Method: users.settings.cse.keypairs.obliterate

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 za pomocą wymazywanych kluczy. Uwierzytelnieni użytkownicy i administratorzy Google Workspace tracą dostęp do odczytu zaszyfrowanych wiadomości.

W przypadku administratorów zarządzających tożsamościami i parami kluczy użytkowników w organizacji prośby wymagają autoryzacji konta usługi, które ma uprawnienia do delegowania uprawnień 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 żądania wymagają włączenia i skonfigurowania szyfrowania za pomocą klucza sprzętowego.

Żą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

string

Podstawowy adres e-mail osoby, która wysłała prośbę. Aby wskazać uwierzytelnionego użytkownika, możesz użyć wartości specjalnej me.

keyPairId

string

Identyfikator pary kluczy, którą chcesz wymazać.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi to pusty obiekt JSON.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://www.googleapis.com/auth/gmail.settings.sharing

Więcej informacji znajdziesz w przewodniku po autoryzacji.