سجلّ المراجعة

تعرض هذه الصفحة التغييرات في واجهة برمجة التطبيقات والتعديلات على المستندات لكلّ من YouTube Reporting API وYouTube Analytics API. تتيح كلتا الواجهتَين للمطوّرين الوصول إلى بيانات "إحصاءات YouTube"، ولكن بطرق مختلفة.

‫6 نوفمبر 2026

تم تعديل المستندات الخاصة بسمات موقع التشغيل لكلّ من YouTube Reporting API وYouTube Analytics API:

  • في YouTube Reporting API، يوثّق جدول السمات playback_location_type الآن القيمتَين 11 (المشاهدات التي تمّت على خلاصة البث المباشر بالوضع العمودي) و12 (المشاهدات التي تمّت على علامة التبويب "عيّنات" في YouTube Music).
  • في YouTube Analytics API، يُدرج تعريف السمة insightPlaybackLocationType الآن IMMERSIVE_LIVE_FEED (المشاهدات التي تمّت على خلاصة البث المباشر بالوضع العمودي) وSHORTS_FEED (المشاهدات التي تمّت على خلاصة YouTube Shorts).

‫4 نوفمبر 2026

اعتبارًا من 15 يناير 2027، تم إيقاف الإصدار 1.0 من تقرير المراجع الأسبوعي لمالكي المحتوى (content_owner_active_references_a1) نهائيًا واستبداله بالإصدار 1.1 (content_owner_active_references_a2). يُرجى التأكّد من الانتقال إلى الإصدار الأخير قبل 15 يناير 2027.

‫30 أكتوبر 2026

تتيح واجهة YouTube Reporting API الآن التقارير التالية التي يديرها النظام لمالكي المحتوى:

الفئة اسم التقرير رقم تعريف نوع التقرير
الملخّصات المالية الملخّص الشهري للتعديلات في القناة content_owner_channel_adjustments_summary_a1
الملخّصات المالية الإيرادات الشهرية من معاملات الميزات المدفوعة content_owner_transactions_paid_features_revenue_a1
الملخّصات المالية الإيرادات الشهرية من معاملات الفيديو عند الطلب مقابل معاملة (TVOD) حسب العنوان والبلد tvod_content_owner_country_title_tvod_revenue_a1
الملخّصات المالية الإيرادات الشهرية من معاملات الفيديو عند الطلب مقابل معاملة (TVOD) حسب البلد tvod_content_owner_country_transactions_tvod_revenue_a1
فيديوهات Shorts فيديوهات Shorts الشهرية التي تم إنشاؤها باستخدام مواد عرض تابعة لشركات إنتاج موسيقي music_content_owner_shorts_asset_creations_a1
فيديوهات Shorts عدد المشاهدات الشهرية لمواد العرض في فيديوهات Shorts التابعة لشركات الإنتاج الموسيقي music_content_owner_shorts_asset_views_a1
فيديوهات Shorts فيديوهات Shorts الشهرية التي أنشأها ناشرو الموسيقى باستخدام مواد العرض publisher_content_owner_shorts_asset_creations_a1
فيديوهات Shorts عدد المشاهدات الشهرية لفيديوهات Shorts التي تتضمّن مواد عرض تابعة لناشري الموسيقى publisher_content_owner_shorts_asset_views_a1
الضرائب تقرير الملخّص الشهري لاسترداد قيمة الضرائب المقتطعة للقنوات التابعة لشبكة متعددة القنوات content_owner_affiliate_tax_refund_summary_a1
Assets تقرير SRMF الأسبوعي publisher_content_owner_weekly_srmf
Assets تقرير يومي عن حالة طلبات "قنوات الفنّانين الرسمية" content_owner_oac_request_status_a1
Assets تقرير يومي حول جودة طلبات "قناة الفنّان الرسمية" content_owner_oac_quality_status_a1

‫13 سبتمبر 2026

تتيح واجهة YouTube Reporting API الآن استخدام الإصدار 1.1 من تقرير المراجع الأسبوعي لمالكي المحتوى (content_owner_active_references_a2).

يتضمّن الإصدار 1.1 التغييرات التالية:

  • تضيف هذه السمة الحقل status_detail الذي يوفّر تفاصيل إضافية أو سببًا لحالة الملف المرجعي.
  • يتم تعديل الحقل asset_owners لاستخدام الأسماء المعروضة لمالكي المحتوى أو المعرّفات الخارجية بدلاً من رموز الشركاء.

سيظل الإصدار السابق من التقرير، الإصدار 1.0 (content_owner_active_references_a1)، متاحًا.

‫9 سبتمبر 2026

تم تعديل مستندات YouTube Analytics API وYouTube Reporting API من خلال الإضافات والتوضيحات التالية:

  • اتفاقية مستوى الخدمة بشأن سرعة توفُّر البيانات ووقت الاستجابة: تمت إضافة قسم مخصّص إلى نموذج البيانات يشرح تأخير معالجة البيانات الذي يتراوح بين 48 و72 ساعة، واقتطاع تاريخ الانتهاء إلى آخر يوم تمت معالجته بالكامل، واقتراح طريقة videos.list في YouTube Data API للحصول على إحصاءات الفيديوهات في الوقت الفعلي.

  • المقاييس المالية في تقارير القنوات: تم تعديل مستندات تفويض تقارير القنوات لتوضيح أنّ مقاييس الإيرادات المقدَّرة وأداء الإعلانات متاحة لتقارير القنوات المصرَّح بها باستخدام النطاق https://www.googleapis.com/auth/yt-analytics-monetary.readonly عندما تكون القناة عضوًا في "برنامج شركاء YouTube"، وأنّ القنوات التي لا تحقّق الربح تعرض رمز HTTP 403 Forbidden.

  • قيود طلبات البحث وتوافق المَعلمات: تمت إضافة ملاحظة استشارية إلى فهم جداول التقارير توضّح أنّ مجموعات السمات والمقاييس والفلاتر غير الصالحة أو المتنافية تعرض رمز HTTP 400 badRequest ("The query is not supported.").

  • قيم السمات الفارغة في التقارير المجمّعة: تم تعديل خصائص تقارير YouTube Reporting API لتوضيح أنّ أعمدة السمات، مثل video_id أو channel_id، تحتوي على سلاسل فارغة للحفاظ على أعداد المقاييس المجمّعة للمراجع المحذوفة ولتمثيل الأحداث على مستوى القناة.

‫27 أغسطس 2026

سيوحّد YouTube طريقة احتساب المشاهدات العلنية لجميع تنسيقات الفيديوهات: الفيديوهات الطويلة وأحداث البث المباشر وفيديوهات Shorts. سيحتسب YouTube المشاهدات العلنية فور بدء تشغيل الفيديو.

لا تتأثر الأهلية لتحقيق الربح ومعظم مقاييس الأداء الأساسية لأنّها تبقى مرتبطة بمقاييس التفاعل. ستظل أرباح صنّاع المحتوى مستنِدة إلى "مشاهدات Shorts المقصودة" و "ساعات المشاهدة المقصودة"، ويمكنكم الاطّلاع عليها في إحصاءات YouTube > الوضع المتقدّم.

لم نُجرِ أي تغييرات على متطلبات أهلية الانضمام إلى "برنامج شركاء YouTube". سنشير الآن أيضًا إلى متطلبات الأهلية للمشاركة في "برنامج شركاء YouTube" باسم "مشاهدات Shorts المؤهّلة" و"ساعات المشاهدة المؤهّلة" (التي كانت سابقًا "مشاهدات Shorts العلنية الصالحة" و"ساعات المشاهدة العلنية الصالحة").

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة فهم أداء فيديوهاتكم على YouTube.

المقياس الحالة Trigger يتم الاستخدام مع
العرض اكتمل التحديث. يتم تشغيل الفيديو من الإطار الأول (يشمل ذلك التشغيل التلقائي، وتمرير المؤشر فوق الفيديو، والنقر لتشغيله). عدد المشاهدات العلنية العادية
العرض المطوّل للإعلان لم يتم التغيير يستمر التشغيل بعد اللقطة الأولى، أو ينقر المستخدم لتشغيل الفيديو. تحقيق الربح من خلال "برنامج شركاء YouTube"، ومعظم الإحصاءات الأساسية (نسبة النقر إلى الظهور ومتوسّط مدة المشاهدة)، وإعداد تقارير عن التفاعل
مرات ظهور الصورة المصغّرة لم يتم التغيير يتم عرض الصورة المصغّرة بدون تفاعل أو تشغيل تلقائي. يقيس هذا المقياس مدى ظهور الخلاصة وتجميعها.

تعديلات على مستندات واجهة برمجة التطبيقات: تم تعديل تعريف مقياس engagedViews في مستندات مقاييس YouTube Analytics API ومقاييس YouTube Reporting API.

‫25 يونيو 2026

تم تعديل مستندات YouTube Analytics API (الطلبات المستهدفة) لإزالة تقرير نشاط المستخدم حسب المدينة لمالكي المحتوى. لا يتوفّر هذا التقرير لمالكي المحتوى، وستعرض طلبات البحث التي يجريها مالكو المحتوى عن نشاط المستخدمين حسب المدينة نتائج فارغة.

‫9 مارس 2026

تتضمّن الآن سمات ageGroup (واجهة YouTube Analytics API) وage_group (واجهة YouTube Reporting API) المستخدمين الذين يقدّر YouTube أنّهم دون الـ 18 عامًا.

‫15 يناير 2026

تتيح واجهة YouTube Reporting API الآن تقارير مدى الوصول إلى الجمهور للقنوات ومالكي المحتوى. تقدّم تقارير مدى الوصول إلى الجمهور إحصاءات حول مرّات ظهور الصور المصغّرة للفيديوهات ونِسب النقر إلى الظهور.

  • يتوفّر تقريرا "channel_reach_basic_a1" و"channel_reach_combined_a1" للقنوات.
  • يتوفّر تقريرا content_owner_reach_basic_a1 وcontent_owner_reach_combined_a1 لمالكي المحتوى.

تتيح هذه التقارير المقاييس الجديدة التالية:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

‫22 سبتمبر 2025

تم تأجيل موعد إيقاف التقارير الذي أعلنّا عنه سابقًا من 30 سبتمبر 2025 إلى 31 أكتوبر 2025. ستبقى الإصدارات السابقة من التقارير التي تم تعديلها لتشمل التغييرات في عدد مشاهدات Shorts متاحة حتى ذلك الحين، باستثناء الإصدار 1.0 من تقرير "المطالبات" (content_owner_active_claims_a1) والإصدار 1.1 من تقرير "المطالبات" (content_owner_active_claims_a2)، اللذين سيتوقف العمل بهما في 30 سبتمبر.

‫24 يونيو 2025

كما أعلنّا في 26 مارس 2025، سيتم تعديل Bulk Reports API كجزء من التغيير الجديد في عدد مشاهدات Shorts. تم إجراء التغييرات التالية:

  • تم إنشاء نُسخ جديدة من كل تقرير يتضمّن مشاهدات، وهو ما ينطبق على معظم التقارير. تمت زيادة إصدار كل تقرير متأثر بمقدار واحد، مثل الإصدار a2 إلى الإصدار a3.
  • بالنسبة إلى فيديوهات Shorts، سيتم احتساب عدد مرّات بدء تشغيل فيديو Short أو إعادة تشغيله في عدد المشاهدات. بالنسبة إلى الفيديوهات، لن يطرأ أي تغيير.
  • ستتضمّن التقارير المعدَّلة عمودًا جديدًا بعنوان engaged_views يعرض عدد المشاهدات وفقًا للمنهجية السابقة.

ستسري هذه التغييرات اعتبارًا من 30 يونيو 2025 على Bulk Reports API. احرص على تعديل معالجة التقارير وفقًا لذلك.

ستتوفّر الإصدارات السابقة من التقرير حتى 30 سبتمبر 2025. وبعد 30 سبتمبر 2025، سيتم إيقاف الإصدارات السابقة نهائيًا. احرص على نقل البيانات إلى أحدث الإصدارات.

أخيرًا، احرص على اتّباع أفضل الممارسات عند معالجة التقارير لتجنُّب حدوث تغييرات مستقبلية في التقارير تؤدي إلى تعطُّل مسارات المعالجة.

تعرض الجداول التالية إصدارات التقارير الجديدة لكل نوع تقرير:

تقارير البيانات المجمّعة في "إحصاءات YouTube"

تقارير القناة - تقارير الفيديوهات
اسم التقرير الإصدار السابق أحدث إصدار
نشاط المستخدم channel_basic_a2 channel_basic_a3
نشاط المستخدمين حسب المقاطعة channel_province_a2 channel_province_a3
مواقع التشغيل channel_playback_location_a2 channel_playback_location_a3
مصادر الزيارات channel_traffic_source_a2 channel_traffic_source_a3
نوع الجهاز ونظام التشغيل channel_device_os_a2 channel_device_os_a3
الترجمة channel_subtitles_a2 channel_subtitles_a3
القيمة المُجمَّعة channel_combined_a2 channel_combined_a3
تقارير القناة - تقارير قوائم التشغيل
اسم التقرير الإصدار السابق أحدث إصدار
نشاط المستخدم playlist_basic_a1 playlist_basic_a2
نشاط المستخدمين حسب المقاطعة playlist_province_a1 playlist_province_a2
مواقع التشغيل playlist_playback_location_a1 playlist_playback_location_a2
مصادر الزيارات playlist_traffic_source_a1 playlist_traffic_source_a2
نوع الجهاز ونظام التشغيل playlist_device_os_a1 playlist_device_os_a2
القيمة المُجمَّعة playlist_combined_a1 playlist_combined_a2
تقارير مالك المحتوى - تقارير الفيديوهات
اسم التقرير الإصدار السابق أحدث إصدار
نشاط المستخدم content_owner_basic_a3 content_owner_basic_a4
نشاط المستخدمين حسب المقاطعة content_owner_province_a2 content_owner_province_a3
مواقع التشغيل content_owner_playback_location_a2 content_owner_playback_location_a3
مصادر الزيارات content_owner_traffic_source_a2 content_owner_traffic_source_a3
نوع الجهاز ونظام التشغيل content_owner_device_os_a2 content_owner_device_os_a3
الترجمة content_owner_subtitles_a2 content_owner_subtitles_a3
القيمة المُجمَّعة content_owner_combined_a2 content_owner_combined_a3
تقارير مالك المحتوى - تقارير قوائم التشغيل
اسم التقرير الإصدار السابق أحدث إصدار
نشاط المستخدم content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
نشاط المستخدمين حسب المقاطعة content_owner_playlist_province_a1 content_owner_playlist_province_a2
مواقع التشغيل content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
مصادر الزيارات content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
نوع الجهاز ونظام التشغيل content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
القيمة المُجمَّعة content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
تقارير مالك المحتوى - تقارير مواد العرض
اسم التقرير الإصدار السابق أحدث إصدار
نشاط المستخدم content_owner_asset_basic_a2 content_owner_asset_basic_a3
نشاط المستخدمين حسب المقاطعة content_owner_asset_province_a2 content_owner_asset_province_a3
مواقع تشغيل الفيديو content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
مصادر الزيارات content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
نوع الجهاز ونظام التشغيل content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
القيمة المُجمَّعة content_owner_asset_combined_a2 content_owner_asset_combined_a3

التقارير التي يديرها النظام - التقارير المالية (المحتوى غير الموسيقي)

تقارير مالك المحتوى - تقارير Shorts (غير الموسيقية)
اسم التقرير الإصدار السابق أحدث إصدار
ملخّص إيرادات الإعلانات على مستوى العالم content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
ملخّص يومي لإيرادات الإعلانات content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
ملخّص إيرادات الإعلانات حسب البلد content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
ملخّص إيرادات الإعلانات content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

التقارير التي يديرها النظام - غير مالية

تقارير مالك المحتوى - تقارير المطالبات
اسم التقرير الإصدار السابق أحدث إصدار
مطالبات نشطة content_owner_active_claims_a2 content_owner_active_claims_a3
تقارير مالك المحتوى: تقارير البيانات الوصفية للفيديوهات
اسم التقرير الإصدار السابق أحدث إصدار
البيانات الوصفية للفيديو content_owner_video_metadata_a3 content_owner_video_metadata_a4
تقارير مالك المحتوى - تقارير مواد العرض
اسم التقرير الإصدار السابق أحدث إصدار
مواد العرض content_owner_asset_a2 content_owner_asset_a3
التعارضات بشأن مواد العرض content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

‫24 أبريل 2025

كما أعلنّا في 26 مارس 2025، سيتم تعديل Targeted Queries API كجزء من التغيير الجديد في عدد مشاهدات Shorts:

  • بالنسبة إلى فيديوهات Shorts، سيحتسب مقياس "views" الآن عدد مرات بدء تشغيل فيديو Short أو إعادة تشغيله.
  • سيتم إطلاق مقياس جديد باسم "engagedViews" يعكس المنهجية السابقة لاحتساب عدد المشاهدات. ستتم إتاحة "engagedViews" في جميع التقارير مع "views".

ستسري هذه التغييرات اعتبارًا من 30 أبريل 2025 على Targeted Queries API. احرص على تعديل طلبات البحث وفقًا لذلك.

يمكنك الاطّلاع على سجلّ النُسخ السابقة هذا لمعرفة التغييرات التي سيتم إجراؤها على واجهة Bulk Reports API وموعد إجرائها.

‫22 أبريل 2025

كما أعلنّا في 7 أبريل 2024، تم إيقاف السمة isCurated نهائيًا في تقارير القنوات وتقارير قوائم التشغيل الخاصة بمالكي المحتوى. اعتبارًا من 31 ديسمبر 2024، لن تعود هذه السمة متاحة. تمت إزالة السمة من التقارير والمستندات.

‫26 مارس 2025

يتضمّن هذا التعديل التغيير التالي المتعلّق بواجهتَي YouTube Analytics API وYouTube Reporting API:

اعتبارًا من 31 مارس 2025، سيغيّر YouTube طريقة احتساب مشاهدات Shorts. في السابق، كان يتم احتساب مشاهدة لفيديو Shorts بعد تشغيله لعدد معيّن من الثواني. والآن، سنبدأ باحتساب عدد مرات بدء تشغيل فيديو Short أو إعادة تشغيله، بدون فرض حدّ أدنى لوقت المشاهدة. مزيد من المعلومات

سيتم تعديل واجهتَي إحصاءات YouTube API (الطلبات المستهدفة) وReporting API (التقارير المجمّعة) بالتغييرات التالية:

  • بالنسبة إلى فيديوهات Shorts، يتم احتساب views بناءً على عدد مرّات بدء تشغيل فيديو Shorts أو إعادة تشغيله.
  • سيتوفّر مقياس جديد باسم engagedViews يعكس الطريقة السابقة لاحتساب عدد المشاهدات.
  • إذا كنتم تملكون قناة أو كان لديكم الإذن بالوصول إلى بيانات قناة، يمكنكم الاستعلام عن كل من المشاهدات والمشاهدات المقصودة المُعدّلة.

