היסטוריית גרסאות

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

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.

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

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

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

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

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

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

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

19 בינואר 2024

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

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

    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

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

  • דוח חדש מציג את פעילות המשתמשים לפי עיר. הדוח זמין עבור ערוצים וגם בעלי תוכן. הדוח הזה מכיל את 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 (דוחות בכמות גדולה) לתמוך בערך פרטי חדש של מקור תנועה:

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

11 בפברואר 2022

קבוצת הערכים החוקיים של המאפיין gender תשתנה באוגוסט או לאחר מכן. 11, 2022. ייתכן שמדובר בשינוי שאינו תואם לאחור בהטמעת ה-API. בהתאם חזרה בקטע 'שינויים לא תואמים' בתנאים ובהגבלות של שירותי YouTube API, השינוי הזה הוא הוכרזו שישה חודשים לפני שהשינוי ייכנס לתוקף. עליך לעדכן את ההטמעה של ה-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. השינוי הזה משפיע גם על ממשק ה-API של YouTube Analytics (שאילתות מטורגטות) וגם על ממשק API של YouTube Reporting (דוחות בכמות גדולה).

2 בפברואר 2022

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

  • ב-YouTube Reporting (Bulk Reports) של ממשק ה-API, traffic_source_type תומך בערך 28.

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

23 בספטמבר 2020

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

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

המאפיין 'פרטי מקור התנועה' — insightTrafficSourceDetail בממשק ה-API של YouTube Analytics או 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

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

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

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

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

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

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

15 באוקטובר 2019

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

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

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

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

    • אפשר לחשב את מספר הצפיות במשך שבעה ימים על ידי צבירת נתונים לגבי מספר הצפיות מכל יום באותה תקופה.
    • כדי לחשב את אחוז הצופים במשך שבעה ימים, מכפילים את מספר הצפיות שהתרחשו בכל יום כפול אחוז הצופה באותו יום, כדי לקבל את מספר הצופים שהיו מחוברים בזמן הצפייה בסרטון באותו יום. לאחר מכן, ניתן להוסיף את מספר הצופים המחוברים לכל התקופה ולחלק את מספר הצפיות הכולל באותה תקופה כדי לקבל את אחוז הצופים לכל התקופה.
    • לא ניתן לחשב את מספר הצופים הייחודיים במשך שבעה ימים, מפני שאפשר לחשב את אותו צופה כצופה ייחודי בימים שונים. עם זאת, ייתכן שתוכלו להשתמש במאפיין 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

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

  • דרישות ההיקף בשיטות הבאות השתנו:
    • בקשות ל-method reports.query חייבות לקבל גישה להיקף של https://www.googleapis.com/auth/youtube.readonly.
    • בקשות ל-method 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

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

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

22 במאי 2018

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

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

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

      לפני ההודעה הזו, כל דוחות ה-API היו זמינים למשך 180 יום מהמועד שבו הופקו. לשם הבהרה, כשהשינוי במדיניות ייכנס לתוקף, לא תהיה יותר גישה דרך ה-API לדוחות של נתונים היסטוריים שנוצרו לפני יותר מ-30 ימים. גם כל הדוחות האחרים שנוצרו לפני יותר מ-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 יום לפני שדוחות כאלה יהיו זמינים.

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

26 באפריל 2018

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

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

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

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

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

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

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

‫21 בפברואר 2018

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

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

18 בינואר 2018

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

  • YouTube Reporting API (דוחות בכמות גדולה)

    • המאפיין 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 (דוחות בכמות גדולה)

    • המאפיין 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 (דוחות בכמות גדולה)

    • המאפיין 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 ב-YouTube Studio יכולים עכשיו לגשת לנתוני ההכנסות גם דרך ה-API של YouTube Analytics:

17 במרץ 2017

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

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

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

    המסמכים של דוחות הערוצים והדוחות של בעלי התוכן עודכנו ועכשיו הם מציגים את הדוחות שתומכים בשני המדדים החדשים. הם נתמכים בכל הדוחות שכבר תומכים במדדים views ו-estimatedMinutesWatched.

3 במרץ 2017

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

  • YouTube Reporting API (דוחות בכמות גדולה)

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

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

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

    • המאפיין operating_system, שמזהה את מערכת התוכנה של המכשיר שבו התרחשו צפיות, תומך עכשיו בערכים הבאים:
      • 22: טיזן
      • 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

