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

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

22 กันยายน 2025

การเลิกใช้งานรายงานที่ประกาศไว้ก่อนหน้านี้ได้เลื่อนจากวันที่ 30 กันยายน 2025 เป็นวันที่ 31 ตุลาคม 2025 รายงานเวอร์ชันก่อนหน้าที่อัปเดตสำหรับการเปลี่ยนแปลงยอดดู Shorts จะยังคงพร้อมให้บริการจนถึงตอนนั้น ยกเว้นรายงานการอ้างสิทธิ์ v1.0 (content_owner_active_claims_a1) และรายงานการอ้างสิทธิ์ v1.1 (content_owner_active_claims_a2) ซึ่งจะยังคงเลิกใช้งานในวันที่ 30 กันยายน

24 มิถุนายน 2025

ตามที่ประกาศเมื่อวันที่ 26 มีนาคม 2025 เราจะอัปเดต Bulk Reports API ซึ่งเป็นส่วนหนึ่งของการเปลี่ยนแปลงยอดดู Shorts ใหม่ การเปลี่ยนแปลงต่อไปนี้ได้ดำเนินการแล้ว

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

การเปลี่ยนแปลงเหล่านี้จะมีผลตั้งแต่วันที่ 30 มิถุนายน 2025 สำหรับ Bulk Reports API อย่าลืมปรับการประมวลผลรายงานตามนั้น

รายงานเวอร์ชันก่อนหน้าจะพร้อมใช้งานจนถึงวันที่ 30 กันยายน 2025 หลังจากวันที่ 30 กันยายน 2025 เราจะเลิกใช้งานเวอร์ชันก่อนหน้า อย่าลืมย้ายข้อมูลไปยังเวอร์ชันล่าสุด

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

ตารางต่อไปนี้แสดงรายงานเวอร์ชันใหม่สำหรับรายงานแต่ละประเภท

รายงานข้อมูลแบบกลุ่มสำหรับข้อมูลวิเคราะห์ YouTube

รายงานช่อง - รายงานวิดีโอ
ชื่อรายงาน เวอร์ชันก่อนหน้า เวอร์ชันล่าสุด
กิจกรรมผู้ใช้ channel_basic_a2 channel_basic_a3
กิจกรรมของผู้ใช้ตามจังหวัด channel_province_a2 channel_province_a3
ตำแหน่งที่เล่น channel_playback_location_a2 channel_playback_location_a3
แหล่งที่มาของการเข้าชม channel_traffic_source_a2 channel_traffic_source_a3
ประเภทอุปกรณ์และระบบปฏิบัติการ channel_device_os_a2 channel_device_os_a3
คำบรรยาย channel_subtitles_a2 channel_subtitles_a3
แบบรวม channel_combined_a2 channel_combined_a3
รายงานช่อง - รายงานเพลย์ลิสต์
ชื่อรายงาน เวอร์ชันก่อนหน้า เวอร์ชันล่าสุด
กิจกรรมผู้ใช้ playlist_basic_a1 playlist_basic_a2
กิจกรรมของผู้ใช้ตามจังหวัด playlist_province_a1 playlist_province_a2
ตำแหน่งที่เล่น playlist_playback_location_a1 playlist_playback_location_a2
แหล่งที่มาของการเข้าชม playlist_traffic_source_a1 playlist_traffic_source_a2
ประเภทอุปกรณ์และระบบปฏิบัติการ playlist_device_os_a1 playlist_device_os_a2
แบบรวม playlist_combined_a1 playlist_combined_a2
รายงานของเจ้าของเนื้อหา - รายงานวิดีโอ
ชื่อรายงาน เวอร์ชันก่อนหน้า เวอร์ชันล่าสุด
กิจกรรมผู้ใช้ content_owner_basic_a3 content_owner_basic_a4
กิจกรรมของผู้ใช้ตามจังหวัด content_owner_province_a2 content_owner_province_a3
ตำแหน่งที่เล่น content_owner_playback_location_a2 content_owner_playback_location_a3
แหล่งที่มาของการเข้าชม content_owner_traffic_source_a2 content_owner_traffic_source_a3
ประเภทอุปกรณ์และระบบปฏิบัติการ content_owner_device_os_a2 content_owner_device_os_a3
คำบรรยาย content_owner_subtitles_a2 content_owner_subtitles_a3
แบบรวม content_owner_combined_a2 content_owner_combined_a3
รายงานของเจ้าของเนื้อหา - รายงานเพลย์ลิสต์
ชื่อรายงาน เวอร์ชันก่อนหน้า เวอร์ชันล่าสุด
กิจกรรมผู้ใช้ content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
กิจกรรมของผู้ใช้ตามจังหวัด content_owner_playlist_province_a1 content_owner_playlist_province_a2
ตำแหน่งที่เล่น content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
แหล่งที่มาของการเข้าชม content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
ประเภทอุปกรณ์และระบบปฏิบัติการ content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
แบบรวม content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
รายงานของเจ้าของเนื้อหา - รายงานชิ้นงาน
ชื่อรายงาน เวอร์ชันก่อนหน้า เวอร์ชันล่าสุด
กิจกรรมผู้ใช้ content_owner_asset_basic_a2 content_owner_asset_basic_a3
กิจกรรมของผู้ใช้ตามจังหวัด content_owner_asset_province_a2 content_owner_asset_province_a3
ตำแหน่งที่เล่นวิดีโอ content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
แหล่งที่มาของการเข้าชม content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
ประเภทอุปกรณ์และระบบปฏิบัติการ content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
แบบรวม content_owner_asset_combined_a2 content_owner_asset_combined_a3

