Değişiklik günlüğü

Resmi Google Analytics API duyuruları için lütfen Google Analytics API Notify Group'a abone olun.

20.08.2025 GetReportingIdentitySettings yöntemi eklendi

Yönetici API'si v1alpha'ya GetReportingIdentitySettings yöntemi eklendi. Bu yöntem, bir mülk için ReportingIdentitySettings değerini almanıza olanak tanır.

20.08.2025 Eski Universal Analytics yöntemleri kaldırıldı

Aşağıdaki eski Universal Analytics (UA) yöntemleri Admin API v1alpha'dan kaldırıldı: SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags ve FetchConnectedGa4Property.

12.06.2025 Alt mülk senkronizasyonu yapılandırma yönetimi yöntemleri eklendi

Admin API v1alpha ile GetSubpropertySyncConfig, ListSubpropertySyncConfig, ve UpdateSubpropertySyncConfig kaynaklarını yönetmek için SubpropertySyncConfig yöntemleri eklendi.

16.04.2025 Raporlama verileri açıklaması yönetim yöntemleri eklendi

Admin API v1alpha ile ReportingDataAnnotation kaynaklarını yönetmek için CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation ve DeleteReportingDataAnnotation yöntemleri eklendi.

Notlar özelliği, kullanıcıların doğrudan Google Analytics raporlarına not ekleyebilmesini sağlar. Böylece etkinlikleri kaydetmeyi, verilerdeki değişiklikleri açıklamayı veya kendiniz ve ekibiniz için önemli gözlem noktalarını öne çıkarmayı kolaylaştırır.

2025-03-07 sharingWithGoogleAnySalesEnabled parametresinin desteği sonlandırılıyor

getDataSharingSettings yönteminin sharingWithGoogleAnySalesEnabled parametresinin desteği sonlandırıldı ve bu parametre her zaman false değerini döndürecek. Bu alan, Haziran 2025'te Google Analytics Admin API v1beta'dan kaldırılacak.

20.01.2025 DataRetentionSettings'a kullanıcı verilerini saklama özelliği eklendi.

Admin API v1alpha ve v1beta'da DataRetentionSettings öğesine userDataRetention alanı eklendi. Kullanıcı verilerinin saklama ayarlarını almak veya değiştirmek için bu alanı kullanın.

2024-09-09 Erişim Raporları anket formu

runAccessReport yönteminin belgeleri, Google Analytics Erişim Raporları geri bildirim formunun bağlantısını içerecek şekilde güncellendi. Görüşlerinize değer veriyoruz. Bu API ile ilgili düşüncelerinizi paylaşarak daha da geliştirmemize yardımcı olabilirsiniz.

Yönetici API'si v1alpha ile BigQueryLink kaynaklarını yönetmek için CreateBigQueryLink, UpdateBigQueryLink ve DeleteBigQueryLink yöntemleri eklendi.

dataset_location alanı, BigQueryLink kaynağına eklendi.

BigQuery bağlantı değişiklikleri, BIGQUERY_LINK değerinde ChangeHistoryResourceType altındaki değişiklik geçmişine eklendi.

2024-08-01 createSubproperty yönteminde zarar veren değişiklik

createSubproperty özel yönteminin adı, özel yöntem kurallarına uygun olması için Admin API v1alpha'da provisionSubproperty olarak değiştirildi.

01.08.2024 Etkinlik düzenleme kuralı yönetimi eklendi

GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, Admin API v1alpha'ya eklenen yöntemler.

EventEditRule, bir kaynak etkinliğin eşleşen ölçütlerine göre tamamen yeni bir etkinliğin oluşturulmasını tetikleyecek koşulları tanımlar. Ayrıca, bir EventEditRule, kaynak etkinlikteki parametrelerde değişiklik tanımlayabilir.

01.08.2024 Çeşitli değişiklikler

Audience kaynağına create_time eklendi.

