पुश नोटिफिकेशन

इस दस्तावेज़ में, पुश नोटिफ़िकेशन का इस्तेमाल करने का तरीका बताया गया है. पुश नोटिफ़िकेशन से, संसाधन में बदलाव होने पर आपके ऐप्लिकेशन को सूचना मिलती है.

खास जानकारी

Directory API, पुश नोटिफ़िकेशन की सुविधा देता है. इससे संसाधनों में हुए बदलावों को मॉनिटर किया जा सकता है. इस सुविधा का इस्तेमाल करके, अपने ऐप्लिकेशन की परफ़ॉर्मेंस को बेहतर बनाया जा सकता है. इससे आपको यह पता लगाने के लिए, पोलिंग संसाधनों से जुड़ी अतिरिक्त नेटवर्क और कंप्यूट लागत को कम करने में मदद मिलती है कि उनमें बदलाव हुआ है या नहीं. जब भी देखी गई किसी संसाधन में बदलाव होता है, तो Directory API आपके ऐप्लिकेशन को इसकी सूचना देता है.

पुश नोटिफ़िकेशन का इस्तेमाल करने के लिए, आपको ये दो काम करने होंगे:

रिसीविंग यूआरएल या "वेबबुक" कॉलबैक रिसीवर सेट अप करें.
यह एक एचटीटीपीएस सर्वर है. यह एपीआई सूचना वाले उन मैसेज को मैनेज करता है जो किसी संसाधन में बदलाव होने पर ट्रिगर होते हैं.
आपको जिस भी संसाधन एंडपॉइंट पर नज़र रखनी है उसके लिए, एक (सूचना चैनल) सेट अप करें.
चैनल, सूचना वाले मैसेज के लिए राउटिंग की जानकारी देता है. चैनल सेटअप करने के दौरान, आपको उस यूआरएल की पहचान करनी होगी जहां आपको सूचनाएं चाहिए. जब भी किसी चैनल के संसाधन में बदलाव होता है, तब Directory API उस यूआरएल पर POST के तौर पर सूचना वाला मैसेज भेजता है.

फ़िलहाल, Directory API, Users संसाधन में हुए बदलावों के लिए सूचनाएं पाने की सुविधा देता है.

सूचना के चैनल बनाना

पुश नोटिफ़िकेशन पाने का अनुरोध करने के लिए, आपको उस हर संसाधन के लिए एक सूचना चैनल सेट अप करना होगा जिसे आपको मॉनिटर करना है. सूचना चैनल सेट अप करने के बाद, जब भी किसी मॉनिटर की गई संसाधन में बदलाव होता है, तब Directory API आपके ऐप्लिकेशन को इसकी सूचना देता है.

स्मार्टवॉच से अनुरोध करना

Directory API के हर ऐसे संसाधन के साथ एक watch तरीका जुड़ा होता है जिसे मॉनिटर किया जा सकता है. इसका यूआरआई इस फ़ॉर्म में होता है:

https://www.googleapis.com/API_NAME/API_VERSION/RESOURCE_PATH/watch

किसी संसाधन में हुए बदलावों के बारे में सूचनाएं पाने के लिए, सूचना चैनल सेट अप करने के लिए, संसाधन के लिए watch तरीके को POST अनुरोध भेजें.

हर सूचना चैनल, किसी उपयोगकर्ता और किसी संसाधन (या संसाधनों के सेट) से जुड़ा होता है. watch अनुरोध तब तक पूरा नहीं होगा, जब तक मौजूदा उपयोगकर्ता या सेवा खाते के पास इस संसाधन का मालिकाना हक नहीं है या उसे ऐक्सेस करने की अनुमति नहीं है.

उदाहरण

किसी एक डोमेन के लिए, User संसाधन के लिए किए गए सभी वॉच अनुरोध इस फ़ॉर्म में होते हैं:

POST https://admin.googleapis.com/admin/directory/v1/users/watch?domain=domain&event=event
Authorization: Bearer auth_token_for_current_user
Content-Type: application/json

{
  "id": "01234567-89ab-cdef-0123456789ab",
  "type": "web_hook",
  "address": "https://mydomain.com/notifications",
  ...
  "token": "target=myApp-myFilesChannelDest",
  "params": {
    "ttl": 3600
  }
}

अनुरोध के मुख्य हिस्से में, अपने चैनल का id, type को web_hook के तौर पर, और address में अपना यूआरएल डालें. आपके पास यह जानकारी देने का विकल्प भी है:

