Dimensions

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

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

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

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

מאפיינים עיקריים

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

ברשימה הבאה מפורטים מאפייני הליבה של ה-API.

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

מסננים

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

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

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

מאפיינים

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

מקורות מידע

המאפיינים האלה תואמים למשאבים שערוצים ובעלי תוכן מנהלים ב-YouTube:

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

סרטון (מאפיין ליבה)
המזהה של סרטון YouTube. ב-YouTube Data API, זהו הערך של מאפיין id של משאב video. This is a core dimension and is subject to the Deprecation Policy.
פלייליסט
המזהה של פלייליסט ב-YouTube. ב-YouTube Data API, זהו הערך של מאפיין id של משאב playlist.
ערוץ (מאפיין ליבה) (משמש רק בדוחות של בעלי התוכן)
המזהה של ערוץ YouTube. ב-YouTube Data API, זהו הערך של מאפיין id של משאב channel. This is a core dimension and is subject to the Deprecation Policy.

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

דוגמאות

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

  • דוגמאות לערוצים

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

  • דוגמאות לבעלי תוכן

    • נתונים סטטיסטיים בסיסיים
      • עשרת הסרטונים המובילים – הסרטונים הנצפים ביותר של בעלי תוכן
      • עשרת המובילים – הסרטונים הנצפים ביותר של בעלי תוכן
      • 10 הסרטונים המובילים – הסרטונים הנצפים ביותר בערוץ של בעלי התוכן
      • עשרת המובילים – שיעורי קליקים על הערות עבור הסרטונים הנצפים ביותר בערוץ
      • עשרת המובילים – הפלייליסטים הנצפים ביותר של בעלי התוכן
    • גיאוגרפי
      • 10 הסרטונים המובילים – הסרטונים הנצפים ביותר באירופה של בעלי תוכן
      • 10 הפלייליסטים המובילים – הפלייליסטים המושמעים ביותר בארצות הברית

אזורים גיאוגרפיים

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

country (מאפיין ליבה)
המדינה המשויכת למדדים בשורת הדוח. ערך המאפיין הוא קוד מדינה בן שתי אותיות לפי תקן ISO-3166-1, למשל US, CN (סין) או FR (צרפת). קוד המדינה ZZ משמש לדיווח על מדדים שהמערכות של YouTube לא הצליחו לזהות את המדינה המשויכת אליהם. This is a core dimension and is subject to the Deprecation Policy.
province
המדינה או האזור בארה"ב המשויכים למדדים בשורת הדוח. ערך המאפיין הוא קוד לפי תקן ISO 3166-2 שמזהה מדינה בארה"ב או את מחוז קולומביה, כמו US-MI (מישיגן) או US-TX (טקסס). קוד המחוז US-ZZ משמש לדיווח על מדדים שהמערכות של YouTube לא הצליחו לזהות את המדינה המשויכת אליהם בארה"ב. כשבקשת API כוללת את province בערך הפרמטר dimensions, הבקשה חייבת גם להגביל את הנתונים לארצות הברית. לשם כך, היא צריכה לכלול את country==US בערך הפרמטר filters.

הערה:המאפיין הזה לא תומך בערכי ISO 3166-2 שמזהים את האזורים המרוחקים של ארה"ב, כי לטריטוריות האלה יש גם קודי מדינות לפי תקן ISO 3166-1. היא גם לא תומכת בחלוקות משנה של מדינות מחוץ לארה"ב.

city
העיר המשוערת המשויכת למדדים בשורת הדוח. הנתונים של המאפיין הזה זמינים החל מ-1 בינואר 2022.
יבשת (מסנן בלבד)
קוד אזור סטטיסטי של האו"ם (UN). ה-API תומך בערכים הבאים:
ערכים
002 אפריקה
019 יבשת אמריקה (צפון אמריקה, אמריקה הלטינית, דרום אמריקה והקריביים)
142 אסיה
150 אירופה
009 אוקיאניה
ניתן להשתמש במאפיין הזה רק לצורך סינון נתונים. כדי להשתמש במאפיין הזה, צריך להגדיר את הערך של הפרמטר filters ל-continent==REGION_CODE ולציין ערך REGION_CODE מהרשימה שלמעלה.
subContinent (מסנן בלבד)
קוד אזור סטטיסטי של האו"ם שמזהה תת-אזור גיאוגרפי. המחלקה לסטטיסטיקה של האו"ם מפרטת את אזורי המשנה ואת המדינות שהיא משייכת לכל אזור.

