ينشئ دعوة. يجوز أن تكون هناك دعوة واحدة فقط للمستخدم والدورة التدريبية في كل مرة. يجب حذف دعوة وإعادة إنشائها لإجراء تغييرات عليها.
تعرض هذه الطريقة رموز الخطأ التالية:
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
لمزيد من المعلومات، راجِع دليل التفويض.