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

Z tego dokumentu dowiesz się, jak wykonywać te zadania 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 bieżącej opublikowanej wersji. Jeśli istnieje wersja robocza, na jej podstawie zostanie utworzona nowa wyłączona wersja robocza. Starsze wersje robocze zostaną usunięte. Więcej informacji znajdziesz w artykule Cykl życia etykiety.

Po wyłączeniu użytkownicy nadal mogą stosować tę etykietę za pomocą interfejsu API etykiet Dysku Google. Etykieta nadal będzie widoczna wszędzie tam, gdzie została już zastosowana, oraz w wynikach wyszukiwania. Wyłączoną etykietę można usunąć.

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

Musisz też określić:

Poniższy przykładowy kod pokazuje, jak użyć id etykiety, aby wyłączyć odpowiednią etykietę:

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

Zastąp ID identyfikatorem etykiety, którą chcesz wyłączyć.

Etykieta ma State ustawiony na DISABLED , a identyfikator wersji etykiety jest zwiększany. Użytkownicy mogą stosować etykietę za pomocą interfejsu Drive Labels API. Wyłączona etykieta nie jest jednak wyświetlana w interfejsie, chyba że skonfigurowane jest showInApply pole obiektu DisabledPolicy.

Włączanie etykiety

Włączenie wyłączonej etykiety przywraca ją do stanu opublikowanego. Powoduje to utworzenie nowej opublikowanej wersji na podstawie bieżącej wyłączonej opublikowanej wersji. Jeśli istnieje wyłączona wersja robocza, na jej podstawie zostanie utworzona nowa wersja, która zostanie włączona. Więcej informacji znajdziesz w artykule Cykl życia etykiety.

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

Musisz też określić:

Poniższy przykładowy kod pokazuje, jak użyć id etykiety, aby włączyć odpowiednią etykietę:

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

Zastąp ID identyfikatorem etykiety, którą chcesz włączyć.

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

Usuwanie etykiety

Można usuwać tylko wersje robocze i wyłączone etykiety. Gdy etykieta zostanie usunięta, wszystkie wystąpienia, w których była ona wcześniej stosowana, łącznie z odpowiednimi wartościami pól podanymi przez użytkowników, zostaną trwale skasowane i usunięte z tych plików na Dysku.

Aby usunąć etykietę, musisz najpierw ją wyłączyć, a potem użyć metody delete w zasobie labels.

Musisz też określić:

Poniższy przykładowy kod pokazuje, jak użyć id etykiety, aby usunąć odpowiednią etykietę:

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

Zastąp ID identyfikatorem etykiety, którą chcesz usunąć.

Etykieta ma State ustawiony na DELETED , a identyfikator wersji etykiety jest zwiększany. Etykiety nie można zastosować, a usunięte etykiety są ostatecznie usuwane. Więcej informacji znajdziesz w artykule Cykl życia etykiety.