- HTTP-Anfrage
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- NewMediaItem
- SimpleMediaItem
- NewMediaItemResult
- Testen!
Erstellt ein oder mehrere Medienelemente in der Google Fotos-Galerie eines Nutzers.
Dies ist der zweite Schritt beim Erstellen eines Medienelements. Weitere Informationen zu Schritt 1 zum Hochladen der Rohbyte auf einen Google-Server finden Sie unter Medien hochladen.
Durch diesen Aufruf wird das Medienelement der Bibliothek hinzugefügt. Wenn die id
für ein Album angegeben ist, wird das Medienelement auch zum Album hinzugefügt. Jedes Album kann bis zu 20.000 Medienelemente enthalten. Das Medienelement wird standardmäßig am Ende der Mediathek oder des Albums hinzugefügt.
Wenn sowohl die id
als auch die Position eines Albums definiert sind, wird das Medienelement an der angegebenen Position dem Album hinzugefügt.
Wenn der Aufruf mehrere Medienelemente enthält, werden diese an der angegebenen Position hinzugefügt. Wenn Sie ein Medienelement in einem geteilten Album erstellen, dessen Eigentümer Sie nicht sind, können Sie das Medienelement nicht positionieren. Andernfalls wird der Fehler BAD REQUEST
zurückgegeben.
HTTP-Anfrage
POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "albumId": string, "newMediaItems": [ { object ( |
Felder | |
---|---|
albumId |
ID des Albums, dem die Medienelemente hinzugefügt werden Die Medienelemente werden auch der Mediathek des Nutzers hinzugefügt. Dieses Feld ist optional. |
newMediaItems[] |
Erforderlich. Liste der zu erstellenden Medienelemente. Maximal 50 Media-Elemente pro Aufruf. |
albumPosition |
Position im Album, an der die Medienelemente hinzugefügt werden. Wenn nicht angegeben, werden die Medienelemente am Ende des Albums hinzugefügt (gemäß dem Standardwert, also |
Antworttext
Liste der erstellten Medienelemente.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"newMediaItemResults": [
{
object ( |
Felder | |
---|---|
newMediaItemResults[] |
Nur Ausgabe Liste der erstellten Medienelemente. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing
NewMediaItem
Neues Medienelement, das im Google Fotos-Konto eines Nutzers erstellt wird.
JSON-Darstellung |
---|
{ "description": string, // Union field |
Felder | |
---|---|
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. |
Union-Feld new_media_item_type . Es gibt verschiedene Typen des neuen Medienelements. Dies hängt vom Upload-Pfad ab. Für die derzeit unterstützten Uploads wird nur der einfache Pfad für Medienelemente verwendet. Für new_media_item_type ist nur einer der folgenden Werte zulässig: |
|
simpleMediaItem |
Ein neues Medienelement, das über das enthaltene |
SimpleMediaItem
Ein einfaches Medienelement, das über ein Uploadtoken in Google Fotos erstellt wird.
JSON-Darstellung |
---|
{ "uploadToken": string, "fileName": string } |
Felder | |
---|---|
uploadToken |
Token zur Identifizierung der Mediabyte, die auf Google hochgeladen wurden. |
fileName |
Dateiname mit der Erweiterung des Medienelements. Dies wird dem Nutzer in Google Fotos angezeigt. Der beim Byte-Upload angegebene Dateiname wird ignoriert, wenn dieses Feld festgelegt ist. Der Dateiname, einschließlich der Dateiendung, darf maximal 255 Zeichen lang sein. Dieses Feld ist optional. |
NewMediaItemResult
Ergebnis der Erstellung eines neuen Medienelements.
JSON-Darstellung |
---|
{ "uploadToken": string, "status": { object ( |
Felder | |
---|---|
uploadToken |
Das Uploadtoken, das zum Erstellen dieses neuen (einfachen) Medienelements verwendet wird. Wird nur ausgefüllt, wenn das Medienelement einfach ist und ein einzelnes Upload-Token erfordert. |
status |
Wenn beim Erstellen dieses Medienelements ein Fehler aufgetreten ist, wird dieses Feld mit Informationen zum Fehler gefüllt. Weitere Informationen zu diesem Feld finden Sie unter Status. |
mediaItem |
Mit dem Upload-Token erstelltes Medienelement. Dieses Feld wird ausgefüllt, wenn keine Fehler aufgetreten sind und das Medienelement erfolgreich erstellt wurde. |