Wyszukiwanie plików z określoną etykietą lub wartością pola

Na tej stronie dowiesz się, jak wyszukać pliki z zastosowaną wartością etykiety lub pola.

Typy pól etykiet

Pola etykiet na Dysku Google są ściśle określone, a każdy z nich obsługuje różne semantykę indeksowania i wyszukiwania. W tabeli poniżej znajdziesz dostępne typy danych.

Typ Opcje typu etykiety Obsługiwane operatory wyszukiwania
Tekst TextOptions is null, is not null, =, contains, starts with
Długi tekst LongTextOptions is null, is not null, contains
Liczba całkowita IntegerOptions is null, is not null, =, !=, <, >, <=, >=
Data DateOptions is null, is not null, =, !=, <, >, <=, >=
Zaznaczenie SelectionOptions is null, is not null, =, !=
Użytkownik UserOptions is null, is not null, =, !=
Lista wyboru SelectionOptions (maksymalna_liczba wpisów > 1) is null, is not null, in, not in
Lista użytkowników UserOptions (z max_entries > 1) is null, is not null, in, not in

1. Wyszukiwanie na podstawie obecności etykiety lub pola

Możesz wyszukiwać elementy, do których wskazana etykieta została lub nie została zastosowana:

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

Możesz też wyszukiwać elementy, dla których określone pole ma (lub nie zostało) ustawione:

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

2. Wyszukiwanie na podstawie pól jednowartościowych

Możesz tworzyć zapytania pasujące do oczekiwanych wartości pól. Ta tabela zawiera prawidłowe zapytania dotyczące pól:

O co chcesz zapytać Ciąg zapytania
Elementy, w których komentarz jest ustawiony na „Cześć” labels/contract.comment = 'hello'
Pliki, których komentarz zaczyna się od słowa „Cześć” labels/contract.comment STARTS WITH 'hello'
Pliki, w przypadku których wykonywany jest stan labels/contract.status = 'executed'
Pliki, których stan nie jest wykonywany labels/contract.status != 'executed'
Pliki, w przypadku których data_wykonania przypada przed określoną datą labels/contract.execution_date < '2020-06-22'
Pliki, w których wartość_usd (liczba całkowita) jest mniejsza od określonej wartości labels/contract.value_usd < 2000
Pliki, w których client_contact jest ustawiony na określony adres e-mail. labels/contract.client_contact = 'alex@altostrat.com'

3. Wyszukiwanie na podstawie pól z polami wielowartościowymi (np. ListOptions.max_entries > 1)

Zapytania dotyczące pól obsługujących wiele wartości można wysyłać tylko z użyciem operatora IN:

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

Przykład

Poniższy przykładowy kod pokazuje, jak za pomocą co najmniej 1 elementu labelId wyświetlić listę wszystkich plików z określoną etykietą lub wartością pola z zasobu pliku na Dysku. Używa też metody files.list. Treść żądania musi być pusta.

Jeśli w odpowiedzi chcesz umieścić parametr labelInfo, musisz też podać te dane:

  • includeLabels w postaci listy identyfikatorów rozdzielonych przecinkami.

  • labelInfo w parametrze fields, aby wskazać, że ma być zwracana wartość labelInfo w ciągu includeLabels.

Jeśli operacja się uda, treść odpowiedzi będzie zawierała listę plików.

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

Zastąp następujące elementy:

  • LABEL_1_ID: pierwszy element (labelId) etykiety do zwrócenia.
  • LABEL_2_ID: drugi element labelId etykiety do zwrócenia.