Cómo buscar archivos con una etiqueta o un valor de campo específicos

En esta página, se describe cómo buscar archivos con una etiqueta o un valor de campo específicos aplicados.

Tipos de campos de etiqueta

Los campos de etiquetas de Google Drive tienen un tipo fuertemente definido, y cada tipo admite semánticas de indexación y búsqueda diferentes. En la siguiente tabla, se muestran los tipos de datos disponibles.

Ejemplos de búsquedas

1. Búsqueda basada en la presencia de una etiqueta o un campo

Puedes buscar elementos a los que se les aplicó (o no) una etiqueta específica:

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

También puedes buscar elementos en los que se haya establecido (o no) un campo específico:

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

2. Búsqueda basada en campos con un solo valor

Puedes escribir consultas de búsqueda para que coincidan con los valores de campo esperados. En la siguiente tabla, se muestran las consultas de campo válidas:

3. Búsqueda basada en campos con campos de varios valores (como ListOptions.max_entries > 1)

Los campos que admiten varios valores solo se pueden consultar con el operador IN:

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

Ejemplo

En la siguiente muestra de código, se muestra cómo usar uno o más labelId para enumerar todos los archivos con una etiqueta o un valor de campo específicos de un recurso de archivo de Drive. También usa el método files.list. El cuerpo de la solicitud debe estar vacío.

Si quieres incluir labelInfo en la respuesta, también debes especificar lo siguiente:

• includeLabels como una lista de IDs separados por comas.

• labelInfo en el parámetro fields para indicar que deseas que se muestre labelInfo dentro de includeLabels.

Si se realiza de forma correcta, el cuerpo de la respuesta contiene la lista de archivos.

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();

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();

/**
* 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;
  }

Reemplaza lo siguiente:

• LABEL_1_ID: El primer labelId de una etiqueta que se muestra.
• LABEL_2_ID: Es el segundo labelId de una etiqueta que se mostrará.