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

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

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

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

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

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

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

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

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

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

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

تمت إضافة طرق GetSKAdNetworkConversionValueSchema وCreateSKAdNetworkConversionValueSchema وDeleteSKAdNetworkConversionValueSchema UpdateSKAdNetworkConversionValueSchema وListSKAdNetworkConversionValueSchemas إلى الإصدار 1alpha من Admin API.

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

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

تمت إضافة طريقة UpdateConversionEvent إلى الإصدار 1تجريبي من Admin API.

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

تمت إعادة تسمية الحقل enterprise_export_enabled في المورد BigQueryLink إلى fresh_daily_export_enabled.

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

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

ستتم إعادة تسمية أعضاء التعداد ReportingAttributionModel على النحو التالي:

الاسم القديم	الاسم الجديد
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 على النحو التالي:

الاسم القديم	الاسم الجديد
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.

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

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

راجِع إعلان المنتج في "إحصاءات Google" للحصول على مزيد من المعلومات.

31-05-2023 تمت إضافة طُرق إدارة روابط AdSense.

تمت إضافة طرق GetAdSenseLink وCreateAdSenseLink وDeleteAdSenseLink ListAdSenseLinks إلى الإصدار 1alpha من Admin API.

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

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

تمت إضافة طريقة FetchConnectedGa4Property إلى Admin API v1alpha

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

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

تمت إضافة طرق CreateEventCreateRule وUpdateEventCreateRule وDeleteEventCreateRule وListEventCreateRules وGetEventCreateRule إلى الإصدار 1alpha من Admin API.

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

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

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

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

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

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

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

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

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

تمت إضافة طرق properties.createConnectedSiteTag وproperties.deleteConnectedSiteTag وproperties.listConnectedSiteTags إلى الإصدار 1alpha من Admin API.

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

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

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

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

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

2024-02-2023 تحلّ روابط الوصول محل روابط المستخدمين لإدارة أذونات المستخدمين.

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

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

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

ستتم إزالة وظيفة روابط المستخدمين من الإصدار الأول من واجهة برمجة تطبيقات المشرف في 1/6/23

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

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

• accounts.userLinks.audit
• properties.userLinks.audit

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

تمّت إضافة المورد 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" المبرمَجة لأحد مواقع Universal Analytics.

15-02-2023 تمت إضافة طرق إدارة روابط BigQuery.

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

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

15-02-2023 تمت إضافة طرق إدارة روابط "إعلانات شبكة البحث 360".

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

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

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

• LESS_THAN_OR_EQUAL، تمت إزالة قيم GREATER_THAN_OR_EQUAL من التعداد NumericFilter.Operation.

• تمت إزالة قيمة PARTIAL_REGEXP من التعداد StringFilter.MatchType.

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

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

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

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

11-07-2022 تم إطلاق الإصدار 1 التجريبي من واجهة برمجة التطبيقات Admin API.

تم إطلاق الإصدار التجريبي من Google Analytics Admin API.

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

2021-10-12 تمت إزالة طُرق Optimize Settings (إعدادات القياس المحسّنة) من واجهة برمجة التطبيقات.

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

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

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

• accounts.searchChangeHistoryEvents إلى واجهة برمجة التطبيقات. تبحث هذه الطريقة في جميع التغييرات التي يتم إجراؤها على حساب أو عناصره الثانوية وفقًا لمجموعة محددة من الفلاتر. قد تتمثّل الأسباب الشائعة في التعديلات التي يتم إجراؤها في واجهة مستخدم "إحصاءات Google"، أو التغييرات من فريق دعم العملاء، أو التغييرات التلقائية في نظام "إحصاءات Google".
• طرق إدارة أسرار Measurement Protocol التي تمت إضافتها ضمن properties.webDataStreams.measurementProtocolSecrets:
  • create تنشئ واجهة Measurement Protocol سرّية.
  • delete يحذف بروتوكول Measurement Protocol السرّي.
  • get ابحث عن مفتاح سر واحد لبروتوكول القياس.
  • list عرض أسرار بروتوكول القياس الثانوي ضمن الموقع الرئيسي المحدّد.
  • 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 مخرجات فقط.

2021-01-28 تمت إضافة دعم التقسيم على صفحات لعملية ListFirebaseLinks.

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

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

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

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

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

20-10-2020 تمت إضافة معلومات عن ملخّصات الحسابات.

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

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

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

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