Method: userProfiles.guardians.get

Belirli bir veliyi döndürür.

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

  • İstekte bulunan kullanıcı, sağlanan studentId ile eşleşen hiçbir kullanıcı görünmüyorsa, istekte bulunan kullanıcının studentId tarafından tanımlanan öğrencinin veli bilgilerini görüntülemesine izin verilmiyorsa, söz konusu alan için veliler etkinleştirilmemişse veya diğer erişim hataları varsa PERMISSION_DENIED.
  • 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).
  • NOT_FOUND İstekte bulunan kullanıcının, istenen studentId ile ilişkili velileri görüntülemesine izin veriliyorsa ancak Guardian söz konusu öğrenci için, sağlanan guardianId ile eşleşen bir kayıt yoksa.

HTTP isteği

GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardians/{guardianId}

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

Yol parametreleri

Parametreler
studentId

string

Velisi istenen öğrenci. Şunlardan biri:

  • kullanıcının sayısal tanımlayıcısı
  • kullanıcının e-posta adresi
  • istekte bulunan kullanıcıyı gösteren "me" dize değeri
guardianId

string

Guardian öğesindeki id alanı.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt metni

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

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
  • 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.