ממשק YouTube Content ID API – היסטוריית גרסאות

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

בדף הזה מפורטים שינויים בממשק ה-API של Content ID ב-YouTube ועדכונים במסמכי התיעוד.

26 במרץ 2025

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

עד 30 ביוני 2025, נעדכן את Content ID API בדרכים הבאות בהתאם לשינוי הזה:

  • סדרי המיון של claimSearch.list.sort יעודכנו:
    • DAILY_ENGAGED_VIEWS יתווסף למספרי הצפיות היומיים על סמך השיטה הקודמת לספירת צפיות.
    • LIFETIME_ENGAGED_VIEWS יתווסף למספר הצפיות הכולל על סמך השיטה הקודמת לספירת צפיות.
  • סדרי המיון של assetSearch.list.sort יעודכנו:
    • DAILY_ENGAGED_VIEWS יתווסף למספרי הצפיות היומיים על סמך השיטה הקודמת לספירת צפיות.

עד 30 בספטמבר 2025, Content ID API יתעדכן בדרכים הבאות בהתאם לשינוי הזה:

  • סדר המיון assetSearch.list.sort VIEWS יוצא משימוש.
  • סדר המיון claimSearch.list.sort VIEW_COUNT יוצא משימוש.
  • המדד claimSearch.claimSnippet.videoViews יתעדכן כך שישקף את המתודולוגיה המעודכנת לספירת צפיות בסרטוני Shorts.
  • claimSearch.claimSnippet.engagedViews יתווסף למספרי הצפיות על סמך שיטת הספירה הקודמת של הצפיות

14 בינואר 2025

השדה autoGeneratedBreaks[] של המשאב videoAdvertisingOption עודכן, כי עכשיו אנחנו מאפשרים לספק את הערכים ad_breaks ו-autoGeneratedBreaks בו-זמנית. אם הערך של autoGeneratedBreaks מוגדר כ-true בסרטון שבו מוגדר adBreaks, המערכות שלנו יזהו מיקומים להצגת מודעות בנוסף למיקומי המודעות שהוגדרו ידנית. פרטים נוספים זמינים במאמר התמיכה.

‫10 בנובמבר 2023

השדה adFormats[] של המשאב videoAdvertisingOption עודכן כך ש-third_party הוא הערך החוקי היחיד בשדה הזה. פורמטים של מודעות הבאים כבר לא נתמכים: instream_trueview, instream_standard, display, preroll, postroll. פרטים נוספים זמינים במאמר התמיכה.

1 ביוני 2023

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

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

20 בדצמבר 2022

ההגדרה של פרמטר השאילתה ownershipRestriction של השיטה assetSearch.list עודכנה כדי להבהיר שאם הערך של הפרמטר הזה הוא none, גם ערך הפרמטר metadataSearchFields חייב לכלול מסנן מזהה אחד לפחות. השינוי במסמכי העזרה לא משקף שינוי בהתנהגות ה-API.

9 בנובמבר 2022

המסמכים של השיטות asset.get ו-asset.list עודכנו כדי להבהיר איך יש תמיכה במספר ערכים עבור:

28 בספטמבר 2022

פרטי האפשרות לרישוי נוספו ל-asset resource.

18 ביולי 2022

המסמך של הפרמטר inactiveReasons של השיטה claimSearch.list עודכן כדי לשקף שיפורים לשמירה על עקביות עם YouTube Studio:

  • בעבר הוסרה מ-Studio התמיכה ב-Audio Swap וב-Song Erase. ערכי ה-API התואמים, audio_removed ו-song_erased, התעלמו בשקט ועכשיו הם לא מתועדים.
  • channel_whitelisted הוחלף ב-channel_allowlisted. הערך הקודם כבר לא מתועד, אבל עדיין נתמך.
  • עכשיו יש תמיכה בערכים closed_disabled_monetization,‏ closed_manually,‏ closed_no_adsense,‏ closed_own_video_match,‏ reference_removed,‏ replaced ו-video_modified.

14 ביוני 2022

המסמכים של המשאב assetSearch עודכנו כך שישקפו את שני המאפיינים החדשים: isrcs[] ו-iswcs[]. ערכי המאפיינים החדשים isrcs[] ו-iswcs[] מכילים מערך של ערכים של מחרוזות, כאשר כל ערך מציין מזהה ISRC או ISWC, לפי הצורך, שממופה לנכס שזוהה בתוצאת החיפוש.

מומלץ להשתמש בנכסים החדשים במקום בנכסים isrc ו-iswc שכבר כלולים במשאבים של assetSearch, כי הנתונים בנכסים החדשים מדויקים יותר. בעוד שבנכסים החדשים יכולה להופיע רשימה של מערך ערכים של מחרוזות, כל אחד מהנכסים isrc ו-iswc מזהה רק קוד ISRC או קוד ISWC אחד שמשויך לתוצאת החיפוש.

12 במאי 2022

הקישורים לספריות הלקוח עודכנו כך שיצביעו על ספריות הלקוח הרגילות של Google APIs. קישורים שנוצרו מראש ל-PHP עודכנו.

3 במאי 2022

הפרמטר status של השיטה claimSearch.list תומך עכשיו במסננים נוספים שמבוססים על פרטי תלונה פוטנציאליים.

2 במאי 2022

התיעוד של התגובה של השיטה assetSearch.list עודכן כדי לשקף שיפורים לשמירה על עקביות בהתאם ל-AIP-158:

  • בתיאור של pageInfo.totalResults מצוין במפורש שהערך הוא אומדן ולא הערך בפועל
  • השדות pageInfo.resultsPerPage ו-pageInfo.startIndex הוסרו

