יצירת הזמנה. בכל רגע נתון ניתן ליצור רק הזמנה אחת למשתמש ולקורס. מוחקים את ההזמנה ויוצרים אותה מחדש.
השיטה הזו מחזירה את קודי השגיאה הבאים:
PERMISSION_DENIED
אם המשתמש ששלח את הבקשה לא מורשה ליצור הזמנות לקורס הזה או בגלל שגיאות גישה.NOT_FOUND
אם הקורס או המשתמש לא קיימים.FAILED_PRECONDITION
:- אם החשבון של המשתמש המבוקש מושבת.
- אם למשתמש כבר יש את התפקיד הזה או תפקיד עם הרשאות גבוהות יותר.
- עבור שגיאות הבקשה הבאות:
- IneligibleOwner
ALREADY_EXISTS
אם כבר קיימת הזמנה למשתמש ולקורס שצוינו.
בקשת HTTP
POST https://classroom.googleapis.com/v1/invitations
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
גוף הבקשה
גוף הבקשה מכיל מופע של Invitation
.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של Invitation
שנוצר.
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/classroom.rosters
למידע נוסף, ניתן לעיין במדריך ההרשאות.