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 フォトの 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 です。

メソッド

get

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

join

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

leave

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

list

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