این صفحه به‌وسیله ‏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

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

از 31 مارس 2025، برای Shorts، viewCount تعداد دفعاتی که Short شروع به پخش یا پخش می‌کند، بدون نیاز به حداقل زمان تماشا را برمی‌گرداند.

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

مقادیر معتبر برای این ویژگی عبارتند از:

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
توضیحات ویدیوی محلی.

Videos با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

روش ها

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

خواص

Videos