یک نام مستعار برای یک دوره ایجاد می کند.
این روش کدهای خطای زیر را برمی گرداند:
- اگر کاربر درخواست کننده مجاز به ایجاد نام مستعار یا خطاهای دسترسی نباشد
PERMISSION_DENIED
. -
NOT_FOUND
اگر دوره وجود نداشته باشد. - اگر نام مستعار از قبل وجود داشته باشد،
ALREADY_EXISTS
. -
FAILED_PRECONDITION
اگر نام مستعار درخواست شده برای کاربر یا دوره درخواست کننده معنی نداشته باشد (به عنوان مثال، اگر کاربری که در یک دامنه نیست سعی کند به یک نام مستعار با دامنه دامنه دسترسی پیدا کند).
درخواست HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/aliases
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
course Id | شناسه دوره به نام مستعار. این شناسه می تواند شناسه اختصاص داده شده توسط Classroom یا |
درخواست بدن
بدنه درخواست شامل نمونه ای از CourseAlias
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از CourseAlias
است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/classroom.courses
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.