سجلّ التغييرات

للحصول على إعلانات واجهة برمجة تطبيقات "إحصاءات Google" الرسمية، يُرجى الاشتراك في مجموعة إشعارات Google Analytics API.

2024-09-09 نموذج الاستطلاع الخاص بتقارير "الوصول إلى التقارير"

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

تمت إضافة CreateBigQueryLink وUpdateBigQueryLink وDeleteBigQueryLink. طرق إدارة BigQueryLink من الموارد ذات الإصدار الأول من واجهة برمجة تطبيقات المشرف.

تمت إضافة الحقل dataset_location إلى المورد BigQueryLink.

تمت إضافة التغييرات على روابط BigQuery إلى سجلّ التغييرات ضمن BIGQUERY_LINK الجديدة. قيمة في ChangeHistoryResourceType

2024-08-01 تغيير جذري في طريقة createSubproperty

تمت إعادة تسمية طريقة createSubproperty المخصّصة إلى provisionSubproperty في الإصدار 1 من واجهة برمجة تطبيقات المشرف للتوافق مع الطريقة المخصصة والإرشادات.

2024-08-01 تمت إضافة إدارة قاعدة تعديل الحدث

GetEventEditRule، CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, المضافة إلى الإصدار الأول من واجهة برمجة تطبيقات المشرف.

تحدّد السمة EventEditRule الشروط التي ستؤدي إلى إنشاء حدث جديد تمامًا استنادًا إلى معايير مطابقة لحدث مصدر. بالإضافة إلى ذلك، يمكن لـ EventEditRule تحديد تعديلات المعلَمات من المصدر فعالية.

2024-08-01 تغييرات متنوعة

تمت إضافة create_time إلى Audience المرجع.

تمت إضافة primary إلى ChannelGroup من الموارد يمكنك الإشارة إلى ما إذا كانت مجموعة القنوات هي مجموعة القنوات التلقائية للتقارير. واحد فقط يمكن أن تضبط مجموعة القنوات السمة primary على "true" في أي وقت. الإعداد يتم ضبط السمة primary تلقائيًا على "false" من خلال ضبط قيمة primary على "true" لمجموعة قنوات. لمجموعة القنوات الأساسية السابقة

تمت إضافة gmp_organization إلى Account. يحتوي على معرّف الموارد المنتظم (URI) لمؤسسة "منصة Google للتسويق" إذا كان الحساب مرتبطًا بمؤسسة في "منصة Google للتسويق".

2024-05-06 إضافة طُرق لإدارة الأحداث الرئيسية

الموارد وطرق المفتاح الأحداث متاحة الآن.

تعديل عملية دمج واجهة برمجة التطبيقات لاستخدامها KeyEvent بدلاً من ConversionEvent تم إيقاف ConversionEvent نهائيًا.

15-12-2023 تتوفّر الآن تقارير الوصول إلى البيانات لجميع مواقع "إحصاءات Google".

حقول معيّنة من ميزة تقارير الوصول إلى البيانات متاحة الآن لجميع مواقع "إحصاءات Google"، كلاهما و"إحصاءات Google 360"

راجِع مستندات المخطَّطات للحصول على مزيد من المعلومات.

15-12-2023 السمة accessDateHour التي تمت إضافتها إلى مخطط تقارير الوصول إلى البيانات.

السمة accessDateHour المُضافة إلى السمة مخطّط تقرير الوصول إلى البيانات يحتوي على تاريخ الساعة لمستخدم "إحصاءات Google" الذي وصل إلى بيانات إعداد تقارير "إحصاءات Google".

05-10-2023 يتم ضبط المواقع التي تتضمّن نماذج تحديد المصدر الخطية وتلك المستندة إلى النقرة الأولى وإلى تناقص الوقت وإلى الموضع تلقائيًا على تحديد المصدر بالاستناد إلى البيانات على جميع القنوات.

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

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

2023-09-01 تمت إضافة طرق إعداد مخطّط قيمة الإحالة الناجحة في SKAdNetwork.

