Videos

منبع video نشان‌دهنده ویدیو YouTube است.

روش‌ها

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

getRating
رده‌بندی‌هایی را که کاربر مجاز به فهرست ویدیوهای مشخص‌شده داده است بازیابی می‌کند. اکنون امتحان کنید.
فهرست
فهرستی از ویدیوهایی را که با پارامترهای درخواست میانای برنامه‌سازی کاربردی مطابقت دارند برمی‌گرداند. اکنون امتحان کنید.
batchGetStats
فهرستی از آمار ویدیو را که با پارامترهای درخواست API مطابقت دارد بازیابی می‌کند. اکنون امتحان کنید.
درج کردن
ویدیویی را در YouTube بارگذاری می‌کند و به‌طور اختیاری فراداده ویدیو را تنظیم می‌کند.
به‌روزرسانی
فراداده ویدیو را به‌روزرسانی می‌کند. اکنون امتحان کنید.
حذف
ویدیو YouTube را حذف می‌کند. اکنون امتحان کنید.
نرخ
به یک ویدیو رده‌بندی پسندیدن یا نپسندیدن اضافه کنید یا رده‌بندی را از یک ویدیو بردارید. اکنون امتحان کنید.
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
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

مشخصات

جدول زیر خصوصیات نشان‌داده‌شده در این منبع را تعریف می‌کند:

مشخصات
kind string
نوع منبع «میانای برنامه‌سازی کاربردی» را مشخص می‌کند. مقدار youtube#video خواهد بود.
etag etag
Etag این منبع.
id string
شناسه‌ای که YouTube برای شناسایی یکتای ویدیو استفاده می‌کند.
snippet object
شیء snippet حاوی جزئیات اصلی درباره ویدیو است، مانند عنوان، شرح، و دسته آن.
snippet.publishedAt datetime
تاریخ و ساعتی که ویدیو منتشر شده است. این زمان ممکن است با زمانی که ویدیو بارگذاری شده است متفاوت باشد. برای مثال، اگر ویدیویی به‌عنوان ویدیو خصوصی بارگذاری شود و سپس در زمان دیگری عمومی شود، این ویژگی زمانی را که ویدیو عمومی شده است مشخص می‌کند.

چند مورد خاص وجود دارد:
  • اگر ویدیویی به‌عنوان ویدیو خصوصی بارگذاری شود و فراداده ویدیو توسط مالک کانال بازیابی شود، مقدار دارایی تاریخ و زمان بارگذاری ویدیو را مشخص می‌کند.
  • اگر ویدیویی به‌عنوان ویدیو فهرست‌نشده بارگذاری شود، مقدار دارایی نیز تاریخ و زمان بارگذاری ویدیو را مشخص می‌کند. در این مورد، هر کسی که شناسه ویدیو منحصربه‌فرد ویدیو را بداند می‌تواند فراداده ویدیو را بازیابی کند.
  • اگر ویدیویی به‌عنوان ویدیو مختص اعضا بارگذاری شود، مقدار ویژگی تاریخ و زمان بارگذاری ویدیو را مشخص می‌کند.
مقدار در قالب ISO 8601 مشخص شده است.
snippet.channelId string
شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد کانالی که ویدیو در آن بارگذاری شده است استفاده می‌کند. این مقدار می‌تواند درطول زمان تغییر کند، مثلاً وقتی ویدیو به کانال دیگری (برای مثال، کانال موضوعی یا کانال هنرمند) اختصاص داده می‌شود.
snippet.title string
عنوان ویدیو. مقدار ویژگی حداکثر ۱۰۰ نویسه طول دارد و می‌تواند شامل همه نویسه‌های UTF-8 معتبر به‌جز < و > باشد. اگر روش videos.update را فراخوانی می‌کنید و درحال به‌روزرسانی بخش snippet از منبع video هستید، باید مقداری برای این ویژگی تنظیم کنید.
snippet.description string
شرح ویدیو. مقدار دارایی حداکثر ۵۰۰۰ بایت طول دارد و می‌تواند شامل همه نویسه‌های UTF-8 معتبر به‌جز < و > باشد.

