สำหรับประกาศเกี่ยวกับ Google Analytics API อย่างเป็นทางการ โปรดติดตาม กลุ่มการแจ้งเตือน Google Analytics API
15-12-2023 ตอนนี้รายงานการเข้าถึงข้อมูลใช้ได้กับพร็อพเพอร์ตี้ Google Analytics ทั้งหมดแล้ว
ตอนนี้ช่องบางช่องของฟีเจอร์รายงานการเข้าถึงข้อมูลใช้ได้กับพร็อพเพอร์ตี้ Google Analytics ทั้งหมดทั้งลูกค้าแบบมาตรฐานและ Google Analytics 360 แล้ว
ดูข้อมูลเพิ่มเติมได้ในเอกสารสคีมา
15-12-2023 มิติข้อมูล accessDateHour
ที่เพิ่มลงในสคีมารายงานการเข้าถึงข้อมูล
เพิ่มมิติข้อมูล accessDateHour
ลงในสคีมารายงานการเข้าถึงข้อมูล ซึ่งประกอบด้วยชั่วโมงของวันที่
ของผู้ใช้ GA ที่เข้าถึงข้อมูลการรายงาน GA
05-10-2023 พร็อพเพอร์ตี้ที่มีรูปแบบการระบุแหล่งที่มาแบบคลิกแรก เชิงเส้น ลดลงตามเวลา และตามตำแหน่งจะมีค่าเริ่มต้นเป็น DDA ข้ามแชแนล
ตั้งแต่ช่วงกลางเดือนตุลาคม 2023 รูปแบบการระบุแหล่งที่มาแบบคลิกแรก เชิงเส้น ลดลงตามเวลา และตามตำแหน่งจะไม่สามารถใช้ร่วมกับเมธอด UpdateAttributionSettings สำหรับทุกพร็อพเพอร์ตี้ได้
หากพร็อพเพอร์ตี้ของคุณได้รับการกำหนดค่าให้ใช้รูปแบบใดรูปแบบหนึ่งอยู่ในขณะนี้ ระบบจะเปลี่ยนเป็นการระบุแหล่งที่มาโดยอิงตามข้อมูลแบบข้ามแชแนล คุณจะยังคงมีตัวเลือกในการใช้คลิกสุดท้ายข้ามแชแนลหรือคลิกสุดท้ายที่ระบุว่ามาจาก Google Ads แทน
2023-09-01 เพิ่มวิธีการกําหนดค่าสคีมามูลค่า Conversion สำหรับ SKAdNetwork
GetSKAdNetworkConversionValueSchema
,
CreateSKAdNetworkConversionValueSchema
,
DeleteSKAdNetworkConversionValueSchema
,
UpdateSKAdNetworkConversionValueSchema
,
ListSKAdNetworkConversionValueSchemas
เมธอดเพิ่มใน Admin API เวอร์ชัน 1alpha
ฟังก์ชันนี้ช่วยให้คุณจัดการการกำหนดค่าสคีมามูลค่า Conversion ของ SKAdNetwork สำหรับสตรีม iOS ได้
01-09-2023 เพิ่มเมธอด UpdateConversionEvent
แล้ว
เพิ่มเมธอด UpdateConversionEvent
ไปยัง Admin API v1beta แล้ว
2023-09-01 ช่อง BigQueryLink.enterprise_export_enabled
เปลี่ยนชื่อเป็น fresh_daily_export_enabled
ช่อง enterprise_export_enabled
ของทรัพยากร BigQueryLink
เปลี่ยนชื่อเป็น fresh_daily_export_enabled
14-07-2023 การเปลี่ยนแปลงที่ส่งผลกับ properties.updateAttributionSettings
, properties.getAttributionSettings
วิธี
ตั้งแต่วันที่ 24 กรกฎาคม 2023 เป็นต้นไป การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นของ Admin API v1 จะส่งผลต่อฟังก์ชันการทํางานของเมธอด properties.getAttributionSettings และ properties.updateAttributionSettings
สมาชิกของ enum ของ ReportingAttributionModel
จะเปลี่ยนชื่อดังนี้
ชื่อเก่า | ชื่อใหม่ |
---|---|
CROSS_CHANNEL_DATA_DRIVEN |
PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN |
CROSS_CHANNEL_LAST_CLICK |
PAID_AND_ORGANIC_CHANNELS_LAST_CLICK |
CROSS_CHANNEL_FIRST_CLICK |
PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK |
CROSS_CHANNEL_LINEAR |
PAID_AND_ORGANIC_CHANNELS_LINEAR |
CROSS_CHANNEL_POSITION_BASED |
PAID_AND_ORGANIC_CHANNELS_POSITION_BASED |
CROSS_CHANNEL_TIME_DECAY |
PAID_AND_ORGANIC_CHANNELS_TIME_DECAY |
ADS_PREFERRED_LAST_CLICK |
GOOGLE_PAID_CHANNELS_LAST_CLICK |
สมาชิกของ enum ของ AdsWebConversionDataExportScope
จะเปลี่ยนชื่อดังนี้
ชื่อเก่า | ชื่อใหม่ |
---|---|
CROSS_CHANNEL |
PAID_AND_ORGANIC_CHANNELS |
ADS_PREFERRED |
GOOGLE_PAID_CHANNELS |
2023-07-10 เพิ่มช่อง ads_web_conversion_data_export_scope
ในประเภท AttributionSettings
แล้ว
เพิ่มช่อง ads_web_conversion_data_export_scope
ลงในประเภท AttributionSettings
ซึ่งแก้ไขได้โดยใช้เมธอด UpdateAttributionSettings
2023-06-2023 การเลิกใช้งานรูปแบบการระบุแหล่งที่มาแบบคลิกแรก เชิงเส้น ลดลงตามเวลา และตามตำแหน่ง
ตั้งแต่เดือนมิถุนายน 2023 คุณจะไม่สามารถใช้วิธี UpdateAttributionSettings เพื่อกำหนดค่าพร็อพเพอร์ตี้ GA4 ด้วยรูปแบบการระบุแหล่งที่มาแบบคลิกแรก เชิงเส้น ลดลงตามเวลา และตามตำแหน่ง ตั้งแต่เดือนกันยายน 2023 เป็นต้นไป โมเดลเหล่านี้จะใช้ไม่ได้กับพร็อพเพอร์ตี้บางรายการ
โปรดดูข้อมูลเพิ่มเติมในประกาศเกี่ยวกับผลิตภัณฑ์ Google Analytics
31-05-2023 เพิ่มวิธีจัดการลิงก์ AdSense
เพิ่ม GetAdSenseLink
,
CreateAdSenseLink
,
DeleteAdSenseLink
,
ListAdSenseLinks
เมธอดลงใน Admin API v1alpha แล้ว
ฟังก์ชันการทํางานนี้จะช่วยให้จัดการลิงก์ AdSense กับ Analytics สําหรับพร็อพเพอร์ตี้ GA4 ได้
31-05-2023 เพิ่มวิธีการค้นหาพร็อพเพอร์ตี้ GA4 ที่เชื่อมต่อแล้ว
เพิ่มเมธอด FetchConnectedGa4Property
ไปยัง Admin API v1alpha แล้ว
ฟังก์ชันการทำงานนี้ช่วยให้คุณได้รับข้อมูลเกี่ยวกับพร็อพเพอร์ตี้ GA4 ที่ลิงก์กับพร็อพเพอร์ตี้ Universal Analytics ในระหว่างกระบวนการย้ายข้อมูล GA4
31-05-2023 เพิ่มวิธีจัดการกฎการสร้างเหตุการณ์
เพิ่มเมธอด CreateEventCreateRule
,
UpdateEventCreateRule
,
DeleteEventCreateRule
,
ListEventCreateRules
,
GetEventCreateRule
ลงใน Admin API เวอร์ชัน 1alpha
ฟังก์ชันนี้ช่วยให้คุณจัดการกฎการสร้างเหตุการณ์ได้ ซึ่งจะทริกเกอร์ให้สร้างเหตุการณ์ใหม่ทั้งหมดโดยอิงตามเกณฑ์ที่ตรงกันของเหตุการณ์แหล่งที่มา
31-05-2023 เพิ่มวิธีการในการจัดการ Channel Group ที่กําหนดเอง
เพิ่มเมธอด GetChannelGroup
,
ListChannelGroups
,
CreateChannelGroup
,
UpdateChannelGroup
,
DeleteChannelGroup
ลงใน Admin API เวอร์ชัน 1alpha แล้ว
ฟังก์ชันการทำงานนี้จะช่วยให้คุณจัดการ Channel Group ที่กําหนดเองสําหรับแหล่งที่มาของการเข้าชมเว็บไซต์ได้
เมื่อสร้างแล้ว คุณจะค้นหากลุ่มแชแนลที่กำหนดเองได้โดยใช้ Google Analytics Data API v1
31-03-2023 เพิ่มวิธีการจัดการการตั้งค่าการวัดที่ปรับปรุงแล้ว
เพิ่มเมธอด properties.dataStreams.updateEnhancedMeasurementSettings
, properties.dataStreams.getEnhancedMeasurementSettings
ลงใน Admin API v1alpha
ฟังก์ชันการทํางานนี้จะช่วยให้จัดการการตั้งค่าการวัดที่ปรับปรุงแล้วสําหรับสตรีมข้อมูลเว็บของพร็อพเพอร์ตี้ GA4 ได้
31-03-2023 เพิ่มวิธีการจัดการแท็กเว็บไซต์ที่เชื่อมต่อ
เพิ่มเมธอด properties.createConnectedSiteTag
, properties.deleteConnectedSiteTag
และ properties.listConnectedSiteTags
ลงใน Admin API v1alpha
ฟังก์ชันการทำงานนี้ช่วยให้จัดการแท็กเว็บไซต์ที่เชื่อมต่อได้ และมีประโยชน์ในการส่งต่อการเข้าชมจากพร็อพเพอร์ตี้ Universal Analytics ไปยังพร็อพเพอร์ตี้ Google Analytics 4
31-03-2023 เพิ่มบัญชีและเมธอด runAccessReport
ระดับพร็อพเพอร์ตี้ใน Admin API v1beta
เพิ่มเมธอด properties.runAccessReport
และ accounts.runAccessReport
ลงใน Admin API เวอร์ชัน v1beta เมธอดจะแสดงรายงานบันทึกการเข้าถึงข้อมูลที่กำหนดเอง
24-02-2023 เพิ่มวิธีการจัดการชุดข้อมูลแบบขยาย
เราได้เพิ่มทรัพยากร ExpandedDataSet
ไปยัง API เวอร์ชัน v1alpha พร้อมด้วยการดำเนินการ properties.expandedDataSets.create
,
properties.expandedDataSets.delete
,
properties.expandedDataSets.patch
,
properties.expandedDataSets.list
,
properties.expandedDataSets.get
ที่เกี่ยวข้อง ฟังก์ชันนี้ใช้สำหรับการจัดการชุดข้อมูลแบบขยายใน Google Analytics 360 ได้
24-02-2023 การเชื่อมโยงการเข้าถึงจะมาแทนที่ "ลิงก์ผู้ใช้" ในการจัดการสิทธิ์ของผู้ใช้
เราได้เพิ่มทรัพยากร AccessBinding
ไปยัง API เวอร์ชัน v1alpha พร้อมด้วยการดำเนินการต่อไปนี้
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
ฟังก์ชันนี้ช่วยให้จัดการสิทธิ์ของผู้ใช้สำหรับบัญชีหรือพร็อพเพอร์ตี้ GA4 ได้ และควรใช้แทนลิงก์ผู้ใช้
เราจะนำฟังก์ชันลิงก์ผู้ใช้ออกจากเวอร์ชันอัลฟ่าของ Admin API v1 ในวันที่ 1/6/23
2023-02-24 การเลิกใช้งานวิธีการตรวจสอบสิทธิ์ของผู้ใช้
เมธอดต่อไปนี้เลิกใช้งานแล้วและจะถูกนำออกจาก Admin API v1 อัลฟ่าในวันที่ 1/6/23
24-02-2023 เพิ่มวิธีการจัดการกลุ่มเป้าหมาย
เราได้เพิ่มทรัพยากร Audience
ไปยัง API เวอร์ชัน v1alpha พร้อมด้วยการดำเนินการ properties.audience.create
,
properties.audience.archive
,
properties.audience.patch
,
properties.audience.list
,
properties.audience.get
ที่เกี่ยวข้อง
ฟังก์ชันการทํางานนี้จะช่วยให้จัดการกลุ่มเป้าหมายสําหรับพร็อพเพอร์ตี้ GA4 ได้
15-02-2023 เพิ่มวิธีการเลือกไม่ใช้กระบวนการตั้งค่า GA4 อัตโนมัติ
properties.setAutomatedGa4ConfigurationOptOut
,
ระบบได้เพิ่มการดำเนินการ properties.fetchAutomatedGa4ConfigurationOptOut
ไปยัง API เวอร์ชัน v1alpha แล้ว
ซึ่งฟังก์ชันนี้ช่วยให้จัดการสถานะการเลือกไม่ใช้สําหรับขั้นตอนการตั้งค่า GA4 อัตโนมัติสําหรับพร็อพเพอร์ตี้ UA ได้
15-02-2023 เพิ่มวิธีจัดการลิงก์ BigQuery
เราได้เพิ่มทรัพยากร BigQueryLink
ไปยัง API เวอร์ชัน v1alpha พร้อมด้วยการดำเนินการ properties.bigQueryLinks.get
และ properties.bigQueryLinks.list
ที่เกี่ยวข้อง
ฟังก์ชันนี้ช่วยให้เรียกข้อมูลเกี่ยวกับลิงก์ระหว่างพร็อพเพอร์ตี้ GA4 กับโปรเจ็กต์ BigQuery ได้
15-02-2023 เพิ่มวิธีจัดการลิงก์ Search Ads 360
เราได้เพิ่มทรัพยากร SearchAds360Link
ไปยัง API เวอร์ชัน v1alpha พร้อมด้วยการดำเนินการ properties.searchAds360Links.create
,
properties.searchAds360Links.delete
,
properties.searchAds360Links.patch
,
properties.searchAds360Links.list
,
properties.searchAds360Links.get
ที่เกี่ยวข้อง
ฟังก์ชันนี้ช่วยให้คุณจัดการการลิงก์ระหว่างพร็อพเพอร์ตี้ GA4 และเอนทิตี Search Ads 360 ได้
15-02-2023 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
LESS_THAN_OR_EQUAL
นำค่าGREATER_THAN_OR_EQUAL
รายการออกจาก enum ของNumericFilter.Operation
แล้วนำค่า
PARTIAL_REGEXP
ออกจาก enum ของStringFilter.MatchType
แล้ว
15-02-2023 การเปลี่ยนแปลงเบ็ดเตล็ด
- เพิ่มช่อง
tokensPerProjectPerHour
ลงในประเภทAccessQuota
แล้ว EXPANDED_DATA_SET
เพิ่มค่าCHANNEL_GROUP
ลงใน enum ของChangeHistoryResourceType
แล้ว- เพิ่ม
searchAds360Link
,expandedDataSet
,bigqueryLink
ค่าลงในChangeHistoryResource
แล้ว
เพิ่มเมธอด runAccessReport
2022-08-2022 ลงใน Admin API v1alpha แล้ว
เพิ่มเมธอด properties.runAccessReport
ลงใน Admin API เวอร์ชัน v1alpha โดยจะแสดงรายงานที่กำหนดเองของบันทึกการเข้าถึงข้อมูล รายงานนี้จะให้ข้อมูลบันทึกในแต่ละครั้งที่ผู้ใช้อ่านข้อมูลการรายงานของ Google Analytics ผู้ดูแลระบบของพร็อพเพอร์ตี้ Google Analytics 360 สามารถใช้รายงานการเข้าถึงข้อมูลได้
11-07-2022 เปิดตัว Admin API เวอร์ชัน 1เบต้า
เปิดตัว v1beta Google Analytics Admin API
Admin API จะรองรับทั้งเวอร์ชันอัลฟ่าและเบต้าของ API ต่อไป เวอร์ชันเบต้าประกอบด้วยชุดย่อยของฟีเจอร์ที่มีในรุ่นอัลฟ่าซึ่งถือว่ามีความเสถียรและไม่คาดว่าจะมีการเปลี่ยนแปลงอย่างมีนัยสำคัญในอนาคต เราจะเพิ่มฟีเจอร์ใหม่ลงในเวอร์ชันเบต้าเมื่อเปิดตัวเต็มรูปแบบ
12-10-2021 นำเมธอด EnhancedMeasurementSettings ออกจาก API แล้ว
properties.webDataStreams.getEnhancedMeasurementSettings
, ระบบจะนำเมธอดproperties.webDataStreams.updateEnhancedMeasurementSettings
รายการออกจาก API แต่คุณจะแก้ไขการตั้งค่าการวัดที่ปรับปรุงแล้วได้อีกครั้งผ่าน API ในเร็วๆ นี้- ช่อง
directRoles
ของทรัพยากรUserLink
ไม่รองรับบทบาทpredefinedRoles/manage-users
อีกต่อไป คุณควรใช้บทบาทpredefinedRoles/admin
ใหม่แทน ซึ่งเทียบเท่ากับชุดค่าผสมของบทบาทpredefinedRoles/edit
และpredefinedRoles/manage-users
เดิม การเปลี่ยนแปลงนี้ส่งผลต่อลักษณะการทํางานของเมธอดaccounts.userLinks
,properties.userLinks
และสอดคล้องกับการเปลี่ยนแปลงการจัดการการเข้าถึงและข้อจํากัดด้านข้อมูล ที่เริ่มใช้ใน Google Analytics
2021-06-2021 เพิ่มฟีเจอร์แล้ว
มีการเพิ่มฟีเจอร์ต่อไปนี้ใน API
- เพิ่มเมธอด
accounts.searchChangeHistoryEvents
ลงใน API แล้ว วิธีการนี้จะค้นหาการเปลี่ยนแปลงทั้งหมดที่เกิดขึ้นกับบัญชีหรือระดับย่อยในบัญชีตามชุดตัวกรองที่ระบุ สาเหตุที่พบบ่อยคือการอัปเดตใน UI ของ Google Analytics, การเปลี่ยนแปลงจากฝ่ายสนับสนุนลูกค้า หรือการเปลี่ยนแปลงระบบ Google Analytics อัตโนมัติ - เพิ่มวิธีการจัดการข้อมูลลับของ Measurement Protocol ในส่วน
properties.webDataStreams.measurementProtocolSecrets
แล้ว - วิธีจัดการเหตุการณ์ Conversion ที่เพิ่มในส่วน
properties.conversionEvents
- วิธีการจัดการมิติข้อมูลที่กำหนดเองซึ่งเพิ่มในส่วน
properties.customDimensions
มีดังนี้ - วิธีการจัดการเมตริกที่กำหนดเองที่เพิ่มไว้ใน
properties.customMetrics
: - เพิ่มเมธอด
properties.getGoogleSignalsSettings
,properties.updateGoogleSignalsSettings
ที่อนุญาตการควบคุมการตั้งค่า Google Signals สําหรับพร็อพเพอร์ตี้ Google Analytics 4 delete_time
,expire_time
ช่องเอาต์พุตเฉพาะที่เพิ่มไว้ในประเภทProperty
05-06-2021 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
เราได้เปิดตัวการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบต่อไปนี้
properties.iosAppDataStreams.create
มีการนำเมธอดproperties.androidAppDataStreams.create
ออกจาก API โปรดใช้ Firebase เพื่อสร้างสตรีมแอปพลิเคชันในพร็อพเพอร์ตี้ Google Analytics 4- ตอนนี้เมธอด
properties.delete
จะแสดงผลข้อมูลพร็อพเพอร์ตี้ที่ลบไปแล้วเป็นประเภทProperty
แทนที่จะส่งคืนการตอบกลับที่ว่างเปล่า - ตอนนี้คุณต้องระบุข้อมูลในช่อง
time_zone
ของประเภทProperty
- นำช่อง
deleted
ออกจากประเภทProperty
- ช่อง
email_address
ของประเภทUserLink
จะเปลี่ยนแปลงไม่ได้แล้ว - ช่อง
name
ของประเภทUserLink
จะแสดงเพียงเอาต์พุตเท่านั้น
28-01-2021 เพิ่มการรองรับการใส่เลขหน้าสำหรับการดำเนินการ ListFirebaseLinks
28-01-2021 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ:
- ต้องระบุช่อง update_mask
สำหรับการดำเนินการอัปเดตทั้งหมด
ช่อง
country_code
เปลี่ยนชื่อเป็นregion_code
ในAccount
แล้วช่อง
url_query_parameter
เปลี่ยนชื่อเป็นuri_query_parameter
ในEnhancedMeasurementSettings
แล้วนำช่อง
parent
ออกจากGoogleAdsLink
แล้ว
20-10-2020 เพิ่มการรองรับข้อมูลสรุปบัญชี
เพิ่มการสนับสนุนสำหรับเมธอดสรุปบัญชี
13-10-2020 พร็อพเพอร์ตี้แอป + เว็บเปลี่ยนชื่อเป็น Google Analytics 4 (GA4)
15-08-2020 Management App + Web API เปลี่ยนชื่อเป็น Admin API
เราได้เปลี่ยนชื่อ API แอป + เว็บการจัดการ Google Analytics เป็น Google Analytics Admin API ดังนั้นปลายทาง API ได้เปลี่ยนเป็น analyticsadmin.googleapis.com โค้ดที่มีอยู่ซึ่งเขียนโดยเทียบกับ URL ปลายทางของ API เวอร์ชันก่อนหน้าและไลบรารีไคลเอ็นต์ให้สอดคล้องกัน