Method: files.modifyLabels

Modifica o conjunto de marcadores aplicados a um arquivo. Retorna uma lista dos rótulos que foram adicionados ou modificados.

Solicitação HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/modifyLabels

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
fileId

string

O ID do arquivo a que os rótulos pertencem.

Corpo da solicitação

O corpo da solicitação contém uma instância de ModifyLabelsRequest.

Corpo da resposta

Resposta a uma solicitação files.modifyLabels. Contém apenas os rótulos que foram adicionados ou atualizados pela solicitação.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
Campos
modifiedLabels[]

object (Label)

A lista de rótulos que foram adicionados ou atualizados pela solicitação.
kind

string

É sempre drive#modifyLabelsResponse

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

Alguns escopos são restritos e exigem uma avaliação de segurança para que o app possa usá-los. Para mais informações, consulte o guia de autorização.

ModifyLabelsRequest

Uma solicitação para modificar o conjunto de rótulos em um arquivo. Essa solicitação pode conter muitas modificações que serão bem-sucedidas ou todas falharão atomicamente.

Representação JSON 
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
Campos
labelModifications[]

object (LabelModification)

Lista de modificações a serem aplicadas aos rótulos no arquivo.
kind

string

É sempre drive#modifyLabelsRequest.

LabelModification

Uma modificação em um rótulo em um arquivo. Uma LabelModification pode ser usada para aplicar um rótulo a um arquivo, atualizar um rótulo existente em um arquivo ou remover um rótulo de um arquivo.

Representação JSON 
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
Campos
labelId

string

O ID do marcador a ser modificado.
fieldModifications[]

object (FieldModification)

A lista de modificações nos campos deste rótulo.
removeLabel

boolean

Se verdadeiro, o rótulo será removido do arquivo.
kind

string

É sempre drive#labelModification.

FieldModification

Uma modificação no campo de um marcador.

Representação JSON 
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
Campos
fieldId

string

O ID do campo a ser modificado.
kind

string

É sempre drive#labelFieldModification.
setDateValues[]

string

Substitui o valor de um campo date por esses novos valores. A string precisa estar no formato de data completa RFC 3339: AAAA-MM-DD.
setTextValues[]

string

Define o valor de um campo text.
setSelectionValues[]

string

Substitui um campo selection por esses novos valores.
setIntegerValues[]

string (int64 format)

Substitui o valor de um campo integer por esses novos valores.
setUserValues[]

string

Substitui um campo user por esses novos valores. Os valores precisam ser endereços de e-mail válidos.
unsetValues

boolean

Desfaz a definição dos valores para esse campo.