پیاده سازی: کانال ها

این صفحه نحوه استفاده از YouTube Data API (v3) را برای انجام عملکردهای مربوط به بازیابی و به‌روزرسانی داده‌های کانال توضیح می‌دهد. یک منبع channel شامل شناسه‌های لیست پخش است که ویدیوهای آپلود شده و پسندیده کانال را شناسایی می‌کند. برای واکشی این اطلاعات هنگام فراخوانی روش channels.list ، مطمئن شوید که مقدار پارامتر part شامل قسمت منبع contentDetails باشد.

بازیابی اطلاعات مربوط به یک کانال

برای بازیابی اطلاعات یک کانال خاص، روش channels.list را فراخوانی کنید. چند راه برای شناسایی کانال وجود دارد:

اطلاعات برندینگ کانال را تنظیم کنید

این مثال گزینه های برندسازی کانال را به روز می کند. مثال دو مرحله دارد:

  • مرحله 1: گزینه های برندسازی کانال را بازیابی کنید

    متد channels.list فراخوانی کنید و مقدار پارامتر part را روی brandingSettings و مقدار پارامتر mine را روی true تنظیم کنید.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    برنامه شما می تواند تنظیمات بازیابی شده را نمایش دهد و به کاربر امکان می دهد تنظیمات را برای به روز رسانی تغییر دهد.

  • مرحله 2: گزینه های برندسازی کانال را به روز کنید

    متد channels.list را فراخوانی کنید و مقادیر زیر را تنظیم کنید:

    • ویژگی id را روی شناسه کانال YouTube منحصر به فرد کانال تنظیم کنید. شناسه را می توان از پاسخ API در مرحله 1 استخراج کرد.
    • مقدار پارامتر part را روی brandingSettings تنظیم کنید.

    پیوند به API Explorer زیر یک منبع channel با تنظیمات نام تجاری زیر ایجاد می کند:

    {
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}

    برای تکمیل درخواست در APIs Explorer، باید مقدار ویژگی id را روی شناسه کانال کانال کاربر تأیید شده تنظیم کنید. همچنین باید ویژگی های تصویر را مطابق با تنظیمات فعلی خود تنظیم کنید.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings

مدیریت بخش های کانال

API از روش های channelSections.list ، channelSections.insert ، channelSections.update و channelSections.delete برای مدیریت بخش های کانال پشتیبانی می کند. بخش کانال مجموعه ای از ویدیوهایی است که در یک کانال نمایش داده می شوند. برای مثال، یک بخش می‌تواند شامل آخرین بارگذاری‌های کانال، محبوب‌ترین آپلودها یا ویدیوهای یک یا چند فهرست پخش باشد.

مثال زیر بخش‌های کانال را برای کانال رسمی YouTube گوگل بازیابی می‌کند. این درخواست روش channelSections.list را فراخوانی می‌کند و مقدار پارامتر channelId را روی UCK8sQmJBp8GCxrOtXWBpyEA تنظیم می‌کند که شناسه کانال برای کانال Google است. 

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

اگر به جای استفاده از پارامتر channelId ، مقدار پارامتر mine را روی true تنظیم کنید، این درخواست به مجوز نیاز دارد. این پارامتر نشان می دهد که شما در حال بازیابی بخش های کانال برای کانال کاربر تأیید شده فعلی هستید.

یک تصویر واترمارک برای یک کانال آپلود و تنظیم کنید

می توانید برای آپلود تصویر واترمارک و تنظیم آن برای یک کانال، متد watermarks.set فراخوانی کنید. سپس تصویر در حین پخش ویدیوهای کانال مشخص شده نمایش داده می شود. همچنین می‌توانید یک کانال هدف که تصویر به آن پیوند می‌یابد و همچنین جزئیات زمان‌بندی که تعیین می‌کند واترمارک چه زمانی ظاهر می‌شود و چه مدت قابل مشاهده است را مشخص کنید.

روش watermarks.unset تصویر واترمارک کانال را حذف می کند.

متأسفانه، این پرس و جو را نمی توان با استفاده از APIs Explorer آزمایش کرد، زیرا APIs Explorer از توانایی آپلود فایل های رسانه ای پشتیبانی نمی کند، که لازمه این روش است.