REST Resource: mediaItems

Ressource: MediaItem

Darstellung eines Medienelements (z. B. eines Fotos oder Videos) in Google Fotos.

JSON-Darstellung 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
Felder
id

string

Kennung für das Medienelement. Dies ist eine dauerhafte Kennung, die zwischen Sitzungen verwendet werden kann, um dieses Medienelement zu identifizieren.
description

string

Beschreibung des Medienelements. Sie wird dem Nutzer in der Google Fotos App im Bereich „Info“ des Artikels angezeigt. Muss kürzer als 1.000 Zeichen sein. Fügen Sie nur von Nutzern verfassten Text ein. Beschreibungen sollten Kontext bieten und Nutzern helfen, Medien zu verstehen. Verwenden Sie keine automatisch generierten Strings wie Dateinamen, Tags und andere Metadaten.
productUrl

string

Google Fotos-URL für das Medienelement. Dieser Link ist nur für Nutzer verfügbar, die angemeldet sind. Bei Abruf aus einer Albumsuche verweist die URL auf das Element im Album.
baseUrl

string

Eine URL zu den Bytes des Medienelements. 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 eines Medienelements des Typs „Foto“ auf eine Breite von 2.048 px und eine Höhe von 1.024 px festgelegt.
mimeType

string

MIME-Typ des Medienelements. Beispiel: image/jpeg.
mediaMetadata

object (MediaMetadata)

Metadaten des Medienelements, z. B. Höhe, Breite oder Erstellungszeit.
contributorInfo

object (ContributorInfo)

Informationen zum Nutzer, der dieses Medienelement hinzugefügt hat. Dies gilt nur, wenn Sie mediaItems.search mit der ID eines geteilten Albums verwenden. Das Album muss von Ihrer App erstellt werden und Sie müssen die Freigabeberechtigung haben.
filename

string

Dateiname des Medienelements. Sie wird dem Nutzer in der Google Fotos App im Bereich „Info“ des Artikels angezeigt.

MediaMetadata

Metadaten für ein Medienelement.

JSON-Darstellung 
{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}
Felder
creationTime

string (Timestamp format)

Zeitpunkt, zu dem das Medienelement erstellt wurde (nicht der Zeitpunkt, zu dem es auf Google Fotos hochgeladen wurde).

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
width

string (int64 format)

Ursprüngliche Breite (in Pixeln) des Medienelements
height

string (int64 format)

Die ursprüngliche Höhe (in Pixeln) des Medienelements.
Union-Feld metadata. Metadaten für das Medienelement, die für den zugrunde liegenden Medientyp spezifisch sind, den es repräsentiert. Für metadata ist nur einer der folgenden Werte zulässig:
photo

object (Photo)

Metadaten für einen Fotomedientyp.
video

object (Video)

Metadaten für einen Videomedientyp.

Foto

Fotospezifische Metadaten wie ISO, Brennweite und Belichtungszeit. Einige dieser Felder können null sein oder nicht enthalten.

JSON-Darstellung 
{
  "cameraMake": string,
  "cameraModel": string,
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Felder
cameraMake

string

Marke der Kamera, mit der das Foto aufgenommen wurde.
cameraModel

string

Modell der Kamera, mit der das Foto aufgenommen wurde.
focalLength

number

Brennweite des Kameraobjektivs, mit dem das Foto aufgenommen wurde.
apertureFNumber

number

Blende f-Nummer des Kameraobjektivs, mit dem das Foto aufgenommen wurde.
isoEquivalent

integer

ISO der Kamera, mit der das Foto aufgenommen wurde.
exposureTime

string (Duration format)

Belichtungszeit der Kamerablende bei der Aufnahme des Fotos.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

Video

Videospezifische Metadaten, z. B. fps und Verarbeitungsstatus. Einige dieser Felder sind möglicherweise leer oder nicht enthalten.

JSON-Darstellung 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
Felder
cameraMake

string

Marke der Kamera, mit der das Video aufgenommen wurde
cameraModel

string

Modell der Kamera, mit der das Video aufgenommen wurde.
fps

number

Framerate des Videos.
status

enum (VideoProcessingStatus)

Verarbeitungsstatus des Videos.

VideoProcessingStatus

Verarbeitungsstatus eines Videos, das in Google Fotos hochgeladen wird.

Enums
UNSPECIFIED Der Status der Videoverarbeitung ist unbekannt.
PROCESSING Das Video wird verarbeitet. Der Nutzer sieht ein Symbol für dieses Video in der Google Fotos App. kann aber noch nicht abgespielt werden.
READY Die Videoverarbeitung ist abgeschlossen und das Video kann jetzt angesehen werden. Wichtig: Der Versuch, ein Video herunterzuladen, das nicht den Status BEREIT hat, kann fehlschlagen.
FAILED Ein Fehler ist aufgetreten und das Video konnte nicht verarbeitet werden.

ContributorInfo

Informationen zu dem Nutzer, der das Medienelement hinzugefügt hat. Diese Informationen sind nur enthalten, wenn sich das Medienelement in einem geteilten Album befindet, das von Ihrer App erstellt wurde, und Sie die Freigabeberechtigung haben.

JSON-Darstellung 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
Felder
profilePictureBaseUrl

string

URL zum Profilbild des Beitragenden.
displayName

string

Anzeigename des Beitragenden.

Methoden

batchCreate

 Es werden mindestens ein Medienelement in der Google Fotos-Mediathek eines Nutzers erstellt.

batchGet

 Gibt die Liste der Medienelemente für die angegebenen Medienelement-IDs zurück.

get

 Gibt das Medienelement für die angegebene Medienelement-ID zurück.

list

 Hiermit werden alle Medienelemente aus der Google Fotos-Galerie eines Nutzers aufgelistet.

patch

 Aktualisiere das Medienelement mit der angegebenen id.
Es wird in der Google Fotos-Mediathek eines Nutzers nach Medienelementen gesucht.