إدارة إعادة التوجيه

يمكنك استخدام الإعدادات لمحاولة ضبط إعادة التوجيه لحساب. لكي يتم استخدامه كعنوان بريد إلكتروني لإعادة التوجيه، يجب أن يستوفي العنوان أحد المعايير التالية:

• تم إثبات ملكية عنوان البريد الإلكتروني. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء عناوين إعادة التوجيه وإثبات ملكيتها.
• ينتمي عنوان البريد الإلكتروني إلى النطاق نفسه الذي ينتمي إليه المُرسِل.
• ينتمي عنوان البريد الإلكتروني إلى نطاق فرعي ضمن النطاق نفسه للمُرسِل.
• ينتمي عنوان البريد الإلكتروني إلى اسم نطاق بديل تم إعداده كجزء من حساب Google Workspace نفسه.

إذا لم يلتزم عنوان البريد الإلكتروني المُستخدَم لإعادة التوجيه بإحدى هذه القواعد، لن يتم إعداد إعادة التوجيه باستخدام واجهة برمجة التطبيقات.

للحصول على معلومات عن كيفية إنشاء قائمة الحصول على أو حذف عناوين إعادة التوجيه، اطّلِع على مرجع ForwardingAddresses.

للحصول على معلومات عن كيفية الحصول على إعدادات توجيه المكالمات أو تعديلها، يُرجى الاطّلاع على مرجع الإعدادات.

إنشاء عناوين إعادة التوجيه وإثبات صحتها

يجب إنشاء عناوين إعادة التوجيه قبل استخدامها. في بعض الحالات، على المستخدمين أيضًا إثبات ملكية العنوان.

إذا كانت خدمة Gmail تتطلّب من المستخدم إثبات ملكيته لعنوان إعادة التوجيه، يتم عرض العنوان مع الحالة pending. يتم تلقائيًا إرسال رسالة تحقّق إلى عنوان البريد الإلكتروني المستهدَف. على صاحب عنوان البريد الإلكتروني إكمال عملية إثبات الملكية قبل أن يتمكّن من استخدامه.

تكون حالة التحقّق من عناوين إعادة التوجيه التي لا تتطلّب إثبات الملكية هي accepted.

تفعيل إعادة التوجيه التلقائي

استخدِم الأسلوب updateAutoForwarding لتفعيل ميزة "إعادة التوجيه التلقائي" لحساب معيّن. تتطلّب المكالمة توفُّر عنوان إعادة توجيه مسجَّل ومُثبَت ملكيته، بالإضافة إلى إجراء بشأن الرسائل المُعاد توجيهها.

على سبيل المثال، لتفعيل ميزة إعادة التوجيه التلقائي ونقل الرسائل المُعاد توجيهها إلى المهملات:

Java

gmail/snippets/src/main/java/EnableForwarding.java

عرض على GitHub

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.AutoForwarding;
import com.google.api.services.gmail.model.ForwardingAddress;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;

/* Class to demonstrate the use of Gmail Enable Forwarding API */
public class EnableForwarding {
  /**
   * Enable the auto-forwarding for an account.
   *
   * @param forwardingEmail - Email address of the recipient whose email will be forwarded.
   * @return forwarding id and metadata, {@code null} otherwise.
   * @throws IOException - if service account credentials file not found.
   */
  public static AutoForwarding enableAutoForwarding(String forwardingEmail) 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_SHARING);
    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 {
      // Enable auto-forwarding and move forwarded messages to the trash
      ForwardingAddress address = new ForwardingAddress()
          .setForwardingEmail(forwardingEmail);
      ForwardingAddress createAddressResult = service.users().settings().forwardingAddresses()
          .create("me", address).execute();
      if (createAddressResult.getVerificationStatus().equals("accepted")) {
        AutoForwarding autoForwarding = new AutoForwarding()
            .setEnabled(true)
            .setEmailAddress(address.getForwardingEmail())
            .setDisposition("trash");
        autoForwarding =
            service.users().settings().updateAutoForwarding("me", autoForwarding).execute();
        System.out.println(autoForwarding.toPrettyString());
        return autoForwarding;
      }
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      GoogleJsonError error = e.getDetails();
      if (error.getCode() == 403) {
        System.err.println("Unable to enable forwarding: " + e.getDetails());
      } else {
        throw e;
      }
    }
    return null;
  }
}

Python

gmail/snippet/settings snippets/enable_forwarding.py

عرض على GitHub

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


def enable_forwarding():
  """Enable email forwarding.
  Returns:Draft object, including forwarding id and result meta data.

  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)

    address = {"forwardingEmail": "[e-mail]"}

    # pylint: disable=E1101
    result = (
        service.users()
        .settings()
        .forwardingAddresses()
        .create(userId="me", body=address)
        .execute()
    )
    if result.get("verificationStatus") == "accepted":
      body = {
          "emailAddress": result.get("forwardingEmail"),
          "enabled": True,
          "disposition": "trash",
      }
      # pylint: disable=E1101
      result = (
          service.users()
          .settings()
          .updateAutoForwarding(userId="me", body=body)
          .execute()
      )
      print(f"Forwarding is enabled : {result}")

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

  return result


if __name__ == "__main__":
  enable_forwarding()

لإيقاف ميزة "إعادة التوجيه التلقائي"، اتصل بـ updateAutoForwarding واضبط القيمة enabled على false.

إعادة توجيه رسائل معيّنة

تؤدي إعادة التوجيه التلقائي إلى إرسال جميع الرسائل المستلَمة إلى الحساب المستهدَف. لإعادة توجيه الرسائل بشكل انتقائي، استخدِم الفلاتر لإنشاء قواعد تعيد التوجيه استجابةً لسمات الرسائل أو محتواها.