ประวัติการแก้ไข

หน้านี้จะแสดงรายการการเปลี่ยนแปลง API และการอัปเดตเอกสารสำหรับทั้ง API การรายงาน YouTube และ YouTube Analytics API API ทั้ง 2 แบบช่วยให้นักพัฒนาซอฟต์แวร์เข้าถึงข้อมูล YouTube Analytics ได้แม้ว่าจะมีวิธีการที่แตกต่างกัน สมัครรับบันทึกการเปลี่ยนแปลงนี้ สมัครใช้บริการ

6 พฤษภาคม 2024

YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย) API รองรับรายงานใหม่ 3 แบบสำหรับช่อง ดังนี้

นอกจากนี้ช่อง กลุ่มเป้าหมาย รายงานการรักษาผู้ใช้ได้รับการปรับปรุงให้รองรับเมตริกใหม่ 3 รายการ ได้แก่

7 เมษายน 2024

API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย) มีการอัปเดตหลายรายการที่เกี่ยวข้องกับเจ้าของเนื้อหา รายงานเพลย์ลิสต์ การอัปเดตจะเหมือนกับการอัปเดตที่เกี่ยวข้องกับรายงานเพลย์ลิสต์ของช่อง ซึ่งประกาศไปเมื่อวันที่ 19 มกราคม 2024

รายการประวัติการแก้ไขต่อไปนี้จะให้ข้อมูลเกือบ ข้อมูลเดียวกับรายการจากวันที่ 19 มกราคม 2024 อย่างไรก็ตาม โปรดทราบว่าเจ้าของเนื้อหา รายงานเพลย์ลิสต์จะรองรับ isCurated มิติข้อมูลจนถึง ในวันที่ 31 ธันวาคม 2024 คุณจะสามารถใช้มิติข้อมูลสำหรับรายงานเพลย์ลิสต์ของช่องได้จนถึง 30 มิถุนายน 2024

  • หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

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

    เพื่อรักษาความเข้ากันได้แบบย้อนหลังเมื่อคุณนำ isCurated ออก คุณต้องอัปเดตโค้ดเพื่อดึงเมตริก playlistViews ด้วย แทนที่จะเป็นเมตริก views สำหรับรายงานเพลย์ลิสต์เท่านั้น นับตั้งแต่วันที่ views รายงานเพลย์ลิสต์ยังคงรองรับ แม้ว่าจะมีความหมายต่างกัน API จะ จะแสดงข้อมูลหากคุณไม่อัปเดตชื่อเมตริก แน่นอนว่าคุณสามารถแก้ไขแอปพลิเคชัน เพื่อดึงข้อมูลและแสดงทั้ง views และ playlistViews

    นอกเหนือจากมิติข้อมูล isCurated แล้ว ฟังก์ชันการทำงานของ API ต่อไปนี้ได้ด้วย ไม่ได้รับการสนับสนุนในรายงานใหม่อีกต่อไป:

    • ตัวกรองสถานที่ตั้ง เช่น continent และ subcontinent ไม่ใช่ รายงานเพลย์ลิสต์ใหม่ของช่องได้ด้วย
    • เมตริก redViews และ estimatedRedMinutesWatched ปิดลงแล้ว รายงานเพลย์ลิสต์ใหม่ของช่องได้ด้วย เมตริกเหล่านี้ยังไม่พร้อมใช้งานใน YouTube Studio ดังนั้นการเปลี่ยนแปลงนี้จะปรับฟังก์ชันของ API ให้สอดคล้องกับฟังก์ชันที่มีในแอปพลิเคชัน Studio
    • มิติข้อมูล subscribedStatus และ youtubeProduct เลิกใช้แล้ว สามารถใช้เป็นตัวกรองสำหรับรายงานเพลย์ลิสต์ของช่องได้ ตัวกรองเหล่านี้ไม่พร้อมใช้งานใน YouTube Studio ดังนั้นการเปลี่ยนแปลงนี้จึงปรับฟังก์ชันการทำงานของ API ให้สอดคล้องกับฟังก์ชันที่มีอยู่ใน แอปพลิเคชัน Studio

  • รายงานเพลย์ลิสต์ ในเอกสารประกอบของรายงานเจ้าของเนื้อหาได้รับการอัปเดตเพื่ออธิบายอย่างละเอียดมากขึ้น ประเภทของเมตริกที่สนับสนุนสำหรับรายงานเพลย์ลิสต์ ได้แก่

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

  • ระบบรองรับเมตริกในเพลย์ลิสต์ใหม่ดังต่อไปนี้สำหรับรายงานเพลย์ลิสต์สำหรับ เจ้าของเนื้อหา โปรดทราบว่าระบบจะรองรับเมตริกเหล่านี้ก็ต่อเมื่อมีคำขอ API เพื่อดึงข้อมูลเท่านั้น รายงานไม่ใช้มิติข้อมูล isCurated โปรดดู metrics สำหรับ คำจำกัดความของเมตริกแต่ละรายการ

  • ลักษณะการทำงานของ views ตอนนี้ขึ้นอยู่กับว่าคำขอ API ที่ดึงรายงานเพลย์ลิสต์นั้นใช้ มิติข้อมูลisCurated:

    • เมื่อคำขอมีมิติข้อมูล isCurated แอตทริบิวต์ มีเมตริก views อยู่ในเพลย์ลิสต์ เมตริกที่ระบุจำนวนครั้งที่มีการดูวิดีโอในบริบทของ เพลย์ลิสต์ของเจ้าของเนื้อหา
    • เมื่อคำขอไม่รวมมิติข้อมูล isCurated แอตทริบิวต์ เมตริก views คือเมตริกวิดีโอรวมที่ระบุจำนวนทั้งหมด จำนวนครั้งที่มีการดูวิดีโอในเพลย์ลิสต์ของเจ้าของเนื้อหา โดยไม่คำนึงว่า เกิดขึ้นในบริบทของเพลย์ลิสต์ จำนวนรวมรวมเฉพาะจำนวนการดู วิดีโอที่เป็นของเจ้าของเนื้อหาซึ่งเชื่อมโยงกับช่องที่เป็นเจ้าของเพลย์ลิสต์

      ในรายงานเหล่านี้ ซึ่งไม่ได้ใช้มิติข้อมูล isCurated พารามิเตอร์ เมตริก playlistViews แสดงจำนวนครั้งที่มีการดูวิดีโอ ในบริบทของเพลย์ลิสต์ โดยเมตริกดังกล่าวจะนับยอดดู ของวิดีโอทั้งหมดในเพลย์ลิสต์ ไม่ว่าช่องใดจะเป็นเจ้าของก็ตาม

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

19 มกราคม 2024

API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย) มีการอัปเดตหลายรายการที่เกี่ยวข้องกับเพลย์ลิสต์ของช่อง รายงาน การอัปเดตนี้รวมถึงมิติข้อมูลที่เลิกใช้งานแล้วและเมตริกใหม่และเมตริกที่อัปเดตหลายรายการ ดังนี้

  • หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

    isCurated เลิกใช้งานมิติข้อมูลสำหรับรายงานแชแนลแล้ว ระบบจะไม่รองรับฟีเจอร์นี้ในวันที่ หรือ หลังวันที่ 30 มิถุนายน 2024 ระบบได้อัปเดตคําจํากัดความของมิติข้อมูลดังกล่าวให้สอดคล้องกันแล้ว

    เพื่อรักษาความเข้ากันได้แบบย้อนหลังเมื่อคุณนำ isCurated ออก คุณต้องอัปเดตโค้ดเพื่อดึงเมตริก playlistViews ด้วย แทนที่จะเป็นเมตริก views สำหรับรายงานเพลย์ลิสต์เท่านั้น นับตั้งแต่วันที่ views รายงานเพลย์ลิสต์ยังคงรองรับ แม้ว่าจะมีความหมายต่างกัน API จะ จะแสดงข้อมูลหากคุณไม่อัปเดตชื่อเมตริก แน่นอนว่าคุณสามารถแก้ไขแอปพลิเคชัน เพื่อดึงข้อมูลและแสดงทั้ง views และ playlistViews

    นอกเหนือจากมิติข้อมูล isCurated แล้ว ฟังก์ชันการทำงานของ API ต่อไปนี้ได้ด้วย ไม่ได้รับการสนับสนุนในรายงานใหม่อีกต่อไป:

    • ตัวกรองสถานที่ตั้ง เช่น continent และ subcontinent ไม่ใช่ รายงานเพลย์ลิสต์ใหม่ของช่องได้ด้วย
    • เมตริก redViews และ estimatedRedMinutesWatched ปิดลงแล้ว รายงานเพลย์ลิสต์ใหม่ของช่องได้ด้วย เมตริกเหล่านี้ยังไม่พร้อมใช้งานใน YouTube Studio ดังนั้นการเปลี่ยนแปลงนี้จะปรับฟังก์ชันของ API ให้สอดคล้องกับฟังก์ชันที่มีในแอปพลิเคชัน Studio
    • มิติข้อมูล subscribedStatus และ youtubeProduct เลิกใช้แล้ว สามารถใช้เป็นตัวกรองสำหรับรายงานเพลย์ลิสต์ของช่องได้ ตัวกรองเหล่านี้ไม่พร้อมใช้งานใน YouTube Studio ดังนั้นการเปลี่ยนแปลงนี้จึงปรับฟังก์ชันการทำงานของ API ให้สอดคล้องกับฟังก์ชันที่มีอยู่ใน แอปพลิเคชัน Studio

  • รายงานเพลย์ลิสต์ ในเอกสารประกอบของรายงานแชแนลได้รับการอัปเดตเพื่ออธิบายอย่างละเอียดมากขึ้น ประเภทของเมตริกที่สนับสนุนสำหรับรายงานเพลย์ลิสต์ ได้แก่

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

  • รายงานเพลย์ลิสต์ของช่องรองรับเมตริกในเพลย์ลิสต์ใหม่ดังต่อไปนี้ รายงานเจ้าของเนื้อหายังไม่รองรับเมตริกเหล่านี้ โปรดทราบว่าเมตริกเหล่านี้ รองรับเฉพาะเมื่อคำขอ API เพื่อดึงรายงานไม่ได้ใช้เมธอด มิติข้อมูล isCurated รายการ โปรดดู metrics สำหรับ คำจำกัดความของเมตริกแต่ละรายการ

  • ลักษณะการทำงานของ views ตอนนี้ขึ้นอยู่กับว่าคำขอ API ที่ดึงรายงานเพลย์ลิสต์นั้นใช้ มิติข้อมูลisCurated:

    • เมื่อคำขอมีมิติข้อมูล isCurated แอตทริบิวต์ มีเมตริก views อยู่ในเพลย์ลิสต์ เมตริกที่ระบุจำนวนครั้งที่มีการดูวิดีโอในบริบทของ เพลย์ลิสต์ของช่อง
    • เมื่อคำขอไม่รวมมิติข้อมูล isCurated แอตทริบิวต์ เมตริก views คือเมตริกวิดีโอรวมที่ระบุจำนวนทั้งหมด จำนวนครั้งที่มีการดูวิดีโอในเพลย์ลิสต์ของช่อง โดยไม่คำนึงว่า เกิดขึ้นในบริบทของเพลย์ลิสต์ จำนวนรวมรวมเฉพาะจำนวนการดู วิดีโอที่เป็นของช่องที่เป็นเจ้าของเพลย์ลิสต์

      ในรายงานเหล่านี้ ซึ่งไม่ได้ใช้มิติข้อมูล isCurated พารามิเตอร์ เมตริก playlistViews แสดงจำนวนครั้งที่มีการดูวิดีโอ ในบริบทของเพลย์ลิสต์ โดยเมตริกดังกล่าวจะนับยอดดู ของวิดีโอทั้งหมดในเพลย์ลิสต์ ไม่ว่าช่องใดจะเป็นเจ้าของก็ตาม

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

4 ธันวาคม 2023

เราได้อัปเดต API ของข้อมูลวิเคราะห์ YouTube (คำค้นหาที่กำหนดเป้าหมาย) เพื่อรวม insightTrafficSourceType มิติข้อมูล ก่อนหน้านี้ มิติข้อมูลของวิดีโอที่เล่นเป็นส่วนหนึ่งของเพลย์ลิสต์มีความแตกต่างกัน (PLAYLIST) และยอดดูที่มาจากหน้าเว็บที่แสดงรายการวิดีโอทั้งหมดในเพลย์ลิสต์ (YT_PLAYLIST_PAGE) นับจากนี้ไป การดูทั้ง 2 ประเภทจะเกี่ยวข้องกับ ค่ามิติข้อมูล PLAYLIST

15 ธันวาคม 2022

YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย) API รองรับมิติข้อมูลใหม่ 2 รายการและรายงานใหม่ 1 รายการ ได้แก่

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

  • creatorContentType ใหม่ ระบุประเภทของเนื้อหา YouTube ที่เชื่อมโยงกับกิจกรรมของผู้ใช้ เมตริกในแถวข้อมูล ค่าที่รองรับคือ LIVE_STREAM, SHORTS, STORY และ VIDEO_ON_DEMAND

    มิติข้อมูล creatorContentType สามารถใช้เป็นมิติข้อมูลที่ไม่บังคับสําหรับ รายงานวิดีโอของช่องและเจ้าของเนื้อหา

  • ตอนนี้คู่มือตัวอย่างคำขอสำหรับ API ของ YouTube Analytics มีตัวอย่างสำหรับมิติข้อมูลใหม่ทั้ง 2 รายการ

  • การอ้างอิงมิติข้อมูล 7DayTotals และ 30DayTotals ได้รับการ นำออกจากเอกสารแล้ว เราได้ประกาศการเลิกใช้งานมิติข้อมูลเหล่านี้ในเดือนตุลาคม 2019

26 สิงหาคม 2022

API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย) และ API การรายงานของ YouTube (รายงานแบบกลุ่ม) รองรับค่ารายละเอียดแหล่งที่มาของการเข้าชมใหม่ ดังนี้

  • ใน API (คำค้นหาที่กำหนดเป้าหมาย) ของ YouTube Analytics API หาก insightTrafficSourceType ค่าของมิติข้อมูลคือ SUBSCRIBER แล้ว insightTrafficSourceDetail สามารถตั้งค่าเป็น podcasts ซึ่งบ่งชี้ว่าการเข้าชมมาจาก หน้าปลายทางของพอดแคสต์
  • ใน API การรายงาน (การรายงานแบบกลุ่ม) ของ YouTube หาก traffic_source_type ค่าของมิติข้อมูลคือ 3 แล้ว ค่า traffic_source_detail ตั้งค่าเป็น podcasts ได้ ซึ่งบ่งชี้ว่าการเข้าชมมาจาก หน้าปลายทางของพอดแคสต์

11 กุมภาพันธ์ 2022

ชุดค่าที่ถูกต้องสำหรับมิติข้อมูล gender จะมีการเปลี่ยนแปลงในหรือหลังจากเดือนสิงหาคม 11 ก.ย. 2022 การดำเนินการนี้อาจเป็นการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันเดิมในการใช้งาน API ในการปฏิบัติตาม ย้อนกลับ การเปลี่ยนแปลงที่ใช้ร่วมกันไม่ได้ในข้อกำหนดในการให้บริการของบริการ API ของ YouTube การเปลี่ยนแปลงนี้ มีการประกาศในอีก 6 เดือนก่อนที่จะมีผลบังคับใช้ โปรดอัปเดตการใช้งาน API ก่อนวันที่ 11 สิงหาคม 2022 เพื่อให้เปลี่ยนไปใช้ค่าชุดใหม่ได้อย่างราบรื่น

การเปลี่ยนแปลงที่เกิดขึ้นมีดังนี้

  • ใน API (คำค้นหาที่กำหนดเป้าหมาย) ของ YouTube Analytics แอตทริบิวต์ ปัจจุบันมีมิติข้อมูล gender รายการ รองรับ 2 ค่า ได้แก่ female และ male ตั้งแต่วันที่ 11 สิงหาคม 2022 เป็นต้นไป มิติข้อมูลจะรองรับค่า 3 ค่า ได้แก่ female, male และ user_specified
  • ใน API การรายงาน (การรายงานจำนวนมาก) ของ YouTube ฟิลด์ ปัจจุบันมีมิติข้อมูล gender รายการ รองรับค่า 3 ค่า ได้แก่ FEMALE, MALE และ GENDER_OTHER ตั้งแต่วันที่ 11 สิงหาคม 2022 เป็นต้นไป ชุดค่าที่รองรับจะเปลี่ยนเป็น FEMALE MALE และ USER_SPECIFIED

9 กุมภาพันธ์ 2022

เมตริก 2 รายการได้รับการอัปเดตเพื่อยกเว้น การเข้าชมจากคลิปวนซ้ำ ณ วันที่ 13 ธันวาคม 2021 การเปลี่ยนแปลงนี้จะส่งผลต่อทั้ง API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย) และ API การรายงานของ YouTube (รายงานแบบกลุ่ม)