می‌توانید با افزودن مُهرهای زمان قالب‌بندی‌شده (برای مثال، 00:00) در نوشتار شرح، فصل‌های ویدیو ایجاد کنید.
snippet.thumbnails object
نقشه‌ای از تصاویر ریزعکس مرتبط با ویدیو. برای هر شیء در نقشه، کلید نام تصویر کوچک است و مقدار شیئی است که حاوی اطلاعات دیگری درباره تصویر کوچک است.
snippet.thumbnails.(key) object
مقادیر کلید معتبر عبارت‌اند از:
  • default – تصویر ریزعکس پیش‌فرض. ریزعکس پیش‌فرض برای یک ویدیو – یا منبعی که به یک ویدیو ارجاع می‌دهد، مانند یک مورد فهرست پخش یا نتیجه جستجو – ۱۲۰ پیکسل عرض و ۹۰ پیکسل ارتفاع دارد. ریزعکس پیش‌فرض برای کانال ۸۸ پیکسل عرض و ۸۸ پیکسل ارتفاع دارد.
  • medium – نسخه با وضوح بالاتر از تصویر کوچک. برای ویدیو (یا منبعی که به ویدیو ارجاع می‌دهد)، این تصویر ۳۲۰ پیکسل عرض و ۱۸۰ پیکسل ارتفاع دارد. برای کانال، این تصویر ۲۴۰ پیکسل عرض و ۲۴۰ پیکسل ارتفاع دارد.
  • high – نسخه‌ای با وضوح بالا از تصویر ریزعکس. برای ویدیو (یا منبعی که به ویدیو اشاره می‌کند)، این تصویر ۴۸۰ پیکسل عرض و ۳۶۰ پیکسل ارتفاع دارد. برای کانال، این تصویر ۸۰۰ پیکسل عرض و ۸۰۰ پیکسل ارتفاع دارد.
  • standard – نسخه‌ای با وضوح حتی بالاتر از تصویر ریزعکس نسبت‌به تصویر با وضوح high. این تصویر برای برخی ویدیوها و منابع دیگری که به ویدیوها ارجاع می‌دهند، مانند موارد فهرست پخش یا نتایج جستجو، دردسترس است. این تصویر ۶۴۰ پیکسل عرض و ۴۸۰ پیکسل ارتفاع دارد.
  • maxres – نسخه با وضوح بالای تصویر کوچک. این اندازه تصویر برای برخی‌از ویدیوها و منابع دیگری که به ویدیوها اشاره دارند، مانند موارد فهرست پخش یا نتایج جستجو، دردسترس است. این تصویر ۱۲۸۰ پیکسل عرض و ۷۲۰ پیکسل ارتفاع دارد.
  • fhd – نسخه وضوح بالای کامل (۱۰۸۰ پیکسل) تصویر کوچک. این اندازه تصویر برای برخی‌از ویدیوها دردسترس است. این تصویر ۱۹۲۰ پیکسل عرض و ۱۰۸۰ پیکسل ارتفاع دارد.
  • qhd – نسخه وضوح بالای چهارگانه (۱۴۴۰ پیکسل / ۲K) تصویر کوچک. این اندازه تصویر برای برخی‌از ویدیوها دردسترس است. این تصویر ۲۵۶۰ پیکسل عرض و ۱۴۴۰ پیکسل ارتفاع دارد.
  • uhd – نسخه با وضوح بسیار بالا (4K) از تصویر کوچک. این اندازه تصویر برای برخی ویدیوها دردسترس است. این تصویر ۳۸۴۰ پیکسل عرض و ۲۱۶۰ پیکسل ارتفاع دارد.
snippet.thumbnails.(key).url string
نشانی وب تصویر.
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
دسته ویدیو 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 نشان می‌دهد که طول ویدیو ۱۵ دقیقه و ۳۳ ثانیه است.

اگر ویدیو حداقل یک ساعت طول بکشد، مدت زمان در قالب 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 – G
  • ‫acbM – میلیون
  • acbMa15plus – MA15+‎
  • acbP – برنامه‌هایی که توسط «مرجع رسانه‌ها و ارتباطات استرالیا» طبقه‌بندی P دریافت کرده‌اند. این برنامه‌ها برای کودکان پیش‌دبستانی درنظر گرفته شده است.
  • acbPg – PG
  • ‫acbR18plus – R18+‎
  • acbUnrated
contentDetails.contentRating.agcomRating string
رده‌بندی ویدیو از «سازمان تنظیم مقررات ارتباطات» (AGCOM) ایتالیا.

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • agcomT – T
  • agcomUnrated
  • ‫agcomVm14 – VM14
  • ‫agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
رده‌بندی Anatel (Asociación Nacional de Televisión) ویدیو برای تلویزیون شیلی.

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • bbfc12 – ۱۲
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – ۱۸
  • ‫bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
رده‌بندی ویدیو از «هیئت سانسور فیلم و ویدیو تایلند».

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • bfvc13 – 13
  • ‫۱۵ – bfvc15
  • ‫bfvc18 – ۱۸
  • bfvc20 – 20
  • bfvcB – بایت
  • ‫bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
رده‌بندی ویدیو از «هیئت رده‌بندی رسانه‌های اتریش» (Bundesministerium für Unterricht, Kunst und Kultur).

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • bmukk10 – 10+
  • bmukk12 – ۱۲+
  • ‫bmukk14 – +۱۴
  • ‫bmukk16 – ۱۶+
  • ‫bmukk6 – ۶+
  • bmukk8 – 8+
  • bmukkAa – بدون محدودیت
  • bmukkUnrated
contentDetails.contentRating.catvRating string
سیستم رده‌بندی برای تلویزیون کانادا - سیستم طبقه‌بندی تلویزیون کانادا رده‌بندی ویدیو از کمیسیون رادیو-تلویزیون و مخابرات کانادا (CRTC) برای پخش‌های انگلیسی‌زبان کانادا. برای اطلاعات بیشتر، به وب‌سایت Canadian Broadcast Standards Council مراجعه کنید.

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • ‫catvfr13plus – ۱۳ سال به بالا
  • catvfr16plus – ۱۶+
  • 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 – نامشخص
contentDetails.contentRating.cccRating string
رده‌بندی ویدیو توسط «شورای رده‌بندی فیلم» (شیلی).

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • ccc14 – ۱۴+
  • 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 – ۰
  • ‫chfilm12 – ۱۲
  • chfilm16 – 16
  • chfilm18 – ۱۸
  • ‫chfilm6 – ۶
  • 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 – ۱۸
  • cna18plus – 18+
  • ‫cnaAp – آسوشیتدپرس
  • cnaUnrated
contentDetails.contentRating.cncRating string
سیستم رده‌بندی در فرانسه - Commission de classification cinematographique

مقادیر معتبر برای این ویژگی عبارتند از:
  • cnc10 – 10
  • cnc12 – ۱۲
  • cnc16 – 16
  • ‫cnc18 – ۱۸
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
رده‌بندی ویدیو از Conseil supérieur de l'audiovisuel فرانسه که محتوای پخش را رده‌بندی می‌کند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – Interdiction
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
رده‌بندی ویدیو از Commission de surveillance de la classification des films (CSCF) لوکزامبورگ.

