Gmail Postmaster Tools API

واجهة برمجة التطبيقات Postmaster Tools API هي واجهة برمجة تطبيقات RESTful تتيح الوصول آليًا إلى مقاييس عدد الزيارات للرسائل الإلكترونية (مثل تقارير الرسائل غير المرغوب فيها وأخطاء التسليم وما إلى ذلك) المتاحة حاليًا من خلال واجهة مستخدم أدوات Postmaster في Gmail.

الخدمة: gmailpostmastertools.googleapis.com

لطلب هذه الخدمة، ننصح باستخدام مكتبات العميل التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لطلب هذه الخدمة، استخدِم المعلومات التالية عند طلب بيانات من واجهة برمجة التطبيقات.

مستند الاستكشاف

مستند الاستكشاف هو عبارة عن مواصفات يمكن أن تقرأها الآلة لوصف REST API واستخدامها. وهو يُستخدم لإنشاء مكتبات العميل ومكوّنات IDE الإضافية وغيرها من الأدوات التي تتفاعل مع Google APIs. تجدر الإشارة إلى أنّ خدمة واحدة قد تقدّم أكثر من وثيقة استكشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي الجزء الأساسي من عنوان URL الذي يحدّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد يكون للخدمة الواحدة أكثر من نقطة نهاية واحدة. تحتوي هذه الخدمة على نقطة النهاية التالية، وجميع عناوين URI أدناه تكون نسبيّة لهذه النقطة:

  • https://gmailpostmastertools.googleapis.com

مورد REST: ‏ v2beta.domainStats

الطُرق
batchQuery POST /v2beta/domainStats:batchQuery
تنفيذ مجموعة من طلبات QueryDomainStats لنطاقات متعددة

مورد REST: ‏ v2beta.domains

الطُرق
get GET /v2beta/{name=domains/*}
تسترد هذه الطريقة معلومات تفصيلية حول نطاق سجّلته.
getComplianceStatus GET /v2beta/{name=domains/*/complianceStatus}
تعرض هذه الطريقة حالة الامتثال لنطاق معيّن.
list GET /v2beta/domains
تعرض هذه الطريقة قائمة بجميع النطاقات التي سجّلتها، بالإضافة إلى البيانات الوصفية المقابلة لها.

مورد REST: ‏ v2beta.domains.domainStats

الطُرق
query POST /v2beta/{parent=domains/*}/domainStats:query
تعرض هذه الطريقة قائمة بإحصاءات النطاق لنطاق وفترة زمنية محدّدين.