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

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

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

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

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

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

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

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

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

  • يعتمد سلوك المقياس 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 حاليًا أمثلة لكلّ من السمتَين الجديدتَين.

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

26 آب (أغسطس) 2022

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

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

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

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

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

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

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

تم تعديل مقياسَين لاستبعاد عدد الزيارات الواردة من المقاطع المتكررة اعتبارًا من 13 كانون الأول (ديسمبر) 2021. يؤثّر هذا التغيير في كلّ من واجهة برمجة التطبيقات في "إحصاءات YouTube" (طلبات البحث المستهدفة) وواجهة برمجة التطبيقات لإعداد التقارير في YouTube (التقارير المجمّعة).

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

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

  • في واجهة برمجة التطبيقات لإعداد التقارير في YouTube (التقارير المجمَّعة)، تتيح السمة traffic_source_type القيمة 28.

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

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

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

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

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

20 تموز (يوليو) 2020

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

  • لقد زاد الحدّ الأقصى المسموح به لمجموعة تقارير "إحصاءات YouTube" من 200 إلى 500 مجموعة.
  • تحدّد معلَمة filters في طريقة reports.query قائمة بالفلاتر التي يجب تطبيقها عند استرداد بيانات "إحصاءات YouTube". تتيح المَعلمة إمكانية تحديد قيم متعدّدة للفلاتر 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 وتجميع البيانات أو اشتقاقها على مدى سبعة أو ثلاثين يومًا. مثال:

    • ويمكن احتساب عدد المشاهدات لمدة سبعة أيام من خلال تجميع عدد المشاهدات من كل يوم من تلك الفترة.
    • يمكن احتساب نسبة المشاهدين لمدة سبعة أيام من خلال ضرب عدد المشاهدات التي حدثت كل يوم في النسبة المئوية للمشاهدين لذلك اليوم للحصول على عدد المشاهدين الذين سجّلوا الدخول عند مشاهدة الفيديو في ذلك اليوم. بعد ذلك، يمكن إضافة عدد المشاهدين الذين سجّلوا دخولهم للمدة الكاملة وقسمته على إجمالي عدد المشاهدات في تلك الفترة للحصول على النسبة المئوية للمشاهدين عن الفترة الكاملة.
    • لا يمكن احتساب عدد المشاهدين الفرديين لفترة سبعة أيام لأنّه يمكن احتساب المشاهد نفسه كمشاهد فردي في أيام مختلفة. وفي المقابل، قد تتمكّن من استخدام السمة 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 API. كما هو موضّح في سياسات المطوّرين في خدمات واجهة برمجة تطبيقات YouTube (الأقسام من 3.3.1 إلى 3.E.4.d)، على عملاء واجهة برمجة التطبيقات حذف أو إعادة تحميل البيانات الوصفية للموارد المخزّنة من واجهة برمجة التطبيقات هذه بعد 30 يومًا.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

21 شباط (فبراير) 2018

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

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

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

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

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

    • أصبحت السمة operating_system، التي تحدد نظام البرامج للجهاز الذي حدثت عليه المشاهدات، متوافقة الآن مع القيمة التالية:
      • 25: KaiOS
  • YouTube Analytics API (طلبات البحث المستهدفة)

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

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

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

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

    Accept-Encoding: gzip

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

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

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

10 آب (أغسطس) 2017

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

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

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

6 تموز (يوليو) 2017

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

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

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

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

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

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

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

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

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

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

24 أيار (مايو) 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

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

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

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

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

    • أصبحت السمة sharing_service، التي تحدد الخدمة التي تم استخدامها لمشاركة الفيديوهات، متوافقة الآن مع القيم التالية:

      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

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

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

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

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

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

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

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

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

  • تتيح واجهة برمجة تطبيقات YouTube Analytics استخدام المقياسَين 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 ساعة. (في السابق، كانت الوثائق تذكر أن توقيت المحيط الهادئ كان UTC-8 ولم تذكر احتمال أن اليوم قد لا يمثل فترة 24 ساعة).

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

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

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