ממשק ה-API של YouTube Analytics תומך עכשיו בפרמטר האופציונלי 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 תומך בשלושה דוחות חדשים של מסכי סיום ובמאפיינים ומדדים חדשים לדוחות האלה. הדוחות מספקים נתונים סטטיסטיים על חשיפות ועל שיעור קליקים של מסכי הסיום שמוצגים אחרי שסרטון מפסיק לפעול.

    8 בנובמבר 2016

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

    • המדדים ברשימה הבאה הוצאו משימוש במלואם ואין יותר תמיכה בהם. כפי שהודענו ב-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 של YouTube Analytics API הוצא משימוש. זהו לא מדד עיקרי והוא יהיה נתמך עד 31 באוקטובר 2016.

    15 בספטמבר 2016

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

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

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

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

      בכל דוח, המספר במזהה של סוג הדוח החדש הוא מספר אחד גבוה יותר מהמזהה של סוג הדוח הישן. (הגרסאות הישנות של הדוחות האלה הוצאו משימוש, כפי שמתואר בהמשך בהיסטוריית הגרסאות). לדוגמה, הדוח 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 (שאילתות מטורגטות)

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

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

        שם המדד הישן השם החדש של המדד תאריך התמיכה
        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 (דוחות בכמות גדולה)

      • המאפיין 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 (דוחות בכמות גדולה)

      • בסקירה הכללית על ממשקי ה-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 לא תייצר יותר דוחות חדשים לגבי המשימה.

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

    • אם תנסו ליצור משימה לדוח שהוצא משימוש, השיטה jobs.create תחזיר עכשיו קוד תגובת HTTP (Bad Request) מסוג 400. בנוסף, התיעוד של השיטה מפרט עכשיו כמה סיבות נוספות הגורמות לבקשת 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 Premium. הדוחות יהיו זמינים לבעלי תוכן שכבר יכולים לגשת לדוחות הכנסות שניתן להוריד באופן ידני בסטודיו ליוצרים ב-YouTube. כך, הפונקציונליות החדשה של ה-API תאפשר גישה פרוגרמטית לנתונים האלה.

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

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

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

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

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

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

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

    28 במרץ 2016

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

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

    16 במרץ 2016

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

    YouTube Reporting API

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

    ממשק API של YouTube Analytics

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

    8 בפברואר 2016

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

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

    6 בינואר 2016

    YouTube Reporting API ו-YouTube Analytics API מזהים עכשיו באופן ספציפי צפיות שמתרחשות באמצעות מכשיר 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

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

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

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

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

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

      תוכן עניינים
      מאפיינים:
      חובה deviceType
      צריך להזין 0 או יותר day, liveOrOnDemand, subscribedStatus, youtubeProduct
      מדדים:
      שימוש באחד או יותר צפיות, estimatedMinutesWatched
      מסננים:
      אפשר להזין 0 או 1 מדינה, מחוז, יבשת, subContinent
      אפשר להזין 0 או 1 סרטון, קבוצה
      צריך להזין 0 או יותר operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

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

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

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

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

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

    10 בנובמבר 2015

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

    29 באוקטובר 2015

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

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

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

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

      ערך הפרמטר הוא חותמת זמן לפי "Zulu" בפורמט RFC3339 UTC בפורמט מדויק למיליוניות השנייה. דוגמה: "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 שונים, אבל ממשק ה-API של YouTube Analytics ו-YouTube Reporting API מאפשרים למפתחים לאחזר נתונים מ-YouTube Analytics. מכיוון ששני ממשקי ה-API מספקים גישה למערכי נתונים דומים, מתבצע פרסום של התיעוד עבור שני ממשקי ה-API כקבוצה אחת של מסמכים.

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

    20 באוגוסט 2015

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

    • מסמכי התיעוד של ה-API בנויים מחדש כדי להקל על ההבנה של ה-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 אפשר למצוא מידע נוסף על קבוצות ב-YouTube Analytics.

    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 תומך בשני דוחות עם פירוט הנתונים הסטטיסטיים לפי מדינה (State). שני הדוחות זמינים לערוצים ולבעלי תוכן.

          • דוח הנתונים הסטטיסטיים העיקריים כולל מספר נתונים סטטיסטיים, כולל ספירת צפיות ודקות צפייה משוערות.
          • הדוח שמבוסס על זמן מציג אותם נתונים סטטיסטיים, אבל הוא צובר נתונים על בסיס יומי, 7 ימים, 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

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

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

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

    28 במרץ 2013

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

    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. כשהמדדים האלה מופיעים בדוח ספציפי לסרטון, הם כוללים רק נתונים סטטיסטיים מדף הצפייה של הסרטון שצוין.