Method: subscriptions.patch

Google Workspace की सदस्यता को अपडेट या रिन्यू करता है. इस तरीके का इस्तेमाल करने का तरीका जानने के लिए, Google Workspace की सदस्यता को अपडेट या रिन्यू करना लेख पढ़ें.

चैट टारगेट रिसोर्स की सदस्यता के लिए, सदस्यता को इस तरह अपडेट किया जा सकता है:

एचटीटीपी अनुरोध

PATCH https://workspaceevents.googleapis.com/v1beta/{subscription.name=subscriptions/*}

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
subscription.name

string

आइडेंटिफ़ायर. सदस्यता के संसाधन का नाम.

फ़ॉर्मैट: subscriptions/{subscription}

क्वेरी पैरामीटर

पैरामीटर
updateMask

string (FieldMask format)

ज़रूरी नहीं. अपडेट किया जाने वाला फ़ील्ड. अगर इसे शामिल नहीं किया जाता है, तो अनुरोध में शामिल किए गए सभी फ़ील्ड अपडेट हो जाते हैं.

किसी सदस्यता में, इनमें से कोई एक फ़ील्ड अपडेट किया जा सकता है:

  • expireTime: सदस्यता खत्म होने का टाइमस्टैंप.
  • 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

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.