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

batchRemoveMediaItems

create

get

list

patch

 使用指定的 id 更新影集。

share

unshare