Davetiye oluşturur. Bir kullanıcı ve ders için aynı anda yalnızca bir davetiye olabilir. Değişiklik yapmak için bir davetiyeyi silip yeniden oluşturun.
Bu yöntem aşağıdaki hata kodlarını döndürür:
- İstekte bulunan kullanıcının bu ders için davetiye oluşturmasına izin verilmiyorsa veya erişim hataları varsa
PERMISSION_DENIED
. - Ders veya kullanıcı mevcut değilse
NOT_FOUND
. FAILED_PRECONDITION
:- devre dışı bırakılmışsa.
- Kullanıcı zaten bu role veya daha fazla izne sahip bir role sahipse.
- aşağıdaki istek hataları için:
- IneligibleOwner
- Belirtilen kullanıcı ve ders için zaten bir davetiye varsa
ALREADY_EXISTS
.
HTTP isteği
POST https://classroom.googleapis.com/v1/invitations
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
İstek içeriği
İstek metni, Invitation
öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılı olursa yanıt gövdesi, yeni oluşturulan Invitation
örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/classroom.rosters
Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.