รายงานที่ระบบจัดการ - การเงิน (ไม่ใช่เพลง)

รายงานเจ้าของเนื้อหา - รายงาน Shorts (ไม่ใช่เพลง)
ชื่อรายงาน เวอร์ชันก่อนหน้า เวอร์ชันล่าสุด
สรุปรายได้จากโฆษณาทั่วโลก content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
สรุปรายได้จากโฆษณารายวัน content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
สรุปรายได้จากโฆษณาในแต่ละประเทศ content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
สรุปรายได้จากโฆษณา content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

รายงานที่ระบบจัดการ - ไม่ใช่รายงานทางการเงิน

รายงานของเจ้าของเนื้อหา - รายงานการอ้างสิทธิ์
ชื่อรายงาน เวอร์ชันก่อนหน้า เวอร์ชันล่าสุด
การอ้างสิทธิ์ที่ยังมีผล content_owner_active_claims_a2 content_owner_active_claims_a3
รายงานของเจ้าของเนื้อหา - รายงานข้อมูลเมตาวิดีโอ
ชื่อรายงาน เวอร์ชันก่อนหน้า เวอร์ชันล่าสุด
ข้อมูลเมตาของวิดีโอ content_owner_video_metadata_a3 content_owner_video_metadata_a4
รายงานของเจ้าของเนื้อหา - รายงานชิ้นงาน
ชื่อรายงาน เวอร์ชันก่อนหน้า เวอร์ชันล่าสุด
เนื้อหา content_owner_asset_a2 content_owner_asset_a3
ความขัดแย้งของเนื้อหา content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

24 เมษายน 2025

ตามที่ประกาศเมื่อวันที่ 26 มีนาคม 2025 เราจะอัปเดต Targeted Queries API โดยเป็นส่วนหนึ่งของการเปลี่ยนแปลงยอดดู Shorts ใหม่ ดังนี้

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

การเปลี่ยนแปลงเหล่านี้จะมีผลตั้งแต่วันที่ 30 เมษายน 2025 สำหรับ Targeted Queries API อย่าลืมปรับคำค้นหาตามความเหมาะสม

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

22 เมษายน 2025

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

26 มีนาคม 2025

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

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

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

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

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

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

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

3 มีนาคม 2025

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

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

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

15 พฤศจิกายน 2024

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

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

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

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

6 พฤษภาคม 2024

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

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

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

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

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

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

7 เมษายน 2024

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

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

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

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

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

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

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

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

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

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

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

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

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

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

19 มกราคม 2024

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

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

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

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

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

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

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

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

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

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

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

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

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

4 ธันวาคม 2023

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

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

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

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

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

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

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

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

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

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

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

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

23 กันยายน 2020

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

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

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

20 กรกฎาคม 2020

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

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

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

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

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

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

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

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

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

15 ตุลาคม 2019

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

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

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

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

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

27 มิถุนายน 2019

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

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

1 พฤศจิกายน 2018

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

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

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

17 กันยายน 2018

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

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

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

      หรือ

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

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

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

18 มิถุนายน 2018

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

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

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

23 พฤษภาคม 2018

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

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

