היסטוריית תיקונים

בדף הזה מפורטים שינויים ב-API ועדכונים במסמכי התיעוד של YouTube Reporting API ושל YouTube Analytics API. שני ממשקי ה-API מאפשרים למפתחים לגשת לנתונים של YouTube Analytics, אבל בדרכים שונות. הרשמה ליומן השינויים הזה. הרשמה

‫25 ביוני 2026

המסמכים של YouTube Analytics API (שאילתות ממוקדות) עודכנו, והוסר מהם הדוח User activity by city (פעילות משתמשים לפי עיר) לבעלי תוכן. הדוח הזה לא נתמך לבעלי תוכן. שאילתות של בעלי תוכן לגבי פעילות משתמשים לפי עיר יחזירו תוצאות ריקות.

‫9 במרץ 2026

המאפיינים ageGroup (YouTube Analytics API) ו-age_group (YouTube Reporting API) כוללים עכשיו משתמשים ש-YouTube מעריכה שהם מתחת לגיל 18.

‫15 בינואר 2026

ה-API של YouTube Reporting תומך עכשיו בדוחות על היקף החשיפה של ערוצים ובעלי תוכן. בדוחות על טווח ההגעה מוצגים נתונים סטטיסטיים על חשיפות של תמונות ממוזערות של סרטונים ועל שיעורי קליקים.

  • הדוחות channel_reach_basic_a1 ו-channel_reach_combined_a1 זמינים לערוצים.
  • הדוחות content_owner_reach_basic_a1 ו-content_owner_reach_combined_a1 זמינים לבעלי תוכן.

הדוחות האלה תומכים במדדים החדשים הבאים:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

‫22 בספטמבר 2025

הוצאת הדוחות משימוש, שהודענו עליה בעבר, נדחתה מ-30 בספטמבר 2025 ל-31 באוקטובר 2025. עד אז, הגרסאות הקודמות של הדוחות שעודכנו בעקבות השינויים בספירת הצפיות בסרטוני Shorts ימשיכו להיות זמינות, למעט דוח התביעות גרסה 1.0 (content_owner_active_claims_a1) ודוח התביעות גרסה 1.1 (content_owner_active_claims_a2), שיוצאו משימוש ב-30 בספטמבר.

‫24 ביוני 2025

כפי שפורסם ב-26 במרץ 2025, נעדכן את Bulk Reports API כחלק מהשינוי החדש במספר הצפיות בסרטוני Shorts. בוצעו השינויים הבאים:

  • נוצרו גרסאות חדשות של כל הדוחות שכוללים תצוגות, כלומר רוב הדוחות. הגרסה של כל דוח מושפע עלתה באחד, למשל מגרסה a2 לגרסה a3.
  • בסרטוני Shorts, מספר הצפיות משקף עכשיו את מספר הפעמים שסרטון Shorts התחיל לפעול או הופעל מחדש. בסרטונים, לא חל שינוי.
  • הדוחות המעודכנים יכללו עמודה חדשה, engaged_views, שתשקף את השיטה הקודמת לספירת הצפיות.

השינויים האלה ייכנסו לתוקף ב-30 ביוני 2025, לגבי Bulk Reports API. חשוב להתאים את עיבוד הדוחות בהתאם.

גרסאות קודמות של הדוחות יהיו זמינות עד 30 בספטמבר 2025. אחרי 30 בספטמבר 2025, הגרסאות הקודמות יצאו משימוש. חשוב לעבור לגרסאות העדכניות ביותר.

לסיום, חשוב לפעול לפי השיטות המומלצות כשמעבדים את הדוחות, כדי למנוע מצב שבו שינויים בדוחות ישבשו את צינורות העיבוד שלכם בעתיד.

בטבלאות הבאות מוצגות הגרסאות החדשות של הדוחות לכל סוג דוח:

דוחות נתונים בכמות גדולה ב-YouTube Analytics

דוחות על ערוצים – דוחות על סרטונים
שם הדוח הגרסה הקודמת הגרסה האחרונה
פעילות משתמש channel_basic_a2 channel_basic_a3
פעילות המשתמשים לפי מחוז channel_province_a2 channel_province_a3
מקומות שבהם הסרטון הופעל channel_playback_location_a2 channel_playback_location_a3
מקורות תנועה channel_traffic_source_a2 channel_traffic_source_a3
סוג המכשיר ומערכת ההפעלה channel_device_os_a2 channel_device_os_a3
כתוביות channel_subtitles_a2 channel_subtitles_a3
משולב channel_combined_a2 channel_combined_a3
דוחות על ערוצים – דוחות על פלייליסטים
שם הדוח הגרסה הקודמת הגרסה האחרונה
פעילות משתמש playlist_basic_a1 playlist_basic_a2
פעילות המשתמשים לפי מחוז playlist_province_a1 playlist_province_a2
מקומות שבהם הסרטון הופעל playlist_playback_location_a1 playlist_playback_location_a2
מקורות תנועה playlist_traffic_source_a1 playlist_traffic_source_a2
סוג המכשיר ומערכת ההפעלה playlist_device_os_a1 playlist_device_os_a2
משולב playlist_combined_a1 playlist_combined_a2
דוחות של בעלי תוכן – דוחות על סרטונים
שם הדוח הגרסה הקודמת הגרסה האחרונה
פעילות משתמש content_owner_basic_a3 content_owner_basic_a4
פעילות המשתמשים לפי מחוז content_owner_province_a2 content_owner_province_a3
מקומות שבהם הסרטון הופעל content_owner_playback_location_a2 content_owner_playback_location_a3
מקורות תנועה content_owner_traffic_source_a2 content_owner_traffic_source_a3
סוג המכשיר ומערכת ההפעלה content_owner_device_os_a2 content_owner_device_os_a3
כתוביות content_owner_subtitles_a2 content_owner_subtitles_a3
משולב content_owner_combined_a2 content_owner_combined_a3
דוחות של בעלי תוכן – דוחות על פלייליסטים
שם הדוח הגרסה הקודמת הגרסה האחרונה
פעילות משתמש content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
פעילות המשתמשים לפי מחוז content_owner_playlist_province_a1 content_owner_playlist_province_a2
מקומות שבהם הסרטון הופעל content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
מקורות תנועה content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
סוג המכשיר ומערכת ההפעלה content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
משולב content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
דוחות של בעלי תוכן – דוחות נכסים
שם הדוח הגרסה הקודמת הגרסה האחרונה
פעילות משתמש content_owner_asset_basic_a2 content_owner_asset_basic_a3
פעילות המשתמשים לפי מחוז content_owner_asset_province_a2 content_owner_asset_province_a3
מקומות שבהם הסרטון הופעל content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
מקורות תנועה content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
סוג המכשיר ומערכת ההפעלה content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
משולב content_owner_asset_combined_a2 content_owner_asset_combined_a3

דוחות בניהול המערכת – פיננסיים (לא מוזיקה)

דוחות של בעלי תוכן – דוחות על סרטוני Shorts (לא מוזיקה)
שם הדוח הגרסה הקודמת הגרסה האחרונה
סיכום גלובלי של הכנסות מפרסום content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
סיכום יומי של ההכנסות מפרסום content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
סיכום ההכנסות מפרסום לפי מדינה content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
סיכום ההכנסות מפרסום content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

דוחות שמנוהלים על ידי המערכת – לא פיננסיים

דוחות של בעלי תוכן – דוחות תלונות על הפרת זכויות יוצרים
שם הדוח הגרסה הקודמת הגרסה האחרונה
דרישות בעלות פעילות content_owner_active_claims_a2 content_owner_active_claims_a3
דוחות של בעלי תוכן – דוחות של מטא-נתונים של סרטונים
שם הדוח הגרסה הקודמת הגרסה האחרונה
מטא נתונים של סרטון content_owner_video_metadata_a3 content_owner_video_metadata_a4
דוחות של בעלי תוכן – דוחות נכסים
שם הדוח הגרסה הקודמת הגרסה האחרונה
נכסים content_owner_asset_a2 content_owner_asset_a3
נכסים שיש לגביהם מחלוקות content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

‫24 באפריל 2025

כפי שפורסם ב-26 במרץ 2025, ממשק ה-API של שאילתות ממוקדות יעודכן כחלק מהשינוי החדש בספירת הצפיות בסרטוני Shorts:

  • בסרטוני Shorts, המדד views משקף עכשיו את מספר הפעמים שסרטון Shorts התחיל לפעול או הופעל מחדש.
  • מדד חדש, engagedViews, ישקף את שיטת הספירה הקודמת של הצפיות. העמודה engagedViews תהיה זמינה בכל הדוחות יחד עם views.

השינויים האלה ייכנסו לתוקף ב-30 באפריל 2025, לגבי Targeted Queries API. חשוב לשנות את השאילתות בהתאם.

בהיסטוריית הגרסאות הזו מפורטים השינויים שיבוצעו ב-Bulk Reports API ומתי הם יבוצעו.

‫22 באפריל 2025

כפי שפורסם ב-7 באפריל 2024, המאפיין isCurated יצא משימוש בדוחות של ערוצים ובדוחות של פלייליסטים של בעלי תוכן. החל מ-31 בדצמבר 2024, המאפיין הזה לא נתמך יותר. המאפיין הוסר מהדוחות ומהתיעוד.

‫26 במרץ 2025

העדכון הזה כולל את השינוי הבא שקשור לממשקי ה-API של YouTube Analytics ושל YouTube Reporting:

החל מ-31 במרץ 2025, נשנה ב-YouTube את האופן שבו הצפיות בסרטוני Shorts נספרות. בעבר, צפייה בסרטון Shorts נספרה אחרי שהסרטון הופעל למשך מספר מסוים של שניות. מספר הצפיות משקף עכשיו את מספר הפעמים שסרטון Shorts התחיל לפעול או הופעל מחדש, לא משנה לכמה זמן. מידע נוסף

ממשקי ה-API של YouTube Analytics (שאילתות ממוקדות) ושל YouTube Reporting (דוחות בכמות גדולה) יעודכנו עם השינויים הבאים:

  • בסרטוני Shorts, מספר הצפיות משקף את מספר הפעמים שסרטון Shorts התחיל לפעול או הופעל מחדש.views
  • מדד חדש, engagedViews, יהיה זמין וישקף את שיטת הספירה הקודמת של הצפיות.
  • אם אתם הבעלים של ערוץ או שיש לכם הרשאה לגשת לנתונים של ערוץ, תוכלו לשלוח שאילתות לגבי התצוגות המעודכנות והתצוגות עם מעורבות הצופים.

העדכון של 'שאילתות ממוקדות' יתבצע עד 30 באפריל, והעדכון של 'דוחות בכמות גדולה' יתבצע עד 30 ביוני. עד אז, הצפיות יתבססו על המתודולוגיה הישנה. מספר הצפיות בסרטוני Shorts ובסרטונים בערוץ לא יהיה זהה למספר הצפיות ב-Analytics ב-Studio.

בנוסף, הוצאה משימוש של הדוח 'תביעות יומיות' (גרסה 1.0), שהודע עליה בעבר, נדחתה.

בהיסטוריית הגרסאות הזו אפשר לראות מתי בוצעו שינויים בממשקי ה-API.

‫3 במרץ 2025

העדכון הזה כולל את השינוי הבא שקשור ל-YouTube Reporting API:

הערה: זוהי הודעה על הוצאה משימוש.

הוצאנו משימוש את הדוח תביעות יומיות (גרסה 1.0) לשותפים. התמיכה בו תופסק ב-30 באפריל 2025 או לפני כן. ההגדרה של הדוח הזה עודכנה בהתאם. במקומו, אפשר להשתמש בדוח העדכני בנושא תביעות יומיות.

‫15 בנובמבר 2024

הערה: השינוי הבא ייכנס לתוקף ב-18 בנובמבר 2024.

עדכנו את התיעוד של YouTube Analytics (Targeted Queries) API כדי לציין שבדוחות של מקורות תנועה, השיטה reports.query של ה-API מחזירה עכשיו שגיאה אם המכפלה של מספר הסרטונים שנכללו בשאילתה כפול מספר הימים בטווח התאריכים גדולה מ-50,000. לדוגמה, שאילתה שמחזירה נתונים של 500 מזהי סרטונים יכולה לבקש נתונים של 100 ימים לכל היותר.

השינוי הזה משפיע על דוחות של ערוצים ושל בעלי תוכן.

כדי להקטין את מספר השורות שמוחזרות בבקשה, אפשר לפצל את השאילתה לכמה שאילתות שבהן מצוינים פחות סרטונים או טווחי תאריכים קצרים יותר. ככלל, מומלץ להשתמש בדוחות בכמות גדולה כשמדובר במערכי נתונים גדולים.

‫6 במאי 2024

ה-API של YouTube Analytics (שאילתות ממוקדות) תומך בשלושה דוחות חדשים לערוצים:

בנוסף, שיפרנו את הדוח שימור קהל כך שיכלול שלושה מדדים חדשים:

‫7 באפריל 2024

בוצעו כמה עדכונים ב-API של YouTube Analytics (שאילתות ממוקדות) שקשורים לדוחות של פלייליסטים של בעלי תוכן. העדכונים האלה זהים לעדכונים שקשורים לדוחות על פלייליסטים בערוץ, שעליהם הודענו ב-19 בינואר 2024.

הערך הבא בהיסטוריית גרסאות מספק כמעט את אותו מידע כמו הערך מ-19 בינואר 2024. עם זאת, חשוב לזכור שדוחות על פלייליסטים של בעלי תוכן יתמכו במאפיין isCurated עד 31 בדצמבר 2024, בעוד שדוחות על פלייליסטים של ערוצים יתמכו במאפיין עד 30 ביוני 2024.

  • הערה: זוהי הודעה על הוצאה משימוש.

    המאפיין isCurated יצא משימוש בדוחות של בעלי תוכן בנושא פלייליסטים. התמיכה בו תופסק ב-31 בדצמבר 2024. ההגדרה של המאפיין הזה עודכנה בהתאם.

    כדי לשמור על תאימות לאחור כשמסירים את המאפיין isCurated, צריך גם לעדכן את הקוד כדי לאחזר את המדד playlistViews במקום את המדד views בדוחות של פלייליסטים בלבד. מאחר שהמדד views עדיין נתמך בדוחות על פלייליסטים, גם אם המשמעות שלו שונה, ה-API עדיין יחזיר נתונים אם לא תעדכנו את שם המדד. כמובן שאפשר לשנות את האפליקציה כדי לאחזר ולהציג גם את views וגם את playlistViews.

    בנוסף למאפיין isCurated, הפונקציונליות הבאה של ה-API לא נתמכת יותר בדוחות החדשים:

    • אין תמיכה במסנני מיקום, כמו continent ו-subcontinent, בדוחות החדשים של פלייליסטים בערוץ.
    • המדדים redViews ו-estimatedRedMinutesWatched כבר לא נתמכים בדוחות החדשים של פלייליסטים בערוץ. המדדים האלה לא היו זמינים ב-YouTube Studio, ולכן השינוי הזה מתאים את הפונקציונליות של ה-API לפונקציונליות שזמינה באפליקציית Studio.
    • המאפיינים subscribedStatus ו-youtubeProduct לא נתמכים יותר כמסננים בדוחות של פלייליסטים בערוץ. המסננים האלה לא היו זמינים ב-YouTube Studio, ולכן השינוי הזה מתאים את הפונקציונליות של ה-API לפונקציונליות שזמינה באפליקציית Studio.

  • הקטע playlist reports במסמכי התיעוד בנושא דוחות של בעלי תוכן עודכן כדי להסביר בצורה מפורטת יותר את סוגי המדדים שנתמכים בדוחות של פלייליסטים:

    • מדדים מצטברים של סרטונים מספקים מדדים של פעילות משתמשים וחשיפות שמצטברים עבור כל הסרטונים בפלייליסטים של בעלי התוכן, שהם גם הבעלים של התוכן הזה. מדדי וידאו מצטברים נתמכים רק בבקשות ל-API שלא נעשה בהן שימוש במאפיין isCurated.
    • מדדים שקשורים לפלייליסט משקפים את פעילות המשתמש והמעורבות בהקשר של דף הפלייליסט. המדדים האלה כוללים גם נתונים של צפיות בסרטונים שלא נמצאים בבעלותכם בפלייליסט, אבל רק אם הצפיות האלה התרחשו בהקשר של הפלייליסט.
    • בקטע מדדים נתמכים של פלייליסטים מפורטים מדדים מצטברים של סרטונים ומדדים של פלייליסטים שנתמכים בדוחות על פלייליסטים.

  • בעלי תוכן יכולים לראות בדוחות על פלייליסטים את המדדים החדשים הבאים שקשורים לפלייליסטים: הערה: המדדים האלה נתמכים רק אם בקשת ה-API לאחזור הדוחות לא משתמשת במאפיין isCurated. הגדרות של כל מדד מפורטות במאמר בנושא מדדים.

  • ההתנהגות של המדד views תלויה עכשיו בשאלה אם בקשת ה-API שאחזרה את דוח הפלייליסט השתמשה במאפיין isCurated:

    • כשבקשה כוללת את מאפיין isCurated, המדד views הוא מדד שקשור לפלייליסט ומציין את מספר הפעמים שצפו בסרטונים בהקשר של הפלייליסטים של בעלי התוכן.
    • אם הבקשה לא כוללת את המאפיין isCurated, המדד views הוא מדד מצטבר של סרטונים שמציין את המספר הכולל של הפעמים שבהן אנשים צפו בסרטונים בפלייליסטים של בעל התוכן, בלי קשר לשאלה אם הצפיות האלה התרחשו בהקשר של הפלייליסט. הסכום הכולל המצטבר כולל רק צפיות בסרטונים שנמצאים בבעלות של בעלי התוכן שמשויכים לערוץ שבבעלותו נמצא הפלייליסט.

      בדוחות האלה, שלא נעשה בהם שימוש במאפיין isCurated, המדד playlistViews מציין את מספר הפעמים שהסרטונים נצפו בהקשר של הפלייליסט. המדד הזה סופר את הצפיות בכל הסרטונים בפלייליסט, לא משנה לאיזה ערוץ הם שייכים.

  • במסמכי התיעוד של דוחות בעלי תוכן מופיעות עכשיו טבלאות עם מדדים נתמכים לכל דוח של פלייליסט, בהתאם לשאלה אם בקשת ה-API כוללת את המאפיין isCurated. דוגמה מופיעה בקטע שבו מוגדרים דוחות פלייליסטים מבוססי-זמן.

