Method: subscriptions.patch

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

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

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

PATCH https://workspaceevents.googleapis.com/v1/{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

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