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

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

‫24 يونيو 2025

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

  • تم إنشاء إصدارات جديدة من التقارير لكل تقرير يتضمّن طرق عرض، وهو ما ينطبق على معظم التقارير. تمت زيادة رقم إصدار كل تقرير متأثّر بمقدار واحد، مثلاً من الإصدار a2 إلى الإصدار a3.
  • بالنسبة إلى فيديوهات Shorts، سيشمل مقياس المشاهدات الآن عدد مرات بدء تشغيل فيديو Shorts أو إعادة تشغيله. بالنسبة إلى "الفيديوهات"، لم يطرأ أي تغيير.
  • ستتضمّن التقارير المعدَّلة عمودًا جديدًا، 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 الآن عدد مرات بدء تشغيل فيديو Shorts أو إعادة تشغيله.
  • سيعرض المقياس الجديد engagedViews منهجية احتساب المشاهدات السابقة. سيتم توفير engagedViews في جميع التقارير مع views.

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

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

‫22 أبريل 2025

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

‫26 مارس 2025

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

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

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

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

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

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

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

‫3 مارس 2025

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

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

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

‫15 نوفمبر 2024

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

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

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

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

‫6 مايو 2024

تتيح واجهة YouTube Analytics API (الطلبات المستهدَفة) ثلاثة تقارير جديدة للقنوات:

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

‫7 أبريل 2024

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

يقدّم إدخال سجلّ المراجعات التالي المعلومات نفسها تقريبًا التي يقدّمها الإدخال من 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 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 (الطلبات المستهدَفة) لدمج قيمتَي سمة insightTrafficSourceType معًا. في السابق، كان المقياس يفرّق بين الفيديوهات التي يتم تشغيلها كجزء من قائمة تشغيل (PLAYLIST) والمشاهدات التي مصدرها صفحة تعرض كل الفيديوهات في قائمة تشغيل (YT_PLAYLIST_PAGE). من الآن فصاعدًا، سيتم ربط كلا النوعين من المشاهدات بقيمة المقياس PLAYLIST.

‫15 ديسمبر 2022

تتيح واجهة YouTube Analytics API (الطلبات المستهدَفة) سمةَين جديدتَين وتقريرًا جديدًا واحدًا:

  • يتوفّر تقرير جديد يعرض نشاط المستخدم حسب المدينة. يتوفّر هذا التقرير للقنوات و مالكي المحتوى. يتضمّن هذا التقرير السمة الجديدة 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 (Bulk Reports) API، إذا كانت قيمة السمة traffic_source_type هي 3، يمكن ضبط قيمة traffic_source_detail على podcasts، ما يشير إلى أنّ الزيارات تمت الإحالة إليها من صفحة وجهة البودكاست.

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

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

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

  • في واجهة YouTube Analytics 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" (التقارير المجمّعة) قيمة جديدة لسمة مصدر الزيارات تشير إلى أنّ المشاهدات أتت من أحداث مباشرة تمت إعادة توجيه المشاهدين إليها:

  • في واجهة 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 Analytics 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: المشاهدات التي مصدرها إشعارات غير فورية، مثل الإشعارات عبر البريد الإلكتروني أو في البريد الوارد، والتي يتم إرسالها إلى المشتركين عند تحميل فيديو

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

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

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

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

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

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

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

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

‫27 يونيو 2019

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

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

‫1 نوفمبر 2018

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

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

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

‫17 سبتمبر 2018

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

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

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

      أو

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

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

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

‫18 حزيران (يونيو) 2018

يتضمّن هذا التعديل التغييرات التالية على واجهة YouTube Analytics 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 API (الطلبات المستهدَفة):

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

‫22 مايو 2018

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

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

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

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

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

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

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

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

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

‫26 أبريل 2018

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

  • تتشابه واجهة برمجة التطبيقات الإصدار 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 من واجهة برمجة التطبيقات. يؤدي هذا التغيير إلى اتّساق أسماء المَعلمات في جميع أنحاء واجهة برمجة التطبيقات، لأنّ طرق واجهة برمجة التطبيقات لإنشاء المجموعات وإدارتها كانت تستخدم بالفعل أسلوب الكتابة المختلط لأسماء المَعلمات.
    • لا تتيح واجهة برمجة التطبيقات الإصدار 2 إرسال طلبات مجمّعة إلى نقطة النهاية المجمّعة العامة لبروتوكول HTTP من Google (www.googleapis.com/batch). إذا كنت ترسل طلبات مجمّعة في واجهة برمجة التطبيقات الإصدار 2، عليك استخدام نقطة النهاية https://youtubeanalytics.googleapis.com/v2 بدلاً من ذلك.

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

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

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

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

‫21 فبراير 2018

يتضمّن هذا التعديل التغييرات التالية على واجهة YouTube Analytics 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 ساعة وأنّ توقيت المحيط الهادئ كان دائمًا بالتوقيت العالمي المنسّق -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:

‫11 أغسطس 2016

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

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

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

‫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.
  • تتيح السمة traffic_source_type الآن استخدام 18 كقيمة سمة. تشير هذه القيمة إلى أنّ مشاهدات الفيديو أتت من صفحة تعرض كل الفيديوهات في قائمة تشغيل. يختلف هذا المصدر عن نوع المصدر 14 الذي يشير إلى أنّ المشاهدات حدثت أثناء تشغيل الفيديو كجزء من قائمة تشغيل.

YouTube Analytics API

  • تتيح السمة insightPlaybackLocationType قيمتَي سمة جديدتَين:
    • BROWSE: تشير البيانات إلى المشاهدات التي حدثت على صفحة YouTube الرئيسية أو شاشتها الرئيسية، أو في خلاصة اشتراكات المستخدم، أو في ميزة أخرى من ميزات التصفّح على YouTube.
    • SEARCH: تشير البيانات إلى المشاهدات التي تمّت مباشرةً على صفحة نتائج البحث على YouTube.
  • تتيح السمة insightTrafficSourceType الآن استخدام YT_PLAYLIST_PAGE كقيمة سمة. تشير هذه القيمة إلى أنّ مشاهدات الفيديو أتت من صفحة تعرض كل الفيديوهات في قائمة تشغيل. يختلف مصدر المشاهدات هذا عن نوع المصدر 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 video وgroup
    استخدِم 0 أو أكثر operatingSystem وliveOrOnDemand وsubscribedStatus وyoutubeProduct

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

  • تتجاهل "واجهة برمجة تطبيقات YouTube Analytics" الآن تلقائيًا العناصر التي لا يمكن لمستخدم الواجهة استرداد بياناتها من الفلاتر التي تتيح استخدام قيم متعددة (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 للإشارة إلى أنّ جميع السمات المرتبطة بالتاريخ (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 عنصرًا في مجموعة "إحصاءات Google". تتيح واجهة برمجة التطبيقات طُرق 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.

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

‫4 فبراير 2013

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

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

‫14 نوفمبر 2012

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

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

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

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

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

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

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

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

‫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 الرئيسية. عندما تظهر هذه المقاييس في تقرير خاص بفيديو معيّن، فإنّها تتضمّن الإحصاءات من صفحة مشاهدة الفيديو المحدّد فقط.