25 באפריל 2022

מסמכי התיעוד של המשאב assetLabels.list עודכנו כדי להבהיר את המשמעות של פרמטרים של בקשות labelPrefix ו-q, וכדי לתעד שהבקשה או התגובה תומכות בחלוקה לדפים.

8 בדצמבר 2021

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

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

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

17 בנובמבר 2021

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

  • השיטה claims.update תומכת עכשיו באפשרות לעדכן את הסטטוס של תלונה לא פעילה או של תלונה פוטנציאלית ל-active. פרטים נוספים זמינים בהגדרה של המאפיין status של המשאב claim.
  • המסמכים של המשאבים claim ו-claimSearch עודכנו כך שישקפו את ההוספה של האובייקט החדש studioInfo, שמכיל קישורים לדפים ב-YouTube Studio שקשורים לתלונה.
  • רשימת הערכים הנתמכים לפרמטר origin של השיטה claimSearch.list השתנתה. הפרמטר תומך עכשיו בארבעה ערכים נוספים: batchTool,‏ inProductShorts,‏ melodyMatch ו-youTubeAdmin. בנוסף, הערכים dropboxUpload ו-webUpload כבר לא נתמכים.

26 בפברואר 2021

המסמך של הפרמטר videoId של השיטה claimSearch.list עודכן כדי לציין שערך הפרמטר מקבל עכשיו עד 10 מזהי וידאו מופרדים בפסיקים. ה-API יחזיר שגיאה מסוג badRequest – קוד תגובה מסוג HTTP‏ 400 – אם הערך מכיל יותר מ-10 מזהי סרטונים.

6 בדצמבר 2018

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

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

21 במרץ 2018

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

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

24 ביולי 2017

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

  • המשאב החדש package מייצג קבוצה של קבצים שנשלחים דרך האינטרנט, SFTP או מנגנון העברה אחר. ה-API תומך בשתי שיטות למשאב הזה:

    • השיטה package.insert מאמתת ומעלה חבילה של מטא-נתונים בלבד שמכילה קובץ מטא-נתונים אחד בלבד.
    • השיטה package.get מאחזרת מידע על חבילה שהועלו בעבר.

  • בשיטה validator.validate, ההגדרה של המאפיין uploaderName עודכנה כדי לציין שהערך לא מזהה את שותף התוכן שמעלה את הנתונים, אלא ערך כמו web-google או yt-google שמזהה את חשבון מעלה התוכן הספציפי שבו הבעלים של התוכן משתמש.

  • המאפיין status של המשאב reference כבר לא משתמש בערך duplicate_on_hold כדי לציין שהפניה היא כפולה של הפניה אחרת. במקום זאת, אם הפניה היא כפולה, הערך של המאפיין status מוגדר עכשיו ל-inactive והערך של המאפיין statusReason הוא REASON_DUPLICATE_FOR_OWNERS.

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

17 באפריל 2017

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

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

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

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

    המשאב assetShare מזהה קשר בין תצוגה של יצירה לבין שיתוף של יצירה. בעזרת השיטה החדשה assetShares.list תוכלו לבצע את אחת מהפעולות הבאות:

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

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

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

11 באוגוסט 2016

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

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

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

31 במאי 2016

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

  • משאבים ושיטות חדשים

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

  • שגיאות חדשות ומעודכנות

    • השגיאה הבאה נתמכת עכשיו בשיטות assets.patch ו-assets.update. כתזכורת, שיטה יכולה לתמוך בכמה שגיאות עם אותו סוג שגיאה. רשימה מלאה של השגיאות האפשריות מופיעה במסמכי העזרה של השגיאות של כל שיטה או בדף שגיאות.

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

28 במרץ 2016

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

  • עדכונים למשאבים ולשיטות קיימים

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

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

    • עכשיו אפשר לעדכן את ערך המאפיין claimedVideoOptions.newVideoDefaults[] של המשאב contentOwnerAdvertisingOptions כשקוראים לשיטות contentOwnerAdvertisingOptions.patch או contentOwnerAdvertisingOptions.update.

    • המאפיין allowedOptions.autoGeneratedBreaks של המשאב contentOwnerAdvertisingOptions, שמיועד לקריאה בלבד, יצא משימוש.

  • שגיאות חדשות ומעודכנות

    • השיטה claims.update של ה-API תומכת עכשיו בשגיאה הבאה. כתזכורת, שיטה יכולה לתמוך בכמה שגיאות עם אותו סוג שגיאה. רשימה מלאה של השגיאות האפשריות מופיעה במסמכי העזרה של השגיאות של כל שיטה או בדף שגיאות.

      שגיאות
      badRequest (400) alreadyClaimed
      התלונה היא עותק כפול של תלונה קיימת אחרת, ולא ניתן לעדכן אותה.

    • לפעמים, הזמן לטעינת השיטה assets.list פג והיא מחזירה קוד תגובה 500 של HTTP‏ (Internal Server Error). זה קורה במיוחד כשהבקשה מאחזרת נתונים לגבי הרבה נכסים והערך של הפרמטר fetchMatchPolicy הוא effective. אם בבקשה assets.list מצוינים מספר מזהי נכסים והיא מחזירה את השגיאה 500, נסו לשלוח מחדש את הבקשה לגבי נכס יחיד או מספר קטן יותר של נכסים.

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

