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.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.all.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.all.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.app.spaces.readonly
  • https://www.googleapis.com/auth/chat.app.all.spaces.readonly
  • https://www.googleapis.com/auth/chat.app.all.users.readstate.readonly
  • 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

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