หน้านี้แสดงการเปลี่ยนแปลง API และการอัปเดตเอกสารสำหรับทั้ง API การรายงานของ YouTube และ API ของ YouTube Analytics API ทั้งสองช่วยให้นักพัฒนาซอฟต์แวร์เข้าถึงข้อมูล YouTube Analytics ได้ด้วยวิธีที่ต่างกัน ติดตามบันทึกการเปลี่ยนแปลงนี้
4 ธันวาคม 2023
อัปเดต API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย) เพื่อรวมค่ามิติข้อมูล insightTrafficSourceType
2 ค่าเข้าด้วยกัน ก่อนหน้านี้มิติข้อมูลที่แตกต่างกันระหว่างวิดีโอที่เล่นเป็นส่วนหนึ่งของเพลย์ลิสต์ (PLAYLIST
) และยอดดูที่มาจากหน้าที่แสดงวิดีโอทั้งหมดในเพลย์ลิสต์ (YT_PLAYLIST_PAGE
) โดยนับจากนี้ไป ยอดดูทั้ง 2 ประเภทจะเชื่อมโยงกับค่ามิติข้อมูล PLAYLIST
15 ธันวาคม 2022
API ของ YouTube Analytics (ข้อความค้นหาที่กำหนดเป้าหมาย) รองรับมิติข้อมูลใหม่ 2 รายการและรายงานใหม่ 1 รายการ ได้แก่
-
รายงานใหม่แสดงกิจกรรมของผู้ใช้ตามเมือง รายงานนี้มีไว้สำหรับช่องและเจ้าของเนื้อหา รายงานนี้มีมิติข้อมูล
city
ใหม่ ซึ่งระบุค่าประมาณเมืองที่ YouTube เกิดขึ้นจากผู้ใช้ -
มิติข้อมูล
creatorContentType
ใหม่ระบุประเภทเนื้อหา YouTube ที่เชื่อมโยงกับเมตริกกิจกรรมของผู้ใช้ในแถวข้อมูล ค่าที่รองรับคือLIVE_STREAM
,SHORTS
,STORY
และVIDEO_ON_DEMAND
ระบบรองรับมิติข้อมูล
creatorContentType
เป็นมิติข้อมูลที่ไม่บังคับสำหรับรายงานวิดีโอของช่องและเจ้าของเนื้อหาทั้งหมด -
ตอนนี้คู่มือตัวอย่างคำขอสำหรับ YouTube Analytics API มีตัวอย่างสำหรับมิติข้อมูลใหม่ทั้ง 2 รายการรวมอยู่ด้วย
-
เรานำการอ้างอิงมิติข้อมูล
7DayTotals
และ30DayTotals
ออกจากเอกสารประกอบแล้ว เราได้ประกาศการเลิกใช้งานมิติข้อมูลเหล่านี้ไปเมื่อเดือนตุลาคม 2019
26 สิงหาคม 2022
ทั้ง API ของ YouTube Analytics (คำค้นหาที่กำหนดเป้าหมาย) และ API การรายงานของ YouTube (รายงานจำนวนมาก) รองรับค่ารายละเอียดแหล่งที่มาของการเข้าชมใหม่ ดังนี้
- ใน API ของ YouTube Analytics API (Targeted Query) หากค่าของมิติข้อมูล
insightTrafficSourceType
คือSUBSCRIBER
คุณจะกำหนดค่าinsightTrafficSourceDetail
เป็นpodcasts
ได้ ซึ่งบ่งชี้ว่าการเข้าชมได้รับการอ้างอิงจากหน้าปลายทางของ Podcasts - ใน API การรายงานของ YouTube (รายงานแบบกลุ่ม) หากค่าของมิติข้อมูล
traffic_source_type
คือ3
ค่าtraffic_source_detail
จะตั้งค่าเป็นpodcasts
ได้ ซึ่งบ่งชี้ว่าการเข้าชมได้รับการอ้างอิงจากหน้าปลายทางของ Podcasts
11 กุมภาพันธ์ 2022
ชุดค่าที่ถูกต้องสำหรับมิติข้อมูล gender
จะเปลี่ยนแปลงในวันที่ 11 สิงหาคม 2022 หรือหลังจากนั้น นี่อาจเป็นการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังในการใช้งาน API ของคุณ เราจะประกาศการเปลี่ยนแปลงนี้ 6 เดือนก่อนจะมีผล เพื่อให้เป็นไปตามส่วนการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังในข้อกำหนดในการให้บริการบริการ API ของ YouTube โปรดอัปเดตการใช้งาน API ก่อนวันที่ 11 สิงหาคม 2022 เพื่อให้เปลี่ยนไปใช้ชุดค่าใหม่ได้อย่างราบรื่น
การเปลี่ยนแปลงที่กำลังเกิดขึ้นมีดังนี้
- ปัจจุบันมิติข้อมูล
gender
รองรับ 2 ค่า ได้แก่female
และmale
ใน API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย) โดยในวันที่ 11 สิงหาคม 2022 เป็นต้นไป มิติข้อมูลดังกล่าวจะรองรับค่า 3 ค่า ได้แก่female
,male
และuser_specified
- ใน API การรายงานของ YouTube (รายงานแบบกลุ่ม) ปัจจุบันมิติข้อมูล
gender
รองรับ 3 ค่า ได้แก่FEMALE
,MALE
และGENDER_OTHER
ในวันที่ 11 สิงหาคม 2022 หรือหลังจากนั้น ชุดค่าที่รองรับจะเปลี่ยนเป็นFEMALE
,MALE
และUSER_SPECIFIED
9 กุมภาพันธ์ 2022
มีการอัปเดตเมตริก 2 รายการให้ไม่รวมการเข้าชมผ่านคลิปวนซ้ำตั้งแต่วันที่ 13 ธันวาคม 2021 การเปลี่ยนแปลงนี้ส่งผลต่อทั้ง API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย) และ API การรายงานของ YouTube (รายงานแบบกลุ่ม)
- ใน API ของ YouTube Analytics (Targeted Query) ทั้งเมตริก
averageViewDuration
และaverageViewPercentage
จะไม่รวมการเข้าชมคลิปวนซ้ำตั้งแต่วันที่ 13 ธันวาคม 2021 - ใน API การรายงานของ YouTube (รายงานแบบกลุ่ม) ทั้งเมตริก
average_view_duration_seconds
และaverage_view_duration_percentage
จะไม่รวมการเข้าชมคลิปวนซ้ำตั้งแต่วันที่ 13 ธันวาคม 2021
2 กุมภาพันธ์ 2022
API การรายงานของ YouTube (รายงานแบบเป็นกลุ่ม) นี้รองรับค่ามิติข้อมูลแหล่งที่มาของการเข้าชมใหม่ที่ระบุว่ายอดดูมาจากการส่งผู้ชมแบบสด ดังนี้
- ใน API การรายงานของ YouTube (รายงานแบบกลุ่ม) มิติข้อมูล
traffic_source_type
รองรับค่า28
สำหรับแหล่งที่มาของการเข้าชมประเภทนี้ มิติข้อมูล traffic_source_detail
จะระบุรหัสช่องที่มีการอ้างอิงผู้ชม
23 กันยายน 2020
ทั้ง API ของ YouTube Analytics (คำค้นหาที่กำหนดเป็นเป้าหมาย) และ API การรายงานของ YouTube (รายงานจำนวนมาก) รองรับค่ามิติข้อมูลแหล่งที่มาของการเข้าชมใหม่ที่ระบุว่ามีการอ้างอิงถึงผู้ชมด้วยการปัดในแนวตั้งในประสบการณ์การรับชม YouTube Shorts
- ใน API ของ YouTube Analytics API (Targeted Query) มิติข้อมูล
insightTrafficSourceType
จะรองรับค่าSHORTS
- ใน API การรายงานของ YouTube (รายงานแบบกลุ่ม) มิติข้อมูล
traffic_source_type
รองรับค่า24
มิติข้อมูลรายละเอียดแหล่งที่มาของการเข้าชม insightTrafficSourceDetail
ใน API ของ YouTube Analytics หรือ traffic_source_detail
ใน API การรายงานของ YouTube ไม่ได้ป้อนข้อมูลสำหรับประเภทแหล่งที่มาของการเข้าชมใหม่นี้
20 กรกฎาคม 2020
การอัปเดตนี้ครอบคลุมการเปลี่ยนแปลง 2 อย่างที่ส่งผลกระทบต่อ API ของ YouTube Analytics (คำค้นหาที่กำหนดเป็นเป้าหมาย) ดังนี้
- ขนาดสูงสุดของกลุ่มการรายงานของ YouTube Analytics เพิ่มขึ้นจาก 200 เป็น 500 รายการ
- พารามิเตอร์
filters
ของเมธอดreports.query
จะระบุรายการตัวกรองที่ควรใช้เมื่อดึงข้อมูล YouTube Analytics พารามิเตอร์ดังกล่าวรองรับความสามารถในการระบุค่าหลายค่าสำหรับตัวกรองvideo
,playlist
และchannel
อีกทั้งจำนวนรหัสสูงสุดที่ระบุสำหรับตัวกรองเหล่านั้นได้ก็เพิ่มขึ้นจาก 200 เป็น 500 รหัส
13 กุมภาพันธ์ 2020
การอัปเดตนี้จะมีการเปลี่ยนแปลงต่อไปนี้ซึ่งเกี่ยวข้องกับ API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย) และ API การรายงานของ YouTube (รายงานจำนวนมาก) ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงเหล่านี้ได้ในศูนย์ช่วยเหลือของ YouTube
ใน API ทั้งสอง ชุดค่ารายละเอียดแหล่งที่มาของการเข้าชมที่เป็นไปได้สำหรับการแจ้งเตือนจะเปลี่ยนแปลง
ในการค้นหาที่กำหนดเป้าหมาย ระบบจะรายงานการแจ้งเตือนเป็น insightTrafficSourceType=NOTIFICATION
ในรายงานจำนวนมาก ระบบจะรายงานการแจ้งเตือนเป็น traffic_source_type=17
ค่าใหม่จะแยกการแจ้งเตือนที่เกี่ยวข้องกับวิดีโอที่อัปโหลดและสตรีมแบบสดซึ่งก่อนหน้านี้รายงานเป็น uploaded
ออกเป็น 2 หมวดหมู่ ดังนี้
uploaded_push
- ยอดดูที่มาจากข้อความ Push ที่ส่งไปยังผู้ติดตามเมื่ออัปโหลดวิดีโอuploaded_other
- ยอดดูที่มาจากการแจ้งเตือนที่ไม่ใช่ข้อความ Push เช่น การแจ้งเตือนทางอีเมลหรือกล่องจดหมาย ที่ส่งไปยังผู้ติดตามเมื่ออัปโหลดวิดีโอ
ค่าเหล่านี้จะแสดงผลสำหรับช่วงเวลาตั้งแต่วันที่ 13-01-2020 (13 มกราคม 2020)
ทั้งนี้ เราขอย้ำเตือนอีกครั้งว่าค่าเหล่านี้ไม่ได้แสดงถึงการแจ้งเตือน แต่แสดงแหล่งที่มาของการเข้าชมที่กระตุ้นให้เกิดยอดดูบางส่วนใน YouTube เช่น หากแถวรายงานระบุว่า views=3
, traffic_source_type=17
(NOTIFICATION
) และ traffic_source_detail=uploaded_push
แสดงว่าแถวระบุว่ายอดดู 3 ครั้งเกิดจากผู้ชมคลิกข้อความ Push ที่ส่งเมื่ออัปโหลดวิดีโอ
15 ตุลาคม 2019
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย)
-
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
YouTube จะเลิกรองรับมิติข้อมูล
7DayTotals
และ30DayTotals
คุณจะยังคงดึงข้อมูลโดยใช้มิติข้อมูลเหล่านั้นได้จนถึงวันที่ 15 เมษายน 2020 ตั้งแต่วันที่ดังกล่าวเป็นต้นไป การพยายามเรียกดูรายงานโดยใช้มิติข้อมูล7DayTotals
หรือ30DayTotals
จะแสดงข้อผิดพลาดโปรดทราบว่าผู้ใช้สามารถทำซ้ำข้อมูลบางส่วนสำหรับมิติข้อมูลเหล่านี้ได้โดยการค้นหาโดยใช้มิติข้อมูล
day
และรวบรวมข้อมูลหรือดึงข้อมูลในช่วง 7 หรือ 30 วัน เช่น- จำนวนการดูสำหรับช่วงเวลา 7 วันคำนวณได้ด้วยการรวมจำนวนการดูจากแต่ละวันของช่วงเวลานั้น
- เปอร์เซ็นต์ผู้ชมสำหรับช่วง 7 วันสามารถคำนวณได้โดยการคูณจำนวนการดูที่เกิดขึ้นในแต่ละวันคูณเปอร์เซ็นต์ผู้ชมในวันนั้นๆ เพื่อหาจำนวนผู้ชมที่เข้าสู่ระบบเมื่อดูวิดีโอในวันนั้น จากนั้นจึงสามารถเพิ่มจำนวนผู้ชมที่เข้าสู่ระบบตลอดระยะเวลาหนึ่งและหารด้วยจำนวนการดูทั้งหมดในช่วงเวลานั้นเพื่อดูเปอร์เซ็นต์ผู้ดูตลอดระยะเวลาดังกล่าว
- ระบบคำนวณจำนวนผู้ชมที่ไม่ซ้ำกันในระยะเวลา 7 วันไม่ได้เนื่องจากระบบคำนวณผู้ชมรายเดียวกันเป็นผู้ชมที่ไม่ซ้ำกันคนละวันกัน อย่างไรก็ตาม คุณอาจสามารถใช้มิติข้อมูล
month
แทนมิติข้อมูล30DayTotals
เพื่อประเมินข้อมูลเกี่ยวกับจำนวนผู้ชมที่ไม่ซ้ำกันในช่วงระยะเวลา 30 วันได้ โปรดทราบว่ามิติข้อมูลmonth
หมายถึงเดือนในปฏิทิน ส่วนมิติข้อมูล30DayTotals
จะคำนวณระยะเวลา 30 วันโดยอิงตามวันที่เริ่มต้นและวันที่สิ้นสุดที่ระบุ
27 มิถุนายน 2019
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย)
-
เนื่องจากตอนนี้เราได้เลิกใช้งาน API เวอร์ชัน 1 โดยสมบูรณ์แล้ว จึงมีการอัปเดตเอกสารประกอบเพื่อนำการอ้างอิงเวอร์ชันดังกล่าวออก ซึ่งรวมถึงประกาศการเลิกใช้งานและคำแนะนำในการย้ายข้อมูลที่อธิบายวิธีอัปเดตเป็นเวอร์ชัน 2
1 พฤศจิกายน 2018
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย)
-
และเลิกใช้งาน API เวอร์ชัน 1 แล้ว หากคุณยังไม่ได้ดำเนินการ โปรดอัปเดตไคลเอ็นต์ API ให้ใช้ API เวอร์ชัน 2 โดยเร็วที่สุดเพื่อลดการหยุดชะงักของบริการ ดูรายละเอียดเพิ่มเติมจากคำแนะนำในการย้ายข้อมูล
โปรดทราบว่าเราได้ประกาศกำหนดเวลาสำหรับการเลิกใช้งานนี้ไปก่อนหน้านี้ในวันที่ 26 เมษายน 2018
17 กันยายน 2018
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ที่เกี่ยวข้องกับ API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย)
-
ส่วนการลบข้อมูลระบุตัวบุคคลใหม่ในเอกสารภาพรวมโมเดลข้อมูลจะอธิบายว่าข้อมูลบางอย่างใน YouTube Analytics จะถูกจำกัดเมื่อเมตริกไม่เป็นไปตามเกณฑ์ที่กำหนด ซึ่งสามารถเกิดขึ้นได้หลายกรณี ในทางปฏิบัติหมายความว่ารายงานอาจไม่มีข้อมูลทั้งหมด (หรือข้อมูลใดเลย) ในกรณีต่อไปนี้
-
วิดีโอหรือช่องมีปริมาณการเข้าชมจำกัดในระยะเวลาที่ระบุ
หรือ
-
คุณได้เลือกตัวกรองหรือมิติข้อมูล เช่น แหล่งที่มาของการเข้าชมหรือประเทศ ซึ่งค่าไม่ถึงเกณฑ์ที่กำหนดไว้
ส่วนใหม่นี้ยังพูดถึงประเภทของข้อมูลที่อาจถูกจำกัดในรายงานของ YouTube Analytics ด้วย
-
-
เอกสารรายงานช่องและรายงานของเจ้าของเนื้อหาได้รับการอัปเดตเพื่อแสดงข้อเท็จจริงที่ว่าเมตริก
redViews
และestimatedRedMinutesWatched
ไม่รองรับในรายงานตำแหน่งที่เล่น แหล่งที่มาของการเข้าชม และรายงานประเภทอุปกรณ์/ระบบปฏิบัติการอีกต่อไป
18 มิถุนายน 2018
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API ของ YouTube Analytics (การค้นหาเป้าหมาย)
- มีการเปลี่ยนแปลงข้อกำหนดด้านขอบเขตสำหรับเมธอดต่อไปนี้
- คำขอที่ส่งไปยังเมธอด
reports.query
ต้องมีสิทธิ์เข้าถึงขอบเขตhttps://www.googleapis.com/auth/youtube.readonly
- คำขอที่ส่งไปยังเมธอด
groupItems.list
ต้องมีสิทธิ์เข้าถึงสิ่งใดสิ่งหนึ่งต่อไปนี้https://www.googleapis.com/auth/youtube
ขอบเขต
หรือ- ขอบเขต
https://www.googleapis.com/auth/youtube.readonly
และ
ขอบเขตhttps://www.googleapis.com/auth/yt-analytics.readonly
ตัวเลือกแรกใช้ขอบเขตเดียว ซึ่งก็คือขอบเขตแบบอ่าน-เขียน ในขณะที่ตัวเลือกที่ 2 ใช้ขอบเขตแบบอ่านอย่างเดียว 2 ขอบเขต
- คำขอที่ส่งไปยังเมธอด
23 พฤษภาคม 2018
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API ของ YouTube Analytics (การค้นหาเป้าหมาย)
- ภาพรวม API มีส่วนใหม่คือเมตริกรวมและรายการที่ถูกลบ ซึ่งจะอธิบายวิธีที่การตอบกลับของ API จัดการกับข้อมูลที่เชื่อมโยงกับทรัพยากรที่ถูกลบ เช่น วิดีโอ เพลย์ลิสต์ หรือช่อง
- เราได้อัปเดตส่วนแนวทางปฏิบัติแนะนำของภาพรวม API เพื่อช่วยเตือนว่าคุณสามารถใช้ API ข้อมูลของ YouTube เพื่อเรียกข้อมูลเมตาเพิ่มเติมสำหรับแหล่งข้อมูลที่ระบุในการตอบกลับเกี่ยวกับ API ของ YouTube Analytics ได้ ตามที่ระบุไว้ในนโยบายสำหรับนักพัฒนาบริการ YouTube API (ส่วน III.E.4.b ถึง III.E.4.d) ไคลเอ็นต์ API จะต้องลบหรือรีเฟรชข้อมูลเมตาของทรัพยากรที่จัดเก็บไว้จาก API นั้นหลังผ่านไป 30 วัน
22 พฤษภาคม 2018
การอัปเดตนี้มีการเปลี่ยนแปลงที่เกี่ยวข้องกับ API การรายงาน (รายงานจำนวนมาก) ของ YouTube ดังต่อไปนี้
- ในตอนนี้ การเปลี่ยนแปลงต่อไปนี้มีกำหนดมีผลในเดือนกรกฎาคม 2018 และนโยบายใหม่จะมีผลกับรายงานและงานการรายงานทั้งหมดทั่วโลก
-
หลังจากการเปลี่ยนแปลง รายงาน API ส่วนใหญ่รวมถึงรายงานโฆษณาทดแทนจะพร้อมใช้งานเป็นเวลา 60 วันนับจากวันที่สร้าง อย่างไรก็ตาม คุณสามารถดูรายงานที่มีข้อมูลย้อนหลังได้เป็นเวลา 30 วันนับจากวันที่สร้าง
ก่อนการประกาศนี้ รายงาน API ทั้งหมดจะใช้ได้เป็นเวลา 180 วันนับจากวันที่สร้าง เราขอกล่าวย้ำเพื่อความชัดเจน เมื่อการเปลี่ยนแปลงนโยบายนี้มีผลบังคับใช้ คุณจะเข้าถึงรายงานข้อมูลย้อนหลังที่มีอายุเกิน 30 วันผ่าน API ไม่ได้อีกต่อไป คุณจะไม่สามารถเข้าถึงรายงานอื่นๆ ทั้งหมดที่มีอายุมากกว่า 60 วันได้ ด้วยเหตุนี้ เอกสารประกอบจึงระบุว่ารายงานที่สร้างขึ้นก่อนการเปลี่ยนแปลงนโยบายจะใช้งานได้สูงสุด 180 วัน
-
หลังจากการเปลี่ยนแปลง เมื่อคุณกำหนดเวลางานการรายงาน YouTube จะสร้างรายงานตั้งแต่วันนั้นเป็นต้นไปโดยครอบคลุมระยะเวลา 30 วันก่อนเวลาที่งานนั้นกำหนดไว้ ก่อนการเปลี่ยนแปลง เมื่อคุณกำหนดเวลางานการรายงาน YouTube จะสร้างรายงานที่ครอบคลุมช่วงเวลา 180 วันก่อนที่จะถึงวันงานนั้น
-
-
เราได้อัปเดตส่วนแนวทางปฏิบัติแนะนำเพื่อช่วยเตือนว่าคุณสามารถใช้ YouTube Data API เพื่อเรียกข้อมูลเมตาเพิ่มเติมสำหรับแหล่งข้อมูลที่ระบุในรายงานได้ ตามที่ระบุไว้ในนโยบายสำหรับนักพัฒนาบริการ YouTube API (ส่วน III.E.4.b ถึง III.E.4.d) ไคลเอ็นต์ API จะต้องลบหรือรีเฟรชข้อมูลเมตาของทรัพยากรที่จัดเก็บไว้จาก API นั้นหลังผ่านไป 30 วัน
-
เราได้อัปเดตส่วนลักษณะของรายงานเพื่อให้ทราบว่าแม้ข้อมูลรายงานจะไม่ได้รับการกรอง แต่รายงานที่มีข้อมูลสำหรับช่วงเวลาตั้งแต่วันที่ 1 มิถุนายน 2018 เป็นต้นไป จะไม่มีการอ้างอิงถึงแหล่งข้อมูลของ YouTube ที่มีการลบข้อมูลไปอย่างน้อย 30 วันก่อนวันที่สร้างรายงาน
-
ส่วนข้อมูลย้อนหลังของภาพรวม API ได้รับการอัปเดตเพื่อให้ทราบว่าเมื่อคุณตั้งเวลางานการรายงานใหม่ โดยทั่วไปจะมีการโพสต์รายงานข้อมูลย้อนหลังภายใน 2-3 วัน ก่อนหน้านี้เอกสารระบุว่าอาจใช้เวลาสูงสุด 30 วันกว่าที่รายงานดังกล่าวจะแสดงได้
-
เราได้อัปเดตส่วนข้อมูลทดแทนในภาพรวม API เพื่อระบุข้อมูลทดแทนให้ชัดเจนยิ่งขึ้นว่าเป็นชุดข้อมูลที่จะแทนที่ชุดข้อมูลที่ส่งก่อนหน้านี้
26 เมษายน 2018
API ของ YouTube Analytics (Targeted Query) API (v2) เวอร์ชัน 2 พร้อมให้บริการแบบสาธารณะแล้ว รายการต่อไปนี้แสดงการเปลี่ยนแปลงของผลิตภัณฑ์และเอกสารที่เกี่ยวข้องกับ API เวอร์ชันใหม่
-
API v2 นั้นแทบจะเหมือนกับ v1 API เลย อย่างไรก็ตาม คุณอาจต้องอัปเดตโค้ดเพื่อให้สอดคล้องกับการเปลี่ยนแปลงที่แสดงด้านล่าง รายละเอียดเกี่ยวกับการเปลี่ยนแปลงทั้งหมดเหล่านี้ได้อธิบายไว้ในคำแนะนำในการย้ายข้อมูลใหม่
- เวอร์ชันของ API เปลี่ยนจาก
v1
เป็นv2
แล้ว - URL ฐานสำหรับคำขอ API เปลี่ยนจาก
https://www.googleapis.com/youtube/analytics/v1
เป็นhttps://youtubeanalytics.googleapis.com/v2
- พารามิเตอร์หลายรายการสำหรับเมธอด
reports.query
มีการอัปเดตชื่อ กล่าวอย่างเจาะจงคือ ชื่อพารามิเตอร์ที่มีขีดกลาง เช่นend-date
ใน API v1 จะใช้ตัวพิมพ์ Caml (endDate
) แทนขีดกลางใน API v2 การเปลี่ยนแปลงนี้ทำให้ชื่อพารามิเตอร์สอดคล้องกันทั่วทั้ง API เนื่องจากวิธีการของ API สร้างและจัดการกลุ่มที่ใช้ตัวพิมพ์เล็ก/ใหญ่ที่ใช้ตัวอักษรอูฐอยู่แล้วสำหรับชื่อพารามิเตอร์ - API v2 ไม่รองรับคำขอแบบกลุ่มที่ส่งไปยังปลายทางกลุ่ม HTTP ส่วนกลางของ Google (
www.googleapis.com/batch
) หากส่งคำขอแบบกลุ่มใน API v2 คุณจะต้องใช้ปลายทางhttps://youtubeanalytics.googleapis.com/v2
แทน
นอกจากนี้ v1 API v2 ยังไม่รองรับฟีเจอร์ v1 บางอย่าง:
- เมธอด
reports.query
ไม่รองรับพารามิเตอร์คำขอalt
,quotaUser
และuserIp
อีกต่อไป - API v2 ไม่มีปลายทางแบบกลุ่มที่รองรับกลุ่มที่ประกอบด้วยคำขอไปยัง API ที่แตกต่างกัน (แต่แบบกลุ่มอาจประกอบด้วยคำขอที่ส่งไปยังเมธอดต่างๆ ของ API เดียวกัน) การเลิกใช้งานนี้ไม่ได้เกิดขึ้นกับ API ของ YouTube Analytics โดยเฉพาะเนื่องจาก Google กำลังเลิกใช้งานปลายทางแบบกลุ่มทั่วโลกใน API ทั้งหมด
- API v2 ไม่รองรับโปรโตคอล JSON-RPC ที่รองรับใน API v1 ขอย้ำอีกครั้งว่าการเลิกใช้งานนี้ไม่ได้เกิดขึ้นกับ API ของ YouTube Analytics โดยเฉพาะ
- เวอร์ชันของ API เปลี่ยนจาก
-
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
ขณะนี้มีการเลิกใช้งาน API เวอร์ชัน 1 (v1) แล้วและรองรับจนถึงวันที่ 31 ตุลาคม 2018 คำขอทั้งหมดที่ส่งไปยัง API เวอร์ชัน 1 จะหยุดทำงานหลังจากวันที่ดังกล่าว ดังนั้น โปรดอัปเกรดไปใช้ API เวอร์ชัน 2 ภายในวันที่ 31 ตุลาคม 2018 เพื่อไม่ให้การเข้าถึงข้อมูล YouTube Analytics ผ่าน API หยุดชะงัก
21 กุมภาพันธ์ 2018
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API ของ YouTube Analytics (การค้นหาเป้าหมาย)
- รายงานข้อมูลประชากรของผู้ชมซึ่งรวบรวมสถิติการดูตามกลุ่มอายุและเพศของผู้ชมไม่รองรับมิติข้อมูล
youtubeProduct
ที่ระบุบริการของ YouTube ที่เกิดกิจกรรมของผู้ใช้อีกต่อไป
18 มกราคม 2018
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API การรายงานของ YouTube (รายงานจำนวนมาก)
- ขณะนี้มิติข้อมูล
operating_system
ซึ่งระบุระบบซอฟต์แวร์ของอุปกรณ์ที่เกิดการดู รองรับค่าต่อไปนี้25
: KaiOS
- ขณะนี้มิติข้อมูล
-
API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย)
- มิติข้อมูล
operatingSystem
รองรับค่ามิติข้อมูลKAIOS
- มิติข้อมูล
20 ธันวาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลง 2 รายการที่เกี่ยวข้องกับ API การรายงานของ YouTube ดังนี้
-
ตอนนี้เซิร์ฟเวอร์ API รองรับการบีบอัด gzip สำหรับคำขอที่ดาวน์โหลดรายงานแล้ว โปรดทราบว่าระบบไม่รองรับการบีบอัด gzip สำหรับคำขอ API ประเภทอื่น การเปิดใช้การบีบอัด gzip จะลดแบนด์วิดท์ที่ต้องใช้ในการตอบสนองของ API แต่ละรายการ และแม้ว่าแอปพลิเคชันจะต้องใช้เวลา CPU เพิ่มเติมในการคลายการบีบอัดการตอบกลับจาก API แต่ประโยชน์ของการใช้ทรัพยากรเครือข่ายน้อยลงมักจะมีค่าใช้จ่ายมากกว่า
หากต้องการได้รับการตอบกลับที่เข้ารหัสด้วย gzip ให้ตั้งค่าส่วนหัวของคำขอ HTTP
Accept-Encoding
เป็นgzip
ดังที่แสดงในตัวอย่างต่อไปนี้Accept-Encoding: gzip
ฟังก์ชันการทำงานนี้มีอธิบายในภาพรวม API และในคำจำกัดความของพร็อพเพอร์ตี้
downloadUrl
ของทรัพยากรreport
-
เอกสารประกอบของมิติข้อมูล
age group
และgender
ได้รับการแก้ไขเพื่อแสดงค่าจริงที่ API แสดงสำหรับมิติข้อมูลเหล่านั้น โปรดทราบว่านี่เป็นการแก้ไขเอกสารประกอบ และไม่ได้แสดงถึงการเปลี่ยนแปลงฟังก์ชันหรือลักษณะการทำงานของ API กล่าวอย่างเจาะจงคือ ค่าต่อไปนี้มีการเปลี่ยนแปลง- ค่าสำหรับมิติข้อมูล
age_group
ใช้ตัวอักษรพิมพ์ใหญ่ มีขีดล่างระหว่างคำว่าAGE
และตัวเลขในกลุ่มอายุ และใช้ขีดล่างแทนขีดกลาง ด้วยเหตุนี้ ค่า เช่นage13-17
และage18-24
จึงได้รับการแก้ไขเป็นAGE_13_17
และAGE_18_24
ตามลำดับ - ค่าของมิติข้อมูล
gender
จะใช้ตัวอักษรพิมพ์ใหญ่ ดังนั้น ค่าfemale
,male
และgender_other
จึงได้รับการแก้ไขเป็นFEMALE
,MALE
และGENDER_OTHER
- ค่าสำหรับมิติข้อมูล
10 สิงหาคม 2017
เอกสารฉบับนี้ได้ประกาศการเลิกใช้งานเมตริก earnings
API ของ YouTube Analytics API เมื่อวันที่ 10 สิงหาคม 2016 (ในขณะเดียวกัน API ได้เพิ่มการรองรับเมตริกใหม่ที่ชื่อว่า estimatedRevenue
ซึ่งให้ข้อมูลเดียวกัน)
เนื่องจากเมตริก earnings
เป็นเมตริกหลัก เมตริกนี้จึงรองรับเป็นเวลา 1 ปีนับจากวันที่ประกาศ เนื่องจากช่วงเวลาตลอดทั้งปีได้สิ้นสุดลงแล้ว แต่ระบบจะไม่รองรับเมตริก earnings
อีกต่อไป ด้วยเหตุนี้ คำขอ API ที่ระบุเมตริก earnings
จึงแสดงโค้ดตอบกลับ HTTP 400
แล้วในตอนนี้ หากคุณยังไม่ได้อัปเดตแอปเพื่อใช้เมตริก estimatedRevenue
แทนเมตริก earnings
โปรดดำเนินการโดยเร็วที่สุด
เราได้อัปเดตเอกสารประกอบเกี่ยวกับ API เพื่อนำการอ้างอิงที่เหลือไปยังเมตริก earnings
ออก
6 กรกฎาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย)
-
เอกสารประกอบของ API ได้รับการอัปเดตเพื่อแสดงข้อเท็จจริงที่ว่าการตอบกลับ API มีข้อมูลจนถึงวันสุดท้ายในช่วงวันที่ที่ขอซึ่งมีเมตริกทั้งหมดที่ค้นหา
ตัวอย่างเช่น หากคำขอระบุวันที่สิ้นสุดเป็นวันที่ 5 กรกฎาคม 2017 และค่าสำหรับเมตริกที่ขอทั้งหมดจะใช้ได้จนถึงวันที่ 3 กรกฎาคม 2017 วันที่ดังกล่าวจะเป็นวันสุดท้ายที่มีข้อมูลรวมอยู่ในการตอบกลับ (ถึงแม้ว่าข้อมูลสำหรับเมตริกที่ขอบางรายการจะพร้อมใช้งานในวันที่ 4 กรกฎาคม 2017 ก็ตาม)
-
ตอนนี้มิติข้อมูล
adType
รองรับค่าreservedBumperInstream
ซึ่งหมายถึงโฆษณาวิดีโอแบบข้ามไม่ได้ที่มีความยาวสูงสุด 6 วินาทีซึ่งเล่นก่อนที่จะดูวิดีโอ รูปแบบโฆษณาเหมือนกับโฆษณาauctionBumperInstream
แต่ประเภทนี้หมายถึงโฆษณาที่ขายแบบจอง ไม่ใช่การประมูล
-
-
API การรายงานของ YouTube (รายงานจำนวนมาก)
-
ตอนนี้มิติข้อมูล
ad_type
รองรับค่า20
ซึ่งหมายถึงโฆษณาบัมเปอร์ที่ขายแบบจองแล้ว โฆษณาบัมเปอร์คือโฆษณาวิดีโอแบบข้ามไม่ได้ที่มีความยาวได้สูงสุด 6 วินาทีซึ่งจะเล่นก่อนที่จะดูวิดีโอ โปรดทราบว่าค่า19
สำหรับมิติข้อมูลนี้ยังหมายถึงโฆษณาบัมเปอร์ที่ขายในการประมูลไม่ใช่แบบจองด้วย -
มีการลบงานการรายงานของ YouTube Reporting API ต่อไปนี้
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
เราได้ประกาศว่ารายงานประเภทนี้เลิกใช้งานแล้วในวันที่ 15 กันยายน 2016 และระบบจะไม่สร้างรายงานสำหรับประเภทรายงานดังกล่าวอีกต่อไปหลังจากวันที่ 15 ธันวาคม 2016 รายงานที่สร้างไว้ก่อนหน้านี้จะยังคงอยู่เป็นเวลา 180 วันนับจากวันที่สร้าง รายงานบางอย่างจึงเข้าถึงได้ถึงวันที่ 15 มิถุนายน 2017 แต่เนื่องจากรายงานใช้ไม่ได้แล้ว งานที่เชื่อมโยงกับรายงานจึงไม่จำเป็นเช่นกัน
-
24 พฤษภาคม 2017
งานการรายงานทั้งหมดสำหรับรายงาน YouTube Reporting API ต่อไปนี้ถูกลบแล้ว
content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1
เราได้ประกาศว่ารายงานประเภทนี้เลิกใช้งานแล้วในวันที่ 22 มิถุนายน 2016 และระบบจะไม่สร้างรายงานสำหรับประเภทรายงานดังกล่าวอีกต่อไปหลังจากวันที่ 22 กันยายน 2016 รายงานที่สร้างไว้ก่อนหน้านี้จะยังคงอยู่เป็นเวลา 180 วันนับจากวันที่สร้าง รายงานบางอย่างจึงเข้าถึงได้ย้อนหลังถึงวันที่ 22 มีนาคม 2017 แต่เนื่องจากรายงานใช้ไม่ได้แล้ว งานที่เชื่อมโยงกับรายงานจึงไม่จำเป็นเช่นกัน
22 พฤษภาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API การรายงานของ YouTube (รายงานจำนวนมาก)
- ตอนนี้มิติข้อมูล
sharing_service
ซึ่งระบุบริการที่ใช้ในการแชร์วิดีโอรองรับค่าต่อไปนี้แล้ว85
: YouTube Music86
: YouTube Gaming87
: YouTube Kids88
: YouTube TV
นอกจากนี้ยังมีการอัปเดตชื่อที่ใช้ระบุค่า
52
ในเอกสารประกอบเป็น Kakao (Kakao Talk) เพื่อให้แตกต่างจากค่า73
(Kakao Story) อย่างชัดเจนยิ่งขึ้น การเปลี่ยนแปลงนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงใดๆ ในการทำงานของ API หรือการจัดประเภทวิดีโอที่แชร์กับบริการเหล่านี้
- ตอนนี้มิติข้อมูล
-
API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย)
- ตอนนี้มิติข้อมูล
sharingService
รองรับค่าต่อไปนี้แล้วYOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
- ตอนนี้มิติข้อมูล
28 มีนาคม 2017
ตอนนี้เจ้าของช่องที่เข้าถึงข้อมูลรายได้ผ่าน YouTube Analytics ใน Creator Studio ได้จะเข้าถึงข้อมูลรายได้ดังกล่าวผ่าน API ของ YouTube Analytics ดังต่อไปนี้ได้ด้วย
-
API รองรับเมตริกที่เกี่ยวข้องกับรายได้ต่อไปนี้
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
เมตริกเหล่านี้ใช้ได้กับรายงานต่อไปนี้
-
ตอนนี้เจ้าของช่องสามารถเรียกดูรายงานประสิทธิภาพของโฆษณาได้แล้ว ซึ่งรองรับมิติข้อมูล
adType
รวมทั้งมิติข้อมูลday
ที่ไม่บังคับ -
ตอนนี้คู่มือตัวอย่างคำขอสำหรับ API ของ YouTube Analytics ประกอบด้วยส่วนรายงานรายได้ของช่อง
17 มีนาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API ของ YouTube Analytics รองรับเมตริก
redViews
และestimatedRedMinutesWatched
ซึ่งทั้งคู่เกี่ยวข้องกับผู้ชม YouTube Red จริงๆ แล้ว API รองรับเมตริกเหล่านี้มาระยะหนึ่งแล้ว และ YouTube Reporting API รองรับเมตริกทั้ง 2 อย่างที่ประกาศไปเมื่อวันที่ 15 กันยายน 2016 อยู่แล้ว- เมตริก
redViews
จะระบุจำนวนครั้งที่สมาชิก YouTube Red ดูวิดีโอ - เมตริก
estimatedRedMinutesWatched
จะระบุจำนวนนาทีที่สมาชิก YouTube Red ดูวิดีโอ
มีการอัปเดตรายงานแชแนลและรายงานของเจ้าของเนื้อหาเพื่อแสดงรายงานที่สนับสนุนเมตริกใหม่ 2 รายการ โดยใช้ได้กับรายงานที่รองรับเมตริก
views
และestimatedMinutesWatched
อยู่แล้ว - เมตริก
3 มีนาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API การรายงานของ YouTube (รายงานจำนวนมาก)
-
คำจำกัดความของมิติข้อมูล
date
ได้รับการแก้ไขแล้ว โปรดทราบว่าค่ามิติข้อมูลอ้างอิงถึงช่วงเวลาเริ่มตั้งแต่ 00:00 น. ตามเวลาแปซิฟิก และสิ้นสุดเวลา 23:59 น. ตามเวลาแปซิฟิกในวันที่ เดือน และปีที่ระบุ เวลาแปซิฟิกจะเป็น UTC-7 หรือ UTC-8 ทั้งนี้ขึ้นอยู่กับช่วงเวลาของปีแม้ว่าวันที่โดยทั่วไปจะแสดงช่วงเวลา 24 ชั่วโมง แต่วันที่ที่มีการปรับนาฬิกาไปข้างหน้าจะแสดงระยะเวลา 23 ชั่วโมง และวันที่ที่มีการปรับนาฬิกาย้อนหลังจะแสดงช่วงเวลา 25 ชั่วโมง (ก่อนหน้านี้ เอกสารระบุว่าแต่ละวันที่มีระยะเวลา 24 ชั่วโมงที่ไม่ซ้ำกันและเวลาแปซิฟิกเป็น UTC-8 เสมอ)
โปรดทราบว่าการแก้ไขนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานจริงของ API
- ขณะนี้มิติข้อมูล
operating_system
ซึ่งระบุระบบซอฟต์แวร์ของอุปกรณ์ที่เกิดการดู รองรับค่าต่อไปนี้22
: ทิเซน23
: Firefox24
: RealMedia
-
งานการรายงานทั้งหมดสําหรับรายงานประเภท
content_owner_basic_a1
ถูกลบแล้ว เราได้เลิกใช้งานรายงานประเภทดังกล่าวโดยสมบูรณ์เมื่อวันที่ 19 สิงหาคม 2016 แต่รายงานที่สร้างก่อนหน้านี้ของcontent_owner_basic_a1
จะยังคงใช้งานได้เป็นเวลา 180 วันนับจากวันที่สร้าง รายงานบางอย่างจึงเข้าถึงได้ล่าช้าในวันที่ 19 กุมภาพันธ์ 2017 แต่เนื่องจากรายงานใช้ไม่ได้แล้ว งานที่เชื่อมโยงกับรายงานจึงไม่จำเป็นเช่นกัน
-
-
API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย)
-
เราได้แก้ไขคำอธิบายมิติข้อมูลที่เกี่ยวข้องกับ
time periods
แล้ว โปรดทราบว่าค่ามิติข้อมูลหมายถึงช่วงเวลาโดยเริ่มตั้งแต่เวลา 00:00 น. ตามเวลาแปซิฟิก และสิ้นสุดเวลา 23:59 น. ตามเวลาแปซิฟิกในวันที่ เดือน และปีที่ระบุ เวลาแปซิฟิกจะเป็น UTC-7 หรือ UTC-8 ทั้งนี้ขึ้นอยู่กับช่วงเวลาของปีแม้ว่าวันที่โดยทั่วไปจะแสดงช่วงเวลา 24 ชั่วโมง แต่วันที่ที่มีการปรับนาฬิกาไปข้างหน้าจะแสดงระยะเวลา 23 ชั่วโมง และวันที่ที่มีการปรับนาฬิกาย้อนหลังจะแสดงช่วงเวลา 25 ชั่วโมง (ก่อนหน้านี้ เอกสารประกอบระบุว่าเวลาแปซิฟิกคือ UTC-8 และไม่ได้กล่าวถึงความเป็นไปได้ที่วันหนึ่งๆ อาจไม่ได้แสดงถึงระยะเวลา 24 ชั่วโมง)
โปรดทราบว่าการแก้ไขนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานจริงของ API
-
เอกสารรายงานแชแนลได้รับการอัปเดตแล้ว โปรดทราบว่าขณะนี้รายงานแชแนลยังไม่มีเมตริกรายได้หรือประสิทธิภาพโฆษณา ด้วยเหตุนี้ ขอบเขต
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
จึงไม่ได้ให้สิทธิ์เข้าถึงข้อมูลด้านการเงินในรายงานแชแนลในขณะนี้ - มิติข้อมูล
operatingSystem
รองรับค่ามิติข้อมูลใหม่ 3 ค่า ดังนี้FIREFOX
REALMEDIA
TIZEN
-
8 กุมภาพันธ์ 2017
ขณะนี้ API ของ YouTube Analytics รองรับพารามิเตอร์ include-historical-channel-data
ที่ไม่บังคับแล้ว โปรดทราบว่าพารามิเตอร์นี้จะเกี่ยวข้องเมื่อเรียกข้อมูลรายงานเจ้าของเนื้อหาเท่านั้น
พารามิเตอร์นี้จะช่วยให้เจ้าของเนื้อหาระบุได้ว่าการตอบกลับของ API ควรรวมเวลาในการรับชมของช่องและข้อมูลการดูจากระยะเวลาก่อนที่ช่องจะลิงก์กับเจ้าของเนื้อหา ค่าพารามิเตอร์เริ่มต้นคือ false
ซึ่งหมายความว่าโดยค่าเริ่มต้นแล้ว การตอบกลับของ API จะรวมเฉพาะเวลาในการรับชมและข้อมูลการดูจากช่วงเวลาที่ช่องลิงก์กับเจ้าของเนื้อหาเท่านั้น
กฎเหล่านี้ยังใช้ในกรณีที่คำขอ API เรียกข้อมูลของหลายแชแนลด้วย
- หากค่าพารามิเตอร์คือ
false
ข้อมูลเวลาในการรับชมและยอดดูที่ส่งกลับมาในช่องใดก็ตามจะอิงตามวันที่ลิงก์ช่องกับเจ้าของเนื้อหา
โปรดอย่าลืมว่าช่องต่างๆ อาจลิงก์กับเจ้าของเนื้อหาในวันที่ต่างกัน หากคำขอ API กำลังดึงข้อมูลของหลายช่องและค่าพารามิเตอร์คือfalse
การตอบกลับของ API จะมีข้อมูลเวลาในการรับชมและข้อมูลการดูตามวันที่ลิงก์ช่องที่เกี่ยวข้องแต่ละช่อง - หากค่าพารามิเตอร์คือ
true
การตอบกลับจะแสดงผลข้อมูลเวลาในการรับชมและการดูของช่องทั้งหมดตามวันที่เริ่มต้นและวันที่สิ้นสุดที่ระบุไว้ในคำขอ API
15 ธันวาคม 2016
ระบบไม่รองรับรายงาน API การรายงานของ YouTube ต่อไปนี้อีกต่อไปและเราได้นำรายงาน API ดังกล่าวออกจากเอกสารประกอบแล้ว แต่ละรายงานจะมีเวอร์ชันใหม่ให้ใช้งาน (ประกาศการเลิกใช้งานรายงานเหล่านี้มีขึ้นเมื่อวันที่ 15 กันยายน 2016)
-
รายงานแชแนล
channel_basic_a1
- แทนที่ด้วยรายงานchannel_basic_a2
channel_province_a1
- แทนที่ด้วยรายงานchannel_province_a2
channel_playback_location_a1
- แทนที่ด้วยรายงานchannel_playback_location_a2
channel_traffic_source_a1
- แทนที่ด้วยรายงานchannel_traffic_source_a2
channel_device_os_a1
- แทนที่ด้วยรายงานchannel_device_os_a2
channel_subtitles_a1
- แทนที่ด้วยรายงานchannel_subtitles_a2
channel_combined_a1
- แทนที่ด้วยรายงานchannel_combined_a2
-
รายงานเจ้าของเนื้อหา
content_owner_basic_a2
- แทนที่ด้วยรายงานcontent_owner_basic_a3
content_owner_province_a1
- แทนที่ด้วยรายงานcontent_owner_province_a2
content_owner_playback_location_a1
- แทนที่ด้วยรายงานcontent_owner_playback_location_a2
content_owner_traffic_source_a1
- แทนที่ด้วยรายงานcontent_owner_traffic_source_a2
content_owner_device_os_a1
- แทนที่ด้วยรายงานcontent_owner_device_os_a2
content_owner_subtitles_a1
- แทนที่ด้วยรายงานcontent_owner_subtitles_a2
content_owner_combined_a1
- แทนที่ด้วยรายงานcontent_owner_combined_a2
content_owner_asset_basic_a1
- แทนที่ด้วยรายงานcontent_owner_asset_basic_a2
content_owner_asset_province_a1
- แทนที่ด้วยรายงานcontent_owner_asset_province_a2
content_owner_asset_playback_location_a1
- แทนที่ด้วยรายงานcontent_owner_asset_playback_location_a2
content_owner_asset_traffic_source_a1
- แทนที่ด้วยรายงานcontent_owner_asset_traffic_source_a2
content_owner_asset_device_os_a1
- แทนที่ด้วยรายงานcontent_owner_asset_device_os_a2
content_owner_asset_combined_a1
- แทนที่ด้วยรายงานcontent_owner_asset_combined_a2
นอกจากนี้รายการประเภทรายงานปัจจุบันในเอกสารอ้างอิง API ก็ได้รับการอัปเดตด้วย
11 พฤศจิกายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
รายงาน End Screen
- รายงาน End Screen สำหรับวิดีโอของช่องประกอบด้วยสถิติสำหรับวิดีโอทั้งหมดของช่อง
- รายงานตอนท้ายสำหรับวิดีโอของเจ้าของเนื้อหาจะมีสถิติวิดีโอในช่องใดๆ ของเจ้าของเนื้อหา
- รายงาน End Screen สำหรับเนื้อหาของเจ้าของเนื้อหามีสถิติสำหรับเนื้อหาที่เชื่อมโยงกับวิดีโอที่ End Screen แสดง
-
ขนาด End Screen
end_screen_element_type
: ประเภทขององค์ประกอบ End Screen ที่เชื่อมโยงกับสถิติend_screen_element_id
: รหัสที่ YouTube ใช้เพื่อระบุองค์ประกอบ End Screen แบบไม่ซ้ำ
เมตริก End Screen
หมายเหตุ: ข้อมูลสำหรับเมตริก End Screen พร้อมใช้งานแล้วตั้งแต่วันที่ 1 พฤษภาคม 2016
end_screen_element_impressions
: จำนวนการแสดงผลขององค์ประกอบ End Screen ทั้งหมด ระบบจะบันทึกการแสดงผล 1 ครั้งสำหรับองค์ประกอบ End Screen แต่ละรายการที่แสดงend_screen_element_clicks
: จำนวนครั้งที่มีการคลิกองค์ประกอบ End Screenend_screen_element_click_rate
: อัตราการคลิกผ่านขององค์ประกอบ End Screen
-
ระบบไม่รองรับรายงานต่อไปนี้อีกต่อไปและเราได้นำออกจากเอกสารประกอบแล้ว แต่ละรายงานจะมีเวอร์ชันใหม่ให้ใช้งาน (ประกาศการเลิกใช้งานรายงานเหล่านี้มีขึ้นเมื่อวันที่ 22 มิถุนายน 2016)
content_owner_ad_performance_a1
- แทนที่ด้วยรายงานcontent_owner_ad_rates_a1
content_owner_estimated_earnings_a1
- แทนที่ด้วยรายงานcontent_owner_estimated_revenue_a1
content_owner_asset_estimated_earnings_a1
- แทนที่ด้วยรายงานcontent_owner_asset_estimated_revenue_a1
-
เราเลิกใช้งานเมตริกในรายการต่อไปนี้โดยสมบูรณ์แล้วและไม่รองรับอีกต่อไป ตามที่ได้ประกาศไปเมื่อวันที่ 10 สิงหาคม 2016 เมตริกใหม่ที่อ้างถึงข้อมูลเดียวกันได้รับการรองรับอยู่แล้ว ตารางด้านล่างแสดงชื่อเมตริกที่เลิกใช้งานแล้วและชื่อเมตริกใหม่
เมตริกที่เลิกใช้งานแล้ว เมตริกใหม่ adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- รายได้จากโฆษณารายเดือนต่อวิดีโอทั่วโลก
- รายได้จากโฆษณารายวันต่อประเทศต่อวิดีโอ
- รายได้จากโฆษณารายเดือนทั่วโลกต่อเนื้อหา
- รายได้จากโฆษณารายวันต่อประเทศต่อเนื้อหา
- การอ้างสิทธิ์ (รายงานนี้ไม่มีข้อมูลรายได้)
-
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 วันนับจากวันที่สร้าง
-
เราเลิกใช้งานรายงาน
content_owner_basic_a1
โดยสมบูรณ์และนำออกจากเอกสารประกอบแล้ว YouTube จะไม่สร้างรายงานใหม่ประเภทนี้อีกต่อไป แต่รายงานที่สร้างไว้แล้วจะยังคงใช้งานได้เป็นเวลา 180 วันนับจากวันที่สร้างการแทนที่รายงาน
content_owner_basic_a1
คือรายงานcontent_owner_basic_a2
ตามที่อธิบายไว้ในรายการประวัติการแก้ไขสําหรับวันที่ 19 พฤษภาคม 2016 -
ข้อกำหนดในการให้บริการของบริการ API ของ YouTube ที่เผยแพร่ใหม่ ("ข้อกำหนดฉบับปรับปรุง") ซึ่งกล่าวถึงโดยละเอียดในบล็อกด้านวิศวกรรมและนักพัฒนาซอฟต์แวร์ของ YouTube จะให้ข้อมูลอัปเดตมากมายเกี่ยวกับข้อกำหนดในการให้บริการปัจจุบัน นอกเหนือจากข้อกำหนดที่อัปเดตซึ่งจะมีผลบังคับใช้ในวันที่ 10 กุมภาพันธ์ 2017 แล้ว การปรับปรุงนี้ยังมีเอกสารสนับสนุนอีกหลายฉบับเพื่อช่วยอธิบายนโยบายที่นักพัฒนาแอปต้องปฏิบัติตาม
ดูเอกสารทั้งหมดฉบับใหม่ได้ในประวัติการแก้ไขสำหรับข้อกำหนดฉบับปรับปรุง นอกจากนี้ การเปลี่ยนแปลงข้อกำหนดที่ปรับปรุงในอนาคตหรือเอกสารสนับสนุนต่างๆ จะมีอธิบายไว้ในประวัติการแก้ไขดังกล่าวด้วย คุณสมัครรับข้อมูลการเปลี่ยนแปลงรายการฟีด RSS ในประวัติการแก้ไขได้จากลิงก์ในเอกสารนั้น
-
API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย)
-
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
เมตริกในตารางต่อไปนี้จะเลิกใช้งาน ในขณะเดียวกัน เรายังได้เปิดตัวเมตริกใหม่ที่อ้างอิงข้อมูลเดียวกันนี้ด้วย ซึ่งหมายความว่าจะมีการเปลี่ยนชื่อเมตริกเก่า อย่างไรก็ตาม API ของ YouTube Analytics จะรองรับชื่อเมตริกทั้ง 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 วินาทีซึ่งเล่นก่อนที่จะดูวิดีโอ
-
-
API การรายงานของ YouTube (รายงานจำนวนมาก)
- ตอนนี้มิติข้อมูล
traffic_source_type
รองรับค่าต่อไปนี้แล้ว19
: รองรับเฉพาะแหล่งที่มาของการเข้าชมนี้สำหรับรายงานเจ้าของเนื้อหา ซึ่งเป็นการระบุว่ายอดดูมาจากวิดีโอที่ผู้ใช้อัปโหลดซึ่งมีการอ้างสิทธิ์และเจ้าของเนื้อหาใช้เพื่อโปรโมตเนื้อหาที่มีคนดู20
: ข้อมูลนี้เกี่ยวข้องกับยอดดูที่มาจาก End Screen ของวิดีโออื่น
สำหรับแหล่งที่มาของการเข้าชมใหม่ทั้ง 2 แหล่ง มิติข้อมูล
traffic_source_detail
จะระบุวิดีโอที่เป็นแหล่งที่มาของการเข้าชม -
เราได้แก้ไขรายการเมตริกหลักของ API ให้แสดง
estimated_partner_revenue
เป็นเมตริกหลักและนำearnings
ออกจากรายการดังกล่าว (ระบบยังไม่รองรับเมตริกearnings
ใน API การรายงานของ YouTube) -
ตอนนี้มิติข้อมูล
ad_type
รองรับค่า19
ที่หมายถึงโฆษณาบัมเปอร์ ซึ่งเป็นโฆษณาวิดีโอแบบข้ามไม่ได้ที่มีความยาวสูงสุด 6 วินาทีที่เล่นก่อนที่จะดูวิดีโอ
- ตอนนี้มิติข้อมูล
-
API ของ YouTube Analytics (การค้นหาที่กำหนดเป้าหมาย)
- รายการเมตริกที่รองรับสำหรับรายงานแชแนลต่อไปนี้ได้รับการอัปเดตให้รวมเมตริกการ์ด จริงๆ แล้วมีการรองรับเมตริกการ์ดในรายงานเหล่านี้ในวันที่ 28 มิถุนายน 2016 และรายการประวัติการแก้ไขสำหรับวันที่ดังกล่าวจะอธิบายรายละเอียดเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลง โดยรายงานมีลักษณะดังนี้
- กิจกรรมของผู้ใช้เบื้องต้นสําหรับรัฐในสหรัฐอเมริกา
- กิจกรรมของผู้ใช้ในรัฐต่างๆ ในสหรัฐอเมริกาในระยะเวลาที่เจาะจง
- กิจกรรมของผู้ใช้ตามจังหวัด
- กิจกรรมของผู้ใช้ตามสถานะที่สมัครใช้บริการ
- กิจกรรมของผู้ใช้ตามสถานะที่สมัครรับข้อมูลสำหรับจังหวัด
- วิดีโอยอดนิยมตามรัฐ
- วิดีโอยอดนิยมสำหรับผู้ชมที่ติดตามหรือเลิกติดตาม
-
เราได้แก้ไขรายการตัวกรองทั้งในรายงานการรักษาผู้ชมของช่องและรายงานการรักษาผู้ชมของเจ้าของเนื้อหาเพื่อให้แสดงว่าต้องมีตัวกรอง
video
และไม่รองรับตัวกรองgroup
ก่อนหน้านี้ เอกสารสําหรับรายงานทั้ง 2 ฉบับระบุอย่างไม่ถูกต้องว่าสามารถเรียกดูรายงานได้โดยใช้ตัวกรอง 1 ใน 2 ตัวกรองนั้นหรือไม่ได้ใช้ทั้ง 2 ตัวกรอง
- รายการเมตริกที่รองรับสำหรับรายงานแชแนลต่อไปนี้ได้รับการอัปเดตให้รวมเมตริกการ์ด จริงๆ แล้วมีการรองรับเมตริกการ์ดในรายงานเหล่านี้ในวันที่ 28 มิถุนายน 2016 และรายการประวัติการแก้ไขสำหรับวันที่ดังกล่าวจะอธิบายรายละเอียดเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลง โดยรายงานมีลักษณะดังนี้
-
API การรายงานของ YouTube (รายงานจำนวนมาก)
- ในภาพรวม API ส่วนที่อธิบายวิธีเรียกข้อมูล URL ดาวน์โหลดรายงานได้รับการแก้ไขแล้วเพื่อระบุว่า YouTube ได้สร้างรายงานที่ดาวน์โหลดได้สำหรับวันที่ไม่มีข้อมูล รายงานเหล่านี้มีแถวส่วนหัว แต่ไม่มีข้อมูลเพิ่มเติม ข้อมูลนี้ได้รับการอัปเดตแล้วในส่วนลักษณะของรายงานของเอกสารเดียวกันเมื่อวันที่ 12 เมษายน 2016
- รายการมิติข้อมูลในรายงาน
content_owner_asset_cards_a1
ได้รับการแก้ไขเพื่อแสดงให้เห็นว่ารายงานใช้มิติข้อมูลcard_id
ก่อนหน้านี้เอกสารแสดงชื่อมิติข้อมูลเป็นcard_title
ไม่ถูกต้อง
- สถิติพื้นฐาน(ช่อง, เจ้าของเนื้อหา)
- ตามเวลา(ช่อง เจ้าของเนื้อหา)
- ภูมิศาสตร์ของผู้ใช้ (ช่อง เจ้าของเนื้อหา)
- กิจกรรมของผู้ใช้ตามสถานะการติดตาม (ช่อง เจ้าของเนื้อหา)
- วิดีโอยอดนิยม (ช่อง เจ้าของเนื้อหา)
-
ส่วนลักษณะของรายงานในภาพรวม 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 ยังไม่รองรับมิติข้อมูลเหล่านี้ -
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
จะแสดงโค้ดตอบกลับ HTTP400
(Bad Request
) หากคุณพยายามสร้างงานสำหรับรายงานที่เลิกใช้งานแล้ว นอกจากนี้ เอกสารประกอบของเมธอดจะแสดงสาเหตุอื่นๆ ที่ทำให้คำขอ API ล้มเหลว -
ขณะนี้ YouTube สร้างข้อมูลที่ครอบคลุมช่วงเวลา 180 วันก่อนที่จะกำหนดเวลางานการรายงานเป็นครั้งแรก ก่อนหน้านี้ Reporting API ไม่ได้แสดงข้อมูลย้อนหลัง การเปลี่ยนแปลงนี้จะส่งผลต่องานทั้งหมด รวมถึงงานที่สร้างขึ้นก่อนการประกาศนี้ด้วย
ระบบจะโพสต์รายงานข้อมูลย้อนหลังทันทีที่พร้อมแสดง แต่อาจใช้เวลาประมาณ 1 เดือนในการโพสต์ข้อมูลย้อนหลังทั้งหมดสําหรับตำแหน่งงาน ดังนั้น 1 เดือนหลังจากกำหนดเวลางานการรายงาน คุณจะมีสิทธิ์เข้าถึงข้อมูลได้ประมาณ 7 เดือน (ข้อมูลย้อนหลังทั้งหมดของงานที่สร้างขึ้นก่อนการประกาศนี้ควรโพสต์ภายใน 1 เดือนนับจากการประกาศ)
โปรดทราบว่าข้อมูลย้อนหลังจะพร้อมใช้งานตั้งแต่วันที่ 1 กรกฎาคม 2015 เท่านั้น งานที่สร้างขึ้นก่อนวันที่ 28 ธันวาคม 2015 จะมีข้อมูลย้อนหลังไม่ถึง 180 วัน
การเปลี่ยนแปลงเหล่านี้อธิบายไว้ในส่วนข้อมูลย้อนหลังใหม่ของภาพรวม Reporting API
-
ส่วนลักษณะของรายงานในภาพรวม API การรายงานของ YouTube ได้รับการอัปเดตให้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้เอกสารประกอบระบุว่ารายงานจะใช้ได้เป็นเวลา 180 วันหลังจากที่สร้างขึ้น และพร้อมให้ไคลเอ็นต์ API ดาวน์โหลดได้ ก่อนหน้านี้ เอกสารระบุว่ารายงานจะใช้ได้เป็นเวลาสูงสุด 6 เดือนก่อนวันที่มีการส่งคำขอ API
-
เอกสารนี้ได้รับการอัปเดตเพื่อแสดงข้อเท็จจริงที่ว่าตอนนี้ API จะสร้างรายงานที่ดาวน์โหลดได้สำหรับวันที่ไม่มีข้อมูล รายงานเหล่านี้จะมีแถวส่วนหัวแต่จะไม่มีข้อมูลเพิ่มเติม
-
-
เร็วๆ นี้ API การรายงานของ YouTube จะสนับสนุนชุดรายงานที่จัดการโดยระบบที่สร้างขึ้นโดยอัตโนมัติ ซึ่งมีข้อมูลรายได้จากโฆษณาหรือข้อมูลรายได้จากการติดตาม YouTube Red เจ้าของเนื้อหาที่เข้าถึงรายงานรายได้ที่ดาวน์โหลดได้ด้วยตนเองอยู่แล้วใน YouTube Creator Studio จะใช้รายงานเหล่านี้ได้ ดังนั้น ฟังก์ชันการทำงานใหม่ของ 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
-
- ใน API การรายงานของ YouTube มิติข้อมูล
sharing_service
จะรองรับค่าใหม่ต่อไปนี้82
: กล่องโต้ตอบกิจกรรมของระบบ iOS83
: กล่องจดหมายของ Google84
: Android Messenger
- ใน API ของ YouTube Analytics มิติข้อมูล
sharingService
รองรับค่าใหม่ต่อไปนี้ANDROID_MESSENGER
: Android MessengerINBOX
: กล่องจดหมายของ GoogleIOS_SYSTEM_ACTIVITY_DIALOG
: กล่องโต้ตอบกิจกรรมของระบบ iOS
- มิติข้อมูล
playback_location_type
รองรับค่ามิติข้อมูลใหม่ 2 ค่า ได้แก่7
: ข้อมูลนี้เกี่ยวข้องกับการดูที่เกิดขึ้นบนหน้าแรกหรือหน้าจอหลักของ YouTube ในฟีดการติดตามของผู้ใช้ หรือในฟีเจอร์การท่องเว็บอื่นๆ ของ YouTube8
: ข้อมูลนี้เกี่ยวข้องกับการดูที่เกิดขึ้นในหน้าผลการค้นหาของ YouTube โดยตรง
- ตอนนี้มิติข้อมูล
traffic_source_type
รองรับ18
เป็นค่ามิติข้อมูลแล้ว ค่านี้บ่งบอกว่ายอดดูวิดีโอมาจากหน้าที่แสดงวิดีโอทั้งหมดในเพลย์ลิสต์ แหล่งที่มานี้แตกต่างจากแหล่งที่มาประเภท14
ซึ่งบ่งชี้ว่าการดูเกิดขึ้นในขณะที่วิดีโอกำลังเล่นโดยเป็นส่วนหนึ่งของเพลย์ลิสต์ - มิติข้อมูล
insightPlaybackLocationType
รองรับค่ามิติข้อมูลใหม่ 2 ค่า ได้แก่BROWSE
: ข้อมูลนี้เกี่ยวข้องกับการดูที่เกิดขึ้นบนหน้าแรกหรือหน้าจอหลักของ YouTube ในฟีดการติดตามของผู้ใช้ หรือในฟีเจอร์การท่องเว็บอื่นๆ ของ YouTubeSEARCH
: ข้อมูลนี้เกี่ยวข้องกับการดูที่เกิดขึ้นในหน้าผลการค้นหาของ YouTube โดยตรง
- ตอนนี้มิติข้อมูล
insightTrafficSourceType
รองรับYT_PLAYLIST_PAGE
เป็นค่ามิติข้อมูลแล้ว ค่านี้บ่งบอกว่ายอดดูวิดีโอมาจากหน้าที่แสดงวิดีโอทั้งหมดในเพลย์ลิสต์ แหล่งที่มานี้แตกต่างจากแหล่งที่มาประเภทPLAYLIST
ซึ่งบ่งชี้ว่าการดูเกิดขึ้นในขณะที่วิดีโอกำลังเล่นเป็นส่วนหนึ่งของเพลย์ลิสต์ - ใน API การรายงานของ YouTube มิติข้อมูล
operating_system
จะใช้ค่า21
เพื่อระบุการดูที่เกิดขึ้นผ่าน Chromecast - ใน API ของ YouTube Analytics มิติข้อมูล
operatingSystem
จะใช้ค่าCHROMECAST
เพื่อระบุการดูที่เกิดขึ้นผ่าน Chromecast -
ขณะนี้ API ของ YouTube Analytics รองรับมิติข้อมูลรายละเอียดการเล่นใหม่ 3 แบบ ซึ่งสามารถใช้ได้ในรายงานช่องและเจ้าของเนื้อหาที่หลากหลาย ดังนี้
liveOrOnDemand
: มิติข้อมูลนี้จะระบุว่าข้อมูลในรายงานอธิบายกิจกรรมของผู้ใช้ที่เกิดขึ้นระหว่างการถ่ายทอดสดหรือไม่subscribedStatus
: มิติข้อมูลนี้จะระบุว่าเมตริกกิจกรรมของผู้ใช้ในข้อมูลเชื่อมโยงกับผู้ชมที่ติดตามช่องของวิดีโอหรือเพลย์ลิสต์หรือไม่youtubeProduct
: มิติข้อมูลนี้ระบุพร็อพเพอร์ตี้ YouTube ที่มีกิจกรรมของผู้ใช้ ค่าที่เป็นไปได้ ได้แก่ เว็บไซต์หลักของ YouTube (หรือแอป YouTube), YouTube Gaming และ YouTube Kids
เอกสารประกอบได้รับการอัปเดตเพื่อระบุรายงานรายละเอียดการเล่นใหม่ที่พร้อมใช้งานสำหรับช่องและเจ้าของเนื้อหา นอกจากนี้ รายงานอื่นๆ อีกจำนวนมากก็ได้รับการอัปเดตเพื่อให้ทราบว่ามิติข้อมูลเหล่านี้อย่างน้อย 1 รายการสามารถเลือกใช้เป็นมิติข้อมูลและ/หรือตัวกรองในรายงานเหล่านั้นได้
-
มีการเปลี่ยนแปลงรูปแบบของตารางที่อธิบายรายงานเพื่อช่วยให้คุณระบุชุดค่าผสมของมิติข้อมูล เมตริก และตัวกรองที่ถูกต้องได้ง่ายขึ้น ซึ่งสามารถใช้เพื่อดึงข้อมูลแต่ละรายงานได้ ตารางด้านล่างซึ่งอธิบายรายงาน "ประเภทอุปกรณ์" สำหรับแชแนลต่างๆ แสดงรูปแบบใหม่นี้
เนื้อหา มิติข้อมูล: จำเป็น deviceType ใช้ 0 ขึ้นไป day, liveOrOnDemand, subscribedStatus, youtubeProduct เมตริก: ใช้อย่างน้อย 1 รายการ จำนวนการดู, estimatedMinutesWatched ตัวกรอง: ใช้ 0 หรือ 1 ประเทศ จังหวัด ทวีป subContinent ใช้ 0 หรือ 1 วิดีโอ, กลุ่ม ใช้ 0 ขึ้นไป operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct คำศัพท์ที่อธิบายช่องที่จำเป็นและช่องที่ไม่บังคับมีอธิบายไว้ในเอกสารประกอบสำหรับรายงานช่องและเจ้าของเนื้อหา
-
ขณะนี้ API ของ YouTube Analytics จะทิ้งเอนทิตีที่ผู้ใช้ API ไม่สามารถเรียกข้อมูลจากตัวกรองที่รองรับหลายค่า (
video
,playlist
และchannel
) โดยอัตโนมัติ ก่อนหน้านี้เซิร์ฟเวอร์ API จะส่งคืนข้อผิดพลาดหากผู้ใช้ API เข้าถึงข้อมูลที่ระบุอย่างน้อย 1 รายการไม่ได้เช่น สมมติว่าผู้ใช้ส่งคำขอ API ที่ตัวกรอง
video
แสดงรหัสวิดีโอ 20 รายการ ผู้ใช้เป็นเจ้าของวิดีโอ 18 รายการ อย่างไรก็ตาม รหัสวิดีโอรหัสหนึ่งระบุวิดีโอของช่องอื่น และรหัสอีกรหัสจะระบุวิดีโอที่ถูกลบไปแล้ว ดังนั้นจึงไม่มีอีกต่อไป ในกรณีนี้ แทนที่จะแสดงข้อผิดพลาด ตอนนี้เซิร์ฟเวอร์ API จะทิ้งวิดีโอ 2 รายการที่ผู้ใช้ไม่สามารถเข้าถึงได้ และการตอบกลับของ API จะมีข้อมูลสำหรับวิดีโอ 18 รายการที่ผู้ใช้ API เป็นเจ้าของ -
หากคุณขอข้อมูล
group
ของ YouTube Analytics ที่ว่างเปล่า ตอนนี้ API จะแสดงชุดข้อมูลที่ว่างเปล่าแทนข้อผิดพลาด -
ตอนนี้เมธอด
groupItems.insert
ของ API ของ YouTube Analytics จะแสดงข้อผิดพลาดที่ไม่ได้รับอนุญาต (รหัสการตอบกลับ HTTP403
รหัส) หากคุณพยายามเพิ่มเอนทิตีลงในกลุ่ม แต่ไม่มีสิทธิ์เข้าถึงเอนทิตีนั้น ก่อนหน้านี้ API จะอนุญาตให้คุณเพิ่มเอนทิตีลงในกลุ่ม แต่ภายหลังแสดงข้อผิดพลาดที่ไม่ได้รับอนุญาตเมื่อคุณพยายามดึงข้อมูลรายงานสำหรับกลุ่มนั้น -
ตอนนี้เมธอด
groups.list
ของ YouTube Analytics API รองรับการใส่เลขหน้าแล้ว หากการตอบกลับของ API ไม่มีกลุ่มที่ใช้ได้ทั้งหมด พารามิเตอร์nextPageToken
ของการตอบกลับจะระบุโทเค็นที่ใช้เพื่อเรียกผลการค้นหาหน้าถัดไป ตั้งค่าพารามิเตอร์pageToken
ของเมธอดเป็นค่านั้นเพื่อดึงผลลัพธ์เพิ่มเติม -
ขณะนี้ API ของ YouTube Analytics รองรับเมตริก
redPartnerRevenue
ซึ่งจะรายงานรายได้โดยประมาณทั้งหมดที่ได้รับจากการติดตาม YouTube Red สำหรับมิติข้อมูลรายงานที่เลือก ค่าของเมตริกแสดงถึงรายได้จากทั้งเนื้อหาเพลงและเนื้อหาที่ไม่ใช่เพลง และอาจขึ้นอยู่กับการปรับค่าใช้จ่ายตอนสิ้นเดือนอัปเดตรายการรายงานเจ้าของเนื้อหาใน API ของ YouTube Analytics เพื่อระบุรายงานวิดีโอที่สนับสนุนเมตริก
redPartnerRevenue
ดังนี้- สถิติพื้นฐาน
- ตามเวลา
- พื้นที่ทางภูมิศาสตร์ของผู้ใช้
- วิดีโอยอดนิยม – สำหรับรายงานนี้ สามารถใช้
redPartnerRevenue
เป็นเมตริกการจัดเรียงได้ ซึ่งหมายความว่าคุณสามารถเรียกดูรายการวิดีโอที่จัดเรียงตามรายได้จาก YouTube Red ได้
-
ปัจจุบันคำจำกัดความของรายงานวิดีโอยอดนิยมสำหรับ API ของ YouTube Analytics แสดงให้เห็นว่ารายงานนี้รองรับเมตริกรายได้
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
และimpressionBasedCpm
ด้วย -
เอกสารสำหรับมิติข้อมูล
date
ของ YouTube Reporting API ได้รับการแก้ไขให้ถูกต้องแล้วเพื่อแสดงวันที่ที่อ้างอิงช่วงเวลา 24 ชั่วโมงซึ่งเริ่มตั้งแต่เวลา 00:00 น. ตามเวลาแปซิฟิก (UTC-8) ก่อนหน้านี้ เอกสารประกอบระบุว่าวันที่เริ่มต้นเวลา 00:00 น. (GMT)นอกจากนี้ เอกสาร API ของ YouTube Analytics ได้รับการอัปเดตให้ทราบว่ามิติข้อมูลที่เกี่ยวข้องกับวันที่ทั้งหมด (
day
,7DayTotals
,30DayTotals
และmonth
) อ้างอิงถึงวันที่เริ่มตั้งแต่เวลา 00:00 น. ตามเวลาแปซิฟิก (UTC-8) -
ตอนนี้เมธอด
jobs.reports.list()
ของ YouTube Reporting API รองรับพารามิเตอร์การค้นหาcreatedAfter
แล้ว หากระบุไว้ พารามิเตอร์นี้จะระบุว่าการตอบกลับของ API ควรแสดงเฉพาะรายงานที่สร้างหลังจากวันที่และเวลาที่ระบุเท่านั้น รวมถึงรายงานใหม่ที่มีข้อมูลทดแทนด้วย โปรดทราบว่าค่าพารามิเตอร์เกี่ยวข้องกับเวลาที่สร้างรายงาน ไม่ใช่วันที่ที่เชื่อมโยงกับข้อมูลที่ส่งคืนค่าพารามิเตอร์คือการประทับเวลาในรูปแบบ RFC3339 UTC "ซูลู" ซึ่งมีความแม่นยำเป็นไมโครวินาที ตัวอย่าง:
"2015-10-02T15:01:23.045678Z"
นอกจากนี้ เรายังได้อัปเดตแนวทางปฏิบัติแนะนำของ API การรายงานของ YouTube เพื่ออธิบายวิธีใช้พารามิเตอร์
createdAfter
เพื่อหลีกเลี่ยงการประมวลผลรายงานเดียวกันซ้ำ -
คำจำกัดความพร็อพเพอร์ตี้
createTime
ของทรัพยากรjob
และพร็อพเพอร์ตี้startTime
,endTime
และcreateTime
ของทรัพยากรreport
ได้รับการแก้ไขแล้ว โปรดทราบว่าค่าพร็อพเพอร์ตี้มีความแม่นยำเป็นไมโครวินาที ไม่ใช่นาโนวินาที นอกจากนี้ คําจํากัดความทั้งหมดยังสะท้อนให้เห็นอย่างถูกต้องว่าค่าของพร็อพเพอร์ตี้คือการประทับเวลา -
อัปเดตเอกสารประกอบสำหรับมิติข้อมูล
sharingService
ของ YouTube Analytics API ให้แสดงรายการค่ามิติข้อมูลที่เป็นไปได้ ซึ่งรายการดังกล่าวจะมีบริการใหม่ที่รองรับจำนวนหนึ่งนอกจากนี้ ยังอัปเดตคำจำกัดความของมิติข้อมูล
sharing_service
ของ API การรายงานของ YouTube เพื่อแสดงค่าใหม่ที่รองรับด้วย ค่า enum ที่มากกว่า59
คือค่าใหม่ในรายการ -
API การรายงานของ YouTube ใหม่จะเรียกรายงานข้อมูลจำนวนมากที่มีข้อมูล YouTube Analytics สำหรับช่องหรือเจ้าของเนื้อหา โดยออกแบบมาสำหรับแอปพลิเคชันที่สามารถนำเข้าชุดข้อมูลขนาดใหญ่ และมีเครื่องมือในการกรอง จัดเรียง และขุดเหมืองข้อมูลดังกล่าว
รายงาน API การรายงานของ YouTube แต่ละฉบับจะมีชุดมิติข้อมูลและเมตริกที่กำหนดไว้ล่วงหน้า (รายงาน API ของ YouTube Analytics ยังใช้เมตริกและมิติข้อมูลด้วย) ในรายงาน ข้อมูลแต่ละแถวจะมีชุดค่าผสมของมิติข้อมูลที่ไม่ซ้ำกัน คุณสามารถรวมข้อมูลจากแถวต่างๆ ตามค่ามิติข้อมูลเพื่อคำนวณเมตริกสำหรับวิดีโอแต่ละรายการ ประเทศ วิดีโอสด ผู้ใช้ที่ติดตาม และอื่นๆ
คุณสามารถใช้ API เพื่อตั้งเวลางานการรายงานได้ ซึ่งแต่ละ API จะระบุรายงานที่ YouTube ควรสร้าง เมื่อคุณตั้งค่างานแล้ว YouTube จะสร้างรายงานประจำวันที่สามารถดาวน์โหลดแบบไม่พร้อมกัน แต่ละรายงานจะมีข้อมูลของช่วงเวลา 24 ชั่วโมงที่ไม่ซ้ำ
-
แม้ว่าจะเป็น API ที่ต่างกัน แต่ทั้ง API ของ YouTube Analytics และ API การรายงานของ YouTube ช่วยให้นักพัฒนาซอฟต์แวร์เรียกข้อมูล YouTube Analytics ได้ เนื่องจากทั้ง API ให้การเข้าถึงชุดข้อมูลที่คล้ายกัน ระบบจึงเผยแพร่เอกสารประกอบสำหรับ API ทั้ง 2 รายการเป็นชุดเอกสารประกอบชุดเดียว
- แท็บคำแนะนำในชุดเอกสารประกอบมีข้อมูลทั่วไปสำหรับ API ทั้งสอง รวมถึงวิธีการสำหรับการให้สิทธิ์คำขอ API
- แท็บรายงานจำนวนมากมีเอกสารอ้างอิงและเนื้อหาอื่นๆ สำหรับ YouTube Reporting API โดยเฉพาะ
- แท็บการค้นหาที่กำหนดเป้าหมายมีเอกสารอ้างอิงและเนื้อหาอื่นๆ สำหรับ API ของ YouTube Analytics โดยเฉพาะ
- แท็บตัวอย่างจะแสดงตัวอย่างโค้ดที่พร้อมใช้งานสำหรับ API ใด 2 รายการ
- แท็บเครื่องมือจะแสดงแหล่งข้อมูลเพิ่มเติมที่มีเพื่อช่วยให้นักพัฒนาซอฟต์แวร์ใช้งาน API ตัวใดตัวหนึ่งจาก 2 ตัวได้
-
เราได้ปรับโครงสร้างเอกสารประกอบของ API เพื่อทำให้ API เข้าใจง่ายขึ้น ดังนั้น การเปลี่ยนแปลงเหล่านี้จึงไม่ได้อธิบายถึงฟีเจอร์ใหม่ๆ
-
ขณะนี้เอกสารประกอบจะมีหน้าเว็บหนึ่งที่แสดงรายงานช่องทั้งหมด และอีกหน้าหนึ่งที่แสดงรายงานเจ้าของเนื้อหาทั้งหมดที่มีอยู่ ก่อนหน้านี้ เอกสารประกอบดังกล่าวมีหน้าแยกต่างหากสำหรับรายงานวิดีโอของช่อง รายงานเพลย์ลิสต์ของช่อง ฯลฯ
-
ภาพรวมโมเดลข้อมูลใหม่ต้องการให้ข้อมูลเบื้องต้นเกี่ยวกับวิธีการทำงานของ API ที่ชัดเจนขึ้น โดยเฉพาะอย่างยิ่ง เอกสารนี้พยายามอธิบายถึงวิธีที่ YouTube ใช้เมตริก มิติข้อมูล และตัวกรองเพื่อคำนวณค่าในรายงานให้ชัดเจนยิ่งขึ้น
-
ตอนนี้เมธอด
reports.query
ของ API ที่คุณใช้เพื่อเรียกดูรายงานได้รับการจัดทำเป็นเอกสารแยกต่างหากแล้ว ก่อนหน้านี้ ข้อมูลดังกล่าวเคยอยู่ในหน้าอื่นๆ แล้ว หน้าเว็บใหม่นี้ออกแบบมาเพื่อช่วยให้คุณระบุข้อมูลที่คุณต้องส่งเพื่อเรียกดูรายงานได้ง่ายขึ้น
-
-
เมตริก
adEarnings
ใหม่นี้ประกอบด้วยรายได้โดยประมาณทั้งหมด (รายได้สุทธิ) จากแหล่งโฆษณาที่จำหน่ายโดย Google ทั้งหมด ซึ่งไม่ใช่เมตริกหลัก API รองรับเมตริกadEarnings
สําหรับรายงานที่รองรับเมตริกearnings
อยู่แล้วนอกจากนี้ เรายังได้แก้ไขคำจำกัดความของเมตริก
earnings
เพื่อแสดงถึงข้อเท็จจริงที่ว่าค่าดังกล่าวรวมถึงรายได้โดยประมาณทั้งหมดจากแหล่งที่มาของโฆษณาที่ขายโดย Google ทั้งหมดและแหล่งที่มาที่ไม่ใช่เพื่อการโฆษณา ก่อนหน้านี้ คำจำกัดความระบุอย่างไม่ถูกต้องว่าเมตริกรวมเฉพาะรายได้จากแหล่งที่มาของการโฆษณาเท่านั้น -
เราเลิกใช้งานเมตริก
primaryAdGrossRevenue
แล้ว ให้ใช้เมตริกgrossRevenue
เพื่อดึงข้อมูลรายได้แทน -
นอกจากเมตริก
primaryAdGrossRevenue
ที่เลิกใช้งานแล้ว รายงานประสิทธิภาพของโฆษณาก็ไม่รองรับเมตริกmonetizedPlaybacks
และplaybackBasedCpm
อีกต่อไปแล้ว อย่างไรก็ตาม รายงานวิดีโอหลายรายการยังคงรองรับเมตริกเหล่านั้นอยู่ -
ตอนนี้ API รองรับเมตริกใหม่ 2 รายการสำหรับรายงานวิดีโอแล้ว
videosAddedToPlaylists
และvideosRemovedFromPlaylists
อัปเดตทั้งรายการรายงานวิดีโอสำหรับช่องและเจ้าของเนื้อหาเพื่อระบุรายงานที่รองรับเมตริกใหม่videosAddedToPlaylists
– จำนวนครั้งที่มีการเพิ่มวิดีโอในขอบเขตการค้นหาลงในเพลย์ลิสต์ YouTube วิดีโออาจเพิ่มลงในเพลย์ลิสต์ของเจ้าของวิดีโอหรือเพลย์ลิสต์ของช่องอื่นvideosRemovedFromPlaylists
– จำนวนครั้งที่มีการนำวิดีโอในขอบเขตการค้นหาออกจากเพลย์ลิสต์ YouTube ระบบอาจนำวิดีโอออกจากเพลย์ลิสต์ของเจ้าของวิดีโอหรือจากเพลย์ลิสต์ของช่องอื่น
โดยทั้ง 2 เมตริกจะมีเพลย์ลิสต์เริ่มต้น เช่น เพลย์ลิสต์ "ดูภายหลัง" แต่จะไม่นับเพลย์ลิสต์ที่มีการเพิ่มวิดีโอโดยอัตโนมัติ เช่น เพลย์ลิสต์การอัปโหลดของช่องหรือประวัติการดูของผู้ใช้ และโปรดทราบว่าเมตริกเหล่านี้แสดงจำนวนสัมบูรณ์ของการเพิ่มและลบ ดังนั้น หากผู้ใช้เพิ่มวิดีโอลงในเพลย์ลิสต์แล้วนำออก แล้วเพิ่มอีกครั้ง เมตริกจะระบุว่ามีการเพิ่มวิดีโอลงในเพลย์ลิสต์ 2 รายการและนำออกจากเพลย์ลิสต์เดียว
ข้อมูลสำหรับเมตริกเหล่านี้ใช้ได้ตั้งแต่วันที่ 1 ตุลาคม 2014
-
เมตริก
favoritesAdded
และfavoritesRemoved
เลิกใช้งานแล้วนับตั้งแต่การประกาศนี้ เมตริกเหล่านี้เป็นเมตริกหลักและอยู่ภายใต้นโยบายการเลิกใช้งานที่ระบุไว้ในข้อกำหนดในการให้บริการ -
พารามิเตอร์
currency
ใหม่ช่วยให้คุณดึงข้อมูลเมตริกรายได้ในสกุลเงินอื่นที่ไม่ใช่ดอลลาร์สหรัฐ (USD
) หากมีการตั้งค่าพารามิเตอร์ไว้ API จะแปลงค่าของเมตริกearnings
,grossRevenue
,playbackBasedCpm
และimpressionBasedCpm
เป็นสกุลเงินที่ระบุ ค่าที่เป็นผลลัพธ์เป็นค่าประมาณที่คำนวณโดยใช้อัตราแลกเปลี่ยนที่เปลี่ยนแปลงในแต่ละวันค่าพารามิเตอร์จะเป็นรหัสสกุลเงิน 3 ตัวอักษรตามมาตรฐาน ISO 4217 ค่าเริ่มต้นคือ
USD
คำจำกัดความพารามิเตอร์มีรายการรหัสสกุลเงินที่รองรับ -
ขณะนี้ API รองรับความสามารถในการสร้างและจัดการกลุ่ม YouTube Analytics รวมถึงสามารถเรียกดูข้อมูลรายงานของกลุ่มเหล่านั้น
-
การสร้างและจัดการกลุ่ม
การอัปเดตนี้จะแนะนำทรัพยากร
group
และgroupItem
สำหรับการสร้างและจัดการกลุ่ม- ทรัพยากร
group
แสดงถึงกลุ่ม Analytics ซึ่งเป็นคอลเล็กชันที่กำหนดเองที่มีช่อง วิดีโอ เพลย์ลิสต์ หรือเนื้อหาสูงสุด 200 รายการ API รองรับเมธอดlist
,insert
,update
และdelete
สำหรับทรัพยากรนี้ - ทรัพยากร
groupItem
หมายถึงรายการในกลุ่ม Analytics API รองรับเมธอดlist
,insert
และdelete
สำหรับทรัพยากรนี้
เช่น คุณอาจสร้างกลุ่มโดยใช้เมธอด
groups.insert
แล้วเพิ่มรายการลงในกลุ่มนั้นโดยใช้เมธอดgroupItems.insert
- ทรัพยากร
-
การเรียกดูข้อมูลรายงานของกลุ่ม
เอกสารมิติข้อมูลได้รับการอัปเดตให้รวมมิติข้อมูล
group
ซึ่งสามารถใช้เป็นตัวกรองสำหรับรายงานแชแนลและรายงานเจ้าของเนื้อหาหลายรายการได้ เมื่อคุณใช้ตัวกรองgroup
API จะแสดงข้อมูลสำหรับรายการทั้งหมดในกลุ่มนั้น โปรดทราบว่าขณะนี้ API ยังไม่รองรับความสามารถในการสร้างรายงานสําหรับกลุ่มชิ้นงาน
ไปที่ศูนย์ช่วยเหลือของ YouTube เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่ม YouTube Analytics
-
-
API ไม่รองรับมิติข้อมูล
show
อีกต่อไป -
ตอนนี้ API รองรับความสามารถในการระบุค่าหลายค่าสำหรับมิติข้อมูล
video
,playlist
,channel
และshow
เมื่อใช้มิติข้อมูลเหล่านั้นเป็นตัวกรอง หากต้องการระบุหลายค่า ให้ตั้งค่าพารามิเตอร์filters
เป็นรายการที่คั่นด้วยคอมมาของวิดีโอ เพลย์ลิสต์ ช่อง หรือรหัสของรายการที่ควรกรองการตอบกลับของ API ค่าพารามิเตอร์ระบุรหัสได้สูงสุด 200 รหัสหากคุณระบุค่าหลายค่าสำหรับตัวกรองเดียวกัน คุณยังสามารถเพิ่มตัวกรองนั้นลงในรายการมิติข้อมูลที่คุณระบุสำหรับคำขอได้ด้วย กรณีนี้จะเกิดขึ้นแม้ว่าตัวกรองจะไม่ได้อยู่ในรายการเป็นมิติข้อมูลที่ได้รับการสนับสนุนสำหรับรายงานหนึ่งๆ หากคุณเพิ่มตัวกรองลงในรายการมิติข้อมูล API จะใช้ค่าตัวกรองในการจัดกลุ่มผลลัพธ์ด้วย
ดูคำจำกัดความพารามิเตอร์
filters
สำหรับรายละเอียดทั้งหมดเกี่ยวกับฟังก์ชันนี้ -
เมื่อดึงรายงานแชแนล คุณจะดึงข้อมูลสำหรับแชแนลของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วได้โดยการตั้งค่าพารามิเตอร์
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
ได้อีกต่อไป -
เอกสารรายงานเจ้าของเนื้อหาได้รับการอัปเดตเพื่อให้เจ้าของเนื้อหาอ้างสิทธิ์หรืออัปโหลดเมตริก
subscribersGained
และsubscribersLost
ได้แล้วการเปลี่ยนแปลงจะปรากฏในรายงานสถิติพื้นฐานฉบับแรกสำหรับเจ้าของเนื้อหา ซึ่งตอนนี้รองรับตัวกรอง
claimedStatus
และuploaderType
แล้ว -
เอกสารตัวอย่างคำขอได้รับการออกแบบใหม่ให้จัดกลุ่มตัวอย่างในหมวดหมู่ต่างๆ โดยใช้รูปแบบแท็บคล้ายกับเอกสารที่เผยแพร่ล่าสุดสำหรับรายงานช่องและเจ้าของเนื้อหา เมื่อใช้รูปลักษณ์ใหม่นี้ ตัวอย่างจะถูกจัดกลุ่มเป็นหมวดหมู่ต่อไปนี้
- สถิติพื้นฐาน
- ตามเวลา
- ภูมิศาสตร์
- ตำแหน่งที่เล่น
- แหล่งที่มาของการเข้าชม
- อุปกรณ์/ระบบปฏิบัติการ
- ข้อมูลประชากร
- โซเชียล
- รายได้/โฆษณา (สำหรับรายงานของเจ้าของเนื้อหาเท่านั้น)
-
ตอนนี้เอกสารตัวอย่างคำขอมีตัวอย่างใหม่สำหรับการดึงข้อมูลเฉพาะจังหวัดในรายงานช่องหรือรายงานเจ้าของเนื้อหา
-
เมตริกเฉพาะจังหวัดสำหรับรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี. รายงานนี้จะแสดงผลจำนวนการดูและสถิติอื่นๆ แยกตามจังหวัดและสถิติอื่นๆ สำหรับวิดีโอของช่อง ข้อมูลครอบคลุมรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี. ตัวอย่างนี้ใช้มิติข้อมูล
province
และใช้พารามิเตอร์filters
เพื่อจำกัดการตอบสนองให้รวมเฉพาะผลลัพธ์สำหรับสหรัฐอเมริกาเท่านั้น -
ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ): รายงานนี้จะแสดงสถิติเกี่ยวกับกลุ่มอายุและเพศของผู้ชมในแคลิฟอร์เนียที่ดูวิดีโอของช่อง หรือสำหรับรายงานเจ้าของเนื้อหาหรือเนื้อหาที่เจ้าของเนื้อหาอ้างสิทธิ์ ตัวอย่างนี้ใช้พารามิเตอร์
filters
เพื่อให้มั่นใจว่าคำตอบจะมีเฉพาะข้อมูลของจังหวัดที่เฉพาะเจาะจง
-
-
มีการอัปเดตคำจำกัดความของมิติข้อมูล
province
เพื่อให้ทราบว่าเมื่อprovince
รวมอยู่ในค่าพารามิเตอร์dimensions
คำขอนั้นต้องจำกัดข้อมูลให้อยู่ในสหรัฐอเมริกาด้วย โดยใส่country==US
ในค่าพารามิเตอร์filters
-
เอกสารที่แสดงรายงานช่องและเจ้าของเนื้อหาที่รองรับได้รับการออกแบบใหม่แล้ว แทนที่จะสร้างตารางที่แสดงรายการรายงานที่เป็นไปได้ทั้งหมด เอกสารแต่ละฉบับจะจัดกลุ่มรายงานเป็นหมวดหมู่ต่างๆ แทน ดังนี้
- สถิติพื้นฐาน
- ตามเวลา
- ภูมิศาสตร์
- ตำแหน่งที่เล่น
- แหล่งที่มาของการเข้าชม
- อุปกรณ์/ระบบปฏิบัติการ
- ข้อมูลประชากร
- โซเชียล
- วิดีโอยอดนิยม
เอกสารแต่ละฉบับจะแสดงหมวดหมู่เหล่านี้เป็นรายการแท็บ และคุณสามารถคลิกแท็บใดก็ได้เพื่อดูรายงานที่สนับสนุนในหมวดหมู่นั้นๆ
-
ตอนนี้ API รองรับมิติข้อมูลทางภูมิศาสตร์ใหม่ 3 รายการ ได้แก่
province
,continent
และsubContinent
-
มิติข้อมูล
province
ช่วยให้คุณสามารถเรียกดูสถิติสำหรับรัฐในสหรัฐอเมริกาและดิสตริกต์ออฟโคลัมเบีย API รองรับการใช้งาน 2 แบบสำหรับมิติข้อมูลนี้ ได้แก่-
API รองรับรายงาน 2 ฉบับที่แจกแจงสถิติในแต่ละรัฐ รายงานทั้ง 2 ประเภทมีไว้สำหรับช่องและเจ้าของเนื้อหา
- รายงานสถิติหลักแสดงสถิติหลายอย่าง รวมถึงจำนวนการดูและจำนวนนาทีที่ดูโดยประมาณ
- รายงานตามเวลาจะให้สถิติเดียวกัน แต่รวบรวมข้อมูลแบบรายวัน, 7 วัน, 30 วัน หรือรายเดือน
-
คุณสามารถใช้พารามิเตอร์ข้อความค้นหา
filters
เพื่อจำกัดรายงานให้มีเฉพาะสถิติสำหรับสถานะที่ระบุเท่านั้น รายงานหลายประเภทสนับสนุนการกรองประเภทนี้ ซึ่งรวมถึงรายงานทางภูมิศาสตร์ รายงานตำแหน่งที่เล่น รายงานแหล่งที่มาของการเข้าชม รายงานอุปกรณ์ รายงานระบบปฏิบัติการ รายงานข้อมูลประชากร และรายงานวิดีโอยอดนิยม
-
-
มิติข้อมูล
continent
ระบุรหัสภูมิภาคทางสถิติของสหประชาชาติ (UN) ที่ระบุทวีป มิติข้อมูลนี้สามารถใช้เป็นตัวกรองเท่านั้น -
มิติข้อมูล
subContinent
ระบุรหัสภูมิภาคทางสถิติของสหประชาชาติ (UN) ที่ระบุภูมิภาคย่อยของทวีป มิติข้อมูลนี้สามารถใช้เป็นตัวกรองได้เท่านั้นเนื่องจากแต่ละภูมิภาคย่อยเชื่อมโยงกับทวีปเพียง 1 ทวีปเท่านั้น จึงไม่จำเป็นต้องใช้ตัวกรอง
continent
เมื่อใช้ตัวกรองsubContinent
(ซึ่ง API จะแสดงผลข้อผิดพลาดหากคำขอใช้มิติข้อมูลทั้ง 2 รายการ)
-
-
เอกสารประกอบได้รับการแก้ไขแล้ว มิติข้อมูล
insightTrafficSourceDetail
ไม่รวมค่าinsightTrafficSourceType
PROMOTED
เป็นค่าตัวกรองที่ถูกต้อง -
ตอนนี้ API ของ YouTube Analytics อยู่ภายใต้นโยบายการเลิกใช้งานที่อธิบายไว้ในข้อกำหนดในการให้บริการ อย่างไรก็ตาม มิติข้อมูลที่ไม่ใช่กลุ่มหลักและเมตริกที่ไม่ใช่กลุ่มหลักของ API จะไม่ขึ้นอยู่กับนโยบายการเลิกใช้งาน มีการอัปเดตหน้ามิติข้อมูลและmetricsให้แสดงรายการมิติข้อมูลและเมตริกหลัก นอกจากนี้ คําจํากัดความในหน้าเหล่านั้นยังได้รับการอัปเดตเพื่อระบุมิติข้อมูลและเมตริกหลักอย่างชัดเจน
-
ตอนนี้ API รองรับ
EXTERNAL_APP
เป็นค่าสําหรับมิติข้อมูลinsightPlaybackLocationType
แล้ว นับตั้งแต่วันที่ 10 กันยายน 2013 เป็นต้นไป การเล่นจะไม่ได้จัดอยู่ในหมวดหมู่การเล่นMOBILE
อีกต่อไป แต่การเล่นบนอุปกรณ์เคลื่อนที่ที่เกิดขึ้นก่อนวันที่ดังกล่าวจะยังคงมีการจัดหมวดหมู่ด้วยค่าดังกล่าวด้วยการอัปเดตนี้ การเล่นบนอุปกรณ์เคลื่อนที่จึงได้รับการจัดประเภทเป็นการเล่น
WATCH
,EMBEDDED
หรือEXTERNAL_APP
โดยขึ้นอยู่กับประเภทของแอปพลิเคชันที่จะเล่น -
ตอนนี้ API รองรับ
PLAYLIST
เป็นค่าสําหรับมิติข้อมูลinsightTrafficSourceType
แล้ว ค่าดังกล่าวบ่งบอกว่ายอดดูวิดีโอมาจากเพลย์ลิสต์ ก่อนหน้านี้ ข้อมูลพร็อพเพอร์ตี้เหล่านี้จะได้รับการจัดประเภทโดยใช้หมวดหมู่YT_OTHER_PAGE
ของมิติข้อมูล -
ตอนนี้ 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
ซึ่งระบุข้อมูลพร็อพเพอร์ตี้ที่ไม่ได้จัดประเภทโดยใช้ค่าอื่นๆ ของมิติข้อมูลดังกล่าว -
เราได้อัปเดตเอกสารรายงานของเจ้าของเนื้อหาเพื่อแสดงให้เห็นว่าคุณสามารถจัดเรียงรายงานวิดีโอยอดนิยมตามรายได้จากมากไปน้อยเพื่อระบุวิดีโอที่มีรายได้สูงสุด รายงานนี้เป็นรายงานแรกที่แสดงในตารางที่ 2 ของส่วนรายงานกิจกรรมของผู้ใช้และรายได้
-
YouTube ไม่ได้ระบุฟีเจอร์และบริการ API แบบทดลองอีกต่อไป แต่ตอนนี้ เราจะแสดงรายการ YouTube API ภายใต้นโยบายการเลิกใช้งานแทน
-
ตอนนี้ 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
-
-
-
เอกสารคำขอ API ตัวอย่างใหม่มีตัวอย่างที่สาธิตวิธีการเรียกรายงานประเภทต่างๆ โดยใช้ YouTube Analytics API แต่ละตัวอย่างจะมีคำอธิบายสั้นๆ ของรายงานที่คำขอดึงมา จากนั้นจะแสดงมิติข้อมูล เมตริก ตัวกรอง และพารามิเตอร์การจัดเรียงสำหรับคำขอ
-
ตอนนี้มิติข้อมูล
insightTrafficSourceType
รองรับSUBSCRIBER
เป็นค่าที่ถูกต้อง ค่านี้จะระบุจำนวนการดูวิดีโอที่อ้างอิงมาจากฟีดในหน้าแรกของ YouTube หรือจากคุณลักษณะการติดตามของ YouTube หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่องinsightTrafficSourceDetail
จะระบุฟีดหน้าแรกหรือหน้าอื่นๆ ที่มีการอ้างอิงมาจากข้อมูลพร็อพเพอร์ตี้ -
ตอนนี้ API รองรับเมตริกใหม่ 2 รายการคือ
annotationClickThroughRate
และannotationCloseRate
ซึ่งเกี่ยวข้องกับการโต้ตอบของผู้ชมที่มีต่อคำอธิบายประกอบที่แสดงระหว่างวิดีโอของคุณ เราได้อัปเดตทั้งรายการรายงานแชแนลและรายงานของเจ้าของเนื้อหาเพื่อระบุรายงานที่สนับสนุนเมตริกใหม่annotationClickThroughRate
– อัตราส่วนของคำอธิบายประกอบที่ผู้ชมคลิกต่อจำนวนการแสดงผลคำอธิบายประกอบที่คลิกได้ทั้งหมดannotationCloseRate
– อัตราส่วนของคำอธิบายประกอบที่ผู้ชมปิดเทียบกับจำนวนการแสดงผลทั้งหมดของคำอธิบายประกอบ
-
ตอนนี้ API รองรับเมตริกรายได้และประสิทธิภาพของโฆษณา รวมถึงรายงานประสิทธิภาพโฆษณาแบบใหม่แล้ว มีเพียงพาร์ทเนอร์ด้านเนื้อหาของ YouTube ที่เข้าร่วมโปรแกรมพาร์ทเนอร์ YouTube เท่านั้นที่จะเข้าถึงเมตริกและรายงานได้
-
รายงานใหม่ที่รองรับจะรองรับเมตริกประสิทธิภาพของโฆษณาตามการเล่นและเมตริกประสิทธิภาพของโฆษณาตามการแสดงผล ดูเอกสารรายงานเจ้าของเนื้อหาสำหรับข้อมูลเพิ่มเติมเกี่ยวกับรายงานประสิทธิภาพโฆษณา
-
เมตริกใหม่ที่รองรับจะแสดงอยู่ด้านล่าง เราได้อัปเดตรายการรายงานของเจ้าของเนื้อหาเพื่อระบุรายงาน ซึ่งรวมถึงรายงานใหม่ 2 ฉบับที่รองรับเมตริกเหล่านี้
earnings
– รายได้โดยประมาณทั้งหมดจากแหล่งโฆษณาที่ขายโดย Google ทั้งหมดgrossRevenue
– รายได้รวมโดยประมาณจาก Google หรือพาร์ทเนอร์ DoubleClickprimaryAdGrossRevenue
– รายได้รวมโดยประมาณ สรุปและจัดอยู่ในหมวดหมู่โฆษณาหลักสำหรับการเล่นวิดีโอที่รายงานครอบคลุมจากพาร์ทเนอร์ Google หรือ DoubleClickmonetizedPlaybacks
– จำนวนการเล่นที่แสดงการแสดงโฆษณาอย่างน้อย 1 ครั้งplaybackBasedCpm
– รายได้รวมโดยประมาณต่อการเล่น 1,000 ครั้งimpressions
– จำนวนการแสดงโฆษณาที่ยืนยันแล้วimpressionBasedCpm
– รายได้รวมโดยประมาณต่อการแสดงโฆษณา 1,000 ครั้ง
หมายเหตุ: ดูรายละเอียดทั้งหมดในคำจำกัดความของเมตริก
-
คำขอที่ดึงรายได้หรือเมตริกประสิทธิภาพโฆษณาต้องส่งโทเค็นการให้สิทธิ์ที่ให้สิทธิ์เข้าถึงโดยใช้ขอบเขต
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
ใหม่
-
-
เอกสารประกอบของ API ได้รับการจัดระเบียบใหม่เพื่อให้รายงานประเภทต่างๆ อธิบายในหน้าที่แยกกัน ด้วยเหตุนี้ ตอนนี้จึงมีหน้าแยกต่างหากที่อธิบายรายงานช่องและรายงานเจ้าของเนื้อหาประเภทต่างๆ
-
ตอนนี้คู่มืออ้างอิงของ API จะมีส่วนตัวอย่าง ซึ่งมีตัวอย่างโค้ดที่สาธิตวิธีเรียก API โดยใช้ไลบรารีของไคลเอ็นต์ Java, JavaScript, Python และ Ruby ตัวอย่างโค้ด JavaScript คือโค้ดเดียวกับที่กล่าวถึงอย่างละเอียดในเอกสารประกอบของแอปพลิเคชันตัวอย่าง
-
ตอนนี้คู่มืออ้างอิง API จะมี APIs Explorer ซึ่งจะช่วยให้คุณเรียกใช้ API ดูคำขอ API และเรียกข้อมูลจริงในการตอบสนองได้
-
API รองรับรายงานใหม่จำนวนมากสำหรับทั้งช่องและเจ้าของเนื้อหาตามรายละเอียดด้านล่าง รายงานแต่ละฉบับจะพร้อมใช้งานเป็นรายงานช่องหรือรายงานเจ้าของเนื้อหา หน้ามิติข้อมูลและmetricsก็ได้รับการอัปเดตให้สอดคล้องกันด้วย
-
รายงานตำแหน่งที่เล่นจะระบุจำนวนการดูวิดีโอที่เกิดขึ้นในหน้าเว็บหรือแอปพลิเคชันประเภทต่างๆ
-
รายงานรายละเอียดตำแหน่งที่เล่นจะระบุโปรแกรมเล่นแบบฝังที่สร้างยอดดูมากที่สุดให้กับวิดีโอที่ระบุ ซึ่งจะให้มุมมองที่ละเอียดมากกว่ารายงานตำแหน่งที่เล่น โดยการระบุ URL ที่เชื่อมโยงกับโปรแกรมเล่นแบบฝังยอดนิยม
-
รายงานแหล่งที่มาของการเข้าชมจะระบุยอดดูวิดีโอที่มาจากURL ที่มาประเภทต่างๆ
-
รายงานรายละเอียดแหล่งที่มาของการเข้าชมจะระบุ URL ที่มาซึ่งสร้างยอดดูสูงสุดสำหรับวิดีโอหนึ่งๆ และประเภทแหล่งที่มาของการเข้าชมที่ระบุ ตัวอย่างเช่น รายงานนี้อาจแสดงวิดีโอที่เกี่ยวข้องที่ทำให้เกิดการเข้าชมมากที่สุดไปยังวิดีโอใดวิดีโอหนึ่ง มีแหล่งที่มาของการเข้าชมหลายแห่งที่รองรับรายงานนี้
-
รายงานเวลาในการรับชมแสดงระยะเวลาที่ผู้ชมใช้ในการรับชมเนื้อหาของคุณ รายงานจะสามารถรวบรวมข้อมูลสำหรับกรอบเวลาหนึ่งๆ เช่น วัน, 7 วันก่อนหน้า, 30 วันก่อนหน้า ฯลฯ หรือประเทศ หากรายงานรวบรวมข้อมูลตามวันหรือประเทศ รายงานยังสามารถระบุความยาวเฉลี่ยของการดูวิดีโอแต่ละครั้ง รวมทั้งเปอร์เซ็นต์เฉลี่ยของแต่ละวิดีโอที่ผู้ใช้ดู
-
-
YouTube Analytics API พร้อมให้บริการแก่นักพัฒนาแอปทุกรายแล้ว คุณเปิดใช้งาน API สำหรับโปรเจ็กต์ได้โดยไม่ต้องขอสิทธิ์เข้าถึงก่อน จากแผงบริการใน APIs console
-
ส่วนเริ่มต้นใช้งานใหม่จะสรุปข้อกำหนดเบื้องต้นและขั้นตอนพื้นฐานสำหรับการสร้างแอปพลิเคชันที่ใช้ YouTube Analytics API
-
ส่วนการทำความเข้าใจการใช้งานโควต้าใหม่จะมีหลักเกณฑ์ในการเพิ่มประสิทธิภาพการใช้โควต้า API ของคุณ เซิร์ฟเวอร์ API จะคํานวณค่าใช้จ่ายการค้นหาสําหรับคําขอแต่ละรายการ และค่าใช้จ่ายนั้นจะถูกหักออกจากโควต้าการใช้งาน API เนื่องจากรายงานประเภทต่างๆ อาจมีค่าใช้จ่ายในการค้นหาที่ต่างกันอย่างมาก คุณจึงควรวางแผนให้ใช้โควต้าอย่างมีประสิทธิภาพและแอปพลิเคชันของคุณควรขอเฉพาะเมตริกและข้อมูลที่ต้องใช้จริงๆ เท่านั้น
-
เราได้อัปเดตส่วนมิติข้อมูลชั่วคราวเพื่ออธิบายว่ามิติข้อมูลเหล่านั้นระบุว่ารายงาน Analytics ควรรวบรวมข้อมูลโดยอิงตามระยะเวลา ขณะนี้ API รองรับมิติข้อมูลเวลาเพิ่มเติมต่อไปนี้
7DayTotals
– ระบบจะรวมข้อมูลในรายงานเพื่อให้แต่ละแถวมีข้อมูลในระยะเวลา 7 วัน30DayTotals
– ระบบจะรวมข้อมูลในรายงานเพื่อให้แต่ละแถวมีข้อมูลในระยะเวลา 30 วันmonth
– ระบบจะรวบรวมข้อมูลในรายงานตามเดือนปฏิทิน
ในทำนองเดียวกัน ส่วนรายงานที่ใช้ได้ก็ได้รับการอัปเดตเพื่อแสดงการสนับสนุนของ API สำหรับรายงานที่ใช้มิติข้อมูลเหล่านี้
-
ส่วนมิติข้อมูลบุคคลที่รายงานได้รับการอัปเดตให้สังเกตว่าคำขอ API สำหรับเรียกข้อมูลรายงานของเจ้าของเนื้อหาต้องกรองข้อมูลโดยใช้มิติข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้ (
video
,channel
หรือshow
) หรือชุดค่าผสมของมิติข้อมูลclaimedStatus
และuploaderType
ที่รองรับ -
ตอนนี้ API รองรับตัวเลือกการจัดเรียงใหม่ 2 แบบสำหรับรายงานวิดีโอยอดนิยม รายงานเหล่านี้เป็นรายงานของช่องหรือรายงานเจ้าของเนื้อหา มีเมตริกต่างๆ (ยอดดู ความคิดเห็น การกดชอบ ฯลฯ) ในแต่ละประเทศและแจกแจงเมตริกเหล่านั้นตามวิดีโอ ตอนนี้คุณจัดเรียงรายงานเหล่านี้ตามจำนวนผู้ใช้ที่ติดตามหรือเลิกติดตามช่องจากหน้าสำหรับดูของวิดีโอได้แล้ว
-
เราได้ปรับปรุงคำจำกัดความของmetrics
subscribersGained
และsubscribersLost
เพื่ออธิบายว่าช่องอาจได้รับหรือสูญเสียผู้ติดตามในหลายตำแหน่ง ซึ่งรวมถึงหน้าสำหรับดูวิดีโอ หน้าช่อง และคำแนะนำที่จะปรากฏในหน้าแรกของ YouTube เมื่อเมตริกเหล่านี้ปรากฏในรายงานเฉพาะวิดีโอ เมตริกเหล่านี้จะรวมเฉพาะสถิติจากหน้าสำหรับดูของวิดีโอที่ระบุเท่านั้น
API การรายงานของ YouTube รองรับรายงาน End Screen ใหม่ 3 แบบ รวมถึงมิติข้อมูลและเมตริกใหม่สำหรับรายงานเหล่านั้น รายงานจะแสดงสถิติการแสดงผลและการคลิกผ่านสำหรับ End Screen ที่แสดงหลังจากวิดีโอหยุดเล่น
ศูนย์ช่วยเหลือของ YouTube มีข้อมูลโดยละเอียดเกี่ยวกับการเพิ่ม End Screen ลงในวิดีโอ
8 พฤศจิกายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API ของ YouTube Analytics
27 ตุลาคม 2016
ตอนนี้ YouTube สร้างชุดรายงานรายได้จากโฆษณาที่จัดการโดยระบบโดยอัตโนมัติสำหรับเจ้าของเนื้อหาที่มีสิทธิ์เข้าถึงรายงานที่เกี่ยวข้องในส่วนรายงานของ Creator Studio ของ YouTube ได้แล้ว รายงาน API ใหม่ที่จัดการโดยระบบออกแบบมาเพื่อให้สิทธิ์การเข้าถึงข้อมูลแบบเป็นโปรแกรมที่มีอยู่ในรายงาน Creator Studio ที่ดาวน์โหลดได้ด้วยตนเอง
ภาพรวมรายงานที่จัดการโดยระบบมีภาพรวมโดยสรุปเกี่ยวกับรายงานใหม่ และอธิบายกระบวนการดึงข้อมูลผ่าน API ขั้นตอนนี้จะแตกต่างจากการดึงข้อมูลรายงานจำนวนมากสำหรับ YouTube Analytics เนื่องจากพาร์ทเนอร์ไม่จำเป็นต้องกำหนดเวลางานเพื่อสร้างรายงาน
พร็อพเพอร์ตี้ id
ของทรัพยากร reportType
ได้รับการอัปเดตให้รวมรายการรายงานที่จัดการโดยระบบซึ่งคุณเข้าถึงได้ผ่าน API ดังนี้
27 กันยายน 2016
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
เราเลิกใช้งานเมตริก uniques
ของ YouTube Analytics API แล้ว เมตริกนี้ไม่ใช่เมตริกหลักและได้รับการรองรับจนถึงวันที่ 31 ตุลาคม 2016
15 กันยายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API การรายงานของ YouTube
19 สิงหาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API การรายงานของ YouTube
11 สิงหาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
10 สิงหาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
18 กรกฎาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
28 มิถุนายน 2016
เอกสาร API ของ YouTube Analytics ได้รับการอัปเดตเพื่อแสดงการสนับสนุนเมตริกการ์ดในรายงานช่องและเจ้าของเนื้อหาจำนวนมาก เมตริกใหม่ที่รองรับ ได้แก่
เมตริกได้รับการรองรับในรายงานประเภทต่อไปนี้
22 มิถุนายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ของ YouTube Reporting API การเปลี่ยนแปลงแรกเกี่ยวกับ API โดยทั่วไป และการเปลี่ยนแปลงที่เหลือจะมีผลกับรายงานเจ้าของเนื้อหาเท่านั้น ดังนี้
19 พฤษภาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ใน API การรายงานของ YouTube
12 เมษายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ ซึ่งทั้งหมดจะส่งผลต่อ API การรายงานของ YouTube เท่านั้น
28 มีนาคม 2016
ขณะนี้ API การรายงานของ YouTube และ API ของ YouTube Analytics จะแสดงสถิติการดูสำหรับบริการการแชร์เพิ่มเติมหลายรายการ
16 มีนาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ ซึ่งส่งผลต่อทั้ง API การรายงานของ YouTube และ API ของ YouTube Analytics
API การรายงานของ YouTube
API ของ YouTube Analytics
8 กุมภาพันธ์ 2016
อัปเดตรายการเมตริกที่รองรับ API ของ YouTube Analytics แล้ว เพื่อให้เมตริกการ์ดไม่แสดงเป็นเมตริกที่รองรับสำหรับ API นั้นอีกต่อไป (ไม่มีรายงานใดๆ ของ API นั้นที่ได้รับการบันทึกไว้ว่าสนับสนุนเมตริกของการ์ดเลย)
โปรดทราบว่าคุณยังคงสามารถเรียกดูเมตริกการ์ดได้โดยใช้ API การรายงานของ YouTube ซึ่งรองรับเมตริกเหล่านั้นสำหรับรายงานช่องและเจ้าของเนื้อหาจำนวนมาก
6 มกราคม 2016
ขณะนี้ API การรายงานของ YouTube และ API ของ YouTube Analytics จะระบุการดูที่เกิดขึ้นผ่านอุปกรณ์ Chromecast ได้อย่างเจาะจง
21 ธันวาคม 2015
ในเอกสารนี้ ชื่อของเมตริก annotation_clickable_impressions
และ annotation_closable_impressions
ได้รับการอัปเดตให้ตรงกับชื่อที่แสดงผลในรายงาน ก่อนหน้านี้ ชื่อจะบันทึกเป็น clickable_annotation_impressions
และ closable_annotation_impressions
18 ธันวาคม 2015
กฎหมายของสหภาพยุโรป (EU) กำหนดว่าต้องมีการเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ปลายทางในสหภาพยุโรปและได้รับการยินยอมจากผู้ใช้ดังกล่าว ดังนั้น สำหรับผู้ใช้ปลายทางในสหภาพยุโรป คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU เราได้เพิ่มประกาศข้อกำหนดนี้ไว้ในข้อกำหนดในการให้บริการ API ของ YouTube
15 ธันวาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้ ซึ่งทั้งหมดจะส่งผลต่อ API ของ YouTube Analytics
10 พฤศจิกายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
29 ตุลาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
8 ตุลาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
24 กันยายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
20 สิงหาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
22 กรกฎาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงหลายอย่าง ซึ่งทั้งหมดจะมีผลกับเจ้าของเนื้อหาเท่านั้น
1 มิถุนายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
31 มีนาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
16 มีนาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
25 กุมภาพันธ์ 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
13 กุมภาพันธ์ 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
28 สิงหาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
16 กรกฎาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
31 มกราคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
16 มกราคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
6 มกราคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
30 กันยายน 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
16 กรกฎาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
23 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
10 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
6 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
3 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
28 มีนาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
21 มีนาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
4 กุมภาพันธ์ 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
14 พฤศจิกายน 2012
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
2 ตุลาคม 2012
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
12 กันยายน 2012
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้