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