Reports API: ประวัติการแก้ไข

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

หน้านี้จะแสดงการเปลี่ยนแปลง Reports API (v1) และการอัปเดตเอกสารประกอบ

14 พฤษภาคม 2020

เพิ่มพารามิเตอร์ใหม่ member_type ในรายงานกิจกรรมกลุ่มแล้ว ประเภทสมาชิกที่ถูกต้อง ได้แก่ ผู้ใช้ กลุ่ม บัญชีบริการ และอื่นๆ

30 กรกฎาคม 2019

เราเลิกใช้งานรายงานการใช้งานของลูกค้าสําหรับ App Maker และ Apps Script แล้ว และจะนําออกจาก API ในที่สุด

22 ตุลาคม 2018

ตอนนี้พารามิเตอร์ Community_name สําหรับรายงาน Google+ ชุมชนออนไลน์พร้อมให้บริการสําหรับชุมชนภายในองค์กรของคุณเท่านั้น

1 สิงหาคม 2018

ความพร้อมใช้งานของข้อมูลในอดีตสําหรับรายงานการใช้งานเอนทิตีเปลี่ยนเป็น 30 วัน

4 มิถุนายน 2018

เราได้แก้ไขปัญหาที่มีการรายงานพารามิเตอร์การใช้งานเอนทิตีบางรายการไม่เพียงพอสําหรับชุมชน Google+ บางชุมชน ข้อมูลนี้ได้รับการแก้ไข ณ วันที่ 25 พฤษภาคม 2018

11 ธันวาคม 2017

เราได้สร้างรายงานการใช้งานเอนทิตีเพื่อสร้างรายงานเกี่ยวกับเอนทิตีที่ผู้ใช้ในบัญชีของคุณใช้ ปัจจุบัน API รองรับการรายงานสําหรับชุมชน Google+ แล้ว

11 กรกฎาคม 2017

เพิ่มพารามิเตอร์ใหม่ 9 รายการไปยังรายงานการใช้งานของลูกค้า Google+ พารามิเตอร์ใหม่มีดังนี้

  • จํานวนชุมชน
  • หมายเลขโทรศัพท์สาธารณะ
  • จํานวนชุมชนส่วนตัว
  • หมายเลของค์กรขององค์กร
  • จํานวน_องค์กร_ส่วนตัว
  • คอลเล็กชัน num
  • หมายเลขคอลเล็กชันสาธารณะ
  • จํานวนคอลเล็กชันองค์กรแบบกว้าง
  • จํานวนคอลเล็กชันองค์กรส่วนตัว
นอกจากนี้ รายงานการใช้งานของผู้ใช้ Google+ ยังสร้างขึ้นด้วยเมตริก 7 รายการ ได้แก่

  • จํานวนการแชร์
  • จํานวนบวก
  • จํานวนบวกที่ได้รับ
  • จํานวนการตอบกลับ
  • จํานวนการรับ
  • จํานวนการแชร์ใหม่
  • จํานวนการแชร์อีกครั้ง

11 พฤษภาคม 2017

เราได้เพิ่มรายงานการใช้งาน App Maker และ App Script ของลูกค้าลงในเมธอด customerusageReports.get รายงานใหม่เหล่านี้จะช่วยให้คุณดูข้อมูลการใช้งาน App Maker และ Apps Script ในโดเมนได้

5 เมษายน 2017

ลูกค้า Google เอกสารกําลังเข้ามาแทนที่รายงานและการใช้งาน Google ไดรฟ์ โปรดดูรายละเอียดในการอัปเดตเมตริกของไดรฟ์และเอกสาร

14 มีนาคม 2017

เพิ่มพารามิเตอร์ใหม่ 6 รายการในรายงานการใช้งานของลูกค้า Google+ พารามิเตอร์ใหม่มีดังนี้

  • จํานวนผู้ใช้ใหม่
  • จํานวนการแชร์
  • จํานวนการแชร์ใหม่
  • จํานวนบวก
  • จํานวนการตอบกลับ
  • จํานวนรายการสตรีมที่อ่านแล้ว

2 กุมภาพันธ์ 2015

เราได้เพิ่มรายงานการใช้งานลูกค้าอุปกรณ์เคลื่อนที่ลงในเมธอด customerusageReports.get รายงานใหม่นี้จะช่วยให้คุณสามารถดูข้อมูลเกี่ยวกับการใช้งานอุปกรณ์เคลื่อนที่ในโดเมนของคุณ

