Videos

تمام ویدیوهای آپلود شده از طریق نقطه پایانی videos.insert از پروژه‌های API تأیید نشده که پس از ۲۸ ژوئیه ۲۰۲۰ ایجاد شده‌اند، به حالت مشاهده خصوصی محدود خواهند شد. برای لغو این محدودیت، هر پروژه API باید تحت ممیزی قرار گیرد تا انطباق آن با شرایط خدمات تأیید شود. لطفاً برای جزئیات بیشتر به تاریخچه ویرایش‌های API مراجعه کنید.

یک منبع video ، یک ویدیوی یوتیوب را نشان می‌دهد.

روش‌ها

این API از روش‌های زیر برای منابع videos پشتیبانی می‌کند:

getRating
امتیازهایی را که کاربر مجاز به لیستی از ویدیوهای مشخص شده داده است، بازیابی می‌کند. همین حالا امتحان کنید .
list
لیستی از ویدیوهایی را که با پارامترهای درخواست API مطابقت دارند، برمی‌گرداند. همین حالا امتحان کنید .
batchGetStats
فهرستی از آمار ویدیوها را که با پارامترهای درخواست API مطابقت دارند، بازیابی می‌کند. همین حالا امتحان کنید .
insert
یک ویدیو را در یوتیوب آپلود می‌کند و به صورت اختیاری، متادیتای ویدیو را تنظیم می‌کند.
update
ابرداده‌های ویدیو را به‌روزرسانی می‌کند. همین حالا امتحان کنید .
delete
یک ویدیوی یوتیوب را حذف می‌کند. همین حالا امتحان کنید .
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
برچسب E این منبع.
id string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد ویدیو از آن استفاده می‌کند.
snippet object
شیء snippet شامل جزئیات اولیه در مورد ویدیو، مانند عنوان، توضیحات و دسته بندی آن است.
snippet. publishedAt datetime
تاریخ و زمانی که ویدیو منتشر شده است. توجه داشته باشید که این زمان ممکن است با زمان آپلود ویدیو متفاوت باشد. برای مثال، اگر یک ویدیو به عنوان یک ویدیوی خصوصی آپلود شده و سپس بعداً عمومی شود، این ویژگی زمان عمومی شدن ویدیو را مشخص می‌کند.

چند مورد خاص وجود دارد:
  • اگر یک ویدیو به عنوان یک ویدیوی خصوصی آپلود شود و متادیتای ویدیو توسط صاحب کانال بازیابی شود، مقدار ویژگی، تاریخ و زمان آپلود ویدیو را مشخص می‌کند.
  • اگر ویدیویی به عنوان ویدیوی فهرست نشده آپلود شود، مقدار ویژگی، تاریخ و زمان آپلود ویدیو را نیز مشخص می‌کند. در این حالت، هر کسی که شناسه ویدیوی منحصر به فرد ویدیو را بداند، می‌تواند فراداده ویدیو را بازیابی کند.
مقدار در قالب ISO 8601 مشخص شده است.
snippet. channelId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد کانالی که ویدیو در آن آپلود شده است، استفاده می‌کند.
snippet. title string
عنوان ویدیو. مقدار این ویژگی حداکثر ۱۰۰ کاراکتر دارد و می‌تواند شامل تمام کاراکترهای معتبر UTF-8 به جز < و > باشد. اگر متد videos.update را فراخوانی می‌کنید و بخش snippet یک منبع video را به‌روزرسانی می‌کنید، باید مقداری برای این ویژگی تعیین کنید.
snippet. description string
توضیحات ویدیو. مقدار ویژگی حداکثر ۵۰۰۰ بایت طول دارد و می‌تواند شامل تمام کاراکترهای معتبر UTF-8 به جز < و > باشد.
snippet. thumbnails object
نقشه‌ای از تصاویر کوچک مرتبط با ویدیو. برای هر شیء در نقشه، کلید، نام تصویر کوچک و مقدار، شیء‌ای است که حاوی اطلاعات دیگری در مورد تصویر کوچک است.
snippet.thumbnails. (key) object
مقادیر کلید معتبر عبارتند از:
  • default - تصویر کوچک پیش‌فرض. تصویر کوچک پیش‌فرض برای یک ویدیو - یا منبعی که به یک ویدیو اشاره دارد، مانند یک آیتم لیست پخش یا نتیجه جستجو - ۱۲۰ پیکسل عرض و ۹۰ پیکسل ارتفاع دارد. تصویر کوچک پیش‌فرض برای یک کانال ۸۸ پیکسل عرض و ۸۸ پیکسل ارتفاع دارد.
  • medium ​​- نسخه‌ای با وضوح بالاتر از تصویر کوچک. برای یک ویدیو (یا منبعی که به یک ویدیو اشاره دارد)، این تصویر ۳۲۰ پیکسل عرض و ۱۸۰ پیکسل ارتفاع دارد. برای یک کانال، این تصویر ۲۴۰ پیکسل عرض و ۲۴۰ پیکسل ارتفاع دارد.
  • high – یک نسخه با وضوح بالا از تصویر کوچک. برای یک ویدیو (یا منبعی که به یک ویدیو اشاره دارد)، این تصویر ۴۸۰ پیکسل عرض و ۳۶۰ پیکسل ارتفاع دارد. برای یک کانال، این تصویر ۸۰۰ پیکسل عرض و ۸۰۰ پیکسل ارتفاع دارد.
  • standard - نسخه‌ای از تصویر کوچک با وضوح حتی بالاتر از تصویر با وضوح high . این تصویر برای برخی از ویدیوها و منابع دیگری که به ویدیوها اشاره دارند، مانند موارد لیست پخش یا نتایج جستجو، در دسترس است. این تصویر ۶۴۰ پیکسل عرض و ۴۸۰ پیکسل ارتفاع دارد.
  • maxres – بالاترین وضوح تصویر بندانگشتی. این اندازه تصویر برای برخی از ویدیوها و منابع دیگری که به ویدیوها اشاره دارند، مانند موارد لیست پخش یا نتایج جستجو، در دسترس است. این تصویر ۱۲۸۰ پیکسل عرض و ۷۲۰ پیکسل ارتفاع دارد.
