Method: invitations.create

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

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

نص الطلب

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

نص الاستجابة

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

نطاقات الأذونات

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

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

لمزيد من المعلومات، اطّلِع على دليل التفويض.