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

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

4 พฤศจิกายน 2569

ตั้งแต่วันที่ 15 มกราคม 2027 เป็นต้นไป เราจะเลิกใช้งานรายงานข้อมูลอ้างอิงรายสัปดาห์สำหรับเจ้าของเนื้อหา (content_owner_active_references_a1) เวอร์ชัน 1.0 และแทนที่ด้วยเวอร์ชัน 1.1 (content_owner_active_references_a2) โปรดย้ายข้อมูลไปยังเวอร์ชันล่าสุดก่อนวันที่ 15 มกราคม 2027

30 ตุลาคม 2569

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

หมวดหมู่ ชื่อรายงาน รหัสประเภทรายงาน
สรุปข้อมูลทางการเงิน สรุปการปรับช่องทางรายเดือน content_owner_channel_adjustments_summary_a1
สรุปข้อมูลทางการเงิน รายได้จากธุรกรรมของฟีเจอร์แบบชำระเงินรายเดือน content_owner_transactions_paid_features_revenue_a1
สรุปข้อมูลทางการเงิน รายได้จากธุรกรรม TVOD รายเดือนตามชื่อรายการและประเทศ tvod_content_owner_country_title_tvod_revenue_a1
สรุปข้อมูลทางการเงิน รายได้จากธุรกรรม TVOD รายเดือนตามประเทศ tvod_content_owner_country_transactions_tvod_revenue_a1
Shorts การสร้างเนื้อหา Shorts รายเดือนของค่ายเพลง music_content_owner_shorts_asset_creations_a1
Shorts ยอดดูเนื้อหา Shorts ของค่ายเพลงรายเดือน music_content_owner_shorts_asset_views_a1
Shorts การสร้างเนื้อหา Shorts ของผู้เผยแพร่เพลงรายเดือน publisher_content_owner_shorts_asset_creations_a1
Shorts ยอดดูเนื้อหา Shorts รายเดือนของผู้เผยแพร่เพลง publisher_content_owner_shorts_asset_views_a1
ภาษี รายงานสรุปการคืนเงินภาษีของแอฟฟิลิเอต MCN รายเดือน content_owner_affiliate_tax_refund_summary_a1
ชิ้นงาน รายงาน SRMF รายสัปดาห์ publisher_content_owner_weekly_srmf
ชิ้นงาน รายงานสถานะคำขอ OAC รายวัน content_owner_oac_request_status_a1
ชิ้นงาน รายงานคุณภาพคำขอ OAC รายวัน content_owner_oac_quality_status_a1

13 กันยายน 2569

ตอนนี้ Reporting API ของ YouTube รองรับรายงานข้อมูลอ้างอิงรายสัปดาห์เวอร์ชัน 1.1 สำหรับเจ้าของเนื้อหา (content_owner_active_references_a2) แล้ว

เวอร์ชัน 1.1 มีการเปลี่ยนแปลงต่อไปนี้

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

รายงานเวอร์ชันก่อนหน้า ซึ่งก็คือเวอร์ชัน 1.0 (content_owner_active_references_a1) จะยังคงพร้อมใช้งานต่อไป

9 กันยายน 2569

เราได้อัปเดตเอกสารประกอบเกี่ยวกับ 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 > โหมดขั้นสูง

การเปลี่ยนแปลงนี้จะไม่ส่งผลต่อการมีสิทธิ์เข้าร่วมโปรแกรมพาร์ทเนอร์ 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

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

  • รายงาน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 จะยังคงพร้อมใช้งานจนถึงวันดังกล่าว ยกเว้นรายงานการอ้างสิทธิ์เวอร์ชัน 1.0 (content_owner_active_claims_a1) และรายงานการอ้างสิทธิ์เวอร์ชัน 1.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 ในอดีต ระบบจะนับยอดดู Shorts เมื่อเล่นถึงระยะเวลาที่กำหนดเป็นวินาที ตอนนี้ระบบจะนับยอดดูเป็นจำนวนครั้งที่ Shorts เริ่มเล่นหรือเล่นซ้ำ โดยไม่มีการกำหนดเวลาในการรับชมขั้นต่ำ ดูข้อมูลเพิ่มเติม

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

  • สำหรับ 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 รายการสำหรับช่อง ดังนี้

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

