REST Resource: users.settings.sendAs

Ressource: SendAs

Einstellungen, die einem „Senden als“-Alias zugeordnet sind. Dabei kann es sich entweder um die primäre Log-in-Adresse des Kontos oder eine benutzerdefinierte „Von“-Adresse handeln. „Senden als“-Aliasse entsprechen der Funktion E-Mail senden als in der Weboberfläche.

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

string

Die E-Mail-Adresse, die bei E-Mails, die über dieses Alias gesendet werden, im "Von:"-Header angezeigt wird. Dies ist für alle Vorgänge außer „create“ schreibgeschützt.

displayName

string

Ein Name, der im „Von:“-Header für E-Mails angezeigt wird, die über dieses Alias gesendet werden. Wenn dieses Feld leer ist, wird bei benutzerdefinierten „Von:“-Adressen in Gmail der Name der primären Adresse des Kontos im „Von:“-Header eingefügt. Wenn der Administrator für Nutzer die Option zum Aktualisieren ihres Namensformats deaktiviert hat, schlagen Anfragen zur Aktualisierung dieses Felds für den primären Log-in automatisch fehl.

replyToAddress

string

Eine optionale E-Mail-Adresse, die in einem „Antwort an:“-Header für E-Mails enthalten ist, die über dieses Alias gesendet werden. Ist dieser Wert leer, wird in Gmail kein „Antwort an:“-Header generiert.

signature

string

Eine optionale HTML-Signatur, die in Nachrichten enthalten ist, die mit diesem Alias in der Gmail-Weboberfläche erstellt werden. Diese Signatur wird nur neuen E-Mails hinzugefügt.

isPrimary

boolean

Gibt an, ob diese Adresse die primäre Adresse ist, die zur Anmeldung im Konto verwendet wird. Jedes Gmail-Konto hat genau eine primäre Adresse und kann nicht aus der Sammlung der „Senden als“-Aliasse gelöscht werden. Dieses Feld ist schreibgeschützt.

isDefault

boolean

Gibt an, ob diese Adresse als standardmäßige "Von:"-Adresse verwendet wird, z. B. beim Schreiben einer neuen Nachricht oder beim Senden einer automatischen Abwesenheitsnotiz. Jedes Gmail-Konto hat genau eine Standard-Senden-als-Adresse. Der einzige zulässige Wert, den Kunden in dieses Feld eingeben können, ist true. Wenn Sie dies für eine Adresse von false in true ändern, wird dieses Feld für die andere vorherige Standardadresse zu false.

treatAsAlias

boolean

Legt fest, ob Gmail diese Adresse als Alias für die primäre E-Mail-Adresse des Nutzers behandeln soll. Diese Einstellung gilt nur für benutzerdefinierte „Von“-Aliasse.

smtpMsa

object (SmtpMsa)

Ein optionaler SMTP-Dienst, der als ausgehendes Relay für E-Mails verwendet wird, die über dieses Alias gesendet werden. Wenn dieses Feld leer ist, werden ausgehende E-Mails direkt von den Gmail-Servern an den SMTP-Zieldienst gesendet. Diese Einstellung gilt nur für benutzerdefinierte „Von“-Aliasse.

verificationStatus

enum (VerificationStatus)

Gibt an, ob diese Adresse für die Verwendung als „Senden als“-Alias bestätigt wurde. Schreibgeschützt. Diese Einstellung gilt nur für benutzerdefinierte „Von“-Aliasse.

SmtpMsa

Konfiguration für die Kommunikation mit einem SMTP-Dienst.

JSON-Darstellung
{
  "host": string,
  "port": integer,
  "username": string,
  "password": string,
  "securityMode": enum (SecurityMode)
}
Felder
host

string

Der Hostname des SMTP-Dienstes. Erforderlich.

port

integer

Der Port des SMTP-Dienstes. Erforderlich.

username

string

Der Nutzername, der für die Authentifizierung mit dem SMTP-Dienst verwendet wird. Dies ist ein schreibgeschütztes Feld, das in Anfragen zum Erstellen oder Aktualisieren von SendAs-Einstellungen angegeben werden kann. Es wird in Antworten nie ausgefüllt.

password

string

Das Passwort, das für die Authentifizierung mit dem SMTP-Dienst verwendet wird. Dies ist ein schreibgeschütztes Feld, das in Anfragen zum Erstellen oder Aktualisieren von SendAs-Einstellungen angegeben werden kann. Es wird in Antworten nie ausgefüllt.

securityMode

enum (SecurityMode)

Das Protokoll, das zur Sicherung der Kommunikation mit dem SMTP-Dienst verwendet wird. Erforderlich.

SecurityMode

Protokoll, das zur Sicherung der Kommunikation mit dem SMTP-Dienst verwendet werden kann.

Enums
securityModeUnspecified Sicherheitsmodus nicht angegeben.
none Die Kommunikation mit dem Remote-SMTP-Dienst ist nicht gesichert. Erfordert Port 25.
ssl Die Kommunikation mit dem Remote-SMTP-Dienst ist durch SSL gesichert.
starttls Die Kommunikation mit dem Remote-SMTP-Dienst wird durch STARTTLS gesichert.

VerificationStatus

Gibt an, ob die Inhaberschaft einer Adresse für die Verwendung als „Senden als“-Alias bestätigt wurde.

Enums
verificationStatusUnspecified Nicht angegebener Bestätigungsstatus.
accepted Die Adresse kann als „Senden als“-Alias verwendet werden.
pending Die Adresse muss noch vom Inhaber bestätigt werden.

Methoden

create

Erstellt einen benutzerdefinierten „Von“-Alias zum Senden als

delete

Löscht den angegebenen Alias als „Senden als“.

get

Ruft den angegebenen Alias als Absender ab.

list

Listet die „Senden als“-Aliasse für das angegebene Konto auf.

patch

Angegebenen „Senden als“-Alias patchen.

update

Aktualisiert einen „Senden als“-Alias.

verify

Sendet eine Bestätigungs-E-Mail an die angegebene Sende-als-Alias-Adresse.