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

דף זה מפרט את השינויים בממשק ה-API ואת עדכוני התיעוד של ממשק ה-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. במאמרי העזרה בנושא metrics תוכלו לקרוא את ההגדרות של כל מדד:

  • אופן הפעולה של המדד 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. במאמרי העזרה בנושא metrics תוכלו לקרוא את ההגדרות של כל מדד:

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

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

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

26 באוגוסט 2022

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

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

11 בפברואר 2022

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

2 בפברואר 2022

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

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

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

23 בספטמבר 2020

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

  • ב-API של YouTube Analytics (שאילתות מטורגטות), המאפיין 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 ישויות.
  • הפרמטר filters של השיטה reports.query מזהה רשימה של מסננים שיש להחיל בעת אחזור נתונים של YouTube Analytics. הפרמטר תומך באפשרות לציין ערכים מרובים למסננים video, playlist ו-channel, ומספר המזהים המקסימלי שאפשר לציין למסננים האלה גדל מ-200 ל-500 מזהים.

13 בפברואר 2020

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

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. כפי שמצוין במדיניות למפתחים של שירותי YouTube API (סעיפים III.E.4.b עד III.E.4.d), לקוחות API חייבים למחוק או לרענן מטא-נתונים של משאבים מאוחסנים מאותו API לאחר 30 יום.

22 במאי 2018

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

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

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

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

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

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

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

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

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

26 באפריל 2018

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

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

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

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

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

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

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

21 בפברואר 2018

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

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

18 בינואר 2018

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

  • YouTube Reporting API (דוחות מרוכזים)

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

  • YouTube Analytics API (שאילתות מטורגטות)

20 בדצמבר 2017

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

  • שרת ה-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 של ממשק ה-API של YouTube Analytics. (יחד עם זאת, ממשק ה-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

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

  • ממשק ה-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 (דוחות מרוכזים)

    • ההגדרה של המאפיין 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

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

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

    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

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

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

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

    • ה-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

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

    • התנאים וההגבלות החדשים של שירותי YouTube API ("התנאים המעודכנים"), המפורטים בבלוג ההנדסה והמפתחים של 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

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

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

    12 באפריל 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      • הפרמטר החדש includeSystemManaged של השיטה 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

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

    15 בדצמבר 2015

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

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

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

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

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

      תוכן עניינים
      מאפיינים:
      חובה deviceType
      יש להשתמש ב-0 או יותר day, liveOrOnDemand, subscribedStatus, youtubeProduct
      מדדים:
      יש להשתמש באחד או יותר צפיות, estimatedMinutesWatched
      מסננים:
      צריך להשתמש ב-0 או ב-1 country, מחוז, יבשת, subContinent
      צריך להשתמש ב-0 או ב-1 video, group
      יש להשתמש ב-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 בממשק ה-API של YouTube Analytics מחזירה עכשיו שגיאה לא מורשית (403 קוד תגובת HTTP) אם אתם מנסים להוסיף ישות לקבוצה אבל אין לכם גישה לישות הזו. בעבר, ה-API היה אפשר להוסיף את הישות לקבוצה, אבל מאוחר יותר החזיר שגיאה לא מורשית כשניסית לאחזר נתוני דוחות של הקבוצה הזו.

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

    10 בנובמבר 2015

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

    29 באוקטובר 2015

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

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

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

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

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

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

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

    8 באוקטובר 2015

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

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

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

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

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

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

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

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

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

    30 בספטמבר 2013

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

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

    • ה-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

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

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

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

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

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

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

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

    2 באוקטובר, 2012

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

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

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

    12 בספטמבר 2012

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

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

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

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

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

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

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

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