سيتم تعديل الطلبات المستهدفة بحلول 30 أبريل، والتقارير المجمّعة بحلول 30 يونيو. وحتى ذلك الحين، ستستند المشاهدات إلى المنهجية القديمة. لن تتطابق مشاهدات فيديوهات Shorts والقناة مع الإحصاءات في "استوديو YouTube".

بالإضافة إلى ذلك، تم تأجيل الإيقاف النهائي المُعلن عنه سابقًا لتقرير "المطالبات اليومية" (الإصدار 1.0).

يمكنك الاطّلاع على سجلّ النُسخ السابقة هذا لمعرفة وقت إجراء التغييرات على واجهات برمجة التطبيقات.

‫3 مارس 2025

يتضمّن هذا التعديل التغيير التالي المتعلّق بواجهة YouTube Reporting API:

ملاحظة: هذا إشعار بالإيقاف النهائي.

تم إيقاف تقرير المطالبات اليومية (الإصدار 1.0) نهائيًا للشركاء. ولن يكون متاحًا اعتبارًا من 30 أبريل 2025. وتم تعديل تعريف هذا التقرير وفقًا لذلك. يُرجى استخدام أحدث تقرير "المطالبات اليومية" بدلاً من ذلك.

‫15 نوفمبر 2024

ملاحظة: يسري التغيير التالي اعتبارًا من 18 نوفمبر 2024.

تم تعديل مستندات YouTube Analytics (Targeted Queries) API للإشارة إلى أنّه بالنسبة إلى تقارير مصادر الزيارات، تعرض طريقة reports.query في واجهة برمجة التطبيقات الآن خطأً إذا كان ناتج عدد الفيديوهات التي تم الاستعلام عنها مضروبًا في عدد الأيام في النطاق الزمني يتجاوز 50,000. على سبيل المثال، يمكن لطلب البحث الذي يسترد بيانات 500 معرّف فيديو طلب بيانات لمدة 100 يوم كحد أقصى.

يؤثّر هذا التغيير في تقارير كلّ من القنوات ومالكي المحتوى.

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

‫6 مايو 2024

تتيح واجهة برمجة التطبيقات لإحصاءات YouTube (الطلبات المستهدفة) ثلاثة تقارير جديدة للقنوات:

بالإضافة إلى ذلك، تم تحسين تقرير الاحتفاظ بالجمهور ليتيح استخدام ثلاثة مقاييس جديدة:

‫7 أبريل 2024

تم إجراء عدة تعديلات على YouTube Analytics (Targeted Queries) API في ما يتعلق بتقارير قوائم التشغيل الخاصة بمالك المحتوى. وهي التعديلات نفسها التي أجريناها على تقارير قوائم التشغيل في القنوات، والتي تم الإعلان عنها في 19 يناير 2024.

The following revision history entry provides nearly the same information as the entry from January 19, 2024. يُرجى العِلم أنّ تقارير قوائم التشغيل الخاصة بمالكي المحتوى ستتيح استخدام السمة isCurated حتى 31 ديسمبر 2024، في حين أنّ السمة ستكون متاحة لتقارير قوائم التشغيل الخاصة بالقنوات حتى 30 يونيو 2024.

  • ملاحظة: هذا إشعار بالإيقاف النهائي.

    تم إيقاف السمة isCurated نهائيًا في تقارير قوائم التشغيل الخاصة بمالك المحتوى. ولن يكون متاحًا اعتبارًا من 31 ديسمبر 2024. وتم تعديل تعريف هذه السمة وفقًا لذلك.

    للحفاظ على التوافق مع الأنظمة القديمة عند إزالة السمة isCurated، يجب أيضًا تعديل الرمز لاسترداد المقياس playlistViews بدلاً من المقياس views لتقارير قوائم التشغيل فقط. بما أنّ المقياس views لا يزال متاحًا لتقارير قوائم التشغيل، ولكن بمعنى مختلف، ستواصل واجهة برمجة التطبيقات عرض البيانات إذا لم تعدّل اسم المقياس. يمكنك بالطبع تعديل تطبيقك لاسترداد وعرض كل من views وplaylistViews.

    بالإضافة إلى السمة isCurated، لم تعد وظائف واجهة برمجة التطبيقات التالية متاحة في التقارير الجديدة:

    • لا تتوفّر فلاتر المواقع الجغرافية، مثل continent وsubcontinent، في تقارير قوائم التشغيل الجديدة للقنوات.
    • لم يعُد المقياسان redViews وestimatedRedMinutesWatched متاحَين لتقارير قوائم التشغيل الجديدة في القناة. لم تكن هذه المقاييس متوفّرة في "استوديو YouTube"، لذا يهدف هذا التغيير إلى جعل وظائف واجهة برمجة التطبيقات متوافقة مع الوظائف المتوفّرة في تطبيق "استوديو YouTube".
    • لم تعد السمتان subscribedStatus وyoutubeProduct متاحتَين كفلاتر لتقارير قوائم التشغيل في القناة. لم تكن هذه الفلاتر متاحة في "استوديو YouTube"، لذا يهدف هذا التغيير إلى مواءمة وظائف واجهة برمجة التطبيقات مع الوظائف المتاحة في تطبيق "استوديو YouTube".

  • تم تعديل قسم تقارير قوائم التشغيل في مستندات تقارير مالك المحتوى لشرح أنواع المقاييس المتاحة لتقارير قوائم التشغيل بشكل أكثر تفصيلاً:

    • مقاييس الفيديوهات المجمّعة توفّر مقاييس مجمّعة لنشاط المستخدمين ومرات الظهور لكل الفيديوهات في قوائم التشغيل التي يملكها مالك المحتوى. لا تتوفّر مقاييس الفيديو المجمّعة إلا لطلبات البيانات من واجهة برمجة التطبيقات التي لا تستخدم السمة isCurated.
    • مقاييس "ضمن قائمة التشغيل" تعكس نشاط المستخدمين وتفاعلهم في سياق صفحة قائمة التشغيل. وتشمل هذه المقاييس بيانات المشاهدات من الفيديوهات غير المملوكة في قائمة التشغيل، ولكن فقط عندما تحدث هذه المشاهدات في سياق قائمة التشغيل.
    • يحدّد قسم مقاييس قوائم التشغيل المتاحة مقاييس الفيديوهات المجمّعة والمقاييس ضمن قوائم التشغيل المتاحة لتقارير قوائم التشغيل.

  • تتوفّر المقاييس الجديدة التالية ضمن قوائم التشغيل لتقارير قوائم التشغيل الخاصة بمالكي المحتوى. يُرجى العِلم أنّ هذه المقاييس متاحة فقط إذا كان طلب البيانات من واجهة برمجة التطبيقات لاسترداد التقارير لا يستخدم السمة isCurated. يمكنك الاطّلاع على مستندات المقاييس لمعرفة تعريفات كل مقياس:

  • يعتمد سلوك المقياس views الآن على ما إذا كان طلب البيانات من واجهة برمجة التطبيقات الذي استردّ تقرير قائمة التشغيل قد استخدم السمة isCurated:

    • عندما يتضمّن الطلب السمة isCurated، يكون المقياس views مقياسًا ضمن قائمة التشغيل يشير إلى عدد مرات مشاهدة الفيديوهات في سياق قوائم التشغيل الخاصة بمالك المحتوى.
    • عندما لا يتضمّن الطلب السمة isCurated، يكون المقياس views مقياسًا مجمّعًا للفيديوهات يحدّد إجمالي عدد مرات مشاهدة الفيديوهات في قوائم التشغيل التابعة لمالك المحتوى، بغض النظر عمّا إذا كانت هذه المشاهدات قد حدثت في سياق قائمة التشغيل. يشمل المجموع الإجمالي فقط مشاهدات الفيديوهات التي يملكها مالك المحتوى المرتبط بالقناة التي تملك قائمة التشغيل.

      في هذه التقارير التي لا تستخدم السمة isCurated، يشير المقياس playlistViews إلى عدد مرات مشاهدة الفيديوهات في سياق قائمة التشغيل. يحتسب هذا المقياس عدد المشاهدات لجميع الفيديوهات في قائمة التشغيل، بغض النظر عن القناة التي تملكها.

  • بالنسبة إلى كل تقرير من تقارير قوائم التشغيل، تتضمّن الآن مستندات تقارير مالك المحتوى جداول تعرض المقاييس المتاحة لذلك التقرير استنادًا إلى ما إذا كان طلب البيانات من واجهة برمجة التطبيقات يتضمّن السمة isCurated. يمكنك الاطّلاع على القسم الذي يحدّد تقارير قوائم التشغيل المستندة إلى الوقت للحصول على مثال.

‫19 يناير 2024

تم إجراء عدة تعديلات على YouTube Analytics (Targeted Queries) API في ما يتعلق بتقارير قوائم التشغيل في القناة. تشمل التعديلات سمة متوقفة نهائيًا والعديد من المقاييس الجديدة والمعدَّلة:

  • ملاحظة: هذا إشعار بالإيقاف النهائي.

    تم إيقاف السمة isCurated نهائيًا في تقارير القنوات. ولن يكون متاحًا في 30 يونيو 2024 أو بعد هذا التاريخ. وتم تعديل تعريف هذه السمة وفقًا لذلك.

    للحفاظ على التوافق مع الأنظمة القديمة عند إزالة السمة isCurated، يجب أيضًا تعديل الرمز لاسترداد المقياس playlistViews بدلاً من المقياس views لتقارير قوائم التشغيل فقط. بما أنّ المقياس views لا يزال متاحًا لتقارير قوائم التشغيل، ولكن بمعنى مختلف، ستواصل واجهة برمجة التطبيقات عرض البيانات إذا لم تعدّل اسم المقياس. يمكنك بالطبع تعديل تطبيقك لاسترداد وعرض كل من views وplaylistViews.

    بالإضافة إلى السمة isCurated، لم تعد وظائف واجهة برمجة التطبيقات التالية متاحة في التقارير الجديدة:

    • لا تتوفّر فلاتر المواقع الجغرافية، مثل continent وsubcontinent، في تقارير قوائم التشغيل الجديدة للقنوات.
    • لم يعُد المقياسان redViews وestimatedRedMinutesWatched متاحَين لتقارير قوائم التشغيل الجديدة في القناة. لم تكن هذه المقاييس متوفّرة في "استوديو YouTube"، لذا يهدف هذا التغيير إلى جعل وظائف واجهة برمجة التطبيقات متوافقة مع الوظائف المتوفّرة في تطبيق "استوديو YouTube".
    • لم تعد السمتان subscribedStatus وyoutubeProduct متاحتَين كفلاتر لتقارير قوائم التشغيل في القناة. لم تكن هذه الفلاتر متاحة في "استوديو YouTube"، لذا يهدف هذا التغيير إلى جعل وظائف واجهة برمجة التطبيقات متوافقة مع الوظائف المتاحة في تطبيق "استوديو YouTube".

  • تم تعديل قسم تقارير قوائم التشغيل في مستندات تقارير القناة لشرح أنواع المقاييس المتاحة لتقارير قوائم التشغيل بشكل أكثر تفصيلاً:

    • توفّر مقاييس الفيديوهات المجمّعة مقاييس نشاط المستخدمين ومرات الظهور المجمّعة لكل الفيديوهات في قوائم تشغيل القناة والتي تملكها القناة أيضًا. لا تتوفّر مقاييس الفيديو المجمّعة إلا لطلبات البيانات من واجهة برمجة التطبيقات التي لا تستخدم السمة isCurated.
    • مقاييس "ضمن قائمة التشغيل" تعكس نشاط المستخدمين وتفاعلهم في سياق صفحة قائمة التشغيل. وتشمل هذه المقاييس بيانات المشاهدات من الفيديوهات غير المملوكة في قائمة التشغيل، ولكن فقط عندما تحدث هذه المشاهدات في سياق قائمة التشغيل.
    • يحدّد قسم مقاييس قوائم التشغيل المتاحة مقاييس الفيديوهات المجمّعة والمقاييس ضمن قوائم التشغيل المتاحة لتقارير قوائم التشغيل.

  • تتوفّر المقاييس الجديدة التالية ضمن قائمة التشغيل لتقارير قوائم التشغيل في القنوات. لا تتوفّر هذه المقاييس بعد في تقارير مالك المحتوى. يُرجى العِلم أنّ هذه المقاييس متاحة فقط إذا كان طلب البيانات من واجهة برمجة التطبيقات لاسترداد التقارير لا يستخدم السمة isCurated. يمكنك الاطّلاع على مستندات المقاييس لمعرفة تعريفات كل مقياس:

  • يعتمد سلوك المقياس views الآن على ما إذا كان طلب البيانات من واجهة برمجة التطبيقات الذي استردّ تقرير قائمة التشغيل قد استخدم السمة isCurated:

    • عندما يتضمّن الطلب السمة isCurated، يكون المقياس views مقياسًا ضمن قائمة التشغيل يشير إلى عدد المرات التي تمت فيها مشاهدة الفيديوهات في سياق قوائم التشغيل في القناة.
    • عندما لا يتضمّن الطلب السمة isCurated، يكون المقياس views مقياسًا مجمّعًا للفيديوهات يحدّد إجمالي عدد مرات مشاهدة الفيديو في قوائم التشغيل في القناة، بغض النظر عمّا إذا كانت هذه المشاهدات قد حدثت في سياق قائمة التشغيل. يشمل المجموع المجمّع فقط مشاهدات الفيديوهات التي تملكها القناة التي تملك قائمة التشغيل.

      في هذه التقارير التي لا تستخدم السمة isCurated، يشير المقياس playlistViews إلى عدد مرات مشاهدة الفيديوهات في سياق قائمة التشغيل. يحتسب هذا المقياس عدد المشاهدات لجميع الفيديوهات في قائمة التشغيل، بغض النظر عن القناة التي تملكها.

  • بالنسبة إلى كل تقرير من تقارير قوائم التشغيل، تتضمّن مستندات تقارير القنوات الآن جداول تعرض المقاييس المتوافقة مع هذا التقرير استنادًا إلى ما إذا كان طلب البيانات من واجهة برمجة التطبيقات يتضمّن السمة isCurated. يمكنك الاطّلاع على القسم الذي يحدّد تقارير قوائم التشغيل المستندة إلى الوقت للحصول على مثال.

‫4 ديسمبر 2023

تم تعديل واجهة برمجة التطبيقات YouTube Analytics (Targeted Queries) API لدمج قيمتَين للسمة insightTrafficSourceType. في السابق، كانت السمة تميّز بين الفيديوهات التي تم تشغيلها كجزء من قائمة تشغيل (PLAYLIST) والمشاهدات التي نشأت من صفحة تعرض جميع الفيديوهات في قائمة تشغيل (YT_PLAYLIST_PAGE). من الآن فصاعدًا، سيتم ربط كلا النوعَين من المشاهدات بقيمة السمة PLAYLIST.

‫15 ديسمبر 2022

تتيح واجهة برمجة التطبيقات لإحصاءات YouTube (الطلبات المستهدفة) استخدام بُعدَين جديدَين وتقرير جديد:

  • يوفّر تقرير جديد نشاط المستخدم حسب المدينة. يتوفّر هذا التقرير للقنوات ومالكي المحتوى. يحتوي هذا التقرير على السمة الجديدة city التي تحدّد تقدير YouTube للمدينة التي تم فيها نشاط المستخدم.

  • تحدّد السمة الجديدة creatorContentType نوع محتوى YouTube المرتبط بمقاييس نشاط المستخدم في صف البيانات. القيم المسموح بها هي LIVE_STREAM وSHORTS وSTORY وVIDEO_ON_DEMAND.

    تتوفّر السمة creatorContentType كسمة اختيارية لجميع تقارير الفيديوهات الخاصة بالقنوات ومالكي المحتوى.

  • يتضمّن دليل نماذج الطلبات في YouTube Analytics API الآن أمثلة على السمتَين الجديدتَين.

  • تمت إزالة الإشارات إلى السمتَين 7DayTotals و30DayTotals من المستندات. تم الإعلان عن إيقاف هذه السمات نهائيًا في أكتوبر 2019.

‫26 أغسطس 2022

تتيح كل من واجهة YouTube Analytics API (الطلبات المستهدفة) وواجهة YouTube Reporting API (التقارير المجمّعة) استخدام قيمة جديدة لتفاصيل مصدر الزيارات:

  • في YouTube Analytics API (الطلبات المستهدفة)، إذا كانت قيمة السمة insightTrafficSourceType هي SUBSCRIBER، يمكن ضبط قيمة insightTrafficSourceDetail على podcasts، ما يشير إلى أنّ الزيارات تمّت إحالتها من صفحة "البودكاست" المقصودة.
  • في YouTube Reporting (تقارير مجمّعة) API، إذا كانت قيمة السمة traffic_source_type هي 3، يمكن ضبط قيمة traffic_source_detail على podcasts، ما يشير إلى أنّ الزيارات تمّت إحالتها من صفحة البودكاست المقصودة.

11 شباط (فبراير) 2022

ستتغيّر مجموعة القيم الصالحة للسمة gender في 11 أغسطس 2022 أو بعد هذا التاريخ. قد يكون هذا التغيير غير متوافق مع الأنظمة القديمة في تنفيذ واجهة برمجة التطبيقات. وفقًا لقسم التغييرات غير المتوافقة مع الأنظمة القديمة في بنود خدمة YouTube API، نعلن عن هذا التغيير قبل ستة أشهر من دخوله حيز التنفيذ. يُرجى تعديل عملية تنفيذ واجهة برمجة التطبيقات قبل 11 أغسطس 2022 لضمان الانتقال بسلاسة إلى مجموعة القيم الجديدة.

في ما يلي التغييرات المحدّدة التي سيتم إجراؤها:

  • في YouTube Analytics (Targeted Queries) API، تتيح السمة gender حاليًا استخدام قيمتَين: female وmale. في 11 أغسطس 2022 أو بعد هذا التاريخ، ستتيح هذه السمة ثلاث قيم: female وmale وuser_specified.
  • في YouTube Reporting (تقارير مجمّعة) API، تتيح السمة gender حاليًا استخدام ثلاث قيم: FEMALE وMALE وGENDER_OTHER. في 11 أغسطس 2022 أو بعد هذا التاريخ، ستتغيّر مجموعة القيم المسموح بها لتصبح FEMALE وMALE وUSER_SPECIFIED.

‫9 فبراير 2022

تم تعديل مقياسَين لاستبعاد عدد الزيارات الناتجة من المقاطع المتكررة اعتبارًا من 13 ديسمبر 2021. يؤثر هذا التغيير في كل من YouTube Analytics API (الطلبات المستهدفة) وYouTube Reporting API (التقارير المجمّعة).

