این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

خواص

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

خواص

kind string
نوع منبع API را مشخص می کند. مقدار youtube#video خواهد بود.

etag etag
Etag این منبع

id string
شناسه ای که YouTube برای شناسایی منحصر به فرد ویدیو استفاده می کند.

snippet object
شی snippet حاوی جزئیات اساسی درباره ویدیو، مانند عنوان، توضیحات و دسته بندی آن است.

snippet. publishedAt

datetime
تاریخ و ساعت انتشار ویدئو توجه داشته باشید که این زمان ممکن است با زمانی که ویدیو آپلود شده است متفاوت باشد. برای مثال، اگر ویدیویی به‌عنوان یک ویدیوی خصوصی آپلود شود و بعداً عمومی شود، این ویژگی زمان عمومی شدن ویدیو را مشخص می‌کند.

چند مورد خاص وجود دارد:

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

مقدار در قالب ISO 8601 مشخص شده است.

snippet. channelId string
شناسه ای که YouTube برای شناسایی منحصر به فرد کانالی که ویدیو در آن آپلود شده است استفاده می کند.

snippet. title string
عنوان ویدیو مقدار ویژگی حداکثر 100 کاراکتر طول دارد و ممکن است شامل همه نویسه‌های معتبر UTF-8 به جز < و > باشد. اگر متد videos.update را فرا می‌خوانید و بخش snippet یک منبع video را به‌روزرسانی می‌کنید، باید برای این ویژگی مقداری تنظیم کنید.

snippet. description string
توضیحات ویدیو مقدار ویژگی حداکثر 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 را مجاز کرده باشد.

status. containsSyntheticMedia

boolean
در یک درخواست videos.insert یا videos.update ، این ویژگی به مالک کانال اجازه می‌دهد افشا کند که یک ویدیو حاوی محتوای واقعی تغییر یافته یا مصنوعی ( A/S ) است. درباره خط‌مشی‌های YouTube مربوط به محتوای A/S بیشتر بدانید.

نمونه‌هایی از محتوای A/S شامل ویدیوهایی است که:

کاری کنید که یک شخص واقعی به نظر برسد که چیزی را می گوید یا انجام می دهد که واقعاً نگفته یا انجام نداده است
فیلم یک رویداد یا مکان واقعی را تغییر دهید
صحنه ای با ظاهری واقع گرایانه ایجاد کنید که واقعاً اتفاق نیفتاده است

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 شروع به بازگرداندن مجموعه کوچکی از شناسه های موضوع انتخاب شده کرد.

شناسه‌های موضوع پشتیبانی شده از 15 فوریه 2017 را ببینید

موضوعات
موضوعات موسیقی
/m/04rlf	موسیقی (موضوع اصلی)
/m/02mscn	موسیقی مسیحی
/m/0ggq0m	موسیقی کلاسیک
/m/01lyv	کشور
/m/02lkt	موسیقی الکترونیک
/m/0glt670	موسیقی هیپ هاپ
/m/05rwpb	موسیقی مستقل
/m/03_d0	جاز
/m/028sqc	موسیقی آسیا
/m/0g293	موسیقی آمریکای لاتین
/m/064t9	موسیقی پاپ
/m/06cqb	رگی
/m/06j6l	ریتم اند بلوز
/m/06by7	موسیقی راک
/m/0gywn	موسیقی روح
موضوعات بازی
/m/0bzvm2	بازی (موضوع اصلی)
/m/025zzc	بازی اکشن
/m/02ntfj	بازی اکشن ماجراجویی
/m/0b1vjn	بازی گاه به گاه
/m/02hygl	موزیک بازی ویدیویی
/m/04q1x3q	بازی ویدیویی پازل
/m/01sjng	بازی ویدیویی مسابقه ای
/m/0403l3g	بازی ویدئویی نقش آفرینی
/m/021bp2	بازی ویدئویی شبیه سازی
/m/022dc6	بازی ورزشی
/m/03hf_rm	بازی ویدیویی استراتژیک
موضوعات ورزشی
/m/06ntj	ورزش (موضوع والدین)
/m/0jm_	فوتبال آمریکایی
/m/018jz	بیسبال
/m/018w8	بسکتبال
/m/01cgz	بوکس
/m/09xp_	کریکت
/m/02vx4	فوتبال
/m/037hz	گلف
/m/03tmr	هاکی روی یخ
/m/01h7lh	هنرهای رزمی ترکیبی
/m/0410th	موتوراسپرت
/m/07bs0	تنیس
/m/07_53	والیبال
موضوعات سرگرمی
/m/02jjt	سرگرمی (موضوع والدین)
/m/09kqc	طنز
/m/02vxn	فیلم ها
/m/05qjc	هنرهای نمایشی
/m/066wd	کشتی حرفه ای
/m/0f2f9	برنامه های تلویزیونی
موضوعات مربوط به سبک زندگی
/m/019_rr	سبک زندگی (موضوع والدین)
/m/032tl	مد
/m/027x7n	تناسب اندام
/m/02wbm	غذا
/m/03glg	سرگرمی
/m/068hy	حیوانات خانگی
/m/041xxh	جذابیت فیزیکی [زیبایی]
/m/07c1v	تکنولوژی
/m/07bxq	گردشگری
/m/07yv9	وسایل نقلیه
موضوعات جامعه
/m/098wr	جامعه (موضوع والدین)
/m/09s1f	تجارت
/m/0kt51	سلامتی
/m/01h6rj	نظامی
/m/05qt0	سیاست
/m/06bvp	دین
موضوعات دیگر
/m/01k8wb	دانش

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 شناسایی شده است. در حال حاضر ، YouTube فقط پرونده های ویدیویی را پردازش می کند ، اما این قسمت موجود است که آیا یک فایل ویدیویی یا نوع دیگری از پرونده بارگذاری شده است.

