ตัวอย่างคำขอ API

รายงานวิดีโอ

เมตริกเวลาในการรับชมรายวันสำหรับวิดีโอของช่อง

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

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

เมตริกคำอธิบายประกอบรายวันสำหรับวิดีโอของช่อง

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

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

รายงานเพลย์ลิสต์

ยอดดูเพลย์ลิสต์รายวันของช่อง

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

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

รายงานวิดีโอ

เมตริกเวลาในการรับชมเฉพาะประเทศสำหรับวิดีโอของช่อง

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

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

เมตริกคำอธิบายประกอบเฉพาะประเทศสำหรับวิดีโอของช่อง

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

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

เมตริกเฉพาะจังหวัดสำหรับรัฐในสหรัฐฯ และวอชิงตัน ดี.ซี.

คำขอนี้เรียกรายละเอียดของยอดดู จำนวนนาทีที่ดูโดยประมาณ และระยะเวลาการดูเฉลี่ยสำหรับวิดีโอของช่องแบบแยกตามจังหวัด ข้อมูลนี้ครอบคลุมรัฐในสหรัฐฯ และวอชิงตัน ดี.ซี. โดยผลลัพธ์จะจัดเรียงตามตัวอักษรของจังหวัดต่างๆ รหัส ISO 3166-2

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

10 อันดับยอดนิยม – วิดีโอที่มีคนดูมากที่สุดในประเทศใดประเทศหนึ่ง

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

หมายเหตุ: รายงานนี้กำหนดให้คุณต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort และตั้งค่าพารามิเตอร์ maxResults เป็นค่าที่เป็นจำนวนเต็ม 10 หรือน้อยกว่า

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

10 เมืองยอดนิยมในสหรัฐอเมริกาตามจำนวนการดูทั้งหมด

ข้อความค้นหานี้จะดึงรายชื่อเมือง 10 แห่งในสหรัฐฯ ที่มียอดดูเนื้อหาของช่องมากที่สุดในช่วงวันที่ที่ระบุ คุณแก้ไขการค้นหาเพื่อขอข้อมูลสำหรับประเทศอื่นได้โดยเลือกค่าอื่นที่ถูกต้องให้กับตัวกรองนั้น ในทำนองเดียวกัน คุณสามารถเปลี่ยนแปลงข้อความค้นหาให้ดึงข้อมูลสำหรับอนุทวีป เช่น ยุโรปตะวันตก หรือเอเชียตะวันออกเฉียงใต้ โดยใช้ตัวกรอง subContinent และหนึ่งในค่าที่ถูกต้อง ตัวกรองอื่นๆ ก็สามารถใช้ได้เช่นกัน ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

เมือง 10 อันดับแรกของสหรัฐฯ ตามจำนวนการดูทั้งหมดสำหรับเนื้อหาแต่ละประเภท

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

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

10 เมืองยอดนิยมในสหรัฐอเมริกาตามเวลาในการรับชมทั้งหมด

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

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

10 อันดับแรก – วิดีโอที่มีคนดูมากที่สุดในยุโรป

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

หมายเหตุ: รายงานนี้กำหนดให้คุณต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort และตั้งค่าพารามิเตอร์ maxResults เป็นค่าที่เป็นจำนวนเต็ม 10 หรือน้อยกว่า

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

รายงานเพลย์ลิสต์

เมตริกเวลาในการรับชมตามประเทศสำหรับเพลย์ลิสต์ของช่อง

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

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

10 อันดับแรก - เพลย์ลิสต์ที่เริ่มเล่นมากที่สุดในสหรัฐอเมริกา

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

หมายเหตุ: เนื่องจากรายงานนี้ใช้มิติข้อมูล playlist คุณจึงต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort และตั้งค่าพารามิเตอร์ maxResults เป็นค่าจำนวนเต็ม 10 หรือน้อยกว่า

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

รายงานวิดีโอ

จำนวนการดูและเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกัน

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

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกัน

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

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

10 อันดับแรก - เว็บไซต์ของบุคคลที่สามที่สร้างยอดดูสูงสุดสำหรับวิดีโอแบบฝัง

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

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

รายงานเพลย์ลิสต์

ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกัน

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

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

ยอดดูเพลย์ลิสต์รายวันและเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกัน

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

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

รายงานวิดีโอ

การชอบและไม่ชอบตามประเภทเนื้อหา

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

dimensions=creatorContentType
metrics=likes,dislikes

รายงานวิดีโอ

ยอดดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศ

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

ยอดดูรายวันและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

10 อันดับยอดนิยม – ข้อความค้นหาใน YouTube ที่สร้างการเข้าชมสูงสุดสำหรับวิดีโอ

คำค้นหานี้จะดึงข้อความค้นหา 10 ข้อความที่ทำให้เกิดการดูมากที่สุดจากผลการค้นหาของ YouTube สำหรับวิดีโอที่เฉพาะเจาะจงอย่างน้อย 1 รายการ ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID ในค่าพารามิเตอร์ filters ด้วยรายการที่คั่นด้วยคอมมาของรหัสวิดีโอสูงสุด 500 รายการ

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

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