مقادیر معتبر برای این ویژگی عبارتند از:
  • ‫cscf12 – ۱۲
  • cscf16 – 16
  • ‫cscf18 – ۱۸
  • cscf6 – 6
  • cscf9 – 9
  • ‫cscfA – پاس گل
  • ‫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 – ۱۰
  • djctq12 – 12
  • djctq14 – 14
  • ‫۱۶ – djctq16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
دلایلی که توضیح می‌دهد چرا ویدیو رتبه‌بندی DJCQT (برزیل) را دریافت کرده است.
contentDetails.contentRating.ecbmctRating string
سیستم رده‌بندی در ترکیه - هیئت ارزیابی و طبقه‌بندی وزارت فرهنگ و گردشگری

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • ecbmct13a – 13A
  • ‫ecbmct13plus – ۱۳ سال به بالا
  • ‫ecbmct15a – ۱۵ آمپر
  • ecbmct15plus – ۱۵+
  • ‫ecbmct18plus – بالای ۱۸ سال
  • ‫ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ‫ecbmct10plus – +۱۰
  • ecbmct16plus – ۱۶+
contentDetails.contentRating.eefilmRating string
رده‌بندی ویدیو در استونی.

مقادیر معتبر برای این ویژگی عبارتند از:
  • ‫eefilmK12 – کودکستان تا پایان دوره متوسطه دوم
  • ‫eefilmK14 – K-14
  • ‫eefilmK16 – K-16
  • ‫eefilmK6 – K-6
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
رده‌بندی ویدیو در مصر.

مقادیر معتبر برای این ویژگی عبارتند از:
  • egfilm18 – ۱۸
  • ‫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 – ۱۸ زلوتی
  • ‫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
این ویژگی از ۲ نوامبر ۲۰۱۵ منسوخ شده است. به‌جای آن از دارایی contentDetails.contentRating.cncRating استفاده کنید.

رده‌بندی ویدیو توسط «مرکز ملی سینما و تصویر متحرک» (وزارت فرهنگ فرانسه).

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • ‫fmoc10 – ۱۰
  • fmoc12 – 12
  • ‫۱۶ – fmoc16
  • fmoc18 – 18
  • fmocE – E
  • ‫fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
رده‌بندی ویدیو از «هیئت فیلم و نشریات آفریقای جنوبی».

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • ‫fpb10 – ۱۰
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • ‫fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
دلایلی که توضیح می‌دهد چرا ویدیو رده‌بندی FPB (آفریقای جنوبی) را دریافت کرده است.
contentDetails.contentRating.fskRating string
رده‌بندی ویدیو توسط Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - آلمان).

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • fsk0 – FSK 0
  • ‫fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
رده‌بندی ویدیو در یونان.

مقادیر معتبر برای این ویژگی عبارتند از:
  • ‫grfilmE – E
  • ‫grfilmK – K
  • grfilmK12 – کودکستان تا پایان دوره متوسطه دوم
  • ‫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 – ۱۳
  • icaa16 – 16
  • icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • ‫icaaX – X
contentDetails.contentRating.ifcoRating string
رده‌بندی ویدیو ازسوی «اداره طبقه‌بندی فیلم ایرلند» (IFCO - ایرلند). برای اطلاعات بیشتر، وب‌سایت IFCO را ببینید.

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • ifco12 – 12
  • ifco12a – 12A
  • ‫۱۵ – ifco15
  • ifco15a – 15A
  • ifco16 – 16
  • ‫ifco18 – ۱۸
  • ifcoG – G
  • ‫ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
رده‌بندی ویدیو در اسرائیل.

مقادیر معتبر برای این ویژگی عبارتند از:
  • ‫ilfilm12 – ۱۲
  • ilfilm16 – 16
  • ‫ilfilm18 – ۱۸
  • ‫ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
رده‌بندی INCAA (مؤسسه ملی سینما و هنرهای سمعی و بصری - آرژانتین) ویدیو.

مقادیر معتبر برای این ویژگی عبارتند از:
  • 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 (Netherlands).

مقادیر معتبر برای این ویژگی عبارت‌اند از:
  • kijkwijzer12 – 12
  • ‫kijkwijzer14 – ۱۴
  • kijkwijzer16 – 16
  • ‫kijkwijzer18 – ۱۸
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
رده‌بندی «هیئت رده‌بندی رسانه‌ای کره» (영상물등급위원회) برای ویدیو. KMRB ویدیوها را در کره جنوبی رده‌بندی می‌کند.

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

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

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • mccaa12 – 12
  • mccaa12a – 12A
  • mccaa14 – 14 - این رده‌بندی از ساختار طبقه‌بندی جدیدی که در سال ۲۰۱۳ معرفی شد برداشته شده است.
  • ‫۱۵ – mccaa15
  • mccaa16 – ۱۶ - این رده‌بندی از ساختار طبقه‌بندی جدیدی که در سال ۲۰۱۳ معرفی شد برداشته شده است.
  • ‫mccaa18 – ۱۸
  • ‫mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
رده‌بندی ویدیو از «شورای رسانه برای کودکان و جوانان» (Det Danske Filminstitut) در «مؤسسه فیلم دانمارک».

مقادیر معتبر برای این ویژگی عبارتند از:
  • ‫mccyp11 – ۱۱
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
سیستم رده‌بندی ویدیو برای ویتنام - MCST

مقادیر معتبر برای این ویژگی عبارتند از:
  • mcst0 – 0
  • mcst16plus – ۱۶+
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • ‫mcstP – P
  • mcstUnrated
  • ‫mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • ‫mcstK – هزار
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 – ۱۱
  • ‫medietilsynet12 – ۱۲
  • medietilsynet15 – 15
  • ‫medietilsynet18 – ۱۸
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • ‫medietilsynet9 – ۹
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
رده‌بندی ویدیو از Kansallinen Audiovisuaalinen Instituutti (مؤسسه ملی صوتی و تصویری) فنلاند.

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • ‫meku12 – ۱۲
  • ‫۱۶ – meku16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
