REST Resource: mediaItems

Ressource: MediaItem

Darstellung eines Medienelements in Google Fotos, z. B. eines Fotos oder Videos.

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

string

ID des Medienelements. Dies ist eine dauerhafte Kennung, die zwischen Sitzungen verwendet werden kann, um dieses Medienelement zu identifizieren.
description

string

Beschreibung des Medienelements. Diese Information wird dem Nutzer in der Google Fotos App unter den Informationen zum Objekt angezeigt. Sie darf maximal 1.000 Zeichen lang sein. Verwenden Sie nur Text, der von Nutzern geschrieben wurde. Beschreibungen sollten Kontext bieten und Nutzern helfen, die Medien zu verstehen. Verwenden Sie keine automatisch generierten Strings wie Dateinamen, Tags und andere Metadaten.
productUrl

string

Google Fotos-URL des Medienelements. Dieser Link ist für Nutzer nur verfügbar, wenn sie angemeldet sind. Wenn die URL aus einer Albumsuche abgerufen wird, verweist sie auf das Element im Album.
baseUrl

string

Eine URL zu den Bytes des Medienelements. 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 eines Medienelements vom Typ „Foto“ auf eine Breite von 2.048 Pixel und eine Höhe von 1.024 Pixeln fest.
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. Hinweis: Dieser Wert ist nur enthalten, wenn du mediaItems.search mit der ID eines geteilten Albums verwendest. Das Album muss von Ihrer App erstellt werden und Sie müssen Freigabeberechtigungen haben.
filename

string

Dateiname des Medienelements. Diese wird dem Nutzer im Infobereich des Artikels in der Google Fotos App 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 erstmals erstellt wurde (nicht zu dem Zeitpunkt, zu dem es in Google Fotos hochgeladen wurde).

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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 des Medienelements, die für den zugrunde liegenden Medientyp spezifisch sind. Für metadata ist nur einer der folgenden Werte zulässig:
photo

object (Photo)

Metadaten für einen Foto-Medientyp.
video

object (Video)

Metadaten für einen Videomedientyp.

Foto

Metadaten, die für ein Foto spezifisch sind, wie ISO, Brennweite und Belichtungszeit. Einige dieser Felder sind möglicherweise null 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

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

number

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

number

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

integer

ISO-Wert der Kamera, mit der das Foto aufgenommen wurde
exposureTime

string (Duration format)

Belichtungszeit der Blende der Kamera zum Zeitpunkt der Aufnahme.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

Video

Videospezifische Metadaten, z. B. Bilder pro Sekunde und Verarbeitungsstatus. Einige dieser Felder sind möglicherweise null 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

Das 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. Es kann jedoch noch nicht abgespielt werden.
READY Die Verarbeitung des Videos ist abgeschlossen und kann jetzt wiedergegeben 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 angezeigt werden, wenn sich das Medienelement in einem geteilten Album befindet, das von Ihrer App erstellt wurde, und Sie Freigabeberechtigungen haben.

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

string

URL zum Profilbild des Beitragenden.
displayName

string

Anzeigename des Beitragenden.

Methoden

batchCreate

 Erstellt ein oder mehrere Medienelemente in der Google Fotos-Galerie eines Nutzers.

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

 Aktualisiert das Medienelement mit der angegebenen id.
Sucht in der Google Fotos-Galerie eines Nutzers nach Medienelementen