Method: mediaItems.batchCreate

Es werden mindestens ein Medienelement in der Google Fotos-Mediathek eines Nutzers erstellt.

Dies ist der zweite Schritt beim Erstellen eines Medienelements. Weitere Informationen zu Schritt 1, dem Hochladen der Rohbytes auf einen Google-Server, finden Sie unter Medien hochladen.

Mit diesem Aufruf wird das Medienelement der Mediathek hinzugefügt. Wenn ein Album id angegeben ist, wird das Medienelement durch den Aufruf auch dem Album hinzugefügt. 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 ein Album id als auch eine Position definiert sind, wird das Medienelement dem Album an der angegebenen Position hinzugefügt.

Wenn der Aufruf mehrere Medienelemente enthält, werden sie an der angegebenen Position eingefügt. Wenn Sie ein Medienelement in einem geteilten Album erstellen, dessen Eigentümer Sie nicht sind, können Sie es nicht positionieren. Dies führt zum Fehler BAD REQUEST.

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

Kennung des Albums, 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 Medienelemente 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. Fügen Sie nur von Nutzern verfassten Text ein. Beschreibungen sollten Kontext bieten und Nutzern helfen, Medien zu verstehen. Fügen Sie keine automatisch generierten Strings wie Dateinamen, Tags und andere Metadaten ein.
Union-Feld new_media_item_type. Das neue Medienelement kann verschiedene Typen haben, je nach Uploadpfad. Bei den derzeit unterstützten Uploads wird nur der einfache Pfad zum Medienelement 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 über ein Upload-Token in Google Fotos erstellt wird.

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

string

Token, das die Medienbyte identifiziert, die auf Google hochgeladen wurden.
fileName

string

Dateiname mit Erweiterung des Medienelements. Dieser wird dem Nutzer in Google Fotos angezeigt. Der Dateiname, der während des Uploads von Bytes angegeben wurde, wird ignoriert, wenn dieses Feld festgelegt ist. Der Dateiname darf einschließlich der Dateierweiterung maximal 255 Zeichen lang sein. Dieses Feld ist optional.

NewMediaItemResult

Ergebnis des Erstellens eines neuen Medienelements

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

string

Das Upload-Token, mit dem dieses neue (einfache) Medienelement erstellt wurde. Wird nur ausgefüllt, wenn das Medienelement einfach ist und ein einzelnes Upload-Token erforderlich war.
status

object (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

object (MediaItem)

Mit dem Upload-Token erstelltes Medienelement. Sie wird ausgefüllt, wenn keine Fehler aufgetreten sind und das Medienelement erfolgreich erstellt wurde.