Method: invitations.create

ينشئ دعوة. يجوز أن تكون هناك دعوة واحدة فقط للمستخدم والدورة التدريبية في كل مرة. يجب حذف دعوة وإعادة إنشائها لإجراء تغييرات عليها.

تعرض هذه الطريقة رموز الخطأ التالية:

  • PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بإنشاء دعوات لهذه الدورة التدريبية أو لأخطاء الوصول.
  • NOT_FOUND إذا كانت الدورة الدراسية أو المستخدم غير موجود.
  • FAILED_PRECONDITION:
    • إذا كان حساب المستخدم المطلوب غير مفعّل.
    • إذا كان المستخدِم قد ضُم هذا الدور أو دورًا بأذونات أكبر.
    • بخصوص أخطاء الطلب التالية:
      • IneligibleOwner
  • ALREADY_EXISTS إذا كانت هناك دعوة حاليًا للمستخدم المحدَّد والدورة التدريبية.

طلب HTTP

POST https://classroom.googleapis.com/v1/invitations

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

يحتوي نص الطلب على مثال Invitation.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل Invitation تم إنشاؤه حديثًا.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/classroom.rosters

لمزيد من المعلومات، راجِع دليل التفويض.