2 شباط (فبراير) 2022

تتيح واجهة YouTube Reporting (تقارير مجمّعة) API استخدام قيمة جديدة لسمة مصدر الزيارات تشير إلى أنّ المشاهدات واردة من الحدث المباشر التالي:

  • في YouTube Reporting (تقارير مجمّعة) API، تتيح السمة traffic_source_type استخدام القيمة 28.

بالنسبة إلى نوع مصدر الزيارات هذا، تحدّد السمة traffic_source_detail معرّف القناة التي تمّت إحالة المشاهد منها.

23 أيلول (سبتمبر) 2020

تتيح كل من واجهة YouTube Analytics API (الطلبات المستهدفة) وواجهة YouTube Reporting API (التقارير المجمّعة) استخدام قيمة جديدة لسمة مصدر الزيارات تشير إلى أنّه تمت إحالة المشاهد من خلال التمرير عموديًا في تجربة مشاهدة فيديوهات YouTube Shorts:

  • في YouTube Analytics API (الطلبات المستهدفة)، تتيح السمة insightTrafficSourceType استخدام القيمة SHORTS.
  • في YouTube Reporting (تقارير مجمّعة) API، تتيح السمة traffic_source_type استخدام القيمة 24.

لا يتم ملء سمة تفاصيل مصدر الزيارات (insightTrafficSourceDetail في YouTube Analytics API أو traffic_source_detail في YouTube Reporting API) لهذا النوع الجديد من مصادر الزيارات.

‫20 يوليو 2020

يشمل هذا التعديل تغييرَين يؤثران في إحصاءات YouTube (الطلبات المستهدفة) API:

  • تمت زيادة الحد الأقصى لحجم مجموعة إعداد تقارير "إحصاءات YouTube" من 200 إلى 500 عنصر.
  • تحدّد المَعلمة filters في الطريقة reports.query قائمة بالفلاتر التي يجب تطبيقها عند استرداد بيانات "إحصاءات YouTube". تتيح المَعلمة تحديد قيم متعددة لفلاتر video وplaylist وchannel، وقد تمت زيادة الحد الأقصى لعدد المعرّفات التي يمكن تحديدها لهذه الفلاتر من 200 إلى 500 معرّف.

‫13 فبراير 2020

يتضمّن هذا التعديل التغييرات التالية المتعلّقة بواجهة YouTube Analytics API (الطلبات المستهدفة) وواجهة YouTube Reporting API (التقارير المجمّعة). يمكنك الاطّلاع على مزيد من المعلومات عن هذه التعديلات في مركز مساعدة YouTube.

في كلتا واجهتَي برمجة التطبيقات، ستتغيّر مجموعة القيم المحتملة لتفاصيل مصدر الزيارات للإشعارات. في الطلبات المستهدفة، يتم تسجيل الإشعارات على أنّها insightTrafficSourceType=NOTIFICATION. في التقارير المجمّعة، يتم تسجيل الإشعارات على أنّها traffic_source_type=17.

تقسّم القيم الجديدة الإشعارات المتعلّقة بالفيديوهات المحمَّلة وأحداث البث المباشر، والتي تم الإبلاغ عنها سابقًا على أنّها uploaded، إلى فئتَين:

  • uploaded_push - المشاهدات الناتجة من الإشعارات الفورية التي تم إرسالها إلى المشتركين عند تحميل فيديو
  • uploaded_other - المشاهدات التي مصدرها إشعارات غير فورية، مثل الإشعارات في البريد الإلكتروني أو البريد الوارد، والتي تم إرسالها إلى المشتركين عند تحميل فيديو

يتم عرض هذه القيم للنطاق الزمني الذي يبدأ في ‎2020-01-13 (13 يناير 2020).

ونذكّركم أيضًا بأنّ هذه القيم لا تمثّل الإشعارات نفسها، بل مصادر الزيارات التي أدّت إلى تحقيق عدد معيّن من المشاهدات على YouTube. على سبيل المثال، إذا كان صف في التقرير يشير إلى views=3 وtraffic_source_type=17 (NOTIFICATION) وtraffic_source_detail=uploaded_push، يعني ذلك أنّ ثلاث مشاهدات نتجت من نقر المشاهدين على الإشعارات الفورية التي تم إرسالها عند تحميل الفيديو.

15 تشرين الأول (أكتوبر) 2019

يتضمّن هذا التعديل التغييرات التالية المتعلّقة بواجهة YouTube Analytics (Targeted Queries) API:

  • ملاحظة: هذا إشعار بالإيقاف النهائي.

    ستزيل منصة YouTube إمكانية استخدام السمتَين 7DayTotals و30DayTotals. وسيظل بإمكانك استرداد البيانات باستخدام هذه السمات حتى 15 أبريل 2020. في هذا التاريخ أو بعده، ستؤدي محاولات استرداد التقارير باستخدام السمة 7DayTotals أو 30DayTotals إلى ظهور رسالة خطأ.

    يُرجى العِلم أنّه يمكن للمستخدمين إعادة إنشاء بعض البيانات لهذه السمات من خلال طلب البحث باستخدام السمة day وتجميع البيانات أو اشتقاقها على مدار فترات تبلغ 7 أيام أو 30 يومًا. على سبيل المثال:

    • يمكن احتساب عدد المشاهدات لفترة سبعة أيام من خلال تجميع عدد المشاهدات من كل يوم من تلك الفترة.
    • يمكن احتساب viewerPercentage لفترة سبعة أيام من خلال ضرب عدد المشاهدات التي حدثت كل يوم في viewerPercentage لذلك اليوم للحصول على عدد المشاهدين الذين سجّلوا الدخول عند مشاهدة الفيديو في ذلك اليوم. بعد ذلك، يمكن إضافة عدد المشاهدين الذين سجّلوا الدخول خلال الفترة بأكملها وقسمته على إجمالي عدد المشاهدات لتلك الفترة للحصول على viewerPercentage للفترة بأكملها.
    • لا يمكن احتساب عدد المشاهدين الفرديين لفترة سبعة أيام لأنّه يمكن احتساب المشاهد نفسه كمشاهد فردي في أيام مختلفة. ومع ذلك، قد تتمكّن من استخدام السمة month بدلاً من السمة 30DayTotals لاستقراء بيانات حول عدد المشاهدين الفرديين خلال فترة 30 يومًا. يُرجى العِلم أنّ السمة month تشير إلى الأشهر التقويمية، في حين أنّ السمة 30DayTotals تحتسب فترات مدتها 30 يومًا استنادًا إلى تاريخَي البدء والانتهاء المحدّدَين.

‫27 يونيو 2019

يتضمّن هذا التعديل التغييرات التالية المتعلّقة بواجهة YouTube Analytics (Targeted Queries) API:

  • بما أنّ الإصدار 1 من واجهة برمجة التطبيقات قد تم إيقافه نهائيًا، تم تعديل المستندات لإزالة الإشارات إلى هذا الإصدار، بما في ذلك إشعار الإيقاف النهائي ودليل نقل البيانات الذي يشرح كيفية الترقية إلى الإصدار 2.

‫1 نوفمبر 2018

يتضمّن هذا التعديل التغييرات التالية المتعلّقة بواجهة YouTube Analytics (Targeted Queries) API:

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

    يُرجى العِلم أنّه تم الإعلان عن الجدول الزمني لهذا الإيقاف النهائي في 26 أبريل 2018.

‫17 سبتمبر 2018

يتضمّن هذا التعديل التغييرات التالية المتعلّقة بواجهة YouTube Analytics (Targeted Queries) API:

  • يشرح قسم إخفاء هوية البيانات الجديد في مستند نظرة عامة على نموذج البيانات أنّ بعض بيانات "إحصاءات YouTube" تكون محدودة عندما لا تستوفي المقاييس حدًا معيّنًا. يمكن أن يحدث ذلك في حالات مختلفة. من الناحية العملية، يعني ذلك أنّ التقرير قد لا يتضمّن كل بياناتك (أو أيًا منها) في الحالات التالية:

    1. إذا كان عدد الزيارات إلى فيديو أو قناة محدودًا خلال فترة زمنية محددة

      أو

    2. إذا اخترتم فلترًا أو سمة، مثل مصدر الزيارات أو البلد، ولم تتوفر بيانات كافية مرتبطة بهما

    يتضمّن القسم الجديد أيضًا مناقشة حول أنواع البيانات التي قد تكون محدودة في تقارير "إحصاءات YouTube".

  • تم تعديل مستندات تقارير القنوات وتقارير مالك المحتوى لتعكس حقيقة أنّ مقياسَي redViews وestimatedRedMinutesWatched لم يعودا متاحَين لتقارير موقع التشغيل ومصدر الزيارات ونوع الجهاز/نظام التشغيل.

‫18 يونيو 2018

يتضمّن هذا التعديل التغييرات التالية على YouTube Analytics (Targeted Queries) API:

  • تغيّرت متطلبات النطاق للطُرق التالية:
    • يجب أن تملك الطلبات المرسَلة إلى طريقة reports.query إذن الوصول إلى نطاق https://www.googleapis.com/auth/youtube.readonly.
    • يجب أن تملك الطلبات المرسَلة إلى طريقة groupItems.list إذن الوصول إلى أيّ مما يلي:
      • نطاق https://www.googleapis.com/auth/youtube
        أو
      • نطاق https://www.googleapis.com/auth/youtube.readonly
        و
        نطاق https://www.googleapis.com/auth/yt-analytics.readonly

      يستخدم الخيار الأول نطاقًا واحدًا، وهو نطاق قراءة وكتابة، بينما يستخدم الخيار الثاني نطاقَين للقراءة فقط.

‫23 مايو 2018

يتضمّن هذا التعديل التغييرات التالية على YouTube Analytics (Targeted Queries) API:

  • تتضمّن نظرة عامة على واجهة برمجة التطبيقات قسمًا جديدًا بعنوان المقاييس المجمّعة والعناصر المحذوفة، يشرح كيفية تعامل الردود من واجهة برمجة التطبيقات مع البيانات المرتبطة بالمراجع المحذوفة، مثل الفيديوهات أو قوائم التشغيل أو القنوات.
  • تم تعديل قسم أفضل الممارسات في نظرة عامة على واجهة برمجة التطبيقات لتذكيرك بأنّه يمكنك استخدام YouTube Data API لاسترداد بيانات وصفية إضافية للموارد المحدّدة في الردود من YouTube Analytics API. كما هو موضّح في سياسات مطوّري خدمات YouTube API (الأقسام من III.E.4.b إلى III.E.4.d)، على عملاء واجهة برمجة التطبيقات إما حذف البيانات الوصفية المخزّنة للموارد من واجهة برمجة التطبيقات هذه أو إعادة تحميلها بعد 30 يومًا.

‫22 مايو 2018

يتضمّن هذا التعديل التغييرات التالية المتعلّقة بواجهة YouTube Reporting (Bulk Reports) API:

  • من المقرّر حاليًا أن تسري التغييرات التالية في يوليو 2018، وستنطبق السياسات الجديدة على جميع التقارير ومهام إعداد التقارير على مستوى العالم.

    • بعد إجراء التغيير، ستكون معظم تقارير واجهة برمجة التطبيقات، بما في ذلك تقارير البيانات السابقة، متاحة لمدة 60 يومًا من وقت إنشائها. ومع ذلك، ستكون التقارير التي تحتوي على بيانات سابقة متاحة لمدة 30 يومًا من وقت إنشائها.

      قبل هذا الإعلان، كانت جميع تقارير واجهة برمجة التطبيقات متاحة لمدة 180 يومًا من تاريخ إنشائها. للتوضيح، عندما يدخل هذا التغيير في السياسة حيّز التنفيذ، لن يعود بإمكانك الوصول إلى تقارير البيانات السابقة التي مرّ عليها أكثر من 30 يومًا من خلال واجهة برمجة التطبيقات. ولن يعود بإمكانك الوصول إلى جميع التقارير الأخرى التي مرّ عليها أكثر من 60 يومًا. لذلك، تنصّ المستندات الآن على أنّ التقارير التي تم إنشاؤها قبل تغيير السياسة ستكون متاحة لمدة تصل إلى 180 يومًا.

    • بعد إجراء هذا التغيير، عندما تحدّد موعدًا لمهمة إعداد التقارير، سينشئ YouTube تقارير من ذلك اليوم فصاعدًا، وستغطي هذه التقارير فترة الـ 30 يومًا السابقة لموعد المهمة. قبل إجراء هذا التغيير، عندما تحدّد موعدًا لمهمة إعداد التقارير، سينشئ YouTube تقارير تغطي فترة الـ 180 يومًا السابقة لموعد المهمة.

  • تم تعديل قسم أفضل الممارسات لتذكيرك بأنّه يمكنك استخدام YouTube Data API لاسترداد بيانات وصفية إضافية للمراجع المحدّدة في التقارير. كما هو موضّح في سياسات مطوّري خدمات YouTube API (الأقسام من III.E.4.b إلى III.E.4.d)، على عملاء واجهة برمجة التطبيقات إما حذف البيانات الوصفية المخزّنة للموارد من واجهة برمجة التطبيقات هذه أو إعادة تحميلها بعد 30 يومًا.

  • تم تعديل قسم خصائص التقارير للإشارة إلى أنّه على الرغم من عدم فلترة بيانات التقارير، لن تتضمّن التقارير التي تحتوي على بيانات لفترة زمنية في 1 يونيو 2018 أو بعده أي إشارات إلى موارد YouTube التي تم حذفها قبل 30 يومًا على الأقل من تاريخ إنشاء التقرير.

  • تم تعديل قسم البيانات السابقة في نظرة عامة على واجهة برمجة التطبيقات للإشارة إلى أنّه عند جدولة مهمة إعداد تقارير جديدة، يتم عادةً نشر التقارير السابقة في غضون يومَين. في السابق، كانت المستندات تشير إلى أنّ توفُّر هذه التقارير قد يستغرق مدة تصل إلى 30 يومًا.

  • تم تعديل قسم بيانات التعبئة في نظرة عامة على واجهة برمجة التطبيقات لتحديد بيانات التعبئة بشكل أوضح كمجموعة بيانات تحلّ محلّ مجموعة تم تسليمها سابقًا.

‫26 أبريل 2018

أصبح الإصدار 2 من YouTube Analytics (Targeted Queries) API (v2) متاحًا الآن للجميع. تحدّد القائمة التالية التغييرات في المنتج والمستندات ذات الصلة بالإصدار الجديد من واجهة برمجة التطبيقات:

  • يتطابق الإصدار 2 من واجهة برمجة التطبيقات تقريبًا مع الإصدار 1. ومع ذلك، ستحتاج على الأرجح إلى تعديل الرمز ليعكس التغييرات المذكورة أدناه. تم شرح كل هذه التغييرات بالتفصيل في دليل نقل البيانات الجديد.

    • تم تغيير إصدار واجهة برمجة التطبيقات من v1 إلى v2.
    • تم تغيير الجزء الأساسي من عنوان URL لطلبات البيانات من واجهة برمجة التطبيقات من https://www.googleapis.com/youtube/analytics/v1 إلى https://youtubeanalytics.googleapis.com/v2.
    • تم تعديل أسماء عدة مَعلمات لطريقة reports.query. على وجه التحديد، أسماء المَعلمات التي تحتوي على واصلات، مثل end-date في الإصدار 1 من واجهة برمجة التطبيقات، تستخدم تنسيق Camel Case (endDate) بدلاً من الواصلات في الإصدار 2 من واجهة برمجة التطبيقات. يجعل هذا التغيير أسماء المَعلمات متسقة في جميع أنحاء واجهة برمجة التطبيقات لأنّ طرق واجهة برمجة التطبيقات لإنشاء المجموعات وإدارتها تستخدم تنسيق Camel Case لأسماء المَعلمات.
    • لا يتيح الإصدار 2 من واجهة برمجة التطبيقات إرسال الطلبات المجمّعة إلى نقطة النهاية المجمّعة العامة لبروتوكول HTTP من Google ‏(www.googleapis.com/batch). إذا كنت ترسل طلبات مجمّعة في الإصدار 2 من واجهة برمجة التطبيقات، عليك استخدام نقطة النهاية https://youtubeanalytics.googleapis.com/v2 بدلاً من ذلك.

    بالإضافة إلى ذلك، لا تتوفّر بعض ميزات الإصدار 1 في الإصدار 2 من واجهة برمجة التطبيقات:

    • لم تعُد الطريقة reports.query تتيح استخدام مَعلمات الطلب alt وquotaUser وuserIp.
    • لا توفّر واجهة برمجة التطبيقات v2 نقطة نهاية مجمّعة تتيح استخدام مجموعات تتألف من طلبات إلى واجهات برمجة تطبيقات مختلفة. (ومع ذلك، يمكن أن تتألف الدفعة من طلبات إلى طرق مختلفة لواجهة برمجة التطبيقات نفسها). لا يقتصر هذا الإيقاف النهائي على YouTube Analytics API، لأنّ Google ستوقف نهائيًا نقطة النهاية المجمّعة العامة في جميع واجهات برمجة التطبيقات.
    • لا يتوافق الإصدار الثاني من واجهة برمجة التطبيقات مع بروتوكول JSON-RPC الذي كان متوافقًا مع الإصدار الأول من واجهة برمجة التطبيقات. نكرّر أنّ عملية الإيقاف النهائي هذه لا تقتصر على YouTube Analytics API.

  • ملاحظة: هذا إشعار بالإيقاف النهائي.

    تم إيقاف الإصدار 1 من واجهة برمجة التطبيقات (v1) نهائيًا، وسيكون متاحًا حتى 31 أكتوبر 2018. وستتوقف جميع الطلبات المرسَلة إلى الإصدار v1 من واجهة برمجة التطبيقات عن العمل بعد ذلك التاريخ. لذلك، يُرجى التأكّد من الترقية إلى الإصدار الثاني من واجهة برمجة التطبيقات في موعد أقصاه 31 أكتوبر 2018 لتجنُّب أي انقطاع في إمكانية الوصول إلى بيانات "إحصاءات YouTube" من خلال واجهة برمجة التطبيقات.

‫21 فبراير 2018

يتضمّن هذا التعديل التغييرات التالية على YouTube Analytics (Targeted Queries) API:

  • لم تعُد تقارير الأداء حسب المعلومات السكانية للمشاهدين، التي تجمع إحصاءات المشاهدة استنادًا إلى الفئة العمرية للمشاهدين وجنسهم، تتيح استخدام السمة youtubeProduct التي تحدّد خدمة YouTube التي حدث فيها نشاط المستخدم.

‫18 يناير 2018

