- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- ModifyLabelsRequest
- EtiquetaModification
- Modificación de campo
- Pruébala
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 |
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 ( |
Campos | |
---|---|
modifiedLabels[] |
La lista de etiquetas que la solicitud agregó o actualizó. |
kind |
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 ( |
Campos | |
---|---|
labelModifications[] |
La lista de modificaciones que se aplicarán a las etiquetas del archivo. |
kind |
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 ( |
Campos | |
---|---|
labelId |
El ID de la etiqueta que se debe modificar. |
fieldModifications[] |
La lista de modificaciones de los campos de esta etiqueta. |
removeLabel |
Si es verdadero, la etiqueta se quitará del archivo. |
kind |
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 |
El ID del campo que se modificará. |
kind |
Esto siempre es drive#labelFieldModification. |
setDateValues[] |
Reemplaza el valor de un campo |
setTextValues[] |
Establece el valor de un campo |
setSelectionValues[] |
Reemplaza un campo |
setIntegerValues[] |
Reemplaza el valor de un campo |
setUserValues[] |
Reemplaza un campo |
unsetValues |
Establece los valores para este campo. |