Method: invitations.create

دعوتنامه ایجاد می کند. فقط یک دعوت نامه برای کاربر و دوره ممکن است در یک زمان وجود داشته باشد. یک دعوت نامه برای ایجاد تغییرات حذف و دوباره ایجاد کنید.

این روش کدهای خطای زیر را برمی گرداند:

  • اگر کاربر درخواست کننده مجاز به ایجاد دعوت نامه برای این دوره یا خطاهای دسترسی نباشد 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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.