إحصاءات Google - جميع سجلات تغييرات واجهة برمجة التطبيقات للتهيئة

تمت إضافة طريقة valueClientId إلى Management API.

توفّر طريقة hashClientId تجزئة معرّف العميل المحدّد والتي يمكن العثور عليها في تنسيقات معيّنة للبيانات المُصدَّرة، كما هو الحال في بيانات "إحصاءات Google" التي يتم تصديرها إلى BigQuery.

إعدادات الاحتفاظ ببيانات المستخدمين في Management API

أصبح من الممكن الآن ضبط إعدادات الاحتفاظ ببيانات المستخدمين آليًا باستخدام الحقلَين "dataBACKUPTtl" و"dataستنPauseOnNewActivity" الجديد المضاف إلى مورد الموقع الإلكتروني.

هذا هو الإصدار الأولي من User Deletion API:

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

كتابة العمليات في Management API

لم تعد عمليات كتابة العمليات في Management API (مثل الإنشاء والتحديث والحذف وتصحيح الأخطاء) لحسابات مواقع الويب والملف الشخصي (الملف الشخصي) و"هدف" تتطلب إضافة إلى القائمة البيضاء. إنّ الحدّ اليومي التلقائي لجميع عمليات الكتابة في Management API هو 50 عملية كتابة في اليوم. يمكنك الاطّلاع على صفحة الحدود والحصص لمزيد من المعلومات.

جمهور تجديد النشاط التسويقي - دعم "أدوات تحسين الأداء"

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

جمهور تجديد النشاط التسويقي

يضيف هذا الإصدار الفعل DELETE إلى مورد جمهور تجديد النشاط التسويقي. اطّلع على دليل مطوّري برامج جمهور تجديد النشاط التسويقي للحصول على التفاصيل.

• جمهور تجديد النشاط التسويقي: حذف - لحذف جمهور تجديد النشاط التسويقي.

المقاييس المخصّصة

هذا إصدار لإصلاح الأخطاء، وهو يعمل على حلّ المشكلة التي تؤدي إلى تعذُّر إنشاء مقياس مخصّص من النوع TIME في حال عدم ضبط min_value. تؤدي الطلبات التي لا تتضمّن min_value إلى إنشاء مقياس مخصّص باستخدام قيمة تلقائية min_value في 0.

العملات

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

• UAH، درهم إماراتي، بوليفيانو بوليفي، البيزو التشيلي، البيزو الكوستاريكي، مصر الجديدة، كرونة سويدية، شيكل إسرائيلي، درهم إماراتي، رينغيت ماليزي، سول بيروفي، سول بيروفي، دينار صربي، دينار صربي، سنغافورة، الدولار السنغافوري (VEF)، LVL

لمزيد من المعلومات، يُرجى الاطّلاع على: مرجع الملفات الشخصية (الملفات الشخصية). - مقالة مركز المساعدة مرجع العملة.

يضيف هذا الإصدار شرائح جمهور تجديد النشاط التسويقي إلى Management API.

مسؤولو تجديد النشاط التسويقي

تتيح لك Management API استخدام create وget وlist وupdate وpatch شرائح جمهور تجديد النشاط التسويقي لموقع على "إحصاءات Google". لمعرفة المزيد من المعلومات عن آلية عمل شرائح جمهور تجديد النشاط التسويقي، يمكنك الاطّلاع على مقالة لمحة عن شرائح جمهور تجديد النشاط التسويقي في "إحصاءات Google" في مركز المساعدة.

• دليل المطوّر لجمهور تجديد النشاط التسويقي
• مرجع شرائح جمهور تجديد النشاط التسويقي

بطولة

يضيف هذا الإصدار الموقع الإلكتروني starred إلى ملخّصات الحسابات والحسابات ومواقع الويب والملفات الشخصية (الملفات الشخصية).

الحدّ من معدّل الخطأ

لطالما تنص سياستنا على أنّه على المطوّرين تنفيذ عملية رقابة أسييّة عند التعامل مع 500 ردّ أو 503. نطرح اليوم حدًا أقصى لأخطاء 500 و503 لتنفيذ هذه السياسة.

• 50 طلب كتابة فاشل في الساعة

