Videos: update

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

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

השפעה על המכסה: לקריאה לשיטה הזו יש עלות מכסה של 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 שאפשר לכלול בערך הפרמטר:
  • 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.
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

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

תשובה

אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר משאב וידאו בגוף התגובה.

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) defaultLanguageNotSet בקשת ה-API מנסה להוסיף פרטי סרטון שהותאמו לשוק המקומי, בלי לציין את שפת ברירת המחדל של פרטי הסרטון.
badRequest (400) invalidCategoryId המאפיין snippet.categoryId מציין מזהה קטגוריה לא חוקי. משתמשים בשיטה 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.