للاطّلاع على الإشعارات الرسمية بشأن Google Analytics API، يُرجى الاشتراك في مجموعة الإشعارات بشأن Google Analytics API.
2025-01-20 تمت إضافة الاحتفاظ ببيانات المستخدمين إلى DataRetentionSettings
تمت إضافة الحقل userDataRetention
إلى
DataRetentionSettings
في
Admin API الإصدارَين 1alpha و1beta. استخدِم هذا الحقل لاسترداد إعدادات الاحتفاظ
ببيانات المستخدمين أو تعديلها.
2024-09-09 نموذج استطلاع حول "تقارير الوصول"
تم تعديل مستندات الطريقة
runAccessReport
لتشمل رابطًا يؤدي إلى نموذج
ملاحظات حول الوصول إلى تقارير "إحصاءات Google". نحن نقدّر ملاحظاتك ونشجّعك على مشاركة أفكارك حول واجهة برمجة التطبيقات هذه لمساعدتنا في تحسينها بشكل أكبر.
01-08-2024 تمت إضافة إدارة روابط BigQuery
تمت إضافة CreateBigQueryLink
وUpdateBigQueryLink
وDeleteBigQueryLink
طُرق لإدارة موارد
BigQueryLink
باستخدام
الإصدار الأول من Admin API.
تمت إضافة حقل dataset_location
إلى المورد BigQueryLink
.
تمت إضافة تغييرات رابط BigQuery إلى سجلّ التغييرات ضمن القيمة الجديدة BIGQUERY_LINK
في
ChangeHistoryResourceType
.
01-08-2024 تغيير قد يؤدي إلى عطل في طريقة createSubproperty
تمت إعادة تسمية الطريقة المخصّصة createSubproperty
إلى
provisionSubproperty
في الإصدار 1alpha من Admin API بما يتوافق مع إرشادات
الطريقة المخصّصة.
01-08-2024 تمت إضافة إدارة قاعدة تعديل الحدث
GetEventEditRule
،
CreateEventEditRule
،
DeleteEventEditRule
،
ListEventEditRules
،
UpdateEventEditRules
،
ReorderEventEditRules
،
الطرق التي تمت إضافتها إلى الإصدار 1 من Admin API
يحدِّد EventEditRule
الشروط التي ستؤدي إلى إنشاء
حدث جديد تمامًا استنادًا إلى المعايير المطابقة لحدث مصدر. بالإضافة إلى ذلك، يمكن لEventEditRule
تحديد تعديلات على المَعلمات من حدث المصدر.
01-08-2024 تغييرات متنوعة
تمت إضافة create_time
إلى المورد
Audience
.
تمت إضافة primary
إلى موارد
ChannelGroup
لتحديد ما إذا كانت مجموعة القنوات هي مجموعة القنوات التلقائية للتقارير. يمكن أن يكون primary
مضبوطًا على true
في مجموعة قناة واحدة فقط في أي وقت. يؤدي ضبط
primary
على true
لمجموعة قنوات إلى ضبط primary
على false
تلقائيًا لمجموعة القنوات الأساسية السابقة.
تمت إضافة gmp_organization
إلى مورد Account
الذي يحتوي على عنوان URL لمورد مؤسسة على "منصّة Google للتسويق"
إذا كان الحساب مرتبطًا بمؤسسة على "منصّة Google للتسويق".
06-05-2024 تمت إضافة طرق إدارة الأحداث الرئيسية
تتوفّر الآن مراجع وأساليب للأحداث المهمة.
عدِّل عملية دمج واجهة برمجة التطبيقات لاستخدام
KeyEvent
بدلاً من
ConversionEvent
.
تم إيقاف ConversionEvent
نهائيًا.
15-12-2023 تتوفّر الآن تقارير الوصول إلى البيانات لجميع مواقع "إحصاءات Google".
أصبحت الآن حقول معيّنة من ميزة تقارير الوصول إلى البيانات متوفرة لجميع مواقع "إحصاءات Google"، سواءً عملاء الإصدار العادي أو عملاء "إحصاءات Google 360".
اطّلِع على مستندات المخطط للحصول على مزيد من المعلومات.
15-12-2023 تمّت إضافة سمة accessDateHour
إلى مخطّط تقرير "الوصول إلى البيانات".
سمة accessDateHour
التي تمت إضافتها إلى
مخطّط تقرير "الوصول إلى البيانات" يحتوي على تاريخ ووقت وصول مستخدِم "إحصاءات Google" إلى بيانات التقارير في هذه الخدمة.
05-10-2023 المواقع التي تستخدم نماذج تحديد المصدر المستنِدة إلى النقرة الأولى والمساواة بين نقاط الاتّصال وتوقيت نقاط الاتّصال وموضع نقاط الاتّصال تستخدم تلقائيًا نموذج تحديد المصدر بالاستناد إلى البيانات على جميع القنوات.
اعتبارًا من منتصف تشرين الأول (أكتوبر) 2023، لن تعود نماذج تحديد المصدر المستنِدة إلى النقرة الأولى المساواة بين نقاط الاتصال تناقص الوقت وموضع نقاط الاتصال متوفّرة للاستخدام مع الطريقة UpdateAttributionSettings في جميع المواقع.
إذا كان موقعك الإلكتروني مُعدًّا حاليًا لاستخدام أحد هذه النماذج، سيتم تغييره إلى تحديد المصدر بالاستناد إلى البيانات على جميع القنوات. وسيظل بإمكانك استخدام خيارَي "النقرة الأخيرة على جميع القنوات" أو "النقرة الأخيرة المفضّلة في إعلانات Google" بدلاً من ذلك.
01-09-2023 تمت إضافة طرق ضبط مخطّط قيمة الإحالة الناجحة في SKAdNetwork.
GetSKAdNetworkConversionValueSchema
،
CreateSKAdNetworkConversionValueSchema
،
DeleteSKAdNetworkConversionValueSchema
،
UpdateSKAdNetworkConversionValueSchema
،
ListSKAdNetworkConversionValueSchemas
الإجراءات التي تمت إضافتها إلى الإصدار 1 من Admin API
تتيح هذه الوظيفة إدارة إعدادات مخطّط قيمة الإحالة الناجحة في SKAdNetwork لبثّ iOS.
01-09-2023 تمت إضافة طريقة UpdateConversionEvent
.
تمت إضافة طريقة UpdateConversionEvent
إلى الإصدار التجريبي من Admin API 1.
تمت إعادة تسمية حقل BigQueryLink.enterprise_export_enabled
في 2023-09-01 إلى fresh_daily_export_enabled
.
تمت إعادة تسمية الحقل enterprise_export_enabled
لمورد BigQueryLink
إلى
fresh_daily_export_enabled
.
14-07-2023 تغييرات قد تؤدي إلى حدوث أعطال في الطريقتَين properties.updateAttributionSettings
وproperties.getAttributionSettings
اعتبارًا من 24 تموز (يوليو) 2023، سيتم إجراء تغييرات جذرية على الإصدار العلني من Admin API 1 الذي سيؤثّر في وظائف 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" لمزيد من المعلومات.
31 أيار (مايو) 2023: تمت إضافة طرق إدارة روابط AdSense.
GetAdSenseLink
،
CreateAdSenseLink
،
DeleteAdSenseLink
،
ListAdSenseLinks
methods added to the Admin API v1alpha.
تتيح هذه الوظيفة إدارة الروابط بين AdSense و"إحصاءات Google" لموقع على "إحصاءات Google 4".
31/05/2023 تمت إضافة طريقة للبحث عن موقع "إحصاءات Google 4" مرتبط.
تمت إضافة طريقة FetchConnectedGa4Property
إلى الإصدار الأولي من Admin API.
تتيح هذه الوظيفة الحصول على معلومات عن موقع على "إحصاءات Google 4" مرتبط بموقعك على Universal Analytics أثناء عملية نقل البيانات إلى "إحصاءات Google 4".
31-05-2023 تمت إضافة طريقة لإدارة قواعد إنشاء الأحداث.
تمّت إضافة طُرق CreateEventCreateRule
،
UpdateEventCreateRule
،
DeleteEventCreateRule
،
ListEventCreateRules
،
GetEventCreateRule
إلى الإصدار 1alpha من Admin API.
تتيح هذه الوظيفة إدارة قواعد إنشاء الأحداث التي يمكن أن تؤدي إلى إنشاء حدث جديد تمامًا استنادًا إلى معايير مطابقة لحدث مصدر.
31 أيار (مايو) 2023: تمت إضافة طرق لإدارة مجموعات القنوات المخصّصة.
تمت إضافة طُرق GetChannelGroup
،
ListChannelGroups
،
CreateChannelGroup
،
UpdateChannelGroup
،
DeleteChannelGroup
إلى الإصدار 1alpha من Admin API.
تتيح هذه الوظيفة إدارة مجموعات قنوات مخصّصة لمصادر الزيارات إلى موقعك الإلكتروني.
بعد إنشاء مجموعات القنوات المخصّصة، يمكن طلبها باستخدام الإصدار 1 من Google Analytics Data API.
31 آذار (مارس) 2023: تمت إضافة طرق إدارة إعدادات "القياس المحسَّن".
تمّت إضافة الطريقتَين properties.dataStreams.updateEnhancedMeasurementSettings
وproperties.dataStreams.getEnhancedMeasurementSettings
إلى الإصدار 1alpha من Admin API.
تسمح هذه الوظيفة بإدارة إعدادات القياس المحسّن لمصدر بيانات موقع إلكتروني لأحد المواقع على "إحصاءات Google 4".
31 آذار (مارس) 2023: تمت إضافة طرق إدارة "علامة الموقع الإلكتروني المرتبطة".
تمّت إضافة طُرق properties.createConnectedSiteTag
وproperties.deleteConnectedSiteTag
وproperties.listConnectedSiteTags
إلى الإصدار 1alpha من Admin API.
تتيح هذه الوظيفة إدارة علامات المواقع الإلكترونية المرتبطة، وهي مفيدة لإعادة توجيه الزيارات من موقع على Universal Analytics إلى موقع على "إحصاءات Google 4".
31 آذار (مارس) 2023: تمت إضافة طرق runAccessReport
على مستوى الحساب والموقع إلى الإصدار التجريبي من Admin API 1.
تمّت إضافة الطريقتَين 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".
2023-02-24 ستحلّ عمليات ربط أذونات الوصول محلّ روابط المستخدمين لإدارة أذونات المستخدمين.
تمت إضافة المورد 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" أو موقعه، ويجب استخدامها بدلاً من روابط المستخدمين.
سيتمّ إيقاف وظائف روابط المستخدمين نهائيًا من الإصدار التجريبي من Admin API 1 في 1/6/23.
2023-02-24 إيقاف طُرق تدقيق أذونات المستخدمين نهائيًا
تم إيقاف الأساليب التالية نهائيًا وسيتمّت إزالتها من Admin API v1 alpha في 1/6/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" الآلي لحساب Universal Analytics.
2023-02-15 تمت إضافة طرق إدارة روابط BigQuery.
تمت إضافة مورد BigQueryLink
إلى الإصدار v1alpha من واجهة برمجة التطبيقات، إلى جانب عمليات properties.bigQueryLinks.get
،
properties.bigQueryLinks.list
المقابلة.
تتيح هذه الوظيفة استرداد معلومات عن الروابط بين موقع على "إحصاءات Google 4" ومشروع على BigQuery.
15 شباط (فبراير) 2023: تمت إضافة طرق إدارة روابط "إعلانات شبكة البحث 360".
تمت إضافة المورد SearchAds360Link
إلى الإصدار v1alpha من واجهة برمجة التطبيقات، بالإضافة إلى عمليات properties.searchAds360Links.create
،
properties.searchAds360Links.delete
،
properties.searchAds360Links.patch
،
properties.searchAds360Links.list
،
properties.searchAds360Links.get
المرتبطة به.
تسمح هذه الوظيفة بإدارة الروابط بين موقع على "إحصاءات Google 4" وأحد ملفّات تعريف الارتباط في "إعلانات شبكة البحث 360".
2023-02-15 تغييرات قد تؤدي إلى أعطال
تمّت إزالة القيم
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
.
11 آب (أغسطس) 2022 تمت إضافة طريقة runAccessReport
إلى الإصدار 1alpha من Admin API.
تمت إضافة الطريقة properties.runAccessReport
إلى الإصدار v1alpha من Admin API. ويعرض
تقريرًا مخصّصًا عن سجلّات الوصول إلى البيانات. يقدّم التقرير سجلّات لكلّ
مرّة يقرأ فيها المستخدِم بيانات تقارير "إحصاءات Google". تتوفّر تقارير "الوصول إلى البيانات"
لمشرفي مواقع "إحصاءات Google 360".
11 تموز (يوليو) 2022: تم إصدار الإصدار 1 من Admin API (الإصدار التجريبي).
تمّ إصدار الإصدار 1 من الإصدار التجريبي من Google Analytics Admin API.
ستظلّ كلّ من قناة Alpha وقناة Beta لواجهة برمجة التطبيقات متاحة لواجهة Admin API. تتضمّن القناة التجريبية مجموعة فرعية من الميزات المتاحة في القناة العلنية والتي يُعتبَر أنّها ثابتة ولا يُتوقّع أن تخضع لتغيير كبير في المستقبل. ستتم إضافة ميزات جديدة إلى الإصدار التجريبي بعد أن تصبح جاهزة.
12-10-2021 تمّت إزالة طرق EnhancedMeasurementSettings من واجهة برمجة التطبيقات.
- تمت إزالة
properties.webDataStreams.getEnhancedMeasurementSettings
،properties.webDataStreams.updateEnhancedMeasurementSettings
من واجهة برمجة التطبيقات، ولكن سيتم قريبًا تعديل إعدادات القياس المحسَّن مجددًا من خلال واجهة برمجة التطبيقات. - لم يعُد الحقل
directRoles
في موردUserLink
يتيح دورpredefinedRoles/manage-users
. يجب استخدام الدور الجديدpredefinedRoles/admin
بدلاً من ذلك، وهو معادل لجمع الدورَين القديمَينpredefinedRoles/edit
وpredefinedRoles/manage-users
. يؤثّر هذا التغيير في سلوك أسلوبَيaccounts.userLinks
،properties.userLinks
، وهو متوافق مع التغييرات التي تمّ إجراؤها في "إحصاءات Google" في ما يتعلّق بإدارة أذونات الوصول وقيود البيانات.
05-06-2021 تمّت إضافة ميزات.
تمت إضافة الميزات التالية إلى واجهة برمجة التطبيقات:
- تمت إضافة طريقة
accounts.searchChangeHistoryEvents
إلى واجهة برمجة التطبيقات. تبحث هذه الطريقة في جميع التغييرات التي طرأت على حساب أو عناصره الفرعية استنادًا إلى مجموعة الفلاتر المحدّدة. تشمل الأسباب الشائعة التعديلات التي تم إجراؤها في واجهة مستخدم "إحصاءات Google" أو التغييرات التي أجراها فريق دعم العميل أو التغييرات التلقائية في نظام "إحصاءات Google". - طرق إدارة أسرار Measurement Protocol التي تمت إضافتها ضمن
properties.webDataStreams.measurementProtocolSecrets
:create
تُنشئ مفتاحًا سريًا لمنصّة Measurement Protocol.delete
يؤدي هذا الإجراء إلى حذف مفتاح Measurement Protocol السري المستهدف.get
ابحث عن مفتاح سرّي واحد لمنصّة Measurement Protocol.list
تعرض هذه الدالة أسرار Measurement Protocol الفرعية ضمن الموقع الرئيسي المحدّد.patch
تعديل مفتاح Measurement Protocol السري
- طرق إدارة أحداث الإحالات الناجحة التي تمت إضافتها ضمن
properties.conversionEvents
: - طرق إدارة السمات المخصّصة التي تمت إضافتها ضمن
properties.customDimensions
: - طرق إدارة المقاييس المخصّصة التي تمت إضافتها ضمن
properties.customMetrics
: - تمت إضافة
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
.
2020-10-20 تمت إضافة ميزة "ملخّصات الحسابات".
تمت إضافة إمكانية استخدام طريقة ملخّصات الحسابات.
13-10-2020 تمت إعادة تسمية مواقع "التطبيقات + المواقع الإلكترونية" إلى "إحصاءات Google 4".
15 آب (أغسطس) 2020: تمت إعادة تسمية Management App + Web API إلى Admin API.
تمت إعادة تسمية واجهة برمجة التطبيقات Google Analytics Management App + Web API إلى Google Analytics Admin API. نتيجةً لذلك، تغيّرت نقطة نهاية واجهة برمجة التطبيقات لتصبح analyticsadmin.googleapis.com. ويجب تعديل الرمز البرمجي الحالي المكتوب وفقًا للإصدار السابق من عنوان URL لنقطة نهاية واجهة برمجة التطبيقات ومكتبات العملاء وفقًا لذلك.