Aliasse verwalten

"Senden als"-Aliasse stehen für die E-Mail-Adressen, die mit einem Konto verknüpft werden können. Senden von E-Mails aus. Jedes Konto hat immer mindestens einen Alias für das primäre E-Mail-Adresse des Kontos.

"Senden als"-Aliase entsprechen der „Senden als“ Funktion im .

Aliasse werden auch verwendet, um Signaturen für ein Konto zu verwalten. Grundlegendes Verständnis von „Senden als“-Aliassen sind erforderlich, damit Sie E-Mail-Signaturen ändern können. Im obigen Video sehen Sie, wie Sie „Senden als“-Aliase durchlaufen und die für die primäre E-Mail-Adresse eines Nutzers.

Informationen zur erstellen, list, get, Update, oder Aliase löschen, sieh dir die SendAs-Referenz.

Aliasse erstellen und überprüfen

Sie müssen erstellen, vor der Verwendung Aliase an. In einigen Fällen müssen Nutzer auch die Inhaberschaft der Alias.

Wenn in Gmail eine Nutzerbestätigung für ein Alias erforderlich ist, wird der Alias mit dem Status pending. Eine Bestätigungs-E-Mail wird automatisch an den Ziel-E-Mail-Adresse. Der Inhaber der E-Mail-Adresse muss die Bestätigung abschließen bevor sie verwendet werden können.

Aliasse, für die keine Bestätigung erforderlich ist, haben den Bestätigungsstatus accepted.

Verwenden Sie die Methode verify, um die Bestätigungsanfrage bei Bedarf noch einmal zu senden.

SMTP-Einstellungen

Aliasse für externe Adressen sollten E-Mails über ein Remote-SMTP senden. E-Mail-Sende-Agent (E-Mail-Sende-Agent, MSA). Verwenden Sie zum Konfigurieren der SMTP-MSA für einen Alias Das Feld smtpMsa, um die Verbindungsdetails anzugeben.

Signaturen verwalten

Sie können auch für jeden Alias eine E-Mail-Signatur konfigurieren. Um beispielsweise den Parameter Signatur für die primäre E-Mail-Adresse des Nutzers:

Java

gmail/snippets/src/main/java/UpdateSignature.java

Auf GitHub ansehen

import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.gmail.Gmail;
import com.google.api.services.gmail.GmailScopes;
import com.google.api.services.gmail.model.ListSendAsResponse;
import com.google.api.services.gmail.model.SendAs;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;

/* Class to demonstrate the use of Gmail Update Signature API */
public class UpdateSignature {
  /**
   * Update the gmail signature.
   *
   * @return the updated signature id , {@code null} otherwise.
   * @throws IOException - if service account credentials file not found.
   */
  public static String updateGmailSignature() throws IOException {
        /* Load pre-authorized user credentials from the environment.
           TODO(developer) - See https://developers.google.com/identity for
            guides on implementing OAuth2 for your application. */
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(GmailScopes.GMAIL_SETTINGS_BASIC);
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(credentials);

    // Create the gmail API client
    Gmail service = new Gmail.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Gmail samples")
        .build();

    try {
      SendAs primaryAlias = null;
      ListSendAsResponse aliases = service.users().settings().sendAs().list("me").execute();
      for (SendAs alias : aliases.getSendAs()) {
        if (alias.getIsPrimary()) {
          primaryAlias = alias;
          break;
        }
      }
      // Updating a new signature
      SendAs aliasSettings = new SendAs().setSignature("Automated Signature");
      SendAs result = service.users().settings().sendAs().patch(
              "me",
              primaryAlias.getSendAsEmail(),
              aliasSettings)
          .execute();
      //Prints the updated signature
      System.out.println("Updated signature - " + result.getSignature());
      return result.getSignature();
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      GoogleJsonError error = e.getDetails();
      if (error.getCode() == 403) {
        System.err.println("Unable to update signature: " + e.getDetails());
      } else {
        throw e;
      }
    }
    return null;
  }
}

Python

gmail/Snippet/settings snippet/update_signature.py

Auf GitHub ansehen

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def update_signature():
  """Create and update signature in gmail.
  Returns:Draft object, including updated signature.

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()

  try:
    # create gmail api client
    service = build("gmail", "v1", credentials=creds)

    primary_alias = None

    # pylint: disable=E1101
    aliases = service.users().settings().sendAs().list(userId="me").execute()
    for alias in aliases.get("sendAs"):
      if alias.get("isPrimary"):
        primary_alias = alias
        break

    send_as_configuration = {
        "displayName": primary_alias.get("sendAsEmail"),
        "signature": "Automated Signature",
    }

    # pylint: disable=E1101
    result = (
        service.users()
        .settings()
        .sendAs()
        .patch(
            userId="me",
            sendAsEmail=primary_alias.get("sendAsEmail"),
            body=send_as_configuration,
        )
        .execute()
    )
    print(f'Updated signature for: {result.get("displayName")}')

  except HttpError as error:
    print(f"An error occurred: {error}")
    result = None

  return result.get("signature")


if __name__ == "__main__":
  update_signature()