All Products
Search
Document Center

Drive and Photo Service:FilePutUserTags

Last Updated:Feb 26, 2026

Menambahkan tag kustom ke file.

Deskripsi operasi

Operasi ini merupakan operasi pembaruan inkremental. Perhatikan hal-hal berikut:

  • Jika nama tag yang ditentukan dalam permintaan sama dengan nama tag yang sudah ada, tag yang ada akan ditimpa.

  • Jika nama tag yang ditentukan dalam permintaan berbeda dari nama tag yang sudah ada, tag tersebut akan ditambahkan.

  • Tag yang sudah ada dengan nama unik tidak terpengaruh.

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/file/put_usertags HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

body

object

No

Parameter permintaan.

drive_id

string

Yes

ID drive.

1

file_id

string

Yes

ID file.

9520943DC264

user_tags

array<object>

Yes

Tag yang akan ditambahkan ke file. Anda tidak boleh mengosongkan parameter ini. Anda dapat menentukan hingga 1.000 tag. Anda tidak boleh menentukan tag yang memiliki nama yang sama.

object

Yes

key

string

Yes

Nama tag. Nama tag tidak boleh kosong dan tidak boleh mengandung tanda pagar (#).

tag

value

string

No

Nilai tag. Nilai tag tidak boleh mengandung tanda pagar (#).

value

Elemen respons

Element

Type

Description

Example

object

Parameter respons.

file_id

string

ID file.

9520943DC264

Contoh

Respons sukses

JSONformat

{
  "file_id": "9520943DC264"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.