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

الطُرق
create POST /v2beta/domains
يضيف نطاقًا إلى حساب المستخدِم.
delete DELETE /v2beta/{name=domains/*}
يحذف نطاقًا من حساب المستخدِم.
get GET /v2beta/{name=domains/*}
يسترد معلومات مفصّلة عن نطاق سجّلته.
getComplianceStatus GET /v2beta/{name=domains/*/complianceStatus}
يسترد حالة الامتثال لنطاق معيّن.
getVerificationToken GET /v2beta/{name=domains/*/verificationToken}
يحصل على رمز مميّز لإثبات ملكية النطاق يُستخدم للتحقّق من ملكية المستخدِم لنطاق.
list GET /v2beta/domains
يسترد قائمة بجميع النطاقات التي سجّلتها، بالإضافة إلى البيانات الوصفية المقابلة لها.
verify POST /v2beta/{name=domains/*}:verify
يتحقّق من ملكية المستخدِم لنطاق على مستوى نظام أسماء النطاقات.

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

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

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

الطُرق
create POST /v2beta/{parent=domains/*}/users
ينشئ مستخدمًا يمكنه الوصول إلى نطاق.
delete DELETE /v2beta/{name=domains/*/users/*}
يحذف مستخدمًا من نطاق.
get GET /v2beta/{name=domains/*/users/*}
يسترد معلومات مفصّلة عن مستخدم يمكنه الوصول إلى نطاق.
list GET /v2beta/{parent=domains/*}/users
يسرد المستخدمين الذين يمكنهم الوصول إلى نطاق.
patch PATCH /v2beta/{user.name=domains/*/users/*}
يعدّل مستخدمًا لنطاق.