مقادیر معتبر برای این خاصیت عبارتند از:

archive - پرونده یک پرونده بایگانی است ، مانند بایگانی .zip.
audio - پرونده یک نوع فایل صوتی شناخته شده است ، مانند یک پرونده .mp3.
document - پرونده یک سند یا فایل متنی است ، مانند یک سند MS Word.
image - پرونده یک فایل تصویری است ، مانند یک تصویر .jpeg.
other -پرونده یکی دیگر از نوع پرونده های غیر Video است.
project - پرونده یک فایل پروژه ویدیویی است ، مانند یک پروژه سازنده فیلم Microsoft Windows ، که حاوی داده های ویدیویی واقعی نیست.
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
Bitrate جریان ویدیو ، در بیت در ثانیه.

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
Bitrate جریان صوتی ، در بیت در ثانیه.

fileDetails.audioStreams[]. vendor string
مقداری که منحصر به فرد یک فروشنده ویدیو را شناسایی می کند. به طور معمول ، مقدار یک کد فروشنده چهار حرف است.

fileDetails. durationMs unsigned long
طول ویدیوی بارگذاری شده در میلی ثانیه.

fileDetails. bitrateBps unsigned long
Bitrate ترکیبی (ویدئو و صوتی) پرونده ویدیویی بارگذاری شده در بیت در ثانیه.

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 - پردازش ویدیو شکست خورده است. به پردازش failurereason مراجعه کنید.
processing - در حال حاضر ویدیو در حال پردازش است. به پردازش پردازش مراجعه کنید.
succeeded - فیلم با موفقیت پردازش شده است.
terminated - اطلاعات پردازش دیگر در دسترس نیست.

processingDetails. processingProgress object
شیء processingProgress حاوی اطلاعاتی در مورد پیشرفت YouTube در پردازش ویدیو است. در صورتی که وضعیت پردازش فیلم در processing باشد ، مقادیر فقط مرتبط هستند.

processingDetails.processingProgress. partsTotal unsigned long
برآوردی از تعداد کل قطعاتی که باید برای این فیلم پردازش شوند. این تعداد ممکن است با برآورد دقیق تر به روز شود در حالی که YouTube فیلم را پردازش می کند.

processingDetails.processingProgress. partsProcessed unsigned long
تعداد قسمت های ویدئویی که YouTube قبلاً پردازش کرده است. می توانید درصد ویدیویی را که YouTube قبلاً با محاسبه پردازش کرده است تخمین بزنید:
100 * parts_processed / parts_total

توجه داشته باشید که از آنجا که تعداد تخمینی قطعات می تواند بدون افزایش مربوط به تعداد قطعاتی که قبلاً پردازش شده اند افزایش یابد ، ممکن است که پیشرفت محاسبه شده به طور دوره ای کاهش یابد در حالی که YouTube یک ویدیو را پردازش می کند.

processingDetails.processingProgress. timeLeftMs unsigned long
برآوردی از زمان ، در Millseconds ، مبنی بر اینکه YouTube باید پردازش فیلم را تمام کند.

processingDetails. processingFailureReason

string
دلیل عدم موفقیت YouTube در پردازش فیلم. این خاصیت فقط در صورت failed ارزش خاصیت processingStatus ، دارای ارزش خواهد بود.

مقادیر معتبر برای این خاصیت عبارتند از:

other - برخی از مؤلفه های پردازش دیگر شکست خورده است.
streamingFailed - ویدیو را نمی توان برای پخش کننده ها ارسال کرد.
transcodeFailed - Transcoding محتوا شکست خورده است.
uploadFailed - تحویل پرونده شکست خورده است.

processingDetails. fileDetailsAvailability string
این مقدار نشان می دهد که آیا جزئیات پرونده برای ویدیوی بارگذاری شده در دسترس است یا خیر. می توانید با درخواست قسمت fileDetails در درخواست videos.list() خود ، جزئیات پرونده ویدیویی را بازیابی کنید.

