Method: users.settings.delegates.create
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Dodaje użytkownika zweryfikowanego jako accepted bez wysyłania e-maila weryfikacyjnego. Użytkownik delegowany musi być członkiem tej samej organizacji Google Workspace co użytkownik delegujący.
Gmail nakłada ograniczenia na liczbę przedstawicieli i delegujących, których może mieć każdy użytkownik w organizacji Google Workspace. Te limity zależą od organizacji, ale ogólnie każdy użytkownik może mieć maksymalnie 25 przedstawicieli i maksymalnie 10 delegatów.
Pamiętaj, że użytkownik upoważniony musi być wskazany za pomocą podstawowego adresu e-mail, a nie aliasu.
Pamiętaj też, że po utworzeniu nowego użytkownika zastępczego może minąć nawet minuta, zanim będzie on dostępny do użycia.
Ta metoda jest dostępna tylko dla klientów kont usługi, którym przekazano uprawnienia w całej domenie.
Żądanie HTTP
POST 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. Wartość specjalna „me” może służyć do wskazywania uwierzytelnionego użytkownika.
|
Treść żądania
Treść żądania zawiera wystąpienie elementu Delegate.
Treść odpowiedzi
Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję Delegate.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/gmail.settings.sharing
Więcej informacji znajdziesz w przewodniku dotyczącym 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: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[],[],null,["# Method: users.settings.delegates.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nAdds a delegate with its verification status set directly to `accepted`, without sending any verification email. The delegate user must be a member of the same Google Workspace organization as the delegator user.\n\nGmail imposes limitations on the number of delegates and delegators each user in a Google Workspace organization can have. These limits depend on your organization, but in general each user can have up to 25 delegates and up to 10 delegators.\n\nNote that a delegate user must be referred to by their primary email address, and not an email alias.\n\nAlso note that when a new delegate is created, there may be up to a one minute delay before the new delegate is available for use.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.\n\n### HTTP request\n\n`POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------|\n| `userId` | `string` User's email address. The special value \"me\" can be used to indicate the authenticated user. |\n\n### Request body\n\nThe request body contains an instance of [Delegate](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#Delegate).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Delegate](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#Delegate).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/gmail.settings.sharing`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
