Todos os produtos
Search
Central de documentação

Drive and Photo Service:FilePutUserTags

Última atualização: Jul 04, 2026

Adiciona tags personalizadas a um arquivo.

Descrição da operação

Esta operação realiza uma atualização incremental:\n\n- Se uma tag com a mesma chave já existir, seu valor será substituído.\n\n- Se uma tag não existir, ela será adicionada.\n\n- As tags existentes com chaves diferentes não são afetadas.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST /v2/file/put_usertags HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

domain_id

string

Sim

body

object

Não

O corpo da solicitação.

drive_id

string

Sim

O ID do drive.

1

file_id

string

Sim

O ID do arquivo.

9520943DC264

user_tags

array<object>

Sim

O array de tags a serem adicionadas. O array deve conter de 1 a 1.000 tags e não deve conter chaves de tag duplicadas.

object

Sim

O comprimento combinado da chave da tag e do valor da tag não pode exceder 2.000 bytes.

key

string

Sim

A chave da tag. Não deve estar vazia nem conter o caractere #.

tag

value

string

Não

O valor da tag. Não deve conter o caractere #.

value

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O esquema da resposta.

file_id

string

O ID do arquivo.

9520943DC264

Exemplos

Resposta de sucesso

JSON formato

{
  "file_id": "9520943DC264"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.