REST Resource: users.settings.sendAs

Ressource: SendAs

Einstellungen, die mit einem Alias für „Senden als“ verknüpft sind. Dies kann entweder die primäre Anmeldeadresse des Kontos oder eine benutzerdefinierte „Von“-Adresse sein. Aliasse für das Senden als entsprechen der Funktion „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 im Absenderheader für E-Mails angezeigt wird, die mit diesem Alias gesendet werden. Dieser ist für alle Vorgänge außer „Erstellen“ schreibgeschützt.
displayName

string

Ein Name, der in der Kopfzeile „Von:“ für E-Mails angezeigt wird, die mit diesem Alias gesendet wurden. Wenn die benutzerdefinierte Absenderadresse leer ist, wird in Gmail in der Kopfzeile „Von:“ der Name verwendet, 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, werden Anfragen zum Aktualisieren dieses Felds für die primäre Anmeldung ohne Benachrichtigung fehlschlagen.
replyToAddress

string

Eine optionale E-Mail-Adresse, die in der Kopfzeile „An:“ für E-Mails enthalten ist, die über diesen Alias gesendet werden. Wenn dieses Feld leer ist, generiert Gmail keine „An:“-Zeile.
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

Ob diese Adresse die primäre Adresse ist, mit der Sie sich im Konto anmelden. Jedes Gmail-Konto hat genau eine primäre Adresse, die nicht aus der Sammlung der Aliasse für das Senden als gelöscht werden kann. Dieses Feld ist schreibgeschützt.
isDefault

boolean

Ob diese Adresse als Standard-Absenderadresse ausgewählt wird, z. B. beim Verfassen einer neuen Nachricht oder beim Senden einer automatischen Antwort für den Urlaub. Jedes Gmail-Konto hat genau eine Standardadresse für das Senden als. Daher ist der einzige zulässige Wert, den Clients in dieses Feld schreiben dürfen, 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

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 Absenderaliasse.
smtpMsa

object (SmtpMsa)

Ein optionaler SMTP-Dienst, der als ausgehendes Relay für E-Mails verwendet wird, die über diesen Alias gesendet werden. 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 Absenderaliasse.
verificationStatus

enum (VerificationStatus)

Gibt an, ob diese Adresse für die Verwendung als Alias für das Senden von E-Mails bestätigt wurde. Schreibgeschützt. Diese Einstellung gilt nur für benutzerdefinierte Absenderaliasse.

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. Dieses Feld kann nur zum Schreiben verwendet werden und kann in Anfragen zum Erstellen oder Aktualisieren von SendAs-Einstellungen angegeben werden. Es wird nie in Antworten eingefügt.
password

string

Das Passwort, das für die Authentifizierung beim SMTP-Dienst verwendet wird. Dieses Feld kann nur zum Schreiben verwendet werden und kann in Anfragen zum Erstellen oder Aktualisieren von SendAs-Einstellungen angegeben werden. Es wird nie in Antworten eingefügt.
securityMode

enum (SecurityMode)

Das Protokoll, das für die sichere Kommunikation mit dem SMTP-Dienst verwendet wird. Erforderlich.

SecurityMode

Ein Protokoll, das zur Sicherung 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 wird mit SSL gesichert.
starttls Die Kommunikation mit dem Remote-SMTP-Dienst wird mit STARTTLS gesichert.

VerificationStatus

Gibt an, ob die Inhaberschaft einer Adresse für die Verwendung als Alias für das Senden von E-Mails bestätigt wurde.

Enums
verificationStatusUnspecified Nicht angegebener Bestätigungsstatus.
accepted Die Adresse kann als Alias für das Senden von E-Mails verwendet werden.
pending Die Adresse muss noch vom Eigentümer bestätigt werden.

Methoden

create

 Erstellt einen benutzerdefinierten Alias für das Senden von E-Mails mit dem Absender „Von:“.

delete

 Löscht den angegebenen Alias für das Senden als.

get

 Ruft den angegebenen Alias für das Senden als ab.

list

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

patch

 Patch für den angegebenen Alias für das Senden als

update

 Aktualisiert einen Alias für das Senden als.

verify

 Es wird eine Bestätigungs-E-Mail an die angegebene Alias-Adresse für das Senden als gesendet.