Method: subscriptions.patch

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

بالنسبة إلى اشتراك في مورد مستهدف في Chat، يمكنك تعديل الاشتراك على النحو التالي:

طلب 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/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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