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

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