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; izin talebinde bulunan kullanıcının, studentId ile tanımlanan öğrenci için veli davetiyelerini görüntülemesine izin verilmiyorsa, söz konusu alan için veliler etkinleştirilmemişse veya diğer erişim hatalarından kaynaklanır.
  • Bir studentId belirtilmişse ancak biçimi tanınmıyorsa INVALID_ARGUMENT (bu bir e-posta adresi, API'den gelen bir studentId veya harflerden oluşan me dizesi değilse).
  • Classroom, belirtilen öğrencinin herhangi bir kaydını bulamazsa NOT_FOUND veya invitationId. Ayrıca, öğrenci varsa ancak istekte bulunan kullanıcının öğrenciyi görmek için 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 daveti istenen öğrencinin kimliği.

invitationId

string

İstenen GuardianInvitation için 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 göz atın.