Method: users.settings.cse.keypairs.list

Wyświetla pary kluczy szyfrowania po stronie klienta dla uwierzytelnionego użytkownika.

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

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs

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.

Parametry zapytania

Parametry
pageToken

string

Token strony, który wskazuje, która strona z parami kluczy ma zostać zwrócona. Jeśli token nie zostanie podany, interfejs API zwróci pierwszą stronę wyników.

pageSize

integer

Liczba par kluczy do zwrócenia. Jeśli nie podasz tej wartości, domyślnie zostanie użyta liczba 20.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "cseKeyPairs": [
    {
      object (CseKeyPair)
    }
  ],
  "nextPageToken": string
}
Pola
cseKeyPairs[]

object (CseKeyPair)

Jedna strona listy par kluczy szyfrowania po stronie klienta zainstalowanych u użytkownika.

nextPageToken

string

Token strony, który należy przekazać do kolejnego wywołania keypairs.list, aby pobrać kolejną stronę par kluczy. Jeśli ta wartość nie zostanie zwrócona, nie ma kolejnych stron.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.settings.sharing

Więcej informacji znajdziesz w przewodniku po autoryzacji.