Method: mediaItems.batchCreate

Erstellt mindestens ein Medienelement in der Google Fotos-Galerie eines Nutzers

Dies ist der zweite Schritt zum Erstellen eines Medienelements. Weitere Informationen zu Schritt 1 und zum Hochladen der Rohbyte auf einen Google-Server finden Sie unter Medien hochladen.

Bei diesem Aufruf wird das Medienelement der Bibliothek hinzugefügt. Wenn das Album id angegeben ist, fügt der Aufruf das Medienelement dem Album ebenfalls hinzu. Jedes Album kann bis zu 20.000 Medienelemente enthalten. Standardmäßig wird das Medienelement am Ende der Mediathek oder des Albums hinzugefügt.

Wenn sowohl das Album id als auch die Position definiert sind, wird das Medienelement an der angegebenen Position zum 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 Inhaber Sie nicht sind, können Sie es 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 (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Felder
albumId

string

ID des Albums, in dem die Medienelemente hinzugefügt werden. Die Medienelemente werden auch der Mediathek des Nutzers hinzugefügt. Dieses Feld ist optional.
newMediaItems[]

object (NewMediaItem)

Erforderlich. Liste der zu erstellenden Medienelemente. Maximal 50 Medien pro Aufruf
albumPosition

object (AlbumPosition)

Position im Album, an der die Medienelemente hinzugefügt werden Wenn keine Angabe erfolgt, werden die Medienelemente dem Album am Ende hinzugefügt (gemäß dem Standardwert LAST_IN_ALBUM). Die Anfrage schlägt fehl, wenn dieses Feld festgelegt ist und albumId nicht angegeben ist. Die Anfrage schlägt auch fehl, wenn Sie das Feld festlegen und nicht der Inhaber des geteilten Albums sind.

Antworttext

Liste der erstellten Medienelemente.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
Felder
newMediaItemResults[]

object (NewMediaItemResult)

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 new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
Felder
description

string

Beschreibung des Medienelements. Dieser wird Nutzern in der Google Fotos App im Infobereich des Elements angezeigt. Er darf maximal 1.000 Zeichen lang sein. Schließen Sie nur Text ein, der von Nutzern geschrieben wurde. Beschreibungen sollten Kontext bieten und Nutzern helfen, Medien zu verstehen. Verwenden Sie keine automatisch generierten Strings wie Dateinamen, Tags und andere Metadaten.
Union-Feld new_media_item_type. Je nach Upload-Pfad kann das neue Medienelement verschiedene Typen aufweisen. Bei den 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

object (SimpleMediaItem)

Ein neues Medienelement, das über die enthaltene uploadToken hochgeladen wurde.

SimpleMediaItem

Ein einfaches Medienelement, das in Google Fotos über ein Uploadtoken erstellt wird.

JSON-Darstellung 
{
  "uploadToken": string,
  "fileName": string
}
Felder
uploadToken

string

Token zur Identifizierung der Medienbyte, die auf Google hochgeladen wurden.
fileName

string

Dateiname mit der Erweiterung des Medienelements. Dieser wird dem Nutzer in Google Fotos angezeigt. Der während des Byte-Uploadvorgangs angegebene Dateiname wird ignoriert, wenn dieses Feld festgelegt wurde. Der Dateiname einschließlich Dateiendung darf maximal 255 Zeichen lang sein. Dieses Feld ist optional.

NewMediaItemResult

Ergebnis der Erstellung eines neuen Medienelements

JSON-Darstellung 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Felder
uploadToken

string

Das Upload-Token, das zum Erstellen dieses neuen (einfachen) Medienelements verwendet wird. Wird nur ausgefüllt, wenn das Medienelement einfach ist und ein einzelnes Uploadtoken erfordert.
status

object (Status)

Wenn beim Erstellen dieses Medienelements ein Fehler aufgetreten ist, enthält dieses Feld Informationen zum Fehler. Weitere Informationen zu diesem Feld finden Sie unter Status.
mediaItem

object (MediaItem)

Mit dem Uploadtoken erstelltes Medienelement. Dieses Feld wird ausgefüllt, wenn keine Fehler aufgetreten sind und das Medienelement erfolgreich erstellt wurde.