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

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

9 กันยายน 2026

เราได้อัปเดตเอกสารประกอบของ YouTube Analytics API และ YouTube Reporting API โดยเพิ่มข้อมูลและคำอธิบายต่อไปนี้

  • SLA ความใหม่ของข้อมูลและความหน่วง: เพิ่มส่วนเฉพาะในโมเดลข้อมูลที่อธิบายถึงความล่าช้าในการประมวลผลข้อมูล 48-72 ชั่วโมง การตัดวันที่สิ้นสุดเป็นวันที่มีการประมวลผลเสร็จสมบูรณ์ล่าสุด และแนะนำวิธี videos.list ของ YouTube Data API สำหรับสถิติแบบเรียลไทม์ของวิดีโอ

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

  • ข้อจํากัดในการค้นหาและความเข้ากันได้ของพารามิเตอร์: เพิ่มหมายเหตุคำแนะนำในทําความเข้าใจตารางรายงานเพื่อชี้แจงว่าชุดค่าผสมมิติข้อมูล เมตริก และตัวกรองที่ไม่ถูกต้องหรือใช้ร่วมกันไม่ได้จะแสดงผล HTTP 400 badRequest ("The query is not supported.")

  • ค่ามิติข้อมูลที่ว่างเปล่าในรายงานกลุ่ม: อัปเดตลักษณะรายงานของ YouTube Reporting API เพื่ออธิบายว่าคอลัมน์มิติข้อมูล เช่น video_id หรือ channel_id มีสตริงว่างเปล่าเพื่อรักษาจํานวนเมตริกรวมสําหรับทรัพยากรที่ถูกลบและเพื่อแสดงเหตุการณ์ระดับช่อง

27 สิงหาคม 2026

YouTube จะปรับวิธีการนับยอดดูแบบสาธารณะสำหรับวิดีโอทุกรูปแบบ ได้แก่ วิดีโอแบบยาว ไลฟ์สด และ Shorts YouTube จะนับยอดดูแบบสาธารณะทันทีที่วิดีโอเริ่มเล่น

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

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

ดูข้อมูลเพิ่มเติมได้ที่ทำความเข้าใจประสิทธิภาพเนื้อหาของคุณบน YouTube

เมตริก สถานะ ทริกเกอร์ ใช้สำหรับ
ดู อัปเดตแล้ว วิดีโอจะเล่นจากเฟรมแรก (รวมถึงการเล่นอัตโนมัติ วางเมาส์เหนือ และคลิก/แตะเพื่อเล่น) ยอดดูแบบสาธารณะมาตรฐาน
การดูอย่างมีส่วนร่วม ไม่มีการเปลี่ยนแปลง การเล่นจะดำเนินต่อไปหลังจากเฟรมแรก หรือผู้ใช้คลิก/แตะเพื่อเล่น การสร้างรายได้ผ่านโปรแกรมพาร์ทเนอร์ YouTube, ข้อมูลวิเคราะห์หลักส่วนใหญ่ (อัตราการคลิกผ่าน, ระยะเวลาการดูโดยเฉลี่ย) และการรายงานการมีส่วนร่วม
การแสดงผลภาพปก ไม่มีการเปลี่ยนแปลง ภาพปกจะแสดงโดยไม่ต้องมีการโต้ตอบหรือเล่นอัตโนมัติ วัดการแสดงผลและการจัดแพ็กเกจระดับฟีด

การอัปเดตเอกสารประกอบของ API: อัปเดตคำจำกัดความของเมตริก engagedViews ในเอกสารประกอบเมตริกของ YouTube Analytics API และเมตริกของ YouTube Reporting API

25 มิถุนายน 2026

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

9 มีนาคม 2026

มิติข้อมูล ageGroup (YouTube Analytics API) และ age_group (YouTube Reporting API) จะรวมผู้ใช้ที่ YouTube ประมาณว่ามีอายุต่ำกว่า 18 ปี

