Method: invitations.create

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

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

  • 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

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