تغییرات

برای اطلاعیه‌های رسمی Google Analytics API، لطفاً در Google Analytics API Notify Group مشترک شوید.

09-09-2024 فرم نظرسنجی گزارش های دسترسی

مستندات روش runAccessReport به‌روزرسانی شده است تا پیوندی به فرم بازخورد Google Analytics Access Reports داشته باشد. ما برای ورودی شما ارزش قائل هستیم و شما را تشویق می کنیم که نظرات خود را در مورد این API به اشتراک بگذارید تا به ما در بهبود بیشتر آن کمک کنید.

متدهای CreateBigQueryLink ، UpdateBigQueryLink و DeleteBigQueryLink را برای مدیریت منابع BigQueryLink با Admin API v1alpha اضافه کرد.

فیلد dataset_location را به منبع BigQueryLink اضافه کرد.

تغییرات پیوند BigQuery برای تغییر تاریخچه تحت مقدار BIGQUERY_LINK جدید در ChangeHistoryResourceType اضافه شد.

01-08-2024 تغییر در متد createSubproperty

روش سفارشی createSubproperty را در Admin API v1alpha به provisionSubproperty تغییر نام داد تا با دستورالعمل‌های متد سفارشی هماهنگ شود.

01-08-2024 مدیریت قوانین ویرایش رویداد اضافه شد

GetEventEditRule ، CreateEventEditRule ، DeleteEventEditRule ، ListEventEditRules ، UpdateEventEditRules ، ReorderEventEditRules ، متدهای اضافه شده به Admin API v1alpha.

EventEditRule شرایطی را تعریف می کند که باعث ایجاد یک رویداد کاملاً جدید بر اساس معیارهای منطبق با یک رویداد منبع می شود. علاوه بر این، یک EventEditRule می تواند تغییرات پارامترها را از رویداد منبع تعریف کند.

2024-08-01 تغییرات متفرقه

create_time به منبع Audience اضافه شد.

به منبع ChannelGroup primary اضافه شده است تا مشخص شود آیا گروه کانال، گروه کانال پیش‌فرض برای گزارش‌ها است یا خیر. فقط یک گروه کانال می‌تواند در هر زمان معین تنظیم primary را روی true داشته باشد. تنظیم primary روی true برای یک گروه کانال به طور خودکار primary را روی false برای گروه کانال اصلی قبلی تنظیم می کند.

gmp_organization به منبع Account اضافه شد، که حاوی URI برای یک منبع سازمانی Google Marketing Platform است، اگر حساب به یک سازمان GMP متصل باشد.

06-05-2024 روش های مدیریت رویدادهای کلیدی اضافه شد

اکنون منابع و روش‌های رویدادهای کلیدی در دسترس هستند.

ادغام API خود را برای استفاده از KeyEvent به جای ConversionEvent تغییر دهید. ConversionEvent منسوخ شده است.

15/12/2023 گزارش‌های دسترسی به داده‌ها اکنون برای همه ویژگی‌های Google Analytics در دسترس است.

فیلدهای خاصی از ویژگی گزارش دسترسی به داده اکنون برای همه دارایی های Google Analytics، اعم از مشتریان استاندارد و Google Analytics 360 در دسترس است.

برای اطلاعات بیشتر به مستندات طرحواره مراجعه کنید.

15-12-2023 بعد accessDateHour به طرح گزارش دسترسی به داده اضافه شد.

بعد accessDateHour به طرح گزارش دسترسی به داده اضافه شد. این شامل ساعت تاریخ کاربر GA است که به داده های گزارش GA دسترسی داشته است.

05-10-2023 ویژگی‌های دارای مدل‌های انتساب اولین کلیک، خطی، زوال زمان و موقعیت به طور پیش‌فرض DDA متقابل کانالی است.

از اواسط اکتبر 2023، مدل‌های انتساب با کلیک اول ، خطی ، زوال زمانی و موقعیت مبتنی بر مکان برای استفاده با روش UpdateAttributionSettings برای همه ویژگی‌ها در دسترس نخواهد بود.

اگر دارایی شما در حال حاضر برای استفاده از یکی از این مدل‌ها پیکربندی شده است، به انتساب داده‌محور بین کانالی تغییر می‌کند. شما همچنان گزینه‌هایی برای استفاده از آخرین کلیک بین کانالی یا آخرین کلیک ترجیحی تبلیغات به جای آن خواهید داشت.

