همه ویدیوهای آپلود شده از طریق
videos.insert
endpoint از پروژههای API تأیید نشده ایجاد شده پس از ۲۸ ژوئیه ۲۰۲۰ به حالت مشاهده خصوصی محدود میشوند. برای برداشتن این محدودیت، هر پروژه API باید تحت بازرسی قرار گیرد تا مطابقت با شرایط خدمات را تأیید کند. لطفاً برای جزئیات بیشتر به تاریخچه ویرایش API مراجعه کنید. یک منبع video
نشان دهنده یک ویدیوی YouTube است.
روش ها
API از روشهای زیر برای منابع videos
پشتیبانی میکند:
- getRating
- رتبه بندی هایی را که کاربر مجاز به لیستی از ویدیوهای مشخص شده داده است، بازیابی می کند. اکنون آن را امتحان کنید .
- list
- فهرستی از ویدیوها را برمیگرداند که با پارامترهای درخواست API مطابقت دارند. اکنون آن را امتحان کنید .
- insert
- یک ویدیو را در YouTube آپلود می کند و به صورت اختیاری ابرداده ویدیو را تنظیم می کند.
- update
- فراداده یک ویدیو را به روز می کند. اکنون آن را امتحان کنید .
- delete
- یک ویدیوی YouTube را حذف می کند. اکنون آن را امتحان کنید .
- rate
- رتبه پسندیدن یا نپسندیدن را به یک ویدیو اضافه کنید یا امتیازی را از یک ویدیو حذف کنید. اکنون آن را امتحان کنید .
- reportAbuse
- گزارش ویدیویی حاوی محتوای توهین آمیز. اکنون آن را امتحان کنید .
نمایندگی منابع
ساختار JSON زیر فرمت یک منبع videos
را نشان می دهد:
{ "kind": "youtube#video", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "tags": [ string ], "categoryId": string, "liveBroadcastContent": string, "defaultLanguage": string, "localized": { "title": string, "description": string }, "defaultAudioLanguage": string }, "contentDetails": { "duration": string, "dimension": string, "definition": string, "caption": string, "licensedContent": boolean, "regionRestriction": { "allowed": [ string ], "blocked": [ string ] }, "contentRating": { "acbRating": string, "agcomRating": string, "anatelRating": string, "bbfcRating": string, "bfvcRating": string, "bmukkRating": string, "catvRating": string, "catvfrRating": string, "cbfcRating": string, "cccRating": string, "cceRating": string, "chfilmRating": string, "chvrsRating": string, "cicfRating": string, "cnaRating": string, "cncRating": string, "csaRating": string, "cscfRating": string, "czfilmRating": string, "djctqRating": string, "djctqRatingReasons": [, string ], "ecbmctRating": string, "eefilmRating": string, "egfilmRating": string, "eirinRating": string, "fcbmRating": string, "fcoRating": string, "fmocRating": string, "fpbRating": string, "fpbRatingReasons": [, string ], "fskRating": string, "grfilmRating": string, "icaaRating": string, "ifcoRating": string, "ilfilmRating": string, "incaaRating": string, "kfcbRating": string, "kijkwijzerRating": string, "kmrbRating": string, "lsfRating": string, "mccaaRating": string, "mccypRating": string, "mcstRating": string, "mdaRating": string, "medietilsynetRating": string, "mekuRating": string, "mibacRating": string, "mocRating": string, "moctwRating": string, "mpaaRating": string, "mpaatRating": string, "mtrcbRating": string, "nbcRating": string, "nbcplRating": string, "nfrcRating": string, "nfvcbRating": string, "nkclvRating": string, "oflcRating": string, "pefilmRating": string, "rcnofRating": string, "resorteviolenciaRating": string, "rtcRating": string, "rteRating": string, "russiaRating": string, "skfilmRating": string, "smaisRating": string, "smsaRating": string, "tvpgRating": string, "ytRating": string }, "projection": string, "hasCustomThumbnail": boolean }, "status": { "uploadStatus": string, "failureReason": string, "rejectionReason": string, "privacyStatus": string, "publishAt": datetime, "license": string, "embeddable": boolean, "publicStatsViewable": boolean, "madeForKids": boolean, "selfDeclaredMadeForKids": boolean }, "statistics": { "viewCount": string, "likeCount": string, "dislikeCount": string, "favoriteCount": string, "commentCount": string }, "paidProductPlacementDetails": { "hasPaidProductPlacement": boolean }, "player": { "embedHtml": string, "embedHeight": long, "embedWidth": long }, "topicDetails": { "topicIds": [ string ], "relevantTopicIds": [ string ], "topicCategories": [ string ] }, "recordingDetails": { "recordingDate": datetime }, "fileDetails": { "fileName": string, "fileSize": unsigned long, "fileType": string, "container": string, "videoStreams": [ { "widthPixels": unsigned integer, "heightPixels": unsigned integer, "frameRateFps": double, "aspectRatio": double, "codec": string, "bitrateBps": unsigned long, "rotation": string, "vendor": string } ], "audioStreams": [ { "channelCount": unsigned integer, "codec": string, "bitrateBps": unsigned long, "vendor": string } ], "durationMs": unsigned long, "bitrateBps": unsigned long, "creationTime": string }, "processingDetails": { "processingStatus": string, "processingProgress": { "partsTotal": unsigned long, "partsProcessed": unsigned long, "timeLeftMs": unsigned long }, "processingFailureReason": string, "fileDetailsAvailability": string, "processingIssuesAvailability": string, "tagSuggestionsAvailability": string, "editorSuggestionsAvailability": string, "thumbnailsAvailability": string }, "suggestions": { "processingErrors": [ string ], "processingWarnings": [ string ], "processingHints": [ string ], "tagSuggestions": [ { "tag": string, "categoryRestricts": [ string ] } ], "editorSuggestions": [ string ] }, "liveStreamingDetails": { "actualStartTime": datetime, "actualEndTime": datetime, "scheduledStartTime": datetime, "scheduledEndTime": datetime, "concurrentViewers": unsigned long, "activeLiveChatId": string }, "localizations": { (key): { "title": string, "description": string } } }
خواص
جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:
خواص | |
---|---|
kind | string نوع منبع API را مشخص می کند. مقدار youtube#video خواهد بود. |
etag | etag Etag این منبع |
id | string شناسه ای که YouTube برای شناسایی منحصر به فرد ویدیو استفاده می کند. |
snippet | object شی snippet حاوی جزئیات اساسی درباره ویدیو، مانند عنوان، توضیحات و دسته بندی آن است. |
snippet. publishedAt | datetime تاریخ و ساعت انتشار ویدئو توجه داشته باشید که این زمان ممکن است با زمانی که ویدیو آپلود شده است متفاوت باشد. برای مثال، اگر ویدیویی بهعنوان یک ویدیوی خصوصی آپلود شود و بعداً عمومی شود، این ویژگی زمان عمومی شدن ویدیو را مشخص میکند. چند مورد خاص وجود دارد:
|
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 مقادیر کلیدی معتبر عبارتند از:
|
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 کاراکتر طول دارد. در مورد نحوه محاسبه محدودیت کاراکتر به قوانین زیر توجه کنید:
|
snippet. categoryId | string دسته ویدیوی YouTube مرتبط با ویدیو. اگر متد videos.update را فرا میخوانید و بخش snippet یک منبع video را بهروزرسانی میکنید، باید برای این ویژگی مقداری تنظیم کنید. |
snippet. liveBroadcastContent | string نشان می دهد که آیا ویدیو یک پخش زنده آتی/فعال است یا خیر. یا اگر ویدیو پخش زنده آتی/فعال نباشد، «هیچ» است. مقادیر معتبر برای این ویژگی عبارتند از:
|
snippet. defaultLanguage | string زبان متن در ویژگی های snippet.title و snippet.description منبع video . |
snippet. localized | object شی snippet.localized یا حاوی عنوان و توضیحات محلی برای ویدیو یا عنوان به زبان پیش فرض برای ابرداده ویدیو است.
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 ) یا فقط در کیفیت استاندارد موجود است.مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails. caption | string نشان می دهد که آیا زیرنویس برای ویدیو موجود است یا خیر. مقادیر معتبر برای این ویژگی عبارتند از:
|
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 برای طبقه بندی برنامه های تلویزیونی کودکان استفاده می شود. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. agcomRating | string رتبه بندی ویدیو از Autorità per le Garanzie nelle Comunicazioni (AGCOM) ایتالیا. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. anatelRating | string رتبه بندی آناتل (Asociación Nacional de Televisión) ویدیو برای تلویزیون شیلی. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. bbfcRating | string رتبه بندی این ویدیو توسط هیئت بریتانیایی طبقه بندی فیلم (BBFC). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. bfvcRating | string امتیاز این ویدیو از هیئت سانسور فیلم و ویدیو تایلند. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. bmukkRating | string رتبه بندی ویدیو از هیئت طبقه بندی رسانه اتریش (Bundesministerium für Unterricht, Kunst und Kultur). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. catvRating | string سیستم رتبهبندی تلویزیون کانادا - سیستم طبقهبندی تلویزیون کانادا رتبهبندی ویدیو از کمیسیون رادیو تلویزیون و ارتباطات راه دور کانادا (CRTC) برای پخشهای انگلیسی زبان کانادایی. برای اطلاعات بیشتر، به وب سایت شورای استانداردهای پخش کانادا مراجعه کنید. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. catvfrRating | string رتبه بندی ویدیو از کمیسیون رادیو تلویزیون و ارتباطات راه دور کانادا (CRTC) برای پخش های فرانسوی زبان کانادا. برای اطلاعات بیشتر، به وب سایت شورای استانداردهای پخش کانادا مراجعه کنید. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. cbfcRating | string امتیاز هیئت مرکزی صدور گواهینامه فیلم (CBFC - هند). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. cccRating | string امتیاز فیلم Consejo de Calificación Cinematográfica (شیلی). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. cceRating | string امتیاز ویدیو از Comissão de Classificação de Espect´culos پرتغال. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. chfilmRating | string رتبه بندی ویدیو در سوئیس. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. chvrsRating | string رتبهبندی سیستم رتبهبندی ویدیوی خانگی کانادا (CHVRS). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. cicfRating | string رتبه بندی ویدیو از کمیسیون کنترل فیلم (بلژیک). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. cnaRating | string رتبه بندی ویدیو از CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) رومانیایی. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. cncRating | string سیستم رتبه بندی در فرانسه - کمیسیون طبقه بندی سینماتوگرافیک مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. csaRating | string رتبه بندی ویدیو از Conseil supérieur de l?audiovisuel فرانسه که محتوای پخش شده را رتبه بندی می کند. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. cscfRating | string رتبه بندی ویدیو از کمیسیون نظارت بر طبقه بندی فیلم ها (CSCF) لوکزامبورگ. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. czfilmRating | string رتبه بندی ویدیو در جمهوری چک. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. djctqRating | string رتبه بندی Departamento de Justiça، Classificação، Qualificação e Títulos (DJCQT - برزیل). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. djctqRatingReasons[] | list دلایلی که توضیح میدهند چرا این ویدیو رتبه DJCQT (برزیل) خود را دریافت کرد. |
contentDetails.contentRating. ecbmctRating | string سیستم رتبه بندی در ترکیه - هیئت ارزیابی و طبقه بندی وزارت فرهنگ و گردشگری مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. eefilmRating | string رتبه بندی ویدیو در استونی. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. egfilmRating | string رتبه بندی ویدیو در مصر. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. eirinRating | string امتیاز Eirin (映倫) این ویدیو. Eirin سیستم رتبه بندی ژاپنی است. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. fcbmRating | string امتیاز این ویدیو از هیئت سانسور فیلم مالزی. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. fcoRating | string رتبه بندی ویدیو از دفتر اداره فیلم، روزنامه و مقاله هنگ کنگ. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. fmocRating | string این ویژگی از 2 نوامبر 2015 منسوخ شده است. به جای آن از ویژگی contentDetails.contentRating.cncRating استفاده کنید.امتیاز فیلم مرکز ملی سینما و تصویر انیمیشن (وزارت فرهنگ فرانسه). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. fpbRating | string رتبه بندی ویدیو از هیئت فیلم و انتشارات آفریقای جنوبی. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. fpbRatingReasons[] | list دلایلی که توضیح میدهند چرا این ویدیو امتیاز FPB (آفریقای جنوبی) خود را دریافت کرد. |
contentDetails.contentRating. fskRating | string رتبه بندی این ویدیو Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - آلمان). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. grfilmRating | string رتبه بندی ویدیو در یونان. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. icaaRating | string رتبه بندی این ویدیو به موسسه فیلمبرداری و هنر سمعی بصری (ICAA - اسپانیا). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. ifcoRating | string رتبه بندی دفتر رده بندی فیلم ایرلندی (IFCO - ایرلند) این ویدئو. برای اطلاعات بیشتر به وب سایت IFCO مراجعه کنید. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. ilfilmRating | string رتبه بندی ویدیو در اسرائیل. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. incaaRating | string امتیاز INCAA (Instituto Nacional de Cine y Artes Audiovisuales - آرژانتین) این ویدیو. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. kfcbRating | string رتبه بندی ویدیو از هیئت رده بندی فیلم کنیا. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. kijkwijzerRating | string voor de Classificatie van Audiovisuele Media (هلند). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. kmrbRating | string رتبه بندی هیئت رتبه بندی رسانه کره (영상물등급위원회). KMRB به ویدیوها در کره جنوبی امتیاز می دهد. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. lsfRating | string امتیاز ویدیو از فیلم حسگر لمباگا اندونزی. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. mccaaRating | string رتبه بندی این ویدیو از هیئت رده بندی سنی فیلم مالت. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. mccypRating | string امتیاز این ویدئو از شورای رسانه ای کودکان و نوجوانان موسسه فیلم دانمارکی (Det Danske Filminstitut). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. mcstRating | string سیستم رتبه بندی ویدیو برای ویتنام - MCST مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. mdaRating | string رتبه بندی این ویدیو از سازمان توسعه رسانه سنگاپور (MDA) و به طور خاص، هیئت سانسور فیلم (BFC). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. medietilsynetRating | string رتبه بندی ویدیو از Medietilsynet، سازمان رسانه ای نروژ. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. mekuRating | string رتبه بندی ویدیو از Kansallinen Audiovisuaalinen Instituutti (موسسه ملی سمعی و بصری) فنلاند. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. mibacRating | string رتبه بندی ویدیو از Ministero dei Beni e delle Attività Culturali e del Turismo (ایتالیا). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. mocRating | string رتبهبندی وزارت فرهنگ (کلمبیا) این ویدیو. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. moctwRating | string رتبه بندی ویدیو از وزارت فرهنگ تایوان (文化部). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. mpaaRating | string امتیاز انجمن تصویر متحرک آمریکا (MPAA) این ویدئو. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. mpaatRating | string رتبه بندی انجمن فیلم های سینمایی آمریکا برای تریلرها و پیش نمایش فیلم ها. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. mtrcbRating | string رتبه بندی ویدیو از هیئت بررسی و طبقه بندی فیلم و تلویزیون (فیلیپین). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. nbcRating | string رتبه بندی ویدیو از اداره ملی طبقه بندی مالدیو. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. nfrcRating | string رتبه بندی ویدیو از مرکز ملی فیلم بلغارستان . مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. nfvcbRating | string امتیاز این ویدیو از هیئت سانسور فیلم و ویدیوی ملی نیجریه. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. nkclvRating | string امتیاز ویدیو از Nacionãlais Kino centrs (مرکز ملی فیلم لتونی). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. oflcRating | string رتبه بندی دفتر فیلم و ادبیات طبقه بندی فیلم (OFLC - نیوزلند). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. pefilmRating | string امتیاز ویدیو در پرو. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. resorteviolenciaRating | string رتبه بندی ویدیو در ونزوئلا. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. rtcRating | string رتبهبندی اداره کل رادیو، تلویزیون و سینمای فیلم (مکزیک). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. rteRating | string رتبه بندی ویدیو از Raidió Teilifís Éireann از ایرلند. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. russiaRating | string امتیاز ثبت ملی فیلم فدراسیون روسیه (MKRF - روسیه). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. skfilmRating | string رتبه بندی ویدیو در اسلواکی. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. smaisRating | string رتبه بندی ویدیو در ایسلند. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. smsaRating | string رتبه بندی ویدیو از Statens medieråd (شورای رسانه ملی سوئد). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. tvpgRating | string رتبه بندی دستورالعمل های والدین تلویزیونی (TVPG). مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.contentRating. ytRating | string رتبهبندی که YouTube برای شناسایی محتوای دارای محدودیت سنی استفاده میکند. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails. projection | string فرمت نمایش ویدئو را مشخص می کند. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails. hasCustomThumbnail | boolean نشان می دهد که آیا آپلودکننده ویدیو یک تصویر کوچک سفارشی برای ویدیو ارائه کرده است یا خیر. این ویژگی فقط برای آپلودکننده ویدیو قابل مشاهده است. |
status | object شیء status حاوی اطلاعاتی درباره وضعیت آپلود، پردازش و حریم خصوصی ویدیو است. |
status. uploadStatus | string وضعیت ویدیوی آپلود شده. مقادیر معتبر برای این ویژگی عبارتند از:
|
status. failureReason | string این مقدار توضیح می دهد که چرا یک ویدیو بارگذاری نشد. این ویژگی تنها در صورتی وجود دارد که ویژگی uploadStatus نشان دهد که آپلود انجام نشد.مقادیر معتبر برای این ویژگی عبارتند از:
|
status. rejectionReason | string این مقدار توضیح می دهد که چرا YouTube یک ویدیوی آپلود شده را رد کرد. این ویژگی فقط در صورتی وجود دارد که ویژگی uploadStatus نشان دهد که آپلود رد شده است.مقادیر معتبر برای این ویژگی عبارتند از:
|
status. privacyStatus | string وضعیت حریم خصوصی ویدیو. مقادیر معتبر برای این ویژگی عبارتند از:
|
status. publishAt | datetime تاریخ و زمانی که قرار است ویدیو منتشر شود. فقط در صورتی می توان آن را تنظیم کرد که وضعیت حریم خصوصی ویدیو خصوصی باشد. مقدار در قالب ISO 8601 مشخص شده است. به دو نکته اضافی زیر در مورد رفتار این ویژگی توجه کنید:
|
status. license | string مجوز ویدیو مقادیر معتبر برای این ویژگی عبارتند از:
|
status. embeddable | boolean این مقدار نشان می دهد که آیا ویدیو می تواند در وب سایت دیگری جاسازی شود یا خیر. |
status. publicStatsViewable | boolean این مقدار نشان میدهد که آیا آمار ویدیوی توسعهیافته در صفحه تماشای ویدیو بهصورت عمومی قابل مشاهده است یا خیر. بهطور پیشفرض، این آمارها قابل مشاهده هستند و آمارهایی مانند تعداد بازدید و رتبهبندی یک ویدیو همچنان برای عموم قابل مشاهده هستند، حتی اگر مقدار این ویژگی روی false تنظیم شود. |
status. madeForKids | boolean این مقدار نشان میدهد که آیا ویدیو بهعنوان کارگردانی کودک تعیین شده است یا خیر، و حاوی وضعیت فعلی «ساخته شده برای کودکان» ویدیو است. برای مثال، وضعیت ممکن است بر اساس مقدار ویژگی selfDeclaredMadeForKids تعیین شود. برای اطلاعات بیشتر درباره تنظیم مخاطب برای کانال، ویدیوها یا پخشهای خود، به مرکز راهنمایی YouTube مراجعه کنید. |
status. selfDeclaredMadeForKids | boolean در یک درخواست videos.insert یا videos.update ، این ویژگی به مالک کانال اجازه میدهد ویدیو را بهعنوان کارگردانی کودک تعیین کند. در یک درخواست videos.list ، ارزش دارایی تنها در صورتی برگردانده میشود که مالک کانال درخواست API را مجاز کرده باشد. |
statistics | object شیء statistics حاوی آماری در مورد ویدیو است. |
statistics. viewCount | unsigned long تعداد دفعاتی که ویدیو مشاهده شده است. |
statistics. likeCount | unsigned long تعداد کاربرانی که نشان داده اند که ویدیو را پسندیده اند. |
statistics. dislikeCount | unsigned long توجه: دارایی statistics.dislikeCount از 13 دسامبر 2021 خصوصی شد. این بدان معنی است که این ویژگی تنها در صورتی در پاسخ API گنجانده میشود که درخواست API توسط مالک ویدیو تأیید شده باشد. برای اطلاعات بیشتر به تاریخچه ویرایش مراجعه کنید.تعداد کاربرانی که اعلام کردهاند که ویدیو را دوست ندارند. |
statistics. favoriteCount | unsigned long توجه: این ویژگی منسوخ شده است. استهلاک از 28 اوت 2015 قابل اجرا است. ارزش ملک اکنون همیشه روی 0 تنظیم شده است. |
statistics. commentCount | unsigned long تعداد نظرات برای ویدیو. |
paidProductPlacementDetails | object شی paidProductPlacementDetails حاوی اطلاعاتی درباره قرار دادن محصول پولی در ویدیو است. |
paidProductPlacementDetails. hasPaidProductPlacement | boolean اگر محتوا از قرار دادن محصول پولی استفاده می کند، روی true تنظیم کنید. پیش فرض ها به false . |
player | object شی player حاوی اطلاعاتی است که می توانید از آن برای پخش ویدیو در یک پخش کننده جاسازی شده استفاده کنید. |
player. embedHtml | string یک تگ <iframe> که پخش کننده ای را تعبیه می کند که ویدیو را پخش می کند. |
player. embedHeight | long ارتفاع پخش کننده تعبیه شده در ویژگی player.embedHtml برگردانده شد. این ویژگی تنها در صورتی برگردانده میشود که درخواست مقداری را برای پارامترهای maxHeight و/یا maxWidth مشخص کرده باشد و نسبت ابعاد ویدیو مشخص باشد. |
player. embedWidth | long عرض پخش کننده تعبیه شده در ویژگی player.embedHtml برگردانده شده است. این ویژگی تنها در صورتی برگردانده میشود که درخواست مقداری را برای پارامترهای maxHeight و/یا maxWidth مشخص کرده باشد و نسبت ابعاد ویدیو مشخص باشد. |
topicDetails | object شی topicDetails اطلاعات مربوط به موضوعات مرتبط با ویدیو را در خود جای می دهد.مهم: برای جزئیات بیشتر در مورد تغییرات آتی مربوط به شناسههای موضوع، تعاریف ویژگیهای topicDetails.relevantTopicIds[] و topicDetails.topicIds[] و همچنین تاریخچه بازبینی را ببینید. |
topicDetails. topicIds[] | list مهم: این ویژگی از 10 نوامبر 2016 منسوخ شده است. API دیگر مقادیری را برای این ویژگی برنمیگرداند و هر موضوع مرتبط با یک ویدیو اکنون با مقدار ویژگی topicDetails.relevantTopicIds[] برگردانده میشود. |
topicDetails. relevantTopicIds[] | list فهرستی از شناسههای موضوعی مرتبط با ویدیو. این ملک از 10 نوامبر 2016 منسوخ شده است و تا 10 نوامبر 2017 پشتیبانی می شود. مهم: به دلیل منسوخ شدن Freebase و Freebase API، شناسه های موضوع از 27 فوریه 2017 به طور متفاوت شروع به کار کردند. در آن زمان، YouTube شروع به بازگرداندن مجموعه کوچکی از شناسه های موضوع انتخاب شده کرد. |
topicDetails. topicCategories[] | list فهرستی از نشانیهای اینترنتی ویکیپدیا که توصیف سطح بالایی از محتوای ویدیو را ارائه میکنند. |
recordingDetails | object شی recordingDetails اطلاعات مربوط به مکان، تاریخ و آدرس محل ضبط ویدیو را در خود جای می دهد. |
recordingDetails. locationDescription | string این ملک از تاریخ 1 ژوئن 2017 منسوخ شده است. لطفاً برای جزئیات بیشتر به اطلاعیه انحلال مراجعه کنید. توضیحات متنی محل ضبط ویدیو. |
recordingDetails. location | object اطلاعات موقعیت جغرافیایی مرتبط با ویدیو. توجه داشته باشید که مقادیر ویژگی فرزند، مکانی را که مالک ویدیو میخواهد با ویدیو مرتبط کند، مشخص میکند. این مقدار قابل ویرایش، قابل جستجو در ویدیوهای عمومی است و ممکن است برای ویدیوهای عمومی به کاربران نمایش داده شود. |
recordingDetails.location. latitude | double این ملک از تاریخ 1 ژوئن 2017 منسوخ شده است. لطفاً برای جزئیات بیشتر به اطلاعیه انحلال مراجعه کنید. عرض جغرافیایی بر حسب درجه |
recordingDetails.location. longitude | double این ملک از تاریخ 1 ژوئن 2017 منسوخ شده است. لطفاً برای جزئیات بیشتر به اطلاعیه انحلال مراجعه کنید. طول جغرافیایی بر حسب درجه |
recordingDetails.location. altitude | double این ملک از تاریخ 9 جولای 2018 منسوخ شده است. لطفاً برای جزئیات بیشتر به اطلاعیه انصراف مراجعه کنید. ارتفاع بالای بیضی مرجع، بر حسب متر. |
recordingDetails. recordingDate | datetime تاریخ و زمان ضبط ویدیو. مقدار در قالب ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ) مشخص شده است. |
fileDetails | object شی fileDetails اطلاعات مربوط به فایل ویدیویی که در YouTube آپلود شده است، از جمله وضوح فایل، مدت زمان، کدکهای صوتی و تصویری، نرخ بیت جریان و موارد دیگر را در بر میگیرد. این دادهها را فقط مالک ویدیو میتواند بازیابی کند.شی fileDetails تنها در صورتی برگردانده می شود که ویژگی processingDetails.fileAvailability دارای مقدار available باشد. |
fileDetails. fileName | string نام فایل آپلود شده چه یک فایل ویدیویی یا نوع دیگری از فایل آپلود شده باشد، این فیلد وجود دارد. |
fileDetails. fileSize | unsigned long اندازه فایل آپلود شده بر حسب بایت چه یک فایل ویدیویی یا نوع دیگری از فایل آپلود شده باشد، این فیلد وجود دارد. |
fileDetails. fileType | string نوع فایل آپلود شده توسط موتور پردازش ویدیوی YouTube شناسایی شده است. در حال حاضر، یوتیوب فقط فایلهای ویدیویی را پردازش میکند، اما چه یک فایل ویدیویی یا نوع دیگری از فایل آپلود شده باشد، این فیلد وجود دارد. مقادیر معتبر برای این ویژگی عبارتند از:
|
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 برای چرخاندن محتوای منبع اصلی برای نمایش صحیح ویدیو نیاز دارد. مقادیر معتبر برای این ویژگی عبارتند از:
|
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 زیر پشتیبانی می شوند:
|
processingDetails | object شی processingDetails اطلاعاتی در مورد پیشرفت YouTube در پردازش فایل ویدیویی آپلود شده را در خود جای داده است. ویژگیهای موجود در شی، وضعیت پردازش فعلی و تخمینی از زمان باقیمانده تا پایان پردازش ویدیو توسط YouTube را شناسایی میکنند. این بخش همچنین نشان میدهد که آیا انواع مختلف داده یا محتوا، مانند جزئیات فایل یا تصاویر کوچک، برای ویدیو موجود است یا خیر.شی processingProgress برای نظرسنجی طراحی شده است تا ویدیوی آپلود شده بتواند پیشرفتی را که YouTube در پردازش فایل ویدیویی آپلود شده انجام داده است، ردیابی کند. این دادهها را فقط مالک ویدیو میتواند بازیابی کند. |
processingDetails. processingStatus | string وضعیت پردازش ویدیو. این مقدار نشان میدهد که آیا YouTube قادر به پردازش ویدیو بوده یا اینکه ویدیو هنوز در حال پردازش است. مقادیر معتبر برای این ویژگی عبارتند از:
|
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 باشد.مقادیر معتبر برای این ویژگی عبارتند از:
|
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 خواهد بود.مقادیر معتبر برای این ویژگی عبارتند از:
|
suggestions. processingWarnings[] | list فهرستی از دلایلی که ممکن است YouTube در رمزگذاری ویدیوی آپلود شده مشکل داشته باشد یا ممکن است منجر به رمزگذاری اشتباه شود. این هشدارها قبل از اینکه YouTube واقعاً فایل ویدیویی آپلود شده را پردازش کند، ایجاد میشود. علاوه بر این، آنها مشکلاتی را شناسایی میکنند که لزوماً نشان نمیدهند که پردازش ویدیو با شکست مواجه میشود، اما همچنان ممکن است مشکلاتی مانند مشکلات همگامسازی، مصنوعات ویدیویی یا یک تراک صوتی از دست رفته را ایجاد کند. مقادیر معتبر برای این ویژگی عبارتند از:
|
suggestions. processingHints[] | list فهرستی از پیشنهاداتی که ممکن است توانایی YouTube را برای پردازش ویدیو بهبود بخشد. مقادیر معتبر برای این ویژگی عبارتند از:
|
suggestions. tagSuggestions[] | list فهرستی از برچسبهای کلمه کلیدی که میتوانند به ابردادههای ویدیو اضافه شوند تا احتمال اینکه کاربران هنگام جستجو یا مرور در YouTube، ویدیوی شما را پیدا کنند، افزایش مییابد. |
suggestions.tagSuggestions[]. tag | string برچسب کلمه کلیدی پیشنهادی برای ویدیو. |
suggestions.tagSuggestions[]. categoryRestricts[] | list مجموعه ای از دسته بندی های ویدئویی که برچسب مربوط به آن است. میتوانید از این اطلاعات برای نمایش پیشنهادهای برچسب مناسب بر اساس دسته ویدیویی که آپلودکننده ویدیو با ویدیو مرتبط میکند، استفاده کنید. اگر هیچ محدودیتی برای کلمه کلیدی تعریف نشده باشد، به طور پیشفرض، پیشنهادات برچسب برای همه دستهها مرتبط هستند. |
suggestions. editorSuggestions[] | list فهرستی از عملیات ویرایش ویدیو که ممکن است کیفیت ویدیو یا تجربه پخش ویدیوی آپلود شده را بهبود بخشد. مقادیر معتبر برای این ویژگی عبارتند از:
|
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 توضیحات ویدیوی محلی. |