Method: mediaItems.batchCreate

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 (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Felder
albumId

string

ID 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 Media-Elemente pro Aufruf.
albumPosition

object (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 LAST_IN_ALBUM). Die Anfrage schlägt fehl, wenn dieses Feld festgelegt 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. 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

object (SimpleMediaItem)

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

SimpleMediaItem

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

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

string

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

string

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 (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Felder
uploadToken

string

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

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. Dieses Feld wird ausgefüllt, wenn keine Fehler aufgetreten sind und das Medienelement erfolgreich erstellt wurde.