न्योता बनाता है. एक बार में, किसी उपयोगकर्ता और कोर्स के लिए सिर्फ़ एक न्योता मौजूद हो सकता है. बदलाव करने के लिए, न्योता मिटाएं और फिर से बनाएं.
इस तरीके से, गड़बड़ी के ये कोड मिलते हैं:
PERMISSION_DENIEDअगर अनुरोध करने वाले उपयोगकर्ता के पास इस कोर्स के लिए न्योते बनाने की अनुमति नहीं है या ऐक्सेस से जुड़ी गड़बड़ियों की वजह से.NOT_FOUNDअगर कोर्स या उपयोगकर्ता मौजूद नहीं है.FAILED_PRECONDITION:- अगर जिस उपयोगकर्ता के खाते को मिटाने का अनुरोध किया गया है उसका खाता बंद है.
- अगर उपयोगकर्ता के पास पहले से ही यह भूमिका है या ज़्यादा अनुमतियों वाली कोई भूमिका है.
- इन अनुरोध से जुड़ी गड़बड़ियों के लिए:
- IneligibleOwner
ALREADY_EXISTSअगर किसी उपयोगकर्ता और कोर्स के लिए न्योता पहले से मौजूद है.
एचटीटीपी अनुरोध
POST https://classroom.googleapis.com/v1/invitations
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में Invitation का उदाहरण है.
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Invitation का नया इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/classroom.rosters
ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.