Kanal grubunun raporlar için varsayılan kanal grubu olup olmadığını belirtmek üzere primary öğesi, ChannelGroup kaynağına eklendi. Herhangi bir zamanda yalnızca bir kanal grubunda primary değeri true olarak ayarlanabilir. Bir kanal grubu için primary ayarını true olarak belirlediğinizde, önceki birincil kanal grubu için primary ayarı otomatik olarak false olarak belirlenir.

Hesap bir GMP kuruluşuna bağlıysa Google Marketing Platform kuruluş kaynağının URI'sini içeren Account kaynağına gmp_organization eklendi.

06.05.2024 Önemli etkinlik yönetimi yöntemleri eklendi

Önemli etkinliklerle ilgili kaynaklar ve yöntemler artık kullanılabilir.

API entegrasyonunuzu ConversionEvent yerine KeyEvent kullanacak şekilde değiştirin. ConversionEvent desteği sonlandırıldı.

15.12.2023 Veri erişimi raporları artık tüm Google Analytics mülklerinde kullanılabilir.

Veri erişimi raporları özelliğinin belirli alanları artık hem Standart hem de Google Analytics 360 müşterileri için tüm Google Analytics mülklerinde kullanılabilir.

Daha fazla bilgi için şema belgelerini inceleyin.

2023-12-15 Veri erişimi raporu şemasına accessDateHour boyutu eklendi.

accessDateHour boyutu, veri erişimi raporu şemasına eklendi. GA raporlama verilerine erişen GA kullanıcısının tarih ve saatini içerir.

2023-10-05 İlk tıklama, doğrusal, zamana bağlı azalma ve konuma dayalı ilişkilendirme modellerinin kullanıldığı mülklerde varsayılan olarak kanallar arası DDA kullanılır.

Ekim 2023'ün ortasından itibaren ilk tıklama, doğrusal, zamana bağlı azalma ve konuma dayalı ilişkilendirme modelleri, tüm mülkler için UpdateAttributionSettings yöntemiyle kullanılamayacak.

Mülkünüz şu anda bu modellerden birini kullanacak şekilde yapılandırılmışsa kanallar arası veriye dayalı ilişkilendirme modeline değiştirilir. Bunun yerine kanallar arası son tıklama veya Ads tercihli son tıklama seçeneklerini kullanmaya devam edebilirsiniz.

2023-09-01 SKAdNetwork dönüşüm değeri şema yapılandırma yöntemleri eklendi.

Yönetici API'si v1alpha'ya GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas yöntemleri eklendi.

Bu işlev, bir iOS akışı için SKAdNetwork dönüşüm değeri şeması yapılandırmasının yönetilmesine olanak tanır.

2023-09-01 UpdateConversionEvent yöntemi eklendi.

UpdateConversionEvent Yönetici API'si v1beta'ya yöntem eklendi.

2023-09-01 BigQueryLink.enterprise_export_enabled alanı, fresh_daily_export_enabled olarak yeniden adlandırıldı.

BigQueryLink kaynağının enterprise_export_enabled alanı, fresh_daily_export_enabled olarak yeniden adlandırıldı.

14.07.2023 properties.updateAttributionSettings ve properties.getAttributionSettings yöntemlerinde zarar veren değişiklikler.

24 Temmuz 2023'ten itibaren Admin API v1 alfa sürümünde, properties.getAttributionSettings, properties.updateAttributionSettings yöntemlerinin işlevselliğini etkileyecek olan, uyumluluğu bozacak değişiklikler yapılacak.

ReportingAttributionModel enum'unun üyeleri aşağıdaki şekilde yeniden adlandırılacak:

Eski ad Yeni ad
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'unun üyeleri aşağıdaki şekilde yeniden adlandırılacak:

Eski ad Yeni ad
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

10.07.2023 AttributionSettings türüne ads_web_conversion_data_export_scope alanı eklendi.

ads_web_conversion_data_export_scope alanını, UpdateAttributionSettings yöntemi kullanılarak değiştirilebilen AttributionSettings türüne ekledi.