رده‌بندی ویدیو ازسوی «وزارت میراث فرهنگی، فعالیت‌های فرهنگی، و گردشگری» (ایتالیا).

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
رده‌بندی ویدیو از Ministerio de Cultura (کلمبیا).

مقادیر معتبر برای این ویژگی عبارتند از:
  • ‫moc12 – ۱۲
  • moc15 – 15
  • moc18 – 18
  • ‫moc7 – ۷
  • 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
رده‌بندی انجمن تصاویر متحرک آمریکا (MPAA) برای ویدیو.

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

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

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • ‫mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
رده‌بندی ویدیو از «اداره ملی طبقه‌بندی مالدیو».

مقادیر معتبر برای این ویژگی عبارتند از:
  • nbc12plus – ۱۲+
  • nbc15plus – ۱۵+
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • ‫nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
رده‌بندی ویدیو از مرکز ملی فیلم بلغارستان.

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • nfrcA – A
  • nfrcB – بایت
  • ‫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 – ۱۲+
  • nkclv18plus – 18+
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
رده‌بندی ویدیو ازنظر «اداره طبقه‌بندی فیلم و ادبیات» (OFLC - نیوزیلند).

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

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

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

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

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • rteCh – CH
  • rteGa – GA
  • ‫rteMa – MA
  • ‫rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
رده‌بندی ویدیو در «ثبت ملی فیلم فدراسیون روسیه» (MKRF - روسیه).

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

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

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

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • smsa11 – ۱۱
  • ‫۱۵ – smsa15
  • ‫smsa7 – ۷
  • ‫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
وضعیت حریم خصوصی ویدیو. در درخواست videos.insert، اگر مقداری برای این ویژگی مشخص نکنید، وضعیت حریم خصوصی ویدیو بارگذاری‌شده به‌طور پیش‌فرض روی public تنظیم می‌شود. برخی‌از بارگذاری‌ها ممکن است براساس تنظیمات حساب محتواساز، به‌طور پیش‌فرض روی private تنظیم شوند، همان‌طور که در مرکز راهنمایی YouTube توضیح داده شده است. ویدیوهای بارگذاری‌شده از پروژه‌های API تأییدنشده به حالت مشاهده خصوصی محدود نمی‌شوند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • private
  • public
  • unlisted
status.publishAt datetime
تاریخ و زمانی که ویدیو برای انتشار زمان‌بندی شده است. این تنظیم فقط درصورتی قابل‌تنظیم است که وضعیت حریم خصوصی ویدیو خصوصی باشد. مقدار در قالب ISO 8601 مشخص شده است. به دو نکته اضافی زیر درباره رفتار این ویژگی توجه کنید:
  • اگر هنگام فراخوانی روش videos.update مقدار این ویژگی را تنظیم کنید، باید مقدار ویژگی status.privacyStatus را نیز روی private تنظیم کنید، حتی اگر ویدیو ازقبل خصوصی باشد.
  • این ویژگی فقط درصورتی می‌تواند تنظیم شود که وضعیت حریم خصوصی ویدیو private باشد و ویدیو هرگز منتشر نشده باشد.
  • اگر درخواست شما ویدیویی را برای انتشار در زمانی در گذشته برنامه‌ریزی کند، ویدیو بلافاصله منتشر خواهد شد. بنابراین، تأثیر تنظیم خصوصیت status.publishAt روی تاریخ و زمان گذشته مانند تغییر privacyStatus ویدیو از private به public است.
status.license string
پروانه ویدیو.

مقادیر معتبر برای این ویژگی عبارتند از:
  • creativeCommon
  • youtube
status.embeddable boolean
این مقدار نشان می‌دهد که آیا ویدیو می‌تواند در وب‌سایت دیگری جاسازی شود یا خیر.
status.publicStatsViewable boolean
این مقدار نشان می‌دهد که آیا آمار گسترده ویدیو در صفحه تماشای ویدیو به‌صورت عمومی قابل‌مشاهده است یا نه. به‌طور پیش‌فرض، این آمار قابل مشاهده است و آماری مانند تعداد بازدید و رده‌بندی ویدیو همچنان به‌صورت عمومی قابل مشاهده خواهد بود، حتی اگر مقدار این دارایی روی false تنظیم شده باشد.
status.madeForKids boolean
این مقدار نشان می‌دهد که آیا ویدیو به‌عنوان محتوای مختص کودکان تعیین شده است یا نه، و حاوی وضعیت فعلی «ساخته‌شده برای کودکان» ویدیو است. برای مثال، ممکن است وضعیت براساس مقدار ویژگی selfDeclaredMadeForKids تعیین شود. برای اطلاعات بیشتر درباره تنظیم مخاطب برای کانال، ویدیوها، یا همه‌فرستی‌هایتان، به مرکز راهنمایی YouTube مراجعه کنید.
status.selfDeclaredMadeForKids boolean
در یک درخواست videos.insert یا videos.update، این دارایی به مالک کانال اجازه می‌دهد ویدیو را به‌عنوان ویدیو ویژه کودکان تعیین کند. در درخواست videos.list، مقدار دارایی فقط درصورتی برگردانده می‌شود که مالک کانال درخواست API را مجاز کرده باشد.
status.containsSyntheticMedia boolean
در videos.insert یا videos.update درخواست، این دارایی به مالک کانال اجازه می‌دهد که فاش کند ویدیو حاوی محتوای واقع‌نمایانه تغییریافته یا مصنوعی (A/S) است. درباره خط‌مشی‌های YouTube مربوط به محتوای خودآزاری بیشتر بدانید.

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

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

