REST Resource: sharedAlbums

リソース: Album

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 フォトの URL。ユーザーがこのリンクにアクセスするには、Google フォトのアカウントにログインする必要があります。

isWriteable

boolean

[出力のみ] このアルバム内にメディア アイテムを作成できる場合は true。このフィールドは、付与されるスコープとアルバムの権限に基づきます。スコープが変更されたり、アルバムの権限が変更されたりすると、このフィールドが更新されます。

shareInfo

object (ShareInfo)

[出力専用] 共有アルバムに関する情報。このフィールドが入力されるのは、アルバムが共有アルバムであり、デベロッパーがアルバムを作成し、ユーザーが photoslibrary.sharing スコープを付与している場合のみです。

mediaItemsCount

string (int64 format)

[出力専用] アルバム内のメディア アイテムの数。

coverPhotoBaseUrl

string

[出力専用] カバー写真のバイトへの URL。これをそのまま使用しないでください。使用する前に、この URL にパラメータを追加する必要があります。サポートされているパラメータの一覧については、デベロッパー向けドキュメントをご覧ください。たとえば、'=w2048-h1024' と指定すると、カバー写真のサイズは、幅 2,048 ピクセル、高さ 1,024 ピクセルに設定されます。

coverPhotoMediaItemId

string

カバー写真に関連付けられているメディア アイテムの ID です。

Methods

get

指定した shareToken に基づいてアルバムを返します。

join

Google フォトのユーザーに代わって共有アルバムに参加します。

leave

Google フォトのユーザーに代わって参加中の共有アルバムから退出します。

list

ユーザーの Google フォト アプリの [共有] タブで利用できるすべての共有アルバムを一覧表示します。