05.06.2023 İlk tıklama, doğrusal, zamana bağlı azalma ve konuma dayalı ilişkilendirme modellerinin desteği sonlandırıldı.

Haziran 2023'ten itibaren UpdateAttributionSettings yöntemi, GA4 mülklerini ilk tıklama, doğrusal, zamana bağlı azalma ve konuma dayalı ilişkilendirme modelleriyle yapılandırmak için kullanılamaz. Eylül 2023'ten itibaren bu modeller tüm mülklerde kullanılamayacak.

Daha fazla bilgi için Google Analytics ürün duyurusuna bakın.

GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks yöntemleri Admin API v1alpha'ya eklendi.

Bu işlev, bir GA4 mülkü için AdSense-Analytics bağlantılarının yönetilmesine olanak tanır.

31.05.2023 Bağlı bir GA4 mülkünü arama yöntemi eklendi.

Admin API v1alpha'ya eklenen FetchConnectedGa4Property yöntemi

Bu işlev, GA4'e geçiş sürecinde Universal Analytics mülkünüze bağlı bir GA4 mülkü hakkında bilgi edinmenizi sağlar.

31.05.2023 Etkinlik oluşturma kurallarını yönetme yöntemi eklendi.

Yönetici API'si v1alpha'ya CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule yöntemleri eklendi.

Bu işlev, bir kaynak etkinliğin eşleşen ölçütlerine göre tamamen yeni bir etkinliğin oluşturulmasını tetikleyebilen etkinlik oluşturma kurallarının yönetilmesine olanak tanır.

31.05.2023 Özel kanal gruplarını yönetme yöntemleri eklendi.

Yönetici API'si v1alpha'ya GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup yöntemleri eklendi.

Bu işlev, web sitenizin trafik kaynakları için özel kanal gruplarını yönetmenize olanak tanır.

Oluşturulduktan sonra özel kanal grupları, Google Analytics Data API v1 kullanılarak sorgulanabilir.

31.03.2023 Geliştirilmiş ölçüm ayarları yönetim yöntemleri eklendi.

Admin API v1alpha'ya properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings yöntemleri eklendi.

Bu işlev, bir GA4 mülkünün web veri akışı için Geliştirilmiş Ölçüm Ayarları'nın yönetilmesine olanak tanır.

31.03.2023 Bağlı site etiketi yönetim yöntemleri eklendi.

Yönetici API'si v1alpha'ya properties.createConnectedSiteTag, properties.deleteConnectedSiteTag, properties.listConnectedSiteTags yöntemleri eklendi.

Bu işlev, bağlı site etiketlerinin yönetilmesine olanak tanır ve trafiği bir Universal Analytics mülkünden Google Analytics 4 mülküne yönlendirmek için kullanışlıdır.

2023-03-31 Admin API v1beta'ya hesap ve mülk düzeyinde runAccessReport yöntemleri eklendi.

properties.runAccessReport ve accounts.runAccessReport yöntemleri, Admin API'nin v1beta sürümüne eklendi. Yöntemler, veri erişim kayıtlarının özelleştirilmiş bir raporunu döndürür.

2023-02-24 Genişletilmiş veri kümeleri yönetim yöntemleri eklendi.

ExpandedDataSet kaynağı, ilgili properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get işlemleriyle birlikte API'nin v1alpha sürümüne eklendi. Bu işlev, Google Analytics 360'ta genişletilmiş veri kümelerini yönetmek için kullanılabilir.

AccessBinding kaynağı, aşağıdaki işlemlerle birlikte API'nin v1alpha sürümüne eklendi:

Bu işlev, bir GA4 hesabı veya mülkü için kullanıcı izinlerinin yönetilmesine olanak tanır ve Kullanıcı Bağlantıları yerine kullanılmalıdır.

Kullanıcı bağlantıları işlevi, 6/1/23'te Yönetici API'si v1 alfa sürümünden kaldırılacak

24.02.2023 Kullanıcı izinleri denetim yöntemlerinin desteği sonlandırıldı.