चैनल टोकन के तौर पर इस्तेमाल करने के लिए token.
ttl में params इस चैनल के लिए टाइम-टू-लाइव का अनुरोध करने के लिए, सेकंड में.

domain और event पैरामीटर का इस्तेमाल करके, उस डोमेन और इवेंट के टाइप के बारे में बताएं जिसके लिए आपको सूचनाएं चाहिए.

किसी ग्राहक के लिए, उपयोगकर्ता संसाधन के सभी वॉच अनुरोध इस सामान्य फ़ॉर्म में होते हैं:

POST https://admin.googleapis.com/admin/directory/users/v1/watch?customer=customer&event=event
Authorization: Bearer auth_token_for_current_user
Content-Type: application/json

{
  "id": "01234567-89ab-cdef-0123456789ab",
  "type": "web_hook",
  "address": "https://mydomain.com/notifications",
  ...
  "token": "target=myApp-myFilesChannelDest",
  "params": {
    "ttl": 3600
  }
}

customer और event पैरामीटर का इस्तेमाल करके, ग्राहक के Google खाते का यूनीक आईडी और उस इवेंट का टाइप बताएं जिसके लिए आपको सूचनाएं चाहिए.

event के लिए ये वैल्यू इस्तेमाल की जा सकती हैं:

add: उपयोगकर्ता की कार्रवाई की वजह से बना इवेंट
delete: उपयोगकर्ता ने खाता मिटाया इवेंट
makeAdmin: उपयोगकर्ता एडमिन की स्थिति में बदलाव का इवेंट
undelete: उपयोगकर्ता ने इवेंट को वापस लाया
update: उपयोगकर्ता ने इवेंट अपडेट किया

ध्यान दें: यहां दिए गए उदाहरणों में, अनुरोध के मुख्य हिस्से को शामिल नहीं किया गया है, ताकि जानकारी साफ़ तौर पर समझाई जा सके.

डोमेन mydomain.com के लिए, उपयोगकर्ता के बनाए गए इवेंट देखें:

POST https://admin.googleapis.com/admin/directory/v1/users/watch?domain=mydomain.com&event=add

उपयोगकर्ता के बनाए गए इवेंट को ग्राहक my_customer के लिए देखें:

POST https://admin.googleapis.com/admin/directory/v1/users/watch?customer=my_customer&event=add

ज़रूरी प्रॉपर्टी

हर watch अनुरोध के साथ, आपको ये फ़ील्ड देने होंगे:

id प्रॉपर्टी स्ट्रिंग, जो आपके प्रोजेक्ट में इस नए सूचना चैनल की पहचान करती है. हमारा सुझाव है कि आप यूनिवर्सली यूनीक आइडेंटिफ़ायर (UUID) या इसी तरह की कोई यूनीक स्ट्रिंग इस्तेमाल करें. ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं.

आपने जो आईडी वैल्यू सेट की है वह आपको इस चैनल के लिए मिलने वाले हर सूचना मैसेज के X-Goog-Channel-Id एचटीटीपी हेडर में वापस दिखती है.
type प्रॉपर्टी स्ट्रिंग, web_hook वैल्यू पर सेट है.
address प्रॉपर्टी स्ट्रिंग को उस यूआरएल पर सेट किया जाता है जो इस सूचना चैनल के लिए सूचनाएं सुनता है और उनका जवाब देता है. यह आपका वेबहुक कॉलबैक यूआरएल है. इसमें एचटीटीपीएस का इस्तेमाल होना चाहिए.

ध्यान दें कि Directory API, इस एचटीटीपीएस पते पर सूचनाएं सिर्फ़ तब भेज सकता है, जब आपके वेब सर्वर पर एक मान्य एसएसएल सर्टिफ़िकेट इंस्टॉल किया गया हो. अमान्य सर्टिफ़िकेट में ये शामिल हैं:
- खुद हस्ताक्षर किए हुए सर्टिफ़िकेट.
- किसी गैर-भरोसेमंद सोर्स के हस्ताक्षर किए हुए सर्टिफ़िकेट.
- वे सर्टिफ़िकेट जो निरस्त कर दिए गए हैं.
- ऐसे सर्टिफ़िकेट जिनका विषय, टारगेट किए गए होस्टनेम से मेल नहीं खाता.

ज़रूरी नहीं है कि ये प्रॉपर्टी मौजूद हों

watch अनुरोध के साथ, इन वैकल्पिक फ़ील्ड की जानकारी भी दी जा सकती है:

