บันทึกการเปลี่ยนแปลง API การจัดการของ Google Analytics

เราอัปเดต Management API ของ Google Analytics เป็นระยะๆ เพื่อแสดงฟีเจอร์ใหม่ๆ และซ่อมแซมข้อบกพร่องที่พบในเวอร์ชันก่อนหน้า ในกรณีส่วนใหญ่ การเปลี่ยนแปลงเหล่านี้จะมีความโปร่งใสต่อนักพัฒนาแอป API แต่บางครั้งเราจำเป็นต้องทำการเปลี่ยนแปลงที่ทำให้นักพัฒนาซอฟต์แวร์ต้องแก้ไขแอปพลิเคชันที่มีอยู่

หน้านี้บันทึกการเปลี่ยนแปลงที่เกิดขึ้นกับ Google Analytics Management API ที่อาจส่งผลกระทบต่อแอปพลิเคชันของคุณ เราขอแนะนำให้นักพัฒนา API ตรวจสอบรายการนี้เป็นระยะเพื่อดูประกาศใหม่ คุณยังติดตามการเปลี่ยนแปลงผ่านฟีดที่แสดงในส่วนติดตามด้านล่างได้ด้วย

สมัครรับข้อมูลบันทึกการเปลี่ยนแปลงที่เกี่ยวข้อง

บันทึกการเปลี่ยนแปลง API ของ Google Analytics ทั้งหมด
–
สมัครใช้บริการ rss

มี API คอลเล็กชัน การกำหนดค่า และการรายงานทั้งหมด

บันทึกการเปลี่ยนแปลงของ API การกำหนดค่าทั้งหมด
–
สมัครใช้บริการ rss

รวม Management API และ API การจัดเตรียมข้อมูล

บันทึกการเปลี่ยนแปลงของ Management API
–
สมัครใช้บริการ rss

การตั้งค่าการเก็บรักษาข้อมูลผู้ใช้ใน Management API

ตอนนี้คุณสามารถกําหนดค่าการตั้งค่าการเก็บรักษาข้อมูลผู้ใช้แบบเป็นโปรแกรมได้โดยใช้ช่อง "dataStorageTtl" และ "dataStorageรีเซ็ตOnNewActivity" ไปยังทรัพยากร WebProperty

การดำเนินการเขียนใน Management API

การดำเนินการเขียนใน API การจัดการ (เช่น สร้าง อัปเดต ลบ แพตช์) สำหรับพร็อพเพอร์ตี้เว็บ ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) และทรัพยากรเป้าหมายไม่ต้องการรายการที่อนุญาตพิเศษอีกต่อไป ขีดจำกัดรายวันเริ่มต้นสำหรับการดำเนินการเขียนทั้งหมดใน API การจัดการคือการเขียน 50 รายการ/วัน โปรดดูข้อมูลเพิ่มเติมในหน้าขีดจำกัดและโควต้า

กลุ่มเป้าหมายรีมาร์เก็ตติ้ง - การสนับสนุน Optimize

รุ่นนี้เพิ่มการรองรับ Google Optimize OPTIMIZE เป็นประเภทบัญชีโฆษณาที่ลิงก์ ดูรายละเอียดได้ที่เอกสารอ้างอิงผู้ชมรีมาร์เก็ตติ้งและคู่มือนักพัฒนาซอฟต์แวร์กลุ่มเป้าหมายรีมาร์เก็ตติ้ง

กลุ่มเป้าหมายรีมาร์เก็ตติ้ง

รุ่นนี้เพิ่มคำกริยา DELETE ลงในทรัพยากรกลุ่มเป้าหมายรีมาร์เก็ตติ้ง ดูรายละเอียดได้ที่คู่มือนักพัฒนาซอฟต์แวร์กลุ่มเป้าหมายรีมาร์เก็ตติ้ง

เมตริกที่กำหนดเอง

รุ่นนี้เป็นรุ่นที่มีการแก้ไขข้อบกพร่อง ซึ่งจะแก้ไขปัญหาการสร้างเมตริกที่กำหนดเองประเภท TIME ไม่สำเร็จเมื่อไม่ได้ตั้งค่า min_value ตอนนี้คําขอที่ไม่มี min_value จะสร้างเมตริกที่กําหนดเองซึ่งมี min_value เริ่มต้นเป็น 0

สกุลเงิน

