Method: domains.trafficStats.list

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתה
• גוף הבקשה
• גוף התשובה
  • ייצוג JSON
• היקפי ההרשאות
• Date (תאריך)
  • ייצוג JSON
• רוצים לנסות?

הצגת רשימה של נתונים סטטיסטיים של תנועה לכל הימים הזמינים. הפונקציה מחזירה את הערך רשות_DENIED אם למשתמש אין הרשאה לגשת אל נתוני התנועה של הדומיין.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent	string שם המשאב של הדומיין שלגביו רוצים לראות את הנתונים הסטטיסטיים של התנועה. הפורמט צריך להיות domains/{domain_name}, שבו domain_name הוא שם הדומיין שמוגדר במלואו.

פרמטרים של שאילתה

פרמטרים
startDate	object (Date) היום המוקדם ביותר של המדדים שיש לאחזר. יש לציין startDate ו-endDate או את שניהם ללא לציין. אם מציינים רק ערך אחד, או שתאריך הסיום מוקדם יותר מ-startDate, מוחזר הערך INVALID_ARGUMENT.
endDate	object (Date) היום האחרון של המדדים לאחזור בלעדי. יש לציין startDate ו-endDate או את שניהם ללא לציין. אם מציינים רק ערך אחד, או שתאריך הסיום מוקדם יותר מ-startDate, מוחזר הערך INVALID_ARGUMENT.
pageSize	integer גודל הדף המבוקש. השרת עשוי להחזיר פחות נתוני תנועה מהנדרש. אם לא צוין, השרת יבחר ברירת מחדל מתאימה.
pageToken	string הערך NextPageToken שהוחזר מבקשת רשימה קודמת, אם קיימת. זהו הערך של ListTrafficStatsResponse.next_page_token שהוחזר מהקריאה הקודמת ל-method trafficStats.list.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

הודעת תגובה עבור trafficStats.list.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON
{ "trafficStats": [ { object (TrafficStats) } ], "nextPageToken": string }

שדות
trafficStats[]	object (TrafficStats) רשימת הנתונים הסטטיסטיים של תנועת הגולשים.
nextPageToken	string אסימון לאחזור דף התוצאות הבא, או ריק אם אין עוד תוצאות ברשימה.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של 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	integer השנה שבה חל התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.
month	integer החודש בשנה. הערך חייב להיות 1 עד 12, או 0 כדי לציין שנה בלי חודש ויום.
day	integer היום בחודש. הערך צריך להיות בין 1 ל-31 ותקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם אין חשיבות לציון יום מסוים.