Method: entityUsageReports.get

ดึงรายงานซึ่งเป็นชุดของพร็อพเพอร์ตี้และสถิติสำหรับเอนทิตีที่ผู้ใช้ภายในบัญชีใช้ ดูข้อมูลเพิ่มเติมได้ที่คู่มือรายงานการใช้งานเอนทิตี สำหรับข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์ของรายงานเอนทิตี โปรดดูคู่มืออ้างอิงพารามิเตอร์การใช้งานเอนทิตี

คำขอ HTTP

GET https://admin.googleapis.com/admin/reports/v1/usage/{entityType}/{entityKey or all}/dates/{date}

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
entityType

enum (EntityType)

แสดงประเภทของเอนทิตีสำหรับรายงาน
entityKey or all

string

แสดงคีย์ของออบเจ็กต์ที่ใช้กรองข้อมูล ค่านี้เป็นสตริงที่มีค่า all เพื่อรับเหตุการณ์กิจกรรมของผู้ใช้ทั้งหมด หรือค่าอื่นๆ สำหรับเอนทิตีเฉพาะแอป โปรดดูรายละเอียดเกี่ยวกับวิธีรับ entityKey สำหรับ entityType ที่ต้องการที่คู่มืออ้างอิงเกี่ยวกับพารามิเตอร์การใช้งานเอนทิตี
date

string

แสดงวันที่ที่มีการใช้งาน ตามเขตเวลา UTC-8:00 (เวลามาตรฐานแปซิฟิก) การประทับเวลาอยู่ในรูปแบบ ISO 8601, yyyy-mm-dd

พารามิเตอร์การค้นหา

พารามิเตอร์
customerId

string

รหัสที่ไม่ซ้ำกันของลูกค้าที่ต้องการดึงข้อมูล
filters

string

สตริงการค้นหา filters คือรายการพารามิเตอร์เหตุการณ์ของแอปพลิเคชันที่คั่นด้วยคอมมา โดยที่ค่าของพารามิเตอร์ควบคุมโดยโอเปอเรเตอร์แบบเชิงสัมพันธ์ สตริงการค้นหา filters มีชื่อแอปพลิเคชันที่แสดงการใช้งานในรายงาน ค่าแอปพลิเคชันสำหรับรายงานการใช้งานเอนทิตีประกอบด้วย accounts, docs และ gmail

ตัวกรองอยู่ในรูปแบบ [application name]:[parameter name][relational operator][parameter value],...

ในตัวอย่างนี้ โอเปอเรเตอร์ "ไม่เท่ากับ" ของ <> มีการเข้ารหัส URL ในสตริงการค้นหาของคำขอ (%3C%3E) ดังนี้ 

GET
https://www.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-01
?parameters=gplus:community_name,gplus:num_total_members
&filters=gplus:num_total_members%3C%3E0

โอเปอเรเตอร์ที่สัมพันธ์กันมีดังนี้

  • == - 'เท่ากับ'
  • <> - "ไม่เท่ากับ" มีการเข้ารหัส URL (%3C%3E)
  • < - 'น้อยกว่า' มีการเข้ารหัส URL (%3C)
  • <= - "น้อยกว่าหรือเท่ากับ" มีการเข้ารหัส URL (%3C=)
  • > - "มากกว่า" ซึ่งใช้เข้ารหัส URL (%3E)
  • >= - "มากกว่าหรือเท่ากับ" มีการเข้ารหัส URL (%3E=)
ตัวกรองใช้ได้กับพารามิเตอร์ที่เป็นตัวเลขเท่านั้น
maxResults

integer (uint32 format)

กำหนดจำนวนบันทึกกิจกรรมที่จะแสดงในหน้าคำตอบแต่ละหน้า ตัวอย่างเช่น หากคำขอตั้งค่า <span>maxResults=1</span> และรายงานมีกิจกรรม 2 รายการ รายงานจะมี 2 หน้า พร็อพเพอร์ตี้ <span>nextPageToken</span> ของการตอบกลับมีโทเค็นไปยังหน้าที่ 2
pageToken

string

โทเค็นเพื่อระบุหน้าถัดไป รายงานที่มีหลายหน้าจะมีพร็อพเพอร์ตี้ nextPageToken ในการตอบกลับ ในคำขอติดตามผลที่ขอหน้าถัดไปของรายงาน ให้ป้อนค่า nextPageToken ในสตริงคำค้นหา pageToken
parameters

string

สตริงการค้นหา parameters คือรายการพารามิเตอร์เหตุการณ์ที่คั่นด้วยจุลภาคซึ่งปรับแต่งผลลัพธ์ของรายงาน พารามิเตอร์จะเชื่อมโยงกับแอปพลิเคชันที่เฉพาะเจาะจง ค่าของแอปพลิเคชันสำหรับรายงานการใช้งานเอนทิตีคือ gplus เท่านั้น
สตริงคำค้นหา parameter อยู่ในรูปแบบ CSV ของ [app_name1:param_name1], [app_name2:param_name2]...

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ UsageReports

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

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

EntityType

Enum
gplus_communities แสดงผลรายงานเกี่ยวกับ Google+ ชุมชนออนไลน์