ภาพรวมของ Google Analytics Admin API

สรุป: เอกสารนี้จะแสดงภาพรวมระดับสูงของ Google Admin API เวอร์ชัน 1.0

คําเตือน: นี่คือ API เวอร์ชันตัวอย่างก่อนเปิดตัวและอาจมีการเปลี่ยนแปลง แม้ว่าเราจะพยายามแจ้งให้คุณทราบถึงการเปลี่ยนแปลงที่กําลังจะเกิดขึ้นนี้ แต่คุณอาจพบการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบก่อนที่จะเผยแพร่ API ต่อสาธารณะ

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

สําหรับประกาศอย่างเป็นทางการของ Google Analytics API โปรดสมัครรับ กลุ่มแจ้งเตือนของ Google Analytics API หากต้องการรายงานปัญหาเกี่ยวกับ API ให้ใช้แบบฟอร์มแสดงความคิดเห็นของผู้ทดสอบ Google Analytics API

บทนำ

Google Analytics Admin API ช่วยให้คุณเข้าถึงข้อมูลการกําหนดค่า Google Analytics 4 (GA4) แบบเป็นโปรแกรมได้ และเข้ากันได้กับพร็อพเพอร์ตี้ GA4 เท่านั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ GA4

คุณสามารถใช้ Google Analytics Admin API เพื่อดําเนินการต่อไปนี้ได้

• จัดสรรบัญชีใหม่
• จัดการบัญชี
• จัดการการตั้งค่าการแชร์ข้อมูล
• แสดงข้อมูลสรุปบัญชี
• ค้นหาเหตุการณ์ประวัติการเปลี่ยนแปลง
• จัดการพร็อพเพอร์ตี้
• รับทราบการรวบรวมข้อมูลผู้ใช้
• จัดการการตั้งค่าการเก็บรักษาข้อมูลสําหรับพร็อพเพอร์ตี้
• จัดการการตั้งค่า Google Signals สําหรับพร็อพเพอร์ตี้ (อัลฟ่า)
• จัดการสตรีม
• จัดการข้อมูลลับใน Measurement Protocol
• สร้างข้อมูลโค้ดแท็ก Google สําหรับสตรีมข้อมูลเว็บ (อัลฟ่า)
• จัดการเหตุการณ์ Conversion
• จัดการมิติข้อมูลที่กําหนดเอง
• จัดการเมตริกที่กําหนดเอง
• จัดการการลิงก์ระหว่างพร็อพเพอร์ตี้ GA4 กับโปรเจ็กต์ Firebase
• จัดการการลิงก์ระหว่างพร็อพเพอร์ตี้ GA4 กับบัญชี Google Ads
• จัดการข้อเสนอสําหรับการลิงก์ระหว่างพร็อพเพอร์ตี้ GA4 กับผู้ลงโฆษณา Display & amp; Video 360 (อัลฟ่า)
• จัดการการลิงก์ระหว่างพร็อพเพอร์ตี้ GA4 กับผู้ลงโฆษณา Display & amp; Video 360 (อัลฟ่า)
• จัดการการลิงก์ระหว่างพร็อพเพอร์ตี้ GA4 กับ Search Ads 360 (อัลฟ่า)
• จัดการการลิงก์ระหว่างพร็อพเพอร์ตี้ GA4 กับโปรเจ็กต์ BigQuery (อัลฟ่า)
• จัดการสิทธิ์ของผู้ใช้สําหรับลําดับชั้นบัญชีและพร็อพเพอร์ตี้ GA4 (อัลฟ่า)
• สร้างรายงานการเข้าถึงข้อมูล (อัลฟ่า)
• จัดการกลุ่มเป้าหมาย (อัลฟ่า)
• จัดการชุดข้อมูลแบบขยาย (อัลฟ่า)
• จัดการการตั้งค่าการเลือกไม่ใช้กระบวนการตั้งค่า GA4 อัตโนมัติ (อัลฟ่า)

วิธีการที่ใช้ได้

การจัดสรรบัญชี

• accounts.provisionAccountTicket

  วิธีนี้จะแสดงผลช่อง accountTicketId ที่ควรรวมอยู่ใน URL ของข้อกําหนดในการให้บริการ (TOS) https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID เมื่อผู้ใช้ไปที่ TOS URL และยอมรับข้อกําหนดในการให้บริการแล้ว การสร้างบัญชี Google Analytics จะสมบูรณ์ (ตัวอย่างการจัดสรรบัญชี)

การจัดการบัญชี

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

การจัดการการตั้งค่าการแชร์ข้อมูล

• accounts.getDataSharingSettings

แสดงรายการสรุปบัญชี

• accountSummaries.list

ค้นหาเหตุการณ์ประวัติการเปลี่ยนแปลง

• accounts.searchChangeHistoryEvents

บริการจัดการคอนโด

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

การรับทราบการรวบรวมข้อมูลผู้ใช้

• properties.acknowledgeUserDataCollection

การจัดการการตั้งค่าการเก็บรักษาข้อมูล

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

การจัดการการตั้งค่า Google Signals (อัลฟ่า)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

การจัดการสตรีมข้อมูล

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

การจัดการข้อมูลลับใน Measurement Protocol

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

การจัดการเหตุการณ์ Conversion

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete

การจัดการมิติข้อมูลที่กําหนดเอง

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

การจัดการเมตริกที่กําหนดเอง

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

การลิงก์โปรเจ็กต์ Firebase

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

การลิงก์บัญชี Google Ads

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

การสร้างแท็ก Google (อัลฟ่า)

• properties.webDataStreams.getGlobalSiteTag

ข้อเสนอการลิงก์ระหว่างพร็อพเพอร์ตี้ GA4 กับผู้ลงโฆษณา Display & amp; Video 360 (อัลฟ่า)

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

การลิงก์บัญชีผู้ลงโฆษณา Display & amp; Video 360 (อัลฟ่า)

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

การลิงก์บัญชี Search Ads 360 (อัลฟ่า)

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าการผสานรวม Analytics ใน Search Ads 360 สําหรับพร็อพเพอร์ตี้ GA4

การลิงก์บัญชี BigQuery (อัลฟ่า)

• properties.bigQueryLinks.get
• properties.bigQueryLinks.list

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่า BigQuery Export สําหรับพร็อพเพอร์ตี้ GA4

การจัดการสิทธิ์ของผู้ใช้ (อัลฟ่า)

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

รายงานการเข้าถึงข้อมูล (อัลฟ่า)

• properties.runAccessReport

ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ได้ที่คําแนะนําเกี่ยวกับรายงานการเข้าถึงข้อมูล

การจัดการกลุ่มเป้าหมาย (อัลฟ่า)

• properties.audience.create
• properties.audience.archive
• properties.audience.patch
• properties.audience.list
• properties.audience.get

ดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่มเป้าหมาย ใน Google Analytics

การจัดการชุดข้อมูลที่ขยาย (อัลฟ่า)

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

ดูข้อมูลเพิ่มเติมเกี่ยวกับชุดข้อมูลที่ขยายใน Google Analytics 360

การเลือกไม่ใช้กระบวนการตั้งค่า GA4 อัตโนมัติ (อัลฟ่า)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการสถานะการเลือกไม่รับสําหรับกระบวนการตั้งค่า GA4 แบบอัตโนมัติสําหรับพร็อพเพอร์ตี้ UA