Method: invitations.create

न्योता बनाता है. एक बार में, किसी उपयोगकर्ता और कोर्स के लिए सिर्फ़ एक न्योता मौजूद हो सकता है. बदलाव करने के लिए, न्योता मिटाएं और फिर से बनाएं.

इस तरीके से, गड़बड़ी के ये कोड मिलते हैं:

  • 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

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