Wyłączanie, włączanie i usuwanie etykiety

Na tej stronie dowiesz się, jak wykonywać te czynności związane z etykietami:

• Wyłączanie etykiety
• Włączanie etykiety
• Usuwanie etykiety

Wyłączanie etykiety

Wyłączenie etykiety powoduje utworzenie nowej wyłączonej opublikowanej wersji na podstawie aktualnie opublikowanej wersji. Jeśli dostępna jest wersja robocza, nowa wyłączona wersja robocza jest tworzona na podstawie ostatniej wersji roboczej. Starsze wersje robocze są usuwane. Więcej informacji znajdziesz w artykule Cykl życia etykiety.

Po wyłączeniu tej etykiety użytkownicy będą nadal mogli stosować ją za pomocą interfejsu API. Ta etykieta będzie nadal widoczna tam, gdzie została już zastosowana, i w wynikach wyszukiwania. Wyłączoną etykietę można usunąć.

Aby wyłączyć opublikowaną etykietę, użyj w kolekcji labels metody disable.

Musisz też podać:

• Zasób etykiety reprezentujący każdą etykietę. Zawiera zasoby Name i ID, które są globalnie unikalnym identyfikatorem etykiety.

• useAdminAccess: true, aby można było użyć danych logowania administratora. Przed zezwoleniem na dostęp serwer sprawdza, czy użytkownik jest administratorem etykiety.

W tym przykładzie użyto elementu ID, aby wyłączyć prawidłową etykietę.

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);
});

Etykieta ma wartość State o wartości DISABLED, a identyfikator wersji etykiety jest zwiększany. Użytkownicy mogą stosować ją za pomocą interfejsu API. Wyłączona etykieta nie będzie jednak widoczna w interfejsie, chyba że skonfigurowana jest właściwość showInApply metody disabledPolicy.

Włączanie etykiety

Włączenie wyłączonej etykiety spowoduje przywrócenie jej do stanu publikacji. Powoduje to utworzenie nowej opublikowanej wersji na podstawie aktualnie wyłączonej opublikowanej wersji. Jeśli istnieje wyłączona wersja robocza, utworzona na jej podstawie nowa wersja zostanie włączona. Więcej informacji znajdziesz w artykule Cykl życia etykiety.

Aby włączyć wyłączoną etykietę, użyj metody enable.

Musisz też podać:

• Zasób etykiety reprezentujący każdą etykietę. Zawiera zasoby Name i ID, które są globalnie unikalnym identyfikatorem etykiety.

• useAdminAccess: true, aby można było użyć danych logowania administratora. Przed zezwoleniem na dostęp serwer sprawdza, czy użytkownik jest administratorem etykiety.

W tym przykładzie użyto elementu ID, aby włączyć prawidłową etykietę.

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);
});

Etykieta ma wartość State o wartości PUBLISHED, a identyfikator wersji etykiety jest zwiększany. Użytkownicy mogą wyświetlać etykietę i stosować ją do plików za pomocą interfejsu API.

Usuwanie etykiety

Można usunąć tylko wersje robocze i wyłączone etykiety. Po usunięciu etykiety wszystkie przypadki, w których była ona wcześniej stosowana, w tym wszystkie odpowiadające im wartości pól wpisane przez użytkowników, są trwale usuwane i usuwane z tych plików na Dysku.

Aby usunąć etykietę, musisz ją najpierw wyłączyć, a następnie użyć metody delete.

Musisz też podać:

• Zasób etykiety reprezentujący każdą etykietę. Zawiera zasoby Name i ID, które są globalnie unikalnym identyfikatorem etykiety.

• useAdminAccess: true, aby można było użyć danych logowania administratora. Przed zezwoleniem na dostęp serwer sprawdza, czy użytkownik jest administratorem etykiety.

W tym przykładzie do usunięcia prawidłowej etykiety użyto elementu 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);
});

Etykieta ma wartość State o wartości DELETED, a identyfikator wersji etykiety jest zwiększany. Nie można zastosować etykiety, a usunięte etykiety zostaną w końcu trwale usunięte. Więcej informacji znajdziesz w artykule Cykl życia etykiety.