token प्रॉपर्टी, जो चैनल टोकन के तौर पर इस्तेमाल करने के लिए आर्बिट्ररी स्ट्रिंग वैल्यू तय करती है. सूचना चैनल टोकन का इस्तेमाल कई कामों के लिए किया जा सकता है. उदाहरण के लिए, इस टोकन का इस्तेमाल यह पुष्टि करने के लिए किया जा सकता है कि हर इनकमिंग मैसेज, आपके ऐप्लिकेशन से बनाए गए चैनल के लिए है. इससे यह पक्का किया जा सकता है कि सूचना को स्पूफ़ नहीं किया जा रहा है. इसके अलावा, इस टोकन का इस्तेमाल, चैनल के मकसद के आधार पर मैसेज को आपके ऐप्लिकेशन में सही जगह पर भेजने के लिए भी किया जा सकता है. ज़्यादा से ज़्यादा वर्ण: 256 वर्ण.
यह टोकन, हर सूचना मैसेज में X-Goog-Channel-Token एचटीटीपी हेडर में शामिल होता है. यह मैसेज, आपका ऐप्लिकेशन इस चैनल के लिए पाता है.

अगर सूचना चैनल टोकन का इस्तेमाल किया जाता है, तो हमारा सुझाव है कि आप:
- एक्सटेंसिबल एन्कोडिंग फ़ॉर्मैट का इस्तेमाल करें. जैसे, यूआरएल क्वेरी पैरामीटर. उदाहरण: forwardTo=hr&createdBy=mobile
- इसमें OAuth टोकन जैसे संवेदनशील डेटा को शामिल न करें.
ध्यान दें: अगर आपको बहुत ज़्यादा संवेदनशील डेटा भेजना है, तो पक्का करें कि टोकन में जोड़ने से पहले उसे एन्क्रिप्ट किया गया हो.
expiration प्रॉपर्टी स्ट्रिंग को उस तारीख और समय के Unix टाइमस्टैंप (मिलीसेकंड में) पर सेट किया जाता है जब आपको Directory API को इस सूचना चैनल के लिए मैसेज भेजना बंद करना है.

अगर किसी चैनल की समयसीमा खत्म होने वाली है, तो उसे X-Goog-Channel-Expiration एचटीटीपी हेडर की वैल्यू के तौर पर शामिल किया जाता है. यह वैल्यू, हर सूचना वाले मैसेज में होती है. यह मैसेज, आपके ऐप्लिकेशन को इस चैनल के लिए मिलता है. इस वैल्यू को, आसानी से पढ़े जा सकने वाले फ़ॉर्मैट में दिखाया जाता है.

अनुरोध के बारे में ज़्यादा जानकारी के लिए, एपीआई के रेफ़रंस में Users संसाधन के लिए watch तरीका देखें.

जवाब देखना

अगर watch अनुरोध से सूचना चैनल बन जाता है, तो यह एचटीटीपी 200 OK स्टेटस कोड दिखाता है.

वॉच रिस्पॉन्स के मैसेज बॉडी में, अभी-अभी बनाए गए सूचना चैनल के बारे में जानकारी दी गई है. इसे यहां दिए गए उदाहरण में देखा जा सकता है.

{
  "kind": "api#channel",
  "id": "01234567-89ab-cdef-0123456789ab",
  "resourceId": "B4ibMJiIhTjAQd7Ff2K2bexk8G4",
  "resourceUri": "https://admin.googleapis.com/admin/directory/v1/users?domain=domain&event=event",
  "token": "target=myApp-myFilesChannelDest",
  "expiration": 1384823632000
}

जवाब के मुख्य हिस्से में चैनल की जानकारी दी जाती है. जैसे:

id: इस चैनल के लिए आपने जो आईडी दिया है.
resourceId: देखे गए संसाधन का आईडी.
resourceUri: देखे गए संसाधन का वर्शन के हिसाब से आईडी.
token: अनुरोध के मुख्य हिस्से में दिया गया टोकन.
expiration: चैनल की सदस्यता खत्म होने का समय, मिलीसेकंड में Unix टाइमस्टैंप के तौर पर.

आपने अनुरोध में जो प्रॉपर्टी भेजी हैं उनके अलावा, जवाब में मिली जानकारी में resourceId और resourceUri भी शामिल हैं. इनसे यह पता चलता है कि इस सूचना चैनल पर कौनसे संसाधन पर नज़र रखी जा रही है.

