نمای کلی API Postmaster Tools
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Postmaster Tools API به شما این امکان را میدهد که معیارهای مربوط به ایمیلهای انبوه ارسال شده به کاربران Gmail را جمعآوری کنید و دادهها را به سیستمهای دیگر وارد کنید یا آن دادهها را با آنها ادغام کنید. معیارها شامل درصد ایمیلهای شما که توسط کاربر بهعنوان هرزنامه علامتگذاری شده است و خطاهای ارسال میشود. برای توضیح کامل معیارهای ارائه شده توسط Postmaster Tools API، به بخش داشبوردها در مقاله مرکز راهنمایی Postmaster Tools مراجعه کنید.
مراحل اجرای سطح بالا
برای استفاده از این API این مراحل سطح بالا را دنبال کنید:
- یک دامنه احراز هویت، یا دامنه DKIM (d=) یا SPF (دامنه Return-Path) که برای احراز هویت ایمیل شما استفاده می شود، تنظیم کنید.
- API را تنظیم کنید:
- یک پروژه ایجاد کنید.
- Postmaster Tools API را روشن کنید.
- اعتبارنامه را برای API تنظیم کنید.
- یک توکن OAuth2 ایجاد کنید.
- از توکن و اعتبارنامه OAuth2 برای برقراری تماسهای API از جمله تأیید دامنه و بازیابی معیارها استفاده کنید.
مراحل بعدی
برای راه اندازی دامنه احراز هویت، به راه اندازی دامنه تأیید هویت بروید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Postmaster Tools API overview\n\nThe Postmaster Tools API allows you to gather metrics on bulk emails sent to\nGmail users and import data into, or merge that data with, other systems.\nMetrics include the percentage of your email marked as spam by the user and\ndelivery errors. For a full explanation of the metrics provided by the\nPostmaster Tools API, refer to Dashboards section of the\n[Postmaster Tools help center article](https://support.google.com/mail/answer/6227174).\n\nHigh-level implementation steps\n-------------------------------\n\nFollow these high-level steps to use this API:\n\n1. Set up an authentication domain, either the DKIM (d=) or SPF domain (Return-Path domain) that is used to authenticate your email.\n2. Set up the API:\n 1. Create a project.\n 2. Turn on the Postmaster Tools API.\n 3. Set up credentials for the API.\n 4. Create an OAuth2 token.\n3. Use the OAuth2 token and credentials to make API calls including verifying domains and retrieving metrics.\n\nNext steps\n----------\n\nTo set up the authentication domain, proceed to\n[Set up authentication domain](/workspace/gmail/postmaster/guides/domain)."]]