เราอัปเดต Management API ของ Google Analytics เป็นระยะๆ เพื่อแสดงฟีเจอร์ใหม่ๆ และซ่อมแซมข้อบกพร่องที่พบในเวอร์ชันก่อนหน้า ในกรณีส่วนใหญ่ การเปลี่ยนแปลงเหล่านี้จะมีความโปร่งใสต่อนักพัฒนาแอป API แต่บางครั้งเราจำเป็นต้องทำการเปลี่ยนแปลงที่ทำให้นักพัฒนาซอฟต์แวร์ต้องแก้ไขแอปพลิเคชันที่มีอยู่
หน้านี้บันทึกการเปลี่ยนแปลงที่เกิดขึ้นกับ Google Analytics Management API ที่อาจส่งผลกระทบต่อแอปพลิเคชันของคุณ เราขอแนะนำให้นักพัฒนา API ตรวจสอบรายการนี้เป็นระยะเพื่อดูประกาศใหม่ คุณยังติดตามการเปลี่ยนแปลงผ่านฟีดที่แสดงในส่วนติดตามด้านล่างได้ด้วย
สมัครรับข้อมูลบันทึกการเปลี่ยนแปลงที่เกี่ยวข้อง
มี API คอลเล็กชัน การกำหนดค่า และการรายงานทั้งหมด
รวม Management API และ API การจัดเตรียมข้อมูล
รุ่น 17-07-2018 (17 กรกฎาคม 2018)
เพิ่มเมธอดแฮชไคลเอ็นต์Id ลงใน API การจัดการแล้ว
เมธอด hashClientId จะให้แฮชของรหัสไคลเอ็นต์ดังกล่าว ซึ่งพบได้ในรูปแบบข้อมูลที่ส่งออกบางรูปแบบ เช่น ในข้อมูล Google Analytics ที่ส่งออกไปยัง BigQuery
รุ่น 11-05-2018 (11 พฤษภาคม 2018)
การตั้งค่าการเก็บรักษาข้อมูลผู้ใช้ใน Management API
ตอนนี้คุณสามารถกําหนดค่าการตั้งค่าการเก็บรักษาข้อมูลผู้ใช้แบบเป็นโปรแกรมได้โดยใช้ช่อง "dataStorageTtl" และ "dataStorageรีเซ็ตOnNewActivity" ไปยังทรัพยากร WebProperty
รุ่น 2018-02-20 (22 กุมภาพันธ์ 2018)
การดำเนินการเขียนใน Management API
การดำเนินการเขียนใน API การจัดการ (เช่น สร้าง อัปเดต ลบ แพตช์) สำหรับพร็อพเพอร์ตี้เว็บ ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) และทรัพยากรเป้าหมายไม่ต้องการรายการที่อนุญาตพิเศษอีกต่อไป ขีดจำกัดรายวันเริ่มต้นสำหรับการดำเนินการเขียนทั้งหมดใน API การจัดการคือการเขียน 50 รายการ/วัน โปรดดูข้อมูลเพิ่มเติมในหน้าขีดจำกัดและโควต้า
รุ่น 2017-04-19 (19 เมษายน 2017)
กลุ่มเป้าหมายรีมาร์เก็ตติ้ง - การสนับสนุน Optimize
รุ่นนี้เพิ่มการรองรับ Google Optimize OPTIMIZE
เป็นประเภทบัญชีโฆษณาที่ลิงก์ ดูรายละเอียดได้ที่เอกสารอ้างอิงผู้ชมรีมาร์เก็ตติ้งและคู่มือนักพัฒนาซอฟต์แวร์กลุ่มเป้าหมายรีมาร์เก็ตติ้ง
รุ่น 2017-03-20 (23 มีนาคม 2017)
กลุ่มเป้าหมายรีมาร์เก็ตติ้ง
รุ่นนี้เพิ่มคำกริยา DELETE
ลงในทรัพยากรกลุ่มเป้าหมายรีมาร์เก็ตติ้ง ดูรายละเอียดได้ที่คู่มือนักพัฒนาซอฟต์แวร์กลุ่มเป้าหมายรีมาร์เก็ตติ้ง
- กลุ่มเป้าหมายรีมาร์เก็ตติ้ง: ลบ - ลบกลุ่มเป้าหมายรีมาร์เก็ตติ้ง
รุ่น 2017-02-09 (9 กุมภาพันธ์ 2017)
เมตริกที่กำหนดเอง
รุ่นนี้เป็นรุ่นที่มีการแก้ไขข้อบกพร่อง ซึ่งจะแก้ไขปัญหาการสร้างเมตริกที่กำหนดเองประเภท TIME
ไม่สำเร็จเมื่อไม่ได้ตั้งค่า min_value
ตอนนี้คําขอที่ไม่มี min_value
จะสร้างเมตริกที่กําหนดเองซึ่งมี min_value
เริ่มต้นเป็น 0
รุ่น 2016-08-09 (9 สิงหาคม 2016)
สกุลเงิน
เวอร์ชันนี้เป็นการแก้ไขข้อบกพร่อง ซึ่งจะแก้ไขปัญหาที่เว็บอินเทอร์เฟซ Analytics รองรับสกุลเงินบางส่วน แต่ไม่รองรับใน API รุ่นนี้เพิ่มการรองรับสกุลเงินต่อไปนี้
- UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL
ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลอ้างอิงการดู (โปรไฟล์) - บทความในศูนย์ช่วยเหลือเกี่ยวกับข้อมูลอ้างอิงสกุลเงิน
รุ่น 2016-08-08 (8 สิงหาคม 2016)
รุ่นนี้จะเพิ่มกลุ่มเป้าหมายรีมาร์เก็ตติ้งลงใน Management API
ผู้ชมรีมาร์เก็ตติ้ง
Management API ช่วยให้คุณcreate
get
list
update
และpatch
กลุ่มเป้าหมายรีมาร์เก็ตติ้งสำหรับพร็อพเพอร์ตี้ Google Analytics ได้ หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของกลุ่มเป้าหมายรีมาร์เก็ตติ้ง โปรดอ่านบทความเกี่ยวกับกลุ่มเป้าหมายรีมาร์เก็ตติ้งใน Analytics ในศูนย์ช่วยเหลือ
รุ่น 2016-03-11 (11 มีนาคม 2016)
นำแสดงโดย
รุ่นนี้เพิ่มพร็อพเพอร์ตี้ starred
ลงในข้อมูลสรุปบัญชี บัญชี พร็อพเพอร์ตี้เว็บ และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
รุ่น 25-02-2016 (25 กุมภาพันธ์ 2016)
การจำกัดอัตราข้อผิดพลาด
เรากำหนดนโยบายมาโดยตลอดว่านักพัฒนาแอปควรใช้ Exponential Backoff เมื่อจัดการกับคำตอบ 500 หรือ 503 วันนี้เราขอแนะนำขีดจำกัดอัตราคำขอสำหรับข้อผิดพลาด 500 และ 503 เพื่อบังคับใช้นโยบายนี้
- คำขอการเขียนที่ล้มเหลว 50 รายการต่อชั่วโมง
รุ่น 2016-02-01 (1 กุมภาพันธ์ 2016)
รายงานแบบไม่สุ่มตัวอย่าง
API รายงานที่ไม่ได้เก็บตัวอย่างไม่มีขีดจำกัด 100 รายงานต่อวันอีกต่อไป API ใช้ระบบโทเค็นต่อพร็อพเพอร์ตี้ ต่อวัน เดียวกันกับเมื่อสร้างรายงานที่ไม่ได้เก็บตัวอย่างผ่านอินเทอร์เฟซเว็บ
รุ่น 26-01-2016 (26 มกราคม 2016)
รายงานแบบไม่สุ่มตัวอย่าง
รายงานที่ไม่ได้เก็บตัวอย่างที่ผู้ใช้ปัจจุบันไม่สามารถเข้าถึงได้จะไม่มีลิงก์ดาวน์โหลดภายในข้อความตอบกลับของ Management API อีกต่อไป การทำงานในลักษณะนี้สอดคล้องกับฟังก์ชันแดชบอร์ดของ UI ที่เฉพาะเจ้าของรายงานเท่านั้นที่จะเห็นลิงก์ดาวน์โหลดเอกสารที่สร้างขึ้น
รุ่น 17-12-2015 (17 ธันวาคม 2015)
ยอดดู (โปรไฟล์)
รุ่นนี้เพิ่มพร็อพเพอร์ตี้ botFilteringEnabled
ไปยังแหล่งข้อมูลข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) พร็อพเพอร์ตี้นี้ระบุว่ามีการเปิดใช้การกรองบ็อตสำหรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) หรือไม่ ดูรายละเอียดได้ที่ดูเอกสารอ้างอิง (โปรไฟล์)
รายงานแบบไม่สุ่มตัวอย่าง
รุ่นนี้เพิ่มเมธอด delete
ในรายงานที่ไม่ได้เก็บตัวอย่าง โปรดดูรายละเอียดในรายงานที่ไม่ได้เก็บตัวอย่างการลบเอกสารอ้างอิง
รุ่น 2015-11-17 (17 พฤศจิกายน 2015)
กลุ่ม
รุ่นนี้เป็นรุ่นที่มีการแก้ไขข้อบกพร่อง รุ่นนี้ได้แก้ไขปัญหาที่ทำให้กลุ่มที่มีค่าสกุลเงินในคำจำกัดความแสดงอย่างไม่ถูกต้องเมื่อเรียกใช้วิธีการแสดงรายการกลุ่ม
รุ่น 06-10-2015 (6 ตุลาคม 2015)
กลุ่ม
รุ่นนี้เป็นรุ่นที่มีการแก้ไขข้อบกพร่อง รุ่นนี้แก้ไขปัญหาที่จะทำให้ผู้ใช้ที่มีกลุ่มส่วนตัวปักหมุดอยู่ในข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) หลายรายการได้รับการตอบกลับข้อผิดพลาด 500
เมื่อเรียกใช้วิธีการแสดงรายการกลุ่ม
รุ่น 2015-09-03 (3 กันยายน 2015)
รวมกลุ่ม
นอกเหนือจากการรองรับกลุ่มทั่วไปแล้ว เราได้เพิ่มการสนับสนุนพิเศษสำหรับ User Permissions API ในรุ่นนี้ด้วย คำขอสิทธิ์ของผู้ใช้แบบกลุ่มจะได้รับประสิทธิภาพที่ดีขึ้นอย่างมากและการใช้โควต้าลดลง
รุ่น 2015-08-06 (6 สิงหาคม 2015)
ยอดดู (โปรไฟล์)
ในรุ่นนี้ พร็อพเพอร์ตี้ View (Profile) currency
จะมีค่าเริ่มต้นเป็น USD หากไม่ได้ตั้งค่าไว้ในระหว่างการดำเนินการ insert นอกจากนี้ การดำเนินการ get
และ list
จะแสดงผลเป็น USD สำหรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่สร้างขึ้นก่อนหน้านี้โดยไม่มีพร็อพเพอร์ตี้ currency
-
โปรดดูคู่มือนักพัฒนาซอฟต์แวร์การดู (โปรไฟล์) สำหรับรายละเอียดเกี่ยวกับการใช้ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ใน Management API
-
โปรดดูรายการพารามิเตอร์ทั้งหมดของแหล่งข้อมูลข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ในข้อมูลอ้างอิงมุมมอง (โปรไฟล์)
รุ่น 2015-05-28 (28 พฤษภาคม 2015)
ฟิลเตอร์
รุ่นนี้เป็นการนำช่องตัวกรอง IS_MOBILE
และ IS_TABLET
ที่เลิกใช้งานแล้วออกครั้งสุดท้าย ซึ่งควรแทนที่ด้วย DEVICE_CATEGORY=mobile
และ DEVICE_CATEGORY=tablet
คำขอแทรก อัปเดต และแพตช์ซึ่งตั้งค่าช่องตัวกรองให้ใช้ IS_MOBILE
และ IS_TABLET
จะแสดงข้อผิดพลาด
-
โปรดดูคู่มือนักพัฒนาซอฟต์แวร์การกรองสำหรับรายละเอียดเกี่ยวกับการใช้ตัวกรองใน Management API
-
โปรดดูรายการพารามิเตอร์ทั้งหมดของทรัพยากรตัวกรองในข้อมูลอ้างอิงตัวกรอง
รุ่น 2015-05-05 (5 พฤษภาคม 2015)
ฟิลเตอร์
รุ่นนี้เพิ่มการรองรับการใช้มิติข้อมูลที่กำหนดเองสำหรับช่องตัวกรองโดยเพิ่มพร็อพเพอร์ตี้ fieldIndex
ลงในส่วนรายละเอียดตัวกรองทั้งหมด เช่น ตอนนี้คุณสามารถตั้งค่านิพจน์ตัวกรองด้วย "field": "CUSTOM_DIMENSION"
และ "fieldIndex": "1"
เพื่อให้ตัวกรองทำงานกับมิติข้อมูลที่กำหนดเองรายการแรก
-
โปรดดูคู่มือนักพัฒนาซอฟต์แวร์การกรองสำหรับรายละเอียดเกี่ยวกับการใช้ตัวกรองใน Management API
-
โปรดดูรายการพารามิเตอร์ทั้งหมดของทรัพยากรตัวกรองในข้อมูลอ้างอิงตัวกรอง
เป้าหมาย
เวอร์ชันนี้แก้ปัญหาได้ด้วยเมื่อสร้างเป้าหมายด้วย "comparisonValue": "0"
ไม่สำเร็จ
-
โปรดดูคู่มือนักพัฒนาซอฟต์แวร์เป้าหมายสำหรับรายละเอียดเกี่ยวกับการใช้เป้าหมายใน Management API
-
โปรดดูข้อมูลอ้างอิงเป้าหมายสำหรับรายการพารามิเตอร์ทั้งหมดของแหล่งข้อมูลเป้าหมาย
รุ่น 13-03-2015 (13 มีนาคม 2015)
การเผยแพร่นี้ถือเป็นการสิ้นสุดและการนำทรัพยากร dailyUpload
ออกครั้งสุดท้าย เราได้เลิกใช้งานทรัพยากร dailyUpload
อย่างเป็นทางการเมื่อวันที่ 20 มิถุนายน 2014 การนำเข้าข้อมูลค่าใช้จ่ายทั้งหมดควรดำเนินการโดยใช้ทรัพยากรการอัปโหลด
- โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับกระบวนการเลิกใช้งานของ Google Analytics API ในนโยบายการเลิกใช้งานข้อมูล
- โปรดดูคู่มือนักพัฒนาซอฟต์แวร์การนำเข้าข้อมูลสำหรับรายละเอียดเกี่ยวกับวิธีนำเข้าข้อมูลไปยัง Google Analytics
รุ่น 2015-01-2015 (23 มกราคม 2015)
รุ่นนี้เพิ่มคอลเล็กชันใหม่ 2 รายการใน Management API ได้แก่ มิติข้อมูลที่กำหนดเองและเมตริกที่กำหนดเอง
มิติข้อมูลและเมตริกที่กำหนดเอง
ตอนนี้คุณสร้าง แสดงรายการ รับ แพตช์ และอัปเดตมิติข้อมูลและเมตริกที่กำหนดเองด้วย Management API ได้แล้ว
รุ่น 2015-01-08 (8 มกราคม 2015)
ตอนนี้การตอบกลับเมธอด list
สำหรับคอลเล็กชันทั้งหมดมีรายการที่ว่างเปล่าสำหรับพร็อพเพอร์ตี้ items
เมื่อคอลเล็กชันไม่มีทรัพยากร ก่อนหน้านี้ พร็อพเพอร์ตี้ items
จะไม่รวมอยู่ในคำตอบ ดูรายละเอียดทั้งหมดเกี่ยวกับคำค้นหาและคำตอบสำหรับข้อมูลการกำหนดค่า Google Analytics ได้ที่เอกสารอ้างอิง API
รุ่น 2014-12-16 (16 ธันวาคม 2014)
การแก้ไขข้อบกพร่อง
- แก้ไขปัญหา 467 - ตอนนี้การรวบรวมกลุ่มจะแสดงกลุ่มที่ใช้ไวยากรณ์
dateOfSession
รุ่น 2014-11-20 (20 พฤศจิกายน 2014)
รุ่นนี้แนะนำขอบเขตใหม่สำหรับ API การจัดการของ Google Analytics - analytics.manage.users.readonly
- ดูสิทธิ์ของผู้ใช้ Google Analytics
รุ่น 2014-11-05 (5 พฤศจิกายน 2014)
มีการเพิ่มช่องตัวกรอง DEVICE_CATEGORY
ช่องใหม่ รวมถึงเลิกใช้งาน IS_MOBILE
และ IS_TABLET
แล้ว ใช้ DEVICE_CATEGORY=mobile
และ DEVICE_CATEGORY=tablet
รุ่น 29-10-2014 (29 ตุลาคม 2014)
ขณะนี้ทรัพยากรข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) มีพร็อพเพอร์ตี้ enhancedECommerceTracking
ที่บ่งชี้ว่าอีคอมเมิร์ซที่เพิ่มประสิทธิภาพเปิดใช้ (true
) หรือปิดใช้ (false
)
รุ่น 2014-06 (20 มิถุนายน 2014)
รุ่นนี้มีการนำเข้าข้อมูลประเภทใหม่และการเลิกใช้งานทรัพยากร dailyUpload
การนำเข้าข้อมูล
โปรดดูคู่มือนักพัฒนาซอฟต์แวร์การนำเข้าข้อมูลสำหรับรายละเอียดเกี่ยวกับวิธีใช้ API การจัดการเพื่อนำเข้าข้อมูลไปยังบัญชี Google Analytics ของคุณ
การอัปโหลด
- ปัจจุบันทรัพยากร
upload
รองรับการอัปโหลดประเภทต่อไปนี้- ข้อมูลแคมเปญ
- ข้อมูลเนื้อหา
- ข้อมูลค่าใช้จ่าย
- ข้อมูลผลิตภัณฑ์
- ข้อมูลการคืนเงิน
- ข้อมูลผู้ใช้
- ทรัพยากร
upload
มีเมธอดmigrateDataImport
ใหม่ในการย้ายข้อมูลค่าใช้จ่ายที่มีอยู่customDataSources
การเลิกใช้งานการอัปโหลดรายวัน
- ขณะนี้มีการเลิกใช้งานทรัพยากร
dailyUpload
แล้ว โปรดดูคู่มือการย้ายข้อมูลสำหรับรายละเอียดเกี่ยวกับการย้ายข้อมูลเพื่อใช้ฟีเจอร์การนำเข้าข้อมูล - ทรัพยากร
dailyUpload
จะทำงานต่อไปอีก 6 เดือน ซึ่งหมายความว่าระบบจะย้ายข้อมูลcustomDataSources
ที่ตั้งค่าพร็อพเพอร์ตี้uploadType
เป็นanalytics#dailyUploads
โดยอัตโนมัติและใช้ได้เฉพาะกับทรัพยากรupload
เท่านั้น - ผู้ใช้ปัจจุบันของทรัพยากร
dailyUpload
ควรอัปเดตโค้ดและย้ายข้อมูลเพื่อใช้ทรัพยากรการอัปโหลดโดยเร็วที่สุด
รุ่น 2014-05 (28 พฤษภาคม 2014)
รุ่นนี้จะมี API การกำหนดค่าใหม่ 2 รายการ
ลิงก์ AdWords
-
ลิงก์ AdWords ใน API การจัดการช่วยให้คุณสามารถสร้าง แสดงรายการ รับ อัปเดต แพตช์ และลบลิงก์ระหว่างบัญชี Google AdWords กับพร็อพเพอร์ตี้ Google Analytics และจัดการข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่ลิงก์กับข้อมูล AdWords
ฟิลเตอร์
-
ตัวกรองใน API การจัดการช่วยให้คุณสร้าง แสดงรายการ รับ อัปเดต แพตช์ และลบตัวกรองสำหรับบัญชี Google Analytics ได้ ลิงก์ตัวกรองโปรไฟล์ ช่วยให้คุณสามารถสร้าง แสดงรายการ รับ อัปเดต แก้ไข และลบลิงก์ระหว่างตัวกรองและข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)
รุ่น 2014-05-27 (27 พฤษภาคม 2014)
รายงานที่ไม่ได้เก็บตัวอย่าง: API การจัดการ
มีการเพิ่มทรัพยากรใหม่ใน Management API ชื่อรายงานที่ไม่ได้เก็บตัวอย่าง รายงานแบบไม่สุ่มตัวอย่างคือรายงานของ Google Analytics (GA) ที่สร้างขึ้นโดยใช้ข้อมูลแบบไม่สุ่มตัวอย่างปัจจุบันรายงานแบบไม่สุ่มตัวอย่างพร้อมให้บริการแก่ผู้ใช้ GA Premium เท่านั้น
- โปรดดูคู่มือนักพัฒนาซอฟต์แวร์
รุ่น 2014-04-11 (11 เมษายน 2014)
กลุ่ม: Management API v2.4 และ v3.0
มีการเปลี่ยนแปลงต่อไปนี้กับคอลเล็กชันกลุ่ม
- API รองรับกลุ่มผู้ใช้และกลุ่มลำดับแล้ว
- ตอนนี้คอลเล็กชันกลุ่มจะแสดงกลุ่มระดับเซสชันและระดับผู้ใช้ในตัวและที่กำหนดเองทั้งหมด
- ตอนนี้พร็อพเพอร์ตี้
definition
สำหรับกลุ่มจะใช้ไวยากรณ์ของกลุ่มใหม่แล้ว ซึ่งรวมถึงคำจำกัดความของกลุ่มระดับเซสชันที่มีอยู่ ซึ่งจะเปลี่ยนจากdefinition: "
เป็น" definition: "sessions::condition::
" - มีการเพิ่มพร็อพเพอร์ตี้
type
ใหม่ในทรัพยากรกลุ่มเพื่อระบุว่ากลุ่มเป็นCUSTOM
(สร้างโดยผู้ใช้ในอินเทอร์เฟซเว็บ) หรือBUILT_IN
(ซึ่งจัดหาโดย Google Analytics)
การทดสอบ
คุณใช้เมตริก AdSense ต่อไปนี้เป็นวัตถุประสงค์การเพิ่มประสิทธิภาพได้แล้ว
ga:adsenseAdsClicks
— จำนวนครั้งที่มีการคลิกโฆษณา AdSense บนเว็บไซต์ของคุณga:adsenseAdsViewed
— จำนวนโฆษณา AdSense ที่ดู หน่วยโฆษณาหนึ่งสามารถแสดงโฆษณาหลายรายการได้ga:adsenseRevenue
— รายได้ทั้งหมดจากโฆษณา AdSense
รุ่น 2014-03-25 (25 มีนาคม 2014)
คอลเล็กชันข้อมูลสรุปบัญชีใหม่
- เพิ่มคอลเล็กชัน AccountSummaries ใน Management API แล้ว และให้ข้อมูลสรุปเกี่ยวกับแต่ละบัญชี พร็อพเพอร์ตี้ และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่ผู้ใช้ที่ได้รับอนุญาตมีสิทธิ์เข้าถึงในคำขอเดียวที่รวดเร็ว ดูรายละเอียดในคู่มือนักพัฒนาซอฟต์แวร์สรุปบัญชี
รุ่น 2013-12-12 (12 ธันวาคม 2013)
มีการเปลี่ยนแปลงต่อไปนี้กับกลุ่มเริ่มต้นเนื่องจากการเลิกใช้งานมิติข้อมูล ga:isMobile
และ ga:isTablet
- เปลี่ยนชื่อกลุ่ม
gaid::-11
จากการเข้าชมบนอุปกรณ์เคลื่อนที่เป็นการเข้าชมบนอุปกรณ์เคลื่อนที่และแท็บเล็ตแล้ว คำจำกัดความของกลุ่มนี้เปลี่ยนจากga:isMobile==Yes
เป็นga:deviceCategory==mobile,ga:deviceCategory==tablet
โปรดทราบว่าga:isMobile
ได้รวมการเข้าชมบนแท็บเล็ตไว้ด้วย ซึ่งแสดงอยู่ในคำจำกัดความใหม่ หากต้องการเฉพาะการเข้าชมบนอุปกรณ์เคลื่อนที่ ยกเว้นแท็บเล็ต ให้เปลี่ยนไปใช้กลุ่มการเข้าชมบนอุปกรณ์เคลื่อนที่ใหม่ (gaid::-14
) - คำจำกัดความของกลุ่ม
gaid::-13
เปลี่ยนจากga:isTablet==Yes
เป็นga:deviceCategory==tablet
ซึ่งยังคงแสดงถึงการเข้าชมบนแท็บเล็ตต่อไป - เพิ่มกลุ่ม
gaid::-14
แล้ว ชื่อของกลุ่มคือการเข้าชมบนอุปกรณ์เคลื่อนที่ คำจำกัดความคือga:deviceCategory==mobile
รุ่น 28-10-2013 (28 ตุลาคม 2013)
แก้ไขข้อบกพร่อง:
- แก้ไขข้อมูลเขตเวลาสำหรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) แล้ว รายละเอียด: ก่อนการแก้ไข ในบางกรณีเมื่อมุมมองรายการ (โปรไฟล์) ใน API การจัดการมีการแสดงผลข้อมูลเขตเวลาที่ไม่ถูกต้องของข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ขณะนี้ ข้อมูลเขตเวลาสำหรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) สอดคล้องกับสิ่งที่ตั้งค่าในอินเทอร์เฟซผู้ดูแลระบบของ Google Analytics
รุ่น 2013-10-04 (4 ตุลาคม 2013)
การอัปโหลด (มุมมองที่กว้างขึ้น)
- ทรัพยากรการอัปโหลดใหม่จะช่วยให้สามารถอัปโหลดข้อมูลมุมมองที่กว้างขึ้น โปรดดูรายละเอียดในคู่มือนักพัฒนาซอฟต์แวร์การนำเข้าข้อมูล (อัปโหลด)
รุ่น 2013-10-03 (3 ตุลาคม 2013)
รุ่นนี้มีการดำเนินการเขียนสำหรับพร็อพเพอร์ตี้เว็บ ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) และเป้าหมาย ตลอดจนชุดทรัพยากรใหม่ 3 รายการที่เปิดใช้การจัดการสิทธิ์ของผู้ใช้
API การตั้งค่าและการกำหนดค่าบัญชี
- สร้าง อัปเดต แพตช์ และลบข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ได้แล้ว ดูรายละเอียดเกี่ยวกับวิธีใหม่ๆ ได้ที่ข้อมูลอ้างอิงการดู (โปรไฟล์)
- สามารถสร้าง อัปเดต และแพตช์ผลิตภัณฑ์และบริการบนอินเทอร์เน็ตและเป้าหมายได้แล้ว ดูรายละเอียดวิธีการใหม่ๆ ได้ที่ข้อมูลอ้างอิงเกี่ยวกับพร็อพเพอร์ตี้เว็บและข้อมูลอ้างอิงเป้าหมาย
- สามารถขอผลิตภัณฑ์และบริการบนอินเทอร์เน็ต ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) หรือเป้าหมายรายการเดียวได้ด้วยเมธอด
get
- ปัจจุบันฟีเจอร์เหล่านี้มีให้บริการเป็นตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ในรุ่นเบต้าแบบจํากัด หากสนใจลงชื่อสมัครใช้ โปรดขอสิทธิ์เข้าถึงรุ่นเบต้า
สิทธิ์ของผู้ใช้ใน Management API
- ทรัพยากร accountUserLinks ใหม่จะช่วยในการจัดการสิทธิ์ของบัญชีสําหรับผู้ใช้
- ทรัพยากร webpropertyUserLinks ใหม่ช่วยให้จัดการสิทธิ์ของพร็อพเพอร์ตี้สำหรับผู้ใช้ได้
- ทรัพยากร profileUserLinks ใหม่ช่วยให้สามารถจัดการสิทธิ์การดู (โปรไฟล์) สำหรับผู้ใช้
- สิทธิ์สำหรับผู้ใช้ที่ได้รับอนุญาตจะมีอยู่ในทรัพยากรบัญชี พร็อพเพอร์ตี้เว็บ และดู (โปรไฟล์)
- มีการเริ่มใช้ขอบเขตใหม่ซึ่งจำเป็นสำหรับการจัดการสิทธิ์ของผู้ใช้
https://www.googleapis.com/auth/analytics.manage.users
. - ดูรายละเอียดเพิ่มเติมได้ที่คู่มือการพัฒนาสิทธิ์ของผู้ใช้
รุ่น 2013-07-15 (16 กรกฎาคม 2013)
ในการเปิดตัวกลุ่มเป้าหมายใหม่ เราจะเปิดตัวการเปลี่ยนแปลงต่อไปนี้ในคอลเล็กชันกลุ่ม
- รหัสกลุ่มทั้งหมดจะเปลี่ยนจากจำนวนเต็มบวกเป็นสตริงตัวอักษรและตัวเลขคละกัน หากคุณมีรหัสกลุ่มของผู้ใช้ที่บันทึกไว้ เราขอแนะนำให้คุณอัปเดตรหัสเหล่านั้นให้ใช้รหัสใหม่
- การรวบรวมกลุ่มจะแสดงกลุ่มระดับการเข้าชมที่มีอยู่เท่านั้น ขณะนี้กลุ่มผู้เข้าชมใหม่ กลุ่มประชากรตามรุ่น และลำดับไม่ได้รับการสนับสนุนใน API
- คอลเล็กชันกลุ่มจะแสดงกลุ่มเริ่มต้นที่มีอยู่ที่มีรหัสตัวเลขเชิงลบเดียวกันต่อไป อย่างไรก็ตาม ระบบยังไม่รองรับกลุ่มเริ่มต้นใหม่ในขณะนี้
รุ่น 2013-06-05 (5 มิถุนายน 2013)
รุ่นนี้เพิ่มพร็อพเพอร์ตี้ใหม่ 2 รายการในแหล่งข้อมูลเว็บพร็อพเพอร์ตี้ ได้แก่
profileCount
- แสดงผลจำนวนโปรไฟล์ของพร็อพเพอร์ตี้ วิธีนี้จะช่วยกรองผลิตภัณฑ์และบริการที่ไม่มีโปรไฟล์ใดๆ ได้ (เช่น profileCount = 0)industryVertical
- แสดงผลประเภทธุรกิจ/หมวดหมู่อุตสาหกรรมที่เลือกไว้สำหรับพร็อพเพอร์ตี้
แก้ไขข้อบกพร่อง:
- ขณะนี้พร็อพเพอร์ตี้
eCommerceTracking
ของทรัพยากรโปรไฟล์สอดคล้องกับการตั้งค่าอีคอมเมิร์ซในส่วนผู้ดูแลระบบของอินเทอร์เฟซเว็บแล้ว แสดงผลtrue
เมื่อเปิดใช้การติดตามอีคอมเมิร์ซ และแสดงผลfalse
หากไม่
รุ่น 2013-05-08 (8 พฤษภาคม 2013)
- ตอนนี้แหล่งข้อมูลเว็บพร็อพเพอร์ตี้มีพร็อพเพอร์ตี้
level
เพื่อระบุว่าเว็บพร็อพเพอร์ตี้เป็นPREMIUM
หรือSTANDARD
รุ่น 2013-04-04 (4 เมษายน 2013)
- มีการเพิ่มปลายทางใหม่ไปยัง Management API v3 เพื่อเข้าถึงและแก้ไขทรัพยากรการทดสอบ
รุ่น 14-01-2013 (14 มกราคม 2013)
- ขณะนี้ทรัพยากรโปรไฟล์ได้รวมพร็อพเพอร์ตี้
type
เพื่อระบุว่าโปรไฟล์ได้รับการกำหนดค่าสำหรับเว็บไซต์หรือแอปหรือไม่ ค่าที่เป็นไปได้ 2 ค่า ได้แก่WEB
หรือAPP
รุ่น 2012-01 (26 มกราคม 2012)
รุ่นนี้เพิ่มการตอบกลับข้อผิดพลาดที่เป็นประโยชน์ไปยัง Management API
- มีการเพิ่มรหัสข้อผิดพลาด เหตุผล และคำอธิบายใหม่ในส่วนเนื้อหาของการตอบกลับข้อผิดพลาด API รหัสทั้งหมดได้รับการบันทึกสำหรับ Management API ทั้ง 2 เวอร์ชัน คือ เวอร์ชัน 2.4 และ เวอร์ชัน 3.0 - Management API
รุ่น 2011-12 (5 ธันวาคม 2011)
รุ่นนี้เพิ่มข้อมูล เปลี่ยนแปลงฟังก์ชันที่มีอยู่ และแก้ไขข้อบกพร่อง
ข้อมูลใหม่
- ตอนนี้การรวบรวมกลุ่มเป้าหมายขั้นสูงจะมีช่อง
segmentId
ซึ่งใช้ในพารามิเตอร์ กลุ่มของ API การส่งออกข้อมูลได้
การเปลี่ยนแปลง
-
เปลี่ยนประเภทข้อมูลของ
max-results
เป็นinteger
แล้ว -
ค่าเริ่มต้นและค่าสูงสุดสำหรับ
max-results
เปลี่ยนเป็น 1000
การแก้ไขข้อบกพร่อง
- บัญชี ผลิตภัณฑ์และบริการบนอินเทอร์เน็ต และโปรไฟล์สำหรับการทดสอบเครื่องมือเพิ่มประสิทธิภาพเว็บไซต์ของ Google จะไม่รวมอยู่ในคอลเล็กชันที่เกี่ยวข้องอีกต่อไป
รุ่น 2011-08 (29 สิงหาคม 2011)
รุ่นนี้เพิ่ม API ใหม่ 2 เวอร์ชันที่มีฟีเจอร์ใหม่มากมายและจะเลิกใช้งานเวอร์ชันเก่า การเปลี่ยนแปลงนี้ส่งผลต่อวิธีที่คุณขอและจัดการข้อมูลจาก API
เวอร์ชัน 3.0
-
นี่คือ API เวอร์ชันหลักล่าสุดของเราและไม่สามารถใช้งานร่วมกันได้แบบย้อนหลัง การพัฒนา API ในอนาคตทั้งหมดจะดำเนินการในเวอร์ชันนี้
-
ข้อมูลใหม่
- การนำเสนอเป้าหมายเหตุการณ์แบบเต็ม
- รหัสเว็บพร็อพเพอร์ตี้ภายในที่ใช้ทํา Deep Link กับอินเทอร์เฟซผู้ใช้ GA ได้
- การกำหนดค่าโปรไฟล์สำหรับหน้าเริ่มต้นและพารามิเตอร์การค้นหาเว็บไซต์
-
การเปลี่ยนแปลง
- นโยบายโควต้าใหม่
- การผสานรวมกับคอนโซล Google API เพื่อจัดการการเข้าถึง API และขอโควต้าเพิ่ม
- การรองรับ OAuth 2.0 ซึ่งเป็นวิธีให้สิทธิ์ผู้ใช้แบบใหม่ที่แนะนำ
- URL ใหม่ที่จะส่งคำขอ:
https://www.googleapis.com/analytics/v3/management/…
- การตอบสนองของ API ที่กะทัดรัดมากขึ้นโดยใช้ JSON
- ไลบรารีของไคลเอ็นต์ Google API ใหม่ที่รองรับภาษาเพิ่มเติมอีกมากมาย
- การรองรับ Google Discovery API
เวอร์ชัน 2.4
-
นี่คือการอัปเกรดเวอร์ชันย่อยที่โดยส่วนใหญ่แล้วจะเข้ากันได้กับเวอร์ชัน 2.3 ที่มีอยู่
-
การเปลี่ยนแปลง
- นโยบายโควต้าใหม่
- การผสานรวมกับคอนโซล Google API เพื่อจัดการการเข้าถึง API และขอโควต้าเพิ่ม
- การสนับสนุนอย่างต่อเนื่องสำหรับกลไกการให้สิทธิ์และ OAuth 2.0 ที่มีอยู่
- URL ใหม่ที่จะส่งคำขอ:
https://www.googleapis.com/analytics/v2.4/management/…
- คำตอบใน XML เท่านั้น
- ไม่รองรับไลบรารีของไคลเอ็นต์ Google Data JavaScript
- เอาต์พุต XML ที่สอดคล้องกับเวอร์ชัน 2.3 ดังนั้นไลบรารีของไคลเอ็นต์ Google Data อื่นๆ จะยังคงใช้งานได้ต่อไป
การเลิกใช้งาน
- เราขอประกาศการเลิกใช้งาน Management API เวอร์ชัน 2.3 เดิม โดยจะใช้งานต่อไปเป็นเวลา 2 เดือน โดยหลังจากนั้นคำขอเวอร์ชัน 2.3 ทั้งหมดจะแสดงการตอบกลับเวอร์ชัน 2.4
รุ่น 2010-08 (18 สิงหาคม 2010)
นี่คือ Google Analytics Management API รุ่นเบต้า
ฟีดใหม่
-
เราได้สร้างฟีดใหม่ 5 รายการเพื่อให้เข้าถึงข้อมูลการกําหนดค่าบัญชี Google Analytics ได้ง่ายขึ้น ดังนี้
ไลบรารีของไคลเอ็นต์ที่อัปเดต
- Management API จะเปิดตัวในไลบรารีเดียวกันกับ API การส่งออกข้อมูลของ Google Analytics ทั้งไลบรารี Google Data Java และ JavaScript ได้รับการอัปเดตแล้ว แต่ละฟีดจะเข้าถึงได้โดยการระบุ URI ฟีดที่เหมาะสมให้กับเมธอด
getManagementFeed()
ของไลบรารี
เอกสารใหม่
- มีการสร้างส่วนใหม่ของเอกสารสำหรับนักพัฒนาซอฟต์แวร์ Google Analytics เพื่ออธิบายวิธีการทำงานของ API การจัดการใหม่