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

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

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

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

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

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

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

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

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 คุณต้องแทนที่สตริง CHANNEL_ID ในค่าพารามิเตอร์ filters ด้วยรายการรหัสช่องสูงสุด 500 รายการที่คั่นด้วยคอมมาสำหรับช่องของคุณ

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

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

การค้นหานี้จะดึงข้อมูลยอดดูรายวันและเวลาในการรับชมโดยประมาณในสหรัฐอเมริกาสำหรับวิดีโอที่อัปโหลดไปยังช่องหรือกลุ่มช่องหนึ่งๆ ระบบจะจัดกลุ่มผลลัพธ์ตามวันสำหรับหน้าเว็บหรือแอปพลิเคชันแต่ละประเภทที่มีการเล่นวิดีโอ ผลลัพธ์จะจัดเรียงตามลำดับเวลาย้อนกลับ โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ในเครื่องมือสํารวจ API คุณต้องแทนที่สตริง 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 ฉบับถัดไปจะรองรับแหล่งที่มาของการเข้าชมที่เฉพาะเจาะจงเท่านั้น แหล่งที่มาของการเข้าชม VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES และ NO_LINK_EMBEDDED เป็นบางแหล่งที่ไม่รองรับ

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

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

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

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

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

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

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

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

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

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

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