Method: files.modifyLabels

Modifica el conjunto de etiquetas aplicadas a un archivo. Para obtener más información, consulta Cómo establecer un campo de etiqueta en un archivo.

Devuelve una lista de las etiquetas que se agregaron o modificaron.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
fileId

string

Es el ID del archivo al que pertenecen las etiquetas.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de ModifyLabelsRequest.

Cuerpo de la respuesta

Es la respuesta a una solicitud files.modifyLabels. Contiene solo las etiquetas que se agregaron o actualizaron con la solicitud.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
Campos
modifiedLabels[]

object (Label)

Es la lista de etiquetas que se agregaron o actualizaron con la solicitud.
kind

string

Siempre es "drive#modifyLabelsResponse".

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Algunos alcances están restringidos y requieren una evaluación de seguridad para que tu app los use. Para obtener más información, consulta la Guía de autorización.

ModifyLabelsRequest

Es una solicitud para modificar el conjunto de etiquetas de un archivo. Esta solicitud puede contener muchas modificaciones que se realizarán correctamente o fallarán de forma atómica.

Representación JSON 
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
Campos
labelModifications[]

object (LabelModification)

Es la lista de modificaciones que se aplicarán a las etiquetas del archivo.
kind

string

Siempre es "drive#modifyLabelsRequest".

LabelModification

Es una modificación en la etiqueta de un archivo. Se puede usar un objeto LabelModification para aplicar una etiqueta a un archivo, actualizar una etiqueta existente en un archivo o quitar una etiqueta de un archivo.

Representación JSON 
{
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "labelId": string,
  "removeLabel": boolean,
  "kind": string
}
Campos
fieldModifications[]

object (FieldModification)

Es la lista de modificaciones en los campos de esta etiqueta.
labelId

string

Es el ID de la etiqueta que se modificará.
removeLabel

boolean

Si es verdadero, se quitará la etiqueta del archivo.
kind

string

Siempre es "drive#labelModification".

FieldModification

Es una modificación en el campo de una etiqueta.

Representación JSON 
{
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "fieldId": string,
  "kind": string,
  "unsetValues": boolean
}
Campos
setDateValues[]

string

Reemplaza el valor de un campo date por estos valores nuevos. La cadena debe tener el formato de fecha completa RFC 3339: AAAA-MM-DD.
setTextValues[]

string

Establece el valor de un campo text.
setSelectionValues[]

string

Reemplaza un campo selection con estos valores nuevos.
setIntegerValues[]

string (int64 format)

Reemplaza el valor de un campo integer por estos valores nuevos.
setUserValues[]

string

Reemplaza un campo user con estos valores nuevos. Los valores deben ser direcciones de correo electrónico válidas.
fieldId

string

Es el ID del campo que se modificará.
kind

string

Siempre es "drive#labelFieldModification".
unsetValues

boolean

Anula los valores de este campo.