Videos

כל הסרטונים שיועלו דרך נקודת הקצה videos.insert מפרויקטים לא מאומתים של API שנוצרו אחרי 28 ביולי 2020 יוגבלו למצב צפייה פרטית. כדי לבטל את ההגבלה הזו, כל פרויקט API צריך לעבור ביקורת כדי לוודא שהוא עומד בתנאי השירות. פרטים נוספים זמינים בהיסטוריית הגרסאות של ה-API.

משאב video מייצג סרטון ב-YouTube.

שיטות

ה-API תומך בשיטות הבאות למשאבי videos:

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

ייצוג משאבים

המבנה הבא של JSON מציג את הפורמט של משאב videos:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

מאפיינים

בטבלה הבאה מפורטים המאפיינים שמופיעים במשאב הזה:

מאפיינים
kind string
משמש לזיהוי הסוג של משאב ה-API. הערך יהיה youtube#video.
etag etag
ה-Etag של המשאב הזה.
id string
המזהה שמשמש את YouTube לזיהוי ייחודי של הסרטון.
snippet object
האובייקט snippet מכיל פרטים בסיסיים על הסרטון, כמו השם, התיאור והקטגוריה שלו.
snippet.publishedAt datetime
התאריך והשעה שבהם הסרטון פורסם. שימו לב שהשעה הזו עשויה להיות שונה מהשעה שבה הסרטון הועלה. לדוגמה, אם סרטון הועלה כפרטי ולאחר מכן הוגדר כגלוי לכולם, המאפיין הזה יציין את המועד שבו הסרטון הוגדר כגלוי לכולם.

יש כמה מקרים מיוחדים:
  • אם סרטון מועלה כסרטון פרטי ובעל הערוץ מאחזר את המטא-נתונים של הסרטון, ערך הנכס מציין את התאריך והשעה שבהם הסרטון הועלה.
  • אם סרטון הועלה כסרטון לא רשום, ערך המאפיין מציין גם את התאריך והשעה שבהם הסרטון הועלה. במקרה כזה, כל מי שיודע את מזהה הווידאו הייחודי של הסרטון יכול לאחזר את המטא-נתונים שלו.
הערך מצוין בפורמט ISO 8601.
snippet.channelId string
המזהה שמשמש את YouTube לזיהוי ייחודי של הערוץ שאליו הועלה הסרטון.
snippet.title string
השם של הסרטון. אורך הערך של המאפיין הוא עד 100 תווים, והוא יכול להכיל את כל התווים התקינים של UTF-8, מלבד < ו->. צריך להגדיר ערך למאפיין הזה אם קוראים לשיטה videos.update ומעדכנים את החלק snippet של משאב video.
snippet.description string
תיאור הסרטון. האורך המקסימלי של ערך המאפיין הוא 5,000 בייטים, והוא יכול להכיל את כל התווים התקינים של UTF-8, מלבד < ו->.
snippet.thumbnails object
מפה של תמונות ממוזערות שמשויכות לסרטון. לכל אובייקט במפה, המפתח הוא שם התמונה הממוזערת והערך הוא אובייקט שמכיל מידע נוסף על התמונה הממוזערת.
snippet.thumbnails.(key) object
ערכי המפתח החוקיים הם:
  • default – תמונת ברירת המחדל של התמונה הממוזערת. התמונה הממוזערת שמוגדרת כברירת מחדל עבור סרטון – או משאב שמתייחס לסרטון, כמו פריט בפלייליסט או תוצאת חיפוש – היא ברוחב של 120 פיקסלים וגובה של 90 פיקסלים. ברירת המחדל של התמונה הממוזערת של הערוץ היא 88 פיקסלים רוחב ו-88 פיקסלים גובה.
  • medium – גרסה ברזולוציה גבוהה יותר של התמונה הממוזערת. עבור סרטון (או משאב שמתייחס לסרטון), התמונה הזו צריכה להיות ברוחב 320 פיקסלים ובאורך 180 פיקסלים. עבור ערוץ, התמונה הזו צריכה להיות ברוחב 240 פיקסלים ובגובה 240 פיקסלים.
  • high – גרסה ברזולוציה גבוהה של התמונה הממוזערת. עבור סרטון (או משאב שמתייחס לסרטון), התמונה הזו צריכה להיות ברוחב 480 פיקסלים ובגובה 360 פיקסלים. התמונה של הערוץ צריכה להיות ברוחב 800 פיקסלים ובגובה 800 פיקסלים.
  • standard – גרסה ברזולוציה גבוהה יותר של התמונה הממוזערת מאשר התמונה ברזולוציה high. התמונה הזו זמינה לחלק מהסרטונים וממקורות מידע אחרים שמפנים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. התמונה הזו ברוחב 640 פיקסלים ובגובה 480 פיקסלים.
  • maxres – גרסת הרזולוציה הגבוהה ביותר של התמונה הממוזערת. גודל התמונה הזה זמין לסרטונים מסוימים ולמשאבים אחרים שמפנים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. התמונה הזו ברוחב 1,280 פיקסלים ובגובה 720 פיקסלים.
snippet.thumbnails.(key).url string
כתובת ה-URL של התמונה.
snippet.thumbnails.(key).width unsigned integer
רוחב התמונה.
snippet.thumbnails.(key).height unsigned integer
גובה התמונה.
snippet.channelTitle string
שם הערוץ שהסרטון שייך לו.
snippet.tags[] list
רשימה של תגי מילות מפתח שמשויכים לסרטון. התגים יכולים להכיל רווחים. האורך המקסימלי של ערך הנכס הוא 500 תווים. חשוב לשים לב לכללים הבאים לגבי אופן החישוב של מגבלת התווים:
  • ערך המאפיין הוא רשימה, ופסיק בין פריטים ברשימה נספר במסגרת המגבלה.
  • אם תג מכיל רווח, שרת ה-API מטפל בערך התג כאילו הוא מוקף במירכאות, והמירכאות נספרות כחלק ממגבלת התווים. לכן, למטרות מגבלת התווים, התג Foo-Baz מכיל שבעה תווים, אבל התג Foo Baz מכיל תשעה תווים.
snippet.categoryId string
קטגוריית הסרטון ב-YouTube שמשויכת לסרטון. צריך להגדיר ערך למאפיין הזה אם קוראים ל-method videos.update ומעדכנים את החלק snippet במשאב video.
snippet.liveBroadcastContent string
מציין אם הסרטון הוא שידור חי שמשודר עכשיו או שישודר בקרוב. לחלופין, הערך הוא 'none' אם הסרטון הוא לא שידור חי פעיל או שידור חי שעומד להתקיים.

