Method: mediaItems.batchCreate

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

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

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

Jika id album dan posisi sudah ditentukan, 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 di mana Anda bukan pemiliknya, Anda tidak diizinkan untuk memosisikan item media tersebut. Tindakan tersebut 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 koleksi pengguna. Ini adalah kolom opsional.

newMediaItems[]

object (NewMediaItem)

Wajib diisi. 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 nilai default, yaitu LAST_IN_ALBUM). Permintaan akan gagal jika kolom ini disetel 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

Baru AAPT

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. Hal ini ditampilkan kepada pengguna di bagian info item di aplikasi Google Foto. Harus kurang dari 1.000 karakter. Hanya sertakan teks yang ditulis oleh pengguna. Deskripsi harus menambahkan konteks dan membantu pengguna memahami media. Jangan sertakan string yang dihasilkan secara otomatis seperti nama file, tag, dan metadata lainnya.

Kolom union new_media_item_type. Item media baru dapat memiliki berbagai jenis yang berbeda - hal ini bergantung pada jalur upload. Upload yang saat ini didukung 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.

Abjad

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 akan ditampilkan kepada pengguna di Google Foto. Nama file yang ditetapkan selama proses upload byte diabaikan jika kolom ini disetel. Nama file, termasuk ekstensi file, tidak boleh lebih dari 255 karakter. Ini adalah kolom opsional.

NewUpdatedResult

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.