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)
    }
  ],
  "userReportedSpamRatioLowerBound": number,
  "userReportedSpamRatioUpperBound": number
}
الحقول
name

string

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

number

نسبة الرسائل غير المرغوب فيها التي أبلغ عنها المستخدمون إلى الرسائل الإلكترونية التي تم إرسالها إلى البريد الوارد قد لا يكون هذا التقدير دقيقًا، لذا قد يريد المستخدمون الرجوع إلى وصف حقلَي الفاصل الزمني userReportedSpamRatioLowerBound وuserReportedSpamRatioUpperBound للحصول على ضمانات أكثر وضوحًا للدقة. لا ينطبق هذا المقياس إلا على الرسائل الإلكترونية التي تمت مصادقتها باستخدام 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.
userReportedSpamRatioLowerBound

number

الحدّ الأدنى لفاصل الثقة لنسبة الرسائل غير المرغوب فيها التي أبلغ عنها المستخدم في حال ضبط هذا الحقل، يتم ضبط قيمة userReportedSpamRatio على منتصف هذا الفاصل الزمني، وبالتالي تكون غير دقيقة. ومع ذلك، نضمن أن تكون النسبة الفعلية بين هذا الحدّ الأدنى والحدّ الأقصى المقابل له في% 95 من الوقت. لا ينطبق هذا المقياس إلا على الرسائل الإلكترونية التي تمت مصادقتها باستخدام DKIM.
userReportedSpamRatioUpperBound

number

الحدّ الأقصى لفئة الثقة لنسبة الرسائل غير المرغوب فيها التي أبلغ عنها المستخدم في حال ضبط هذا الحقل، يتم ضبط قيمة userReportedSpamRatio على منتصف هذا الفاصل الزمني، وبالتالي تكون غير دقيقة. ومع ذلك، نضمن أن تكون النسبة الفعلية بين هذا الحدّ الأقصى والحدّ الأدنى المقابل له في% 95 من الوقت. لا ينطبق هذا المقياس إلا على الرسائل الإلكترونية التي تمت مصادقتها باستخدام 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 للإرسال منخفضة للغاية.
LOW_DOMAIN_REPUTATION سمعة نطاق الإرسال منخفضة للغاية.
IP_IN_RBL عنوان IP مُدرَج في واحدة أو أكثر من قوائم الثقوب السوداء في الوقت الفعلي المتاحة للجميع. تواصَل مع المشرف على قائمة RBL لإزالة عنوان IP من القائمة.
DOMAIN_IN_RBL النطاق مُدرَج في واحدة أو أكثر من قوائم الثقوب السوداء في الوقت الفعلي العامة. تواصَل مع المشرف على قائمة RBL لإزالة نطاقك من القائمة.
BAD_PTR_RECORD لا يتضمّن عنوان IP المُستخدَم في الإرسال سجلّ PTR.

الطُرق

get

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

list

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