הערכים התקפים לנכס הזה הם:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
השפה של הטקסט במאפיינים snippet.title ו-snippet.description של המשאב video.
snippet.localized object
האובייקט snippet.localized מכיל שם ותיאור מותאמים לסרטון או את השם בשפת ברירת המחדל של המטא-נתונים של הסרטון.
  • טקסט מותאם לשפה המקומית מוחזר בקטע הקוד של המשאב אם בבקשה videos.list נעשה שימוש בפרמטר hl כדי לציין שפה שבה צריך להחזיר טקסט מותאם לשפה המקומית וגם אם טקסט מותאם לשפה המקומית זמין בשפה הזו.
  • המטא-נתונים של שפת ברירת המחדל מוחזרים אם לא צוין ערך של הפרמטר hl או אם צוין ערך אבל אין מטא-נתונים מותאמים לשוק המקומי בשפה שצוינה.
המאפיין מכיל ערך לקריאה בלבד. משתמשים באובייקט localizations כדי להוסיף, לעדכן או למחוק שמות מתורגמים.
snippet.localized.title string
שם הסרטון המתורגם.
snippet.localized.description string
תיאור הסרטון המותאם לשוק המקומי.
snippet.defaultAudioLanguage string
המאפיין default_audio_language מציין את השפה המדוברת ברצועת האודיו שמוגדרת כברירת מחדל בסרטון.
contentDetails object
האובייקט contentDetails מכיל מידע על תוכן הסרטון, כולל משך הסרטון והערה לגבי זמינות הכתוביות בסרטון.
contentDetails.duration string
אורך הסרטון. ערך המאפיין הוא משך זמן לפי תקן ISO 8601. לדוגמה, בסרטון באורך של דקה אחת לפחות ופחות משעה, משך הזמן מוצג בפורמט PT#M#S, שבו האותיות PT מציינות שהערך מציין פרק זמן, והאותיות M ו-S מתייחסות לאורך הסרטון בדקות ובשניות, בהתאמה. התווים # שמופיעים לפני האותיות M ו-S הם מספרים שלמים שמציינים את מספר הדקות (או השניות) של הסרטון. לדוגמה, ערך של PT15M33S מציין שהסרטון הוא 15 דקות ו-33 שניות.

אם הסרטון נמשך שעה אחת לפחות, משך הזמן מצוין בפורמט PT#H#M#S, כאשר המספר # שמופיע לפני האות H מציין את משך הסרטון בשעות, וכל שאר הפרטים זהים כפי שמתואר למעלה. אם הסרטון נמשך לפחות יום אחד, האותיות P ו-T מופרדות והפורמט של הערך הוא P#DT#H#M#S. פרטים מלאים זמינים במפרט ISO 8601.
contentDetails.dimension string
מציין אם הסרטון זמין בתלת-ממד או בדו-ממד.
contentDetails.definition string
מציין אם הסרטון זמין באיכות גבוהה (HD) או רק באיכות רגילה.

הערכים התקפים של המאפיין הזה הם:
  • hd
  • sd
contentDetails.caption string
מציין אם יש כתוביות לסרטון.

הערכים החוקיים לנכס הזה הם:
  • false
  • true
contentDetails.licensedContent boolean
מציין אם הסרטון מייצג תוכן ברישיון. כלומר, התוכן הועלה לערוץ שמקושר לשותף תוכן של YouTube, והשותף הזה הצהיר על זכויות יוצרים לגביו.
contentDetails.regionRestriction object
האובייקט regionRestriction מכיל מידע על המדינות שבהן אפשר לצפות בסרטון (או שלא). האובייקט יכיל את המאפיין contentDetails.regionRestriction.allowed או את המאפיין contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
רשימה של קודי אזורים שמזהים את המדינות שבהן אפשר לצפות בסרטון. אם המאפיין הזה קיים ומדינה מסוימת לא רשומה בערך שלו, הסרטון ייחסם ולא יוצג במדינה הזו. אם המאפיין הזה קיים ומכיל רשימה ריקה, הסרטון ייחסם בכל המדינות.
contentDetails.regionRestriction.blocked[] list
רשימה של קודי אזורים שמזהים מדינות שבהן הסרטון חסום. אם המאפיין הזה קיים ומדינה מסוימת לא רשומה בערך שלו, המשמעות היא שאפשר לצפות בסרטון במדינה הזו. אם המאפיין הזה קיים ומכיל רשימה ריקה, הסרטון יהיה גלוי בכל המדינות.
contentDetails.contentRating object
מציין את הדירוגים שהסרטון קיבל לפי שיטות דירוג שונות.
contentDetails.contentRating.acbRating string
הדירוג של המועצה האוסטרלית לסיווג (ACB) של הסרטון או הרשות האוסטרלית לתקשורת ומדיה (ACMA). דירוגים של ACMA משמשים לסיווג תוכניות טלוויזיה לילדים.

הערכים החוקיים למאפיין הזה הם:
  • acbC – תוכניות שקיבלו סיווג C על ידי הרשות האוסטרלית לתקשורת ומדיה. התוכניות האלה מיועדות לילדים (לא לילדים בגילאי הגן) מתחת לגיל 14.
  • acbE – E
  • acbG – G
  • acbM – M
  • acbMa15plus – MA15+‎
  • acbP – תוכניות שקיבלו סיווג P מהרשות האוסטרלית לתקשורת ומדיה. התוכניות האלה מיועדות לילדים בגילאי הגן.
  • acbPg – PG
  • acbR18plus – R18+‎
  • acbUnrated
contentDetails.contentRating.agcomRating string
דירוג הסרטון מ-Autorità לפי le Garanzie nelle Comunicazioni (AGCOM).

הערכים החוקיים לנכס הזה הם:
  • agcomT – טון
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
דירוג Anatel (Asociación Nacional de Televisión) של הסרטון בטלוויזיה בצ'ילה.

הערכים החוקיים לנכס הזה הם:
  • anatelA עד A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR עד R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
הסיווג של הסרטון על ידי המועצה הבריטית לסיווג סרטים (BBFC).

הערכים התקפים למאפיין הזה הם:
  • bbfc12 – 12
  • bbfc12a עד 12A
  • bbfc15 עד 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU עד U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
דירוג הסרטון על ידי מועצת צנזור הווידאו והקול בתאילנד.

הערכים החוקיים לנכס הזה הם:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
הדירוג של הסרטון על ידי ועדת הסיווג של המדיה באוסטריה (Bundesministerium für Unterricht, Kunst und Kultur).

הערכים התקפים למאפיין הזה הם:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 - 14 ומעלה
  • bmukk16 – מגיל 16 ומעלה
  • bmukk6 – 6+
  • bmukk8 - 8 ומעלה
  • bmukkAa – ללא הגבלה
  • bmukkUnrated
contentDetails.contentRating.catvRating string
מערכת סיווג לטלוויזיה בקנדה – מערכת סיווג הטלוויזיה בקנדה. דירוג הסרטון של ועדת הרדיו, הטלוויזיה והטלקומוניקציות בקנדה (CRTC) לשידורים בקנדה בשפה האנגלית. מידע נוסף זמין באתר של Canadian Broadcast Standards Council.

