Google Classroom eklentileri artık geliştiricilerin genel kullanımına sunuldu! Daha fazla bilgi edinmek için lütfen
eklenti belgelerini inceleyin.
REST Resource: invitations
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: Davetiye
Bir derse katılma daveti.
JSON gösterimi |
{
"id": string,
"userId": string,
"courseId": string,
"role": enum (CourseRole )
} |
Alanlar |
id |
string
Classroom tarafından atanan tanımlayıcı. Salt okunur.
|
userId |
string
Davet edilen kullanıcının tanımlayıcısıdır. Bir isteğin parametresi olarak belirtildiğinde bu tanımlayıcı aşağıdakilerden birine ayarlanabilir:
- Kullanıcının sayısal tanımlayıcısı
- kullanıcının e-posta adresi
- İstekte bulunan kullanıcıyı belirten
"me" değişmez dizesi
|
courseId |
string
Kullanıcıyı davet edilecek dersin tanımlayıcısıdır.
|
role |
enum (CourseRole )
Kullanıcıyı davet etmek için kullanılacak rol. COURSE_ROLE_UNSPECIFIED olmamalıdır.
|
CourseRole
Kullanıcıların davet edilebileceği olası roller.
Sıralamalar |
COURSE_ROLE_UNSPECIFIED |
Ders rolü yok. |
STUDENT |
Kurstaki öğrenci. |
TEACHER |
Kursun öğretmeni. |
OWNER |
Kursun sahibi. |
Yöntemler |
|
Daveti kabul eder, daveti kaldırır ve davet edilen kullanıcıyı belirtilen dersin öğretmenlerine veya öğrencilerine (uygun olduğu şekilde) ekler. |
|
Davetiye oluşturur. |
|
Davetiyeyi siler. |
|
Bir davetiye döndürür. |
|
İstekte bulunan kullanıcının görüntülemesine izin verilen davetlerin listesini döndürür. Bu liste, liste isteğiyle eşleşenlerle sınırlıdır. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# REST Resource: invitations\n\n- [Resource: Invitation](#Invitation)\n - [JSON representation](#Invitation.SCHEMA_REPRESENTATION)\n- [CourseRole](#CourseRole)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Invitation\n--------------------\n\nAn invitation to join a course.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"userId\": string, \"courseId\": string, \"role\": enum (/workspace/classroom/reference/rest/v1/invitations#CourseRole) } ``` |\n\n| Fields ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Identifier assigned by Classroom. Read-only. |\n| `userId` | `string` Identifier of the invited user. When specified as a parameter of a request, this identifier can be set to one of the following: - the numeric identifier for the user - the email address of the user - the string literal `\"me\"`, indicating the requesting user |\n| `courseId` | `string` Identifier of the course to invite the user to. |\n| `role` | `enum (`[CourseRole](/workspace/classroom/reference/rest/v1/invitations#CourseRole)`)` Role to invite the user to have. Must not be `COURSE_ROLE_UNSPECIFIED`. |\n\nCourseRole\n----------\n\nPossible roles a user may be invite to have.\n\n| Enums ||\n|---------------------------|------------------------|\n| `COURSE_ROLE_UNSPECIFIED` | No course role. |\n| `STUDENT` | Student in the course. |\n| `TEACHER` | Teacher of the course. |\n| `OWNER` | Owner of the course. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| ### [accept](/workspace/classroom/reference/rest/v1/invitations/accept) | Accepts an invitation, removing it and adding the invited user to the teachers or students (as appropriate) of the specified course. |\n| ### [create](/workspace/classroom/reference/rest/v1/invitations/create) | Creates an invitation. |\n| ### [delete](/workspace/classroom/reference/rest/v1/invitations/delete) | Deletes an invitation. |\n| ### [get](/workspace/classroom/reference/rest/v1/invitations/get) | Returns an invitation. |\n| ### [list](/workspace/classroom/reference/rest/v1/invitations/list) | Returns a list of invitations that the requesting user is permitted to view, restricted to those that match the list request. |"]]