Videos

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

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

روش ها

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

getRating
رتبه بندی هایی را که کاربر مجاز به لیستی از ویدیوهای مشخص شده داده است، بازیابی می کند. اکنون آن را امتحان کنید .
list
فهرستی از ویدیوها را برمی‌گرداند که با پارامترهای درخواست API مطابقت دارند. اکنون آن را امتحان کنید .
insert
یک ویدیو را در YouTube آپلود می کند و به صورت اختیاری ابرداده ویدیو را تنظیم می کند.
update
فراداده یک ویدیو را به روز می کند. اکنون آن را امتحان کنید .
delete
یک ویدیوی YouTube را حذف می کند. اکنون آن را امتحان کنید .
rate
رتبه پسندیدن یا نپسندیدن را به یک ویدیو اضافه کنید یا امتیازی را از یک ویدیو حذف کنید. اکنون آن را امتحان کنید .
reportAbuse
گزارش ویدیویی حاوی محتوای توهین آمیز. اکنون آن را امتحان کنید .

نمایندگی منابع

ساختار JSON زیر فرمت یک منبع videos را نشان می دهد:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

خواص

جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:

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

چند مورد خاص وجود دارد:
  • اگر ویدیویی به‌عنوان یک ویدیوی خصوصی آپلود شود و فراداده ویدیو توسط مالک کانال بازیابی شود، ارزش ویژگی تاریخ و ساعت آپلود ویدیو را مشخص می‌کند.
  • اگر ویدیویی به‌عنوان ویدیوی فهرست‌نشده آپلود شود، مقدار ویژگی تاریخ و ساعت آپلود ویدیو را نیز مشخص می‌کند. در این حالت، هر کسی که شناسه ویدیوی منحصر به فرد ویدیو را بداند، می‌تواند فراداده ویدیو را بازیابی کند.
مقدار در قالب ISO 8601 مشخص شده است.
snippet. channelId string
شناسه ای که YouTube برای شناسایی منحصر به فرد کانالی که ویدیو در آن آپلود شده است استفاده می کند.
snippet. title string
عنوان ویدیو مقدار ویژگی حداکثر 100 کاراکتر طول دارد و ممکن است شامل همه نویسه‌های معتبر UTF-8 به جز < و > باشد. اگر متد videos.update را فرا می‌خوانید و بخش snippet یک منبع video را به‌روزرسانی می‌کنید، باید برای این ویژگی مقداری تنظیم کنید.
snippet. description string
توضیحات ویدیو مقدار ویژگی حداکثر 5000 بایت طول دارد و ممکن است شامل همه کاراکترهای معتبر UTF-8 به جز < و > باشد.
snippet. thumbnails object
نقشه ای از تصاویر کوچک مرتبط با ویدئو. برای هر شی در نقشه، کلید نام تصویر بند انگشتی است و مقدار آن شیئی است که حاوی اطلاعات دیگری در مورد تصویر کوچک است.
snippet.thumbnails. (key) object
مقادیر کلیدی معتبر عبارتند از:
  • default – تصویر بندانگشتی پیش‌فرض. تصویر کوچک پیش‌فرض یک ویدیو - یا منبعی که به یک ویدیو اشاره می‌کند، مانند آیتم فهرست پخش یا نتیجه جستجو - 120 پیکسل عرض و 90 پیکسل ارتفاع دارد. تصویر کوچک پیش‌فرض برای یک کانال 88 پیکسل عرض و 88 پیکسل ارتفاع است.
  • medium ​​– یک نسخه با وضوح بالاتر از تصویر کوچک. برای یک ویدیو (یا منبعی که به یک ویدیو اشاره دارد)، این تصویر 320 پیکسل عرض و 180 پیکسل ارتفاع دارد. برای یک کانال، این تصویر 240 پیکسل عرض و 240 پیکسل ارتفاع دارد.
  • high – یک نسخه با وضوح بالا از تصویر کوچک. برای یک ویدیو (یا منبعی که به یک ویدیو اشاره دارد)، این تصویر 480 پیکسل عرض و 360 پیکسل ارتفاع دارد. برای یک کانال، این تصویر 800 پیکسل عرض و 800 پیکسل ارتفاع دارد.
  • standard - حتی یک نسخه با وضوح بالاتر از تصویر کوچک نسبت به تصویر با وضوح high . این تصویر برای برخی از ویدیوها و سایر منابعی که به ویدیوها اشاره دارند، مانند موارد فهرست پخش یا نتایج جستجو، در دسترس است. این تصویر 640 پیکسل عرض و 480 پیکسل ارتفاع دارد.
  • maxres - بالاترین وضوح تصویر تصویر کوچک. این اندازه تصویر برای برخی از ویدیوها و سایر منابعی که به ویدیوها اشاره دارند، مانند موارد فهرست پخش یا نتایج جستجو، در دسترس است. این تصویر 1280 پیکسل عرض و 720 پیکسل ارتفاع دارد.