Aşağıdaki yöntemlerin desteği sonlandırıldı ve 1.6.2023 tarihinde Yönetici API'si v1 alfa sürümünden kaldırılacak:

24.02.2023 Kitle yönetimi yöntemleri eklendi.

Audience kaynağı, ilgili properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get işlemleriyle birlikte API'nin v1alpha sürümüne eklendi.

Bu işlev, bir GA4 mülkü için kitlelerin yönetilmesine olanak tanır.

15.02.2023 Otomatik GA4 kurulumu sürecini devre dışı bırakma yöntemleri eklendi.

properties.setAutomatedGa4ConfigurationOptOut, properties.fetchAutomatedGa4ConfigurationOptOut işlemleri, API'nin v1alpha sürümüne eklendi.

Bu işlev, bir UA mülkü için otomatik GA4 kurulum sürecinin devre dışı bırakma durumunun yönetilmesine olanak tanır.

BigQueryLink kaynağı, ilgili properties.bigQueryLinks.get, properties.bigQueryLinks.list işlemleriyle birlikte API'nin v1alpha sürümüne eklendi.

Bu işlev, GA4 mülkü ile BigQuery projesi arasındaki bağlantılar hakkında bilgi alınmasına olanak tanır.

SearchAds360Link kaynağı, ilgili properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get işlemleriyle birlikte API'nin v1alpha sürümüne eklendi.

Bu işlev, bir GA4 mülkü ile bir Search Ads 360 varlığı arasındaki bağlantıların yönetilmesine olanak tanır.

15.02.2023 Zarar veren değişiklikler.

15.02.2023 Çeşitli değişiklikler.

11.08.2022 runAccessReport yöntemi, Admin API v1alpha'ya eklendi.

properties.runAccessReport yöntemi, Admin API'nin v1alpha sürümüne eklendi. Veri erişim kayıtlarının özelleştirilmiş bir raporunu döndürür. Bu rapor, bir kullanıcının Google Analytics raporlama verilerini her okuduğu zamanla ilgili kayıtlar sağlar. Veri erişimi raporları, Google Analytics 360 mülklerinin yöneticileri tarafından kullanılabilir.

11.07.2022 Admin API v1beta sürümü yayınlandı.

Google Analytics Admin API'nin v1beta sürümü yayınlandı.

API'nin hem alfa hem de beta kanalları, Admin API için desteklenmeye devam edecektir. Beta kanalı, alfa sürümünde bulunan ve kararlı olduğu düşünülen, gelecekte önemli bir değişikliğe uğraması beklenmeyen özelliklerin bir alt kümesini içerir. Yeni özellikler olgunlaştıkça Beta sürümüne eklenir.

12.10.2021 EnhancedMeasurementSettings yöntemleri API'den kaldırıldı.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings yöntemleri API'den kaldırıldı ancak Gelişmiş Ölçüm ayarları yakında API üzerinden tekrar değiştirilebilecek.
  • UserLink kaynağının directRoles alanı artık predefinedRoles/manage-users rolünü desteklemiyor. Bunun yerine, eski predefinedRoles/edit ve predefinedRoles/manage-users rollerinin kombinasyonuna eşdeğer olan yeni predefinedRoles/admin rolü kullanılmalıdır. Bu değişiklik, accounts.userLinks, properties.userLinks yöntemlerinin davranışını etkiler ve Google Analytics'te kullanıma sunulan Erişim ve veri kısıtlama yönetimi değişiklikleriyle uyumludur.

2021-06-05 Özellikler eklendi.

