Subscriptions

يحتوي مورد subscription على معلومات حول اشتراك مستخدم YouTube. يُبلغ الاشتراك المستخدم عند إضافة فيديوهات جديدة إلى قناة أو عندما يتخذ مستخدم آخر أحد الإجراءات المتعددة على YouTube، مثل تحميل فيديو أو تقييم فيديو أو التعليق على فيديو.

الطُرق

تتوافق واجهة برمجة التطبيقات مع الطرق التالية لموردَين (subscriptions):

list

عرض موارد الاشتراك التي تطابق معايير طلب واجهة برمجة التطبيقات. التجربة الآن

إدراج

لإضافة اشتراك في قناة المستخدم الذي تمت المصادقة عليه. التجربة الآن

حذف

حذف اشتراك. التجربة الآن

تمثيل الموارد

تعرض بنية JSON التالية تنسيق مورد subscriptions:

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

أماكن إقامة

يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:

أماكن إقامة
kind	string تحدد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#subscription.
etag	etag Etag لهذا المورد.
id	string المعرّف الذي تستخدمه منصة YouTube لتعريف الاشتراك بشكل فريد
snippet	object يحتوي الكائن snippet على تفاصيل أساسية عن الاشتراك، بما في ذلك عنوانه والقناة التي اشترك فيها المستخدم.
snippet.publishedAt	datetime تاريخ إنشاء الاشتراك ووقته. يتم تحديد القيمة بتنسيق ISO 8601.
snippet.channelTitle	string تمثّل هذه السمة عنوان القناة التي ينتمي إليها الاشتراك.
snippet.title	string عنوان الاشتراك
snippet.description	string تفاصيل الاشتراك
snippet.resourceId	object يحتوي الكائن id على معلومات حول القناة التي اشترك فيها المستخدم.
snippet.resourceId.kind	string نوع مورد واجهة برمجة التطبيقات.
snippet.resourceId.channelId	string القيمة التي يستخدمها YouTube لتحديد القناة التي اشترك فيها المستخدم بشكل فريد.
snippet.channelId	string المعرّف الذي يستخدمه YouTube لتحديد قناة المشترك بشكل فريد يحدد الكائن resource_id القناة التي اشترك فيها المستخدم.
snippet.thumbnails	object خريطة تضمّ صورًا مصغّرة مرتبطة بالاشتراك بالنسبة إلى كل كائن على الخريطة، يكون المفتاح هو اسم الصورة المصغّرة، والقيمة هي كائن يحتوي على معلومات أخرى حول الصورة المصغّرة.
snippet.thumbnails.(key)	object القيم الأساسية الصالحة هي: default – الصورة المصغّرة التلقائية لهذا المورد. الصورة المصغرة الافتراضية لمقطع فيديو - أو مورد يشير إلى فيديو، مثل عنصر قائمة تشغيل أو نتيجة بحث - يبلغ عرضها 120 بكسل وطولها 90 بكسل. يبلغ عرض الصورة المصغّرة التلقائية للقناة 88 بكسل وطولها 88 بكسل. medium – نسخة بدقة أعلى من الصورة المصغّرة. بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يبلغ عرض هذه الصورة 320 بكسل وطولها 180 بكسل. بالنسبة إلى القناة، يبلغ عرض هذه الصورة 240 بكسل وطولها 240 بكسل. high – نسخة بدقة عالية من الصورة المصغّرة. بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يبلغ عرض هذه الصورة 480 بكسل وطولها 360 بكسل. بالنسبة إلى القناة، يبلغ عرض هذه الصورة 800 بكسل وطولها 800 بكسل.
snippet.thumbnails.(key).url	string عنوان URL للصورة.
snippet.thumbnails.(key).width	unsigned integer عرض الصورة.
snippet.thumbnails.(key).height	unsigned integer ارتفاع الصورة
contentDetails	object يحتوي الكائن contentDetails على إحصاءات أساسية عن الاشتراك.
contentDetails.totalItemCount	unsigned integer العدد التقريبي للعناصر التي يشير إليها الاشتراك.
contentDetails.newItemCount	unsigned integer عدد العناصر الجديدة في الاشتراك منذ آخر مرة تمت قراءة محتواه.
contentDetails.activityType	string نوع النشاط لهذا الاشتراك (للتحميل فقط، كل شيء). القيم الصالحة لهذا الموقع هي: all uploads
subscriberSnippet	object يحتوي الكائن subscriberSnippet على تفاصيل أساسية عن المشترك.
subscriberSnippet.title	string تمثّل هذه السمة عنوان قناة المشترك.
subscriberSnippet.description	string وصف قناة المشترك.
subscriberSnippet.channelId	string المعرّف الذي يعيّنه YouTube لتحديد قناة المشترك بشكل فريد.
subscriberSnippet.thumbnails	object صور مصغّرة لقناة المشترك
subscriberSnippet.thumbnails.(key)	object القيم الأساسية الصالحة هي: default – الصورة المصغّرة التلقائية لهذا المورد. الصورة المصغرة الافتراضية لمقطع فيديو - أو مورد يشير إلى فيديو، مثل عنصر قائمة تشغيل أو نتيجة بحث - يبلغ عرضها 120 بكسل وطولها 90 بكسل. يبلغ عرض الصورة المصغّرة التلقائية للقناة 88 بكسل وطولها 88 بكسل. medium – نسخة بدقة أعلى من الصورة المصغّرة. بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يبلغ عرض هذه الصورة 320 بكسل وطولها 180 بكسل. بالنسبة إلى القناة، يبلغ عرض هذه الصورة 240 بكسل وطولها 240 بكسل. high – نسخة بدقة عالية من الصورة المصغّرة. بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يبلغ عرض هذه الصورة 480 بكسل وطولها 360 بكسل. بالنسبة إلى القناة، يبلغ عرض هذه الصورة 800 بكسل وطولها 800 بكسل.
subscriberSnippet.thumbnails.(key).url	string عنوان URL للصورة.
subscriberSnippet.thumbnails.(key).width	unsigned integer عرض الصورة.
subscriberSnippet.thumbnails.(key).height	unsigned integer ارتفاع الصورة