Method: registrations.create

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

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