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

توضّح هذه الصفحة كيفية استخدام 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 إلى حذف صورة العلامة المائية للقناة.

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