ניתן להשתמש במאפיין הזה רק לצורך סינון נתונים. כדי להשתמש במאפיין הזה, צריך להגדיר את הערך של הפרמטר filters ל-subContinent==REGION_CODE ולציין ערך REGION_CODE מרשימת רשימות UN.

דוגמאות

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

  • דוגמאות לערוצים

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

  • דוגמאות לבעלי תוכן

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

תקופות זמן

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

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

המאפיין חודש מתייחס לתקופת הזמן שמתחילה בשעה 00:00 לפי שעון החוף המערבי של ארה"ב (UTC-7 או UTC-8) ביום הראשון של החודש והשנה שצוינו.

יום (מאפיין ליבה)
כשמשתמשים במאפיין הזה, הנתונים בדוח נצברים על בסיס יומי וכל שורה מכילה נתונים של יום אחד. תוכלו להשתמש במאפיינים אחרים כדי להציג פירוט נוסף של הנתונים. לדוגמה, דוח 'מקור תנועה' יכול לצבור נתונים סטטיסטיים יומיים על צפיות על סמך האופן שבו משתמשים מגיעים לסרטונים שלכם. This is a core dimension and is subject to the Deprecation Policy.
חודש (מאפיין ליבה)
הנתונים בדוח נצברים לפי חודש קלנדרי. כמו בדוחות יומיים, אפשר להשתמש במסננים אחרים כדי לפלח את הנתונים עוד יותר. התאריכים בדוח מוצגים בפורמט YYYY-MM.

הערה:אם שאילתת ה-API שלך כוללת את המאפיין month, עליך להגדיר את שניהם של הפרמטרים start-date ו-end-date ליום הראשון בחודש. This is a core dimension and is subject to the Deprecation Policy.

דוגמאות

הבקשות לדוגמה הבאות משתמשות במאפיינים או במסננים לפי זמן:

  • דוגמאות לערוצים

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

  • דוגמאות לבעלי תוכן

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

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

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

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

  • BROWSE – הנתונים מתארים צפיות בדף הבית או במסך הבית של YouTube, בפיד המינויים של המשתמש או בתכונת גלישה אחרת של YouTube.

  • CHANNEL – הנתונים מתארים צפיות שהתרחשו בדף ערוץ.

  • EMBEDDED – הנתונים מתארים צפיות שהתרחשו באפליקציה או באתר אחרים שבהם הסרטון הוטמע באמצעות הטמעה של <iframe> או <object>.

  • EXTERNAL_APP – הנתונים מתארים צפיות שהתרחשו באפליקציה של צד שלישי שבה הסרטון הופעל בשיטה שאינה הטמעה של <iframe> או <object>. לדוגמה, הפעלות באפליקציות שמשתמשות ב-YouTube Android Player API יסווגו לפי הערך הזה.

  • MOBILE – הנתונים מתארים צפיות באתר לנייד של YouTube או בלקוחות YouTube API שאושרו, כולל מכשירים ניידים.

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

  • SEARCH – הנתונים מתארים צפיות שהתרחשו ישירות בדף תוצאות החיפוש ב-YouTube.

  • WATCH – הנתונים מתארים צפיות בדף הצפייה של הסרטון ב-YouTube או באפליקציה רשמית של YouTube, כמו אפליקציית YouTube ל-Android.

  • YT_OTHER – הנתונים מתארים תצוגות שלא סווגו בדרך אחרת.

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

דוגמאות

הבקשות לדוגמה הבאות משתמשות במידות של מיקום ההפעלה:

  • דוגמאות לערוצים

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

  • דוגמאות לבעלי תוכן

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

פרטי הפעלה

creatorContentType
המאפיין הזה מזהה את סוג התוכן שמשויך למדדים של פעילות המשתמשים בשורת הנתונים. הנתונים למאפיין הזה זמינים החל מ-1 בינואר 2019.

בטבלה הבאה מפורטים ערכי המאפיינים:
ערכים
LIVE_STREAM התוכן שנצפה היה שידור חי ב-YouTube.
SHORTS התוכן שנצפה היה סרטון YouTube Shorts.
STORY התוכן שנצפה היה סטורי ב-YouTube.
VIDEO_ON_DEMAND התוכן שנצפה היה סרטון YouTube שלא תואם לאחד מערכי המאפיינים האחרים.
UNSPECIFIED סוג התוכן של התוכן שנצפה אינו ידוע.
liveOrOnDemand
המאפיין הזה מציין אם מדדי פעילות המשתמשים בשורת הנתונים משויכים לצפיות בשידור חי. נתונים למאפיין הזה זמינים החל מ-1 באפריל 2014.

בטבלה הבאה מפורטים ערכי המאפיינים:
ערכים
LIVE נתוני השורה מתארת פעילות משתמש שהתרחשה במהלך שידור חי.
ON_DEMAND נתוני השורה מתארת פעילות משתמש שלא התרחשה במהלך שידור חי.
subscribedStatus
המאפיין הזה מציין אם מדדי פעילות המשתמשים בשורת הנתונים משויכים לצופים שנרשמו לערוץ של הסרטון או הפלייליסט. הערכים האפשריים הם SUBSCRIBED ו-UNSUBSCRIBED.

חשוב לזכור שערך המאפיין מדויק נכון למועד שבו מתבצעת פעילות המשתמש. לדוגמה, נניח שמשתמש לא נרשם לערוץ מסוים וצופה באחד מהסרטונים של הערוץ, ואז נרשם לערוץ וצופה בסרטון אחר – כל זה באותו יום. הדוח של הערוץ מציין שלצפייה אחת יש את הערך subscribedStatus של SUBSCRIBED, ולצפייה אחת יש את הערך subscribedStatus של UNSUBSCRIBED.
youtubeProduct
המאפיין הזה מזהה את השירות של YouTube שבו התרחשה פעילות המשתמש. הנתונים למאפיין הזה זמינים החל מ-18 ביולי 2015.

בטבלה הבאה מפורטים ערכי המאפיינים:
ערכים
CORE פעילות של משתמשים שלא התרחשה באחת מהאפליקציות המיוחדות של YouTube (YouTube Gaming, YouTube Kids או YouTube Music). יוצא מן הכלל: פעילות משתמשים שהתרחשה ב-YouTube Music לפני 1 במרץ 2021 כלולה ב-CORE.
GAMING פעילות המשתמש התרחשה ב-YouTube Gaming.
KIDS פעילות המשתמש התרחשה ב-YouTube Kids.
MUSIC פעילות המשתמשים התרחשה ב-YouTube Music ב-1 במרץ 2021 או לאחר מכן. נתונים מלפני 1 במרץ 2021 כלולים ב-CORE. הנתונים בזמן אמת לא מתועדים.
UNKNOWN פעילות המשתמשים התרחשה לפני 18 ביולי 2015.

מקורות תנועה.

insightTrafficSourceType
הנתונים בדוח נצברים בהתבסס על סוג הגורם המפנה, שמתאר את האופן שבו המשתמשים הגיעו לסרטון. ערכים אפשריים למאפיין הזה הם:
  • ADVERTISING – הצופה הופנה לסרטון על ידי פרסומת. אם תסננו על סמך מקור התנועה הזה, סוג הפרסומת יצוין בשדה insightTrafficSourceDetail.
  • ANNOTATION – צופים הגיעו לסרטון על ידי לחיצה על הערה בסרטון אחר.
  • CAMPAIGN_CARD – הצפיות הגיעו מסרטונים שהועלו על ידי משתמשים ושהבעלים של התוכן השתמשו בהם כדי לקדם את התוכן שנצפה. מקור התנועה הזה נתמך רק עבור דוחות של בעלי התוכן.
  • END_SCREEN – הצפיות הופנו ממסך הסיום של סרטון אחר.
  • EXT_URL – הצפיות בסרטונים הופנו מקישור באתר אחר. אם מסננים על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail יזהה את דף האינטרנט. מקור התנועה הזה כולל הפניות מתוצאות חיפוש ב-Google.
  • HASHTAGS – הצפיות הגיעו מדפי hashtag ב-VOD או מדפי צירים של hashtag ב-Shorts.
  • LIVE_REDIRECT – הצפיות בסרטון הופנו מהפניות אוטומטיות בזמן אמת.
  • NO_LINK_EMBEDDED – הסרטון הוטמע באתר אחר בעת הצפייה.
  • NO_LINK_OTHER – המערכת של YouTube לא זיהתה את הגורם המפנה של התנועה. הקטגוריה הזו כוללת תנועה ישירה לסרטון ותנועה מאפליקציות לנייד.
  • NOTIFICATION – הצפיות בסרטון הופנו מאימייל או מהתראה מ-YouTube.
  • PLAYLIST – הצפיות בסרטון התרחשו בזמן שהסרטון הופעל כחלק מפלייליסט. הנתון כולל תנועה שמגיעה מדף הפלייליסט.
  • PRODUCT_PAGE – הצפיות בסרטון הופנו מדף מוצר.
  • PROMOTED – הצפיות בסרטון הופנו מקידום מכירות ב-YouTube ללא תשלום, כגון הדף 'סרטונים מומלצים' ב-YouTube.
  • RELATED_VIDEO – הצפיות בסרטונים הופנו מדף צפייה של סרטון קשור בדף צפייה אחר. אם מבצעים סינון על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מציין את מזהה הווידאו של הסרטון.
  • SHORTS – ההפניה של הצופה בוצעה על ידי החלקה אנכית מהסרטון הקודם בממשק הצפייה ב-Shorts.
  • SOUND_PAGE – הצפיות הגיעו מדפי עיצוב של סרטוני Shorts.
  • SUBSCRIBER – הצפיות בסרטונים הופנו מפידים בדף הבית של YouTube או מתכונות המינויים של YouTube. אם מבצעים סינון על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מציין את הפריטים בפיד של דף הבית או דף אחר שממנו הופנו הצפיות.
  • YT_CHANNEL – הצפיות בסרטון התרחשו בדף ערוץ. אם מבצעים סינון על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מציין את מזהה הערוץ של הערוץ.
  • YT_OTHER_PAGE – הצפיות בסרטון הופנו מקישור שאינו תוצאת חיפוש או קישור לסרטון קשור שהופיע בדף YouTube. אם מסננים על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מזהה את הדף.
  • YT_SEARCH – הצפיות בסרטונים הופנו מתוצאות החיפוש ב-YouTube. אם מסננים על סמך מקור התנועה הזה, מונח החיפוש יצוין בשדה insightTrafficSourceDetail.
  • VIDEO_REMIXES – הצפיות בסרטון הופנו מהקישור לסרטון שעבר רמיקס בנגן Shorts. אם מבצעים סינון על סמך מקור התנועה הזה, השדה insightTrafficSourceDetail מציין את הסרטון שממנו הופנה הצופה.
insightTrafficSourceDetail
הנתונים בדוח נצברים לפי הגורמים המפנים שהניבו הכי הרבה צפיות לסרטון מסוים ולסוג מקור תנועה שצוין. ברשימה הבאה מפורטים מקורות התנועה שהדוח זמין לגביהם. עבור כל מקור תנועה, הרשימה מזהה את המידע שמספק המאפיין insightTrafficSourceDetail.
  • ADVERTISING – סוג הפרסומת שהובילה לצפיות. הערכים האפשריים הם:
    • מודעה שיוצרת מעורבות מסוג 'לחץ להפעלה'
    • מודעה שיוצרת מעורבות
    • מודעות לרשת החיפוש של Google
    • מודעת וידאו בדף הבית
    • מודעות וידאו In-stream שמורות שניתן לדלג עליהן
    • TrueView בחיפוש ובתצוגה
    • מודעת וידאו TrueView In-stream
    • פרסום ב-YouTube ללא שיוך לקטגוריה
    • קיר סרטונים
  • CAMPAIGN_CARD – הסרטון שהוגשה לגביו תלונה על הפרת זכויות יוצרים שהוביל צופים לסרטון שזוהה בדוח.
  • END_SCREEN – הסרטון שהוביל את הצופים לסרטון שזוהה בדוח.
  • EXT_URL – האתר שהפנה את הצופים לסרטון.
  • HASHTAGS – ה-hashtag שהוביל לצפיות.
  • NOTIFICATION – האימייל או ההתראה שהפנו את התנועה.
  • RELATED_VIDEO – הסרטון הקשור שהוביל את הצופים לסרטון שנכלל בדוח.
  • SOUND_PAGE – הסרטון שהוביל לצפיות.
  • SUBSCRIBER – הפריט בפיד דף הבית או התכונה 'מינוי ל-YouTube' שהובילה את הצופים לסרטון המכוסה בדוח. הערכים התקינים הם:
    • activity – צפיות מפריטים בפידים של המינויים בדף הבית שנבעו מפעילות ערוץ ללא העלאות ושאינו חברתי, כולל לייקים, מועדפים, פוסטים עם מבזקים ותוספות לפלייליסטים.
    • blogged – צפיות מפריטים בפיד המינויים של דף הבית שנבעו מקישורים מבלוגים מובילים.
    • mychannel – צפיות מפריטים בפידים אחרים שרשומים בדף הבית, למשל 'לייקים', 'היסטוריית צפייה' ו'לצפייה בהמשך'.
    • podcasts – צפיות שמקורן בפריטים בדף היעד פודקאסטים.
    • sdig – צפיות שמגיעות מהודעות אימייל עם עדכוני מינויים.
    • uploaded – צפיות מ-uploaded הפריטים בפידים של המינויים בדף הבית.
    • / – צפיות אחרות שמגיעות מדף הבית של YouTube.
    • /my_subscriptions – צפיות שמגיעות מדפי המינויים שלי של משתמשים ב-YouTube.
  • YT_CHANNEL – דף הערוץ שבו אנשים צפו בסרטון.
  • YT_OTHER_PAGE – הדף ב-YouTube שממנו הצופים הופנו לסרטון.
  • YT_SEARCH – מונח החיפוש שהוביל את הצופים לסרטון.
  • VIDEO_REMIXES – הסרטון שהוביל לצפיות.

דוגמאות

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

  • דוגמאות לערוצים

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

  • דוגמאות לבעלי תוכן

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

מכשירים

deviceType
המאפיין הזה מזהה את גורם הצורה הפיזי של המכשיר שבו התרחשה הצפייה. ברשימה הבאה מפורטים סוגי המכשירים שעבורם ה-API מחזיר נתונים. ניתן גם להשתמש במאפיין deviceType כמסנן כדי להגביל דוח של מערכת הפעלה כך שיכלול נתונים רק לגבי סוג מסוים של מכשיר.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
המאפיין הזה מזהה את מערכת התוכנה של המכשיר שבו התרחשה הצפייה. ברשימה הבאה מפורטות מערכות ההפעלה שעבורן ה-API מחזיר נתונים. אפשר גם להשתמש ב-operatingSystem כמסנן כדי להגביל דוח של סוגי מכשירים כך שיכלול נתונים רק לגבי מערכת הפעלה ספציפית.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

דוגמאות

הבקשות לדוגמה הבאות משתמשות במידות המכשיר:

  • דוגמאות לערוצים

    • מכשיר/מערכת הפעלה
      • מדדים יומיים לגבי סוג המכשיר במערכת ההפעלה Android
      • מדדים יומיים של מערכת ההפעלה במכשירים ניידים
      • מדדים יומיים של מערכת ההפעלה וסוגי המכשיר
      • מדדים יומיים של סוגי מכשיר לגבי צפיות בפלייליסט במערכת ההפעלה של Android
      • מדדים יומיים של מערכת ההפעלה לגבי צפיות בפלייליסט במכשירים ניידים

  • דוגמאות לבעלי תוכן

    • מכשיר/מערכת הפעלה
      • מדדים יומיים של סוגי מכשירים לגבי סרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים
      • מדדים יומיים של מערכת ההפעלה לגבי סרטונים שהוגשה לגביהם תלונה על הפרת זכויות יוצרים ונצפו במכשירים ניידים
      • מדדים יומיים של מערכת ההפעלה וסוגי המכשיר
      • מדדים יומיים של סוגי מכשיר לגבי צפיות בפלייליסט במערכת ההפעלה של Android
      • מדדים יומיים של מערכת ההפעלה לגבי צפיות בפלייליסט במכשירים ניידים

