Omówienie interfejsu Drive Labels API

Etykiety to metadane, które definiujesz, aby ułatwić użytkownikom porządkowanie i znajdowanie plików oraz stosowanie do nich zasad na Dysku Google. Interfejs Drive Labels API to interfejs API REST, który obsługuje procesy biznesowe przez dołączanie metadanych do plików w usłudze Dysk. Typowe zastosowania tego interfejsu API:

  • Klasyfikowanie treści w celu zachowania zgodności ze strategią zarządzania informacjami – utwórz etykietę, aby identyfikować treści o charakterze kontrowersyjnym lub dane wymagające specjalnego traktowania. Możesz na przykład utworzyć etykietę z odznaką (etykietę z wartościami opcji oznaczonymi kolorami) o nazwie „Poufność” z wartościami „Ściśle tajne”, „Poufne” i „Publiczne”.

  • Stosowanie zasad do elementów na Dysku – twórz etykiety, aby zarządzać zawartością Dysku przez cały cykl życia i mieć pewność, że jest ona zgodna z zasadami przechowywania danych obowiązującymi w organizacji. Możesz na przykład używać etykiet do zarządzania zasadami zapobiegania utracie danych (DLP), zgodnie z którymi plików z etykietą „Poufność” ustawioną na „Ściśle tajne” nie można pobrać na komputer.

  • Porządkowanie i znajdowanie plików – twórz etykiety, aby zwiększyć możliwość wyszukiwania treści firmy, umożliwiając osobom w organizacji znajdowanie elementów na podstawie etykiet i ich pól. Na przykład użytkownik w organizacji może skorzystać z opcji wyszukiwania na Dysku, aby znaleźć wszystkie umowy, które wymagają podpisania do określonej daty.

Poniżej znajdziesz listę 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 przypadku plików. Etykiety składają się z tych elementów:

Nazwa etykiety
Nazwa zasobu etykiety. Identyfikator etykiety jest częścią nazwy etykiety. W zależności od żądania nazwa ma postać:labels/{id} lub labels/{id}@{revisionId}. Więcej informacji znajdziesz w sekcji Wersja etykiety poniżej.
Identyfikator etykiety
Globalnie unikalny identyfikator etykiety. Identyfikator jest częścią nazwy etykiety, ale w przeciwieństwie do nazwy jest spójny między wersjami.

Istnieją 2 style etykiet:

Etykieta z plakietką

Etykieta z polem typu SelectionOptions zawierającym opcje, które można oznaczyć kolorami, aby wskazać ich ważność. Możesz to zrobić, ustawiając badgeConfig za pomocą Properties elementu Choice.

Dysk wyświetla kolor wybranej opcji dla każdego pliku, dzięki czemu użytkownicy mogą łatwo sprawdzić stan lub klasyfikację pliku. Na przykład opcja „Ściśle tajne” w przypadku etykiety z plakietką „Poufność” może być wyświetlana na czerwono. W danej etykiecie możesz mieć tylko 1 pole z plakietką, ale możesz mieć wiele etykiet z plakietką.

Standardowa etykieta

Etykieta zawierająca 0 lub więcej typów pól. Etykieta standardowa może mieć tytuł, np. „Projekt Moonshot”, i wskazywać wszystkie pliki związane z projektem. Standardowa etykieta może też mieć kilka pól strukturalnych. Na przykład etykieta o nazwie „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

Pojedynczy komponent etykiety, który można ustawić. Etykieta może mieć 0 lub więcej powiązanych z nią pól.

Typ pola
Typ danych wartości powiązanej z polem. Można skonfigurować jako tekst, liczbę całkowitą, datę, użytkownika lub wybór. Jeśli skonfigurujesz pole za pomocą ListOptions, możesz ustawić pola użytkownika i wyboru z wieloma wartościami. Wybrany typ wpływa zarówno na prawidłowe wartości, które można zastosować do 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 SelectionOptionspolu.

Typ etykiety

Wszystkie etykiety zawierają znak LabelType. Istnieją 2 rodzaje etykiet:

Administrator

Aby tworzyć i edytować etykiety należące do administratora, musisz być administratorem konta z uprawnieniem Zarządzaj etykietami.

Administratorzy mogą udostępniać etykiety administratora dowolnym użytkownikom, aby umożliwić im wyświetlanie i stosowanie tych etykiet do elementów na Dysku. Modyfikowanie lub odczytywanie wartości etykiet w elementach na Dysku wymaga tych uprawnień:

  • Modyfikowanie – aby użytkownik mógł modyfikować metadane elementu na Dysku związane z daną etykietą, musi mieć odpowiedni poziom uprawnień:

    • Element na Dysku: EDITOR
    • Etykieta: APPLIER

  • Odczyt – aby użytkownik mógł odczytywać lub wyszukiwać metadane elementu na Dysku powiązane z daną etykietą, musi mieć odpowiednie poziomy uprawnień:

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

Użytkownicy, którzy nie są administratorami, mogą tworzyć etykiety współdzielone, które inne osoby mogą stosować do elementów na Dysku. Zespoły mogą tworzyć i porządkować własne etykiety do użytku w zespole bez udziału administratora.

Taksonomia etykiet

Obecnie skonfigurowane pola etykiet, które użytkownicy mogą stosować do plików na Dysku. Nazywany też schematem etykiet.

Przykładowe taksonomie etykiet:

  • Czułość – czerwony, pomarańczowy, żółty, zielony
  • Stan – nierozpoczęty, wersja robocza, w trakcie sprawdzania, wersja ostateczna
  • Typ treści: Umowa, Dokument projektowy, Podgląd
  • Dział – marketing, finanse, kadry, sprzedaż
Cykl życia etykiety

Etykiety przechodzą cykl życia, w którym są tworzone, publikowane i aktualizowane. W miarę przechodzenia etykiety przez cykl życia jej wersja jest zwiększana. Więcej informacji znajdziesz w artykule Cykl życia etykiety.

Wersja etykiety

Instancja etykiety. Za każdym razem, gdy etykieta jest tworzona, aktualizowana, publikowana lub wycofywana, numer wersji etykiety jest zwiększany.

Wersja robocza
Numer wersji bieżącej instancji etykiety w wersji roboczej. Możesz wprowadzić kilka aktualizacji etykiety, z których każda zwiększy numer wersji roboczej, bez wpływu na opublikowaną wersję. Możliwość tworzenia etykiet w wersji roboczej pozwala przetestować aktualizacje etykiet przed opublikowaniem.
Opublikowana wersja
Numer wersji opublikowanej etykiety. Opublikowana etykieta to instancja etykiety, która jest obecnie dostępna dla użytkowników.