GetSKAdNetworkConversionValueSchema، CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas المضافة إلى الإصدار الأول من واجهة برمجة تطبيقات المشرف.

تتيح هذه الوظيفة إدارة مخطّط قيمة الإحالة الناجحة في SKAdNetwork. الإعدادات بالنسبة إلى مصدر بيانات iOS

2023-09-01 تمت إضافة طريقة UpdateConversionEvent.

UpdateConversionEvent تمت إضافتها إلى الإصدار التجريبي من Admin API.

01-09-2023 تمت إعادة تسمية حقل BigQueryLink.enterprise_export_enabled إلى fresh_daily_export_enabled.

الحقل enterprise_export_enabled للمورد BigQueryLink الذي تمت إعادة تسميته fresh_daily_export_enabled

14-07-2023 تغييرات غير مكتملة على properties.updateAttributionSettings، properties.getAttributionSettings طريقة

اعتبارًا من 24 تموز (يوليو) 2023، سيتم إجراء تغييرات تؤدي إلى أعطال في الإصدار 1 من Admin API. ألفا والذي سيؤثر في وظائف properties.getAttributionSettings, properties.updateAttributionSettings الطرق.

المشتركون في لعبة ReportingAttributionModel ستتم إعادة تسمية enum على النحو التالي:

الاسم القديم اسم جديد
CROSS_CHANNEL_DATA_DRIVEN PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN
CROSS_CHANNEL_LAST_CLICK PAID_AND_ORGANIC_CHANNELS_LAST_CLICK
CROSS_CHANNEL_FIRST_CLICK PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK
CROSS_CHANNEL_LINEAR PAID_AND_ORGANIC_CHANNELS_LINEAR
CROSS_CHANNEL_POSITION_BASED PAID_AND_ORGANIC_CHANNELS_POSITION_BASED
CROSS_CHANNEL_TIME_DECAY PAID_AND_ORGANIC_CHANNELS_TIME_DECAY
ADS_PREFERRED_LAST_CLICK GOOGLE_PAID_CHANNELS_LAST_CLICK

المشتركون في لعبة AdsWebConversionDataExportScope ستتم إعادة تسمية enum على النحو التالي:

الاسم القديم اسم جديد
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

2023-07-10 تمت إضافة الحقل ads_web_conversion_data_export_scope إلى النوع AttributionSettings.

تمت إضافة الحقل ads_web_conversion_data_export_scope إلى النوع AttributionSettings الذي يمكن تعديله باستخدام UpdateAttributionSettings .

05/06/2023 سيتم إيقاف نماذج تحديد المصدر الخطية وتلك المستندة إلى النقرة الأولى وإلى تناقص الوقت وإلى الموضع.

اعتبارًا من حزيران (يونيو) 2023، سيتم تغيير UpdateAttributionSettings لإعداد مواقع "إحصاءات Google 4" باستخدام النقرة الأولى، خطي، تناقص الوقت والاستناد إلى الموضع نماذج تحديد المصدر بدءًا من أيلول (سبتمبر) 2023، ستصبح هذه النماذج غير متاح لجميع المواقع.

يُرجى الاطّلاع على الإشعار عن منتج "إحصاءات Google". لمزيد من المعلومات.

GetAdSenseLink، CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks المضافة إلى الإصدار الأول من واجهة برمجة تطبيقات المشرف.

تتيح هذه الوظيفة إدارة روابط AdSense إلى "إحصاءات Google". لأحد مواقع "إحصاءات Google 4"

31-05-2023 تمّت إضافة طريقة للبحث عن موقع مرتبط على "إحصاءات Google 4".

FetchConnectedGa4Property تمت إضافة الطريقة إلى الإصدار 1alpha من Admin API

تسمح هذه الوظيفة بالحصول على معلومات حول ربط موقع "إحصاءات Google 4" موقعك على Universal Analytics أثناء عملية نقل البيانات إلى "إحصاءات Google 4"

31-05-2023 تمت إضافة طريقة لإدارة قواعد إنشاء الأحداث.

