Trwale i natychmiast usuwa parę kluczy szyfrowania po stronie klienta. Możesz trwale usunąć tylko pary kluczy, które są wyłączone od ponad 30 dni. Aby wyłączyć parę kluczy, użyj metody keypairs.disable.
Gmail nie może przywrócić ani odszyfrować żadnych wiadomości zaszyfrowanych przy użyciu usuniętego klucza. Uwierzytelnieni użytkownicy i administratorzy Google Workspace utracą dostęp do odczytywania zaszyfrowanych wiadomości.
W przypadku administratorów zarządzających tożsamościami i parami kluczy użytkowników w swojej organizacji żądania wymagają autoryzacji za pomocą konta usługi, które ma uprawnienia do delegowania w całej domenie, aby podszywać się pod użytkowników w zakresie https://www.googleapis.com/auth/gmail.settings.basic.
W przypadku użytkowników zarządzających własnymi tożsamościami i parami kluczy wymagane jest włączenie i skonfigurowanie szyfrowania za pomocą kluczy sprzętowych.
Żądanie HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry | |
|---|---|
userId |
Podstawowy adres e-mail osoby przesyłającej prośbę. Aby wskazać uwierzytelnionego użytkownika, możesz użyć wartości specjalnej |
keyPairId |
Identyfikator pary kluczy do usunięcia. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie pustym obiektem JSON.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/gmail.settings.basichttps://www.googleapis.com/auth/gmail.settings.sharing
Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.