3 בפברואר 2016

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

  • עדכונים למשאבים ולשיטות קיימים

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

      כתוצאה מהשינוי הזה, עכשיו אפשר לכלול את product_listing בערכים של המאפיינים הבאים:

      שיטת משאב/API נכס
      contentOwnerAdvertisingOptions allowedOptions.licAdFormats[]
      contentOwnerAdvertisingOptions allowedOptions.ugcAdFormats[]
      contentOwnerAdvertisingOptions claimedVideoOptions.newVideoDefaults[]
      videoAdvertisingOptions adFormats[]
      videoAdvertisingOptions.getEnabledAds countriesRestriction[].adFormats[]

    • הפרמטרים החדשים createdBefore ו-createdAfter של השיטה assetSearch.list מורים ל-API להחזיר רק נכסים שנוצרו לפני או אחרי תאריך מסוים.

    • בתגובה של ה-API לבקשה מסוג assetSearch.list, המאפיין type תומך עכשיו בערך art_track_video. במרכז העזרה של YouTube יש מידע נוסף על סרטונים עם תמונות רקע.

    • השיטה claimSearch.list תומכת בפרמטרים החדשים הבאים:

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

    • האובייקט references#origination החדש של המשאב reference מכיל מידע שמתאר את המקור של ההפניה.

    • השיטה references.insert תומכת עכשיו באפשרות להעלות קובצי עזר שנוצרו באמצעות תוכנת gfp_gen של YouTube. אם אתם מספקים טביעת אצבע שנוצרה מראש, צריך להגדיר את ערך המאפיין fpDirect כ-true במשאב reference שהועלו.

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

  • שגיאות חדשות ומעודכנות

    במסמכי העזרה מפורטות עכשיו השגיאות שמוחזרות על ידי השיטות של המשאב whitelist.

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

    שגיאות
    badRequest (400) inappropriateCampaignTarget
    השגיאה הזו מופיעה בשיטות campaigns.insert ו-campaigns.update אם בקמפיין מנסים להציג סרטון שעלול להיות לא הולם לחלק מהמשתמשים. כדי לפתור את השגיאה, עליך לבחור תוכן אחר להצגה.
    badRequest (400) canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets
    שגיאה זו מופיעה בחזרה מהשיטה claims.insert אם מנסים ליצור תלונה שהועלתה על ידי שותף עם נכס של יצירה מוזיקלית או הקלטת אודיו.
    badRequest (400) existingSoundRecordingOrMusicVideoClaim
    השיטה claims.insert מחזירה את השגיאה הזו אם כבר יש תלונה על מוזיקה שהוקלטה בסרטון שצוין. לא ניתן להוסיף הצהרות על זכויות יוצרים מסוג 'שימוש בתוכן שנוצר ישירות' דרך ה-API.
    badRequest (400) asset_id
    שגיאה זו מוחזרת על ידי השיטה references.insert אם הבקשה ניסתה ליצור הפניה דרך קובץ, אבל לא צוין בה assetId.
    badRequest (400) canNotBeActivated
    שגיאה זו תוחזר על ידי השיטה references.update אם לא ניתן להפעיל את ההפניה, אולי בגלל הסטטוס שלה או התנאים של הבעלות.
    badRequest (400) videoNotClaimed
    שיטת videoAdvertisingOptions.get מחזירה את השגיאה הזו אם לא הגשתם תלונה על הפרת זכויות יוצרים לגבי הסרטון שבו אתם מנסים לאחזר את אפשרויות הפרסום, ולכן המידע המבוקש לא זמין לכם.

18 בדצמבר 2015

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

21 באפריל 2015

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

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

    ה-API תומך בשיטות לשימוש במשאבים get,‏ list,‏ insert,‏ update,‏ patch ו-delete campaign.

  • ה-API תומך בכמה שגיאות חדשות עבור השיטות החדשות campaigns.get,‏ campaigns.insert,‏ campaigns.update ו-campaigns.delete.

30 במרץ 2015

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

  • עדכונים למשאבים ולשיטות קיימים

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

    • המאפיין event[].reason של המשאב claimHistory תומך בערכים החדשים הבאים. כל סיבה מסבירה למה אירוע מסוים שקשור לתלונה התרחש:

      • closed_audio_claim_on_visual_reference
      • closed_partner_exclusion
      • closed_reference_conflict

    • הפרמטר החדש sort של method‏ claimSearch.list מציין את השיטה שבה יתבצע סדר המשאבים בתגובת ה-API. כברירת מחדל, המשאבים ממוינים בסדר כרונולוגי הפוך (מהחדש ביותר לישן ביותר) על סמך התאריכים שבהם הם נוצרו. אפשר גם למיין את המשאבים לפי מספר הצפיות הגבוה ביותר לנמוך ביותר בתוכן שהוגשה לגביו תלונה.

      שימו לב: אם בבקשה claimSearch.list מוגדר גם ערך הפרמטר status כ-appealed,‏ disputed,‏ pending,‏ potential או routedForReview, התוצאות ממוינות לפי מועד התפוגה של תקופת בדיקת התלונה.

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

    • הפרמטרים fetchMatchPolicy לשיטות assets.get ו-assets.list כוללים עכשיו את הערך effective כערך נתמך. הערך הזה מורה לשרת ה-API לאחזר את מדיניות ההתאמה ש-YouTube מחילה על הנכס.

    • הפרמטרים id לשיטות assets.list,‏ claims.list,‏ contentOwners.list,‏ policies.list,‏ publishers.list ו-references.list כוללים עכשיו הערה על כך שערכי הפרמטרים שלהם יכולים להכיל עד 50 מזהי מפריד-פסיקים.

  • שגיאות חדשות ומעודכנות

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

    מידע נוסף זמין במסמכי התיעוד של השגיאות של כל שיטה או בדף שגיאות.

    סוג השגיאה פרטי השגיאה תיאור
    badRequest (400) tooManyIsrcs השיטה assetSearch.list מחזירה את השגיאה הזו אם הפרמטר isrcs מציין יותר מ-50 מזהי ISRC.
    badRequest (400) videoIsPrivate שגיאה זו תוחזר על ידי השיטה claims.insert אם תנסו לשלוח תלונה על הפרת זכויות יוצרים לגבי סרטון פרטי. אפשר להצהיר בעלות על סרטון רק אם סטטוס הפרטיות שלו הוא public או unlisted.
    notModified (304) blockOutsideOwnershipUnchanged השיטה claims.update מחזירה את השגיאה הזו אם לא ניתן היה לשנות את הדגל blockOutsideOwnership בטענה. יש כמה סיבות אפשריות לשגיאה הזו. דוגמה נפוצה היא שהשינוי שצוין לא משפיע על הסרטון שעליו הוגשה התלונה.

7 בנובמבר 2014

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

  • עדכונים למשאבים ולשיטות קיימים

    • הפרמטר status של השיטה claimSearch.list תומך עכשיו בערך routedForReview. הערך הזה מגביל את התוצאות לתלונות שצריך לבדוק באופן ידני על סמך כלל במדיניות ההתאמה של הנכס.

    • המאפיין event[].reason של המשאב claimHistory תומך בערכים החדשים הבאים. כל סיבה מסבירה למה אירוע מסוים שקשור לתלונה התרחש:

      • closed_invalid_reference_segment
      • closed_noadsense
      • suspended_monetization_on_channel
      • video_content_modified

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

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

      • אם הבקשה היא להעלאת קובץ עזר חדש, נקודת הקצה הנכונה היא:

        POST https://www.googleapis.com/upload/youtube/partner/v1/references

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

        POST https://www.googleapis.com/youtube/partner/v1/references

  • שגיאות חדשות ומעודכנות

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

    מידע נוסף זמין במסמכי התיעוד של השגיאות של כל שיטה או בדף שגיאות.

    סוג השגיאה פרטי השגיאה תיאור
    badRequest (400) invalidLabelName השגיאה הזו מוחזרת על ידי השיטות assets.insert,‏ assets.update ו-assetLabels.insert אם השם של תווית הנכס לא חוקי. אורך השמות של התוויות צריך להיות בין שניים ל-30 תווים. אסור להוסיף להם סוגריים זוויתיים, פסיקים, תווי נקודתיים, תווי אמפרסנד או קווים אנכיים (|).
    badRequest (400) ownerHaveMaximumNumberOfLabels השגיאה הזו תוחזר מהשיטות assets.insert, ‏ assets.update ו-assetLabels.insert אם בעלי התוכן כבר הגדירו 2, 500 תוויות ייחודיות לסימון נכסים, שהוא המספר המקסימלי המותר כרגע.
    badRequest (400) tooManyLabelsOnOneAsset השגיאה הזו מופיעה בחזרה מהשיטות assets.insert ו-assets.update אם הנכס כבר משויך ל-30 תוויות של נכסים, המספר המקסימלי המותר כרגע.
    badRequest (400) channelMonetizationSuspended השגיאה הזו מוחזרת מהשיטות claims.insert ו-claims.update אם הערוץ של הסרטון הושעה בגלל תלונות של שותפים.
    badRequest (400) channelNotActive השיטה claims.update מחזירה את השגיאה הזו אם הערוץ של הסרטון לא פעיל.

  • השיטות assets.insert ו-assets.update לא מחזירות יותר שגיאה מסוג badRequest לגבי נכסים מסוימים, אם המשאב בגוף הבקשה לא מכיל את המאפיין metadataMine.contentType.

23 בספטמבר 2014

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

  • שינויים במזהה של בעלי התוכן

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

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

    • ה-API מחזיר עכשיו את המזהה החדש כערך של מאפייני המשאבים שהחזירו בעבר את קוד השותף, כמו המאפיין id של המשאב contentOwner.
    • כל השיטות של ה-API תומכות בפרמטר onBehalfOfContentOwner, שמזהה את בעלי התוכן שעבורו נשלחת בקשת ה-API. לאחר השינוי, צריך להגדיר את הפרמטר למזהה החדש במקום לקוד השותף. כדי למנוע שיבושים בקוד, הפרמטר יקבל כל אחד מהערכים במהלך תקופת המעבר.
    • לאחר השינוי, הפרמטר contentOwnerId של השיטה contentOwners.list צריך לציין את המזהה החדש במקום את קוד השותף.

  • עדכונים למשאבים ולשיטות קיימים

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

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

      המדיניות שחלה על התוכן עשויה להיות שונה מהמדיניות שהוגדרה על ידי בעלי התוכן בשתי דרכים:

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

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

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

8 בספטמבר 2014

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

  • משאבים ושיטות חדשים

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

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

  • עדכונים למשאבים ולשיטות קיימים

    • המאפיין label[] של המשאב asset עודכן כדי לציין שאפשר להפעיל את השיטה assets.update כדי לעדכן את התוויות של נכס. עם זאת, אי אפשר להגדיר תוויות של נכס כשקוראים לשיטה assets.insert.

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

  • שגיאות חדשות ומעודכנות

    ה-API תומך בכמה שגיאות חדשות בשיטות החדשות assetLabels.list ו-assetLabels.insert.

9 ביולי 2014

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

  • שינויים במזהה של בעלי התוכן

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

    • ה-API יחזיר את המזהה בן 22 התווים כערך של מאפייני המשאבים שהחזירו בעבר את קוד השותף, כמו המאפיין id של המשאב contentOwner.
    • כל השיטות של ה-API תומכות בפרמטר onBehalfOfContentOwner, שמזהה את בעלי התוכן שעבורו נשלחת בקשת ה-API. לאחר השינוי, צריך להגדיר את הפרמטר למזהה בן 22 התווים במקום לקוד השותף. כדי למנוע שיבושים בקוד, הפרמטר יקבל כל אחד מהערכים במהלך תקופת המעבר.
    • לאחר השינוי, הפרמטר contentOwnerId של השיטה contentOwners.list צריך לציין את המזהה בן 22 התווים במקום את קוד השותף.

  • עדכונים למשאבים ולשיטות קיימים

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

    • השיטה assetSearch.list תומכת עכשיו בפרמטרים האופציונליים הבאים:

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

    • משאב claimHistory מכיל עכשיו את המאפיינים החדשים הבאים:

    • השיטה claimSearch.list תומכת עכשיו בפרמטרים האופציונליים הבאים:

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

  • מידע מפורט יותר על השגיאה

    מסמכי התיעוד של השגיאות כוללים עכשיו את קוד התגובה של HTTP לכל סוג שגיאה.

  • שגיאות חדשות ומעודכנות

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

    מידע נוסף זמין במסמכי התיעוד של השגיאות של כל שיטה או בדף שגיאות.

    שיטה שגיאות
    assetSearch.list
    • invalidValue – ה-API לא תומך בחיפוש נכסים של תוכניות או עונות. משנים את הערך של הפרמטר type לערך נתמך.
    assets.insert
    • conflict – כבר קיימים יותר מדי נכסים עם אותו מזהה (למשל, מזהה מותאם אישית, קוד ISRC וכו').
    • conflict – כבר יש יותר מדי עותקים של הנכס שצוין.
    • invalidValue – למשתמש שמפעיל את ה-API אין הרשאה ליצור נכסים מהסוג שצוין.
    assets.patch
    assets.update
    • badRequest – ה-API לא תומך בהמרה של סוג הנכס שניסיתם לבצע.
    claimSearch.list
    ownership.patch
    ownership.update
    • badRequest – לא ניתן לעדכן את הבעלות על נכס מסוג תמונת רקע לסרטון.
    references.patch
    references.update
    • badRequest – קובץ העזר במצב לא תקין לפעולה שאתם מנסים לבצע.

3 בפברואר 2014

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

  • עדכונים למשאבים ולשיטות קיימים

    • עכשיו למשאב asset יכול להיות ערך type של art_track_video.

    • משאב claimSearch כולל עכשיו את המאפיינים החדשים הבאים:

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

    • השיטה claimSearch.list תומכת עכשיו בפרמטרים האופציונליים הבאים:

      • contentType: הגבלת התוצאות כך שיכללו רק תלונות על אודיו בלבד, תלונות על וידאו בלבד או תלונות על תוכן אודיו-ויזואלי.
      • origin: מציין מקור אחד או יותר של תלונות, כמו descriptiveSearch או videoMatch, שעבורם רוצים למצוא תלונות.
      • status: הגבלת התוצאות כך שיכללו רק הצהרות שיש להן את הסטטוס שצוין.

    • המאפיין status של המשאב claim תומך עכשיו בערכים הנוספים הבאים: appealed,‏ disputed,‏ potential,‏ takedown ו-unknown.

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

    • המאפיין החדש allowedOptions.autoGeneratedBreaks של המשאב contentOwnerAdvertisingOption מציין אם השותף יכול לבחור להציג מודעות באמצע סרטון (mid-roll) בזמני הפסקה שנקבעו באופן אוטומטי על ידי YouTube.

    • עכשיו אפשר לקרוא לשיטה contentOwners.list עם אסימון הרשאה שמציין את ההיקף https://www.googleapis.com/auth/youtubepartner-content-owner-readonly.

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

    • השיטה policies.list תומכת עכשיו בפרמטר sort אופציונלי, שאפשר להשתמש בו כדי לציין שצריך למיין את התוצאות בסדר עולה או יורד לפי מועד העדכון האחרון שלהן.

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

    • המאפיין החדש autoGeneratedBreaks של המשאב videoAdvertisingOption מציין אם צריך להציג בסרטון מודעות In-stream באמצע הסרטון בזמני הפסקה שנקבעו באופן אוטומטי על ידי YouTube.

  • שגיאות חדשות ומעודכנות

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

    מידע נוסף זמין במסמכי התיעוד של השגיאות של כל שיטה או בדף שגיאות.

    שיטה שגיאות
    assets.insert
    assets.update
    • badRequest – ה-API לא תומך בפעולות כתיבה בנכסי תמונת רקע לסרטון.
    claimSearch.list
    • invalidValue – הפרמטר pageToken בבקשה מציין טוקן דף לא חוקי.
    claims.insert
    • badRequest – התלונה שאתם מנסים ליצור לא תקפה כי הערוץ של הסרטון לא פעיל.
    • badRequest – הסרטון שאתם מנסים לשלוח לגביו תלונה פטור ממדיניות ההסרה. לשאלות, אפשר לפנות אל copyright@youtube.com
    • badRequest – לא ניתן לעבד את הבקשה כי אי אפשר ליצור תלונה של צד שלישי לגבי הסרטון שצוין.
    • conflict – ל-YouTube אין אפשרות ליצור את התלונה המבוקשת כי נשלחה הודעה נגדית להסרת תוכן לגבי הסרטון.
    • conflict – ל-YouTube אין אפשרות ליצור את התלונה המבוקשת כי יש תלונה פעילה על הסרת תוכן לגבי הסרטון.
    references.insert
    • badRequest – הסרטון שהוגשה לגביו תלונה ושאתם מנסים להשתמש בו נמחק או נדחה, או שהעיבוד שלו נכשל.

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

12 בספטמבר 2013

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

  • משאבים ושיטות חדשים

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

    עדכונים למשאבים ולשיטות קיימים

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

      כדי לאחזר את מדיניות ההתאמה היעילה של נכס, מגדירים את ערך הפרמטר fetchMatchPolicy לערך effective כשקוראים לשיטות assets.get או assets.list. בתשובה של ה-API, האובייקט matchPolicyEffective בכל משאב asset מוחזר מכיל את מדיניות ההתאמה בפועל של הנכס הזה.

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

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

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

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

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

  • שגיאות חדשות ומעודכנות

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

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

    • הדף errors עודכן כך שלכל משאב שתומך בשיטות update ו-patch, הדף מכיל טבלה אחת עם רשימה של השגיאות שמוחזרות על ידי שתי השיטות האלה. בעבר, השגיאות של כל שיטה הוצגו בנפרד בדף, אבל הרשימות תמיד היו זהות.

16 ביולי 2013

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

  • משאבים ושיטות חדשים

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

    • השיטה החדשה claimSearch.list מאפשרת לחפש הצהרות שעומדות באחד או בכל הקריטריונים הבאים:

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

      כל משאב claimSnippet בתגובה של ה-API מכיל פרטים על תלונה, כולל מזהה התלונה הייחודי, הסטטוס, הסוג (audio,‏ video או audiovisual) והנכס והסרטון שמשויכים לתלונה. המשאב מציין גם את מספר הצפיות בסרטון שהוגשה לגביו תלונה על הפרת זכויות יוצרים ואת שם הסרטון.

  • עדכונים למשאבים ולשיטות קיימים

    • במסמכי העזרה מפורטים עכשיו הערכים הנתמכים לנכסים שיש להם קבוצה של ערכים ממוספרים. נכסים כאלה כוללים את המאפיין type של המשאב asset ואת המאפיין status של המשאב claim.

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

      ברשימה הבאה מוסבר על השינויים התואמים במבנה המשאב asset, וגם על ההשפעות של השינויים האלה על שיטות ה-API של משאבי get, ‏ list, ‏ insert, ‏ update או patch asset.

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

      • באופן דומה, האובייקט ownership הוחלף באובייקטים ownershipMine ו-ownershipEffective.

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

      הערה: כדי להבטיח תאימות לאחור, אם מבקשים רק גרסה אחת של מטא-נתונים, קבוצה אחת של נתוני בעלות או מדיניות התאמה אחת לנכס, תגובת ה-API תכלול את האובייקט שהוצא משימוש וגם את האובייקט החדש שנתמך. לדוגמה, אם בבקשה מוגדר הפרמטר fetchMetadata לערך mine, תגובת ה-API תכיל אובייקט metadata ואובייקט metadataMine, ושניהם יכללו את אותם נתונים. (היכולת להגדיר את fetchMetadata=mine נתמכה לפני עדכון התכונה שמאפשר לאחזר כמה גרסאות של מטא-נתונים).

      עם זאת, אם הפרמטר fetchMetadata מוגדר כ-mine,effective, תגובת ה-API תכיל אובייקטים מסוג metadataMine ו-metadataEffective, אבל לא תכלול אובייקט מסוג metadata. (היכולת להגדיר את fetchMetadata=mine,effective לא נתמכה לפני עדכון התכונה הזה, לכן אין צורך להחזיר את האובייקט metadata לצורך תאימות לאחור). אותו עיקרון חל גם על הפרמטרים fetchOwnership ו-fetchMatchPolicy.

      כמו כן, לשם תאימות לאחור, בקשה ל-insert, ל-update או ל-patch של משאב asset יכולה לכלול את האובייקט metadataMine או את האובייקט metadata. אותו עיקרון חל על הגדרת נתוני הבעלות או מדיניות ההתאמה של משאב asset.

    • הפרמטרים assetId,‏ q ו-videoId של השיטה claims.list הוצאו משימוש. כדי לחפש תלונות לפי אחד מהקריטריונים האלה, משתמשים בשיטה claimSearch.list, שתומכת בכל הפרמטרים האלה.

    • במשאב ownership, עכשיו לכל הערכים של המאפיינים general[].ratio,‏ performance[].ratio,‏ synchronization[].ratio ו-mechanical[].ratio יש פורמט תוכן של double במקום integer.

    • ההגדרה של המאפיין rules[].action של המשאב policy כוללת עכשיו את הערכים התקפים של המאפיין הזה: block,‏ monetize,‏ takedown ו-track. עם זאת, חשוב לזכור שאי אפשר להשתמש ב-API כדי להחיל מדיניות הסרה על תלונה.

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

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

    • ה-API כבר לא מחייב להגדיר את המאפיין status במשאב reference שנשלח בגוף הבקשה מסוג references.update או references.patch.

    • תוקנו מסמכי התיעוד כדי לתאר בצורה נכונה את פורמט התגובה של ה-API לשיטה videoAdvertisingOptions.getEnabledAds. התשובה, שהיא משאב youtubePartner#videoAdvertisingOptionGetEnabledAds, מכילה את הפרטים הבאים:

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

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

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

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

  • שגיאות חדשות ומעודכנות

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

      מידע נוסף זמין במסמכי התיעוד של השגיאות של כל שיטה או בדף שגיאות.

      שיטה שגיאות
      assets.insert
      assets.update
      assets.patch
      • שגיאות מסוג invalidValue ו-required ששויכו בעבר למאפייני הצאצאים של האובייקט metadata משויכות עכשיו לאותו מאפייני הצאצאים באובייקט metadataMine.
      claimHistory.get
      • notFound – לא ניתן למצוא את התלונה שאליה אתם מנסים לאחזר את ההיסטוריה.
      • required – בבקשה לא צוין ערך לפרמטר claimId.
      claimSearch.list
      claims.list
      • badRequest – בבקשה צוינו קריטריונים לא תקינים. אפשר לציין לכל היותר אחד מפרמטרי המסנן הבאים: q,‏ assetId,‏ videoId.
      claims.insert
      • badRequest – התלונה שאתם מנסים ליצור לא תקפה כי בעלי התוכן המבקש הוא לא הבעלים של הנכס שמשויך לתלונה.
      • badRequest – לבעלי התוכן שאתם פועלים בשמם אין הרשאה ליצור כללי מדיניות עם הפעולה שצוינה.
      • invalidValue – לבעלי התוכן שעבורו פועלים אין הרשאה להגיש תלונות על הפרת זכויות יוצרים בסרטונים שהמשתמשים העלו באמצעות ה-API.
      contentOwners.list
      • badRequest – בבקשה צוינו קריטריונים לא תקינים. צריך לציין בדיוק אחד מפרמטרי הסינון הבאים: fetchMine, id. (בעבר, השגיאה ציינה קבוצה אחרת של פרמטרים של מסנן – has_conflicts_with,‏ restrict_to_user,‏ name_prefix ו-id).
      ownership.update
      ownership.patch
      • badRequest – בבקשה לעדכון נתוני הבעלות של נכס קומפוזיציה צריך לציין נתוני בעלות מפורטים &ndahs; זכויות mechanical,‏ performance,‏ synchronization ו/או lyric – במקום זכויות בעלות מסוג general. סוג הזכויות lyric נתמך עכשיו.
      policies.insert
      policies.update
      policies.patch
      • invalidValue – הבקשה מכילה כלל מדיניות לא תקין כי ה-API לא תומך ביצירה או בשינוי של כללי מדיניות שצוינה בהם פעולה מסוג takedown. השגיאה הזו, שמדווחת על הסיבה invalidPolicyTakedownAction, מחליפה את השגיאה invalidPolicyConditionalTakedown שהוצאה משימוש.
      references.insert
      • badRequest – הבקשה חייבת לשלוח קובץ מדיה או לציין ערך לפרמטר הבקשה claimId. עם זאת, אסור לשלוח בקשה עם קובץ מדיה וגם לציין ערך לפרמטר הבקשה claimId.
      • badRequest – כבר נוצר קובץ עזר לאותו תוכן מתלונה אחרת על אותו סרטון ב-YouTube.
      • badRequest – ה-API לא תומך באפשרות להגדיר ערך למאפיין fpDirect כשיוצרים קובץ עזר.
      • internalError – יש בעיה בקובץ המדיה שהעליתם.
      • invalidValue – הערך של פרמטר הבקשה contentType,‏ assetId או claimId לא תקין. השגיאה מזהה את הערך הלא חוקי.
      • notFound – לא ניתן למצוא את הנכס או את התלונה שציינת. עליך לבדוק את ערכי הפרמטרים assetId ו-claimId בבקשה.
      • required – בבקשה צריך לציין ערך לפרמטר contentType.
      references.insert
      references.update
      references.patch
      • invalidValue – הערכים של excludedIntervals שצוינו להפניה לא חוקיים. שימו לב שאין אפשרות לציין מרווחי החרגה כשמשביתים קובץ עזר.

10 במאי 2013

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

8 באפריל 2013

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

  • שם ה-API השתנה לממשק ה-API של Content ID ב-YouTube.

  • כמה מאפיינים השתנו במשאב assetMatchPolicy:

    • ערך המאפיין kind השתנה מ-youtubePartner#policy ל-youtubePartner#assetMatchPolicy.
    • המאפיין החדש policyId מכיל ערך שמזהה באופן ייחודי משאב של מדיניות שמורה.
    • ערך המאפיין rules[].subaction הוא עכשיו רשימה של מחרוזות במקום מחרוזת אחת.
    • ערך המאפיין rules[].conditions.contentMatchType הוא עכשיו רשימה של מחרוזות במקום מחרוזת אחת.
    • הנכסים id,‏ name ו-description הוסרו.

  • המסמך של השיטה assetMatchPolicy.update עודכן כדי לשקף את העובדה שאפשר להגדיר ערכים למאפיין policyId או לאובייקט rules[] בזמן הקריאה לשיטה.

  • עכשיו יש תמיכה במספר מאפיינים חדשים במשאב claims:

    שם הנכס ערך תיאור
    timeCreated datetime התאריך והשעה שבהם נוצרה התלונה על הפרת זכויות יוצרים.
    matchInfo object האובייקט matchInfo מכיל מידע על התוכן התואם שגרם ליצירת התלונה. המידע הזה נכלל במשאב claim רק אם התלונה נוצרה באופן אוטומטי כי סרטון שהועלה התאים לקובץ עזר קיים.
    matchInfo.referenceId string המזהה הייחודי ש-YouTube משתמש בו כדי לזהות את reference ששימש ליצירת ההתאמה.
    matchInfo.longestMatch object האובייקט longestMatch מכיל מידע על ההתאמה הארוכה ביותר בין קובץ העזר לסרטון שהוUpload.
    matchInfo.longestMatch.durationSecs unsigned long משך ההתאמה, בשניות.
    matchInfo.longestMatch.userVideoOffset unsigned long הפרש הזמן שבו המשחק מתחיל, נמדד בשניות מתחילת הסרטון שהועלו.
    matchInfo.longestMatch.referenceOffset unsigned long הפרש הזמן שבו מתחילה ההתאמה, שנמדד בשניות מתחילת ההפניה.
    matchInfo.totalMatch object האובייקט totalMatch מכיל מידע על משך הזמן הכולל של הסרטון שהועלה שתואמת לקובץ העזר, ועל משך הזמן הכולל של קובץ העזר שתואמת לסרטון שהועלה. הערכים האלה עשויים להיות שונים אם התוכן התואם פועל בלולאה בסרטון שהועלו או בקובץ העזר. לדוגמה, אם סרטון שהועלה כולל קליפ של 10 שניות מקובץ עזר, אבל הקליפ חוזר על עצמו שש פעמים, זמן התוכן הכולל שתואם בסרטון שהועלה הוא 60 שניות, אבל זמן התוכן הכולל שתואם בקובץ העזר הוא רק 10 שניות.
    matchInfo.totalMatch.userVideoDurationSecs unsigned long משך הזמן הכולל, בשניות, של תוכן הסרטון שהועלה שתואמת לקובץ העזר.
    matchInfo.totalMatch.referenceDurationSecs unsigned long משך הזמן הכולל, בשניות, של תוכן העזר שתואמת לסרטון שהועלה.
    origin object האובייקט origin מכיל מידע שמתאר את מקור התלונה.
    origin.source string מקור התלונה.

  • המאפיין policy במשאב claims עודכן כדי לציין שלא ניתן לעדכן את הערך של תלונה בנושא AudioSwap.

  • השם של המאפיין timeProvidedMs של המשאב metadataHistory השתנה ל-timeProvided.

  • השם של המאפיין timeProvidedMs של המשאב ownershipHistory השתנה ל-timeProvided.

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

  • כמה מאפיינים השתנו במשאב policy:

    • השם של המאפיין rule השתנה ל-rules.
    • ערך המאפיין rules[].subaction הוא עכשיו רשימה של מחרוזות במקום מחרוזת אחת.
    • ערך המאפיין rules[].conditions.contentMatchType הוא עכשיו רשימה של מחרוזות במקום מחרוזת אחת.

  • המסמכים של השיטות policies.insert ו-policies.update עודכנו כדי לשקף את העובדה שאפשר להגדיר ערכים לאובייקט rules[] בזמן הקריאה לשיטות האלה.

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

    מידע נוסף זמין במסמכי התיעוד של השגיאות של כל שיטה או בדף שגיאות.

    שיטה שגיאות
    assets.insert
    • invalidValue – שדה מטא-נתונים של נכס מכיל ערך לא חוקי.
    • required – חסר שדה חובה של מטא-נתונים של נכס.
    assets.update
    assets.patch
    • forbidden – הנכס שמתעדכן לא בבעלות השותף שמנסה להשלים את העדכון.
    • invalidValue – שדה מטא-נתונים של נכס מכיל ערך לא חוקי.
    • notFound – הנכס משויך לנכס של עונה או לנכס של תוכנית טלוויזיה שלא ניתן למצוא.
    • required – חסר שדה חובה של מטא-נתונים של נכס.
    claims.insert
    • badRequest – הבקשה מנסה להצהיר בעלות על סרטון, אבל הבקשה לא מותרת.
    ownership.update
    ownership.patch
    • badRequest – בבקשה מוגדרת בעלות כוללת של יותר מ-100% בתוך אזור מסוים.
    policies.insert
    policies.patch
    policies.update
    • conflictingPolicyRules – המדיניות מכילה כללי מדיניות סותרים.

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

18 בינואר 2013

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

  • שיטת videoAdvertisingOptions.getEnabledAds החדשה מאפשרת לאחזר פרטים על סוגי המודעות שמותר להציג בסרטון ספציפי שהועלה על ידי שותף או על ידי משתמש.

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

  • המסמכים של השיטה assets.list משקפים את השינויים הבאים:

    • הפרמטר id נדרש עכשיו.

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

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

    • רשימת הנכסים שה-API מחזיר כבר לא מכילה נתוני פירוט דפים. כתוצאה מכך, גם המאפיין nextPageToken וגם האובייקט pageInfo הוסרו מהתגובה של ה-API. אובייקט pageInfo הכיל את המאפיינים totalResults,‏ resultsPerPage ו-startIndex.

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

  • המאפיין hasUnpublishedDraft של המשאב policy יצא משימוש.

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

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

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

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

    שיטה סוג השגיאה פרטי השגיאה תיאור
    guideCategories.list notFound Unavailable לא ניתן למצוא את הנכס שעבורו אתם מנסים לאחזר את מדיניות ההתאמה.
    claims.get notFound Unavailable לא הצלחנו למצוא את ההצהרה על זכויות יוצרים שניסית לאחזר.
    ownership.patch invalidValue Unavailable נתוני הבעלות שציינת מכילים ערך לא חוקי.
    ownership.update invalidValue Unavailable נתוני הבעלות שציינת מכילים ערך לא חוקי.