Omówienie interfejsu Drive Labels API

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} lub labels/{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 elementu Choice.

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).

Diagram etykiety z plakietką.
Rysunek 1. Etykieta z plakietką
Diagram etykiety standardowej.
Rysunek 2. Etykieta standardowa
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
  • 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
Udostępnione

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.