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)

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

endDate

object (Date)

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

pageSize

integer

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

pageToken

string

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

نص الطلب

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

نص الاستجابة

رسالة استجابة لـ trafficStats.list.

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

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

object (TrafficStats)

قائمة 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 لتحديد عام في حد ذاته أو تحديد سنة وشهر عندما لا يكون اليوم مهمًا.