Videos

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

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

Methods

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

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

הערכים התקינים של המאפיין הזה הם:
  • 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
הסיווג של הסרטון מטעם Australian Classification Board‏ (ACB) או Australian Communications and Media Authority‏ (ACMA). סיווגים של ACMA משמשים לסיווג של תוכניות טלוויזיה לילדים.string
הערכים התקינים של המאפיין הזה הם:

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

הערכים התקינים של המאפיין הזה הם:
  • agcomT – T
  • 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
הסיווג של הסרטון על ידי British Board of Film Classification‏ (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
סיווג הסרטון על ידי Austrian Board of Media Classification (המועצה האוסטרית לסיווג מדיה, 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
מערכת הסיווג לתוכניות טלוויזיה בקנדה – מערכת הסיווג לתוכניות טלוויזיה בקנדה. הסיווג של הסרטון מטעם Canadian Radio-Television and Telecommunications Commission (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 – S
  • 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 – Todo espectador
  • 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
סיווג הסרטון בשווייץ.

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

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

הערכים התקינים של המאפיין הזה הם:
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
הסיווג של הסרטון מ-CONSILIUL NATIONAL AL AUDIOVIZUALULUI ‏ (CNA) ברומניה.

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

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

הערכים התקינים של המאפיין הזה הם:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – איסור כניסה
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
הסיווג של הסרטון מטעם הוועדה לפיקוח על סיווג סרטים (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 – ברזיל).

הערכים התקינים של המאפיין הזה הם:
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
סיבות שמסבירות למה הסרטון קיבל את הסיווג של DJCQT (ברזיל).
contentDetails.contentRating.ecbmctRating string
מערכת הסיווג בטורקיה – Evaluation and Classification Board of the Ministry of Culture and Tourism

הערכים התקפים של המאפיין הזה הם:
  • 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 – K-6
  • 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 – 18PA
  • 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é (משרד התרבות הצרפתי).

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

הערכים התקפים של המאפיין הזה הם:
  • fpb10 – 10
  • 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 – E
  • 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 – ארגנטינה).

הערכים התקינים של המאפיין הזה הם:
  • 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
הדירוג של הסרטון מ-Kenya Film Classification Board (המועצה לסיווג סרטים בקניה).

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

הערכים התקינים של המאפיין הזה הם:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • 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

הערכים התקפים של המאפיין הזה הם:
  • mcst0 – 0
  • mcst16plus – מגיל 16 ומעלה
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
הסיווג של הסרטון מטעם Media Development Authority (רשות פיתוח המדיה) של סינגפור, ובאופן ספציפי, מטעם Board of Film Censors (המועצה לסיווג סרטים, 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 (המכון הלאומי לאודיו-ויזואל) בפינלנד.

הערכים התקינים של המאפיין הזה הם:
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • 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 – E
  • mocT – T
  • 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 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
הסיווג של איגוד MPAA לטריילרים ולתצוגות מקדימות של סרטים.

הערכים התקינים של המאפיין הזה הם:
  • mpaatGb – GB (פס ירוק – אושר לכל הקהלים)
  • mpaatRb – RB (Red Band – מומלץ לגילאי 17 ומעלה)
contentDetails.contentRating.mtrcbRating string
הסיווג של הסרטון מ-Movie and Television Review and Classification Board (הפיליפינים).

הערכים התקפים של המאפיין הזה הם:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
הסיווג של הסרטון מטעם Maldives National Bureau of Classification (הלשכה הלאומית לסיווג של המלדיבים).

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

הערכים התקפים של המאפיין הזה הם:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
הסיווג של הסרטון מ-Nigeria's National Film and Video Censors Board (המועצה הלאומית לסינון סרטים וסרטונים בניגריה).

הערכים התקפים של המאפיין הזה הם:
  • 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
הסיווג של הסרטון מטעם Office of Film and Literature Classification (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
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
הסיווג של הסרטון מטעם המנהל הכללי של הרדיו, הטלוויזיה והקולנוע (מקסיקו).

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

הערכים התקינים של המאפיין הזה הם:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
סיווג התוכן של הסרטון מטעם National Film Registry of the Russian Federation‏ (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
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
סיווג הסרטון מ-Statens medieråd (המועצה הלאומית לתקשורת של שוודיה).

הערכים התקפים של המאפיין הזה הם:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – כל הגילאים
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
סיווג התוכן של הסרטון לפי TV Parental Guidelines (הנחיות להורים בנוגע לתוכניות טלוויזיה, 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, גם אם הסרטון כבר פרטי.
  • אפשר להגדיר את המאפיין הזה רק אם סטטוס הפרטיות של הסרטון הוא 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 בנושא תוכן שקשור לניצול או התעללות מינית בילדים

דוגמאות לתוכן עם פעילות מינית או ניצול מיני כוללות סרטונים שבהם:
  • בתוכן נראה אדם אמיתי שאומר משהו שלא אמר או עושה משהו שלא עשה.
  • שינוי חומר מצולם של אירוע או מקום אמיתיים
  • יצירת סצנה שנראית אמיתית אבל שלא התרחשה באמת
statistics object
האובייקט statistics מכיל נתונים סטטיסטיים על הסרטון.
statistics.viewCount unsigned long

מספר הפעמים שבהן צפו בסרטון.

החל מ-31 במרץ 2025, הפונקציה viewCount תחזיר את מספר הפעמים שסרטון Shorts התחיל לפעול או הופעל מחדש, ללא דרישה של זמן צפייה מינימלי.

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

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

הערכים התקינים של המאפיין הזה הם:
  • nonStreamableMov – אי אפשר להזרים את קובץ ה-MP4, ולכן העיבוד יהיה איטי יותר.
  • sendBestQualityVideo – כנראה קיימת גרסה באיכות טובה יותר של הסרטון.
suggestions.tagSuggestions[] list
רשימה של תגי מילות מפתח שאפשר להוסיף למטא-נתונים של הסרטון כדי להגדיל את הסיכוי שהמשתמשים ימצאו את הסרטון שלכם כשהם מחפשים או מעיינים ב-YouTube.
suggestions.tagSuggestions[].tag string
התג keyword שהוצע לסרטון.
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
תיאור הסרטון שמותאם לשוק המקומי.