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

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