‫19 בינואר 2024

בוצעו כמה עדכונים ב-YouTube Analytics (Targeted Queries) API שקשורים לדוחות של פלייליסטים בערוץ. העדכונים כוללים מאפיין שהוצא משימוש וכמה מדדים חדשים ומעודכנים:

  • הערה: זוהי הודעה על הוצאה משימוש.

    המאפיין isCurated הוצא משימוש בדוחות על ערוצים. התמיכה בו תופסק ב-30 ביוני 2024 או אחרי התאריך הזה. ההגדרה של המאפיין הזה עודכנה בהתאם.

    כדי לשמור על תאימות לאחור כשמסירים את המאפיין isCurated, צריך גם לעדכן את הקוד כדי לאחזר את המדד playlistViews במקום את המדד views בדוחות של פלייליסטים בלבד. מאחר שהמדד views עדיין נתמך בדוחות על פלייליסטים, גם אם המשמעות שלו שונה, ה-API עדיין יחזיר נתונים אם לא תעדכנו את שם המדד. כמובן שאפשר לשנות את האפליקציה כדי לאחזר ולהציג גם את views וגם את playlistViews.

    בנוסף למאפיין isCurated, הפונקציונליות הבאה של ה-API לא נתמכת יותר בדוחות החדשים:

    • אין תמיכה במסנני מיקום, כמו continent ו-subcontinent, בדוחות החדשים של פלייליסטים בערוץ.
    • המדדים redViews ו-estimatedRedMinutesWatched כבר לא נתמכים בדוחות החדשים של פלייליסטים בערוץ. המדדים האלה לא היו זמינים ב-YouTube Studio, ולכן השינוי הזה מתאים את הפונקציונליות של ה-API לפונקציונליות שזמינה באפליקציית Studio.
    • המאפיינים subscribedStatus ו-youtubeProduct לא נתמכים יותר כמסננים בדוחות של פלייליסטים בערוץ. המסננים האלה לא היו זמינים ב-YouTube Studio, ולכן השינוי הזה מתאים את הפונקציונליות של ה-API לפונקציונליות שזמינה באפליקציית Studio.

  • הקטע דוחות על פלייליסטים במסמכי התיעוד של דוחות הערוץ עודכן, ועכשיו מוסבר בו בצורה מפורטת יותר אילו סוגי מדדים נתמכים בדוחות על פלייליסטים:

    • מדדים מצטברים של סרטונים מספקים מדדים של פעילות משתמשים וחשיפות שמצטברים עבור כל הסרטונים בפלייליסטים של הערוץ, שהערוץ הוא גם הבעלים שלהם. מדדי וידאו מצטברים נתמכים רק בבקשות ל-API שלא נעשה בהן שימוש במאפיין isCurated.
    • מדדים שקשורים לפלייליסט משקפים את פעילות המשתמש והמעורבות בהקשר של דף הפלייליסט. המדדים האלה כוללים גם נתונים של צפיות בסרטונים שלא נמצאים בבעלותכם בפלייליסט, אבל רק אם הצפיות האלה התרחשו בהקשר של הפלייליסט.
    • בקטע מדדים נתמכים של פלייליסטים מפורטים מדדים מצטברים של סרטונים ומדדים של פלייליסטים שנתמכים בדוחות על פלייליסטים.

  • המדדים החדשים הבאים בתוך הפלייליסט נתמכים בדוחות על פלייליסטים של ערוצים. עדיין אין תמיכה במדדים האלה בדוחות של בעלי תוכן. שימו לב שהמדדים האלה נתמכים רק אם בקשת ה-API לאחזור הדוחות לא משתמשת במאפיין isCurated. הגדרות של כל מדד מפורטות במאמר בנושא מדדים.

  • ההתנהגות של המדד views תלויה עכשיו בשאלה אם בקשת ה-API שאחזרה את דוח הפלייליסט השתמשה במאפיין isCurated:

    • כשבקשה כוללת את המאפיין isCurated, המדד views הוא מדד שקשור לפלייליסט ומציין את מספר הפעמים שאנשים צפו בסרטונים בהקשר של הפלייליסטים של הערוץ.
    • אם הבקשה לא כוללת את המאפיין isCurated, המדד views הוא מדד מצטבר של סרטון שמציין את המספר הכולל של הפעמים שבהן אנשים צפו בסרטון בפלייליסטים של הערוץ, בלי קשר לשאלה אם הצפיות האלה התרחשו בהקשר של הפלייליסט. הסכום הכולל המצטבר כולל רק צפיות בסרטונים שנמצאים בבעלות הערוץ שהפלייליסט שייך לו.

      בדוחות האלה, שלא נעשה בהם שימוש במאפיין isCurated, המדד playlistViews מציין את מספר הפעמים שהסרטונים נצפו בהקשר של הפלייליסט. המדד הזה סופר את הצפיות בכל הסרטונים בפלייליסט, לא משנה לאיזה ערוץ הם שייכים.

  • במסמכי התיעוד של דוחות הערוצים לכל דוח של פלייליסט, יש עכשיו טבלאות שבהן מוצגים המדדים הנתמכים בדוח הזה, בהתאם לשאלה אם בקשת ה-API כוללת את המאפיין isCurated. דוגמה מופיעה בקטע שבו מוגדרים דוחות פלייליסטים מבוססי-זמן.

‫4 בדצמבר 2023

ה-API של YouTube Analytics (שאילתות ממוקדות) עודכן כך שיאחד שני ערכים של מאפיינים: insightTrafficSourceType. בעבר, המימד הבחין בין סרטונים שהופעלו כחלק מפלייליסט (PLAYLIST) לבין צפיות שמקורן בדף שבו מפורטים כל הסרטונים בפלייליסט (YT_PLAYLIST_PAGE). מעכשיו, שני סוגי הצפיות ישויכו לערך המימד PLAYLIST.

‫15 בדצמבר 2022

‫YouTube Analytics API (שאילתות ממוקדות) תומך בשני מאפיינים חדשים ובדוח חדש אחד:

  • דוח חדש מספק נתוני פעילות משתמשים לפי עיר. הדוח הזה זמין לערוצים ולבעלי תוכן. הדוח הזה מכיל את המאפיין החדש city שמציין את ההערכה של YouTube לגבי העיר שבה התרחשה פעילות המשתמש.

  • המאפיין החדש creatorContentType מזהה את סוג התוכן ב-YouTube שמשויך למדדים של פעילות המשתמש בשורת הנתונים. הערכים הנתמכים הם LIVE_STREAM,‏ SHORTS,‏ STORY ו-VIDEO_ON_DEMAND.

    המאפיין creatorContentType נתמך כמאפיין אופציונלי בכל הדוחות על סרטונים של ערוצים ובעלי תוכן.

  • במדריך בקשות לדוגמה של YouTube Analytics API, יש עכשיו דוגמאות לשני המאפיינים החדשים.

  • ההפניות למאפיינים 7DayTotals ו-30DayTotals הוסרו מהתיעוד. הודענו על הוצאת המאפיינים האלה משימוש באוקטובר 2019.

‫26 באוגוסט 2022

ממשק ה-API של YouTube Analytics (שאילתות ממוקדות) וממשק ה-API של YouTube Reporting (דוחות בכמות גדולה) תומכים שניהם בערך חדש של פרטי מקור תנועה:

  • ב-YouTube Analytics API (Targeted Queries) API, אם הערך של המאפיין insightTrafficSourceType הוא SUBSCRIBER, אפשר להגדיר את הערך של insightTrafficSourceDetail כ-podcasts, שמציין שהתנועה הופנתה מדף היעד של הפודקאסטים.
  • ב-YouTube Reporting (Bulk Reports) API, אם הערך של המאפיין traffic_source_type הוא 3, אפשר להגדיר את הערך traffic_source_detail כ-podcasts, שמציין שהתנועה הופנתה מדף היעד של פודקאסטים.

11 בפברואר 2022

קבוצת הערכים התקפים למאפיין gender תשתנה ב-11 באוגוסט 2022 או אחריו. יכול להיות שזה שינוי ביישום ה-API שלא תואם לאחור. בהתאם לקטע שינויים שאינם תואמים לאחור בתנאים ובהגבלות של שירותי ה-API של YouTube, אנחנו מודיעים על השינוי הזה שישה חודשים לפני שהוא ייכנס לתוקף. כדי שהמעבר לסט הערכים החדש יהיה חלק, צריך לעדכן את הטמעת ה-API לפני 11 באוגוסט 2022.

השינויים הספציפיים שמתבצעים הם:

  • ב-API של YouTube Analytics (שאילתות ממוקדות), המאפיין gender תומך כרגע בשני ערכים: female ו-male. החל מ-11 באוגוסט 2022, המאפיין הזה יתמוך בשלושה ערכים: female,‏ male ו-user_specified.
  • ב-YouTube Reporting (Bulk Reports) API, המאפיין gender תומך כרגע בשלושה ערכים: FEMALE,‏ MALE ו-GENDER_OTHER. החל מ-11 באוגוסט 2022, קבוצת הערכים הנתמכים תשתנה ל-FEMALE, MALE ו-USER_SPECIFIED.

‫9 בפברואר 2022

ב-13 בדצמבר 2021 עדכנו שני מדדים כך שלא יכללו תנועת גולשים מסרטונים שמופעלים בלופ. השינוי הזה משפיע גם על YouTube Analytics API (שאילתות ממוקדות) וגם על YouTube Reporting API (דוחות בכמות גדולה).

2 בפברואר 2022

ה-API של YouTube Reporting (דוחות בכמות גדולה) תומך בערך חדש של מאפיין מקורות התנועה שמציין שהצפיות הגיעו מהפניות אוטומטיות לשידור חי:

  • ב-YouTube Reporting (Bulk Reports) API, המאפיין traffic_source_type תומך בערך 28.

עבור סוג המקור הזה לתנועה, המאפיין traffic_source_detail מציין את מזהה הערוץ שממנו הופנה הצופה.

23 בספטמבר 2020

‫YouTube Analytics (Targeted Queries) API ו-YouTube Reporting (Bulk Reports) API תומכים שניהם בערך חדש של מאפיין מקורות התנועה שמציין שהצופים הופנו על ידי החלקה אנכית בחוויית הצפייה ב-YouTube Shorts:

  • בממשק YouTube Analytics API (Targeted Queries) API, המאפיין insightTrafficSourceType תומך בערך SHORTS.
  • ב-YouTube Reporting (Bulk Reports) API, המאפיין traffic_source_type תומך בערך 24.

מאפיין הפרטים של מקור התנועה – insightTrafficSourceDetail ב-YouTube Analytics API או traffic_source_detail ב-YouTube Reporting API – לא מאוכלס עבור סוג מקור התנועה החדש הזה.

‫20 ביולי 2020

העדכון הזה כולל שני שינויים שמשפיעים על ה-API של YouTube Analytics (שאילתות ממוקדות):

  • הגודל המקסימלי של קבוצת דיווח ב-YouTube Analytics גדל מ-200 ל-500 ישויות.
  • הפרמטר reports.query של השיטה filters מציין רשימה של מסננים שצריך להחיל כשמאחזרים נתונים מ-YouTube Analytics. הפרמטר תומך באפשרות לציין כמה ערכים למסננים video, playlist ו-channel, ומספר המזהים המקסימלי שאפשר לציין למסננים האלה גדל מ-200 ל-500.

‫13 בפברואר 2020

העדכון הזה כולל את השינויים הבאים שקשורים ל-API של YouTube Analytics (שאילתות ממוקדות) ול-API של YouTube Reporting (דוחות בכמות גדולה). אפשר לקרוא מידע נוסף על השינויים האלה במרכז העזרה של YouTube.

בשני ממשקי ה-API, קבוצת הערכים האפשריים של פרטי מקורות התנועה עבור התראות משתנה. בשאילתות ממוקדות, ההתראות מדווחות כ-insightTrafficSourceType=NOTIFICATION. בדוחות מרוכזים, ההתראות מדווחות כtraffic_source_type=17.

הערכים החדשים מפצלים את ההתראות שקשורות לסרטונים שהועלו ולשידורים חיים, שבעבר דווחו כuploaded, לשתי קטגוריות:

  • ‫uploaded_push – צפיות שהגיעו מהתראות שנשלחו למנויים כשהסרטון הועלה
  • ‫uploaded_other – צפיות שהגיעו מהתראות שאינן התראות פוש, כמו התראות באימייל או בתיבת הדואר הנכנס, שנשלחות למנויים כשסרטון מועלה.

הערכים האלה מוחזרים עבור טווח הזמן שמתחיל ב-2020-01-13 (13 בינואר 2020).

בנוסף, חשוב לזכור שהערכים האלה לא מייצגים את ההתראות עצמן, אלא את מקורות התנועה שהניבו צפיות מסוימות ב-YouTube. לדוגמה, אם בשורה בדוח מופיעים הערכים views=3,‏ traffic_source_type=17 (NOTIFICATION) ו-traffic_source_detail=uploaded_push, המשמעות היא ששלוש צפיות התקבלו מצופים שלחצו על התראות פוש שנשלחו כשהסרטון הועלה.

15 באוקטובר 2019

העדכון הזה כולל את השינויים הבאים שקשורים ל-API של YouTube Analytics (שאילתות ממוקדות):

  • הערה: זוהי הודעה על הוצאה משימוש.

    אנחנו מסירים מ-YouTube את התמיכה במאפיינים 7DayTotals ו-30DayTotals. עדיין אפשר לאחזר נתונים באמצעות המאפיינים האלה עד 15 באפריל 2020. החל מהתאריך הזה, ניסיונות לאחזר דוחות באמצעות המאפיין 7DayTotals או 30DayTotals יחזירו שגיאה.

    הערה: משתמשים יכולים לשחזר חלק מהנתונים של המאפיינים האלה באמצעות שאילתה עם המאפיין day וצבירה או גזירה של נתונים על פני תקופות של שבעה או 30 ימים. לדוגמה:

    • כדי לחשב את מספר הצפיות לתקופה של שבעה ימים, צריך לסכם את מספר הצפיות מכל יום בתקופה הזו.
    • אפשר לחשב את viewerPercentage לתקופה של שבעה ימים על ידי הכפלת מספר הצפיות שהתרחשו בכל יום ב-viewerPercentage של אותו יום, כדי לקבל את מספר הצופים שהיו מחוברים לחשבון כשהם צפו בסרטון באותו יום. לאחר מכן, אפשר לחבר את מספר הצופים המחוברים לכל התקופה ולחלק אותו במספר הצפיות הכולל באותה תקופה כדי לקבל את viewerPercentage לכל התקופה.
    • אי אפשר לחשב את מספר הצופים הייחודיים לתקופה של שבעה ימים, כי אותו צופה יכול להיספר כצופה ייחודי בימים שונים. עם זאת, יכול להיות שתוכלו להשתמש במאפיין month במקום במאפיין 30DayTotals כדי להסיק נתונים על מספר הצופים הייחודיים בפרק זמן של 30 יום. שימו לב שהמאפיין month מתייחס לחודשים קלנדריים, ואילו המאפיין 30DayTotals מחשב תקופות של 30 ימים על סמך תאריך ההתחלה ותאריך הסיום שצוינו.

