REST Resource: mediaItems

Ressource: PickedMediaItem

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

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

string

ID für das Medienelement.

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

string (Timestamp format)

Zeitpunkt, zu dem das Medienelement 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".
type

enum (Type)

Der Typ dieses Medienelements.
mediaFile

object (MediaFile)

Die Mediendatei, aus der dieses Medienelement besteht.

Typ

Der Typ des Medienelements.

Enums
TYPE_UNSPECIFIED Der Typ ist nicht standardmäßig angegeben.
PHOTO Das Medienelement steht für ein Standbild.
VIDEO Das Medienelement steht für ein Video.

MediaFile

Darstellung einer einzelnen Datei mit Medienbyte.

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

string

Eine URL zu den Byte der Mediendatei.

Um eine Mediendatei herunterzuladen, muss der API-Client die in der Entwicklerdokumentation angegebenen Parameter zu dieser URL hinzufügen.

Beispielsweise legt '=w2048-h1024' die Abmessungen eines Medienelements des Typs „Foto“ auf eine Breite von 2.048 px und eine Höhe von 1.024 px fest.
mimeType

string

MIME-Typ der Mediendatei. Beispiel: image/jpeg.
mediaFileMetadata

object (MediaFileMetadata)

Metadaten zur Mediendatei, z. B. Höhe, Breite oder Erstellungszeit.

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

Ursprüngliche Breite (in Pixeln) der Mediendatei
height

integer

Ursprüngliche Höhe (in Pixeln) der Mediendatei
cameraMake

string

Marke der Kamera, mit der das Foto aufgenommen wurde
cameraModel

string

Modell der Kamera, mit der das Foto aufgenommen wurde.
Union-Feld metadata. Metadaten für die Mediendatei, die für den zugrunde liegenden Medientyp spezifisch sind, den sie repräsentiert. 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

Fotospezifische Metadaten wie ISO, Brennweite und Belichtungszeit. Einige dieser Felder können null sein oder nicht enthalten.

JSON-Darstellung 
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string,
  "printMetadata": {
    object (PrintMetadata)
  }
}
Felder
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 Blende der Kamera bei der Aufnahme.

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

object (PrintMetadata)

Metadaten, die sich auf den Druck des Fotos beziehen.

PrintMetadata

Metadaten, die druckbezogene Eigenschaften eines Fotos beschreiben, z. B. der Druckqualitätsfaktor.

JSON-Darstellung 
{
  "qualityScore": enum (Score)
}
Felder
qualityScore

enum (Score)

Druckqualitätsfaktor eines Fotos, das bestimmt, ob das Foto zum Drucken geeignet ist.

Der Wert sollte nicht verwendet werden, um Nutzer vom Drucken abzuraten. Der Wert wird auf HIGH gesetzt, wenn das Foto eine hohe Qualität hat und der Nutzer es möglicherweise drucken möchte. Ein NORMAL-Wert bedeutet, dass das Foto möglicherweise nicht von hoher Qualität ist. SCORE_UNSPECIFIED gibt an, dass kein Wert verfügbar ist.

Punktzahl

Ein Wert, der beschreibt, wie gut ein Foto gedruckt werden kann.

Enums
SCORE_UNSPECIFIED Der Wert ist nicht standardmäßig angegeben.
HIGH Das Foto hat eine hohe Punktzahl.
NORMAL Das Foto zeigt ein normales Ergebnis.

VideoMetadata

Videospezifische Metadaten, z. B. fps

JSON-Darstellung 
{
  "fps": number
}
Felder
fps

number

Framerate des Videos.

Methoden

list

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