snippet.thumbnails.(key). url string
URL تصویر
snippet.thumbnails.(key). width unsigned integer
عرض تصویر
snippet.thumbnails.(key). height unsigned integer
ارتفاع تصویر
snippet. channelTitle string
عنوان کانال برای کانالی که ویدیو به آن تعلق دارد.
snippet. tags[] list
لیستی از برچسب های کلیدواژه مرتبط با ویدیو. برچسب ها ممکن است حاوی فاصله باشند. مقدار ویژگی حداکثر 500 کاراکتر طول دارد. در مورد نحوه محاسبه محدودیت کاراکتر به قوانین زیر توجه کنید:
  • مقدار ویژگی یک لیست است و کاما بین موارد موجود در لیست تا حد مجاز محاسبه می شود.
  • اگر یک تگ حاوی یک فاصله باشد، سرور API مقدار تگ را طوری مدیریت می کند که گویی در علامت نقل قول پیچیده شده است و علامت نقل قول در حد کاراکتر محاسبه می شود. بنابراین، برای اهداف محدودیت کاراکتر، تگ Foo-Baz شامل هفت کاراکتر است، اما تگ Foo Baz شامل نه کاراکتر است.
snippet. categoryId string
دسته ویدیوی YouTube مرتبط با ویدیو. اگر متد videos.update را فرا می‌خوانید و بخش snippet یک منبع video را به‌روزرسانی می‌کنید، باید برای این ویژگی مقداری تنظیم کنید.
snippet. liveBroadcastContent string
نشان می دهد که آیا ویدیو یک پخش زنده آتی/فعال است یا خیر. یا اگر ویدیو پخش زنده آتی/فعال نباشد، «هیچ» است.

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

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

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

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • acbC - برنامه هایی که توسط اداره ارتباطات و رسانه استرالیا طبقه بندی C داده شده است. این برنامه ها برای کودکان (به غیر از کودکان پیش دبستانی) که کمتر از 14 سال سن دارند در نظر گرفته شده است.
  • acbE – E
  • acbG - G
  • acbM – M
  • acbMa15plus – MA15+
  • acbP – برنامه هایی که توسط اداره ارتباطات و رسانه استرالیا طبقه بندی P داده شده است. این برنامه ها برای کودکان پیش دبستانی در نظر گرفته شده است.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating. agcomRating string
رتبه بندی ویدیو از Autorità per le Garanzie nelle Comunicazioni (AGCOM) ایتالیا.

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

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

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • bfvc13 - 13
  • bfvc15 - 15
  • bfvc18 - 18
  • bfvc20 – 20
  • bfvcB - B
  • bfvcE – E
  • bfvcG - G
  • bfvcUnrated
contentDetails.contentRating. bmukkRating string
رتبه بندی ویدیو از هیئت طبقه بندی رسانه اتریش (Bundesministerium für Unterricht, Kunst und Kultur).

