Method: userProfiles.guardianInvitations.get

Trả về lời mời cụ thể dành cho người giám hộ.

Phương thức này trả về các mã lỗi sau:

  • PERMISSION_DENIED nếu người dùng yêu cầu không được phép xem các lời mời làm người giám hộ cho học viên do studentId xác định, nếu người giám hộ không được bật cho miền liên quan hoặc vì các lỗi truy cập khác.
  • INVALID_ARGUMENT nếu studentId được chỉ định nhưng định dạng của nó không nhận dạng được (không phải địa chỉ email, cũng không phải studentId từ API, cũng không phải chuỗi ký tự me).
  • NOT_FOUND nếu Lớp học không tìm thấy bản ghi nào của học sinh đã nêu hoặc invitationId. Cũng có thể được trả lại nếu có học viên, nhưng người dùng gửi yêu cầu không có quyền truy cập để xem học viên đó.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
studentId

string

Giấy tờ tuỳ thân của học viên đang được yêu cầu mời là người giám hộ.

invitationId

string

Trường id của GuardianInvitation đang được yêu cầu.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của GuardianInvitation.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.