REST Resource: users.settings.sendAs

Ressource: SendAs

Mit einem Sende-als-Alias verknüpfte Einstellungen, also entweder die mit dem Konto verknüpfte primäre Log-in-E-Mail-Adresse oder eine benutzerdefinierte „Von:“-Adresse Adresse. "Senden als"-Aliasse 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 Feld "Von:" -Header für E-Mails, die über diesen Alias gesendet werden. Dies ist für alle Vorgänge außer dem Erstellen schreibgeschützt.

displayName

string

Ein Name, der in der Zeile "Von:" -Header für E-Mails, die über diesen Alias gesendet werden. Für benutzerdefiniertes „Von“ Adressen eingeben, wird das Feld "Von:" -Header mit dem Namen, 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 zur Aktualisierung dieses Felds für die primäre Anmeldung ohne Meldung fehl.

replyToAddress

string

Eine optionale E-Mail-Adresse, die in einem "Antwort an"-Element enthalten ist: -Header für E-Mails, die über diesen Alias gesendet werden. Wenn dieses Feld leer ist, wird in Gmail keine Antwort an: Header.

signature

string

Eine optionale HTML-Signatur, die in Nachrichten enthalten ist, die mit diesem Alias in der Gmail-Weboberfläche erstellt 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 und kann nicht aus der Sammlung der "Senden als"-Aliasse gelöscht werden. Dieses Feld ist schreibgeschützt.

isDefault

boolean

Legt fest, ob diese Adresse als standardmäßige Absenderadresse ausgewählt wird: wenn Sie eine neue Nachricht schreiben oder eine automatische Abwesenheitsnotiz senden. Jedes Gmail-Konto hat genau eine Standard-Sende-Adresse. Daher darf von Kunden in dieses Feld nur true eingegeben werden. Wenn Sie diesen Wert für eine Adresse von false zu true ändern, wird dieses Feld für die andere vorherige Standardadresse zu false.

treatAsAlias

boolean

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

smtpMsa

object (SmtpMsa)

Ein optionaler SMTP-Dienst, der als ausgehendes Relay für E-Mails verwendet wird, die über diesen Alias gesendet werden. Wenn Sie hier keinen Wert eingeben, werden ausgehende E-Mails direkt von den Gmail-Servern an den SMTP-Zieldienst gesendet. Diese Einstellung gilt nur für benutzerdefinierte „Von:“- Aliasnamen.

verificationStatus

enum (VerificationStatus)

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

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. wird er nie in Antworten eingefügt.

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. wird er nie in Antworten eingefügt.

securityMode

enum (SecurityMode)

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

SecurityMode

Ein Protokoll, das zur sicheren Kommunikation mit dem SMTP-Dienst verwendet werden kann.

Enums
securityModeUnspecified Unbekannter Sicherheitsmodus.
none Die Kommunikation mit dem Remote-SMTP-Dienst ist ungesichert. 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 ihre Verwendung als Sende-als-Alias bestätigt wurde.

Enums
verificationStatusUnspecified Unbekannter Bestätigungsstatus.
accepted Die Adresse kann als Alias für das Senden als E-Mail-Adresse verwendet werden.
pending Die Adresse muss noch durch den Inhaber bestätigt werden.

Methoden

create

Erstellt ein benutzerdefiniertes „von“-Element Senden als Alias.

delete

Löscht das angegebene Senden als Alias.

get

Ruft das angegebene Senden als Alias ab.

list

Listet die Sende-als-Aliase für das angegebene Konto auf.

patch

Patchen Sie das angegebene Senden als Alias.

update

Aktualisiert einen „Senden als“-Alias.

verify

Sendet eine Bestätigungs-E-Mail an die angegebene Alias-Adresse für Absender.