snippet.thumbnails.(key). url string
آدرس اینترنتی (URL) تصویر.
snippet.thumbnails.(key). width unsigned integer
عرض تصویر.
snippet.thumbnails.(key). height unsigned integer
ارتفاع تصویر.
snippet. channelTitle string
عنوان کانالی که ویدیو به آن تعلق دارد.
snippet. tags[] list
فهرستی از برچسب‌های کلمات کلیدی مرتبط با ویدیو. برچسب‌ها ممکن است حاوی فاصله باشند. مقدار ویژگی حداکثر ۵۰۰ کاراکتر دارد. به قوانین زیر در مورد نحوه محاسبه محدودیت کاراکتر توجه کنید:
  • مقدار ویژگی یک لیست است و ویرگول‌های بین آیتم‌های موجود در لیست تا حد مجاز شمارش می‌شوند.
  • اگر یک تگ شامل فاصله باشد، سرور API با مقدار تگ طوری رفتار می‌کند که انگار در علامت نقل قول قرار گرفته است و علامت‌های نقل قول جزو محدودیت کاراکترها محسوب می‌شوند. بنابراین، برای اهداف محدودیت کاراکتر، تگ Foo-Baz شامل هفت کاراکتر است، اما تگ Foo Baz شامل نه کاراکتر است.
snippet. categoryId string
دسته بندی ویدیوی یوتیوب مرتبط با ویدیو. اگر متد videos.update را فراخوانی می‌کنید و بخش snippet یک منبع video را به‌روزرسانی می‌کنید، باید برای این ویژگی مقداری تعیین کنید.
snippet. liveBroadcastContent string

نشان می‌دهد که آیا ویدیو پخش زنده‌ی در حال پخش/فعال است یا خیر. اگر ویدیو پخش زنده‌ی در حال پخش/فعال نباشد، مقدار آن none است.



مقادیر معتبر برای این ویژگی عبارتند از:
  • live
  • none
  • upcoming
snippet. defaultLanguage string
زبان متن موجود در ویژگی‌های snippet.title و snippet.description مربوط به منبع video .
snippet. localized object
شیء snippet.localized یا شامل عنوان و توضیحات محلی‌شده برای ویدیو است یا شامل عنوان به زبان پیش‌فرض برای فراداده‌های ویدیو.
  • متن محلی‌سازی شده در قطعه کد منبع برگردانده می‌شود اگر درخواست videos.list از پارامتر hl برای مشخص کردن زبانی که متن محلی‌سازی شده باید برای آن برگردانده شود استفاده کرده باشد و متن محلی‌سازی شده در آن زبان موجود باشد.
  • اگر مقدار پارامتر hl مشخص نشده باشد یا مقداری مشخص شده باشد اما فراداده محلی برای زبان مشخص شده در دسترس نباشد، فراداده برای زبان پیش‌فرض بازگردانده می‌شود.
این ویژگی حاوی یک مقدار فقط خواندنی است. از شیء localizations برای اضافه کردن، به‌روزرسانی یا حذف عناوین محلی‌شده استفاده کنید.
snippet.localized. title string
عنوان ویدیوی بومی‌سازی‌شده.
snippet.localized. description string
توضیحات ویدیوی بومی‌سازی‌شده.
snippet. defaultAudioLanguage string
ویژگی default_audio_language زبانی را که در آهنگ صوتی پیش‌فرض ویدیو صحبت می‌شود، مشخص می‌کند.
contentDetails object
شیء contentDetails حاوی اطلاعاتی در مورد محتوای ویدیو، از جمله مدت زمان ویدیو و نشانه‌ای از اینکه آیا زیرنویس برای ویدیو موجود است یا خیر، می‌باشد.
contentDetails. duration string
طول ویدیو. مقدار این ویژگی، مدت زمان ISO 8601 است. به عنوان مثال، برای ویدیویی که حداقل یک دقیقه و کمتر از یک ساعت طول دارد، مدت زمان به فرمت PT#M#S است که در آن حروف PT نشان می‌دهند که مقدار، یک دوره زمانی را مشخص می‌کند و حروف M و S به ترتیب به طول بر حسب دقیقه و ثانیه اشاره دارند. کاراکترهای # قبل از حروف M و S هر دو عدد صحیح هستند که تعداد دقیقه (یا ثانیه) ویدیو را مشخص می‌کنند. به عنوان مثال، مقدار PT15M33S نشان می‌دهد که ویدیو 15 دقیقه و 33 ثانیه طول دارد.

اگر ویدیو حداقل یک ساعت طول داشته باشد، مدت زمان آن به صورت PT#H#M#S خواهد بود که در آن # قبل از حرف H طول ویدیو را بر حسب ساعت مشخص می‌کند و سایر جزئیات مشابه توضیحات بالا هستند. اگر ویدیو حداقل یک روز طول داشته باشد، حروف P و T از هم جدا می‌شوند و قالب مقدار P#DT#H#M#S خواهد بود. لطفاً برای جزئیات کامل به مشخصات ISO 8601 مراجعه کنید.
contentDetails. dimension string
مشخص می‌کند که آیا ویدیو به صورت سه‌بعدی یا دوبعدی در دسترس است.
contentDetails. definition string
نشان می‌دهد که آیا ویدیو با کیفیت بالا ( HD ) یا فقط با کیفیت استاندارد در دسترس است.

مقادیر معتبر برای این ویژگی عبارتند از:
  • hd
  • sd
contentDetails. caption string
نشان می‌دهد که آیا زیرنویس برای ویدیو موجود است یا خیر.

مقادیر معتبر برای این ویژگی عبارتند از:
  • false
  • true