הערכים התקינים של המאפיין הזה הם:
  • catv14plus – מגיל 14 ומעלה
  • catv18plus – מעל גיל 18
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
הסיווג של הסרטון מטעם Canadian Radio-Television and Telecommunications Commission ‏(CRTC) לשידורים בקנדה בשפה הצרפתית. מידע נוסף זמין באתר של Canadian Broadcast Standards Council.

הערכים התקינים של המאפיין הזה הם:
  • catvfr13plus - 13 ומעלה
  • catvfr16plus – מגיל 16 ומעלה
  • catvfr18plus – מעל גיל 18
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
הדירוג של המועצה המרכזית לאישור סרטים (Central Board of Film Certification) (CBFC – הודו) של הסרטון.

הערכים החוקיים לנכס הזה הם:
  • cbfcA עד A
  • cbfcS – דר'
  • cbfcU עד U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
דירוג Consejo de Calificación Cinematográfica (צ'ילה) של הסרטון.

הערכים החוקיים לנכס הזה הם:
  • ccc14 – מגיל 14 ומעלה
  • ccc18 - 18 ומעלה
  • ccc18s – 18 ומעלה – contenido pornográfico
  • ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – משימות לביצוע
  • cccUnrated
contentDetails.contentRating.cceRating string
הדירוג של הסרטון של הוועדה לסווג סרטים (Comissão de Classificação de Espect´culos) בפורטוגל.

הערכים התקפים למאפיין הזה הם:
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 עד 16
  • cceM18 – 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
הדירוג של הסרטון בשווייץ.

הערכים החוקיים לנכס הזה הם:
  • 0-chfilm0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
הדירוג של הסרטון במערכת הסיווג של סרטונים ביתיים בקנדה (CHVRS).

הערכים התקינים למאפיין הזה הם:
  • chvrs14a – 14A
  • chvrs18a עד 18A
  • chvrsE עד מז'
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
דירוג הסרטון מאת Commission de Contrôle des Films (בלגיה).

הערכים החוקיים לנכס הזה הם:
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – ק"ט/יחידה
  • cicfUnrated
contentDetails.contentRating.cnaRating string
דירוג הסרטון מ-CONSILIUL NATIONAL AL AUDIOVIZUALULUI ברומניה.

הערכים החוקיים לנכס הזה הם:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – מעל גיל 18
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
מערכת הסיווג בצרפת – נציבות הסיווג של הקולנוע ב-Cinetographique

הערכים החוקיים לנכס הזה הם:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – טון
  • cncUnrated
contentDetails.contentRating.csaRating string
הדירוג של הסרטון על ידי Conseil supérieur de l'audiovisuel (המועצה העליונה לטלוויזיה ולרדיו) בצרפת, שמדרגת תוכן שידור.

הערכים התקפים למאפיין הזה הם:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 עד 18
  • csaInterdiction – חסימת נתונים
  • csaT – טון
  • csaUnrated
contentDetails.contentRating.cscfRating string
דירוג הסרטון על ידי Commission de surveillance de la category des Films (CSCF) של לוקסמבורג.

הערכים החוקיים לנכס הזה הם:
  • cscf12 עד 12
  • cscf16 עד 16
  • cscf18 – 18
  • cscf6 עד 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
הדירוג של הסרטון בצ'כיה.

הערכים התקינים למאפיין הזה הם:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
הדירוג של הסרטון לפי Departamento de Justiça, Classificação, Qualificação e Títulos‏ (DJCQT – ברזיל).

הערכים התקפים של המאפיין הזה הם:
  • 10-djctq10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL עד L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
הסיבות לכך שהסרטון קיבל את הדירוג שלו ב-DJCQT (ברזיל).
contentDetails.contentRating.ecbmctRating string
מערכת דירוג בטורקיה – מועצת ההערכה והסיווג של משרד התרבות והתיירות

הערכים התקינים של המאפיין הזה הם:
  • ecbmct13a עד 13A
  • ecbmct13plus – 13 ומעלה
  • ecbmct15a עד 15A
  • ecbmct15plus – 15 ומעלה
  • ecbmct18plus – מעל גיל 18
  • ecbmct7a – 7A
  • ecbmct7plus - 7 ומעלה
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a עד 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – מגיל 16 ומעלה
contentDetails.contentRating.eefilmRating string
הדירוג של הסרטון באסטוניה.

הערכים התקינים למאפיין הזה הם:
  • eefilmK12 - K-12
  • eefilmK14 – K-14
  • eefilmK16 – K-16
  • eefilmK6 – גן ילדים עד כיתה ו'
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
הדירוג של הסרטון במצרים.

הערכים החוקיים למאפיין הזה הם:
  • egfilm18 עד 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
הדירוג של הסרטון לפי Eirin‏ (映倫). Eirin הוא מערכת הסיווג ביפן.

הערכים החוקיים למאפיין הזה הם:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+‎
  • eirinR18plus - R18 ומעלה
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
הדירוג של הסרטון על ידי מועצת הצנזורה של מלזיה.

הערכים התקינים לנכס הזה הם:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa עד 18:00
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 עד P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
הסיווג של הסרטון על ידי המשרד לניהול סרטים, עיתונים ומאמרים בהונג קונג.

הערכים התקפים למאפיין הזה הם:
  • fcoI – I
  • fcoIi עד II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
הנכס הזה יצא משימוש ב-2 בנובמבר 2015. במקום זאת, יש להשתמש במאפיין contentDetails.contentRating.cncRating.

דירוג הסרטון של Centre national du cinéma et de l'image animé (משרד התרבות הצרפתי).

הערכים החוקיים של המאפיין הזה הם:
  • 10-fmoc10
  • fmoc12 עד 12
  • fmoc16 עד 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
הסיווג של הסרטון על ידי Film and Publication Board (הרשות לקולנוע ולפרסום) בדרום אפריקה.

הערכים החוקיים למאפיין הזה הם:
  • 10-fpb10
  • fpb1012Pg – 10-12PG
  • fpb13 עד 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA עד A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
סיבות שמסבירות למה הסרטון קיבל את הדירוג שלו ב-FPB (דרום אפריקה).
contentDetails.contentRating.fskRating string
הסיווג של הסרטון לפי Freiwillige Selbstkontrolle der Filmwirtschaft‏ (FSK – גרמניה).

הערכים החוקיים למאפיין הזה הם:
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
דירוג הסרטון ביוון.

הערכים החוקיים לנכס הזה הם:
  • grfilmE עד מז'
  • grfilmK - K
  • grfilmK12 – K-12
  • grfilmK13 - K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
הדירוג של הסרטון לפי Instituto de la Cinematografía y de las Artes Audiovisuales‏ (ICAA – ספרד).

הערכים התקפים למאפיין הזה הם:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 עד 16
  • icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
הסיווג של הסרטון על ידי Irish Film Classification Office‏ (IFCO – אירלנד). מידע נוסף זמין באתר IFCO.

הערכים החוקיים לנכס הזה הם:
  • ifco12 – 12
  • ifco12a – 12A
  • ifco15 עד 15
  • ifco15a עד 15A
  • ifco16 – 16
  • ifco18 – 18
  • ifcoG – G
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
הדירוג של הסרטון בישראל.

הערכים החוקיים למאפיין הזה הם:
  • ilfilm12 עד 12
  • ilfilm16 עד 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
הדירוג INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) של הסרטון.