מידע דמוגרפי

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

ageGroup (מאפיין ליבה)
המאפיין הזה מזהה את קבוצת הגיל של המשתמשים המחוברים ומשויכים לנתוני הדוח. ה-API משתמש בקבוצות הגיל הבאות:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
gender (מאפיין ליבה)
המאפיין הזה מזהה את המגדר של המשתמשים המחוברים ומשויכים לנתוני הדוח. הערכים החוקיים הם female, male ו-user_specified. This is a core dimension and is subject to the Deprecation Policy.

דוגמאות

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

  • דוגמאות לערוצים

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

  • דוגמאות לבעלי תוכן

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

מעורבות ושיתוף תוכן

sharingService (מאפיין ליבה)
המאפיין הזה מזהה את השירות ששימש לשיתוף סרטונים. ניתן לשתף סרטונים ב-YouTube (או דרך נגן YouTube) באמצעות הלחצן 'שיתוף'. This is a core dimension and is subject to the Deprecation Policy.

בטבלה הבאה מפורטים ערכי מאפיינים חוקיים:
שירות שיתוף ערך API
Ameba AMEBA
אימייל ל-Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
העברת הודעות ב-Android ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
העתקה ללוח COPY_PASTE
עולם המים CYWORLD
דיג DIGG
Dropbox DROPBOX
הטמעה EMBED
אימייל MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
דפי Facebook FACEBOOK_PAGES
פוטקה FOTKA
Gmail GMAIL
goo GOO
Google+‎ GOOGLEPLUS
התחלת SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
הודעת טקסט דרך HTC HTC_MMS
תיבת הדואר הנכנס של Google INBOX
תיבת דו-שיח של פעילות המערכת ב-iOS IOS_SYSTEM_ACTIVITY_DIALOG
סיפור KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
קיק KIK
אימייל של LGE LGE_EMAIL
קו LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
העברת הודעות של Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
שיתוף בקרבת מקום NEARBY_SHARE
NUjij NUJIJ
Odnoklassnici (Одноклассники) ODNOKLASSNIKI
אחר OTHER
Pinterest PINTEREST
ראקוטן (楽天:#場) RAKUTEN
reddit, רדיט, ראדיט REDDIT
Skype SKYPE
סקיירוק SKYBLOG
Sony שיחות SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
הודעת טקסט TEXT_MESSAGE
טואנטי TUENTI
tumblr. TUMBLR
Twitter TWITTER
לא ידוע UNKNOWN
הודעות של Verizon VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
וויקופ WYKOP
מזהה העסק יפן YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

מידע נוסף זמין במסמכי העזרה.

דוגמאות

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

  • דוגמאות לערוצים

  • דוגמאות לבעלי תוכן

שימור קהל

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

ה-API מחזיר 100 נקודות נתונים לכל סרטון עם ערכי יחס שנעים בין 0.01 ל-1.0. הזמנים שבהם נמדדים הנתונים במהלך הפעלות של סרטון, מרווחים באופן שווה בין כל סרטון. כלומר, בסרטון באורך שתי דקות, המרווח בין נקודות נתונים הוא 1.2 שניות. עם זאת, לסרטון באורך שעתיים, המרווח בין נקודות נתונים הוא 72 שניות. ערך המאפיין מציין את הסיום הבלעדי של המרווח.
audienceType (מסנן בלבד)
ערך המאפיין מזהה את סוג התנועה המשויכת לנתוני הדוח. הערכים הנתמכים הם ORGANIC, AD_INSTREAM ו-AD_INDISPLAY. במרכז העזרה של YouTube תוכלו למצוא הסברים על הסוגים האלה של מקורות תנועה.

לתשומת ליבך: הנתונים של המסנן audienceType זמינים החל מ-25 בספטמבר 2013. ה-API לא מחזיר נתונים לשאילתות שבהן נעשה שימוש במסנן כדי לנסות לאחזר נתונים מתאריכים קודמים. שאילתות שלא נעשה בהן שימוש במסנן יפעלו בתאריך כלשהו שאחרי 1 ביולי 2008.

דוגמאות

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

  • דוגמאות לערוצים

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

  • דוגמאות לבעלי תוכן

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

ביצועי מודעות

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

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

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

  • auctionTrueviewInslate – הצופה בוחר מודעת וידאו אחת מתוך מגוון אפשרויות המוצגות לפני הסרטון. See the TrueView documentation for more information.

  • auctionTrueviewInstream – מודעות וידאו שניתן לדלג עליהן שמוצגות לפני או במהלך הסרטון הראשי. למידע נוסף, עיינו במסמכי התיעוד בנושא TrueView.

  • auctionUnknown – מודעה שנרכשה דרך מכירה פומבית של AdWords, אך לא סווגה לאחד מסוגי המודעות האחרים.

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

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

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

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

  • reservedInstreamSelect

  • reservedMasthead – מודעה גדולה, שיכולה לכלול וידאו ואלמנטים גרפיים, שמוצגת בדף הבית.

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

  • unknown – לא הצלחנו לסווג את סוג המודעה הזה.

דוגמאות

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

  • דוגמאות לערוצים

    • הכנסות/מודעות
      • מדדים של ביצועי מודעות והכנסות מהערוץ
      • הכנסה יומית ומדדי ביצועים של מודעות
      • ערכים של הכנסות וביצועי מודעות ספציפיות למדינה
      • 10 המובילים – הסרטונים עם ההכנסות הגבוהות ביותר
      • מדדי ביצועים של מודעות מסוגים שונים

  • דוגמאות לבעלי תוכן

    • הכנסות/מודעות
      • מדדי הכנסות וביצועי מודעות של תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים
      • הכנסה יומית ומדדי ביצועים של מודעות
      • ערכים של הכנסות וביצועי מודעות ספציפיות למדינה
      • 10 המובילים – הסרטונים עם ההכנסות הגבוהות ביותר
      • מדדי ביצועים של מודעות מסוגים שונים

פלייליסטים

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

דוגמאות

כל הבקשות לדוגמה שמאחזרות את דוחות הפלייליסט משתמשות במסנן isCurated.

מאפיינים של בעלי התוכן

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

חשוב: בקשות API לאחזור דוחות של בעלי התוכן חייבות לסנן נתונים לפי אחד מהמאפיינים הבאים:
  • video
  • channel
  • שילוב נתמך של המאפיינים claimedStatus ו-uploaderType כפי שמוגדר בהמשך.
בעלות סטטוס (משמש רק בדוחות של בעלי התוכן)
המאפיין הזה מאפשר לציין שתגובת API צריכה להכיל ערכים רק של תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים. הערך החוקי היחיד למאפיין זה הוא claimed. אם הפרמטר filters מגביל את השאילתה ל-claimedStatus==claimed, ה-API יאחזר נתונים רק עבור תוכן שהוגשה לגביו תלונה. הטבלה בהגדרה של המאפיין uploaderType מספקת פרטים נוספים על אופן השימוש במאפיין הזה.
UploadType (מאפיין ליבה) (משמש רק בדוחות של בעלי התוכן)
המאפיין הזה מאפשר לציין אם תגובת ה-API צריכה להכיל מדדים לתוכן שהועלה על ידי בעלי התוכן שצוינו ו/או לתוכן שהועלה על ידי צדדים שלישיים, כמו סרטונים שהועלו על ידי משתמשים. הערכים החוקיים הם self ו-thirdParty. זהו מאפיין ליבה והוא כפוף למדיניות ההוצאה משימוש.

בטבלה הבאה מוצגים השילובים הנתמכים של המאפיינים claimedStatus ו-uploaderType, ושניהם נמצאים בשימוש בפרמטר filters:

ערך של claimedStatus ערך של uploaderType התיאור
[לא מוגדר] עצמי אחזור נתונים של YouTube Analytics עבור תוכן שהועלתה על ידי בעלי התוכן ושאין תביעת בעלות עליו.
הוגשה דרישת בעלות [לא מוגדר] אחזור נתונים עבור תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהועלו על ידי בעלי התוכן או על ידי צד שלישי.
הוגשה דרישת בעלות עצמי אחזור נתונים עבור תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהועלה על ידי בעלי התוכן.
הוגשה דרישת בעלות thirdParty אחזור נתונים עבור תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים, שהועלה על ידי צד שלישי.

דוגמאות

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