API'ye aşağıdaki özellikler eklenir:

  • API'ye accounts.searchChangeHistoryEvents yöntemi eklendi. Bu yöntem, belirtilen filtre grubu göz önünde bulundurularak bir hesapta veya alt hesaplarında yapılan tüm değişiklikleri arar. Google Analytics kullanıcı arayüzünde yapılan güncellemeler, müşteri desteğinden gelen değişiklikler veya otomatik Google Analytics sistem değişiklikleri, yaygın nedenler arasındadır.
  • Measurement Protocol gizli anahtar yönetimi yöntemleri, properties.webDataStreams.measurementProtocolSecrets bölümüne eklendi:
    • create Measurement Protocol gizli anahtarı oluşturur.
    • delete Hedef Measurement Protocol gizli anahtarını siler.
    • get Tek bir Measurement Protocol gizli anahtarını arayın.
    • list Belirtilen üst mülk altındaki alt Measurement Protocol gizli anahtarlarını döndürür.
    • patch Measurement Protocol gizli anahtarını günceller.
  • properties.conversionEvents bölümüne dönüşüm etkinlikleri yönetim yöntemleri eklendi:
    • create Belirtilen özelliklere sahip bir dönüşüm etkinliği oluşturur.
    • delete Bir mülkteki dönüşüm etkinliğini siler.
    • get Tek bir dönüşüm etkinliğini alma.
    • list Belirtilen üst mülkteki dönüşüm etkinliklerinin listesini döndürür.
  • properties.customDimensions altında özel boyut yönetimi yöntemleri eklendi:
    • archive Bir mülkteki özel boyutu arşivler.
    • create Özel boyut oluşturur.
    • get Tek bir özel boyut için arama yapın.
    • list Bir mülkteki özel boyutları listeler.
    • patch Bir mülkteki özel boyutu günceller.
  • properties.customMetrics altında özel metrik yönetimi yöntemleri eklendi:
    • archive Bir mülkteki özel metriği arşivler.
    • create Özel metrik oluşturur.
    • get Tek bir özel metrik için arama yapın.
    • list Bir mülkteki özel metrikleri listeler.
    • patch Bir mülkteki özel metriği günceller.
  • properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings Google Analytics 4 mülkünün Google sinyalleri ayarını kontrol etmeye olanak tanıyan yöntemler eklendi.
  • delete_time, expire_time Yalnızca çıkış alanları Property türüne eklendi.

2021-06-05 Zarar veren değişiklikler.

Aşağıdaki önemli değişiklikler yapıldı:

  • properties.iosAppDataStreams.create, properties.androidAppDataStreams.create yöntemleri API'den kaldırıldı. Lütfen Google Analytics 4 mülkünde uygulama akışları oluşturmak için Firebase'i kullanın.
  • properties.delete yöntemi artık boş bir yanıt döndürmek yerine silinen mülk verilerini Property türü olarak döndürüyor.
  • time_zone türündeki Property alanı artık zorunludur.
  • deleted alanı Property türünden kaldırıldı.
  • email_address türündeki UserLink alanı artık değiştirilemez.
  • name türündeki UserLink alanı artık yalnızca çıkış olarak kullanılıyor.

2021-01-28 Zarar veren değişiklikler.

Önemli değişiklikler: - update_mask alanı, tüm güncelleme işlemleri için zorunlu hale getirildi.

  • country_code alanı, Account içinde region_code olarak yeniden adlandırıldı.

  • url_query_parameter alanı, EnhancedMeasurementSettings içinde uri_query_parameter olarak yeniden adlandırıldı.

  • parent alanı, GoogleAdsLink öğesinden kaldırıldı.

20.10.2020 Hesap özetleri için destek eklendi.

Hesap özetleri yöntemi için destek eklendi.

13.10.2020 Uygulama + Web mülklerinin adı Google Analytics 4 (GA4) olarak değiştirildi.

2020-08-15 Yönetici Uygulaması + Web API'sinin adı Admin API olarak değiştirildi.

Google Analytics Management App + Web API'nin adı Google Analytics Admin API olarak değiştirildi. Sonuç olarak, API uç noktası analyticsadmin.googleapis.com olarak değişti. API uç noktası URL'sinin ve istemci kitaplıklarının önceki sürümüne göre yazılmış mevcut kodun buna göre güncellenmesi gerekiyor.