เวอร์ชันนี้เป็นการแก้ไขข้อบกพร่อง ซึ่งจะแก้ไขปัญหาที่เว็บอินเทอร์เฟซ Analytics รองรับสกุลเงินบางส่วน แต่ไม่รองรับใน API รุ่นนี้เพิ่มการรองรับสกุลเงินต่อไปนี้

  • UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL

ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลอ้างอิงการดู (โปรไฟล์) - บทความในศูนย์ช่วยเหลือเกี่ยวกับข้อมูลอ้างอิงสกุลเงิน

รุ่นนี้จะเพิ่มกลุ่มเป้าหมายรีมาร์เก็ตติ้งลงใน Management API

ผู้ชมรีมาร์เก็ตติ้ง

Management API ช่วยให้คุณcreate get list update และpatchกลุ่มเป้าหมายรีมาร์เก็ตติ้งสำหรับพร็อพเพอร์ตี้ Google Analytics ได้ หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของกลุ่มเป้าหมายรีมาร์เก็ตติ้ง โปรดอ่านบทความเกี่ยวกับกลุ่มเป้าหมายรีมาร์เก็ตติ้งใน Analytics ในศูนย์ช่วยเหลือ

การจำกัดอัตราข้อผิดพลาด

เรากำหนดนโยบายมาโดยตลอดว่านักพัฒนาแอปควรใช้ Exponential Backoff เมื่อจัดการกับคำตอบ 500 หรือ 503 วันนี้เราขอแนะนำขีดจำกัดอัตราคำขอสำหรับข้อผิดพลาด 500 และ 503 เพื่อบังคับใช้นโยบายนี้

  • คำขอการเขียนที่ล้มเหลว 50 รายการต่อชั่วโมง

รายงานแบบไม่สุ่มตัวอย่าง

API รายงานที่ไม่ได้เก็บตัวอย่างไม่มีขีดจำกัด 100 รายงานต่อวันอีกต่อไป API ใช้ระบบโทเค็นต่อพร็อพเพอร์ตี้ ต่อวัน เดียวกันกับเมื่อสร้างรายงานที่ไม่ได้เก็บตัวอย่างผ่านอินเทอร์เฟซเว็บ

รายงานแบบไม่สุ่มตัวอย่าง

รายงานที่ไม่ได้เก็บตัวอย่างที่ผู้ใช้ปัจจุบันไม่สามารถเข้าถึงได้จะไม่มีลิงก์ดาวน์โหลดภายในข้อความตอบกลับของ Management API อีกต่อไป การทำงานในลักษณะนี้สอดคล้องกับฟังก์ชันแดชบอร์ดของ UI ที่เฉพาะเจ้าของรายงานเท่านั้นที่จะเห็นลิงก์ดาวน์โหลดเอกสารที่สร้างขึ้น

ยอดดู (โปรไฟล์)

รุ่นนี้เพิ่มพร็อพเพอร์ตี้ botFilteringEnabled ไปยังแหล่งข้อมูลข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) พร็อพเพอร์ตี้นี้ระบุว่ามีการเปิดใช้การกรองบ็อตสำหรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) หรือไม่ ดูรายละเอียดได้ที่ดูเอกสารอ้างอิง (โปรไฟล์)

รายงานแบบไม่สุ่มตัวอย่าง

รุ่นนี้เพิ่มเมธอด delete ในรายงานที่ไม่ได้เก็บตัวอย่าง โปรดดูรายละเอียดในรายงานที่ไม่ได้เก็บตัวอย่างการลบเอกสารอ้างอิง

กลุ่ม

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

กลุ่ม

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

รวมกลุ่ม

นอกเหนือจากการรองรับกลุ่มทั่วไปแล้ว เราได้เพิ่มการสนับสนุนพิเศษสำหรับ User Permissions API ในรุ่นนี้ด้วย คำขอสิทธิ์ของผู้ใช้แบบกลุ่มจะได้รับประสิทธิภาพที่ดีขึ้นอย่างมากและการใช้โควต้าลดลง

ยอดดู (โปรไฟล์)

ในรุ่นนี้ พร็อพเพอร์ตี้ View (Profile) currency จะมีค่าเริ่มต้นเป็น USD หากไม่ได้ตั้งค่าไว้ในระหว่างการดำเนินการ insert นอกจากนี้ การดำเนินการ get และ list จะแสดงผลเป็น USD สำหรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่สร้างขึ้นก่อนหน้านี้โดยไม่มีพร็อพเพอร์ตี้ currency