از ۲۴ اوت ۲۰۲۶، برای همه قالب‌های ویدیو (طولانی، زنده، و «کوته‌ویدیوها») در یک کانال، viewCount به‌روز خواهد شد تا بازدیدها را از لحظه شروع پخش ویدیو (شامل پخش خودکار، نگه داشتن اشاره‌گر روی ویدیو، و کلیک/ضربه زدن برای پخش) محاسبه کند.
statistics.likeCount unsigned long
تعداد کاربرانی که نشان داده‌اند ویدیو را پسندیده‌اند.
statistics.dislikeCount unsigned long
توجه: ویژگی statistics.dislikeCount از ۱۳ دسامبر ۲۰۲۱ خصوصی شده است. این یعنی دارایی تنها درصورتی در پاسخ «میانای برنامه‌سازی کاربردی» گنجانده می‌شود که درخواست «میانای برنامه‌سازی کاربردی» توسط مالک ویدیو اصالت‌سنجی شده باشد. برای اطلاعات بیشتر، سابقه ویرایش را ببینید.

تعداد کاربرانی که نشان داده‌اند ویدیو را نپسندیده‌اند.
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 و Freebase API، شناسه‌های موضوعی به‌صورت متفاوتی عمل می‌کنند. در آن زمان، YouTube شروع به برگرداندن مجموعه کوچکی از شناسه‌های موضوعی انتخاب‌شده کرد.
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
تاریخ و زمان ضبط ویدیو. مقدار در قالب ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) مشخص شده است.
fileDetails object
شیء fileDetails اطلاعات مربوط به فایل ویدیویی بارگذاری‌شده در YouTube را دربرمی‌گیرد، ازجمله وضوح، مدت، کدک‌های صوتی و تصویری، نرخ بیت جاری‌سازی، و غیره. این داده‌ها فقط توسط مالک ویدیو قابل بازیابی است.

شیء fileDetails فقط درصورتی برگردانده می‌شود که ویژگی processingDetails.fileAvailability دارای مقدار available باشد.
fileDetails.fileName string
نام فایل بارگذاری‌شده. این فیلد نشان می‌دهد که آیا فایل ویدیویی یا نوع دیگری از فایل بارگذاری شده است یا خیر.
fileDetails.fileSize unsigned long
اندازه فایل بارگذاری‌شده به بایت. این فیلد نشان می‌دهد که آیا فایل ویدیویی یا نوع دیگری از فایل بارگذاری شده است یا خیر.
fileDetails.fileType string
نوع فایل بارگذاری‌شده که توسط موتور پردازش ویدیو YouTube شناسایی شده است. درحال‌حاضر، YouTube فقط فایل‌های ویدیویی را پردازش می‌کند، اما این فیلد چه فایل ویدیویی بارگذاری شده باشد چه نوع دیگری از فایل، وجود دارد.

مقادیر معتبر برای این ویژگی عبارتند از:
  • archive – فایل موردنظر فایل بایگانی است، مثل بایگانی ‎ .zip.
  • audio – فایل از نوع فایل صوتی شناخته‌شده‌ای مثل فایل mp3 است.
  • document – فایل سند یا فایل نوشتاری است، مثل سند MS Word.
  • image – فایل از نوع فایل تصویری است، مثل تصویر jpeg.
  • other – فایل از نوع فایل غیر ویدیویی دیگری است.
  • project – فایل یک فایل پروژه ویدیویی است، مانند پروژه Microsoft Windows Movie Maker، که حاوی داده‌های ویدیویی واقعی نیست.
  • video – فایل از نوع فایل‌های ویدیویی شناخته‌شده، مانند فایل mp4.، باشد.
fileDetails.container string
قالب محفظه فایل ویدیو بارگذاری‌شده.
fileDetails.videoStreams[] list
فهرستی از جاری‌سازی‌های ویدیویی موجود در فایل ویدیویی بارگذاری‌شده. هر مورد در فهرست حاوی فراداده‌های دقیق درباره جاری‌سازی ویدیویی است.
fileDetails.videoStreams[].widthPixels unsigned integer
عرض محتوای ویدیویی کدبندی‌شده به پیکسل. می‌توانید نسبت ابعادی کدبندی ویدیو را به‌صورت width_pixels / height_pixels محاسبه کنید.
fileDetails.videoStreams[].heightPixels unsigned integer
ارتفاع محتوای ویدیو کدبندی‌شده به پیکسل.
fileDetails.videoStreams[].frameRateFps double
نرخ فریم جاری‌سازی ویدیو، برحسب فریم در ثانیه.
fileDetails.videoStreams[].aspectRatio double
نسبت ابعادی نمایش محتوای ویدیو که نسبت ابعادی‌ای را که ویدیو باید در آن نمایش داده شود مشخص می‌کند.
fileDetails.videoStreams[].codec string
کدک ویدیویی که جاری‌سازی استفاده می‌کند.
fileDetails.videoStreams[].bitrateBps unsigned long
نرخ بیت جاری‌سازی ویدیو، برحسب بیت در ثانیه.
fileDetails.videoStreams[].rotation string
مقدار چرخشی که YouTube برای نمایش صحیح ویدیو به محتوای منبع اصلی نیاز دارد.

مقادیر معتبر برای این دارایی عبارت‌اند از:
  • clockwise – ویدیو باید ۹۰ درجه در جهت عقربه‌های ساعت چرخانده شود.
  • counterClockwise – ویدیو باید ۹۰ درجه پادساعت‌گرد چرخانده شود.
  • none – ویدیو نیازی به چرخش ندارد.
  • other – ویدیو باید به روش دیگری که ساده نیست چرخانده شود.
  • upsideDown – ویدیو باید وارونه چرخانده شود.