7 เมษายน 2024

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

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

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

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

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

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

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

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

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

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

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

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

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

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

19 มกราคม 2024

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

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

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

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

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

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

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

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

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

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

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

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

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

4 ธันวาคม 2023

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

15 ธันวาคม 2022

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

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

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

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

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

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

26 สิงหาคม 2022

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

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

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

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

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

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

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

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

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

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

23 กันยายน 2020

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

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

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

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

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

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

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

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

15 ตุลาคม 2019

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

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

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

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

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

27 มิถุนายน 2019

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

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

1 พฤศจิกายน 2018

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

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

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

17 กันยายน 2018

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

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

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

      หรือ

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

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

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

18 มิถุนายน 2018

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

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

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

23 พฤษภาคม 2018

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

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

22 พฤษภาคม 2018

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

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

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

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

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

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

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

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

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

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

18 มกราคม 2018

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

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

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

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

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

20 ธันวาคม 2017

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

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

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

    Accept-Encoding: gzip

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

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

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

10 สิงหาคม 2017

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

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

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

6 กรกฎาคม 2017

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

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

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

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

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

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

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

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

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

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

24 พฤษภาคม 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

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

22 พฤษภาคม 2017

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

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

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

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

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

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

28 มีนาคม 2017

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

17 มีนาคม 2017

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

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

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

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

3 มีนาคม 2017

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

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

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

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

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

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

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

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

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

      แม้ว่าโดยปกติแล้ววันที่หนึ่งๆ จะมีระยะเวลา 24 ชั่วโมง แต่วันที่ที่มีการปรับนาฬิกาไปข้างหน้าจะมีระยะเวลา 23 ชั่วโมง และวันที่ที่มีการปรับนาฬิกาย้อนกลับจะมีระยะเวลา 25 ชั่วโมง (ก่อนหน้านี้ เอกสารประกอบระบุว่าเวลาแปซิฟิกคือ UTC-8 และไม่ได้กล่าวถึงความเป็นไปได้ที่ 1 วันอาจไม่ได้หมายถึงระยะเวลา 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 ของ YouTube Analytics API เลิกใช้งานแล้ว เมตริกนี้ไม่ใช่เมตริกหลักและจะรองรับจนถึงวันที่ 31 ตุลาคม 2016

15 กันยายน 2016

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

  • 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_a2 จะมาแทนที่รายงาน content_owner_basic_a1 ตามที่อธิบายไว้ในรายการประวัติการแก้ไขสำหรับวันที่ 19 พฤษภาคม 2016

11 สิงหาคม 2016

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

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

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

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: ข้อมูลนี้เกี่ยวข้องกับยอดดูที่มาจาก End Screen ของวิดีโออื่น

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

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

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

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

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

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

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

18 กรกฎาคม 2016

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

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

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

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

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

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

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

28 มิถุนายน 2016

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

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

22 มิถุนายน 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

19 พฤษภาคม 2016

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

  • 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

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

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

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

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

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

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

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

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

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

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

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

28 มีนาคม 2016

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

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

16 มีนาคม 2016

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

YouTube Reporting API

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

YouTube Analytics API

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

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

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

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

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 เราได้เพิ่มประกาศเกี่ยวกับข้อกำหนดนี้ในข้อกำหนดในการให้บริการของ YouTube API

15 ธันวาคม 2015

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

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

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

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

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

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

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

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

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

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

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

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

10 พฤศจิกายน 2015

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

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

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

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

29 ตุลาคม 2015

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

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

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

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

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

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

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

8 ตุลาคม 2015

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

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

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

24 กันยายน 2015

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

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

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

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

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

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

20 สิงหาคม 2015

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

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

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

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

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

22 กรกฎาคม 2015

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

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

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

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

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

1 มิถุนายน 2015

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

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

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

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

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

31 มีนาคม 2015

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

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

16 มีนาคม 2015

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

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

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

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

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

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

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

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

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

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

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

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

    ดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่มต่างๆ ของข้อมูลวิเคราะห์ YouTube ได้ที่ศูนย์ช่วยเหลือของ 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 – รายได้รวมโดยประมาณต่อการแสดงโฆษณาพันครั้ง

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

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