contentDetails. licensedContent boolean
نشان می‌دهد که آیا ویدیو محتوای دارای مجوز را نشان می‌دهد یا خیر، به این معنی که محتوا در کانالی که به یک شریک محتوای YouTube مرتبط است آپلود شده و سپس توسط آن شریک ادعا شده است.
contentDetails. regionRestriction object
شیء regionRestriction حاوی اطلاعاتی درباره کشورهایی است که یک ویدیو در آنها قابل مشاهده است (یا نیست). این شیء یا حاوی ویژگی contentDetails.regionRestriction.allowed یا ویژگی contentDetails.regionRestriction.blocked خواهد بود.
contentDetails.regionRestriction. allowed[] list
فهرستی از کدهای منطقه‌ای که کشورهایی را که ویدیو در آنها قابل مشاهده است مشخص می‌کند. اگر این ویژگی وجود داشته باشد و کشوری در مقدار آن ذکر نشده باشد، نمایش ویدیو در آن کشور مسدود می‌شود. اگر این ویژگی وجود داشته باشد و حاوی فهرست خالی باشد، ویدیو در همه کشورها مسدود می‌شود.
contentDetails.regionRestriction. blocked[] list
فهرستی از کدهای منطقه‌ای که کشورهایی را که ویدیو در آنها مسدود شده است، مشخص می‌کند. اگر این ویژگی وجود داشته باشد و کشوری در مقدار آن ذکر نشده باشد، ویدیو در آن کشور قابل مشاهده است. اگر این ویژگی وجود داشته باشد و حاوی یک لیست خالی باشد، ویدیو در همه کشورها قابل مشاهده است.
contentDetails. contentRating object
رتبه‌بندی‌هایی را که ویدیو تحت طرح‌های رتبه‌بندی مختلف دریافت کرده است، مشخص می‌کند.
contentDetails.contentRating. acbRating string
رتبه‌بندی هیئت طبقه‌بندی استرالیا (ACB) یا سازمان ارتباطات و رسانه‌های استرالیا (ACMA) برای ویدیو. رتبه‌بندی‌های ACMA برای طبقه‌بندی برنامه‌های تلویزیونی کودکان استفاده می‌شود.

مقادیر معتبر برای این ویژگی عبارتند از:
  • acbC – برنامه‌هایی که توسط سازمان ارتباطات و رسانه‌های استرالیا رتبه C را کسب کرده‌اند. این برنامه‌ها برای کودکانی (به غیر از کودکان پیش‌دبستانی) که کمتر از ۱۴ سال سن دارند، در نظر گرفته شده است.
  • acbE – E
  • acbG – جی
  • acbM – م
  • acbMa15plus – MA15+
  • acbP – برنامه‌هایی که توسط سازمان ارتباطات و رسانه‌های استرالیا رتبه P دریافت کرده‌اند. این برنامه‌ها برای کودکان پیش‌دبستانی در نظر گرفته شده‌اند.
  • 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
رتبه بندی آناتل (Asociación Nacional de Televisión) ویدیو برای تلویزیون شیلی.

مقادیر معتبر برای این ویژگی عبارتند از:
  • anatelA – A
  • anatelF – اف
  • anatelI – من
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – آر
  • anatelUnrated
contentDetails.contentRating. bbfcRating string
رتبه‌بندی این ویدئو توسط هیئت رده‌بندی سنی فیلم‌های بریتانیا (BBFC)

مقادیر معتبر برای این ویژگی عبارتند از:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – پی جی
  • bbfcR18 – R18
  • bbfcU – یو
  • bbfcUnrated
contentDetails.contentRating. bfvcRating string
رتبه‌بندی این ویدیو از سوی هیئت سانسور فیلم و ویدئوی تایلند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – جی
  • 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) برای پخش برنامه‌های انگلیسی زبان کانادایی. برای اطلاعات بیشتر، به وب‌سایت شورای استانداردهای پخش کانادا مراجعه کنید.

مقادیر معتبر برای این ویژگی عبارتند از:
  • catv14plus - 14+
  • catv18plus - 18+
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating. catvfrRating string
رتبه‌بندی ویدیو از کمیسیون رادیو-تلویزیون و مخابرات کانادا (CRTC) برای پخش برنامه‌های فرانسوی‌زبان کانادایی. برای اطلاعات بیشتر، به وب‌سایت شورای استانداردهای پخش کانادا مراجعه کنید.

مقادیر معتبر برای این ویژگی عبارتند از:
  • catvfr13plus - 13+
  • catvfr16plus - 16+
  • catvfr18plus - 18+
  • catvfr8plus - 8+
  • catvfrG – جی
  • catvfrUnrated
contentDetails.contentRating. cbfcRating string
رتبه‌بندی این ویدئو از سوی هیئت مرکزی صدور گواهینامه فیلم (CBFC - هند).

مقادیر معتبر برای این ویژگی عبارتند از:
  • cbfcA – الف
  • cbfcS – اس
  • cbfcU – یو
  • cbfcUnrated
  • cbfcUA – یو/ای
  • cbfcUA7plus – یو/ای
  • cbfcUA13plus – یو/ای
  • cbfcUA16plus – یو/ای
contentDetails.contentRating. cccRating string
امتیاز فیلم Consejo de Calificación Cinematográfica (شیلی).

مقادیر معتبر برای این ویژگی عبارتند از:
  • ccc14 - 14+
  • ccc18 - 18+
  • ccc18s – 18+ – محتوای پورنوگرافیکی
  • ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ - ناخوشایند برای 7 سال قبل
  • cccTe – همه تماشاچیان
  • cccUnrated
contentDetails.contentRating. cceRating string
امتیاز ویدیو از Comissão de Classificação de Espect´culos پرتغال.

مقادیر معتبر برای این ویژگی عبارتند از:
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 – 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating. chfilmRating string
رتبه‌بندی ویدیو در سوئیس.

مقادیر معتبر برای این ویژگی عبارتند از:
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – ۶
  • chfilmUnrated
contentDetails.contentRating. chvrsRating string
رتبه‌بندی سیستم رتبه‌بندی ویدیوهای خانگی کانادا (CHVRS) برای این ویدیو.

