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

ID 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. Schließen Sie nur Text ein, der von Nutzern geschrieben wurde. 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 zu dem 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 den Freigabebereich 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 zum ersten Mal erstellt wurde (nicht, wann es in 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)

Ursprüngliche Höhe des Medienelements (in Pixeln)
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

Metadaten, die für ein Foto spezifisch sind, z. B. ISO, Brennweite und Belichtungszeit. Einige dieser Felder sind möglicherweise leer 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 können null sein 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 Verarbeitungsstatus des Videos 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 Verarbeitung des Videos ist abgeschlossen und 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. Beachten Sie, dass diese Informationen nur eingeschlossen werden, wenn sich das Medienelement in einem geteilten Album befindet, das von Ihrer App erstellt wurde, und wenn Sie den Freigabebereich haben.

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

string

URL zum Profilbild des Mitwirkenden.
displayName

string

Anzeigename des Beitragenden.

Methoden

batchCreate

batchGet

get

list

patch

 Aktualisiere das Medienelement mit der angegebenen id.