Method: mediaItems.batchCreate

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

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.

Mit diesem Aufruf wird das Medienelement der Mediathek 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 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 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. 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

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 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. Je nach Upload-Pfad kann das neue Medienelement verschiedene Typen aufweisen. 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 zur Identifizierung der Medienbyte, die auf Google hochgeladen wurden.
fileName

string

Dateiname mit der Erweiterung des Medienelements. Dies 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 einschließlich Dateiendung darf 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 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. Sie wird ausgefüllt, wenn keine Fehler aufgetreten sind und das Medienelement erfolgreich erstellt wurde.