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
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.