Method: files.modifyLabels

Modifica o conjunto de rótulos 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 ao qual 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 de 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 de 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 serem usados pelo app. Para mais informações, consulte o Guia de autorização.

ModificarRequestRequests

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 falharão atomicamente.

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

object (LabelModification)

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

string

É sempre drive#modifyLabelsRequest.

Modificação de Rótulo

Uma modificação em um rótulo de um arquivo. Um LabelModification pode ser usado 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 rótulo a ser modificado.
fieldModifications[]

object (FieldModification)

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

boolean

Se for "true", o rótulo será removido do arquivo.
kind

string

É sempre drive#labelModification.

Modificação de campo

Uma modificação no campo de um rótulo.

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 deve 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

Cancela a configuração dos valores deste campo.