2 กุมภาพันธ์ 2022

API การรายงานของ YouTube (รายงานจำนวนมาก) นี้รองรับค่ามิติข้อมูลแหล่งที่มาของการเข้าชมใหม่ ระบุว่าการดูมาจาก การส่งผู้ชมแบบสด:

  • ใน API การรายงาน (การรายงานจำนวนมาก) ของ YouTube พารามิเตอร์ traffic_source_type รองรับค่า 28

สำหรับแหล่งที่มาของการเข้าชมประเภทนี้ ค่า traffic_source_detail ระบุรหัสช่องที่ใช้อ้างอิงผู้ชม

23 กันยายน 2020

API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย) และ API การรายงานของ YouTube (รายงานแบบกลุ่ม) รองรับค่ามิติข้อมูลแหล่งที่มาของการเข้าชมใหม่ที่ระบุว่าผู้ชมได้รับการอ้างอิงจาก การปัดแนวตั้งในประสบการณ์การดู YouTube Shorts

  • ใน API (คำค้นหาที่กำหนดเป้าหมาย) ของ YouTube Analytics API insightTrafficSourceType รองรับค่า SHORTS
  • ใน API การรายงาน (การรายงานจำนวนมาก) ของ YouTube ฟิลด์ traffic_source_type รองรับค่า 24

มิติข้อมูลรายละเอียดแหล่งที่มาของการเข้าชม — insightTrafficSourceDetail ใน API ของข้อมูลวิเคราะห์ YouTube หรือ วันที่ traffic_source_detail ใน API การรายงานของ YouTube ระบบจะไม่ใส่ข้อมูลสำหรับแหล่งที่มาของการเข้าชมประเภทใหม่นี้

20 กรกฎาคม 2020

การอัปเดตนี้ครอบคลุมการเปลี่ยนแปลง 2 อย่างที่จะส่งผลต่อ API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย) ดังนี้

  • ขนาดสูงสุดของการรายงานของ YouTube Analytics ได้เพิ่มขึ้นจาก 200 เป็น 500 รายการ
  • เมธอด reports.query วันที่ filters ระบุรายการตัวกรองที่ควรนำมาใช้เมื่อดึงข้อมูล YouTube Analytics พารามิเตอร์นี้รองรับความสามารถในการระบุค่าหลายค่าสำหรับ video, playlist, และ channel ตัวกรอง และ จำนวนรหัสสูงสุดที่อนุญาตสำหรับตัวกรองเหล่านั้นเพิ่มขึ้นจาก 200 เป็น 500 รหัส

13 กุมภาพันธ์ 2020

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย) API และ Reporting API (รายงานแบบกลุ่ม) ของ YouTube ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงเหล่านี้ได้ใน ศูนย์ช่วยเหลือของ YouTube

ใน API ทั้งสอง จะมีการเปลี่ยนแปลงชุดรายละเอียดแหล่งที่มาของการเข้าชมที่เป็นไปได้สำหรับการแจ้งเตือน ในคำค้นหาที่กำหนดเป้าหมาย การแจ้งเตือนจะได้รับการรายงานเป็น insightTrafficSourceType=NOTIFICATION ใน รายงานแบบเป็นกลุ่ม การแจ้งเตือนจะได้รับการรายงานเป็น traffic_source_type=17

ก่อนหน้านี้มีการแจ้งเตือนแยกค่าใหม่ที่เกี่ยวข้องกับวิดีโอและสตรีมแบบสดที่อัปโหลด รายงานเป็น uploaded แล้ว โดยแบ่งออกเป็น 2 หมวดหมู่ ดังนี้

  • uploaded_push - ยอดดูที่มาจากข้อความ Push ที่ส่งไปยัง ผู้ติดตามเมื่ออัปโหลดวิดีโอ
  • uploaded_other - ยอดดูที่มาจากข้อความที่ไม่ใช่ข้อความ Push เช่น อีเมลหรือการแจ้งเตือนในกล่องจดหมาย ระบบจะส่งไปยังผู้ติดตามเมื่อมีการอัปโหลดวิดีโอ

ระบบจะแสดงผลค่าเหล่านี้สำหรับช่วงเวลาตั้งแต่วันที่ 13 มกราคม 2020 (13 มกราคม 2020)

โปรดอย่าลืมว่าค่าเหล่านี้ไม่ได้แสดงถึงการแจ้งเตือน แต่เป็นการเข้าชม แหล่งที่มาที่เพิ่มจำนวนการดู YouTube บางรายการ ตัวอย่างเช่น หากแถวในรายงานระบุว่า views=3 traffic_source_type=17 (NOTIFICATION) และ traffic_source_detail=uploaded_push แถวแสดงถึงมุมมอง 3 มุมมอง เกิดจากการที่ผู้ชมคลิกข้อความ Push ที่ส่งเมื่ออัปโหลดวิดีโอ

15 ตุลาคม 2019

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้เกี่ยวกับ API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย)

  • หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

    YouTube จะเลิกรองรับมิติข้อมูล 7DayTotals และ 30DayTotals คุณยังดึงข้อมูลโดยใช้มิติข้อมูลเหล่านั้นได้จนถึงวันที่ 15 เมษายน 2020 ในวันที่ดังกล่าวหรือหลังจากนั้น การพยายามดึงรายงานโดยใช้มิติข้อมูล 7DayTotals หรือ 30DayTotals จะแสดงข้อผิดพลาด

    โปรดทราบว่าผู้ใช้จะทำซ้ำข้อมูลบางส่วนสําหรับมิติข้อมูลเหล่านี้ได้โดยการค้นหาโดยใช้มิติข้อมูล day และรวมหรือดึงข้อมูลในช่วงเวลา 7 หรือ 30 วัน เช่น

    • จำนวนยอดดูในช่วงเวลา 7 วันจะคำนวณได้โดยการรวมยอดดูจากแต่ละวันในช่วงเวลานั้น
    • เปอร์เซ็นต์ของผู้ชมสำหรับช่วงเวลา 7 วันสามารถคำนวณได้โดยคูณจำนวนการดูที่เกิดขึ้นในแต่ละวันกับเปอร์เซ็นต์ผู้ชมในวันนั้นเพื่อหาจำนวนผู้ชมที่เข้าสู่ระบบเมื่อดูวิดีโอในวันนั้น จากนั้นจึงเพิ่มจำนวนผู้ชมที่เข้าสู่ระบบตลอดระยะเวลานั้น แล้วหารด้วยจำนวนยอดดูทั้งหมดในช่วงเวลานั้นเพื่อดูเปอร์เซ็นต์ของผู้ชมของระยะเวลาดังกล่าว
    • ไม่สามารถคำนวณจำนวนผู้ชมที่ไม่ซ้ำกันในช่วงระยะเวลา 7 วัน เนื่องจากการคำนวณผู้ชมรายเดียวกันเป็นผู้ชมที่ไม่ซ้ำกันคนละวันกัน อย่างไรก็ตาม คุณอาจใช้มิติข้อมูล month แทนมิติข้อมูล 30DayTotals ได้เพื่อประเมินข้อมูลเกี่ยวกับจำนวนผู้ชมที่ไม่ซ้ำกันในช่วงระยะเวลา 30 วัน โปรดทราบว่ามิติข้อมูล month หมายถึงเดือนตามปฏิทิน ส่วนมิติข้อมูล 30DayTotals จะคำนวณระยะเวลา 30 วันตามวันที่เริ่มต้นและวันที่สิ้นสุดที่ระบุไว้

27 มิถุนายน 2019

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้เกี่ยวกับ API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย)

  • เนื่องจากตอนนี้ API เวอร์ชัน 1 เลิกใช้งานแล้ว จึงมีการอัปเดตเอกสารเพื่อนำการอ้างอิงเวอร์ชันดังกล่าวออก ซึ่งรวมถึงประกาศการเลิกใช้งานและคำแนะนำการย้ายข้อมูลที่อธิบายวิธีอัปเดตเป็นเวอร์ชัน 2

1 พฤศจิกายน 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้เกี่ยวกับ API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย)

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

    โปรดทราบว่ามีการประกาศกำหนดการสำหรับการเลิกใช้งานนี้ก่อนหน้านี้ในวันที่ 26 เมษายน 2018

17 กันยายน 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้เกี่ยวกับ API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย)

  • ส่วนการลบข้อมูลระบุตัวบุคคลใหม่ในเอกสารภาพรวมโมเดลข้อมูลอธิบายว่าข้อมูล YouTube Analytics บางรายการจะถูกจํากัดเมื่อเมตริกไม่เป็นไปตามเกณฑ์บางอย่าง ซึ่งอาจเกิดขึ้นได้หลายกรณี ซึ่งในทางปฏิบัติแล้วหมายความว่ารายงานอาจไม่มีข้อมูลทั้งหมด (หรือข้อมูลใดเลย) ในกรณีต่อไปนี้

    1. วิดีโอหรือช่องมีปริมาณการเข้าชมจำกัดในระยะเวลาที่ระบุ

      หรือ

    2. คุณได้เลือกตัวกรองหรือมิติข้อมูล เช่น แหล่งที่มาของการเข้าชมหรือประเทศ ซึ่งมีค่าที่ไม่ตรงตามเกณฑ์บางอย่าง

    ส่วนใหม่นี้ยังจะมีการพูดคุยเกี่ยวกับประเภทข้อมูลที่อาจถูกจำกัดในรายงาน YouTube Analytics ด้วย

  • เอกสารรายงานช่องและรายงานของเจ้าของเนื้อหาได้รับการอัปเดตเพื่อแสดงข้อเท็จจริงที่ว่าระบบไม่รองรับเมตริก redViews และ estimatedRedMinutesWatched สำหรับรายงานตำแหน่งที่เล่น แหล่งที่มาของการเข้าชม และรายงานประเภทอุปกรณ์/ระบบปฏิบัติการอีกต่อไป

18 มิถุนายน 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API ของข้อมูลวิเคราะห์ YouTube (คำค้นหาที่กำหนดเป้าหมาย)

  • มีการเปลี่ยนแปลงข้อกําหนดขอบเขตสําหรับเมธอดต่อไปนี้
    • คำขอที่ส่งไปยังเมธอด reports.query ต้องมีสิทธิ์เข้าถึงขอบเขต https://www.googleapis.com/auth/youtube.readonly
    • คำขอสำหรับเมธอด groupItems.list ต้องมีสิทธิ์เข้าถึงอย่างใดอย่างหนึ่งต่อไปนี้
      • https://www.googleapis.com/auth/youtubeขอบเขต
        หรือ
      • https://www.googleapis.com/auth/youtube.readonlyขอบเขต
        และ
        ขอบเขต https://www.googleapis.com/auth/yt-analytics.readonly

      ตัวเลือกแรกจะใช้ขอบเขต 1 ขอบเขต ซึ่งเกิดขึ้นเป็นขอบเขตแบบอ่านและเขียน ในขณะที่ตัวเลือกที่ 2 ใช้ขอบเขตแบบอ่านอย่างเดียว 2 ขอบเขต

23 พฤษภาคม 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API ของข้อมูลวิเคราะห์ YouTube (คำค้นหาที่กำหนดเป้าหมาย)

22 พฤษภาคม 2018

การอัปเดตนี้มีการเปลี่ยนแปลงที่เกี่ยวข้องกับ API การรายงานของ YouTube (รายงานแบบกลุ่ม) ดังต่อไปนี้

  • ปัจจุบันการเปลี่ยนแปลงต่อไปนี้มีกำหนดมีผลในเดือนกรกฎาคม 2018 และนโยบายใหม่จะมีผลบังคับใช้ทั่วโลกกับรายงานและงานการรายงานทั้งหมด

    • หลังจากการเปลี่ยนแปลงนี้ รายงาน API ส่วนใหญ่ ซึ่งรวมถึงรายงานโฆษณาทดแทนจะใช้ได้เป็นเวลา 60 วันนับจากวันที่สร้างรายงาน แต่รายงานที่มีข้อมูลย้อนหลังจะใช้งานได้เป็นเวลา 30 วันนับจากวันที่สร้าง

      โดยก่อนการประกาศนี้ รายงาน API ทั้งหมดจะใช้งานได้เป็นเวลา 180 วันนับจากวันที่สร้างรายงาน เพื่อความชัดเจน เมื่อการเปลี่ยนแปลงนโยบายนี้มีผลบังคับใช้ คุณจะเข้าถึงรายงานข้อมูลย้อนหลังที่มีอายุเกิน 30 วันผ่าน API ไม่ได้อีกต่อไป ส่วนรายงานอื่นๆ ทั้งหมดที่มีอายุมากกว่า 60 วันก็จะไม่สามารถเข้าถึงได้อีกต่อไปเช่นกัน ด้วยเหตุนี้ เอกสารประกอบในตอนนี้จึงระบุว่ารายงานที่สร้างขึ้นก่อนการเปลี่ยนแปลงนโยบายจะใช้ได้สูงสุด 180 วัน

    • หลังจากการเปลี่ยนแปลง เมื่อคุณกำหนดเวลางานการรายงาน YouTube จะสร้างรายงานจากวันนั้นเป็นต้นไป และครอบคลุมช่วง 30 วันก่อนกำหนดเวลางาน ก่อนการเปลี่ยนแปลง เมื่อคุณกำหนดเวลางานการรายงาน YouTube จะสร้างรายงานที่ครอบคลุมช่วง 180 วันก่อนถึงเวลาที่มีการกำหนดเวลางานไว้

  • เราได้อัปเดตส่วนแนวทางปฏิบัติแนะนำเพื่อช่วยเตือนว่าคุณสามารถใช้ YouTube Data API เพื่อเรียกดูข้อมูลเมตาเพิ่มเติมสำหรับทรัพยากรที่ระบุในรายงานได้ ดังที่ระบุไว้ในนโยบายสำหรับนักพัฒนาซอฟต์แวร์บริการ API ของ YouTube (ส่วน III.E.4.b ถึง III.E.4.d) ไคลเอ็นต์ API จะต้องลบหรือรีเฟรชข้อมูลเมตาของทรัพยากรที่จัดเก็บไว้จาก API ดังกล่าวหลังจาก 30 วัน

  • ส่วนลักษณะรายงานได้รับการอัปเดตโปรดทราบว่าแม้ว่าข้อมูลรายงานจะไม่มีการกรอง แต่รายงานที่มีข้อมูลสำหรับช่วงเวลาตั้งแต่วันที่ 1 มิถุนายน 2018 เป็นต้นไปจะไม่มีการอ้างอิงไปยังแหล่งข้อมูลของ YouTube ที่ถูกลบก่อนวันที่สร้างรายงานอย่างน้อย 30 วัน

  • ส่วนข้อมูลย้อนหลังของภาพรวม API ได้รับการอัปเดตแล้ว โปรดทราบว่าเมื่อคุณตั้งเวลางานการรายงานใหม่ โดยทั่วไปแล้วรายงานข้อมูลย้อนหลังจะโพสต์ภายใน 2-3 วัน ก่อนหน้านี้เอกสารระบุว่าอาจใช้เวลาถึง 30 วันกว่าที่รายงานดังกล่าวจะพร้อมใช้งาน

  • ส่วนข้อมูลทดแทนของภาพรวม API ได้รับการอัปเดตให้กําหนดข้อมูลทดแทนได้ชัดเจนมากขึ้นว่าเป็นชุดข้อมูลที่แทนที่ชุดที่ส่งก่อนหน้านี้

26 เมษายน 2018

