REST Resource: domains.trafficStats

المرجع: 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) التي تم قبولها عبر النقل الآمن (بروتوكول أمان طبقة النقل (TLS)).
inboundEncryptionRatio

number

نسبة البريد الوارد (إلى Gmail) الذي اجتاز النقل الآمن (بروتوكول أمان طبقة النقل (TLS)) مقابل جميع البريد المستلَم من هذا النطاق. يرتبط هذا المقياس فقط بالزيارات التي اجتازت 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

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