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

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

26 มีนาคม 2025

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

ตั้งแต่วันที่ 31 มีนาคม 2025 เป็นต้นไป YouTube จะเปลี่ยนวิธีนับยอดดูของ Shorts ในอดีต ระบบจะนับยอดดู Shorts เมื่อเล่นถึงระยะเวลาที่กำหนดเป็นวินาที โดยระบบจะนับยอดดูเป็นจำนวนครั้งที่ Shorts เริ่มเล่นหรือเล่นซ้ำ โดยไม่มีการกำหนดเวลาในการรับชมขั้นต่ำ ดูข้อมูลเพิ่มเติม

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

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

ระบบจะอัปเดตข้อความค้นหาที่กำหนดเป้าหมายภายในวันที่ 30 เมษายน และอัปเดตรายงานกลุ่มภายในวันที่ 30 มิถุนายน ในระหว่างนี้ ยอดดูจะอิงตามวิธีการแบบเก่า ยอดดู Shorts และยอดดูช่องจะไม่ตรงกับ Analytics ใน Studio

นอกจากนี้ การเลิกใช้งานที่ประกาศไปก่อนหน้านี้ของรายงานการอ้างสิทธิ์รายวัน (เวอร์ชัน 1.0) จะต้องเลื่อนออกไป

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

3 มีนาคม 2025

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

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

เราเลิกใช้งานรายงานการอ้างสิทธิ์รายวัน (เวอร์ชัน 1.0) กับพาร์ทเนอร์แล้ว ระบบจะไม่รองรับอีกต่อไปหลังจากวันที่ 30 เมษายน 2025 คําจํากัดความของรายงานดังกล่าวได้รับการอัปเดตแล้ว ให้ใช้รายงานการอ้างสิทธิ์รายวันฉบับล่าสุดแทน

15 พฤศจิกายน 2024

หมายเหตุ: การเปลี่ยนแปลงต่อไปนี้จะมีผลตั้งแต่วันที่ 18 พฤศจิกายน 2024

เอกสารประกอบของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย) API ได้รับการอัปเดตเพื่อระบุว่าสำหรับรายงานแหล่งที่มาของการเข้าชม ตอนนี้เมธอด reports.query ของ API จะแสดงข้อผิดพลาดหากผลคูณของจำนวนวิดีโอที่ค้นหา x จำนวนวันในช่วงวันที่เกิน 50,000 เช่น การค้นหาที่ดึงข้อมูลสำหรับรหัสวิดีโอ 500 รายการจะขอข้อมูลได้สูงสุด 100 วัน

การเปลี่ยนแปลงนี้จะส่งผลต่อรายงานของทั้งช่องและเจ้าของเนื้อหา

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

6 พฤษภาคม 2024

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

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

7 เมษายน 2024

API ของข้อมูลวิเคราะห์ YouTube (การค้นหาที่กำหนดเป้าหมาย) มีการอัปเดตหลายรายการที่เกี่ยวข้องกับรายงานเพลย์ลิสต์ของเจ้าของเนื้อหา การอัปเดตนี้เหมือนกับการอัปเดตที่เกี่ยวข้องกับรายงานเพลย์ลิสต์ของช่องซึ่งประกาศไปเมื่อวันที่ 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 ดูคําจํากัดความของเมตริกแต่ละรายการในเอกสารประกอบเมตริก

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

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

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

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

19 มกราคม 2024

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

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

    เราเลิกใช้งานมิติข้อมูล 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 ดูคําจํากัดความของเมตริกแต่ละรายการในเอกสารประกอบเมตริก

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

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

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

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

4 ธันวาคม 2023

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

15 ธันวาคม 2022

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

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

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

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

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

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

26 สิงหาคม 2022

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

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

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

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

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

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

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

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

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

YouTube Reporting (Bulk Reports) API นี้รองรับค่ามิติข้อมูลแหล่งที่มาของการเข้าชมใหม่ซึ่งบ่งชี้ว่ายอดดูมาจากการเปลี่ยนเส้นทางแบบเรียลไทม์

  • ใน Reporting API (รายงานกลุ่ม) ของ YouTube มิติข้อมูล traffic_source_type รองรับค่า 28

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

23 กันยายน 2020

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

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

ระบบจะไม่สร้างมิติข้อมูลรายละเอียดแหล่งที่มาของการเข้าชม (insightTrafficSourceDetailใน YouTube Analytics API หรือtraffic_source_detailใน YouTube Reporting API) สําหรับแหล่งที่มาของการเข้าชมประเภทใหม่นี้

