سِجل النُسخ السابقة

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

6 مايو 2024

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

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

7 أبريل 2024

تم إجراء عدّة تعديلات في واجهة برمجة تطبيقات "إحصاءات YouTube" (طلبات البحث المستهدَفة) تتعلّق بمالك المحتوى تقارير قوائم التشغيل. تماثل التحديثات التحديثات المتعلقة بتقارير قوائم تشغيل القنوات، التي تم الإعلان عنها في 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 متاحة كفلاتر لتقارير قوائم التشغيل في القنوات. هذه الفلاتر غير متاحة في وبالتالي، يساعد هذا التغيير في ضمان توافق وظائف واجهة برمجة التطبيقات مع الوظائف المتوفّرة في تطبيق الاستوديو.

  • تقارير قوائم التشغيل في مستندات تقارير مالك المحتوى قد تم تعديلها لتوضيح أنواع المقاييس المتاحة لتقارير قوائم التشغيل:

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

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

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

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

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

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

19 يناير 2024

تتضمّن واجهة برمجة تطبيقات "إحصاءات YouTube" (طلبات البحث المستهدَفة) عدّة تعديلات مرتبطة بقائمة تشغيل القناة. التقارير. تشمل التعديلات سمة تم إيقافها نهائيًا والعديد من المقاييس الجديدة والمحدّثة:

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

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

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

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

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

  • تقارير قوائم التشغيل في مستندات تقارير القنوات لمزيد من التوضيح أنواع المقاييس المتاحة لتقارير قوائم التشغيل:

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

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

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

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

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

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

4 كانون الأول (ديسمبر) 2023

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

15 كانون الأول (ديسمبر) 2022

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

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

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

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

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

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

26 آب (أغسطس) 2022