ध्यान दें: resourceId प्रॉपर्टी, संसाधन के लिए एक स्टेबल आइडेंटिफ़ायर है. यह वर्शन पर निर्भर नहीं करता. resourceUri प्रॉपर्टी, मौजूदा एपीआई वर्शन के हिसाब से देखे गए संसाधन का कैननिकल यूआरआई है. इसलिए, यह वर्शन के हिसाब से अलग-अलग होती है.

आपको मिली जानकारी का इस्तेमाल, सूचना चैनल से जुड़ी अन्य कार्रवाइयों के लिए किया जा सकता है. जैसे, सूचनाएं पाना बंद करना.

रिस्पॉन्स के बारे में ज़्यादा जानकारी के लिए, एपीआई के रेफ़रंस में Users रिसॉर्स के लिए watch तरीका देखें.

मैसेज सिंक करना

किसी संसाधन को मॉनिटर करने के लिए सूचना चैनल बनाने के बाद, Directory API एक sync मैसेज भेजता है. इससे पता चलता है कि सूचनाएं भेजी जा रही हैं. इन मैसेज के लिए, X-Goog-Resource-State एचटीटीपी हेडर की वैल्यू sync है. नेटवर्क टाइमिंग से जुड़ी समस्याओं की वजह से, ऐसा हो सकता है कि आपको sync मैसेज, watch तरीके के जवाब से पहले ही मिल जाए.

sync सूचना को अनदेखा किया जा सकता है. हालांकि, इसका इस्तेमाल भी किया जा सकता है. उदाहरण के लिए, अगर आपको चैनल नहीं रखना है, तो X-Goog-Channel-ID और X-Goog-Resource-ID वैल्यू का इस्तेमाल करके, सूचनाएं पाना बंद किया जा सकता है. इसके अलावा, sync सूचना का इस्तेमाल करके, कुछ इवेंट के लिए तैयारी की जा सकती है.

Directory API, आपके रिसीविंग यूआरएल पर sync मैसेज इस फ़ॉर्मैट में भेजता है.

POST https://mydomain.com/notifications // Your receiving URL.
X-Goog-Channel-ID: channel-ID-value
X-Goog-Channel-Token: channel-token-value
X-Goog-Channel-Expiration: expiration-date-and-time // In human-readable format. Present only if the channel expires.
X-Goog-Resource-ID: identifier-for-the-watched-resource
X-Goog-Resource-URI: version-specific-URI-of-the-watched-resource
X-Goog-Resource-State: sync
X-Goog-Message-Number: 1

सिंक किए गए मैसेज में हमेशा X-Goog-Message-Number एचटीटीपी हेडर की वैल्यू 1 होती है. इस चैनल के लिए, इसके बाद आने वाली हर सूचना में एक ऐसा मैसेज नंबर होता है जो पिछली सूचना के मैसेज नंबर से बड़ा होता है. हालांकि, मैसेज नंबर क्रम से नहीं होंगे.

सूचना के चैनलों को रिन्यू करना

सूचना चैनल के खत्म होने का समय हो सकता है. इसकी वैल्यू, आपके अनुरोध या Directory API की किसी अंदरूनी सीमा या डिफ़ॉल्ट वैल्यू से तय होती है. इनमें से जो वैल्यू ज़्यादा पाबंदी वाली होती है उसका इस्तेमाल किया जाता है. अगर चैनल की सदस्यता की समयसीमा खत्म होने वाली है, तो उसकी जानकारी watch तरीके से मिली जानकारी में शामिल की जाती है. यह जानकारी यूनिक्स टाइमस्टैंप (मिलीसेकंड में) के तौर पर शामिल की जाती है. इसके अलावा, हर सूचना वाले मैसेज में समयसीमा खत्म होने की तारीख और समय (इंसान के पढ़ने लायक फ़ॉर्मैट में) शामिल होता है. आपका ऐप्लिकेशन, इस चैनल के लिए X-Goog-Channel-Expiration एचटीटीपी हेडर में यह मैसेज पाता है.

फ़िलहाल, सूचना चैनल को अपने-आप रिन्यू करने का कोई तरीका उपलब्ध नहीं है. जब किसी चैनल की समयसीमा खत्म होने वाली हो, तो आपको उसे नए चैनल से बदलना होगा. इसके लिए, watch तरीके को कॉल करें. हमेशा की तरह, आपको नए चैनल की id प्रॉपर्टी के लिए एक यूनीक वैल्यू का इस्तेमाल करना होगा. ध्यान दें कि ऐसा हो सकता है कि एक ही संसाधन के लिए, सूचना पाने के दोनों चैनल कुछ समय के लिए चालू रहें.