15 มกราคม 2026

ตอนนี้ YouTube Reporting API รองรับรายงานการเข้าถึงสำหรับช่องและเจ้าของเนื้อหาแล้ว รายงานการเข้าถึงจะแสดงสถิติสำหรับการแสดงผลภาพปกวิดีโอและอัตราการคลิกผ่าน

  • รายงานchannel_reach_basic_a1และchannel_reach_combined_a1พร้อมใช้งานสำหรับช่อง
  • รายงานcontent_owner_reach_basic_a1และcontent_owner_reach_combined_a1พร้อมให้บริการแก่เจ้าของเนื้อหา

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

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

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

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

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

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

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

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

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

  • ใน 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เมธอด filters จะระบุรายการตัวกรองที่ควรใช้เมื่อเรียกข้อมูลข้อมูลวิเคราะห์ YouTube พารามิเตอร์นี้รองรับความสามารถในการระบุค่าหลายค่าสำหรับตัวกรอง video, playlist, และ channel และจำนวนสูงสุดของรหัสที่ระบุได้สำหรับตัวกรองเหล่านั้นเพิ่มขึ้นจาก 200 เป็น 500 รหัส

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

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

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

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

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

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

26 เมษายน 2018

ตอนนี้ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย) API เวอร์ชัน 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 ใน v1 API จะใช้รูปแบบ Camel Case (endDate) แทนขีดกลางใน v2 API การเปลี่ยนแปลงนี้จะทำให้ชื่อพารามิเตอร์สอดคล้องกันตลอดทั้ง 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 เวอร์ชัน 2 ไม่รองรับโปรโตคอล JSON-RPC ซึ่งรองรับใน API เวอร์ชัน 1 อีกครั้งที่การเลิกใช้งานนี้ไม่ได้เจาะจงเฉพาะ 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

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

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

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

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

    • เราได้อัปเดตเอกสารประกอบของ 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 หรือการจัดประเภทวิดีโอที่แชร์กับบริการเหล่านี้

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

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

28 มีนาคม 2017

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

17 มีนาคม 2017

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

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

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

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

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

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

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

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

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

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

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

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

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

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

15 ธันวาคม 2016

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

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

11 พฤศจิกายน 2016

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

YouTube Reporting API รองรับรายงาน End Screen 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

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

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

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

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

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

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

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

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

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

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

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

28 มิถุนายน 2016

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

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

22 มิถุนายน 2016

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

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

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

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

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

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

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

      รายงานที่เปลี่ยนชื่อใหม่ทั้ง 2 รายการแตกต่างจากรายงานก่อนหน้าในลักษณะต่อไปนี้

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

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

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

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

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

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

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

19 พฤษภาคม 2016

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

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

    หากมีงานที่สร้างรายงาน 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

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

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

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

YouTube Analytics API

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

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

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

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

6 มกราคม 2016

ตอนนี้ทั้ง 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 country, province, continent, subContinent
    ใช้ 0 หรือ 1 วิดีโอ กลุ่ม
    ใช้ 0 ขึ้นไป operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

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

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

  • หากคุณขอข้อมูลสำหรับ ข้อมูลวิเคราะห์ YouTubegroup ที่ว่างเปล่า ตอนนี้ 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 ของ API ของข้อมูลวิเคราะห์ YouTube ได้รับการอัปเดตให้มีรายการค่ามิติข้อมูลที่เป็นไปได้ รายการนี้มีบริการที่รองรับใหม่หลายรายการ

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

24 กันยายน 2015

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

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

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

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

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

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

20 สิงหาคม 2015

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

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

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

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

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

22 กรกฎาคม 2015

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

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

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

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

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

1 มิถุนายน 2015

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

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

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

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

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

31 มีนาคม 2015

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

  • เมตริก favoritesAdded และ favoritesRemoved ทั้ง 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 ที่เชื่อมโยงกับเพลเยอร์ยอดนิยมที่ฝังไว้

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

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