YouTube Analytics (การค้นหาเป้าหมาย) API (v2) เวอร์ชัน 2 พร้อมใช้งานแบบสาธารณะแล้ว รายการต่อไปนี้ระบุการเปลี่ยนแปลงผลิตภัณฑ์และเอกสารประกอบที่เกี่ยวข้องกับ API เวอร์ชันใหม่

  • API เวอร์ชัน 2 เกือบจะเหมือนกับ API เวอร์ชัน 1 อย่างไรก็ตาม คุณอาจต้องอัปเดตโค้ดเพื่อให้สอดคล้องกับการเปลี่ยนแปลงที่แสดงด้านล่าง เราจะอธิบายการเปลี่ยนแปลงทั้งหมดนี้โดยละเอียดในคำแนะนำในการย้ายข้อมูลฉบับใหม่

    • เวอร์ชันของ API เปลี่ยนจาก v1 เป็น v2
    • URL ฐานสำหรับคำขอ API เปลี่ยนจาก https://www.googleapis.com/youtube/analytics/v1 เป็น https://youtubeanalytics.googleapis.com/v2
    • พารามิเตอร์หลายรายการสำหรับเมธอด reports.query มีชื่อที่อัปเดตแล้ว กล่าวโดยละเอียดคือชื่อพารามิเตอร์ที่มีขีดกลางสั้น เช่น end-date ใน v1 API ให้ใช้รูปแบบอูฐ (endDate) แทนที่จะเป็นขีดกลางใน API v2 การเปลี่ยนแปลงนี้ทำให้ชื่อพารามิเตอร์สอดคล้องกันทั่วทั้ง API เนื่องจากเมธอดของ API ในการสร้างและจัดการกลุ่มที่มีการใช้ตัวพิมพ์ใหญ่/เล็กของอูฐสำหรับชื่อพารามิเตอร์อยู่แล้ว
    • API v2 ไม่รองรับคำขอแบบกลุ่มที่ส่งไปยังปลายทางกลุ่ม HTTP ส่วนกลางของ Google (www.googleapis.com/batch) หากส่งคำขอแบบกลุ่มใน API เวอร์ชัน 2 คุณต้องใช้ปลายทาง https://youtubeanalytics.googleapis.com/v2 แทน

    นอกจากนี้ API เวอร์ชัน 2 ไม่รองรับฟีเจอร์บางรายการใน v1 ดังนี้

    • เมธอด reports.query ไม่รองรับพารามิเตอร์คำขอ alt, quotaUser และ userIp อีกต่อไป
    • API เวอร์ชัน 2 ไม่มีปลายทางเป็นกลุ่มที่รองรับกลุ่มที่ประกอบด้วยคำขอไปยัง API ที่แตกต่างกัน (อย่างไรก็ตาม กลุ่มอาจประกอบด้วยคำขอไปยังเมธอดต่างๆ ของ API เดียวกัน) การเลิกใช้งานนี้ไม่เจาะจงกับ API ของ YouTube Analytics เนื่องจาก Google จะเลิกใช้งานปลายทางกลุ่มทั่วโลกใน API ทั้งหมด
    • API v2 ไม่รองรับโปรโตคอล JSON-RPC ซึ่ง API v1 รองรับ ขอย้ำอีกครั้งว่าการเลิกใช้งานนี้ไม่ได้มีไว้สำหรับ API ของ YouTube Analytics โดยเฉพาะ

  • หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

    ตอนนี้เราได้เลิกใช้งาน API เวอร์ชัน 1 (v1) แล้ว และรองรับจนถึงวันที่ 31 ตุลาคม 2018 คำขอทั้งหมดที่ส่งไปยัง API v1 จะหยุดทำงานหลังจากวันที่ดังกล่าว ด้วยเหตุนี้ โปรดอัปเกรดเป็น API เวอร์ชัน 2 ภายในวันที่ 31 ตุลาคม 2018 เพื่อไม่ให้การเข้าถึงข้อมูล YouTube Analytics ผ่าน API หยุดชะงัก

21 กุมภาพันธ์ 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API ของข้อมูลวิเคราะห์ YouTube (คำค้นหาที่กำหนดเป้าหมาย)

  • รายงานข้อมูลประชากรของผู้ชม ซึ่งรวบรวมสถิติการดูตามผู้ชม กลุ่มอายุและเพศไม่รองรับมิติข้อมูล youtubeProduct ซึ่งระบุบริการของ YouTube ที่มีกิจกรรมของผู้ใช้อีกต่อไป

18 มกราคม 2018

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

  • Reporting API ของ YouTube (รายงานจำนวนมาก)

    • มิติข้อมูล operating_system ที่ระบุระบบซอฟต์แวร์ของอุปกรณ์ที่เกิดการดูรองรับค่าต่อไปนี้แล้ว
      • 25: KaiOS

  • API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย)

    • มิติข้อมูล operatingSystem รองรับค่ามิติข้อมูล KAIOS

20 ธันวาคม 2017

การอัปเดตนี้มีการเปลี่ยนแปลง 2 รายการที่เกี่ยวข้องกับ Reporting API ของ YouTube ดังนี้

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

    หากต้องการรับการตอบกลับที่เข้ารหัส gzip ให้ตั้งค่าส่วนหัวของคำขอ HTTP Accept-Encoding เป็น gzip ดังที่แสดงในตัวอย่างต่อไปนี้

    Accept-Encoding: gzip

    มีคำอธิบายฟังก์ชันการทำงานนี้ในภาพรวม API และในคำจำกัดความของพร็อพเพอร์ตี้ downloadUrl ของทรัพยากร report

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

    • ค่าสำหรับมิติข้อมูล age_group ใช้ตัวอักษรพิมพ์ใหญ่ มีขีดล่างระหว่างคำว่า AGE กับตัวเลขในกลุ่มอายุ และใช้ขีดล่างแทนขีดกลางสั้น ด้วยเหตุนี้ ค่าต่างๆ เช่น age13-17 และ age18-24 จะได้รับการแก้ไขเป็น AGE_13_17 และ AGE_18_24 ตามลำดับ
    • ค่าสำหรับมิติข้อมูล gender ใช้ตัวอักษรพิมพ์ใหญ่ ดังนั้น ค่า female, male และ gender_other ได้รับการแก้ไขเป็น FEMALE, MALE และ GENDER_OTHER

10 สิงหาคม 2017

เมื่อวันที่ 10 สิงหาคม 2016 เอกสารนี้ได้ประกาศการเลิกใช้งานเมตริก earnings ของ YouTube Analytics API (ในขณะเดียวกัน API ได้เพิ่มการรองรับเมตริกใหม่ชื่อ estimatedRevenue ซึ่งให้ข้อมูลเหมือนกัน)

เนื่องจากเมตริก earnings เป็นเมตริกหลัก จึงมีการรองรับมา 1 ปีนับจากวันที่ประกาศ ช่วงเวลาของปีนี้สิ้นสุดลงแล้ว แต่ระบบไม่รองรับเมตริก earnings อีกต่อไป ด้วยเหตุนี้ ตอนนี้คำขอ API ที่ระบุเมตริก earnings จะแสดงโค้ดตอบกลับ HTTP 400 หากคุณยังไม่ได้อัปเดตแอปเพื่อใช้เมตริก estimatedRevenue แทนเมตริก earnings โปรดดำเนินการโดยเร็วที่สุด

เอกสารประกอบเกี่ยวกับ API ได้รับการอัปเดตเพื่อนำการอ้างอิงที่เหลืออยู่ไปยังเมตริก earnings ออก

6 กรกฎาคม 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

  • API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย)

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

      ตัวอย่างเช่น หากคำขอระบุวันที่สิ้นสุดเป็นวันที่ 5 กรกฎาคม 2017 และค่าสำหรับเมตริกที่ขอทั้งหมดแสดงจนถึงวันที่ 3 กรกฎาคม 2017 เท่านั้น นั่นหมายความว่าวันที่สุดท้ายที่จะรวมข้อมูลไว้ในคำตอบ (กล่าวคือ แม้ว่าข้อมูลของเมตริกที่ขอบางรายการจะพร้อมใช้งานในวันที่ 4 กรกฎาคม 2017 ก็ตาม)

    • ปัจจุบันมิติข้อมูล adType รองรับค่า reservedBumperInstream ซึ่งเป็นโฆษณาวิดีโอแบบข้ามไม่ได้ความยาวไม่เกิน 6 วินาทีที่เล่นก่อนที่จะดูวิดีโอ รูปแบบโฆษณาเหมือนกับโฆษณา auctionBumperInstream แต่ประเภทนี้หมายถึงโฆษณาที่ขายแบบจอง ไม่ใช่การประมูล

  • Reporting API ของ YouTube (รายงานจำนวนมาก)

    • ปัจจุบันมิติข้อมูล ad_type รองรับค่า 20 ซึ่งเป็นโฆษณาบัมเปอร์ที่ขายในรูปแบบการจอง โฆษณาบัมเปอร์เป็นโฆษณาวิดีโอแบบข้ามไม่ได้ความยาวไม่เกิน 6 วินาทีที่เล่นก่อนดูวิดีโอ โปรดทราบว่าค่า 19 สำหรับมิติข้อมูลนี้หมายถึงโฆษณาบัมเปอร์ที่ขายในการประมูล ไม่ใช่แบบจองไว้

    • ลบงานการรายงานสำหรับรายงาน YouTube Reporting API ต่อไปนี้แล้ว:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      เราได้ประกาศประเภทรายงานเหล่านี้ว่าจะเลิกใช้งานในวันที่ 15 กันยายน 2016 และไม่สร้างรายงานสำหรับประเภทรายงานดังกล่าวอีกต่อไปหลังจากวันที่ 15 ธันวาคม 2016 รายงานที่สร้างขึ้นก่อนหน้านี้จะยังคงเข้าถึงได้เป็นเวลา 180 วันนับจากวันที่สร้าง ด้วยเหตุนี้ รายงานบางส่วนจึงเข้าถึงได้ล่าช้าถึงวันที่ 15 มิถุนายน 2017 แต่เนื่องจากรายงานไม่มีให้บริการแล้ว งานที่เชื่อมโยงกับรายงานจึงไม่จำเป็นเช่นกัน

24 พฤษภาคม 2017

งานการรายงานทั้งหมดสำหรับรายงาน YouTube Reporting API ต่อไปนี้ถูกลบแล้ว

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

มีการประกาศเลิกใช้งานประเภทรายงานเหล่านี้ในวันที่ 22 มิถุนายน 2016 และไม่สร้างรายงานสำหรับประเภทรายงานดังกล่าวอีกต่อไปหลังจากวันที่ 22 กันยายน 2016 รายงานที่สร้างขึ้นก่อนหน้านี้จะยังคงเข้าถึงได้เป็นเวลา 180 วันนับจากวันที่สร้าง ด้วยเหตุนี้ รายงานบางส่วนจึงเข้าถึงได้ย้อนหลังไปถึงวันที่ 22 มีนาคม 2017 แต่เนื่องจากรายงานไม่มีให้บริการแล้ว งานที่เชื่อมโยงกับรายงานจึงไม่จำเป็นเช่นกัน

22 พฤษภาคม 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

  • Reporting API ของ YouTube (รายงานจำนวนมาก)

    • มิติข้อมูล sharing_service ที่ระบุบริการที่ใช้ในการแชร์วิดีโอรองรับค่าต่อไปนี้แล้ว

      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      นอกจากนี้ ชื่อที่ใช้ในการระบุค่า 52 ได้รับการอัปเดตในเอกสารประกอบเป็น Kakao (Kakao Talk) เพื่อให้แตกต่างจากค่า 73 (Kakao Story) ให้ชัดเจนยิ่งขึ้น การเปลี่ยนแปลงนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงใดๆ ในลักษณะการทำงานของ API หรือการแยกประเภทของวิดีโอที่แชร์กับบริการเหล่านี้

  • API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย)

    • มิติข้อมูล sharingService รองรับค่าต่อไปนี้แล้ว

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 มีนาคม 2017

ตอนนี้เจ้าของช่องที่เข้าถึงข้อมูลรายได้ผ่าน YouTube Analytics ใน Creator Studio จะเข้าถึงข้อมูลรายได้ผ่าน API ของ YouTube Analytics ได้ด้วย โดยทำดังนี้

17 มีนาคม 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

  • API ของ YouTube Analytics รองรับเมตริก redViews และ estimatedRedMinutesWatched ซึ่งเมตริกทั้ง 2 อย่างนี้เกี่ยวข้องกับผู้ชม YouTube Red อันที่จริง API รองรับเมตริกเหล่านี้มาระยะหนึ่งแล้ว และ API การรายงานของ YouTube ก็รองรับเมตริกทั้ง 2 รายการอยู่แล้วตามที่ประกาศไว้เมื่อวันที่ 15 กันยายน 2016

    • เมตริก redViews ระบุจำนวนครั้งที่สมาชิก YouTube Red ดูวิดีโอ
    • เมตริก estimatedRedMinutesWatched ระบุจำนวนนาทีที่สมาชิก YouTube Red ดูวิดีโอ

    เอกสารรายงานช่องและรายงานของเจ้าของเนื้อหาได้รับการอัปเดตเพื่อแสดงว่ารายงานใดรองรับเมตริกใหม่ 2 รายการ ซึ่งใช้ได้ในรายงานที่รองรับเมตริก views และ estimatedMinutesWatched อยู่แล้ว

3 มีนาคม 2017

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

  • Reporting API ของ YouTube (รายงานจำนวนมาก)

    • แก้ไขคำจำกัดความของมิติข้อมูล date แล้ว โดยสังเกตว่าค่ามิติข้อมูลหมายถึงช่วงเวลาที่เริ่มต้นเวลา 00:00 น. เวลาเขตแปซิฟิก และสิ้นสุดเวลา 23.59 น. เวลาเขตแปซิฟิกในวัน เดือน และปีที่ระบุ โดยเวลาเขตแปซิฟิกจะเป็น UTC-7 หรือ UTC-8 ทั้งนี้ขึ้นอยู่กับช่วงเวลาของปี

      แม้ว่าโดยปกติแล้ว วันที่จะแสดงช่วงเวลา 24 ชั่วโมง วันที่ที่มีการปรับนาฬิกาไปข้างหน้าจะเป็นช่วง 23 ชั่วโมง และวันที่ที่มีการปรับนาฬิกาย้อนหลังจะแสดงระยะเวลา 25 ชั่วโมง (ก่อนหน้านี้เอกสารระบุว่าแต่ละวันที่แสดงช่วงเวลา 24 ชั่วโมงที่ไม่ซ้ำกัน และเวลาเขตแปซิฟิกจะเป็น UTC-8 เสมอ)

      โปรดทราบว่าการแก้ไขนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานจริงของ API

    • มิติข้อมูล operating_system ที่ระบุระบบซอฟต์แวร์ของอุปกรณ์ที่เกิดการดูรองรับค่าต่อไปนี้แล้ว
      • 22: ทิเซน
      • 23: Firefox
      • 24: RealMedia

    • ลบงานการรายงานทั้งหมดสำหรับรายงานประเภท content_owner_basic_a1 แล้ว เราได้เลิกใช้งานรายงานประเภทดังกล่าวโดยสมบูรณ์เมื่อวันที่ 19 สิงหาคม 2016 แต่รายงานที่สร้างขึ้นก่อนหน้านี้ content_owner_basic_a1 รายการจะยังคงใช้งานได้เป็นเวลา 180 วันนับจากวันที่สร้าง ด้วยเหตุนี้ รายงานบางฉบับจึงดูย้อนหลังได้ถึงวันที่ 19 กุมภาพันธ์ 2017 แต่เนื่องจากรายงานไม่มีให้บริการแล้ว งานที่เชื่อมโยงกับรายงานจึงไม่จำเป็นเช่นกัน

  • API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย)

    • คำอธิบายมิติข้อมูลที่เกี่ยวข้องกับ time periods ได้รับการแก้ไขแล้ว โปรดทราบว่าค่ามิติข้อมูลหมายถึงช่วงเวลาที่เริ่มต้นเวลา 00:00 น. เวลาเขตแปซิฟิก และสิ้นสุดเวลา 23.59 น. เวลาเขตแปซิฟิกในวัน เดือน และปีที่ระบุ โดยเวลาเขตแปซิฟิกจะเป็น UTC-7 หรือ UTC-8 ทั้งนี้ขึ้นอยู่กับช่วงเวลาของปี

      แม้ว่าโดยปกติแล้ว วันที่จะแสดงช่วงเวลา 24 ชั่วโมง วันที่ที่มีการปรับนาฬิกาไปข้างหน้าจะเป็นช่วง 23 ชั่วโมง และวันที่ที่มีการปรับนาฬิกาย้อนหลังจะแสดงระยะเวลา 25 ชั่วโมง (ก่อนหน้านี้เอกสารระบุว่าเวลาเขตแปซิฟิกคือ UTC-8 และไม่ได้พูดถึงความเป็นไปได้ที่วันหนึ่งๆ อาจไม่ได้แสดงถึงระยะเวลา 24 ชั่วโมง)

      โปรดทราบว่าการแก้ไขนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานจริงของ API

    • เอกสารเกี่ยวกับรายงานแชแนลได้รับการอัปเดตแล้ว โปรดทราบว่ารายงานแชแนลยังไม่มีเมตริกรายได้หรือประสิทธิภาพโฆษณาในขณะนี้ ด้วยเหตุนี้ ขอบเขต https://www.googleapis.com/auth/yt-analytics-monetary.readonly จึงไม่ได้ให้สิทธิ์เข้าถึงข้อมูลการเงินในรายงานแชแนลในขณะนี้

    • มิติข้อมูล operatingSystem รองรับค่ามิติข้อมูลใหม่ 3 ค่า ได้แก่
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 กุมภาพันธ์ 2017

ขณะนี้ API ของข้อมูลวิเคราะห์ YouTube รองรับพารามิเตอร์ include-historical-channel-data ที่ไม่บังคับแล้ว โปรดทราบว่าพารามิเตอร์นี้มีความเกี่ยวข้องเมื่อดึงข้อมูลรายงานเจ้าของเนื้อหาเท่านั้น

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