10 อันดับยอดนิยม – เว็บไซต์ภายนอกที่สร้างการเข้าชมสูงสุดสำหรับวิดีโอ

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

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

รายงานเพลย์ลิสต์

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

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

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

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

รายงานวิดีโอ

เมตริกประเภทอุปกรณ์รายวันสำหรับระบบปฏิบัติการ Android

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

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

เมตริกระบบปฏิบัติการรายวันสำหรับอุปกรณ์เคลื่อนที่

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

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

เมตริกระบบปฏิบัติการและประเภทอุปกรณ์รายวัน

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

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

รายงานเพลย์ลิสต์

เมตริกประเภทอุปกรณ์รายวันสำหรับยอดดูเพลย์ลิสต์บนระบบปฏิบัติการ Android

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

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

เมตริกระบบปฏิบัติการรายวันสำหรับยอดดูเพลย์ลิสต์บนอุปกรณ์เคลื่อนที่

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

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

รายงานวิดีโอ

ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

รายงานเพลย์ลิสต์

ข้อมูลประชากรของผู้ชมเพลย์ลิสต์ในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

เมตริกการแชร์ ซึ่งรวบรวมตามบริการที่มีการแชร์วิดีโอ

คำขอนี้เรียกข้อมูลจำนวนครั้งที่ผู้ใช้ใช้ปุ่ม Share เพื่อแชร์วิดีโอของช่อง ผลลัพธ์จะรวบรวมโดยบริการแชร์ (Google+, Twitter ฯลฯ) และจัดเรียงตามจำนวนครั้งที่แชร์จากมากไปน้อย

dimensions=sharingService
metrics=shares
sort=-shares

เมตริกการคงผู้ชมไว้สำหรับวิดีโอ

รายงานนี้วัดความสามารถของวิดีโอในการรักษาผู้ชมไว้ คุณจะเรียกดูรายงานของวิดีโอได้ทีละ 1 รายการเท่านั้น โปรดทราบว่าในการเรียกใช้คำค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID ในค่าพารามิเตอร์ filters ด้วยรหัสวิดีโอของวิดีโอที่คุณอัปโหลด โปรดทราบว่ารายงานการคงผู้ชมไว้ไม่รองรับความสามารถในการระบุค่าหลายค่าสำหรับตัวกรอง video

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

โปรดทราบว่าข้อมูลสำหรับตัวกรอง audienceType จะพร้อมใช้งานตั้งแต่วันที่ 25 กันยายน 2013 API จะไม่แสดงข้อมูลสำหรับการค้นหาที่ใช้ตัวกรองเพื่อพยายามเรียกข้อมูลจากวันก่อนหน้า การค้นหาที่ไม่ใช้ตัวกรองจะทำงานหลังจากวันที่ 1 กรกฎาคม 2008

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

เมตริกรายได้และประสิทธิภาพของโฆษณาของช่อง

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

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

เมตริกรายได้และประสิทธิภาพโฆษณารายวัน

คำขอนี้จะดึงข้อมูลรายได้รายวันและเมตริกประสิทธิภาพโฆษณาของช่อง

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

เมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศ

คำขอนี้จะดึงข้อมูลเมตริกรายได้และเมตริกประสิทธิภาพโฆษณาเฉพาะประเทศของช่อง ผลลัพธ์จะจัดเรียงตามปริมาณรายได้จากมากไปน้อย ซึ่งหมายความว่าประเทศแรกที่พาร์ทเนอร์มีรายได้สุทธิมากที่สุดจะเป็นประเทศแรกที่ปรากฏ

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

10 อันดับแรก – วิดีโอที่มีรายได้สูงสุด

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

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

เมตริกประสิทธิภาพโฆษณาสำหรับโฆษณาประเภทต่างๆ

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

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

รายงานวิดีโอ

เมตริกเวลาในการรับชมรายวันสำหรับเนื้อหาที่อัปโหลดด้วยตนเอง

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

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

เมตริกคำอธิบายประกอบสำหรับเนื้อหาที่อ้างสิทธิ์

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

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

รายงานเพลย์ลิสต์

ยอดดูเพลย์ลิสต์รายวันของเจ้าของเนื้อหา

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

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

รายงานวิดีโอ

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

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

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

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

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

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

เมตริกเฉพาะจังหวัดสำหรับรัฐในสหรัฐฯ และวอชิงตัน ดี.ซี.

คำขอนี้เรียกรายละเอียดของยอดดู จำนวนนาทีที่ดูโดยประมาณ และระยะเวลาการดูเฉลี่ยของวิดีโอที่เจ้าของเนื้อหาอ้างสิทธิ์แยกตามจังหวัด ข้อมูลนี้ครอบคลุมรัฐในสหรัฐฯ และวอชิงตัน ดี.ซี. โดยผลลัพธ์จะจัดเรียงตามตัวอักษรของจังหวัดต่างๆ รหัส ISO 3166-2

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