يتضمّن هذا التحديث التغييرات التالية:

  • ‫YouTube Reporting API (التقارير المجمّعة)

    • أصبح البُعد operating_system الذي يحدّد نظام برنامج الجهاز الذي تم عرض الفيديوهات عليه يتيح استخدام القيمة التالية:
      • 25: KaiOS

  • ‫YouTube Analytics API (الطلبات المستهدَفة)

    • تتيح السمة operatingSystem استخدام قيمة السمة KAIOS.

‫20 ديسمبر 2017

يتضمّن هذا التعديل تغييرَين يتعلّقان بواجهة YouTube Reporting API:

  • يتيح خادم واجهة برمجة التطبيقات الآن ضغط gzip للطلبات التي تنزّل التقارير. يُرجى العِلم أنّ ضغط gzip غير متاح لأنواع أخرى من طلبات البيانات من واجهة برمجة التطبيقات. يؤدي تفعيل ضغط gzip إلى تقليل معدّل نقل البيانات المطلوب لكل ردّ من واجهة برمجة التطبيقات. وعلى الرغم من أنّ تطبيقك سيحتاج إلى وقت وحدة المعالجة المركزية إضافي لفك ضغط الردود من واجهة برمجة التطبيقات، فإنّ فائدة استهلاك موارد أقل للشبكة تفوق عادةً هذه التكلفة.

    لتلقّي استجابة مرمّزة باستخدام gzip، اضبط عنوان طلب HTTP‏ Accept-Encoding على gzip كما هو موضّح في المثال التالي:

    Accept-Encoding: gzip

    يتم شرح هذه الوظيفة في نظرة عامة على واجهة برمجة التطبيقات وفي تعريف السمة downloadUrl للمورد report.

  • تم تصحيح مستندات السمتَين age group وgender لعرض القيم الفعلية التي تعرضها واجهة برمجة التطبيقات لهاتين السمتَين. يُرجى العِلم أنّ هذا تصحيح للمستندات ولا يعكس تغييرًا في وظائف واجهة برمجة التطبيقات أو سلوكها. على وجه التحديد، تم تغيير القيم التالية:

    • تستخدم قيم السمة age_group أحرفًا كبيرة، وتحتوي على شرطات سفلية بين الكلمة AGE والأرقام في الفئة العمرية، وتستخدم شرطات سفلية بدلاً من الواصلات. وبالتالي، تم تصحيح القيم مثل age13-17 وage18-24 إلى AGE_13_17 وAGE_18_24 على التوالي.
    • تستخدم قيم السمة gender أحرفًا كبيرة. وبالتالي، تم تصحيح القيم female وmale وgender_other إلى FEMALE وMALE وGENDER_OTHER.

‫10 أغسطس 2017

في 10 آب (أغسطس) 2016، أعلنت هذه المستندات عن إيقاف المقياس earnings نهائيًا في YouTube Analytics API. (في الوقت نفسه، أضافت واجهة برمجة التطبيقات إمكانية استخدام مقياس جديد باسم estimatedRevenue يوفّر البيانات نفسها).

بما أنّ مقياس earnings كان مقياسًا أساسيًا، فقد تم توفيره لمدة عام واحد من تاريخ الإعلان. وبعد انتهاء هذه الفترة التي استمرت لمدة عام، لم يعُد مقياس earnings متاحًا. ونتيجةً لذلك، فإنّ طلبات البيانات من واجهة برمجة التطبيقات التي تحدّد المقياس earnings تعرض الآن رمز استجابة HTTP‏ 400. إذا لم يسبق لك تحديث تطبيقك لاستخدام مقياس estimatedRevenue بدلاً من مقياس earnings، يُرجى إجراء ذلك في أقرب وقت ممكن.

تم تعديل مستندات واجهة برمجة التطبيقات لإزالة الإشارات المتبقية إلى مقياس earnings.

‫6 يوليو 2017

يتضمّن هذا التحديث التغييرات التالية:

  • ‫YouTube Analytics API (الطلبات المستهدَفة)

    • تم تعديل مستندات واجهة برمجة التطبيقات لتعكس حقيقة أنّ الردود من واجهة برمجة التطبيقات تحتوي على بيانات حتى آخر يوم في النطاق الزمني المطلوب الذي تتوفّر فيه جميع المقاييس التي يتم طلبها.

      على سبيل المثال، إذا حدّد طلب تاريخ انتهاء في 5 يوليو 2017، وكانت قيم جميع المقاييس المطلوبة متاحة فقط حتى 3 يوليو 2017، سيكون هذا هو آخر تاريخ يتم تضمين البيانات فيه في الاستجابة. (ينطبق ذلك حتى إذا كانت بيانات بعض المقاييس المطلوبة متاحة في 4 يوليو 2017).

    • تتيح السمة adType الآن القيمة reservedBumperInstream، والتي تشير إلى إعلان فيديو غير قابل للتخطّي تصل مدته إلى 6 ثوانٍ ويتم تشغيله قبل أن يتمكّن المستخدم من مشاهدة الفيديو. شكل الإعلان مطابق لإعلان "auctionBumperInstream"، ولكن يشير هذا النوع إلى الإعلانات التي يتم بيعها على أساس الحجز بدلاً من المزاد.

  • ‫YouTube Reporting API (التقارير المجمّعة)

    • تتيح السمة ad_type الآن استخدام القيمة 20 التي تشير إلى "إعلانات الملصقات الصغيرة" التي يتم بيعها على أساس الحجز. "إعلانات الملصقات الصغيرة" هي إعلانات فيديو غير قابلة للتخطّي تصل مدتها إلى 6 ثوانٍ ويتم تشغيلها قبل أن يتمكّن المستخدم من مشاهدة الفيديو. يُرجى العِلم أنّ القيمة 19 لهذه السمة تشير أيضًا إلى "إعلانات الملصقات الصغيرة" التي يتم بيعها في مزاد بدلاً من بيعها على أساس الحجز.

    • تم حذف مهام إعداد التقارير التالية في YouTube Reporting API:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      تم الإعلان عن إيقاف أنواع التقارير هذه نهائيًا في 15 سبتمبر 2016، ولم يعُد يتم إنشاء تقارير لأنواع التقارير هذه بعد 15 ديسمبر 2016. وظلّت التقارير التي تم إنشاؤها سابقًا متاحة لمدة 180 يومًا من وقت إنشائها. وبالتالي، كان من الممكن الوصول إلى بعض التقارير حتى 15 يونيو 2017. ومع ذلك، بما أنّ التقارير لم تعُد متاحة، لم تعُد هناك حاجة إلى المهام المرتبطة بها أيضًا.

‫24 مايو 2017

تم حذف جميع مهام إعداد التقارير التالية في YouTube Reporting API:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

تم الإعلان عن إيقاف أنواع التقارير هذه نهائيًا في 22 يونيو 2016، ولم يعُد يتم إنشاء تقارير لهذه الأنواع بعد 22 سبتمبر 2016. وظلّت التقارير التي تم إنشاؤها سابقًا متاحة لمدة 180 يومًا من وقت إنشائها. وبالتالي، كان من الممكن الوصول إلى بعض التقارير حتى 22 مارس 2017. ومع ذلك، بما أنّ التقارير لم تعُد متاحة، لم تعُد هناك حاجة إلى المهام المرتبطة بها أيضًا.

‫22 مايو 2017

يتضمّن هذا التحديث التغييرات التالية:

  • ‫YouTube Reporting API (التقارير المجمّعة)

    • أصبحت السمة sharing_service التي تحدّد الخدمة المستخدَمة لمشاركة الفيديوهات تتيح الآن استخدام القيم التالية:
      • ‫85: YouTube Music
      • ‫86: YouTube Gaming
      • 87: YouTube Kids
      • ‫88: YouTube TV

      بالإضافة إلى ذلك، تم تعديل الاسم المستخدَم لتحديد القيمة 52 في المستندات إلى Kakao (Kakao Talk) لتمييزها بشكل أوضح عن القيمة 73 ‏(Kakao Story). لا يعكس هذا التغيير أي تغيير في سلوك واجهة برمجة التطبيقات أو تصنيف الفيديوهات التي تتم مشاركتها مع هذه الخدمات.

  • ‫YouTube Analytics API (الطلبات المستهدَفة)

    • تتيح السمة sharingService الآن استخدام القيم التالية:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

‫28 مارس 2017

يمكن الآن لمالكي القنوات الذين يمكنهم الوصول إلى بيانات الأرباح من خلال "إحصاءات YouTube" في "استوديو صنّاع المحتوى" الوصول إلى بيانات الأرباح هذه أيضًا من خلال YouTube Analytics API:

‫17 مارس 2017

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح واجهة YouTube Analytics API استخدام المقياسَين redViews وestimatedRedMinutesWatched، وكلاهما مرتبطان بنسبة المشاهدة في YouTube Red. في الواقع، كانت واجهة برمجة التطبيقات تتيح استخدام هذين المقياسَين لبعض الوقت، وتتيح واجهة YouTube Reporting API استخدام كليهما كما تم الإعلان عنه في 15 سبتمبر 2016.

    • يحدّد مقياس redViews عدد المرات التي شاهد فيها أعضاء YouTube Red فيديو معيّنًا.
    • يحدّد المقياس estimatedRedMinutesWatched عدد الدقائق التي شاهد فيها المشتركون في YouTube Red فيديو معيّنًا.

    تم تعديل مستندات تقارير القنوات وتقارير مالكي المحتوى لعرض التقارير التي تتيح استخدام المقياسَين الجديدَين. وهي متاحة في أي تقارير كانت تتيح استخدام مقياسَي views وestimatedMinutesWatched.

‫3 مارس 2017

يتضمّن هذا التحديث التغييرات التالية:

  • ‫YouTube Reporting API (التقارير المجمّعة)

    • تم تصحيح تعريف السمة date للإشارة إلى أنّ قيمة السمة تشير إلى الفترة التي تبدأ في الساعة 12:00 صباحًا بتوقيت المحيط الهادئ وتنتهي في الساعة 11:59 مساءً بتوقيت المحيط الهادئ في اليوم والشهر والسنة المحدّدة. يُرجى العِلم أنّ توقيت المحيط الهادئ هو إما UTC-7 أو UTC-8 حسب الوقت من السنة.

      على الرغم من أنّ التواريخ تمثّل عادةً فترة 24 ساعة، فإنّ التواريخ التي يتم فيها تقديم الساعة تمثّل فترة 23 ساعة، والتواريخ التي يتم فيها تأخير الساعة تمثّل فترة 25 ساعة. (في السابق، كانت المستندات تشير إلى أنّ كل تاريخ يمثّل فترة فريدة مدتها 24 ساعة وأنّ توقيت المحيط الهادئ كان دائمًا UTC-8).

      يُرجى العِلم أنّ هذا التصحيح لا يمثّل تغييرًا في سلوك واجهة برمجة التطبيقات الفعلي.

    • أصبحت السمة operating_system التي تحدّد نظام برنامج الجهاز الذي تم عرض الفيديوهات عليه تتيح استخدام القيم التالية:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • تم حذف جميع مهام إعداد التقارير لنوع التقرير "content_owner_basic_a1". تم إيقاف هذا النوع من التقارير نهائيًا اعتبارًا من 19 أغسطس 2016، ولكنّ تقارير content_owner_basic_a1 التي تم إنشاؤها سابقًا ظلّت متاحة لمدة 180 يومًا من وقت إنشائها. وبالتالي، كان من الممكن الوصول إلى بعض التقارير حتى 19 فبراير 2017. ومع ذلك، بما أنّ التقارير لم تعُد متاحة، لم تعُد هناك حاجة إلى المهام المرتبطة بها أيضًا.

  • ‫YouTube Analytics API (الطلبات المستهدَفة)

    • تم تصحيح وصف السمات ذات الصلة بـ time periods للإشارة إلى أنّ قيمة السمة تشير إلى الفترة التي تبدأ في الساعة 12:00 صباحًا بتوقيت المحيط الهادئ وتنتهي في الساعة 11:59 مساءً بتوقيت المحيط الهادئ في اليوم والشهر والسنة المحدّدة. يُرجى العِلم أنّ توقيت المحيط الهادئ هو إما UTC-7 أو UTC-8 حسب الوقت من السنة.

      على الرغم من أنّ التواريخ تمثّل عادةً فترة 24 ساعة، فإنّ التواريخ التي يتم فيها تقديم الساعة تمثّل فترة 23 ساعة، والتواريخ التي يتم فيها تأخير الساعة تمثّل فترة 25 ساعة. (في السابق، كانت المستندات تشير إلى أنّ توقيت المحيط الهادئ هو UTC-8 ولم تذكر احتمال ألا يمثّل اليوم فترة 24 ساعة).

      يُرجى العِلم أنّ هذا التصحيح لا يمثّل تغييرًا في سلوك واجهة برمجة التطبيقات الفعلي.

    • تم تعديل مستندات تقارير القنوات للإشارة إلى أنّ تقارير القنوات لا تحتوي حاليًا على مقاييس الأرباح أو أداء الإعلانات. نتيجةً لذلك، لا يمنح نطاق https://www.googleapis.com/auth/yt-analytics-monetary.readonly حاليًا إمكانية الوصول إلى البيانات المالية في تقارير القنوات.

    • تتيح السمة operatingSystem استخدام ثلاث قيم جديدة للسمات:
      • FIREFOX
      • REALMEDIA
      • TIZEN

‫8 فبراير 2017

تتيح واجهة YouTube Analytics API الآن استخدام المَعلمة الاختيارية include-historical-channel-data. يُرجى العِلم أنّ هذه المَعلمة تكون ذات صلة فقط عند استرداد تقارير مالك المحتوى.

تتيح هذه المَعلمة لمالك المحتوى الإشارة إلى أنّ الردّ من واجهة برمجة التطبيقات يجب أن يتضمّن بيانات وقت المشاهدة وعدد المشاهدات للقنوات من الفترة الزمنية التي تسبق ربط القنوات بمالك المحتوى. القيمة التلقائية للمَعلمة هي false، ما يعني أنّ الردّ من واجهة برمجة التطبيقات يتضمّن تلقائيًا بيانات وقت المشاهدة والمشاهدات من وقت ربط القنوات بحساب مالك المحتوى.

تنطبق هذه القواعد أيضًا إذا كان طلب البيانات من واجهة برمجة التطبيقات يستردّ بيانات لقنوات متعددة:

  • إذا كانت قيمة المَعلمة هي false، تستند بيانات وقت المشاهدة وعدد المشاهدات التي يتم عرضها لأي قناة معيّنة إلى تاريخ ربط هذه القناة بمالك المحتوى.

    من المهم تذكُّر أنّه من الممكن أن تكون قنوات مختلفة مرتبطة بمالك محتوى في تواريخ مختلفة. إذا كان طلب البيانات من واجهة برمجة التطبيقات يستردّ بيانات لقنوات متعدّدة وكانت قيمة المَعلمة false، سيتضمّن الردّ من واجهة برمجة التطبيقات بيانات وقت المشاهدة وعدد المشاهدات استنادًا إلى تاريخ الربط لكل قناة معنيّة.
  • إذا كانت قيمة المَعلمة true، يعرض الردّ بيانات وقت المشاهدة وعدد المشاهدات لجميع القنوات استنادًا إلى تاريخَي البدء والانتهاء المحدّدَين في طلب البيانات من واجهة برمجة التطبيقات.

‫15 ديسمبر 2016

لم تعُد تقارير YouTube Reporting API التالية متاحة وتمت إزالتها من المستندات. يتوفّر إصدار أحدث من كل تقرير. (تم الإعلان عن الإيقاف النهائي لهذه التقارير في 15 سبتمبر 2016).

تم أيضًا تعديل قائمة أنواع التقارير الحالية في المستندات المرجعية لواجهة برمجة التطبيقات.

‫11 نوفمبر 2016

يتضمّن هذا التحديث التغييرات التالية:

تتيح واجهة YouTube Reporting API ثلاثة تقارير جديدة حول شاشات النهاية، بالإضافة إلى سمات ومقاييس جديدة لهذه التقارير. وتقدّم هذه التقارير إحصاءات حول مرّات الظهور ونسبة النقر إلى الظهور لشاشات النهاية التي تظهر بعد توقّف تشغيل الفيديو.

  • تقارير شاشات النهاية

    • يحتوي تقرير شاشات النهاية لفيديوهات القناة على إحصاءات لجميع فيديوهات القناة.
    • يحتوي تقرير شاشات النهاية لفيديوهات مالك المحتوى على إحصاءات للفيديوهات على أيّ من قنوات مالك المحتوى.
    • يحتوي تقرير شاشات النهاية الخاص بمواد عرض مالك المحتوى على إحصاءات لمواد العرض المرتبطة بالفيديوهات التي تظهر شاشات النهاية بعدها.

  • أبعاد شاشة النهاية

    • ‫end_screen_element_type: نوع عنصر شاشة النهاية المرتبط بالإحصاءات
    • ‫end_screen_element_id: المعرّف الذي يستخدمه YouTube لتحديد عنصر شاشة النهاية بشكل فريد

  • مقاييس شاشة النهاية

    ملاحظة: تتوفّر بيانات مقاييس شاشات النهاية اعتبارًا من 1 مايو 2016.

    • ‫end_screen_element_impressions: إجمالي عدد مرّات ظهور عناصر شاشة النهاية يتم تسجيل مرّة ظهور واحدة لكل عنصر شاشة نهاية يتم عرضه.
    • end_screen_element_clicks: عدد المرّات التي تم فيها النقر على عناصر شاشة النهاية
    • ‫end_screen_element_click_rate: نسبة النقر إلى الظهور لعناصر شاشة النهاية

    • يحتوي "مركز مساعدة YouTube" على معلومات أكثر تفصيلاً حول إضافة شاشات النهاية إلى فيديوهاتك.

  • لم تعُد التقارير التالية متاحة وتمت إزالتها من المستندات. يتوفّر إصدار أحدث من كل تقرير. (تم الإعلان عن الإيقاف النهائي لهذه التقارير في 22 يونيو 2016).

‫8 نوفمبر 2016

يتضمّن هذا التعديل التغييرات التالية على YouTube Analytics API:

  • تم إيقاف المقاييس الواردة في القائمة التالية نهائيًا ولم تعُد متاحة. كما أعلنّا في 10 أغسطس 2016، أصبحت المقاييس الجديدة التي تشير إلى البيانات نفسها متاحة. يعرض الجدول أدناه اسم المقياس المتوقّف نهائيًا واسم المقياس الجديد:

    مقياس متوقّف نهائيًا مقياس جديد
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

‫27 أكتوبر 2016

ينشئ YouTube الآن تلقائيًا مجموعة من تقارير إيرادات الإعلانات التي يديرها النظام لمالكي المحتوى الذين يمكنهم الوصول إلى التقارير المقابلة في قسم التقارير في "استوديو صنّاع المحتوى" في YouTube. تم تصميم تقارير واجهة برمجة التطبيقات الجديدة التي يديرها النظام لتوفير وصول آلي إلى البيانات المتاحة أيضًا في تقارير "استوديو YouTube" القابلة للتنزيل يدويًا.

