אנחנו מעדכנים את ממשקי ה-API של YouTube Analytics ושל Reporting API בהתאם לאופן שבו YouTube סופר צפיות ב-Shorts.
מידע נוסף
ReportTypes
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משאב reportType
מזהה דוח ספציפי שערוץ או בעלי תוכן יכולים לאחזר.
שיטות
בטבלה הבאה מוצגות ה-methods שבהן ה-API תומך למשאבי report
.
שיטות |
list |
מחזירה רשימה של סוגי דוחות שהערוץ או בעלי התוכן יכולים לאחזר. |
מאפיינים
בטבלה הבאה מוגדרים המאפיינים שמופיעים במשאב הזה:
מאפיינים |
id |
string
המזהה שמשמש את YouTube לזיהוי ייחודי של הדוח. האורך המקסימלי של ערך המאפיין הוא 100 תווים. בטבלה שלמטה מוצגת הגרסה העדכנית ביותר של כל סוג דוח נתמך (עד 100 תווים).
הצגת דוחות נתמכים של ערוצים
דוחות |
channel_basic_a2 |
פעילות משתמש |
channel_province_a2 |
פעילות משתמשים לפי פרובינציה |
channel_playback_location_a2 |
מקומות שבהם הסרטון הופעל |
channel_traffic_source_a2 |
מקורות תנועה |
channel_device_os_a2 |
המכשיר (Device) ומערכת ההפעלה (operating system) |
channel_demographics_a1 |
דמוגרפיה |
channel_sharing_service_a1 |
שירותי שיתוף |
channel_annotations_a1 |
הערות |
channel_cards_a1 |
כרטיסים |
channel_end_screens_a1 |
מסכי סיום |
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 |
המכשיר (Device) ומערכת ההפעלה (operating system) |
content_owner_demographics_a1 |
דמוגרפיה |
content_owner_sharing_service_a1 |
שירותי שיתוף |
content_owner_annotations_a1 |
הערות |
content_owner_cards_a1 |
כרטיסים |
content_owner_end_screens_a1 |
מסכי סיום |
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 |
מסכי סיום של נכסים |
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 תיצור דוחות חדשים למשימה למשך שלושה חודשים לאחר פרסום תאריך ההוצאה משימוש.
לדוגמה, ב-19 במאי 2016 הודענו על הוצאה משימוש של הדוח content_owner_basic_a1 . לכן, השדה deprecateTime עבור סוג הדוח הזה מציין את השעה ב-19 באוגוסט 2016. לאחר מכן, המערכת של YouTube תפסיק להפיק דוחות מהסוג הזה. |
systemManaged |
boolean
הערך הזה הוא true אם המערכת של YouTube יוצרת את הדוח באופן אוטומטי עבור בעלי תוכן ב-YouTube שאינם בעלי תוכן שצריכים להפעיל קודם את השיטה jobs.create כדי להנחות את YouTube להפיק את הדוח. למעשה, השיטה jobs.create מחזירה שגיאה אם הנכס reportTypeId מזהה דוח שמנוהל על ידי מערכת. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-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"]],["עדכון אחרון: 2024-08-21 (שעון UTC)."],[[["A `reportType` resource in the YouTube API defines a specific report that can be retrieved by a channel or content owner."],["The API supports listing available report types via the `reportTypes.list` method, enabling users to identify the reports they can access."],["Each `reportType` resource is represented in JSON and includes properties such as `id`, `name`, `deprecateTime`, and `systemManaged`, detailing the report's identifier, name, deprecation status, and whether it is system-managed."],["The `id` property of a report type can help identify the most recent version of the report, and there are different reports for channels, content owners and system managed."],["The `systemManaged` property indicates whether a report is automatically generated by YouTube for content owners, or if they need to use the jobs.create method to initiate report generation."]]],["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"]]