REST Resource: albums

Ressource: Album

Darstellung eines Albums in Google Fotos Alben sind Container für Medienelemente. Wenn ein Album von der Anwendung geteilt wurde, enthält es eine zusätzliche shareInfo-Eigenschaft.

JSON-Darstellung 
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
Felder
id

string

ID für das Album. Dies ist eine dauerhafte ID, die zwischen Sitzungen verwendet werden kann, um dieses Album zu identifizieren.
title

string

Name des Albums, das der Nutzer in seinem Google Fotos-Konto sieht. Dieser String darf maximal 500 Zeichen lang sein.
productUrl

string

[Nur Ausgabe] Google Fotos-URL für das Album. Der Nutzer muss in seinem Google Fotos-Konto angemeldet sein, um auf diesen Link zugreifen zu können.
isWriteable

boolean

[Nur Ausgabe] "True", wenn Sie in diesem Album Medienelemente erstellen können. Dieses Feld basiert auf den gewährten Bereichen und Berechtigungen des Albums. Dieses Feld wird aktualisiert, wenn Bereiche oder Berechtigungen für das Album geändert werden.
shareInfo

object (ShareInfo)

[Nur Ausgabe] Informationen zu geteilten Alben. Dieses Feld wird nur ausgefüllt, wenn das Album ein geteiltes Album ist, der Entwickler das Album erstellt hat und der Nutzer den Bereich photoslibrary.sharing gewährt hat.
mediaItemsCount

string (int64 format)

[Nur Ausgabe] Die Anzahl der Medienelemente im Album.
coverPhotoBaseUrl

string

[Nur Ausgabe] Eine URL zu den Byte des Titelbilds. Sollte nicht in der vorliegenden Form verwendet werden. Parameter müssen vor der Verwendung an diese URL angehängt werden. Eine vollständige Liste der unterstützten Parameter finden Sie in der Entwicklerdokumentation. Mit '=w2048-h1024' werden beispielsweise die Abmessungen des Titelbilds auf eine Breite von 2.048 Pixel und eine Höhe von 1.024 Pixel festgelegt.
coverPhotoMediaItemId

string

ID des Medienelements, das dem Titelbild zugeordnet ist.

ShareInfo

Informationen zu geteilten Alben Diese Informationen werden nur angegeben, wenn Sie das Album erstellt haben, es freigegeben ist und Sie den Freigabebereich haben.

JSON-Darstellung 
{
  "sharedAlbumOptions": {
    object (SharedAlbumOptions)
  },
  "shareableUrl": string,
  "shareToken": string,
  "isJoined": boolean,
  "isOwned": boolean,
  "isJoinable": boolean
}
Felder
sharedAlbumOptions

object (SharedAlbumOptions)

Optionen, mit denen festgelegt wird, ob andere Personen einem geteilten Album Medienelemente hinzufügen oder es kommentieren dürfen.
shareableUrl

string

Ein Link zum geteilten Google Fotos-Album. Jeder, der über den Link verfügt, kann auf den Inhalt des Albums zugreifen. Daher sollten Sie mit dem Inhalt vorsichtig umgehen.

Der Parameter shareableUrl wird nur zurückgegeben, wenn für das Album die Linkfreigabe aktiviert ist. Wenn ein Nutzer bereits einem Album ohne Linkfreigabe beigetreten ist, kann er stattdessen das productUrl des Albums verwenden, um darauf zuzugreifen.

shareableUrl wird ungültig, wenn der Inhaber die Linkfreigabe in der Google Fotos App deaktiviert oder wenn das Album nicht mehr geteilt wird.
shareToken

string

Ein Token, das verwendet wird, um einem geteilten Album im Namen eines Nutzers, der nicht der Inhaber ist, beizutreten, diese zu verlassen oder die Details eines geteilten Albums abzurufen.

shareToken wird ungültig, wenn der Inhaber die Linkfreigabe in der Google Fotos App deaktiviert oder wenn das Album nicht mehr geteilt wird.
isJoined

boolean

"True", wenn der Nutzer dem Album beigetreten ist. Dies gilt immer für den Eigentümer des Albums.
isOwned

boolean

"True", wenn das Album dem Nutzer gehört.
isJoinable

boolean

Dieser Wert ist "True", wenn Nutzer dem Album beitreten können.

SharedAlbumOptions

Optionen, die das Teilen eines Albums steuern.

JSON-Darstellung 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
Felder
isCollaborative

boolean

"True", wenn das geteilte Album Mitbearbeitern (Nutzern, die dem Album beigetreten sind) erlauben, ihm Medienelemente hinzuzufügen. Die Standardeinstellung ist "false".
isCommentable

boolean

"True", wenn das geteilte Album Mitbearbeitern (Nutzern, die dem Album beigetreten sind) erlauben, dem Album Kommentare hinzuzufügen. Die Standardeinstellung ist "false".

Methoden

addEnrichment

batchAddMediaItems

batchRemoveMediaItems

create

get

list

patch

 Aktualisiert das Album mit der angegebenen id.

share

unshare