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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์