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

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

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

‫27 באוגוסט 2026

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

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

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

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

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

‫4 באוגוסט 2026

עדכנו את המסמכים של YouTube Content ID API כדי להבהיר את סדר הפעולות כשמעדכנים נכסים שכבר נמצאים בבעלות של בעלי תוכן אחרים:

  • אם נכס כבר נמצא בבעלות של בעל תוכן אחר, צריך להוסיף את הבעלות שלכם לנכס באמצעות ownership.update או ownership.patch לפני שתוכלו להגדיר או לעדכן את המטא-נתונים או את מדיניות ההתאמה שלו.
  • אם תנסו לעדכן את המטא-נתונים (assets.update או assets.patch) או את מדיניות ההתאמה (assetMatchPolicy.update או assetMatchPolicy.patch) לפני שתצהירו על בעלות, הבקשה תיכשל ותוצג השגיאה PERMISSION_DENIED.
  • עדכנו את המדריך עדכון תוויות של נכס והוספנו לו הוראות מפורטות להוספת תוויות לנכסים שבבעלות בעלי תוכן אחרים.

‫26 במרץ 2025

החל מ-31 במרץ 2025, נשנה ב-YouTube את האופן שבו הצפיות בסרטוני 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

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

‫10 בנובמבר 2023

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

1 ביוני 2023

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

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

20 בדצמבר 2022

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

9 בנובמבר 2022

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

‫28 בספטמבר 2022

מידע על סטטוס הרישוי נוסף לasset resource.

‫18 ביולי 2022

עדכנו את התיעוד של claimSearch.list השיטה inactiveReasons כדי לשקף שיפורים בעקביות עם 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 של ה-method‏ 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 לגבי הזכויות על היצירה המוזיקלית שמשויכת להקלטה מסוימת, ויכול להיות שהם יסכמו מידע מכמה ספקי נתונים.

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

    המשאב assetShare מזהה קשר בין תצוגת יצירה לבין שיתוף יצירה. ה-method החדש 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 יצא משימוש.

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

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

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

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

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

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

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

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

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

‫7 בנובמבר 2014

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

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

    • הפרמטר status של ה-method‏ 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 תומך בהן, והשיטות שיכולות להחזיר כל שגיאה. שימו לב: יכול להיות ששיטה תחזיר כמה שגיאות מאותו סוג.

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

    סוג השגיאה פרטי השגיאה תיאור
    badRequest (400) invalidLabelName השיטות assets.insert,‏ assets.update ו-assetLabels.insert מחזירות את השגיאה הזו אם השם של תווית נכס לא תקין. אורך השמות של התוויות צריך להיות בין 2 ל-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 עודכן כדי לציין שאפשר להתקשר אל method ‏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.

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

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

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

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

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

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

    במסמכי התיעוד בנושא שגיאות מצוין עכשיו קוד תגובת ה-HTTP לכל סוג שגיאה.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    שיטה שגיאות
    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.

‫12 בספטמבר 2013

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

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

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

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

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

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

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

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

    • ה-methods‏ 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.

    • הדף שגיאות עודכן כך שעבור כל משאב שתומך בשיטות 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 methods שמשאבי asset,‏ get,‏ list,‏ insert,‏ update או patch משתמשים בהם.

      • האובייקט 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 ל-method videoAdvertisingOptions.getEnabledAds מתואר בצורה נכונה. התשובה, שהיא משאב youtubePartner#videoAdvertisingOptionGetEnabledAds, מכילה את הפרטים הבאים:

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

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

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

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

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

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

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

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

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

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

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

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

    שיטה שגיאות
    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 – המדיניות מכילה כללי מדיניות סותרים.

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