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.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 تمثّل هذه السمة ارتفاع الصورة.