Method: customerUsageReports.get

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

בקשת HTTP

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

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

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

פרמטרים
date

string

מייצג את התאריך שבו בוצע השימוש, לפי UTC-8:00 (לפי שעון החוף המערבי של ארה"ב). חותמת הזמן היא בפורמט 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

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