تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
Method: invitations.create
ينشئ دعوة. يجوز أن تكون هناك دعوة واحدة فقط للمستخدم والدورة التدريبية في كل مرة. يجب حذف دعوة وإعادة إنشائها لإجراء تغييرات عليها.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بإنشاء دعوات لهذه الدورة التدريبية أو لأخطاء الوصول.NOT_FOUND إذا كانت الدورة الدراسية أو المستخدم غير موجود.FAILED_PRECONDITION:
- إذا كان حساب المستخدم المطلوب غير مفعّل.
- إذا كان المستخدِم قد ضُم هذا الدور أو دورًا بأذونات أكبر.
- بخصوص أخطاء الطلب التالية:
ALREADY_EXISTS إذا كانت هناك دعوة حاليًا للمستخدم المحدَّد والدورة التدريبية.
طلب HTTP
POST https://classroom.googleapis.com/v1/invitations
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على مثال Invitation.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل Invitation تم إنشاؤه حديثًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.rosters
لمزيد من المعلومات، راجِع دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Creates an invitation for a user to join a course, allowing only one active invitation per user and course at a time."],["Requires `https://www.googleapis.com/auth/classroom.rosters` authorization scope for successful execution."],["Returns an error if the user already has an invitation, the course or user doesn't exist, or the requesting user lacks permission."],["Uses an HTTP POST request to `https://classroom.googleapis.com/v1/invitations` with the invitation details in the request body."],["Upon successful creation, returns the newly created invitation details in the response body."]]],[]]
