Omówienie interfejsu Drive Labels API

Etykiety to metadane zdefiniowane przez Ciebie, które ułatwiają użytkownikom porządkowanie, znajdowanie i stosowanie zasad dotyczących plików na Dysku Google. Drive label API to interfejs API typu RESTful, obsługuje procesy biznesowe przez dołączanie metadanych do Dysku . Typowe zastosowania tego interfejsu API to:

  • Klasyfikowanie treści w celu zachowania zgodności ze strategią zarządzania informacjami – utwórz do identyfikowania treści poufnych lub danych, które wymagają specjalnej obsługi. Możesz np. utworzyć etykietę z plakietką (oznaczoną kolorem, wartości opcji) o nazwie „Czułość” z wartościami „Ściśle tajne”, „Poufne”, i „Publiczny”.

  • Stosowanie zasad do elementów na Dysku – tworzenie etykiet do zarządzania Wyświetlaj treści przez cały cykl życia i zadbaj o ich zgodność do zasad przechowywania dokumentacji w Twojej organizacji. Etykiet możesz np. użyć do: zarządzanie zasadami utraty danych (DLP), w którym pliki cechują się czułością; zestaw etykiet do „Ściśle tajnych” nie mogą zostać pobrane na komputer.

  • Selekcjonowanie i znajdowanie plików – utwórz etykiety, aby zwiększyć dostępność treści firmowych, umożliwiając osobom w organizacji znajdowanie elementów na podstawie etykiet i ich pól. Na przykład ktoś w organizacji może użyć Opcje wyszukiwania na Dysku pozwalające znaleźć wszystkie umowy oczekujące na podpis 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 . Na etykiety składają się:

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

Dostępne są 2 style etykiet:

Etykieta z plakietką

Etykieta ze znakiem SelectionOptions typu pola zawierającego opcje, które można oznaczyć kolorami, aby wskazać znaczenie. Jest to możliwe dzięki ustawieniu badgeConfig przez Properties z Choice.

Dysk wyświetla kolor wybranej opcji każdego pliku, dzięki czemu użytkownicy określać stan, klasyfikację itd. pliku. Na przykład w kategorii „Ściśle tajne” w polu „Czułość” etykieta z plakietką mogą być zaznaczone 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ł etykiety, np. „Projekt Moonshot”, i wskaż wszystkie pliki związane z projektem. Etykieta standardowa może też zawierać kilka uporządkowanych pól. Na przykład etykietę zatytułowaną „Umowa” może zawierają pola „Firma”, „Termin”, „Stan”, oraz „Sygnatariusze”. Każde pole ma określony typ (tekst, data, wyboru lub użytkownika).

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

Pojedynczy, możliwy do ustawienia komponent etykiety. Etykieta może mieć wartość 0 lub (powiązanych z nią pól).

Typ pola
Typ danych wartości powiązanej z polem. Konfigurowalne jako tekst, liczba całkowita, data, użytkownik lub zaznaczenie. Jeśli skonfigurujesz pole z ListOptions, w polach użytkownika i wyboru możesz ustawić kilka wartości . Wybrany typ wpływa na prawidłowe wartości mające zastosowanie do Elementy na Dysku oraz opcje zapytań.
Wybór

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

Typ etykiety

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

Administrator

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

Administratorzy mogą udostępniać etykiety administratora dowolnemu użytkownikowi, aby przyznać mu możliwość wyświetlania ich i stosowania do elementów na Dysku. Modyfikowanie lub czytanie wartości etykiet w elementach na Dysku wymagają tych uprawnień:

  • Modyfikowanie – użytkownik może modyfikować metadane elementu na Dysku związane z dla danej etykiety użytkownik musi mieć odpowiednie poziomy uprawnień:

    • Element na Dysku: EDITOR
    • Etykieta: APPLIER
  • Odczyt – użytkownik może odczytać lub wyszukać metadane elementów na Dysku. związane z daną etykietą, użytkownik musi mieć odpowiednie poziomy uprawnień:

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

Użytkownicy bez uprawnień administratora mogą tworzyć udostępnione etykiety, które mogą stosować inni użytkownicy 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

aktualnie skonfigurowane pola etykiet dostępne dla użytkowników, do których aplikacja może Pliki 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, w którym są tworzone, publikowane, aktualizowane i tak dalej. Jako etykieta, która przechodzi przez cykl życia, wersja etykiety jest zwiększono. Więcej informacji znajdziesz w artykule Cykl życia etykiet.

Wersja etykiety

Wystąpienie etykiety. Za każdym razem, gdy etykieta zostanie utworzona, zaktualizowana, opublikowana lub wycofane, liczba wersji etykiety będzie rosnąć.

Wersja robocza
Numer wersji bieżącej wersji roboczej etykiety. Dostępne opcje wprowadzić kilka zmian w etykiecie, co zwiększa jej wersję roboczą bez wpływu na opublikowaną wersję. Możliwość wersje robocze etykiet umożliwiają testowanie ich aktualizacji przed opublikowaniem.
Wersja opublikowana
Numer wersji opublikowanej wersji etykiety. Opublikowana etykieta to wystąpienie etykiety obecnie dostępnej dla użytkowników.