REST Resource: users.settings.sendAs

Zasób: SendAs

Ustawienia powiązane z aliasem „Wyślij jako”, który może być głównym adresem logowania powiązanym z kontem lub niestandardowym adresem „Od”. Aliasy „Wyślij jako” odpowiadają funkcji „Wyślij e-maila jako” w interfejsie internetowym. Alias „Wyślij jako” musi być prawidłowym adresem e-mail.

Zapis JSON
{
  "sendAsEmail": string,
  "displayName": string,
  "replyToAddress": string,
  "signature": string,
  "isPrimary": boolean,
  "isDefault": boolean,
  "treatAsAlias": boolean,
  "smtpMsa": {
    object (SmtpMsa)
  },
  "verificationStatus": enum (VerificationStatus)
}
Pola
sendAsEmail

string

Adres e-mail, który pojawia się w nagłówku „Od:” w przypadku poczty wysyłanej przy użyciu tego aliasu. W przypadku wszystkich operacji z wyjątkiem tworzenia jest to pole tylko do odczytu.

displayName

string

Nazwa, która pojawia się w nagłówku „Od:” w przypadku poczty wysyłanej przy użyciu tego aliasu. W przypadku niestandardowych adresów „Od” gdy to pole jest puste, Gmail wypełni nagłówek „Od:” nazwą używaną dla podstawowego adresu powiązanego z kontem. Jeśli administrator wyłączy możliwość aktualizowania formatu nazwy przez użytkowników, prośby o zaktualizowanie tego pola w przypadku podstawowego loginu będą cicho odrzucane.

replyToAddress

string

Opcjonalny adres e-mail, który jest uwzględniany w nagłówku „Reply-To:” w przypadku poczty wysyłanej przy użyciu tego aliasu. Jeśli to pole jest puste, Gmail nie wygeneruje nagłówka „Reply-To:”.

signature

string

Opcjonalny podpis HTML, który jest dołączany do wiadomości tworzonych przy użyciu tego aliasu w interfejsie internetowym Gmaila. Ten podpis jest dodawany tylko do nowych e-maili.

isPrimary

boolean

Czy ten adres jest podstawowym adresem używanym do logowania się na konto. Każde konto Gmail ma dokładnie 1 podstawowy adres, którego nie można usunąć z kolekcji aliasów do wysyłania. To pole jest tylko do odczytu.

isDefault

boolean

Czy ten adres jest wybierany jako domyślny adres „Od:” w sytuacjach takich jak pisanie nowej wiadomości lub wysyłanie automatycznej odpowiedzi o nieobecności. Każde konto Gmail ma dokładnie 1 domyślny adres „Wyślij jako”, więc jedyną prawidłową wartością, jaką klienci mogą wpisać w tym polu, jest true. Jeśli zmienisz to ustawienie z false na true w przypadku jednego adresu, w przypadku innego poprzedniego adresu domyślnego to pole zmieni się na false.

treatAsAlias

boolean

Czy Gmail ma traktować ten adres jako alias podstawowego adresu e-mail użytkownika. To ustawienie dotyczy tylko niestandardowych aliasów „Od”.

smtpMsa

object (SmtpMsa)

Opcjonalna usługa SMTP, która będzie używana jako usługa przekaźnika poczty wychodzącej wysyłanej przy użyciu tego aliasu. Jeśli to pole jest puste, poczta wychodząca będzie wysyłana bezpośrednio z serwerów Gmaila do docelowej usługi SMTP. To ustawienie dotyczy tylko niestandardowych aliasów „Od”.

verificationStatus

enum (VerificationStatus)

Wskazuje, czy ten adres został zweryfikowany do użycia jako alias „Wyślij jako”. Tylko do odczytu. To ustawienie dotyczy tylko niestandardowych aliasów „Od”.

SmtpMsa

Konfiguracja komunikacji z usługą SMTP.

Zapis JSON
{
  "host": string,
  "port": integer,
  "username": string,
  "password": string,
  "securityMode": enum (SecurityMode)
}
Pola
host

string

Nazwa hosta usługi SMTP. Wymagane.

port

integer

Port usługi SMTP. Wymagane.

username

string

Nazwa użytkownika, która będzie używana do uwierzytelniania w usłudze SMTP. Jest to pole tylko do zapisu, które można określić w żądaniach utworzenia lub zaktualizowania ustawień SendAs. Nigdy nie jest wypełniane w odpowiedziach.

password

string

Hasło, które będzie używane do uwierzytelniania w usłudze SMTP. Jest to pole tylko do zapisu, które można określić w żądaniach utworzenia lub zaktualizowania ustawień SendAs. Nigdy nie jest wypełniane w odpowiedziach.

securityMode

enum (SecurityMode)

Protokół, który będzie używany do zabezpieczania komunikacji z usługą SMTP. Wymagane.

SecurityMode

Protokół, który może być używany do zabezpieczania komunikacji z usługą SMTP.

Wartości w polu enum
securityModeUnspecified Nieokreślony tryb zabezpieczeń.
none Komunikacja ze zdalną usługą SMTP jest niezabezpieczona. Wymaga portu 25.
ssl Komunikacja ze zdalną usługą SMTP jest zabezpieczona protokołem SSL.
starttls Komunikacja ze zdalną usługą SMTP jest zabezpieczona za pomocą STARTTLS.

VerificationStatus

Wskazuje, czy własność adresu została zweryfikowana pod kątem używania go jako aliasu „Wyślij jako”.

Wartości w polu enum
verificationStatusUnspecified Nieokreślony stan weryfikacji.
accepted Adres jest gotowy do użycia jako alias „Wyślij jako”.
pending Adres oczekuje na weryfikację przez właściciela.

Metody

create

Tworzy niestandardowy alias „Wyślij jako” z adresem nadawcy.

delete

Usuwa określony alias „Wyślij jako”.

get

Pobiera określony alias „Wyślij jako”.

list

Wyświetla listę aliasów „Wyślij jako” dla określonego konta.

patch

Zastosuj poprawkę do określonego aliasu „Wyślij jako”.

update

Aktualizuje alias „Wyślij jako”.

verify

Wysyła e-maila weryfikacyjnego na podany adres aliasu „Wyślij jako”.