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. Dieser wird Nutzern in der Google Fotos App im Infobereich des Elements angezeigt. Er darf maximal 1.000 Zeichen lang sein. Fügen Sie nur von Nutzern verfassten Text ein. Beschreibungen sollten Kontext bieten und Nutzern helfen, Medien zu verstehen. Fügen Sie keine automatisch generierten Strings wie Dateinamen, Tags und andere Metadaten ein.
productUrl

string

Google Fotos-URL für das Medienelement. Dieser Link ist nur für Nutzer verfügbar, die angemeldet sind. Wenn die URL über eine Albumsuche abgerufen wird, verweist sie auf das Element im Album.
baseUrl

string

Eine URL zu den Bytes des Medienelements. Diese URL sollte nicht unverändert verwendet werden. Vor der Verwendung sollten Parameter an sie 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 vom Typ „Foto“ auf 2.048 × 1.024 Pixel festgelegt.
mimeType

string

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

object (MediaMetadata)

Metadaten zum Medienelement, z. B. Höhe, Breite oder Erstellungszeit.
contributorInfo

object (ContributorInfo)

Informationen zum Nutzer, der dieses Medienelement hinzugefügt hat. Hinweis: Dieser Wert wird nur berücksichtigt, wenn mediaItems.search mit der ID eines geteilten Albums verwendet wird. Das Album muss von Ihrer App erstellt werden und Sie müssen die Freigabeberechtigung haben.
filename

string

Dateiname des Medienelements. Diese Informationen werden dem Nutzer in der Google Fotos App im Infobereich 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).

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
width

string (int64 format)

Die 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. 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 Video-Medientyp.

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

Die Blendenzahl 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 in der Google Fotos App ein Symbol für dieses Video, es kann jedoch noch nicht wiedergegeben werden.
READY Die Videoverarbeitung ist abgeschlossen und das Video kann jetzt angesehen werden. Wichtig: Der Download eines Videos, das sich nicht im Status „BEREIT“ befindet, kann fehlschlagen.
FAILED Ein Fehler ist aufgetreten und das Video konnte nicht verarbeitet werden.

ContributorInfo

Informationen zum 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 Mitwirkenden.
displayName

string

Der Anzeigename des Mitwirkenden.

Methoden

batchCreate

batchGet

get

list

patch

 Aktualisiert das Medienelement mit der angegebenen id.