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

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

15 בנובמבר 2024

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

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

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

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

6 במאי 2024

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

• הדוח פעילות משתמשים לפי אזור שוק ייעודי (DMA) הוא דוח גיאוגרפי שמספק נתונים סטטיסטיים על פעילות המשתמשים לפי אזור שוק ייעודי (DMA). בדוח הזה, צריך להגדיר את ערך הפרמטר filters לערך country==US.

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

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

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

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

• startedWatching
• stoppedWatching
• totalSegmentImpressions

7 באפריל 2024

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

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

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

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

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

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

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

  • playlistAverageViewDuration
  • playlistEstimatedMinutesWatched
  • playlistSaves
  • playlistViews

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

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

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

19 בינואר 2024

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

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

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

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

  עדכון (ב-2 באפריל 2024): המאפיין isCurated הוצא משימוש גם בדוחות של בעלי תוכן. בדוחות האלה, לא תהיה יותר תמיכה במאפיין החל מ-31 בדצמבר 2024 ואילך.
  חשוב: כשמסירים את המאפיין isCurated מבקשות ה-API, צריך לבצע שינויים נוספים באפליקציה.

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

  • playlistAverageViewDuration
  • playlistEstimatedMinutesWatched
  • playlistSaves
  • playlistViews

• ההתנהגות של המדד 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, שמציין שהתנועה הועברה מדף היעד של Podcasts.
• ב-YouTube Reporting API‏ (דוחות בכמות גדולה), אם הערך של המאפיין 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 API (דוחות בכמות גדולה), המאפיין gender תומך כרגע בשלושה ערכים: FEMALE,‏ MALE ו-GENDER_OTHER. החל מ-11 באוגוסט 2022, קבוצת הערכים הנתמכים תשתנה ל-FEMALE,‏ MALE ו-USER_SPECIFIED.

9 בפברואר 2022

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

• ב-API של YouTube Analytics (שאילתות ממוקדות), המדדים averageViewDuration ו-averageViewPercentage לא כוללים תנועה מקליפים שמופעלים בלופ החל מ-13 בדצמבר 2021.
• ב-Reporting API של YouTube (דוחות בכמות גדולה), המדדים average_view_duration_seconds ו-average_view_duration_percentage לא כוללים תנועה מקליפים שמופעלים בלופ החל מ-13 בדצמבר 2021.

2 בפברואר 2022

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

• ב-Reporting API של YouTube (דוחות בכמות גדולה), המאפיין traffic_source_type תומך בערך 28.

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

23 בספטמבר 2020

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

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

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

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

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

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

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

15 באוקטובר 2019

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

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

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

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

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

27 ביוני 2019

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

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

1 בנובמבר 2018

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

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

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

17 בספטמבר 2018

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

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

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

     או

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

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

• המסמכים של דוחות הערוץ ושל דוחות בעלי התוכן עודכנו כך שישקפו את העובדה שמדדי redViews ו-estimatedRedMinutesWatched כבר לא נתמכים בדוחות 'מיקום ההפעלה', 'מקור התנועה' ו'סוג המכשיר/מערכת ההפעלה'.

18 ביוני 2018

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

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

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

23 במאי 2018

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

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

22 במאי 2018

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

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

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

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

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

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

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

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

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

26 באפריל 2018

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

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

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

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

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

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

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

‫21 בפברואר 2018

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

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

18 בינואר 2018

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

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

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

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

  • המאפיין operatingSystem תומך בערך המאפיין KAIOS.

20 בדצמבר 2017

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

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

  כדי לקבל תשובה בקידוד gzip, מגדירים את כותרת הבקשה Accept-Encoding ל-HTTP כ-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 מחזירות עכשיו את קוד התגובה 400‏ HTTP. אם עדיין לא עדכנתם את האפליקציה כך שתשתמש במדד 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 ב-Creator Studio יכולים עכשיו לגשת לנתוני ההכנסות האלה גם דרך ממשק ה-API של YouTube Analytics:

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

  • adImpressions
  • cpm
  • estimatedAdRevenue
  • estimatedRedPartnerRevenue
  • estimatedRevenue
  • grossRevenue
  • monetizedPlaybacks
  • playbackBasedCpm

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

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

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

• המדריך בנושא בקשות לדוגמה של YouTube Analytics API כולל עכשיו קטע בנושא דוחות הכנסות בערוץ.

17 במרץ 2017

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

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

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

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

3 במרץ 2017

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

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

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

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

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

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

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

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

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

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

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

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

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

8 בפברואר 2017

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

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

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

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

15 בדצמבר 2016

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

• דוחות ערוץ

  • channel_basic_a1 – הוחלף בדוח channel_basic_a2.
  • channel_province_a1 – הוחלף בדוח channel_province_a2.
  • channel_playback_location_a1 – הוחלף בדוח channel_playback_location_a2.
  • channel_traffic_source_a1 – הוחלף בדוח channel_traffic_source_a2.
  • channel_device_os_a1 – הוחלף בדוח channel_device_os_a2.
  • channel_subtitles_a1 – הוחלף בדוח channel_subtitles_a2.
  • channel_combined_a1 – הוחלף בדוח channel_combined_a2.

• דוחות של בעלי תוכן

  • content_owner_basic_a2 – הוחלף בדוח content_owner_basic_a3.
  • content_owner_province_a1 – הוחלף בדוח content_owner_province_a2.
  • content_owner_playback_location_a1 – הוחלף בדוח content_owner_playback_location_a2.
  • content_owner_traffic_source_a1 – הוחלף בדוח content_owner_traffic_source_a2.
  • content_owner_device_os_a1 – הוחלף בדוח content_owner_device_os_a2.
  • content_owner_subtitles_a1 – הוחלף בדוח content_owner_subtitles_a2.
  • content_owner_combined_a1 – הוחלף בדוח content_owner_combined_a2.
  • content_owner_asset_basic_a1 – הוחלף בדוח content_owner_asset_basic_a2.
  • content_owner_asset_province_a1 – הוחלף בדוח content_owner_asset_province_a2.
  • content_owner_asset_playback_location_a1 – הוחלף בדוח content_owner_asset_playback_location_a2.
  • content_owner_asset_traffic_source_a1 – הוחלף בדוח content_owner_asset_traffic_source_a2.
  • content_owner_asset_device_os_a1 – הוחלף בדוח content_owner_asset_device_os_a2.
  • content_owner_asset_combined_a1 – הוחלף בדוח content_owner_asset_combined_a2.

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

11 בנובמבר 2016

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

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

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

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

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

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

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

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

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

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

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

  • content_owner_ad_performance_a1 – הוחלף בדוח content_owner_ad_rates_a1.
  • content_owner_estimated_earnings_a1 – הוחלף בדוח content_owner_estimated_revenue_a1.
  • content_owner_asset_estimated_earnings_a1 – הוחלף בדוח content_owner_asset_estimated_revenue_a1.

8 בנובמבר 2016

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

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

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

27 באוקטובר 2016

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

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

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

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

27 בספטמבר 2016

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

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

15 בספטמבר 2016

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

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

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

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

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

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

  • דוחות על סרטונים בערוץ

    • channel_basic_a2
    • channel_province_a2
    • channel_playback_location_a2
    • channel_traffic_source_a2
    • channel_device_os_a2
    • channel_subtitles_a2
    • channel_combined_a2

  • דוחות של בעלי תוכן לגבי סרטונים

    • content_owner_basic_a3
    • content_owner_province_a2
    • content_owner_playback_location_a2
    • content_owner_traffic_source_a2
    • content_owner_device_os_a2
    • content_owner_subtitles_a2
    • content_owner_combined_a2

  • דוחות נכסים של בעלי תוכן

    • content_owner_asset_basic_a2
    • content_owner_asset_province_a2
    • content_owner_asset_playback_location_a2
    • content_owner_asset_traffic_source_a2
    • content_owner_asset_device_os_a2
    • content_owner_asset_combined_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 עודכנו כך שישקפו תמיכה במדדי כרטיסים במספר רב של דוחות ערוצים ובעלי תוכן. המדדים החדשים שנתמכים הם:

• cardImpressions
• cardTeaserImpressions
• cardClicks
• cardTeaserClicks
• cardClickRate
• cardTeaserClickRate

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

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

‫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.

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

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

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

12 באפריל 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

28 במרץ 2016

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

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

16 במרץ 2016

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

YouTube Reporting API

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

YouTube Analytics API

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

8 בפברואר 2016

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

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

6 בינואר 2016

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

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

21 בדצמבר 2015

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

18 בדצמבר 2015

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

15 בדצמבר 2015

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

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

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

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

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

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

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

• מעכשיו, ממשק ה-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

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

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

  רשימת הדוחות לבעלי תוכן של YouTube Analytics API עודכנה כדי לזהות את דוחות הסרטונים שתומכים במדד redPartnerRevenue:

  • נתונים סטטיסטיים בסיסיים
  • מבוססת-זמן
  • מיקום גיאוגרפי של משתמשים
  • הסרטונים המובילים – בדוח הזה, אפשר להשתמש ב-redPartnerRevenue גם כמדד למיון. כלומר, אפשר לאחזר רשימה של סרטונים שממוינים לפי הרווחים שלהם מ-YouTube Red.

• הגדרת הדוח הסרטונים המובילים ב-YouTube Analytics API משקפת עכשיו שהדוח הזה תומך גם במדדי הרווחים הבאים: earnings,‏ adEarnings,‏ grossRevenue,‏ monetizedPlaybacks,‏ playbackBasedCpm,‏ impressions ו-impressionBasedCpm.

29 באוקטובר 2015

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

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

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

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

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

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

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

• המדדים favoritesAdded ו-favoritesRemoved הוצאו משימוש החל מההודעה הזו. מדדים אלה הם מדדי ליבה שחלים עליהם כללי המדיניות בנושא הוצאה משימוש שמפורטים בתנאים ובהגבלות.

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 תומך בשיטות list,‏ insert ו-delete למשאב הזה.

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

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

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

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

13 בפברואר 2015

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

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

28 באוגוסט 2014

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

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

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

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

16 ביולי 2014

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

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

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

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

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

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

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

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

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

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

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

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

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

  • annotationImpressions: המספר הכולל של חשיפות של ההערות.
  • annotationClickableImpressions: מספר ההערות שהופיעו ואפשר היה ללחוץ עליהן.
  • annotationClosableImpressions: מספר ההערות שהופיעו ואפשר היה לסגור.
  • annotationClicks: המספר הכולל של ההערות שנלחצו עליהן.
  • annotationCloses: המספר הכולל של ההערות הסגורות.

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

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

31 בינואר 2014

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

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

  השינוי גלוי בדוח נתונים סטטיסטיים בסיסיים הראשון לבעלי תוכן, שבו יש עכשיו תמיכה במסננים claimedStatus ו-uploaderType.

16 בינואר 2014

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

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

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

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

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

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

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

6 בינואר 2014

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

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

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

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

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

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

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

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

    • אתם יכולים להשתמש בפרמטר השאילתה 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

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

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

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

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

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