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 |
Przykłady wyszukiwania
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 parametrzefields
, aby wskazać, że ma być zwracana wartośćlabelInfo
w ciąguincludeLabels
.
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.