Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Etiketler, kullanıcıların Google Drive'daki dosyaları düzenlemesine, bulmasına ve bu dosyalara politika uygulamasına yardımcı olmak için tanımladığınız meta verilerdir. Drive Labels API, Drive dosyalarınıza meta veriler ekleyerek iş süreçlerini destekleyen bir RESTful API'dir. Bu API'nin yaygın kullanım alanları şunlardır:
Bilgi yönetimi stratejisini izlemek için içeriği sınıflandırma: Hassas veya özel işlem uygulanması gereken içeriği ya da verileri tanımlamak için etiket oluşturun.
Örneğin, "Gizlilik" başlıklı ve "Çok Gizli", "Gizli" ve "Herkese Açık" değerlerine sahip bir rozetli etiket (renk kodlu seçenek değerlerine sahip bir etiket) oluşturabilirsiniz.
Drive'daki öğelere politika uygulama: Drive içeriğini yaşam döngüsü boyunca yönetmek ve kuruluşunuzun kayıt saklama uygulamalarına uygun olmasını sağlamak için etiketler oluşturun. Örneğin, "Hassasiyet" etiketi "Çok Gizli" olarak ayarlanmış dosyaların bilgisayara indirilemediği bir veri kaybını önleme (DLP) politikasını yönetmek için etiketleri kullanabilirsiniz.
Dosyaları seçme ve bulma: Kuruluşunuzdaki kullanıcıların öğeleri etiketlere ve alanlarına göre bulmasını sağlayarak şirketinizin içeriklerinin aranabilirliğini artırmak için etiketler oluşturun. Örneğin, kuruluşunuzdaki bir çalışan, belirli bir tarihe kadar imzalanması gereken tüm sözleşmeleri bulmak için Drive arama seçeneklerini kullanabilir.
Drive Labels API'de kullanılan yaygın terimlerin listesini aşağıda bulabilirsiniz:
Drive dosyasına yerleştirilen yapılandırılmış meta veriler.
Drive kullanıcıları, dosyalara etiket atayabilir ve etiket alan değerlerini ayarlayabilir. Etiketler şunlardan oluşur:
Etiket adı
Etiketin kaynak adı. Etiket kimliği, etiket adının bir bölümünü oluşturur. İsteğe bağlı olarak ad, labels/{id} veya labels/{id}@{revisionId} biçimindedir. Daha fazla bilgi için aşağıdaki Etiket düzeltmesi bölümüne bakın.
Label ID
Etiket için genel olarak benzersiz tanımlayıcı. Kimlik, etiket adının bir bölümünü oluşturur ancak adın aksine revizyonlar arasında tutarlıdır.
2 tür etiket stili vardır:
Rozetli etiket
Önemi belirtmek için renk kodlarıyla işaretlenebilen seçenekler içeren SelectionOptions alan türüne sahip bir etiket. Bu işlem, Choice öğesinin Properties aracılığıyla badgeConfig ayarlanarak yapılır.
Drive, her dosya için seçilen seçeneğin rengini gösterir. Böylece kullanıcılar, dosyanın durumunu, sınıflandırmasını vb. net bir şekilde anlayabilir.
Örneğin, "Gizlilik derecesi" rozetli etiketi için "Çok Gizli" seçeneği kırmızı renkte gösterilebilir. Aynı anda yalnızca bir rozetli etiketiniz olabilir.
Standart etiket
Sıfır veya daha fazla alan türü içeren bir etiket. Standart bir etiket, "Project Moonshot" gibi bir etiket başlığına sahip olabilir ve projeyle ilgili tüm dosyaları gösterebilir. Standart bir etikette birden fazla yapılandırılmış alan da olabilir. Örneğin, "Sözleşme" başlıklı bir etiket "Şirket", "Son Tarih", "Durum" ve "İmza Sahipleri" alanlarını içerebilir. Her alan belirli bir türdedir (metin, tarih, seçim veya kullanıcı).
Bir etiketin yazılmış, ayarlanabilir bağımsız bileşeni. Bir etiketle ilişkili alan olmayabilir veya birden fazla alan olabilir.
Alan türü
Alan ile ilişkili değerin veri türü. Metin, tam sayı, tarih, kullanıcı veya seçim olarak yapılandırılabilir. Alanı ListOptions ile yapılandırırsanız kullanıcı ve seçim alanlarını birden fazla değerle ayarlayabilirsiniz. Seçilen tür, hem Drive öğeleri için geçerli değerleri hem de kullanılabilen arama sorgusu seçeneklerini etkiler.
Tüm etiketler LabelType içerir. 2 tür etiket vardır:
Yönetici
Yöneticiye ait etiketleri oluşturmak ve düzenlemek için Etiketleri Yönetme ayrıcalığına sahip bir hesap yöneticisi olmanız gerekir.
Yöneticiler, yönetici etiketlerini herhangi bir kullanıcıyla paylaşarak bu kullanıcılara etiketleri görüntüleme ve Drive öğelerine uygulama olanağı verebilir. Drive öğelerindeki etiket değerlerini değiştirme veya okuma için aşağıdaki izinler gerekir:
Değiştirme: Bir kullanıcının belirli bir etiketle ilgili Drive öğesi meta verilerini değiştirebilmesi için uygun izin düzeylerine sahip olması gerekir:
Drive öğesi: EDITOR
Etiket: APPLIER
Okuma: Bir kullanıcının belirli bir etiketle ilgili Drive öğesi meta verilerini okuması veya araması için kullanıcının uygun izin düzeylerine sahip olması gerekir:
Drive öğesi: READER
Etiket: READER
Paylaşılan
Yönetici olmayan kullanıcılar, diğer kullanıcıların Drive öğelerine uygulayabileceği ortak etiketler oluşturabilir. Ekipler, yöneticiye gerek kalmadan ekip içinde kullanılmak üzere kendi etiketlerini oluşturup düzenleyebilir.
Etiket sınıflandırması
Kullanıcıların Drive dosyalarına uygulayabileceği, şu anda yapılandırılmış etiket alanları. Etiket şeması olarak da bilinir.
Örnek etiket sınıflandırmaları:
Hassasiyet: Kırmızı, Turuncu, Sarı, Yeşil
Durum: Başlatılmadı, Taslak, İncelemede, Nihai
İçerik türü: Sözleşme, Tasarım Dokümanı, Model
Departman: Pazarlama, Finans, İnsan Kaynakları, Satış
Etiketler, oluşturulma, yayınlanma, güncellenme gibi bir yaşam döngüsünden geçer. Bir etiket yaşam döngüsünü tamamladığında etiket düzeltmesi artırılır. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.
Etiket düzeltme
Etiketin bir örneği. Etiket oluşturulduğunda, güncellendiğinde, yayınlandığında veya kullanımdan kaldırıldığında etiket düzeltmesi artar.
Taslak düzeltme
Etiketin mevcut taslak örneğinin düzeltme numarası. Yayınlanan düzeltmeyi etkilemeden bir etikette birden fazla güncelleme yapabilirsiniz. Her güncelleme, taslak düzeltme numarasını artırır. Taslak etiketler oluşturma özelliği, etiket güncellemelerini yayınlamadan önce test etmenize olanak tanır.
Yayınlanan düzeltme
Bir etiketin yayınlanmış sürümünün düzeltme numarası. Yayınlanan etiket, şu anda kullanıcılar tarafından kullanılabilen etiket örneğidir.
İlgili konular
Kimlik doğrulama ve yetkilendirme işlemleri de dahil olmak üzere Google Workspace API'leriyle geliştirme hakkında bilgi edinmek için Google Workspace geliştiricisi olarak
başlama başlıklı makaleyi inceleyin.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-04 UTC."],[],[],null,["*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- 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)."]]