22 พฤษภาคม 2018

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

  • การเปลี่ยนแปลงต่อไปนี้มีกำหนดจะมีผลในเดือนกรกฎาคม 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 เวอร์ชัน 2 (v2) พร้อมใช้งานแบบสาธารณะแล้ว รายการต่อไปนี้ระบุการเปลี่ยนแปลงของผลิตภัณฑ์และเอกสารที่เกี่ยวข้องกับ API เวอร์ชันใหม่

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

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

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

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

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

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

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

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

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

18 มกราคม 2018

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

  • API การรายงานของ YouTube (รายงานแบบกลุ่ม)

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

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

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

20 ธันวาคม 2017

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

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

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

    Accept-Encoding: gzip

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

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

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

10 สิงหาคม 2017

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

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

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

6 กรกฎาคม 2017

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

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

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

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

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

  • API การรายงานของ YouTube (รายงานแบบกลุ่ม)

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

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

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

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

24 พฤษภาคม 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

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

22 พฤษภาคม 2017

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

  • API การรายงานของ YouTube (รายงานแบบกลุ่ม)

    • ตอนนี้sharing_serviceมิติข้อมูลซึ่งระบุบริการที่ใช้แชร์วิดีโอรองรับค่าต่อไปนี้แล้ว
      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

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

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

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

28 มีนาคม 2017

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

17 มีนาคม 2017

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

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

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

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

3 มีนาคม 2017

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

  • API การรายงานของ YouTube (รายงานแบบกลุ่ม)

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

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

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

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

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

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

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

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

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

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

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

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

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

15 ธันวาคม 2016

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

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

11 พฤศจิกายน 2016

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

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

  • รายงาน End Screen

  • ขนาดของ End Screen

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

  • เมตริก End Screen

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

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

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

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

8 พฤศจิกายน 2016

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

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

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

27 ตุลาคม 2016

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

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

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

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

27 กันยายน 2016

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

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

15 กันยายน 2016

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

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

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

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

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

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

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

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

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

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

19 สิงหาคม 2016

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

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

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

11 สิงหาคม 2016

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

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

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

10 สิงหาคม 2016

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

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

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

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

  • API การรายงานของ YouTube (รายงานแบบกลุ่ม)

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

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

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

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

18 กรกฎาคม 2016

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

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

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

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

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

  • API การรายงานของ YouTube (รายงานแบบกลุ่ม)

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

28 มิถุนายน 2016

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

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

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 จะสร้างรายงานที่ดาวน์โหลดได้สำหรับวันที่ไม่มีข้อมูล รายงานดังกล่าวจะมีแถวส่วนหัว แต่จะไม่มีข้อมูลเพิ่มเติม

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

  • ใน 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

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

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

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

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

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

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

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

6 มกราคม 2016

ตอนนี้ทั้ง YouTube Reporting API และ YouTube Analytics API จะระบุยอดดูที่เกิดขึ้นผ่านอุปกรณ์ 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 และต้องได้รับความยินยอมจากผู้ใช้ปลายทางใน 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 รายการขึ้นไป ยอดดู, estimatedMinutesWatched
    ตัวกรอง:
    ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent
    ใช้ 0 หรือ 1 วิดีโอ กลุ่ม
    ใช้ 0 ขึ้นไป operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

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

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

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

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

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

10 พฤศจิกายน 2015

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

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

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

  • คำจำกัดความของรายงานวิดีโอยอดนิยมสำหรับ 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

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

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

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

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

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

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

20 สิงหาคม 2015

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

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

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

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

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

22 กรกฎาคม 2015

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

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

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

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

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

1 มิถุนายน 2015

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

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

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

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

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

31 มีนาคม 2015

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

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

16 มีนาคม 2015

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

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

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

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

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

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

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

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

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

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

    • การเรียกข้อมูลรายงานสำหรับกลุ่ม

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

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

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

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

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

28 สิงหาคม 2014

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

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

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

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

16 กรกฎาคม 2014

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

31 มกราคม 2014

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

  • เราได้อัปเดตเอกสารรายงานเจ้าของเนื้อหาเพื่อให้สอดคล้องกับการดึงข้อมูลเมตริก 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

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

10 พฤษภาคม 2013

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

6 พฤษภาคม 2013

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

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

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

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

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

    • ตอนนี้ฟีเจอร์นี้รองรับcountryตัวกรองที่ไม่บังคับแล้ว

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

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

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

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

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

3 พฤษภาคม 2013

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

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

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

28 มีนาคม 2013

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

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

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

21 มีนาคม 2013

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

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

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

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

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

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

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

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

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

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

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

14 พฤศจิกายน 2012

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

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

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

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

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

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

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

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