Playlists

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

YouTube همچنین از لیست‌های پخش برای شناسایی مجموعه‌های ویژه ویدیوها برای یک کانال استفاده می‌کند، مانند:

• ویدیوهای آپلود شده
• ویدیوهای دارای امتیاز مثبت (پسندیده)

برای دقیق تر، این لیست ها با یک کانال مرتبط هستند که مجموعه ای از ویدیوها، لیست های پخش و سایر اطلاعات YouTube یک شخص، گروه یا شرکت است. می‌توانید شناسه‌های فهرست پخش هر یک از این فهرست‌ها را از channel resource برای یک کانال خاص بازیابی کنید.

سپس می توانید از روش playlistItems.list برای بازیابی هر یک از آن لیست ها استفاده کنید. همچنین می‌توانید با فراخوانی روش‌های playlistItems.insert و playlistItems.delete موارد را از آن فهرست‌ها اضافه یا حذف کنید.

مواد و روش ها

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

list

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

insert

یک لیست پخش ایجاد می کند. اکنون آن را امتحان کنید .

update

یک لیست پخش را اصلاح می کند. برای مثال، می‌توانید عنوان، توضیحات یا وضعیت حریم خصوصی فهرست پخش را تغییر دهید. اکنون آن را امتحان کنید .

delete

یک لیست پخش را حذف می کند. اکنون آن را امتحان کنید .

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

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

{
  "kind": "youtube#playlist",
  "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,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    }
  },
  "status": {
    "privacyStatus": string
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

خواص

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

خواص
kind	string نوع منبع API را مشخص می کند. مقدار youtube#playlist خواهد بود.
etag	etag Etag این منبع
id	string شناسه ای که YouTube برای شناسایی منحصر به فرد لیست پخش استفاده می کند.
snippet	object شی snippet حاوی جزئیات اساسی درباره لیست پخش، مانند عنوان و توضیحات آن است.
snippet. publishedAt	datetime تاریخ و زمانی که لیست پخش ایجاد شد. مقدار در قالب ISO 8601 مشخص شده است.
snippet. channelId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد کانالی که لیست پخش را منتشر کرده است، استفاده می‌کند.
snippet. title	string عنوان لیست پخش
snippet. description	string توضیحات لیست پخش
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 این ملک منسوخ شده است. برچسب های کلمه کلیدی مرتبط با لیست پخش.
snippet. defaultLanguage	string زبان متن در ویژگی‌های snippet.title و snippet.description منبع playlist .
snippet. localized	object شی snippet.localized شامل عنوان و توضیحات محلی برای لیست پخش یا عنوان به زبان پیش فرض برای فراداده لیست پخش است. در صورتی که درخواست playlists.list از پارامتر hl برای تعیین زبانی استفاده کند که متن محلی برای آن باید برگردانده شود و متن محلی شده در آن زبان موجود باشد، متن محلی در قطعه منبع برگردانده می شود. اگر مقدار پارامتر hl مشخص نشده باشد یا مقداری مشخص شده باشد اما فراداده محلی برای زبان مشخص شده در دسترس نباشد، متادیتا برای زبان پیش‌فرض برگردانده می‌شود. ویژگی حاوی یک مقدار فقط خواندنی است. از شی localizations ها برای افزودن، به روز رسانی یا حذف عناوین بومی سازی شده استفاده کنید.
snippet.localized. title	string عنوان لیست پخش بومی شده
snippet.localized. description	string شرح فهرست پخش محلی.
status	object شی status حاوی اطلاعات وضعیت لیست پخش است.
status. privacyStatus	string وضعیت حریم خصوصی لیست پخش. مقادیر معتبر برای این ویژگی عبارتند از: private public unlisted
contentDetails	object شی contentDetails حاوی اطلاعاتی درباره محتوای لیست پخش، از جمله تعداد ویدیوهای موجود در لیست پخش است.
contentDetails. itemCount	unsigned integer تعداد ویدیوهای موجود در لیست پخش.
player	object شی player حاوی اطلاعاتی است که می توانید از آنها برای پخش لیست پخش در یک پخش کننده جاسازی شده استفاده کنید.
player. embedHtml	string یک تگ <iframe> که پخش کننده ای را تعبیه می کند که لیست پخش را پخش می کند.
localizations	object شی localizations ها ترجمه های فراداده لیست پخش را در بر می گیرد.
localizations. (key)	object زبان متن محلی مرتبط با مقدار کلید. مقدار رشته ای است که حاوی کد زبان BCP-47 است.
localizations.(key). title	string عنوان لیست پخش بومی شده
localizations.(key). description	string شرح فهرست پخش محلی.