Method: files.modifyLabels

Modifica el conjunto de etiquetas aplicadas a un archivo. Muestra 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

El ID del archivo al que pertenecen las etiquetas.

Cuerpo de la solicitud

El cuerpo de la solicitud incluye una instancia de ModifyLabelsRequest.

Cuerpo de la respuesta

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

Respuesta a una solicitud de files.modifyLabels. Solo contiene las etiquetas que la solicitud agregó o actualizó.

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

object (Label)

La lista de etiquetas que la solicitud agregó o actualizó.

kind

string

Esto siempre es drive#modifyLabelsResponse

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Algunos permisos 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.

ModificarLabelsRequest

Una solicitud para modificar el conjunto de etiquetas de un archivo. Esta solicitud puede contener muchas modificaciones que tendrán éxito o fallarán de manera atómica.

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

object (LabelModification)

La lista de modificaciones que se aplicarán a las etiquetas del archivo.

kind

string

Siempre es drive#modifyLabelsRequest.

Modificación de la etiqueta

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

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

string

El ID de la etiqueta que se debe modificar.

fieldModifications[]

object (FieldModification)

La lista de modificaciones de los campos de esta etiqueta.

removeLabel

boolean

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

kind

string

Esto siempre es drive#labelModification.

Modificación del campo

Una modificación en el campo de una etiqueta

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

string

El ID del campo que se modificará.

kind

string

Esto siempre es drive#labelFieldModification.

setDateValues[]

string

Reemplaza el valor de un campo date con estos valores nuevos. La string 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 con estos valores nuevos.

setUserValues[]

string

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

unsetValues

boolean

Establece los valores para este campo.