קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
תוויות הן מטא-נתונים שאתם מגדירים כדי לעזור למשתמשים לארגן ולמצוא קבצים ב-Google Drive, וגם להוסיף להם כללי מדיניות. Drive Labels API הוא API ל-REST שתומך בתהליכים עסקיים על ידי צירוף מטא-נתונים לקבצים ב-Drive. שימושים נפוצים בממשק ה-API הזה:
סיווג תוכן בהתאם לאסטרטגיה לניהול מדיניות לגבי מידע – אפשר ליצור תווית כדי לזהות תוכן רגיש או נתונים שדורשים טיפול מיוחד.
לדוגמה, אפשר ליצור תווית עם סמל (תווית עם ערכי אפשרויות מקודדים בצבע) בשם 'רגישות' עם הערכים 'סודי ביותר', 'סודי' ו'ציבורי'.
החלת מדיניות על פריטים ב-Drive – יצירת תוויות לניהול התוכן ב-Drive לאורך מחזור החיים שלו, כדי לוודא שהוא עומד בדרישות של שיטות ניהול הרשומות בארגון. לדוגמה, אפשר להשתמש בתוויות כדי לנהל מדיניות למניעת אובדן נתונים (DLP), כך שאי אפשר יהיה להוריד למחשב קבצים עם התווית 'רגישות' שהוגדרה כ'סודי ביותר'.
ארגון קבצים וחיפוש שלהם – תוכלו ליצור תוויות כדי לשפר את יכולת החיפוש של התוכן של החברה, ולאפשר לאנשים בארגון למצוא פריטים לפי תוויות והשדות שלהן. לדוגמה, מישהו בארגון יכול להשתמש באפשרויות החיפוש ב-Drive כדי למצוא את כל החוזים שצריך לחתום עליהם עד תאריך מסוים.
ריכזנו כאן רשימה של מונחים נפוצים שמשמשים ב-Drive Labels API:
מטא-נתונים מובְנים שמוצבים בקובץ ב-Drive.
משתמשים ב-Drive יכולים להקצות תוויות ולהגדיר ערכים בשדות של תוויות בקבצים. התוויות מורכבות מ:
שם התווית
שם המשאב של התווית. מזהה התווית הוא חלק משם התווית. בהתאם לבקשה, השם הוא באחת מהצורות הבאות:
labels/{id} או labels/{id}@{revisionId}. מידע נוסף זמין בקטע שינוי תוויות שבהמשך.
מזהה התווית
מזהה ייחודי גלובלי של התווית. המזהה הוא חלק משם התווית, אבל בניגוד לשם, הוא עקבי בין הגרסאות.
ב-Drive מוצג הצבע של האפשרות שנבחרה לכל קובץ, כדי שהמשתמשים יוכלו להבין בבירור את הסטטוס, הסיווג וכו' של הקובץ.
לדוגמה, האפשרות 'סודי ביותר' לתווית עם תג 'רגישות' עשויה להופיע באדום. אפשר להוסיף תג רק לתווית אחת בכל פעם.
תווית רגילה
תווית שמכילה אפס סוגי שדות או יותר. תווית רגילה יכולה לכלול שם תווית, כמו 'פרויקט שאפתני', ולציין את כל הקבצים שקשורים לפרויקט. תווית רגילה יכולה לכלול גם כמה שדות מובנים. לדוגמה, תווית עם הכותרת 'חוזה' יכולה להכיל את השדות 'חברה', 'מועד לתשלום', 'סטטוס' ו'חותמים'. כל שדה הוא מסוג מסוים (טקסט, תאריך, בחירה או משתמש).
רכיב שניתן להקלדה ולהגדרה בתווית. תווית יכולה לכלול אפס שדות או יותר.
סוג השדה
סוג הנתונים של הערך שמשויך לשדה. אפשר להגדיר את השדה כטקסט, מספר שלם, תאריך, משתמש או בחירה. אם מגדירים בשדה את הערך ListOptions, אפשר להגדיר בשדות של המשתמש והבחירה כמה ערכים. הסוג שתבחרו ישפיע גם על הערכים התקפים שרלוונטיים לפריטים ב-Drive וגם על האפשרויות של שאילתות החיפוש שזמינות.
כל התוויות כוללות LabelType. יש 2 סוגים של תוויות:
מנהל מערכת
כדי ליצור ולערוך תוויות בבעלות האדמין, צריך להיות אדמין בחשבון עם ההרשאה ניהול תוויות.
אדמינים יכולים לשתף תוויות אדמין עם כל משתמש כדי לתת לו את האפשרות לראות אותן ולהחיל אותן על פריטים ב-Drive. כדי לשנות או לקרוא ערכי תוויות בפריטים ב-Drive, צריך את ההרשאות הבאות:
שינוי – כדי שמשתמש יוכל לשנות את המטא-נתונים של פריט ב-Drive שקשורים לתווית מסוימת, צריכות להיות לו רמות ההרשאה המתאימות:
פריט ב-Drive: EDITOR
תווית: APPLIER
קריאה – כדי שמשתמש יוכל לקרוא או לחפש את המטא-נתונים של פריט ב-Drive שקשורים לתווית מסוימת, צריכות להיות לו רמות ההרשאה המתאימות:
פריט ב-Drive: READER
תווית: READER
משותף
משתמשים שאין להם הרשאות אדמין יכולים ליצור תוויות משותפות שמשתמשים אחרים יכולים להוסיף לפריטים ב-Drive. צוותים יכולים ליצור ולארגן תוויות משלהם לשימוש בתוך הצוות, בלי צורך במנהל מערכת.
טקסונומיה של תוויות
שדות התוויות שמוגדרים כרגע וזמינים למשתמשים להחלה על קבצים ב-Drive. נקרא גם סכימת התוויות.
התוויות עוברות מחזור חיים שכולל יצירה, פרסום, עדכון וכן הלאה. במהלך מחזור החיים של תווית, הגרסה של התווית גדלה. מידע נוסף זמין במאמר בנושא מחזור החיים של תוויות.
Label revision
מופע של התווית. בכל פעם שיוצרים, מעדכנים, מפרסמים או מוציאים משימוש תווית, מספר הגרסה של התווית עולה.
Draft revision
מספר הגרסה של מופע הטיוטה הנוכחי של התווית. אתם יכולים לבצע כמה עדכונים בתווית, וכל עדכון יגדיל את מספר הטיוטה שלה, בלי להשפיע על הגרסה שפורסמה. האפשרות ליצור תוויות בטיוטה מאפשרת לכם לבדוק עדכונים של תוויות לפני הפרסום.
גרסה קודמת שפורסמה
מספר הגרסה של התווית שפורסמה. התווית שפורסמה היא המופע של התווית שזמין כרגע למשתמשים.
[null,null,["עדכון אחרון: 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)."]]
