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
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "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
ה-e של המשאב הזה.
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
מציין אם הסרטון הוא שידור חי פעיל/עתידי. לחלופין, הערך הוא 'ללא' אם הסרטון לא משודר בשידור חי בקרוב או פעיל.

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

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

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

הערכים החוקיים לנכס הזה הם:
  • anatelA - א
  • anatelF עד F
  • anatelI - 1
  • 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 - מז'
  • bfvcG עד G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
דירוג הסרטון על ידי הוועדה האוסטרית לסיווג מדיה (Bundesministerium für Unterribt, 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
סיווג הסרטון נקבע על ידי נציבות הרדיו והטלקומוניקציה הקנדית (CRTC) לשידורים בשפה הצרפתית (קנדה). מידע נוסף זמין באתר של Canadian Broadcast Standards Council.

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

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

הערכים החוקיים לנכס הזה הם:
  • ccc14 עד 14 ומעלה
  • ccc18 עד 18 ומעלה
  • ccc18s – 18 ומעלה – Contenido pornográfico
  • ccc18v – 18 ומעלה – Contenido exsivamente לצאת
  • ccc6 – 6 ומעלה – Inconveniente para menores de 7 años
  • cccTe – אליפות הכלים של Todo
  • 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 Movies (בלגיה).

הערכים החוקיים לנכס הזה הם:
  • cicfE - מז'
  • 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
מערכת הסיווג בצרפת – עמלה לסיווג קולנוע

הערכים החוקיים לנכס הזה הם:
  • cnc10 עד 10
  • cnc12 עד 12
  • cnc16 עד 16
  • cnc18 עד 18
  • cncE - מז'
  • 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
דירוג הסרטון נקבע על ידי נציבות החוק בלוקסמבורג ( Commission de surveillance de la Class des movies (CSCF).

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

הערכים החוקיים לנכס הזה הם:
  • czfilm12 עד 12
  • czfilm14 עד 14
  • czfilm18 עד 18
  • czfilmU - U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
הדירוג של הסרטון לפי מחלקה

  • djctq10 עד 10
  • djctq12 עד 12
  • djctq14 עד 14
  • djctq16 עד 16
  • djctq18 עד 18
  • djctqL עד ל'
  • 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 – K-6
  • eefilmL עד ל'
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – פר
  • 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 - 1
  • fcoIi - 2
  • fcoIia – IIA
  • fcoIib - IIB
  • fcoIii - III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
הנכס הזה הוצא משימוש ב-2 בנובמבר 2015. במקום זאת, צריך להשתמש בנכס contentDetails.contentRating.cncRating.

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

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

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

הערכים החוקיים לנכס הזה הם:
  • 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 – אלבמה
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
דירוג הוועדה לדירוג מדיה של קוריאה (Association of Korea Rating Board (Association) להגדרת היא ועוד: דירוג הסרטונים על ידי KMRB בדרום קוריאה.

הערכים החוקיים לנכס הזה הם:
  • kmrb12plus – 12ℸ 䃁 ’㞌換
  • kmrb15plus – 15ℸ 䃁 ɞ
  • kmrbAll – 多溴貴換鞌る
  • kmrbR – ⲭ膌 ’⬞消を
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
סיווג הסרטון מתוך סרט חיישן Lembaga של אינדונזיה.

הערכים החוקיים לנכס הזה הם:
  • lsf13 עד 13
  • lsf17 עד 17
  • lsf21 עד 21
  • lsfA - א
  • lsfBo – BO
  • lsfD עד יום
  • lsfR עד R
  • lsfSu – דרום
  • 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 Fiberinstitut) (Det Danske Fiberinstitut) (Det Danske Footinstitut) היא מועצת המדיה לילדים ולצעירים.

הערכים החוקיים לנכס הזה הם:
  • mccyp11 עד 11
  • mccyp15 עד 15
  • mccyp7 עד 7
  • mccypA - א
  • 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 - א
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
דירוג הסרטון נקבע על ידי Kansallinen Audiovisuaalinen Instituutti (מכון האודיו-ויזואלי הלאומי) של פינלנד.

הערכים החוקיים לנכס הזה הם:
  • meku12 עד 12
  • meku16 עד 16
  • meku18 עד 18
  • meku7 עד 7
  • mekuS - דר'
  • mekuUnrated
contentDetails.contentRating.mibacRating string
סיווג הסרטון מ-Ministero dei Beni e delle Attività Culturei 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 עד 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
הדירוג של The Motion Picture Association of America לטריילרים של סרטים ולתצוגה מקדימה של סרטים.

הערכים החוקיים לנכס הזה הם:
  • mpaatGb – GB (פס ירוק – מאושר לכל הקהלים)
  • mpaatRb – RB (רצועה אדומה – מומלץ לגילאי 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 עד 18R
  • nbcG עד G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
סיווג הסרטון ממרכז הסרטים הלאומי הבולגרי.

הערכים החוקיים לנכס הזה הם:
  • nfrcA - א
  • nfrcB - B
  • nfrcC עד C
  • nfrcD עד יום
  • 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 עד מיליון
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15 עד R15
  • oflcR16 עד R16
  • oflcR18 עד R18
  • oflcRp13 – RP13
  • oflcRp16 עד 16 RP
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
דירוג הסרטון בפרו.

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

הערכים החוקיים לנכס הזה הם:
  • resorteviolenciaA - א
  • resorteviolenciaB - B
  • resorteviolenciaC עד C
  • resorteviolenciaD עד יום
  • resorteviolenciaE - מז'
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
הדירוג של הסרטון בהנהלה הכללית של רדיו, טלוויזיה וסינמטוגרפיה (מקסיקו).

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

הערכים החוקיים לנכס הזה הם:
  • rteCh – שווייץ
  • rteGa – Google Analytics
  • 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
  • smais7 עד 7
  • smaisL עד ל'
  • smaisUnrated
contentDetails.contentRating.smsaRating string
הדירוג של הסרטון מ-Statens medierãod (מועצת המדיה הלאומית של שוודיה).

הערכים החוקיים לנכס הזה הם:
  • smsa11 עד 11
  • 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.
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
מספר התגובות לסרטון.
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. התמיכה ב-API תתבצע עד 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 – עיבוד הווידאו נכשל. אפשר לראות את הסיבה לאי-העיבוד.
  • processing – הסרטון בתהליך עיבוד. ראו את 'תהליך העיבוד'.
  • 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
תיאור הסרטון המותאם לשוק המקומי.