Method: customerUsageReports.get

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

בקשת HTTP

GET https://admin.googleapis.com/admin/reports/v1/usage/dates/{date}

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

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

פרמטרים
date

string

התאריך שבו התרחש השימוש, לפי שעון החוף המערבי (PST)‏ -8:00 (UTC). חותמת הזמן היא בפורמט ISO 8601, yyyy-mm-dd.

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

פרמטרים
customerId

string

המזהה הייחודי של הלקוח שעבורו רוצים לאחזר נתונים.
pageToken

string

אסימון לציון הדף הבא. דוח עם כמה דפים מכיל בתשובה נכס nextPageToken. בבקשות הבאות לקבלת כל הדפים בדוח, מזינים את הערך nextPageToken במחרוזת השאילתה pageToken.
parameters

string

מחרוזת השאילתה parameters היא רשימה מופרדת בפסיקים של פרמטרים של אירועים שמצמצמים את תוצאות הדוח. הפרמטר משויך לאפליקציה ספציפית. הערכים של האפליקציות בדוח 'נתוני שימוש של לקוחות' כוללים את הערכים הבאים: accounts, app_maker, apps_scripts, calendar, classroom, cros, docs, gmail, gplus, device_management, meet ו-sites.
מחרוזת שאילתה parameters היא בפורמט CSV של app_name1:param_name1, app_name2:param_name2.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/admin.reports.usage.readonly

מידע נוסף זמין במדריך להרשאות.