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

للاطّلاع على الإشعارات الرسمية بشأن Google Analytics API، يُرجى الاشتراك في مجموعة الإشعارات بشأن Google Analytics API.

‎2025-01-20 تمت إضافة الاحتفاظ ببيانات المستخدمين إلى DataRetentionSettings

تمت إضافة الحقل userDataRetention إلى DataRetentionSettings في Admin API الإصدارَين 1alpha و1beta. استخدِم هذا الحقل لاسترداد إعدادات الاحتفاظ ببيانات المستخدمين أو تعديلها.

‎2024-09-09 نموذج استطلاع حول "تقارير الوصول"

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

تمت إضافة 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" لمزيد من المعلومات.

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".

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

تسمح هذه الوظيفة بإدارة أذونات المستخدمين لحساب "إحصاءات 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.

تمت إضافة مورد 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".

‫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:
    • 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 تغييرات قد تؤدي إلى أعطال

التغييرات الأساسية: - حقل 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 لنقطة نهاية واجهة برمجة التطبيقات ومكتبات العملاء وفقًا لذلك.