مقادیر معتبر برای این ویژگی عبارتند از:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14+
  • bmukk16 – 16+
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa - نامحدود
  • bmukkUnrated
contentDetails.contentRating. catvRating string
سیستم رتبه‌بندی تلویزیون کانادا - سیستم طبقه‌بندی تلویزیون کانادا رتبه‌بندی ویدیو از کمیسیون رادیو تلویزیون و ارتباطات راه دور کانادا (CRTC) برای پخش‌های انگلیسی زبان کانادایی. برای اطلاعات بیشتر، به وب سایت شورای استانداردهای پخش کانادا مراجعه کنید.

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

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

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

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

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

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

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating. cnaRating string
رتبه بندی ویدیو از CONSILIUL NATIONAL AL ​​AUDIOVIZUALULUI (CNA) رومانیایی.

مقادیر معتبر برای این ویژگی عبارتند از:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18+
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating. cncRating string
سیستم رتبه بندی در فرانسه - کمیسیون طبقه بندی سینماتوگرافیک

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • csa10 – 10
  • csa12 - 12
  • csa16 – 16
  • csa18 - 18
  • csaInterdiction – ممنوعیت
  • csaT – T
  • csaUnrated
contentDetails.contentRating. cscfRating string
رتبه بندی ویدیو از کمیسیون نظارت بر طبقه بندی فیلم ها (CSCF) لوکزامبورگ.

مقادیر معتبر برای این ویژگی عبارتند از:
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating. czfilmRating string
رتبه بندی ویدیو در جمهوری چک.

مقادیر معتبر برای این ویژگی عبارتند از:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating. djctqRating string
رتبه بندی Departamento de Justiça، Classificação، Qualificação e Títulos (DJCQT - برزیل).

مقادیر معتبر برای این ویژگی عبارتند از:
  • djctq10 – 10
  • djctq12 - 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating. djctqRatingReasons[] list
دلایلی که توضیح می‌دهند چرا این ویدیو رتبه DJCQT (برزیل) خود را دریافت کرد.
contentDetails.contentRating. ecbmctRating string
سیستم رتبه بندی در ترکیه - هیئت ارزیابی و طبقه بندی وزارت فرهنگ و گردشگری

مقادیر معتبر برای این ویژگی عبارتند از:
  • ecbmct13a – 13A
  • ecbmct13plus – 13+
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18+
  • ecbmct7a - 7A
  • ecbmct7plus – 7+
  • ecbmctG - G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16+
contentDetails.contentRating. eefilmRating string
رتبه بندی ویدیو در استونی.

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating. eirinRating string
امتیاز Eirin (映倫) این ویدیو. Eirin سیستم رتبه بندی ژاپنی است.

مقادیر معتبر برای این ویژگی عبارتند از:
  • eirinG - جی
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating. fcbmRating string
امتیاز این ویدیو از هیئت سانسور فیلم مالزی.

مقادیر معتبر برای این ویژگی عبارتند از:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating. fcoRating string
رتبه بندی ویدیو از دفتر اداره فیلم، روزنامه و مقاله هنگ کنگ.

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

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

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

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

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – K-12
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating. icaaRating string
رتبه بندی این ویدیو به موسسه فیلمبرداری و هنر سمعی بصری (ICAA - اسپانیا).

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

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating. incaaRating string
امتیاز INCAA (Instituto Nacional de Cine y Artes Audiovisuales - آرژانتین) این ویدیو.

