Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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:
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).
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ń.
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
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.
Powiązane artykuły
Więcej informacji o tworzeniu aplikacji za pomocą interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Pierwsze kroki jako deweloper Google Workspace.
[null,null,["Ostatnia aktualizacja: 2025-08-29 UTC."],[],[],null,["# Drive Labels API overview\n\n*Labels* are metadata that you define to help users organize, find, and apply\npolicy to files in Google Drive. The Drive Labels API is a RESTful API that\nsupports business processes by attaching metadata to your Drive\nfiles. Common uses for this API are:\n\n- **Classify content to follow an information governance strategy**---Create a\n label to identify sensitive content or data that requires special handling.\n For example, you might create a badged label (a label with color-coded\n option values) titled \"Sensitivity\" with the values of \"Top Secret,\"\n \"Confidential,\" and \"Public.\"\n\n- **Apply policy to items in Drive**---Create labels to manage\n Drive content throughout its lifecycle and ensure it adheres\n to your organization's record keeping practices. For example, use labels to\n manage a data loss policy (DLP) whereby files with a \"Sensitivity\" label set\n to \"Top Secret\" can't be downloaded to a computer.\n\n- **Curate and find files**---Create labels to increase searchability of your\n company's content by letting people in your organization find items based on\n labels and their fields. For example, someone in your organization could use\n Drive search options to find all contracts awaiting signature\n by a specific date.\n\nBelow is a list of common terms used in the Drive Labels API:\n\n[*Label*](/workspace/drive/labels/reference/rest/v2/labels#resource:-label)\n\n: Structured metadata placed on a Drive file.\n Drive users can assign labels and set label field values for\n files. Labels are composed of:\n\n *Label name*\n : The resource name of the label. The *label ID* makes up part of the\n Label name. Depending on the request, the name is in the form of either:\n `labels/{id}` or `labels/{id}@{revisionId}`. For more information, see\n [Label revision](#revision) below.\n\n *Label ID*\n : A globally unique identifier for the label. The ID makes up part of the\n label name, but unlike the name, it's consistent between revisions.\n\n There are 2 styles of labels:\n\n *Badged label*\n\n : A label with a\n [`SelectionOptions`](/workspace/drive/labels/reference/rest/v2/labels#selectionoptions)\n field type containing *choices* that can be color-coded to indicate\n importance. This is done by setting\n [`badgeConfig`](/workspace/drive/labels/reference/rest/v2/labels#BadgeConfig)\n through the\n [`Properties`](/workspace/drive/labels/reference/rest/v2/labels#properties_1) of a\n [`Choice`](/workspace/drive/labels/reference/rest/v2/labels#choice).\n\n Drive displays the color of the chosen option for each file so users\n clearly understand the status, classification, and so on, of the file.\n For example, the \"Top Secret\" option for the \"Sensitivity\" badged label\n might display in red. You can only have one badged label at a time.\n\n *Standard label*\n\n : A label containing zero or more *field type*s. A standard label might\n have a label title, such as \"Project Moonshot,\" and indicate all files\n related to the project. A standard label might also have several\n structured fields. For example, a label with the title \"Contract\" might\n contain the fields for \"Company,\" \"Due Date,\" \"Status,\" and\n \"Signatories.\" Each field is of a specific type (text, date,\n selection, or user).\n\n|----------------------------|------------------------------|\n| **Figure 1.** Badged label | **Figure 2.** Standard label |\n\n[*Field*](/workspace/drive/labels/reference/rest/v2/labels#field)\n\n: An individual typed, settable component of a label. A label can have zero or\n more fields associated with it.\n\n *Field type*\n : The data type of the value associated with the *field* . Configurable as\n text, integer, date, user, or selection. If you configure the field with\n `ListOptions`, you can set the user and selection fields with multiple\n values. The type chosen impacts both the valid values applicable to\n Drive items and the search query options available.\n\n[*Choice*](/workspace/drive/labels/reference/rest/v2/labels#choice)\n\n: One of several options a user can choose from within a `SelectionOptions`\n field.\n\n[*Label type*](/workspace/drive/labels/reference/rest/v2/labels#labeltype)\n\n: All labels include a `LabelType`. There are 2 types of labels:\n\n *Admin*\n\n : To create and edit admin-owned labels, you must be an account\n administrator with the\n [Manage Labels](https://support.google.com/a/answer/1219251#drive_and_docs)\n privilege.\n\n Admins can share admin labels with any user to grant that user the\n ability to view and apply them to Drive items. Modifying or reading\n label values on Drive items requires the following permissions:\n\n - Modifying---For a user to modify the Drive item metadata related to a\n given label, the user must have the appropriate permission levels:\n\n - Drive item: `EDITOR`\n - Label: `APPLIER`\n - Reading---For a user to read or search for the Drive item metadata\n related to a given label, the user must have the appropriate\n permission levels:\n\n - Drive item: `READER`\n - Label: `READER`\n\n *Shared*\n\n : Non-administrator users can create shared labels that others can apply\n to Drive items. Teams can create and organize their own labels for use\n within the team without requiring an administrator.\n\n | **Note:** Shared labels are only available in a closed beta that isn't currently accepting new customers.\n\n*Label taxonomy*\n\n: The currently configured label fields available to users for application to\n Drive files. Also known as the label schema.\n\n Example label taxonomies:\n\n - Sensitivity---Red, Orange, Yellow, Green\n - Status---Not Started, Draft, In Review, Final\n - Content type---Contract, Design Doc, Mockup\n - Department---Marketing, Finance, Human Resources, Sales\n\n[*Label lifecycle*](/workspace/drive/labels/reference/rest/v2/labels#lifecycle)\n\n: Labels go through a lifecycle where they're created, published, updated, and\n so on. As a label makes it through the lifecycle, its *label revision* is\n incremented. For more information, see [Label lifecycle](/workspace/drive/labels/guides/label-lifecycle).\n\n*Label revision*\n\n: An instance of the label. Anytime a label is created, updated, published, or\n deprecated, the label revision increments.\n\n *Draft revision*\n : The revision number of the current draft instance of the label. You can\n make several updates to a label, each incrementing its draft revision\n number, without affecting the published revision. The ability to have\n draft labels lets you test label updates before publishing.\n\n *Published revision*\n : The revision number of the published version of a label. The published\n label is the instance of the label currently available to users.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Get started as a\n Google Workspace\n developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Labels API app, try the\n [Python quickstart](/workspace/drive/labels/quickstart/python)."]]
