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 des Albums. Dies ist eine dauerhafte Kennung, die zwischen Sitzungen verwendet werden kann, um dieses Album zu identifizieren.
title

string

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

string

[Nur Ausgabe] Google Fotos-URL des Albums. 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. Wenn die Bereiche oder Berechtigungen des Albums geändert werden, wird dieses Feld aktualisiert.
shareInfo

object (ShareInfo)

[Nur Ausgabe] Informationen zu geteilten Alben. Dieses Feld wird nur gefü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 Titelbildes. Verwenden Sie diesen Parameter nicht in der vorliegenden Form. Parameter sollten vor der Verwendung an diese URL angehängt werden. Eine vollständige Liste der unterstützten Parameter finden Sie in der Entwicklerdokumentation. Zum Beispiel legt '=w2048-h1024' die Abmessungen des Titelbilds auf eine Breite von 2.048 Pixel und eine Höhe von 1.024 Pixel fest.
coverPhotoMediaItemId

string

ID des Medienelements, das mit dem Titelbild verknüpft ist.

ShareInfo

Informationen zu geteilten Alben. Diese Informationen sind nur sichtbar, wenn Sie das Album erstellt haben, es freigegeben ist und Sie Freigabeberechtigungen haben.

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

object (SharedAlbumOptions)

Mit diesen Optionen wird festgelegt, ob jemand Medienelemente zu einem geteilten Album hinzufügen oder dieses kommentieren darf.
shareableUrl

string

Ein Link zum geteilten Google Fotos-Album. Jeder, der über den Link verfügt, kann den Inhalt des Albums sehen, Sie sollten also vorsichtig vorgehen.

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 über die productUrl des Albums darauf zugreifen.

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

string

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

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

boolean

„True“, wenn der Nutzer dem Album beigetreten ist. Dies gilt immer für den Besitzer des Albums.
isOwned

boolean

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

boolean

True, wenn dem Album Nutzer hinzugefügt werden können.

SharedAlbumOptions

Optionen, die das Teilen eines Albums steuern.

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

boolean

Dieser Wert ist „True“, wenn Mitbearbeiter (Nutzer, die dem Album beigetreten sind) im geteilten Album Medienelemente hinzufügen können. Die Standardeinstellung ist "false".
isCommentable

boolean

True, wenn Mitbearbeiter, also Nutzer, die dem Album beigetreten sind, im geteilten Album Kommentare zum Album hinzufügen können. Die Standardeinstellung ist "false".

Methoden

addEnrichment

 Fügt in einem definierten Album an einer bestimmten Position eine Anreicherung hinzu.

batchAddMediaItems

 Fügt einem Album ein oder mehrere Medienelemente aus der Google Fotos-Galerie eines Nutzers hinzu.

batchRemoveMediaItems

 Entfernt ein oder mehrere Medienelemente aus dem angegebenen Album.

create

 Ein Album wird in der Google Fotos-Galerie eines Nutzers erstellt.

get

 Gibt das Album basierend auf dem angegebenen albumId zurück.

list

 Listet alle Alben auf, die Nutzern auf dem Tab „Alben“ in der Google Fotos App angezeigt werden.

patch

 Aktualisiere das Album mit der angegebenen id.

share

 Kennzeichnet ein Album als freigegeben und für andere Nutzer zugänglich.

unshare

 Kennzeichnet ein zuvor geteiltes Album als privat.