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
Tham số | |
---|---|
pageSize |
Số lượng album tối đa trả về trong phản hồi. Có thể trả về ít album hơn số lượng đã chỉ định. Giá trị mặc định |
pageToken |
Mã thông báo tiếp tục để xem trang tiếp theo của kết quả. Việc thêm đoạn mã này vào yêu cầu sẽ trả về các hàng sau |
excludeNonAppCreatedData |
Nếu bạn đặt chính sách này, kết quả sẽ loại trừ các mục nội dung nghe nhìn không do ứng dụng này tạo. 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 phạm vi photoslibrary.readonly.appcreateddata được sử dụng. |
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 được 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 ( |
Trường | |
---|---|
albums[] |
Chỉ có đầu ra. Danh sách album hiển thị trong thẻ Album trong ứng dụng Google Photos của người dùng. |
nextPageToken |
Chỉ có đầu ra. Mã thông báo được sử dụng để tải nhóm album tiếp theo. Được điền sẵn nếu có nhiều 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 đây:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata