หน้านี้แสดงตัวอย่างคำขอ API ของ YouTube Analytics แต่ละตัวอย่างจะอธิบายถึงรายงานที่มีการดึงข้อมูลไว้คร่าวๆ จากนั้นจะแสดงค่าพารามิเตอร์ dimensions
, metrics
, filters
และ sort
ที่เกี่ยวข้อง (เอกสารรายงานแชแนลและรายงานของเจ้าของเนื้อหาจะระบุรายงานที่ API รองรับ)
ตัวอย่างแต่ละรายการจะลิงก์ไปยังและป้อนข้อมูล Google API Explorer ด้วยค่าที่แสดง ตัวอย่างยังใช้วันที่เริ่มต้นและวันที่สิ้นสุดเริ่มต้น (YYYY-MM-DD
) ของ 2023-09-01
และ 2024-03-31
ด้วย
หลังจากลิงก์กับ API Explorer แล้ว คุณยังคงต้องระบุช่องหรือเจ้าของเนื้อหาที่จะเรียกดูรายงาน API Explorer จะเติมค่าพารามิเตอร์ ids
ด้วย channel==MINE
หรือ contentOwner==CONTENT_OWNER_ID
ขึ้นอยู่กับการค้นหาที่คุณคลิก สำหรับรายงานแชแนล คุณสามารถเปลี่ยน MINE
เป็นรหัสแชแนลของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้ว สำหรับรายงานเจ้าของเนื้อหา คุณจะต้องแทนที่ CONTENT_OWNER_ID
ด้วยรหัสเจ้าของเนื้อหา
นอกจากนี้ คุณยังต้องได้รับการตรวจสอบสิทธิ์ในฐานะช่องหรือเจ้าของเนื้อหาที่ระบุเพื่อให้ API Explorer สามารถให้สิทธิ์คำขอ API ของคุณโดยใช้ OAuth 2.0
การจัดเรียงคำขอตามมิติข้อมูล/เมตริกหลายรายการ
API รองรับความสามารถในการจัดเรียงข้อมูลการตอบกลับโดยใช้มิติข้อมูลหรือเมตริกหลายรายการ ตัวอย่างเช่น คำขอด้านล่างจะดึงข้อมูลแหล่งที่มาของการเข้าชมรายวันสำหรับวิดีโอของช่องใดช่องหนึ่ง แต่ละแถวในชุดผลลัพธ์จะระบุจำนวนการดูและเวลาในการรับชมโดยประมาณที่มาจากแหล่งที่มาของการเข้าชมประเภทใดประเภทหนึ่ง (เช่น EXT_URL
) ในวันหนึ่งๆ
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
ในการตอบสนอง ผลลัพธ์จะจัดเรียงตามลำดับเวลา ภายในชุดผลลัพธ์ของแต่ละวัน ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย ดังนั้นแถวแรกในชุดผลลัพธ์จะมีข้อมูลแหล่งที่มาของการเข้าชมที่สร้างยอดดูมากที่สุดในวันแรกในช่วงวันที่ที่ขอ แถวที่ 2 มีข้อมูลแหล่งที่มาของการเข้าชมซึ่งสร้างยอดดูสูงสุดเป็นลำดับถัดไปในวันแรก
รายงานแชแนล
รายงานวิดีโอ
ยอดดูทั้งหมด เวลาในการรับชมโดยประมาณ และอื่นๆ ของช่อง
การค้นหานี้จะเรียกเมตริกรวมสำหรับเนื้อหาของช่อง รายงานจะแสดงแถวเดี่ยวของข้อมูลที่มีผลรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
จำนวนการดูเฉพาะประเทศ (และอื่นๆ) สำหรับช่อง
คำค้นหานี้จะเรียกข้อมูลเมตริกสำหรับประเทศที่เฉพาะเจาะจงสำหรับวิดีโอของช่อง รายงานจะแสดงแถวเดี่ยวของข้อมูลที่มีผลรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
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
รายงานเพลย์ลิสต์
ยอดดูเพลย์ลิสต์ทั้งหมดของช่อง
คำขอนี้จะเรียกเพลย์ลิสต์ทั้งหมดที่เริ่มเล่น จำนวนนาทีที่ดูโดยประมาณ ยอดดู (เมตริกวิดีโอแบบรวม) ยอดดูเพลย์ลิสต์ (เมตริกในเพลย์ลิสต์) และยอดดูต่อการเริ่มเล่นเพลย์ลิสต์สำหรับเพลย์ลิสต์ในช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
สถิติสำหรับเพลย์ลิสต์ที่เฉพาะเจาะจง
คำขอนี้จะเรียกยอดดูเพลย์ลิสต์ทั้งหมดที่เริ่มเล่น จำนวนนาทีที่ดูโดยประมาณ ยอดดู (เมตริกวิดีโอแบบรวม) ยอดดูเพลย์ลิสต์ (เมตริกในเพลย์ลิสต์) และยอดดูต่อการเริ่มเล่นเพลย์ลิสต์ของเพลย์ลิสต์ที่เฉพาะเจาะจง โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง PLAYLIST_ID
ในค่าพารามิเตอร์ filters
ด้วยรหัสเพลย์ลิสต์สำหรับเพลย์ลิสต์ในช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
หากต้องการดึงข้อมูลสถิติแบบรวมสำหรับเพลย์ลิสต์หลายรายการ คุณยังสามารถแทนที่สตริง PLAYLIST_ID
ด้วยรายการรหัสเพลย์ลิสต์ที่คั่นด้วยคอมมาได้สูงสุด 500 รหัสสำหรับเพลย์ลิสต์ในช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์
10 อันดับแรก – เพลย์ลิสต์ที่มีผู้ชมมากที่สุดของช่อง
คำค้นหานี้จะเรียกเพลย์ลิสต์ที่มีการดูมากที่สุด 10 รายการของช่อง โดยวัดจากยอดดูเพลย์ลิสต์ในช่วงวันที่ที่ระบุ และยังดึงข้อมูลเมตริกของเพลย์ลิสต์อื่นๆ อีกหลายรายการ เช่น จำนวนครั้งที่ผู้ชมเริ่มเล่นเพลย์ลิสต์แต่ละรายการและระยะเวลาเฉลี่ยที่ผู้ชมดูวิดีโอในเพลย์ลิสต์หลังจากที่เริ่มเล่น ผลลัพธ์จะจัดเรียงตามยอดดูเพลย์ลิสต์จากมากไปน้อย
หมายเหตุ: เนื่องจากรายงานนี้ใช้มิติข้อมูล playlist
คุณจึงต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
และตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 10
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
รายงานวิดีโอ
เมตริกเวลาในการรับชมรายวันสำหรับวิดีโอของช่อง
การค้นหานี้จะเรียกข้อมูลจำนวนการดูรายวัน เมตริกเวลาในการรับชม และจำนวนผู้ติดตามใหม่สำหรับวิดีโอของช่อง รายงานจะแสดงแถวข้อมูลหนึ่งแถวสำหรับแต่ละวันในช่วงวันที่ที่ขอ ระบบจะจัดเรียงแถวตามลำดับเวลา
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
เมตริกคำอธิบายประกอบรายวันสำหรับวิดีโอของช่อง
คำขอนี้จะเรียกข้อมูลจำนวนการดูรายวัน อัตราการคลิกผ่านคำอธิบายประกอบ อัตราการปิดคำอธิบายประกอบ และการแสดงผลคำอธิบายประกอบสำหรับเนื้อหาของช่อง ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
รายงานเพลย์ลิสต์
ยอดดูของเพลย์ลิสต์รายวันของช่อง
คำขอนี้จะเรียกยอดดูรายวัน (เมตริกวิดีโอแบบรวม) ยอดดูเพลย์ลิสต์ (เมตริกในเพลย์ลิสต์) การเริ่มเล่นเพลย์ลิสต์ จำนวนนาทีที่ดูโดยประมาณ และยอดดูต่อการเริ่มเพลย์ลิสต์ของช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
รายงานวิดีโอ
เมตริกเวลาในการรับชมเฉพาะประเทศสำหรับวิดีโอของช่อง
ข้อความค้นหานี้จะดึงข้อมูลจำนวนการดู เมตริกเวลาในการรับชม และตัวเลขการติดตามเฉพาะประเทศสำหรับวิดีโอของช่อง โดยจะแสดงแถวข้อมูล 1 แถวสำหรับแต่ละประเทศที่มีการรับชมวิดีโอของช่อง ระบบจะจัดเรียงแถวตามลำดับจำนวนนาทีที่ดูจากมากไปหาน้อย
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=-estimatedMinutesWatched
เมตริกคำอธิบายประกอบเฉพาะประเทศสำหรับวิดีโอของช่อง
คำขอนี้จะเรียกข้อมูลจำนวนการดูเฉพาะประเทศ อัตราการคลิกผ่านคำอธิบายประกอบ อัตราการปิดคำอธิบายประกอบ และการแสดงผลคำอธิบายประกอบสำหรับวิดีโอของช่อง ผลลัพธ์จะจัดเรียงตามอัตราการคลิกผ่านคำอธิบายประกอบจากมากไปน้อย ซึ่งหมายความว่าประเทศที่มีอัตราการคลิกผ่านคำอธิบายประกอบสูงสุดจะแสดงก่อน
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
เมตริกเฉพาะจังหวัดสำหรับรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี.
คำขอนี้จะเรียกยอดดู จำนวนนาทีที่ดูโดยประมาณ และระยะเวลาการดูเฉลี่ยสำหรับวิดีโอของช่องโดยแยกตามจังหวัด ข้อมูลจะครอบคลุมรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี. ผลลัพธ์จะจัดเรียงตามตัวอักษรของรหัส ISO 3166-2 ของจังหวัด
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 อันดับยอดนิยม – วิดีโอที่มีคนดูมากที่สุดในประเทศใดประเทศหนึ่ง
ข้อความค้นหานี้จะดึงข้อมูลของวิดีโอที่มีจำนวนการดูมากที่สุด 10 รายการของช่อง โดยวัดจากจำนวนการดูในช่วงวันที่ที่ระบุในประเทศที่ระบุ ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย
หมายเหตุ: รายงานนี้กำหนดให้คุณต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
และตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 10
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views
เมืองยอดนิยม 10 อันดับแรกในสหรัฐอเมริกาตามจำนวนการดูทั้งหมด
คำค้นหานี้จะเรียกรายชื่อเมือง 10 เมืองในสหรัฐฯ ซึ่งมียอดดูเนื้อหาของช่องสูงสุดในช่วงวันที่ที่ระบุ คุณแก้ไขการค้นหาเพื่อขอข้อมูลสำหรับประเทศอื่นได้โดยเลือกค่าอื่นที่ถูกต้องให้กับตัวกรองนั้น ในทำนองเดียวกัน คุณสามารถแก้ไขข้อความค้นหาเพื่อดึงข้อมูลของอนุทวีป เช่น ยุโรปตะวันตกหรือเอเชียตะวันออกเฉียงใต้ได้โดยใช้ตัวกรอง subContinent และค่าที่ถูกต้องค่าใดค่าหนึ่ง แต่ระบบจะรองรับตัวกรองอื่นๆ ด้วย ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย
dimensions=city metrics=views filters=country==US maxResults=10 sort=-views
เมืองยอดนิยม 10 อันดับแรกในสหรัฐอเมริกาตามยอดดูทั้งหมดของเนื้อหาแต่ละประเภท
การค้นหานี้จะเรียกข้อมูลรายชื่อเมือง 10 เมืองในสหรัฐฯ ซึ่งส่งผลให้เนื้อหาของช่องมียอดดูมากที่สุดในช่วงวันที่ที่ระบุสำหรับ creatorContentType ที่รองรับแต่ละรายการ ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย
dimensions=city,creatorContentType metrics=views filters=country==US maxResults=10 sort=-views
เมืองยอดนิยม 10 อันดับแรกในสหรัฐอเมริกาตามเวลาในการรับชมทั้งหมด
การค้นหานี้จะดึงรายการ 10 วันยอดนิยมระหว่างช่วงวันที่ที่ระบุ เมื่อเมืองในสหรัฐอเมริกามีเวลาในการรับชมเนื้อหาของช่องรวมสูงสุดในแต่ละวัน ผลการค้นหาจะแสดงเวลาในการรับชมทั้งหมด วันที่ที่เกิดเวลาในการรับชม และเมืองที่คาดว่าจะมีการดูเนื้อหานั้น ผลลัพธ์จะจัดเรียงตามเวลาในการรับชมทั้งหมดจากมากไปหาน้อย
dimensions=city,day metrics=estimatedWatchTime filters=country==US maxResults=10 sort=-estimatedWatchTime
10 อันดับแรก – วิดีโอที่มียอดดูมากที่สุดในยุโรป
ข้อความค้นหานี้จะดึงข้อมูลจากวิดีโอ 10 รายการที่มีคนดูมากที่สุดในยุโรปของช่อง โดยวัดจากจำนวนการดูในช่วงวันที่ที่ระบุ คุณแก้ไขคำค้นหาเพื่อขอข้อมูลสำหรับทวีปอื่นได้โดยเลือกค่าอื่นที่ใช้ได้สำหรับตัวกรองนั้น ในทำนองเดียวกัน คุณสามารถแก้ไขข้อความค้นหาเพื่อดึงข้อมูลของอนุทวีป เช่น ยุโรปตะวันตกหรือเอเชียตะวันออกเฉียงใต้ได้โดยใช้ตัวกรอง subContinent และค่าที่ถูกต้องค่าใดค่าหนึ่ง ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย
หมายเหตุ: รายงานนี้กำหนดให้คุณต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
และตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 10
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
รายงานเพลย์ลิสต์
เมตริกเวลาในการรับชมของแต่ละประเทศสำหรับเพลย์ลิสต์ของช่อง
คำค้นหานี้จะเรียกข้อมูลยอดดูของแต่ละประเทศ (เมตริกวิดีโอแบบรวม) ยอดดูเพลย์ลิสต์ (เมตริกในเพลย์ลิสต์) และเมตริกเวลาในการรับชมสำหรับเพลย์ลิสต์ของช่อง โดยรายงานจะแสดงข้อมูล 1 แถวสำหรับแต่ละ ประเทศที่มีการดูเพลย์ลิสต์ของช่อง ระบบจะจัดเรียงแถวตามลำดับจำนวนนาทีที่ดูจากมากไปหาน้อย
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched
10 อันดับแรก – เพลย์ลิสต์ที่เริ่มต้นมากที่สุดในสหรัฐอเมริกา
ข้อความค้นหานี้จะดึงข้อมูลเพลย์ลิสต์ 10 รายการที่ผู้ชมในสหรัฐอเมริกาเริ่มดูบ่อยที่สุดในช่วงวันที่ที่ระบุ ผลลัพธ์จะจัดเรียงตามจำนวนของเพลย์ลิสต์ที่เริ่มเล่นจากมากไปน้อย
หมายเหตุ: เนื่องจากรายงานนี้ใช้มิติข้อมูล playlist
คุณจึงต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
และตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 10
dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts
รายงานวิดีโอ
จำนวนการดูและเวลาในการรับชมจากตำแหน่งที่เล่นต่างกัน
ข้อความค้นหานี้จะเรียกข้อมูลจำนวนการดูและเวลาในการรับชมโดยประมาณสำหรับวิดีโอของช่องใดช่องหนึ่ง ผลลัพธ์จะรวบรวมตามประเภทของหน้าเว็บหรือแอปพลิเคชันที่เกิดการเล่นวิดีโอ และผลลัพธ์จะจัดเรียงตามจำนวนการดูจากมากไปหาน้อย
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views
ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกันไป
ข้อความค้นหานี้จะเรียกข้อมูลจำนวนการดูรายวันและเวลาในการรับชมโดยประมาณในสหรัฐอเมริกาสำหรับวิดีโอของช่องใดช่องหนึ่ง ผลลัพธ์จะจัดกลุ่มตามวันสำหรับหน้าเว็บหรือแอปพลิเคชันแต่ละประเภทที่มีการเล่นวิดีโอ ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
10 อันดับยอดนิยม – ไซต์บุคคลที่สามที่สร้างการดูวิดีโอแบบฝังมากที่สุด
ข้อความค้นหานี้จะดึงจำนวนการดูและเวลาในการรับชมโดยประมาณของวิดีโอหรือกลุ่มวิดีโอหนึ่งๆ ผลลัพธ์จะจัดกลุ่มตามเว็บไซต์ของบุคคลที่สามที่มีวิดีโอฝังอยู่ ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยคอมมาของรหัสวิดีโออย่างน้อย 1 รายการสำหรับวิดีโอที่คุณอัปโหลด
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
รายงานเพลย์ลิสต์
ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากตำแหน่งที่เล่นต่างกัน
คำค้นหานี้จะเรียกข้อมูลยอดดู (เมตริกวิดีโอแบบรวม) ยอดดูเพลย์ลิสต์ (เมตริกในเพลย์ลิสต์) เวลาในการรับชมโดยประมาณ และเพลย์ลิสต์ที่เริ่มเล่นสำหรับเพลย์ลิสต์ของช่องใดช่องหนึ่ง ระบบจะรวบรวมผลลัพธ์ตามประเภทของหน้าเว็บหรือแอปพลิเคชันที่มีการเล่นวิดีโอ และผลลัพธ์จะจัดเรียงตามการเริ่มเล่นจากมากไปน้อย
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
ยอดดูเพลย์ลิสต์และเวลาในการรับชมรายวันจากตำแหน่งที่เล่นต่างกัน
การค้นหานี้จะดึงข้อมูลการเริ่มเล่นของเพลย์ลิสต์รายวัน ยอดดู (เมตริกวิดีโอแบบรวม) ยอดดูเพลย์ลิสต์ (เมตริกในเพลย์ลิสต์) และเวลาในการรับชมโดยประมาณในสหรัฐอเมริกาสำหรับเพลย์ลิสต์ของช่องใดช่องหนึ่ง ผลลัพธ์จะจัดกลุ่มตามวันสำหรับหน้าเว็บหรือแอปพลิเคชันแต่ละประเภทที่มีการดูเพลย์ลิสต์เกิดขึ้น ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=country==US sort=day
รายงานวิดีโอ
การกดชอบและไม่ชอบตามประเภทเนื้อหา
คำค้นหานี้จะเรียกข้อมูลจำนวนการชอบและไม่ชอบสำหรับเนื้อหาแต่ละประเภทในช่อง
dimensions=creatorContentType metrics=likes,dislikes
รายงานวิดีโอ
จำนวนการดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศ
คำขอนี้จะเรียกจำนวนการดูและเวลาในการรับชมโดยประมาณสำหรับวิดีโอของช่องในประเทศที่ระบุ ระบบจะรวบรวมเมตริกตามแหล่งที่มาของการเข้าชม ซึ่งอธิบายลักษณะที่ผู้ใช้เข้าถึงวิดีโอ
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
ยอดดูรายวันและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
คำขอนี้จะเรียกยอดดูรายวันและเวลาในการรับชมโดยประมาณรายวันสำหรับวิดีโอของช่อง ระบบจะรวบรวมเมตริกแบบรายวันตามแหล่งที่มาของการเข้าชมและจัดเรียงตามลำดับเวลา
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched sort=day
10 อันดับยอดนิยม – ข้อความค้นหาบน YouTube ที่สร้างการเข้าชมวิดีโอมากที่สุด
ข้อความค้นหานี้จะดึงข้อมูล 10 ข้อความค้นหาที่ทำให้มียอดดูมากที่สุดจากผลการค้นหาของ YouTube สำหรับวิดีโอที่เฉพาะเจาะจงอย่างน้อย 1 รายการ ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยคอมมาของรหัสวิดีโอสูงสุด 500 รายการ
เช่น คุณอาจเรียกใช้การค้นหาสำหรับวิดีโอรายการเดียวหรือแทนที่ VIDEO_ID
เพื่อระบุข้อความค้นหาที่เพิ่มการเข้าชมมากที่สุดให้กับวิดีโอนั้น และคุณยังสามารถแสดงรายชื่อวิดีโอทั้งหมดในเพลย์ลิสต์หนึ่งๆ เพื่อพิจารณาว่าข้อความค้นหาใดทำให้เกิดการเข้าชมมากที่สุดสำหรับวิดีโอใดๆ ในเพลย์ลิสต์นั้น
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 อันดับยอดนิยม – เว็บไซต์ภายนอกที่สร้างการเข้าชมมากที่สุดสำหรับวิดีโอ
คำค้นหานี้จะเรียกเว็บไซต์ภายนอก 10 เว็บไซต์ที่สร้างยอดดูสูงสุดสำหรับวิดีโอหรือกลุ่มวิดีโอหนึ่งๆ ผลลัพธ์จะจัดเรียงตามเวลาในการรับชมโดยประมาณจากมากไปน้อย โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยคอมมาของรหัสวิดีโอสูงสุด 500 รายการสำหรับวิดีโอที่อัปโหลด
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
รายงานเพลย์ลิสต์
ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศ
คำขอนี้จะเรียกข้อมูลยอดดู (เมตริกวิดีโอแบบรวม) ยอดดูเพลย์ลิสต์ (เมตริกในเพลย์ลิสต์) การเริ่มเล่นเพลย์ลิสต์ และเวลาในการรับชมโดยประมาณสำหรับยอดดูเพลย์ลิสต์ในประเทศที่ระบุ ระบบจะรวบรวมเมตริกตามแหล่งที่มาของการเข้าชม ซึ่งอธิบายลักษณะที่ผู้ใช้เข้าถึงเพลย์ลิสต์
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
ยอดดูเพลย์ลิสต์และเวลาในการรับชมรายวันจากแหล่งที่มาของการเข้าชมต่างๆ
คำขอนี้จะดึงข้อมูลยอดดูเพลย์ลิสต์รายวันของช่อง (เมตริกในเพลย์ลิสต์) การเริ่มเล่นเพลย์ลิสต์ และเวลาในการรับชมโดยประมาณ และยังดึงยอดดูทั้งหมด (เมตริกวิดีโอรวม) ด้วย ระบบจะรวบรวมเมตริกแบบรายวันตามแหล่งที่มาของการเข้าชมและจัดเรียงตามลำดับเวลา
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=day
รายงานวิดีโอ
เมตริกประเภทอุปกรณ์รายวันสำหรับระบบปฏิบัติการ Android
ข้อความค้นหานี้จะเรียกข้อมูลจำนวนการดูรายวันและเวลาในการรับชมโดยประมาณบนอุปกรณ์ Android สำหรับวิดีโอของช่องใดช่องหนึ่ง ผลลัพธ์จะจัดกลุ่มตามวันสำหรับอุปกรณ์แต่ละประเภทที่มีการเล่นวิดีโอ ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day
เมตริกระบบปฏิบัติการรายวันสำหรับอุปกรณ์เคลื่อนที่
ข้อความค้นหานี้จะเรียกข้อมูลจำนวนการดูรายวันและเวลาในการรับชมโดยประมาณบนอุปกรณ์เคลื่อนที่สำหรับวิดีโอของช่องใดช่องหนึ่ง ผลลัพธ์จะจัดกลุ่มตามวันสำหรับระบบปฏิบัติการแต่ละระบบที่มีการเล่นวิดีโอ ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
เมตริกประเภทอุปกรณ์และระบบปฏิบัติการรายวัน
ข้อความค้นหานี้จะเรียกข้อมูลจำนวนการดูรายวันและเวลาในการรับชมโดยประมาณสำหรับช่อง สถิติจะจัดกลุ่มตามระบบปฏิบัติการและประเภทอุปกรณ์ ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
รายงานเพลย์ลิสต์
เมตริกประเภทอุปกรณ์รายวันสำหรับยอดดูเพลย์ลิสต์บนระบบปฏิบัติการ Android
คำค้นหานี้จะเรียกข้อมูลยอดดูรายวัน (เมตริกวิดีโอแบบรวม) ยอดดูเพลย์ลิสต์ (เมตริกในเพลย์ลิสต์) และเวลาในการรับชมโดยประมาณบนอุปกรณ์ Android สำหรับเพลย์ลิสต์ของช่องหนึ่งๆ ผลลัพธ์จะจัดกลุ่มตามวันสำหรับอุปกรณ์แต่ละประเภทที่เกิดการดูเพลย์ลิสต์ ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day
เมตริกระบบปฏิบัติการรายวันสำหรับยอดดูเพลย์ลิสต์บนอุปกรณ์เคลื่อนที่
คำค้นหานี้จะเรียกข้อมูลยอดดูรายวัน (เมตริกวิดีโอแบบรวม) ยอดดูเพลย์ลิสต์ (เมตริกในเพลย์ลิสต์) และเวลาในการรับชมโดยประมาณบนอุปกรณ์เคลื่อนที่สำหรับเพลย์ลิสต์ของช่องใดช่องหนึ่ง ผลลัพธ์จะจัดกลุ่มตามวันสำหรับระบบปฏิบัติการแต่ละระบบที่มีการดูเพลย์ลิสต์เกิดขึ้น ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
รายงานวิดีโอ
ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
รายงานนี้จะเรียกสถิติเกี่ยวกับกลุ่มอายุและเพศของผู้ชมในแคลิฟอร์เนียที่ดูวิดีโอของช่อง ผลลัพธ์จะจัดเรียงตามเพศ จากนั้นจึงจัดเรียงตามกลุ่มอายุ คุณแก้ไขคำค้นหานี้เพื่อเรียกข้อมูลสถิติเดียวกันของผู้ชมทั่วโลก หรือผู้ชมทั้งหมดในประเทศ ทวีป อนุทวีป หรือรัฐอื่นในสหรัฐอเมริกาได้โดยการปรับค่าพารามิเตอร์ filters
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
รายงานเพลย์ลิสต์
ข้อมูลประชากรของผู้ชมเพลย์ลิสต์ในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
รายงานนี้จะเรียกสถิติเกี่ยวกับกลุ่มอายุและเพศของผู้ชมในแคลิฟอร์เนียที่ดูเพลย์ลิสต์ของช่อง ผลลัพธ์จะจัดเรียงตามเพศ จากนั้นจึงจัดเรียงตามกลุ่มอายุ คุณแก้ไขคำค้นหานี้เพื่อดึงข้อมูลสถิติเดียวกันสำหรับผู้ชมทุกคนทั่วโลก หรือผู้ชมทั้งหมดในประเทศ ทวีป อนุทวีป หรือรัฐอื่นในสหรัฐอเมริกาได้โดยการปรับค่าพารามิเตอร์ filters
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
เมตริกการแชร์ ซึ่งรวบรวมตามบริการที่มีการแชร์วิดีโอ
คำขอนี้จะแสดงจำนวนครั้งที่ผู้ใช้ใช้ปุ่ม Share
เพื่อแชร์วิดีโอของช่อง ผลลัพธ์จะรวบรวมโดยบริการแชร์ (Google+, Twitter ฯลฯ) และจัดเรียงตามจำนวนการแชร์จากมากไปหาน้อย
dimensions=sharingService metrics=shares sort=-shares
เมตริกการคงผู้ชมไว้ของวิดีโอ
รายงานนี้วัดความสามารถของวิดีโอในการรักษาผู้ชมเอาไว้ โดยจะดึงข้อมูลรายงานสำหรับวิดีโอได้เพียงครั้งละ 1 รายการเท่านั้น โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID
ในค่าพารามิเตอร์ filters
ด้วยรหัสวิดีโอสำหรับวิดีโอที่อัปโหลดของคุณ โปรดทราบว่ารายงานการคงผู้ชมไว้ไม่รองรับความสามารถในการระบุค่าหลายค่าสำหรับตัวกรอง video
ในตัวอย่างนี้ รายงานใช้ตัวกรอง audienceType
เพื่อจำกัดการตอบกลับเพื่อให้มีเฉพาะข้อมูลการดูทั่วไป ซึ่งเป็นผลมาจากการดำเนินการโดยตรงของผู้ใช้ เช่น การค้นหาวิดีโอหรือการคลิกวิดีโอแนะนำ ดังนั้น รายงานจึงไม่มีข้อมูลการดูจากโฆษณา TrueView ในสตรีมหรือ TrueView แบบบนหน้าจอ คุณสามารถนำตัวกรองออกเพื่อดึงข้อมูลการคงผู้ชมไว้ของวิดีโอออกจากกลุ่มเป้าหมายทุกประเภท
โปรดทราบว่าข้อมูลสำหรับตัวกรอง audienceType
จะพร้อมใช้งานตั้งแต่วันที่ 25 กันยายน 2013 API จะไม่แสดงข้อมูลสำหรับคำค้นหาที่ใช้ตัวกรองเพื่อพยายามดึงข้อมูลจากวันก่อนหน้า ข้อความค้นหาที่ไม่ใช้ตัวกรองนั้นจะใช้ได้กับวันที่ใดๆ หลังจากวันที่ 1 กรกฎาคม 2008
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
เมตริกรายได้และประสิทธิภาพโฆษณาของช่อง
คำขอนี้จะดึงข้อมูลเมตริกรายได้และประสิทธิภาพโฆษณาของช่อง รายงานจะแสดงแถวเดี่ยวของข้อมูลที่มีผลรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
เมตริกรายได้และประสิทธิภาพโฆษณารายวัน
คำขอนี้จะเรียกรายได้รายวันของช่องและเมตริกประสิทธิภาพโฆษณา
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
เมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศ
คำขอนี้จะดึงข้อมูลเมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศของช่อง ผลลัพธ์จะจัดเรียงตามจำนวนรายได้จากมากไปหาน้อย ซึ่งหมายความว่าประเทศแรกที่แสดงในรายการจะเป็นประเทศที่พาร์ทเนอร์มีรายได้สุทธิมากที่สุด
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
10 อันดับแรก – วิดีโอที่สร้างรายได้สูงสุด
คำขอนี้จะแสดงเมตริกรายได้และประสิทธิภาพโฆษณาสำหรับวิดีโอ 10 รายการของช่องที่สามารถสร้างรายได้มากที่สุด ผลลัพธ์จะจัดเรียงตามจำนวนรายได้จากมากไปหาน้อย ซึ่งหมายความว่าวิดีโอแรกจะเป็นวิดีโอที่มีรายได้โดยประมาณสูงสุด
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks maxResults=10 sort=-estimatedRevenue
เมตริกประสิทธิภาพโฆษณาสำหรับโฆษณาประเภทต่างๆ
คำขอนี้จะเรียกเมตริกประสิทธิภาพโฆษณาสำหรับเนื้อหาที่เจ้าของเนื้อหาอ้างสิทธิ์ ผลลัพธ์จะจัดกลุ่มตามประเภทโฆษณา ซึ่งช่วยให้คุณเปรียบเทียบรายได้และค่า CPM ในโฆษณาประเภทต่างๆ ได้
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
รายงานเจ้าของเนื้อหา
รายงานวิดีโอ
ยอดดูทั้งหมด เวลาในการรับชมโดยประมาณ และอื่นๆ ของเนื้อหาที่อ้างสิทธิ์ทั้งหมด
การค้นหานี้จะเรียกเมตริกรวมสำหรับเนื้อหาที่อ้างสิทธิ์ของเจ้าของเนื้อหา รายงานจะแสดงแถวเดี่ยวของข้อมูลที่มีผลรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
จำนวนการดูเฉพาะประเทศ (และอื่นๆ) สำหรับวิดีโอที่อัปโหลดด้วยตนเองทั้งหมด
คำค้นหานี้จะเรียกข้อมูลเมตริกสำหรับประเทศที่เฉพาะเจาะจงสำหรับวิดีโอที่เจ้าของเนื้อหาอัปโหลด รายงานจะแสดงแถวเดี่ยวของข้อมูลที่มีผลรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
ยอดดูทั้งหมด (และอื่นๆ) สำหรับเนื้อหาของบุคคลที่สามที่มีการอ้างสิทธิ์ทั้งหมด
การค้นหานี้จะเรียกเมตริกรวมสำหรับวิดีโอที่เจ้าของเนื้อหาได้อ้างสิทธิ์ไว้แต่ไม่ได้อัปโหลด รายงานจะแสดงแถวเดี่ยวของข้อมูลที่มีผลรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
จำนวนการดูทั้งหมด (และอื่นๆ) สำหรับเนื้อหาที่อัปโหลดด้วยตนเองทั้งหมด
การค้นหานี้จะเรียกเมตริกรวมสำหรับวิดีโอที่เจ้าของเนื้อหาอัปโหลดไว้ รายงานจะแสดงแถวเดี่ยวของข้อมูลที่มีผลรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
ยอดดูทั้งหมด (และอื่นๆ) ของเนื้อหาที่อัปโหลดด้วยตนเองทั้งหมดที่อ้างสิทธิ์
การค้นหานี้จะเรียกเมตริกรวมสำหรับวิดีโอที่เจ้าของเนื้อหาได้อัปโหลดและอ้างสิทธิ์ไว้ด้วย รายงานจะแสดงแถวเดี่ยวของข้อมูลที่มีผลรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
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 รายการสำหรับช่องหรือกลุ่มช่องที่เจ้าของเนื้อหาจัดการ ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยจุลภาคของรหัสแชแนลสำหรับแชแนลของคุณไม่เกิน 500 รหัส
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
10 อันดับยอดนิยม – อัตราการคลิกผ่านคำอธิบายประกอบสำหรับวิดีโอที่มีจำนวนการดูมากที่สุดของช่อง
คำขอนี้จะดึงข้อมูลยอดดู อัตราการคลิกผ่านคำอธิบายประกอบ อัตราการปิดคำอธิบายประกอบ และการแสดงผลคำอธิบายประกอบสำหรับวิดีโอที่มียอดดูมากที่สุด 10 รายการในช่องหรือกลุ่มช่องที่ระบุ ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย ซึ่งหมายความว่าวิดีโอที่มีคนดูมากที่สุดจะแสดงก่อน โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยจุลภาคของรหัสแชแนลสำหรับแชแนลของคุณไม่เกิน 500 รหัส
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
รายงานเพลย์ลิสต์
ยอดดูเพลย์ลิสต์สำหรับช่องของเจ้าของเนื้อหา
คำขอนี้จะเรียกเพลย์ลิสต์ทั้งหมดที่เริ่มเล่น จำนวนนาทีที่ดูโดยประมาณของเพลย์ลิสต์ ยอดดูเพลย์ลิสต์ และยอดดูต่อการเริ่มเล่นเพลย์ลิสต์สำหรับเพลย์ลิสต์ในช่องของเจ้าของเนื้อหา เมตริก playlistViews
จะนับเฉพาะยอดดูวิดีโอที่เกิดขึ้นในบริบทของเพลย์ลิสต์ เนื่องจากเมตริกที่ขอทั้งหมดเป็นเมตริกในเพลย์ลิสต์ คำขอจึงไม่ต้องมีตัวกรองเพลย์ลิสต์หรือกลุ่มด้วย
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
สถิติสำหรับเพลย์ลิสต์ที่เฉพาะเจาะจง
คำขอนี้จะเรียกยอดดูเพลย์ลิสต์ทั้งหมดที่เริ่มเล่น จำนวนนาทีที่ดูโดยประมาณ ยอดดู (เมตริกวิดีโอแบบรวม) ยอดดูเพลย์ลิสต์ (เมตริกในเพลย์ลิสต์) และยอดดูต่อการเริ่มเล่นเพลย์ลิสต์ของเพลย์ลิสต์ที่เฉพาะเจาะจง โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง PLAYLIST_ID
ในค่าพารามิเตอร์ filters
ด้วยรหัสเพลย์ลิสต์สำหรับเพลย์ลิสต์ในช่องใดช่องหนึ่งของเจ้าของเนื้อหา
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
ในการเรียกดูสถิติรวมของเพลย์ลิสต์หลายรายการ คุณยังสามารถแทนที่สตริง PLAYLIST_ID
ด้วยรายการรหัสเพลย์ลิสต์ที่คั่นด้วยจุลภาค 500 รหัสสำหรับเพลย์ลิสต์ในช่องของเจ้าของเนื้อหา
รายงานวิดีโอ
เมตริกเวลาในการรับชมรายวันสำหรับเนื้อหาที่อัปโหลดด้วยตนเอง
การค้นหานี้จะเรียกเมตริกเวลาในการรับชมรายวัน รวมถึงยอดดู จำนวนการเล่นที่สร้างรายได้ และจำนวนการแสดงผลสำหรับวิดีโอที่เจ้าของเนื้อหาอัปโหลด รายงานจะแสดงแถวข้อมูลหนึ่งแถวสำหรับแต่ละวันในช่วงวันที่ที่ขอ และแถวจะจัดเรียงตามลำดับเวลา
dimensions=day metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions filters=uploaderType==self sort=day
เมตริกคำอธิบายประกอบสำหรับเนื้อหาที่อ้างสิทธิ์
คำขอนี้จะเรียกยอดดูรายวัน อัตราการคลิกผ่านคำอธิบายประกอบ อัตราการปิดคำอธิบายประกอบ และการแสดงผลคำอธิบายประกอบสำหรับเนื้อหาที่เจ้าของเนื้อหาอ้างสิทธิ์ ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
รายงานเพลย์ลิสต์
ยอดดูของเพลย์ลิสต์รายวันของเจ้าของเนื้อหา
คำขอนี้จะเรียกเมตริกสำหรับการโต้ตอบรายวันของผู้ใช้กับวิดีโอในเพลย์ลิสต์ของเจ้าของเนื้อหา เมตริกที่ดึงข้อมูลในรายงานคือ playlistViews, playlistStarts, playlistEstimatedMinutesWatched และ viewsPerPlaylistStart เมตริกข้างต้นทั้งหมดเป็นเมตริกในเพลย์ลิสต์ เนื่องจากเมตริกที่ขอทั้งหมดเป็นเมตริกในเพลย์ลิสต์ คำขอจึงไม่จำเป็นต้องใส่ตัวกรองเพลย์ลิสต์หรือกลุ่มด้วย
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
รายงานวิดีโอ
เมตริกเวลาในการรับชมของแต่ละประเทศสำหรับเนื้อหาที่อัปโหลดด้วยตนเอง
การค้นหานี้จะเรียกข้อมูลยอดดู เมตริกเวลาในการรับชม และรายได้จากโฆษณาโดยประมาณสำหรับแต่ละประเทศ เมตริกมีไว้สำหรับวิดีโอที่เจ้าของเนื้อหาอัปโหลด รายงานจะแสดงข้อมูลหนึ่งแถวสำหรับแต่ละประเทศที่มีการดูวิดีโอ และจัดเรียงแถวตามลำดับจำนวนนาทีที่ดูจากมากไปหาน้อย
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
เมตริกคำอธิบายประกอบเฉพาะประเทศสำหรับเนื้อหาที่อัปโหลดด้วยตนเอง
คำขอนี้จะเรียกข้อมูลจำนวนการดูเฉพาะประเทศ อัตราการคลิกผ่านคำอธิบายประกอบ อัตราการปิดคำอธิบายประกอบ และการแสดงผลคำอธิบายประกอบสำหรับวิดีโอที่อัปโหลดของเจ้าของเนื้อหา ผลลัพธ์จะจัดเรียงตามอัตราการคลิกผ่านคำอธิบายประกอบจากมากไปน้อย ซึ่งหมายความว่าประเทศที่มีอัตราการคลิกผ่านคำอธิบายประกอบสูงสุดจะแสดงก่อน
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
เมตริกเฉพาะจังหวัดสำหรับรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี.
คำขอนี้จะแสดงยอดดูแบบจังหวัดต่อจังหวัด จำนวนนาทีที่ดูโดยประมาณ และระยะเวลาการดูเฉลี่ยสำหรับวิดีโอที่เจ้าของเนื้อหาอ้างสิทธิ์ ข้อมูลจะครอบคลุมรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี. ผลลัพธ์จะจัดเรียงตามตัวอักษรของรหัส ISO 3166-2 ของจังหวัด
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
เมืองยอดนิยม 10 อันดับแรกในสหรัฐอเมริกาตามจำนวนการดูทั้งหมด
การค้นหานี้จะเรียกข้อมูลรายชื่อเมือง 10 เมืองในสหรัฐฯ ซึ่งนับเป็นจำนวนการดูสูงสุดสำหรับวิดีโอที่อ้างสิทธิ์ของเจ้าของเนื้อหาในช่วงวันที่ที่ระบุ คุณแก้ไขการค้นหาเพื่อขอข้อมูลสำหรับประเทศอื่นได้โดยเลือกค่าอื่นที่ถูกต้องให้กับตัวกรองนั้น ในทำนองเดียวกัน คุณสามารถแก้ไขข้อความค้นหาเพื่อดึงข้อมูลของอนุทวีป เช่น ยุโรปตะวันตกหรือเอเชียตะวันออกเฉียงใต้ได้โดยใช้ตัวกรอง subContinent และค่าที่ถูกต้องค่าใดค่าหนึ่ง แต่ระบบจะรองรับตัวกรองอื่นๆ ด้วย ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย
dimensions=city metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
เมืองยอดนิยม 10 อันดับแรกในสหรัฐอเมริกาตามยอดดูทั้งหมดของเนื้อหาแต่ละประเภท
การค้นหานี้จะเรียกข้อมูลรายชื่อเมือง 10 เมืองในสหรัฐฯ ซึ่งส่งผลให้เนื้อหาที่เจ้าของเนื้อหาอ้างสิทธิ์มากที่สุดในช่วงวันที่ที่ระบุสำหรับ creatorContentType ที่รองรับแต่ละรายการ ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย
dimensions=city,creatorContentType metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
เมืองยอดนิยม 10 อันดับแรกในสหรัฐอเมริกาตามเวลาในการรับชมทั้งหมด
การค้นหานี้จะดึงรายการ 10 วันยอดนิยมระหว่างช่วงวันที่ที่ระบุ เมื่อเมืองต่างๆ ในสหรัฐอเมริกามีเวลาในการรับชมรวมสูงสุดต่อวันสำหรับเนื้อหาที่มีการอ้างสิทธิ์ของเจ้าของเนื้อหา ผลการค้นหาจะแสดงเวลาในการรับชมทั้งหมด วันที่ที่เกิดเวลาในการรับชม และเมืองที่คาดว่าจะมีการดูเนื้อหานั้น ผลลัพธ์จะจัดเรียงตามเวลาในการรับชมทั้งหมดจากมากไปหาน้อย
dimensions=city,day metrics=estimatedWatchTime filters=claimedStatus==claimed;country==US maxResults=10 sort=-estimatedWatchTime
10 อันดับแรก – วิดีโอที่มีการรับชมมากที่สุดในยุโรป
ข้อความค้นหานี้ดึงข้อมูลจากวิดีโอที่มีการดูมากที่สุด 10 รายการในยุโรป จากวิดีโอที่มีการอ้างสิทธิ์โดยเจ้าของเนื้อหา ซึ่งวัดจากยอดดูในช่วงวันที่ที่ระบุ คุณแก้ไขคำค้นหาเพื่อขอข้อมูลสำหรับทวีปอื่นได้โดยเลือกค่าอื่นที่ใช้ได้สำหรับตัวกรองนั้น ในทำนองเดียวกัน คุณสามารถแก้ไขข้อความค้นหาเพื่อดึงข้อมูลของอนุทวีป เช่น ยุโรปตะวันตกหรือเอเชียตะวันออกเฉียงใต้ได้โดยใช้ตัวกรอง subContinent และค่าที่ถูกต้องค่าใดค่าหนึ่ง ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=claimedStatus==claimed;filters=continent==150 maxResults=10 sort=-estimatedMinutesWatched
รายงานเพลย์ลิสต์
เมตริกเวลาในการรับชมเฉพาะประเทศสำหรับเพลย์ลิสต์ของเจ้าของเนื้อหา
คำค้นหานี้จะดึงข้อมูลยอดดูของเพลย์ลิสต์ที่เจาะจงประเทศและเมตริกเวลาในการรับชมเพลย์ลิสต์สำหรับเพลย์ลิสต์ทั้งหมดในช่องของเจ้าของเนื้อหา โดยรายงานจะแสดงข้อมูล 1 แถวสำหรับแต่ละประเทศที่มีการดูเพลย์ลิสต์ ระบบจะจัดเรียงแถวตามลำดับจำนวนนาทีที่ดูจากมากไปหาน้อย
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
10 อันดับแรก – เพลย์ลิสต์ที่เริ่มต้นมากที่สุดในสหรัฐอเมริกา
คำค้นหานี้จะดึงข้อมูลเพลย์ลิสต์ 10 รายการจากช่องของเจ้าของเนื้อหาที่ผู้ดูในสหรัฐอเมริกาเริ่มดูบ่อยที่สุดในช่วงวันที่ที่ระบุ ผลลัพธ์จะจัดเรียงตามจำนวนของเพลย์ลิสต์ที่เริ่มเล่นตามลำดับจากมากไปน้อย
หมายเหตุ: เนื่องจากรายงานนี้ใช้มิติข้อมูล playlist
คุณจึงต้องระบุค่าสำหรับพารามิเตอร์คำขอ sort
และตั้งค่าพารามิเตอร์ maxResults
เป็นค่าจำนวนเต็มไม่เกิน 10
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
รายงานวิดีโอ
การกดชอบและไม่ชอบตามประเภทเนื้อหา
คำค้นหานี้จะเรียกข้อมูลจำนวนการชอบและไม่ชอบสำหรับเนื้อหาแต่ละประเภทในช่องหรือกลุ่มช่องหนึ่งๆ โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยจุลภาคของรหัสแชแนลสำหรับแชแนลของคุณไม่เกิน 500 รหัส
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
รายงานวิดีโอ
จำนวนการดูและเวลาในการรับชมจากตำแหน่งที่เล่นต่างกัน
ข้อความค้นหานี้จะเรียกข้อมูลจำนวนการดูและเวลาในการรับชมโดยประมาณสำหรับวิดีโอที่อัปโหลดลงในช่องหรือกลุ่มช่องใดช่องหนึ่ง ผลลัพธ์จะรวบรวมตามประเภทของหน้าเว็บหรือแอปพลิเคชันที่เกิดการเล่นวิดีโอ และผลลัพธ์จะจัดเรียงตามจำนวนการดูจากมากไปหาน้อย โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยจุลภาคของรหัสแชแนลสำหรับแชแนลของคุณไม่เกิน 500 รหัส
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นแตกต่างกันไป
ข้อความค้นหานี้จะเรียกข้อมูลจำนวนการดูรายวันและเวลาในการรับชมโดยประมาณในสหรัฐอเมริกาสำหรับวิดีโอที่อัปโหลดไปยังช่องหรือกลุ่มช่องใดช่องหนึ่ง ผลลัพธ์จะจัดกลุ่มตามวันสำหรับหน้าเว็บหรือแอปพลิเคชันแต่ละประเภทที่มีการเล่นวิดีโอ ผลลัพธ์จะจัดเรียงตามลำดับเวลาย้อนกลับ โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยจุลภาคของรหัสแชแนลสำหรับแชแนลของคุณไม่เกิน 500 รหัส
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
10 อันดับยอดนิยม – ไซต์บุคคลที่สามที่สร้างการดูวิดีโอแบบฝังมากที่สุด
ข้อความค้นหานี้จะดึงจำนวนการดูและเวลาในการรับชมโดยประมาณของวิดีโอหรือกลุ่มวิดีโอหนึ่งๆ ผลลัพธ์จะจัดกลุ่มตามเว็บไซต์ของบุคคลที่สามที่มีวิดีโอฝังอยู่ ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยคอมมาของรหัสวิดีโอสูงสุด 500 รายการสำหรับวิดีโอที่อัปโหลด
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
รายงานเพลย์ลิสต์
ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากตำแหน่งที่เล่นต่างกัน
คำค้นหานี้จะเรียกข้อมูลยอดดูเพลย์ลิสต์ เวลาในการรับชมเพลย์ลิสต์โดยประมาณ และรายการเล่นของเพลย์ลิสต์ที่เริ่มเล่นสำหรับทุกเพลย์ลิสต์ในช่องของเจ้าของเนื้อหา ระบบจะรวบรวมผลลัพธ์ตามประเภทของหน้าเว็บหรือแอปพลิเคชันที่มีการเล่นวิดีโอ และผลลัพธ์จะจัดเรียงตามการเริ่มเล่นจากมากไปน้อย
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากตำแหน่งที่เล่นต่างกัน
คำค้นหานี้จะดึงข้อมูลการเริ่มเล่นเพลย์ลิสต์รายวัน ยอดดูเพลย์ลิสต์ และเวลาในการรับชมเพลย์ลิสต์โดยประมาณในสหรัฐอเมริกาสำหรับเพลย์ลิสต์ทั้งหมดในช่องของเจ้าของเนื้อหา ระบบจะแสดงผลลัพธ์สำหรับหน้าเว็บหรือแอปพลิเคชันแต่ละประเภทที่มีการดูเพลย์ลิสต์
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
รายงานวิดีโอ
ยอดดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
คำขอนี้จะเรียกจำนวนการดูและเวลาในการรับชมโดยประมาณสำหรับวิดีโอของเจ้าของเนื้อหา ระบบจะรวบรวมเมตริกตามแหล่งที่มาของการเข้าชม ซึ่งอธิบายลักษณะที่ผู้ใช้เข้าถึงวิดีโอ
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
ยอดดูรายวันและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
คำขอนี้จะเรียกยอดดูรายวันและเวลาในการรับชมโดยประมาณรายวันสำหรับวิดีโอของเจ้าของเนื้อหา ระบบจะรวบรวมเมตริกแบบรายวันตามแหล่งที่มาของการเข้าชมและจัดเรียงตามลำดับเวลาจากใหม่ไปหาเก่า
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
หมายเหตุ: รายงานตัวอย่าง 2 รายงานถัดไปรองรับเฉพาะแหล่งที่มาของการเข้าชมที่เฉพาะเจาะจงเท่านั้น ตัวอย่างเช่น แหล่งที่มาของการเข้าชม NO_LINK_EMBEDDED
ไม่มีรายละเอียดเพิ่มเติม รายงานจึงไม่พร้อมให้รับชมสำหรับแหล่งที่มานั้น ดูคําจํากัดความของ insightTrafficSourceType สําหรับรายละเอียดเกี่ยวกับแหล่งที่มาของการเข้าชมที่รายงานประเภทเหล่านี้พร้อมใช้งาน
10 อันดับยอดนิยม – ข้อความค้นหาบน YouTube ที่สร้างการเข้าชมวิดีโอมากที่สุด
คำค้นหานี้จะดึงข้อมูล 10 ข้อความค้นหาที่ทำให้มียอดดูมากที่สุดจากผลการค้นหาของ YouTube สำหรับวิดีโอหรือกลุ่มวิดีโอที่เฉพาะเจาะจง ผลลัพธ์จะจัดเรียงตามยอดดูจากมากไปน้อย โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยคอมมาของรหัสวิดีโอสูงสุด 500 รายการสำหรับวิดีโอที่อัปโหลด
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 อันดับยอดนิยม – เว็บไซต์ภายนอกที่สร้างการเข้าชมมากที่สุดสำหรับวิดีโอ
คำค้นหานี้จะเรียกเว็บไซต์ภายนอก 10 เว็บไซต์ที่สร้างยอดดูมากที่สุดจากผลการค้นหาของ Google สำหรับวิดีโอหรือกลุ่มวิดีโอที่เฉพาะเจาะจง ผลลัพธ์จะจัดเรียงตามเวลาในการรับชมโดยประมาณจากมากไปน้อย โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยคอมมาของรหัสวิดีโอสูงสุด 500 รายการสำหรับวิดีโอที่อัปโหลด
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
รายงานเพลย์ลิสต์
ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศ
คำขอนี้จะเรียกข้อมูลยอดดูเพลย์ลิสต์ การเริ่มเล่นเพลย์ลิสต์ และเวลาในการรับชมโดยประมาณของเพลย์ลิสต์สำหรับยอดดูเพลย์ลิสต์ในประเทศที่ระบุ ระบบจะรวบรวมเมตริกตามแหล่งที่มาของการเข้าชม ซึ่งอธิบายลักษณะที่ผู้ใช้เข้าถึงเพลย์ลิสต์
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
ยอดดูเพลย์ลิสต์และเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
คำขอนี้จะเรียกข้อมูลยอดดูเพลย์ลิสต์ การเริ่มเล่นเพลย์ลิสต์ และเวลาในการรับชมโดยประมาณของเพลย์ลิสต์สำหรับเพลย์ลิสต์ในช่องของเจ้าของเนื้อหาอย่างน้อย 1 ช่อง ระบบจะรวบรวมเมตริกตามแหล่งที่มาของการเข้าชม โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยคอมมาของรหัสช่องสูงสุด 500 รหัสสำหรับแชแนล
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
รายงานวิดีโอ
เมตริกประเภทอุปกรณ์รายวันสำหรับวิดีโอที่อ้างสิทธิ์
คำค้นหานี้จะเรียกข้อมูลจำนวนการดูรายวันและเวลาในการรับชมโดยประมาณตามประเภทอุปกรณ์สำหรับวิดีโอที่อ้างสิทธิ์โดยเจ้าของเนื้อหาคนใดคนหนึ่ง ผลลัพธ์จะจัดกลุ่มตามวันสำหรับอุปกรณ์แต่ละประเภทที่มีการเล่นวิดีโอ ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
เมตริกระบบปฏิบัติการรายวันสำหรับวิดีโอที่อ้างสิทธิ์ซึ่งดูบนอุปกรณ์เคลื่อนที่
การค้นหานี้จะเรียกข้อมูลจำนวนการดูรายวันและเวลาในการรับชมโดยประมาณตามระบบปฏิบัติการ สำหรับการดูวิดีโอที่มีการอ้างสิทธิ์โดยเจ้าของเนื้อหาที่ระบุ ซึ่งเกิดขึ้นบนอุปกรณ์เคลื่อนที่ ผลลัพธ์จะจัดกลุ่มตามวันสำหรับระบบปฏิบัติการแต่ละระบบที่มีการเล่นวิดีโอ ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
เมตริกประเภทอุปกรณ์และระบบปฏิบัติการรายวัน
คำค้นหานี้จะเรียกข้อมูลจำนวนการดูรายวันและเวลาในการรับชมโดยประมาณสำหรับวิดีโอที่มีการอ้างสิทธิ์โดยเจ้าของเนื้อหารายใดรายหนึ่ง สถิติจะจัดกลุ่มตามระบบปฏิบัติการและประเภทอุปกรณ์ ผลลัพธ์จะจัดเรียงตามลำดับเวลา
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
รายงานเพลย์ลิสต์
เมตริกประเภทอุปกรณ์สำหรับการดูเพลย์ลิสต์บนระบบปฏิบัติการ Android
การค้นหานี้จะเรียกข้อมูลจำนวนการดูเพลย์ลิสต์และเวลาในการรับชมเพลย์ลิสต์โดยประมาณบนอุปกรณ์ Android สำหรับเพลย์ลิสต์ในช่องของเจ้าของเนื้อหาอย่างน้อย 1 ช่อง ระบบจะแสดงผลลัพธ์สำหรับอุปกรณ์แต่ละประเภทที่เกิดการดูเพลย์ลิสต์ โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง CHANNEL_ID
ในค่าพารามิเตอร์ filters
ด้วยรายการที่คั่นด้วยคอมมาของรหัสช่องสูงสุด 500 รหัสสำหรับแชแนล
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
เมตริกระบบปฏิบัติการสำหรับยอดดูเพลย์ลิสต์บนอุปกรณ์เคลื่อนที่
การค้นหานี้จะเรียกข้อมูลยอดดูของเพลย์ลิสต์และเวลาในการรับชมเพลย์ลิสต์โดยประมาณบนอุปกรณ์เคลื่อนที่สำหรับเพลย์ลิสต์ในช่องของเจ้าของเนื้อหา ระบบจะแสดงผลลัพธ์ของแต่ละระบบปฏิบัติการที่มีการดูเพลย์ลิสต์เกิดขึ้น
dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE
รายงานวิดีโอ
ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
รายงานนี้จะเรียกสถิติเกี่ยวกับกลุ่มอายุและเพศของผู้ชมในแคลิฟอร์เนียที่รับชมเนื้อหาที่เจ้าของเนื้อหาอ้างสิทธิ์ ผลลัพธ์จะจัดเรียงตามเพศ จากนั้นจึงจัดเรียงตามกลุ่มอายุ คุณแก้ไขคำค้นหานี้เพื่อเรียกข้อมูลสถิติเดียวกันของผู้ชมทั่วโลก หรือผู้ชมทั้งหมดในประเทศ ทวีป อนุทวีป หรือรัฐอื่นในสหรัฐอเมริกาได้โดยการปรับค่าพารามิเตอร์ filters
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
เมตริกการแชร์ ซึ่งรวบรวมตามบริการที่มีการแชร์วิดีโอ
คำขอนี้จะเรียกจำนวนครั้งที่ผู้ใช้ใช้ปุ่ม Share
เพื่อแชร์วิดีโอที่เจ้าของเนื้อหาอัปโหลด ผลลัพธ์จะรวบรวมโดยบริการแชร์ (Google+, Twitter ฯลฯ) และจัดเรียงตามจำนวนการแชร์จากมากไปหาน้อย
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
เมตริกการคงผู้ชมไว้ของวิดีโอ
รายงานนี้วัดความสามารถของวิดีโอในการรักษาผู้ชมเอาไว้ โดยจะดึงข้อมูลรายงานสำหรับวิดีโอได้เพียงครั้งละ 1 รายการเท่านั้น โปรดทราบว่าหากต้องการเรียกใช้การค้นหานี้ใน API Explorer คุณต้องแทนที่สตริง VIDEO_ID
ในค่าพารามิเตอร์ filters
ด้วยรหัสวิดีโอสำหรับวิดีโอที่อัปโหลดของคุณ โปรดทราบว่ารายงานการคงผู้ชมไว้ไม่รองรับความสามารถในการระบุค่าหลายค่าสำหรับตัวกรอง video
ในตัวอย่างนี้ รายงานใช้ตัวกรอง audienceType
เพื่อจำกัดการตอบกลับเพื่อให้มีเฉพาะข้อมูลการดูทั่วไป ซึ่งเป็นผลมาจากการดำเนินการโดยตรงของผู้ใช้ เช่น การค้นหาวิดีโอหรือการคลิกวิดีโอแนะนำ ดังนั้น รายงานจึงไม่มีข้อมูลการดูจากโฆษณา TrueView ในสตรีมหรือ TrueView แบบบนหน้าจอ คุณสามารถนำตัวกรองออกเพื่อดึงข้อมูลการคงผู้ชมไว้ของวิดีโอออกจากกลุ่มเป้าหมายทุกประเภท
โปรดทราบว่าข้อมูลสำหรับตัวกรอง audienceType
จะพร้อมใช้งานตั้งแต่วันที่ 25 กันยายน 2013 API จะไม่แสดงข้อมูลสำหรับคำค้นหาที่ใช้ตัวกรองเพื่อพยายามดึงข้อมูลจากวันก่อนหน้า ข้อความค้นหาที่ไม่ใช้ตัวกรองนั้นจะใช้ได้กับวันที่ใดๆ หลังจากวันที่ 1 กรกฎาคม 2008
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
เมตริกรายได้และประสิทธิภาพโฆษณาสำหรับเนื้อหาที่มีการอ้างสิทธิ์
คำขอนี้จะดึงเมตริกรายได้และประสิทธิภาพโฆษณาของเนื้อหาที่เจ้าของเนื้อหาอ้างสิทธิ์ รายงานจะแสดงแถวเดี่ยวของข้อมูลที่มีผลรวมของเมตริกที่ขอแต่ละรายการในช่วงวันที่ที่ระบุ
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
เมตริกรายได้และประสิทธิภาพโฆษณารายวัน
คำขอนี้จะเรียกรายได้รายวันและเมตริกประสิทธิภาพโฆษณาสำหรับเนื้อหาที่เจ้าของเนื้อหาอ้างสิทธิ์
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
เมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศ
คำขอนี้ดึงเมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศสำหรับเนื้อหาที่เจ้าของเนื้อหาอ้างสิทธิ์ ผลลัพธ์จะจัดเรียงตามจำนวนรายได้จากมากไปน้อย ซึ่งหมายความว่าประเทศแรกที่แสดงในรายการจะเป็นประเทศที่พาร์ทเนอร์มีรายได้โดยประมาณสูงสุด
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
10 อันดับแรก – วิดีโอที่สร้างรายได้สูงสุด
คำขอนี้จะดึงเมตริกรายได้และประสิทธิภาพโฆษณาสำหรับวิดีโอ 10 รายการที่เจ้าของเนื้อหาอ้างสิทธิ์และสร้างรายได้สูงสุด ผลลัพธ์จะจัดเรียงตามจำนวนรายได้จากมากไปหาน้อย ซึ่งหมายความว่าวิดีโอแรกจะเป็นวิดีโอที่มีรายได้โดยประมาณสูงสุด
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed maxResults=10 sort=-estimatedRevenue
เมตริกประสิทธิภาพโฆษณาสำหรับโฆษณาประเภทต่างๆ
คำขอนี้จะเรียกเมตริกประสิทธิภาพโฆษณาสำหรับเนื้อหาที่เจ้าของเนื้อหาอ้างสิทธิ์ ผลลัพธ์จะจัดกลุ่มตามประเภทโฆษณา ซึ่งช่วยให้คุณเปรียบเทียบรายได้และค่า CPM ในโฆษณาประเภทต่างๆ ได้
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType