Değişiklik günlüğü

Resmi Google Analytics API duyuruları için lütfen Google Analytics API Bildirim Grubu'na abone olun.

18.06.2026 UpdateReportingIdentitySettings yöntemi eklendi

18.06.2026 PropertySummary öğesine can_edit alanı eklendi.

  • Admin API v1alpha ve v1beta'da PropertySummary kaynağına can_edit alanı eklendi. Bu alan, kullanıcının mülkteki ayarları değiştirmesine izin veren bir Google Analytics rolüne sahip olup olmadığını gösterir.

2026-04-14 GetUserProvidedDataSettings yöntemi eklendi

20.08.2025 GetReportingIdentitySettings yöntemi eklendi.

Admin API v1alpha'ya, bir mülkün ReportingIdentitySettings değerini almanıza olanak tanıyan GetReportingIdentitySettings yöntemi eklendi.

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 konfigürasyon yönetimi yöntemleri eklendi.

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

2025-04-16 Raporlama Verileri Ek 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ğinin sonlandırılması

getDataSharingSettings yönteminin sharingWithGoogleAnySalesEnabled parametresi artık kullanımdan kaldırılmıştır ve her zaman false değerini döndürür. Bu alan, Haziran 2025'te Google Analytics Admin API v1beta'dan kaldırılacak.

20.01.2025 DataRetentionSettings için kullanıcı verilerini saklama süresi eklendi.

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

2024-09-09 Access Reports anket formu

runAccessReport yönteminin dokümanları, Google Analytics Erişim Raporları geri bildirim formunun bağlantısını içerecek şekilde güncellendi. Görüşlerinize değer veriyoruz ve bu API'yi daha da geliştirmemize yardımcı olmak için düşüncelerinizi bizimle paylaşmanızı rica ediyoruz.

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

dataset_location alanı BigQueryLink kaynağına eklendi.

ChangeHistoryResourceType içinde yeni BIGQUERY_LINK değeri altında değişiklik geçmişine BigQuery bağlantı değişiklikleri eklendi.

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

Admin API v1alpha'daki createSubproperty özel yöntemi, özel yöntem yönergelerine uygun olacak şekilde provisionSubproperty olarak yeniden adlandırıldı.

2024-08-01 Etkinlik düzenleme kuralı yönetimi eklendi

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

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, EventEditRule, kaynak etkinlikteki parametrelerde yapılacak değişiklikleri tanımlayabilir.

01.08.2024 Çeşitli değişiklikler

create_time, Audience kaynağına eklendi.

Kanal grubunun raporlar için varsayılan kanal grubu olup olmadığını belirtmek üzere ChannelGroup kaynağına primary eklendi. Herhangi bir zamanda yalnızca bir kanal grubunun primary değeri true olarak ayarlanabilir. Bir kanal grubu için primary değerini true olarak ayarladığınızda, önceki birincil kanal grubu için primary değeri otomatik olarak false olarak ayarlanır.

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.

2024-05-06 Önemli etkinlik yönetimi yöntemleri eklendi

Önemli etkinlikler için 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şim raporları özelliğinin belirli alanları artık hem standart hem de Google Analytics 360 müşterileri olmak üzere tüm Google Analytics mülkleri için kullanılabilir.

Daha fazla bilgi için şema belgelerini inceleyin.

15.12.2023 Veri erişimi raporu şemasına accessDateHour boyutu eklendi.

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

05.10.2023 İlk tıklama, doğrusal, zamana bağlı azalma ve konuma dayalı ilişkilendirme modellerini kullanan mülkler varsayılan olarak kanallar arası veriye dayalı ilişkilendirme modeline geçirilir.

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 olarak değiştirilecek. Bunun yerine kanallar arası son tıklama veya Ads tercihli son tıklama modellerini kullanma seçenekleriniz devam edecek.

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

Admin API v1alpha'ya eklenen yöntemler: GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas.

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.

Admin API v1beta'ya UpdateConversionEvent yöntemi eklendi.

2023-09-01 BigQueryLink.enterprise_export_enabled alanının adı fresh_daily_export_enabled olarak değiştirildi.

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

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

24 Temmuz 2023'ten itibaren Admin API v1 alfa sürümünde, properties.getAttributionSettings ve properties.updateAttributionSettings yöntemlerinin işlevini etkileyecek zarar veren 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 ads_web_conversion_data_export_scope alanı, AttributionSettings türüne eklendi.

AttributionSettings türüne ads_web_conversion_data_export_scope alanı eklendi. Bu alan, UpdateAttributionSettings yöntemi kullanılarak değiştirilebilir.

05.06.2023 İlk tıklama, doğrusal, zamana bağlı azalma ve konuma dayalı ilişkilendirme modellerinin kullanımdan kaldırılması.

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ılamayacak. Eylül 2023'ten itibaren bu modeller tüm mülkler için kullanılamayacak.

Daha fazla bilgi için Google Analytics ürün duyurusunu inceleyin.

Admin API v1alpha'ya eklenen yöntemler: GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks.

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

31.05.2023 Bağlı bir GA4 mülkünü aramak için bir yöntem 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.

2023-05-31 Etkinlik oluşturma kurallarını yönetme yöntemi eklendi.

CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule yöntemleri Admin API v1alpha'ya eklendi.

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

31.05.2023 Özel kanal gruplarını yönetmek için yöntemler eklendi.

Admin API 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.

Özel kanal grupları oluşturulduktan sonra Google Analytics Data API v1 kullanılarak sorgulanabilir.

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

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

Bu işlev, bir GA4 mülkünün web veri akışı için geliştirilmiş ölçüm ayarlarını yönetmenize olanak tanır.

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

Admin API v1alpha'ya properties.createConnectedSiteTag, properties.deleteConnectedSiteTag, properties.listConnectedSiteTags yöntemleri eklendi.

Bu işlev, bağlı site etiketlerini yönetmenize 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.

31.03.2023 Admin API v1beta'ya hesap ve mülk düzeyinde runAccessReport yöntemleri eklendi.

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

24.02.2023 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, 1 Haziran 2023'te Admin API v1 alfa sürümünden kaldırılacak

24.02.2023 Kullanıcı izinleri denetleme yöntemlerinin desteğinin sonlandırılması.

Aşağıdaki yöntemlerin desteği sonlandırıldı ve bu yöntemler 1 Haziran 2023'te Admin API 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 kitleleri yönetmenize olanak tanır.

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

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

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

BigQueryLink kaynağı, ilgili properties.bigQueryLinks.get ve 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 almanıza 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 Search Ads 360 öğesi arasındaki bağlantıları yönetmenize 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.

Admin API'nin v1alpha sürümüne properties.runAccessReport yöntemi eklendi. Veri erişim kayıtlarının özelleştirilmiş bir raporunu döndürür. Raporda, bir kullanıcının Google Analytics raporlama verilerini her okuduğu zamanın kayıtları yer alır. Veri erişim 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ı.

Admin API'nin hem alfa hem de beta kanalları desteklenmeye devam ediyor. Beta kanalı, alfa kanalında bulunan özelliklerin bir alt kümesini içerir. Bu özellikler kararlı olarak kabul edilir ve gelecekte önemli bir değişikliğe uğraması beklenmez. Yeni özellikler, olgunlaştıktan sonra Beta'ya 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ştirilmiş Ö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 ve properties.userLinks yöntemlerinin davranışını etkiler ve Google Analytics'te yapılan Erişim ve veri kısıtlama yönetimi değişiklikleriyle uyumludur.

2021-06-05 Özellikler eklendi.

API'ye aşağıdaki özellikler eklenmiştir:

  • API'ye accounts.searchChangeHistoryEvents yöntemi eklendi. Bu yöntem, belirtilen filtre grubu dikkate alınarak bir hesapta veya alt öğelerinde yapılan tüm değişiklikleri arar. Google Analytics kullanıcı arayüzünde yapılan güncellemeler, müşteri desteği tarafından yapılan değişiklikler veya otomatik Google Analytics sistem değişiklikleri, yaygın nedenler arasındadır.
  • Measurement Protocol gizli anahtarları yönetim yöntemleri, properties.dataStreams.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ün 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 eklenen dönüşüm etkinliği yönetimi yöntemleri:
    • 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 bölümüne eklenen özel boyut yönetimi yöntemleri:
    • archive Bir mülkteki özel boyutu arşivler.
    • create Özel boyut oluşturur.
    • get Tek bir özel boyut için arama.
    • list Bir mülkteki özel boyutları listeler.
    • patch Bir mülkteki özel boyutu günceller.
  • properties.customMetrics bölümüne ö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.
    • list Bir mülkteki özel metrikleri listeler.
    • patch Bir mülkteki özel metriği günceller.
  • Google Analytics 4 mülkü için Google sinyalleri ayarını kontrol etmeye olanak tanıyan properties.getGoogleSignalsSettings ve properties.updateGoogleSignalsSettings yöntemleri 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 zarar veren değişiklikler yapıldı:

  • properties.iosAppDataStreams.create, properties.androidAppDataStreams.create yöntemleri API'den kaldırıldı. Google Analytics 4 mülkünde uygulama akışları oluşturmak için lütfen 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ür.
  • Property türünün time_zone alanı artık zorunlu.
  • deleted alanı, Property türünden kaldırıldı.
  • UserLink türünün email_address alanı artık değiştirilemez.
  • UserLink türünün name alanı artık salt çıkış alanıdır.

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

Zarar veren değişiklikler: - Tüm güncelleme işlemleri için update_mask alanı zorunludur.

  • Account içinde country_code alanının adı region_code olarak değiştirildi.

  • EnhancedMeasurementSettings içinde url_query_parameter alanının adı uri_query_parameter olarak değiştirildi.

  • parent alanı GoogleAdsLink listesinden kaldırıldı.

20.10.2020 Hesap özetleri için destek eklendi.

account summaries yöntemi için destek eklendi.

13.10.2020 Uygulama + Web mülkleri, Google Analytics 4 (GA4) olarak yeniden adlandırıldı.

15.08.2020 Yönetim Uygulaması + Web API'nin adı Admin API olarak değiştirildi.

Google Analytics Management App + Web API'nin adı Google Analytics Admin API olarak değiştirildi. Bu nedenle, API uç noktası analyticsadmin.googleapis.com olarak değiştirildi. 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 gerekir.