Method: subscriptions.patch
طلب 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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This API updates or renews a Google Workspace subscription using a PATCH request to the specified URL."],["You can optionally specify an `updateMask` to target specific fields for updating and `validateOnly` to preview the request without applying changes."],["The request body should contain a `Subscription` object and the successful response will include an `Operation` object with the updated `Subscription`."],["Authorization requires specific OAuth scopes related to Google Chat or Google Meet, as detailed in the documentation."]]],["This documentation details updating Google Workspace subscriptions via a `PATCH` HTTP request to `https://workspaceevents.googleapis.com/v1beta/{subscription.name=subscriptions/*}`. Key actions involve specifying the subscription name in the path and using `updateMask` in query parameters to selectively modify fields like `expireTime`, `ttl`, or `eventTypes`. The request body contains subscription details, while the successful response includes an `Operation` with the updated subscription. Authentication requires specific OAuth scopes. The process allows for request validation without actual modification.\n"]]