التقارير غير المستندة إلى عينات

لم تعُد واجهة برمجة التطبيقات للتقارير غير المستندة إلى عينات تحتوي على 100 تقرير في اليوم الواحد. تستخدم واجهة برمجة التطبيقات نظام الرمز المميز لكل موقع في اليوم نفسه الذي يستخدمه عند إنشاء تقرير غير مستند إلى عينات من خلال واجهة الويب.

التقارير غير المستندة إلى عينات

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

المشاهدات (الملفات الشخصية)

يضيف هذا الإصدار السمة botFilteringEnabled إلى مورد الملف الشخصي. تشير هذه السمة إلى ما إذا كانت فلترة برامج التتبُّع مُفعَّلة لملف شخصي (ملف شخصي). يمكنك الاطّلاع على المستندات المرجعية المتعلّقة بعرض (الملفات الشخصية) للحصول على مزيد من التفاصيل.

التقارير غير المستندة إلى عينات

يضيف هذا الإصدار طريقة delete إلى التقارير غير المستندة إلى عينات. يمكنك الاطّلاع على المستندات المرجعية لحذف التقارير غير المستندة إلى عينات لمزيد من التفاصيل.

الشرائح

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

الشرائح

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

يضيف هذا الإصدار مَعلمة إضافية إلى عنوان URL لبنود خدمة واجهة برمجة التطبيقات لإدارة الحسابات:

• تعمل إضافة معلَمة عنوان URL، provisioningSignup=false، على إصلاح مشكلة تحدث عند توفير حساب على "إحصاءات Google" لمستخدم ليس لديه أي حسابات على "إحصاءات Google". وعلى المطوّرين تعديل الرمز لإضافة هذه المَعلمة إلى عنوان URL لبنود الخدمة.

التجميع

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

المشاهدات (الملفات الشخصية)

في إطار هذا الإصدار، سيتم الآن ضبط الموقع الإلكتروني currency للملف الشخصي (الملف الشخصي) تلقائيًا على USD في حال عدم ضبطه أثناء عملية إدراج. كذلك ستعرض عمليات get وlist الدولار الأمريكي في الملفات الشخصية (الملفات الشخصية) التي تم إنشاؤها في السابق بدون موقع currency.

• يُرجى الاطّلاع على دليل المطوّر الخاص بالملف الشخصي للحصول على تفاصيل حول استخدام الملف الشخصي (الملفات الشخصية) في Management API.

• يُرجى الاطّلاع على مرجع العرض (الملفات الشخصية) للحصول على القائمة الكاملة للمَعلمات لمورد الملف الشخصي (الملف الشخصي).

فلاتر

يشير هذا الإصدار إلى الإزالة النهائية لحقلَي الفلترة المتوقّفَين IS_MOBILE وIS_TABLET، والذي يجب استبداله بـ DEVICE_CATEGORY=mobile وDEVICE_CATEGORY=tablet. طلبات الإدراج والتعديل والتصحيح التي تم من خلالها ضبط حقول الفلاتر لاستخدام IS_MOBILE، وستظهر رسالة خطأ عند IS_TABLET.

• يُرجى الاطّلاع على دليل مطوِّر البرامج للحصول على تفاصيل عن استخدام الفلاتر في Management API.

• يُرجى الاطّلاع على مرجع الفلاتر للحصول على القائمة الكاملة بمَعلمات لمورد الفلتر.

فلاتر

يتيح هذا الإصدار استخدام سمة مخصّصة في حقل فلتر من خلال إضافة السمة fieldIndex إلى جميع أقسام تفاصيل الفلتر. على سبيل المثال، من الممكن الآن ضبط تعبير الفلتر باستخدام "field": "CUSTOM_DIMENSION" و"fieldIndex": "1" لكي يعمل الفلتر على السمة المخصّصة الأولى.

• يُرجى الاطّلاع على دليل مطوِّر البرامج للحصول على تفاصيل عن استخدام الفلاتر في Management API.

• يُرجى الاطّلاع على مرجع الفلاتر للحصول على قائمة كاملة بمَعلمات لمورد الفلتر.

الأهداف

