- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
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 | 
 Podstawowy adres e-mail osoby, która wysłała prośbę. Aby wskazać uwierzytelnionego użytkownika, możesz użyć wartości specjalnej  | 
Parametry zapytania
| Parametry | |
|---|---|
| pageToken | 
 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 | 
 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 ( | 
| Pola | |
|---|---|
| cseKeyPairs[] | 
 Jedna strona listy par kluczy szyfrowania po stronie klienta zainstalowanych u użytkownika. | 
| nextPageToken | 
 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.