CreateEventCreateRule، UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, تمت إضافة GetEventCreateRule طريقة إلى الإصدار الأول من واجهة برمجة تطبيقات المشرف.

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

31-05-2023 تمّت إضافة طُرق لإدارة مجموعات القنوات المخصّصة.

تمت إضافة GetChannelGroup، ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup إلى الإصدار 1alpha من Admin API.

تسمح هذه الوظيفة بإدارة مجموعات القنوات المخصَّصة لمصادر الزيارات إلى موقعك الإلكتروني

بعد إنشائها، يمكن البحث عن مجموعات القنوات المخصّصة باستخدام الإصدار 1 من Google Analytics Data API.

31/03/2023 تمت إضافة طرق إدارة "إعدادات القياس" المحسَّنة.

تمت إضافة الطريقتَين properties.dataStreams.updateEnhancedMeasurementSettings وproperties.dataStreams.getEnhancedMeasurementSettings إلى الإصدار الأول من واجهة برمجة تطبيقات المشرف.

تتيح هذه الوظيفة إدارة إعدادات القياس المحسَّن لمصدر بيانات الموقع الإلكتروني لأحد المواقع على "إحصاءات Google 4".

31-03-2023 تمت إضافة طرق إدارة علامة المواقع الإلكترونية المرتبطة.

تمت إضافة طرق properties.createConnectedSiteTag وproperties.deleteConnectedSiteTag وproperties.listConnectedSiteTags إلى الإصدار الأول من واجهة برمجة تطبيقات المشرف.

تتيح هذه الوظيفة إدارة علامات المواقع الإلكترونية المرتبطة وهي مفيدة لإعادة توجيه الزيارات من موقع على Universal Analytics إلى موقع على "إحصاءات Google 4".

31-03-2023 تمت إضافة طرق runAccessReport على مستوى الحساب والموقع إلى الإصدار التجريبي من Admin API.

تمّت إضافة الطريقتَين properties.runAccessReport وaccounts.runAccessReport إلى الإصدار v1beta من Admin API. تُرجع الطرق تقريرًا مخصصًا لسجلات الوصول إلى البيانات.

2023-02-24 تمت إضافة طرق إدارة مجموعات البيانات الموسّعة.

ExpandedDataSet تمت إضافة المورد إلى إصدار v1alpha واجهة برمجة التطبيقات، إلى جانب properties.expandedDataSets.create المقابل، properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list، properties.expandedDataSets.get العمليات التجارية. يمكن استخدام هذه الوظيفة لإدارة مجموعات البيانات الموسّعة في "إحصاءات Google 360".

AccessBinding تمت إضافة المورد إلى إصدار v1alpha واجهة برمجة التطبيقات، إلى جانب العمليات التالية:

وتتيح هذه الوظيفة إدارة أذونات المستخدِمين لحساب "إحصاءات Google 4" أو ويجب استخدامها بدلاً من روابط المستخدمين.

ستتم إزالة وظائف روابط المستخدمين. من الإصدار الأول من Admin API في 1/6/23

24-02-2023 سيتم إيقاف طرق تدقيق أذونات المستخدمين نهائيًا.

تم إيقاف الطرق التالية نهائيًا وستتم إزالتها من الإصدار 1 من Admin API ألفا في 6/1/23:

2023-02-24 تمت إضافة طرق إدارة الجمهور.

Audience تمت إضافة المورد إلى إصدار v1alpha واجهة برمجة التطبيقات، إلى جانب properties.audience.create المقابل، properties.audience.archive, properties.audience.patch, properties.audience.list، properties.audience.get العمليات التجارية.

تتيح هذه الوظيفة إدارة شرائح الجمهور لموقع "إحصاءات Google 4".

15-02-2023 تمت إضافة طرق لإيقاف عملية إعداد "إحصاءات Google 4" المبرمَجة.

properties.setAutomatedGa4ConfigurationOptOut، تمت إضافة عمليات properties.fetchAutomatedGa4ConfigurationOptOut إلى إصدار v1alpha من واجهة برمجة التطبيقات.

