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
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": 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 Valid key values are: default – The default thumbnail image. The default thumbnail for a video – or a resource that refers to a video, such as a playlist item or search result – is 120px wide and 90px tall. The default thumbnail for a channel is 88px wide and 88px tall. medium – A higher resolution version of the thumbnail image. For a video (or a resource that refers to a video), this image is 320px wide and 180px tall. For a channel, this image is 240px wide and 240px tall. high – A high resolution version of the thumbnail image. For a video (or a resource that refers to a video), this image is 480px wide and 360px tall. For a channel, this image is 800px wide and 800px tall. standard – An even higher resolution version of the thumbnail image than the high resolution image. This image is available for some videos and other resources that refer to videos, like playlist items or search results. This image is 640px wide and 480px tall. maxres – The highest resolution version of the thumbnail image. This image size is available for some videos and other resources that refer to videos, like playlist items or search results. This image is 1280px wide and 720px tall.
snippet.thumbnails.(key).url	string عنوان URL الخاص بالصورة
snippet.thumbnails.(key).width	unsigned integer عرض الصورة
snippet.thumbnails.(key).height	unsigned integer ارتفاع الصورة
snippet.channelTitle	string عنوان القناة المسؤولة عن هذا النشاط
snippet.type	string نوع النشاط الذي يصفه المرجع Valid values for this property are: channelItem comment – (not currently returned) playlistItem promotedItem recommendation social 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.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.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 السبب الذي يجعل المرجع مقترَحًا للمستخدم Valid values for this property are: 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 اسم الشبكة الاجتماعية Valid values for this property are: 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 على معلومات تحدّد المرجع الذي تمّت إضافته إلى القناة.