نظرة عامة حول واجهة برمجة التطبيقات لأدوات Postmaster
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك واجهة برمجة تطبيقات أدوات Postmaster جمع مقاييس بشأن الرسائل الإلكترونية المجمّعة المُرسَلة إلى مستخدمي Gmail واستيراد البيانات إلى أنظمة أخرى أو دمجها معها.
تشمل المقاييس النسبة المئوية للرسائل الإلكترونية التي وضع المستخدم علامة عليها كرسائل غير مرغوب فيها وأخطاء التسليم. للحصول على شرح كامل للمقاييس التي توفّرها واجهة برمجة تطبيقات أدوات Postmaster، يُرجى الرجوع إلى قسم "لوحات البيانات" في مقالة مركز مساعدة أدوات Postmaster.
خطوات التنفيذ العالية المستوى
اتّبِع الخطوات العامة التالية لاستخدام واجهة برمجة التطبيقات هذه:
- يجب إعداد نطاق مصادقة، إما نطاق DKIM (d=) أو نطاق نظام التعرّف على هوية المرسل (SPF) (نطاق مسار الإرجاع) الذي يتم استخدامه لمصادقة رسالتك الإلكترونية.
- إعداد واجهة برمجة التطبيقات:
- إنشاء مشروع
- فعِّل واجهة برمجة تطبيقات Postmaster Tools.
- إعداد بيانات اعتماد واجهة برمجة التطبيقات
- أنشئ رمزًا مميزًا لبروتوكول OAuth2.
- استخدِم رمز OAuth2 المميز وبيانات الاعتماد لإجراء طلبات بيانات من واجهة برمجة التطبيقات، بما في ذلك إثبات ملكية النطاقات واسترداد المقاييس.
الخطوات التالية
لإعداد نطاق المصادقة، انتقِل إلى
إعداد نطاق المصادقة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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)."]]
