Method: userProfiles.guardians.list

Trả về danh sách người giám hộ mà người dùng yêu cầu được phép xem, giới hạn cho những người giám hộ phù hợp với yêu cầu.

Để liệt kê người giám hộ của mọi học viên mà người dùng yêu cầu có thể xem người giám hộ, hãy sử dụng ký tự cố định - cho mã nhận dạng học viên.

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

  • PERMISSION_DENIED nếu studentId được chỉ định và người dùng yêu cầu không được phép xem thông tin người giám hộ cho học viên đó, nếu "-" được chỉ định là studentId và người dùng không phải là quản trị viên miền và nếu người giám hộ không được bật cho miền được đề cập, bộ lọc invitedEmailAddress do người dùng không phải là quản trị viên miền hoặc các lỗi truy cập khác đặt.
  • INVALID_ARGUMENT nếu studentId được chỉ định nhưng không thể nhận dạng định dạng của nó (đó không phải là địa chỉ email hoặc studentId từ API hoặc chuỗi giá trị cố định me). Cũng có thể được trả về nếu bạn cung cấp pageToken không hợp lệ.
  • NOT_FOUND nếu bạn chỉ định studentId và có thể nhận dạng được định dạng của học viên đó, nhưng Lớp học sẽ không có bản ghi nào của học viên đó.

Yêu cầu HTTP

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

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

Tham số đường dẫn

Tham số
studentId

string

Lọc kết quả theo học viên được liên kết với người giám hộ. Giá trị nhận dạng có thể là một trong những giá trị sau:

  • giá trị nhận dạng dưới dạng số cho người dùng
  • địa chỉ email của người dùng
  • giá trị cố định kiểu chuỗi "me", cho biết người dùng đưa ra yêu cầu
  • giá trị cố định kiểu chuỗi "-", cho biết cần trả về kết quả cho tất cả học viên mà người dùng yêu cầu có quyền truy cập để xem.

Tham số truy vấn

Tham số
invitedEmailAddress

string

Lọc kết quả theo địa chỉ email nhận được lời mời ban đầu để tạo ra đường liên kết dành cho người giám hộ này. Chỉ quản trị viên miền mới có thể sử dụng bộ lọc này.
pageToken

string

Giá trị nextPageToken được trả về từ lệnh gọi list trước đó, cho biết cần trả về trang kết quả tiếp theo.

Nếu không, yêu cầu list phải giống với yêu cầu đã tạo ra mã thông báo này.
pageSize

integer

Số mục tối đa cần trả về. Số không hoặc chưa được chỉ định cho biết máy chủ có thể chỉ định số tiền tối đa.

Máy chủ có thể trả về ít kết quả hơn số lượng kết quả đã chỉ định.

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

Phản hồi khi liệt kê người giám hộ.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "guardians": [
    {
      object (Guardian)
    }
  ],
  "nextPageToken": string
}
Trường
guardians[]

object (Guardian)

Những người giám hộ trên trang kết quả này đã đáp ứng các tiêu chí được chỉ định trong yêu cầu.
nextPageToken

string

Mã thông báo xác định trang kết quả tiếp theo cần trả về. Nếu trống, không có thêm kết quả nào.

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.me.readonly
  • 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.