Activities

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

الطُرق

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

list

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

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

تعرض بنية 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 تمثّل هذه السمة علامة 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
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 على معلومات تحدّد المورد الذي تمت إضافته إلى القناة.