01-09-2023 روش های پیکربندی طرحواره ارزش تبدیل SKAdNetwork اضافه شد.

GetSKAdNetworkConversionValueSchema ، CreateSKAdNetworkConversionValueSchema ، DeleteSKAdNetworkConversionValueSchema ، UpdateSKAdNetworkConversionValueSchema ، ListSKAdNetworkConversionValueSchemas متدهای API v1al به Adphamin اضافه شد.

این عملکرد اجازه می دهد تا پیکربندی طرحواره مقدار تبدیل SKAdNetwork را برای یک جریان iOS مدیریت کنید.

01-09-2023 روش UpdateConversionEvent اضافه شد.

روش UpdateConversionEvent به Admin API v1beta اضافه شد.

فیلد 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 v1 alpha اعمال می‌شود که بر روی عملکرد 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

10-07-2023 قسمت ads_web_conversion_data_export_scope را به نوع AttributionSettings اضافه کرد

فیلد ads_web_conversion_data_export_scope را به نوع AttributionSettings اضافه کرد که با استفاده از روش UpdateAttributionSettings قابل تغییر است.

05-06-2023 منسوخ شدن مدل‌های انتساب اولین کلیک، خطی، زوال زمانی و موقعیت.

از ژوئن 2023، روش UpdateAttributionSettings نمی‌تواند برای پیکربندی ویژگی‌های GA4 با اولین کلیک ، خطی ، زوال زمانی و مدل‌های انتساب مبتنی بر موقعیت استفاده شود. از سپتامبر 2023، این مدل‌ها برای همه دارایی‌ها در دسترس نخواهد بود.

برای اطلاعات بیشتر به اطلاعیه محصول Google Analytics مراجعه کنید.

متدهای GetAdSenseLink ، CreateAdSenseLink ، DeleteAdSenseLink ، ListAdSenseLinks به Admin API v1alpha اضافه شدند.

این قابلیت به مدیریت پیوندهای AdSense به Analytics برای یک ویژگی GA4 اجازه می دهد.

31-05-2023 روشی برای جستجوی یک ویژگی GA4 متصل اضافه شد.

متد FetchConnectedGa4Property به Admin API v1alpha اضافه شده است

این عملکرد به شما امکان می دهد اطلاعاتی را در مورد یک ویژگی GA4 که دارایی Universal Analytics شما را در طول فرآیند انتقال GA4 مرتبط کرده است به دست آورید.

31-05-2023 روشی برای مدیریت قوانین ایجاد رویداد اضافه شد.

متدهای CreateEventCreateRule ، UpdateEventCreateRule ، DeleteEventCreateRule ، ListEventCreateRules ، GetEventCreateRule به Admin API v1alpha اضافه شدند.

این عملکرد اجازه می دهد تا قوانین ایجاد رویداد را مدیریت کنید که می تواند باعث ایجاد یک رویداد کاملاً جدید بر اساس معیارهای مطابق با یک رویداد منبع شود.

31/05/2023 روش‌هایی برای مدیریت گروه‌های کانال سفارشی اضافه شد.

متدهای GetChannelGroup ، ListChannelGroups ، CreateChannelGroup ، UpdateChannelGroup ، DeleteChannelGroup را به Admin API v1alpha اضافه کرد.

این قابلیت به شما امکان می دهد گروه های کانال سفارشی را برای منابع ترافیک وب سایت خود مدیریت کنید.

پس از ایجاد، گروه های کانال سفارشی را می توان با استفاده از Google Analytics Data API v1 پرس و جو کرد.

31-03-2023 روش‌های مدیریت تنظیمات اندازه‌گیری پیشرفته اضافه شد.

متدهای properties.dataStreams.updateEnhancedMeasurementSettings ، properties.dataStreams.getEnhancedMeasurementSettings به Admin API v1alpha اضافه شدند.

این عملکرد اجازه می دهد تا تنظیمات اندازه گیری پیشرفته را برای جریان داده وب یک ویژگی GA4 مدیریت کنید.

2023-03-31 روش های مدیریت برچسب سایت متصل اضافه شد.