27 ביוני 2019

העדכון הזה כולל את השינויים הבאים שקשורים ל-API של YouTube Analytics (שאילתות ממוקדות):

  • מאחר שגרסה 1 של ה-API הוצאה משימוש באופן סופי, עדכנו את התיעוד והסרנו ממנו הפניות לגרסה הזו, כולל הודעת ההוצאה משימוש ומדריך ההעברה שמסביר איך לעדכן לגרסה 2.

‫1 בנובמבר 2018

העדכון הזה כולל את השינויים הבאים שקשורים ל-API של YouTube Analytics (שאילתות ממוקדות):

  • גרסה 1 של ה-API הוצאה משימוש. אם עדיין לא עשיתם זאת, מומלץ לעדכן את לקוחות ה-API לגרסה 2 של ה-API בהקדם האפשרי כדי לצמצם את הסיכון להפרעות בשירות. פרטים נוספים זמינים במדריך להעברת נתונים.

    חשוב לדעת: התאריך המקורי להוצאה משימוש של התכונה הזו היה 26 באפריל 2018.

‫17 בספטמבר 2018

העדכון הזה כולל את השינויים הבאים שקשורים ל-API של YouTube Analytics (שאילתות ממוקדות):

  • בסעיף החדש אנונימיזציה של נתונים במסמך הסקירה הכללית של מודל הנתונים מוסבר שחלק מהנתונים ב-YouTube Analytics מוגבלים אם המדדים לא מגיעים לסף מסוים. המצב הזה יכול לקרות במגוון מקרים. בפועל, זה אומר שדוח מסוים לא יכיל את כל הנתונים שלכם (או אף נתון) אם:

    1. התנועה לסרטון או לערוץ מוגבלת בטווח זמן מסוים,

      או

    2. בחרתם מסנן או מאפיין, כמו מקור תנועה או מדינה, שהערכים שלהם לא מגיעים לסף מסוים.

    בקטע החדש מוסבר גם על סוגי הנתונים שעשויים להיות מוגבלים בדוחות של YouTube Analytics.

  • עדכנו את המסמכים דוחות על ערוצים ודוחות על בעלי תוכן כדי לשקף את העובדה שהמדדים redViews ו-estimatedRedMinutesWatched כבר לא נתמכים בדוחות על מקומות שבהם הסרטון הופעל, מקור התנועה וסוג המכשיר או מערכת ההפעלה.

‫18 ביוני 2018

העדכון הזה כולל את השינויים הבאים בממשק YouTube Analytics API (שאילתות ממוקדות):

  • השתנו דרישות ההיקף של השיטות הבאות:
    • לבקשות לשיטה reports.query צריכה להיות גישה להיקף https://www.googleapis.com/auth/youtube.readonly.
    • לבקשות לשיטה groupItems.list צריכה להיות גישה לאחת מהאפשרויות הבאות:
      • ההיקף https://www.googleapis.com/auth/youtube
        או
      • היקף ההרשאות https://www.googleapis.com/auth/youtube.readonly
        ו
        היקף ההרשאות https://www.googleapis.com/auth/yt-analytics.readonly

      באפשרות הראשונה נעשה שימוש בהיקף אחד, שהוא במקרה היקף של קריאה וכתיבה, ואילו באפשרות השנייה נעשה שימוש בשני היקפים של קריאה בלבד.

‫23 במאי 2018

העדכון הזה כולל את השינויים הבאים בממשק YouTube Analytics API (שאילתות ממוקדות):

  • במאמר 'סקירה כללית של ה-API' יש עכשיו קטע חדש, מדדים מצטברים ופריטים שנמחקו, שמוסבר בו איך תגובות ה-API מטפלות בנתונים שמשויכים למקורות מידע שנמחקו, כמו סרטונים, פלייליסטים או ערוצים.
  • הקטע שיטות מומלצות במסמך סקירת ה-API עודכן כדי להזכיר לכם שאפשר להשתמש ב-YouTube Data API כדי לאחזר מטא-נתונים נוספים למקורות שזוהו בתגובות של YouTube Analytics API. כפי שמצוין בכללי המדיניות למפתחים של שירותי ה-API של YouTube (סעיפים III.E.4.b עד III.E.4.d), לקוחות API צריכים למחוק או לרענן מטא-נתונים של משאבים מאוחסנים מ-API מסוים אחרי 30 יום.

22 במאי 2018

העדכון הזה כולל את השינויים הבאים שקשורים ל-YouTube Reporting (דוחות בכמות גדולה) API:

  • השינויים הבאים אמורים להיכנס לתוקף ביולי 2018, והמדיניות החדשה חלה באופן גלובלי על כל הדוחות ועבודות הדיווח.

    • אחרי השינוי, רוב הדוחות של ה-API, כולל דוחות על מילוי חוסרים, יהיו זמינים למשך 60 יום מהמועד שבו הם נוצרו. עם זאת, דוחות שמכילים נתונים היסטוריים יהיו זמינים למשך 30 יום מהמועד שבו הם נוצרו.

      לפני ההודעה הזו, כל הדוחות של API היו זמינים למשך 180 יום מהמועד שבו הם נוצרו. חשוב להבהיר: כשהשינוי הזה במדיניות ייכנס לתוקף, לא תהיה יותר גישה לדוחות של נתונים היסטוריים בני יותר מ-30 יום דרך ה-API. גם לדוחות אחרים שנוצרו לפני יותר מ-60 ימים לא תהיה יותר גישה. לכן, במסמכי התיעוד מצוין עכשיו שהדוחות שנוצרו לפני שינוי המדיניות יהיו זמינים למשך עד 180 יום.

    • אחרי השינוי, כשמתזמנים עבודת דיווח, YouTube תיצור דוחות החל מהיום שבו העבודה תוזמנה, שיכסו את התקופה של 30 הימים שקדמו למועד התזמון של העבודה. לפני השינוי, כשמתזמנים עבודת דיווח, מערכת YouTube יוצרת דוחות שכוללים את התקופה של 180 הימים שלפני מועד התזמון של העבודה.

  • הקטע שיטות מומלצות עודכן כדי להזכיר לכם שאפשר להשתמש ב-YouTube Data API כדי לאחזר מטא-נתונים נוספים של מקורות מידע שמזוהים בדוחות. כפי שמצוין בכללי המדיניות למפתחים של שירותי ה-API של YouTube (סעיפים III.E.4.b עד III.E.4.d), לקוחות API צריכים למחוק או לרענן מטא-נתונים של משאבים מאוחסנים מ-API מסוים אחרי 30 יום.

  • בקטע מאפייני הדוח עודכן המידע, ועכשיו מצוין שגם אם נתוני הדוח לא מסוננים, דוחות שמכילים נתונים לתקופה שמתחילה ב-1 ביוני 2018 או אחריו לא יכללו הפניות למקורות מידע ב-YouTube שנמחקו לפחות 30 ימים לפני התאריך שבו הדוח נוצר.

  • בקטע נתונים היסטוריים בסקירה הכללית של ה-API, נוספה הערה שלפיה כשמתזמנים משימת דיווח חדשה, הדוחות ההיסטוריים מתפרסמים בדרך כלל תוך כמה ימים. בעבר, צוין במסמכים שדוחות כאלה יהיו זמינים תוך 30 יום.

  • עדכנו את הקטע backfill data בסקירה הכללית של ה-API כדי להגדיר בצורה ברורה יותר את backfill data כמערך נתונים שמחליף מערך נתונים שנמסר בעבר.

‫26 באפריל 2018

גרסה 2 של YouTube Analytics (Targeted Queries) API‏ (v2) זמינה עכשיו לציבור. ברשימה הבאה מפורטים שינויים במוצר ובמסמכים שקשורים לגרסה החדשה של ה-API:

  • גרסה 2 של ה-API כמעט זהה לגרסה 1. עם זאת, סביר להניח שתצטרכו לעדכן את הקוד כדי לשקף את השינויים שמפורטים בהמשך. כל השינויים האלה מוסברים בפירוט במדריך החדש להעברת נתונים.

    • גרסת ה-API השתנתה מ-v1 ל-v2.
    • כתובת ה-URL הבסיסית לבקשות API השתנתה מ-https://www.googleapis.com/youtube/analytics/v1 ל-https://youtubeanalytics.googleapis.com/v2.
    • השמות של כמה פרמטרים בשיטה reports.query עודכנו. לדוגמה, שמות של פרמטרים שמכילים מקפים, כמו end-date ב-API בגרסה 1, משתמשים ב-camel case‏ (endDate) במקום במקפים ב-API בגרסה 2. השינוי הזה יוצר עקביות בשמות הפרמטרים בכל ה-API, כי השיטה של ה-API ליצירה ולניהול של קבוצות כבר השתמשה ב-camel casing לשמות הפרמטרים.
    • ‫v2 API לא תומך בבקשות מקובצות שנשלחות לנקודת הקצה הגלובלית של Google לבקשות HTTP מקובצות (www.googleapis.com/batch). אם אתם שולחים בקשות מקובצות ב-v2 API, אתם צריכים להשתמש בנקודת הקצה https://youtubeanalytics.googleapis.com/v2 במקום זאת.

    בנוסף, יש כמה תכונות מגרסה 1 שלא נתמכות בגרסה 2 של API:

    • השיטה reports.query לא תומכת יותר בפרמטרים של הבקשה alt,‏ quotaUser ו-userIp.
    • גרסה 2 של ה-API לא מספקת נקודת קצה (endpoint) לאצווה שתומכת באצוות שכוללות בקשות לממשקי API שונים. (אבל אצווה יכולה לכלול בקשות לשיטות שונות של אותו API). הוצאה משימוש הזו לא ספציפית ל-YouTube Analytics API, כי Google מוציאה משימוש את נקודת הקצה הגלובלית של אצווה בכל ממשקי ה-API שלה.
    • ‫API v2 לא תומך בפרוטוקול JSON-RPC, שהיה נתמך ב-API v1. שוב, ההוצאה משימוש הזו לא ספציפית ל-API של YouTube Analytics.

  • הערה: זוהי הודעה על הוצאה משימוש.

    גרסה 1 של ה-API‏ (v1) הוצאה משימוש, והתמיכה בה תסתיים ב-31 באוקטובר 2018. כל הבקשות ל-API בגרסה 1 יפסיקו לפעול אחרי התאריך הזה. לכן, חשוב לשדרג ל-API גרסה 2 עד 31 באוקטובר 2018 כדי למנוע שיבושים בגישה לנתוני YouTube Analytics דרך ה-API.

‫21 בפברואר 2018

העדכון הזה כולל את השינויים הבאים בממשק YouTube Analytics API (שאילתות ממוקדות):

  • דוחות דמוגרפיים של הצופים, שמציגים נתונים סטטיסטיים מצטברים של צפייה על סמך קבוצת הגיל והמגדר של הצופים, כבר לא תומכים במאפיין youtubeProduct שמזהה את שירות YouTube שבו התרחשה פעילות המשתמש.

‫18 בינואר 2018

העדכון הזה כולל את השינויים הבאים:

  • ‫YouTube Reporting API (Bulk Reports)

    • המאפיין operating_system, שמזהה את מערכת התוכנה של המכשיר שבו התרחשו הצפיות, תומך עכשיו בערך הבא:
      • ‫25: KaiOS

  • ‫YouTube Analytics API (שאילתות ממוקדות)

20 בדצמבר 2017

העדכון הזה כולל שני שינויים שקשורים ל-YouTube Reporting API:

  • שרת ה-API תומך עכשיו בדחיסת gzip לבקשות להורדת דוחות. הערה: אין תמיכה בדחיסת gzip בסוגים אחרים של בקשות API. הפעלת דחיסת נתונים מסוג gzip מצמצמת את רוחב הפס שנדרש לכל תגובת API. בנוסף, למרות שהאפליקציה שלכם תצטרך זמן CPU נוסף כדי לבטל את הדחיסה של תגובות ה-API, היתרון של צריכת פחות משאבי רשת בדרך כלל עולה על העלות הזו.

    כדי לקבל תשובה מקודדת ב-gzip, צריך להגדיר את כותרת בקשת ה-HTTP‏ Accept-Encoding לערך gzip, כמו בדוגמה הבאה:

    Accept-Encoding: gzip

    הפונקציונליות הזו מוסברת בסקירה הכללית של ה-API ובמאפיין downloadUrl של משאב report.

  • תיקנו את התיעוד של המאפיינים age group ו-gender כדי להציג את הערכים בפועל שמוחזרים על ידי ה-API עבור המאפיינים האלה. הערה: מדובר בתיקון בתיעוד, והוא לא משקף שינוי בפונקציונליות או בהתנהגות של ה-API. באופן ספציפי, הערכים הבאים השתנו:

    • הערכים של מאפיין age_group כוללים אותיות רישיות, קווים תחתונים בין המילה AGE לבין המספרים בקבוצת הגיל, וקווים תחתונים במקום מקפים. לכן, ערכים כמו age13-17 ו-age18-24 תוקנו ל-AGE_13_17 ו-AGE_18_24, בהתאמה.
    • הערכים של המימד gender הם באותיות רישיות. לכן, הערכים female,‏ male ו-gender_other תוקנו ל-FEMALE,‏ MALE ו-GENDER_OTHER.

‫10 באוגוסט 2017

ב-10 באוגוסט 2016, הודענו במסמך הזה על הוצאה משימוש של המדד earnings ב-YouTube Analytics API. (במקביל, נוספה תמיכה ב-API במדד חדש בשם estimatedRevenue, שמספק את אותם נתונים).

המדד earnings היה מדד ליבה, ולכן הוא נתמך למשך שנה מתאריך ההודעה. אבל עכשיו, אחרי שתקופת השנה הזו הסתיימה, המדד earnings לא נתמך יותר. כתוצאה מכך, בקשות API שמציינות את מדד earnings מחזירות עכשיו קוד תגובת HTTP ‏400. אם עדיין לא עדכנתם את האפליקציה כדי להשתמש במדד estimatedRevenue במקום במדד earnings, חשוב לעשות זאת בהקדם האפשרי.

מאמרי העזרה של ה-API עודכנו כדי להסיר מהם את ההתייחסויות שנותרו למדד earnings.

‫6 ביולי 2017

העדכון הזה כולל את השינויים הבאים:

  • ‫YouTube Analytics API (שאילתות ממוקדות)

    • עדכנו את מסמכי התיעוד של ה-API כדי לשקף את העובדה שתשובות ה-API מכילות נתונים עד היום האחרון בטווח התאריכים המבוקש, שבו כל המדדים שנכללים בשאילתה זמינים.

      לדוגמה, אם בבקשה מצוין תאריך סיום של 5 ביולי 2017, והערכים של כל המדדים המבוקשים זמינים רק עד 3 ביולי 2017, זה יהיה התאריך האחרון שייכללו לגביו נתונים בתגובה. (זה נכון גם אם נתונים לגבי חלק מהמדדים המבוקשים זמינים ל-4 ביולי 2017).

    • במאפיין adType יש עכשיו תמיכה בערך reservedBumperInstream, שמתייחס למודעת וידאו שלא ניתן לדלג עליה באורך של עד 6 שניות, שמופעלת לפני שהצופים יכולים לצפות בסרטון. פורמט המודעה זהה למודעת auctionBumperInstream, אבל הסוג הזה מתייחס למודעות שנמכרות על בסיס הזמנה ולא על בסיס מכרז.

  • ‫YouTube Reporting API (Bulk Reports)

    • המימד ad_type תומך עכשיו בערך 20, שמתייחס למודעות באמפר שנמכרות על בסיס הזמנה. מודעות באמפר הן מודעות וידאו שלא ניתן לדלג עליהן, באורך של עד 6 שניות, שמוצגות לפני שהצופים יכולים לצפות בסרטון. הערה: הערך 19 במאפיין הזה מתייחס גם למודעות באמפר שנמכרות במכרז ולא על בסיס הזמנה.

    • עבודות הדיווח עבור הדוחות הבאים של YouTube Reporting API נמחקו:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      הודענו על הוצאה משימוש של סוגי הדוחות האלה ב-15 בספטמבר 2016, ומאז 15 בדצמבר 2016 לא הופקו יותר דוחות מהסוגים האלה. דוחות שנוצרו בעבר עדיין היו זמינים למשך 180 יום מהמועד שבו נוצרו. לכן, חלק מהדוחות היו זמינים עד 15 ביוני 2017. עם זאת, מכיוון שהדוחות כבר לא זמינים, גם המשימות שמשויכות לדוחות כבר לא נחוצות.

‫24 במאי 2017

כל עבודות הדיווח בדוחות הבאים של YouTube Reporting API נמחקו:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

הודענו על הוצאה משימוש של סוגי הדוחות האלה ב-22 ביוני 2016, ומאז 22 בספטמבר 2016 לא נוצרו יותר דוחות מהסוגים האלה. דוחות שנוצרו בעבר עדיין היו זמינים למשך 180 יום מהמועד שבו נוצרו. לכן, חלק מהדוחות היו זמינים עד 22 במרץ 2017. עם זאת, מכיוון שהדוחות כבר לא זמינים, גם המשימות שמשויכות לדוחות כבר לא נחוצות.

‫22 במאי 2017

העדכון הזה כולל את השינויים הבאים:

  • ‫YouTube Reporting API (Bulk Reports)

    • המימד sharing_service, שמזהה את השירות ששימש לשיתוף סרטונים, תומך עכשיו בערכים הבאים:
      • ‫85: YouTube Music
      • ‫86: YouTube Gaming
      • ‫87: YouTube Kids
      • ‫88: YouTube TV

      בנוסף, השם שמשמש לזיהוי הערך 52 עודכן במסמכים ל-Kakao (Kakao Talk) כדי להבדיל אותו בצורה ברורה יותר מהערך 73 (Kakao Story). השינוי הזה לא משקף שינוי בהתנהגות של ה-API או בסיווג של סרטונים שמשותפים עם השירותים האלה.

  • ‫YouTube Analytics API (שאילתות ממוקדות)

    • בשלב הזה אנחנו תומכים בערכים הבאים של המאפיין sharingService:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

‫28 במרץ 2017

בעלי ערוצים שיש להם גישה לנתוני ההכנסות דרך YouTube Analytics ב-Creator Studio יכולים עכשיו לגשת לנתוני ההכנסות גם דרך YouTube Analytics API:

‫17 במרץ 2017

העדכון הזה כולל את השינויים הבאים:

  • ה-API של YouTube Analytics תומך במדדים redViews ו-estimatedRedMinutesWatched, שניהם קשורים לצופים ב-YouTube Red. למעשה, ה-API תומך במדדים האלה כבר זמן מה, וממשק YouTube Reporting API כבר תומך בשני המדדים האלה, כפי שפורסם ב-15 בספטמבר 2016.

    • המדד redViews מציין את מספר הפעמים שמנויי YouTube Red צפו בסרטון.
    • המדד estimatedRedMinutesWatched מציין את מספר הדקות שבהן מנויי YouTube Red צפו בסרטון.

    עדכנו את מאמרי העזרה בנושא דוחות הערוץ ודוחות בעלי התוכן כדי להראות באילו דוחות אפשר לראות את שני המדדים החדשים. הם נתמכים בכל הדוחות שכבר תמכו במדדים views ו-estimatedMinutesWatched.

‫3 במרץ 2017

העדכון הזה כולל את השינויים הבאים:

  • ‫YouTube Reporting API (Bulk Reports)

    • ההגדרה של מאפיין date תוקנה, ועכשיו מצוין בה שערך המאפיין מתייחס לתקופה שמתחילה ב-12:00 בצהריים לפי שעון החוף המזרחי ומסתיימת ב-23:59 לפי שעון החוף המזרחי ביום, בחודש ובשנה שצוינו. בהתאם לשעה בשנה, שעון החוף המערבי הוא UTC-7 או UTC-8.

      בדרך כלל התאריכים מייצגים תקופה של 24 שעות, אבל תאריכים שבהם השעונים מוזזים קדימה מייצגים תקופה של 23 שעות, ותאריכים שבהם השעונים מוזזים אחורה מייצגים תקופה של 25 שעות. (בעבר, בתיעוד צוין שכל תאריך מייצג תקופה ייחודית של 24 שעות, וששעון החוף המערבי הוא תמיד UTC-8).

      הערה: התיקון הזה לא מייצג שינוי בהתנהגות בפועל של ה-API.

    • במאפיין operating_system, שמזהה את מערכת התוכנה של המכשיר שבו התרחשו הצפיות, יש עכשיו תמיכה בערכים הבאים:
      • ‫22: Tizen
      • ‫23: Firefox
      • 24: RealMedia

    • כל עבודות הדיווח עבור סוג הדוח content_owner_basic_a1 נמחקו. סוג הדוח הזה הוצא משימוש באופן מלא החל מ-19 באוגוסט 2016, אבל דוחות content_owner_basic_a1 שנוצרו בעבר עדיין היו זמינים למשך 180 יום מהמועד שבו הם נוצרו. לכן, חלק מהדוחות היו נגישים עד 19 בפברואר 2017. עם זאת, מכיוון שהדוחות כבר לא זמינים, גם המשימות שמשויכות לדוחות כבר לא נחוצות.

  • ‫YouTube Analytics API (שאילתות ממוקדות)

    • תיקנו את התיאור של המאפיינים שקשורים ל-time periods. עכשיו מצוין שערך המאפיין מתייחס לתקופה שמתחילה ב-00:00 לפי שעון החוף המערבי ומסתיימת ב-23:59 לפי שעון החוף המערבי ביום, בחודש ובשנה שצוינו. בהתאם לשעה בשנה, שעון החוף המערבי הוא UTC-7 או UTC-8.

      בדרך כלל התאריכים מייצגים תקופה של 24 שעות, אבל תאריכים שבהם השעונים מוזזים קדימה מייצגים תקופה של 23 שעות, ותאריכים שבהם השעונים מוזזים אחורה מייצגים תקופה של 25 שעות. (בעבר, במסמכי התיעוד צוין שהשעה לפי שעון האוקיינוס השקט היא UTC-8, ולא הוזכרה האפשרות שיום לא מייצג תקופה של 24 שעות).

      הערה: התיקון הזה לא מייצג שינוי בהתנהגות בפועל של ה-API.

    • עדכנו את התיעוד של דוחות הערוצים כדי לציין שדוחות הערוצים לא מכילים כרגע מדדים של רווחים או של ביצועי מודעות. לכן, היקף הגישה https://www.googleapis.com/auth/yt-analytics-monetary.readonly לא מאפשר כרגע גישה לנתונים כספיים בדוחות הערוצים.

    • המימד operatingSystem תומך בשלושה ערכים חדשים:
      • FIREFOX
      • REALMEDIA
      • TIZEN

‫8 בפברואר 2017

‫YouTube Analytics API תומך עכשיו בפרמטר האופציונלי include-historical-channel-data. הערה: הפרמטר הזה רלוונטי רק כשמאחזרים דוחות של בעלי תוכן.

הפרמטר מאפשר לבעלי תוכן לציין שתגובת API צריכה לכלול נתונים על זמן הצפייה והצפיות בערוצים מהתקופה שלפני שהערוצים קושרו לבעלי התוכן. ערך ברירת המחדל של הפרמטר הוא false, כלומר, כברירת מחדל, תגובת ה-API כוללת רק נתונים של זמן צפייה וצפיות מהרגע שבו הערוצים קושרו לבעלי התוכן.

הכללים האלה חלים גם אם בקשת ה-API מאחזרת נתונים של כמה ערוצים:

  • אם ערך הפרמטר הוא false, נתוני זמן הצפייה והצפיות שמוחזרים עבור ערוץ מסוים מבוססים על התאריך שבו הערוץ הזה קושר לבעלי התוכן.

    חשוב לזכור שערוצים שונים יכולים להיות מקושרים לבעלי תוכן בתאריכים שונים. אם בקשת ה-API מאחזרת נתונים עבור כמה ערוצים וערך הפרמטר הוא false, תגובת ה-API מכילה נתונים של זמן צפייה וצפיות על סמך תאריך הקישור של כל ערוץ.
  • אם ערך הפרמטר הוא true, התגובה מחזירה נתונים של זמן צפייה וצפיות בכל הערוצים על סמך תאריכי ההתחלה והסיום שצוינו בבקשת ה-API.

‫15 בדצמבר 2016

הדוחות הבאים של YouTube Reporting API כבר לא נתמכים והוסרו מהתיעוד. יש גרסה חדשה יותר של כל דוח. (הודעה על הוצאה משימוש של הדוחות האלה פורסמה ב-15 בספטמבר 2016).

גם הרשימה של סוגי הדוחות הנוכחיים במסמכי העזר של ה-API עודכנה.

‫11 בנובמבר 2016

העדכון הזה כולל את השינויים הבאים:

‫YouTube Reporting API תומך בשלושה דוחות חדשים של מסכי סיום, וגם במאפיינים ובמדדים חדשים לדוחות האלה. בדוחות מוצגים נתונים סטטיסטיים של חשיפות ושיעורי קליקים לגבי מסכי הסיום שמוצגים אחרי שהסרטון מפסיק לפעול.

  • דוחות על מסכי סיום

    • הדוח 'מסך סיום' עבור סרטונים בערוץ מכיל נתונים סטטיסטיים לגבי כל הסרטונים בערוץ.
    • הדוח 'מסך סיום' עבור סרטונים של בעלי תוכן מכיל נתונים סטטיסטיים של סרטונים בכל אחד מהערוצים של בעלי התוכן.
    • הדוח 'מסכי סיום' עבור נכסים של בעלי תוכן מכיל נתונים סטטיסטיים לגבי הנכסים שמשויכים לסרטונים שאחריהם מוצגים מסכי הסיום.

  • המידות של מסך הסיום

    • ‫end_screen_element_type: סוג הרכיב של מסך הסיום שמשויך לנתונים הסטטיסטיים.
    • ‫end_screen_element_id: המזהה שמשמש את YouTube לזיהוי ייחודי של רכיב מסך הסיום.

  • מדדים של מסכי סיום

    הערה: הנתונים של מדדי מסך הסיום זמינים החל מ-1 במאי 2016.

    • במרכז העזרה של YouTube יש מידע מפורט יותר על הוספת מסכי סיום לסרטונים.

  • הדוחות הבאים כבר לא נתמכים והוסרו מהתיעוד. יש גרסה חדשה יותר של כל דוח. (הודעה על הוצאה משימוש של הדוחות האלה פורסמה ב-22 ביוני 2016).

‫8 בנובמבר 2016

העדכון הזה כולל את השינויים הבאים ב-YouTube Analytics API:

  • המדדים ברשימה הבאה הוצאו משימוש באופן מלא ולא נתמכים יותר. כפי שפורסם ב-10 באוגוסט 2016, המערכת כבר תומכת במדדים חדשים שמתייחסים לאותם נתונים. בטבלה שבהמשך מוצגים שם המדד שהוצא משימוש ושם המדד החדש:

    מדד שהוצא משימוש מדד חדש
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

‫27 באוקטובר 2016

מעכשיו, מערכת YouTube יוצרת באופן אוטומטי קבוצה של דוחות על הכנסות מפרסום שמנוהלים על ידי המערכת עבור בעלי תוכן שיש להם גישה לדוחות המתאימים בקטע דוחות ב-YouTube Studio. דוחות ה-API החדשים שמנוהלים על ידי המערכת נועדו לספק גישה פרוגרמטית לנתונים שזמינים גם בדוחות של YouTube Studio שאפשר להוריד באופן ידני.

בסקירה הכללית של דוחות שמנוהלים על ידי המערכת יש סקירה קצרה של הדוחות החדשים והסבר על התהליך לאחזור שלהם באמצעות ה-API. התהליך הזה שונה מעט מהתהליך של שליפת דוחות בכמות גדולה מ-YouTube Analytics, כי שותפים לא צריכים לתזמן משימות כדי ליצור את הדוחות.

המאפיין id של המשאב reportType עודכן כך שיכלול רשימה של הדוחות שמנוהלים על ידי המערכת שאפשר לגשת אליהם דרך ה-API:

  • הכנסות חודשיות מפרסום בכל העולם לכל סרטון
  • הכנסה יומית מפרסום לכל סרטון, לפי מדינה
  • הכנסות חודשיות מפרסום ברחבי העולם לכל נכס
  • הכנסות יומיות ממודעות לכל נכס, לפי מדינה
  • תלונות על הפרת זכויות יוצרים (הדוח הזה לא מכיל נתוני הכנסות)

27 בספטמבר 2016

הערה: זוהי הודעה על הוצאה משימוש.

הפסקנו את התמיכה במדד uniques ב-API של YouTube Analytics. זה לא מדד ליבה, והוא ייתמך עד 31 באוקטובר 2016.

‫15 בספטמבר 2016

העדכון הזה כולל את השינויים הבאים ב-YouTube Reporting API:

  • ה-API תומך בשני מדדים חדשים שקשורים לצפייה ב-YouTube Red:

    • ‫red_views: מספר הפעמים שחברי YouTube Red צפו בסרטון.
    • ‫red_watch_time_minutes: מספר הדקות שחברי YouTube Red צפו בסרטון.

  • ה-API תומך בגרסאות חדשות של 20 דוחות. כל הגרסאות החדשות תומכות במדדים החדשים red_views ו-red_watch_time_minutes.

    לכל דוח, המספר במזהה סוג הדוח החדש גבוה ב-1 מהמספר במזהה סוג הדוח הישן. (הגרסאות הישנות של הדוחות האלה הוצאו משימוש, כמו שמתואר בהמשך בהיסטוריית גרסאות זו). לדוגמה, הדוח channel_basic_a1 יצא משימוש והוחלף בדוח channel_basic_a2.

    הרשימות הבאות מציגות את מזהי סוג הדוח החדשים:

  • הערה: זוהי הודעה על הוצאה משימוש.

    שימו לב: אם כבר יש לכם משימות ליצירת גרסאות ישנות יותר של הדוחות שמופיעים למעלה, תצטרכו ליצור משימות חדשות עבור הדוחות ששמם שונה. במקביל להשקת הגרסאות החדשות של הדוחות, הוצאנו משימוש את הגרסאות הבאות של הדוחות:

    • channel_basic_a1
    • channel_province_a1
    • channel_playback_location_a1
    • channel_traffic_source_a1
    • channel_device_os_a1
    • channel_subtitles_a1
    • channel_combined_a1
    • content_owner_basic_a2
    • content_owner_province_a1
    • content_owner_playback_location_a1
    • content_owner_traffic_source_a1
    • content_owner_device_os_a1
    • content_owner_subtitles_a1
    • content_owner_combined_a1
    • content_owner_asset_basic_a1
    • content_owner_asset_province_a1
    • content_owner_asset_playback_location_a1
    • content_owner_asset_traffic_source_a1
    • content_owner_asset_device_os_a1
    • content_owner_asset_combined_a1

    אם יש לכם משימות שקשורות לאחד מהדוחות האלה, אל תצפו ש-YouTube ייצור דוחות חדשים למשימות האלה אחרי 15 בדצמבר 2016. הדוחות שנוצרו עדיין יהיו זמינים למשך 180 יום מהמועד שבו הם נוצרו.

‫19 באוגוסט 2016

העדכון הזה כולל את השינוי הבא ב-YouTube Reporting API:

  • הדוח content_owner_basic_a1 הוצא משימוש באופן מלא והוסר מהתיעוד. מערכת YouTube לא תיצור יותר דוחות חדשים מהסוג הזה, אבל דוחות שכבר נוצרו עדיין יהיו זמינים למשך 180 יום מהמועד שבו הם נוצרו.

    הדוח content_owner_basic_a1 הוחלף בדוח content_owner_basic_a2, כפי שמוסבר בהיסטוריית גרסאות מ-19 במאי 2016.

‫11 באוגוסט 2016

העדכון הזה כולל את השינויים הבאים:

  • התנאים וההגבלות החדשים של שירותי ה-API של YouTube (להלן "התנאים המעודכנים"), שמוסברים בפירוט בבלוג של צוות ההנדסה והמפתחים של YouTube, כוללים מגוון רחב של עדכונים לתנאים ולהגבלות הנוכחיים. בנוסף לתנאים המעודכנים, שייכנסו לתוקף ב-10 בפברואר 2017, העדכון הזה כולל כמה מסמכים תומכים שמסבירים את המדיניות שמפתחים צריכים לפעול לפיה.

    התיאור המלא של המסמכים החדשים מופיע בהיסטוריית הגרסאות של התנאים המעודכנים. בנוסף, היסטוריית הגרסאות תכלול הסברים על שינויים עתידיים בתנאים המעודכנים או במסמכים התומכים. אפשר להירשם לעדכונים בפיד RSS שכולל את השינויים בהיסטוריית הגרסאות באמצעות קישור במסמך.

‫10 באוגוסט 2016

העדכון הזה כולל את השינויים הבאים:

  • ‫YouTube Analytics API (שאילתות ממוקדות)

    • הערה: זוהי הודעה על הוצאה משימוש.

      המדדים בטבלה הבאה עומדים לצאת משימוש. במקביל, אנחנו משיקים מדדים חדשים שמתייחסים לאותם נתונים. בפועל, המשמעות היא שהשמות של המדדים הישנים משתנים, אבל YouTube Analytics API יתמוך בשני שמות המדדים עד לתאריכי ההוצאה משימוש שמפורטים בטבלה.

      השם הקודם של המדד השם החדש של המדד תאריך התמיכה
      earnings estimatedRevenue ‫10 באוגוסט 2017
      adEarnings estimatedAdRevenue ‫4 בנובמבר 2016
      redPartnerRevenue estimatedRedPartnerRevenue ‫4 בנובמבר 2016
      impressionBasedCpm cpm ‫4 בנובמבר 2016
      impressions adImpressions ‫4 בנובמבר 2016

      חשוב לזכור שהמדד earnings היה מדד ליבה, ולכן הוא ייתמך למשך שנה ממועד ההודעה הזו. המדדים האחרים, שלא היו מדדי ליבה, יתמכו במשך שלושה חודשים, עד 4 בנובמבר 2016.

      לדוגמה, עד 4 בנובמבר 2016, בקשת API יכולה לציין את המדד impressionBasedCpm, את המדד cpm או את שניהם. אבל אחרי התאריך הזה, תהיה תמיכה רק במדד cpm.

    • המאפיין insightTrafficSourceType תומך בשני ערכים חדשים:
      • ‫CAMPAIGN_CARD: מקור התנועה הזה נתמך רק בדוחות של בעלי תוכן. הערך הזה מציין שהצפיות הגיעו מסרטונים שהועלו על ידי משתמשים, שהוגשה לגביהם הצהרת זכויות יוצרים, ושבעלי התוכן השתמשו בהם כדי לקדם את התוכן שנצפה.
      • ‫END_SCREEN: הנתונים מתייחסים לצפיות שמקורן במסך הסיום של סרטון אחר.

      אפשר גם לאחזר traffic source detail דוח לגבי שני מקורות התנועה החדשים. בשני המקרים, המאפיין insightTrafficSourceDetail מזהה את הסרטון שממנו הצופה הופנה.

    • במאפיין adType יש עכשיו תמיכה בערך auctionBumperInstream, שמתייחס למודעת וידאו שלא ניתן לדלג עליה באורך של עד 6 שניות, שמופעלת לפני שהצופים יכולים לצפות בסרטון.

  • ‫YouTube Reporting API (Bulk Reports)

    • בשלב הזה אנחנו תומכים בערכים הבאים של המאפיין traffic_source_type:
      • ‫19: מקור התנועה הזה נתמך רק בדוחות של בעלי תוכן. הערך הזה מציין שהצפיות הגיעו מסרטונים שהועלו על ידי משתמשים, שהוגשה לגביהם הצהרת זכויות יוצרים, ושבעלי התוכן השתמשו בהם כדי לקדם את התוכן שנצפה.
      • ‫20: הנתונים מתייחסים לצפיות שמקורן במסך הסיום של סרטון אחר.

      בשני המקורות החדשים של התנועה, המאפיין traffic_source_detail מזהה את הסרטון שממנו הצופה הופנה.

    • הרשימה של מדדי הליבה ב-API תוקנה. המדד estimated_partner_revenue מופיע עכשיו ברשימה הזו, והמדד earnings הוסר ממנה. (המדד earnings אף פעם לא נתמך ב-YouTube Reporting API).

    • המאפיין ad_type תומך עכשיו בערך 19 שמתייחס למודעות באמפר – מודעות וידאו שלא ניתן לדלג עליהן, באורך של עד 6 שניות, שמופעלות לפני שהצופים יכולים לצפות בסרטון.

‫18 ביולי 2016

העדכון הזה כולל את השינויים הבאים:

  • ‫YouTube Analytics API (שאילתות ממוקדות)

    • הרשימות של המדדים הנתמכים בדוחות הערוצים הבאים עודכנו כך שיכללו מדדים של כרטיסים. התמיכה במדדים של כרטיסים בדוחות האלה נוספה ב-28 ביוני 2016, והערך בהיסטוריית גרסאות של התאריך הזה מסביר את השינוי בפירוט רב יותר. הדוחות הם:
      • פעילות משתמש בסיסית במדינות בארה"ב
      • פעילות משתמשים במדינות בארה"ב בתקופות זמן ספציפיות
      • פעילות המשתמשים לפי מחוז
      • פעילות המשתמשים לפי סטטוס המינוי
      • פעילות המשתמשים לפי סטטוס המינוי במחוזות
      • הסרטונים המובילים לפי מדינה
      • הסרטונים המובילים לצופים מנויים או לא מנויים

    • רשימות המסננים תוקנו גם בדוחות שימור הקהל בערוץ וגם בדוחות שימור הקהל של בעלי תוכן, כך שמשתקף בהן שהמסנן video נדרש והמסנן group לא נתמך.

      בעבר, במסמכי התיעוד של שני הדוחות צוין באופן שגוי שאפשר לאחזר את הדוח באמצעות אחד משני המסננים האלה או בלי להשתמש באף אחד מהם.

  • ‫YouTube Reporting API (Bulk Reports)

    • בסקירה הכללית של ה-API, הקטע שמסביר איך לאחזר כתובת URL להורדה של דוח תוקן. עכשיו מצוין בו ש-YouTube אכן יוצר דוחות שאפשר להוריד לגבי ימים שבהם לא היו נתונים זמינים. הדוחות האלה מכילים שורת כותרת אבל לא מכילים נתונים נוספים. המידע הזה כבר עודכן בקטע מאפייני הדוח באותו מסמך ב-12 באפריל 2016.
    • רשימת המאפיינים בדוח content_owner_asset_cards_a1 תוקנה כך שתשקף את השימוש במאפיין card_id בדוח. בעבר, שם המאפיין שצוין במסמכים היה card_title, אבל זה לא היה נכון.

‫28 ביוני 2016

עדכנו את התיעוד של YouTube Analytics API כדי לשקף את התמיכה במדדי כרטיסים בדוחות רבים של ערוצים ובעלי תוכן. המדדים החדשים שנתמכים הם:

המדדים נתמכים בסוגי הדוחות הבאים:

‫22 ביוני 2016

העדכון הזה כולל את השינויים הבאים ב-YouTube Reporting API. השינוי הראשון מתייחס ל-API באופן כללי, והשינויים הנותרים משפיעים רק על דוחות של בעלי תוכן:

  • הקטע מאפייני הדוח בסקירה הכללית על ה-API עודכן כדי להבהיר שהדוחות זמינים דרך ה-API למשך 180 יום מהמועד שבו הם נוצרו.

    בעבר, צוין במסמכי התיעוד שהדוחות זמינים לתקופה של עד 180 יום לפני התאריך שבו נשלחת בקשת ה-API. הטקסט המקורי היה נכון מבחינה טכנית, אבל לכל הפחות מבלבל.

  • ה-API תומך בגרסאות חדשות של שלושה דוחות. שניים מהדוחות האלה מכילים גם מדדים חדשים ושמות חדשים למדדים:

    • הדוח content_owner_ad_rates_a1 הוא הגרסה החדשה של הדוח content_owner_ad_performance_a1. הדוח ששמו שונה זהה לגרסה הקודמת.

    • שני דוחות שנוספו להם גרסאות חדשות קיבלו שמות חדשים:

      • הגרסה החדשה של הדוח content_owner_estimated_earnings_a1 נקראת content_owner_estimated_revenue_a1.
      • הגרסה החדשה של הדוח content_owner_asset_estimated_earnings_a1 נקראת content_owner_asset_estimated_revenue_a1.

      שני הדוחות החדשים ששמם שונה שונים מהדוחות הקודמים בדרכים הבאות:

    שימו לב: אם כבר יש לכם משימות ליצירת גרסאות ישנות יותר של הדוחות האלה, תצטרכו ליצור משימות חדשות לדוחות ששמם שונה. במקביל להשקת הגרסאות החדשות של הדוחות, הוצאנו משימוש את הדוחות content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 ו-content_owner_asset_estimated_earnings_a1.

    אם יש לכם משימות שקשורות לאחד מהדוחות האלה, אל תצפו ש-YouTube ייצור דוחות חדשים למשימות האלה אחרי 22 בספטמבר 2016. הדוחות שנוצרו עדיין יהיו זמינים למשך 180 יום מהמועד שבו הם נוצרו.

  • ההגדרה של מאפיין id של המשאב reportType עודכנה כדי לשקף את קבוצת הדוחות הזמינים הנוכחית.

  • שמות של שני מדדים תוקנו במסמכים כך שיתאימו לשמות שמופיעים בדוחות. זהו תיקון במסמכים בלבד, והוא לא משקף שינוי בתוכן הדוח בפועל:

    • השם של המדד estimated_partner_adsense_revenue עודכן ל-estimated_partner_ad_sense_revenue. עם זאת, חשוב לזכור שהמדד הזה מופיע רק בשני דוחות שיוצאו משימוש בעדכון הזה. כפי שמתואר למעלה, המדד הזה נקרא estimated_partner_ad_auction_revenue בגרסאות חדשות יותר של הדוחות האלה.
    • השם של המדד estimated_partner_doubleclick_revenue עודכן ל-estimated_partner_double_click_revenue. חשוב לזכור שהמדד הזה מופיע רק בשני דוחות שיוצאו משימוש בעדכון הזה. כפי שמתואר למעלה, המדד הזה נקרא estimated_partner_ad_reserved_revenue בגרסאות חדשות יותר של הדוחות האלה.

  • העדכנו את מאמרי העזרה בנושא מאפיינים של Reporting API, והסרנו מהם את המאפיינים elapsed_video_time_percentage ו-audience_retention_type. אף אחד מהדוחות שזמינים דרך ה-API לא תומך כרגע במאפיינים האלה.

‫19 במאי 2016

העדכון הזה כולל את השינויים הבאים ב-YouTube Reporting API:

  • ה-API תומך בגרסה חדשה של דוח פעילות המשתמש לבעלי תוכן. מזהה סוג הדוח של הדוח החדש הוא content_owner_basic_a2. בניגוד לגרסה הקודמת של הדוח, content_owner_basic_a1, הגרסה החדשה תומכת במדדים likes ו-dislikes.

    אם כבר יש לכם משימה ליצירת הדוח content_owner_basic_a1, עדיין צריך ליצור משימה חדשה לדוח content_owner_basic_a2. המערכת של YouTube לא מעבירה באופן אוטומטי בעלי תוכן לגרסה החדשה של הדוח, ולא יוצרת באופן אוטומטי משימה ליצירת הגרסה החדשה של הדוח. ביישומים מסוימים, הופעה של משימה חדשה ולא צפויה יכולה להיות שינוי שובר.

    במקביל להשקת הדוח החדש, הדוח content_owner_basic_a1 יצא משימוש. אם יש לכם משימה שקשורה לדוח הזה, אל תצפו ש-YouTube ייצור דוחות חדשים למשימה הזו אחרי 19 באוגוסט 2016. הדוחות שנוצרו עדיין יהיו זמינים למשך 180 יום מהמועד שבו הם נוצרו.

  • במשאבים reportType, job ו-report יש מאפיין חדש שמציין אם המשאב המשויך מייצג סוג דוח שיצא משימוש:

    • המאפיין deprecateTime של המשאב reportType מציין את התאריך והשעה שבהם סוג הדוח יוצא משימוש. למאפיין הזה יש ערך רק בדוחות שהודענו שהם הוצאו משימוש, והערך מייצג את התאריך שבו YouTube יפסיק ליצור דוחות מהסוג הזה.

      אחרי שמכריזים על סוג דוח מסוים כסוג דוח שיצא משימוש, מערכת YouTube יוצרת דוחות מהסוג הזה למשך שלושה חודשים נוספים. לדוגמה, בעדכון הזה מ-19 במאי 2016, הודענו על הוצאה משימוש של הדוח content_owner_basic_a1. לכן, הערך deprecateTime עבור סוג הדוח הזה מציין שעה ב-19 באוגוסט 2016, שאחריה YouTube יפסיק להפיק דוחות מהסוג הזה.

    • המאפיין expireTime של משאב job מציין את התאריך והשעה שבהם פג התוקף של העבודה או שיפוג התוקף שלה. למאפיין הזה יש ערך אם סוג הדוח שמשויך לעבודה הוצא משימוש, או אם דוחות שנוצרו עבור העבודה לא הורדו במשך תקופה ממושכת. התאריך מציין את הזמן שאחריו YouTube לא יוצר יותר דוחות חדשים לגבי המשרה.

    • במאפיין report של משאב report מצוינים התאריך והשעה שבהם פג התוקף של העבודה שמשויכת לדוח, או התאריך והשעה שבהם יפוג התוקף שלה.jobExpireTime המאפיין הזה מכיל את אותו ערך כמו המאפיין expireTime במשאב job, כפי שמתואר בפריט הקודם ברשימה הזו.

  • השיטה jobs.create מחזירה עכשיו קוד תגובת HTTP ‏400 (Bad Request) אם מנסים ליצור משימה עבור דוח שהוצא משימוש. בנוסף, במסמכי התיעוד של השיטה מפורטות עכשיו כמה סיבות נוספות שגורמות לכך שבקשת API תיכשל.

‫12 באפריל 2016

העדכון הזה כולל את השינויים הבאים, שכולם משפיעים רק על YouTube Reporting API:

  • מערכת YouTube יוצרת עכשיו נתונים שכוללים את התקופה של 180 יום לפני הזמן שבו נקבעה לראשונה משימת דיווח. בעבר, ה-Reporting API לא סיפק נתונים היסטוריים. השינוי הזה משפיע על כל המשימות, כולל אלה שנוצרו לפני ההודעה הזו.

    הדוחות ההיסטוריים מתפרסמים ברגע שהם זמינים, אבל לוקח בערך חודש עד שכל הנתונים ההיסטוריים של משרה מסוימת מתפרסמים. לכן, חודש אחרי שתזמנו משימת דיווח, תהיה לכם גישה לנתונים של כ-7 חודשים. (כל הנתונים ההיסטוריים של משרות שנוצרו לפני ההודעה הזו צריכים להתפרסם תוך חודש ממועד ההודעה).

    הערה: נתונים היסטוריים זמינים רק מ-1 ביולי 2015. כתוצאה מכך, למשימות שנוצרו לפני 28 בדצמבר 2015 יהיו נתונים היסטוריים של פחות מ-180 ימים.

    כל השינויים האלה מוסברים בקטע החדש נתונים היסטוריים שבסקירה הכללית של Reporting API.

  • הוספנו את השינויים הבאים לקטע מאפייני הדוחות במאמר 'סקירה כללית של YouTube Reporting API':

    • בתיעוד מצוין עכשיו שהדוחות זמינים למשך 180 יום אחרי שהם נוצרים, ולכן לקוחות API יכולים להוריד אותם. בעבר, במסמכי התיעוד צוין שהדוחות זמינים לתקופה של עד שישה חודשים לפני התאריך שבו נשלחת בקשת ה-API.

    • עדכנו את התיעוד כדי לשקף את העובדה שממשק ה-API יוצר עכשיו דוחות שאפשר להוריד לגבי ימים שבהם לא היו נתונים זמינים. הדוחות האלה יכללו שורות כותרת, אבל לא יכללו נתונים נוספים.

  • בקרוב, YouTube Reporting API יתמוך בסדרה של דוחות שמנוהלים על ידי המערכת ונוצרים באופן אוטומטי. הדוחות האלה יכללו נתוני הכנסות מפרסום או נתוני הכנסות ממינויים ל-YouTube Red. הדוחות יהיו זמינים לבעלי תוכן שכבר יש להם גישה לדוחות הכנסות שאפשר להוריד באופן ידני ב-YouTube Studio. לכן, הפונקציונליות החדשה של ה-API תספק גישה פרוגרמטית לנתונים האלה.

    אנחנו מפרסמים עכשיו את השינויים הבאים ב-API לקראת השקת דוחות שמנוהלים על ידי המערכת:

    • המאפיין החדש systemManaged של המשאב job מציין אם המשאב מתאר משרה שמייצרת דוחות שמנוהלים על ידי המערכת. המערכת של YouTube יוצרת באופן אוטומטי דוחות שמנוהלים על ידי המערכת עבור בעלי תוכן ב-YouTube, ובעלי התוכן לא יכולים לשנות או למחוק משימות שיוצרות את הדוחות האלה.

    • הפרמטר החדש includeSystemManaged של method‏ jobs.list מציין אם תגובת ה-API צריכה לכלול משימות של דוחות שמנוהלים על ידי המערכת. ערך ברירת המחדל של הפרמטר הוא false.

    • הפרמטר החדש startTimeAtOrAfter של השיטה jobs.reports.list מציין שתגובת ה-API צריכה להכיל דוחות רק אם הנתונים המוקדמים ביותר בדוח הם בתאריך שצוין או אחריו. באופן דומה, הפרמטר startTimeBefore מציין שתגובת ה-API צריכה להכיל דוחות רק אם הנתונים המוקדמים ביותר בדוח הם לפני התאריך שצוין.

      בניגוד לפרמטר createdAfter של השיטה, שמתייחס לזמן שבו הדוח נוצר, הפרמטרים החדשים מתייחסים לנתונים בדוח.

    • המאפיין החדש systemManaged של המשאב reportType מציין אם המשאב מתאר דוח שמנוהל על ידי המערכת.

    • הפרמטר החדש includeSystemManaged של method‏ reportTypes.list מציין אם התשובה של ה-API צריכה לכלול דוחות שמנוהלים על ידי המערכת. ערך ברירת המחדל של הפרמטר הוא false.

‫28 במרץ 2016

ממשקי ה-API של YouTube Reporting ושל YouTube Analytics מחזירים עכשיו נתונים סטטיסטיים של צפיות עבור כמה שירותי שיתוף נוספים.

  • ב-YouTube Reporting API, המאפיין sharing_service תומך בערכים החדשים האלה:
    • ‫82: תיבת דו-שיח של פעילות המערכת ב-iOS
    • ‫83: Google Inbox
    • ‫84: Android Messenger
  • ב-YouTube Analytics API, המאפיין sharingService תומך בערכים החדשים האלה:
    • ‫ANDROID_MESSENGER: Android Messenger
    • ‫INBOX: Google Inbox
    • ‫IOS_SYSTEM_ACTIVITY_DIALOG: תיבת דו-שיח של פעילות המערכת ב-iOS

‫16 במרץ 2016

העדכון הזה כולל את השינויים הבאים, שמשפיעים על YouTube Reporting API ועל YouTube Analytics API:

‫YouTube Reporting API

  • המאפיין playback_location_type תומך בשני ערכים חדשים:
    • ‫7: הנתונים מתייחסים לצפיות שהתרחשו בדף הבית או במסך הבית של YouTube, בפיד המינויים של המשתמש או בתכונה אחרת של YouTube שמאפשרת דפדוף.
    • ‫8: הנתונים מתייחסים לצפיות שהתרחשו ישירות בדף תוצאות החיפוש ב-YouTube.
  • המאפיין traffic_source_type תומך עכשיו בערך המאפיין 18. הערך הזה מציין שהצפיות בסרטון הגיעו מדף שמופיעים בו כל הסרטונים בפלייליסט. המקור הזה שונה מסוג המקור 14, שמציין שהצפיות התרחשו בזמן שהסרטון הופעל כחלק מפלייליסט.

‫YouTube Analytics API

  • המאפיין insightPlaybackLocationType תומך בשני ערכים חדשים:
    • ‫BROWSE: הנתונים מתייחסים לצפיות שהתרחשו בדף הבית או במסך הבית של YouTube, בפיד המינויים של המשתמש או בתכונה אחרת של YouTube שמאפשרת דפדוף.
    • ‫SEARCH: הנתונים מתייחסים לצפיות שהתרחשו ישירות בדף תוצאות החיפוש ב-YouTube.
  • המאפיין insightTrafficSourceType תומך עכשיו בערך המאפיין YT_PLAYLIST_PAGE. הערך הזה מציין שהצפיות בסרטון הגיעו מדף שמופיעים בו כל הסרטונים בפלייליסט. המקור הזה שונה מסוג המקור PLAYLIST, שמציין שהצפיות התרחשו בזמן שהסרטון הופעל כחלק מפלייליסט.

‫8 בפברואר 2016

רשימת המדדים שנתמכים ב-YouTube Analytics API עודכנה, כך שמדדי כרטיסים לא מופיעים יותר כמדדים נתמכים בממשק ה-API הזה. (אף אחד מהדוחות של ה-API הזה לא תועד כתומך באף אחד מהמדדים של הכרטיס).

שימו לב שעדיין אפשר לאחזר מדדים של כרטיסים באמצעות YouTube Reporting API, שתומך במדדים האלה עבור דוחות רבים של ערוצים ושל בעלי תוכן.

‫6 בינואר 2016

ממשקי ה-API של YouTube Reporting ושל YouTube Analytics מזהים עכשיו באופן ספציפי צפיות שמתרחשות דרך מכשיר Chromecast.

  • ב-YouTube Reporting API, המאפיין operating_system משתמש בערך 21 כדי לזהות צפיות שמתרחשות באמצעות Chromecast.
  • ב-YouTube Analytics API, המאפיין operatingSystem משתמש בערך CHROMECAST כדי לזהות צפיות שמתרחשות דרך Chromecast.

‫21 בדצמבר 2015

במסמכים, השמות של המדדים annotation_clickable_impressions ו-annotation_closable_impressions עודכנו כך שיתאימו לשמות שמוחזרים בדוחות. בעבר, השמות תועדו כ-clickable_annotation_impressions ו-closable_annotation_impressions.

‫18 בדצמבר 2015

חוקי האיחוד האירופי (EU) מחייבים להציג גילוי נאות מסוים למשתמשי קצה באיחוד האירופי ולקבל מהם הסכמה. לכן, אם אתם מציגים מודעות למשתמשי קצה באיחוד האירופי, אתם צריכים לפעול בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי. הוספנו הודעה על הדרישה הזו בתנאים ובהגבלות של ממשק ה-API של YouTube.

‫15 בדצמבר 2015

העדכון הזה כולל את השינויים הבאים, שכולם משפיעים על YouTube Analytics API:

  • ה-API של YouTube Analytics תומך עכשיו בשלושה מאפיינים חדשים של פרטי הפעלה, שאפשר להשתמש בהם במגוון דוחות של ערוצים ובעלי תוכן:

    • ‫liveOrOnDemand: המאפיין הזה מציין אם הנתונים בדוח מתארים פעילות משתמשים שהתרחשה במהלך שידור חי.
    • ‫subscribedStatus: המאפיין הזה מציין אם מדדי פעילות המשתמשים בנתונים משויכים לצופים שהיו מנויים לערוץ של הסרטון או הפלייליסט.
    • ‫youtubeProduct: המאפיין הזה מזהה את נכס YouTube שבו התרחשה פעילות המשתמש. הערכים האפשריים כוללים את אתר YouTube הראשי (או אפליקציית YouTube),‏ YouTube Gaming ו-YouTube Kids.

    עדכנו את המסמכים כדי לציין את הדוחות החדשים עם פרטי ההפעלה שזמינים לערוצים ולבעלי תוכן. בנוסף, עדכנו הרבה דוחות אחרים כדי לציין שאפשר להשתמש באחד או יותר מהמאפיינים האלה כמאפיינים או כמסננים בדוחות האלה.

  • הפורמט של הטבלאות שמסבירות את הדוחות השתנה כדי שיהיה לכם קל יותר לזהות שילובים תקפים של מאפיינים, מדדים ומסננים שאפשר להשתמש בהם כדי לאחזר כל דוח. בטבלה הבאה, שבה מוסבר על הדוח 'סוג המכשיר' בערוצים, מוצג הפורמט החדש:

    תוכן עניינים
    מאפיינים:
    חובה deviceType
    אפשר להשתמש ב-0 או יותר ‫day, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct
    מדדים:
    משתמשים ב-1 או יותר ‫views, ‏ estimatedMinutesWatched
    מסננים:
    משתמשים ב-0 או ב-1 ‫country, ‏ province, ‏ continent, ‏ subContinent
    משתמשים ב-0 או ב-1 ‫video, ‏ group
    אפשר להשתמש ב-0 או יותר ‫operatingSystem, ‏ liveOrOnDemand, ‏ subscribedStatus, ‏ youtubeProduct

    המונחים שמתארים שדות חובה ושדות אופציונליים מוסברים במסמכי התיעוד של דוחות channel ו-content owner.

  • ממשק ה-API של YouTube Analytics מסיר עכשיו באופן אוטומטי ממסננים שתומכים במספר ערכים (video,‏ playlist ו-channel) ישויות שמשתמש ה-API לא יכול לאחזר עבורן נתונים. בעבר, שרת ה-API היה מחזיר שגיאה אם למשתמש ה-API לא הייתה גישה לנתונים של פריט אחד לפחות מבין הפריטים שצוינו.

    לדוגמה, נניח שמשתמש שולח בקשת API שבה המסנן video מפרט 20 מזהי סרטונים. המשתמש הוא הבעלים של 18 מהסרטונים. עם זאת, מזהה אחד מזהה סרטון שנמצא בבעלות של ערוץ אחר, ומזהה אחר מזהה סרטון שנמחק ולכן הוא כבר לא קיים. במקרה כזה, במקום להחזיר שגיאה, שרת ה-API משמיט את שני הסרטונים שהמשתמש לא יכול לגשת אליהם, ותגובת ה-API מכילה נתונים לגבי 18 הסרטונים שבבעלות משתמש ה-API.

  • אם שולחים בקשה לנתונים של group ריק ב-YouTube Analytics, ה-API מחזיר עכשיו מערך נתונים ריק במקום שגיאה.

  • השיטה groupItems.insert של YouTube Analytics API מחזירה עכשיו שגיאה לא מורשית (קוד תגובת HTTP‏ 403) אם מנסים להוסיף ישות לקבוצה אבל אין גישה לישות הזו. בעבר, ה-API היה מאפשר להוסיף את הישות לקבוצה, אבל אחר כך היה מחזיר שגיאת הרשאה כשניסיתם לאחזר נתוני דוחות עבור הקבוצה הזו.

  • ה-method ‏groups.list של YouTube Analytics API תומך עכשיו בהגדרת מעברי עמוד. אם תגובת ה-API לא מכילה את כל הקבוצות הזמינות, הפרמטר nextPageToken בתגובה מציין אסימון שאפשר להשתמש בו כדי לאחזר את הדף הבא של התוצאות. מגדירים את הפרמטר pageToken של השיטה לערך הזה כדי לאחזר תוצאות נוספות.

‫10 בנובמבר 2015

העדכון הזה כולל את השינויים הבאים:

‫29 באוקטובר 2015

העדכון הזה כולל את השינויים הבאים:

  • התיעוד של המאפיין date ב-YouTube Reporting API תוקן כדי לשקף שתאריכים מתייחסים לתקופה של 24 שעות שמתחילה בחצות לפי שעון החוף המערבי (UTC-8). בעבר, בתיעוד צוין שהתאריך מתחיל בשעה 00:00 (GMT).

    בנוסף, עדכנו את התיעוד של YouTube Analytics API כדי לציין שכל המאפיינים שקשורים לתאריכים (day,‏ 7DayTotals,‏ 30DayTotals ו-month) מתייחסים לתאריכים שמתחילים בחצות לפי שעון החוף הפסיפי (UTC-8).

  • ה-method ‏jobs.reports.list() של YouTube Reporting API תומך עכשיו בפרמטר השאילתה createdAfter. אם מציינים את הפרמטר הזה, בתגובת ה-API יופיעו רק דוחות שנוצרו אחרי התאריך והשעה שצוינו, כולל דוחות חדשים עם נתונים שנוספו בדיעבד. שימו לב: ערך הפרמטר מתייחס לזמן שבו הדוח נוצר, ולא לתאריכים שמשויכים לנתונים שמוחזרים.

    ערך הפרמטר הוא חותמת זמן בפורמט RFC3339 UTC ‏'Zulu', ברמת דיוק של מיקרו-שניות. דוגמה: "2015-10-02T15:01:23.045678Z"

    גם השיטות המומלצות לשימוש ב-YouTube Reporting API עודכנו. עכשיו מוסבר בהן איך אפשר להשתמש בפרמטר createdAfter כדי להימנע מעיבוד חוזר של אותו דוח.

  • הגדרות המאפיין createTime של המשאב job והמאפיינים startTime, endTime ו-createTime של המשאב report תוקנו כך שיצוין בהן שערכי המאפיינים מדויקים עד מיקרו-שנייה, ולא עד ננו-שנייה. בנוסף, כל ההגדרות משקפות עכשיו בצורה מדויקת שערך המאפיין הוא חותמת זמן.

‫8 באוקטובר 2015

העדכון הזה כולל את השינויים הבאים:

  • המסמכים של מאפיין sharingService ב-YouTube Analytics API עודכנו, ועכשיו מופיעה בהם רשימה של ערכי מאפיינים אפשריים. הרשימה כוללת מספר שירותים חדשים שנתמכים.

    הגדרת המאפיין sharing_service ב-YouTube Reporting API עודכנה גם היא, ועכשיו מופיעים בה הערכים החדשים הנתמכים. ערכי ה-enum שגדולים מ-59 הם הערכים החדשים ברשימה.

‫24 בספטמבר 2015

העדכון הזה כולל את השינויים הבאים:

  • ‫YouTube Reporting API החדש מאחזר דוחות נתונים בכמות גדולה שמכילים נתונים מ-YouTube Analytics לגבי ערוץ או בעלי תוכן. היא מיועדת לאפליקציות שיכולות לייבא קבוצות גדולות של נתונים, ומספקות כלים לסינון, למיון ולכריית הנתונים האלה.

    כל דוח ב-YouTube Reporting API מכיל קבוצה מוגדרת מראש של מאפיינים ומדדים. (גם בדוחות של YouTube Analytics API נעשה שימוש במדדים ובמאפיינים). בדוח, לכל שורת נתונים יש שילוב ייחודי של ערכי מאפיינים. אפשר לצבור נתונים בשורות על סמך ערכי מאפיינים כדי לחשב מדדים לסרטונים בודדים, למדינות, לסרטונים בשידור חי, למשתמשים שנרשמו לערוץ וכו'.

    אתם יכולים להשתמש ב-API כדי לתזמן משימות דיווח, שכל אחת מהן מזהה דוח ש-YouTube צריך ליצור. אחרי שמגדירים משימה, מערכת YouTube יוצרת דוח יומי שאפשר להוריד באופן אסינכרוני. כל דוח מכיל נתונים לתקופה ייחודית של 24 שעות.

  • ממשקי ה-API של YouTube Analytics ושל YouTube Reporting הם ממשקים שונים, אבל שניהם מאפשרים למפתחים לאחזר נתונים מ-YouTube Analytics. מכיוון ששני ממשקי ה-API מספקים גישה למערכי נתונים דומים, אנחנו מפרסמים את התיעוד של שני ממשקי ה-API כקבוצת תיעוד אחת.

    • בכרטיסייה Guides (מדריכים) בסט מסמכי התיעוד יש מידע שמשותף לשני ממשקי ה-API, כולל הוראות לאישור בקשות ל-API.
    • בכרטיסייה דוחות בכמות גדולה מופיעים מסמכי עזר ותוכן אחר שרלוונטיים ל-YouTube Reporting API.
    • הכרטיסייה שאילתות ממוקדות מכילה מסמכי עזר ותוכן אחר שמתייחסים ספציפית ל-YouTube Analytics API.
    • בכרטיסייה Samples (דוגמאות) מפורטות דוגמאות קוד שזמינות לכל אחד משני ממשקי ה-API.
    • בכרטיסייה כלים מפורטים משאבים נוספים שיכולים לעזור למפתחים להטמיע את אחד משני ממשקי ה-API.

‫20 באוגוסט 2015

העדכון הזה כולל את השינויים הבאים:

  • שינינו את המבנה של מאמרי העזרה של ה-API כדי שיהיה קל יותר להבין אותו. לכן, השינויים האלה לא מתארים תכונות חדשות:

    • במסמכי העזרה יש עכשיו דף אחד שבו מפורטים כל הדוחות שקשורים לערוצים ודף נוסף שבו מפורטים כל הדוחות שקשורים לבעלי תוכן. בעבר, במסמכי העזרה היו דפים נפרדים לדוחות על סרטונים בערוץ, דוחות על פלייליסטים בערוץ וכן הלאה.

    • בסקירה הכללית של מודל הנתונים החדש אנחנו מסבירים בצורה ברורה יותר איך ה-API פועל. במסמך הזה אנחנו מנסים להסביר בצורה טובה יותר איך YouTube משתמש במדדים, במאפיינים ובמסננים כדי לחשב את הערכים בדוחות.

    • השיטה reports.query של ה-API, שמשמשת לאחזור דוחות, מתועדת עכשיו בנפרד. המידע שמופיע בדף הזה הופיע בעבר בדפים אחרים. הדף החדש נועד לעזור לכם לזהות בקלות רבה יותר את המידע שאתם צריכים לשלוח כדי לקבל דוח.

