Method: subscriptions.patch

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

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

  • تطبيق Chat من خلال تحديد نطاق تفويض يبدأ بـ chat.app والحصول على موافقة المشرف لمرة واحدة لمزيد من المعلومات، يُرجى الاطّلاع على المقالة التفويض كتطبيق Chat بموافقة المشرف.

  • مستخدم من خلال تحديد نطاق تفويض لا يتضمّن app في اسمه لمزيد من المعلومات، يُرجى الاطّلاع على المقالة التفويض كمستخدم Chat.

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

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