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

หน้านี้แสดงตัวอย่างคําขอ 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 ได้

  1. การจัดเรียงคําขอตามมิติข้อมูล/เมตริกหลายรายการ
  2. รายงานช่อง
  3. รายงานเจ้าของเนื้อหา

การจัดเรียงคําขอตามมิติข้อมูล/เมตริกหลายรายการ

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