مقادیر معتبر برای این ویژگی عبارتند از:
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (Solo apta para mayores de 18 años, de exhibición condicionada)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (Solo apta para mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating. kfcbRating string
رتبه بندی ویدیو از هیئت رده بندی فیلم کنیا.

مقادیر معتبر برای این ویژگی عبارتند از:
  • kfcb16plus – 16
  • kfcbG - GE
  • kfcbPg - PG
  • kfcbR - 18
  • kfcbUnrated
contentDetails.contentRating. kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (هلند).

مقادیر معتبر برای این ویژگی عبارتند از:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • 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 – A
  • lsfBo – BO
  • lsfD - D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating. mccaaRating string
رتبه بندی این ویدیو از هیئت رده بندی سنی فیلم مالت.

مقادیر معتبر برای این ویژگی عبارتند از:
  • mccaa12 - 12
  • mccaa12a - 12A
  • mccaa14 – 14 - این رتبه از ساختار طبقه بندی جدید معرفی شده در سال 2013 حذف شد.
  • mccaa15 - 15
  • mccaa16 – 16 - این رتبه از ساختار طبقه بندی جدید معرفی شده در سال 2013 حذف شد.
  • mccaa18 - 18
  • mccaaPg - PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating. mccypRating string
امتیاز این ویدئو از شورای رسانه ای کودکان و نوجوانان موسسه فیلم دانمارکی (Det Danske Filminstitut).

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • mcst0 - 0
  • mcst16plus – 16+
  • mcstC13 - C13
  • mcstC16 - C16
  • mcstC18 - C18
  • mcstP - P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 - T18
  • mcstK - K
contentDetails.contentRating. mdaRating string
رتبه بندی این ویدیو از سازمان توسعه رسانه سنگاپور (MDA) و به طور خاص، هیئت سانسور فیلم (BFC).

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • medietilsynet11 – 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 – 18
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA - A
  • medietilsynetUnrated
contentDetails.contentRating. mekuRating string
رتبه بندی ویدیو از Kansallinen Audiovisuaalinen Instituutti (موسسه ملی سمعی و بصری) فنلاند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • meku12 - 12
  • meku16 – 16
  • meku18 - 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating. mibacRating string
رتبه بندی ویدیو از Ministero dei Beni e delle Attività Culturali e del Turismo (ایتالیا).

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

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

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

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

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

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

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

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

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • nkclv12plus – 12+
  • nkclv18plus – 18+
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating. oflcRating string
رتبه بندی دفتر فیلم و ادبیات طبقه بندی فیلم (OFLC - نیوزلند).

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

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

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

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

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16+
  • russia18 – 18+
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating. skfilmRating string
رتبه بندی ویدیو در اسلواکی.

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

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

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

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • ytAgeRestricted
contentDetails. projection string
فرمت نمایش ویدئو را مشخص می کند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • 360
  • rectangular
contentDetails. hasCustomThumbnail boolean
نشان می دهد که آیا آپلودکننده ویدیو یک تصویر کوچک سفارشی برای ویدیو ارائه کرده است یا خیر. این ویژگی فقط برای آپلودکننده ویدیو قابل مشاهده است.
status object
شیء status حاوی اطلاعاتی درباره وضعیت آپلود، پردازش و حریم خصوصی ویدیو است.
status. uploadStatus string
وضعیت ویدیوی آپلود شده.

مقادیر معتبر برای این ویژگی عبارتند از:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status. failureReason string
این مقدار توضیح می دهد که چرا یک ویدیو بارگذاری نشد. این ویژگی تنها در صورتی وجود دارد که ویژگی uploadStatus نشان دهد که آپلود انجام نشد.

مقادیر معتبر برای این ویژگی عبارتند از:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status. rejectionReason string
این مقدار توضیح می دهد که چرا YouTube یک ویدیوی آپلود شده را رد کرد. این ویژگی فقط در صورتی وجود دارد که ویژگی uploadStatus نشان دهد که آپلود رد شده است.

مقادیر معتبر برای این ویژگی عبارتند از:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status. privacyStatus string
وضعیت حریم خصوصی ویدیو.

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • creativeCommon
  • youtube
status. embeddable boolean
این مقدار نشان می دهد که آیا ویدیو می تواند در وب سایت دیگری جاسازی شود یا خیر.
status. publicStatsViewable boolean
این مقدار نشان می‌دهد که آیا آمار ویدیوی توسعه‌یافته در صفحه تماشای ویدیو به‌صورت عمومی قابل مشاهده است یا خیر. به‌طور پیش‌فرض، این آمارها قابل مشاهده هستند و آمارهایی مانند تعداد بازدید و رتبه‌بندی یک ویدیو همچنان برای عموم قابل مشاهده هستند، حتی اگر مقدار این ویژگی روی false تنظیم شود.
status. madeForKids boolean
این مقدار نشان می‌دهد که آیا ویدیو به‌عنوان کارگردانی کودک تعیین شده است یا خیر، و حاوی وضعیت فعلی «ساخته شده برای کودکان» ویدیو است. برای مثال، وضعیت ممکن است بر اساس مقدار ویژگی selfDeclaredMadeForKids تعیین شود. برای اطلاعات بیشتر درباره تنظیم مخاطب برای کانال، ویدیوها یا پخش‌های خود، به مرکز راهنمایی YouTube مراجعه کنید.
status. selfDeclaredMadeForKids boolean
در یک درخواست videos.insert یا videos.update ، این ویژگی به مالک کانال اجازه می‌دهد ویدیو را به‌عنوان کارگردانی کودک تعیین کند. در یک درخواست videos.list ، ارزش دارایی تنها در صورتی برگردانده می‌شود که مالک کانال درخواست API را مجاز کرده باشد.
statistics object
شیء statistics حاوی آماری در مورد ویدیو است.
statistics. viewCount unsigned long
تعداد دفعاتی که ویدیو مشاهده شده است.
statistics. likeCount unsigned long
تعداد کاربرانی که نشان داده اند که ویدیو را پسندیده اند.
statistics. dislikeCount unsigned long
توجه: دارایی statistics.dislikeCount از 13 دسامبر 2021 خصوصی شد. این بدان معنی است که این ویژگی تنها در صورتی در پاسخ API گنجانده می‌شود که درخواست API توسط مالک ویدیو تأیید شده باشد. برای اطلاعات بیشتر به تاریخچه ویرایش مراجعه کنید.

تعداد کاربرانی که اعلام کرده‌اند که ویدیو را دوست ندارند.
statistics. favoriteCount unsigned long
توجه: این ویژگی منسوخ شده است. استهلاک از 28 اوت 2015 قابل اجرا است. ارزش ملک اکنون همیشه روی 0 تنظیم شده است.
statistics. commentCount unsigned long
تعداد نظرات برای ویدیو.
paidProductPlacementDetails object
شی paidProductPlacementDetails حاوی اطلاعاتی درباره قرار دادن محصول پولی در ویدیو است.
paidProductPlacementDetails. hasPaidProductPlacement boolean
اگر محتوا از قرار دادن محصول پولی استفاده می کند، روی true تنظیم کنید. پیش فرض ها به false .
player object
شی player حاوی اطلاعاتی است که می توانید از آن برای پخش ویدیو در یک پخش کننده جاسازی شده استفاده کنید.
player. embedHtml string
یک تگ <iframe> که پخش کننده ای را تعبیه می کند که ویدیو را پخش می کند.
  • اگر درخواست API برای بازیابی منبع مقداری را برای پارامترهای maxHeight و/یا maxWidth مشخص کند، اندازه پخش‌کننده تعبیه‌شده برای برآورده کردن الزامات maxHeight و/یا maxWidth مقیاس می‌شود.
  • اگر نسبت ابعاد ویدیو ناشناخته باشد، پخش‌کننده تعبیه‌شده به‌طور پیش‌فرض روی قالب 4:3 تنظیم می‌شود.
player. embedHeight long
ارتفاع پخش کننده تعبیه شده در ویژگی player.embedHtml برگردانده شد. این ویژگی تنها در صورتی برگردانده می‌شود که درخواست مقداری را برای پارامترهای maxHeight و/یا maxWidth مشخص کرده باشد و نسبت ابعاد ویدیو مشخص باشد.
player. embedWidth long
عرض پخش کننده تعبیه شده در ویژگی player.embedHtml برگردانده شده است. این ویژگی تنها در صورتی برگردانده می‌شود که درخواست مقداری را برای پارامترهای maxHeight و/یا maxWidth مشخص کرده باشد و نسبت ابعاد ویدیو مشخص باشد.
topicDetails object
شی topicDetails اطلاعات مربوط به موضوعات مرتبط با ویدیو را در خود جای می دهد.

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

این ملک از 10 نوامبر 2016 منسوخ شده است و تا 10 نوامبر 2017 پشتیبانی می شود.

مهم: به دلیل منسوخ شدن Freebase و Freebase API، شناسه های موضوع از 27 فوریه 2017 به طور متفاوت شروع به کار کردند. در آن زمان، YouTube شروع به بازگرداندن مجموعه کوچکی از شناسه های موضوع انتخاب شده کرد.

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

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

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

طول جغرافیایی بر حسب درجه
recordingDetails.location. altitude double
این ملک از تاریخ 9 جولای 2018 منسوخ شده است. لطفاً برای جزئیات بیشتر به اطلاعیه انصراف مراجعه کنید.

ارتفاع بالای بیضی مرجع، بر حسب متر.
recordingDetails. recordingDate datetime
تاریخ و زمان ضبط ویدیو. مقدار در قالب ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ) مشخص شده است.
fileDetails object
شی fileDetails اطلاعات مربوط به فایل ویدیویی که در YouTube آپلود شده است، از جمله وضوح فایل، مدت زمان، کدک‌های صوتی و تصویری، نرخ بیت جریان و موارد دیگر را در بر می‌گیرد. این داده‌ها را فقط مالک ویدیو می‌تواند بازیابی کند.

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

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

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

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

