REST Resource: domains.trafficStats

المرجع: إحصاءات عدد الزيارات

إحصاءات عدد زيارات البريد الإلكتروني ذات الصلة بتاريخ محدّد.

تمثيل JSON 
{
  "name": string,
  "userReportedSpamRatio": number,
  "ipReputations": [
    {
      object (IpReputation)
    }
  ],
  "domainReputation": enum (ReputationCategory),
  "spammyFeedbackLoops": [
    {
      object (FeedbackLoop)
    }
  ],
  "spfSuccessRatio": number,
  "dkimSuccessRatio": number,
  "dmarcSuccessRatio": number,
  "outboundEncryptionRatio": number,
  "inboundEncryptionRatio": number,
  "deliveryErrors": [
    {
      object (DeliveryError)
    }
  ]
}
الحقول
name

string

اسم المورد لإحصاءات عدد الزيارات. تكون أسماء إحصاءات الزيارات على النحو domains/{domain}/trafficStats/{date}، حيث يكون domain_name هو اسم النطاق المؤهل بالكامل (مثل mymail.mydomain.com) النطاق الذي ترتبط به إحصاءات الزيارات هذه، ويكون التاريخ بالتنسيق yyyymmdd الذي تتطابق معه هذه الإحصاءات. على سبيل المثال: domains/mymail.mydomain.com/trafficStats/20160807
userReportedSpamRatio

number

نسبة الرسائل غير المرغوب فيها التي أبلغ عنها المستخدم مقابل الرسائل الإلكترونية التي تم إرسالها إلى البريد الوارد. لا يرتبط هذا المقياس إلا بالرسائل الإلكترونية التي تمت مصادقتها من خلال البريد المُعرَّف بمفاتيح النطاق (DKIM).
ipReputations[]

object (IpReputation)

معلومات السمعة المتعلقة بعناوين IP لخوادم البريد الإلكتروني في النطاق هناك إدخال واحد بالضبط لكل فئة سمعة باستثناء REPUTATION_CATEGORY_UNSPECIFIED.
domainReputation

enum (ReputationCategory)

سمعت النطاق.
spammyFeedbackLoops[]

object (FeedbackLoop)

معرّفات حلقة الملاحظات غير المرغوب فيها مع معدلات الرسائل غير المرغوب فيها الفردية. لا يرتبط هذا المقياس إلا بالزيارات التي تتم مصادقتها من خلال البريد المُعرَّف بمفاتيح النطاق (DKIM).
spfSuccessRatio

number

نسبة الرسائل الإلكترونية التي تمت مصادقتها بنجاح باستخدام نظام التعرّف على هوية المرسل (SPF) مقارنةً بجميع الرسائل الإلكترونية التي حاولت مصادقتها باستخدام نظام التعرّف على هوية المرسل (SPF). ويتم استبعاد البريد المخادع.
dkimSuccessRatio

number

نسبة الرسائل الإلكترونية التي تمت مصادقتها باستخدام DKIM بنجاح مقارنةً بجميع الرسائل الإلكترونية التي حاولت مصادقتها باستخدام DKIM. ويتم استبعاد البريد المخادع.
dmarcSuccessRatio

number

نسبة البريد الذي اجتاز عمليات تحقق محاذاة DMARC مقابل جميع رسائل البريد المستلمة من النطاق التي تمت مصادقتها بنجاح إما باستخدام نظام التعرف على هوية المرسل (SPF) أو DKIM.
outboundEncryptionRatio

number

نسبة الرسائل الإلكترونية الصادرة (من Gmail) التي تم قبولها عبر النقل الآمن (بروتوكول أمان طبقة النقل)
inboundEncryptionRatio

number

نسبة البريد الوارد (إلى Gmail) الذي اجتاز النقل الآمن (بروتوكول أمان طبقة النقل) مقابل جميع الرسائل الإلكترونية المستلَمة من هذا النطاق. لا يرتبط هذا المقياس إلا بالزيارات التي اجتازت نظام التعرّف على هوية المُرسِل (SPF) أو البريد المُعرَّف بمفاتيح النطاق (DKIM).
deliveryErrors[]

object (DeliveryError)

أخطاء في التسليم للنطاق لا يرتبط هذا المقياس إلا بالزيارات التي اجتازت نظام التعرّف على هوية المُرسِل (SPF) أو البريد المُعرَّف بمفاتيح النطاق (DKIM).

IpReputation

معلومات سمعة عنوان IP لمجموعة من عناوين IP في فئة سمعة معيّنة.

تمثيل JSON 
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
الحقول
reputation

enum (ReputationCategory)

فئة السمعة التي تمثلها سمعة عنوان IP هذه.
ipCount

string (int64 format)

إجمالي عدد عناوين IP الفريدة في فئة السمعة هذه. لا يرتبط هذا المقياس إلا بالزيارات التي اجتازت نظام التعرّف على هوية المُرسِل (SPF) أو البريد المُعرَّف بمفاتيح النطاق (DKIM).
sampleIps[]

string

نموذج من عناوين IP في فئة السمعة هذه.

ReputationCategory

سمعة النطاق أو عنوان IP. لمزيد من المعلومات، راجِع "لوحات بيانات سمعة النطاق وعنوان IP" في قسم "لوحات البيانات" في صفحة مساعدة أدوات Postmaster.

