Method: customerUsageReports.get

گزارشی را بازیابی می کند که مجموعه ای از خواص و آمار برای حساب یک مشتری خاص است. برای اطلاعات بیشتر، راهنمای گزارش استفاده از مشتریان را ببینید. برای اطلاعات بیشتر در مورد پارامترهای گزارش مشتری، به راهنمای مرجع پارامترهای استفاده از مشتریان مراجعه کنید.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.