مقادیر معتبر برای این ویژگی عبارتند از:
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating. cicfRating string
امتیاز این ویدیو از کمیسیون کنترل فیلم (بلژیک).

مقادیر معتبر برای این ویژگی عبارتند از:
  • 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 – ۱۸+
  • cnaAp – آسوشیتدپرس
  • cnaUnrated
contentDetails.contentRating. cncRating string
سیستم درجه‌بندی در فرانسه - کمیسیون طبقه‌بندی سینمایی

مقادیر معتبر برای این ویژگی عبارتند از:
  • cnc10 – ۱۰
  • 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
رتبه بندی ویدیو از کمیسیون نظارت بر طبقه بندی فیلم ها (CSCF) لوکزامبورگ.

مقادیر معتبر برای این ویژگی عبارتند از:
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – آل
  • 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 – ل
  • djctqUnrated
contentDetails.contentRating. djctqRatingReasons[] list
دلایلی که توضیح می‌دهند چرا این ویدیو رتبه DJCQT (برزیل) خود را دریافت کرده است.
contentDetails.contentRating. ecbmctRating string
سیستم رتبه‌بندی در ترکیه - هیئت ارزیابی و طبقه‌بندی وزارت فرهنگ و گردشگری

مقادیر معتبر برای این ویژگی عبارتند از:
  • ecbmct13a – 13A
  • ecbmct13plus – ۱۳+
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – ۱۸+
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – جی
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – ۶+
  • 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 – 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 – یو
  • fcbmUnrated
contentDetails.contentRating. fcoRating string
امتیاز این ویدیو از سوی دفتر مدیریت فیلم، روزنامه و مقالات هنگ کنگ.

مقادیر معتبر برای این ویژگی عبارتند از:
  • fcoI – من
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating. fmocRating string
این ویژگی از تاریخ ۲ نوامبر ۲۰۱۵ منسوخ شده است. به جای آن از ویژگی contentDetails.contentRating.cncRating استفاده کنید.

امتیاز فیلم مرکز ملی سینما و تصویر انیمیشن (وزارت فرهنگ فرانسه).

مقادیر معتبر برای این ویژگی عبارتند از:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – یو
  • fmocUnrated
contentDetails.contentRating. fpbRating string
امتیاز این ویدئو از سوی هیئت فیلم و انتشارات آفریقای جنوبی.

مقادیر معتبر برای این ویژگی عبارتند از:
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – الف
  • fpbPg – پی جی
  • 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
رتبه بندی این ویدیو به موسسه فیلمبرداری و هنر سمعی بصری (ICAA - اسپانیا).

مقادیر معتبر برای این ویژگی عبارتند از:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating. ifcoRating string
رتبه‌بندی دفتر طبقه‌بندی فیلم‌های ایرلند (IFCO - ایرلند). برای اطلاعات بیشتر به وب‌سایت IFCO مراجعه کنید.

مقادیر معتبر برای این ویژگی عبارتند از:
  • ifco12 – ۱۲
  • ifco12a – ۱۲ای
  • ifco15 – ۱۵
  • ifco15a – ۱۵ای
  • ifco16 – ۱۶
  • ifco18 – 18
  • ifcoG – جی
  • ifcoPg – پی جی
  • 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 – جنرال الکتریک
  • kfcbPg – پی جی
  • 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
رتبه‌بندی هیئت رتبه‌بندی رسانه‌های کره (영상물등급위원회). KMRB ویدیوها را در کره جنوبی رتبه‌بندی می‌کند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating. lsfRating string
امتیاز ویدیو از فیلم حسگر لمباگا اندونزی.

مقادیر معتبر برای این ویژگی عبارتند از:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – الف
  • lsfBo – BO
  • lsfD – دی
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating. mccaaRating string
رتبه‌بندی این ویدیو از سوی هیئت رده‌بندی سنی فیلم مالت.

مقادیر معتبر برای این ویژگی عبارتند از:
  • mccaa12 – 12
  • mccaa12a – 12A
  • mccaa14 – 14 - این رتبه‌بندی از ساختار طبقه‌بندی جدید معرفی‌شده در سال ۲۰۱۳ حذف شد.
  • mccaa15 – 15
  • mccaa16 – 16 - این رتبه‌بندی از ساختار طبقه‌بندی جدید معرفی‌شده در سال ۲۰۱۳ حذف شد.
  • 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 – پ
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – ک
contentDetails.contentRating. mdaRating string
این ویدیو توسط سازمان توسعه رسانه سنگاپور (MDA) و به طور خاص توسط هیئت سانسور فیلم (BFC) رتبه‌بندی شده است.

مقادیر معتبر برای این ویژگی عبارتند از:
  • mdaG – جی
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating. medietilsynetRating string
امتیاز این ویدیو از Medietilsynet، سازمان رسانه‌های نروژ.

مقادیر معتبر برای این ویژگی عبارتند از:
  • medietilsynet11 – ۱۱
  • medietilsynet12 – ۱۲
  • medietilsynet15 – ۱۵
  • medietilsynet18 – ۱۸
  • medietilsynet6 – ۶
  • medietilsynet7 – ۷
  • medietilsynet9 – ۹
  • 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
رتبه‌بندی وزارت فرهنگ (کلمبیا) این ویدیو.

مقادیر معتبر برای این ویژگی عبارتند از:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – مسدود شده
  • mocE – ای
  • mocT – تی
  • mocUnrated
  • mocX – ایکس
contentDetails.contentRating. moctwRating string
رتبه بندی ویدیو از وزارت فرهنگ تایوان (文化部).

مقادیر معتبر برای این ویژگی عبارتند از:
  • moctwG – G
  • moctwP – پ
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating. mpaaRating string
رتبه‌بندی انجمن تصاویر متحرک آمریکا (MPAA) برای این ویدئو.

