Method: invitations.create

יצירת הזמנה. בכל רגע נתון יכולה להתקיים רק הזמנה אחת למשתמש ולקורס. מוחקים את ההזמנה ויוצרים אותה מחדש כדי לבצע שינויים.

השיטה הזו מחזירה את קודי השגיאה הבאים:

  • PERMISSION_DENIED אם למשתמש המבקש אין הרשאה ליצור הזמנות לקורס הזה, או בגלל שגיאות גישה.
  • NOT_FOUND אם הקורס או המשתמש לא קיימים.
  • FAILED_PRECONDITION:
    • אם החשבון של המשתמש המבוקש מושבת.
    • אם למשתמש כבר יש את התפקיד הזה או תפקיד עם הרשאות גבוהות יותר.
    • לשגיאות הבקשה הבאות:
      • IneligibleOwner
  • ALREADY_EXISTS אם כבר יש הזמנה למשתמש ולקורס שצוינו.

בקשת HTTP

POST https://classroom.googleapis.com/v1/invitations

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

גוף הבקשה

גוף הבקשה מכיל מופע של Invitation.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Invitation.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/classroom.rosters

מידע נוסף זמין במדריך ההרשאות.