Method: subscriptions.patch

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

طلب HTTP

PATCH https://workspaceevents.googleapis.com/v1beta/{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

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