Pesquisar arquivos com um marcador ou valor de campo específico

Nesta página, descrevemos como pesquisar arquivos com um marcador ou valor de campo específico aplicado.

Tipos de campo de rótulo

Os campos de marcadores do Google Drive são fortemente digitados, e cada um deles oferece suporte a diferentes semânticas de indexação e pesquisa. A tabela a seguir mostra os tipos de dados disponíveis.

Tipo	Opções de tipo de marcador	Operadores de pesquisa compatíveis
Texto	TextOptions	is null, is not null, =, contains, starts with
Texto longo	LongTextOptions	is null, is not null, contains
Número inteiro	IntegerOptions	is null, is not null, =, !=, <, >, <=, >=
Data	DateOptions	is null, is not null, =, !=, <, >, <=, >=
Seleção	SelectionOptions	is null, is not null, =, !=
Usuário	UserOptions	is null, is not null, =, !=
Lista de seleção	SelectionOptions (com max_Entries > 1)	is null, is not null, in, not in
Lista de usuários	UserOptions (com max_Entries > 1)	is null, is not null, in, not in

Exemplos de pesquisa

Observação: nos exemplos abaixo, strings legíveis são usadas para maior clareza. Nomes de recursos e IDs de campo reais precisam ser usados. Por exemplo, labels/contract.execution_date pode ser algo como: labels/837d7f5de85137b86e52.491d.

1. pesquisar com base na presença de um marcador ou campo

É possível pesquisar itens com um marcador específico aplicado ou não:

• 'labels/contract' in labels
• not 'labels/contract' in labels

Também é possível pesquisar itens em que um campo específico foi definido (ou não):

• labels/contract.comment IS NOT NULL
• labels/contract.comment IS NULL

Observação :pesquisar arquivos sem campos definidos retorna itens em que o marcador não foi aplicado. É possível combinar as consultas acima para encontrar itens em que o rótulo é aplicado, mas não contém um valor para um campo específico: 'labels/contract' in labels AND labels/contract.comment IS NULL.

2. pesquisar com base em campos de valor único

É possível escrever consultas de pesquisa para corresponder aos valores de campo esperados. A tabela abaixo mostra as consultas de campo válidas:

O que você quer consultar	String de consulta
Itens em que o comentário está definido como "olá"	labels/contract.comment = 'hello'
Arquivos em que o comentário começa com "olá"	labels/contract.comment STARTS WITH 'hello'
Arquivos com status executado	labels/contract.status = 'executed'
Arquivos em que o status não é executado	labels/contract.status != 'executed'
Arquivos em que run_date é anterior a uma data específica	labels/contract.execution_date < '2020-06-22'
Arquivos em que valor_usd (número inteiro) é menor que um valor específico	labels/contract.value_usd < 2000
Arquivos em que client_contact está definido como um endereço de e-mail específico	labels/contract.client_contact = '[e-mail]'

3. Pesquise com base em campos com campos de vários valores (como ListOptions.max_Entries > 1)

Campos que aceitam vários valores só podem ser consultados usando o operador IN:

• 'EMAIL_ADDRESS' IN labels/project.project_leads
• NOT 'EMAIL_ADDRESS' IN labels/project.project_leads

Exemplo

O exemplo de código a seguir mostra como usar um ou mais labelId para listar todos os arquivos com um marcador ou valor de campo específico de um recurso de arquivo do Drive. Ela também usa o método files.list. O corpo da solicitação precisa estar vazio.

Se você quiser incluir labelInfo na resposta, também vai precisar especificar:

• includeLabels como uma lista de IDs separada por vírgulas.

• labelInfo no parâmetro fields para indicar que você quer que o labelInfo seja retornado em includeLabels.

Se bem-sucedido, o corpo da resposta vai conter a lista de arquivos.

Java

List<File> fileList = driveService.files().list().setIncludeLabels("LABEL_1_ID,LABEL_2_ID").setFields("items(labelInfo, id)").setQ("'labels/LABEL_1_ID' in labels and 'labels/LABEL_2_ID' in labels").execute().getItems();

Python

file_list = drive_service.files().list(includeLabels="LABEL_1_ID,LABEL_2_ID", q="'labels/LABEL_1_ID' in labels and 'labels/LABEL_2_ID' in labels", fields="items(labelInfo, id)").execute();

Node.js

/**
* Search for Drive files with specific labels
* @return{obj} file list with labelInfo
**/
async function searchForFileWithLabels() {
  // 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});
  try {
    const fileList = await service.files.list({
      includeLabels: 'LABEL_1_ID,LABEL_2_ID',
      q: '\'labels/LABEL_1_ID\' in labels and \'labels/LABEL_2_ID\' in labels',
      fields:'files(labelInfo, id)',
    });
    return file;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }

Substitua:

• LABEL_1_ID: o primeiro labelId de uma etiqueta a ser retornada.
• LABEL_2_ID: o segundo labelId de um rótulo a ser retornado.