REST Resource: albums

资源：影集

表示 Google 相册中的影集。影集是媒体内容的容器。如果应用分享影集，则该影集会包含一个额外的 shareInfo 属性。

JSON 表示法 
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
字段
id

string

影集的标识符。这是一个永久标识符，可用于在会话之间标识此影集。
title

string

用户在 Google 相册账号中看到的影集名称。此字符串不应超过 500 个字符。
productUrl

string

[仅限输出] 影集的 Google 相册网址。用户需要登录 Google 相册账号才能访问此链接。
isWriteable

boolean

[仅限输出] 如果您可以在此影集中创建媒体内容，则为 true。此字段取决于授予的范围和影集的权限。如果范围或影集的权限发生更改，此字段会更新。
shareInfo

object (ShareInfo)

[仅限输出] 与共享影集相关的信息。仅当该影集为共享影集、其创建者为开发者，且用户已向 photoslibrary.sharing 范围授权时，系统才会填充此字段。
mediaItemsCount

string (int64 format)

[仅限输出] 影集中的媒体内容数量。
coverPhotoBaseUrl

string

[仅限输出] 指向封面照片字节的网址。请勿直接使用此参数。参数在使用前应附加到此网址。如需查看所支持参数的完整列表，请参阅开发者文档。例如，'=w2048-h1024' 会将封面照片的尺寸设置为 2048 像素（宽）和 1024 像素（高）。
coverPhotoMediaItemId

string

与封面照片相关联的媒体内容的标识符。

ShareInfo

分享的影集的相关信息。只有您创建影集、已与他人共享影集并且您拥有共享范围时，此信息才会包含在其中。

JSON 表示法 
{
  "sharedAlbumOptions": {
    object (SharedAlbumOptions)
  },
  "shareableUrl": string,
  "shareToken": string,
  "isJoined": boolean,
  "isOwned": boolean,
  "isJoinable": boolean
}
字段
sharedAlbumOptions

object (SharedAlbumOptions)

用于控制用户能否向共享影集中添加媒体内容或发表评论的选项。
shareableUrl

string

指向共享的 Google 相册影集的链接。知道链接的任何人都可以查看影集内容，因此请谨慎分享。

只有在影集启用了链接共享功能的情况下，系统才会返回 shareableUrl 参数。如果用户已加入不是通过链接共享的影集，则可以改用该影集的productUrl来访问该影集。

如果所有者在 Google 相册应用中关闭链接分享功能，或者影集取消分享，shareableUrl 将失效。
shareToken

string

用于代表用户（非所有者）加入、退出或检索共享影集详细信息的令牌。

如果所有者在 Google 相册应用中关闭链接分享功能，或者影集取消分享，shareToken 将失效。
isJoined

boolean

如果用户已加入影集，则为 true。对于影集的所有者来说，始终是如此。
isOwned

boolean

如果用户是影集的所有者，则为“true”。
isJoinable

boolean

如果用户可以加入影集，则为“true”。

SharedAlbumOptions

用于控制影集分享的选项。

JSON 表示法 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
字段
isCollaborative

boolean

如果共享影集允许协作者（已加入影集的用户）在其中添加媒体内容，则为“true”。默认值为 false。
isCommentable

boolean

如果共享影集允许协作者（已加入影集的用户）向影集添加评论，则为“true”。默认值为 false。

方法

addEnrichment

 在指定影集中的指定位置添加扩充项。

batchAddMediaItems

 将用户 Google 相册媒体库中的一项或多项媒体内容添加到影集。

batchRemoveMediaItems

 从指定影集中移除一项或多项媒体内容。

create

 在用户的 Google 相册媒体库中创建影集。

get

 根据指定的 albumId 返回影集。

list

 列出 Google 相册应用的“影集”标签页中向用户显示的所有影集。

patch

 使用指定的 id 更新影集。

share

 将影集标记为共享影集，以供其他用户访问。

unshare

 将先前的共享影集标记为不公开。