ฟิลเตอร์

รุ่นนี้เป็นการนำช่องตัวกรอง IS_MOBILE และ IS_TABLET ที่เลิกใช้งานแล้วออกครั้งสุดท้าย ซึ่งควรแทนที่ด้วย DEVICE_CATEGORY=mobile และ DEVICE_CATEGORY=tablet คำขอแทรก อัปเดต และแพตช์ซึ่งตั้งค่าช่องตัวกรองให้ใช้ IS_MOBILE และ IS_TABLET จะแสดงข้อผิดพลาด

ฟิลเตอร์

รุ่นนี้เพิ่มการรองรับการใช้มิติข้อมูลที่กำหนดเองสำหรับช่องตัวกรองโดยเพิ่มพร็อพเพอร์ตี้ fieldIndex ลงในส่วนรายละเอียดตัวกรองทั้งหมด เช่น ตอนนี้คุณสามารถตั้งค่านิพจน์ตัวกรองด้วย "field": "CUSTOM_DIMENSION" และ "fieldIndex": "1" เพื่อให้ตัวกรองทำงานกับมิติข้อมูลที่กำหนดเองรายการแรก

เป้าหมาย

เวอร์ชันนี้แก้ปัญหาได้ด้วยเมื่อสร้างเป้าหมายด้วย "comparisonValue": "0" ไม่สำเร็จ

การเผยแพร่นี้ถือเป็นการสิ้นสุดและการนำทรัพยากร dailyUpload ออกครั้งสุดท้าย เราได้เลิกใช้งานทรัพยากร dailyUpload อย่างเป็นทางการเมื่อวันที่ 20 มิถุนายน 2014 การนำเข้าข้อมูลค่าใช้จ่ายทั้งหมดควรดำเนินการโดยใช้ทรัพยากรการอัปโหลด

รุ่นนี้เพิ่มคอลเล็กชันใหม่ 2 รายการใน Management API ได้แก่ มิติข้อมูลที่กำหนดเองและเมตริกที่กำหนดเอง

มิติข้อมูลและเมตริกที่กำหนดเอง

ตอนนี้คุณสร้าง แสดงรายการ รับ แพตช์ และอัปเดตมิติข้อมูลและเมตริกที่กำหนดเองด้วย Management API ได้แล้ว

ตอนนี้การตอบกลับเมธอด list สำหรับคอลเล็กชันทั้งหมดมีรายการที่ว่างเปล่าสำหรับพร็อพเพอร์ตี้ items เมื่อคอลเล็กชันไม่มีทรัพยากร ก่อนหน้านี้ พร็อพเพอร์ตี้ items จะไม่รวมอยู่ในคำตอบ ดูรายละเอียดทั้งหมดเกี่ยวกับคำค้นหาและคำตอบสำหรับข้อมูลการกำหนดค่า Google Analytics ได้ที่เอกสารอ้างอิง API

มีการเพิ่มช่องตัวกรอง DEVICE_CATEGORY ช่องใหม่ รวมถึงเลิกใช้งาน IS_MOBILE และ IS_TABLET แล้ว ใช้ DEVICE_CATEGORY=mobile และ DEVICE_CATEGORY=tablet

รุ่นนี้มีการนำเข้าข้อมูลประเภทใหม่และการเลิกใช้งานทรัพยากร dailyUpload

การนำเข้าข้อมูล

โปรดดูคู่มือนักพัฒนาซอฟต์แวร์การนำเข้าข้อมูลสำหรับรายละเอียดเกี่ยวกับวิธีใช้ API การจัดการเพื่อนำเข้าข้อมูลไปยังบัญชี Google Analytics ของคุณ

การอัปโหลด

  • ปัจจุบันทรัพยากร upload รองรับการอัปโหลดประเภทต่อไปนี้
    • ข้อมูลแคมเปญ
    • ข้อมูลเนื้อหา
    • ข้อมูลค่าใช้จ่าย
    • ข้อมูลผลิตภัณฑ์
    • ข้อมูลการคืนเงิน
    • ข้อมูลผู้ใช้
  • ทรัพยากร upload มีเมธอด migrateDataImport ใหม่ในการย้ายข้อมูลค่าใช้จ่ายที่มีอยู่customDataSources

