Activities

أوقفت منصة YouTube ميزة نشرة القناة نهائيًا. لا تعرض الطريقة activities.list نشرات القنوات إلى الآن، كما لم تعُد الطريقة activities.insert متاحة. لمزيد من التفاصيل، يُرجى مراجعة مركز مساعدة YouTube.

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

الطُرق

تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد activities:

list

عرض قائمة بأحداث أنشطة القناة التي تطابق معايير الطلب. على سبيل المثال، يمكنك استرداد الأحداث المرتبطة بقناة معيّنة أو بقناة المستخدم الخاصة. التجربة الآن

لم تعُد طريقة activities.insert متاحة.

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

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

{
  "kind": "youtube#activity",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "type": string,
    "groupId": string
  },
  "contentDetails": {
    "upload": {
      "videoId": string
    },
    "like": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "favorite": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      }
    },
    "subscription": {
      "resourceId": {
        "kind": string,
        "channelId": string,
      }
    },
    "playlistItem": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      },
      "playlistId": string,
      "playlistItemId": string
    },
    "recommendation": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      },
      "reason": string,
      "seedResourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      }
    },
    "social": {
      "type": string,
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      },
      "author": string,
      "referenceUrl": string,
      "imageUrl": string
    },
    "channelItem": {
      "resourceId": {
      }
    },
  }
}

أماكن إقامة

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