fileDetails.videoStreams[].vendor string
مقداری که فروشنده ویدیو را به‌طور منحصربه‌فرد شناسایی می‌کند. معمولاً این مقدار یک کد فروشنده چهارحرفی است.
fileDetails.audioStreams[] list
فهرستی از جاری‌سازی‌های صوتی موجود در فایل ویدیویی بارگذاری‌شده. هر مورد در فهرست حاوی فراداده‌های دقیق درباره یک جاری‌سازی صوتی است.
fileDetails.audioStreams[].channelCount unsigned integer
تعداد کانال‌های صوتی که جاری‌سازی دارد.
fileDetails.audioStreams[].codec string
کدک صوتی که جاری‌سازی استفاده می‌کند.
fileDetails.audioStreams[].bitrateBps unsigned long
نرخ بیت جاری‌سازی صوتی، برحسب بیت در ثانیه.
fileDetails.audioStreams[].vendor string
مقداری که فروشنده ویدیو را به‌طور منحصربه‌فرد شناسایی می‌کند. معمولاً این مقدار یک کد فروشنده چهارحرفی است.
fileDetails.durationMs unsigned long
طول ویدیو بارگذاری‌شده برحسب میلی‌ثانیه.
fileDetails.bitrateBps unsigned long
نرخ بیت ترکیبی (ویدیو و صدا) فایل ویدیویی بارگذاری‌شده برحسب بیت در ثانیه.
fileDetails.creationTime string
تاریخ و زمان ایجاد فایل ویدیویی بارگذاری‌شده. مقدار در قالب ISO 8601 مشخص شده است. درحال‌حاضر، قالب‌های ISO 8601 زیر پشتیبانی می‌شود:
  • فقط تاریخ: YYYY-MM-DD
  • زمان ساده: YYYY-MM-DDTHH:MM:SS
  • زمان با منطقه زمانی: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
شیء processingDetails اطلاعات مربوط به پیشرفت YouTube در پردازش فایل ویدیویی بارگذاری‌شده را دربرمی‌گیرد. ویژگی‌های موجود در شیء وضعیت پردازش فعلی و تخمینی از زمان باقی‌مانده تا پایان پردازش ویدیو توسط YouTube را مشخص می‌کنند. این بخش همچنین نشان می‌دهد که آیا انواع مختلف داده یا محتوا، مانند جزئیات فایل یا تصاویر کوچک، برای ویدیو دردسترس هستند یا خیر.

شیء processingProgress به‌گونه‌ای طراحی شده است که بتواند نظرسنجی کند تا ویدیو بارگذاری‌شده بتواند پیشرفتی را که YouTube در پردازش فایل ویدیویی بارگذاری‌شده داشته است ردیابی کند. فقط مالک ویدیو می‌تواند این داده‌ها را بازیابی کند.
processingDetails.processingStatus string
وضعیت پردازش ویدیو. این مقدار نشان می‌دهد که آیا YouTube توانسته است ویدیو را پردازش کند یا ویدیو هنوز درحال پردازش است.

مقادیر معتبر برای این ویژگی عبارتند از:
  • failed – پردازش ویدیو ناموفق بود. ProcessingFailureReason را ببینید.
  • processing – ویدیو درحال‌حاضر درحال پردازش است. ProcessingProgress را ببینید.
  • succeeded – ویدیو باموفقیت پردازش شد.
  • terminated – اطلاعات پردازش دیگر دردسترس نیست.
processingDetails.processingProgress object
شیء processingProgress حاوی اطلاعاتی درباره پیشرفت YouTube در پردازش ویدیو است. این مقادیر فقط زمانی مرتبط هستند که وضعیت پردازش ویدیو processing باشد.
processingDetails.processingProgress.partsTotal unsigned long
تعداد تخمینی کل بخش‌هایی که باید برای ویدیو پردازش شوند. این عدد ممکن است درحین پردازش ویدیو توسط YouTube با برآوردهای دقیق‌تر به‌روز شود.
processingDetails.processingProgress.partsProcessed unsigned long
تعداد بخش‌های ویدیویی که YouTube قبلاً پردازش کرده است. می‌توانید درصد ویدیویی را که YouTube قبلاً پردازش کرده است با محاسبه تخمین بزنید:
100 * parts_processed / parts_total

توجه داشته باشید که ازآنجایی‌که تعداد تخمینی بخش‌ها می‌تواند بدون افزایش متناظر در تعداد بخش‌هایی که قبلاً پردازش شده‌اند افزایش یابد، ممکن است پیشرفت محاسبه‌شده به‌صورت دوره‌ای درحالی‌که YouTube درحال پردازش ویدیو است کاهش یابد.
processingDetails.processingProgress.timeLeftMs unsigned long
تخمین مدت زمانی که YouTube برای تکمیل پردازش ویدیو نیاز دارد (به میلی‌ثانیه).
processingDetails.processingFailureReason string
دلیلی که YouTube نتوانست ویدیو را پردازش کند. این ویژگی فقط درصورتی مقدار خواهد داشت که مقدار ویژگی processingStatus برابر با failed باشد.

مقادیر معتبر برای این ویژگی عبارت‌اند از:
  • other – برخی‌از مؤلفه‌های پردازش دیگر ناموفق بوده‌اند.
  • ‫streamingFailed – ویدیو به جاری‌سازان ارسال نشد.
  • transcodeFailed – تراتبدیل محتوا ناموفق بود.
  • uploadFailed – فایل تحویل داده نشد.