सूचनाएं पाएं

जब भी मॉनिटर की जा रही किसी संसाधन में बदलाव होता है, तब आपके ऐप्लिकेशन को बदलाव के बारे में बताने वाला सूचना मैसेज मिलता है. Directory API, इन मैसेज को एचटीटीपीएस POST अनुरोधों के तौर पर भेजता है. ये अनुरोध, उस यूआरएल पर भेजे जाते हैं जिसे आपने इस सूचना चैनल के लिए address प्रॉपर्टी के तौर पर सेट किया है.

ध्यान दें: सूचनाएं भेजने के लिए किए गए एचटीटीपीएस अनुरोधों में, APIs-Google उपयोगकर्ता एजेंट के तौर पर शामिल होता है. साथ ही, ये अनुरोध robots.txt के निर्देशों का पालन करते हैं. इस बारे में APIs Google User Agent में बताया गया है.

सूचना वाले मैसेज के फ़ॉर्मैट को समझना

सूचना वाले सभी मैसेज में, एचटीटीपी हेडर का एक सेट शामिल होता है. इसमें X-Goog- प्रीफ़िक्स होते हैं. कुछ तरह की सूचनाओं में मैसेज का मुख्य हिस्सा भी शामिल हो सकता है.

हेडर

Directory API से आपके यूआरएल पर पोस्ट किए गए सूचना मैसेज में, ये एचटीटीपी हेडर शामिल होते हैं:

हेडर	ब्यौरा
हमेशा मौजूद
`X-Goog-Channel-ID`	यूयूआईडी या अन्य यूनीक स्ट्रिंग, जिसका इस्तेमाल आपने इस सूचना चैनल की पहचान करने के लिए किया है.
`X-Goog-Message-Number`	पूर्णांक, जो इस सूचना चैनल के लिए इस मैसेज की पहचान करता है. `sync` मैसेज के लिए, वैल्यू हमेशा `1` होती है. चैनल पर मौजूद हर मैसेज के लिए, मैसेज की संख्या बढ़ती है. हालांकि, यह क्रम से नहीं होती.
`X-Goog-Resource-ID`	यह एक अपारदर्शी वैल्यू है, जो देखे जा रहे संसाधन की पहचान करती है. यह आईडी, एपीआई के सभी वर्शन में एक जैसा रहता है.
`X-Goog-Resource-State`	संसाधन की नई स्थिति, जिसकी वजह से सूचना ट्रिगर हुई. संभावित वैल्यू: `sync` या इवेंट का नाम.
`X-Goog-Resource-URI`	यह एपीआई के वर्शन के हिसाब से, मॉनिटर किए जा रहे संसाधन के लिए आइडेंटिफ़ायर होता है.
कभी-कभी मौजूद होता है
`X-Goog-Channel-Expiration`	सूचना चैनल के खत्म होने की तारीख और समय. इसे ऐसे फ़ॉर्मैट में दिखाया जाता है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. यह सिर्फ़ तब मौजूद होता है, जब इसे तय किया गया हो.
`X-Goog-Channel-Token`	आपके ऐप्लिकेशन ने सूचना चैनल का यह टोकन सेट किया था. इसका इस्तेमाल सूचना के सोर्स की पुष्टि करने के लिए किया जा सकता है. यह सिर्फ़ तब मौजूद होता है, जब इसे तय किया गया हो.

उपयोगकर्ताओं को भेजी जाने वाली सूचनाओं में, अनुरोध के मुख्य हिस्से में यह जानकारी शामिल होती है:

प्रॉपर्टी	ब्यौरा
`kind`	इससे यह पता चलता है कि यह एक उपयोगकर्ता संसाधन है. वैल्यू: तय की गई स्ट्रिंग "`admin#directory#user`".
`id`	उपयोगकर्ता संसाधन का यूनीक आइडेंटिफ़ायर.
`etag`	सूचना वाले मैसेज का ईटैग. यह उपयोगकर्ता रिसॉर्स के ईटैग से अलग होता है.
`primaryEmail`	उपयोगकर्ता का मुख्य ईमेल पता.

उदाहरण

User रिसॉर्स के इवेंट के लिए सूचना वाले मैसेज, आम तौर पर इस तरह दिखते हैं:

