บันทึกการเปลี่ยนแปลง

สำหรับประกาศเกี่ยวกับ 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

เพิ่ม 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 ได้

เราได้เพิ่มทรัพยากร AccessBinding ไปยัง API เวอร์ชัน v1alpha พร้อมด้วยการดำเนินการต่อไปนี้

ฟังก์ชันนี้ช่วยให้จัดการสิทธิ์ของผู้ใช้สำหรับบัญชีหรือพร็อพเพอร์ตี้ 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 ได้

เราได้เพิ่มทรัพยากร BigQueryLink ไปยัง API เวอร์ชัน v1alpha พร้อมด้วยการดำเนินการ properties.bigQueryLinks.get และ properties.bigQueryLinks.list ที่เกี่ยวข้อง

ฟังก์ชันนี้ช่วยให้เรียกข้อมูลเกี่ยวกับลิงก์ระหว่างพร็อพเพอร์ตี้ GA4 กับโปรเจ็กต์ BigQuery ได้

เราได้เพิ่มทรัพยากร 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 แล้ว
    • create สร้างข้อมูลลับของ Measurement Protocol
    • delete ลบข้อมูลลับของ Measurement Protocol เป้าหมาย
    • get ค้นหาข้อมูลลับของ Measurement Protocol เพียง 1 รายการ
    • list แสดงผลข้อมูลลับของ Measurement Protocol ย่อยภายใต้พร็อพเพอร์ตี้ระดับบนสุดที่ระบุ
    • patch อัปเดตข้อมูลลับของ Measurement Protocol
  • วิธีจัดการเหตุการณ์ Conversion ที่เพิ่มในส่วน properties.conversionEvents
    • create สร้างเหตุการณ์ Conversion ด้วยแอตทริบิวต์ที่ระบุ
    • delete ลบกิจกรรม Conversion ในพร็อพเพอร์ตี้
    • get ดึงข้อมูลเหตุการณ์ Conversion รายการเดียว
    • list แสดงรายการเหตุการณ์ Conversion ในพร็อพเพอร์ตี้หลักที่ระบุ
  • วิธีการจัดการมิติข้อมูลที่กำหนดเองซึ่งเพิ่มในส่วน properties.customDimensions มีดังนี้
    • archive เก็บมิติข้อมูลที่กําหนดเองในพร็อพเพอร์ตี้
    • create สร้างมิติข้อมูลที่กำหนดเอง
    • get ค้นหามิติข้อมูลที่กำหนดเอง 1 รายการ
    • list แสดงรายการมิติข้อมูลที่กำหนดเองในพร็อพเพอร์ตี้
    • patch อัปเดตมิติข้อมูลที่กำหนดเองในพร็อพเพอร์ตี้
  • วิธีการจัดการเมตริกที่กำหนดเองที่เพิ่มไว้ใน properties.customMetrics:
    • archive เก็บเมตริกที่กําหนดเองในพร็อพเพอร์ตี้
    • create สร้างเมตริกที่กำหนดเองอีกครั้ง
    • get ค้นหาเมตริกที่กำหนดเองรายการเดียว
    • list แสดงรายการเมตริกที่กำหนดเองในพร็อพเพอร์ตี้
    • patch อัปเดตเมตริกที่กําหนดเองในพร็อพเพอร์ตี้
  • เพิ่มเมธอด 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 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ: - ต้องระบุช่อง 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 เวอร์ชันก่อนหน้าและไลบรารีไคลเอ็นต์ให้สอดคล้องกัน