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

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

15 พฤศจิกายน 2024

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

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

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

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

6 พฤษภาคม 2024

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

• รายงานกิจกรรมของผู้ใช้ตาม DMA เป็นรายงานตามภูมิศาสตร์ที่ให้สถิติกิจกรรมของผู้ใช้ตามพื้นที่การตลาดที่กําหนด (DMA) สําหรับรายงานนี้ คุณต้องตั้งค่าพารามิเตอร์ filters เป็น country==US

• รายงานจำนวนผู้ชมที่ดูพร้อมกันจะแสดงจำนวนผู้ชมที่ดูพร้อมกันในส่วนต่างๆ ของวิดีโอสตรีมแบบสดรายการเดียว

• รายงานการยกเลิกการเป็นสมาชิกจะแสดงสถิติที่แสดงให้เห็นสาเหตุที่ผู้ใช้ยกเลิกการเป็นสมาชิกของช่อง

  รายงานนี้ใช้มิติข้อมูล membershipsCancellationSurveyReason ใหม่ ซึ่งระบุสาเหตุที่ผู้ใช้ยกเลิกการเป็นสมาชิกของช่อง นอกจากนี้ ยังใช้เมตริก membershipsCancellationSurveyResponses ใหม่ ซึ่งระบุจํานวนการเป็นสมาชิกของช่องที่ถูกยกเลิกด้วยเหตุผลดังกล่าว

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

• startedWatching
• stoppedWatching
• totalSegmentImpressions

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

  • playlistAverageViewDuration
  • playlistEstimatedMinutesWatched
  • playlistSaves
  • playlistViews

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

  • playlistAverageViewDuration
  • playlistEstimatedMinutesWatched
  • playlistSaves
  • playlistViews

• ตอนนี้ลักษณะการทํางานของเมตริก 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 (รายงานจำนวนมาก)

• ใน YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย) API ทั้งเมตริก averageViewDuration และ averageViewPercentage จะยกเว้นการเข้าชมคลิปที่เล่นซ้ำ ณ วันที่ 13 ธันวาคม 2021
• ใน YouTube Reporting (Bulk Reports) API ทั้งเมตริก average_view_duration_seconds และ average_view_duration_percentage จะไม่รวมการเข้าชมคลิปที่เล่นซ้ำ ณ วันที่ 13 ธันวาคม 2021

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

• API รองรับเมตริกที่เกี่ยวข้องกับรายได้ดังต่อไปนี้

  • adImpressions
  • cpm
  • estimatedAdRevenue
  • estimatedRedPartnerRevenue
  • estimatedRevenue
  • grossRevenue
  • monetizedPlaybacks
  • playbackBasedCpm

  เมตริกเหล่านี้ใช้ได้กับรายงานต่อไปนี้

  • สถิติกิจกรรมของผู้ใช้พื้นฐาน
  • กิจกรรมของผู้ใช้ตามประเทศในระยะเวลาที่เจาะจง
  • กิจกรรมของผู้ใช้ตามประเทศ
  • วิดีโอยอดนิยมพร้อมตัวกรองระดับภูมิภาค (ไม่บังคับ)

• นอกจากนี้ เจ้าของช่องยังเรียกดูรายงานประสิทธิภาพโฆษณาได้ด้วย ซึ่งรองรับมิติข้อมูล adType รวมถึงมิติข้อมูล day (ไม่บังคับ)

• ตอนนี้คู่มือคําขอตัวอย่างของ 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)

• รายงานช่อง

  • channel_basic_a1 - แทนที่ด้วยรายงาน channel_basic_a2
  • channel_province_a1 - แทนที่ด้วยรายงาน channel_province_a2
  • channel_playback_location_a1 - แทนที่ด้วยรายงาน channel_playback_location_a2
  • channel_traffic_source_a1 - แทนที่ด้วยรายงาน channel_traffic_source_a2
  • channel_device_os_a1 - แทนที่ด้วยรายงาน channel_device_os_a2
  • channel_subtitles_a1 - แทนที่ด้วยรายงาน channel_subtitles_a2
  • channel_combined_a1 - แทนที่ด้วยรายงาน channel_combined_a2

• รายงานของเจ้าของเนื้อหา

  • content_owner_basic_a2 - แทนที่ด้วยรายงาน content_owner_basic_a3
  • content_owner_province_a1 - แทนที่ด้วยรายงาน content_owner_province_a2
  • content_owner_playback_location_a1 - แทนที่ด้วยรายงาน content_owner_playback_location_a2
  • content_owner_traffic_source_a1 - แทนที่ด้วยรายงาน content_owner_traffic_source_a2
  • content_owner_device_os_a1 - แทนที่ด้วยรายงาน content_owner_device_os_a2
  • content_owner_subtitles_a1 - แทนที่ด้วยรายงาน content_owner_subtitles_a2
  • content_owner_combined_a1 - แทนที่ด้วยรายงาน content_owner_combined_a2
  • content_owner_asset_basic_a1 - แทนที่ด้วยรายงาน content_owner_asset_basic_a2
  • content_owner_asset_province_a1 - แทนที่ด้วยรายงาน content_owner_asset_province_a2
  • content_owner_asset_playback_location_a1 - แทนที่ด้วยรายงาน content_owner_asset_playback_location_a2
  • content_owner_asset_traffic_source_a1 - แทนที่ด้วยรายงาน content_owner_asset_traffic_source_a2
  • content_owner_asset_device_os_a1 - แทนที่ด้วยรายงาน content_owner_asset_device_os_a2
  • content_owner_asset_combined_a1 - แทนที่ด้วยรายงาน content_owner_asset_combined_a2

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

