REST Resource: mediaItems

Ressource: PickedMediaItem

Darstellung eines Fotos oder Videos, das vom Nutzer ausgewählt wurde.

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 Medienelement zu identifizieren.

createTime

string (Timestamp format)

Der Zeitpunkt, zu dem das Medienelement erstellt wurde (nicht der Zeitpunkt, zu dem 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".

type

enum (Type)

Der Typ dieses Medienelements.

mediaFile

object (MediaFile)

Die Mediendatei, die dieses Medienelement bildet.

Typ

Der Typ eines Medienelements.

Enums
TYPE_UNSPECIFIED Der Typ ist nicht angegeben.
PHOTO Das Medienelement ist ein Foto.
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, über die die Bytes der Mediendatei abgerufen werden.

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 Medienelements vom Typ „Foto“ auf eine Breite von 2.048 Pixeln und eine Höhe von 1.024 Pixeln festgelegt.

mimeType

string

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

filename

string

Dateiname der Mediendatei.

mediaFileMetadata

object (MediaFileMetadata)

Metadaten zur Mediendatei, 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

Originalbreite (in Pixeln) der Mediendatei.

height

integer

Die ursprüngliche Höhe (in Pixeln) der Mediendatei.

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 dem Medientyp entsprechen. 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 Video-Medientyp.

PhotoMetadata

Metadaten, die für ein Foto spezifisch sind, 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 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".

VideoMetadata

Videospezifische Metadaten. 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 Status der Videoverarbeitung 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 wiedergegeben werden.

READY

Die Videoverarbeitung ist abgeschlossen und das Video kann jetzt wiedergegeben werden.

Der Download eines Videos, das sich nicht im Status READY befindet, 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.