REST Resource: sharedAlbums

资源:影集

表示 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

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

方法

get

根据指定的 shareToken 返回影集。

join

代表 Google 相册用户加入共享影集。

leave

代表 Google 相册用户退出先前加入的共享影集。

list

列出用户 Google 相册应用“分享”标签页中提供的所有共享影集。