التنفيذ: القنوات

تشرح هذه الصفحة كيفية استخدام YouTube Data API (الإصدار 3) لتنفيذ وظائف متعلقة باسترداد بيانات القناة وتعديلها. يتضمّن مصدر channel أرقام تعريف قوائم التشغيل التي تحدّد الفيديوهات التي تم تحميلها وفيديوهات أعجبتك في القناة. لاسترداد هذه المعلومات عند استدعاء طريقة channels.list، تأكّدوا من أنّ قيمة المَعلمة part تتضمّن جزء مصدر contentDetails.

استرداد معلومات عن قناة

استدعوا طريقة channels.list لاسترداد معلومات عن قناة معيّنة. هناك عدة طرق لتحديد القناة:

• اضبطوا قيمة المَعلمة mine على true لاسترداد معلومات عن قناة على YouTube الخاصة بالمستخدم الذي تمّت المصادقة عليه حاليًا. يجب منح الإذن لطلبكم باستخدام 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 لاسترداد معلومات عن قناة Google الرسمية على YouTube.

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

• اضبطوا المَعلمة id على معرّف قناة YouTube الذي يحدّد بشكل فريد القناة التي تستردّون معلومات عنها. يضبط هذا المثال المَعلمة id على UCK8sQmJBp8GCxrOtXWBpyEA، الذي يحدّد أيضًا قناة Google الرسمية على YouTube.

  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 الفريد. يمكن استخراج المعرّف من الردّ من واجهة برمجة التطبيقات في الخطوة 1.
  • اضبطوا قيمة المَعلمة part على brandingSettings.

  يؤدي الرابط إلى مستكشف واجهات برمجة التطبيقات أدناه إلى إنشاء مورد 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"
      }
    }
  }

  لإكمال الطلب في مستكشف واجهات برمجة التطبيقات، عليكم ضبط قيمة السمة id على معرّف قناة المستخدم الذي تمّت المصادقة عليه. عليكم أيضًا ضبط خصائص الصورة لتتطابق مع إعداداتكم الحالية.

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

إدارة أقسام القناة

تتيح واجهة برمجة التطبيقات الطرق channelSections.list وchannelSections.insert وchannelSections.update وchannelSections.delete لإدارة أقسام القناة. قسم القناة هو مجموعة من الفيديوهات المعروضة في قناة. على سبيل المثال، يمكن أن يتضمّن القسم أحدث الفيديوهات التي تم تحميلها أو الفيديوهات الأكثر رواجًا أو فيديوهات من قائمة تشغيل واحدة أو أكثر.

يستردّ المثال أدناه أقسام القناة لقناة Google الرسمية على YouTube. يستدعي الطلب طريقة channelSections.list ويضبط قيمة المَعلمة channelId على UCK8sQmJBp8GCxrOtXWBpyEA، وهو معرّف قناة Google.

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

يتطلّب هذا الطلب منح الإذن إذا ضبطتم قيمة المَعلمة mine على true بدلاً من استخدام المَعلمة channelId. تشير هذه المَعلمة إلى أنّكم تستردّون أقسام القناة لقناة المستخدم الذي تمّت المصادقة عليه حاليًا.

تحميل صورة علامة مائية وضبطها لقناة

يمكنكم استدعاء طريقة watermarks.set لتحميل صورة علامة مائية وضبطها لقناة. بعد ذلك، تظهر الصورة أثناء تشغيل فيديوهات القناة المحدّدة. يمكنكم أيضًا تحديد قناة مستهدَفة سترتبط بها الصورة، بالإضافة إلى تفاصيل التوقيت التي تحدّد متى تظهر العلامة المائية ومدة ظهورها.

تحذف طريقة watermarks.unset صورة العلامة المائية لقناة.

للأسف، لا يمكن اختبار هذا الاستعلام باستخدام مستكشف واجهات برمجة التطبيقات لأنّه لا يتيح إمكانية تحميل ملفات الوسائط، وهو شرط لاستخدام هذه الطريقة.