เราได้แก้ไขบันทึกประจํารุ่นให้รวมรายงาน Chrome OS ซึ่งเปิดตัวไปเมื่อวันที่ 27 ตุลาคม 2014

11 ธันวาคม 2014

เราได้เพิ่มรายงานการตรวจสอบ Google ปฏิทินลงในเมธอด activities.list รายงานใหม่นี้ช่วยให้ดูข้อมูลเกี่ยวกับการเปลี่ยนแปลงในปฏิทินและกิจกรรมในปฏิทินสําหรับผู้ใช้ในโดเมนได้

20 พฤศจิกายน 2014

เราได้เพิ่มรายงานการใช้งานของลูกค้า Google Sites ลงในเมธอด customerusageReports.get รายงานใหม่นี้ช่วยให้คุณดูข้อมูลเกี่ยวกับการใช้งาน Google Sites ในโดเมนได้

12 พฤศจิกายน 2014

เราได้เพิ่มแอปพลิเคชันการรายงาน OAuth Token Audit ลงในเมธอด activities.list รายงานใหม่นี้ช่วยให้ดูข้อมูลเกี่ยวกับเว็บไซต์และแอปพลิเคชันของบุคคลที่สามซึ่งผู้ใช้ในโดเมนให้สิทธิ์เข้าถึงได้

29 ตุลาคม 2014

เพิ่มพารามิเตอร์ใหม่ลงในรายงานการใช้งาน Gmail ของลูกค้าแล้ว พารามิเตอร์ใหม่มีดังนี้

  • จํานวนอีเมลนําส่งที่นําส่งแล้ว
  • จํานวน_เปลี่ยนเส้นทางขาเข้า [num_inbound_rerouted_emails]
  • จํานวน_อีเมลที่ถูกขอบเขตที่ปฏิเสธ
  • จํานวนจดหมายขยะ
  • จํานวนจดหมายขยะ [num_inbound_non_spam_emails]
  • จํานวนอีเมลที่เข้ารหัส
  • จํานวนอีเมลที่ไม่เข้ารหัส
  • จํานวนอีเมลที่ส่งออก
  • จํานวน_อีเมลที่ถูกเปลี่ยนเส้นทาง_
  • จํานวนอีเมลที่ถูกเพิกถอน
  • จํานวนอีเมลที่เข้ารหัสขาออก
  • จํานวนอีเมลที่ไม่เข้ารหัส num_outbound_encoded

27 ตุลาคม 2014

เราได้เพิ่มรายงานการใช้งานอุปกรณ์อุปกรณ์ Chrome OS ลงในเมธอด customerusageReports.get รายงานใหม่นี้ช่วยให้ดูข้อมูลการใช้งานอุปกรณ์ Chrome OS ในโดเมนได้

2 กันยายน 2014

เพิ่มเวลาสูงสุดสําหรับรายงานการใช้งานจาก 180 เป็น 450 วัน เนื่องจากการเปลี่ยนแปลงนี้จะต้องใช้เวลาในการเติมข้อมูลของเรา ประวัติแบบเต็ม 450 วันจะใช้ได้ในวันที่ 30 พฤษภาคม 2015 โดยมีวันที่บันทึกแรกสุดในวันที่ 6 มีนาคม 2014

15 สิงหาคม 2014

เพิ่มเหตุการณ์ view ใหม่ในรายงานกิจกรรมในไดรฟ์แล้ว

25 มิถุนายน 2014

รายงานกิจกรรมในไดรฟ์พร้อมให้ใช้งานแล้วใน Reports API รายงานนี้จะให้ข้อมูลเชิงลึกเกี่ยวกับกิจกรรมในไดรฟ์ และวิธีที่ผู้ใช้ของคุณจัดการ แก้ไข และแชร์เอกสารใน Google ไดรฟ์ของบัญชี รายงานนี้มีให้เฉพาะลูกค้า G Suite Business และใช้แทนรายงานกิจกรรมของ Google เอกสาร เราเลิกใช้รายงานกิจกรรมของ Google เอกสารแล้ว และจะหยุดให้บริการในวันที่ 31 มกราคม 2015

5 มิถุนายน 2014

ตอนนี้ทั้งรายงาน Gmail แบบลูกค้าและผู้ใช้จะรวมค่าเริ่มต้น เช่น หากผู้ใช้ไม่ส่งอีเมล พารามิเตอร์ num_emails_sent จะแสดงเป็น 0 ก่อนหน้านี้หากไม่มีข้อมูลในช่อง ระบบจะไม่สนใจช่องนั้นในรายงาน

27 พฤษภาคม 2014

ตอนนี้ Reports API จะรวมสถิติการใช้งานจากผู้ใช้ที่ถูกระงับในรายงานการใช้งานของลูกค้า

23 เมษายน 2014

มีการเปลี่ยนแปลงวิธีการส่งคืนพารามิเตอร์ที่ API ไม่มีข้อมูล ก่อนหน้านี้หากไม่มีข้อมูลสําหรับพารามิเตอร์ พารามิเตอร์นั้นก็จะไม่แสดงในรายงาน เช่น รายงานการใช้งานของผู้ใช้ Gmail จะไม่มีช่อง num_emails_sent ในการตอบกลับในกรณีที่ผู้ใช้ไม่ได้ส่งอีเมลในวันที่รายงาน ตอนนี้ API จะแสดงพารามิเตอร์เหล่านี้ด้วยค่าเริ่มต้นเป็น 0 สําหรับจํานวนเต็มและ false สําหรับค่าบูลีน

15 เมษายน 2014

เพิ่มพารามิเตอร์ num_users_2sv_not_enrolled_but_enforced ใหม่ไปยังรายงานการใช้งานบัญชีลูกค้าแล้ว พารามิเตอร์ใหม่นี้จะระบุจํานวนผู้ใช้โดเมนที่มีการบังคับใช้การยืนยันแบบ 2 ขั้นตอน แต่ไม่ได้ลงทะเบียน

27 มีนาคม 2014

เพิ่ม login_failure_type ค่าใหม่ 2 ค่าในเหตุการณ์การตรวจสอบการเข้าสู่ระบบ ได้แก่ login_failure_account_disabled และ login_failure_unknown

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

5 มีนาคม 2014

มีการแก้ไขข้อบกพร่องสําหรับปัญหาที่ทําให้ตัวกรองไม่สนใจคําค้นหาสําหรับผู้ใช้รายเดียว และแสดงผลระเบียนเดียวเสมอ หลังจากแก้ไขแล้ว การค้นหาสําหรับผู้ใช้รายเดียวที่มีตัวกรองด้วยจะไม่แสดงผลการค้นหาในกรณีที่ผู้ใช้ไม่ตรงกับเกณฑ์การกรอง

28 กุมภาพันธ์ 2014

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

  • บัญชี
    • จํานวนการเข้าสู่ระบบของวัน
    • จํานวนการเข้าสู่ระบบ วัน
    • จํานวนการเข้าสู่ระบบ 30 วัน
  • Google ปฏิทิน
    • จํานวนผู้ใช้ที่ใช้งานรายวัน
    • จํานวนวันที่ผู้ใช้ใช้งาน 7 วัน
  • Google เอกสาร
    • จํานวนผู้ใช้ที่ใช้งานรายวัน
    • จํานวนวันที่ผู้ใช้ใช้งาน 7 วัน
    • จํานวนผู้ใช้ที่ใช้งานอยู่ 30 วัน
  • Gmail
    • จํานวนผู้ใช้ที่ใช้งานรายวัน
    • จํานวนวันที่ผู้ใช้ใช้งาน 7 วัน
    • จํานวนผู้ใช้ที่ใช้งานอยู่ 30 วัน
  • Google+
    • จํานวนผู้ใช้ที่ใช้งานรายวัน
    • จํานวนวันที่ผู้ใช้ใช้งาน 7 วัน

และเมื่อเร็วๆ นี้มีการเพิ่มช่องใหม่จํานวนมากในรายงานการใช้งานบัญชีของลูกค้าและการใช้งานบัญชีผู้ใช้ ช่องใหม่มีดังนี้

  • บัญชีลูกค้า
    • จํานวนแอปที่ได้รับอนุญาต
    • แอปที่ได้รับสิทธิ์
    • drive_used_quota_in_mb
    • gmail_used_quota_in_mb
    • gplus_photos_used_quota_in_mb
    • total_quota_in_mb
    • ใช้_โควต้าแล้ว
    • ใบอนุญาตรวมของแอป
    • ใบอนุญาตของแอปมือสอง
    • ห้องนิรภัยรวมทั้งหมด
    • พิกัดใบอนุญาตรวม
  • บัญชีผู้ใช้
    • จํานวนแอปที่ได้รับอนุญาต
    • drive_used_quota_in_mb
    • gmail_used_quota_in_mb
    • gplus_photos_used_quota_in_mb
    • total_quota_in_mb
    • ใช้_โควต้าแล้ว
    • ใช้_โควต้าแล้ว

