REST Resource: albums

资源：影集
方法

资源：影集

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

JSON 表示法

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

{
  "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。

isCollaborative

boolean

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

isCommentable

boolean

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

方法
`addEnrichment`	在指定影集中的指定位置添加扩充项。
`batchAddMediaItems`	将用户 Google 相册媒体库中的一项或多项媒体内容添加到影集。
`batchRemoveMediaItems`	从指定影集中移除一项或多项媒体内容。
`create`	在用户的 Google 相册媒体库中创建影集。
`get`	根据指定的 `albumId` 返回影集。
`list`	列出 Google 相册应用的“影集”标签页中向用户显示的所有影集。
`patch`	使用指定的 `id` 更新影集。
`share`	将影集标记为共享影集，以供其他用户访问。
`unshare`	将先前的共享影集标记为不公开。

REST Resource: albums

资源：影集

ShareInfo

SharedAlbumOptions

方法

`addEnrichment`

`batchAddMediaItems`

`batchRemoveMediaItems`

`create`

`get`

`list`

`patch`

`unshare`