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