مقادیر معتبر برای این ویژگی عبارتند از:
  • mpaaG – جی
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating. mpaatRating string
رتبه‌بندی انجمن تصاویر متحرک آمریکا برای تریلرها و پیش‌نمایش فیلم‌ها.

مقادیر معتبر برای این ویژگی عبارتند از:
  • mpaatGb – GB (گروه سبز - مورد تایید برای همه مخاطبان)
  • mpaatRb – RB (باند قرمز - توصیه شده برای سنین ۱۷ سال به بالا)
contentDetails.contentRating. mtrcbRating string
رتبه‌بندی ویدیو از هیئت بررسی و طبقه‌بندی فیلم و تلویزیون (فیلیپین).

مقادیر معتبر برای این ویژگی عبارتند از:
  • mtrcbG – جی
  • mtrcbPg – پی جی
  • 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 – جی
  • nbcPg – پی‌جی
  • nbcPu – پی‌یو
  • nbcUnrated
contentDetails.contentRating. nfrcRating string
امتیاز این ویدیو از مرکز ملی فیلم بلغارستان .

مقادیر معتبر برای این ویژگی عبارتند از:
  • nfrcA – الف
  • nfrcB – B
  • nfrcC – سی
  • nfrcD – دی
  • nfrcUnrated
  • nfrcX – ایکس
contentDetails.contentRating. nfvcbRating string
رتبه‌بندی این ویدیو از سوی هیئت ملی سانسور فیلم و ویدیوی نیجریه.

مقادیر معتبر برای این ویژگی عبارتند از:
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – جی
  • nfvcbPg – پی جی
  • nfvcbRe – دوباره
  • nfvcbUnrated
contentDetails.contentRating. nkclvRating string
امتیاز این ویدیو از مراکز ملی فیلم لتونی (Nacionãlais Kino)

مقادیر معتبر برای این ویژگی عبارتند از:
  • nkclv12plus – ۱۲+
  • nkclv18plus – ۱۸+
  • nkclv7plus – ۷+
  • nkclvU – یو
  • nkclvUnrated
contentDetails.contentRating. oflcRating string
رتبه‌بندی دفتر رده‌بندی فیلم و ادبیات (OFLC - نیوزیلند) برای این ویدئو.

مقادیر معتبر برای این ویژگی عبارتند از:
  • oflcG – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15 – R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating. pefilmRating string
رتبه‌بندی ویدیو در پرو.

مقادیر معتبر برای این ویژگی عبارتند از:
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating. resorteviolenciaRating string
رتبه‌بندی این ویدیو در ونزوئلا.

مقادیر معتبر برای این ویژگی عبارتند از:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating. rtcRating string
رتبه‌بندی این ویدئو از سوی اداره کل رادیو، تلویزیون و سینما (مکزیک).

مقادیر معتبر برای این ویژگی عبارتند از:
  • rtcA – ای
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC – سی
  • rtcD – دی
  • rtcUnrated
contentDetails.contentRating. rteRating string
رتبه بندی ویدیو از Raidió Teilifís Éireann از ایرلند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • rteCh – CH
  • rteGa – جی ای
  • rteMa – کارشناسی ارشد
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating. russiaRating string
رتبه‌بندی این ویدئو در فهرست ملی ثبت فیلم فدراسیون روسیه (MKRF - روسیه).

مقادیر معتبر برای این ویژگی عبارتند از:
  • russia0 – ۰+
  • russia12 – ۱۲+
  • russia16 – ۱۶+
  • russia18 – ۱۸+
  • russia6 – ۶+
  • russiaUnrated
contentDetails.contentRating. skfilmRating string
رتبه‌بندی ویدیو در اسلواکی.

مقادیر معتبر برای این ویژگی عبارتند از:
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating. smaisRating string
رتبه‌بندی ویدیو در ایسلند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • smais12 – ۱۲
  • smais14 – ۱۴
  • smais16 – ۱۶
  • smais18 – 18
  • smais7 – ۷
  • smaisL – ال
  • smaisUnrated
contentDetails.contentRating. smsaRating string
رتبه بندی ویدیو از Statens medieråd (شورای رسانه ملی سوئد).

مقادیر معتبر برای این ویژگی عبارتند از:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – همه سنین
  • smsaUnrated
contentDetails.contentRating. tvpgRating string
رتبه‌بندی این ویدیو بر اساس دستورالعمل‌های والدین برای تماشای تلویزیون (TVPG)

مقادیر معتبر برای این ویژگی عبارتند از:
  • tvpgG – تلویزیون-G
  • tvpgMa – تلویزیون-MA
  • tvpgPg – تلویزیون-PG
  • tvpgUnrated
  • tvpgY – تلویزیون-Y
  • tvpgY7 – تلویزیون-Y7
  • tvpgY7Fv – تلویزیون-Y7-FV
  • pg14 – تلویزیون-۱۴
contentDetails.contentRating. ytRating string
رتبه‌بندی‌ای که یوتیوب برای شناسایی محتوای دارای محدودیت سنی استفاده می‌کند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • 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
این مقدار توضیح می‌دهد که چرا یوتیوب یک ویدیوی آپلود شده را رد کرد. این ویژگی فقط در صورتی وجود دارد که ویژگی 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 ، این ویژگی به صاحب کانال اجازه می‌دهد تا ویدیو را به عنوان child-directed تعیین کند. در درخواست videos.list ، مقدار ویژگی فقط در صورتی برگردانده می‌شود که صاحب کانال درخواست API را تأیید کرده باشد.
status. containsSyntheticMedia boolean
در درخواست videos.insert یا videos.update ، این ویژگی به صاحب کانال اجازه می‌دهد تا فاش کند که یک ویدیو حاوی محتوای واقعی Altered یا Synthetic ( A/S ) است. درباره سیاست‌های YouTube مربوط به محتوای A/S بیشتر بدانید.