واجهة برمجة تطبيقات "إحصاءات YouTube" (طلبات البحث المستهدَفة) وواجهة برمجة التطبيقات لإعداد التقارير في YouTube (التقارير المجمّعة) معًا دعم قيمة تفاصيل جديدة لمصدر الزيارات:

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

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

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

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

  • في واجهة برمجة تطبيقات "إحصاءات YouTube" (طلبات البحث المستهدَفة)، سمة واحدة (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" واجهة برمجة التطبيقات لإعداد تقارير YouTube (التقارير المجمّعة)

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

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

  • في واجهة YouTube Reporting API (التقارير المجمّعة) traffic_source_type تدعم القيمة 28.

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

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

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

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

13 شباط (فبراير) 2020

يتضمّن هذا التعديل التغييرات التالية المتعلّقة بـ "إحصاءات YouTube" (طلبات البحث المستهدَفة). واجهة برمجة التطبيقات وواجهة برمجة التطبيقات لإعداد التقارير في YouTube (التقارير المجمّعة) يمكنك الاطّلاع على المزيد من المعلومات عن هذه التغييرات في مركز مساعدة YouTube:

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

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

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

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

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

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

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

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

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

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

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

27 حزيران (يونيو) 2019

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

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

1 تشرين الثاني (نوفمبر) 2018

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

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

    تجدر الإشارة إلى أنّه تم الإعلان أصلاً عن الجدول الزمني لعملية الإيقاف هذه في 26 نيسان (أبريل) 2018.

17 أيلول (سبتمبر) 2018

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

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

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

      أو

    2. اخترت فلترًا أو سمة، مثل مصدر الزيارات أو البلد، لا تستوفي قيمها حدًّا معيّنًا.

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

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

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

يتضمّن هذا التعديل التغييرات التالية على واجهة برمجة تطبيقات "إحصاءات YouTube" (طلبات البحث المستهدَفة):

  • تم تغيير متطلبات النطاق للطرق التالية:
    • يجب أن تصل الطلبات إلى الطريقة 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" (طلبات البحث المستهدَفة):

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

22 أيار (مايو) 2018

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

  • من المقرر أن تدخل التغييرات التالية حيز التنفيذ في تموز (يوليو) 2018، وسيتم تطبيق السياسات الجديدة عالميًا على جميع وظائف إعداد التقارير وإعداد التقارير.

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

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

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

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

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

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

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

26 نيسان (أبريل) 2018

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

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

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

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

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

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

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

‫21 فبراير 2018

يتضمّن هذا التعديل التغييرات التالية على واجهة برمجة تطبيقات "إحصاءات YouTube" (طلبات البحث المستهدَفة):

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

18 كانون الثاني (يناير) 2018

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

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

    • السمة operating_system، التي تحدد نظام برنامج الجهاز الذي حدثت عليه المشاهدات، تتيح الآن القيمة التالية:
      • 25: KaiOS

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

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

20 كانون الأول (ديسمبر) 2017

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

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

    لتلقّي استجابة بترميز 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 لألعاب الفيديو
      • 87: YouTube Kids
      • 88: YouTube TV

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

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

    • تتيح السمة sharingService الآن القيم التالية:

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 آذار (مارس) 2017

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

17 آذار (مارس) 2017

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

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

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

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

3 آذار (مارس) 2017

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

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

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

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

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

    • السمة operating_system، التي تحدد نظام برنامج الجهاز الذي حدثت عليه المشاهدات، تتيح الآن القيم التالية:
      • 22: تيزن
      • 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 ساعة. (في السابق، كانت المستندات تنص على أنّ التوقيت العالمي المنسّق - 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 استخدام ثلاثة تقارير لشاشات النهاية جديدة بالإضافة إلى سمات ومقاييس جديدة لتلك التقارير. وتوفر التقارير إحصاءات حول مرّات الظهور ونسبة النقر إلى الظهور لشاشات النهاية التي تظهر بعد توقّف تشغيل الفيديو.

    8 تشرين الثاني (نوفمبر) 2016

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

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

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

    27 تشرين الأول (أكتوبر) 2016

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

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

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

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

    27 أيلول (سبتمبر) 2016

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

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

    15 أيلول (سبتمبر) 2016

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

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

      • red_views: عدد المرات التي شاهد فيها أعضاء YouTube Red الفيديو
      • red_watch_time_minutes: عدد الدقائق التي شاهد فيها أعضاء YouTube Red الفيديو

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

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

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

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

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

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

      إذا كان لديك وظائف في أيٍّ من هذه التقارير، فلا تتوقّع أن تنشئ منصة YouTube تقارير جديدة لهذه الوظائف بعد 15 كانون الأول (ديسمبر) 2016. ستظل التقارير المُنشأة متاحة لمدة 180 يومًا من وقت إنشائها.

    19 آب (أغسطس) 2016

    يشمل هذا التعديل التغيير التالي على YouTube Reporting API:

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

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

    11 آب (أغسطس) 2016

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

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

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

    ‫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
      • 84: مراسلة Android
    • في YouTube Analytics API، تتيح السمة sharingService القيم الجديدة التالية:
      • ANDROID_MESSENGER: مراسلة Android
      • INBOX: البريد الوارد في Google
      • 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، تستخدم السمة 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
      المقاييس:
      استخدام 1 أو أكثر views وestimatedMinutesWatched
      الفلاتر:
      استخدِم 0 أو 1 البلد والمقاطعة والقارة وsubContinent
      استخدِم 0 أو 1 فيديو، مجموعة
      استخدام 0 أو أكثر operatingSystem وliveOrOnDemand وsubscribedStatus وyoutubeProduct

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

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

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

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

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

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

    10 تشرين الثاني (نوفمبر) 2015

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

    29 تشرين الأول (أكتوبر) 2015

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

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

      تُعدّ جميع المقاييس الجديدة مقاييس أساسية وتخضع لسياسة الإيقاف النهائي. ومع ذلك، تجدر الإشارة إلى أنّ البيانات أصبحت متاحة للمقاييس الجديدة اعتبارًا من 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 رمز منطقة إحصائي للأمم المتحدة يحدّد قارة معيّنة. لا يمكن استخدام هذه السمة إلا كفلتر.

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

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

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

    30 أيلول (سبتمبر) 2013

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

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

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

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

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

    16 تموز (يوليو) 2013

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

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

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

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

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

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

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

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

    23 أيار (مايو) 2013

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

    10 أيار (مايو) 2013

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

    6 أيار (مايو) 2013

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

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

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

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

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

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

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

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

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

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

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

    3 أيار (مايو) 2013

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

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

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

    28 آذار (مارس) 2013

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

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

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

    21 آذار (مارس) 2013

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

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

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

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

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

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

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

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

    4 شباط (فبراير) 2013

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

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

    14 تشرين الثاني (نوفمبر) 2012

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

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

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

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

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

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

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

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

    2 أكتوبر 2012

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

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

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

    12 أيلول (سبتمبر) 2012

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

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

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

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

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

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

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

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