หน้านี้แสดงตัวอย่างคําขอ API ของ YouTube Analytics ตัวอย่างแต่ละรายการอธิบายรายงานที่ดึงมาคร่าวๆ แล้วแสดงค่าพารามิเตอร์ dimensions
, metrics
, filters
และ sort
ที่เกี่ยวข้อง (เอกสารรายงานช่องและรายงานเจ้าของเนื้อหาจะระบุรายงานที่ API รองรับ)
ตัวอย่างแต่ละรายการจะลิงก์และเติมข้อมูลใน Google APIs Explorer ด้วยค่าที่แสดง ตัวอย่างนี้ยังใช้วันที่เริ่มต้นและวันที่สิ้นสุด (YYYY-MM-DD
) เป็น 2022-01-01
และ 2022-06-30
ด้วย
หลังจากลิงก์กับ API Explorer แล้ว คุณยังต้องระบุช่องหรือเจ้าของเนื้อหาที่จะเรียกดูรายงาน API Explorer จะป้อนข้อมูลค่าพารามิเตอร์ ids
ด้วย channel==MINE
หรือ contentOwner==CONTENT_OWNER_ID
ทั้งนี้ขึ้นอยู่กับคําค้นหาที่คุณคลิก สําหรับรายงานช่องทาง คุณสามารถเปลี่ยน MINE
เป็นรหัสช่องของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ สําหรับรายงานเจ้าของเนื้อหา คุณต้องแทนที่ CONTENT_OWNER_ID
ด้วยรหัสเจ้าของเนื้อหา
และคุณยังต้องได้รับการตรวจสอบสิทธิ์ในฐานะช่องหรือเจ้าของเนื้อหาที่ระบุด้วย โปรแกรมสํารวจ API จะให้สิทธิ์คําขอ API ของคุณโดยใช้ OAuth 2.0 ได้
การจัดเรียงคําขอตามมิติข้อมูล/เมตริกหลายรายการ
API รองรับความสามารถในการจัดเรียงข้อมูลการตอบกลับโดยใช้มิติข้อมูลหรือเมตริกหลายรายการ ตัวอย่างเช่น คําขอด้านล่างจะดึงข้อมูลแหล่งที่มาของการเข้าชมรายวันสําหรับวิดีโอที่เฉพาะเจาะจงของช่อง แต่ละแถวในชุดผลลัพธ์จะระบุยอดดูและเวลาในการรับชมโดยประมาณที่มาจากแหล่งที่มาของการเข้าชมบางประเภท (เช่น EXT_URL
) ในวันหนึ่งๆ
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
ในการตอบกลับ ผลการค้นหาจะจัดเรียงตามลําดับเวลา ภายในชุดผลลัพธ์ของแต่ละวัน ระบบจะจัดเรียงผลลัพธ์ตามลําดับจากมากไปน้อย ดังนั้น แถวแรกในชุดผลลัพธ์จึงมีข้อมูลสําหรับแหล่งที่มาของการเข้าชมที่มียอดดูมากที่สุดในช่วงวันที่แรกในช่วงวันที่ที่ขอ แถวที่สองมีข้อมูลสําหรับแหล่งที่มาของการเข้าชมที่ทําให้เกิดยอดดูสูงสุดในวันแรก
รายงานช่อง
รายงานวิดีโอ
ยอดดูทั้งหมด เวลาในการรับชมโดยประมาณ และอื่นๆ สําหรับช่อง
คําค้นหานี้จะดึงเมตริกรวมสําหรับเนื้อหาของช่อง รายงานจะแสดงข้อมูล 1 แถวที่มียอดรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
ยอดดูเฉพาะประเทศ (และอีกมากมาย) สําหรับช่อง
คําค้นหานี้จะดึงเมตริกสําหรับประเทศสําหรับวิดีโอของวิดีโอ รายงานจะแสดงข้อมูล 1 แถวที่มียอดรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
10 อันดับยอดนิยม - วิดีโอที่มีคนดูมากที่สุดสําหรับช่อง
คําค้นหานี้จะดึงวิดีโอที่มีการรับชมสูงสุด 10 รายการของช่องตามที่วัดตามจํานวนนาทีที่ดูโดยประมาณในช่วงวันที่ที่ระบุ ผลลัพธ์จะจัดเรียงตามนาทีที่ดูโดยประมาณจากมากไปน้อย
หมายเหตุ: คุณต้องระบุรายงานนี้สําหรับพารามิเตอร์คําขอ sort
และต้องกําหนดค่าพารามิเตอร์ maxResults
เป็นค่าที่เป็นจํานวนเต็มไม่เกิน 10
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
10 อันดับยอดนิยม - อัตราการคลิกผ่านคําอธิบายประกอบสําหรับวิดีโอที่มียอดดูสูงสุดของช่อง
คําขอนี้จะเรียกยอดดู อัตราการคลิกผ่านของคําอธิบายประกอบ อัตราการปิดคําอธิบายประกอบ และการแสดงผลคําอธิบายประกอบสําหรับวิดีโอ 10 รายการที่มีคนดูมากที่สุดของช่อง ผลลัพธ์จะจัดเรียงตามจํานวนการดูจากมากไปน้อย ซึ่งหมายความว่าวิดีโอที่มีคนดูมากที่สุดจะแสดงก่อน
หมายเหตุ: คุณต้องระบุรายงานนี้สําหรับพารามิเตอร์คําขอ sort
และต้องกําหนดค่าพารามิเตอร์ maxResults
เป็นค่าที่เป็นจํานวนเต็มไม่เกิน 10
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
รายงานเพลย์ลิสต์
ยอดดูเพลย์ลิสต์ทั้งหมดของช่อง
คําขอนี้จะเรียกการเริ่มต้นเพลย์ลิสต์ทั้งหมด, จํานวนนาทีที่ดูโดยประมาณ, ยอดดู และยอดดูต่อเพลย์ลิสต์ที่เริ่มต้นจากเพลย์ลิสต์ในช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว เมตริก views
จะนับเฉพาะยอดดูวิดีโอที่เกิดขึ้นในบริบทของเพลย์ลิสต์เท่านั้น
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1
สถิติสําหรับเพลย์ลิสต์ที่เฉพาะเจาะจง
คําขอนี้จะเรียกการเริ่มต้นเพลย์ลิสต์ทั้งหมด, จํานวนนาทีที่ดูโดยประมาณ, ยอดดู และยอดดูต่อเพลย์ลิสต์ที่เริ่มต้นจากเพลย์ลิสต์นั้นๆ เมตริก views
จะนับเฉพาะยอดดูวิดีโอที่เกิดขึ้นในบริบทของเพลย์ลิสต์เท่านั้น โปรดทราบว่าเมื่อเรียกใช้คําค้นหานี้ใน APIs Explorer คุณต้องแทนที่สตริง PLAYLIST_ID
ในค่าพารามิเตอร์ filters
ด้วยรหัสเพลย์ลิสต์สําหรับเพลย์ลิสต์ในช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1;playlist==PLAYLIST_ID
หากต้องการเรียกข้อมูลสถิติรวมสําหรับเพลย์ลิสต์หลายรายการ คุณยังแทนที่สตริง PLAYLIST_ID
ด้วยรายการรหัสเพลย์ลิสต์ที่คั่นด้วยคอมมาได้สูงสุด 500 รายการสําหรับเพลย์ลิสต์ในช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วด้วย
10 อันดับยอดนิยม - เพลย์ลิสต์ที่มีคนดูมากที่สุดสําหรับช่อง
การค้นหานี้จะดึงเพลย์ลิสต์ที่มีคนดูมากที่สุด 10 รายการของช่อง ตามที่วัดโดยจํานวนนาทีที่ดูโดยประมาณในช่วงวันที่ที่ระบุ นอกจากนี้ ยังเรียกเมตริกเพลย์ลิสต์อื่นๆ อีกหลายรายการ เช่น จํานวนครั้งที่ผู้ชมเริ่มเล่นเพลย์ลิสต์แต่ละรายการและระยะเวลาเฉลี่ยที่ผู้ชมดูวิดีโอในเพลย์ลิสต์หลังจากเริ่มเล่น ผลลัพธ์จะจัดเรียงตามนาทีที่ดูโดยประมาณจากมากไปน้อย
หมายเหตุ: เนื่องจากรายงานนี้ใช้มิติข้อมูล playlist
คุณจึงต้องระบุค่าสําหรับพารามิเตอร์คําขอ sort
และจะตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจํานวนเต็มที่ 10
ด้วย
dimensions=playlist metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist filters=isCurated==1 maxResults=10 sort=-estimatedMinutesWatched
รายงานวิดีโอ
เมตริกเวลาในการรับชมรายวันสําหรับวิดีโอของช่อง
คําค้นหานี้จะดึงยอดดูรายวัน เมตริกเวลาในการรับชม และจํานวนผู้ติดตามใหม่สําหรับวิดีโอของช่อง รายงานจะแสดงข้อมูล 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,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1 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 เมืองที่ครอบคลุมยอดดูเนื้อหาของช่องมากที่สุดในช่วงวันที่ที่ระบุ ระบบอาจแก้ไขการค้นหาเพื่อขอข้อมูลสําหรับประเทศอื่นโดยเลือกค่าอื่นที่ถูกต้องสําหรับตัวกรองนั้น ในทํานองเดียวกัน ระบบอาจแก้ไขการค้นหาเพื่อเรียกข้อมูลสําหรับอนุทวีป เช่น ยุโรปตะวันตกหรือเอเชียตะวันออกเฉียงใต้โดยใช้ตัวกรองย่อยย่อยและค่าใดค่าหนึ่งที่ถูกต้อง ระบบรองรับตัวกรองอื่นๆ ด้วย ผลลัพธ์จะจัดเรียงตามจํานวนการดูจากมากไปน้อย
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 filters=isCurated==1 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 filters=isCurated==1 sort=-playlistStarts
ยอดดูเพลย์ลิสต์รายวันและเวลาในการรับชมจากตําแหน่งที่เล่นต่างๆ
การค้นหานี้จะเรียกข้อมูลเพลย์ลิสต์รายวัน ยอดดู และเวลาในการรับชมโดยประมาณในสหรัฐอเมริกาสําหรับเพลย์ลิสต์ของช่องนั้นๆ ผลการค้นหาจะจัดกลุ่มตามวันของหน้าหรือแอปพลิเคชันแต่ละประเภทที่มีการดูเพลย์ลิสต์เกิดขึ้น ผลการค้นหาจะจัดเรียงตามลําดับเวลา
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,views,estimatedMinutesWatched filters=isCurated==1;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,playlistStarts,estimatedMinutesWatched filters=isCurated==1;country==US
ยอดดูเพลย์ลิสต์รายวันและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
คําขอนี้จะเรียกยอดดูเพลย์ลิสต์รายวัน การเริ่มเพลย์ลิสต์ และเวลาในการรับชมโดยประมาณสําหรับการดูเพลย์ลิสต์ ระบบรวบรวมเมตริกแบบรายวันตามแหล่งที่มาของการเข้าชมและจัดเรียงตามลําดับเวลา
dimensions=day,insightTrafficSourceType metrics=views,playlistStarts,estimatedMinutesWatched filters=isCurated==1 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 filters=isCurated==1;operatingSystem==ANDROID sort=day
เมตริกระบบปฏิบัติการรายวันสําหรับการดูเพลย์ลิสต์บนอุปกรณ์เคลื่อนที่
การค้นหานี้จะดึงยอดดูเพลย์ลิสต์รายวันและเวลาในการรับชมโดยประมาณบนอุปกรณ์เคลื่อนที่สําหรับเพลย์ลิสต์ของช่องหนึ่งๆ ผลลัพธ์จะจัดกลุ่มตามวันของระบบปฏิบัติการแต่ละชนิดที่มีการดูเพลย์ลิสต์เกิดขึ้น ผลการค้นหาจะจัดเรียงตามลําดับเวลา
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=isCurated==1;deviceType==MOBILE sort=day
รายงานวิดีโอ
ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
รายงานนี้ดึงข้อมูลสถิติเกี่ยวกับกลุ่มอายุและเพศของผู้ชมในแคลิฟอร์เนียที่ดูวิดีโอของช่อง ผลลัพธ์จะจัดเรียงตามเพศ แล้วจัดเรียงตามกลุ่มอายุ ระบบอาจแก้ไขการค้นหานี้เพื่อดึงสถิติเดียวกันสําหรับผู้ชมทั่วโลกหรือผู้ชมทั้งหมดในประเทศ ทวีป อนุทวีป หรือรัฐอื่นๆ ของสหรัฐฯ ด้วยการปรับค่าพารามิเตอร์ filters
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
รายงานเพลย์ลิสต์
ข้อมูลประชากรของผู้ชมเพลย์ลิสต์ในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
รายงานนี้ดึงข้อมูลสถิติเกี่ยวกับกลุ่มอายุและเพศของผู้ชมในแคลิฟอร์เนียที่ดูเพลย์ลิสต์ของช่อง ผลลัพธ์จะจัดเรียงตามเพศ แล้วจัดเรียงตามกลุ่มอายุ ระบบอาจแก้ไขการค้นหานี้เพื่อดึงสถิติเดียวกันสําหรับผู้ชมทั่วโลกหรือผู้ชมทั้งหมดในประเทศ ทวีป อนุทวีป หรือรัฐอื่นๆ ของสหรัฐฯ ด้วยการปรับค่าพารามิเตอร์ filters
dimensions=ageGroup,gender metrics=viewerPercentage filters=isCurated==1;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
เมตริกรายได้ของช่องและประสิทธิภาพของโฆษณา
คําขอนี้จะเรียกเมตริกรายได้และประสิทธิภาพของโฆษณาของช่อง รายงานจะแสดงข้อมูล 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 แถวที่มียอดรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
จํานวนยอดดูแบบเจาะจงประเทศ (และอื่นๆ) สําหรับวิดีโอทั้งหมดที่อัปโหลดด้วยตนเอง
คําค้นหานี้จะดึงเมตริกสําหรับประเทศเฉพาะสําหรับวิดีโอที่เจ้าของเนื้อหาอัปโหลด รายงานจะแสดงข้อมูล 1 แถวที่มียอดรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
จํานวนการดูทั้งหมด (และอื่นๆ) สําหรับเนื้อหาของบุคคลที่สามที่มีการอ้างสิทธิ์ทั้งหมด
คําค้นหานี้จะดึงเมตริกรวมสําหรับวิดีโอที่เจ้าของเนื้อหาอ้างสิทธิ์แต่ไม่ได้อัปโหลด รายงานจะแสดงข้อมูล 1 แถวที่มียอดรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
ยอดดูทั้งหมด (และอื่นๆ) สําหรับเนื้อหาที่อัปโหลดด้วยตนเองทั้งหมด
คําค้นหานี้จะดึงเมตริกรวมสําหรับวิดีโอที่เจ้าของเนื้อหาอัปโหลด รายงานจะแสดงข้อมูล 1 แถวที่มียอดรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
จํานวนยอดดูทั้งหมด (และอื่นๆ) สําหรับเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดด้วยตนเองทั้งหมด
คําค้นหานี้จะดึงข้อมูลเมตริกรวมสําหรับวิดีโอที่เจ้าของเนื้อหาอัปโหลดและอ้างสิทธิ์ด้วย รายงานจะแสดงข้อมูล 1 แถวที่มียอดรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
10 อันดับยอดนิยม – วิดีโอที่มียอดดูมากที่สุดสําหรับเจ้าของเนื้อหา
คําค้นหานี้จะดึงวิดีโอที่มีคนดูมากที่สุด 10 รายการตามที่วัดโดยจํานวนการดูในช่วงวันที่ที่ระบุซึ่งเจ้าของเนื้อหาได้อัปโหลดไว้ ผลลัพธ์จะจัดเรียงตามจํานวนการดูจากมากไปน้อย
dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views
10 อันดับยอดนิยม - วิดีโอที่มีคนดูมากที่สุดสําหรับเจ้าของเนื้อหา
คําค้นหานี้จะดึงวิดีโอที่มีคนดูมากที่สุด 10 รายการตามที่วัดโดยจํานวนนาทีที่ดูโดยประมาณในช่วงวันที่ที่ระบุซึ่งเจ้าของเนื้อหาได้อัปโหลดไว้ ผลลัพธ์จะจัดเรียงตามนาทีที่ดูโดยประมาณจากมากไปน้อย
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
10 อันดับแรก – วิดีโอที่มีคนดูมากที่สุดสําหรับช่องของเจ้าของเนื้อหา
คําค้นหานี้จะดึงวิดีโอที่มีคนดูมากที่สุด 10 รายการสําหรับช่องหรือช่องที่เจ้าของเนื้อหาจัดการ ผลลัพธ์จะจัดเรียงตามจํานวนการดูจากมากไปน้อย โปรดทราบว่าหากต้องการเรียกใช้คําค้นหานี้ใน APIs Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการรหัสช่องที่คั่นด้วยคอมมาได้สูงสุด 500 รายการในช่องของคุณ
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
10 อันดับยอดนิยม - อัตราการคลิกผ่านคําอธิบายประกอบสําหรับวิดีโอที่มียอดดูสูงสุดของช่อง
คําขอนี้จะเรียกยอดดู อัตราการคลิกผ่านของคําอธิบายประกอบ อัตราการปิดคําอธิบายประกอบ และการแสดงผลคําอธิบายประกอบสําหรับวิดีโอ 10 รายการที่มีคนดูมากที่สุดในช่องหรือกลุ่มช่องที่ระบุ ผลลัพธ์จะจัดเรียงตามจํานวนการดูจากมากไปน้อย ซึ่งหมายความว่าวิดีโอที่มีคนดูมากที่สุดจะแสดงก่อน โปรดทราบว่าหากต้องการเรียกใช้คําค้นหานี้ใน APIs Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการรหัสช่องที่คั่นด้วยคอมมาได้สูงสุด 500 รายการในช่องของคุณ
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
รายงานเพลย์ลิสต์
ยอดดูเพลย์ลิสต์สําหรับช่องของเจ้าของเนื้อหา
คําขอนี้จะเรียกการเริ่มต้นเพลย์ลิสต์ทั้งหมด, จํานวนนาทีที่ดูโดยประมาณ, ยอดดู และยอดดูต่อเพลย์ลิสต์ที่เริ่มต้นจากเพลย์ลิสต์ในช่องของเจ้าของเนื้อหา เมตริก views
จะนับเฉพาะยอดดูวิดีโอที่เกิดขึ้นในบริบทของเพลย์ลิสต์เท่านั้น
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1
ยอดดูเพลย์ลิสต์ของช่องใดช่องหนึ่ง
คําขอนี้จะเรียกการเริ่มต้นเพลย์ลิสต์ทั้งหมด, จํานวนนาทีที่ดูโดยประมาณ, ยอดดู และยอดดูต่อเพลย์ลิสต์ที่เริ่มต้นจากเพลย์ลิสต์ในช่องของเจ้าของเนื้อหา เมตริก views
จะนับเฉพาะยอดดูวิดีโอที่เกิดขึ้นในบริบทของเพลย์ลิสต์เท่านั้น โปรดทราบว่าหากต้องการเรียกใช้คําค้นหานี้ใน APIs Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการรหัสช่องที่คั่นด้วยคอมมาได้สูงสุด 500 รายการในช่องของคุณ
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1;channel==CHANNEL_ID
สถิติสําหรับเพลย์ลิสต์
คําขอนี้จะเรียกการเริ่มต้นเพลย์ลิสต์ทั้งหมด, จํานวนนาทีที่ดูโดยประมาณ, ยอดดู และยอดดูต่อเพลย์ลิสต์ที่เริ่มต้นจากเพลย์ลิสต์นั้นๆ เมตริก views
จะนับเฉพาะยอดดูวิดีโอที่เกิดขึ้นในบริบทของเพลย์ลิสต์เท่านั้น โปรดทราบว่าเมื่อเรียกใช้คําค้นหานี้ในโปรแกรมสํารวจ API คุณต้องแทนที่สตริง PLAYLIST_ID
ในค่าพารามิเตอร์ filters
ด้วยรหัสเพลย์ลิสต์ของเพลย์ลิสต์ในช่องของเจ้าของเนื้อหา
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1;playlist==PLAYLIST_ID
หากต้องการเรียกข้อมูลสถิติรวมสําหรับเพลย์ลิสต์หลายรายการ คุณยังแทนที่สตริง PLAYLIST_ID
ด้วยรายการรหัสเพลย์ลิสต์ที่คั่นด้วยคอมมาได้สูงสุด 500 รายการสําหรับเพลย์ลิสต์ในช่องของเจ้าของเนื้อหาอีกด้วย
10 อันดับยอดนิยม - เพลย์ลิสต์ที่มีคนดูมากที่สุดสําหรับเจ้าของเนื้อหา
การค้นหานี้จะดึงเพลย์ลิสต์ที่มีคนดูมากที่สุด 10 รายการมากที่สุดซึ่งวัดโดยจํานวนนาทีที่ดูโดยประมาณในช่วงวันที่ที่ระบุ นอกจากนี้ ยังเรียกเมตริกเพลย์ลิสต์อื่นๆ อีกหลายรายการ เช่น จํานวนครั้งที่ผู้ชมเริ่มเล่นเพลย์ลิสต์แต่ละรายการและระยะเวลาเฉลี่ยที่ผู้ชมดูวิดีโอในเพลย์ลิสต์หลังจากเริ่มเล่น ผลลัพธ์จะจัดเรียงตามนาทีที่ดูโดยประมาณจากมากไปน้อย
หมายเหตุ: เนื่องจากรายงานนี้ใช้มิติข้อมูล playlist
คุณจึงต้องระบุค่าสําหรับพารามิเตอร์คําขอ sort
และจะตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจํานวนเต็มที่ 10
ด้วย
dimensions=playlist metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist filters=isCurated==1 maxResults=10 sort=-estimatedMinutesWatched
รายงานวิดีโอ
เมตริกเวลาในการรับชมรายวันของเนื้อหาที่อัปโหลดด้วยตนเอง
คําค้นหานี้จะดึงข้อมูลเมตริกเวลาในการรับชมรายวัน รวมไปถึงยอดดู จํานวนการเล่นวิดีโอที่สร้างรายได้ และจํานวนการแสดงผลของวิดีโอซึ่งเจ้าของเนื้อหาอัปโหลด รายงานจะแสดงข้อมูล 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
รายงานเพลย์ลิสต์
ยอดดูเพลย์ลิสต์รายวันสําหรับเจ้าของเนื้อหา
คําขอนี้จะเรียกยอดดูรายวัน การเริ่มเพลย์ลิสต์ จํานวนนาทีที่ดูโดยประมาณ และยอดดูต่อเพลย์ลิสต์ที่เริ่มสําหรับเพลย์ลิสต์ทั้งหมดในช่องของเจ้าของเนื้อหา ผลการค้นหาจะจัดเรียงตามลําดับเวลา
dimensions=day metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1 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=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist filters=isCurated==1 sort=-estimatedMinutesWatched
10 อันดับยอดนิยม - เพลย์ลิสต์ที่เริ่มต้นมากที่สุดในสหรัฐอเมริกา
คําค้นหานี้จะดึงเพลย์ลิสต์ 10 รายการมาจากช่องของเจ้าของเนื้อหาที่ผู้ชมในสหรัฐอเมริกาเริ่มดูบ่อยที่สุดในช่วงวันที่ที่ระบุ ผลลัพธ์จะจัดเรียงตามจํานวนเพลย์ลิสต์ที่เรียงจากมากไปน้อย
หมายเหตุ: เนื่องจากรายงานนี้ใช้มิติข้อมูล playlist
คุณจึงต้องระบุค่าสําหรับพารามิเตอร์คําขอ sort
และจะตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจํานวนเต็มที่ 10
ด้วย
dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts
รายงานวิดีโอ
การกดชอบและไม่ชอบตามประเภทเนื้อหา
คําค้นหานี้จะรวบรวมข้อมูลจํานวนการกดชอบและไม่ชอบของเนื้อหาแต่ละประเภทในช่องหรือกลุ่มช่องที่เฉพาะเจาะจง โปรดทราบว่าหากต้องการเรียกใช้คําค้นหานี้ใน APIs Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการรหัสช่องที่คั่นด้วยคอมมาได้สูงสุด 500 รายการในช่องของคุณ
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
รายงานวิดีโอ
ยอดดูและเวลาในการรับชมจากตําแหน่งที่เล่นต่างๆ
คําค้นหานี้จะดึงยอดดูและเวลาในการรับชมโดยประมาณของวิดีโอที่อัปโหลดไปยังช่องหรือกลุ่มช่องใดช่องหนึ่ง ผลลัพธ์จะได้รับการรวบรวมตามประเภทของหน้าเว็บหรือแอปพลิเคชันที่เกิดขึ้นในการเล่นวิดีโอ และผลลัพธ์จะเรียงลําดับจากมากไปหาน้อยตามจํานวนการดู โปรดทราบว่าหากต้องการเรียกใช้คําค้นหานี้ใน APIs Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการรหัสช่องที่คั่นด้วยคอมมาได้สูงสุด 500 รายการในช่องของคุณ
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
ยอดดูรายวันและเวลาในการรับชมจากตําแหน่งที่เล่นต่างๆ
การค้นหานี้จะดึงยอดดูรายวันและเวลาในการรับชมโดยประมาณในสหรัฐอเมริกาสําหรับวิดีโอที่อัปโหลดไปยังช่องหรือกลุ่มช่องใดช่องหนึ่ง ผลลัพธ์จะจัดกลุ่มตามวันของหน้าเว็บหรือแอปพลิเคชันแต่ละประเภทที่มีการเล่นวิดีโอเกิดขึ้น ผลลัพธ์จะจัดเรียงตามลําดับเวลาจากใหม่ไปหาเก่า โปรดทราบว่าหากต้องการเรียกใช้คําค้นหานี้ใน APIs 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=views,estimatedMinutesWatched,playlistStarts filters=isCurated==1 sort=-playlistStarts
ยอดดูเพลย์ลิสต์รายวันและเวลาในการรับชมจากตําแหน่งที่เล่นต่างๆ
การค้นหานี้จะเรียกข้อมูลเพลย์ลิสต์รายวัน ยอดดู และเวลาในการรับชมโดยประมาณในสหรัฐอเมริกาสําหรับเพลย์ลิสต์ทั้งหมดในช่องของเจ้าของเนื้อหา ผลการค้นหาจะจัดกลุ่มตามวันของหน้าหรือแอปพลิเคชันแต่ละประเภทที่มีการดูเพลย์ลิสต์เกิดขึ้น ผลการค้นหาจะจัดเรียงตามลําดับเวลา
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,views,estimatedMinutesWatched filters=isCurated==1;country==US sort=day
รายงานวิดีโอ
ยอดดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
คําขอนี้จะเรียกยอดดูและเวลาในการรับชมโดยประมาณสําหรับวิดีโอของเจ้าของเนื้อหา ระบบรวบรวมเมตริกตามแหล่งที่มาของการเข้าชม ซึ่งอธิบายวิธีที่ผู้ใช้เข้าถึงวิดีโอ
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=views,playlistStarts,estimatedMinutesWatched filters=isCurated==1;country==US
ยอดดูเพลย์ลิสต์รายวันและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
คําขอนี้จะเรียกยอดดูเพลย์ลิสต์รายวัน การเริ่มเพลย์ลิสต์ และเวลาในการรับชมโดยประมาณสําหรับเพลย์ลิสต์ในช่องของเจ้าของเนื้อหาอย่างน้อย 1 ช่อง ระบบรวบรวมเมตริกแบบรายวันตามแหล่งที่มาของการเข้าชมและจัดเรียงตามลําดับเวลา โปรดทราบว่าหากต้องการเรียกใช้คําค้นหานี้ใน APIs Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการรหัสช่องที่คั่นด้วยคอมมาได้สูงสุด 500 รายการในช่องของคุณ
dimensions=day,insightTrafficSourceType metrics=views,playlistStarts,estimatedMinutesWatched filters=isCurated==1;channel==CHANNEL_ID sort=day
รายงานวิดีโอ
เมตริกประเภทอุปกรณ์รายวันสําหรับวิดีโอที่อ้างสิทธิ์
การค้นหานี้จะดึงยอดดูรายวันและเวลาในการรับชมโดยประมาณตามประเภทอุปกรณ์สําหรับวิดีโอที่มีการอ้างสิทธิ์โดยเจ้าของเนื้อหารายใดรายหนึ่ง ผลลัพธ์จะจัดกลุ่มตามวันของอุปกรณ์แต่ละประเภทที่เล่นวิดีโอ ผลการค้นหาจะจัดเรียงตามลําดับเวลา
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 ช่อง ผลการค้นหาจะจัดกลุ่มตามวันของอุปกรณ์แต่ละประเภทที่มีการดูเพลย์ลิสต์ ผลการค้นหาจะจัดเรียงตามลําดับเวลา โปรดทราบว่าหากต้องการเรียกใช้คําค้นหานี้ใน APIs Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการรหัสช่องที่คั่นด้วยคอมมาได้สูงสุด 500 รายการในช่องของคุณ
dimensions=day,deviceType metrics=views,estimatedMinutesWatched filters=isCurated==1;channel==CHANNEL_ID;operatingSystem==ANDROID sort=day
เมตริกระบบปฏิบัติการรายวันสําหรับการดูเพลย์ลิสต์บนอุปกรณ์เคลื่อนที่
การค้นหานี้จะดึงยอดดูเพลย์ลิสต์รายวันและเวลาในการรับชมโดยประมาณบนอุปกรณ์เคลื่อนที่สําหรับเพลย์ลิสต์ในช่องของเจ้าของเนื้อหา ผลลัพธ์จะจัดกลุ่มตามวันของระบบปฏิบัติการแต่ละชนิดที่มีการดูเพลย์ลิสต์เกิดขึ้น ผลการค้นหาจะจัดเรียงตามลําดับเวลา
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=isCurated==1;deviceType==MOBILE sort=day
รายงานวิดีโอ
ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
รายงานนี้ดึงข้อมูลสถิติเกี่ยวกับกลุ่มอายุและเพศของผู้ชมในแคลิฟอร์เนียซึ่งดูเนื้อหาที่อ้างสิทธิ์โดยเจ้าของเนื้อหา ผลลัพธ์จะจัดเรียงตามเพศ แล้วจัดเรียงตามกลุ่มอายุ ระบบอาจแก้ไขการค้นหานี้เพื่อดึงสถิติเดียวกันสําหรับผู้ชมทั่วโลกหรือผู้ชมทั้งหมดในประเทศ ทวีป อนุทวีป หรือรัฐอื่นๆ ของสหรัฐฯ ด้วยการปรับค่าพารามิเตอร์ filters
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
รายงานเพลย์ลิสต์
ข้อมูลประชากรของผู้ชมเพลย์ลิสต์ในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
รายงานนี้ดึงข้อมูลสถิติเกี่ยวกับกลุ่มอายุและเพศของผู้ชมในแคลิฟอร์เนียที่ดูเพลย์ลิสต์ในช่องของเจ้าของเนื้อหา ผลลัพธ์จะจัดเรียงตามเพศ แล้วจัดเรียงตามกลุ่มอายุ ระบบอาจแก้ไขการค้นหานี้เพื่อดึงสถิติเดียวกันสําหรับผู้ชมทั่วโลกหรือผู้ชมทั้งหมดในประเทศ ทวีป อนุทวีป หรือรัฐอื่นๆ ของสหรัฐฯ ด้วยการปรับค่าพารามิเตอร์ filters
dimensions=ageGroup,gender metrics=viewerPercentage filters=isCurated==1;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
เมตริกรายได้และประสิทธิภาพของโฆษณาสําหรับเนื้อหาที่มีการอ้างสิทธิ์
คําขอนี้จะนําเมตริกรายได้และประสิทธิภาพของโฆษณาสําหรับเนื้อหาที่มีการอ้างสิทธิ์ของเจ้าของเนื้อหา รายงานจะแสดงข้อมูล 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