نمونه‌هایی از محتوای A/S شامل ویدیوهایی است که:
  • وانمود کردن به اینکه یک شخص واقعی چیزی را می‌گوید یا انجام می‌دهد که در واقع نگفته یا انجام نداده است
  • فیلم یک رویداد یا مکان واقعی را تغییر دهید
  • صحنه‌ای واقع‌گرایانه خلق کنید که در واقع رخ نداده است
statistics object
شیء statistics شامل اطلاعات آماری مربوط به ویدیو است.
statistics. viewCount unsigned long

تعداد دفعاتی که ویدیو دیده شده است.

از ۳۱ مارس ۲۰۲۵، برای ویدیوهای کوتاه (Shorts)، viewCount تعداد دفعاتی که یک ویدیوی کوتاه شروع به پخش یا پخش مجدد می‌کند را بدون نیاز به حداقل زمان تماشا، برمی‌گرداند.

statistics. likeCount unsigned long
تعداد کاربرانی که اعلام کرده‌اند ویدیو را دوست داشته‌اند.
statistics. dislikeCount unsigned long
توجه: ویژگی statistics.dislikeCount از ۱۳ دسامبر ۲۰۲۱ خصوصی شده است. این بدان معناست که این ویژگی فقط در صورتی در پاسخ API گنجانده می‌شود که درخواست API توسط مالک ویدیو تأیید شده باشد. برای اطلاعات بیشتر به تاریخچه ویرایش مراجعه کنید.

تعداد کاربرانی که اعلام کرده‌اند از این ویدیو خوششان نیامده است.
statistics. favoriteCount unsigned long
توجه: این ویژگی منسوخ شده است. این منسوخ شدن از تاریخ ۲۸ آگوست ۲۰۱۵ اعمال می‌شود. مقدار این ویژگی اکنون همیشه روی 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 مقیاس‌بندی می‌شود.
  • اگر نسبت ابعاد ویدیو مشخص نباشد، پخش‌کننده‌ی داخلی به‌طور پیش‌فرض فرمت ۴:۳ را انتخاب می‌کند.
player. embedHeight long
ارتفاع پخش‌کننده‌ی جاسازی‌شده در ویژگی player.embedHtml برگردانده می‌شود. این ویژگی فقط در صورتی برگردانده می‌شود که درخواست، مقداری برای پارامترهای maxHeight و/یا maxWidth مشخص کرده باشد و نسبت ابعاد ویدیو مشخص باشد.
player. embedWidth long
عرض پخش‌کننده‌ی جاسازی‌شده در ویژگی player.embedHtml برگردانده می‌شود. این ویژگی فقط در صورتی برگردانده می‌شود که درخواست مقداری برای پارامترهای maxHeight و/یا maxWidth مشخص کرده باشد و نسبت ابعاد ویدیو مشخص باشد.
topicDetails object
شیء topicDetails اطلاعات مربوط به موضوعات مرتبط با ویدیو را کپسوله‌سازی می‌کند.

مهم: برای جزئیات بیشتر در مورد تغییرات آتی مربوط به شناسه‌های موضوع، به تعاریف ویژگی‌های topicDetails.relevantTopicIds[] و topicDetails.topicIds[] و همچنین تاریخچه ویرایش‌ها مراجعه کنید.
topicDetails. topicIds[] list
مهم: این ویژگی از تاریخ ۱۰ نوامبر ۲۰۱۶ منسوخ شده است. API دیگر مقادیری برای این ویژگی برنمی‌گرداند و هر موضوعی که با یک ویدیو مرتبط باشد، اکنون توسط مقدار ویژگی topicDetails.relevantTopicIds[] برگردانده می‌شود.
topicDetails. relevantTopicIds[] list
فهرستی از شناسه‌های موضوعی که به ویدیو مربوط هستند.

این ویژگی از تاریخ ۱۰ نوامبر ۲۰۱۶ منسوخ شده است. تا ۱۰ نوامبر ۲۰۱۷ پشتیبانی خواهد شد.

مهم: به دلیل منسوخ شدن Freebase و API مربوط به Freebase، شناسه‌های موضوعات از ۲۷ فوریه ۲۰۱۷ به طور متفاوتی کار کردند. در آن زمان، یوتیوب شروع به بازگرداندن مجموعه کوچکی از شناسه‌های موضوعات انتخاب‌شده کرد.

topicDetails. topicCategories[] list
فهرستی از نشانی‌های اینترنتی ویکی‌پدیا که شرحی سطح بالا از محتوای ویدیو ارائه می‌دهند.
recordingDetails object
شیء recordingDetails اطلاعات مربوط به مکان، تاریخ و آدرس محل ضبط ویدیو را در خود جای می‌دهد.
recordingDetails. locationDescription string
این ویژگی از تاریخ ۱ ژوئن ۲۰۱۷ منسوخ شده است. لطفاً برای جزئیات بیشتر به اطلاعیه منسوخ شدن مراجعه کنید.

توضیحات متنی مربوط به مکانی که ویدیو در آن ضبط شده است.
recordingDetails. location object
اطلاعات موقعیت جغرافیایی مرتبط با ویدیو. توجه داشته باشید که مقادیر ویژگی فرزند، مکانی را که صاحب ویدیو می‌خواهد با ویدیو مرتبط کند، مشخص می‌کنند. این مقدار قابل ویرایش، قابل جستجو در ویدیوهای عمومی است و ممکن است برای ویدیوهای عمومی به کاربران نمایش داده شود.
recordingDetails.location. latitude double
این ویژگی از تاریخ ۱ ژوئن ۲۰۱۷ منسوخ شده است. لطفاً برای جزئیات بیشتر به اطلاعیه منسوخ شدن مراجعه کنید.

عرض جغرافیایی بر حسب درجه.
recordingDetails.location. longitude double
این ویژگی از تاریخ ۱ ژوئن ۲۰۱۷ منسوخ شده است. لطفاً برای جزئیات بیشتر به اطلاعیه منسوخ شدن مراجعه کنید.

طول جغرافیایی بر حسب درجه.
recordingDetails.location. altitude double
این ویژگی از تاریخ ۹ ژوئیه ۲۰۱۸ منسوخ شده است. لطفاً برای جزئیات بیشتر به اطلاعیه منسوخ شدن مراجعه کنید.

ارتفاع بالاتر از بیضوی مرجع، بر حسب متر.
recordingDetails. recordingDate datetime
The date and time when the video was recorded. The value is specified in ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ) format.
fileDetails object
The fileDetails object encapsulates information about the video file that was uploaded to YouTube, including the file's resolution, duration, audio and video codecs, stream bitrates, and more. This data can only be retrieved by the video owner.

The fileDetails object will only be returned if the processingDetails.fileAvailability property has a value of available .
fileDetails. fileName string
The uploaded file's name. This field is present whether a video file or another type of file was uploaded.
fileDetails. fileSize unsigned long
The uploaded file's size in bytes. This field is present whether a video file or another type of file was uploaded.
fileDetails. fileType string
The uploaded file's type as detected by YouTube's video processing engine. Currently, YouTube only processes video files, but this field is present whether a video file or another type of file was uploaded.

Valid values for this property are:
  • archive – The file is an archive file, such as a .zip archive.
  • audio – The file is a known audio file type, such as an .mp3 file.
  • document – The file is a document or text file, such as a MS Word document.
  • image – The file is an image file, such as a .jpeg image.
  • other – The file is another non-video file type.
  • project – The file is a video project file, such as a Microsoft Windows Movie Maker project, that does not contain actual video data.
  • video – The file is a known video file type, such as an .mp4 file.
fileDetails. container string
The uploaded video file's container format.
fileDetails. videoStreams[] list
A list of video streams contained in the uploaded video file. Each item in the list contains detailed metadata about a video stream.
fileDetails.videoStreams[]. widthPixels unsigned integer
The encoded video content's width in pixels. You can calculate the video's encoding aspect ratio as width_pixels / height_pixels .
fileDetails.videoStreams[]. heightPixels unsigned integer
The encoded video content's height in pixels.
fileDetails.videoStreams[]. frameRateFps double
The video stream's frame rate, in frames per second.
fileDetails.videoStreams[]. aspectRatio double
The video content's display aspect ratio, which specifies the aspect ratio in which the video should be displayed.
fileDetails.videoStreams[]. codec string
The video codec that the stream uses.
fileDetails.videoStreams[]. bitrateBps unsigned long
The video stream's bitrate, in bits per second.
fileDetails.videoStreams[]. rotation string
The amount that YouTube needs to rotate the original source content to properly display the video.

Valid values for this property are:
  • clockwise – The video needs to be rotated 90 degrees clockwise.
  • counterClockwise – The video needs to be rotated 90 degrees counter-clockwise.
  • none – The video does not need to be rotated.
  • other – The video needs to be rotated in some other, non-trivial way.
  • upsideDown – The video needs to be rotated upside down.
fileDetails.videoStreams[]. vendor string
A value that uniquely identifies a video vendor. Typically, the value is a four-letter vendor code.
fileDetails. audioStreams[] list
A list of audio streams contained in the uploaded video file. Each item in the list contains detailed metadata about an audio stream.
fileDetails.audioStreams[]. channelCount unsigned integer
The number of audio channels that the stream contains.
fileDetails.audioStreams[]. codec string
The audio codec that the stream uses.
fileDetails.audioStreams[]. bitrateBps unsigned long
The audio stream's bitrate, in bits per second.
fileDetails.audioStreams[]. vendor string
A value that uniquely identifies a video vendor. Typically, the value is a four-letter vendor code.
fileDetails. durationMs unsigned long
The length of the uploaded video in milliseconds.
fileDetails. bitrateBps unsigned long
The uploaded video file's combined (video and audio) bitrate in bits per second.
fileDetails. creationTime string
The date and time when the uploaded video file was created. The value is specified in ISO 8601 format. Currently, the following ISO 8601 formats are supported:
  • Date only: YYYY-MM-DD
  • Naive time: YYYY-MM-DDTHH:MM:SS
  • Time with timezone: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
The processingDetails object encapsulates information about YouTube's progress in processing the uploaded video file. The properties in the object identify the current processing status and an estimate of the time remaining until YouTube finishes processing the video. This part also indicates whether different types of data or content, such as file details or thumbnail images, are available for the video.

The processingProgress object is designed to be polled so that the video uploaded can track the progress that YouTube has made in processing the uploaded video file. This data can only be retrieved by the video owner.
processingDetails. processingStatus string
The video's processing status. This value indicates whether YouTube was able to process the video or if the video is still being processed.

Valid values for this property are:
  • failed – Video processing has failed. See ProcessingFailureReason.
  • processing – Video is currently being processed. See ProcessingProgress.
  • succeeded – Video has been successfully processed.
  • terminated – Processing information is no longer available.
processingDetails. processingProgress object
The processingProgress object contains information about the progress YouTube has made in processing the video. The values are really only relevant if the video's processing status is processing .
processingDetails.processingProgress. partsTotal unsigned long
An estimate of the total number of parts that need to be processed for the video. The number may be updated with more precise estimates while YouTube processes the video.
processingDetails.processingProgress. partsProcessed unsigned long
The number of parts of the video that YouTube has already processed. You can estimate the percentage of the video that YouTube has already processed by calculating:
100 * parts_processed / parts_total

Note that since the estimated number of parts could increase without a corresponding increase in the number of parts that have already been processed, it is possible that the calculated progress could periodically decrease while YouTube processes a video.
processingDetails.processingProgress. timeLeftMs unsigned long
An estimate of the amount of time, in millseconds, that YouTube needs to finish processing the video.
processingDetails. processingFailureReason string
The reason that YouTube failed to process the video. This property will only have a value if the processingStatus property's value is failed .

Valid values for this property are:
  • other – Some other processing component has failed.
  • streamingFailed – Video could not be sent to streamers.
  • transcodeFailed – Content transcoding has failed.
  • uploadFailed – File delivery has failed.