‫22 ביולי 2015

העדכון הזה כולל כמה שינויים, שכולם רלוונטיים רק לבעלי תוכן:

  • המדד החדש adEarnings כולל את סך כל הרווחים המשוערים (נטו) מכל מקורות הפרסום שנמכרו על ידי Google. זה לא מדד מרכזי. ה-API תומך במדד adEarnings בכל דוח שכבר תמך במדד earnings.

    בנוסף, הגדרת המדד earnings תוקנה כדי לשקף את העובדה שהערך שלו כולל את סך כל הרווחים המשוערים מכל מקורות הפרסום שנמכרו על ידי Google, וגם ממקורות שאינם פרסומיים. בעבר, ההגדרה ציינה באופן שגוי שהמדד כולל רק רווחים ממקורות פרסום.

  • המדד primaryAdGrossRevenue הוצא משימוש. במקום זאת, אפשר להשתמש במדד grossRevenue כדי לאחזר נתוני הכנסות.

  • בנוסף למדד primaryAdGrossRevenue שהוצא משימוש, דוחות הביצועים של המודעות לא תומכים יותר במדדים monetizedPlaybacks ו-playbackBasedCpm. עם זאת, חלק מהדוחות על סרטונים עדיין תומכים במדדים האלה.

‫1 ביוני 2015

העדכון הזה כולל את השינויים הבאים:

  • ה-API תומך עכשיו בשני מדדים חדשים לדוחות על סרטונים: videosAddedToPlaylists ו-videosRemovedFromPlaylists. עדכנו את רשימות הדוחות על סרטונים בערוצים ובחשבונות של בעלי תוכן כדי לציין אילו דוחות תומכים במדדים החדשים.

    • ‫videosAddedToPlaylists – מספר הפעמים שסרטונים בהיקף השאילתה נוספו לפלייליסטים כלשהם ב-YouTube. יכול להיות שהסרטונים נוספו לפלייליסט של בעלי הסרטון או לפלייליסטים של ערוצים אחרים.
    • ‫videosRemovedFromPlaylists – מספר הפעמים שסרטונים בהיקף השאילתה הוסרו מפלייליסטים ב-YouTube. יכול להיות שהסרטונים הוסרו מהפלייליסט של בעל הסרטון או מהפלייליסטים של ערוצים אחרים.

    שני המדדים כוללים פלייליסטים שמוגדרים כברירת מחדל, כמו הפלייליסט 'לצפייה בהמשך'. עם זאת, המערכת לא סופרת פלייליסטים שסרטון מתווסף אליהם באופן אוטומטי, כמו פלייליסט הסרטונים שהועלו בערוץ או היסטוריית הצפייה של משתמש. חשוב גם לזכור שהמדדים האלה משקפים את המספר המוחלט של התוספות והמחיקות. לכן, אם משתמש מוסיף סרטון לפלייליסט, מסיר אותו ואז מוסיף אותו שוב, המדדים יציינו שהסרטון נוסף לשני פלייליסטים והוסר מאחד.

    הנתונים לגבי המדדים האלה זמינים החל מ-1 באוקטובר 2014.

‫31 במרץ 2015

העדכון הזה כולל את השינויים הבאים:

‫16 במרץ 2015

העדכון הזה כולל את השינויים הבאים:

  • הפרמטר החדש currency מאפשר לאחזר מדדי רווחים במטבע שאינו דולר ארה"ב (USD). אם הפרמטר מוגדר, ה-API ממיר את הערכים של המדדים earnings, grossRevenue, playbackBasedCpm ו-impressionBasedCpm למטבע שצוין. הערכים שמוחזרים הם אומדנים שמחושבים לפי שערי חליפין שמשתנים מדי יום.

    ערך הפרמטר הוא קוד מטבע בן שלוש אותיות לפי תקן ISO 4217. ערך ברירת המחדל הוא USD. הגדרת הפרמטר מכילה רשימה של קודי מטבע נתמכים.

‫25 בפברואר 2015

העדכון הזה כולל את השינויים הבאים:

  • ה-API תומך עכשיו ביצירה ובניהול של קבוצות ב-YouTube Analytics, וגם באחזור של נתוני דוחות עבור הקבוצות האלה.

    • יצירה וניהול של קבוצות

      במסגרת העדכון הזה, הוספנו את משאבי group ו-groupItem ליצירה ולניהול של קבוצות.

      • רכיב group מייצג קבוצה ב-Analytics, אוסף מותאם אישית של עד 200 ערוצים, סרטונים, פלייליסטים או נכסים. ה-API תומך ב-methods‏ list,‏ insert,‏ update ו-delete עבור המשאב הזה.
      • מקור המידע groupItem מייצג פריט בקבוצה ב-Analytics. ה-API תומך ב-methods‏ list,‏ insert ו-delete עבור המשאב הזה.

      לדוגמה, אפשר ליצור קבוצה באמצעות השיטה groups.insert ואז להוסיף פריטים לקבוצה באמצעות השיטה groupItems.insert.

    • אחזור נתוני דוחות של קבוצה

      עדכנו את התיעוד של מאפיינים כדי לכלול את המאפיין group, שאפשר להשתמש בו כמסנן עבור הרבה דוחות על ערוצים ודוחות על בעלי תוכן. כשמשתמשים במסנן group, ה-API מחזיר נתונים של כל הפריטים בקבוצה הזו. שימו לב: נכון לעכשיו, ה-API לא תומך ביצירת דוחות לקבוצות נכסים.

    מידע נוסף על קבוצות ב-YouTube Analytics זמין במרכז העזרה של YouTube.

‫13 בפברואר 2015

העדכון הזה כולל את השינויים הבאים:

  • ה-API כבר לא תומך במאפיין show.

‫28 באוגוסט 2014

העדכון הזה כולל את השינויים הבאים:

  • ה-API תומך עכשיו באפשרות לציין כמה ערכים למאפיינים video, playlist, channel ו-show כשמשתמשים במאפיינים האלה כמסננים. כדי לציין כמה ערכים, מגדירים את ערך הפרמטר filters כרשימה של מזהי הסרטונים, הפלייליסטים, הערוצים או התוכניות שרוצים לסנן את תגובת ה-API לפי המזהים האלה, כשהמזהים מופרדים באמצעות פסיקים. ערך הפרמטר יכול לכלול עד 200 מזהים.

    אם מציינים כמה ערכים לאותו מסנן, אפשר גם להוסיף את המסנן הזה לרשימת המאפיינים שמציינים בבקשה. זה נכון גם אם המסנן לא מופיע כמאפיין נתמך בדוח מסוים. אם מוסיפים את המסנן לרשימת המאפיינים, ה-API משתמש גם בערכי המסנן כדי לקבץ את התוצאות.

    פרטים מלאים על הפונקציונליות הזו מופיעים בהגדרה של הפרמטר filters.

‫16 ביולי 2014

העדכון הזה כולל את השינויים הבאים:

  • כשמאחזרים דוח ערוצים, אפשר עכשיו לאחזר נתונים של הערוץ של המשתמש המאומת על ידי הגדרת הערך של הפרמטר ids ל-channel==MINE. (אפשר גם להגדיר את הפרמטר ids לערך channel==CHANNEL_ID כדי לאחזר נתונים של הערוץ שצוין).

  • ה-API תומך עכשיו בדוחות פלייליסטים, שמכילים נתונים סטטיסטיים שקשורים לצפיות בסרטונים שמתרחשות בהקשר של פלייליסט. דוחות פלייליסטים זמינים לערוצים ולבעלי תוכן.

    כל הדוחות של פלייליסטים תומכים במדדים views ו-estimatedMinutesWatched, וחלקם תומכים גם במדד averageViewDuration.

    בנוסף, כל הדוחות של הפלייליסטים תומכים במדדים החדשים הבאים. שימו לב שכל אחד מהמדדים האלה משקף רק צפיות בפלייליסט שהתרחשו באינטרנט.

    • ‫playlistStarts: מספר הפעמים שצופים יזמו הפעלה של פלייליסט.
    • ‫viewsPerPlaylistStart: המספר הממוצע של צפיות בסרטונים שהתרחשו בכל פעם שהופעל פלייליסט.
    • ‫averageTimeInPlaylist: אומדן משך הזמן הממוצע, בדקות, שמשתמש צפה בסרטונים בפלייליסט אחרי שהפלייליסט התחיל.

    כל בקשה לאחזור דוח של פלייליסט חייבת להשתמש במסנן isCurated, שצריך להגדיר אותו לערך 1 (isCurated==1).

  • ה-API תומך עכשיו בדוח שימור הקהל. בדוח הזה אפשר לראות עד כמה הסרטון מצליח לשמור על רמת העניין של הצופים. המאפיין החדש elapsedVideoTimeRatio בדוח מודד את משך הזמן שחלף בסרטון עבור ערכי המדדים התואמים:

    • המדד audienceWatchRatio מזהה את היחס המוחלט של הצופים שצופים בסרטון בנקודה מסוימת בסרטון. היחס מחושב על ידי השוואה בין מספר הפעמים שמשתמשים צפו בחלק מסוים בסרטון לבין מספר הצפיות הכולל בסרטון.

      חשוב לדעת שאפשר לצפות בחלק מסוים של סרטון יותר מפעם אחת (או לא לצפות בו בכלל) במהלך צפייה בסרטון. לדוגמה, אם משתמשים מריצים אחורה וצופים באותו חלק בסרטון כמה פעמים, היחס האבסולוטי של אותו חלק בסרטון יכול להיות גדול מ-1.

    • המדד relativeRetentionPerformance מראה באיזו מידה הסרטון מצליח לשמר את רמת העניין של הצופים במהלך ההפעלה בהשוואה לכל סרטוני YouTube באורך דומה. ערך של 0 מציין שהסרטון שומר על רמת העניין של הצופים בצורה פחות טובה מכל סרטון אחר באורך דומה, ואילו ערך של 1 מציין שהסרטון שומר על רמת העניין של הצופים בצורה טובה יותר מכל סרטון אחר באורך דומה. ערך חציוני של 0.5 מציין שבמחצית מהסרטונים באורך דומה שימור הצופים טוב יותר, ובמחצית מהסרטונים שימור הצופים גרוע יותר.

    אפשר גם להשתמש במסנן audienceType כדי שהדוח יציג רק נתונים שקשורים לצפיות אורגניות, לצפיות ממודעות וידאו TrueView In-stream או לצפיות ממודעות TrueView ברשת המדיה. (צפיות אורגניות הן תוצאה ישירה של פעולת משתמש, כמו חיפוש סרטון או לחיצה על סרטון מוצע).

  • ה-API תומך בכמה מדדים חדשים שקשורים להערות. אפשר לאחזר את המדדים שמופיעים בהמשך עם כל הדוחות שתמכו בעבר במדדים annotationClickThroughRate ו-annotationCloseRate.

    כל המדדים החדשים הם מדדי ליבה וכפופים למדיניות הוצאה משימוש. עם זאת, חשוב לזכור שהנתונים של המדדים החדשים זמינים החל מ-16 ביולי 2013. (הנתונים של המדדים annotationClickThroughRate ו-annotationCloseRate זמינים החל מ-10 ביוני 2012).

  • הערך GOOGLE_SEARCH לא מדווח יותר כערך נפרד למאפיין insightTrafficSourceType. במקום זאת, הפניות מתוצאות החיפוש ב-Google משויכות עכשיו לסוג מקור התנועה EXT_URL. כתוצאה מכך, אי אפשר יותר לאחזר דוח insightTrafficSourceDetail שבו המסנן insightTrafficSourceType מוגדר לערך GOOGLE_SEARCH.

‫31 בינואר 2014

העדכון הזה כולל את השינויים הבאים:

‫16 בינואר 2014

העדכון הזה כולל את השינויים הבאים:

  • עיצבנו מחדש את המסמך בקשות לדוגמה כדי לקבץ את הדוגמאות בקטגוריות, באמצעות פורמט של כרטיסיות שדומה לפורמט שפורסם לאחרונה בדוחות של בעלי ערוצים ובעלי תוכן. בממשק החדש, הדוגמאות מקובצות בקטגוריות הבאות:

    • נתונים סטטיסטיים בסיסיים
    • מבוסס-זמן
    • גיאוגרפי
    • מקומות שבהם הסרטון הופעל
    • מקור תנועה
    • מכשיר/מערכת הפעלה
    • מאפיינים דמוגרפיים
    • רשתות חברתיות
    • רווחים/מודעות (בדוחות של בעלי תוכן בלבד)

  • מסמך בקשות לדוגמה כולל עכשיו דוגמאות חדשות לאחזור נתונים ספציפיים למחוז בדוחות ערוצים או בדוחות בעלי תוכן.

    • מדדים ספציפיים למחוזות במדינות בארה"ב ובוושינגטון די.סי.: בדוח הזה אפשר לראות פירוט של מספר הצפיות ונתונים סטטיסטיים אחרים של סרטונים בערוץ, לפי מחוז. הנתונים כוללים את מדינות ארה"ב ואת וושינגטון די.סי. בדוגמה נעשה שימוש במאפיין province ובפרמטר filters כדי להגביל את התשובה כך שתכלול רק תוצאות של ארצות הברית.

    • דמוגרפיה של הצופים בקליפורניה (קבוצת גיל ומגדר): בדוח הזה מוצגים נתונים סטטיסטיים על קבוצת הגיל והמגדר של צופים בקליפורניה שצפו בסרטונים בערוץ מסוים, או בתוכן שבעלי תוכן הגישו לגביו תביעת זכויות יוצרים (במקרה של דוחות לבעלי תוכן). בדוגמה הזו נעשה שימוש בפרמטר filters כדי לוודא שהתשובה כוללת רק נתונים של מחוז מסוים.

  • העדכנו את ההגדרה של מאפיין province כדי לציין שאם הפרמטר province נכלל בערך הפרמטר dimensions, הבקשה צריכה גם להגביל את הנתונים לארצות הברית על ידי הכללת country==US בערך הפרמטר filters.

‫6 בינואר 2014

העדכון הזה כולל את השינויים הבאים:

  • עיצבנו מחדש את המסמכים שבהם מפורטים הדוחות הנתמכים של ערוצים ובעלי תוכן. במקום לספק טבלה עם רשימה של כל הדוחות האפשריים, כל מסמך מקבץ את הדוחות לקטגוריות:

    • נתונים סטטיסטיים בסיסיים
    • מבוסס-זמן
    • גיאוגרפי
    • מקומות שבהם הסרטון הופעל
    • מקור תנועה
    • מכשיר/מערכת הפעלה
    • מאפיינים דמוגרפיים
    • רשתות חברתיות
    • סרטונים מובילים

    בכל מסמך, הקטגוריות האלה מוצגות כרשימה של כרטיסיות. אפשר ללחוץ על כל כרטיסייה כדי לראות את הדוחות הנתמכים בקטגוריה הזו.

  • ה-API תומך עכשיו בשלושה מאפיינים גיאוגרפיים חדשים: province,‏ continent ו-subContinent.

    • המאפיין province מאפשר לאחזר נתונים סטטיסטיים של מדינות בארה"ב ושל מחוז קולומביה. ה-API תומך בשני שימושים במאפיין הזה:

      • ה-API תומך בשני דוחות שמפרטים את הנתונים הסטטיסטיים לפי מדינה. שני הדוחות זמינים לערוצים ולבעלי תוכן.

        • בדוח הנתונים הסטטיסטיים העיקריים מופיעים כמה נתונים סטטיסטיים, כולל מספר הצפיות ומשך הצפייה המשוער בדקות.
        • הדוח שמבוסס על זמן מספק את אותם נתונים סטטיסטיים, אבל הנתונים נצברים על בסיס יומי, שבועי, חודשי או 30-יומי.

      • אתם יכולים להשתמש בפרמטר השאילתה filters כדי להגביל את הדוח כך שיכיל רק נתונים סטטיסטיים של מדינה מסוימת. מספר דוחות תומכים בסוג הסינון הזה, כולל דוחות גיאוגרפיים, דוחות על מקומות שבהם הסרטון הופעל, דוחות על מקורות תנועה, דוחות על מכשירים, דוחות על מערכות הפעלה, דוחות דמוגרפיים ודוחות על סרטונים מובילים.

    • במאפיין continent מציינים קוד סטטיסטי של האו"ם (UN) שמזהה יבשת. אפשר להשתמש במאפיין הזה רק כמסנן.

    • המאפיין subContinent מציין קוד סטטיסטי של אזור של האו"ם (UN) שמזהה אזור משנה ביבשת. אפשר להשתמש במאפיין הזה רק כמסנן.

      מכיוון שכל אזור משנה משויך רק ליבשת אחת, אין צורך להשתמש גם בפילטר continent כשמשתמשים בפילטר subContinent. (למעשה, ה-API יחזיר שגיאה אם בקשה תשתמש בשני המאפיינים).

  • תיקנו את התיעוד כך שהמאפיין insightTrafficSourceDetail לא כולל את הערך insightTrafficSourceType PROMOTED כערך מסנן תקין.

