Etykiety to metadane, które określasz, aby ułatwić użytkownikom porządkowanie i znajdowanie plików na Dysku Google oraz stosowanie do nich zasad. Drive Labels API to interfejs API typu REST, który obsługuje procesy biznesowe przez dołączanie metadanych do plików na Dysku. Typowe zastosowania tego interfejsu API to:
Sklasyfikuj treści, aby były zgodne ze strategią zarządzania informacjami – utwórz etykietę do identyfikowania treści poufnych lub danych wymagających specjalnego traktowania. Możesz na przykład utworzyć etykietę z plakietką (oznaczoną kolorami) o nazwie „Czułość” z wartościami „Ściśle tajne”, „Poufne” i „Publiczne”.
Stosowanie zasad do elementów na Dysku – utwórz etykiety, aby zarządzać treściami na Dysku przez cały cykl życia i upewnić się, że są one zgodne z zasadami przechowywania danych Twojej organizacji. Etykiety mogą na przykład służyć do zarządzania zasadami utraty danych (DLP), dzięki którym plików z etykietą „Czułość” ustawioną na „Ściśle tajne” nie można pobrać na komputer.
Wybieranie i znajdowanie plików – możesz tworzyć etykiety, aby ułatwić użytkownikom wyszukiwanie treści w organizacji. Dzięki temu użytkownicy w organizacji będą mogli znajdować elementy na podstawie etykiet i ich pól. Na przykład osoba w organizacji może użyć opcji wyszukiwania na Dysku, aby znaleźć wszystkie umowy, które oczekują na podpisanie do określonej daty.
Poniżej znajduje się lista typowych terminów używanych w interfejsie Drive Labels API:
- Etykieta
Uporządkowane metadane umieszczone w pliku na Dysku. Użytkownicy Dysku mogą przypisywać etykiety i ustawiać wartości pól etykiet w plikach. Etykiety składają się z:
- Nazwa etykiety
- Nazwa zasobu etykiety. Identyfikator etykiety stanowi część nazwy etykiety. W zależności od żądania nazwa może mieć postać:
labels/{id}
lublabels/{id}@{revisionId}
. Więcej informacji znajdziesz w sekcji Wersja etykiety poniżej. - Identyfikator etykiety
- Unikalny globalnie identyfikator etykiety. Identyfikator stanowi część nazwy etykiety, ale w przeciwieństwie do nazwy jest spójny między wersjami.
Są 2 style etykiet:
- Etykieta z plakietką
Etykieta z typem pola
SelectionOptions
zawierającym opcje wyboru, które można oznaczyć kolorami, aby wskazać istotność. W tym celu należy ustawićbadgeConfig
za pomocąProperties
elementuChoice
.Dysk wyświetla kolor wybranej opcji dla każdego pliku, aby użytkownicy mogli bez trudu zrozumieć stan, klasyfikację itp. Na przykład opcja „Ściśle tajna” etykiety z plakietką „Czułość” może mieć kolor czerwony. Możesz mieć tylko 1 etykietę z plakietką.
- Etykieta standardowa
Etykieta, która zawiera zero lub więcej typów pól. Etykieta standardowa może mieć tytuł etykiety, np. „Project Moonshot”, i wskazywać wszystkie pliki powiązane z projektem. Etykieta standardowa może też mieć kilka uporządkowanych pól. Na przykład etykieta „Umowa” może zawierać pola „Firma”, „Termin”, „Stan” i „Sygnatariusze”. Każde pole jest określonego typu (tekst, data, wybór lub użytkownik).
- Pole
Wpisany na głos, możliwy do skonfigurowania komponent etykiety. Z etykietą można powiązać zero lub więcej pól.
- Typ pola
- Typ danych wartości powiązanej z polem. Możliwe do skonfigurowania jako tekstu, liczby całkowitej, daty, użytkownika lub wyboru. Jeśli skonfigurujesz to pole za pomocą
ListOptions
, możesz ustawić w polach użytkownika i wyboru wiele wartości. Wybrany typ ma wpływ na prawidłowe wartości stosowane w przypadku elementów na Dysku i dostępne opcje zapytań.
- Wybór
Jedna z kilku opcji, które użytkownik może wybrać w polu
SelectionOptions
.- Typ etykiety
Wszystkie etykiety mają właściwość
LabelType
. Są 2 rodzaje etykiet:- Administracja
Aby tworzyć i edytować etykiety należące do administratora, musisz być administratorem konta z uprawnieniami Zarządzanie etykietami.
Administratorzy mogą udostępniać etykiety administracyjne dowolnemu użytkownikowi, aby umożliwić mu wyświetlanie i stosowanie ich do elementów na Dysku. Modyfikowanie lub odczytywanie wartości etykiet elementów na Dysku wymaga tych uprawnień:
Modyfikowanie – aby użytkownik mógł modyfikować metadane elementu na Dysku związane z daną etykietą, musi mieć odpowiednie uprawnienia:
- Element na Dysku:
EDITOR
- Etykieta:
APPLIER
- Element na Dysku:
Odczytywanie – aby użytkownik mógł odczytywać lub wyszukiwać metadane elementu na Dysku związane z daną etykietą, musi mieć odpowiednie poziomy uprawnień:
- Element na Dysku:
READER
- Etykieta:
READER
- Element na Dysku:
Użytkownicy niebędący administratorami mogą tworzyć udostępnione etykiety, które inni mogą stosować do elementów na Dysku. Zespoły mogą tworzyć i porządkować własne etykiety do użytku w ramach zespołu bez konieczności korzystania z pomocy administratora.
- Taksonomia etykiet
Obecnie skonfigurowane pola etykiet dostępne dla użytkowników, aby można było stosować je do plików na Dysku. Jest on też nazywany schematem etykiety.
Przykładowe taksonomie etykiet:
- Czułość: czerwony, pomarańczowy, żółty, zielony
- Stan – Nie rozpoczęto, Wersja robocza, W trakcie sprawdzania, Ostateczny
- Typ treści – umowa, dokument projektowy, wzór
- Dział – marketing, finanse, zasoby ludzkie, sprzedaż
- Cykl życia etykiety
Etykiety przechodzą cykl życia, w którym są tworzone, publikowane, aktualizowane itd. W miarę jak etykieta przechodzi przez cykl życia, jej wersja etykiety się zwiększa. Więcej informacji znajdziesz w artykule Cykl życia etykiety.
- Wersja etykiety
Wystąpienie etykiety. Za każdym razem, gdy tworzona, aktualizowana, publikowana lub wycofywana etykieta jest tworzona, jej wersja zwiększa się.
- Wersja robocza
- Numer wersji bieżącej wersji roboczej etykiety. Możesz wprowadzić kilka zmian w etykiecie, a każda z nich będzie zwiększać numer jej wersji roboczej, nie wpływając na opublikowaną wersję. Możliwość posiadania wersji roboczych etykiet umożliwia testowanie aktualizacji etykiet przed ich opublikowaniem.
- Opublikowana wersja
- Numer wersji opublikowanej wersji etykiety. Opublikowana etykieta to wystąpienie etykiety, która jest obecnie dostępna dla użytkowników.
Powiązane artykuły
Więcej informacji o programowaniu z użyciem interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Pierwsze kroki jako programista Google Workspace.
Aby dowiedzieć się, jak skonfigurować i uruchomić prostą aplikację interfejsu Labels API, skorzystaj z krótkiego wprowadzenia do Pythona.