הערכים החוקיים לנכס הזה הם:
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (Solo apta para mayores de 18 años, de exhibición condicionada)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (Solo apta para Mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
הדירוג של הסרטון על ידי ועדת הסיווג של סרטים בקניה.

הערכים התקפים למאפיין הזה הם:
  • kfcb16plus עד 16
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR – 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (הולנד).

הערכים התקפים לנכס הזה הם:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
הדירוג של הסרטון על ידי Korea Media Rating Board‏ (영상물등급위원회). ה-KMRB מסווג סרטונים בדרום קוריאה.

הערכים החוקיים למאפיין הזה הם:
  • kmrb12plus – 12愸 אורך 惁
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – כולל ילדים
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
דירוג הסרטון מחיישן Lembaga באינדונזיה.

הערכים החוקיים לנכס הזה הם:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA עד A
  • lsfBo – BO
  • lsfD עד י'
  • lsfR עד R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
דירוג הסרטון מוועדת סיווג הגיל של הסרטים במלטה.

הערכים החוקיים לנכס הזה הם:
  • mccaa12 – 12
  • mccaa12a עד 12A
  • mccaa14 – 14 – הדירוג הזה הוסר ממבנה הסיווג החדש שהוצג בשנת 2013.
  • mccaa15 עד 15
  • mccaa16 – 16 – הדירוג הזה הוסר ממבנה הסיווג החדש שהוצג בשנת 2013.
  • mccaa18 עד 18
  • mccaaPg – PG
  • mccaaU עד U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
הסיווג של הסרטון על ידי מועצת המדיה של ילדים ובני נוער של מכון הקולנוע הדני (Det Danske Filminstitut).

הערכים התקפים של המאפיין הזה הם:
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
מערכת הסיווג של הסרטון בווייטנאם – MCST

הערכים החוקיים לנכס הזה הם:
  • 0-mcst0
  • mcst16plus - 16 ומעלה
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK - K
contentDetails.contentRating.mdaRating string
הדירוג של הסרטון מטעם רשות הפיתוח של המדיה (MDA) בסינגפור, ובפרט מטעם מועצת הצנזורה של הסרטים (BFC).

הערכים התקפים למאפיין הזה הם:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
הסיווג של הסרטון על ידי Medietilsynet, הרשות הנורווגית לענייני מדיה.

הערכים החוקיים למאפיין הזה הם:
  • medietilsynet11 – 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 עד 18
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
דירוג הסרטון מטעם Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) בפינלנד).

הערכים החוקיים לנכס הזה הם:
  • meku12 עד 12
  • meku16 עד 16
  • meku18 – 18
  • 7-meku7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
הדירוג של הסרטון לפי Ministero dei Beni e delle Attività Culturali e del Turismo (איטליה).

הערכים התקפים למאפיין הזה הם:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
הדירוג של הסרטון על ידי Ministerio de Cultura (קולומביה).

הערכים התקינים למאפיין הזה הם:
  • moc12 – 12
  • moc15 – 15
  • moc18 עד 18
  • moc7 – 7
  • mocBanned – אסור
  • mocE עד מז'
  • mocT – טון
  • mocUnrated
  • mocX עד X
contentDetails.contentRating.moctwRating string
הדירוג של הסרטון לפי משרד התרבות של טייוואן (文化部).

הערכים התקינים למאפיין הזה הם:
  • moctwG עד G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
הסיווג של הסרטון לפי Motion Picture Association of America‏ (MPAA).

הערכים החוקיים למאפיין הזה הם:
  • mpaaG – G
  • mpaaNc17 – הצפייה מתחת לגיל 17 אסורה
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
הסיווג של Motion Picture Association of America (איגוד הסרטים של אמריקה) לטריילרים ולקטעים מקדימים של סרטים.

הערכים החוקיים למאפיין הזה הם:
  • mpaatGb – GB (רצועת ירוק – תוכן שאושר לכל הקהלים)
  • mpaatRb – RB (Red Band – מומלץ לגילאי 17 ומעלה)
contentDetails.contentRating.mtrcbRating string
דירוג הסרטון מוועדת הביקורת והסיווג של סרטים וטלוויזיה (הפיליפינים).

הערכים החוקיים לנכס הזה הם:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX עד X
contentDetails.contentRating.nbcRating string
דירוג הסרטון של המשרד הלאומי לסיווג בסרי לנקה.

הערכים החוקיים למאפיין הזה הם:
  • nbc12plus – 12+
  • nbc15plus – 15 ומעלה
  • nbc18plus – מעל גיל 18
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
הדירוג של הסרטון מ-Bulgarian National Film Center.

הערכים התקפים למאפיין הזה הם:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX עד X
contentDetails.contentRating.nfvcbRating string
הדירוג של הסרטון על ידי המועצה הלאומית של ניגריה לבקרת סרטים ווידאו.

הערכים התקפים למאפיין הזה הם:
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
הסיווג של הסרטון לפי Nacionãlais Kino centrs (המרכז הלאומי לקולנוע בלטביה).

הערכים התקפים למאפיין הזה הם:
  • nkclv12plus – 12+
  • nkclv18plus – מעל גיל 18
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
הדירוג של המשרד לסיווג סרטים וספרות של הסרטון (OFLC – ניו זילנד).

הערכים החוקיים לנכס הזה הם:
  • oflcG – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13 עד R13
  • oflcR15 עד R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
דירוג הסרטון בפרו.

הערכים החוקיים לנכס הזה הם:
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg – PG
  • pefilmPt עד PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
דירוג הסרטון בוונצואלה.

הערכים החוקיים לנכס הזה הם:
  • resorteviolenciaA – A
  • BresorteviolenciaB
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
הדירוג של הסרטון לפי המנהל הכללי של רדיו, טלוויזיה וקולנוע (מקסיקו).

הערכים התקפים למאפיין הזה הם:
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC - C
  • rtcD עד י'
  • rtcUnrated
contentDetails.contentRating.rteRating string
דירוג הסרטון מטעם Raidió Teilifís Éireann שבאירלנד.

הערכים החוקיים לנכס הזה הם:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
הדירוג של הסרטון במרשם הסרטים הלאומי של הפדרציה הרוסית (MKRF – רוסיה).

הערכים התקינים למאפיין הזה הם:
  • russia0 - 0+
  • russia12 – 12+
  • russia16 - 16 ומעלה
  • russia18 – מעל גיל 18
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
הדירוג של הסרטון בסלובקיה.

הערכים התקינים למאפיין הזה הם:
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
הדירוג של הסרטון באיסלנד.

הערכים התקינים למאפיין הזה הם:
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • 7-smais7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
הדירוג של הסרטון מ-Statens medieråd (מועצת המדיה הלאומית של שוודיה).

