- Ressource: MediaItem
- MediaMetadata
- Foto
- Videokampagnen
- VideoProcessingStatus
- ContributorInfo
- Methoden
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 ( |
Felder | |
---|---|
id |
ID des Medienelements. Dies ist eine dauerhafte Kennung, die zwischen Sitzungen verwendet werden kann, um dieses Medienelement zu identifizieren. |
description |
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 |
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 |
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 |
mimeType |
MIME-Typ des Medienelements. Beispiel: |
mediaMetadata |
Metadaten des Medienelements, z. B. Höhe, Breite oder Erstellungszeit |
contributorInfo |
Informationen zu dem Nutzer, der dieses Medienelement hinzugefügt hat. Hinweis: Dieser Wert ist nur enthalten, wenn du |
filename |
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 |
Felder | |
---|---|
creationTime |
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: |
width |
Ursprüngliche Breite (in Pixeln) des Medienelements. |
height |
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 |
Metadaten für einen Foto-Medientyp. |
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 |
Marke der Kamera, mit der das Foto aufgenommen wurde. |
cameraModel |
Das Modell der Kamera, mit der das Foto aufgenommen wurde. |
focalLength |
Brennweite des Kameraobjektivs, mit dem das Foto aufgenommen wurde. |
apertureFNumber |
Blende des Kameraobjektivs, mit dem das Foto aufgenommen wurde. |
isoEquivalent |
ISO-Wert der Kamera, mit der das Foto aufgenommen wurde |
exposureTime |
Belichtungszeit der Blende der Kamera zum Zeitpunkt der Aufnahme. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
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 ( |
Felder | |
---|---|
cameraMake |
Marke der Kamera, mit der das Video aufgenommen wurde. |
cameraModel |
Das Modell der Kamera, mit der das Video aufgenommen wurde. |
fps |
Framerate des Videos. |
status |
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 |
URL zum Profilbild des Beitragenden. |
displayName |
Anzeigename des Beitragenden. |
Methoden |
|
---|---|
|
Erstellt ein oder mehrere Medienelemente in der Google Fotos-Galerie eines Nutzers. |
|
Gibt die Liste der Medienelemente für die angegebenen Medienelement-IDs zurück |
|
Gibt das Medienelement für die angegebene Medienelement-ID zurück |
|
Hiermit werden alle Medienelemente aus der Google Fotos-Galerie eines Nutzers aufgelistet. |
|
Aktualisiert das Medienelement mit der angegebenen id . |
|
Sucht in der Google Fotos-Galerie eines Nutzers nach Medienelementen |