- Permintaan HTTP
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Baru AAPT
- Sederhanakan
- NewConstraintLayoutResult
- Cobalah
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 ( |
Kolom | |
---|---|
albumId |
ID album tempat item media ditambahkan. Item media juga ditambahkan ke koleksi pengguna. Ini adalah kolom opsional. |
newMediaItems[] |
Wajib diisi. 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 dibuat.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"newMediaItemResults": [
{
object ( |
Kolom | |
---|---|
newMediaItemResults[] |
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 |
Kolom | |
---|---|
description |
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 |
Item media baru yang telah diupload melalui |
Abjad
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 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 ( |
Kolom | |
---|---|
uploadToken |
Token upload yang digunakan untuk membuat item media baru (sederhana) ini. Hanya diisi jika item media sederhana dan memerlukan satu token upload. |
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 |
Item media yang dibuat dengan token upload. Kolom ini diisi jika tidak terjadi error dan item media berhasil dibuat. |