הערכים התקפים למאפיין הזה הם:
  • 11-smsa11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – כל הגילאים
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
הסיווג של הסרטון בהתאם להנחיות ה-TVPG (הנחיות להורים בנוגע לתוכניות טלוויזיה).

הערכים החוקיים למאפיין הזה הם:
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-PG
  • tvpgUnrated
  • tvpgY – TV-Y
  • tvpgY7 – TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 – TV-14
contentDetails.contentRating.ytRating string
סיווג שמשמש את YouTube לזיהוי תוכן עם הגבלת גיל.

הערכים התקפים למאפיין הזה הם:
  • ytAgeRestricted
contentDetails.projection string
מציין את פורמט הקרנה של הסרטון.

הערכים התקינים למאפיין הזה הם:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
מציין אם מעלה הסרטון סיפק תמונה ממוזערת מותאמת אישית לסרטון. הנכס הזה גלוי רק למעלה הסרטון.
status object
האובייקט status מכיל מידע על סטטוס ההעלאה, העיבוד והפרטיות של הסרטון.
status.uploadStatus string
הסטטוס של הסרטון שהועלו.

הערכים התקינים למאפיין הזה הם:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
הערך הזה מסביר למה ההעלאה של הסרטון נכשלה. המאפיין הזה מופיע רק אם המאפיין uploadStatus מציין שההעלאה נכשלה.

הערכים החוקיים למאפיין הזה הם:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
הערך הזה מסביר למה YouTube דחה סרטון שהעליתם. המאפיין הזה מופיע רק אם המאפיין uploadStatus מציין שההעלאה נדחתה.

הערכים החוקיים למאפיין הזה הם:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
סטטוס הפרטיות של הסרטון.

הערכים החוקיים לנכס הזה הם:
  • private
  • public
  • unlisted
status.publishAt datetime
התאריך והשעה שבהם הסרטון מתוזמן לפרסום. אפשר להגדיר אותו רק אם סטטוס הפרטיות של הסרטון הוא 'פרטי'. הערך מצוין בפורמט ISO 8601. חשוב לשים לב לשני הדברים הבאים לגבי ההתנהגות של המאפיין הזה:
  • אם מגדירים את ערך המאפיין הזה כשקוראים לשיטה videos.update, צריך להגדיר גם את ערך הנכס status.privacyStatus כ-private, גם אם הסרטון כבר פרטי.
  • אם הבקשה שלכם מתזמנת פרסום של סרטון במועד כלשהו בעבר, הסרטון יפורסם מיד. לכן, ההשפעה של הגדרת המאפיין status.publishAt לתאריך ולשעה קודמים זהה לשינוי privacyStatus של הסרטון מ-private ל-public.
status.license string
הרישיון של הסרטון.

הערכים התקינים למאפיין הזה הם:
  • creativeCommon
  • youtube
status.embeddable boolean
הערך הזה מציין אם ניתן יהיה להטמיע את הסרטון באתר אחר.
status.publicStatsViewable boolean
הערך הזה מציין אם הנתונים הסטטיסטיים המורחבים של הסרטון בדף הצפייה שלו גלויים לכולם. כברירת מחדל, הנתונים הסטטיסטיים האלה ניתנים לצפייה, ונתונים סטטיסטיים כמו מספר הצפיות והדירוגים של הסרטון עדיין יהיו גלויים לכולם גם אם ערך הנכס הזה מוגדר ל-false.
status.madeForKids boolean
הערך הזה מציין אם הסרטון מיועד לילדים, והוא מכיל את סטטוס 'במיוחד לילדים' הנוכחי של הסרטון. לדוגמה, הסטטוס יכול להיקבע על סמך הערך של המאפיין selfDeclaredMadeForKids. במרכז העזרה של YouTube תוכלו למצוא מידע נוסף על הגדרת הקהל של הערוץ, הסרטונים או השידורים שלכם.
status.selfDeclaredMadeForKids boolean
בבקשה מסוג videos.insert או videos.update, הנכס הזה מאפשר לבעלי הערוץ לציין שהסרטון מיועד לילדים. בבקשה מסוג videos.list, ערך הנכס מוחזר רק אם בעלי הערוץ אישר את בקשת ה-API.
status.containsSyntheticMedia boolean
בבקשה של videos.insert או videos.update, הנכס הזה מאפשר לבעל הערוץ לחשוף שהסרטון מכיל תוכן ריאליסטי ששונה או סינתטי (A/S). מידע נוסף על כללי המדיניות של YouTube שקשורים לתוכן A/S

דוגמאות לתוכן שמכיל קריאה לפעולה כוללות סרטונים שבהם:
  • ליצור תוכן שבו נראה אדם אמיתי שאומר או עושה משהו שהוא לא באמת אמר או עשה
  • בתוכן נעשה שינוי בחומר מצולם של אירוע או מקום אמיתיים
  • יצירת סצנה שנראית אמיתית אבל לא התרחשה באמת
statistics object
האובייקט statistics מכיל נתונים סטטיסטיים על הסרטון.
statistics.viewCount unsigned long
מספר הפעמים שאנשים צפו בסרטון.
statistics.likeCount unsigned long
מספר המשתמשים שציינו שהם אהבו את הסרטון.
statistics.dislikeCount unsigned long
הערה: הנכס statistics.dislikeCount הוגדר כפרטי ב-13 בדצמבר 2021. המשמעות היא שהנכס נכלל בתשובה של API רק אם בקשת ה-API אומתה על ידי בעל הסרטון. מידע נוסף זמין במאמר היסטוריית הגרסאות.

מספר המשתמשים שציינו שהם לא אהבו את הסרטון.
statistics.favoriteCount unsigned long
הערה: הנכס הזה הוצא משימוש. ההוצאה משימוש תיכנס לתוקף ב-28 באוגוסט 2015. עכשיו ערך הנכס תמיד מוגדר כ-0.
statistics.commentCount unsigned long
מספר התגובות לסרטון.
paidProductPlacementDetails object
האובייקט paidProductPlacementDetails מכיל מידע על שילוב מוצר בתשלום בסרטון.
paidProductPlacementDetails.hasPaidProductPlacement boolean
מגדירים את הערך true אם התוכן כולל שילוב מוצר בתשלום. ברירת המחדל היא false.
player object
האובייקט player מכיל מידע שמשמש להפעלת הסרטון בנגן מוטמע.
player.embedHtml string
תג <iframe> שמטמיע נגן שמפעיל את הסרטון.
  • אם בבקשת ה-API לאחזור המשאב צוין ערך לפרמטר maxHeight ו/או maxWidth, הגודל של הנגן המוטמע יותאם כך שיציג את הווידאו בהתאם לדרישות של maxHeight ו/או maxWidth.
  • אם יחס הגובה-רוחב של הסרטון לא ידוע, ברירת המחדל של הנגן המוטמע היא פורמט 4:3.
