Videos: update

ה-API תומך עכשיו באפשרות לסמן את הערוץ או את הסרטונים כתוכן שהוא 'במיוחד לילדים'. בנוסף, המשאבים channel ו-video מכילים עכשיו מאפיין שמזהה את הסטטוס "במיוחד לילדים" של הערוץ או הסרטון. ב-10 בינואר 2020 עודכנו גם התנאים וההגבלות של שירותי ה-API של YouTube וכללי המדיניות למפתחים. מידע נוסף זמין בהיסטוריית הגרסאות של YouTube Data API ושל התנאים וההגבלות של שירותי ה-API של YouTube.

עדכון המטא-נתונים של סרטון.

השפעה על המכסה: העלות של קריאה לשיטה הזו היא 50 יחידות מכסה.

תרחישים נפוצים לדוגמה

בקשה

בקשת HTTP

PUT https://www.googleapis.com/youtube/v3/videos

אישור

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

היקף
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

פרמטרים

בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמופיעים ברשימה הם פרמטרים של שאילתה.

פרמטרים
פרמטרים נדרשים
part string
לפרמטר part יש שתי מטרות בפעולה הזו. הוא מזהה את המאפיינים שפעולת הכתיבה תגדיר, וגם את המאפיינים שהתגובה מה-API תכלול.

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

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

הרשימה הבאה מכילה את שמות ה-part שאפשר לכלול בערך הפרמטר:
  • brandPartner
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
פרמטרים אופציונליים
onBehalfOfContentOwner string
אפשר להשתמש בפרמטר הזה רק בבקשה מורשית. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן ב-YouTube.

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

גוף הבקשה

מציינים משאב וידאו בגוף הבקשה. למשאב הזה:

  • צריך לציין ערך למאפיינים הבאים:

    • id
    • snippet.title – המאפיין הזה נדרש רק אם הבקשה מעדכנת את snippet של המשאב video.
    • snippet.categoryId – המאפיין הזה נדרש רק אם הבקשה מעדכנת את snippet של המשאב video.

  • אפשר להגדיר ערכים למאפיינים הבאים:

    • snippet.categoryId
    • snippet.defaultLanguage
    • snippet.description
    • snippet.tags[]
    • snippet.title
    • status.embeddable
    • status.license
    • status.privacyStatus
    • status.publicStatsViewable
    • ‫status.publishAt – אם מגדירים ערך למאפיין הזה, צריך להגדיר גם את המאפיין status.privacyStatus כ-private. אפשר להגדיר את המאפיין הזה רק אם סטטוס הפרטיות של הסרטון הוא private והסרטון מעולם לא פורסם.
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

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

תשובה

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

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) defaultLanguageNotSet בקשת ה-API מנסה להוסיף פרטי סרטון שמותאמים לשוק המקומי בלי לציין את שפת ברירת המחדל של פרטי הסרטון.
badRequest (400) invalidCategoryId המאפיין snippet.categoryId מציין מזהה קטגוריה לא תקין. כדי לאחזר קטגוריות נתמכות, משתמשים ב-method‏ videoCategories.list.
badRequest (400) invalidDefaultBroadcastPrivacySetting הבקשה מנסה להגדיר הגדרת פרטיות לא חוקית לשידור ברירת המחדל.
badRequest (400) invalidDescription המטא-נתונים של הבקשה מציינים תיאור סרטון לא חוקי.
badRequest (400) invalidPublishAt המטא-נתונים של הבקשה מציינים זמן לא חוקי לפרסום מתוזמן.
badRequest (400) invalidRecordingDetails אובייקט recordingDetails במטא-נתונים של הבקשה מציין פרטי הקלטה לא תקינים.
badRequest (400) invalidTags המטא-נתונים של הבקשה מציינים מילות מפתח לא חוקיות לסרטון.
badRequest (400) invalidTitle המטא-נתונים של הבקשה מציינים שם סרטון לא תקין או ריק.
badRequest (400) invalidVideoMetadata המטא-נתונים של הבקשה לא תקינים.
forbidden (403) forbidden
forbidden (403) forbiddenEmbedSetting הבקשה מנסה להגדיר הגדרת הטמעה לא חוקית לסרטון. חשוב לדעת: יכול להיות שלערוצים מסוימים אין הרשאה להציע נגנים מוטמעים לשידורים חיים. מידע נוסף זמין במרכז העזרה של YouTube.
forbidden (403) forbiddenLicenseSetting הבקשה מנסה להגדיר רישיון לא חוקי לסרטון.
forbidden (403) forbiddenPrivacySetting הבקשה מנסה להגדיר הגדרת פרטיות לא חוקית לסרטון.
notFound (404) videoNotFound לא מצאנו את הסרטון שאתם מנסים לעדכן. צריך לבדוק את הערך של השדה id בגוף הבקשה ולוודא שהוא נכון.

רוצה לנסות?

משתמשים ב-APIs Explorer כדי להפעיל את ה-API הזה ולראות את בקשת ה-API והתגובה.