Reports API คือ RESTful API ที่คุณสามารถใช้เข้าถึงข้อมูลเกี่ยวกับกิจกรรมใน Google Workspace ของผู้ใช้ได้ Reports API เป็นส่วนหนึ่งของ Admin SDK API
Reports API มีรายงาน 2 ประเภท ได้แก่
- รายงานกิจกรรม ซึ่งรายงานเหตุการณ์สำหรับแอปพลิเคชันหรือบริการที่เฉพาะเจาะจง เช่น Google ไดรฟ์หรือคอนโซลผู้ดูแลระบบ
- รายงานการใช้งาน ซึ่งแสดงรายการเหตุการณ์ในเวิร์กスペースที่เกิดจากผู้ใช้
- รายงานการใช้งานของลูกค้าจะแสดงเหตุการณ์ของผู้ใช้ทุกคนในโดเมน
- รายงานการใช้งานของผู้ใช้จะแสดงรายการเหตุการณ์ที่จัดระเบียบตามผู้ใช้
ต่อไปนี้คือรายการคําศัพท์ทั่วไปที่ใช้ใน Reports API
- รายงานกิจกรรม
รายงานกิจกรรมจะแสดงข้อมูลสำหรับกิจกรรมในแอปพลิเคชันหรือบริการ Google Workspace ที่เฉพาะเจาะจง รายงานกิจกรรมประกอบด้วยวันที่ เวลา ผู้ใช้ และประเภทกิจกรรม เอกสารอ้างอิง API มีรายการรายงานกิจกรรมทั้งหมดและข้อมูลที่มีอยู่ในรายงาน ตัวอย่างรายงานกิจกรรมที่แสดงตามแอปพลิเคชันหรือบริการมีดังนี้
- รายงานกิจกรรมของผู้ดูแลระบบจะแสดงกิจกรรมที่ผู้ดูแลระบบดำเนินการโดยใช้คอนโซลผู้ดูแลระบบ เช่น คุณอาจดูรายการทั้งหมดที่ผู้ดูแลระบบเปลี่ยนชื่อผู้ใช้ได้โดยใช้คอนโซลผู้ดูแลระบบ
- รายงานกิจกรรมใน Google ไดรฟ์จะแสดงวิธีที่ผู้ใช้โดเมนแก้ไขและดูเอกสารในไดรฟ์ เช่น คุณดูรายการกิจกรรมของผู้ใช้รายใดรายหนึ่งในไดรฟ์ได้
- รายงานกิจกรรมการเข้าสู่ระบบจะแสดงข้อมูลเกี่ยวกับเวลาที่ผู้ใช้บัญชีเข้าสู่ระบบและออกจากระบบ เช่น คุณอาจดูรายงานการเข้าสู่ระบบทั้งหมดของโดเมนในช่วงระยะเวลาหนึ่งได้
- รายงานกิจกรรมในอุปกรณ์เคลื่อนที่จะแสดงกิจกรรมที่ใช้อุปกรณ์เคลื่อนที่ซึ่งจัดการโดยการจัดการอุปกรณ์เคลื่อนที่ของ Google เช่น คุณสามารถรับการแจ้งเตือนเมื่อผู้ใช้ลงทะเบียนอุปกรณ์ใหม่
- รายงานกิจกรรมโทเค็น OAuth จะแสดงรายการเหตุการณ์เมื่อผู้ใช้ให้หรือเพิกถอนโทเค็นการให้สิทธิ์ที่ใช้โดยเว็บไซต์และแอปพลิเคชันของบุคคลที่สาม คุณสามารถใช้ Reports API เพื่อดูรายการสิทธิ์เข้าถึงข้อมูล Google Workspace ของผู้ใช้ทั้งหมดที่บุคคลที่สามมี
- รายงานการใช้งาน
รายงานการใช้งานให้ข้อมูลเกี่ยวกับเหตุการณ์ Google Workspace ในโดเมนของคุณ คุณสามารถใช้ API เพื่อขอข้อมูลเฉพาะเกี่ยวกับผู้ใช้ได้
- รายงานการใช้งานของลูกค้าจะแสดงรายการกิจกรรมโดยละเอียดของแอปพลิเคชันและบริการในบัญชี ข้อมูลการใช้งานนี้จัดระเบียบตามประเภทแอปพลิเคชันและมีข้อมูลเฉพาะสำหรับแอปพลิเคชันนั้นๆ
- รายงานการใช้งานของผู้ใช้จะแสดงกิจกรรมของผู้ใช้บัญชี รายงานเหล่านี้สามารถปรับแต่งและกรองข้อมูลการใช้งานที่เฉพาะเจาะจงได้ ข้อมูลการใช้งานนี้จัดระเบียบตามประเภทแอปพลิเคชันและมีข้อมูลเฉพาะของแอปพลิเคชันนั้นๆ
- รายงานการใช้งานเอนทิตีจะแสดงรายการกิจกรรมที่เกี่ยวข้องกับเอนทิตีที่ผู้ใช้บัญชีของคุณใช้ในแอปพลิเคชัน Currents
- การแจ้งเตือน
- Reports API มีการแจ้งเตือนที่ช่วยให้คุณติดตามเหตุการณ์ต่างๆ เช่น การเปลี่ยนแปลงทรัพยากร เมื่อคุณกําลังดูทรัพยากรและทรัพยากรนั้นเปลี่ยนแปลง Reports API จะส่งการแจ้งเตือนให้คุณ ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าและการรับการแจ้งเตือนจาก Reports API ได้ที่คู่มือการรับการแจ้งเตือนแบบ Push
ขั้นตอนถัดไป
หากต้องการดูข้อมูลเกี่ยวกับ Reports API และวิธีการใช้งาน ให้ใช้การเริ่มต้นใช้งานอย่างรวดเร็ว ซึ่งมีอยู่ตามภาษาโปรแกรมในแถบนำทางด้านซ้าย นอกจากนี้ คุณยังอ่านข้อมูลทั่วไปเกี่ยวกับการตั้งค่าบัญชีต่อในส่วนนี้ได้
ส่วนการให้สิทธิ์จะแสดงวิธีใช้โทเค็นการเข้าถึง OAuth 2.0 เพื่อรับข้อมูลผู้ใช้จากแอปพลิเคชันและบริการของ Google Workspace
หากต้องการดูรายละเอียดของประเภททรัพยากรหรือเมธอดที่เฉพาะเจาะจง โปรดดูเอกสารอ้างอิง API
ดูข้อมูลเพิ่มเติมได้ที่เครื่องมือติดตามปัญหา Admin SDK API, บล็อก Google Workspace Developers และศูนย์ช่วยเหลือของ Google Workspace Admin