عمليات التعداد
REPUTATION_CATEGORY_UNSPECIFIED القيمة التلقائية التي يجب عدم استخدامها بشكل صريح. ويمثّل هذا الولاية التي لا تتوفر فيها أي معلومات عن السمعة.
HIGH لديه سجل تتبُّع جيد لمعدل رسائل غير مرغوب فيها منخفض جدًا، ويلتزم بإرشادات المُرسِل في Gmail. سيتم في حالات نادرة وضع علامة على رسائل البريد الإلكتروني باستخدام فلتر الرسائل غير المرغوب فيها.
MEDIUM معروف بإرسال رسائل بريد جيدة، ولكنه معرض لإرسال عدد قليل من الرسائل غير المرغوب فيها بشكل متقطع. ستحصل معظم الرسائل الإلكترونية الواردة من هذا الكيان على معدل إمكانية تسليم مقبول، باستثناء الحالات التي تظهر فيها زيادة ملحوظة في مستويات الرسائل غير المرغوب فيها.
LOW معروف بإرسال عدد كبير من الرسائل غير المرغوب فيها بانتظام، وسيتم على الأرجح وضع علامة على رسائل البريد الواردة من هذا المُرسِل كرسائل غير مرغوب فيها.
BAD سجلّ إرسال عدد هائل من الرسائل غير المرغوب فيها. سيتم على الأغلب رفض الرسائل الإلكترونية الواردة من هذا الكيان دائمًا على مستوى SMTP أو وضع علامة عليها كرسائل غير مرغوب فيها.

FeedbackLoop

معلومات معرّف حلقة الملاحظات

تمثيل JSON 
{
  "id": string,
  "spamRatio": number
}
الحقول
id

string

معرّف تقرير الملاحظات والآراء الذي يحدّد الحملات الفردية بشكلٍ فريد
spamRatio

number

نسبة الرسائل غير المرغوب فيها التي وضع عليها المعرّف مقارنةً بإجمالي عدد الرسائل المرسلة في البريد الوارد التي تحتوي على هذا المعرّف.

DeliveryError

مقياس لنوع خطأ معيّن في التسليم.

تمثيل JSON 
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
الحقول
errorClass

enum (DeliveryErrorClass)

فئة الخطأ في التسليم.
errorType

enum (DeliveryErrorType)

تمثّل هذه السمة نوع الخطأ في التسليم.
errorRatio

number

نسبة الرسائل التي حدث فيها الخطأ مقابل جميع الزيارات التي تمت مصادقتها.

DeliveryErrorClass

فئة الخطأ في التسليم.

عمليات التعداد
DELIVERY_ERROR_CLASS_UNSPECIFIED القيمة التلقائية التي يجب عدم استخدامها بشكل صريح.
PERMANENT_ERROR تم رفض تسليم الرسالة.
TEMPORARY_ERROR فشل مؤقت في تسليم الرسالة إلى المستلم.

DeliveryErrorType

تمثّل هذه السمة نوع الخطأ في التسليم.

عمليات التعداد
DELIVERY_ERROR_TYPE_UNSPECIFIED القيمة التلقائية التي يجب عدم استخدامها بشكل صريح.
RATE_LIMIT_EXCEEDED يرسل النطاق أو عنوان IP حركة البيانات بمعدل عالٍ بشكل مريب، ونتيجةً لذلك تم فرض حدود المعدل المؤقتة. سيتم رفع الحد عندما يكون Gmail واثقًا بما يكفي من طبيعة عدد الزيارات.
SUSPECTED_SPAM يُشتبه أن تكون حركة المرور غير مرغوب فيها من قِبل Gmail لأسباب مختلفة.
CONTENT_SPAMMY يُشتبه في كون الزيارات غير مرغوب فيها، ويكون المحتوى متعلقًا بالمحتوى.
BAD_ATTACHMENT تحتوي الزيارات على مرفقات غير متوافقة مع Gmail.
BAD_DMARC_POLICY أعدَّ نطاق المُرسِل سياسة رفض مصادقة الرسائل وإعداد تقاريرها وتوافقها استنادًا إلى النطاق (DMARC).
LOW_IP_REPUTATION سمعة عنوان IP لعنوان IP للإرسال منخفضة جدًا.
LOW_DOMAIN_REPUTATION سمعة نطاق الإرسال منخفضة للغاية.
IP_IN_RBL يتم إدراج عنوان IP في واحدة أو أكثر من قوائم الثقوب السوداء في الوقت الفعلي العامة. تواصَل مع المشرف على قائمة RBL لإزالة عنوان IP من القائمة.
DOMAIN_IN_RBL النطاق مُدرج في واحدة أو أكثر من قوائم الثقوب السوداء في الوقت الفعلي العامة. تواصَل مع المشرف على قائمة RBL لإزالة نطاقك من القائمة.
BAD_PTR_RECORD لا يتضمّن عنوان IP للإرسال سجلّ الموجّه (PTR).

الطُرق

get

 الحصول على إحصاءات عدد الزيارات لنطاق في تاريخ محدد.

list

 سرد إحصاءات عدد الزيارات لجميع الأيام المتاحة.