Videos: update

ה-API תומך עכשיו באפשרות לסמן את הערוץ או הסרטונים שלך בקטגוריה 'במיוחד לילדים'. בנוסף, המשאבים channel ו-video מכילים עכשיו גם נכס שמזהה את הסטטוס 'במיוחד לילדים' של הערוץ או הסרטון. התנאים וההגבלות של שירותי YouTube API והמדיניות למפתחים עודכנו גם הם ב-10 בינואר 2020. למידע נוסף, אפשר לעיין בהיסטוריית הגרסאות של שירות 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
  • 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
    • recordingDetails.locationDescription (הוצא משימוש)
    • recordingDetails.location.latitude (הוצא משימוש)
    • recordingDetails.location.longitude (הוצא משימוש)
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

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

תשובה

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

שגיאות

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

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