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