processingDetails.fileDetailsAvailability string
این مقدار نشان می‌دهد که آیا جزئیات فایل برای ویدیو بارگذاری‌شده دردسترس است یا نه. می‌توانید جزئیات فایل ویدیو را با درخواست بخش fileDetails در درخواست videos.list() خود بازیابی کنید.
processingDetails.processingIssuesAvailability string
این مقدار نشان می‌دهد که آیا موتور پردازش ویدیو پیشنهادهایی تولید کرده است که ممکن است توانایی YouTube را برای پردازش ویدیو بهبود بخشد، هشدارهایی که مشکلات پردازش ویدیو را توضیح می‌دهند، یا خطاهایی که باعث مشکلات پردازش ویدیو می‌شوند. می‌توانید این پیشنهادها را با درخواست بخش suggestions در درخواست videos.list() خود بازیابی کنید.
processingDetails.tagSuggestionsAvailability string
این مقدار نشان می‌دهد که آیا پیشنهادهای کلیدواژه (برچسب) برای ویدیو دردسترس است یا خیر. برچسب‌ها را می‌توان به فراداده ویدیو اضافه کرد تا کاربران دیگر راحت‌تر بتوانند ویدیو را پیدا کنند. می‌توانید این پیشنهادها را با درخواست کردن بخش suggestions در درخواست videos.list() خود بازیابی کنید.
processingDetails.editorSuggestionsAvailability string
این مقدار نشان می‌دهد که آیا پیشنهادهای ویرایش ویدیو، که ممکن است کیفیت ویدیو یا تجربه بازپخش را بهبود بخشد، برای ویدیو دردسترس است یا خیر. می‌توانید این پیشنهادها را با درخواست بخش suggestions در درخواست videos.list() خود بازیابی کنید.
processingDetails.thumbnailsAvailability string
این مقدار نشان می‌دهد که آیا تصاویر ریزعکس برای ویدیو تولید شده‌اند یا نه.
suggestions object
شیء suggestions پیشنهادهایی را که فرصت‌های بهبود کیفیت ویدیو یا فراداده ویدیو بارگذاری‌شده را شناسایی می‌کنند، دربرمی‌گیرد. فقط مالک ویدیو می‌تواند این داده‌ها را بازیابی کند.

شیء suggestions فقط درصورتی برگردانده می‌شود که خصوصیت processingDetails.tagSuggestionsAvailability یا خصوصیت processingDetails.editorSuggestionsAvailability مقدار available داشته باشد.
suggestions.processingErrors[] list
فهرستی از خطاهایی که مانع از پردازش موفقیت‌آمیز ویدیو بارگذاری‌شده توسط YouTube می‌شود. این خطاها نشان می‌دهند که صرف‌نظر از وضعیت پردازش فعلی ویدیو، درنهایت، آن وضعیت تقریباً به‌طور قطع failed خواهد بود.

