این سند نحوه پیکربندی ارسال ایمیل در Gmail API را توضیح میدهد.
شما میتوانید از منبع settings برای پیکربندی ارسال ایمیل برای یک حساب کاربری استفاده کنید. برای استفاده از یک آدرس ایمیل برای ارسال، باید یکی از معیارهای زیر را داشته باشد:
- آدرس ایمیل تأیید شده است. برای اطلاعات بیشتر، به ایجاد و تأیید آدرسهای ارسال مراجعه کنید.
- آدرس ایمیل متعلق به همان دامنهای است که فرستنده در آن قرار دارد.
- آدرس ایمیل متعلق به یک زیر دامنه در همان دامنه فرستنده است.
- آدرس ایمیل متعلق به یک نام مستعار دامنه است که به عنوان بخشی از همان حساب Google Workspace پیکربندی شده است.
اگر آدرس ایمیل فوروارد شده یکی از این قوانین را رعایت نکند، تنظیم فوروارد کردن با استفاده از API با شکست مواجه میشود.
برای کسب اطلاعات در مورد نحوه ایجاد ، فهرست کردن ، دریافت یا حذف آدرسهای ارسال، به روشهای موجود در منبع settings.forwardingAddresses مراجعه کنید.
برای اطلاعات در مورد نحوه دریافت یا بهروزرسانی تنظیمات ارسال خودکار، به روشهای موجود در منبع settings مراجعه کنید.
ایجاد و تأیید آدرسهای ارسال
قبل از استفاده از آدرسهای ارسال، باید آنها را ایجاد کنید . در برخی موارد، کاربران باید مالکیت آدرس را نیز تأیید کنند.
اگر جیمیل برای یک آدرس ارسالی نیاز به تأیید کاربر داشته باشد، API آدرس را با VerificationStatus در حال بررسی ( pending برمیگرداند. جیمیل بهطور خودکار یک پیام تأیید به آدرس ایمیل هدف ارسال میکند. مالک آدرس ایمیل باید قبل از اینکه بتوانید از آن استفاده کنید، فرآیند تأیید را تکمیل کند.
آدرسهای ارسالی که نیازی به تأیید ندارند، وضعیت تأییدشان accepted است.
فعال کردن فوروارد خودکار
میتوانید انتخاب کنید که تمام پیامهای جدیدتان به آدرس ایمیل دیگری ارسال شوند.
برای انجام این کار، متد updateAutoForwarding را فراخوانی کنید تا ارسال خودکار برای یک حساب کاربری فعال شود. این فراخوانی نیاز به یک آدرس ارسال ثبت شده و تأیید شده و یک اقدام برای انجام پیامهای ارسال شده دارد. این مقادیر را در شیء AutoForwarding تنظیم کنید.
از فیلد disposition برای تنظیم وضعیت پیام پس از ارسال آن استفاده کنید. اگرچه مقدار پیشفرض dispositionUnspecified است، اما نمیتوانید این فیلد را روی dispositionUnspecified تنظیم کنید.
نمونههای کد زیر نحوه فعال کردن ارسال خودکار و سپس انتقال پیامهای ارسال شده به سطل زباله را نشان میدهند:
جاوا
پایتون
برای غیرفعال کردن ارسال خودکار، متد updateAutoForwarding را فراخوانی کنید و فیلد enabled در شیء AutoForwarding را روی false تنظیم کنید.
پیامهای خاص را فوروارد کنید
فوروارد خودکار، تمام پیامهای دریافتی جیمیل را به حساب هدف ارسال میکند. برای فوروارد کردن پیامهای خاص، فیلتری تنظیم کنید تا قوانینی ایجاد شود که پیامها را در پاسخ به ویژگیها یا محتوای پیام فوروارد کند.
برای فوروارد کردن پیامها به چندین حساب، برای هر آدرس ایمیل فوروارد شده یک فیلتر ایجاد کنید.