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

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

15 تشرين الثاني (نوفمبر) 2024

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

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

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

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

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

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

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

7 نيسان (أبريل) 2024

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

يوفّر إدخال سجلّ المراجعات التالي معلومات مشابهة تقريبًا للإدخال الذي يعود إلى 19 كانون الثاني (يناير) 2024. يُرجى العِلم أنّه سيتم إيقاف سمة isCurated في تقارير قوائم التشغيل الخاصة بأصحاب المحتوى نهائيًا في 31 كانون الأول (ديسمبر) 2024، بينما سيتم إيقافها في تقارير قوائم التشغيل الخاصة بالقنوات نهائيًا في 30 حزيران (يونيو) 2024.

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

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

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

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

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

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

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

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

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

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

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

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

19 كانون الثاني (يناير) 2024

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

26 آب (أغسطس) 2022

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

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

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

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

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

  • في YouTube Analytics (Targeted Queries) API، تتيح سمة 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 Reporting (Bulk Reports) API، تتيح سمة traffic_source_type استخدام القيمة 28.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      أو

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫21 فبراير 2018

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

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

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

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

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

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

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

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

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

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

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

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

    Accept-Encoding: gzip

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

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

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

10 آب (أغسطس) 2017

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

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

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

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

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

    • تتيح الآن سمة sharing_service، التي تحدّد الخدمة المستخدَمة لمشاركة الفيديوهات، القيم التالية:

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

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

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

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

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

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

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

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

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

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

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

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

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

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

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

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

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

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

    • تتيح السمة operating_system، التي تحدّد نظام البرامج للجهاز الذي حدثت عليه المشاهدات، الآن القيم التالية:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    19 آب (أغسطس) 2016

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

    11 آب (أغسطس) 2016

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

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

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

    10 آب (أغسطس) 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    18 تموز (يوليو) 2016

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

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

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

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

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

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

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

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

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

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

    ‫22 يونيو 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    YouTube Analytics API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    24 أيلول (سبتمبر) 2015

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

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

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

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

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

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

    20 آب (أغسطس) 2015

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

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

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

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

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

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

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

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

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

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

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

    1 حزيران (يونيو) 2015

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

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

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

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

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

    31 آذار (مارس) 2015

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

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

    16 آذار (مارس) 2015

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

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

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

    25 شباط (فبراير) 2015

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

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

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

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

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

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

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

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

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

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

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

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

    28 آب (أغسطس) 2014

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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