مقادیر معتبر برای این ویژگی عبارتند از:
  • archiveFile – فایل بایگانی (برای نمونه، بایگانی ZIP).
  • audioFile – فایل فقط حاوی صدا است (مثلاً فایل MP3).
  • docFile – سند یا فایل نوشتاری (برای نمونه، سند MS Word).
  • imageFile – فایل تصویر (برای نمونه، تصویر JPEG).
  • notAVideoFile – فایل غیرویدیویی دیگر.
  • projectFile – فایل پروژه فیلم (مثلاً پروژه Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
فهرستی از دلایلی که ممکن است YouTube در تراتبدیل ویدیو بارگذاری‌شده با مشکل مواجه شود یا ممکن است منجر به تراتبدیل اشتباه شود. این هشدارها قبل‌از اینکه YouTube واقعاً فایل ویدیویی بارگذاری‌شده را پردازش کند تولید می‌شوند. علاوه‌براین، آن‌ها مشکلاتی را شناسایی می‌کنند که لزوماً نشان‌دهنده عدم موفقیت پردازش ویدیو نیستند، اما همچنان ممکن است مشکلاتی مانند مشکلات همگام‌سازی، مصنوعات ویدیویی یا نبود قطعه صوتی ایجاد کنند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • hasEditlist – درحال‌حاضر از فهرست‌های ویرایش پشتیبانی نمی‌شود.
  • inconsistentResolution – وضوح‌های متناقض محفظه و جاری‌سازی.
  • problematicAudioCodec – از کدک صوتی که شناخته شده است و باعث ایجاد مشکل می‌شود استفاده شده است.
  • problematicVideoCodec – از کدک ویدیویی استفاده شده است که باعث بروز مشکل می‌شود.
  • unknownAudioCodec – کدک صوتی ناشناخته، تراتبدیل احتمالاً ناموفق خواهد بود.
  • unknownContainer – قالب فایل ناشناخته است، تراتبدیل احتمالاً ناموفق خواهد بود.
  • unknownVideoCodec – کدک ویدیو ناشناخته است، احتمالاً تراتبدیل انجام نشود.
suggestions.processingHints[] list
فهرستی از پیشنهادها که ممکن است توانایی YouTube را برای پردازش ویدیو بهبود بخشد.

مقادیر معتبر برای این ویژگی عبارتند از:
  • nonStreamableMov – فایل MP4 قابل جاری‌سازی نیست، این امر پردازش را کند می‌کند.
  • sendBestQualityVideo – احتمالاً نسخه باکیفیت‌تری از ویدیو وجود دارد.
suggestions.tagSuggestions[] list
فهرستی از برچسب‌های کلیدواژه که می‌توانند به فراداده ویدیو اضافه شوند تا احتمال اینکه کاربران هنگام جستجو یا مرور در YouTube ویدیو شما را پیدا کنند افزایش یابد.
suggestions.tagSuggestions[].tag string
برچسب کلیدواژه پیشنهادی برای ویدیو.
suggestions.tagSuggestions[].categoryRestricts[] list
مجموعه‌ای از دسته‌های ویدیو که برچسب با آن‌ها مرتبط است. می‌توانید از این اطلاعات برای نمایش پیشنهادهای برچسب مناسب براساس دسته ویدیویی که بارگذارنده ویدیو با ویدیو مرتبط می‌کند استفاده کنید. به‌طور پیش‌فرض، اگر محدودیتی برای کلیدواژه تعریف نشده باشد، پیشنهادهای برچسب برای همه دسته‌ها مرتبط است.
suggestions.editorSuggestions[] list
فهرستی از عملیات ویرایش ویدیو که ممکن است کیفیت ویدیو یا تجربه بازپخش ویدیو بارگذاری‌شده را بهبود بخشد.

مقادیر معتبر برای این ویژگی عبارتند از:
  • audioQuietAudioSwap – قطعه صوتی ساکت به‌نظر می‌رسد و می‌تواند با قطعه‌ای با کیفیت بهتر جایگزین شود.
  • videoAutoLevels – میزان روشنایی تصویر درست به‌نظر نمی‌رسد و می‌تواند اصلاح شود.
  • videoCrop – حاشیه‌های (مات) شناسایی‌شده در اطراف تصویر می‌تواند برش داده شود.
  • videoStabilize – ویدیو لرزان به‌نظر می‌رسد و می‌توان لرزش آن را برطرف کرد.
liveStreamingDetails object
شیء liveStreamingDetails حاوی فراداده درباره همه‌فرستی ویدیو زنده است. این شیء فقط در منبع video وجود خواهد داشت اگر ویدیو یک همه‌فرستی زنده آتی، زنده یا تکمیل‌شده باشد.
liveStreamingDetails.actualStartTime datetime
زمانی که همه‌فرستی واقعاً شروع شد. مقدار در قالب ISO 8601 مشخص شده است. این مقدار تا زمانی که همه‌فرستی شروع نشود دردسترس نخواهد بود.
liveStreamingDetails.actualEndTime datetime
زمانی که پخش واقعاً پایان یافت. مقدار در قالب ISO 8601 مشخص شده است. این مقدار تا پایان همه‌فرستی دردسترس نخواهد بود.
liveStreamingDetails.scheduledStartTime datetime
زمانی که برای شروع همه‌فرستی زمان‌بندی شده است. مقدار در قالب ISO 8601 مشخص شده است.
liveStreamingDetails.scheduledEndTime datetime
زمانی که همه‌فرستی برای پایان یافتن زمان‌بندی شده است. مقدار در قالب ISO 8601 مشخص شده است. اگر مقدار خالی باشد یا دارایی وجود نداشته باشد، پخش زنده به‌صورت نامحدود برنامه‌ریزی می‌شود.
liveStreamingDetails.concurrentViewers unsigned long
تعداد بینندگانی که درحال‌حاضر همه‌فرستی را تماشا می‌کنند. اگر پخش همه‌گانی بینندگان فعلی داشته باشد و مالک پخش همه‌گانی تعداد بازدیدهای ویدیو را پنهان نکرده باشد، این ویژگی و مقدار آن وجود خواهد داشت. توجه داشته باشید که YouTube ردیابی تعداد بینندگان همزمان را برای یک پخش زمانی که پخش به پایان می‌رسد، متوقف می‌کند. بنابراین، این ویژگی تعداد بینندگانی را که ویدیو بایگانی‌شده از پخش زنده‌ای را که قبلاً پایان یافته است تماشا می‌کنند، شناسایی نمی‌کند.
تعداد بینندگان هم‌زمان که YouTube Data API برمی‌گرداند ممکن است با تعداد بینندگان هم‌زمان پردازش‌شده و بدون هرزنامه که ازطریق YouTube Analytics دردسترس است متفاوت باشد. درباره سنجه‌های جاری‌سازی زنده در مرکز راهنمایی YouTube بیشتر بدانید.
liveStreamingDetails.activeLiveChatId string
شناسه گپ مستقیم فعالی که درحال‌حاضر به این ویدیو پیوست شده است. این فیلد فقط درصورتی پر می‌شود که ویدیو یک همه‌فرستی زنده درحال پخش باشد که گپ مستقیم داشته باشد. پس‌از انتقال همه‌فرستی به حالت تکمیل، این فیلد برداشته می‌شود و گپ مستقیم بسته می‌شود. برای همه‌فرستی‌های دائمی، شناسه گپ مستقیم دیگر به این ویدیو مرتبط نخواهد بود، بلکه به ویدیو جدیدی که در صفحه دائمی نمایش داده می‌شود مرتبط خواهد بود.
brandPartner object
شیء brandPartner حاوی جزئیات مربوط به نمانام شریک پیوندشده به ویدیو برای «دسترسی نمانام شریک آغازشده ازسوی محتواساز» (CI BPA) است.
brandPartner.channelId string
شناسه کانال خارجی شریک نمانام. این فیلد باید با «UC» شروع شود. هنگام ایجاد دسترسی، باید channelId یا channelHandle تنظیم شود، اما فقط channelId در پاسخ برگردانده می‌شود.
brandPartner.channelHandle string
نام کاربری کانال نمانام شریک. این فیلد باید با «@» شروع شود. هنگام ایجاد دسترسی، باید channelId یا channelHandle تنظیم شود، اما فقط channelId در پاسخ برگردانده می‌شود.
localizations object
شیء localizations حاوی ترجمه‌های فراداده ویدیو است.
localizations.(key) object
زبان نوشتار بومی‌سازی‌شده مرتبط با مقدار کلید. این مقدار رشته‌ای است که حاوی کد زبان BCP-47 است.
localizations.(key).title string
عنوان بومی‌سازی‌شده ویدیو.
localizations.(key).description string
شرح ویدیو بومی‌سازی‌شده.