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

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

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

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

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

אחרי ההשבתה, המשתמשים עדיין יכולים להחיל את התווית הזו דרך ה-API. התווית עדיין מופיעה במקומות שבהם היא כבר הוחלה ובתוצאות החיפוש. אפשר למחוק תווית מושבתת.

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

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

• משאב Label שמייצג כל תווית. הוא מכיל משאב Name וID, שהוא מזהה ייחודי גלובלי של הלייבל.

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

בדוגמה הזו נשתמש בערך ID כדי להשבית את התווית הנכונה.

Python

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

Node.js

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

התווית כוללת את State של DISABLED ומזהה הגרסה הקודמת של התווית גדל. המשתמשים יכולים להוסיף את התווית באמצעות ה-API. עם זאת, תווית מושבתת לא מוצגת בממשק משתמש אלא אם מוגדר המאפיין showInApply של השיטה disabledPolicy.

הפעלת תווית

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

כדי להפעיל תווית מושבתת, משתמשים בשיטה enable.

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

• משאב Label שמייצג כל תווית. הוא מכיל משאב Name וID, שהוא מזהה ייחודי גלובלי של הלייבל.

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

בדוגמה הזו נשתמש ב-ID כדי להפעיל את התווית הנכונה.

Python

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

Node.js

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

התווית כוללת את State של PUBLISHED ומזהה הגרסה הקודמת של התווית גדל. משתמשים יכולים לראות את התווית ולהחיל אותה על קבצים דרך ה-API.

מחיקת תווית

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

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

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

• משאב Label שמייצג כל תווית. הוא מכיל משאב Name וID, שהוא מזהה ייחודי גלובלי של הלייבל.

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

בדוגמה הזו נשתמש בדגל ID כדי למחוק את התווית הנכונה.

Python

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

Node.js

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

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