تقدّم النظرة العامة على التقارير التي يديرها النظام لمحة موجزة عن التقارير الجديدة وتشرح عملية استردادها من خلال واجهة برمجة التطبيقات. تختلف هذه العملية قليلاً عن عملية استرداد التقارير المجمّعة في "إحصاءات YouTube" لأنّه ليس على الشركاء جدولة المهام لإنشاء التقارير.

تم تعديل السمة id في المورد reportType لتشمل قائمة بالتقارير التي يديرها النظام ويمكنك الوصول إليها من خلال واجهة برمجة التطبيقات:

  • إيرادات الإعلانات الشهرية لكل فيديو على مستوى العالم
  • إيرادات الإعلانات اليومية لكل فيديو حسب البلد
  • الإيرادات الشهرية من الإعلانات لكل مادة عرض على مستوى العالم
  • إيرادات الإعلانات اليومية لكل مادة عرض حسب البلد
  • المطالبات (لا يتضمّن هذا التقرير بيانات الأرباح)

‫27 سبتمبر 2016

ملاحظة: هذا إشعار بالإيقاف النهائي.

تم إيقاف المقياس uniques نهائيًا في YouTube Analytics API. هذا ليس مقياسًا أساسيًا، وسيكون متاحًا حتى 31 أكتوبر 2016.

‫15 سبتمبر 2016

يتضمّن هذا التعديل التغييرات التالية على YouTube Reporting API:

  • تتيح واجهة برمجة التطبيقات استخدام مقياسَين جديدَين مرتبطَين بنسبة المشاهَدة في YouTube Red:

    • red_views: عدد المرات التي شاهد فيها المشتركون في YouTube Red فيديو معيّنًا
    • ‫red_watch_time_minutes: عدد الدقائق التي شاهد فيها المشتركون في YouTube Red فيديو معيّنًا

  • تتيح واجهة برمجة التطبيقات إصدارات جديدة من 20 تقريرًا. تتوافق جميع الإصدارات الجديدة مع مقياسَي red_views وred_watch_time_minutes الجديدَين.

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

    تحدّد القوائم التالية أرقام تعريف أنواع التقارير الجديدة:

  • ملاحظة: هذا إشعار بالإيقاف النهائي.

    يُرجى العِلم أنّه إذا كانت لديك مهام لإنشاء أيّ من النُسخ القديمة من التقارير المذكورة أعلاه، عليك إنشاء مهام جديدة للتقارير التي تمت إعادة تسميتها. بالتزامن مع إصدار نُسخ التقارير الجديدة، تم إيقاف نُسخ التقارير التالية نهائيًا:

    • channel_basic_a1
    • channel_province_a1
    • channel_playback_location_a1
    • channel_traffic_source_a1
    • channel_device_os_a1
    • channel_subtitles_a1
    • channel_combined_a1
    • content_owner_basic_a2
    • content_owner_province_a1
    • content_owner_playback_location_a1
    • content_owner_traffic_source_a1
    • content_owner_device_os_a1
    • content_owner_subtitles_a1
    • content_owner_combined_a1
    • content_owner_asset_basic_a1
    • content_owner_asset_province_a1
    • content_owner_asset_playback_location_a1
    • content_owner_asset_traffic_source_a1
    • content_owner_asset_device_os_a1
    • content_owner_asset_combined_a1

    إذا كانت لديك مهام لأي من هذه التقارير، لن ينشئ YouTube تقارير جديدة لهذه المهام بعد 15 ديسمبر 2016. ستبقى التقارير التي تم إنشاؤها متاحة لمدة 180 يومًا من وقت إنشائها.

‫19 أغسطس 2016

يتضمّن هذا التعديل التغيير التالي في YouTube Reporting API:

  • تم إيقاف تقرير content_owner_basic_a1 نهائيًا وإزالته من المستندات. لن ينشئ YouTube بعد الآن تقارير جديدة من هذا النوع، ولكن ستبقى التقارير التي تم إنشاؤها سابقًا متاحة لمدة 180 يومًا من تاريخ إنشائها.

    تم استبدال تقرير "content_owner_basic_a1" بتقرير "content_owner_basic_a2" كما هو موضّح في إدخال سجلّ النُسخ السابقة في 19 مايو 2016.

‫11 أغسطس 2016

يتضمّن هذا التحديث التغييرات التالية:

  • توفّر بنود الخدمة المنشورة حديثًا لخدمات YouTube API (المُشار إليها باسم "البنود المعدَّلة") مجموعة غنية من التعديلات على بنود الخدمة الحالية، وهي موضّحة بالتفصيل في مدوّنة YouTube Engineering and Developers. بالإضافة إلى البنود المعدَّلة التي ستسري اعتبارًا من 10 فبراير 2017، يتضمّن هذا التعديل العديد من المستندات الداعمة للمساعدة في شرح السياسات التي يجب على المطوّرين اتّباعها.

    تم توضيح المجموعة الكاملة من المستندات الجديدة في سجلّ النُسخ السابقة من "البنود المعدَّلة". بالإضافة إلى ذلك، سيتم أيضًا شرح التغييرات المستقبلية على "البنود المعدَّلة" أو على المستندات الداعمة في سجلّ النُسخ السابقة هذا.

‫10 أغسطس 2016

يتضمّن هذا التحديث التغييرات التالية:

  • ‫YouTube Analytics API (الطلبات المستهدَفة)

    • ملاحظة: هذا إشعار بالإيقاف النهائي.

      سيتم إيقاف المقاييس الواردة في الجدول التالي نهائيًا. في الوقت نفسه، يتم طرح مقاييس جديدة تشير إلى البيانات نفسها. يعني ذلك أنّه تتم إعادة تسمية المقاييس القديمة، مع أنّ واجهة YouTube Analytics API ستتيح استخدام اسمَي المقياسَين حتى تواريخ الإيقاف النهائي المدرَجة في الجدول.

      اسم المقياس القديم اسم المقياس الجديد تاريخ الدعم
      earnings estimatedRevenue ‫10 أغسطس 2017
      adEarnings estimatedAdRevenue 4 تشرين الثاني (نوفمبر)، 2016
      redPartnerRevenue estimatedRedPartnerRevenue 4 تشرين الثاني (نوفمبر)، 2016
      impressionBasedCpm cpm 4 تشرين الثاني (نوفمبر)، 2016
      impressions adImpressions 4 تشرين الثاني (نوفمبر)، 2016

      يُرجى العِلم أنّ مقياس earnings كان مقياسًا أساسيًا، لذا سيظل متاحًا لمدة عام واحد من تاريخ هذا الإعلان. أما المقاييس الأخرى، التي لم تكن مقاييس أساسية، فستكون متاحة لمدة ثلاثة أشهر، حتى 4 تشرين الثاني (نوفمبر) 2016.

      على سبيل المثال، حتى 4 تشرين الثاني (نوفمبر) 2016، يمكن أن يحدّد طلب بيانات من واجهة برمجة التطبيقات المقياس impressionBasedCpm أو المقياس cpm أو كليهما. ومع ذلك، بعد هذا التاريخ، سيتوفّر مقياس cpm فقط.

    • تتيح السمة insightTrafficSourceType استخدام قيمتَين جديدتَين للسمة:
      • ‫CAMPAIGN_CARD: لا يتوفّر مصدر الزيارات هذا إلا في تقارير مالك المحتوى. ويشير ذلك إلى أنّ المشاهدات نشأت من فيديوهات حمّلها المستخدمون وتمّت المطالبة بملكيتها، واستخدمها مالك المحتوى للترويج للمحتوى الذي تمّت مشاهدته.
      • ‫END_SCREEN: تشير البيانات إلى المشاهدات التي بدأت من شاشة النهاية في فيديو آخر.

      بالنسبة إلى مصدرَي الزيارات الجديدَين، يمكنك أيضًا استرداد تقرير traffic source detail. في كلتا الحالتَين، يحدّد السمة insightTrafficSourceDetail الفيديو الذي تمّت إحالة المشاهد منه.

    • تتيح السمة adType الآن القيمة auctionBumperInstream، والتي تشير إلى إعلان فيديو غير قابل للتخطّي تصل مدته إلى 6 ثوانٍ ويتم تشغيله قبل أن يتمكّن المستخدم من مشاهدة الفيديو.

  • ‫YouTube Reporting API (التقارير المجمّعة)

    • تتيح السمة traffic_source_type الآن استخدام القيم التالية:
      • ‫19: لا يتوفّر مصدر الزيارات هذا إلا في تقارير مالك المحتوى. ويشير ذلك إلى أنّ المشاهدات نشأت من فيديوهات حمّلها المستخدمون وتمّت المطالبة بملكيتها، واستخدمها مالك المحتوى للترويج للمحتوى الذي تمّت مشاهدته.
      • ‫20: تشير البيانات إلى المشاهدات التي بدأت من شاشة النهاية في فيديو آخر.

      بالنسبة إلى مصدرَي الزيارات الجديدَين، تحدّد السمة traffic_source_detail الفيديو الذي تمّت إحالة المشاهد منه.

    • تم تصحيح قائمة المقاييس الأساسية في واجهة برمجة التطبيقات لإدراج estimated_partner_revenue كمقياس أساسي وإزالة earnings من تلك القائمة. (لم يكن مقياس earnings متاحًا في YouTube Reporting API).

    • تتيح السمة ad_type الآن استخدام القيمة 19 التي تشير إلى إعلانات الملصقات الصغيرة، وهي إعلانات فيديو غير قابلة للتخطّي ولا تزيد مدّتها عن 6 ثوانٍ، ويجب أن يشاهدها المستخدم ليتمكّن من مشاهدة الفيديو.

‫18 يوليو 2016

يتضمّن هذا التحديث التغييرات التالية:

  • ‫YouTube Analytics API (الطلبات المستهدَفة)

    • تم تعديل قوائم المقاييس المتاحة لتقارير القنوات التالية لتشمل مقاييس البطاقات. تمت إضافة دعم مقاييس البطاقات في هذه التقارير في 28 حزيران (يونيو) 2016، ويوضّح إدخال سجلّ النُسخ السابقة لهذا التاريخ التغيير بمزيد من التفصيل. التقارير هي:
      • نشاط المستخدم الأساسي في الولايات الأمريكية
      • نشاط المستخدمين في الولايات الأمريكية لفترات زمنية محدّدة
      • نشاط المستخدمين حسب المقاطعة
      • نشاط المستخدمين حسب حالة الاشتراك
      • نشاط المستخدمين حسب حالة الاشتراك في المقاطعات
      • أهم الفيديوهات حسب الولاية
      • أفضل الفيديوهات للمشاهدين المشتركين أو غير المشتركين

    • تم تصحيح قوائم الفلاتر لكلّ من تقارير الاحتفاظ بالجمهور على مستوى القناة وتقارير الاحتفاظ بالجمهور على مستوى مالك المحتوى للإشارة إلى أنّ فلتر video مطلوب وأنّ فلتر group غير متاح.

      في السابق، كانت مستندات كلا التقريرَين تشير بشكل غير صحيح إلى أنّه يمكن استرداد التقرير باستخدام أحد هذين الفلترَين أو بدونهما.

  • ‫YouTube Reporting API (التقارير المجمّعة)

    • في نظرة عامة على واجهة برمجة التطبيقات، تم تصحيح القسم الذي يشرح كيفية استرداد عنوان URL لتنزيل تقرير، وذلك للإشارة إلى أنّ YouTube ينشئ تقارير قابلة للتنزيل للأيام التي لم تتوفّر فيها أي بيانات. وتحتوي هذه التقارير على صف عنوان ولكنّها لا تحتوي على بيانات إضافية. وقد تم تعديل هذه المعلومات في قسم خصائص التقرير من المستند نفسه في 12 أبريل 2016.
    • تم تصحيح قائمة السمات في تقرير "content_owner_asset_cards_a1" لتعكس أنّ التقرير يستخدم سمة "card_id". في السابق، كانت المستندات تُدرج اسم السمة بشكل غير صحيح على أنّه card_title.

‫28 يونيو 2016

تم تعديل مستندات YouTube Analytics API لتوضيح إتاحة مقاييس البطاقات في العديد من تقارير القنوات ومالكي المحتوى. في ما يلي المقاييس الجديدة المتوافقة:

تتوفّر المقاييس في أنواع التقارير التالية:

‫22 يونيو 2016

يتضمّن هذا التعديل التغييرات التالية على YouTube Reporting API. يتعلّق التغيير الأول بواجهة برمجة التطبيقات بشكل عام، في حين تؤثر التغييرات المتبقية في تقارير مالك المحتوى فقط:

  • تم تعديل قسم خصائص التقارير في نظرة عامة على واجهة برمجة التطبيقات لتوضيح أنّ التقارير متاحة من خلال واجهة برمجة التطبيقات لمدة 180 يومًا من وقت إنشائها.

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

  • تتيح واجهة برمجة التطبيقات إصدارات جديدة من ثلاثة تقارير. يحتوي اثنان من هذه التقارير أيضًا على مقاييس جديدة ومقاييس تمّت إعادة تسميتها:

    • تقرير "content_owner_ad_rates_a1" هو النسخة الجديدة من تقرير "content_owner_ad_performance_a1". التقرير الذي تمت إعادة تسميته حديثًا مطابق للنسخة السابقة.

    • تمت إعادة تسمية تقريرَين يتضمّنان إصدارات جديدة:

      • تمت تسمية الإصدار الجديد من تقرير "content_owner_estimated_earnings_a1" باسم "content_owner_estimated_revenue_a1".
      • تمت تسمية الإصدار الجديد من تقرير "content_owner_asset_estimated_earnings_a1" باسم "content_owner_asset_estimated_revenue_a1".

      يختلف كلا التقريرَين اللذين تمت إعادة تسميتهما عن التقريرَين السابقَين بالطرق التالية:

      • يضيفون مقياس estimated_partner_red_revenue الجديد الذي يقدّر إجمالي الأرباح من اشتراكات YouTube Red.
      • ويضيفون مقياس estimated_partner_transaction_revenue الجديد الذي يقدّر الإيرادات المقدَّرة من المعاملات، مثل المحتوى المدفوع و"التمويل من المعجبين"، مطروحًا منها أي أموال مستردّة من قِبل الشركاء.
      • تتم إعادة تسمية مقياس "estimated_partner_ad_sense_revenue" إلى "estimated_partner_ad_auction_revenue".
      • تتم إعادة تسمية مقياس "estimated_partner_double_click_revenue" إلى "estimated_partner_ad_reserved_revenue".

    يُرجى العِلم أنّه إذا كانت لديك مهام لإنشاء أي من النُسخ القديمة من هذه التقارير، عليك إنشاء مهام جديدة للتقارير التي تمت إعادة تسميتها. بالتزامن مع إصدار نُسخ التقارير الجديدة، تم إيقاف تقارير content_owner_ad_performance_a1 وcontent_owner_estimated_earnings_a1 وcontent_owner_asset_estimated_earnings_a1 نهائيًا.

    إذا كانت لديك مهام لأي من هذه التقارير، لن ينشئ YouTube تقارير جديدة لهذه المهام بعد 22 سبتمبر 2016. ستبقى التقارير التي تم إنشاؤها متاحة لمدة 180 يومًا من وقت إنشائها.

  • تم تعديل تعريف السمة id للمورد reportType ليعكس المجموعة الحالية من التقارير المتاحة.

  • تم تصحيح اسمَي مقياسَين في المستندات ليتطابقا مع الاسمَين الظاهرَين في التقارير. هذا مجرّد إصلاح للمستندات ولا يعكس تغييرًا في محتوى التقرير الفعلي:

    • تم تعديل اسم مقياس "estimated_partner_adsense_revenue" إلى "estimated_partner_ad_sense_revenue". يُرجى العِلم أنّ هذا المقياس يظهر فقط في تقريرَين سيتم إيقافهما نهائيًا مع هذا التعديل. كما هو موضّح أعلاه، تمت إعادة تسمية هذا المقياس ليصبح estimated_partner_ad_auction_revenue في الإصدارات الأحدث من هذه التقارير.
    • تم تعديل اسم مقياس "estimated_partner_doubleclick_revenue" إلى "estimated_partner_double_click_revenue". يُرجى العِلم مرة أخرى أنّ هذا المقياس يظهر فقط في تقريرَين سيتم إيقافهما نهائيًا مع هذا التعديل. كما هو موضّح أعلاه، تمت إعادة تسمية هذا المقياس ليصبح estimated_partner_ad_reserved_revenue في الإصدارات الأحدث من هذه التقارير.

  • تم تعديل مستندات السمات الخاصة بواجهة Reporting API بحيث لم تعُد تتضمّن السمتَين elapsed_video_time_percentage وaudience_retention_type. لا تتوفّر هذه السمات حاليًا في أي تقارير متاحة من خلال واجهة برمجة التطبيقات.

‫19 مايو 2016

يتضمّن هذا التعديل التغييرات التالية على YouTube Reporting API:

  • تتيح واجهة برمجة التطبيقات إصدارًا جديدًا من تقرير نشاط المستخدم لمالكي المحتوى. رقم تعريف نوع التقرير الجديد هو content_owner_basic_a2. على عكس الإصدار السابق من التقرير، content_owner_basic_a1، يتيح الإصدار الجديد استخدام المقياسَين likes وdislikes.

    إذا كانت لديك مهمة لإنشاء تقرير content_owner_basic_a1، سيظل عليك إنشاء مهمة جديدة لتقرير content_owner_basic_a2. لا ينقل YouTube مالكي المحتوى تلقائيًا إلى إصدار التقرير الجديد أو ينشئ مهمة تلقائيًا لإنشاء إصدار التقرير الجديد. في بعض عمليات التنفيذ، قد يؤدي ظهور وظيفة جديدة غير متوقعة إلى حدوث تغيير قد يؤدي إلى عطل.

    بالتزامن مع إصدار التقرير الجديد، تم إيقاف تقرير content_owner_basic_a1 نهائيًا. إذا كانت لديك مهمة لهذا التقرير، لن ينشئ YouTube تقارير جديدة لهذه المهمة بعد 19 أغسطس 2016. ستبقى التقارير التي تم إنشاؤها متاحة لمدة 180 يومًا من وقت إنشائها.

  • تتيح الموارد reportType وjob وreport استخدام سمة جديدة تحدّد ما إذا كان المورد المرتبط يمثّل نوع تقرير متوقف نهائيًا:

    • تحدّد السمة deprecateTime في المورد reportType التاريخ والوقت اللذين سيتم فيهما إيقاف نوع التقرير نهائيًا. لا تتوفّر قيمة لهذه السمة إلا للتقارير التي تم الإعلان عن إيقافها نهائيًا، وتمثّل القيمة التاريخ الذي سيتوقف فيه YouTube عن إنشاء تقارير من هذا النوع.

      بعد الإعلان عن إيقاف نوع تقرير نهائيًا، ينشئ YouTube تقارير من هذا النوع لمدة ثلاثة أشهر أخرى. على سبيل المثال، يعلن هذا التعديل في 19 مايو 2016 عن إيقاف تقرير content_owner_basic_a1 نهائيًا. وبالتالي، يحدّد الحقل deprecateTime لنوع التقرير هذا وقتًا في 19 آب (أغسطس) 2016، سيتوقف YouTube بعده عن إنشاء تقارير من هذا النوع.

    • تحدّد السمة expireTime في المورد job تاريخ ووقت انتهاء صلاحية المهمة. تحتوي هذه السمة على قيمة إذا تم إيقاف نوع التقرير المرتبط بالمهمة نهائيًا أو إذا لم يتم تنزيل التقارير التي تم إنشاؤها للمهمة لفترة زمنية طويلة. يشير التاريخ إلى الوقت الذي يتوقف بعده YouTube عن إنشاء تقارير جديدة للمهمة.

    • تحدّد السمة jobExpireTime في المورد report تاريخ ووقت انتهاء صلاحية المهمة المرتبطة بالتقرير. تحتوي هذه السمة على القيمة نفسها التي تتضمّنها السمة expireTime في المورد job، كما هو موضّح في العنصر السابق في هذه القائمة.

  • تعرض طريقة jobs.create الآن رمز استجابة HTTP‏ 400 (Bad Request) إذا حاولت إنشاء مهمة لتقرير متوقّف نهائيًا. بالإضافة إلى ذلك، تدرج مستندات الطريقة الآن عدة أسباب أخرى تؤدي إلى تعذُّر طلب البيانات من واجهة برمجة التطبيقات.