8 شباط (فبراير) 2017

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    19 آب (أغسطس) 2016

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

    11 آب (أغسطس) 2016

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

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

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

    10 آب (أغسطس) 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    18 يوليو 2016

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

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

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

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

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

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

    28 حزيران (يونيو) 2016

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

    ويمكن استخدام هذه المقاييس في الأنواع التالية من التقارير:

    22 حزيران (يونيو) 2016

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

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

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

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

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

      • تمت إعادة تسمية تقريرَين لهما نُسخ جديدة:

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

        في ما يلي نقاط الاختلاف بين التقارير التي تمت إعادة تسميتها مؤخرًا عن الإصدارات السابقة:

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

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

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

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

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

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

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

    19 أيار (مايو) 2016

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

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

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

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

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

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

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

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

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

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

    12 نيسان (أبريل) 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • في YouTube Reporting API، تتيح السمة sharing_service القيم الجديدة التالية:
      • 82: مربع حوار نشاط نظام iOS
      • 83: البريد الوارد في Google
      • 84: Android Messenger
    • في YouTube Analytics API، تتيح السمة sharingService القيم الجديدة التالية:
      • ANDROID_MESSENGER: Android Messenger
      • 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.
    • يمكن الآن استخدام السمة 18 كقيمة للسمة traffic_source_type. وتشير هذه القيمة إلى أنّ مشاهدات الفيديو نشأت من صفحة تعرض كل الفيديوهات في قائمة تشغيل. يختلف هذا المصدر عن نوع المصدر "14"، ما يشير إلى أنّ المشاهدات حدثت أثناء تشغيل الفيديو كجزء من قائمة تشغيل.

    YouTube Analytics API

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

    8 شباط (فبراير) 2016

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

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

    6 كانون الثاني (يناير) 2016

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

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

    21 كانون الأول (ديسمبر) 2015

    في المستندات، تم تعديل اسمَي المقياسَين annotation_clickable_impressions وannotation_closable_impressions لمطابقة الأسماء التي يتم عرضها في التقارير. في السابق، كان يتم توثيق الاسمين بالصيغة clickable_annotation_impressions وclosable_annotation_impressions.

    18 كانون الأول (ديسمبر) 2015

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

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

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

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

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

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

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

      المحتويات
      الأبعاد:
      مطلوبة deviceType
      استخدِم 0 أو أكثر day وliveOrOnDemand وsubscribedStatus وyoutubeProduct
      المقاييس:
      يمكنك استخدام عنصر واحد أو أكثر. مشاهدة، estimatedMinutesWatched
      الفلاتر
      استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
      استخدِم 0 أو 1 فيديو أو مجموعة
      استخدِم 0 أو أكثر operatingSystem وliveOrOnDemand وsubscribedStatus وyoutubeProduct

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

    • أصبحت واجهة برمجة تطبيقات YouTube Analytics تُزيل الآن تلقائيًا الكيانات التي يتعذّر على مستخدم واجهة برمجة التطبيقات استرداد بياناتها من الفلاتر التي تتيح قِيَمًا متعددة (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 Reporting API من جديد للإشارة إلى أنّ التواريخ تشير إلى فترة 24 ساعة وتبدأ من الساعة 12:00 صباحًا بتوقيت المحيط الهادئ (UTC-8). وفي السابق، كانت المستندات تشير إلى أنّ التاريخ يبدأ في الساعة 12:00 صباحًا (بتوقيت غرينتش).

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

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

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

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

    20 آب (أغسطس) 2015

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

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

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

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

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

    22 تموز (يوليو) 2015

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

    • يتضمّن المقياس الجديد "adEarnings" إجمالي الأرباح المقدَّرة (صافي الأرباح) من جميع مصادر Google الإعلانية التي تبيعها 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.

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

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

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

    31 كانون الثاني (يناير) 2014

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

    16 يناير 2014

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

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

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

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

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

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

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

    6 يناير 2014

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

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

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

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

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

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

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

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

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

      • تحدّد السمة continent رمز منطقة إحصائية للأمم المتحدة يحدِّد إحدى القارات. لا يمكن استخدام هذه السمة إلا كفلتر.

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

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

    • تم تصحيح الوثائق بحيث لا تشتمل سمة insightTrafficSourceDetail على قيمة insightTrafficSourceType PROMOTED كقيمة فلتر صالحة.

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

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

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

    • تتيح واجهة برمجة التطبيقات الآن استخدام 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 الإعلانية التي تبيعها 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 التي تتيح لك طلب بيانات من واجهة برمجة التطبيقات والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات واسترداد البيانات الفعلية في الردّ.

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

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

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

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

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

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

    2 تشرين الأول (أكتوبر) 2012

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

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

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

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

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

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

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

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

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

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

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

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