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

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