تتيح هذه الوظيفة إدارة حالة الإيقاف لخدمة "إحصاءات Google 4" المبرمَجة. عملية الإعداد لموقع UA.

BigQueryLink تمت إضافة المورد إلى إصدار v1alpha واجهة برمجة التطبيقات، إلى جانب properties.bigQueryLinks.get المقابلة، properties.bigQueryLinks.list العمليات التجارية.

تتيح هذه الوظيفة استرداد المعلومات حول الروابط بين موقع على "إحصاءات Google 4" ومشروع على BigQuery.

SearchAds360Link تمت إضافة المورد إلى إصدار v1alpha واجهة برمجة التطبيقات، إلى جانب properties.searchAds360Links.create المقابل، properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list، properties.searchAds360Links.get العمليات التجارية.

وتتيح هذه الوظيفة إدارة الروابط بين موقع على "إحصاءات Google 4" كيان في "إعلانات شبكة البحث 360".

15-02-2023 تغييرات قد تؤدي إلى أعطال.

15/02/2023 تغييرات متنوعة:

  • تمت إضافة حقل tokensPerProjectPerHour إلى AccessQuota. الكتابة.
  • قيم EXPANDED_DATA_SET وCHANNEL_GROUP التي تمت إضافتها إلى ChangeHistoryResourceType التعداد
  • تمت إضافة قيم searchAds360Link وexpandedDataSet وbigqueryLink إلى ChangeHistoryResource.

11-08-2022 تمت إضافة طريقة runAccessReport إلى الإصدار 1ألفا من واجهة برمجة التطبيقات Admin API.

properties.runAccessReport إلى إصدار v1alpha من Admin API. تُرجع المخصص لسجلات الوصول إلى البيانات. ويقدم التقرير سجلات لكل منها الوقت الذي يقرأ فيه المستخدِم بيانات إعداد التقارير في "إحصاءات Google" تقارير الوصول إلى البيانات متاحة لمشرفي مواقع "إحصاءات Google 360".

11-07-2022 تم طرح الإصدار التجريبي من Admin API v1.

الإصدار التجريبي من v1 تم إطلاق واجهة برمجة التطبيقات Admin API في "إحصاءات Google".

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

2021-10-12 تمت إزالة طرق AdvancedMeasurementSettings من واجهة برمجة التطبيقات.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings طريقة تتم إزالته من واجهة برمجة التطبيقات، ولكن يجب إجراء القياس المحسّن قابلة للتعديل مرة أخرى عبر واجهة برمجة التطبيقات قريبًا.
  • الحقل directRoles في UserLink لم يعد المورد يتيح استخدام الدور predefinedRoles/manage-users. يجب استخدام دور predefinedRoles/admin الجديد بدلاً من ذلك، وهو يعادل تركيبة predefinedRoles/edit القديمة predefinedRoles/manage-users دور. يؤثر هذا التغيير في سلوك accounts.userLinks، properties.userLinks وتتوافق مع إدارة أذونات الوصول والقيود المفروضة على البيانات التغييرات التي تم إدخالها في Google Analytics.

2021-06-05 تمّت إضافة الميزات.

