Method: domains.trafficStats.list

سرد إحصاءات عدد الزيارات لجميع الأيام المتاحة. يعرض Permission_DENIED إذا لم يكن لدى المستخدم الإذن بالوصول إلى TrafficStats للنطاق.

طلب HTTP

GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
parent

string

اسم مورد النطاق الذي نريد إدراج إحصاءات عدد الزيارات الخاصة به. ويجب أن يكون بالشكل domains/{domain_name}، حيث يكون domain_name هو اسم النطاق المؤهل بالكامل.

معلمات طلب البحث

المَعلمات
startDate

object (Date)

اليوم الأول من المقاييس المطلوب استردادها بشكل شامل. يجب تحديد كل من تاريخ البدء وتاريخ الانتهاء أو تركهما بدون تحديد. إذا تم تحديد تاريخ واحد فقط، أو كان تاريخ الانتهاء قبل وقت البدء من تاريخ البدء، فسيتم عرض INVALID_{9}.
endDate

object (Date)

آخر يوم من المقاييس المطلوب استرداده بشكل حصري. يجب تحديد كل من تاريخ البدء وتاريخ الانتهاء أو تركهما بدون تحديد. إذا تم تحديد تاريخ واحد فقط، أو كان تاريخ الانتهاء قبل وقت البدء من تاريخ البدء، فسيتم عرض INVALID_{9}.
pageSize

integer

حجم الصفحة المطلوب. قد يعرض الخادم إحصاءات حركة مرور أقل من المطلوب. وفي حال عدم تحديد هذا الحقل، سيختار الخادم قيمة تلقائية مناسبة.
pageToken

string

القيمة nextPageToken التي يتم عرضها من طلب قائمة سابق، إن وجد. هذه هي قيمة ListTrafficStatsResponse.next_page_token التي تم إرجاعها من الاستدعاء السابق إلى طريقة trafficStats.list.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة رد لـ trafficStats.list.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
الحقول
trafficStats[]

object (TrafficStats)

قائمة إحصاءات الزيارات.
nextPageToken

string

رمز مميز لاسترداد الصفحة التالية من النتائج، أو يكون فارغًا إذا لم تكن هناك نتائج أخرى في القائمة.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/postmaster.readonly

لمزيد من المعلومات، راجِع دليل التفويض.

التاريخ

تمثّل تاريخًا كاملاً أو جزئيًا في التقويم، مثل تاريخ الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو هما غير مهمين. التاريخ مرتبط بالتقويم الميلادي. يمكن أن يمثّل ذلك أحد الأنواع التالية:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم.
  • شهر ويوم مع السنة صفر (على سبيل المثال، ذكرى سنوية).
  • سنة من تلقاء نفسها، مع عدم تحديد شهر ويوم صفر.
  • سنة وشهر بدون يوم (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).

أنواع ذات صلة:

تمثيل JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

سنة من التاريخ. يجب أن تتراوح القيمة بين 1 و9999، أو 0 لتحديد تاريخ بدون سنة.
month

integer

شهر من السنة يجب أن تتراوح القيمة من 1 إلى 12 أو 0 لتحديد عام بدون شهر ويوم.
day

integer

يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر أو يجب أن تكون القيمة 0 لتحديد سنة بحد ذاتها أو عام وشهر لا يكون فيه اليوم مهمًا.