Поиск файлов с определенной меткой или значением поля

На этой странице описывается, как искать файлы с определенной меткой или значением поля.

Типы полей меток

Поля меток Google Диска строго типизированы, каждый тип поддерживает различную семантику индексирования и поиска. В следующей таблице показаны доступные типы данных.

Примеры поиска

1. Поиск по наличию метки или поля

Вы можете искать товары, к которым была (или не была) применена определенная метка:

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

Вы также можете искать элементы, для которых задано (или не установлено) определенное поле:

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

2. Поиск по однозначным полям

Вы можете писать поисковые запросы, соответствующие ожидаемым значениям полей. В следующей таблице показаны допустимые запросы полей:

3. Поиск по полям с многозначными полями (например, ListOptions.max_entries > 1).

Поля, поддерживающие несколько значений, можно запрашивать только с помощью оператора IN:

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

Пример

В следующем примере кода показано, как использовать один или несколько labelId для вывода списка всех файлов с определенной меткой или значением поля из файлового ресурса Диска. Он также использует метод files.list . Тело запроса должно быть пустым.

Если вы хотите включить в ответ labelInfo , вам также необходимо указать:

• includeLabels в виде списка идентификаторов, разделенных запятыми.

• labelInfo в параметре fields , чтобы указать, что вы хотите, чтобы labelInfo возвращался внутри includeLabels .

В случае успеха тело ответа содержит список файлов.

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

Замените следующее:

• LABEL_1_ID : первый labelId возвращаемой метки.
• LABEL_2_ID : второй labelId возвращаемой метки.

На этой странице описывается, как искать файлы с определенной меткой или значением поля.

Типы полей меток

Поля меток Google Диска строго типизированы, каждый тип поддерживает различную семантику индексирования и поиска. В следующей таблице показаны доступные типы данных.

Примеры поиска

1. Поиск по наличию метки или поля

Вы можете искать товары, к которым была (или не была) применена определенная метка:

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

Вы также можете искать элементы, для которых задано (или не установлено) определенное поле:

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

2. Поиск по однозначным полям

Вы можете писать поисковые запросы, соответствующие ожидаемым значениям полей. В следующей таблице показаны допустимые запросы полей:

3. Поиск по полям с многозначными полями (например, ListOptions.max_entries > 1).

Поля, поддерживающие несколько значений, можно запрашивать только с помощью оператора IN:

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

Пример

В следующем примере кода показано, как использовать один или несколько labelId для вывода списка всех файлов с определенной меткой или значением поля из файлового ресурса Диска. Он также использует метод files.list . Тело запроса должно быть пустым.

Если вы хотите включить в ответ labelInfo , вам также необходимо указать:

• includeLabels в виде списка идентификаторов, разделенных запятыми.

• labelInfo в параметре fields , чтобы обозначить, что вы хотите, чтобы labelInfo возвращался внутри includeLabels .

В случае успеха тело ответа содержит список файлов.

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

Замените следующее:

• LABEL_1_ID : первый labelId возвращаемой метки.
• LABEL_2_ID : второй labelId возвращаемой метки.