وتتم إضافة الميزات التالية إلى واجهة برمجة التطبيقات:

  • accounts.searchChangeHistoryEvents إلى واجهة برمجة التطبيقات. تبحث هذه الطريقة عبر جميع التغييرات في الحساب أو عناصره الفرعية وفقًا لمجموعة الفلاتر المحددة. الأسباب الشائعة هي التحديثات التي أجريت في واجهة مستخدم "إحصاءات Google" والتغييرات من أو تغييرات تلقائية في نظام "إحصاءات Google"
  • تمت إضافة طرق إدارة أسرار Measurement Protocol ضمن properties.webDataStreams.measurementProtocolSecrets:
    • create تُنشئ سر Measurement Protocol.
    • delete يؤدي هذا الإجراء إلى حذف المفتاح السرّي لـ "بروتوكول القياس المستهدف".
    • get ابحث عن بروتوكول سرّي واحد للقياس.
    • list عرض أسرار Measurement Protocol التابعة ضمن الموقع الرئيسي المحدّد
    • patch تعدّل أحد المفاتيح السرّية في Measurement Protocol.
  • تمت إضافة طرق إدارة أحداث الإحالات الناجحة ضمن properties.conversionEvents:
    • create يتم إنشاء حدث إحالة ناجحة باستخدام السمات المحدّدة.
    • delete حذف حدث إحالة ناجحة في أحد المواقع.
    • get استرِد حدث إحالة ناجحة واحدًا.
    • list عرض قائمة بأحداث الإحالات الناجحة في الموقع الرئيسي المحدّد
  • تمت إضافة طرق إدارة السمات المخصّصة ضمن properties.customDimensions:
    • archive أرشفة سمة مخصّصة على أحد المواقع
    • create تُنشئ سمة مخصّصة.
    • get ابحث عن سمة مخصّصة واحدة.
    • list يسرد السمات المخصّصة في أحد المواقع.
    • patch يعدِّل سمة مخصّصة في أحد المواقع.
  • طرق إدارة المقاييس المخصّصة التي تمت إضافتها ضمن properties.customMetrics:
    • archive أرشفة مقياس مخصَّص على أحد المواقع
    • create تُنشئ مقياسًا مخصّصًا.
    • get ابحث عن مقياس مخصّص واحد.
    • list يسرد المقاييس المخصّصة في أحد المواقع.
    • patch يعدِّل مقياس مخصَّص على أحد المواقع.
  • تمت إضافة properties.getGoogleSignalsSettings، properties.updateGoogleSignalsSettings الطرق التي تسمح بالتحكّم في إشارات Google الإعداد لموقع على "إحصاءات Google 4".
  • delete_time، expire_time تمت إضافة حقول إخراج فقط إلى Property الكتابة.

2021-06-05 تغييرات قد تؤثّر في التغييرات

تم إدخال التغييرات التالية التي قد تؤدي إلى أعطال:

  • "properties.iosAppDataStreams.create" و"properties.androidAppDataStreams.create" من واجهة برمجة التطبيقات. يُرجى استخدام Firebase لإنشاء تطبيق مصادر البيانات في موقع "إحصاءات Google 4".
  • properties.delete تُرجع الآن بيانات الموقع المحذوفة على أنها Property الكتابة بدلاً من عرض استجابة فارغة.
  • time_zone الحقل في Property النوع مطلوب الآن.
  • تمت إزالة الحقل deleted من Property. الكتابة.
  • email_address الحقل في UserLink النوع غير قابل للتغيير الآن.
  • name الحقل في UserLink النوع هو الآن إخراج فقط.

28-01-2021 تغييرات قد تؤدي إلى أعطال.

التغييرات التي قد تؤدي إلى أعطال: - يجب ملء حقل update_mask لجميع عمليات التحديث.

  • تمت إعادة تسمية حقل "country_code" إلى region_code في Account.

  • تمت إعادة تسمية حقل "url_query_parameter" إلى uri_query_parameter في EnhancedMeasurementSettings.

  • تمت إزالة حقل parent من GoogleAdsLink.

2020-10-20 أُتيحت ملخّصات الحسابات.

تمت إضافة دعم لطريقة ملخّصات الحسابات.

2020-10-13 تمت إعادة تسمية التطبيقات + المواقع الإلكترونية إلى "إحصاءات Google 4".

2020-08-15 تمت إعادة تسمية واجهة برمجة التطبيقات لإدارة التطبيقات + المواقع الإلكترونية إلى Admin API.

تمت إعادة تسمية واجهة برمجة تطبيقات إدارة التطبيقات + المواقع الإلكترونية في "إحصاءات Google" إلى واجهة برمجة التطبيقات Admin API في "إحصاءات Google" ونتيجةً لذلك، تغيّرت نقطة نهاية واجهة برمجة التطبيقات إلى analyticsadmin.googleapis.com. الرمز الحالي مكتوب وفقًا للإصدار السابق يجب تحديث عنوان URL لنقطة نهاية واجهة برمجة التطبيقات ومكتبات العملاء وفقًا لذلك.