Registration
बनाता है. इससे Classroom, दिए गए feed
से cloudPubSubTopic
में दिए गए डेस्टिनेशन पर सूचनाएं भेजना शुरू कर देता है.
बनाया गया Registration
दिखाता है. फ़िलहाल, यह आर्ग्युमेंट जैसा ही होगा. हालांकि, इसमें सर्वर से असाइन किए गए फ़ील्ड, जैसे कि expiryTime
और id
भरे हुए होंगे.
ध्यान दें कि expiryTime
या id
फ़ील्ड के लिए दी गई किसी भी वैल्यू को अनदेखा कर दिया जाएगा.
Classroom, cloudPubSubTopic
की पुष्टि कर सकता है और गड़बड़ियों की जानकारी दे सकता है. हालांकि, यह पक्का करना कॉलर की ज़िम्मेदारी है कि वह मौजूद है और Classroom के पास उस पर पब्लिश करने की अनुमति है.
इस तरीके से, गड़बड़ी के ये कोड दिख सकते हैं:
PERMISSION_DENIED
अगर:- पुष्टि किए गए उपयोगकर्ता के पास, अनुरोध किए गए फ़ील्ड से सूचनाएं पाने की अनुमति नहीं है या
- मौजूदा उपयोगकर्ता ने अनुरोध किए गए फ़ीड के लिए, मौजूदा Cloud प्रोजेक्ट का ऐक्सेस नहीं दिया है. ध्यान दें कि फ़िलहाल, इस काम के लिए डोमेन-वाइड अधिकार देने की सुविधा उपलब्ध नहीं है. अगर अनुरोध का दायरा सही है, लेकिन कोई अनुदान मौजूद नहीं है, तो [अनुरोध से जुड़ी गड़बड़ियां][
@MissingGrant
गड़बड़ी] दिखती है. - कोई दूसरी ऐक्सेस से जुड़ी गड़बड़ी आती है.
INVALID_ARGUMENT
अगर:- कोई
cloudPubsubTopic
नहीं दिया गया है या दिया गयाcloudPubsubTopic
अमान्य है; या - कोई
feed
नहीं दिया गया है या दिया गयाfeed
अमान्य है.
- कोई
NOT_FOUND
अगर:- बताए गए
feed
को ढूंढा नहीं जा सकता या अनुरोध करने वाले उपयोगकर्ता के पास यह तय करने की अनुमति नहीं है कि यह मौजूद है या नहीं; या - दिया गया
cloudPubsubTopic
ढूंढा नहीं जा सकता या Classroom को उस पर पब्लिश करने की अनुमति नहीं दी गई है.
- बताए गए
एचटीटीपी अनुरोध
POST https://classroom.googleapis.com/v1/registrations
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में Registration
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Registration
का नया इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/classroom.push-notifications
ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.