10 เมืองยอดนิยมในสหรัฐอเมริกาตามจำนวนการดูทั้งหมด

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

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

เมือง 10 อันดับแรกของสหรัฐฯ ตามจำนวนการดูทั้งหมดสำหรับเนื้อหาแต่ละประเภท

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

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

10 เมืองยอดนิยมในสหรัฐอเมริกาตามเวลาในการรับชมทั้งหมด

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

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

10 อันดับแรก – วิดีโอที่มีการรับชมมากที่สุดในยุโรป

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

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

รายงานเพลย์ลิสต์

เมตริกเวลาในการรับชมเฉพาะประเทศสำหรับเพลย์ลิสต์ของเจ้าของเนื้อหา

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

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

10 อันดับแรก - เพลย์ลิสต์ที่เริ่มเล่นมากที่สุดในสหรัฐอเมริกา

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

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

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

รายงานวิดีโอ

การชอบและไม่ชอบตามประเภทเนื้อหา

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

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

รายงานวิดีโอ

จำนวนการดูและเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกัน

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

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกัน

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

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

10 อันดับแรก - เว็บไซต์ของบุคคลที่สามที่สร้างยอดดูสูงสุดสำหรับวิดีโอแบบฝัง

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

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

รายงานเพลย์ลิสต์

ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกัน

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

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกัน

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

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

รายงานวิดีโอ

ยอดดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

ยอดดูรายวันและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

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

10 อันดับยอดนิยม – ข้อความค้นหาใน YouTube ที่สร้างการเข้าชมสูงสุดสำหรับวิดีโอ

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

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

10 อันดับยอดนิยม – เว็บไซต์ภายนอกที่สร้างการเข้าชมสูงสุดสำหรับวิดีโอ

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

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

รายงานเพลย์ลิสต์

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

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

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

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

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

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

รายงานวิดีโอ

เมตริกประเภทอุปกรณ์รายวันสำหรับวิดีโอที่อ้างสิทธิ์

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

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

เมตริกระบบปฏิบัติการรายวันสำหรับวิดีโอที่อ้างสิทธิ์ซึ่งดูในอุปกรณ์เคลื่อนที่

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

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

เมตริกระบบปฏิบัติการและประเภทอุปกรณ์รายวัน

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

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

รายงานเพลย์ลิสต์

เมตริกประเภทอุปกรณ์สำหรับการดูเพลย์ลิสต์บนระบบปฏิบัติการ Android

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

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

เมตริกระบบปฏิบัติการสำหรับการดูเพลย์ลิสต์บนอุปกรณ์เคลื่อนที่

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

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

รายงานวิดีโอ

ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

เมตริกการแชร์ ซึ่งรวบรวมตามบริการที่มีการแชร์วิดีโอ

คำขอนี้เรียกข้อมูลจำนวนครั้งที่ผู้ใช้ใช้ปุ่ม Share เพื่อแชร์วิดีโอที่เจ้าของเนื้อหาอัปโหลด ผลลัพธ์จะรวบรวมโดยบริการแชร์ (Google+, Twitter ฯลฯ) และจัดเรียงตามจำนวนครั้งที่แชร์จากมากไปน้อย

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

เมตริกการคงผู้ชมไว้สำหรับวิดีโอ

รายงานนี้วัดความสามารถของวิดีโอในการรักษาผู้ชมไว้ คุณจะเรียกดูรายงานของวิดีโอได้ทีละ 1 รายการเท่านั้น โปรดทราบว่าในการเรียกใช้คำค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID ในค่าพารามิเตอร์ filters ด้วยรหัสวิดีโอของวิดีโอที่คุณอัปโหลด โปรดทราบว่ารายงานการคงผู้ชมไว้ไม่รองรับความสามารถในการระบุค่าหลายค่าสำหรับตัวกรอง video

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

โปรดทราบว่าข้อมูลสำหรับตัวกรอง audienceType จะพร้อมใช้งานตั้งแต่วันที่ 25 กันยายน 2013 API จะไม่แสดงข้อมูลสำหรับการค้นหาที่ใช้ตัวกรองเพื่อพยายามเรียกข้อมูลจากวันก่อนหน้า การค้นหาที่ไม่ใช้ตัวกรองจะทำงานหลังจากวันที่ 1 กรกฎาคม 2008

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

เมตริกรายได้และประสิทธิภาพโฆษณาสำหรับเนื้อหาที่มีการอ้างสิทธิ์

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

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

เมตริกรายได้และประสิทธิภาพโฆษณารายวัน

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

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

เมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศ

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

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

10 อันดับแรก – วิดีโอที่มีรายได้สูงสุด

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

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

เมตริกประสิทธิภาพโฆษณาสำหรับโฆษณาประเภทต่างๆ

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

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType