REST Resource: users.settings.sendAs

Ressource: SendAs

Einstellungen für einen „Senden als“-Alias. Dabei kann es sich entweder um die primäre Anmeldeadresse des Kontos oder um eine benutzerdefinierte „Von“-Adresse handeln. „Senden als“-Aliase entsprechen der Funktion „Senden als“ in der Weboberfläche. Der „Senden als“-Alias muss eine gültige E‑Mail-Adresse sein.

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 im Header „Von:“ für E‑Mails angezeigt wird, die mit diesem Alias gesendet wurden. Dieses Feld ist für alle Vorgänge außer „Erstellen“ schreibgeschützt.
displayName

string

Ein Name, der im Header „Von:“ für E‑Mails angezeigt wird, die mit diesem Alias gesendet wurden. Wenn dieses Feld für benutzerdefinierte „Von“-Adressen leer ist, wird in Gmail der Header „Von:“ mit dem Namen gefüllt, der für die primäre Adresse des Kontos verwendet wird. Wenn der Administrator die Möglichkeit für Nutzer deaktiviert hat, ihr Namensformat zu aktualisieren, schlagen Anfragen zum Aktualisieren dieses Felds für die primäre Anmeldung im Hintergrund fehl.
replyToAddress

string

Eine optionale E‑Mail-Adresse, die in einem „Antworten an:“-Header für E‑Mails enthalten ist, die mit diesem Alias gesendet wurden. Wenn dieses Feld leer ist, wird in Gmail kein „Antworten an:“-Header generiert.
signature

string

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

boolean

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

boolean

Gibt an, ob diese Adresse als Standardadresse für „Von:“ ausgewählt ist, z. B. beim Verfassen einer neuen Nachricht oder beim Senden einer automatischen Abwesenheitsantwort. Jedes Gmail-Konto hat genau eine Standardadresse für „Senden als“. Der einzige gültige Wert, den Clients in dieses Feld schreiben können, ist true. Wenn Sie diesen Wert für eine Adresse von false in true ändern, wird dieses Feld für die andere vorherige Standardadresse in false geändert.
treatAsAlias

boolean

Gibt an, 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“-Aliase.
smtpMsa

object (SmtpMsa)

Ein optionaler SMTP-Dienst, der als ausgehendes Relay für E‑Mails verwendet wird, die mit diesem Alias gesendet wurden. Wenn dieses Feld leer ist, werden ausgehende E‑Mails direkt von den Gmail-Servern an den Ziel-SMTP-Dienst gesendet. Diese Einstellung gilt nur für benutzerdefinierte „Von“-Aliase.
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“-Aliase.

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 beim SMTP-Dienst verwendet wird. Dies ist ein schreibgeschütztes Feld, das in Anfragen zum Erstellen oder Aktualisieren von „Senden als“-Einstellungen angegeben werden kann. Es wird in Antworten nie ausgefüllt.
password

string

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

enum (SecurityMode)

Das Protokoll, das zum Sichern der Kommunikation mit dem SMTP-Dienst verwendet wird. Erforderlich.

SecurityMode

Ein Protokoll, das zum Sichern der Kommunikation mit dem SMTP-Dienst verwendet werden kann.

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

VerificationStatus

Gibt an, ob das Eigentum an 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 wartet auf die Bestätigung durch den Inhaber.

Methoden

create

 Erstellt einen benutzerdefinierten „Senden als“-Alias für „Von“.

delete

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

get

 Ruft den angegebenen „Senden als“-Alias ab.

list

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

patch

 Patcht den angegebenen „Senden als“-Alias.

update

 Aktualisiert einen „Senden als“-Alias.

verify

 Sendet eine Bestätigungs-E‑Mail an die angegebene „Senden als“-Aliasadresse.