player.embedHeight long
הגובה של הנגן המוטמע שמוחזר במאפיין player.embedHtml. המאפיין הזה מוחזר רק אם בבקשה צוין ערך לפרמטרים maxHeight או maxWidth ויחס הגובה-רוחב של הסרטון ידוע.
player.embedWidth long
הרוחב של הנגן המוטמע שמוחזר בנכס player.embedHtml. המערכת מחזירה את המאפיין הזה רק אם בבקשה צוין ערך לפרמטר maxHeight ו/או לפרמטר maxWidth, ויחס הגובה-רוחב של הסרטון ידוע.
topicDetails object
האובייקט topicDetails מכיל מידע על הנושאים שמשויכים לסרטון.

חשוב: פרטים נוספים על השינויים הצפויים שקשורים למזהי נושאים מופיעים בהגדרות של המאפיינים topicDetails.relevantTopicIds[] ו-topicDetails.topicIds[], וגם בהיסטוריית הגרסאות.
topicDetails.topicIds[] list
חשוב: המאפיין הזה הוצא משימוש החל מ-10 בנובמבר 2016. ה-API לא מחזיר יותר ערכים לנכס הזה, וכל הנושאים שמשויכים לסרטון מוחזרים עכשיו באמצעות ערך הנכס topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
רשימה של מזהי נושאים שרלוונטיים לסרטון.

הנכס הזה הוצא משימוש החל מ-10 בנובמבר 2016. התמיכה בה תהיה זמינה עד 10 בנובמבר 2017.

חשוב: עקב ההוצאה משימוש של Freebase ו-Freebase API, החל מ-27 בפברואר 2017 מזהי נושאים התחילו לפעול בצורה שונה. באותו זמן, YouTube התחיל להחזיר קבוצה קטנה של מזהים של נושאים שנבחרו בקפידה.

topicDetails.topicCategories[] list
רשימת כתובות URL בוויקיפדיה שמספקות תיאור ברמה גבוהה של תוכן הסרטון.
recordingDetails object
האובייקט recordingDetails מכיל מידע על המיקום, התאריך והכתובת שבהם צולם הסרטון.
recordingDetails.locationDescription string
המאפיין הזה הוצא משימוש ב-1 ביוני 2017. לפרטים נוספים אפשר לעיין בהודעה על הוצאה משימוש.

טקסט התיאור של המיקום שבו צולם הסרטון.
recordingDetails.location object
נתוני המיקום הגיאוגרפי שמשויך לסרטון. שימו לב שערכים של נכסי הצאצאים מזהים את המיקום שבעלי הסרטון רוצים לשייך לסרטון. אפשר לערוך את הערך, לחפש אותו בסרטונים גלויים לכולם, ויכול להיות שהוא יוצג למשתמשים בסרטונים גלויים לכולם.
recordingDetails.location.latitude double
המאפיין הזה הוצא משימוש ב-1 ביוני 2017. פרטים נוספים זמינים בהודעה על ההוצאה משימוש.

קו הרוחב במעלות.
recordingDetails.location.longitude double
הנכס הזה יצא משימוש ב-1 ביוני 2017. לפרטים נוספים אפשר לעיין בהודעה על הוצאה משימוש.

קו האורך במעלות.
recordingDetails.location.altitude double
הנכס הזה יצא משימוש ב-9 ביולי 2018. פרטים נוספים זמינים בהודעה על ההוצאה משימוש.

הגובה מעל אליפסואיד העזר, במטרים.
recordingDetails.recordingDate datetime
התאריך והשעה שבהם הסרטון צולם. הערך מצוין בפורמט ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
האובייקט fileDetails מכיל מידע על קובץ הווידאו שהועלה ל-YouTube, כולל הרזולוציה, משך הזמן, קודיקים של אודיו ווידאו, קצב העברת הנתונים של הסטרימינג ועוד. רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה.

האובייקט fileDetails יוחזר רק אם הערך של המאפיין processingDetails.fileAvailability הוא available.
fileDetails.fileName string
שם הקובץ שהועלה. השדה הזה מופיע גם אם העליתם קובץ וידאו וגם אם העליתם קובץ מסוג אחר.
fileDetails.fileSize unsigned long
גודל הקובץ שהועלה, בבייטים. השדה הזה מופיע גם אם העליתם קובץ וידאו וגם אם העליתם קובץ מסוג אחר.
fileDetails.fileType string
סוג הקובץ שהועלה, כפי שזוהה על ידי מנוע עיבוד הווידאו של YouTube. בשלב זה, מערכת YouTube מעבדת רק קובצי וידאו, אבל השדה הזה מופיע גם אם העליתם קובץ וידאו וגם אם העליתם קובץ מסוג אחר.

הערכים התקינים של המאפיין הזה הם:
  • archive – הקובץ הוא קובץ ארכיון, כמו קובץ ZIP.
  • audio – הקובץ הוא מסוג ידוע של קובץ אודיו, כמו קובץ mp3.
  • document – הקובץ הוא מסמך או קובץ טקסט, כמו מסמך של MS Word.
  • image – הקובץ הוא קובץ תמונה, כמו קובץ ‎.jpeg.
  • other – הקובץ הוא מסוג אחר שאינו וידאו.
  • project – הקובץ הוא קובץ של פרויקט וידאו, למשל פרויקט של Microsoft Windows Movie Maker, שלא מכיל את נתוני הווידאו בפועל.
  • video – הקובץ הוא קובץ וידאו ידוע, כמו קובץ ‎.mp4.
fileDetails.container string
פורמט הגורם המכיל של קובץ הווידאו שהעליתם.
fileDetails.videoStreams[] list
רשימה של שידורי וידאו שנכללים בקובץ הווידאו שהועלה. כל פריט ברשימה מכיל מטא-נתונים מפורטים על סטרימינג של וידאו.
fileDetails.videoStreams[].widthPixels unsigned integer
הרוחב של תוכן הווידאו המקודד בפיקסלים. אפשר לחשב את יחס הגובה-רוחב של קידוד הסרטון כ-width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
הגובה בפיקסלים של תוכן הווידאו המקודד.
fileDetails.videoStreams[].frameRateFps double
קצב הפריימים של הווידאו בסטרימינג, ביחידות של פריימים לשנייה.
fileDetails.videoStreams[].aspectRatio double
יחס גובה-רוחב לתצוגה של תוכן הסרטון, שמציין את יחס הגובה-רוחב שבו הסרטון יוצג.
fileDetails.videoStreams[].codec string
קודק הווידאו שבו נעשה שימוש בשידור.
fileDetails.videoStreams[].bitrateBps unsigned long
קצב העברת הנתונים של שידור הווידאו, בביטים לשנייה.
fileDetails.videoStreams[].rotation string
מידת הסיבוב ש-YouTube צריך לבצע בתוכן המקור המקורי כדי להציג את הסרטון בצורה תקינה.

הערכים התקינים של המאפיין הזה הם:
  • clockwise – צריך לסובב את הסרטון ב-90 מעלות בכיוון השעון.
  • counterClockwise – צריך לסובב את הסרטון ב-90 מעלות נגד כיוון השעון.
  • none – אין צורך לסובב את הסרטון.
  • other – צריך לסובב את הסרטון בדרך אחרת, לא טריוויאלית.
  • upsideDown – צריך לסובב את הסרטון הפוך.
