Method: users.settings.cse.identities.list

Wyświetla listę tożsamości zaszyfrowanych 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ń na poziomie domeny, 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/identities

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 tożsamości ma zostać zwrócona. Jeśli token nie zostanie podany, interfejs API zwróci pierwszą stronę wyników.
pageSize

integer

Liczba tożsamości 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 
{
  "cseIdentities": [
    {
      object (CseIdentity)
    }
  ],
  "nextPageToken": string
}
Pola
cseIdentities[]

object (CseIdentity)

Jedna strona listy tożsamości szyfrowania po stronie klienta skonfigurowanych dla użytkownika.
nextPageToken

string

Token strony, który zostanie przekazany do kolejnego wywołania listy tożsamości w celu pobrania kolejnej strony tożsamości. Jeśli ta wartość nie zostanie zwrócona lub jest pustym ciągiem, 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.