Method: mediaItems.batchCreate

Membuat satu atau beberapa item media di galeri Google Foto pengguna.

Ini adalah langkah kedua dalam membuat item media. Untuk mengetahui detail terkait Langkah 1, mengupload byte mentah ke Server Google, lihat Mengupload media.

Panggilan ini akan menambahkan item media ke library. Jika album id ditentukan, panggilan akan menambahkan item media ke album juga. Setiap album dapat berisi hingga 20.000 item media. Secara default, item media akan ditambahkan ke bagian akhir koleksi atau album.

Jika album id dan posisi ditetapkan, item media akan ditambahkan ke album pada posisi yang ditentukan.

Jika panggilan berisi beberapa item media, item tersebut akan ditambahkan di posisi yang ditentukan. Jika Anda membuat item media di album bersama yang bukan Anda pemiliknya, Anda tidak diizinkan untuk memosisikan item media tersebut. Tindakan ini akan menghasilkan error BAD REQUEST.

Permintaan HTTP

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Kolom
albumId

string

ID album tempat item media ditambahkan. Item media juga ditambahkan ke galeri foto pengguna. Kolom ini bersifat opsional.
newMediaItems[]

object (NewMediaItem)

Wajib. Daftar item media yang akan dibuat. Maksimum 50 item media per panggilan.
albumPosition

object (AlbumPosition)

Posisi di album tempat item media ditambahkan. Jika tidak ditentukan, item media akan ditambahkan ke akhir album (sesuai dengan nilai default, yaitu LAST_IN_ALBUM). Permintaan akan gagal jika kolom ini ditetapkan dan albumId tidak ditentukan. Permintaan juga akan gagal jika Anda menetapkan kolom dan bukan pemilik album bersama.

Isi respons

Daftar item media dibuat.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
Kolom
newMediaItemResults[]

object (NewMediaItemResult)

Hanya output. Daftar item media dibuat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

NewMediaItem

Item media baru yang dibuat di akun Google Foto pengguna.

Representasi JSON 
{
  "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.
}
Kolom
description

string

Deskripsi item media. Ini ditampilkan kepada pengguna di bagian info item di aplikasi Google Foto. Harus kurang dari 1000 karakter. Hanya sertakan teks yang ditulis oleh pengguna. Deskripsi harus menambahkan konteks dan membantu pengguna memahami media. Jangan sertakan string yang dibuat secara otomatis, seperti nama file, tag, dan metadata lainnya.
Kolom union new_media_item_type. Item media baru dapat berupa berbagai jenis - hal ini bergantung pada jalur upload. Upload yang didukung saat ini hanya menggunakan jalur item media sederhana. new_media_item_type hanya dapat berupa salah satu dari berikut:
simpleMediaItem

object (SimpleMediaItem)

Item media baru yang telah diupload melalui uploadToken yang disertakan.

SimpleMediaItem

Item media sederhana yang akan dibuat di Google Foto melalui token upload.

Representasi JSON 
{
  "uploadToken": string,
  "fileName": string
}
Kolom
uploadToken

string

Token yang mengidentifikasi byte media yang telah diupload ke Google.
fileName

string

Nama file dengan ekstensi item media. Nama ini ditampilkan kepada pengguna di Google Foto. Nama file yang ditentukan selama proses upload byte diabaikan jika kolom ini ditetapkan. Nama {i>file<i}, termasuk ekstensi file, tidak boleh lebih dari 255 karakter. Kolom ini bersifat opsional.

NewMediaItemResult

Hasil pembuatan item media baru.

Representasi JSON 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Kolom
uploadToken

string

Token upload yang digunakan untuk membuat item media baru (sederhana) ini. Hanya diisi jika item media sederhana dan memerlukan satu token upload.
status

object (Status)

Jika terjadi error selama pembuatan item media ini, kolom ini akan diisi dengan informasi yang terkait dengan error tersebut. Untuk mengetahui detail terkait kolom ini, lihat Status.
mediaItem

object (MediaItem)

Item media yang dibuat dengan token upload. Kolom ini diisi jika tidak terjadi error dan item media berhasil dibuat.