fileDetails.videoStreams[].vendor string
ערך שמזהה באופן ייחודי ספק סרטונים. בדרך כלל, הערך הוא קוד ספק בן ארבע אותיות.
fileDetails.audioStreams[] list
רשימה של שידורי אודיו שנכללים בקובץ הווידאו שהועלה. כל פריט ברשימה מכיל מטא-נתונים מפורטים על סטרימינג של אודיו.
fileDetails.audioStreams[].channelCount unsigned integer
מספר ערוצי האודיו שהשידור מכיל.
fileDetails.audioStreams[].codec string
קודק האודיו שבו נעשה שימוש בשידור.
fileDetails.audioStreams[].bitrateBps unsigned long
קצב העברת הנתונים של שידור האודיו, בסיביות לשנייה.
fileDetails.audioStreams[].vendor string
ערך שמזהה באופן ייחודי ספק סרטונים. בדרך כלל, הערך הוא קוד ספק בן ארבע אותיות.
fileDetails.durationMs unsigned long
אורך הסרטון שהועלה באלפיות שנייה.
fileDetails.bitrateBps unsigned long
קצב העברת הנתונים המשולב (סיביות) לשנייה של קובץ הסרטון שהועלה (וידאו ואודיו).
fileDetails.creationTime string
התאריך והשעה שבהם נוצר קובץ הסרטון שהועלה. הערך מצוין בפורמט ISO 8601. נכון לעכשיו, הפורמטים הבאים נתמכים לפי תקן ISO 8601:
  • תאריך בלבד: YYYY-MM-DD
  • זמן פשוט: YYYY-MM-DDTHH:MM:SS
  • זמן עם אזור זמן: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
האובייקט processingDetails כולל מידע על ההתקדמות של YouTube בעיבוד קובץ הסרטון שהועלה. המאפיינים באובייקט מזהים את סטטוס העיבוד הנוכחי ואת ההערכה לזמן שנותר עד ש-YouTube יסיים לעבד את הסרטון. החלק הזה מציין גם אם סוגים שונים של נתונים או תוכן זמינים לסרטון, כמו פרטי קובץ או תמונות ממוזערות.

האובייקט processingProgress מיועד לסקרים, כדי שאפשר יהיה לעקוב אחרי ההתקדמות של YouTube בעיבוד קובץ הווידאו שהועלה. רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה.
processingDetails.processingStatus string
סטטוס העיבוד של הסרטון. הערך הזה מציין אם מערכת YouTube הצליחה לעבד את הסרטון, או אם הסרטון עדיין בתהליך עיבוד.

הערכים החוקיים לנכס הזה הם:
  • failed – עיבוד הסרטון נכשל. מידע נוסף זמין במאמר ProcessingFailureReason.
  • processing – הסרטון בתהליך עיבוד. ראו ProcessingProgress.
  • succeeded – עיבוד הסרטון הסתיים.
  • terminated – פרטי העיבוד לא זמינים יותר.
processingDetails.processingProgress object
האובייקט processingProgress מכיל מידע על ההתקדמות של YouTube בעיבוד הסרטון. הערכים רלוונטיים רק אם סטטוס העיבוד של הסרטון הוא processing.
processingDetails.processingProgress.partsTotal unsigned long
אומדן של המספר הכולל של החלקים שצריך לעבד עבור הסרטון. יכול להיות שהמספר יתעדכן באומדנים מדויקים יותר בזמן שמערכת YouTube מעבדת את הסרטון.
processingDetails.processingProgress.partsProcessed unsigned long
מספר החלקים בסרטון שכבר עברו עיבוד ב-YouTube. כדי להעריך את אחוז הסרטון שמערכת YouTube כבר עיבדה, אפשר לחשב את הנוסחה הבאה:
100 * parts_processed / parts_total

הערה: מאחר שמספר החלקים המשוער עשוי לעלות בלי עלייה תואמת במספר החלקים שכבר עברו עיבוד, ייתכן שההתקדמות המחושבת תקטן מדי פעם בזמן שמערכת YouTube מעבדת את הסרטון.
processingDetails.processingProgress.timeLeftMs unsigned long
אומדן של משך הזמן, במילי-שניות, שיידרש ל-YouTube כדי לסיים את העיבוד של הסרטון.
processingDetails.processingFailureReason string
הסיבה לכך שהמערכת של YouTube לא הצליחה לעבד את הסרטון. למאפיין הזה יהיה ערך רק אם הערך של המאפיין processingStatus הוא failed.

הערכים החוקיים לנכס הזה הם:
  • other – רכיב עיבוד אחר נכשל.
  • streamingFailed – לא ניתן היה לשלוח את הסרטון לסטרימרים.
  • transcodeFailed – המרת הקידוד של התוכן נכשלה.
  • uploadFailed – שליחת הקובץ נכשלה.
processingDetails.fileDetailsAvailability string
הערך הזה מציין אם פרטי הקובץ זמינים עבור הסרטון שהועלו. כדי לאחזר את פרטי הקובץ של סרטון, יש לבקש את החלק fileDetails בבקשת videos.list().
processingDetails.processingIssuesAvailability string
הערך הזה מציין אם מנוע עיבוד הסרטונים יצר הצעות שעשויות לשפר את היכולת של YouTube לעבד את הסרטון, אזהרות שמסבירות בעיות בעיבוד הסרטון או שגיאות שגורמות לבעיות בעיבוד הסרטון. כדי לאחזר את ההצעות האלה, צריך לבקש את החלק suggestions בבקשה videos.list().
processingDetails.tagSuggestionsAvailability string
הערך הזה מציין אם יש הצעות למילות מפתח (תגים) עבור הסרטון. אפשר להוסיף תגים למטא-נתונים של סרטון כדי למשתמשים אחרים יהיה קל יותר למצוא אותו. כדי לאחזר את ההצעות האלה, צריך לבקש את החלק suggestions בבקשה videos.list().
processingDetails.editorSuggestionsAvailability string
הערך הזה מציין אם יש הצעות לעריכת הסרטון שעשויות לשפר את איכות הסרטון או את חוויית ההפעלה. כדי לאחזר את ההצעות האלה, אפשר לבקש את החלק suggestions בבקשת videos.list().
processingDetails.thumbnailsAvailability string
הערך הזה מציין אם נוצרו תמונות ממוזערות לסרטון.
suggestions object
האובייקט suggestions כולל הצעות לזיהוי הזדמנויות לשיפור איכות הסרטון או המטא-נתונים של הסרטון שהועלה. רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה.

האובייקט suggestions יוחזר רק אם הערך של המאפיין processingDetails.tagSuggestionsAvailability או המאפיין processingDetails.editorSuggestionsAvailability הוא available.
suggestions.processingErrors[] list
רשימה של שגיאות שמונעות מ-YouTube לעבד את הסרטון שהועלו. השגיאות האלה מציינות שלמרות סטטוס העיבוד הנוכחי של הסרטון, סביר להניח שבסופו של דבר הסטטוס יהיה failed.

