Videos

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

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

Methods

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

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

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

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

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

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

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

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

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

הערכים התקינים של המאפיין הזה הם:
  • catvfr13plus – 13 ומעלה
  • catvfr16plus – מגיל 16 ומעלה
  • catvfr18plus – מעל גיל 18
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
הדירוג של הסרטון על ידי המועצה המרכזית לבדיקת סרטים (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 cinematographique

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

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

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

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

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

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

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

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

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

הערכים התקפים לנכס הזה הם:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 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
הסיווג של הסרטון על ידי Film and Publication Board (הרשות לקולנוע ולפרסום) בדרום אפריקה.

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

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

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

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

הערכים התקפים למאפיין הזה הם:
  • 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 – טון
  • 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
הסיווג של Motion Picture Association of America (איגוד הסרטים של אמריקה) לטריילרים ולקטעים מקדימים של סרטים.

הערכים החוקיים למאפיין הזה הם:
  • mpaatGb – GB (Green Band – Approved for all audiences)
  • mpaatRb – RB (Red Band – מומלץ לגילאי 17 ומעלה)
contentDetails.contentRating.mtrcbRating string
הדירוג של הסרטון לפי Movie and Television Review and Classification Board (Philippines).

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

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

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

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

הערכים התקפים למאפיין הזה הם:
  • nkclv12plus – 12+
  • nkclv18plus – מעל גיל 18
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
הסיווג של הסרטון לפי 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 (RTÉ) באירלנד.

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

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

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

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

הערכים התקפים למאפיין הזה הם:
  • 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. חשוב לשים לב לשני הדברים הבאים לגבי ההתנהגות של המאפיין הזה:
  • אם מגדירים את הערך של המאפיין הזה בזמן הקריאה ל-method‏ videos.update, צריך גם להגדיר את ערך המאפיין status.privacyStatus כ-private, גם אם הסרטון כבר מוגדר כפרטי.
  • אם בבקשה שלכם תזמנתם פרסום של סרטון למועד כלשהו בעבר, הסרטון יפורסם באופן מיידי. לכן, ההשפעה של הגדרת המאפיין status.publishAt לתאריך ולשעה קודמים זהה להשפעה של שינוי הערך של privacyStatus בסרטון מ-private ל-public.
status.license string
הרישיון של הסרטון.

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

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

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

החל מ-31 במרץ 2025, עבור סרטוני Shorts, הפונקציה 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
תג