يعمل هذا الإصدار أيضًا على حلّ المشكلة التي تحدث عند إنشاء هدف باستخدام "comparisonValue": "0".

• يُرجى الاطّلاع على دليل مطوِّري الأهداف للحصول على تفاصيل عن استخدام الأهداف في Management API.

• يُرجى الاطلاع على مرجع الأهداف للحصول على قائمة كاملة بمعلمات لمورد الهدف.

يمثّل هذا الإصدار الإيقاف النهائي لمصدر dailyUpload وإزالتها. تم إيقاف المورد dailyUpload رسميًا في 20 حزيران (يونيو) 2014؛ ومن المفترض أن يتم الآن استيراد بيانات التكلفة بالكامل باستخدام مورد عمليات التحميل.

• يُرجى الاطّلاع على سياسة إيقاف البيانات نهائيًا للحصول على مزيد من التفاصيل عن عملية إيقاف Google Analytics API.
• اطّلع على دليل المطوّر لاستيراد البيانات للحصول على مزيد من التفاصيل عن كيفية استيراد البيانات إلى "إحصاءات Google".

يضيف هذا الإصدار مجموعتَين جديدتَين إلى Management API، وهما "السمات المخصّصة" و"المقاييس المخصَّصة".

المقاييس والمكوّنات المخصّصة

من الممكن الآن إنشاء المقاييس والسمات المخصّصة وإدراجها والحصول عليها وتصحيحها وتعديلها باستخدام واجهة برمجة التطبيقات Management API.

• دليل المطوّر حول المقاييس والسمات المخصَّصة
• مرجع ميزات المقاييس والسمات المخصّصة
• مرجع السمات المخصّصة
• مرجع المقاييس المخصَّصة

تتضمّن الآن استجابة طريقة list لجميع المجموعات قائمة فارغة للسمة items عندما لا تحتوي المجموعة على أي موارد. في السابق، كانت السمة items تُحذف من الرد. اطّلع على مرجع واجهة برمجة التطبيقات للحصول على تفاصيل كاملة حول طلبات البحث والردود لبيانات تهيئة "إحصاءات Google".

إصلاح الأخطاء

• حلُّ المشكلة 467: تعرض الآن مجموعة الشرائح المقاطع التي تستخدم بنية dateOfSession.

يقدّم هذا الإصدار نطاقًا جديدًا لواجهة برمجة التطبيقات لإدارة "إحصاءات Google". - analytics.manage.users.readonly - عرض أذونات المستخدمين في "إحصاءات Google"

تمت إضافة حقل DEVICE_CATEGORY فلاتر جديد، وتم الآن إيقاف IS_MOBILE وIS_TABLET نهائيًا. استخدِم DEVICE_CATEGORY=mobile وDEVICE_CATEGORY=tablet.

يشتمل مورد الملف الشخصي (الملف الشخصي) الآن على موقع enhancedECommerceTracking يشير إلى ما إذا كانت التجارة الإلكترونية المحسَّنة مفعَّلة (true) أو غير مفعَّلة (false).

يتضمّن هذا الإصدار أنواعًا جديدة لاستيراد البيانات والإيقاف النهائي لمورد dailyUpload.

استيراد البيانات

اطّلع على دليل المطوّر لاستيراد البيانات لمزيد من التفاصيل عن كيفية استخدام Management API لاستيراد البيانات إلى حسابك على "إحصاءات Google".

الفيديوهات المحمّلة

• يتيح مورد upload الآن أنواع التحميل التالية:
  • بيانات الحملات
  • بيانات المحتوى
  • بيانات التكلفة
  • بيانات المنتج
  • بيانات رد الدفعة
  • بيانات المستخدمين
• يحتوي مورد upload على طريقة migrateDataImport جديدة لنقل بيانات التكلفة الحالية customDataSources.

الإيقاف النهائي لعمليات التحميل اليومية

