Method: albums.list

Liệt kê tất cả album mà người dùng nhìn thấy trong thẻ Album của ứng dụng Google Photos.

Yêu cầu HTTP

GET https://photoslibrary.googleapis.com/v1/albums

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

Tham số truy vấn

Thông số
pageSize

integer

Số lượng album tối đa cần trả về trong phản hồi. Có thể trả về ít anbom hơn so với số lượng đã chỉ định. pageSize mặc định là 20 và tối đa là 50.
pageToken

string

Mã thông báo tiếp tục để xem trang kết quả tiếp theo. Việc thêm mã này vào yêu cầu sẽ trả về các hàng sau pageToken. pageToken phải là giá trị được trả về trong tham số nextPageToken khi phản hồi yêu cầu listAlbums.
excludeNonAppCreatedData

boolean

Nếu bạn đặt chính sách này, kết quả sẽ loại trừ những mục nội dung nghe nhìn không phải do ứng dụng này tạo ra. Giá trị mặc định là false (tất cả album đều được trả về). Trường này sẽ bị bỏ qua nếu bạn sử dụng phạm vi photoslibrary.readonly.app tạodata.

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

Danh sách album đã yêu cầu.

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

object (Album)

Chỉ có đầu ra. Danh sách album xuất hiện trong thẻ Album của ứng dụng Google Photos của người dùng.
nextPageToken

string

Chỉ có đầu ra. Mã thông báo dùng để tải tập hợp album tiếp theo. Được điền sẵn nếu có thêm album cần truy xuất cho yêu cầu này.

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/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata