تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

التنفيذ: الاشتراكات

توضح الأمثلة التالية كيفية استخدام YouTube Data API (الإصدار 3) لتنفيذ وظائف ذات صلة بالاشتراكات.

استرداد اشتراكات قناة

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

لاسترداد اشتراكات المستخدم المصادَق عليه حاليًا، يمكنك ضبط قيمة المعلَمة mine على true. تجدر الإشارة إلى أن الطلب الذي يستخدم المَعلمة mine يجب تفويضه باستخدام OAuth 2.0.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mine=true
```
لاسترداد الاشتراكات لأي قناة أخرى، عيّن قيمة المعلمة channelId على معرّف قناة YouTube الفريد لهذه القناة. يسترد المثال أدناه قائمة بالقنوات التي اشتركت فيها قناة TED على YouTube.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &channelId=UCAuUUnT6oDeKwE6v1NGQxug
```
ملاحظة: تعرض واجهة برمجة التطبيقات رمز استجابة HTTP 403 (Forbidden) إذا لم تكشف القناة المحددة اشتراكاتها ولم يكن مالك القناة قد فوّض الطلب.

يمكنك الاطّلاع على وثائق طريقة subscriptions.list للحصول على نماذج رموز.

إضافة اشتراك

يُرجى الاتصال بالطريقة subscriptions.insert لإضافة اشتراك في قناة. يجب تفويض هذا الطلب باستخدام OAuth 2.0. نص الطلب هو مورد subscription يضبط القيم التالية:

يحتوي snippet.resourceId.kind على القيمة youtube#channel.
تحدد السمة snippet.resourceId.channelId القناة التي تشترك فيها. إن قيمة الخاصية هي معرف قناة YouTube فريد. يمكن الحصول على معرّف القناة بعدّة طرق، بما في ذلك استخدام طريقة channels.list أو استرداد نتائج البحث عن قنوات.

بموجب طلب واجهة برمجة التطبيقات أدناه، يمكنك الاشتراك في قناة TED على YouTube:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

نص الطلب هو:

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

يمكنك الاطّلاع على وثائق طريقة subscriptions.insert للحصول على نماذج رموز.

حذف اشتراك

يؤدي هذا المثال إلى حذف اشتراك. يجب تفويض هذا الطلب باستخدام OAuth 2.0. يتضمن هذا المثال خطوتين:

الخطوة 1: استرداد الاشتراكات لقناة المستخدم التي تمت المصادقة عليها

يمكنك استدعاء طريقة subscriptions.list لاسترداد قائمة الاشتراكات. يوضح المثال أعلاه لاسترداد اشتراكات قناة كيفية تقديم هذا الطلب.

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

يمكنك استدعاء طريقة subscriptions.delete لحذف اشتراك. اضبط مَعلمة id للطلب على رقم تعريف الاشتراك للاشتراك الذي تريد إزالته. يجب تفويض هذا الطلب باستخدام OAuth 2.0.

لإكمال الطلب في مستكشف واجهات برمجة التطبيقات، يجب ضبط قيمة الخاصية id.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
        id=SUBSCRIPTION_ID
```

يمكنك الاطّلاع على وثائق طريقة subscriptions.delete للحصول على نماذج رموز.

استرداد قائمة المشتركين في قناة المستخدم المصرح له

لاسترداد قائمة القنوات التي اشتركت في قناة المستخدم التي تمت مصادقتها حاليًا، يمكنك استدعاء طريقة subscriptions.list وتعيين قيمة المعلمة mySubscribers على true. يجب تفويض الطلب باستخدام OAuth 2.0.

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