הערכים התקינים של המאפיין הזה הם:
  • archiveFile – קובץ ארכיון (למשל, קובץ ZIP).
  • audioFile – הקובץ מכיל אודיו בלבד (למשל, קובץ MP3).
  • docFile – מסמך או קובץ טקסט (למשל, מסמך MS Word).
  • imageFile – קובץ תמונה (למשל, תמונה בפורמט JPEG).
  • notAVideoFile – קובץ אחר שאינו וידאו.
  • projectFile – קובץ פרויקט של סרט (למשל, פרויקט של Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
רשימה של סיבות אפשריות לבעיות בהמרת הקידוד של הסרטון שהועלה ל-YouTube או לשגיאה בהמרת הקידוד. האזהרות האלה נוצרות לפני שמערכת YouTube מעבדת בפועל את קובץ הווידאו שהועלו. בנוסף, הם מזהים בעיות שלא בהכרח מצביעות על כך שעיבוד הווידאו ייכשל, אבל עדיין עלולות לגרום לבעיות כמו בעיות בסנכרון, פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) או טראק של אודיו חסר.

הערכים החוקיים של הנכס הזה הם:
  • hasEditlist – אין כרגע תמיכה ברשימות עריכה.
  • inconsistentResolution – רזולוציות סותרות של קונטיינר וסטרים.
  • problematicAudioCodec – נעשה שימוש בקודק אודיו שידוע שהוא גורם לבעיות.
  • problematicVideoCodec – נעשה שימוש בקודק וידאו שידוע כגורם לבעיות.
  • unknownAudioCodec – קודק אודיו לא מזוהה, סביר להניח שההמרת הקידוד תיכשל.
  • unknownContainer – פורמט קובץ לא מזוהה, סביר להניח שהמרת הקידוד תיכשל.
  • unknownVideoCodec – קודק וידאו לא מזוהה, סביר להניח שההמרת תיכשל.
suggestions.processingHints[] list
רשימת הצעות שעשויות לשפר את היכולת של YouTube לעבד את הסרטון.

הערכים התקפים למאפיין הזה הם:
  • nonStreamableMov – לא ניתן להעביר בסטרימינג את קובץ ה-MP4, הפעולה הזו תאט את העיבוד.
  • sendBestQualityVideo – סביר להניח שיש גרסה באיכות טובה יותר של הסרטון.
suggestions.tagSuggestions[] list
רשימה של תגים של מילות מפתח שאפשר להוסיף למטא-נתונים של הסרטון כדי להגדיל את הסיכוי שהמשתמשים יאתרו את הסרטון כשהם מחפשים או גולשים ב-YouTube.
suggestions.tagSuggestions[].tag string
תג מילת המפתח שהמערכת הציעה לסרטון.
suggestions.tagSuggestions[].categoryRestricts[] list
קבוצה של קטגוריות של סרטונים שהתג רלוונטי להן. ניתן להשתמש במידע הזה כדי להציג הצעות לתגים מתאימות על סמך קטגוריית הסרטון שמעלה הסרטון משייך אליו. כברירת מחדל, ההצעות לתוויות רלוונטיות לכל הקטגוריות אם לא מוגדרות הגבלות למילות המפתח.
suggestions.editorSuggestions[] list
רשימה של פעולות של עריכת סרטונים שעשויות לשפר את איכות הווידאו או את חוויית ההפעלה של הסרטון שהועלה.

הערכים החוקיים לנכס הזה הם:
  • audioQuietAudioSwap – טראק האודיו נראה שקט וניתן להחליף אותו בטראק באיכות טובה יותר.
  • videoAutoLevels – רמות הבהירות של התמונה לא נראות תקינות ואפשר לתקן אותן.
  • videoCrop – אפשר לחתוך שוליים (מטות) שזוהו סביב התמונה.
  • videoStabilize – הסרטון נראה רועד ואפשר לייצב אותו.
liveStreamingDetails object
האובייקט liveStreamingDetails מכיל מטא-נתונים על שידור וידאו בשידור חי. האובייקט יוצג במשאב video רק אם הסרטון הוא שידור חי שמתקיים בקרוב, בשידור חי או שהסתיים.
liveStreamingDetails.actualStartTime datetime
השעה שבה השידור התחיל בפועל. הערך מצוין בפורמט ISO 8601. הערך הזה לא יהיה זמין עד שהשידור יתחיל.
liveStreamingDetails.actualEndTime datetime
השעה שבה השידור הסתיים בפועל. הערך מצוין בפורמט ISO 8601. הערך הזה לא יהיה זמין עד לסיום השידור.
liveStreamingDetails.scheduledStartTime datetime
השעה שבה השידור מתוזמן להתחיל. הערך מצוין בפורמט ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
השעה שבה השידור מתוזמן להסתיים. הערך מצוין בפורמט ISO 8601. אם הערך ריק או שהנכס לא קיים, השידור מתוזמן להימשך ללא הגבלת זמן.
liveStreamingDetails.concurrentViewers unsigned long
מספר הצופים שצופים כרגע בשידור. הנכס והערך שלו יופיעו אם יש לצופים הנוכחיים של השידור, ובעל השידור לא הסתיר את מספר הצפיות בסרטון. חשוב לזכור שמערכת YouTube מפסיקה לעקוב אחרי מספר הצופים בו-זמנית בשידור כשהשידור מסתיים. לכן, המאפיין הזה לא יזהה את מספר האנשים שצופים בסרטון שהועבר לארכיון של שידור חי שכבר הסתיים.
הספירה של צופים בו-זמנית שחוזרים מה-YouTube Data API עשויה להיות שונה ממספר הצופים בו-זמנית שעבר עיבוד וללא ספאם, שזמין ב-YouTube Analytics. אפשר לקרוא מידע נוסף על מדדים של סטרימינג בשידור חי במרכז העזרה של YouTube.
liveStreamingDetails.activeLiveChatId string
המזהה של צ'אט בשידור חי פעיל שמשויך לסרטון הזה. השדה הזה מתמלא רק אם הסרטון הוא שידור חי פעיל עם צ'אט בשידור חי. כשהשידור יושלם, השדה הזה יוסר והצ'אט בשידור חי ייסגר. בשידורים קבועים, מזהה הצ'אט בשידור חי לא יהיה קשור יותר לסרטון הזה, אלא לסרטון החדש שמוצג בדף הקבוע.
localizations object
האובייקט localizations מכיל תרגומים של המטא-נתונים של הסרטון.
localizations.(key) object
השפה של הטקסט המותאם אישית שמשויך לערך המפתח. הערך הוא מחרוזת שמכילה קוד שפה מסוג BCP-47.
localizations.(key).title string
שם הסרטון המתורגם.
localizations.(key).description string
תיאור הסרטון המותאם לשוק המקומי.