اسرد إحصاءات عدد الزيارات لكل الأيام المتاحة. تعرض Permission_DENIED إذا لم يكن لدى المستخدم إذن بالوصول إلى TrafficStats للنطاق.
طلب HTTP
GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
اسم مورد النطاق الذي نرغب في إدراج إحصاءات عدد الزيارات له. ويجب أن يكون على النموذج |
معامِلات طلب البحث
المعلمات | |
---|---|
startDate |
أقرب يوم للمقاييس المراد استردادها بالشمولية. يجب تحديد قيمة startDate وendDate أو تركهما بدون تحديد. إذا تم تحديد قيمة واحدة فقط، أو كان تاريخ الانتهاء يقع قبل تاريخ البدء، سيتم عرض بهدفي يبي هذا. |
endDate |
آخر يوم من المقاييس لاسترداد البيانات الحصرية يجب تحديد قيمة startDate وendDate أو تركهما بدون تحديد. إذا تم تحديد قيمة واحدة فقط، أو كان تاريخ الانتهاء يقع قبل تاريخ البدء، سيتم عرض بهدفي يبي هذا. |
pageSize |
حجم الصفحة المطلوب. قد يعرض الخادم عدد زيارات TrafficStats أقل من المطلوب. إذا لم يتم تحديد قيمة هذه السياسة، سيختار الخادم قيمة تلقائية مناسبة. |
pageToken |
قيمة NextPageToken التي يتم عرضها من طلب قائمة سابق، إن وجد. هذه هي قيمة |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة استجابة لـ trafficStats.list.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"trafficStats": [
{
object ( |
الحقول | |
---|---|
trafficStats[] |
قائمة TrafficStats. |
nextPageToken |
رمز مميّز لاسترداد الصفحة التالية من النتائج، أو فارغًا إذا لم تكن هناك نتائج أخرى في القائمة |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/postmaster.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
التاريخ
يمثل تاريخ تقويم كاملاً أو جزئيًا، مثل عيد الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك أيًا مما يلي:
- تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
- شهر ويوم، بسنة صفرية (على سبيل المثال، ذكرى سنوية).
- سنة بمفردها، بشهر صفري ويوم صفري.
- سنة وشهر بيوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).
الأنواع ذات الصلة:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
تمثيل JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
الحقول | |
---|---|
year |
السنة من التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة. |
month |
شهر من السنة. يجب أن تتراوح القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر، أو 0 لتحديد عام في حد ذاته أو تحديد سنة وشهر حيث لا يكون اليوم مهمًا. |