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) أو مدة الاشتراك
  • eventTypes: قائمة بأنواع الأحداث التي سيتم تلقّيها عن المورد المستهدَف

لاستبدال الاشتراك بالكامل (المكافئ لـ 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

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