- Permintaan HTTP
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- NewMediaItem
- SimpleMediaItem
- NewMediaItemResult
- Cobalah!
Membuat satu atau beberapa item media di galeri Google Foto pengguna.
Ini adalah langkah kedua untuk membuat item media. Untuk mengetahui detail tentang Langkah 1, mengupload byte mentah ke Server Google, lihat Mengupload media.
Panggilan ini akan menambahkan item media ke library. Jika album id
ditentukan, panggilan juga akan menambahkan item media ke album tersebut. Setiap album dapat berisi hingga 20.000 item media. Secara default, item media akan ditambahkan ke akhir koleksi atau album.
Jika album id
dan posisi telah 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 ( |
Kolom | |
---|---|
albumId |
ID album tempat item media ditambahkan. Item media juga ditambahkan ke koleksi pengguna. Kolom ini bersifat opsional. |
newMediaItems[] |
Wajib. Daftar item media yang akan dibuat. Maksimum 50 item media per panggilan. |
albumPosition |
Posisi di album tempat item media ditambahkan. Jika tidak ditentukan, item media akan ditambahkan ke akhir album (sesuai nilai default, yaitu |
Isi respons
Daftar item media yang dibuat.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"newMediaItemResults": [
{
object ( |
Kolom | |
---|---|
newMediaItemResults[] |
Hanya output. Daftar item media yang 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 |
Kolom | |
---|---|
description |
Deskripsi item media. Nama 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 dihasilkan secara otomatis seperti nama file, tag, dan metadata lainnya. |
Kolom union new_media_item_type . Item media baru dapat memiliki berbagai jenis - bergantung pada jalur upload. Upload yang saat ini didukung hanya menggunakan jalur item media sederhana. new_media_item_type hanya ada berupa salah satu diantara berikut: |
|
simpleMediaItem |
Item media baru yang telah diupload melalui |
SimpleMediaItem
Item media sederhana yang akan dibuat di Google Foto melalui token upload.
Representasi JSON |
---|
{ "uploadToken": string, "fileName": string } |
Kolom | |
---|---|
uploadToken |
Token yang mengidentifikasi byte media yang telah diupload ke Google. |
fileName |
Nama file dengan ekstensi item media. Nama ini akan ditampilkan kepada pengguna di Google Foto. Nama file yang ditentukan selama proses upload byte akan diabaikan jika kolom ini ditetapkan. Nama file, 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 ( |
Kolom | |
---|---|
uploadToken |
Token upload yang digunakan untuk membuat item media (sederhana) baru ini. Hanya diisi jika item media sederhana dan memerlukan satu token upload. |
status |
Jika terjadi error saat membuat item media ini, kolom ini akan diisi dengan informasi yang terkait dengan error tersebut. Untuk mengetahui detail terkait kolom ini, lihat Status. |
mediaItem |
Item media yang dibuat dengan token upload. Kolom ini akan diisi jika tidak terjadi error dan item media berhasil dibuat. |