متدهای properties.createConnectedSiteTag ، properties.deleteConnectedSiteTag ، properties.listConnectedSiteTags به Admin API v1alpha اضافه شدند.

این قابلیت به مدیریت برچسب‌های سایت متصل امکان می‌دهد و برای انتقال ترافیک از ویژگی Universal Analytics به ویژگی Google Analytics 4 مفید است.

31-03-2023 روش‌های runAccessReport در سطح دارایی و حساب به Admin API v1beta اضافه شد.

متدهای properties.runAccessReport و accounts.runAccessReport به نسخه v1beta Admin API اضافه شدند. روش‌ها یک گزارش سفارشی از سوابق دسترسی به داده را برمی‌گردانند.

2023-02-24 روش های مدیریت مجموعه داده های گسترده اضافه شد.

منبع ExpandedDataSet به نسخه v1alpha API به همراه properties.expandedDataSets.create مربوطه اضافه شده است.expandedDataSets.create , properties.expandedDataSets.delete , properties.expandedDataSets.patch , properties.expandedDataSets.list , properties.expandedDataSets.get . این قابلیت را می توان برای مدیریت مجموعه داده های گسترده در Google Analytics 360 استفاده کرد.

منبع AccessBinding همراه با عملیات زیر به نسخه v1alpha API اضافه شده است:

این عملکرد اجازه می دهد تا مجوزهای کاربر را برای حساب یا دارایی GA4 مدیریت کنید و باید به جای پیوندهای کاربر استفاده شود.

عملکرد پیوندهای کاربر از Admin API v1 alpha در تاریخ 6/1/23 حذف خواهد شد

2023-02-24 منسوخ شدن روش های حسابرسی مجوزهای کاربر.

روش‌های زیر منسوخ شده‌اند و در تاریخ 6/1/23 از Admin API v1 alpha حذف خواهند شد:

2023-02-24 روش های مدیریت مخاطب اضافه شد.

منبع Audience به نسخه v1alpha API به همراه عملیات مربوط به properties.audience.create , properties.audience.archive , properties.audience.patch , properties.audience.list , properties.audience.get اضافه شده است.

این قابلیت به مدیریت مخاطبان برای یک ویژگی GA4 اجازه می دهد.

15/02/2023 روش‌های انصراف فرآیند راه‌اندازی خودکار GA4 اضافه شد.

عملکردهای properties.setAutomatedGa4ConfigurationOptOut ، properties.fetchAutomatedGa4ConfigurationOptOut به نسخه v1alpha API اضافه شده است.

این عملکرد اجازه می دهد تا وضعیت انصراف را برای فرآیند تنظیم خودکار GA4 برای یک ویژگی UA مدیریت کنید.

منبع BigQueryLink به نسخه v1alpha API به همراه عملیات مربوط به properties.bigQueryLinks.get ، properties.bigQueryLinks.list اضافه شده است.

این عملکرد امکان بازیابی اطلاعات مربوط به پیوندهای بین یک ویژگی GA4 و یک پروژه BigQuery را می دهد.

منبع SearchAds360Link به نسخه v1alpha API به همراه properties.searchAds360Links.create مربوطه اضافه شده است.searchAds360Links.create , properties.searchAds360Links.delete , properties.searchAds360Links.patch , properties.searchAds360Links.list properties.searchAds360Links.get .

این عملکرد اجازه می دهد تا پیوندهای بین یک ویژگی GA4 و یک موجودیت Search Ads 360 را مدیریت کنید.

15/02/2023 تغییرات شکسته.

2023-02-15 تغییرات متفرقه.

  • فیلد tokensPerProjectPerHour به نوع AccessQuota اضافه شد.
  • EXPANDED_DATA_SET ، مقادیر CHANNEL_GROUP به فهرست ChangeHistoryResourceType اضافه شد.
  • searchAds360Link ، expandedDataSet ، مقادیر bigqueryLink به ChangeHistoryResource اضافه شده است.

روش runAccessReport 2022-08-11 به Admin API v1alpha اضافه شد.

متد properties.runAccessReport به نسخه v1alpha Admin API اضافه شده است. این یک گزارش سفارشی از سوابق دسترسی به داده ها را برمی گرداند. این گزارش سوابقی از هر بار خواندن داده های گزارش Google Analytics توسط کاربر ارائه می دهد. گزارش‌های دسترسی به داده‌ها برای مدیران دارایی Google Analytics 360 در دسترس است.