กฎเหล่านี้ยังใช้หากคำขอ API เรียกข้อมูลสำหรับหลายแชแนลด้วย

  • หากค่าพารามิเตอร์คือ false ข้อมูลเวลาในการรับชมและยอดดูที่แสดงผลสำหรับช่องที่ระบุจะอิงตามวันที่ลิงก์ช่องนั้นกับเจ้าของเนื้อหา

    โปรดอย่าลืมว่าช่องต่างๆ อาจลิงก์กับเจ้าของเนื้อหาคนละวันกัน หากคำขอ API มีการเรียกข้อมูลของหลายช่องและค่าพารามิเตอร์คือ false การตอบกลับของ API จะมีข้อมูลเวลาในการรับชมและข้อมูลการดูตามวันที่ลิงก์สำหรับแต่ละช่องทางที่เกี่ยวข้อง
  • หากค่าพารามิเตอร์คือ true การตอบกลับจะแสดงเวลาในการรับชมและข้อมูลยอดดูของทุกช่องโดยอิงตามวันที่เริ่มต้นและวันที่สิ้นสุดที่ระบุไว้ในคําขอ API

15 ธันวาคม 2016

ระบบไม่รองรับรายงาน API การรายงานต่อไปนี้ของ YouTube อีกต่อไปและได้นำออกจากเอกสารประกอบแล้ว รายงานแต่ละฉบับจะมีเวอร์ชันใหม่กว่า (ประกาศการเลิกใช้งานสำหรับรายงานเหล่านี้เผยแพร่เมื่อวันที่ 15 กันยายน 2016)

เรายังอัปเดตรายการประเภทรายงานปัจจุบันในเอกสารอ้างอิง API ด้วย

11 พฤศจิกายน 2016

การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    API การรายงานของ YouTube สนับสนุนรายงาน End Screen ใหม่ 3 รายการ รวมถึงมิติข้อมูลและเมตริกใหม่ๆ สำหรับรายงานเหล่านั้น รายงานนี้จะให้ข้อมูลสถิติการแสดงผลและการคลิกผ่านสำหรับ End Screen ที่แสดงหลังจากวิดีโอหยุดเล่น

    • รายงาน End Screen

    • ขนาด End Screen

      • end_screen_element_type: ประเภทองค์ประกอบ End Screen ที่เชื่อมโยงกับสถิติ
      • end_screen_element_id: รหัสที่ YouTube ใช้เพื่อระบุองค์ประกอบ End Screen แบบไม่ซ้ำ

    • เมตริก End Screen

      หมายเหตุ: ข้อมูลสำหรับเมตริก End Screen จะพร้อมใช้งานในวันที่ 1 พฤษภาคม 2016

      • end_screen_element_impressions: จำนวนการแสดงผลทั้งหมดขององค์ประกอบ End Screen ระบบจะบันทึกการแสดงผล 1 ครั้งสำหรับองค์ประกอบ End Screen แต่ละรายการที่แสดง
      • end_screen_element_clicks: จำนวนครั้งที่มีการคลิกองค์ประกอบ End Screen
      • end_screen_element_click_rate: อัตราการคลิกผ่านขององค์ประกอบ End Screen

      • ศูนย์ช่วยเหลือของ YouTube มีข้อมูลรายละเอียดเพิ่มเติมเกี่ยวกับการเพิ่ม End Screen ลงในวิดีโอ

    • ระบบไม่รองรับรายงานต่อไปนี้อีกต่อไปและได้นำออกจากเอกสารประกอบแล้ว รายงานแต่ละฉบับจะมีเวอร์ชันใหม่กว่า (ประกาศการเลิกใช้งานสำหรับรายงานเหล่านี้เกิดขึ้นเมื่อวันที่ 22 มิถุนายน 2016)

    8 พฤศจิกายน 2016

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API ของข้อมูลวิเคราะห์ YouTube

    • เมตริกในรายการต่อไปนี้เลิกใช้งานแล้วและไม่มีการรองรับอีกต่อไป ตามที่ได้ประกาศไปเมื่อวันที่ 10 สิงหาคม 2016 เมตริกใหม่ที่อ้างอิงข้อมูลเดียวกันก็ได้รับการสนับสนุนแล้ว ตารางด้านล่างแสดงชื่อเมตริกที่เลิกใช้งานแล้วและชื่อเมตริกใหม่

      เมตริกที่เลิกใช้งานแล้ว เมตริกใหม่
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    27 ตุลาคม 2016

    ตอนนี้ YouTube จะสร้างชุดรายงานรายได้จากโฆษณาที่จัดการโดยระบบโดยอัตโนมัติสำหรับเจ้าของเนื้อหาที่มีสิทธิ์เข้าถึงรายงานที่เกี่ยวข้องในส่วนรายงานของ Creator Studio ของ YouTube รายงาน API ใหม่ที่จัดการโดยระบบได้รับการออกแบบมาเพื่อให้สิทธิ์การเข้าถึงแบบเป็นโปรแกรมสำหรับข้อมูลที่อยู่ในรายงานของ Creator Studio ที่ดาวน์โหลดได้ด้วยตนเอง

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

    พร็อพเพอร์ตี้ id ของทรัพยากร reportType ได้รับการอัปเดตให้รวมรายการของรายงานที่จัดการโดยระบบซึ่งคุณสามารถเข้าถึงผ่าน API ได้ดังนี้

    • รายได้จากโฆษณาทั่วโลกต่อวิดีโอต่อเดือน
    • รายได้จากโฆษณารายวันต่อประเทศต่อวิดีโอ
    • รายได้จากโฆษณาทั่วโลกต่อเนื้อหารายเดือน
    • รายได้จากโฆษณารายวันต่อประเทศต่อเนื้อหา
    • การอ้างสิทธิ์ (รายงานนี้ไม่มีข้อมูลรายได้)

    27 กันยายน 2016

    หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

    เมตริก uniques ของ YouTube Analytics API เลิกใช้งานแล้ว เมตริกนี้ไม่ใช่เมตริกหลัก และจะได้รับการสนับสนุนจนถึงวันที่ 31 ตุลาคม 2016

    15 กันยายน 2016

    การอัปเดตนี้มีการเปลี่ยนแปลง API การรายงานของ YouTube ดังต่อไปนี้

    • API รองรับเมตริกใหม่ 2 รายการที่เกี่ยวข้องกับการรับชม YouTube Red ดังนี้

      • red_views: จำนวนครั้งที่สมาชิก YouTube Red ดูวิดีโอ
      • red_watch_time_minutes: จำนวนนาทีที่สมาชิก YouTube Red ดูวิดีโอ

    • API รองรับรายงานเวอร์ชันใหม่ 20 ฉบับ เวอร์ชันใหม่ทั้งหมดรองรับเมตริก red_views และ red_watch_time_minutes ใหม่

      สำหรับแต่ละรายงาน ตัวเลขในรหัสประเภทรายงานใหม่คือตัวเลขที่สูงกว่ารหัสประเภทรายงานเดิมหนึ่งรหัส (ตอนนี้เวอร์ชันเก่าของรายงานเหล่านี้ได้เลิกใช้งานแล้วตามที่อธิบายภายหลังในประวัติการแก้ไขนี้) ตัวอย่างเช่น ตอนนี้เราเลิกใช้งานรายงาน channel_basic_a1 แล้ว และได้เปลี่ยนมาใช้รายงาน channel_basic_a2 แทน

      รายการต่อไปนี้จะระบุรหัสประเภทรายงานใหม่

    • หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

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

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      หากคุณมีตำแหน่งงานสำหรับรายงานเหล่านั้น คุณไม่ควรคาดหวังว่า YouTube จะสร้างรายงานใหม่สำหรับงานดังกล่าวหลังจากวันที่ 15 ธันวาคม 2016 คุณจะยังดูรายงานที่สร้างขึ้นได้เป็นเวลา 180 วันนับจากวันที่สร้าง

    19 สิงหาคม 2016

    การอัปเดตนี้มีการเปลี่ยนแปลง API การรายงานของ YouTube ดังต่อไปนี้

    • รายงาน content_owner_basic_a1 เลิกใช้งานแล้วอย่างสมบูรณ์และนำออกจากเอกสารประกอบแล้ว YouTube จะไม่สร้างรายงานใหม่ประเภทนั้นอีกต่อไป แต่รายงานที่สร้างขึ้นแล้วจะยังเข้าถึงได้เป็นเวลา 180 วันนับจากวันที่สร้างรายงาน

      การแทนที่ของรายงาน content_owner_basic_a1 คือรายงาน content_owner_basic_a2 ตามที่อธิบายไว้ในรายการประวัติการแก้ไขสำหรับวันที่ 19 พฤษภาคม 2016

    11 สิงหาคม 2016

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • ข้อกำหนดในการให้บริการของบริการ API ของ YouTube ที่เผยแพร่ใหม่ ("ข้อกำหนดฉบับปรับปรุง") ซึ่งได้อธิบายไว้อย่างละเอียดในบล็อกวิศวกรรมและนักพัฒนาซอฟต์แวร์ YouTube จะให้ข้อมูลอัปเดตมากมายสำหรับข้อกำหนดในการให้บริการปัจจุบัน นอกเหนือจากข้อกำหนดฉบับปรับปรุงซึ่งจะมีผลบังคับใช้ตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 แล้ว การปรับปรุงครั้งนี้ยังมีเอกสารสนับสนุนอื่นๆ ที่จะช่วยอธิบายนโยบายที่นักพัฒนาซอฟต์แวร์ต้องปฏิบัติตามด้วย

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

    10 สิงหาคม 2016

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย)

      • หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน

        เมตริกในตารางต่อไปนี้เลิกใช้งานแล้ว ในขณะเดียวกัน ก็จะแนะนำเมตริกใหม่ซึ่งอ้างอิงข้อมูลเดียวกันด้วย ซึ่งหมายความว่าจะมีการเปลี่ยนชื่อเมตริกเก่า แม้ว่า API ของ YouTube Analytics จะรองรับชื่อเมตริกทั้ง 2 ชื่อจนกว่าจะถึงวันที่เลิกใช้งานที่ระบุไว้ในตาราง

        ชื่อเมตริกเดิม ชื่อเมตริกใหม่ วันที่ให้การสนับสนุน
        earnings estimatedRevenue 10 สิงหาคม 2017
        adEarnings estimatedAdRevenue 4 พฤศจิกายน 2016
        redPartnerRevenue estimatedRedPartnerRevenue 4 พฤศจิกายน 2016
        impressionBasedCpm cpm 4 พฤศจิกายน 2016
        impressions adImpressions 4 พฤศจิกายน 2016

        โปรดทราบว่าเมตริก earnings เป็นเมตริกหลัก ดังนั้นจึงรองรับเป็นเวลา 1 ปีนับจากวันที่ประกาศนี้ ส่วนเมตริกอื่นๆ ที่ไม่ใช่เมตริกหลักจะได้รับการสนับสนุนเป็นเวลา 3 เดือนจนถึงวันที่ 4 พฤศจิกายน 2016

        ตัวอย่างเช่น คำขอ API สามารถระบุเมตริก impressionBasedCpm, เมตริก cpm หรือทั้ง 2 อย่างได้จนถึงวันที่ 4 พฤศจิกายน 2016 แต่หลังจากวันที่ดังกล่าว ระบบจะรองรับเฉพาะเมตริก cpm เท่านั้น

      • มิติข้อมูล insightTrafficSourceType รองรับค่ามิติข้อมูลใหม่ 2 ค่า ได้แก่
        • CAMPAIGN_CARD: แหล่งที่มาของการเข้าชมนี้รองรับเฉพาะรายงานของเจ้าของเนื้อหาเท่านั้น โดยระบุว่าการดูมาจากวิดีโอที่อ้างสิทธิ์หรืออัปโหลดโดยผู้ใช้ที่เจ้าของเนื้อหาใช้เพื่อโปรโมตเนื้อหาที่ดู
        • END_SCREEN: ข้อมูลนี้เกี่ยวข้องกับยอดดูที่มาจาก End Screen ของวิดีโออื่น

        คุณยังเรียกดูรายงานtraffic source detailสําหรับแหล่งที่มาของการเข้าชมใหม่ทั้ง 2 แหล่งได้ด้วย ในทั้ง 2 กรณี มิติข้อมูล insightTrafficSourceDetail จะระบุวิดีโอที่เป็นที่มาของการแนะนำผู้ชม

      • ปัจจุบันมิติข้อมูล adType รองรับค่า auctionBumperInstream ซึ่งเป็นโฆษณาวิดีโอแบบข้ามไม่ได้ความยาวไม่เกิน 6 วินาทีที่เล่นก่อนที่จะดูวิดีโอ

    • Reporting API ของ YouTube (รายงานจำนวนมาก)

      • มิติข้อมูล traffic_source_type รองรับค่าต่อไปนี้แล้ว
        • 19: แหล่งที่มาของการเข้าชมนี้รองรับเฉพาะรายงานของเจ้าของเนื้อหาเท่านั้น โดยระบุว่าการดูมาจากวิดีโอที่อ้างสิทธิ์หรืออัปโหลดโดยผู้ใช้ที่เจ้าของเนื้อหาใช้เพื่อโปรโมตเนื้อหาที่ดู
        • 20: ข้อมูลนี้เกี่ยวข้องกับยอดดูที่มาจาก End Screen ของวิดีโออื่น

        สำหรับแหล่งที่มาของการเข้าชมใหม่ทั้ง 2 แห่ง มิติข้อมูล traffic_source_detail จะระบุวิดีโอที่เป็นแหล่งที่มาของการเข้าชม

      • มีการแก้ไขรายการเมตริกหลักของ API ให้แสดง estimated_partner_revenue เป็นเมตริกหลัก และนำ earnings ออกจากรายการดังกล่าว (ปัจจุบัน Reporting API ของ YouTube ยังไม่รองรับเมตริก earnings)

      • ตอนนี้มิติข้อมูล ad_type รองรับค่า 19 ที่อ้างถึงโฆษณาบัมเปอร์แล้ว ซึ่งเป็นโฆษณาวิดีโอแบบข้ามไม่ได้ที่มีความยาวสูงสุด 6 วินาทีและเล่นก่อนที่จะดูวิดีโอ

    18 กรกฎาคม 2016

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย)

      • เราได้อัปเดตรายการเมตริกที่รองรับสําหรับรายงานแชแนลต่อไปนี้ให้รวมเมตริกการ์ด อันที่จริงมีการเพิ่มเมตริกการ์ดในรายงานเหล่านี้ในวันที่ 28 มิถุนายน 2016 และรายการประวัติการแก้ไขสำหรับวันที่ดังกล่าวจะอธิบายการเปลี่ยนแปลงโดยละเอียด รายงานมีดังต่อไปนี้
        • กิจกรรมของผู้ใช้พื้นฐานสำหรับรัฐในสหรัฐอเมริกา
        • กิจกรรมของผู้ใช้ในรัฐของสหรัฐอเมริกาในช่วงระยะเวลาหนึ่ง
        • กิจกรรมของผู้ใช้ตามจังหวัด
        • กิจกรรมของผู้ใช้ตามสถานะการติดตาม
        • กิจกรรมของผู้ใช้ตามสถานะการสมัครใช้บริการในจังหวัด
        • วิดีโอยอดนิยมตามรัฐ
        • วิดีโอยอดนิยมสำหรับผู้ชมที่ติดตามหรือไม่ได้ติดตาม

      • รายการตัวกรองได้รับการแก้ไขทั้งรายงานการคงผู้ชมไว้ของช่องและรายงานการรักษาผู้ชมของเจ้าของเนื้อหาแล้ว เพื่อแสดงให้เห็นว่าต้องมีตัวกรอง video และระบบไม่รองรับตัวกรอง group

        ก่อนหน้านี้ เอกสารของรายงานทั้ง 2 ฉบับระบุอย่างไม่ถูกต้องว่า รายงานนี้จะดึงรายงานได้โดยใช้ตัวกรอง 1 ใน 2 รายการดังกล่าว หรือใช้ตัวกรองทั้งคู่

    • Reporting API ของ YouTube (รายงานจำนวนมาก)

      • ในภาพรวม API ส่วนที่อธิบายวิธีเรียกข้อมูล URL ดาวน์โหลดรายงานได้รับการแก้ไขแล้วเพื่อระบุว่า YouTube สร้างรายงานที่ดาวน์โหลดได้สำหรับวันที่ไม่มีข้อมูล รายงานเหล่านี้มีแถวส่วนหัวแต่ไม่มีข้อมูลเพิ่มเติม ข้อมูลนี้ได้รับการอัปเดตแล้วในส่วนลักษณะของรายงานของเอกสารเดียวกันเมื่อวันที่ 12 เมษายน 2016
      • มีการแก้ไขรายการมิติข้อมูลในรายงาน content_owner_asset_cards_a1 เพื่อแสดงให้เห็นว่ารายงานใช้มิติข้อมูล card_id ก่อนหน้านี้ เอกสารประกอบแสดงชื่อมิติข้อมูลเป็น card_title อย่างไม่ถูกต้อง

    28 มิถุนายน 2016

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

    เมตริกได้รับการสนับสนุนในรายงานประเภทต่อไปนี้

    22 มิถุนายน 2016

    การอัปเดตนี้มีการเปลี่ยนแปลง API การรายงานของ YouTube ดังต่อไปนี้ การเปลี่ยนแปลงแรกเกี่ยวข้องกับ API โดยทั่วไปและการเปลี่ยนแปลงที่เหลือจะส่งผลต่อรายงานของเจ้าของเนื้อหาเท่านั้น ดังนี้

    • ส่วนลักษณะรายงานของภาพรวม API ได้รับการอัปเดตเพื่อชี้แจงว่ารายงานจะพร้อมใช้งานผ่าน API เป็นเวลา 180 วันนับจากวันที่สร้างรายงาน

      ก่อนหน้านี้เอกสารระบุว่ารายงานมีให้ดูเป็นเวลาสูงสุด 180 วันก่อนวันที่ส่งคำขอ API แม้ว่าในทางเทคนิคแล้ว ข้อความต้นฉบับนั้นค่อนข้างน่าสับสน

    • API รองรับรายงาน 3 เวอร์ชันใหม่ รายงาน 2 รายการดังกล่าวยังมีเมตริกใหม่และเมตริกที่เปลี่ยนชื่อแล้วด้วย ดังนี้

      • รายงาน content_owner_ad_rates_a1 เป็นรายงาน content_owner_ad_performance_a1 เวอร์ชันใหม่ รายงานที่เพิ่งเปลี่ยนชื่อจะเหมือนกับเวอร์ชันก่อนหน้า

      • มีการเปลี่ยนชื่อรายงาน 2 ฉบับที่เป็นเวอร์ชันใหม่ ได้แก่

        • รายงาน content_owner_estimated_earnings_a1 เวอร์ชันใหม่มีชื่อว่า content_owner_estimated_revenue_a1
        • รายงาน content_owner_asset_estimated_earnings_a1 เวอร์ชันใหม่มีชื่อว่า content_owner_asset_estimated_revenue_a1

        รายงานที่เพิ่งเปลี่ยนชื่อใหม่ทั้งสองฉบับแตกต่างจากรายงานเดิมดังนี้

        • โดยเพิ่มเมตริกestimated_partner_red_revenueใหม่ ซึ่งจะประมาณรายได้ทั้งหมดจากการสมัครใช้บริการ YouTube Red
        • บริษัทได้เพิ่มเมตริก estimated_partner_transaction_revenue ใหม่ ซึ่งจะประมาณรายได้จากธุรกรรม เช่น เนื้อหาที่ต้องชำระเงินและการให้เงินสนับสนุนของแฟนๆ หักลบกับการคืนเงินที่พาร์ทเนอร์เรียกเก็บ
        • และเปลี่ยนชื่อเมตริก estimated_partner_ad_sense_revenue เป็น estimated_partner_ad_auction_revenue
        • และเปลี่ยนชื่อเมตริก estimated_partner_double_click_revenue เป็น estimated_partner_ad_reserved_revenue

      โปรดทราบว่าหากคุณมีงานในการสร้างเวอร์ชันเก่าของรายงานเหล่านี้อยู่แล้ว คุณจะต้องสร้างงานใหม่สำหรับรายงานที่เปลี่ยนชื่อแล้ว เราเลิกใช้งานรายงาน content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 และ content_owner_asset_estimated_earnings_a1 พร้อมกับการเปิดตัวรายงานเวอร์ชันใหม่

      หากคุณมีตำแหน่งงานสำหรับรายงานเหล่านั้น คุณไม่ควรคาดหวังว่า YouTube จะสร้างรายงานใหม่สำหรับงานดังกล่าวหลังจากวันที่ 22 กันยายน 2016 คุณจะยังดูรายงานที่สร้างขึ้นได้เป็นเวลา 180 วันนับจากวันที่สร้าง

    • ระบบได้อัปเดตคําจํากัดความพร็อพเพอร์ตี้ id ของทรัพยากร reportType เพื่อแสดงชุดรายงานปัจจุบันที่มีอยู่

    • ชื่อของเมตริก 2 รายการได้รับการแก้ไขให้ถูกต้องแล้วในเอกสารประกอบเพื่อให้ตรงกับชื่อที่ปรากฏในรายงาน นี่เป็นการแก้ไขในเอกสารเท่านั้น และไม่ได้แสดงถึงการเปลี่ยนแปลงในเนื้อหารายงานจริง

      • อัปเดตชื่อของเมตริก estimated_partner_adsense_revenue เป็น estimated_partner_ad_sense_revenue แล้ว อย่างไรก็ตาม โปรดทราบว่าเมตริกนี้จะปรากฏในรายงาน 2 ฉบับเท่านั้นซึ่งกําลังจะเลิกใช้งานในการอัปเดตนี้ ดังที่อธิบายไว้ข้างต้น เมตริกนี้ได้เปลี่ยนชื่อเป็น estimated_partner_ad_auction_revenue ในรายงานเหล่านั้นในเวอร์ชันที่ใหม่กว่า
      • อัปเดตชื่อของเมตริก estimated_partner_doubleclick_revenue เป็น estimated_partner_double_click_revenue แล้ว ขอย้ำอีกครั้งว่าเมตริกนี้จะปรากฏในรายงาน 2 ฉบับเท่านั้นซึ่งกําลังจะเลิกใช้งานในการอัปเดตนี้ ดังที่อธิบายไว้ข้างต้น เมตริกนี้ได้เปลี่ยนชื่อเป็น estimated_partner_ad_reserved_revenue ในรายงานเหล่านั้นในเวอร์ชันที่ใหม่กว่า

    • เอกสารเกี่ยวกับมิติข้อมูลสำหรับ Reporting API ได้รับการอัปเดตไม่ให้แสดงพร็อพเพอร์ตี้ elapsed_video_time_percentage และ audience_retention_type อีกต่อไป ปัจจุบันรายงานใดๆ ที่มีให้บริการผ่าน API ยังไม่รองรับมิติข้อมูลเหล่านี้

    19 พฤษภาคม 2016

    การอัปเดตนี้มีการเปลี่ยนแปลง API การรายงานของ YouTube ดังต่อไปนี้

    • API รองรับรายงานกิจกรรมของผู้ใช้สำหรับเจ้าของเนื้อหาเวอร์ชันใหม่ รหัสประเภทรายงานสำหรับรายงานใหม่คือ content_owner_basic_a2 เวอร์ชันใหม่นี้รองรับเมตริก likes และ dislikes ซึ่งต่างจากรายงานเวอร์ชันก่อนหน้านี้ content_owner_basic_a1

      หากมีงานที่จะสร้างรายงาน content_owner_basic_a1 อยู่แล้ว คุณก็ยังต้องสร้างงานใหม่สำหรับรายงาน content_owner_basic_a2 YouTube ไม่ได้ย้ายข้อมูลเจ้าของเนื้อหาไปยังรายงานเวอร์ชันใหม่โดยอัตโนมัติ หรือสร้างงานเพื่อสร้างรายงานเวอร์ชันใหม่โดยอัตโนมัติ ในการใช้งานบางรูปแบบ การมีลักษณะของงานใหม่ที่ไม่คาดคิดอาจเป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

      เราได้เลิกใช้งานรายงาน content_owner_basic_a1 ไปพร้อมกับการเปิดตัวรายงานใหม่ หากคุณมีงานสำหรับรายงานนั้น คุณไม่ควรคาดหวังว่า YouTube จะสร้างรายงานใหม่สำหรับงานดังกล่าวหลังจากวันที่ 19 สิงหาคม 2016 คุณจะยังดูรายงานที่สร้างขึ้นได้เป็นเวลา 180 วันนับจากวันที่สร้าง

    • ทรัพยากร reportType, job และ report ต่างรองรับพร็อพเพอร์ตี้ใหม่ที่ระบุว่าทรัพยากรที่เชื่อมโยงแสดงประเภทรายงานที่เลิกใช้งานแล้วหรือไม่ ดังนี้

      • พร็อพเพอร์ตี้ deprecateTime ของทรัพยากร reportType ระบุวันที่และเวลาที่จะเลิกใช้งานประเภทรายงาน พร็อพเพอร์ตี้นี้มีเฉพาะค่าของรายงานที่ประกาศว่าเลิกใช้งาน และค่านี้จะแสดงวันที่ที่ YouTube จะหยุดสร้างรายงานประเภทดังกล่าว

        หลังจากมีการประกาศประเภทรายงานว่าเลิกใช้งาน YouTube จะสร้างรายงานประเภทนั้นต่อไปอีก 3 เดือน ตัวอย่างเช่น การอัปเดตนี้ในวันที่ 19 พฤษภาคม 2016 เป็นการประกาศการเลิกใช้งานรายงาน content_owner_basic_a1 ดังนั้น deprecateTime ของรายงานประเภทดังกล่าวจะระบุเวลาในวันที่ 19 สิงหาคม 2016 ซึ่งหลังจากนั้น YouTube จะหยุดสร้างรายงานประเภทดังกล่าว

      • พร็อพเพอร์ตี้ expireTime ของทรัพยากร job ระบุวันที่และเวลาที่งานหมดอายุหรือจะหมดอายุ พร็อพเพอร์ตี้นี้จะมีค่าหากประเภทรายงานที่เชื่อมโยงกับงานเลิกใช้งานแล้ว หรือหากรายงานที่สร้างขึ้นสำหรับงานไม่มีการดาวน์โหลดรายงานเป็นระยะเวลานาน วันที่จะระบุเวลาที่ YouTube ไม่ได้สร้างรายงานใหม่สำหรับงานนั้นอีกต่อไป

      • พร็อพเพอร์ตี้ jobExpireTime ของทรัพยากร report ระบุวันที่และเวลาที่งานที่เชื่อมโยงกับรายงานหมดอายุหรือจะหมดอายุ พร็อพเพอร์ตี้นี้มีค่าเดียวกับพร็อพเพอร์ตี้ expireTime ในทรัพยากร job ตามที่อธิบายไว้ในรายการก่อนหน้าในรายการนี้

    • ตอนนี้เมธอด jobs.create จะแสดงรหัสตอบกลับ HTTP 400 (Bad Request) หากคุณพยายามสร้างงานสําหรับรายงานที่เลิกใช้งานแล้ว นอกจากนี้ เอกสารประกอบของเมธอดยังระบุเหตุผลอื่นๆ ที่ทำให้คำขอ API ล้มเหลวด้วย

    12 เมษายน 2016

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ ซึ่งทั้งหมดจะส่งผลต่อ API การรายงานของ YouTube เท่านั้น:

    • ปัจจุบัน YouTube จะสร้างข้อมูลที่ครอบคลุมช่วง 180 วันก่อนที่จะถึงกำหนดเวลางานการรายงานครั้งแรก ก่อนหน้านี้ Reporting API ไม่ได้ให้ข้อมูลย้อนหลังใดๆ การเปลี่ยนแปลงนี้จะมีผลกับงานทั้งหมด รวมถึงงานที่สร้างขึ้นก่อนการประกาศนี้ด้วย

      รายงานข้อมูลย้อนหลังจะได้รับการโพสต์ทันทีที่มี แต่จะใช้เวลาประมาณ 1 เดือนกว่าจะโพสต์ข้อมูลย้อนหลังทั้งหมดสำหรับงานหนึ่งๆ ดังนั้น หนึ่งเดือนหลังจากวางกำหนดการงานการรายงานแล้ว คุณจะมีสิทธิ์เข้าถึงข้อมูลประมาณ 7 เดือน (ควรโพสต์ข้อมูลย้อนหลังทั้งหมดสำหรับงานที่สร้างขึ้นก่อนการประกาศนี้ภายใน 1 เดือนนับจากการประกาศ)

      โปรดทราบว่าข้อมูลย้อนหลังมีให้บริการตั้งแต่วันที่ 1 กรกฎาคม 2015 เท่านั้น ด้วยเหตุนี้ งานที่สร้างขึ้นก่อนวันที่ 28 ธันวาคม 2015 จึงมีข้อมูลย้อนหลังไม่ถึง 180 วัน

      เราอธิบายการเปลี่ยนแปลงเหล่านี้ทั้งหมดไว้ในส่วนข้อมูลย้อนหลังใหม่ของภาพรวม Reporting API

    • ส่วนลักษณะรายงานในภาพรวม API การรายงานของ YouTube ได้รับการอัปเดตโดยมีการเปลี่ยนแปลงต่อไปนี้

      • ซึ่งตอนนี้เอกสารระบุว่ารายงานจะพร้อมใช้งานเป็นเวลา 180 วันหลังจากที่สร้าง จึงพร้อมให้ไคลเอ็นต์ API ดาวน์โหลด ก่อนหน้านี้ เอกสารประกอบระบุว่ารายงานนั้นใช้งานได้เป็นเวลาสูงสุด 6 เดือนก่อนวันที่ส่งคำขอ API

      • เอกสารได้รับการอัปเดตเพื่อแสดงถึงข้อเท็จจริงที่ว่า API จะสร้างรายงานที่ดาวน์โหลดได้สำหรับวันที่ไม่มีข้อมูล รายงานเหล่านี้จะมีแถวส่วนหัวแต่จะไม่มีข้อมูลเพิ่มเติม

    • เร็วๆ นี้ API การรายงานของ YouTube จะรองรับชุดรายงานที่สร้างขึ้นโดยอัตโนมัติและจัดการโดยระบบ ซึ่งมีข้อมูลรายได้จากโฆษณาหรือข้อมูลรายได้จากการสมัครใช้บริการ YouTube Red รายงานจะพร้อมใช้งานสำหรับเจ้าของเนื้อหาที่สามารถเข้าถึงรายงานรายได้ที่ดาวน์โหลดได้ด้วยตนเองอยู่แล้วใน YouTube Creator Studio ดังนั้น ฟังก์ชันใหม่ของ API จะให้การเข้าถึงข้อมูลดังกล่าวโดยใช้โปรแกรม

      ในตอนนี้ เรากำลังประกาศการเปลี่ยนแปลง API ต่อไปนี้เพื่อเตรียมพร้อมสำหรับการเปิดตัวรายงานที่จัดการโดยระบบ

      • พร็อพเพอร์ตี้ systemManaged ใหม่ของทรัพยากร job จะระบุว่าทรัพยากรนั้นอธิบายงานที่สร้างรายงานที่จัดการโดยระบบหรือไม่ YouTube จะสร้างรายงานที่จัดการโดยระบบสำหรับเจ้าของเนื้อหา YouTube โดยอัตโนมัติ และเจ้าของเนื้อหาจะแก้ไขหรือลบงานที่สร้างรายงานเหล่านั้นไม่ได้

      • พารามิเตอร์ includeSystemManaged ใหม่ของเมธอด jobs.list จะระบุว่าการตอบกลับจาก API ควรรวมงานสําหรับรายงานที่จัดการโดยระบบหรือไม่ ค่าเริ่มต้นของพารามิเตอร์คือ false

      • พารามิเตอร์ startTimeAtOrAfter ใหม่ของเมธอด jobs.reports.list บ่งชี้ว่าการตอบกลับของ API ควรมีรายงานเฉพาะในกรณีที่ข้อมูลแรกสุดในรายงานตรงกับหรือหลังวันที่ที่ระบุ ในทำนองเดียวกัน พารามิเตอร์ startTimeBefore บ่งชี้ว่าการตอบกลับของ API ควรมีรายงานเฉพาะในกรณีที่ข้อมูลแรกสุดในรายงานอยู่ก่อนวันที่ที่ระบุ

        พารามิเตอร์ใหม่เกี่ยวข้องกับข้อมูลในรายงาน ซึ่งต่างจากพารามิเตอร์ createdAfter ของเมธอดซึ่งเกี่ยวข้องกับเวลาที่สร้างรายงาน

      • พร็อพเพอร์ตี้ systemManaged ใหม่ของทรัพยากร reportType จะระบุว่าทรัพยากรนั้นอธิบายรายงานที่จัดการโดยระบบหรือไม่

      • พารามิเตอร์ includeSystemManaged ใหม่ของเมธอด reportTypes.list จะระบุว่าการตอบกลับจาก API ควรรวมรายงานที่จัดการโดยระบบหรือไม่ ค่าเริ่มต้นของพารามิเตอร์คือ false

    28 มีนาคม 2016

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

    • ใน API การรายงานของ YouTube มิติข้อมูล sharing_service จะรองรับค่าใหม่ต่อไปนี้
      • 82: กล่องโต้ตอบกิจกรรมของระบบ iOS
      • 83: Google Inbox
      • 84: Android Messenger
    • ใน API ของข้อมูลวิเคราะห์ YouTube มิติข้อมูล sharingService รองรับค่าใหม่ต่อไปนี้
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: Google Inbox
      • IOS_SYSTEM_ACTIVITY_DIALOG: กล่องโต้ตอบกิจกรรมของระบบ iOS

    16 มีนาคม 2016

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ ซึ่งจะมีผลกับทั้ง Reporting API ของ YouTube และ YouTube Analytics API

    API การรายงานของ YouTube

    • มิติข้อมูล playback_location_type รองรับค่ามิติข้อมูลใหม่ 2 ค่า ได้แก่
      • 7: ข้อมูลเกี่ยวข้องกับยอดดูที่เกิดขึ้นในหน้าแรกของ YouTube หรือหน้าจอหลักในฟีดการติดตามของผู้ใช้ หรือในฟีเจอร์การเรียกดูอื่นๆ ของ YouTube
      • 8: ข้อมูลนี้เกี่ยวข้องกับยอดดูที่เกิดขึ้นโดยตรงในหน้าผลการค้นหาของ YouTube
    • ขณะนี้มิติข้อมูล traffic_source_type รองรับ 18 เป็นค่ามิติข้อมูลแล้ว ค่านี้จะระบุว่าการดูวิดีโอมาจากหน้าเว็บที่แสดงวิดีโอทั้งหมดในเพลย์ลิสต์ แหล่งที่มานี้แตกต่างจากประเภทแหล่งที่มา 14 ซึ่งระบุว่ายอดดูเกิดขึ้นขณะที่วิดีโอกำลังเล่นโดยเป็นส่วนหนึ่งของเพลย์ลิสต์

    API ของข้อมูลวิเคราะห์ YouTube

    • มิติข้อมูล insightPlaybackLocationType รองรับค่ามิติข้อมูลใหม่ 2 ค่า ได้แก่
      • BROWSE: ข้อมูลเกี่ยวข้องกับยอดดูที่เกิดขึ้นในหน้าแรกของ YouTube หรือหน้าจอหลักในฟีดการติดตามของผู้ใช้ หรือในฟีเจอร์การเรียกดูอื่นๆ ของ YouTube
      • SEARCH: ข้อมูลนี้เกี่ยวข้องกับยอดดูที่เกิดขึ้นโดยตรงในหน้าผลการค้นหาของ YouTube
    • ขณะนี้มิติข้อมูล insightTrafficSourceType รองรับ YT_PLAYLIST_PAGE เป็นค่ามิติข้อมูลแล้ว ค่านี้จะระบุว่าการดูวิดีโอมาจากหน้าเว็บที่แสดงวิดีโอทั้งหมดในเพลย์ลิสต์ แหล่งที่มานี้แตกต่างจากแหล่งที่มาประเภท PLAYLIST ซึ่งบ่งชี้ว่ายอดดูเกิดขึ้นขณะที่วิดีโอกำลังเล่นโดยเป็นส่วนหนึ่งของเพลย์ลิสต์

    8 กุมภาพันธ์ 2016

    รายการเมตริกที่รองรับสำหรับ API ของ YouTube Analytics แล้วเพื่อไม่ให้เมตริกการ์ดแสดงเป็นเมตริกที่รองรับสำหรับ API นั้นอีกต่อไป (ไม่มีการบันทึกรายงานของ API นั้นว่าสนับสนุนเมตริกใดๆ ของการ์ด)

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

    6 มกราคม 2016

    ขณะนี้ทั้ง API การรายงานของ YouTube และ YouTube Analytics API จะระบุข้อมูลพร็อพเพอร์ตี้ที่เกิดขึ้นผ่านอุปกรณ์ Chromecast โดยเฉพาะ

    • ใน API การรายงานของ YouTube มิติข้อมูล operating_system จะใช้ค่า 21 เพื่อระบุข้อมูลพร็อพเพอร์ตี้ที่เกิดขึ้นผ่าน Chromecast
    • ใน API ของ YouTube Analytics มิติข้อมูล operatingSystem จะใช้ค่า CHROMECAST เพื่อระบุข้อมูลพร็อพเพอร์ตี้ที่เกิดขึ้นผ่าน Chromecast

    21 ธันวาคม 2015

    ในเอกสารประกอบ เราได้อัปเดตชื่อของเมตริก annotation_clickable_impressions และ annotation_closable_impressions ให้ตรงกับชื่อที่ปรากฏในรายงาน ก่อนหน้านี้บันทึกชื่อเป็น clickable_annotation_impressions และ closable_annotation_impressions

    18 ธันวาคม 2015

    กฎหมายของสหภาพยุโรป (EU) กำหนดให้มีการเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ปลายทางในสหภาพยุโรปและได้รับความยินยอมจากผู้ใช้ปลายทาง ดังนั้นสำหรับผู้ใช้ปลายทางในสหภาพยุโรป คุณจะต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU เราได้เพิ่มประกาศข้อกำหนดนี้ไว้ในข้อกำหนดในการให้บริการ API ของ YouTube แล้ว

    15 ธันวาคม 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ ซึ่งทั้งหมดจะส่งผลต่อ API ของข้อมูลวิเคราะห์ YouTube

    • ขณะนี้ API ของ YouTube Analytics รองรับมิติข้อมูลรายละเอียดการเล่นใหม่ 3 แบบ ซึ่งสามารถนำไปใช้ในรายงานช่องและเจ้าของเนื้อหาได้หลากหลาย ดังนี้

      • liveOrOnDemand: มิติข้อมูลนี้ระบุว่าข้อมูลในรายงานอธิบายกิจกรรมของผู้ใช้ที่เกิดขึ้นระหว่างการถ่ายทอดสดหรือไม่
      • subscribedStatus: มิติข้อมูลนี้ระบุว่าเมตริกกิจกรรมของผู้ใช้ในข้อมูลเชื่อมโยงกับผู้ชมที่ติดตามช่องของวิดีโอหรือเพลย์ลิสต์หรือไม่
      • youtubeProduct: มิติข้อมูลนี้ระบุพร็อพเพอร์ตี้ YouTube ที่เกิดกิจกรรมของผู้ใช้ ค่าที่เป็นไปได้ ได้แก่ เว็บไซต์ YouTube หลัก (หรือแอป YouTube), YouTube Gaming และ YouTube Kids

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

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

      เนื้อหา
      มิติข้อมูล:
      ต้องระบุ deviceType
      ใช้ 0 ขึ้นไป day, liveOrOnDemand, subscribedStatus, youtubeProduct
      เมตริก:
      ใช้ 1 รายการขึ้นไป views, estimatedMinutesWatched
      ตัวกรอง:
      ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent
      ใช้ 0 หรือ 1 วิดีโอ, กลุ่ม
      ใช้ 0 ขึ้นไป operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

    • ตอนนี้ API ของข้อมูลวิเคราะห์ YouTube จะทิ้งเอนทิตีที่ผู้ใช้ API ไม่สามารถเรียกข้อมูลจากตัวกรองที่รองรับหลายค่า (video, playlist และ channel) ได้โดยอัตโนมัติ ก่อนหน้านี้ เซิร์ฟเวอร์ API จะส่งคืนข้อผิดพลาดหากผู้ใช้ API เข้าถึงข้อมูลสำหรับรายการที่ระบุอย่างน้อย 1 รายการไม่ได้

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

    • หากคุณขอข้อมูลสำหรับ group ของ YouTube Analytics ที่ว่างเปล่า ตอนนี้ API จะแสดงผลชุดข้อมูลที่ว่างเปล่าแทนข้อผิดพลาด

    • ตอนนี้เมธอด groupItems.insert ของ YouTube Analytics API จะแสดงข้อผิดพลาดที่ไม่ได้รับอนุญาต (รหัสการตอบกลับ HTTP 403) ที่ไม่ได้รับอนุญาต หากคุณพยายามเพิ่มเอนทิตีลงในกลุ่มแต่ไม่มีสิทธิ์เข้าถึงเอนทิตีนั้น ก่อนหน้านี้ API จะอนุญาตให้คุณสามารถเพิ่มเอนทิตีลงในกลุ่มได้ แต่ในภายหลังแสดงข้อผิดพลาดที่ไม่ได้รับอนุญาตเมื่อคุณพยายามเรียกข้อมูลรายงานของกลุ่มนั้น

    • ตอนนี้เมธอด groups.list ของ YouTube Analytics API รองรับการใส่เลขหน้าแล้ว หากการตอบกลับของ API ไม่มีกลุ่มที่ใช้ได้ทั้งหมด พารามิเตอร์ nextPageToken ของการตอบกลับจะระบุโทเค็นที่ใช้เพื่อดึงผลการค้นหาหน้าถัดไปได้ ตั้งค่าพารามิเตอร์ pageToken ของเมธอดเป็นค่านั้นเพื่อดึงผลลัพธ์เพิ่มเติม

    10 พฤศจิกายน 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • ขณะนี้ API ของ YouTube Analytics รองรับเมตริก redPartnerRevenue แล้ว ซึ่งจะรายงานรายได้โดยประมาณทั้งหมดที่ได้รับจากการติดตาม YouTube Red สำหรับมิติข้อมูลรายงานที่เลือก ค่าของเมตริกแสดงถึงรายได้จากทั้งเนื้อหาเพลงและเนื้อหาที่ไม่ใช่เพลง และอาจมีการปรับค่าใช้จ่ายตอนสิ้นเดือน

      รายการรายงานเจ้าของเนื้อหาของ YouTube Analytics API ได้รับการอัปเดตเพื่อระบุรายงานวิดีโอที่รองรับเมตริก redPartnerRevenue ต่อไปนี้

    • ปัจจุบันนี้ คำจำกัดความของรายงานวิดีโอยอดนิยมสำหรับ API ของ YouTube Analytics สะท้อนให้เห็นว่ารายงานนี้รองรับเมตริกรายได้ต่อไปนี้ด้วย ได้แก่ earnings, adEarnings, grossRevenue, monetizedPlaybacks, playbackBasedCpm, impressions และ impressionBasedCpm

    29 ตุลาคม 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • เอกสารสำหรับมิติข้อมูล date ของ YouTube Reporting API ได้รับการแก้ไขแล้วให้ตรงกับวันที่ที่อ้างอิงระยะเวลา 24 ชั่วโมงซึ่งเริ่มตั้งแต่เวลา 00:00 น. ตามเวลาแปซิฟิก (UTC-8) ก่อนหน้านี้ เอกสารประกอบระบุว่าวันที่เริ่มต้นเวลา 00:00 น. (GMT)

      นอกจากนี้ ได้อัปเดตเอกสารประกอบของ YouTube Analytics API ให้ทราบว่ามิติข้อมูลที่เกี่ยวกับวันที่ทั้งหมด (day, 7DayTotals, 30DayTotals และ month) อ้างอิงถึงวันที่ที่เริ่มต้นเวลา 00:00 น. ตามเวลาแปซิฟิก (UTC-8)

    • ขณะนี้เมธอด jobs.reports.list() ของ YouTube Reporting API รองรับพารามิเตอร์การค้นหา createdAfter แล้ว หากระบุไว้ พารามิเตอร์นี้บ่งชี้ว่าการตอบกลับของ API ควรแสดงรายการรายงานที่สร้างหลังจากวันที่และเวลาที่ระบุเท่านั้น รวมถึงรายงานใหม่ที่มีข้อมูลทดแทน โปรดทราบว่าค่าพารามิเตอร์เกี่ยวข้องกับเวลาที่สร้างรายงาน ไม่ใช่วันที่ที่เชื่อมโยงกับข้อมูลที่แสดงผล

      ค่าพารามิเตอร์คือการประทับเวลาใน RFC3339 UTC "Zulu" แม่นยำในระดับไมโครวินาที ตัวอย่าง: "2015-10-02T15:01:23.045678Z"

      นอกจากนี้ เรายังปรับปรุงแนวทางปฏิบัติแนะนำสำหรับ Reporting API ของ YouTube เพื่ออธิบายวิธีใช้พารามิเตอร์ createdAfter เพื่อหลีกเลี่ยงการประมวลผลรายงานเดียวกันซ้ำๆ อีกด้วย

    • แก้ไขคําจํากัดความของพร็อพเพอร์ตี้ createTime ของทรัพยากร job และพร็อพเพอร์ตี้ startTime, endTime และ createTime ของทรัพยากร report ทั้งหมดแล้ว โปรดทราบว่าค่าพร็อพเพอร์ตี้ถูกต้องเป็นไมโครวินาที ไม่ใช่นาโนวินาที นอกจากนี้ คำจำกัดความทั้งหมดยังสะท้อนได้ถูกต้องว่าค่าของพร็อพเพอร์ตี้มีการประทับเวลา

    8 ตุลาคม 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

      เรายังอัปเดตคําจํากัดความของมิติข้อมูล sharing_service ของ YouTube Reporting API เพื่อแสดงค่าที่รองรับใหม่ด้วย ค่า enum ที่มากกว่า 59 คือค่าใหม่ในรายการ

    24 กันยายน 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • Reporting API ของ YouTube ใหม่จะดึงรายงานข้อมูลจำนวนมากที่มีข้อมูล YouTube Analytics สำหรับช่องหรือเจ้าของเนื้อหา โดยออกแบบมาสำหรับแอปพลิเคชันที่สามารถนำเข้าชุดข้อมูลขนาดใหญ่และมีเครื่องมือในการกรอง จัดเรียง และขุดค้นข้อมูลนั้น

      รายงาน Reporting API ของ YouTube แต่ละฉบับจะมีชุดมิติข้อมูลและเมตริกที่กำหนดไว้ล่วงหน้า (รายงาน API ของ YouTube Analytics ยังใช้เมตริกและมิติข้อมูลด้วย) ในรายงาน ข้อมูลแต่ละแถวจะมีชุดค่าผสมของค่ามิติข้อมูลที่ไม่ซ้ำกัน คุณสามารถรวมข้อมูลในแถวต่างๆ ตามค่ามิติข้อมูลเพื่อคำนวณเมตริกสำหรับวิดีโอแต่ละรายการ ประเทศ วิดีโอสด ผู้ใช้ที่เป็นผู้ติดตาม ฯลฯ

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

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

      • แท็บคำแนะนำในชุดเอกสารมีข้อมูลที่พบได้บ่อยสำหรับ API ทั้งสอง ซึ่งรวมถึงวิธีการให้สิทธิ์คำขอ API
      • แท็บรายงานแบบเป็นกลุ่มมีเอกสารอ้างอิงและเนื้อหาอื่นๆ สำหรับ Reporting API ของ YouTube โดยเฉพาะ
      • แท็บการค้นหาที่กำหนดเป้าหมายมีเอกสารอ้างอิงและเนื้อหาอื่นๆ สำหรับ API ของ YouTube Analytics โดยเฉพาะ
      • แท็บตัวอย่างจะแสดงตัวอย่างโค้ดที่พร้อมใช้งานสำหรับ API ใด API หนึ่ง
      • แท็บเครื่องมือแสดงรายการแหล่งข้อมูลเพิ่มเติมเพื่อช่วยนักพัฒนาซอฟต์แวร์ในการใช้งาน API อย่างใดอย่างหนึ่ง

    20 สิงหาคม 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

      • เอกสารจะมีหน้าหนึ่งที่แสดงรายงานช่องที่ใช้ได้ทั้งหมด และอีกหน้าที่แสดงรายงานเจ้าของเนื้อหาที่มีอยู่ทั้งหมด ซึ่งก่อนหน้านี้เอกสารดังกล่าวมีหน้าต่างๆ แยกสำหรับรายงานวิดีโอของช่อง รายงานเพลย์ลิสต์ของช่อง เป็นต้น

      • ภาพรวมของโมเดลข้อมูลใหม่พยายามให้ข้อมูลเบื้องต้นที่ชัดเจนยิ่งขึ้นเกี่ยวกับวิธีการทำงานของ API โดยเฉพาะอย่างยิ่ง เอกสารนี้จะพยายามอธิบายวิธีที่ YouTube ใช้เมตริก มิติข้อมูล และตัวกรองในการคำนวณค่าของรายงานให้ดียิ่งขึ้น

      • ตอนนี้เมธอด reports.query ของ API ที่คุณใช้เพื่อเรียกรายงานจะได้รับการจัดทำเอกสารแยกกัน ก่อนหน้านี้ ข้อมูลในหน้านั้นมีอยู่ในหน้าเว็บอื่นๆ มาก่อนแล้ว หน้าเว็บใหม่นี้ออกแบบมาเพื่อช่วยให้คุณค้นหาข้อมูลที่ต้องการส่งเพื่อเรียกดูรายงานได้ง่ายขึ้น

    22 กรกฎาคม 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงหลายอย่าง ซึ่งทั้งหมดนี้จะมีผลกับเจ้าของเนื้อหาเท่านั้น ได้แก่

    • เมตริก adEarnings ใหม่ประกอบด้วยรายได้โดยประมาณทั้งหมด (รายได้สุทธิ) จากแหล่งที่มาของโฆษณาทั้งหมดที่ Google เป็นผู้ขาย ไม่ใช่เมตริกหลัก API รองรับเมตริก adEarnings สำหรับรายงานที่รองรับเมตริก earnings อยู่แล้ว

      นอกจากนี้ ยังแก้ไขคำจำกัดความของเมตริก earnings เพื่อแสดงถึงข้อเท็จจริงที่ว่าค่าของเมตริกประกอบด้วยรายได้โดยประมาณทั้งหมดจากแหล่งที่มาของการโฆษณาทั้งหมดที่ Google เป็นผู้ขาย และจากแหล่งที่มาที่ไม่ใช่การโฆษณา ก่อนหน้านี้ คําจํากัดความที่ระบุไม่ถูกต้องว่าเมตริกรวมเฉพาะรายได้จากแหล่งที่มาของการโฆษณาเท่านั้น

    • เมตริก primaryAdGrossRevenue เลิกใช้งานแล้ว ให้ใช้เมตริก grossRevenue เพื่อดึงข้อมูลรายได้แทน

    • นอกเหนือจากเมตริก primaryAdGrossRevenue ที่เลิกใช้งานแล้ว รายงานประสิทธิภาพของโฆษณาจะไม่รองรับเมตริก monetizedPlaybacks และ playbackBasedCpm อีกต่อไป อย่างไรก็ตาม รายงานวิดีโอหลายรายงานยังคงรองรับเมตริกเหล่านั้น

    1 มิถุนายน 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

      • videosAddedToPlaylists – จำนวนครั้งที่มีการเพิ่มวิดีโอในขอบเขตการค้นหาลงในเพลย์ลิสต์ YouTube วิดีโออาจเพิ่มลงในเพลย์ลิสต์ของเจ้าของวิดีโอหรือช่องอื่น เพลย์ลิสต์
      • videosRemovedFromPlaylists – จำนวนครั้งที่วิดีโอในขอบเขตการค้นหาถูกนำออกจากเพลย์ลิสต์ YouTube วิดีโอดังกล่าวอาจถูกนำออกจากเพลย์ลิสต์ของเจ้าของวิดีโอหรือจากช่องอื่น เพลย์ลิสต์

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

      ข้อมูลสำหรับเมตริกเหล่านี้ใช้ได้ตั้งแต่วันที่ 1 ตุลาคม 2014

    31 มีนาคม 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    16 มีนาคม 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • พารามิเตอร์ currency ใหม่ช่วยให้คุณดึงเมตริกรายได้ในสกุลเงินอื่นที่ไม่ใช่ดอลลาร์สหรัฐ (USD) ได้ หากมีการตั้งค่าพารามิเตอร์แล้ว API จะแปลงค่าสำหรับเมตริก earnings, grossRevenue, playbackBasedCpm และ impressionBasedCpm เป็นสกุลเงินที่ระบุ มูลค่าที่แสดงผลเป็นค่าประมาณที่คำนวณโดยใช้อัตราแลกเปลี่ยนที่เปลี่ยนแปลงในแต่ละวัน

      ค่าพารามิเตอร์คือรหัสสกุลเงิน ISO 4217 ที่เป็นตัวอักษร 3 ตัว ค่าเริ่มต้นคือ USD คำจำกัดความของพารามิเตอร์มีรายการรหัสสกุลเงินที่รองรับ

    25 กุมภาพันธ์ 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • โดยปัจจุบัน API นี้รองรับการสร้างและจัดการกลุ่ม YouTube Analytics รวมถึงเรียกข้อมูลรายงานของกลุ่มเหล่านั้นด้วย

      • การสร้างและจัดการกลุ่ม

        การอัปเดตนี้จะแนะนำทรัพยากร group และ groupItem สำหรับการสร้างและจัดการกลุ่ม

        • ทรัพยากร group แสดงกลุ่ม Analytics ซึ่งเป็นคอลเล็กชันที่กำหนดเองที่มีช่อง วิดีโอ เพลย์ลิสต์ หรือเนื้อหาสูงสุด 200 รายการ API รองรับเมธอด list, insert, update และ delete สำหรับทรัพยากรนี้
        • ทรัพยากร groupItem แสดงรายการในกลุ่ม Analytics API รองรับเมธอด list, insert และ delete สำหรับทรัพยากรนี้

        ตัวอย่างเช่น คุณสามารถสร้างกลุ่มโดยใช้เมธอด groups.insert แล้วเพิ่มรายการลงในกลุ่มนั้นโดยใช้เมธอด groupItems.insert

      • การดึงข้อมูลรายงานของกลุ่ม

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

      ดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่มต่างๆ ของ YouTube Analytics ได้ที่ศูนย์ช่วยเหลือของ YouTube

    13 กุมภาพันธ์ 2015

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • API ไม่รองรับมิติข้อมูล show อีกต่อไป

    28 สิงหาคม 2014

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • ตอนนี้ API รองรับความสามารถในการระบุค่าหลายค่าสำหรับมิติข้อมูล video, playlist, channel และ show เมื่อมีการใช้มิติข้อมูลเหล่านั้นเป็นตัวกรอง หากต้องการระบุหลายค่า ให้ตั้งค่าพารามิเตอร์ filters เป็นรายการที่คั่นด้วยเครื่องหมายจุลภาคของวิดีโอ เพลย์ลิสต์ ช่อง หรือแสดงรหัสที่ควรกรองการตอบกลับจาก API ค่าพารามิเตอร์จะระบุรหัสได้สูงสุด 200 รายการ

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

      ดูคำจำกัดความพารามิเตอร์ filters เพื่อดูรายละเอียดทั้งหมดเกี่ยวกับฟังก์ชันนี้

    16 กรกฎาคม 2014

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • เมื่อดึงรายงานแชแนล ตอนนี้คุณสามารถเรียกข้อมูลสำหรับแชแนลของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้วได้โดยตั้งค่าของพารามิเตอร์ ids เป็น channel==MINE (คุณยังคงตั้งค่าพารามิเตอร์ ids เป็น channel==CHANNEL_ID เพื่อดึงข้อมูลสำหรับแชแนลที่ระบุได้อยู่)

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

      รายงานเพลย์ลิสต์ทั้งหมดรองรับเมตริก views และ estimatedMinutesWatched และบางรายงานรองรับเมตริก averageViewDuration ด้วย

      นอกจากนี้ รายงานเพลย์ลิสต์ทั้งหมดยังรองรับเมตริกใหม่ต่อไปนี้ด้วย โปรดทราบว่าเมตริกแต่ละรายการข้างต้นจะแสดงเฉพาะยอดดูเพลย์ลิสต์ที่เกิดขึ้นบนเว็บเท่านั้น

      • playlistStarts: จำนวนครั้งที่ผู้ชมเล่นเพลย์ลิสต์
      • viewsPerPlaylistStart: จำนวนการดูวิดีโอโดยเฉลี่ยที่เกิดขึ้นทุกครั้งที่มีการสร้างเพลย์ลิสต์
      • averageTimeInPlaylist: เวลาเฉลี่ยโดยประมาณในหน่วยนาทีที่ผู้ชมดูวิดีโอในเพลย์ลิสต์หลังจากเริ่มเพลย์ลิสต์

      คำขอเรียกรายงานเพลย์ลิสต์จะต้องใช้ตัวกรอง isCurated ซึ่งต้องตั้งค่าเป็น 1 (isCurated==1)

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

      • เมตริก audienceWatchRatio ระบุอัตราส่วนสัมบูรณ์ของผู้ชมที่ดูวิดีโอในจุดที่ระบุในวิดีโอ อัตรานี้คำนวณโดยการเปรียบเทียบจำนวนครั้งที่มีการดูวิดีโอบางส่วนกับยอดดูทั้งหมดของวิดีโอ

        โปรดทราบว่าส่วนหนึ่งของวิดีโออาจมีการรับชมมากกว่า 1 ครั้ง (หรือดูไม่ได้เลย) ในการดูวิดีโอหนึ่งๆ ตัวอย่างเช่น หากผู้ใช้กรอกลับและดูวิดีโอส่วนเดียวกันหลายครั้ง อัตราส่วนสัมบูรณ์ของวิดีโอในส่วนดังกล่าวอาจมากกว่า 1

      • เมตริก relativeRetentionPerformance แสดงให้เห็นว่าวิดีโอคงผู้ชมไว้ได้ดีเพียงใดระหว่างการเล่นเมื่อเทียบกับวิดีโอ YouTube ทั้งหมดที่มีความยาวใกล้เคียงกัน ค่า 0 หมายความว่าวิดีโอรักษาผู้ชมได้แย่กว่าวิดีโออื่นๆ ที่มีความยาวเท่าๆ กัน ในขณะที่ค่า 1 หมายความว่าวิดีโอดังกล่าวรักษาผู้ชมได้ดีกว่าวิดีโออื่นๆ ที่มีความยาวเท่าๆ กัน ค่ามัธยฐานที่ 0.5 บ่งชี้ว่าครึ่งหนึ่งของวิดีโอที่มีความยาวใกล้เคียงกันสามารถคงผู้ชมไว้ได้นานกว่า ขณะที่อีกครึ่งหนึ่งคงผู้ชมไว้ได้แย่กว่า

      คุณยังสามารถใช้ตัวกรอง audienceType เพื่อให้รายงานแสดงเฉพาะข้อมูลที่เชื่อมโยงกับการดูทั่วไป การดูจากโฆษณา TrueView ในสตรีม หรือการดูจากโฆษณา TrueView แบบบนหน้าจอเท่านั้น (การดูทั่วไปคือผลลัพธ์โดยตรงจากการกระทำของผู้ใช้ เช่น การค้นหาวิดีโอหรือการคลิกวิดีโอแนะนำ)

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

      • annotationImpressions: จำนวนการแสดงผลคำอธิบายประกอบทั้งหมด
      • annotationClickableImpressions: จำนวนคำอธิบายประกอบที่ปรากฏและสามารถคลิกได้
      • annotationClosableImpressions: จำนวนคำอธิบายประกอบที่ปรากฏและปิดได้
      • annotationClicks: จำนวนรวมของคำอธิบายประกอบที่มีการคลิก
      • annotationCloses: จำนวนคำอธิบายประกอบที่ปิดทั้งหมด

      เมตริกใหม่ทั้งหมดเป็นเมตริกหลักและอยู่ภายใต้นโยบายการเลิกใช้งาน อย่างไรก็ตาม โปรดทราบว่าจะมีข้อมูลสำหรับเมตริกใหม่ตั้งแต่วันที่ 16 กรกฎาคม 2013 เป็นต้นไป (ข้อมูลสำหรับเมตริก annotationClickThroughRate และ annotationCloseRate ใช้ได้ ณ วันที่ 10 มิถุนายน 2012)

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

    31 มกราคม 2014

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    16 มกราคม 2014

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

      • สถิติพื้นฐาน
      • แบบเวลา
      • ภูมิศาสตร์
      • ตำแหน่งที่เล่น
      • แหล่งที่มาของการเข้าชม
      • อุปกรณ์/ระบบปฏิบัติการ
      • ข้อมูลประชากร
      • โซเชียล
      • รายได้/โฆษณา (สำหรับรายงานของเจ้าของเนื้อหาเท่านั้น)

    • ตอนนี้เอกสารตัวอย่างคำขอมีตัวอย่างใหม่สำหรับการดึงข้อมูลเฉพาะจังหวัดในรายงานช่องหรือรายงานเจ้าของเนื้อหา

      • เมตริกเฉพาะจังหวัดสำหรับรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี.: รายงานนี้แสดงการแจกแจงข้อมูลย่อยตามจังหวัดของจำนวนการดูและสถิติอื่นๆ สำหรับวิดีโอของช่อง ข้อมูลนี้ครอบคลุมรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี. ตัวอย่างนี้ใช้มิติข้อมูล province และยังใช้พารามิเตอร์ filters เพื่อจำกัดการตอบกลับให้รวมเฉพาะผลการค้นหาของสหรัฐอเมริกาเท่านั้น

      • ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ): รายงานนี้จะดึงสถิติเกี่ยวกับกลุ่มอายุและเพศของผู้ชมในแคลิฟอร์เนียที่ดูวิดีโอของช่อง หรือดูรายงานของเจ้าของเนื้อหาโดยอิงจากเนื้อหาที่เจ้าของเนื้อหาอ้างสิทธิ์ ตัวอย่างนี้ใช้พารามิเตอร์ filters เพื่อให้มั่นใจว่าการตอบกลับจะมีเฉพาะข้อมูลของจังหวัดหนึ่งๆ เท่านั้น

    • คําจํากัดความของมิติข้อมูล province ได้รับการอัปเดตให้ทราบว่าเมื่อมีการรวม province ในค่าพารามิเตอร์ dimensions คําขอจะต้องจํากัดข้อมูลไว้เฉพาะสหรัฐอเมริกาด้วยโดยใส่ country==US ในค่าพารามิเตอร์ filters

    6 มกราคม 2014

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • เอกสารที่แสดงรายงานช่องและเจ้าของเนื้อหาที่รองรับได้รับการออกแบบใหม่ แทนที่จะจัดทำตารางที่แสดงรายการรายงานที่เป็นไปได้ทั้งหมด เอกสารแต่ละรายการจะจัดกลุ่มรายงานเป็นหมวดหมู่ต่างๆ แทน ดังนี้

      • สถิติพื้นฐาน
      • แบบเวลา
      • ภูมิศาสตร์
      • ตำแหน่งที่เล่น
      • แหล่งที่มาของการเข้าชม
      • อุปกรณ์/ระบบปฏิบัติการ
      • ข้อมูลประชากร
      • โซเชียล
      • วิดีโอยอดนิยม

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

    • ขณะนี้ API สนับสนุนมิติข้อมูลทางภูมิศาสตร์ใหม่ 3 รายการ ได้แก่ province, continent และ subContinent

      • มิติข้อมูล province ช่วยให้คุณสามารถเรียกดูสถิติสำหรับรัฐในสหรัฐอเมริกาและเขตของโคลอมเบียได้ API รองรับการใช้งาน 2 แบบสำหรับมิติข้อมูลนี้

        • API รองรับรายงาน 2 ประเภทที่แบ่งสถิติออกตามรัฐ รายงานทั้ง 2 อย่างนี้จะพร้อมใช้งานสำหรับช่องและเจ้าของเนื้อหา

          • รายงานสถิติหลักแสดงสถิติหลายอย่าง รวมถึงจำนวนการดูและจำนวนนาทีที่ดูโดยประมาณ
          • รายงานตามเวลาให้สถิติเดียวกัน แต่รวบรวมข้อมูลแบบรายวัน, 7 วัน, 30 วัน หรือรายเดือน

        • คุณสามารถใช้พารามิเตอร์การค้นหา filters เพื่อจำกัดให้รายงานมีเฉพาะสถิติสําหรับรัฐหนึ่งๆ เท่านั้น รายงานหลายรายงานรองรับการกรองประเภทนี้ รวมทั้งรายงานทางภูมิศาสตร์ รายงานตำแหน่งที่เล่น รายงานแหล่งที่มาของการเข้าชม รายงานอุปกรณ์ รายงานระบบปฏิบัติการ รายงานข้อมูลประชากร และรายงานวิดีโอยอดนิยม

      • มิติข้อมูล continent ระบุรหัสภูมิภาคทางสถิติของสหประชาชาติ (UN) ที่ระบุทวีป มิติข้อมูลนี้สามารถใช้เป็นตัวกรองเท่านั้น

      • มิติข้อมูล subContinent ระบุรหัสภูมิภาคทางสถิติของสหประชาชาติ (UN) ที่ระบุภูมิภาคย่อยของทวีป มิติข้อมูลนี้สามารถใช้เป็นตัวกรองเท่านั้น

        เนื่องจากแต่ละภูมิภาคย่อยเชื่อมโยงกับทวีปเดียวเท่านั้น คุณจึงไม่จำเป็นต้องใช้ตัวกรอง continent เมื่อใช้ตัวกรอง subContinent (ที่จริงแล้ว API จะส่งกลับข้อผิดพลาดหากคำขอใช้มิติข้อมูลทั้ง 2 แบบ)

    • เอกสารได้รับการแก้ไขแล้วเพื่อให้มิติข้อมูล insightTrafficSourceDetail ไม่ได้รวมค่า insightTrafficSourceType PROMOTED เป็นค่าตัวกรองที่ถูกต้อง

    30 กันยายน 2013

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

    • ตอนนี้ API รองรับ EXTERNAL_APP เป็นค่าสำหรับมิติข้อมูล insightPlaybackLocationType แล้ว ในการอัปเดตนี้ ในวันที่ 10 กันยายน 2013 การเล่นจะไม่จัดอยู่ในหมวดหมู่การเล่น MOBILE อีกต่อไป แม้ว่าการเล่นบนอุปกรณ์เคลื่อนที่ที่เกิดขึ้นก่อนวันที่ดังกล่าวจะยังคงถูกจัดหมวดหมู่ด้วยค่าดังกล่าว

      การอัปเดตนี้ทำให้การเล่นบนอุปกรณ์เคลื่อนที่ได้รับการจัดประเภทเป็นการเล่น WATCH, EMBEDDED หรือ EXTERNAL_APP ทั้งนี้ขึ้นอยู่กับประเภทของแอปพลิเคชันที่มีการเล่น

    • ตอนนี้ API รองรับ PLAYLIST เป็นค่าสำหรับมิติข้อมูล insightTrafficSourceType แล้ว ค่านี้ระบุว่ายอดดูวิดีโอมาจากเพลย์ลิสต์ ก่อนหน้านี้ ข้อมูลพร็อพเพอร์ตี้เหล่านี้จะได้รับการจัดประเภทโดยใช้หมวดหมู่ YT_OTHER_PAGE ของมิติข้อมูล

    16 กรกฎาคม 2013

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • ปัจจุบัน API รองรับการจัดเรียงรายงานตามมิติข้อมูลและเมตริกต่างๆ เอกสารคำขอตัวอย่างมีตัวอย่างใหม่ที่ชื่อการจัดเรียงคำขอตามมิติข้อมูล/เมตริกหลายรายการที่แสดงฟังก์ชันการทำงานนี้ คำขอจะดึงข้อมูลแหล่งที่มาของการเข้าชมและมีค่าพารามิเตอร์ sort เป็น day,-views ผลลัพธ์จะจัดเรียงตามลำดับเวลา แต่ภายในชุดผลลัพธ์ของแต่ละวัน แถวแรกจะมีข้อมูลแหล่งที่มาของการเข้าชมที่ทำให้เกิดการดูมากที่สุด ส่วนแถวที่สองจะมีข้อมูลของแหล่งที่มาที่ทำให้เกิดการดูสูงสุดลำดับถัดไป เป็นต้น

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

      • รายงาน deviceType ช่วยให้คุณสามารถดึงข้อมูลจำนวนการดูและเวลาในการรับชมโดยประมาณสำหรับอุปกรณ์ประเภทต่างๆ รวมถึงเดสก์ท็อป มือถือ และแท็บเล็ต นอกจากนี้ คุณยังสามารถใช้ตัวกรอง operatingSystem เพื่อจำกัดรายงานประเภทอุปกรณ์ให้เก็บเฉพาะสถิติบนอุปกรณ์ที่ใช้ระบบปฏิบัติการที่เฉพาะเจาะจงเท่านั้น เช่น Android หรือ iOS

      • รายงาน operatingSystem ช่วยให้คุณสามารถดึงข้อมูลยอดดูและเวลาในการรับชมโดยประมาณสำหรับระบบปฏิบัติการต่างๆ เช่น Android, iOS, Linux และอื่นๆ นอกจากนี้ คุณยังสามารถใช้ตัวกรอง deviceType เพื่อจำกัดให้รายงานระบบปฏิบัติการมีเฉพาะสถิติบางประเภทของอุปกรณ์ เช่น อุปกรณ์เคลื่อนที่หรือแท็บเล็ต

      ประเภทอุปกรณ์และรายงานระบบปฏิบัติการใหม่จะพร้อมใช้งานสำหรับช่องทางและเจ้าของเนื้อหา

    • เอกสารตัวอย่างคำขอได้รับการอัปเดตเพื่อรวมรายงานอุปกรณ์ 3 ฉบับสำหรับช่อง และรายงานอุปกรณ์ 3 ฉบับสำหรับเจ้าของเนื้อหา

    • มิติข้อมูล insightPlaybackLocationType อาจแสดงผลค่า YT_OTHER ซึ่งระบุข้อมูลพร็อพเพอร์ตี้ที่ไม่ได้รับการจัดประเภทโดยใช้ค่าอื่นๆ ของมิติข้อมูล

    23 พฤษภาคม 2013

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    10 พฤษภาคม 2013

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    6 พฤษภาคม 2013

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • ขณะนี้ API รองรับความสามารถในการดึงข้อมูลเมตริกเวลาในการรับชม เช่น estimatedMinutesWatched, averageViewDuration และ averageViewPercentage ร่วมกับเมตริกอื่นๆ ซึ่งรวมถึงเมตริกยอดดู เมตริกการมีส่วนร่วม เมตริกรายได้ และเมตริกประสิทธิภาพโฆษณา

      รายการรายงานช่องและรายงานเจ้าของเนื้อหาที่พร้อมใช้งานได้รับการอัปเดตเพื่อแสดงการเปลี่ยนแปลงนี้ (จริงๆ แล้วรายการสั้นลงเนื่องจากสามารถดึงข้อมูลเมตริกเวลาในการรับชมเป็นส่วนหนึ่งของรายงานอื่นๆ ที่แสดงในรายการได้)

      นอกจากนี้ เอกสารตัวอย่างคำขอ API ก็ได้รับการอัปเดตแล้วเช่นกัน

    • รายงานที่ใช้มิติข้อมูล insightPlaybackLocationDetail และ insightTrafficSourceDetail ได้รับการปรับปรุงในลักษณะต่อไปนี้

      • ตอนนี้ตัวกรองดังกล่าวรองรับตัวกรอง country ที่ไม่บังคับแล้ว

      • ขณะนี้เจ้าของเนื้อหาสามารถเรียกดูรายงานเหล่านี้โดยใช้ชุดค่าผสม filter ใหม่ดังต่อไปนี้ โปรดทราบว่าชุดค่าผสมทั้งหมดเหล่านี้รองรับตัวกรอง country ซึ่งไม่บังคับด้วย

        • รายละเอียดตำแหน่งที่เล่น

          • channel,insightPlaybackLocationType==EMBEDDED
          • show,insightPlaybackLocationType==EMBEDDED
          • claimedStatus,insightPlaybackLocationType==EMBEDDED
          • uploaderType,insightPlaybackLocationType==EMBEDDED
          • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

        • รายละเอียดแหล่งที่มาของการเข้าชม

          • channel,insightTrafficSourceType
          • show,insightTrafficSourceType
          • claimedStatus,insightTrafficSourceType
          • uploaderType,insightTrafficSourceType
          • uploaderType,claimedStatus,insightTrafficSourceType

    3 พฤษภาคม 2013

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • เอกสารตัวอย่างคำขอ API ใหม่มีตัวอย่างที่สาธิตวิธีการเรียกดูรายงานประเภทต่างๆ โดยใช้ YouTube Analytics API แต่ละตัวอย่างจะมีคำอธิบายสั้นๆ ของรายงานที่คำขอดึงข้อมูล จากนั้นจะแสดงมิติข้อมูล เมตริก ตัวกรอง และการจัดเรียงพารามิเตอร์สำหรับคำขอ

    • ตอนนี้มิติข้อมูล insightTrafficSourceType รองรับ SUBSCRIBER เป็นค่าที่ถูกต้องแล้ว ค่านี้จะระบุยอดดูวิดีโอที่มาจากฟีดในหน้าแรกของ YouTube หรือจากฟีเจอร์การติดตามของ YouTube หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุฟีดหน้าแรกหรือหน้าอื่นๆ ที่มีการอ้างอิงยอดดู

    28 มีนาคม 2013

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • ตอนนี้ API รองรับเมตริกใหม่ 2 รายการ ได้แก่ annotationClickThroughRate และ annotationCloseRate ซึ่งเกี่ยวข้องกับการโต้ตอบของผู้ชมกับคำอธิบายประกอบที่แสดงระหว่างวิดีโอของคุณ ทั้งรายการรายงานช่องและรายงานของเจ้าของเนื้อหาได้รับการอัปเดตเพื่อระบุรายงานที่รองรับเมตริกใหม่

      • annotationClickThroughRate – อัตราส่วนของคำอธิบายประกอบที่ผู้ชมคลิกต่อจำนวนการแสดงผลคำอธิบายประกอบที่คลิกได้ทั้งหมด
      • annotationCloseRate – อัตราส่วนของคำอธิบายประกอบที่ผู้ชมปิดต่อจำนวนการแสดงผลคำอธิบายประกอบทั้งหมด

    21 มีนาคม 2013

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • ปัจจุบัน API รองรับเมตริกรายได้และประสิทธิภาพของโฆษณา ตลอดจนรายงานประสิทธิภาพของโฆษณาใหม่ มีเพียงพาร์ทเนอร์เนื้อหาของ YouTube ที่เข้าร่วมโปรแกรมพาร์ทเนอร์ YouTube เท่านั้นที่จะเข้าถึงเมตริกและรายงานได้

      • รายงานที่ได้รับการสนับสนุนใหม่สนับสนุนตัวชี้วัดประสิทธิภาพของโฆษณาตามการเล่นและเมตริกประสิทธิภาพของโฆษณาตามการแสดงผล ดูข้อมูลเพิ่มเติมเกี่ยวกับรายงานประสิทธิภาพโฆษณาได้ที่เอกสารรายงานเจ้าของเนื้อหา

      • เมตริกใหม่ที่รองรับมีดังนี้ เราได้อัปเดตรายการรายงานเจ้าของเนื้อหาเพื่อระบุรายงาน รวมถึงรายงานใหม่ 2 ฉบับที่รองรับเมตริกเหล่านี้

        • earnings – รายได้โดยประมาณทั้งหมดจากแหล่งที่มาของการโฆษณาที่ Google เป็นผู้ขายทั้งหมด
        • grossRevenue – รายได้รวมโดยประมาณจากพาร์ทเนอร์ Google หรือ DoubleClick
        • primaryAdGrossRevenue – รายได้รวมโดยประมาณ ซึ่งสรุปและจัดประเภทภายใต้ประเภทโฆษณาหลักสำหรับการเล่นวิดีโอที่รายงานครอบคลุม โดยจากพาร์ทเนอร์ Google หรือ DoubleClick
        • monetizedPlaybacks – จำนวนการเล่นที่มีการแสดงโฆษณาอย่างน้อย 1 ครั้ง
        • playbackBasedCpm – รายได้รวมโดยประมาณต่อการเล่น 1,000 ครั้ง
        • impressions – จำนวนการแสดงโฆษณาที่ยืนยันแล้ว
        • impressionBasedCpm – รายได้รวมโดยประมาณต่อการแสดงโฆษณาพันครั้ง

        หมายเหตุ: ดูคำจำกัดความของเมตริกสำหรับรายละเอียดทั้งหมด

      • คำขอใดๆ ที่ดึงรายได้หรือเมตริกประสิทธิภาพของโฆษณาต้องส่งโทเค็นการให้สิทธิ์ที่ให้สิทธิ์เข้าถึงโดยใช้ขอบเขต https://www.googleapis.com/auth/yt-analytics-monetary.readonly ใหม่

    • เอกสารเกี่ยวกับ API ได้รับการจัดระเบียบใหม่เพื่อให้อธิบายรายงานประเภทต่างๆ ในหน้าที่แยกกัน ด้วยเหตุนี้ จึงมีหน้าแยกต่างหากเพื่ออธิบายประเภทต่างๆ ของรายงานช่องและรายงานของเจ้าของเนื้อหา

    4 กุมภาพันธ์ 2013

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • ตอนนี้คู่มืออ้างอิงของ API มีส่วนตัวอย่าง ซึ่งประกอบด้วยตัวอย่างโค้ดที่แสดงวิธีเรียก API โดยใช้ไลบรารีของไคลเอ็นต์ Java, JavaScript, Python และ Ruby ตัวอย่างโค้ด JavaScript เป็นโค้ดเดียวกันกับที่อธิบายโดยละเอียดในเอกสารประกอบตัวอย่างแอปพลิเคชัน

    14 พฤศจิกายน 2012

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • ตอนนี้คู่มืออ้างอิง API จะแสดง APIs Explorer ซึ่งช่วยให้คุณเรียกใช้ API ดูคำขอ API และดึงข้อมูลจริงในการตอบสนองได้

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

      • รายงานตำแหน่งที่เล่นจะระบุจำนวนการดูวิดีโอที่เกิดขึ้นในหน้าเว็บหรือแอปพลิเคชันประเภทต่างๆ

      • รายงานรายละเอียดตำแหน่งที่เล่นจะระบุโปรแกรมเล่นแบบฝังที่สร้างยอดดูมากที่สุดสำหรับวิดีโอที่ระบุ รายงานนี้จะให้มุมมองที่มีความละเอียดมากกว่ารายงานตำแหน่งที่เล่น โดยการระบุ URL ที่เชื่อมโยงกับโปรแกรมเล่นแบบฝังอันดับต้นๆ

      • รายงานแหล่งที่มาของการเข้าชมจะระบุจำนวนการดูวิดีโอที่เกิดจากผู้อ้างอิงประเภทต่างๆ

      • รายงานรายละเอียดแหล่งที่มาของการเข้าชมจะระบุแหล่งอ้างอิงที่สร้างยอดดูมากที่สุดสำหรับวิดีโอที่ระบุและประเภทแหล่งที่มาของการเข้าชมที่ระบุ ตัวอย่างเช่น รายงานนี้จะแสดงวิดีโอที่เกี่ยวข้องซึ่งส่งการเข้าชมไปยังวิดีโอรายการใดรายการหนึ่งมากที่สุด รายงานนี้รองรับแหล่งที่มาของการเข้าชมหลายแห่ง

      • รายงานเวลาในการรับชมจะระบุระยะเวลาที่ผู้ชมใช้ในการรับชมเนื้อหา รายงานนี้สามารถรวบรวมข้อมูลสำหรับกรอบเวลาเฉพาะเจาะจง เช่น วัน 7 วัน 30 วันก่อนหน้า ฯลฯ หรือประเทศ หากรายงานรวบรวมข้อมูลตามวันหรือประเทศ ก็จะระบุระยะเวลาเฉลี่ยของการดูวิดีโอแต่ละครั้ง รวมถึงเปอร์เซ็นต์เฉลี่ยของแต่ละวิดีโอที่ผู้ใช้ดูได้ด้วย

    2 ตุลาคม 2012

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

    • YouTube Analytics API พร้อมให้บริการแก่นักพัฒนาซอฟต์แวร์ทุกคนแล้ว คุณเปิดใช้งาน API สำหรับโปรเจ็กต์ได้จากแผงบริการใน APIs console โดยไม่ต้องขอสิทธิ์เข้าถึงก่อน

    • ส่วนการเริ่มต้นใช้งานใหม่จะระบุข้อกำหนดเบื้องต้นและขั้นตอนพื้นฐานในการสร้างแอปพลิเคชันที่ใช้ YouTube Analytics API

    12 กันยายน 2012

    การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

    • เราได้อัปเดตส่วนมิติข้อมูลชั่วคราวเพื่ออธิบายว่ามิติข้อมูลเหล่านั้นบ่งชี้ว่ารายงาน Analytics ควรรวบรวมข้อมูลโดยอิงตามระยะเวลา ขณะนี้ API รองรับมิติข้อมูลเวลาเพิ่มเติมต่อไปนี้

      • 7DayTotals – ระบบจะรวบรวมข้อมูลในรายงานเพื่อให้แต่ละแถวมีข้อมูลเป็นเวลา 7 วัน
      • 30DayTotals – ระบบจะรวบรวมข้อมูลในรายงานเพื่อให้แต่ละแถวมีข้อมูลเป็นเวลา 30 วัน
      • month – ข้อมูลในรายงานจะรวบรวมตามเดือนปฏิทิน

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

    • ส่วนมิติข้อมูลเอนทิตีการรายงานได้รับการอัปเดตโปรดทราบว่าคำขอ API เพื่อดึงรายงานเจ้าของเนื้อหาจะต้องกรองข้อมูลโดยใช้มิติข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้ (video, channel หรือ show) หรือมิติข้อมูล claimedStatus และ uploaderType ที่รองรับ

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

    • เราอัปเดตคำจำกัดความของเมตริก subscribersGained และ subscribersLost เพื่ออธิบายว่าช่องอาจได้รับหรือสูญเสียผู้ติดตามได้ในที่ต่างๆ มากมาย ซึ่งรวมถึงหน้าดูวิดีโอ หน้าช่อง และคำแนะนำที่ปรากฏในหน้าแรกของ YouTube เมื่อเมตริกเหล่านี้ปรากฏในรายงานเฉพาะวิดีโอ ก็จะรวมเฉพาะสถิติจากหน้าดูวิดีโอที่ระบุไว้เท่านั้น