ReportTypes
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
แหล่งข้อมูล reportType ระบุรายงานที่เจาะจงซึ่งช่องหรือเจ้าของเนื้อหาจะเรียกดูได้
เมธอด
ตารางต่อไปนี้แสดงวิธีการที่ API รองรับสำหรับทรัพยากร report
| เมธอด |
list |
แสดงผลรายการของประเภทรายงานที่ช่องหรือเจ้าของเนื้อหาสามารถดึงข้อมูลได้ |
การแสดงทรัพยากร JSON
โครงสร้าง JSON ด้านล่างแสดงรูปแบบของทรัพยากร reportType
{
"id": string,
"name": string,
"deprecateTime": timestamp,
"systemManaged": boolean
}
พร็อพเพอร์ตี้
ตารางต่อไปนี้จะระบุพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
| พร็อพเพอร์ตี้ |
id |
string
รหัสที่ YouTube ใช้เพื่อระบุรายงานโดยไม่ซ้ำกัน ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 100 อักขระ ตารางด้านล่างระบุเวอร์ชันล่าสุดของรายงานแต่ละประเภทที่รองรับ (สูงสุด 100 อักขระ)
ดูรายงานที่รองรับสำหรับแชแนล
| รายงาน |
| channel_basic_a2 |
กิจกรรมผู้ใช้ |
| channel_province_a2 |
กิจกรรมของผู้ใช้ตามจังหวัด |
| channel_playback_location_a2 |
ตำแหน่งที่เล่น |
| channel_traffic_source_a2 |
แหล่งที่มาของการเข้าชม |
| channel_device_os_a2 |
อุปกรณ์และระบบปฏิบัติการ |
| channel_demographics_a1 |
ข้อมูลประชากร |
| channel_sharing_service_a1 |
การแชร์บริการ |
| channel_annotations_a1 |
คำอธิบายประกอบ |
| channel_cards_a1 |
การ์ด |
| channel_end_screens_a1 |
End Screen |
| channel_subtitles_a2 |
คำบรรยาย |
| channel_combined_a2 |
แบบรวม |
| audience_retention_a1 |
การคงผู้ชมไว้สำหรับวิดีโอ |
| playlist_basic_a1 |
กิจกรรมของผู้ใช้เพลย์ลิสต์ |
| playlist_province_a1 |
กิจกรรมของผู้ใช้เพลย์ลิสต์ตามจังหวัด |
| playlist_playback_location_a1 |
ตำแหน่งการเล่นเพลย์ลิสต์ |
| playlist_traffic_source_a1 |
แหล่งที่มาของการเข้าชมเพลย์ลิสต์ |
| playlist_device_os_a1 |
อุปกรณ์และระบบปฏิบัติการของเพลย์ลิสต์ |
| playlist_combined_a1 |
รวมเพลย์ลิสต์ |
ดูรายงานที่รองรับสำหรับเจ้าของเนื้อหา
| รายงาน |
| content_owner_basic_a3 |
กิจกรรมผู้ใช้ |
| content_owner_province_a2 |
กิจกรรมของผู้ใช้ตามจังหวัด |
| content_owner_playback_location_a2 |
ตำแหน่งที่เล่น |
| content_owner_traffic_source_a2 |
แหล่งที่มาของการเข้าชม |
| content_owner_device_os_a2 |
อุปกรณ์และระบบปฏิบัติการ |
| content_owner_demographics_a1 |
ข้อมูลประชากร |
| content_owner_sharing_service_a1 |
การแชร์บริการ |
| content_owner_annotations_a1 |
คำอธิบายประกอบ |
| content_owner_cards_a1 |
การ์ด |
| content_owner_end_screens_a1 |
End Screen |
| content_owner_subtitles_a2 |
คำบรรยาย |
| content_owner_combined_a2 |
แบบรวม |
| content_owner_playlist_basic_a1 |
กิจกรรมของผู้ใช้เพลย์ลิสต์ |
| content_owner_playlist_province_a1 |
กิจกรรมของผู้ใช้เพลย์ลิสต์ตามจังหวัด |
| content_owner_playlist_playback_location_a1 |
ตำแหน่งการเล่นเพลย์ลิสต์ |
| content_owner_playlist_traffic_source_a1 |
แหล่งที่มาของการเข้าชมเพลย์ลิสต์ |
| content_owner_playlist_device_os_a1 |
อุปกรณ์และระบบปฏิบัติการของเพลย์ลิสต์ |
| content_owner_playlist_combined_a1 |
รวมเพลย์ลิสต์ |
| content_owner_ad_rates_a1 |
ประสิทธิภาพโฆษณา |
| content_owner_estimated_revenue_a1 |
รายได้โดยประมาณตามวิดีโอ |
| content_owner_asset_estimated_revenue_a1 |
รายได้โดยประมาณตามเนื้อหา |
| content_owner_asset_basic_a2 |
กิจกรรมของผู้ใช้สำหรับเนื้อหา |
| content_owner_asset_province_a2 |
กิจกรรมของผู้ใช้ตามจังหวัดสำหรับเนื้อหา |
| content_owner_asset_playback_location_a2 |
ตำแหน่งการเล่นเนื้อหา |
| content_owner_asset_traffic_source_a2 |
แหล่งที่มาของการเข้าชมเนื้อหา |
| content_owner_asset_device_os_a2 |
อุปกรณ์และระบบปฏิบัติการของชิ้นงาน |
| content_owner_asset_demographics_a1 |
ข้อมูลประชากรชิ้นงาน |
| content_owner_asset_sharing_service_a1 |
บริการแชร์เนื้อหา |
| content_owner_asset_annotations_a1 |
คำอธิบายประกอบเนื้อหา |
| content_owner_asset_cards_a1 |
การ์ดเนื้อหา |
| content_owner_asset_end_screens_a1 |
End Screen ของเนื้อหา |
| content_owner_asset_combined_a2 |
รวมชิ้นงาน |
ดูรายงานที่ระบบจัดการระบบที่รองรับ (สำหรับเจ้าของเนื้อหา)
| รายงานที่จัดการโดยระบบ |
content_owner_ad_revenue_raw_a1 |
รายได้จากโฆษณาต่อวิดีโอแบบละเอียด |
content_owner_ad_revenue_summary_a1 |
รายได้รวมจากโฆษณาต่อวิดีโอ |
content_owner_asset_ad_revenue_raw_a1 |
รายได้จากโฆษณาแบบละเอียดต่อเนื้อหา |
content_owner_asset_ad_revenue_summary_a1 |
รายได้รวมจากโฆษณาต่อเนื้อหา |
content_owner_claim_ad_revenue_summary_a1 |
การอ้างสิทธิ์ (รายงานนี้ไม่มีข้อมูลรายได้) |
|
name |
string
ชื่อรายงาน ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 100 อักขระ |
deprecateTime |
timestamp
วันที่และเวลาที่มีการเลิกใช้งานหรือจะเลิกใช้งานรายงาน หากคุณมีงานสำหรับประเภทรายงานที่เลิกใช้งานแล้ว YouTube จะสร้างรายงานใหม่สำหรับงานดังกล่าวเป็นเวลา 3 เดือนหลังจากวันที่ประกาศการเลิกใช้งาน
ตัวอย่างเช่น ประกาศการเลิกใช้งานรายงาน content_owner_basic_a1 คือเมื่อวันที่ 19 พฤษภาคม 2016 ดังนั้น ช่อง deprecateTime ของรายงานประเภทดังกล่าวจึงระบุเวลาของวันที่ 19 สิงหาคม 2016 ซึ่งหลังจากนั้น YouTube จะหยุดสร้างรายงานประเภทดังกล่าว |
systemManaged |
boolean
ค่านี้คือ true หาก YouTube สร้างรายงานสำหรับเจ้าของเนื้อหา YouTube โดยอัตโนมัติโดยที่เจ้าของเนื้อหาไม่จำเป็นต้องเรียกใช้เมธอด jobs.create ก่อนเพื่อสั่งให้ YouTube สร้างรายงาน ที่จริงแล้ว เมธอด jobs.create จะแสดงข้อผิดพลาดหากพร็อพเพอร์ตี้ reportTypeId ระบุรายงานที่จัดการโดยระบบ |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-21 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-08-21 UTC"],[],["A `reportType` resource defines a retrievable report for channels or content owners. The API supports listing available `reportTypes`. Each `reportType` has an `id`, `name`, `deprecateTime`, and `systemManaged` status. The `id` property identifies the report's type, such as user activity or demographics. `SystemManaged` reports are generated automatically, whereas other reports have to be called using the `jobs.create` method. The deprecation date marks when report generation stops.\n"]]