10 กุมภาพันธ์ 2014

ในขณะนี้ ผู้ใช้ที่ถูกระงับจะรวมอยู่ในสถิติสําหรับรายงานเอกสาร บางโดเมนอาจสังเกตเห็นจํานวนเอกสารที่รายงานเพิ่มขึ้น

เพิ่มพารามิเตอร์ต่อไปนี้ลงในรายงานการใช้งานของผู้ใช้

27 มกราคม 2014

เพิ่มข้อความ Push สําหรับการเปลี่ยนแปลงทรัพยากรกิจกรรม การตั้งค่านี้มีให้บริการใน API โดยใช้ 2 วิธีการใหม่ คือ activities.watch และ channels.stop เพื่อเริ่มและหยุดรับการแจ้งเตือน

3 ธันวาคม 2013

เพิ่มการสนับสนุนสําหรับผู้ค้าปลีกเพื่อเรียกรายงานการใช้งานและข้อมูลการตรวจสอบสําหรับลูกค้าที่เฉพาะเจาะจง ซึ่งจะแสดงใน API เป็นพารามิเตอร์ customerId ใหม่สําหรับเมธอด activities.list, customerUsageReports.get และ userUsageReport.get

เมษายน 2013

ส่วนนี้จะไฮไลต์ความแตกต่างระหว่าง Reports API และ G Suite Admin Audit API (v1) ที่เลิกใช้งานแล้ว โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับรายงาน API ของผู้ดูแลระบบในรายงานคู่มือสําหรับนักพัฒนาซอฟต์แวร์ และเอกสารอ้างอิง API และข้อมูลอ้างอิงเหตุการณ์ของกิจกรรมของผู้ดูแลระบบ

ฟีเจอร์ API Reports API (v1) API การตรวจสอบผู้ดูแลระบบที่เลิกใช้งาน (v1)
applicationIdและapplicationName รายงานกิจกรรมของผู้ดูแลระบบจะใช้ applicationName: "admin" เพื่อระบุคอนโซลผู้ดูแลระบบ สําหรับข้อมูลเพิ่มเติมโปรดดูข้อมูลอ้างอิง API Admin Audit API ระบุแอปพลิเคชันคอนโซลผู้ดูแลระบบที่มี "applicationId": "207535951991"
ฟีเจอร์การส่งออกไฟล์ CSV ของแผงควบคุม ใน Reports API เวอร์ชันนี้ ระบบจะไม่รองรับฟีเจอร์นี้ มีการรองรับนี้ใน Admin Audit API
eventTypeและtype รายงานกิจกรรมของผู้ดูแลระบบจะแสดงพารามิเตอร์ type Admin Audit API ใช้ eventType เป็นหมวดหมู่กิจกรรม
ขอบเขต OAuth และ OAuth Reports API ใช้โปรโตคอล OAuth 2.0 Reports API ไม่รองรับขอบเขต OAuth Audit ของผู้ดูแลระบบใน API
การใส่เลขหน้า สําหรับรายงานที่มีหน้าคําตอบหลายหน้า API การรายงานรองรับสตริงการค้นหา maxResults และ pageToken และพารามิเตอร์การตอบกลับ nextPageToken Admin Audit API รองรับพารามิเตอร์ maxResults, rel และ next
URL ของทรัพยากร รายงานกิจกรรมของผู้ดูแลระบบมี URL อื่นที่ไม่ได้ใช้ customerId URL รายงานกิจกรรมของผู้ดูแลระบบคือ https://www.googleapis.com/admin/reports/v1/activity/users/userKey | all/applications/admin URL ของ Admin Audit API คือ https://www.googleapis.com/apps/reporting/audit/v1/the customer ID/the application ID
รูปแบบเวลาและวันที่ Reports API จะขอเวลาการสนับสนุนในรูปแบบ ISO 8601 ปปปป-ดด-วว การตอบกลับ Reports API จะอยู่ในเวลา UNIX epoch ในหน่วยวินาที Admin Audit API ใช้รูปแบบ UTC