Method: userProfiles.guardianInvitations.get

Belirli bir veli davetiyesini döndürür.

Bu yöntem aşağıdaki hata kodlarını döndürür:

  • PERMISSION_DENIED, istek gönderen kullanıcının studentId ile tanımlanan öğrenciye ait veli davetlerini görüntülemesine izin verilmiyorsa, ilgili alan için veliler etkinleştirilmemişse veya diğer erişim hataları nedeniyle gösterilir.
  • studentId belirtilmişse ancak biçimi tanınamıyorsa (e-posta adresi, API'den bir studentId veya me değişmez dizesi değilse) INVALID_ARGUMENT.
  • Classroom, ilgili öğrenciyle ilgili herhangi bir kayıt bulamazsa NOT_FOUND veya invitationId değerini döndürür. Öğrenci mevcutsa ancak istek gönderen kullanıcının bu öğrenciyi görme erişimi yoksa da döndürülebilir.

HTTP isteği

GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations/{invitationId}

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
studentId

string

Veli davetiyesi istenen öğrencinin kimliği.
invitationId

string

İstenen GuardianInvitation öğesinin id alanı.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt metni

Başarılıysa yanıt metni, GuardianInvitation öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
  • https://www.googleapis.com/auth/classroom.guardianlinks.students

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.