Method: subscriptions.patch

تعديلات على اشتراك Google Workspace أو تجديده للتعرّف على كيفية استخدام هذه الطريقة، يمكنك الاطّلاع على مقالة تعديل اشتراك Google Workspace أو تجديده.

طلب HTTP

PATCH https://workspaceevents.googleapis.com/v1/{subscription.name=subscriptions/*}

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
subscription.name

string

اختياريّ. غير قابل للتغيير. المُعرّف. اسم مورد الاشتراك.

تنسيق الملف: subscriptions/{subscription}

معلمات طلب البحث

المَعلمات
updateMask

string (FieldMask format)

اختياريّ. الحقل المطلوب تعديله. في حال إسقاطها، يتم تعديل أي حقول مضمّنة في الطلب.

يمكنك تعديل أحد الحقول التالية في الاشتراك:

  • expireTime: الطابع الزمني لانتهاء صلاحية الاشتراك
  • ttl: مدة البقاء (TTL) أو مدة الاشتراك

لاستبدال الاشتراك بالكامل (ما يعادل الاشتراك PUT)، يمكنك استخدام *. يتم تعديل أي حقول تم حذفها باستخدام قيم فارغة.
validateOnly

boolean

اختياريّ. في حال ضبط السياسة على true، فإنّها تتحقّق من الطلب ومعاينته، ولكن بدون تعديل الاشتراك.

نص الطلب

يحتوي نص الطلب على مثال Subscription.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

  • يحتوي الحقل metadata على مصفوفة فارغة.
  • يحتوي الحقل response على مثيل محدّث من Subscription.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.