أماكن إقامة
kind	string يحدّد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#activity.
etag	etag علامة هذا المرجع.
id	string المعرّف الذي تستخدمه منصة YouTube لتحديد النشاط بشكل فريد.
snippet	object يحتوي العنصر snippet على تفاصيل أساسية حول النشاط، بما في ذلك نوع النشاط ورقم تعريف المجموعة.
snippet.publishedAt	datetime تاريخ ووقت حدوث النشاط. ويتم تحديد القيمة بتنسيق ISO 8601.
snippet.channelId	string المعرّف الذي تستخدمه منصة YouTube لتحديد القناة المرتبطة بالنشاط
snippet.title	string عنوان المورد المرتبط بالنشاط في المقام الأول.
snippet.description	string وصف المورد المرتبط بالنشاط في المقام الأول.
snippet.thumbnails	object خريطة للصور المصغّرة المرتبطة بالمورد المرتبط بالنشاط في المقام الأول. بالنسبة لكل كائن في الخريطة، يكون المفتاح هو اسم الصورة المصغرة، والقيمة هي كائن يحتوي على معلومات أخرى حول الصورة المصغرة.
snippet.thumbnails.(key)	object في ما يلي قيم المفاتيح الصالحة: default – الصورة المصغّرة التلقائية الصورة المصغّرة الافتراضية للفيديو - أو مورد يشير إلى فيديو، مثل عنصر قائمة تشغيل أو نتيجة بحث - هو عرض يبلغ 120 بكسل وطول 90 بكسل. الصورة المصغّرة الافتراضية للقناة هي عرض 88 بكسل وطول 88 بكسل. medium – نسخة بدرجة دقة أعلى من الصورة المصغّرة بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يكون عرض هذه الصورة 320 بكسل وطولها 180 بكسل. بالنسبة إلى القناة، يكون عرض هذه الصورة 240 بكسل وطولها 240 بكسل. high – نسخة عالية الدقة من الصورة المصغّرة بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يكون عرض هذه الصورة 480 بكسل وطولها 360 بكسل. بالنسبة إلى القناة، يكون عرض هذه الصورة 800 بكسل وطول 800 بكسل. standard – نسخة بدرجة دقة أعلى من الصورة المصغّرة بدرجة دقة high. تتوفر هذه الصورة لبعض الفيديوهات وموارد أخرى تشير إلى الفيديوهات، مثل عناصر قوائم التشغيل أو نتائج البحث. يبلغ عرض هذه الصورة 640 بكسل وطولها 480 بكسل. maxres – النسخة الأعلى دقة من الصورة المصغّرة يتوفر هذا الحجم من الصورة لبعض الفيديوهات وموارد أخرى تشير إلى الفيديوهات، مثل عناصر قوائم التشغيل أو نتائج البحث. يبلغ عرض هذه الصورة 1280 بكسل وطولها 720 بكسل.
snippet.thumbnails.(key).url	string عنوان URL للصورة:
snippet.thumbnails.(key).width	unsigned integer عرض الصورة.
snippet.thumbnails.(key).height	unsigned integer ارتفاع الصورة.
snippet.channelTitle	string عنوان القناة المسؤولة عن هذا النشاط
snippet.type	string نوع النشاط الذي يصفه المورد. القيم الصالحة لهذه السمة هي: channelItem comment – (لا يتم عرضها حاليًا) favorite like playlistItem promotedItem recommendation social subscription upload bulletin (متوقّفة نهائيًا)
snippet.groupId	string رقم تعريف المجموعة المرتبط بالنشاط. يحدِّد رقم تعريف المجموعة أحداث المستخدمين المرتبطة بالمستخدم نفسه والمورد نفسه. على سبيل المثال، إذا قيّم أحد المستخدمين فيديو ووضع علامة على الفيديو نفسه كفيديو مفضّل، سيكون للإدخالات في هذه الأحداث معرّف المجموعة نفسه في خلاصة نشاط المستخدم. في واجهة المستخدِم، يمكنك تجنُّب التكرار عن طريق تجميع الأحداث بقيمة groupId نفسها.
contentDetails	object يحتوي الكائن contentDetails على معلومات حول المحتوى المرتبط بالنشاط. على سبيل المثال، إذا كانت قيمة snippet.type هي videoRated، سيحدّد محتوى العنصر contentDetails الفيديو المصنّف.
contentDetails.upload	object يحتوي الكائن upload على معلومات حول الفيديو الذي تم تحميله. ولا تتوفّر هذه السمة إلا إذا كانت قيمة snippet.type هي upload.
contentDetails.upload.videoId	string تمثّل هذه السمة المعرّف الذي تستخدمه منصة YouTube لتحديد الفيديو الذي تم تحميله بشكل فريد.
contentDetails.like	object يحتوي الكائن like على معلومات حول مورد حصل على تقييم إيجابي (إبداء الإعجاب). ولا تتوفّر هذه السمة إلا إذا كانت قيمة snippet.type هي like.
contentDetails.like.resourceId	object يحتوي الكائن resourceId على معلومات تحدّد المورد الذي تم تقييمه.
contentDetails.like.resourceId.kind	string نوع مورد واجهة برمجة التطبيقات.
contentDetails.like.resourceId.videoId	string المعرّف الذي تستخدمه YouTube لتعريف الفيديو بشكل فريد إذا كان المورد الذي تم تقييمه عبارة عن فيديو. ولا تتوفّر هذه السمة إلا إذا كانت قيمة resourceId.kind هي youtube#video.
contentDetails.favorite	object يحتوي الكائن favorite على معلومات حول فيديو تم تصنيفه كفيديو مفضّل. ولا تتوفّر هذه السمة إلا إذا كانت قيمة snippet.type هي favorite.
contentDetails.favorite.resourceId	object يحتوي الكائن resourceId على معلومات تحدِّد المورد الذي تم وضع علامة عليه كمفضّل.
contentDetails.favorite.resourceId.kind	string نوع مورد واجهة برمجة التطبيقات.
contentDetails.favorite.resourceId.videoId	string المعرّف الذي تستخدمه منصة YouTube لتحديد الفيديو المفضّل بشكل فريد لا تتوفّر هذه السمة إلا إذا كانت السمة resourceId.kind هي youtube#video. ملاحظة: لا تعرض الطريقة activities.list حاليًا موارد للتعليقات الجديدة.
contentDetails.comment	object يحتوي الكائن comment على معلومات حول مورد تلقّى تعليقًا. ولا تتوفّر هذه السمة إلا إذا كانت قيمة snippet.type هي comment.
contentDetails.comment.resourceId	object يحتوي الكائن resourceId على معلومات تحدّد المورد المرتبط بالتعليق.
contentDetails.comment.resourceId.kind	string نوع مورد واجهة برمجة التطبيقات.
contentDetails.comment.resourceId.videoId	string المعرّف الذي تستخدمه منصة YouTube لتحديد الفيديو المرتبط بالتعليق بشكل فريد. ولا تتوفّر هذه السمة إلا إذا كانت قيمة resourceId.kind هي youtube#video.
contentDetails.comment.resourceId.channelId	string المعرّف الذي تستخدمه منصة YouTube لتحديد القناة المرتبطة بالتعليق بشكل فريد ولا تتوفّر هذه السمة إلا إذا كانت قيمة resourceId.kind هي youtube#channel.
contentDetails.subscription	object يحتوي الكائن subscription على معلومات حول قناة اشترك فيها مستخدم. ولا تتوفّر هذه السمة إلا إذا كانت قيمة snippet.type هي subscription.
contentDetails.subscription.resourceId	object يحتوي الكائن resourceId على معلومات تحدّد المورد الذي اشترك فيه المستخدم.
contentDetails.subscription.resourceId.kind	string نوع مورد واجهة برمجة التطبيقات.
contentDetails.subscription.resourceId.channelId	string المعرّف الذي تستخدمه منصة YouTube لتحديد القناة التي اشترك فيها المستخدم بشكل فريد ولا تتوفّر هذه السمة إلا إذا كانت قيمة resourceId.kind هي youtube#channel.
contentDetails.playlistItem	object يحتوي الكائن playlistItem على معلومات حول عنصر جديد في قائمة التشغيل. ولا تتوفّر هذه السمة إلا إذا كانت قيمة snippet.type هي playlistItem.
contentDetails.playlistItem.resourceId	object يحتوي الكائن resourceId على معلومات تحدّد المورد الذي تمت إضافته إلى قائمة التشغيل.
contentDetails.playlistItem.resourceId.kind	string نوع مورد واجهة برمجة التطبيقات.
contentDetails.playlistItem.resourceId.videoId	string هو المعرّف الذي تستخدمه منصة YouTube لتحديد الفيديو الذي تمّت إضافته إلى قائمة التشغيل بشكل فريد. ولا تتوفّر هذه السمة إلا إذا كانت قيمة resourceId.kind هي youtube#video.
contentDetails.playlistItem.playlistId	string القيمة التي تستخدمها YouTube لتحديد قائمة التشغيل بشكل فريد.
contentDetails.playlistItem.playlistItemId	string القيمة التي تستخدمها YouTube لتحديد العنصر في قائمة التشغيل بشكل فريد.
contentDetails.recommendation	object يحتوي الكائن recommendation على معلومات عن مورد مقترَح. ولا تتوفّر هذه السمة إلا إذا كانت قيمة snippet.type هي recommendation.
contentDetails.recommendation.resourceId	object يحتوي الكائن resourceId على معلومات تحدّد المورد المقترَح.
contentDetails.recommendation.resourceId.kind	string نوع مورد واجهة برمجة التطبيقات.
contentDetails.recommendation.resourceId.videoId	string المعرّف الذي تستخدمه YouTube لتعريف الفيديو بشكل فريد، إذا كان المورد المقترَح عبارة عن فيديو. ولا تتوفّر هذه السمة إلا إذا كانت قيمة resourceId.kind هي youtube#video.
contentDetails.recommendation.resourceId.channelId	string المعرّف الذي تستخدمه منصة YouTube لتعريف القناة بشكل فريد إذا كان المرجع المقترَح هو قناة ولا تتوفّر هذه السمة إلا إذا كانت قيمة resourceId.kind هي youtube#channel.
contentDetails.recommendation.reason	string سبب اقتراح المورد للمستخدم. القيم الصالحة لهذه السمة هي: videoFavorited videoLiked videoWatched
contentDetails.recommendation.seedResourceId	object يحتوي الكائن seedResourceId على معلومات عن المورد الذي أدى إلى الاقتراح.
contentDetails.recommendation.seedResourceId.kind	string نوع مورد واجهة برمجة التطبيقات.
contentDetails.recommendation.seedResourceId.videoId	string هو المعرّف الذي تستخدمه منصة YouTube لتعريف الفيديو بشكل فريد إذا كانت التوصية بفيديو معيّن. ولا تتوفّر هذه السمة إلا إذا كانت قيمة seedResourceId.kind هي youtube#video.
contentDetails.recommendation.seedResourceId.channelId	string المعرّف الذي تستخدمه منصة YouTube لتعريف القناة بشكل فريد إذا كان الاقتراح ناتجًا من قناة معيّنة ولا تتوفّر هذه السمة إلا إذا كانت قيمة seedResourceId.kind هي youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId	string هو المعرّف الذي تستخدمه منصة YouTube للتعرّف بشكل فريد على قائمة التشغيل، إذا كان الاقتراح ناتجًا عن قائمة تشغيل معيّنة. ولا تتوفّر هذه السمة إلا إذا كانت قيمة seedResourceId.kind هي youtube#playlist.
contentDetails.social	object يحتوي الكائن social على تفاصيل حول مشاركة على شبكة اجتماعية. ولا تتوفّر هذه السمة إلا إذا كانت قيمة snippet.type هي social.
contentDetails.social.type	string اسم الشبكة الاجتماعية. القيم الصالحة لهذه السمة هي: facebook googlePlus twitter unspecified
contentDetails.social.resourceId	object يحتوي الكائن resourceId على معلومات تحدّد المورد المرتبط بمشاركة على شبكة اجتماعية.
contentDetails.social.resourceId.kind	string نوع مورد واجهة برمجة التطبيقات.
contentDetails.social.resourceId.videoId	string المعرّف الذي تستخدمه YouTube لتحديد الفيديو المعروض في مشاركة على وسائل التواصل الاجتماعي بشكل فريد، إذا كانت المشاركة تشير إلى فيديو لن تتوفّر هذه السمة إلا إذا كانت قيمة السمة social.resourceId.kind هي youtube#video.
contentDetails.social.resourceId.channelId	string المعرّف الذي تستخدمه YouTube لتحديد القناة المعروضة في مشاركة على وسائل التواصل الاجتماعي بشكل فريد، إذا كانت المشاركة تشير إلى قناة معيّنة. لن تتوفّر هذه السمة إلا إذا كانت قيمة السمة social.resourceId.kind هي youtube#channel.
contentDetails.social.resourceId.playlistId	string المعرّف الذي تستخدمه YouTube للتعريف عن قائمة التشغيل المعروضة في مشاركة على وسائل التواصل الاجتماعي بشكل فريد، إذا كانت المشاركة تشير إلى قائمة تشغيل. لن تتوفّر هذه السمة إلا إذا كانت قيمة السمة social.resourceId.kind هي youtube#playlist.
contentDetails.social.author	string مؤلف مشاركة الشبكة الاجتماعية.
contentDetails.social.referenceUrl	string عنوان URL للمشاركة على الشبكة الاجتماعية.
contentDetails.social.imageUrl	string صورة لمؤلف المشاركة.
contentDetails.channelItem	object يحتوي العنصر channelItem على تفاصيل حول مورد تمت إضافته إلى قناة. ولا تتوفّر هذه السمة إلا إذا كانت قيمة snippet.type هي channelItem.
contentDetails.channelItem.resourceId	object يحتوي الكائن resourceId على معلومات تحدّد المورد الذي تمت إضافته إلى القناة.