Gunakan batch untuk menggabungkan beberapa permintaan API ke dalam satu panggilan - Drive and Photo Service

Memanggil beberapa operasi sekaligus untuk meningkatkan efisiensi pemanggilan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST /v2/batch HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
body	object	No	Parameter permintaan.
resource	string	Yes	Jenis resource yang ingin Anda kelola. Nilai yang valid: file: sebuah file. drive: drive individu atau team drive. user: pengguna. group: kelompok. membership: anggota kelompok. share_link: share. async_task: tugas asinkron. Valid values: share_link : 分享 file : 文件 async_task : 异步任务 membership : 群组成员 drive : 个人/团队云盘 user : 用户 group : 群组	file
requests	array<object>	Yes	Permintaan anak. Jumlah permintaan anak. Nilai yang valid: 1 hingga 100.
	array<object>	No
id	string	Yes	ID permintaan anak. ID ini digunakan untuk mengaitkan permintaan anak dengan responsnya. ID permintaan anak harus unik.	93433894994ad2e1
method	string	Yes	Metode permintaan anak. Nilai yang valid: POST GET PUT DELETE HEAD Valid values: HEAD : HEAD DELETE : DELETE POST : POST GET : GET PUT : PUT	POST
url	string	Yes	Path API permintaan anak. Nilai yang valid: /file/get: menanyakan informasi tentang file. /file/update: memodifikasi informasi tentang file. /file/search: mencari file. /file/copy: menyalin file atau folder. /file/move: memindahkan file atau folder. /file/delete: menghapus file atau folder. /file/get_download_url: menanyakan URL unduhan file. /file/get_share_link_download_url: menanyakan URL unduhan file dalam share. /recyclebin/trash: memindahkan file atau folder ke Keranjang daur ulang. /recyclebin/restore: memulihkan file atau folder. /file/put_usertags: menambahkan tag ke pengguna. /file/delete_usertags: menghapus tag dari pengguna. /drive/get: menanyakan informasi tentang drive. /user/get: menanyakan informasi tentang pengguna. /group/get: menanyakan informasi tentang kelompok. /share_link/create: membuat share. /share_link/update: memodifikasi share. /share_link/cancel: membatalkan share. /share_link/list: menanyakan shares. /share_link/get: menanyakan informasi tentang share. /share_link/get_share_token: menanyakan token akses share. /async_task/get: menanyakan informasi tentang tugas asinkron. Valid values: /file/copy : 复制文件或文件夹 /file/get_share_link_download_url : 获取分享下载地址 /file/move : 移动文件或文件夹 /share_link/create : 创建分享 /share_link/update : 修改分享 /async_task/get : 获取异步任务信息 /drive/get : 获取空间信息 /group/get : 获取群组信息 /share_link/list : 列举分享 /file/delete : 删除文件或文件夹 /share_link/get : 获取分享信息 /file/get : 获取文件详情 /file/get_download_url : 获取文件下载地址 /recyclebin/restore : 恢复文件或文件夹 /file/update : 修改文件信息 /recyclebin/trash : 放入回收站 /file/search : 搜索文件 /user/get : 获取用户信息 /share_link/get_share_token : 获取分享令牌 /share_link/cancel : 取消分享	/file/get
body	object	No	Parameter permintaan permintaan anak. Nilai parameter harus berupa string JSON. Untuk informasi lebih lanjut, lihat topik permintaan anak yang sesuai. Sebelum menentukan badan permintaan, Anda harus menentukan header menggunakan Content-Type. Content-Type hanya dapat diatur ke application/json.
	any	No	Body permintaan dari sebuah child request.	{"domain_id":"1","drive_id":"1"}
headers	object	No	Header permintaan anak, yang menunjukkan jenis data yang ditentukan dalam badan permintaan.
	string	No	Header permintaan anak.	{"Content-Type":"application/json"}

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
responses	array<object>	Semua respons dari permintaan anak.
	array<object>
id	string	ID permintaan anak. ID ini digunakan untuk mengaitkan permintaan anak dengan responsnya.	93433894994ad2e1
status	integer	Kode status HTTP yang dikembalikan dari permintaan anak. Untuk informasi lebih lanjut, lihat topik permintaan anak yang sesuai.	200
body	object	Parameter respons permintaan anak. Untuk informasi lebih lanjut, lihat topik permintaan anak yang sesuai.
	any	Badan respons permintaan anak.	{"domain_id":"1","drive_id":"1","file_id":"9520943DC264"}

Contoh

Respons sukses

JSONformat

{
  "responses": [
    {
      "id": "93433894994ad2e1",
      "status": 200,
      "body": {
        "key": "{\"domain_id\":\"1\",\"drive_id\":\"1\",\"file_id\":\"9520943DC264\"}"
      }
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.