REST Resource: mediaItems

Ressource: PickedMediaItem

Darstellung eines vom Nutzer ausgewählten Fotos oder Videos.

JSON-Darstellung 
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
Felder
id

string

Kennung für das Medienelement.

Dies ist eine dauerhafte Kennung, die zwischen Sitzungen verwendet werden kann, um dieses Media-Element zu identifizieren.
createTime

string (Timestamp format)

Der Zeitpunkt, zu dem das Media-Element erstellt wurde (nicht der Zeitpunkt, zu dem es in Google Fotos hochgeladen wurde).

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
type

enum (Type)

Der Typ dieses Medienelements.
mediaFile

object (MediaFile)

Die Mediendatei, aus der dieses Medienelement besteht.

Typ

Der Typ eines Medienelements.

Enums
TYPE_UNSPECIFIED Der Typ ist nicht angegeben.
PHOTO Das Medienelement stellt ein Foto dar.
VIDEO Das Medienelement ist ein Video.

MediaFile

Darstellung einer Mediendatei

JSON-Darstellung 
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
Felder
baseUrl

string

Eine URL zum Abrufen der Bytes der Mediendatei.

Zum Herunterladen einer Mediendatei muss der API-Client dieser URL die in der Entwicklerdokumentation angegebenen Parameter hinzufügen.

Mit '=w2048-h1024' werden beispielsweise die Abmessungen eines Media-Elements vom Typ „Foto“ auf eine Breite von 2.048 Pixel und eine Höhe von 1.024 Pixel festgelegt.
mimeType

string

MIME-Typ der Mediadatei. Beispiel: image/jpeg.
filename

string

Dateiname der Mediendatei.
mediaFileMetadata

object (MediaFileMetadata)

Metadaten zur Media-Datei, z. B. Höhe und Breite.

MediaFileMetadata

Metadaten zu einer Mediendatei.

JSON-Darstellung 
{
  "width": integer,
  "height": integer,
  "cameraMake": string,
  "cameraModel": string,

  // Union field metadata can be only one of the following:
  "photoMetadata": {
    object (PhotoMetadata)
  },
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
Felder
width

integer

Die ursprüngliche Breite der Media-Datei in Pixeln.
height

integer

Originalhöhe der Media-Datei in Pixeln.
cameraMake

string

Marke der Kamera, mit der die Medien aufgenommen wurden.
cameraModel

string

Modell der Kamera, mit der die Medien aufgenommen wurden.
Union-Feld metadata. Metadaten für die Mediendatei, die für den jeweiligen Medientyp spezifisch sind. Für metadata ist nur einer der folgenden Werte zulässig:
photoMetadata

object (PhotoMetadata)

Metadaten für einen Fotomedientyp.
videoMetadata

object (VideoMetadata)

Metadaten für einen Videomedientyp.

PhotoMetadata

Metadaten, die sich auf ein bestimmtes Foto beziehen, z. B. ISO, Brennweite und Belichtungszeit.

Einige dieser Felder sind möglicherweise nicht festgelegt.

JSON-Darstellung 
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Felder
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-Wert der Kamera, mit der das Foto aufgenommen wurde.
exposureTime

string (Duration format)

Belichtungszeit der Kameraöffnung bei der Aufnahme des Fotos.

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

VideoMetadata

Metadaten, die für ein bestimmtes Video gelten. Beispiel: fps.

JSON-Darstellung 
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
Felder
fps

number

Framerate des Videos.
processingStatus

enum (VideoProcessingStatus)

Verarbeitungsstatus des Videos.

VideoProcessingStatus

Verarbeitungsstatus eines in Google Fotos gespeicherten Videos.

Enums
UNSPECIFIED Der Videoverarbeitungsstatus ist nicht angegeben.
PROCESSING

Das Video wird verarbeitet.

Der Nutzer sieht in der Google Fotos App ein Symbol für dieses Video, es kann jedoch noch nicht abgespielt werden.
READY

Die Videoverarbeitung ist abgeschlossen und dieses Video kann jetzt angesehen werden.

Der Versuch, ein Video herunterzuladen, das nicht den Status READY hat, kann fehlschlagen.
FAILED Ein Fehler ist aufgetreten und das Video konnte nicht verarbeitet werden.

Methoden

list

 Gibt eine Liste der Medienelemente zurück, die der Nutzer während der angegebenen Sitzung ausgewählt hat.