Remover um marcador de um arquivo

Nesta página, descrevemos como remover um rótulo em um único arquivo do Google Drive.

Para remover os metadados do rótulo de arquivo de um arquivo, use o files.modifyLabels método. O corpo da solicitação contém uma instância de ModifyLabelsRequest para modificar o conjunto de rótulos em um arquivo. A solicitação pode conter várias modificações que são aplicadas atomicamente. Ou seja, se alguma modificação não for válida, toda a atualização falhará e nenhuma das mudanças (possivelmente dependentes) será aplicada.

O ModifyLabelsRequest contém uma instância de LabelModification que é uma modificação em um rótulo em um arquivo. Ele também pode conter uma instância de FieldModification que é uma modificação no campo de um rótulo. Para remover o rótulo do arquivo, defina FieldModification.removeLabel como True.

Se for bem-sucedido, o corpo da resposta vai conter os rótulos adicionados ou atualizados pela solicitação. Eles existem em um modifiedLabels objeto do tipo Label.

Exemplo

O exemplo de código a seguir mostra como usar o labelId para remover todos os campos associados ao rótulo usando o fileId. Por exemplo, se um rótulo contiver campos de texto e de usuário, a remoção de um rótulo vai excluir os dois campos de texto e de usuário associados a ele. Já a remoção do campo de texto o remove do rótulo, mas deixa o campo de usuário intacto. Para mais informações, consulte Remover um campo de rótulo em um arquivo.

Java

ModifyLabelsRequest modifyLabelsRequest =
  new ModifyLabelsRequest()
      .setLabelModifications(
          ImmutableList.of(
              new LabelModification()
                .setLabelId("LABEL_ID")
                .setRemoveLabel(true)));

ModifyLabelsResponse modifyLabelsResponse = driveService.files().modifyLabels("FILE_ID", modifyLabelsRequest).execute();

Python

label_modification = {'labelId':'LABEL_ID', 'removeLabel': True]}

modified_labels = drive_service.files().modifyLabels(fileId="FILE_ID", body = {'labelModifications' : [label_modification]}).execute();

Node.js

/**
* Remove a label on a Drive file
* @return{obj} updated label data
**/
async function removeLabel() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
  const service = google.drive({version: 'v3', auth});
  const labelModification = {
    'labelId': 'LABEL_ID',
    'removeLabel': True,
  };
  const labelModificationRequest = {
    'labelModifications': [labelModification],
  };
  try {
    const updateResponse = await service.files.modifyLabels({
      fileId: 'FILE_ID',
      resource: labelModificationRequest,
    });
    return updateResponse;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }

Substitua:

  • LABEL_ID: o labelId do rótulo a ser modificado. Para localizar os rótulos em um arquivo, use o files.listLabels método.
  • FILE_ID: O fileId do arquivo para o qual os rótulos são modificados.