Activities: list

أوقفت منصة YouTube ميزة نشرة القناة نهائيًا. لا تعرض الطريقة activities.list نشرات القنوات إلى الآن، كما لم تعُد الطريقة activities.insert متاحة. لمزيد من التفاصيل، يُرجى مراجعة مركز مساعدة YouTube.

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

تأثير الحصة: تتطلب أي مكالمة إلى هذه الطريقة تكلفة حصة تبلغ وحدة واحدة.

حالات الاستخدام الشائعة

الطلب

طلب HTTP

GET https://www.googleapis.com/youtube/v3/activities

المَعلمات

يسرد الجدول التالي المعلَمات التي يتيحها طلب البحث هذا. كلّ المَعلمات المدرَجة هي مَعلمات طلب بحث.

المَعلمات
المَعلمات المطلوبة
part string
تحدّد المعلَمة part قائمة مفصولة بفواصل من سمة واحدة أو أكثر من سمات موارد activity التي ستتضمّنها استجابة واجهة برمجة التطبيقات.

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

تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المَعلمة:
  • contentDetails
  • id
  • snippet
الفلاتر (حدِّد إحدى المَعلمات التالية بالضبط)
channelId string
تحدّد المعلَمة channelId معرّف قناة فريدًا على YouTube. ستعرض واجهة برمجة التطبيقات قائمة بأنشطة تلك القناة.
home boolean
ملاحظة: تم إيقاف هذه المَعلمة نهائيًا.
بالنسبة إلى الطلبات التي تضبط هذه المَعلمة، تتضمّن استجابة واجهة برمجة التطبيقات عناصر مشابهة لتلك التي يراها المستخدم الذي سجّل الخروج على صفحة YouTube الرئيسية. تجدر الإشارة إلى أنّه لا يمكن استخدام هذه المَعلمة إلّا في طلب مفوّض بشكلٍ سليم.
mine boolean
لا يمكن استخدام هذه المَعلمة إلا في طلب معتمد بشكل صحيح. يمكنك ضبط قيمة هذه المَعلمة على true لاسترداد خلاصة لأنشطة المستخدم الذي تمت المصادقة عليه.
المَعلمات الاختيارية
maxResults unsigned integer
تحدّد المعلَمة maxResults الحدّ الأقصى لعدد العناصر التي يجب عرضها في مجموعة النتائج. تتراوح القيم المقبولة بين 0 و50، بما في ذلك القيم الواقعة بينهما. القيمة التلقائية هي 5.
pageToken string
تحدِّد المعلَمة pageToken صفحة معيّنة في مجموعة النتائج يجب عرضها. في استجابة واجهة برمجة التطبيقات، تحدّد السمتان nextPageToken وprevPageToken الصفحات الأخرى التي يمكن استردادها.
publishedAfter datetime
تحدّد المعلَمة publishedAfter أوّل تاريخ ووقت حدوث نشاط ليتمّ تضمينه في استجابة واجهة برمجة التطبيقات. إذا كانت قيمة المعلَمة تحدد يومًا، وليس وقتًا، سيتم تضمين أي أنشطة حدثت في ذلك اليوم في مجموعة النتائج. ويتم تحديد القيمة بتنسيق ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
publishedBefore datetime
تحدّد المعلَمة publishedBefore التاريخ والوقت اللذين يجب أن حدث قبلهما حتى يتم تضمين هذا النشاط في استجابة واجهة برمجة التطبيقات. إذا كانت قيمة المَعلمة تحدِّد يومًا وليس وقتًا، سيتم استبعاد أي أنشطة حدثت في ذلك اليوم من مجموعة النتائج. ويتم تحديد القيمة بتنسيق ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
regionCode string
توجّه المَعلمة regionCode واجهة برمجة التطبيقات إلى عرض نتائج للبلد المحدّد. قيمة المَعلمة هي رمز بلد بمعيار ISO 3166-1 alpha-2. وتستخدم YouTube هذه القيمة عندما لا يوفّر النشاط السابق للمستخدم المفوَّض على YouTube معلومات كافية لإنشاء خلاصة النشاط.

نص الطلب

لا تقدِّم نص طلب عند استدعاء هذه الطريقة.

الإجابة

إذا نجحت هذه الطريقة، ستعرض هذه الطريقة نص استجابة بالبنية التالية:

{
  "kind": "youtube#activityListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    activity Resource
  ]
}

أماكن إقامة

يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:

أماكن إقامة
kind string
يحدّد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#activityListResponse.
etag etag
علامة هذا المرجع.
nextPageToken string
الرمز المميّز الذي يمكن استخدامه كقيمة للمَعلمة pageToken لاسترداد الصفحة التالية في مجموعة النتائج.
prevPageToken string
الرمز المميّز الذي يمكن استخدامه كقيمة للمَعلمة pageToken لاسترداد الصفحة السابقة في مجموعة النتائج.
pageInfo object
يحتوي الكائن pageInfo على معلومات التقسيم على صفحات لمجموعة النتائج.
pageInfo.totalResults integer
إجمالي عدد النتائج في مجموعة النتائج.
pageInfo.resultsPerPage integer
عدد النتائج المضمَّنة في ردّ واجهة برمجة التطبيقات
items[] list
قائمة بالأنشطة أو الأحداث التي تتطابق مع معايير الطلب

الأخطاء

يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب بيانات إلى هذه الطريقة. يُرجى الاطّلاع على وثائق رسالة الخطأ للحصول على مزيد من التفاصيل.

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) forbidden الطلب غير مفوَّض بشكل صحيح.
forbidden (403) homeParameterDeprecated لا تتوفّر بيانات نشاط الصفحة الرئيسية للمستخدم من خلال واجهة برمجة التطبيقات هذه. قد يحدث هذا الخطأ في حال ضبط المعلَمة home على true في طلب غير مصرَّح به.
notFound (404) channelNotFound يتعذر العثور على معرّف القناة المحدد في معلمة channelId للطلب.
notFound (404) homeChannelNotFound لا يمكن العثور على خلاصة للصفحة الرئيسية في YouTube للمستخدم الذي تمت المصادقة عليه حاليًا.
unauthorized (401) authorizationRequired يستخدم الطلب المعلَمة home ولكن لم يتم تفويضه بشكل صحيح.

تجربة

يمكنك استخدام APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.