Omówienie interfejsu Drive Labels API

Etykiety to metadane, które definiujesz, aby ułatwić użytkownikom porządkowanie i znajdowanie plików na Dysku Google oraz stosowanie do nich zasad. 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 „Wrażliwość” 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.

  • Selekcjonowanie i znajdowanie plików – twórz etykiety, które usprawnią przeszukiwanie treści w Twojej firmie, umożliwiając osobom z 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 format: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 taki sam w przypadku różnych wersji.

Istnieją 2 style etykiet:

Etykieta z plakietką

Etykieta z polem typuSelectionOptions zawierającym opcje, które można oznaczyć kolorami, aby wskazać ich ważność. W tym celu ustaw wartość badgeConfig w atrybucie Properties elementu Choice.

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

Etykieta standardowa

Etykieta zawierająca 0 lub więcej typów pól. Standardowa etykieta może mieć tytuł, np. „Projekt Moonshot”, i wskazywać wszystkie pliki związane z projektem. Etykieta standardowa może też zawierać kilka uporządkowanych pól. 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 z określonym typem, 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 typy 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 administracyjne dowolnemu użytkownikowi, aby przyznać mu możliwość wyświetlania i stosowania ich 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 powiązane z daną etykietą, musi mieć odpowiednie poziomy 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 udostępnione, które inne osoby mogą stosować do elementów na Dysku. Zespoły mogą tworzyć i organizować własne etykiety do użytku w zespole bez udziału administratora.

Taksonomia etykiet

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

Przykładowe kategorie etykiet:

  • Poufność – czerwony, pomarańczowy, żółty, zielony
  • Stan: nie rozpoczęto, 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, aktualizowane itd. 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, jej wersja jest zwiększana.

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 testować aktualizacje etykiet przed opublikowaniem.
Opublikowana wersja
Numer wersji opublikowanej wersji etykiety. Opublikowana etykieta to instancja etykiety, która jest obecnie dostępna dla użytkowników.