‫12 أبريل 2016

يتضمّن هذا التعديل التغييرات التالية التي تؤثّر فقط في YouTube Reporting API:

  • ينشئ YouTube الآن بيانات تغطي فترة الـ 180 يومًا السابقة للوقت الذي تمت فيه جدولة مهمة إعداد التقارير لأول مرة. في السابق، لم تكن Reporting API تقدّم أي بيانات سابقة. يؤثر هذا التغيير في جميع الوظائف، بما في ذلك الوظائف التي تم إنشاؤها قبل هذا الإعلان.

    يتم نشر التقارير السابقة فور توفّرها، مع العلم أنّ نشر جميع البيانات السابقة لوظيفة معيّنة يستغرق شهرًا واحدًا تقريبًا. وبالتالي، بعد شهر من جدولة مهمة إعداد تقارير، ستتمكّن من الوصول إلى بيانات تغطي فترة سبعة أشهر تقريبًا. (يجب نشر جميع البيانات السابقة للوظائف التي تم إنشاؤها قبل هذا الإعلان في غضون شهر من تاريخ الإعلان).

    يُرجى العِلم أنّ البيانات السابقة لا تتوفّر إلا اعتبارًا من 1 يوليو 2015. ونتيجةً لذلك، فإنّ الوظائف التي تم إنشاؤها قبل 28 ديسمبر 2015 ستحتوي على بيانات سابقة تقلّ مدتها عن 180 يومًا.

    تم شرح كل هذه التغييرات في قسم البيانات السابقة الجديد في نظرة عامة على Reporting API.

  • تم تعديل قسم خصائص التقرير في نظرة عامة على YouTube Reporting API ليشمل التغييرات التالية:

    • تنصّ المستندات الآن على أنّ التقارير تكون متاحة لمدة 180 يومًا بعد إنشائها، وبالتالي يمكن لعملاء واجهة برمجة التطبيقات تنزيلها. في السابق، كانت المستندات تشير إلى أنّ التقارير كانت متاحة لمدة تصل إلى ستة أشهر قبل تاريخ إرسال طلب البيانات من واجهة برمجة التطبيقات.

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

  • ستتيح واجهة YouTube Reporting API قريبًا مجموعة من التقارير التي يتم إنشاؤها تلقائيًا ويديرها النظام، والتي تحتوي على بيانات إيرادات الإعلانات أو بيانات إيرادات الاشتراكات في YouTube Red. ستتوفّر التقارير لمالكي المحتوى الذين يمكنهم الوصول إلى تقارير الإيرادات القابلة للتنزيل يدويًا في استوديو صنّاع المحتوى في YouTube. وبالتالي، ستوفّر وظائف واجهة برمجة التطبيقات الجديدة إمكانية الوصول الآلي إلى هذه البيانات.

    نعلن الآن عن التغييرات التالية في واجهة برمجة التطبيقات استعدادًا لإطلاق التقارير التي يديرها النظام:

    • تشير السمة الجديدة systemManaged لمورد job إلى ما إذا كان المورد يصف مهمة تنشئ تقارير يديرها النظام. ينشئ YouTube تلقائيًا تقارير يديرها النظام لمالكي المحتوى في YouTube، ولا يمكن لمالكي المحتوى تعديل أو حذف المهام التي تنشئ هذه التقارير.

    • تشير المَعلمة includeSystemManaged الجديدة في طريقة jobs.list إلى ما إذا كان يجب أن يتضمّن ردّ واجهة برمجة التطبيقات مهامًا للتقارير التي يديرها النظام. القيمة التلقائية للمَعلمة هي false.

    • تشير المَعلمة الجديدة startTimeAtOrAfter في طريقة jobs.reports.list إلى أنّ الردّ من واجهة برمجة التطبيقات يجب أن يحتوي على تقارير فقط إذا كانت أقدم البيانات في التقرير تقع في التاريخ المحدّد أو بعده. وبالمثل، تشير المَعلمة startTimeBefore إلى أنّ الردّ من واجهة برمجة التطبيقات يجب أن يحتوي على تقارير فقط إذا كانت أقدم البيانات في التقرير قبل التاريخ المحدّد.

      على عكس المَعلمة createdAfter الخاصة بالطريقة، والتي تتعلّق بوقت إنشاء التقرير، تتعلّق المَعلمات الجديدة بالبيانات في التقرير.

    • تشير السمة الجديدة systemManaged لمورد reportType إلى ما إذا كان المورد يصف تقريرًا يديره النظام.

    • تشير المَعلمة includeSystemManaged الجديدة في طريقة reportTypes.list إلى ما إذا كان يجب أن يتضمّن الردّ من واجهة برمجة التطبيقات تقارير يديرها النظام. القيمة التلقائية للمَعلمة هي false.

‫28 مارس 2016

تعرض الآن واجهتا YouTube Reporting API وYouTube Analytics API إحصاءات المشاهدات لعدة خدمات مشاركة إضافية.

  • في YouTube Reporting API، تتيح السمة sharing_service استخدام القيم الجديدة التالية:
    • ‫82: مربّع حوار نشاط نظام iOS
    • 83: Google Inbox
    • 84: Android Messenger
  • في YouTube Analytics API، تتيح السمة sharingService استخدام القيم الجديدة التالية:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • ‫IOS_SYSTEM_ACTIVITY_DIALOG: مربّع حوار نشاط نظام iOS

‫16 مارس 2016

يتضمّن هذا التعديل التغييرات التالية التي تؤثر في كلّ من YouTube Reporting API وYouTube Analytics API:

YouTube Reporting API

  • تتيح السمة playback_location_type استخدام قيمتَين جديدتَين:
    • ‫7: تشير البيانات إلى المشاهدات التي تمّت على صفحة YouTube الرئيسية أو الشاشة الرئيسية أو في خلاصة اشتراكات المستخدم أو في ميزة تصفّح أخرى في YouTube.
    • 8: تتعلّق البيانات بالمشاهدات التي تمّت مباشرةً على صفحة نتائج بحث YouTube.
  • أصبح بإمكانك الآن استخدام 18 كقيمة لبُعد traffic_source_type. تشير هذه القيمة إلى أنّ مشاهدات الفيديو نشأت من صفحة تعرض كل الفيديوهات في قائمة تشغيل. يختلف هذا المصدر عن نوع المصدر 14 الذي يشير إلى أنّ المشاهدات حدثت أثناء تشغيل الفيديو كجزء من قائمة تشغيل.

YouTube Analytics API

  • تتيح السمة insightPlaybackLocationType استخدام قيمتَين جديدتَين:
    • ‫BROWSE: تشير البيانات إلى المشاهدات التي تمّت على صفحة YouTube الرئيسية أو الشاشة الرئيسية أو في خلاصة اشتراكات المستخدم أو في ميزة تصفّح أخرى في YouTube.
    • SEARCH: تتعلّق البيانات بالمشاهدات التي تمّت مباشرةً على صفحة نتائج بحث YouTube.
  • أصبح بإمكانك الآن استخدام YT_PLAYLIST_PAGE كقيمة لبُعد insightTrafficSourceType. تشير هذه القيمة إلى أنّ مشاهدات الفيديو نشأت من صفحة تعرض كل الفيديوهات في قائمة تشغيل. يختلف هذا المصدر عن نوع المصدر PLAYLIST الذي يشير إلى أنّ المشاهدات حدثت أثناء تشغيل الفيديو كجزء من قائمة تشغيل.

‫8 فبراير 2016

تم تعديل قائمة المقاييس المتوافقة مع YouTube Analytics API بحيث لم تعُد مقاييس البطاقات مُدرَجة كمقاييس متوافقة مع واجهة برمجة التطبيقات هذه. (لم يتم توثيق أي من تقارير واجهة برمجة التطبيقات هذه على أنّها تتيح أيًا من مقاييس البطاقات).

يُرجى العِلم أنّه لا يزال بإمكانك استرداد مقاييس البطاقات باستخدام YouTube Reporting API التي تتيح استخدام هذه المقاييس في العديد من تقارير القنوات ومالكي المحتوى.

‫6 يناير 2016

تحدّد الآن كلّ من واجهة YouTube Reporting API وواجهة YouTube Analytics API المشاهدات التي تتم عبر جهاز Chromecast.

  • في YouTube Reporting API، تستخدم السمة operating_system القيمة 21 لتحديد المشاهدات التي تتم عبر Chromecast.
  • في YouTube Analytics API، تستخدم السمة operatingSystem القيمة CHROMECAST لتحديد المشاهدات التي تتم عبر Chromecast.

‫21 ديسمبر 2015

في المستندات، تم تعديل اسمَي المقياسَين annotation_clickable_impressions وannotation_closable_impressions ليتطابقا مع الاسمَين اللذين يتم عرضهما في التقارير. في السابق، تم توثيق الاسمين على النحو التالي: clickable_annotation_impressions وclosable_annotation_impressions.

‫18 ديسمبر 2015

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

‫15 ديسمبر 2015

يتضمّن هذا التعديل التغييرات التالية التي تؤثر جميعها في YouTube Analytics API:

  • تتيح واجهة YouTube Analytics API الآن استخدام ثلاثة تصنيفات جديدة لتفاصيل التشغيل، ويمكن استخدامها في مجموعة متنوعة من تقارير القنوات ومالكي المحتوى:

    • ‫liveOrOnDemand: تشير هذه السمة إلى ما إذا كانت البيانات في التقرير تصف نشاط المستخدم الذي حدث أثناء بث مباشر.
    • ‫subscribedStatus: تشير هذه السمة إلى ما إذا كانت مقاييس نشاط المستخدم في البيانات مرتبطة بالمشاهدين المشتركين في قناة الفيديو أو قائمة التشغيل.
    • ‫youtubeProduct: تحدّد هذه السمة موقع YouTube الذي حدث فيه نشاط المستخدم. تشمل القيم المحتملة موقع YouTube الإلكتروني الأساسي (أو تطبيق YouTube) وYouTube Gaming وYouTube Kids.

    تم تعديل المستندات لتحديد تقارير تفاصيل التشغيل الجديدة المتاحة للقنوات ومالكي المحتوى. بالإضافة إلى ذلك، تم تعديل العديد من التقارير الأخرى للإشارة إلى أنّه يمكن استخدام سمة واحدة أو أكثر من هذه السمات اختياريًا كسمات و/أو فلاتر في تلك التقارير.

  • تم تغيير تنسيق الجداول التي تشرح التقارير لتسهيل تحديد المجموعات الصالحة من السمات والمقاييس والفلاتر التي يمكن استخدامها لاسترداد كل تقرير. يعرض الجدول التالي التنسيق الجديد، وهو يوضّح تقرير "نوع الجهاز" للقنوات:

    الموقع القيمة
    الأبعاد:
    مطلوب deviceType
    يُرجى استخدام 0 أو أكثر day وliveOrOnDemand وsubscribedStatus وyoutubeProduct
    المقاييس:
    استخدام خيار واحد أو أكثر views وestimatedMinutesWatched
    الفلاتر:
    استخدِم 0 أو 1 country وprovince وcontinent وsubContinent
    استخدِم 0 أو 1 فيديو، مجموعة
    يُرجى استخدام 0 أو أكثر operatingSystem وliveOrOnDemand وsubscribedStatus وyoutubeProduct

    يمكنك الاطّلاع على المصطلحات التي تصف الحقول المطلوبة والاختيارية في مستندات تقارير القناة ومالك المحتوى.

  • تُسقط الآن واجهة YouTube Analytics API تلقائيًا الكيانات التي لا يمكن لمستخدم واجهة برمجة التطبيقات استرداد بياناتها من الفلاتر التي تتيح استخدام قيم متعددة (video وplaylist وchannel). في السابق، كان خادم واجهة برمجة التطبيقات يعرض خطأً إذا لم يتمكّن مستخدم واجهة برمجة التطبيقات من الوصول إلى بيانات عنصر واحد على الأقل من العناصر المحدّدة.

    على سبيل المثال، لنفترض أنّ مستخدمًا أرسل طلب بيانات من واجهة برمجة التطبيقات يتضمّن فلتر video الذي يسرد 20 معرّف فيديو. يملك المستخدم 18 فيديو. ومع ذلك، يحدّد أحد معرّفات الفيديوهات فيديو تملكه قناة أخرى، ويحدّد معرّف آخر فيديو تم حذفه، وبالتالي لم يعُد موجودًا. في هذه الحالة، بدلاً من عرض رسالة خطأ، يتجاهل خادم واجهة برمجة التطبيقات الآن الفيديوَين اللذين لا يمكن للمستخدم الوصول إليهما، ويتضمّن الردّ من واجهة برمجة التطبيقات بيانات عن الفيديوهات الـ 18 التي يملكها مستخدم واجهة برمجة التطبيقات.

  • إذا طلبت بيانات لمجموعة group فارغة في "إحصاءات YouTube"، ستعرض واجهة برمجة التطبيقات الآن مجموعة بيانات فارغة بدلاً من رسالة خطأ.

  • تعرض الآن طريقة groupItems.insert في YouTube Analytics API خطأً يشير إلى عدم توفّر الإذن (رمز استجابة HTTP‏ 403) إذا حاولت إضافة كيان إلى مجموعة ولكن لم يكن لديك إذن بالوصول إلى هذا الكيان. في السابق، كانت واجهة برمجة التطبيقات تسمح لك بإضافة الكيان إلى المجموعة، ولكنّها كانت تعرض لاحقًا خطأً يشير إلى عدم السماح لك بذلك عند محاولة استرداد بيانات التقارير لتلك المجموعة.

  • تتيح الآن طريقة groups.list في YouTube Analytics API تقسيم الصفحات. إذا لم يتضمّن الردّ من واجهة برمجة التطبيقات جميع المجموعات المتاحة، تحدّد المَعلمة nextPageToken في الردّ رمزًا مميزًا يمكن استخدامه لاسترداد الصفحة التالية من النتائج. اضبط مَعلمة pageToken الخاصة بالطريقة على هذه القيمة لاسترداد نتائج إضافية.

‫10 نوفمبر 2015

يتضمّن هذا التحديث التغييرات التالية:

‫29 أكتوبر 2015

يتضمّن هذا التحديث التغييرات التالية:

  • تم تصحيح مستندات السمة date في YouTube Reporting API لتعكس أنّ التواريخ تشير إلى فترة الـ 24 ساعة التي تبدأ عند الساعة 12:00 صباحًا بتوقيت المحيط الهادئ (UTC-8). في السابق، كانت المستندات تشير إلى أنّ التاريخ يبدأ في الساعة 12:00 صباحًا (بتوقيت غرينتش).

    بالإضافة إلى ذلك، تم تعديل مستندات YouTube Analytics API للإشارة إلى أنّ جميع السمات المرتبطة بالتاريخ (day و7DayTotals و30DayTotals وmonth) تشير إلى التواريخ التي تبدأ في الساعة 12:00 صباحًا بتوقيت المحيط الهادئ (UTC-8).

  • أصبحت طريقة jobs.reports.list() في YouTube Reporting API تتيح الآن استخدام مَعلمة طلب البحث createdAfter. في حال تحديد هذه المَعلمة، تشير إلى أنّ الردّ من واجهة برمجة التطبيقات يجب أن يعرض فقط التقارير التي تم إنشاؤها بعد التاريخ والوقت المحدّدَين، بما في ذلك التقارير الجديدة التي تتضمّن بيانات تم ملؤها تلقائيًا. يُرجى العِلم أنّ قيمة المَعلمة تتعلّق بوقت إنشاء التقرير وليس بالتواريخ المرتبطة بالبيانات المعروضة.

    قيمة المَعلمة هي طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة تصل إلى الميكرو ثانية. مثال: "2015-10-02T15:01:23.045678Z"

    تم أيضًا تعديل أفضل الممارسات في YouTube Reporting API لشرح كيفية استخدام المَعلمة createdAfter لتجنُّب معالجة التقرير نفسه بشكل متكرّر.

  • تم تصحيح تعريفات السمة createTime للمورد job والسمات startTime وendTime وcreateTime للمورد report للإشارة إلى أنّ قيم السمات دقيقة بالميكروثانية وليس بالنانوثانية. بالإضافة إلى ذلك، تعكس جميع التعريفات الآن بدقة أنّ قيمة السمة هي طابع زمني.

‫8 أكتوبر 2015

يتضمّن هذا التحديث التغييرات التالية:

  • تم تعديل مستندات السمة sharingService في YouTube Analytics API لتشمل قائمة بالقيم المحتملة للسمة. تتضمّن القائمة عددًا من الخدمات الجديدة المتوافقة.

    تم أيضًا تعديل تعريف السمة sharing_service في YouTube Reporting API لإدراج القيم الجديدة المسموح بها. قيم التعداد التي تزيد عن 59 هي القيم الجديدة في القائمة.

