دعوتنامه ایجاد می کند. فقط یک دعوت نامه برای کاربر و دوره ممکن است در یک زمان وجود داشته باشد. یک دعوت نامه برای ایجاد تغییرات حذف و دوباره ایجاد کنید.
این روش کدهای خطای زیر را برمی گرداند:
- اگر کاربر درخواست کننده مجاز به ایجاد دعوت نامه برای این دوره یا خطاهای دسترسی نباشد
PERMISSION_DENIED. -
NOT_FOUNDاگر دوره یا کاربر وجود نداشته باشد. -
FAILED_PRECONDITION:- اگر حساب کاربری درخواستی غیرفعال باشد.
- اگر کاربر قبلاً این نقش یا نقشی با مجوزهای بیشتر داشته باشد.
- برای خطاهای درخواست زیر:
- مالک غیر واجد شرایط
-
ALREADY_EXISTSاگر دعوتنامه ای برای کاربر و دوره مشخص شده از قبل وجود داشته باشد.
درخواست HTTP
POST https://classroom.googleapis.com/v1/invitations
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی نمونه ای از Invitation است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از Invitation است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/classroom.rosters
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.