يحتوي المورد 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قيم المفاتيح الصالحة هي:
|
snippet.thumbnails.(key).url |
stringتمثّل عنوان URL الخاص بالصورة. |
snippet.thumbnails.(key).width |
unsigned integerتمثّل هذه السمة عرض الصورة. |
snippet.thumbnails.(key).height |
unsigned integerتمثّل هذه السمة ارتفاع الصورة. |
snippet.channelTitle |
stringعنوان القناة المسؤولة عن هذا النشاط |
snippet.type |
stringنوع النشاط الذي يصفه المرجع. القيم الصالحة لهذه السمة هي:
|
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سبب اقتراح المرجع للمستخدم. القيم الصالحة لهذه السمة هي:
|
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اسم الشبكة الاجتماعية. القيم الصالحة لهذه السمة هي:
|
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 على معلومات تحدّد المورد الذي تمت إضافته إلى القناة. |