Method: properties.runAccessReport

แสดงรายงานที่กำหนดเองของระเบียนการเข้าถึงข้อมูล รายงานจะบันทึกทุกครั้งที่ผู้ใช้อ่านข้อมูลการรายงานของ Google Analytics ระบบจะเก็บบันทึกการเข้าถึงไว้ไม่เกิน 2 ปี

คุณขอรายงานการเข้าถึงข้อมูลสําหรับพร็อพเพอร์ตี้ได้ อาจมีการขอรายงานสำหรับพร็อพเพอร์ตี้ใดก็ได้ แต่มิติข้อมูลที่ไม่เกี่ยวข้องกับโควต้าจะขอได้ในพร็อพเพอร์ตี้ Google Analytics 360 เท่านั้น วิธีการนี้ใช้ได้เฉพาะกับผู้ดูแลระบบเท่านั้น

ระเบียนการเข้าถึงข้อมูลเหล่านี้รวมถึงการรายงาน UI ของ GA4, การสํารวจ UI ของ GA4, GA4 Data API และผลิตภัณฑ์อื่นๆ เช่น Firebase และ AdMob ที่ดึงข้อมูลจาก Google Analytics ผ่านการลิงก์ได้ ระเบียนเหล่านี้ไม่รวมการเปลี่ยนแปลงการกำหนดค่าพร็อพเพอร์ตี้ เช่น การเพิ่มสตรีมหรือเปลี่ยนเขตเวลาของพร็อพเพอร์ตี้ ดูประวัติการเปลี่ยนแปลงการกําหนดค่าได้ที่ searchChangeHistoryEvents

คำขอ HTTP

POST https://analyticsadmin.googleapis.com/v1beta/{entity=properties/*}:runAccessReport

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

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

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

string

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

หากต้องการขอที่ระดับพร็อพเพอร์ตี้ เอนทิตีควรเป็น เช่น "พร็อพเพอร์ตี้/123" หาก "123" คือรหัสพร็อพเพอร์ตี้ GA4 หากต้องการขอที่ระดับบัญชี ข้อมูลควรเป็น "accounts/1234" เช่น หาก "1234" คือรหัสบัญชี GA4

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

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "dimensions": [
    {
      object (AccessDimension)
    }
  ],
  "metrics": [
    {
      object (AccessMetric)
    }
  ],
  "dateRanges": [
    {
      object (AccessDateRange)
    }
  ],
  "dimensionFilter": {
    object (AccessFilterExpression)
  },
  "metricFilter": {
    object (AccessFilterExpression)
  },
  "offset": string,
  "limit": string,
  "timeZone": string,
  "orderBys": [
    {
      object (AccessOrderBy)
    }
  ],
  "returnEntityQuota": boolean,
  "includeAllUsers": boolean,
  "expandGroups": boolean
}
ช่อง
dimensions[]

object (AccessDimension)

มิติข้อมูลที่ขอและแสดงในคำตอบ คำขอมีมิติข้อมูลได้สูงสุด 9 รายการ
metrics[]

object (AccessMetric)

เมตริกที่ขอและแสดงในการตอบกลับ คำขอมีเมตริกได้สูงสุด 10 รายการ
dateRanges[]

object (AccessDateRange)

ช่วงวันที่ของระเบียนการเข้าถึงที่จะอ่าน หากมีการขอช่วงวันที่หลายช่วง แถวการตอบกลับแต่ละแถวจะมีดัชนีช่วงวันที่ที่ยึดตาม 0 หากช่วงวันที่ 2 ช่วงซ้อนทับกัน บันทึกการเข้าถึงของวันที่ที่ซ้อนทับจะรวมอยู่ในแถวคำตอบของทั้ง 2 ช่วงวันที่ คำขอมีช่วงวันที่ได้สูงสุด 2 ช่วง
dimensionFilter

object (AccessFilterExpression)

ตัวกรองมิติข้อมูลช่วยให้คุณจํากัดการตอบสนองของรายงานให้แสดงเฉพาะค่ามิติข้อมูลที่ตรงกับตัวกรอง เช่น การกรองระเบียนการเข้าถึงของผู้ใช้รายเดียว ดูข้อมูลเพิ่มเติมได้จากตัวอย่างในพื้นฐานเกี่ยวกับตัวกรองมิติข้อมูล ใช้เมตริกในตัวกรองนี้ไม่ได้
metricFilter

object (AccessFilterExpression)

ตัวกรองเมตริกช่วยให้คุณจํากัดการตอบสนองของรายงานให้แสดงเฉพาะค่าเมตริกที่ตรงกับตัวกรอง ระบบจะใช้ตัวกรองเมตริกหลังจากรวบรวมข้อมูลแถวของรายงานแล้ว ซึ่งคล้ายกับประโยคที่มีของ SQL คุณใช้มิติข้อมูลในตัวกรองนี้ไม่ได้
offset

string (int64 format)

จํานวนแถวของแถวเริ่มต้น แถวแรกจะนับเป็นแถว 0 หากไม่ได้ระบุออฟเซต ระบบจะถือว่าออฟเซตเป็น 0 หากออฟเซตเป็น 0 วิธีการนี้จะแสดงหน้าแรกของผลการค้นหาซึ่งมีรายการ limit รายการ

ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์การแบ่งหน้านี้ได้ที่การแบ่งหน้า
limit

string (int64 format)

จำนวนแถวที่จะแสดงผล หากไม่ระบุ ระบบจะแสดงผล 10,000 แถว API จะส่งกลับจำนวนแถวสูงสุด 100,000 แถวต่อคำขอ ไม่ว่าคุณจะขอข้อมูลจำนวนเท่าใดก็ตาม limit ต้องเป็นค่าบวก

API อาจแสดงผลแถวน้อยกว่า limit ที่ขอ หากมีแถวเหลือน้อยกว่า limit ตัวอย่างเช่น มีค่าที่เป็นไปได้น้อยกว่า 300 ค่าสำหรับมิติข้อมูล country ดังนั้นเมื่อรายงานเฉพาะ country จะมีแถวได้ไม่เกิน 300 แถว แม้ว่าคุณจะตั้งค่า limit เป็นค่าที่สูงกว่าก็ตาม

ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์การแบ่งหน้านี้ได้ที่การแบ่งหน้า
timeZone

string

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

อยู่ในรูปแบบสตริงจากฐานข้อมูลเขตเวลาของ IANA (https://www.iana.org/time-zones) เช่น "America/New_York" หรือ "Asia/Tokyo"
orderBys[]

object (AccessOrderBy)

ระบุวิธีจัดเรียงแถวในการตอบกลับ
returnEntityQuota

boolean

สลับว่าจะแสดงสถานะปัจจุบันของโควต้าของพร็อพเพอร์ตี้ Analytics นี้หรือไม่ โควต้าจะแสดงใน AccessQuota สําหรับคําขอระดับบัญชี ช่องนี้ต้องเป็นค่าเท็จ
includeAllUsers

boolean

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

boolean

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

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

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

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit