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 และศูนย์ช่วยเหลือสำหรับผู้ดูแลระบบ Google Workspace