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