Method: sharedAlbums.list

Liệt kê tất cả album được chia sẻ có trong thẻ Chia sẻ của ứng dụng Google Photos của người dùng.

Yêu cầu HTTP

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

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

Tham số truy vấn

Tham số
pageSize

integer

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

pageToken

string

Mã thông báo tiếp tục để nhận trang tiếp theo của kết quả. Việc thêm thông tin 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 trong phản hồi cho yêu cầu listSharedAlbums.

excludeNonAppCreatedData

boolean

Nếu được đặt, kết quả sẽ loại trừ các mục nội dung nghe nhìn không phải do ứng dụng này tạo. 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.appcreateddata.

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 chia sẻ mà bạn 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
{
  "sharedAlbums": [
    {
      object (Album)
    }
  ],
  "nextPageToken": string
}
Trường
sharedAlbums[]

object (Album)

Chỉ có đầu ra. Danh sách album được chia sẻ.

nextPageToken

string

Chỉ có đầu ra. Mã thông báo dùng để nhận nhóm album chia sẻ tiếp theo. Được điền nếu có thêm album được chia sẻ 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals