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

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

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

השבתת תווית

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

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

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

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

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

• useAdminAccess הוא 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 של ה-method disabledPolicy.

הפעלת תווית

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

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

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

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

• useAdminAccess הוא 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 הוא 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, ומזהה הגרסה של התווית גדל. אי אפשר להחיל את התווית, ותוויות שנמחקו יימחקו באופן סופי. מידע נוסף מופיע במאמר מחזור חיים של תוויות.