การเลิกใช้งานการอัปโหลดรายวัน

  • ขณะนี้มีการเลิกใช้งานทรัพยากร dailyUpload แล้ว โปรดดูคู่มือการย้ายข้อมูลสำหรับรายละเอียดเกี่ยวกับการย้ายข้อมูลเพื่อใช้ฟีเจอร์การนำเข้าข้อมูล
  • ทรัพยากร dailyUpload จะทำงานต่อไปอีก 6 เดือน ซึ่งหมายความว่าระบบจะย้ายข้อมูล customDataSources ที่ตั้งค่าพร็อพเพอร์ตี้ uploadType เป็น analytics#dailyUploads โดยอัตโนมัติและใช้ได้เฉพาะกับทรัพยากร upload เท่านั้น
  • ผู้ใช้ปัจจุบันของทรัพยากร dailyUpload ควรอัปเดตโค้ดและย้ายข้อมูลเพื่อใช้ทรัพยากรการอัปโหลดโดยเร็วที่สุด

รุ่นนี้จะมี API การกำหนดค่าใหม่ 2 รายการ

ฟิลเตอร์

รายงานที่ไม่ได้เก็บตัวอย่าง: API การจัดการ

มีการเพิ่มทรัพยากรใหม่ใน Management API ชื่อรายงานที่ไม่ได้เก็บตัวอย่าง รายงานแบบไม่สุ่มตัวอย่างคือรายงานของ Google Analytics (GA) ที่สร้างขึ้นโดยใช้ข้อมูลแบบไม่สุ่มตัวอย่างปัจจุบันรายงานแบบไม่สุ่มตัวอย่างพร้อมให้บริการแก่ผู้ใช้ GA Premium เท่านั้น

กลุ่ม: 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

คอลเล็กชันข้อมูลสรุปบัญชีใหม่

  • เพิ่มคอลเล็กชัน AccountSummaries ใน Management API แล้ว และให้ข้อมูลสรุปเกี่ยวกับแต่ละบัญชี พร็อพเพอร์ตี้ และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่ผู้ใช้ที่ได้รับอนุญาตมีสิทธิ์เข้าถึงในคำขอเดียวที่รวดเร็ว ดูรายละเอียดในคู่มือนักพัฒนาซอฟต์แวร์สรุปบัญชี

มีการเปลี่ยนแปลงต่อไปนี้กับกลุ่มเริ่มต้นเนื่องจากการเลิกใช้งานมิติข้อมูล 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

แก้ไขข้อบกพร่อง:

  • แก้ไขข้อมูลเขตเวลาสำหรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) แล้ว รายละเอียด: ก่อนการแก้ไข ในบางกรณีเมื่อมุมมองรายการ (โปรไฟล์) ใน API การจัดการมีการแสดงผลข้อมูลเขตเวลาที่ไม่ถูกต้องของข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ขณะนี้ ข้อมูลเขตเวลาสำหรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) สอดคล้องกับสิ่งที่ตั้งค่าในอินเทอร์เฟซผู้ดูแลระบบของ Google Analytics

รุ่นนี้มีการดำเนินการเขียนสำหรับพร็อพเพอร์ตี้เว็บ ข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) และเป้าหมาย ตลอดจนชุดทรัพยากรใหม่ 3 รายการที่เปิดใช้การจัดการสิทธิ์ของผู้ใช้

API การตั้งค่าและการกำหนดค่าบัญชี

สิทธิ์ของผู้ใช้ใน Management API

  • ทรัพยากร accountUserLinks ใหม่จะช่วยในการจัดการสิทธิ์ของบัญชีสําหรับผู้ใช้
  • ทรัพยากร webpropertyUserLinks ใหม่ช่วยให้จัดการสิทธิ์ของพร็อพเพอร์ตี้สำหรับผู้ใช้ได้
  • ทรัพยากร profileUserLinks ใหม่ช่วยให้สามารถจัดการสิทธิ์การดู (โปรไฟล์) สำหรับผู้ใช้
  • สิทธิ์สำหรับผู้ใช้ที่ได้รับอนุญาตจะมีอยู่ในทรัพยากรบัญชี พร็อพเพอร์ตี้เว็บ และดู (โปรไฟล์)
  • มีการเริ่มใช้ขอบเขตใหม่ซึ่งจำเป็นสำหรับการจัดการสิทธิ์ของผู้ใช้ https://www.googleapis.com/auth/analytics.manage.users.
  • ดูรายละเอียดเพิ่มเติมได้ที่คู่มือการพัฒนาสิทธิ์ของผู้ใช้