POST https://mydomain.com/notifications
Content-Type: application/json; utf-8
Content-Length: 0
X-Goog-Channel-ID: directoryApiId
X-Goog-Channel-Token: 398348u3tu83ut8uu38
X-Goog-Channel-Expiration: Tue, 29 Oct 2013 20:32:02 GMT
X-Goog-Resource-ID:  ret08u3rv24htgh289g
X-Goog-Resource-URI: https://admin.googleapis.com/admin/directory/v1/users?domain=domain&event=event
X-Goog-Resource-State:  event
X-Goog-Message-Number: 10

{
  "kind": "admin#directory#user",
  "id": long,
  "etag": string,
  "primaryEmail": string
}

उपयोगकर्ता के मिटाए गए इवेंट का उदाहरण:

POST https://mydomain.com/notifications
Content-Type: application/json; utf-8
Content-Length: 189
X-Goog-Channel-ID: deleteChannel
X-Goog-Channel-Token: 245t1234tt83trrt333
X-Goog-Channel-Expiration: Mon, 09 Dec 2013 22:24:23 GMT
X-Goog-Resource-ID:  B4ibMJiIhTjAQd7Ff2K2bexk8G4
X-Goog-Resource-URI: https://admin.googleapis.com/admin/directory/v1/users?domain=mydomain.com&event=delete&alt=json
X-Goog-Resource-State:  delete
X-Goog-Message-Number: 236440

{
  "kind": "admin#directory#user",
  "id": "111220860655841818702",
  "etag": "\"Mf8RAmnABsVfQ47MMT_18MHAdRE/evLIDlz2Fd9zbAqwvIp7Pzq8UAw\"",
  "primaryEmail": "user@mydomain.com"
}

सूचनाओं का उत्तर दें

सफल होने का स्टेटस दिखाने के लिए, इनमें से कोई भी स्टेटस कोड दिखाया जा सकता है: 200, 201, 202, 204 या 102.

अगर आपकी सेवा Google की API क्लाइंट लाइब्रेरी का इस्तेमाल करती है और 500,502, 503 या 504 दिखाती है, तो Directory API, एक्सपोनेंशियल बैकऑफ़ के साथ फिर से कोशिश करता है. वापसी के हर दूसरे स्टेटस कोड को मैसेज डिलीवर न होने की समस्या माना जाता है.

सूचनाएं पाने की सुविधा बंद करें

expiration प्रॉपर्टी से यह कंट्रोल किया जाता है कि सूचनाएं अपने-आप कब बंद होंगी. आपके पास किसी चैनल की सदस्यता खत्म होने से पहले, उसकी सूचनाएं पाने की सुविधा बंद करने का विकल्प होता है. इसके लिए, आपको नीचे दिए गए यूआरआई पर stop तरीके का इस्तेमाल करना होगा:

https://www.googleapis.com/admin/directory_v1/channels/stop

इस तरीके के लिए, आपको कम से कम चैनल की id और resourceId प्रॉपर्टी देनी होंगी. यहां दिए गए उदाहरण में, इन प्रॉपर्टी को दिखाया गया है. ध्यान दें कि अगर Directory API में कई तरह के ऐसे संसाधन हैं जिनमें watch तरीके हैं, तो सिर्फ़ एक watch तरीका होता है.stop

चैनल को सिर्फ़ वे उपयोगकर्ता बंद कर सकते हैं जिनके पास इसकी अनुमति है. खास तौर पर:

अगर चैनल को किसी सामान्य उपयोगकर्ता खाते से बनाया गया था, तो उसे सिर्फ़ वही उपयोगकर्ता बंद कर सकता है जिसने उसे बनाया था. साथ ही, वह उपयोगकर्ता उसी क्लाइंट से होना चाहिए जिसकी पहचान OAuth 2.0 क्लाइंट आईडी से की गई है. यह आईडी, ऑथराइज़ेशन टोकन से मिलता है.
अगर चैनल को किसी सेवा खाते से बनाया गया है, तो उसी क्लाइंट का कोई भी उपयोगकर्ता चैनल को बंद कर सकता है.

यहां दिए गए कोड सैंपल में, सूचनाएं पाने की सुविधा बंद करने का तरीका बताया गया है:

POST https://www.googleapis.com/admin/directory_v1/channels/stop
  
Authorization: Bearer CURRENT_USER_AUTH_TOKEN
Content-Type: application/json

{
  "id": "4ba78bf0-6a47-11e2-bcfd-0800200c9a66",
  "resourceId": "ret08u3rv24htgh289g"
}