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

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

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

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

• برای بازیابی اطلاعات کانال یوتیوب کاربر تأیید شده فعلی، مقدار پارامتر mine را روی true تنظیم کنید. درخواست شما باید با استفاده از OAuth 2.0 مجاز باشد.

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

• پارامتر forUsername را روی نام کاربری YouTube تنظیم کنید تا اطلاعات کانال مرتبط با آن نام کاربری را بازیابی کنید. این مثال مقدار پارامتر forUsername را به Google برای بازیابی اطلاعات برای کانال رسمی YouTube Google تنظیم می کند.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
          part=snippet,contentDetails
          &forUsername=Google

• پارامتر id را روی شناسه کانال YouTube تنظیم کنید که به طور منحصربه‌فرد کانالی را که اطلاعات آن را بازیابی می‌کنید مشخص می‌کند. این مثال پارامتر id را روی UCK8sQmJBp8GCxrOtXWBpyEA تنظیم می کند که کانال رسمی YouTube Google را نیز مشخص می کند.

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

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

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

• مرحله 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 از توانایی آپلود فایل های رسانه ای پشتیبانی نمی کند، که لازمه این روش است.