• تم إيقاف مورد dailyUpload نهائيًا الآن. يمكنك الاطّلاع على دليل نقل البيانات للحصول على تفاصيل عن نقل البيانات لاستخدام ميزة استيراد البيانات.
• يُرجى العِلم أنّ المورد dailyUpload سيستمر في العمل لمدة ستة أشهر أخرى، وعند هذه المرحلة، سيتم تلقائيًا نقل أي customDataSources متبقٍ من خلال ضبط موقع uploadType على analytics#dailyUploads، ولن يعمل إلا مع مورد upload.
• على المستخدمين الحاليين لمورد dailyUpload تعديل رمزهم ونقل البيانات لاستخدام مورد "التحميل" في أقرب وقت ممكن.

هذا هو الإصدار الأولي من "واجهة برمجة التطبيقات لإدارة الحسابات":

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

يضيف هذا الإصدار واجهتَي برمجة تطبيقات جديدتَين للإعدادات.

روابط AdWords

• تسمح لك روابط AdWords في Management API بإنشاء روابط بين حسابات Google AdWords ومواقع "إحصاءات Google" وإدراجها والحصول عليها وتحديثها وتصحيحها وحذفها، وإدارة الملفات الشخصية (الملفات الشخصية) المرتبطة ببيانات AdWords.

  • دليل مطوِّري روابط AdWords
  • مرجع روابط AdWords API

فلاتر

• تسمح لك الفلاتر في Management API بإنشاء فلاتر لحسابك في "إحصاءات Google" وإدراجها في قائمة والحصول عليها وتحديثها وتصحيحها وحذفها. تتيح لك "روابط فلاتر الملف الشخصي" إنشاء روابط بين الفلاتر والملفات الشخصية (الملفات الشخصية) وإدراجها والحصول عليها وتحديثها وتصحيحها وحذفها.

  • دليل مطوِّري الفلاتر
  • مرجع Filters API
  • مرجع واجهة برمجة تطبيقات روابط فلاتر الملفات الشخصية

التقارير غير المستندة إلى عينات: Management API

تتم إضافة مورد جديد إلى Management API باسم التقارير غير المستندة إلى عينات. التقارير غير المستندة إلى عينات هي تقارير Google Analytics (GA) التي تم إنشاؤها باستخدام بيانات غير مستندة إلى عينات.لا تتوفّر التقارير غير المستندة إلى عينات في الوقت الحالي إلا لمستخدمي الإصدار Premium من "إحصاءات Google".

• اطّلِع على دليل المطوِّر.

الشرائح: Management API، الإصداران 2.4 و3.0

تم إجراء التغييرات التالية على مجموعة الشرائح:

• تتوفّر الآن شرائح المستخدِمين والتسلسل في واجهة برمجة التطبيقات.
• تعرض مجموعة الشرائح الآن جميع الشرائح المدمجة والمخصَّصة على مستوى الجلسة وعلى مستوى المستخدم.
• ستستخدم الآن السمة definition للشرائح بنية الشرائح الجديدة. ويشمل ذلك تعريفات الشرائح الحالية على مستوى الجلسة والتي سيتم تغييرها من definition: "" إلى definition: "sessions::condition::".
• تمت إضافة موقع type جديد إلى مورد الشريحة لتوضيح ما إذا كانت الشريحة CUSTOM (أي تم إنشاؤها من قِبل مستخدم في واجهة الويب) أو BUILT_IN (أي يتم توفيرها من خلال "إحصاءات Google").

التجارب

يمكن الآن استخدام مقاييس AdSense التالية كأهداف للتحسين:

• ga:adsenseAdsClicks: عدد مرّات النقر على إعلانات AdSense على موقعك الإلكتروني
• ga:adsenseAdsViewed — عدد إعلانات AdSense التي تمت مشاهدتها يمكن عرض إعلانات متعددة ضمن الوحدة الإعلانية.
• ga:adsenseRevenue — إجمالي الأرباح من إعلانات AdSense.

مجموعة جديدة لملخّصات الحسابات

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

تم إجراء التغييرات التالية على الشرائح التلقائية بسبب إيقاف السمتَين ga:isMobile وga:isTablet:

