Omówienie interfejsu Drive Labels API

Etykiety to metadane zdefiniowane przez Ciebie, które ułatwiają użytkownikom porządkowanie i znajdowanie plików na Dysku Google oraz stosowanie do nich zasad. Drive Etykiety API to interfejs API typu REST, który wspiera procesy biznesowe przez dołączanie metadanych do plików na Dysku. Typowe zastosowania tego interfejsu API to:

  • Klasyfikuj treści w celu zachowania zgodności ze strategią zarządzania informacjami – utwórz etykietę do identyfikowania treści lub danych wrażliwych, które wymagają specjalnego traktowania. Możesz na przykład utworzyć etykietę z plakietką (z wartościami oznaczonymi kolorami) zatytułowaną „Czułość” z wartościami „Ściśle tajne”, „Poufne” i „Publiczne”.

  • Stosowanie zasad do elementów na Dysku – utwórz etykiety, aby zarządzać zawartością Dysku przez cały cykl życia i upewnić się, że jest ona zgodna z zasadami przechowywania dokumentacji obowiązującymi w organizacji. Na przykład możesz używać etykiet do zarządzania zasadami utraty danych (DLP), przez co plików z etykietą „Czułość” ustawioną jako „Ściśle tajne” nie można pobrać na komputer.

  • Selekcjonowanie i znajdowanie plików – utwórz etykiety, aby ułatwić przeszukiwanie treści firmy, umożliwiając osobom w organizacji znajdowanie elementów na podstawie etykiet i ich pól. Na przykład ktoś w organizacji może skorzystać z opcji wyszukiwania na Dysku, aby znaleźć wszystkie umowy, które wymagają podpisania w określonym dniu.

Poniżej znajduje się lista popularnych terminów używanych w interfejsie Drive Etykiety API:

Etykieta

Uporządkowane metadane umieszczone w pliku na Dysku. Użytkownicy Dysku mogą przypisywać etykiety i ustawiać wartości pól etykiet dla plików. Na etykiety składają się:

Nazwa etykiety
Nazwa zasobu etykiety. Identyfikator etykiety stanowi część nazwy etykiety. W zależności od prośby nazwa może mieć taką postać: labels/{id} lub labels/{id}@{revisionId}. Więcej informacji znajdziesz w sekcji Wersja etykiety poniżej.
Identyfikator etykiety
Unikalny globalnie identyfikator etykiety. Identyfikator jest częścią nazwy etykiety, ale w przeciwieństwie do nazwy jest spójny między wersjami.

Dostępne są 2 style etykiet:

Etykieta z plakietką

Etykieta z typem pola SelectionOptions zawierającym opcje, które można oznaczyć kolorami, aby wskazać ich znaczenie. Można to zrobić, ustawiając badgeConfig za pomocą Properties w Choice.

Dysk wyświetla kolor wybranej opcji dla każdego pliku, dzięki czemu użytkownicy wiedzą, jaki jest stan, klasyfikacja itd. Na przykład opcja „Ściśle tajne” w przypadku etykiety z plakietką „Czułość” może być wyświetlana na czerwono. Możesz mieć tylko 1 etykietę z plakietką.

Etykieta standardowa

Etykieta zawierająca zero lub więcej typów pola. Etykieta standardowa może mieć tytuł, np. „Projekt Moonshot”, i wskazywać wszystkie pliki zwią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 ma określony typ (tekst, data, wybór lub użytkownik).

Diagram etykiet z plakietką.
Rysunek 1. Etykieta z plakietką
Diagram etykiet standardowych.
Rysunek 2. Etykieta standardowa
Pole

Pojedynczy, możliwy do ustawienia komponent etykiety. Z etykietą nie może być powiązanych lub więcej pól.

Typ pola
Typ danych wartości powiązanej z polem. Konfigurowalne jako tekst, liczba całkowita, data, użytkownik lub wybór. Jeśli skonfigurujesz to pole za pomocą funkcji ListOptions, w polach użytkownika i wyboru możesz ustawić wiele wartości. Wybrany typ wpływa zarówno na prawidłowe wartości dotyczące elementów na Dysku, jak i na dostępne opcje zapytań.
Wybór

Jedna z kilku opcji, które użytkownik może wybrać w polu SelectionOptions.

Typ etykiety

Wszystkie etykiety zawierają LabelType. Istnieją 2 typy etykiet:

Administrator

Aby tworzyć i edytować etykiety należące do administratora, musisz być administratorem konta z uprawnieniami do zarządzania etykietami.

Administratorzy mogą udostępniać etykiety administratora dowolnemu użytkownikowi, aby przyznać mu możliwość wyświetlania i stosowania 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 określoną etykietą, musi mieć odpowiednie poziomy uprawnień:

    • Element na Dysku: EDITOR
    • Etykieta: APPLIER

  • Odczytywanie – aby użytkownik mógł odczytać lub wyszukać metadane elementu na Dysku związane z daną etykietą, musi mieć odpowiednie uprawnienia:

    • Element na Dysku: READER
    • Etykieta: READER
Udostępnione

Użytkownicy bez uprawnień administratora 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 zespole bez konieczności zatrudniania administratora.

Taksonomia etykiet

Obecnie skonfigurowane pola etykiet dostępne dla użytkowników w przypadku aplikacji do plików na Dysku. Nazywany też schematem etykiet.

Przykładowe taksonomie etykiet:

  • Czułość: czerwony, pomarańczowy, żółty, zielony
  • Stan: Nie rozpoczęto, Wersja robocza, W trakcie sprawdzania, Ostateczna
  • Typ treści – kontrakt, dokument projektowy, model
  • Dział – marketing, finanse, zasoby ludzkie, sprzedaż
Cykl życia etykiet

Etykiety przechodzą cykl życia – są one tworzone, publikowane, aktualizowane itd. W miarę jak etykieta przechodzi przez cykl życia, jej wersja etykiety jest zwiększana. Więcej informacji znajdziesz w artykule Cykl życia etykiet.

Wersja etykiety

Wystąpienie etykiety. Za każdym razem, gdy etykieta jest utworzona, zaktualizowana, opublikowana lub wycofana, wersja etykiety zwiększa się.

Wersja robocza
Numer wersji bieżącej wersji roboczej etykiety. Możesz wprowadzić kilka zmian etykiety, zwiększając przy tym jej numer wersji roboczej, bez wpływu na opublikowaną wersję. Możliwość korzystania z etykiet w wersji roboczej pozwala przetestować ich aktualizacje przed opublikowaniem.
Wersja opublikowana
Numer wersji opublikowanej wersji etykiety. Opublikowana etykieta to instancja etykiety obecnie dostępnej dla użytkowników.