Method: invitations.create
יצירת הזמנה. בכל רגע נתון ניתן ליצור רק הזמנה אחת למשתמש ולקורס. מוחקים את ההזמנה ויוצרים אותה מחדש.
השיטה הזו מחזירה את קודי השגיאה הבאים:
PERMISSION_DENIED אם המשתמש ששלח את הבקשה לא מורשה ליצור הזמנות לקורס הזה או בגלל שגיאות גישה.NOT_FOUND אם הקורס או המשתמש לא קיימים.FAILED_PRECONDITION:
- אם החשבון של המשתמש המבוקש מושבת.
- אם למשתמש כבר יש את התפקיד הזה או תפקיד עם הרשאות גבוהות יותר.
- עבור שגיאות הבקשה הבאות:
ALREADY_EXISTS אם כבר קיימת הזמנה למשתמש ולקורס שצוינו.
בקשת HTTP
POST https://classroom.googleapis.com/v1/invitations
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
גוף הבקשה
גוף הבקשה מכיל מופע של Invitation.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של Invitation שנוצר.
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/classroom.rosters
למידע נוסף, ניתן לעיין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-04 (שעון UTC).
[null,null,["עדכון אחרון: 2024-09-04 (שעון UTC)."],[[["Creates an invitation for a user to join a course, allowing only one active invitation per user and course at a time."],["Requires `https://www.googleapis.com/auth/classroom.rosters` authorization scope for successful execution."],["Returns an error if the user already has an invitation, the course or user doesn't exist, or the requesting user lacks permission."],["Uses an HTTP POST request to `https://classroom.googleapis.com/v1/invitations` with the invitation details in the request body."],["Upon successful creation, returns the newly created invitation details in the response body."]]],[]]