processingDetails. processingIssuesAvailability string
این مقدار نشان می دهد که آیا موتور پردازش ویدیو پیشنهاداتی را ایجاد کرده است که ممکن است توانایی YouTube را در پردازش فیلم ، هشدارهایی که مشکلات پردازش فیلم را توضیح می دهد یا خطاهایی که باعث مشکلات پردازش فیلم می شود ، بهبود بخشد. شما می توانید با درخواست بخش suggestions در درخواست خود در videos.list() خود ، این پیشنهادات را بازیابی کنید.

processingDetails. tagSuggestionsAvailability string
این مقدار نشان می دهد که آیا پیشنهادات کلمه کلیدی (TAG) برای فیلم در دسترس است. برچسب ها را می توان به ابرداده یک ویدیو اضافه کرد تا پیدا کردن این فیلم برای سایر کاربران آسانتر شود. شما می توانید با درخواست بخش suggestions در درخواست خود در videos.list() خود ، این پیشنهادات را بازیابی کنید.

processingDetails. editorSuggestionsAvailability string
این مقدار نشان می دهد که آیا پیشنهادات ویرایش ویدیو ، که ممکن است کیفیت فیلم را بهبود بخشد یا تجربه پخش ، برای این فیلم در دسترس است. شما می توانید با درخواست بخش suggestions در درخواست خود در videos.list() خود ، این پیشنهادات را بازیابی کنید.

processingDetails. thumbnailsAvailability string
این مقدار نشان می دهد که آیا تصاویر تصویر کوچک برای این فیلم ایجاد شده است یا خیر.

suggestions object
suggestions پیشنهاداتی را که فرصت های بهبود کیفیت فیلم یا ابرداده برای فیلم بارگذاری شده را مشخص می کند ، محاصره می کند. این داده ها فقط توسط صاحب فیلم قابل بازیابی هستند.

suggestions موضوع تنها processingDetails.tagSuggestionsAvailability بازگردانده available شود processingDetails.editorSuggestionsAvailability

suggestions. processingErrors[]

list
لیستی از خطاهایی که مانع از پردازش موفقیت آمیز YouTube ویدیوی بارگذاری شده می شود. این خطاها نشان می دهد که ، صرف نظر از وضعیت پردازش فعلی فیلم ، در نهایت ، این وضعیت تقریباً failed خواهد شد.

مقادیر معتبر برای این خاصیت عبارتند از:

archiveFile - یک پرونده بایگانی (به عنوان مثال ، بایگانی زیپ).
audioFile - پرونده فقط حاوی صوتی است (به عنوان مثال ، یک فایل MP3).
docFile - پرونده یا پرونده متنی (به عنوان مثال ، سند MS Word).
imageFile - فایل تصویری (به عنوان مثال ، یک تصویر JPEG).
notAVideoFile سایر پرونده های غیر Video.
projectFile - فایل پروژه فیلم (به عنوان مثال ، پروژه سازنده فیلم Microsoft Windows).

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
تعداد بیننده هایی که در حال حاضر پخش پخش را مشاهده می کنند. این ملک و ارزش آن در صورتی که پخش کننده بینندگان فعلی داشته باشد و صاحب پخش نمایش ViewCount را برای این فیلم پنهان نکرده است. توجه داشته باشید که YouTube پس از پایان پخش ، تعداد بینندگان همزمان را برای پخش متوقف می کند. بنابراین ، این ملک تعداد بینندگانی را که در حال تماشای یک فیلم بایگانی شده از یک پخش زنده است که قبلاً به پایان رسیده است ، شناسایی نمی کند.

بیننده همزمان حساب می کند که بازده API داده های YouTube ممکن است با تعداد بیننده همزمان پردازش شده و ناامید شده از طریق Analytics YouTube متفاوت باشد. در مورد معیارهای پخش مستقیم در مرکز راهنمای YouTube اطلاعات بیشتری کسب کنید.

liveStreamingDetails. activeLiveChatId string
شناسه چت زنده فعال در حال حاضر به این ویدیو متصل است. این قسمت فقط در صورتی پر می شود که این ویدئو یک پخش زنده در حال حاضر است که گپ زنده دارد. پس از انتقال پخش برای تکمیل این زمینه و چت زنده بسته می شود. برای پخش مداوم که شناسه چت زنده دیگر به این ویدیو گره خورده است بلکه به فیلم جدیدی که در صفحه پایدار نمایش داده می شود ، گره خورده است.

localizations object
شیء localizations شامل ترجمه های ابرداده فیلم است.

localizations. (key) object
زبان متن بومی شده مرتبط با مقدار کلیدی. مقدار رشته ای است که حاوی کد زبان BCP-47 است.

localizations.(key). title string
عنوان ویدیوی بومی شده.

localizations.(key). description string
توضیحات ویدیوی بومی شده.