20 กรกฎาคม 2020

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

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

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

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

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

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

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

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

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

15 ตุลาคม 2019

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

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

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

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

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

27 มิถุนายน 2019

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

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

1 พฤศจิกายน 2018

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

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

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

17 กันยายน 2018

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

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

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

      หรือ

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

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

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

18 มิถุนายน 2018

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

  • ข้อกําหนดขอบเขตสําหรับเมธอดต่อไปนี้มีการเปลี่ยนแปลง
    • คำขอไปยังเมธอด 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 ขอบเขต

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

23 พฤษภาคม 2018

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

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

22 พฤษภาคม 2018

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

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

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

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

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

  • เราได้อัปเดตส่วนแนวทางปฏิบัติแนะนำเพื่อแจ้งให้ทราบว่าคุณใช้ YouTube Data API เพื่อดึงข้อมูลเมตาเพิ่มเติมสำหรับทรัพยากรที่ระบุในรายงานได้ ตามที่ระบุไว้ในนโยบายสำหรับนักพัฒนาแอปบริการ YouTube API (ส่วนที่ 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 ใน API เวอร์ชัน 1 จะใช้รูปแบบตัวพิมพ์ใหญ่และตัวพิมพ์เล็กสลับกัน (endDate) แทนขีดกลางใน API เวอร์ชัน 2 การเปลี่ยนแปลงนี้ทําให้ชื่อพารามิเตอร์สอดคล้องกันทั่วทั้ง API เนื่องจากเมธอดของ API ในการสร้างและจัดการกลุ่มใช้รูปแบบตัวพิมพ์ใหญ่และตัวพิมพ์เล็กสลับกันสําหรับชื่อพารามิเตอร์อยู่แล้ว
    • API เวอร์ชัน 2 ไม่รองรับคำขอกลุ่มที่ส่งไปยังปลายทางกลุ่ม HTTP ทั่วโลกของ Google (www.googleapis.com/batch) หากคุณส่งคำขอกลุ่มใน API เวอร์ชัน 2 ต้องใช้ปลายทาง https://youtubeanalytics.googleapis.com/v2 แทน

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

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

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

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

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

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

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

18 มกราคม 2018

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

  • YouTube Reporting API (รายงานแบบเป็นกลุ่ม)

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

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

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

20 ธันวาคม 2017

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

  • ตอนนี้เซิร์ฟเวอร์ API รองรับการบีบอัด Gzip สําหรับคําขอที่ดาวน์โหลดรายงานแล้ว โปรดทราบว่าคำขอ API ประเภทอื่นๆ ไม่รองรับการบีบอัด gzip การเปิดใช้การบีบอัด 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 ปีนับจากวันที่ประกาศ แต่ตอนนี้เมื่อระยะเวลา 1 ปีสิ้นสุดลงแล้ว ระบบจะไม่รองรับเมตริก earnings อีกต่อไป ด้วยเหตุนี้ คำขอ API ที่ระบุเมตริก earnings จึงแสดงรหัสการตอบกลับ HTTP 400 หากคุณยังไม่ได้อัปเดตแอปให้ใช้เมตริก estimatedRevenue แทนเมตริก earnings โปรดอัปเดตโดยเร็วที่สุด

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

6 กรกฎาคม 2017

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

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

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

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

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

  • YouTube Reporting API (รายงานแบบเป็นกลุ่ม)

    • ตอนนี้มิติข้อมูล 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

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

  • YouTube Reporting API (รายงานแบบเป็นกลุ่ม)

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

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

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

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

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

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 มีนาคม 2017

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

17 มีนาคม 2017

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

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

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

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

3 มีนาคม 2017

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

  • YouTube Reporting API (รายงานแบบเป็นกลุ่ม)

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

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

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

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

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

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

    • เราได้แก้ไขคำอธิบายของมิติข้อมูลที่เกี่ยวข้องกับ 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

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

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

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

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

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

15 ธันวาคม 2016

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

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

11 พฤศจิกายน 2016

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

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

    • รายงาน End Screen

    • ขนาดของ End Screen

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

    • เมตริก 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

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

    • เมตริกในรายการต่อไปนี้เลิกใช้งานแล้วและระบบไม่รองรับอีกต่อไป ตามที่ได้ประกาศไปเมื่อวันที่ 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

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

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

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

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

      สําหรับแต่ละรายงาน ตัวเลขในรหัสประเภทรายงานใหม่จะสูงกว่ารหัสประเภทรายงานเดิม 1 หมายเลข (เราเลิกใช้งานรายงานเวอร์ชันเก่าแล้วตามที่อธิบายไว้ภายหลังในประวัติการแก้ไขนี้) ตัวอย่างเช่น เราได้เลิกใช้งานรายงาน 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

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

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

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

    11 สิงหาคม 2016

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

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

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

    10 สิงหาคม 2016

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

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

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

        เมตริกในตารางต่อไปนี้จะเลิกใช้งาน ในขณะเดียวกัน เราจะเปิดตัวเมตริกใหม่ซึ่งอ้างอิงข้อมูลเดียวกัน ซึ่งหมายความว่าเมตริกเดิมจะมีการเปลี่ยนชื่อ แต่ API ของข้อมูลวิเคราะห์ YouTube จะรองรับทั้ง 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

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

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

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

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

    • YouTube Reporting API (รายงานแบบเป็นกลุ่ม)

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

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

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

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

    18 กรกฎาคม 2016

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

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

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

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

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

    • YouTube Reporting API (รายงานแบบเป็นกลุ่ม)

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

    28 มิถุนายน 2016

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

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

    22 มิถุนายน 2016

    การอัปเดตนี้มีการเปลี่ยนแปลง YouTube Reporting API ดังต่อไปนี้ การเปลี่ยนแปลงแรกเกี่ยวข้องกับ 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

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

        • โดยเพิ่มเมตริก 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

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

    • 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

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

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

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

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

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

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

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

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

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

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

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

    16 มีนาคม 2016

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

    YouTube Reporting API

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

    YouTube Analytics API

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

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

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

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

    6 มกราคม 2016

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

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

    21 ธันวาคม 2015

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

    18 ธันวาคม 2015

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

    15 ธันวาคม 2015

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

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

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

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

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

      เนื้อหา
      มิติข้อมูล:
      ต้องระบุ deviceType
      ใช้ 0 ขึ้นไป day, liveOrOnDemand, subscribedStatus, youtubeProduct
      เมตริก:
      ใช้อย่างน้อย 1 รายการ views, estimatedMinutesWatched
      ตัวกรอง:
      ใช้ 0 หรือ 1 country, province, continent, subContinent
      ใช้ 0 หรือ 1 video, group
      ใช้ 0 ขึ้นไป operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

    • ตอนนี้ YouTube Analytics API จะทิ้งเอนทิตีที่ผู้ใช้ 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 จะแสดงข้อผิดพลาด "ไม่ได้รับอนุญาต" (403 รหัสการตอบกลับ HTTP) หากคุณพยายามเพิ่มเอนทิตีลงในกลุ่ม แต่คุณไม่มีสิทธิ์เข้าถึงเอนทิตีนั้น ก่อนหน้านี้ API จะอนุญาตให้คุณเพิ่มเอนทิตีลงในกลุ่ม แต่ภายหลังจะแสดงข้อผิดพลาด "ไม่ได้รับอนุญาต" เมื่อคุณพยายามเรียกข้อมูลรายงานของกลุ่มนั้น

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

    10 พฤศจิกายน 2015

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

    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"

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

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

    8 ตุลาคม 2015

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

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

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

    24 กันยายน 2015

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

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

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

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

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

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

    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 รายการ

      ข้อมูลสำหรับเมตริกเหล่านี้ใช้ได้ตั้งแต่วันที่ 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 ใน Display ได้ด้วย (ยอดดูจากการค้นหาทั่วไปเป็นผลโดยตรงจากการกระทำของผู้ใช้ เช่น การค้นหาวิดีโอหรือการคลิกวิดีโอแนะนำ)

    • 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

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

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

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

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

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

    16 กรกฎาคม 2013

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

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

    • ตอนนี้ 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 – รายได้รวมโดยประมาณต่อการแสดงโฆษณา 1,000 ครั้ง

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

      • คำขอใดก็ตามที่ดึงข้อมูลรายได้หรือเมตริกประสิทธิภาพโฆษณาต้องส่งโทเค็นการให้สิทธิ์ที่ให้สิทธิ์เข้าถึงโดยใช้ขอบเขต 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 ที่เชื่อมโยงกับโปรแกรมเล่นที่ฝังยอดนิยม

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

      • รายงานรายละเอียดแหล่งที่มาของการเข้าชมจะระบุ 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 เมื่อเมตริกเหล่านี้ปรากฏในรายงานเฉพาะวิดีโอ ก็จะรวมเฉพาะสถิติจากหน้าดูของวิดีโอที่ระบุเท่านั้น