REST Resource: sharedAlbums

Tài nguyên: Đĩa nhạc

Hình ảnh đại diện cho một album trong Google Photos. Album là vùng chứa cho các mục nội dung nghe nhìn. Nếu ứng dụng đã chia sẻ một album, thì album đó sẽ chứa thêm một thuộc tính shareInfo.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
Trường
id

string

Giá trị nhận dạng cho album. Đây là giá trị nhận dạng cố định có thể dùng giữa các phiên để xác định album này.

title

string

Tên của album hiển thị cho người dùng trong tài khoản Google Photos của họ. Chuỗi này không được dài quá 500 ký tự.

productUrl

string

[Chỉ đầu ra] URL trên Google Photos của album. Người dùng cần đăng nhập vào tài khoản Google Photos của họ để truy cập được đường liên kết này.

isWriteable

boolean

[Chỉ có giá trị đầu ra] Đúng nếu bạn có thể tạo các mục nội dung nghe nhìn trong album này. Trường này dựa trên các phạm vi đã cấp và các quyền đối với album. Nếu phạm vi hoặc quyền của album thay đổi, trường này sẽ được cập nhật.

shareInfo

object (ShareInfo)

[Chỉ có đầu ra] Thông tin liên quan đến album chia sẻ. Trường này chỉ được điền sẵn nếu album là album chia sẻ, nhà phát triển đã tạo album và người dùng đã cấp phạm vi photoslibrary.sharing.

mediaItemsCount

string (int64 format)

[Chỉ có giá trị đầu ra] Số lượng mục nội dung nghe nhìn trong đĩa nhạc.

coverPhotoBaseUrl

string

[Chỉ đầu ra] URL tới byte của ảnh bìa. Bạn không nên sử dụng nguyên trạng này. Bạn phải nối thông số vào URL này trước khi sử dụng. Hãy xem tài liệu dành cho nhà phát triển để biết danh sách đầy đủ các tham số được hỗ trợ. Ví dụ: '=w2048-h1024' đặt kích thước của ảnh bìa có chiều rộng là 2048 px và chiều cao là 1024 px.

coverPhotoMediaItemId

string

Giá trị nhận dạng cho mục nội dung đa phương tiện được liên kết với ảnh bìa.

Phương thức

get

Trả về đĩa nhạc dựa trên shareToken đã chỉ định.

join

Tham gia một album chia sẻ thay mặt cho người dùng Google Photos.

leave

Rời khỏi một album chia sẻ đã tham gia trước đó thay mặt cho người dùng Google Photos.

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.