• تمت إعادة تسمية الشريحة gaid::-11 من زيارات الأجهزة الجوّالة إلى زيارات الأجهزة الجوّالة والأجهزة اللوحية. تم تغيير تعريف هذه الشريحة من ga:isMobile==Yes إلى ga:deviceCategory==mobile,ga:deviceCategory==tablet. تجدر الإشارة إلى أنّ ga:isMobile تضمّنت زيارات من الأجهزة اللوحية، وهو ما يظهر في التعريف الجديد. إذا كنت تريد فقط الزيارات الواردة من الأجهزة الجوّالة، باستثناء الأجهزة اللوحية، بدِّل إلى شريحة زيارات الأجهزة الجوّالة الجديدة (gaid::-14).
• تم تغيير تعريف الشريحة gaid::-13 من ga:isTablet==Yes إلى ga:deviceCategory==tablet. يظل هذا يمثل زيارات الأجهزة اللوحية.
• تمّت إضافة الشريحة "gaid::-14". اسم الشريحة هو زيارات الأجهزة الجوّالة والتعريف هو ga:deviceCategory==mobile.

إصلاحات الأخطاء:

• تم إصلاح معلومات المنطقة الزمنية للملفات الشخصية. التفاصيل: قبل هذا الإصلاح، وفي بعض الحالات التي كان يتم فيها إدراج الملف الشخصي (الملفات الشخصية) في Management API، تم عرض معلومات غير صحيحة عن المنطقة الزمنية لأحد الملفات الشخصية. أصبحت معلومات المنطقة الزمنية للملفات الشخصية الآن متسقة مع المعلومات التي تم ضبطها في واجهة مشرف "إحصاءات Google".

عمليات التحميل (توسيع البُعد)

• يتيح مورد عمليات التحميل الجديد تحميل بيانات توسيع البُعد. اطّلع على دليل مطوّر برامج استيراد البيانات (عمليات التحميل) لمزيد من التفاصيل.

يقدّم هذا الإصدار عمليات الكتابة لموارد الموقع الإلكتروني والملف الشخصي والهدف ومجموعة من 3 موارد جديدة تتيح إدارة أذونات المستخدمين.

واجهات برمجة التطبيقات لإعداد الحساب وإعداده

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

أذونات المستخدمين في Management API

• يتيح مورد accountUserLinks الجديد إدارة أذونات الحساب للمستخدمين.
• يتيح المورد الجديد webpropertyUserLinks إدارة أذونات الموقع للمستخدمين.
• يتيح المورد الجديد profileUserLinks إدارة أذونات الملف الشخصي للمستخدمين.
• تتوفر الآن أذونات المستخدم المصرّح له كجزء من موارد الحساب والموقع الإلكتروني والملف الشخصي (الملف الشخصي).
• تم توفير نطاق جديد وهو مطلوب لإدارة أذونات المستخدمين. https://www.googleapis.com/auth/analytics.manage.users.
• يُرجى الاطّلاع على دليل تطوير أذونات المستخدمين للحصول على تفاصيل إضافية.

كجزء من إطلاق الشرائح الجديدة، سنطرح التغييرات التالية على مجموعة الشرائح:

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

يضيف هذا الإصدار موقعَين جديدَين إلى مورد الموقع الإلكتروني:

• profileCount - يعرض عدد الملفات الشخصية لأحد المواقع. يسمح لك ذلك بفلترة الخصائص التي لا تحتوي على أي ملفات شخصية (أي profileCount = 0).
• industryVertical: تعرض قطاع/فئة الصناعة المحدَّدة لأحد المواقع.

إصلاحات الأخطاء:

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

• يتضمّن مورد الموقع الإلكتروني الآن السمة level للإشارة إلى ما إذا كان الموقع الإلكتروني هو PREMIUM أو STANDARD.

• تمت إضافة نقطة نهاية جديدة إلى الإصدار 3 من Management API للوصول إلى موارد التجارب وتعديلها.

• يشتمل مورد الملف الشخصي الآن على سمة type لتحديد ما إذا كان قد تم إعداد الملف الشخصي لموقع إلكتروني أو تطبيق. القيمتان المحتملتان هما: WEB أو APP.

يضيف هذا الإصدار ردودًا مفيدة عن الأخطاء إلى Management API.

• تمت إضافة رموز أخطاء وأسباب وأوصاف جديدة إلى نص استجابات أخطاء واجهة برمجة التطبيقات. تم توثيق جميع الرموز لكل من الإصدارَين - الإصدار 2.4 والإصدار 3.0 من Management API.

