سرد إحصاءات عدد الزيارات لجميع الأيام المتاحة. يعرض Permission_DENIED إذا لم يكن لدى المستخدم الإذن بالوصول إلى TrafficStats للنطاق.
طلب HTTP
GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
parent |
اسم مورد النطاق الذي نريد إدراج إحصاءات عدد الزيارات الخاصة به. ويجب أن يكون بالشكل |
معلمات طلب البحث
المَعلمات | |
---|---|
startDate |
اليوم الأول من المقاييس المطلوب استردادها بشكل شامل. يجب تحديد كل من تاريخ البدء وتاريخ الانتهاء أو تركهما بدون تحديد. إذا تم تحديد تاريخ واحد فقط، أو كان تاريخ الانتهاء قبل وقت البدء من تاريخ البدء، فسيتم عرض INVALID_{9}. |
endDate |
آخر يوم من المقاييس المطلوب استرداده بشكل حصري. يجب تحديد كل من تاريخ البدء وتاريخ الانتهاء أو تركهما بدون تحديد. إذا تم تحديد تاريخ واحد فقط، أو كان تاريخ الانتهاء قبل وقت البدء من تاريخ البدء، فسيتم عرض INVALID_{9}. |
pageSize |
حجم الصفحة المطلوب. قد يعرض الخادم إحصاءات حركة مرور أقل من المطلوب. وفي حال عدم تحديد هذا الحقل، سيختار الخادم قيمة تلقائية مناسبة. |
pageToken |
القيمة nextPageToken التي يتم عرضها من طلب قائمة سابق، إن وجد. هذه هي قيمة |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة رد لـ trafficStats.list.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"trafficStats": [
{
object ( |
الحقول | |
---|---|
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 لتحديد سنة بحد ذاتها أو عام وشهر لا يكون فيه اليوم مهمًا. |