processingDetails. fileDetailsAvailability string
This value indicates whether file details are available for the uploaded video. You can retrieve a video's file details by requesting the fileDetails part in your videos.list() request.
processingDetails. processingIssuesAvailability string
This value indicates whether the video processing engine has generated suggestions that might improve YouTube's ability to process the video, warnings that explain video processing problems, or errors that cause video processing problems. You can retrieve these suggestions by requesting the suggestions part in your videos.list() request.
processingDetails. tagSuggestionsAvailability string
This value indicates whether keyword (tag) suggestions are available for the video. Tags can be added to a video's metadata to make it easier for other users to find the video. You can retrieve these suggestions by requesting the suggestions part in your videos.list() request.
processingDetails. editorSuggestionsAvailability string
This value indicates whether video editing suggestions, which might improve video quality or the playback experience, are available for the video. You can retrieve these suggestions by requesting the suggestions part in your videos.list() request.
processingDetails. thumbnailsAvailability string
This value indicates whether thumbnail images have been generated for the video.
suggestions object
The suggestions object encapsulates suggestions that identify opportunities to improve the video quality or the metadata for the uploaded video. This data can only be retrieved by the video owner.

The suggestions object will only be returned if the processingDetails.tagSuggestionsAvailability property or the processingDetails.editorSuggestionsAvailability property has a value of available .
suggestions. processingErrors[] list
A list of errors that will prevent YouTube from successfully processing the uploaded video. These errors indicate that, regardless of the video's current processing status , eventually, that status will almost certainly be failed .

Valid values for this property are:
  • archiveFile – An archive file (eg, a ZIP archive).
  • audioFile – File contains audio only (eg, an MP3 file).
  • docFile – Document or text file (eg, MS Word document).
  • imageFile – Image file (eg, a JPEG image).
  • notAVideoFile – Other non-video file.
  • projectFile – Movie project file (eg, Microsoft Windows Movie Maker project).
suggestions. processingWarnings[] list
A list of reasons why YouTube may have difficulty transcoding the uploaded video or that might result in an erroneous transcoding. These warnings are generated before YouTube actually processes the uploaded video file. In addition, they identify issues that do not necessarily indicate that video processing will fail but that still might cause problems such as sync issues, video artifacts, or a missing audio track.

Valid values for this property are:
  • hasEditlist – Edit lists are not currently supported.
  • inconsistentResolution – Conflicting container and stream resolutions.
  • problematicAudioCodec – Audio codec that is known to cause problems was used.
  • problematicVideoCodec – Video codec that is known to cause problems was used.
  • unknownAudioCodec – Unrecognized audio codec, transcoding is likely to fail.
  • unknownContainer – Unrecognized file format, transcoding is likely to fail.
  • unknownVideoCodec – Unrecognized video codec, transcoding is likely to fail.
suggestions. processingHints[] list
A list of suggestions that may improve YouTube's ability to process the video.

Valid values for this property are:
  • nonStreamableMov – The MP4 file is not streamable, this will slow down the processing.
  • sendBestQualityVideo – Probably a better quality version of the video exists.
suggestions. tagSuggestions[] list
A list of keyword tags that could be added to the video's metadata to increase the likelihood that users will locate your video when searching or browsing on YouTube.
suggestions.tagSuggestions[]. tag string
The keyword tag suggested for the video.
suggestions.tagSuggestions[]. categoryRestricts[] list
A set of video categories for which the tag is relevant. You can use this information to display appropriate tag suggestions based on the video category that the video uploader associates with the video. By default, tag suggestions are relevant for all categories if there are no restricts defined for the keyword.
suggestions. editorSuggestions[] list
A list of video editing operations that might improve the video quality or playback experience of the uploaded video.

Valid values for this property are:
  • audioQuietAudioSwap – The audio track appears silent and could be swapped with a better quality one.
  • videoAutoLevels – Picture brightness levels seem off and could be corrected.
  • videoCrop – Margins (mattes) detected around the picture could be cropped.
  • videoStabilize – The video appears shaky and could be stabilized.
liveStreamingDetails object
The liveStreamingDetails object contains metadata about a live video broadcast. The object will only be present in a video resource if the video is an upcoming, live, or completed live broadcast.
liveStreamingDetails. actualStartTime datetime
The time that the broadcast actually started. The value is specified in ISO 8601 format. This value will not be available until the broadcast begins.
liveStreamingDetails. actualEndTime datetime
The time that the broadcast actually ended. The value is specified in ISO 8601 format. This value will not be available until the broadcast is over.
liveStreamingDetails. scheduledStartTime datetime
The time that the broadcast is scheduled to begin. The value is specified in ISO 8601 format.
liveStreamingDetails. scheduledEndTime datetime
The time that the broadcast is scheduled to end. The value is specified in ISO 8601 format. If the value is empty or the property is not present, then the broadcast is scheduled to continue indefinitely.
liveStreamingDetails. concurrentViewers unsigned long
The number of viewers currently watching the broadcast. The property and its value will be present if the broadcast has current viewers and the broadcast owner has not hidden the viewcount for the video. Note that YouTube stops tracking the number of concurrent viewers for a broadcast when the broadcast ends. So, this property would not identify the number of viewers watching an archived video of a live broadcast that already ended.
The concurrent viewer counts that the YouTube Data API returns might differ from the processed, despammed concurrent viewer counts available through YouTube Analytics. Learn more about live streaming metrics in the YouTube Help Center .
liveStreamingDetails. activeLiveChatId string
The ID of the currently active live chat attached to this video. This field is filled only if the video is a currently live broadcast that has live chat. Once the broadcast transitions to complete this field will be removed and the live chat closed down. For persistent broadcasts that live chat id will no longer be tied to this video but rather to the new video being displayed at the persistent page.
localizations object
The localizations object contains translations of the video's metadata.
localizations. (key) object
The language of the localized text associated with the key value. The value is a string that contains a BCP-47 language code.
localizations.(key). title string
The localized video title.
localizations.(key). description string
The localized video description.