Method: users.settings.delegates.list
Wyświetla listę przedstawicieli dotyczących określonego konta.
Ta metoda jest dostępna tylko dla klientów kont usługi, którym przekazano uprawnienia w całej domenie.
Żądanie HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
userId |
string
Adres e-mail użytkownika. Specjalna wartość „ja” może służyć do wskazywania uwierzytelnionego użytkownika.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź dla metody delegates.list.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"delegates": [
{
object (Delegate)
}
]
} |
| Pola |
delegates[] |
object (Delegate)
Lista przedstawicieli użytkownika (z każdym stanem weryfikacji). Jeśli konto nie ma przedstawicieli, to pole nie jest wyświetlane.
|
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu 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
Więcej informacji znajdziesz w przewodniku na temat autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-09-05 UTC.
[null,null,["Ostatnia aktualizacja: 2024-09-05 UTC."],[[["Lists delegates for a specified account, accessible only to service accounts with domain-wide authority."],["Employs a `GET` request to the endpoint `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates`, using gRPC Transcoding syntax."],["Requires an empty request body and returns a JSON response containing a list of delegates, if any."],["Needs authorization with specific OAuth scopes like `https://www.googleapis.com/auth/gmail.settings.basic` or `https://www.googleapis.com/auth/gmail.modify`."]]],["A `GET` request is made to `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates` to list an account's delegates. The `userId` path parameter, which can be \"me,\" specifies the user. The request body must be empty. The response body, if successful, includes a JSON structure with a list of delegate objects under the \"delegates\" field. This action requires service account clients with domain-wide authority and specific OAuth scopes.\n"]]
