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

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

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

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

تنظیم اطلاعات نمانام‌سازی کانال

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

  • مرحله ۱: بازیابی گزینه‌های نمانام‌سازی کانال

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

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

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

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

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

    • دارایی id را روی شناسه کانال YouTube یکتای کانال تنظیم کنید. شناسه را می‌توان از پاسخ میانای برنامه‌سازی کاربردی در مرحله ۱ استخراج کرد.
    • مقدار پارامتر part را روی brandingSettings تنظیم کنید.

    پیوند «کاوشگر API» در زیر منبع 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

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

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

نمونه زیر بخش‌های کانال را برای کانال رسمی YouTube متعلق به Google بازیابی می‌کند. درخواست، روش 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 تصویر ته‌نقش کانال را حذف می‌کند.

متأسفانه این پُرسمان را نمی‌توانید بااستفاده از «کاوشگر میاناهای برنامه‌سازی کاربردی» آزمایش کنید زیرا «کاوشگر میاناهای برنامه‌سازی کاربردی» از قابلیت بارگذاری فایل‌های رسانه پشتیبانی نمی‌کند و این قابلیت برای این روش الزامی است.