مقادیر معتبر برای این ویژگی عبارتند از:
  • failed - پردازش ویدیو ناموفق بود. به Processing FailureReason مراجعه کنید.
  • 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
دلیل شکست یوتیوب در پردازش ویدیو. این ویژگی فقط در صورتی دارای مقدار خواهد بود که مقدار ویژگی 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
لیستی از خطاهایی که یوتیوب را از پردازش موفقیت آمیز ویدیوی آپلود شده باز می دارد. این خطاها نشان می دهد که، صرف نظر از وضعیت پردازش فعلی ویدیو، در نهایت، تقریباً به طور قطع آن وضعیت 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 پس از پایان پخش، ردیابی تعداد بینندگان همزمان برای یک پخش را متوقف می کند. بنابراین، این ویژگی تعداد بینندگانی را که یک ویدیوی آرشیو شده از پخش زنده ای را که قبلاً پایان یافته است، تماشا می کنند، مشخص نمی کند.
بیننده همزمان حساب می‌کند که API داده‌های YouTube ممکن است با تعداد بازدیدکنندگان همزمان پردازش‌شده و ناخواسته موجود از طریق YouTube Analytics متفاوت باشد. در مرکز راهنمای YouTube درباره معیارهای پخش زنده بیشتر بیاموزید.
liveStreamingDetails. activeLiveChatId string
شناسه چت زنده فعال در حال حاضر به این ویدیو پیوست شده است. این فیلد فقط در صورتی پر می شود که ویدیو در حال حاضر پخش زنده باشد که دارای چت زنده باشد. پس از انتقال پخش برای تکمیل این فیلد حذف می شود و چت زنده بسته می شود. برای پخش‌های دائمی، شناسه چت زنده دیگر به این ویدیو مربوط نمی‌شود، بلکه به ویدیوی جدیدی که در صفحه دائمی نمایش داده می‌شود مرتبط است.
localizations object
شی localizations حاوی ترجمه های فراداده ویدیو است.
localizations. (key) object
زبان متن محلی مرتبط با مقدار کلید. مقدار رشته ای است که حاوی کد زبان BCP-47 است .
localizations.(key). title string
عنوان ویدیوی محلی شده
localizations.(key). description string
توضیحات ویدیوی محلی.