يضيف هذا الإصدار بيانات ويغيّر الوظائف الحالية ويصلح الأخطاء.

بيانات جديدة

• تحتوي مجموعة "الشرائح المتقدمة" الآن على الحقل segmentId الذي يمكن استخدامه في مَعلمة شريحة في واجهة برمجة التطبيقات لتصدير البيانات.

التغييرات

• تم تغيير نوع البيانات لـ "max-results" إلى "integer".

• تم تغيير القيمة التلقائية والحد الأقصى للسمة max-results إلى 1000.

إصلاح الأخطاء

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

يضيف هذا الإصدار إصدارين جديدين من واجهة برمجة التطبيقات مع العديد من الميزات الجديدة، ويوقِف الإصدار القديم نهائيًا. تؤثّر التغييرات في طريقة طلب البيانات من واجهة برمجة التطبيقات والتعامل معها.

الإصدار ‎‏‎3.0

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

• بيانات جديدة

  • التمثيل الكامل لأهداف الأحداث
  • رقم تعريف موقع إلكتروني داخلي يمكن استخدامه لإنشاء رابط لصفحة معيّنة في واجهة مستخدم "إحصاءات Google"
  • إعدادات الملف الشخصي لمَعلمات طلب البحث في الصفحات والمواقع الإلكترونية التلقائية

• التغييرات

  • سياسة حصص جديدة
  • الدمج مع وحدة تحكم Google APIs لإدارة الوصول إلى واجهة برمجة التطبيقات وطلب حصة أكبر
  • دعم OAuth 2.0 باعتباره الطريقة الجديدة المُوصى بها لتفويض المستخدمين
  • عنوان URL جديد لتقديم الطلبات: https://www.googleapis.com/analytics/v3/management/…
  • استجابة أضيق من واجهة برمجة التطبيقات باستخدام JSON
  • مكتبات برامج واجهة Google API الجديدة التي تتوافق مع العديد من اللغات الإضافية
  • دعم Google Discovery API

الإصدار 2.4

• هذه ترقية ثانوية للإصدار المتوافق في الغالب مع الإصدارات القديمة 2.3.

• التغييرات

  • سياسة حصص جديدة
  • الدمج مع وحدة تحكم Google APIs لإدارة الوصول إلى واجهة برمجة التطبيقات وطلب حصة أكبر
  • استمرار الدعم لآليات التفويض الحالية وOAuth 2.0
  • عنوان URL جديد لتقديم الطلبات: https://www.googleapis.com/analytics/v2.4/management/…
  • الردود بتنسيق XML فقط
  • لا يتوفّر دعم لمكتبة برامج JavaScript للبيانات من Google
  • يكون إخراج XML متوافقًا مع الإصدار 2.3، لذا ستستمر مكتبات برامج بيانات Google الحالية الأخرى في العمل.

إيقاف

• نعلن عن إيقاف الإصدار 2.3 القديم من Management API. وستستمر هذه الميزة في العمل لمدة شهرين، وبعد ذلك سيتم عرض استجابة من خلال الإصدار 2.4 عند انتهاء كل طلبات الإصدار 2.3.

هذا هو الإصدار التجريبي من Google Analytics Management API.

الخلاصات الجديدة

• تم إنشاء خمس خلاصات جديدة لتسهيل الوصول إلى بيانات إعداد حساب "إحصاءات Google":

  • خلاصة الحساب
  • خلاصة الموقع الإلكتروني
  • خلاصة الملف الشخصي
  • خلاصة الأهداف
  • خلاصة الشرائح المتقدمة

مكتبات العملاء المحدّثة

• سيتمّ إصدار واجهة برمجة التطبيقات Management API في المكتبة نفسها التي تتوفّر فيها واجهة برمجة التطبيقات Management API في "إحصاءات Google". تم تعديل كلّ من مكتبتَي JavaScript Data Java وJavaScript. يمكن الوصول إلى كل خلاصة من خلال تحديد معرّف الموارد المنتظم (URI) المناسب للخلاصة بطريقة getManagementFeed() في المكتبات.

وثائق جديدة

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