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

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