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 px(宽)x 1024 px(高)。

coverPhotoMediaItemId

string

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

方法

get

根据指定的 shareToken 返回影集。

join

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

leave

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

list

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