- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Hãy làm thử!
Liệt kê các danh tính được mã hoá phía máy khách của một 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
Các tham số | |
---|---|
userId |
Địa chỉ email chính của người yêu cầu. Để cho biết người dùng đã xác thực, bạn có thể sử dụng giá trị đặc biệt |
Tham số truy vấn
Các tham số | |
---|---|
pageToken |
Mã thông báo phân trang cho biết trang danh tính sẽ trả về. Nếu không cung cấp mã thông báo thì API sẽ trả về trang kết quả đầu tiên. |
pageSize |
Số nhận dạng 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. |
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 ( |
Các trường | |
---|---|
cseIdentities[] |
Một trang về danh sách các mã nhận dạng CSE được định cấu hình cho người dùng. |
nextPageToken |
Mã thông báo phân trang được chuyển đến một lệnh gọiCs.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à một 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.