‫30 בספטמבר 2013

העדכון הזה כולל את השינויים הבאים:

  • החל מעכשיו, השימוש ב-YouTube Analytics API כפוף למדיניות ההוצאה משימוש שמתוארת בתנאים ובהגבלות. עם זאת, מאפיינים ומדדים שאינם מרכזיים ב-API לא כפופים למדיניות ההוצאה משימוש. הדפים מאפיינים ומדדים עודכנו וכוללים עכשיו רשימה של מאפייני ליבה ומדדי ליבה. בנוסף, הגדרות המאפיינים והמדדים בדפים האלה עודכנו כך שהן מזהות במפורש מאפיינים ומדדים מרכזיים.

  • ה-API תומך עכשיו בערך EXTERNAL_APP במאפיין insightPlaybackLocationType. במקביל לעדכון הזה, החל מ-10 בספטמבר 2013, הפעלות לא מסווגות יותר כהפעלות MOBILE, אבל הפעלות בנייד שהתרחשו לפני התאריך הזה עדיין יסווגו עם הערך הזה.

    בעקבות העדכון הזה, הפעלות בנייד מסווגות עכשיו כהפעלות מסוג WATCH, EMBEDDED או EXTERNAL_APP, בהתאם לסוג האפליקציה שבה מתרחשות ההפעלות.

  • ה-API תומך עכשיו בערך PLAYLIST במאפיין insightTrafficSourceType. הערך מציין שהצפיות בסרטון הגיעו מהפניה מפלייליסט. בעבר, הצפיות האלה היו מסווגות לפי הקטגוריה של המאפיין YT_OTHER_PAGE.

‫16 ביולי 2013

העדכון הזה כולל את השינויים הבאים:

  • ה-API תומך עכשיו באפשרות למיין דוחות לפי כמה מאפיינים ומדדים. מסמך בקשות לדוגמה מכיל דוגמה חדשה, מיון בקשות לפי מספר מאפיינים או מדדים, שממחישה את הפונקציונליות הזו. הבקשה מאחזרת נתונים על מקורות תנועה וערך הפרמטר sort הוא day,-views. התוצאות ממוינות בסדר כרונולוגי, אבל בתוך קבוצת התוצאות של כל יום, השורה הראשונה מכילה נתונים של מקור התנועה שהניב את מספר הצפיות הגבוה ביותר, השורה השנייה מכילה נתונים של המקור שהניב את מספר הצפיות הגבוה הבא, וכן הלאה.

  • ה-API תומך עכשיו בשני מאפיינים חדשים, deviceType ו-operatingSystem, שאפשר להשתמש בהם כדי לאחזר נתונים על המכשירים שבהם הצופים צופים בסרטונים שלכם. ה-API תומך בדוחות שכוללים את אחד המאפיינים או את שניהם.

    • בדוח deviceType אפשר לאחזר את מספר הצפיות ואת זמן הצפייה המשוער בסוגים שונים של מכשירים, כולל מחשבים, מכשירים ניידים וטאבלטים. אפשר גם להשתמש במסנן operatingSystem כדי להגביל את הדוח 'סוג המכשיר' כך שיכיל רק נתונים סטטיסטיים של מכשירים שמופעלת בהם מערכת הפעלה ספציפית, כמו Android או iOS.

    • בדוח operatingSystem אפשר לאחזר את מספר הצפיות ואת זמן הצפייה המשוער במערכות הפעלה שונות, כמו Android,‏ iOS,‏ Linux ועוד. אפשר גם להשתמש במסנן deviceType כדי להגביל את הדוח של מערכת ההפעלה כך שיכלול רק נתונים סטטיסטיים לגבי סוג מסוים של מכשיר, כמו מכשירים ניידים או טאבלטים.

    הדוחות החדשים על סוג המכשיר ומערכת ההפעלה זמינים לערוצים ולבעלי תוכן.

  • עדכנו את המסמך בקשות לדוגמה כך שיכלול שלושה דוחות מכשירים לערוצים ושלושה דוחות מכשירים לבעלי תוכן.

  • יכול להיות שהמאפיין insightPlaybackLocationType יחזיר את הערך YT_OTHER, שמזהה תצוגות שלא סווגו באמצעות אחד מהערכים האחרים של המאפיין.

‫23 במאי 2013

העדכון הזה כולל את השינויים הבאים:

‫10 במאי 2013

העדכון הזה כולל את השינויים הבאים:

‫6 במאי 2013

העדכון הזה כולל את השינויים הבאים:

  • ה-API תומך עכשיו באפשרות לאחזר מדדי זמן צפייה – estimatedMinutesWatched, averageViewDuration ו-averageViewPercentage – בשילוב עם מדדים אחרים, כולל מדדי צפייה, מדדי מעורבות, מדדי רווחים ומדדי ביצועי מודעות.

    עדכנו את הרשימות של דוחות הערוצים ודוחות בעלי התוכן כדי לשקף את השינוי הזה. (הרשימות קצרות יותר עכשיו כי אפשר לאחזר את מדדי זמן הצפייה כחלק מדוחות אחרים שמופיעים ברשימה).

    גם המסמך דוגמאות לבקשות API עודכן.

  • הדוחות שמשתמשים במאפיינים insightPlaybackLocationDetail ו-insightTrafficSourceDetail שופרו בדרכים הבאות:

    • הם תומכים עכשיו במסנן country אופציונלי.

    • בעלי תוכן יכולים עכשיו לאחזר את הדוחות האלה באמצעות כל אחת מהקומבינציות החדשות הבאות של filter. שימו לב שכל השילובים האלה תומכים גם במסנן האופציונלי country.

      • פרטים על מקומות שבהם הסרטון הופעל

        • channel,insightPlaybackLocationType==EMBEDDED
        • show,insightPlaybackLocationType==EMBEDDED
        • claimedStatus,insightPlaybackLocationType==EMBEDDED
        • uploaderType,insightPlaybackLocationType==EMBEDDED
        • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

      • פרטים על מקור התנועה

        • channel,insightTrafficSourceType
        • show,insightTrafficSourceType
        • claimedStatus,insightTrafficSourceType
        • uploaderType,insightTrafficSourceType
        • uploaderType,claimedStatus,insightTrafficSourceType

‫3 במאי 2013

העדכון הזה כולל את השינויים הבאים:

  • במסמך החדש Sample API requests (דוגמאות לבקשות API) יש דוגמאות שמדגימות איך לאחזר סוגים רבים ושונים של דוחות באמצעות YouTube Analytics API. כל דוגמה כוללת תיאור קצר של הדוח שהבקשה מאחזרת, ואז מציגה את המאפיינים, המדדים, המסננים ופרמטרים המיון של הבקשה.

  • המאפיין insightTrafficSourceType תומך עכשיו בערך SUBSCRIBER. הערך הזה מציין צפיות בסרטונים שהגיעו מפידים בדף הבית של YouTube או מתכונות המינויים של YouTube. אם מסננים לפי מקור התנועה הזה, בשדה insightTrafficSourceDetail יצוין פיד דף הבית או דף אחר שממנו הופנו הצפיות.

‫28 במרץ 2013

העדכון הזה כולל את השינויים הבאים:

  • ה-API תומך עכשיו בשני מדדים חדשים, annotationClickThroughRate ו-annotationCloseRate, שקשורים לאינטראקציות של הצופים עם הערות שמוצגות במהלך הסרטונים. עדכנו את הרשימות של דוחות הערוץ ודוחות בעלי התוכן כדי לציין אילו דוחות תומכים במדדים החדשים.

    • ‫annotationClickThroughRate – היחס בין ההערות שהצופים לחצו עליהן לבין המספר הכולל של חשיפות של הערות קליקביליות.
    • ‫annotationCloseRate – היחס בין מספר ההערות שהצופים סגרו לבין המספר הכולל של חשיפות ההערות.

‫21 במרץ 2013

העדכון הזה כולל את השינויים הבאים:

  • ה-API תומך עכשיו במדדי רווחים וביצועי מודעות, וגם בדוחות חדשים של ביצועי מודעות. המדדים והדוחות זמינים רק לשותפי תוכן ב-YouTube שמשתתפים בתוכנית השותפים של YouTube.

    • הדוחות החדשים שנתמכים כוללים מדדי ביצועים של מודעות שמבוססים על הפעלות ומדדי ביצועים של מודעות שמבוססים על חשיפות. מידע נוסף על דוחות ביצועי המודעות זמין במאמר בנושא דוחות של בעלי תוכן.

    • בהמשך מפורטים המדדים החדשים שנתמכים. הרשימה של דוחות בעלי התוכן עודכנה כדי לזהות את הדוחות שתומכים במדדים האלה, כולל שני הדוחות החדשים.

      • ‫earnings – סך כל הרווחים המשוערים מכל מקורות הפרסום שנמכרים על ידי Google.
      • ‫grossRevenue – אומדן ההכנסות ברוטו משותפים של Google או DoubleClick.
      • ‫primaryAdGrossRevenue – אומדן ההכנסות ברוטו, מסוכם ומסווג לפי סוג המודעה העיקרי להפעלות הסרטונים שהדוח מתייחס אליהן, מ-Google או משותפי DoubleClick.
      • ‫monetizedPlaybacks – מספר הצפיות שבהן הוצגה לפחות חשיפה אחת של מודעה.
      • ‫playbackBasedCpm – הכנסה משוערת ברוטו לכל אלף הפעלות.
      • ‫impressions – מספר החשיפות המאומתות של מודעות שהוצגו.
      • ‫impressionBasedCpm – ההכנסה המשוערת ברוטו לאלף חשיפות של מודעות.

      הערה: פרטים מלאים מופיעים בהגדרות המדדים.

    • כל בקשה לאחזור נתוני רווחים או מדדי ביצועי מודעות חייבת לשלוח אסימון הרשאה שמעניק גישה באמצעות היקף ההרשאות החדש https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

  • ארגנו מחדש את מאמרי העזרה של ה-API כך שסוגים שונים של דוחות מוסברים בדפים נפרדים. לכן, יש עכשיו דפים נפרדים עם הסברים על הסוגים השונים של דוחות ערוצים ודוחות בעלי תוכן.

‫4 בפברואר 2013

העדכון הזה כולל את השינויים הבאים:

  • במדריך העזר של ה-API יש עכשיו קטע דוגמאות, שכולל דוגמאות קוד שמדגימות איך לקרוא ל-API באמצעות ספריות הלקוח של Java,‏ JavaScript,‏ Python ו-Ruby. דוגמת הקוד ב-JavaScript היא אותה דוגמה שמוסברת בפירוט במסמכי התיעוד של האפליקציה לדוגמה.

‫14 בנובמבר 2012

העדכון הזה כולל את השינויים הבאים:

  • במדריך ההפניה ל-API יש עכשיו את APIs Explorer, שמאפשר לכם לקרוא ל-API, לראות את בקשת ה-API ולאחזר נתונים אמיתיים בתגובה.

  • ה-API תומך במספר דוחות חדשים לבעלי ערוצים ולבעלי תוכן, שמתוארים בהמשך. כל דוח זמין כדוח ערוץ או כדוח בעל תוכן. גם הדפים בנושא מאפיינים ומדדים עודכנו בהתאם.

    • בדוח מקומות שבהם הסרטון הופעל מצוין מספר הצפיות בסרטון שהתרחשו בסוגים שונים של דפים או אפליקציות.

    • בדוח המפורט 'מקומות שבהם הסרטון הופעל' אפשר לראות אילו נגנים מוטמעים הניבו את מספר הצפיות הגבוה ביותר בסרטון מסוים. הדוח הזה מספק תצוגה מפורטת יותר מאשר הדוח 'מקומות שבהם הסרטון הופעל', כי הוא מזהה את כתובות ה-URL שמשויכות לנגני ההטמעה המובילים.

    • בדוח מקורות התנועה אפשר לראות את מספר הצפיות בסרטונים שהגיעו מסוגים שונים של מקורות מפנים.

    • בדוח 'פרטים על מקורות תנועה' אפשר לראות את האתרים המפנים שהניבו את מספר הצפיות הגבוה ביותר בסרטון מסוים ובסוג מסוים של מקור תנועה. לדוגמה, בעזרת הדוח הזה תוכלו לראות אילו סרטונים קשורים שלחו הכי הרבה תנועה לסרטון ספציפי. הדוח הזה נתמך בכמה מקורות תנועה.

    • בדוחות זמן הצפייה מפורט משך הזמן שהצופים הקדישו לצפייה בתוכן שלכם. בדוחות אפשר לצבור נתונים עבור מסגרת זמן ספציפית – יום, שבעת הימים הקודמים, 30 הימים הקודמים וכו' – או מדינה. אם בדוח מתבצעת צבירה של נתונים לפי יום או לפי מדינה, אפשר גם לציין את משך הצפייה הממוצע בכל סרטון ואת אחוז הצפייה הממוצע בכל סרטון.

‫2 באוקטובר 2012

העדכון הזה כולל את השינויים הבאים:

  • האפשרות YouTube Analytics API זמינה עכשיו לכל המפתחים. אפשר להפעיל את ה-API בפרויקט בלי לבקש גישה קודם, דרך החלונית Services ב-APIs console.

  • בקטע החדש תחילת העבודה מפורטות הדרישות המוקדמות וההוראות הבסיסיות ליצירת אפליקציה שמשתמשת ב-YouTube Analytics API.

‫12 בספטמבר 2012

העדכון הזה כולל את השינויים הבאים:

  • בקטע החדש הבנת השימוש במכסה מפורטות הנחיות לאופטימיזציה של השימוש במכסת ה-API. שרת ה-API מחשב את עלות השאילתה לכל בקשה, והעלות הזו מנוכה ממכסת השימוש ב-API. לסוגים שונים של דוחות יכולות להיות עלויות שונות מאוד של שאילתות, ולכן חשוב לתכנן את השימוש במכסת הבקשות בצורה יעילה. האפליקציה צריכה לשלוח בקשות רק למדדים ולנתונים שהיא באמת צריכה.

  • עדכנו את הקטע מאפיינים שקשורים לזמן כדי להסביר שהמאפיינים האלה מציינים שבדוח Analytics צריך לצבור נתונים על סמך תקופת זמן. ה-API תומך עכשיו במאפיינים נוספים שקשורים לזמן:

    • ‫7DayTotals – הנתונים בדוח יצטברו כך שכל שורה תכיל נתונים לתקופה של שבעה ימים.
    • ‫30DayTotals – הנתונים בדוח יצטברו כך שכל שורה תכיל נתונים לתקופה של 30 יום.
    • ‫month – הנתונים בדוח יצטברו לפי חודש קלנדרי.

    באופן דומה, הקטע דוחות זמינים עודכן כדי לשקף את התמיכה של ה-API בדוחות שמשתמשים במאפיינים האלה.

  • בקטע מאפייני ישות הדיווח נוסף הסבר שלפיו בקשות API לאחזור דוחות של בעלי תוכן חייבות לסנן את הנתונים באמצעות אחד מהמאפיינים האלה (video,‏ channel או show) או באמצעות שילוב נתמך של המאפיינים claimedStatus ו-uploaderType.

  • ה-API תומך עכשיו בשתי אפשרויות מיון חדשות לדוחות של סרטונים מובילים. הדוחות האלה, שזמינים כדוחות ערוץ או כדוחות בעלי תוכן, כוללים מדדים (צפיות, תגובות, לייקים וכו') על בסיס כל מדינה, ומפרטים את המדדים האלה לפי סרטון. מעכשיו אפשר למיין את הדוחות האלה לפי מספר המשתמשים שנרשמו לערוץ או ביטלו את המינוי לערוץ מדף הצפייה של הסרטון.

  • הגדרות subscribersGained וsubscribersLost המדדים עודכנו כדי להסביר שאפשר להצטרף לערוץ או לבטל את המינוי אליו בכמה מקומות, כולל בדף הצפייה בסרטון, בדף הערוץ ובמדריך שמופיע בדף הבית של YouTube. כשהמדדים האלה מופיעים בדוח ספציפי לסרטון, הם כוללים רק נתונים סטטיסטיים מדף הצפייה של הסרטון שצוין.