ในการเปิดตัวกลุ่มเป้าหมายใหม่ เราจะเปิดตัวการเปลี่ยนแปลงต่อไปนี้ในคอลเล็กชันกลุ่ม

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

รุ่นนี้เพิ่มพร็อพเพอร์ตี้ใหม่ 2 รายการในแหล่งข้อมูลเว็บพร็อพเพอร์ตี้ ได้แก่

  • profileCount - แสดงผลจำนวนโปรไฟล์ของพร็อพเพอร์ตี้ วิธีนี้จะช่วยกรองผลิตภัณฑ์และบริการที่ไม่มีโปรไฟล์ใดๆ ได้ (เช่น profileCount = 0)
  • industryVertical - แสดงผลประเภทธุรกิจ/หมวดหมู่อุตสาหกรรมที่เลือกไว้สำหรับพร็อพเพอร์ตี้

แก้ไขข้อบกพร่อง:

  • ขณะนี้พร็อพเพอร์ตี้ eCommerceTracking ของทรัพยากรโปรไฟล์สอดคล้องกับการตั้งค่าอีคอมเมิร์ซในส่วนผู้ดูแลระบบของอินเทอร์เฟซเว็บแล้ว แสดงผล true เมื่อเปิดใช้การติดตามอีคอมเมิร์ซ และแสดงผล false หากไม่
  • มีการเพิ่มปลายทางใหม่ไปยัง Management API v3 เพื่อเข้าถึงและแก้ไขทรัพยากรการทดสอบ
  • ขณะนี้ทรัพยากรโปรไฟล์ได้รวมพร็อพเพอร์ตี้ type เพื่อระบุว่าโปรไฟล์ได้รับการกำหนดค่าสำหรับเว็บไซต์หรือแอปหรือไม่ ค่าที่เป็นไปได้ 2 ค่า ได้แก่ WEB หรือ APP

รุ่นนี้เพิ่มการตอบกลับข้อผิดพลาดที่เป็นประโยชน์ไปยัง Management API

  • มีการเพิ่มรหัสข้อผิดพลาด เหตุผล และคำอธิบายใหม่ในส่วนเนื้อหาของการตอบกลับข้อผิดพลาด API รหัสทั้งหมดได้รับการบันทึกสำหรับ Management API ทั้ง 2 เวอร์ชัน คือ เวอร์ชัน 2.4 และ เวอร์ชัน 3.0 - Management API

รุ่นนี้เพิ่มข้อมูล เปลี่ยนแปลงฟังก์ชันที่มีอยู่ และแก้ไขข้อบกพร่อง

ข้อมูลใหม่

  • ตอนนี้การรวบรวมกลุ่มเป้าหมายขั้นสูงจะมีช่อง segmentId ซึ่งใช้ในพารามิเตอร์ กลุ่มของ API การส่งออกข้อมูลได้

การเปลี่ยนแปลง

  • เปลี่ยนประเภทข้อมูลของ max-results เป็น integer แล้ว

  • ค่าเริ่มต้นและค่าสูงสุดสำหรับ max-results เปลี่ยนเป็น 1000

การแก้ไขข้อบกพร่อง

  • บัญชี ผลิตภัณฑ์และบริการบนอินเทอร์เน็ต และโปรไฟล์สำหรับการทดสอบเครื่องมือเพิ่มประสิทธิภาพเว็บไซต์ของ Google จะไม่รวมอยู่ในคอลเล็กชันที่เกี่ยวข้องอีกต่อไป

รุ่นนี้เพิ่ม 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

นี่คือ Google Analytics Management API รุ่นเบต้า

ฟีดใหม่

ไลบรารีของไคลเอ็นต์ที่อัปเดต

  • Management API จะเปิดตัวในไลบรารีเดียวกันกับ API การส่งออกข้อมูลของ Google Analytics ทั้งไลบรารี Google Data Java และ JavaScript ได้รับการอัปเดตแล้ว แต่ละฟีดจะเข้าถึงได้โดยการระบุ URI ฟีดที่เหมาะสมให้กับเมธอด getManagementFeed() ของไลบรารี

เอกสารใหม่

  • มีการสร้างส่วนใหม่ของเอกสารสำหรับนักพัฒนาซอฟต์แวร์ Google Analytics เพื่ออธิบายวิธีการทำงานของ API การจัดการใหม่