Method: users.settings.cse.identities.list

Liệt kê danh tính được mã hoá phía máy khách của người dùng đã xác thực.

Yêu cầu HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities

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

Tham số đường dẫn

Tham số
userId

string

Địa chỉ email chính của người yêu cầu. Để cho biết người dùng được xác thực, bạn có thể sử dụng giá trị đặc biệt me.

Tham số truy vấn

Tham số
pageToken

string

Mã thông báo phân trang cho biết cần trả lại trang có danh tính nào. Nếu mã thông báo không được cung cấp, thì API sẽ trả về trang kết quả đầu tiên.
pageSize

integer

Số lượng danh tính cần trả về. Nếu không được cung cấp, kích thước trang sẽ mặc định là 20 mục nhập.

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, 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 
{
  "cseIdentities": [
    {
      object (CseIdentity)
    }
  ],
  "nextPageToken": string
}
Trường
cseIdentities[]

object (CseIdentity)

Một trang trong danh sách danh tính CSE được định cấu hình cho người dùng.
nextPageToken

string

Mã thông báo phân trang cần được truyền đến lệnh gọi identifier.list tiếp theo để truy xuất trang danh tính tiếp theo. Nếu giá trị này không được trả về hoặc là chuỗi trống, thì sẽ không còn trang nào nữa.

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/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.settings.sharing

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