‫24 سبتمبر 2015

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح واجهة YouTube Reporting API الجديدة استرداد تقارير البيانات المجمّعة التي تتضمّن بيانات "إحصاءات YouTube" لقناة أو مالك محتوى. وهو مصمَّم للتطبيقات التي يمكنها استيراد مجموعات بيانات كبيرة وتوفير أدوات لفلترة هذه البيانات وترتيبها واستخراجها.

    يحتوي كل تقرير في YouTube Reporting API على مجموعة محدّدة مسبقًا من السمات والمقاييس. (تستخدم تقارير YouTube Analytics API أيضًا المقاييس والسمات). في أي تقرير، يحتوي كل صف من البيانات على مجموعة فريدة من قيم السمات. يمكنك تجميع البيانات في الصفوف استنادًا إلى قيم السمات لاحتساب المقاييس لكل من الفيديوهات الفردية والبلدان والفيديوهات المباشرة والمستخدمين المشتركين وما إلى ذلك.

    يمكنك استخدام واجهة برمجة التطبيقات لجدولة مهام إعداد التقارير، حيث تحدّد كل مهمة تقريرًا يجب أن ينشئه YouTube. بعد إعداد مهمة، ينشئ YouTube تقريرًا يوميًا يمكن تنزيله بشكل غير متزامن. يحتوي كل تقرير على بيانات لفترة فريدة مدتها 24 ساعة.

  • على الرغم من أنّ YouTube Analytics API وYouTube Reporting API هما واجهتا برمجة تطبيقات مختلفتان، تتيح كلتاهما للمطوّرين استرداد بيانات "إحصاءات YouTube". بما أنّ واجهتَي برمجة التطبيقات تتيحان الوصول إلى مجموعات بيانات متشابهة، يتم نشر مستندات واجهتَي برمجة التطبيقات كمجموعة واحدة من المستندات.

    • تحتوي علامة التبويب الأدلة في مجموعة المستندات على معلومات مشتركة بين واجهتَي برمجة التطبيقات، بما في ذلك تعليمات تفويض طلبات البيانات من واجهة برمجة التطبيقات.
    • تحتوي علامة التبويب التقارير المجمّعة على مستندات مرجعية ومحتوى آخر مخصّص لواجهة YouTube Reporting API.
    • تحتوي علامة التبويب الطلبات المستهدفة على مستندات مرجعية ومحتوى آخر مخصّص لواجهة YouTube Analytics API.
    • تعرض علامة التبويب عيّنات عيّنات التعليمات البرمجية المتاحة لكلّ من واجهتَي برمجة التطبيقات.
    • تعرض علامة التبويب الأدوات مراجع إضافية متاحة لمساعدة المطوّرين في تنفيذ أي من واجهتَي برمجة التطبيقات.

‫20 أغسطس 2015

يتضمّن هذا التحديث التغييرات التالية:

  • تمت إعادة هيكلة مستندات واجهة برمجة التطبيقات لتسهيل فهمها. وبالتالي، لا تصف هذه التغييرات ميزات جديدة:

    • تتضمّن المستندات الآن صفحة واحدة تعرض جميع تقارير القنوات المتاحة وصفحة أخرى تعرض جميع تقارير مالكي المحتوى المتاحة. في السابق، كانت المستندات تتضمّن صفحات منفصلة لتقارير فيديوهات القناة وتقارير قوائم التشغيل في القناة وما إلى ذلك.

    • تهدف نظرة عامة على نموذج البيانات الجديدة إلى تقديم مقدّمة أوضح حول آلية عمل واجهة برمجة التطبيقات. على وجه التحديد، يحاول هذا المستند شرح كيفية استخدام YouTube للمقاييس والسمات والفلاتر لحساب قيم التقارير.

    • تم توثيق طريقة reports.query في واجهة برمجة التطبيقات، والتي تستخدمها لاسترداد التقارير، بشكل منفصل. وكانت المعلومات الواردة في تلك الصفحة قد ظهرت سابقًا في بعض الصفحات الأخرى. تم تصميم الصفحة الجديدة لمساعدتك في تحديد المعلومات التي تحتاج إلى إرسالها لاسترداد تقرير بسهولة أكبر.

‫22 يوليو 2015

يتضمّن هذا التعديل عدة تغييرات تنطبق جميعها على مالكي المحتوى فقط:

  • يتضمّن مقياس "adEarnings" الجديد إجمالي الأرباح المقدَّرة (صافي الإيرادات) من جميع مصادر الإعلانات التي باعتها Google. وهو ليس مقياسًا أساسيًا. تتيح واجهة برمجة التطبيقات استخدام مقياس adEarnings لأي تقرير كان يتيح استخدام مقياس earnings.

    بالإضافة إلى ذلك، تم تصحيح تعريف مقياس "earnings" ليعكس حقيقة أنّ قيمته تشمل إجمالي الأرباح المقدَّرة من جميع مصادر الإعلانات التي تبيعها Google ومن المصادر غير الإعلانية. في السابق، كان التعريف يشير بشكل غير صحيح إلى أنّ المقياس يتضمّن فقط الأرباح من مصادر الإعلانات.

  • تم إيقاف مقياس primaryAdGrossRevenue نهائيًا. بدلاً من ذلك، استخدِم المقياس grossRevenue لاسترداد بيانات الإيرادات.

  • بالإضافة إلى مقياس primaryAdGrossRevenue الذي تم إيقافه نهائيًا، لم تعُد تقارير أداء الإعلانات تتيح استخدام مقياسَي monetizedPlaybacks وplaybackBasedCpm. ومع ذلك، لا تزال العديد من تقارير الفيديو تتيح استخدام هذه المقاييس.

‫1 يونيو 2015

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح واجهة برمجة التطبيقات الآن مقياسَين جديدَين لتقارير الفيديو، وهما videosAddedToPlaylists وvideosRemovedFromPlaylists. تم تعديل قوائم تقارير الفيديوهات لكلّ من القنوات ومالكي المحتوى لتحديد التقارير التي تتيح استخدام المقاييس الجديدة.

    • ‫videosAddedToPlaylists: عدد المرات التي تمت فيها إضافة الفيديوهات ضمن نطاق طلب البحث إلى أي قوائم تشغيل على YouTube قد تكون الفيديوهات قد أُضيفت إلى قائمة تشغيل مالك الفيديو أو إلى قوائم تشغيل قنوات أخرى.
    • ‫videosRemovedFromPlaylists: عدد المرات التي تمت فيها إزالة الفيديوهات ضمن نطاق طلب البحث من أي قوائم تشغيل على YouTube من المحتمل أنّه تمّت إزالة الفيديوهات من قائمة تشغيل مالك الفيديو أو من قوائم تشغيل قنوات أخرى.

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

    تتوفّر بيانات هذه المقاييس اعتبارًا من 1 أكتوبر 2014.

‫31 مارس 2015

يتضمّن هذا التحديث التغييرات التالية:

  • تم إيقاف مقياسَي favoritesAdded وfavoritesRemoved نهائيًا اعتبارًا من تاريخ هذا الإعلان. كلاهما من المقاييس الأساسية ويخضعان لسياسة الإيقاف النهائي المنصوص عليها في بنود الخدمة.

‫16 مارس 2015

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح لك المَعلمة الجديدة currency استرداد مقاييس الأرباح بعملة غير الدولار الأمريكي (USD). إذا تم ضبط المَعلمة، ستحوّل واجهة برمجة التطبيقات قيم المقاييس earnings وgrossRevenue وplaybackBasedCpm وimpressionBasedCpm إلى العملة المحدّدة. والقيم التي يتم عرضها هي تقديرات يتم احتسابها باستخدام أسعار الصرف التي تتغيّر يوميًا.

    قيمة المَعلمة هي رمز عملة مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217. تكون القيمة التلقائية USD. يحتوي تعريف المَعلمة على قائمة برموز العملات المتوافقة.

‫25 فبراير 2015

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح واجهة برمجة التطبيقات الآن إنشاء مجموعات "إحصاءات YouTube" وإدارتها، بالإضافة إلى إمكانية استرداد بيانات التقارير لهذه المجموعات.

    • إنشاء المجموعات وإدارتها

      يقدّم هذا التحديث الموردَين group وgroupItem لإنشاء المجموعات وإدارتها.

      • يمثّل المورد group مجموعة في "إحصاءات YouTube"، وهي مجموعة مخصّصة تضمّ ما يصل إلى 200 قناة أو فيديو أو قائمة تشغيل أو مادة عرض. تتيح واجهة برمجة التطبيقات استخدام الطرق list وinsert وupdate وdelete لهذا المرجع.
      • يمثّل المورد groupItem عنصرًا في مجموعة "إحصاءات YouTube". تتيح واجهة برمجة التطبيقات استخدام الطُرق list وinsert وdelete لهذا المرجع.

      على سبيل المثال، يمكنك إنشاء مجموعة باستخدام طريقة groups.insert ثم إضافة عناصر إلى تلك المجموعة باستخدام طريقة groupItems.insert.

    • استرداد بيانات التقارير لمجموعة

      تم تعديل مستندات السمات لتشمل السمة group التي يمكن استخدامها كفلتر للعديد من تقارير القنوات وتقارير مالكي المحتوى. عند استخدام فلتر group، تعرض واجهة برمجة التطبيقات بيانات لجميع العناصر في تلك المجموعة. يُرجى العِلم أنّ واجهة برمجة التطبيقات لا تتيح حاليًا إنشاء تقارير لمجموعات مواد العرض.

    يمكنك الاطّلاع على مركز مساعدة YouTube لمزيد من المعلومات حول مجموعات "إحصاءات YouTube".

‫13 فبراير 2015

يتضمّن هذا التحديث التغييرات التالية:

  • لم تعُد واجهة برمجة التطبيقات تتيح استخدام السمة show.

‫28 أغسطس 2014

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح واجهة برمجة التطبيقات الآن تحديد قيم متعددة للسمات video وplaylist وchannel وshow عند استخدام هذه السمات كفلاتر. لتحديد قيم متعددة، اضبط قيمة المَعلمة filters على قائمة قيم مفصولة بفاصلة لمعرّفات الفيديوهات أو قوائم التشغيل أو القنوات أو البرامج التي يجب فلترة ردّ من واجهة برمجة التطبيقات لها. يمكن أن تحدّد قيمة المَعلمة ما يصل إلى 200 معرّف.

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

    يُرجى الاطّلاع على تعريف المَعلمة filters للحصول على تفاصيل كاملة حول هذه الوظيفة.

‫16 يوليو 2014

يتضمّن هذا التحديث التغييرات التالية:

  • عند استرداد تقرير قناة، يمكنك الآن استرداد بيانات قناة المستخدم الذي تمت مصادقته من خلال ضبط قيمة المَعلمة ids على channel==MINE. (يمكنك أيضًا ضبط المَعلمة ids على channel==CHANNEL_ID لاسترداد البيانات للقناة المحدّدة).

  • تتيح واجهة برمجة التطبيقات الآن استخدام تقارير قوائم التشغيل التي تحتوي على إحصاءات مرتبطة بمشاهدات الفيديوهات التي تحدث في سياق قائمة تشغيل. تتوفّر تقارير قوائم التشغيل للقنوات ومالكي المحتوى.

    تتيح جميع تقارير قوائم التشغيل استخدام المقياسَين views وestimatedMinutesWatched، ويتيح بعضها أيضًا استخدام المقياس averageViewDuration.

    بالإضافة إلى ذلك، تتيح جميع تقارير قوائم التشغيل المقاييس الجديدة التالية. يُرجى العِلم أنّ كل مقياس من هذه المقاييس يعكس فقط مشاهدات قوائم التشغيل التي حدثت على الويب.

    • ‫playlistStarts: عدد المرات التي بدأ فيها المشاهدون تشغيل قائمة تشغيل
    • ‫viewsPerPlaylistStart: متوسط عدد مرات مشاهدة الفيديو التي حدثت في كل مرة تم فيها بدء قائمة تشغيل
    • ‫averageTimeInPlaylist: متوسط الوقت المقدَّر بالدقائق الذي قضاه المستخدم في مشاهدة الفيديوهات في قائمة تشغيل بعد بدء تشغيلها

    يجب أن يستخدم أي طلب لاسترداد تقرير قائمة تشغيل الفلتر isCurated الذي يجب ضبطه على 1 (isCurated==1).

  • تتيح واجهة برمجة التطبيقات الآن تقرير الاحتفاظ بالجمهور. يقيس هذا التقرير قدرة الفيديو على الاحتفاظ بجمهوره. تقيس السمة الجديدة elapsedVideoTimeRatio في التقرير مقدار الفيديو الذي انقضى لقيم المقاييس المقابلة:

    • يحدّد مقياس "audienceWatchRatio" النسبة المطلقة للمستخدمين الذين يشاهدون الفيديو عند نقطة معيّنة. يتم احتساب النسبة من خلال مقارنة عدد مرات مشاهدة جزء من الفيديو بإجمالي عدد مشاهدات الفيديو.

      يُرجى العِلم أنّه يمكن مشاهدة جزء من الفيديو أكثر من مرّة (أو عدم مشاهدته على الإطلاق) في مشاهدة فيديو معيّنة. على سبيل المثال، إذا أرجع المستخدمون الفيديو إلى الخلف وشاهدوا الجزء نفسه عدة مرات، قد تكون النسبة المطلقة لهذا الجزء من الفيديو أكبر من 1.

    • يعرض مقياس relativeRetentionPerformance مدى نجاح الفيديو في الاحتفاظ بالمشاهدين أثناء عمليات التشغيل مقارنةً بجميع فيديوهات على YouTube ذات المدة نفسها. تشير القيمة 0 إلى أنّ الفيديو يحتفظ بالمشاهدين بشكل أسوأ من أي فيديو آخر ذي مدة مماثلة، بينما تشير القيمة 1 إلى أنّ الفيديو يحتفظ بالمشاهدين بشكل أفضل من أي فيديو آخر ذي مدة مماثلة. تشير القيمة المتوسطة 0.5 إلى أنّ نصف الفيديوهات ذات المدة المماثلة تحتفظ بالمشاهدين بشكل أفضل، بينما تحتفظ النصف الآخر بالمشاهدين بشكل أسوأ.

    يمكنك أيضًا استخدام الفلتر audienceType لكي يعرض التقرير فقط البيانات المرتبطة بالمشاهدات المجانية أو المشاهدات من "إعلانات TrueView أثناء عرض الفيديو" أو المشاهدات من "إعلانات TrueView ضمن العرض". (المشاهدات المجانية هي النتيجة المباشرة لإجراء يتّخذه المستخدم، مثل البحث عن فيديو أو النقر على فيديو مقترَح).

  • تتيح واجهة برمجة التطبيقات استخدام عدة مقاييس جديدة مرتبطة بالتعليقات التوضيحية. يمكن استرداد المقاييس المدرَجة أدناه من خلال أي تقارير كانت تتيح استخدام مقياسَي annotationClickThroughRate وannotationCloseRate.

    • ‫annotationImpressions: إجمالي عدد مرّات ظهور التعليقات التوضيحية
    • ‫annotationClickableImpressions: عدد التعليقات التوضيحية التي ظهرت وكان من الممكن النقر عليها
    • ‫annotationClosableImpressions: عدد التعليقات التوضيحية التي ظهرت ويمكن إغلاقها
    • annotationClicks: إجمالي عدد التعليقات التوضيحية التي تم النقر عليها
    • ‫annotationCloses: إجمالي عدد التعليقات التوضيحية المغلقة

    جميع المقاييس الجديدة هي مقاييس أساسية وتخضع لسياسة الإيقاف النهائي. ومع ذلك، تجدر الإشارة إلى أنّ البيانات متاحة للمقاييس الجديدة اعتبارًا من 16 يوليو 2013. (تتوفّر بيانات مقياسَي annotationClickThroughRate وannotationCloseRate اعتبارًا من 10 يونيو 2012).

  • لم يعُد يتم تسجيل GOOGLE_SEARCH كقيمة منفصلة لسمة insightTrafficSourceType. بدلاً من ذلك، يتم الآن تحديد مصدر الإحالات من نتائج البحث من Google على أنّه EXT_URL. نتيجةً لذلك، لم يعُد من الممكن أيضًا استرداد تقرير insightTrafficSourceDetail يضبط فلتر insightTrafficSourceType على GOOGLE_SEARCH.

‫31 يناير 2014

يتضمّن هذا التحديث التغييرات التالية:

‫16 يناير 2014

يتضمّن هذا التحديث التغييرات التالية:

  • تمت إعادة تصميم مستند نماذج الطلبات لتجميع الأمثلة في فئات، باستخدام تنسيق علامات التبويب المشابه للتنسيق الذي تم إصداره مؤخرًا لتقارير القنوات ومالكي المحتوى. في التصميم الجديد، يتم تجميع الأمثلة في الفئات التالية:

    • الإحصاءات الأساسية
    • مستندة إلى الوقت
    • جغرافي
    • موقع التشغيل
    • مصدر الزيارات
    • الجهاز/نظام التشغيل
    • الخصائص الديموغرافية
    • الشبكات الاجتماعية
    • الأرباح/الإعلانات (لتقارير مالك المحتوى فقط)

  • يتضمّن مستند نماذج الطلبات الآن أمثلة جديدة لاسترداد البيانات الخاصة بالمقاطعات في تقارير القنوات أو تقارير مالكي المحتوى.

    • المقاييس الخاصة بالمقاطعات في الولايات الأمريكية وواشنطن العاصمة: يستردّ هذا التقرير تفاصيل عدد المشاهدات والإحصاءات الأخرى لفيديوهات القناة حسب المقاطعة. تغطي البيانات الولايات الأمريكية وواشنطن العاصمة. يستخدم المثال السمة province، ويستخدم أيضًا المَعلمة filters لحصر الاستجابة على النتائج الخاصة بالولايات المتحدة فقط.

    • الخصائص الديمغرافية للمشاهدين في كاليفورنيا (الفئة العمرية والجنس): يستردّ هذا التقرير إحصاءات حول الفئة العمرية والجنس للمشاهدين في كاليفورنيا الذين شاهدوا فيديوهات قناة معيّنة أو محتوى طالب مالك المحتوى بملكيته (بالنسبة إلى تقارير مالك المحتوى). يستخدم هذا المثال المَعلمة filters لضمان أن تتضمّن الاستجابة بيانات لمقاطعة معيّنة فقط.

  • تم تعديل تعريف السمة province للإشارة إلى أنّه عند تضمين province في قيمة المَعلمة dimensions، يجب أن يحصر الطلب أيضًا البيانات في الولايات المتحدة من خلال تضمين country==US في قيمة المَعلمة filters.

‫6 يناير 2014