2022-07-11 Admin API نسخه v1beta منتشر شد.

نسخه v1beta Google Analytics Admin API منتشر شد.

هر دو کانال آلفا و بتا از API همچنان برای Admin API پشتیبانی می شوند. کانال بتا شامل زیرمجموعه‌ای از ویژگی‌های موجود در آلفا است که پایدار در نظر گرفته می‌شوند و انتظار نمی‌رود در آینده تغییر قابل‌توجهی داشته باشند. ویژگی های جدید پس از بلوغ به بتا اضافه خواهند شد.

روش‌های EnhancedMeasurementSettings 2021-10-12 از API حذف شدند.

  • متدهای properties.webDataStreams.getEnhancedMeasurementSettings ، properties.webDataStreams.updateEnhancedMeasurementSettings از API حذف می شوند، اما تنظیمات اندازه گیری پیشرفته دوباره به زودی از طریق API قابل تغییر خواهند بود.
  • فیلد directRoles منبع UserLink دیگر نقش Roles predefinedRoles/manage-users پشتیبانی نمی کند. نقش جدید predefinedRoles/admin باید به جای آن استفاده شود، که معادل ترکیبی از نقش های قدیمی predefinedRoles/edit و predefinedRoles/manage-users است. این تغییر بر رفتار روش‌های accounts.userLinks ، properties.userLinks تأثیر می‌گذارد و مطابق با تغییرات مدیریت دسترسی و محدودیت داده‌ای است که در Google Analytics معرفی شده‌اند.

2021-06-05 ویژگی های اضافه شده است.

ویژگی های زیر به API اضافه شده است:

  • روش accounts.searchChangeHistoryEvents به API اضافه شد. این روش تمام تغییرات یک حساب یا فرزندان آن را با توجه به مجموعه فیلترهای مشخص شده جستجو می کند. دلایل رایج به‌روزرسانی‌های ایجاد شده در رابط کاربری Google Analytics، تغییرات ناشی از پشتیبانی مشتری یا تغییرات خودکار سیستم Google Analytics است.
  • روش‌های مدیریت اسرار پروتکل اندازه‌گیری در قسمت properties.webDataStreams.measurementProtocolSecrets اضافه شده است:
    • create یک راز پروتکل اندازه گیری ایجاد می کند.
    • delete راز پروتکل اندازه گیری هدف را حذف می کند.
    • جستجوی یک راز پروتکل اندازه گیری واحد را get .
    • list اسرار پروتکل اندازه گیری فرزند را تحت ویژگی والد مشخص شده برمی گرداند.
    • patch راز پروتکل اندازه گیری را به روز می کند.
  • روش‌های مدیریت رویدادهای تبدیل در قسمت 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 Signals را برای ویژگی Google Analytics 4 فراهم می‌کند.
  • delete_time ، expire_time فقط فیلدهایی را که به نوع Property اضافه شده اند، خروجی می دهد.

2021-06-05 تغییرات شکسته.

تغییرات شکستن زیر معرفی شد:

  • متدهای properties.iosAppDataStreams.create ، properties.androidAppDataStreams.create از API حذف شدند. لطفاً از Firebase برای ایجاد جریان های برنامه در ویژگی Google Analytics 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 در EnhancedMeasurementSettings به uri_query_parameter تغییر نام داد.

  • فیلد parent از GoogleAdsLink حذف شد.

2020-10-20 پشتیبانی اضافه شده برای خلاصه حساب.

پشتیبانی از روش خلاصه حساب اضافه شد.

2020-10-13 ویژگی های برنامه + وب به Google Analytics 4 (GA4) تغییر نام داد.

2020-08-15 برنامه مدیریت + API وب به Admin API تغییر نام داد.

Google Analytics Management App + Web API به Google Analytics Admin API تغییر نام داده است. در نتیجه، نقطه پایانی API به analyticsadmin.googleapis.com تغییر کرده است. کد موجود نوشته شده در برابر نسخه قبلی آدرس اینترنتی نقطه پایانی API و کتابخانه های سرویس گیرنده باید بر اساس آن به روز شود.