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

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

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

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

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

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

تتيح واجهة برمجة التطبيقات استخدام الطرق channelSection.list وchannelSection.insert وchannelSection.update وchannelSection.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 إلى حذف صورة العلامة المائية لقناة معيّنة.

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