يتضمّن هذا التحديث التغييرات التالية:

  • تمت إعادة تصميم المستندات التي تعرض تقارير القنوات ومالكي المحتوى المتوافقة. بدلاً من تقديم جدول يسرد جميع التقارير المحتملة، يجمع كل مستند التقارير في فئات:

    • الإحصاءات الأساسية
    • مستندة إلى الوقت
    • جغرافي
    • موقع التشغيل
    • مصدر الزيارات
    • الجهاز/نظام التشغيل
    • الخصائص الديموغرافية
    • الشبكات الاجتماعية
    • الفيديوهات الأفضل أداءً

    يعرض كل مستند هذه الفئات كقائمة من علامات التبويب، ويمكنك النقر على أي علامة تبويب للاطّلاع على التقارير المتوافقة في تلك الفئة.

  • تتيح واجهة برمجة التطبيقات الآن استخدام ثلاثة سمات جغرافية جديدة: province وcontinent وsubContinent.

    • تتيح لك السمة province استرداد الإحصاءات للولايات الأمريكية ومقاطعة كولومبيا. تتيح واجهة برمجة التطبيقات استخدامَين لهذه السمة:

      • تتيح واجهة برمجة التطبيقات تقريرَين يقسّمان الإحصاءات حسب الولاية. يتوفّر كلا التقريرَين للقنوات ومالكي المحتوى.

        • يوفّر تقرير الإحصاءات الأساسية عدة إحصاءات، بما في ذلك عدد المشاهدات والدقائق المقدَّرة التي تمت مشاهدتها.
        • يوفّر التقرير المستند إلى الوقت الإحصاءات نفسها، ولكنّه يجمع البيانات على أساس يومي أو كل 7 أيام أو كل 30 يومًا أو على أساس شهري.

      • يمكنك استخدام مَعلمة طلب البحث filters لحصر التقرير على الإحصاءات الخاصة بولاية معيّنة فقط. تتيح عدة تقارير هذا النوع من الفلترة، بما في ذلك التقارير الجغرافية وتقارير مواقع التشغيل وتقارير مصادر الزيارات وتقارير الأجهزة وتقارير أنظمة التشغيل وتقارير الخصائص الديمغرافية وتقارير الفيديوهات الأفضل أداءً.

    • تحدّد سمة continent رمز منطقة إحصائية تابعًا للأمم المتحدة (UN) يحدّد قارة معيّنة. لا يمكن استخدام هذه السمة إلا كـ فلتر.

    • تحدّد السمة subContinent رمز منطقة إحصائية تابعًا للأمم المتحدة (UN) يعرّف منطقة فرعية في قارة معيّنة. لا يمكن أيضًا استخدام هذه السمة إلا كفلتر.

      بما أنّ كل منطقة فرعية مرتبطة بقارة واحدة فقط، ليس من الضروري استخدام فلتر continent أيضًا عند استخدام فلتر subContinent. (في الواقع، ستعرض واجهة برمجة التطبيقات خطأً إذا استخدم الطلب السمتَين معًا).

  • تم تصحيح المستندات بحيث لا تتضمّن السمة insightTrafficSourceDetail القيمة insightTrafficSourceType PROMOTED كقيمة فلتر صالحة.

‫30 سبتمبر 2013

يتضمّن هذا التحديث التغييرات التالية:

  • تخضع YouTube Analytics API الآن لسياسة الإيقاف النهائي الموضّحة في بنود الخدمة. ومع ذلك، لا تخضع السمات والمقاييس غير الأساسية لواجهة برمجة التطبيقات لسياسة الإيقاف النهائي. تم تعديل صفحتَي السمات والمقاييس لإدراج السمات والمقاييس الأساسية. بالإضافة إلى ذلك، تم تعديل التعريفات في تلك الصفحات لتحديد السمات والمقاييس الأساسية بشكل صريح.

  • تتيح واجهة برمجة التطبيقات الآن استخدام EXTERNAL_APP كقيمة للسمة insightPlaybackLocationType. بالتزامن مع هذا التعديل، اعتبارًا من 10 سبتمبر 2013، لم تعد عمليات التشغيل تُصنَّف على أنّها عمليات تشغيل على MOBILE، مع أنّ عمليات التشغيل على الأجهزة الجوّالة التي حدثت قبل ذلك التاريخ ستظل مصنَّفة بهذه القيمة.

    مع هذا التعديل، يتم الآن تصنيف عمليات التشغيل على الأجهزة الجوّالة على أنّها عمليات تشغيل على WATCH أو EMBEDDED أو EXTERNAL_APP، وذلك حسب نوع التطبيق الذي تتم فيه عمليات التشغيل.

  • تتيح واجهة برمجة التطبيقات الآن استخدام PLAYLIST كقيمة للسمة insightTrafficSourceType. تشير القيمة إلى أنّ مشاهدات الفيديو تمّت من خلال قائمة تشغيل. في السابق، كان يتم تصنيف هذه المشاهدات باستخدام فئة YT_OTHER_PAGE الخاصة بالسمة.

‫16 يوليو 2013

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح واجهة برمجة التطبيقات الآن إمكانية ترتيب التقارير حسب سمات ومقاييس متعددة. يحتوي مستند نماذج الطلبات على مثال جديد، وهو ترتيب الطلبات حسب سمات/مقاييس متعددة، يوضّح هذه الوظيفة. يستردّ الطلب بيانات مصدر الزيارات، وتكون قيمة المَعلمة sort فيه هي day,-views. يتم ترتيب النتائج زمنيًا، ولكن ضمن مجموعة النتائج لكل يوم، يحتوي الصف الأول على بيانات مصدر الزيارات الذي حقّق أكبر عدد من المشاهدات، ويحتوي الصف الثاني على بيانات المصدر الذي حقّق ثاني أكبر عدد من المشاهدات، وهكذا.

  • تتيح واجهة برمجة التطبيقات الآن استخدام سمتَين جديدتَين، وهما deviceType وoperatingSystem، ويمكن استخدامهما لاسترداد بيانات حول الأجهزة التي يشاهد عليها المستخدمون فيديوهاتك. تتيح واجهة برمجة التطبيقات التقارير التي تستخدم إحدى السمتَين أو كلتيهما.

    • يتيح لك تقرير deviceType استرداد عدد المشاهدات ووقت المشاهدة المقدَّر لأنواع مختلفة من الأجهزة، بما في ذلك أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة والأجهزة اللوحية. يمكنك أيضًا استخدام فلتر operatingSystem لحصر تقرير نوع الجهاز على الإحصاءات الخاصة بالأجهزة التي تعمل بنظام تشغيل معيّن، مثل Android أو iOS.

    • يتيح لك تقرير operatingSystem استرداد عدد المشاهدات ووقت المشاهدة المقدَّر لأنظمة تشغيل مختلفة، مثل Android وiOS وLinux والمزيد. يمكنك أيضًا استخدام فلتر deviceType لحصر تقرير نظام التشغيل على الإحصاءات الخاصة بنوع معيّن من الأجهزة، مثل الأجهزة الجوّالة أو الأجهزة اللوحية.

    تتوفّر التقارير الجديدة حول أنواع الأجهزة وأنظمة التشغيل للقنوات ولمالكي المحتوى.

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

  • قد تعرض السمة insightPlaybackLocationType القيمة YT_OTHER التي تحدّد المشاهدات غير المصنّفة باستخدام إحدى القيم الأخرى للسمة.

‫23 مايو 2013

يتضمّن هذا التحديث التغييرات التالية:

‫10 مايو 2013

يتضمّن هذا التحديث التغييرات التالية:

‫6 مايو 2013

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح واجهة برمجة التطبيقات الآن إمكانية استرداد مقاييس وقت المشاهدة (estimatedMinutesWatched وaverageViewDuration وaverageViewPercentage) بالإضافة إلى مقاييس أخرى، بما في ذلك مقاييس المشاهدة ومقاييس التفاعل ومقاييس الأرباح ومقاييس أداء الإعلانات.

    وتم تعديل قوائم تقارير القنوات وتقارير مالكي المحتوى المتاحة لتعكس هذا التغيير. (أصبحت القوائم أقصر الآن لأنّه يمكن استرداد مقاييس وقت المشاهدة كجزء من التقارير الأخرى المدرَجة).

    تم أيضًا تعديل مستند نموذج طلبات البيانات من واجهة برمجة التطبيقات.

  • تم تحسين التقارير التي تستخدم السمتَين insightPlaybackLocationDetail وinsightTrafficSourceDetail بالطرق التالية:

    • وتتيح الآن استخدام فلتر country اختياري.

    • يمكن لمالكي المحتوى الآن استرداد هذه التقارير باستخدام أي من مجموعات filter الجديدة التالية. يُرجى العِلم أنّ كل هذه المجموعات تتيح أيضًا استخدام فلتر country الاختياري.

      • تفاصيل موقع التشغيل

        • channel,insightPlaybackLocationType==EMBEDDED
        • show,insightPlaybackLocationType==EMBEDDED
        • claimedStatus,insightPlaybackLocationType==EMBEDDED
        • uploaderType,insightPlaybackLocationType==EMBEDDED
        • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

      • تفاصيل مصدر الزيارات

        • channel,insightTrafficSourceType
        • show,insightTrafficSourceType
        • claimedStatus,insightTrafficSourceType
        • uploaderType,insightTrafficSourceType
        • uploaderType,claimedStatus,insightTrafficSourceType

‫3 مايو 2013

يتضمّن هذا التحديث التغييرات التالية:

  • يقدّم مستند نموذج طلبات البيانات من واجهة برمجة التطبيقات الجديد أمثلة توضّح كيفية استرداد العديد من أنواع التقارير المختلفة باستخدام YouTube Analytics API. يتضمّن كل مثال وصفًا موجزًا للتقرير الذي يسترجعه الطلب، ثم يعرض السمات والمقاييس والفلاتر ومَعلمات الترتيب للطلب.

  • يتيح الآن سمة insightTrafficSourceType استخدام SUBSCRIBER كقيمة صالحة. تحدّد هذه القيمة مشاهدات الفيديو التي تمّت إحالتها من الخلاصات على صفحة YouTube الرئيسية أو من ميزات الاشتراك في YouTube. إذا فلترت البيانات استنادًا إلى مصدر الزيارات هذا، سيحدّد الحقل insightTrafficSourceDetail خلاصة الصفحة الرئيسية أو صفحة أخرى تمّت إحالة المشاهدات منها.

‫28 مارس 2013

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح واجهة برمجة التطبيقات الآن استخدام مقياسَين جديدَين، هما annotationClickThroughRate وannotationCloseRate، وهما مرتبطان بتفاعلات المشاهدين مع التعليقات التوضيحية التي تظهر أثناء تشغيل فيديوهاتك. تم تعديل قوائم تقارير القنوات وتقارير مالكي المحتوى لتحديد التقارير التي تتيح استخدام المقاييس الجديدة.

    • annotationClickThroughRate – نسبة التعليقات التوضيحية التي نقر عليها المشاهدون إلى إجمالي عدد مرات ظهور التعليقات التوضيحية القابلة للنقر.
    • annotationCloseRate: نسبة التعليقات التوضيحية التي أغلقها المشاهدون إلى إجمالي عدد مرات ظهور التعليقات التوضيحية

‫21 مارس 2013

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح واجهة برمجة التطبيقات الآن مقاييس الأرباح وأداء الإعلانات، بالإضافة إلى تقارير جديدة عن أداء الإعلانات. تتوفّر المقاييس والتقارير حصريًا لشركاء المحتوى في YouTube المشاركين في برنامج شركاء YouTube.

    • تتيح التقارير الجديدة استخدام مقاييس أداء الإعلانات المستندة إلى التشغيل ومقاييس أداء الإعلانات المستندة إلى مرّات الظهور. يمكنك الاطّلاع على مستندات تقارير مالك المحتوى لمزيد من المعلومات حول تقارير أداء الإعلانات.

    • في ما يلي المقاييس الجديدة المتوافقة. تم تعديل قائمة تقارير مالك المحتوى لتحديد التقارير التي تتيح استخدام هذه المقاييس، بما في ذلك التقريران الجديدان.

      • ‫earnings: إجمالي الأرباح المقدَّرة من جميع مصادر الإعلانات التي تبيعها Google
      • ‫grossRevenue: إجمالي الإيرادات المقدَّرة من شركاء Google أو DoubleClick
      • ‫primaryAdGrossRevenue: إجمالي الإيرادات المقدّرة، مجمّعة ومصنّفة ضمن نوع الإعلان الأساسي لعمليات تشغيل الفيديوهات التي يغطيها التقرير، من شركاء Google أو DoubleClick
      • monetizedPlaybacks: عدد عمليات التشغيل التي ظهر فيها مرة ظهور للإعلان على الأقل.
      • ‫playbackBasedCpm: إجمالي الإيرادات المقدَّرة لكل ألف عملية تشغيل
      • ‫impressions: عدد مرّات ظهور الإعلان التي تم التحقّق منها
      • ‫impressionBasedCpm: إجمالي الإيرادات المقدَّرة لكل ألف ظهور للإعلان

      ملاحظة: يُرجى الاطّلاع على تعريفات المقاييس للحصول على التفاصيل الكاملة.

    • يجب أن يرسل أي طلب يستردّ الأرباح أو مقاييس أداء الإعلانات رمز تفويض مميزًا يمنح إذن الوصول باستخدام نطاق https://www.googleapis.com/auth/yt-analytics-monetary.readonly الجديد.

  • تمت إعادة تنظيم مستندات واجهة برمجة التطبيقات بحيث يتم شرح أنواع مختلفة من التقارير في صفحات منفصلة. لذلك، تتوفّر الآن صفحات منفصلة تشرح الأنواع المختلفة من تقارير القنوات وتقارير مالكي المحتوى.

‫4 فبراير 2013

يتضمّن هذا التحديث التغييرات التالية:

  • يتضمّن الدليل المرجعي لواجهة برمجة التطبيقات الآن قسم أمثلة، والذي يتضمّن عينات تعليمات برمجية توضّح كيفية طلب البيانات من واجهة برمجة التطبيقات باستخدام مكتبات برامج Java وJavaScript وPython وRuby. نموذج رمز JavaScript هو نفسه الذي تمت مناقشته بالتفصيل في مستندات نموذج التطبيق.

‫14 نوفمبر 2012

يتضمّن هذا التحديث التغييرات التالية:

  • يتضمّن دليل API المرجعي الآن APIs Explorer، ما يتيح لك طلب البيانات من واجهة برمجة التطبيقات والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات واسترداد البيانات الفعلية في الاستجابة.

  • تتيح واجهة برمجة التطبيقات عددًا من التقارير الجديدة لكلّ من القنوات ومالكي المحتوى، وهي موضّحة أدناه. يتوفّر كل تقرير على شكل تقرير قناة أو تقرير مالك محتوى. تم أيضًا تعديل صفحتَي السمات والمقاييس وفقًا لذلك.

    • يحدّد تقرير "مواقع التشغيل" عدد مشاهدات الفيديو التي تمّت على أنواع مختلفة من الصفحات أو التطبيقات.

    • يحدّد تقرير "تفاصيل موقع التشغيل" المشغّلات المضمّنة التي حقّقت أكبر عدد من المشاهدات لفيديو معيّن. ويوفّر هذا التقرير عرضًا أكثر تفصيلاً من تقرير "مواقع التشغيل" من خلال تحديد عناوين URL المرتبطة بأهم المشغّلات المضمّنة.

    • يحدّد تقرير "مصدر الزيارات" عدد مشاهدات الفيديوهات التي نشأت من أنواع مختلفة من المُحيلين.

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

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

‫2 أكتوبر 2012

يتضمّن هذا التحديث التغييرات التالية:

  • تتوفّر YouTube Analytics API الآن لجميع المطوّرين. يمكنك تفعيل واجهة برمجة التطبيقات لمشروعك بدون الحاجة إلى طلب الوصول أولاً، وذلك من لوحة الخدمات في APIs console.

  • يوضّح القسم الجديد البدء المتطلبات الأساسية والخطوات الأساسية لإنشاء تطبيق يستخدم YouTube Analytics API.

‫12 سبتمبر 2012

يتضمّن هذا التحديث التغييرات التالية:

  • يقدّم القسم الجديد فهم استخدام الحصة إرشادات لتحسين استخدام حصة واجهة برمجة التطبيقات. يحتسب خادم واجهة برمجة التطبيقات تكلفة طلب البحث لكل طلب، ويتم خصم هذه التكلفة من حصة استخدام واجهة برمجة التطبيقات. بما أنّ الأنواع المختلفة من التقارير قد تختلف تكاليف طلبات البحث فيها بشكل كبير، عليك التخطيط لاستخدام حصتك بكفاءة، ويجب أن يطلب تطبيقك فقط المقاييس والبيانات التي يحتاج إليها فعليًا.

  • تم تعديل قسم السمات الزمنية لتوضيح أنّ هذه السمات تشير إلى أنّ تقرير "إحصاءات Google" يجب أن يجمع البيانات المجمّعة استنادًا إلى فترة زمنية معيّنة. تتيح واجهة برمجة التطبيقات الآن السمات الزمنية الإضافية التالية:

    • ‫7DayTotals: سيتم تجميع البيانات في التقرير بحيث يحتوي كل صف على بيانات لفترة سبعة أيام.
    • ‫30DayTotals: سيتم تجميع البيانات في التقرير بحيث يحتوي كل صف على بيانات لفترة 30 يومًا.
    • month: سيتم تجميع البيانات في التقرير حسب الشهر التقويمي.

    وبالمثل، تم تعديل قسم التقارير المتاحة ليعكس إتاحة واجهة برمجة التطبيقات للتقارير التي تستخدم هذه السمات.

  • تم تعديل قسم سمات الكيانات التي يتم إعداد التقارير لها للإشارة إلى أنّ طلبات البيانات من واجهة برمجة التطبيقات لاسترداد تقارير مالكي المحتوى يجب أن تفلتر البيانات باستخدام إحدى هذه السمات (video أو channel أو show) أو مجموعة متوافقة من السمتَين claimedStatus وuploaderType.

  • تتيح واجهة برمجة التطبيقات الآن خيارَي ترتيب جديدَين لتقارير الفيديوهات الأفضل أداءً. تحتوي هذه التقارير، المتوفّرة كتقارير القنوات أو تقارير مالكي المحتوى، على مقاييس (المشاهدات والتعليقات والمعجبين وما إلى ذلك) لكل بلد، وتصنّف هذه المقاييس حسب الفيديو. يمكنك الآن ترتيب هذه التقارير استنادًا إلى عدد المستخدمين الذين اشتركوا في قناة أو ألغوا اشتراكهم فيها من صفحة مشاهدة الفيديو.

  • تم تعديل تعريفَي مقياسَي subscribersGained وsubscribersLost لتوضيح أنّ القناة يمكن أن تكتسب مشتركين أو تفقدهم في أماكن متعددة، بما في ذلك صفحة مشاهدة الفيديو وصفحة القناة والدليل الذي يظهر على صفحة YouTube الرئيسية. عندما تظهر هذه المقاييس في تقرير خاص بفيديو معيّن، فإنّها تتضمّن فقط الإحصاءات من صفحة مشاهدة الفيديو المحدّد.