11 พฤศจิกายน 2016

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

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

• รายงาน End Screen

  • รายงาน End Screen สำหรับวิดีโอในช่องจะมีสถิติของวิดีโอทั้งหมดในช่อง
  • รายงาน End Screen สำหรับวิดีโอของเจ้าของเนื้อหาจะมีสถิติของวิดีโอในช่องของเจ้าของเนื้อหา
  • รายงาน 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)

  • content_owner_ad_performance_a1 - แทนที่ด้วยรายงาน content_owner_ad_rates_a1
  • content_owner_estimated_earnings_a1 - แทนที่ด้วยรายงาน content_owner_estimated_revenue_a1
  • content_owner_asset_estimated_earnings_a1 - แทนที่ด้วยรายงาน content_owner_asset_estimated_revenue_a1

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_a2
    • channel_province_a2
    • channel_playback_location_a2
    • channel_traffic_source_a2
    • channel_device_os_a2
    • channel_subtitles_a2
    • channel_combined_a2

  • รายงานวิดีโอของเจ้าของเนื้อหา

    • content_owner_basic_a3
    • content_owner_province_a2
    • content_owner_playback_location_a2
    • content_owner_traffic_source_a2
    • content_owner_device_os_a2
    • content_owner_subtitles_a2
    • content_owner_combined_a2

  • รายงานเนื้อหาของเจ้าของเนื้อหา

    • content_owner_asset_basic_a2
    • content_owner_asset_province_a2
    • content_owner_asset_playback_location_a2
    • content_owner_asset_traffic_source_a2
    • content_owner_asset_device_os_a2
    • content_owner_asset_combined_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 ได้รับการอัปเดตเพื่อแสดงการรองรับเมตริกการ์ดในรายงานช่องและเจ้าของเนื้อหาจำนวนมาก เมตริกที่รองรับใหม่ ได้แก่

• cardImpressions
• cardTeaserImpressions
• cardClicks
• cardTeaserClicks
• cardClickRate
• cardTeaserClickRate

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

• สถิติพื้นฐาน(ช่อง เจ้าของเนื้อหา)
• ตามเวลา(ช่อง เจ้าของเนื้อหา)
• ภูมิศาสตร์ของผู้ใช้ (ช่อง เจ้าของเนื้อหา)
• กิจกรรมของผู้ใช้ตามสถานะการติดตาม (ช่อง เจ้าของเนื้อหา)
• วิดีโอยอดนิยม (ช่อง เจ้าของเนื้อหา)

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

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

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

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

  • สถิติพื้นฐาน
  • ตามเวลา
  • พื้นที่ทางภูมิศาสตร์ของผู้ใช้
  • วิดีโอยอดนิยม – รายงานนี้รองรับredPartnerRevenueเป็นเมตริกการจัดเรียงด้วย ซึ่งหมายความว่าคุณสามารถเรียกข้อมูลรายการวิดีโอที่จัดเรียงตามรายได้จาก YouTube Red ได้

• ตอนนี้คําจํากัดความของรายงานวิดีโอยอดนิยมสําหรับ YouTube Analytics API แสดงให้เห็นว่ารายงานนี้รองรับเมตริกรายได้ต่อไปนี้ด้วย 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"

  นอกจากนี้ เรายังได้อัปเดตแนวทางปฏิบัติแนะนำของ 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

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

• เมตริก favoritesAdded และ favoritesRemoved เลิกใช้งานแล้วนับตั้งแต่การประกาศนี้ เมตริกเหล่านี้เป็นทั้งเมตริกหลักและอยู่ภายใต้นโยบายการเลิกใช้งานที่ระบุไว้ในข้อกําหนดในการให้บริการ

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

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

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

  การเปลี่ยนแปลงนี้จะแสดงในรายงานสถิติพื้นฐานฉบับแรกสำหรับเจ้าของเนื้อหา ซึ่งตอนนี้รองรับตัวกรอง claimedStatus และ uploaderType แล้ว

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

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

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

10 พฤษภาคม 2013

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

• YouTube จะไม่ระบุฟีเจอร์และบริการ API เวอร์ชันทดลองอีกต่อไป แต่ตอนนี้เรามีรายการ YouTube API ที่อยู่ภายใต้นโยบายการเลิกใช้งานแทน

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