Method: subscriptions.patch

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

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

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/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

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