השבתה, הפעלה ומחיקה של תווית

במאמר הזה מוסבר איך לבצע את הפעולות הבאות שקשורות לתוויות:

• השבתה של תווית
• הפעלת תווית
• מחיקת תווית

השבתה של תווית

השבתה של תווית יוצרת גרסה חדשה מושבתת שפורסמה על סמך הגרסה הנוכחית שפורסמה. אם יש טיוטה של עדכון, נוצרת טיוטה חדשה של עדכון שמושבתת על סמך הטיוטה האחרונה של העדכון. גרסאות טיוטה ישנות יותר נמחקות. מידע נוסף זמין במאמר בנושא מחזור החיים של התווית.

אחרי ההשבתה, המשתמשים עדיין יכולים להוסיף את התווית הזו באמצעות Google Drive Labels API. התווית עדיין מופיעה במקומות שבהם היא כבר הוחלה ובתוצאות החיפוש. אפשר למחוק תווית מושבתת.

כדי להשבית תווית שפורסמה, משתמשים בשיטה disable במשאב labels.

צריך גם לציין:

• מקור מידע labels שמייצג את התווית. הוא מכיל name וid, שהוא מזהה ייחודי של התווית בכל העולם.

• פרמטר השאילתה useAdminAccess מוגדר לערך true כדי להשתמש בהרשאות האדמין של המשתמש. לפני אישור הגישה, השרת מאמת שלמשתמש יש הרשאות אדמין נדרשות לניהול תוויות סיווג.

בדוגמת הקוד הבאה מוצג איך משתמשים בפרמטר id של התווית כדי להשבית את התווית הנכונה:

Python

service.labels().disable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

Node.js

service.labels.disable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

מחליפים את ID במזהה של התווית שרוצים להשבית.

התווית כוללת את State של DISABLED, ומזהה הגרסה הקודמת של התווית גדל. המשתמשים יכולים להוסיף את התווית דרך Drive Labels API. עם זאת, תווית מושבתת לא מוצגת בממשק משתמש אלא אם השדה showInApply של האובייקט DisabledPolicy מוגדר.

הפעלת תווית

הפעלת תווית מושבתת מחזירה אותה למצב שבו היא פורסמה. התוצאה היא גרסה חדשה שפורסמה, שמבוססת על הגרסה הנוכחית שפורסמה והושבתה. אם יש טיוטה מושבתת קיימת, נוצרת גרסה חדשה על סמך הטיוטה הזו והיא מופעלת. מידע נוסף זמין במאמר בנושא מחזור החיים של התווית.

כדי להפעיל תווית מושבתת, משתמשים ב-method ‏enable במשאב labels.

צריך גם לציין:

• מקור מידע labels שמייצג את התווית. הוא מכיל name וid, שהוא מזהה ייחודי של התווית בכל העולם.

• פרמטר השאילתה useAdminAccess מוגדר לערך true כדי להשתמש בהרשאות האדמין של המשתמש. לפני אישור הגישה, השרת מאמת שלמשתמש יש הרשאות אדמין נדרשות לניהול תוויות סיווג.

בדוגמת הקוד הבאה אפשר לראות איך משתמשים ב-id של התווית כדי להפעיל את התווית הנכונה:

Python

service.labels().enable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

Node.js

service.labels.enable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

מחליפים את ID במזהה של התווית שרוצים להפעיל.

התווית כוללת את State של PUBLISHED, ומזהה הגרסה הקודמת של התווית גדל. משתמשים יכולים לראות את התווית ולהוסיף אותה לקבצים באמצעות Drive Labels API.

מחיקת תווית

אפשר למחוק רק תוויות במצב טיוטה או תוויות מושבתות. כשמוחקים תווית, כל המופעים שבהם התווית הוחלה בעבר, כולל כל ערכי השדה התואמים שהוזנו על ידי המשתמשים, נמחקים באופן סופי ומוסרים מקבצי Drive.

כדי למחוק תווית, קודם צריך להשבית אותה ואז להשתמש בשיטה delete במשאב labels.

צריך גם לציין:

• מקור מידע labels שמייצג את התווית. הוא מכיל name וid, שהוא מזהה ייחודי של התווית בכל העולם.

• פרמטר השאילתה useAdminAccess מוגדר לערך true כדי להשתמש בהרשאות האדמין של המשתמש. לפני אישור הגישה, השרת מאמת שלמשתמש יש הרשאות אדמין נדרשות לניהול תוויות סיווג.

בדוגמת הקוד הבאה אפשר לראות איך משתמשים בפרמטר id של התווית כדי למחוק את התווית הנכונה:

Python

response = service.labels().delete(
    name='labels/ID',
    useAdminAccess=True
).execute()

Node.js

service.labels.delete({
  name: 'labels/ID',
  useAdminAccess: true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

מחליפים את ID במזהה של התווית שרוצים למחוק.

התווית כוללת את State של DELETED, ומזהה הגרסה הקודמת של התווית גדל. אי אפשר להחיל את התווית, ובסופו של דבר התוויות שנמחקו נמחקות לצמיתות. מידע נוסף זמין במאמר בנושא מחזור החיים של התווית.