Merchant Accounts API'si sürüm notları

26 Ekim 2026 haftası

  • accounts.homepage.unclaim yönteminin ve Homepage kaynağının claimed alanının belgelerini netleştirdik. Bir hesap, ana sayfa hak talebini gelişmiş hesabından devralırsa unclaim başarılı bir yanıt döndürür ancak ana sayfa için hak talebinde bulunulmuş olarak kalır. Hesabın kendisi hak talebinde bulunmaktan muafsa unclaim, FAILED_PRECONDITION hatası döndürür.

28 Eylül 2026 haftası

  • youtube_affiliate_management, v1alpha içindeki AccountService kaynağına hizmet türü olarak eklendi. Not: YouTube Satış Ortağı Yönetimi, sınırlı erişimli bir özelliktir.

  • Bağlılık programlarını yönetmek için kullanabileceğiniz LoyaltyPrograms hizmetinin alfa sürümü kullanıma sunuldu. Bu özellik yalnızca belirli satıcılar tarafından kullanılabilir. Daha fazla bilgi için Bağlılık programlarına genel bakış başlıklı makaleyi inceleyin.

  • Mağazanın ana sayfasının URI'sini döndürmek için accounts kaynağına salt okunur home_page_uri alanı eklendi.

3 Ağustos 2026 haftası

  • Hesap hizmeti kaynağına hizmet türü olarak "ucp_checkout_management" eklendi. Not: UCP ödeme özelliği, sınırlı erişimli bir özelliktir.
  • "ucp-integration" programı (sınırlı erişim) için destek eklendi.
  • "ucp_integration" hizmet şartları türü için destek eklendi.

29 Haziran 2026 haftası

  • Hesap listesi uç noktasında kullanılan access filtresinin kullanıma sunulması. Bu özellik, hesapları erişim düzeyinize göre filtrelemenize olanak tanır. Olası değerler DIRECT, INDIRECT ve ALL'dir. Varsayılan davranış, erişiminiz olan tüm hesapları döndürmektir. Daha fazla bilgi için Erişebileceğiniz hesapları filtreleme başlıklı makaleyi inceleyin.

20 Nisan 2026 haftası

  • accounts.programs kaynak açıklamasına, kullanılabilir program adları listesine youtube-affiliate eklendi.
  • YouTube Alışveriş Satış Ortağı Programı API'sini etkinleştirin. Güvenilir Test Kullanıcıları tarafından kullanılabilir.

6 Nisan 2026 haftası

  • Onay Durumu'na WAITING durumu eklendi. Karşılaştırmalı Alışveriş Hizmetleri (CSS) için WAITING, PENDING ile ESTABLISHED arasında bir geçiş durumudur. Hesap yeni CSS'ye tamamen aktarılmadan önce orijinal CSS'nin gerekli temizleme işlemlerini yapması için zamana ihtiyacı olduğunda kullanılır.

16 Mart 2026 haftası

  • Accounts API'de CreateTestAccount yöntemi kullanıma sunuldu. Bu sayede geliştiriciler, izole edilmiş korumalı alan benzeri bir ortamda çalışan özel test hesaplarını programatik olarak oluşturabilir ve entegrasyonları geliştirip test etmek için güvenli bir alana sahip olabilir.

17 Kasım 2025 haftası

  • CreateAndConfigureAccountRequest artık hesap kurulumu sırasında yapılandırılabilen yeni hizmetler sunuyor. AccountAggregation, AccountManagement ve ComparisonShopping değerlerinden tam olarak biri belirtilmelidir. Ayrıca, istediğiniz sayıda ProductsManagement ve CampaignsManagement hizmeti belirtebilirsiniz. Ancak aynı sağlayıcı ve harici hesap kimliklerine sahip iki hizmet olmamalıdır.

  • AccountsService.CreateAndConfigure yöntemi artık doğrulama e-postasının gönderilip gönderilmeyeceğini kontrol eden bir ayar sunuyor.

  • CreateAndConfigureAccountRequest.AddAccountService artık bir external_account_id alanına sahip (bu alan AccountService kaynağında zaten mevcut). CampaignsManagement ve ProductsManagement hizmetleriyle birlikte belirtilebilir.

  • AccountService kaynağına ComparisonShopping hizmeti eklendi. Daha fazla bilgi için https://support.google.com/merchants/answer/12653197 adresini ziyaret edin.

  • Artık hesap oluşturma sırasında CreateAndConfigureAccountRequest içindeki setAlias alanını kullanarak bir ilişki için takma ad belirleyebilirsiniz.

  • UserService sınıfına, aramayı yapan kullanıcıyı temsil eden User kaynağı için durumu PENDING değerinden VERIFIED değerine güncelleyen bir VerifySelf yöntemi eklendi.

  • Satıcıların yarıçap alanını kullanarak bölge oluşturmasına olanak tanıyacak Regions API'nin Region yükünde yeni radius_area alanını kullanıma sunun.

10 Kasım 2025 haftası

  • Services API için v1alpha sürümünü yayınlama
  • Satıcıların, satıcı ürünlerinin özelliklerine göre bazı koşullu filtrelemeler uygulayarak feed'lerinin yalnızca bir alt kümesini Google Ads hesaplarıyla paylaşmasına olanak tanıyan Services API'nin CampaignManagement yükünde yeni product_filters alanını kullanıma sunun. Bu özellik, izin verilenler listesine eklenmiş olup yalnızca sınırlı sayıda satıcı tarafından kullanılabilir.

25 Ağustos 2025 haftası

  • Regions API'ye yeni toplu yöntemler eklendi:
    • BatchCreateRegions: Tek bir istekte birden fazla bölge oluşturulmasına olanak tanır.
    • BatchUpdateRegions: Tek bir istekte birden fazla bölgenin güncellenmesini sağlar.
    • BatchDeleteRegions: Tek bir istekte birden fazla bölgeyi ada göre silme olanağı sağlar.

1 Temmuz 2025 haftası

  • API kullanıcılarının checkoutSettings oluşturmasına, güncellemesine, silmesine ve almasına olanak tanıyan CheckoutSettings kaynağının kullanıma sunulması.

26 Mayıs 2025 haftası

  • Artık hesapları capabilities ile filtreleyebilirsiniz. Şu anda mümkün olan tek değer CAN_UPLOAD_PRODUCTS. Bu filtre, ürün yükleyebilen hesapları almanızı sağlar. Bu, aşağıdaki yan tümcelerin artık hesap düzeyinde kullanılabileceği anlamına gelir:

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS Daha fazla bilgi için filtreleme kılavuzunu inceleyin.

  • Salt okuma erişim hakkının kullanıma sunulması. Salt okuma erişim hakkına sahip kullanıcılar, satıcı verilerini görüntüleyebilir ancak değiştiremez.

19 Mayıs 2025 haftası

  • Program API'si için dokümanlar güncellendi ve Enable/Disable yöntemlerinin yönetici kullanıcılarla kısıtlı olduğuna dair yanlış ifade kaldırıldı.

12 Mayıs 2025 haftası

  • API kullanıcılarının iade politikaları oluşturmasına, güncellemesine ve silmesine olanak tanıyan Online Return Policy kaynağının kullanıma sunulması.
  • API kullanıcılarının çok kanallı deneyimlerini yönetmelerine olanak tanıyan OmnichannelSettingsService ve OmnichannelSetting kaynağının kullanıma sunulması.
  • API kullanıcılarının Yerel Feed İş Ortaklığı ilişkilerini yönetmesine olanak tanıyan LfpProvidersService ve LfpProvider kaynağının kullanıma sunulması.
  • API kullanıcılarının Google İşletme Profillerini yönetmesine olanak tanıyan GbpAccountsService ve GbpAccount kaynağının kullanıma sunulması.
  • AccountService'te, yerel envanter reklamları veya ücretsiz yerel listelemeler için kullanılan işletmeye ait konumu bağlayan LocalListingManagement hizmet türünü başlatın.

28 Nisan 2025 haftası

  • API kullanıcılarının ilişkileri yönetmesine ve servis sağlayıcılara hizmet sunmasına olanak tanıyan AccountService ve AccountRelationship kaynaklarının kullanıma sunulması.

14 Nisan 2025 haftası

  • TermsOfServiceService.AcceptTermsOfService artık kabul edilen TermsOfServiceAgremeentState değerini bir yanıt türü içinde sarmalanmış olarak döndürür.

  • TermsOfServiceService.AcceptTermsOfService işleminin fiili artık POST (önceden GET idi).

  • AccountsService.ListSubAccounts yönteminin providers/... yerine accounts/... biçimi kullanılarak çağrılması gerektiği netleştirildi. Bu sayede, bu yöntemin accounts kapsamı dışında kalması (GET providers/123:listSubAccounts yerine GET accounts/123:listSubAccounts) önlenir.

31 Mart 2025 haftası

  • Hesapları filtrelemek için kullanılan externalAccountId filtresinin 2 Aralık 2024 haftasında kullanımdan kaldırılacağı duyurulmuştu. Bu filtre artık kullanılamıyor. Bu, externalAccountId ile filtrelemenin artık yalnızca service düzeyinde mümkün olduğu anlamına gelir. relationship(externalAccountId = "foo") gibi bir filtre artık çalışmayacak ve relationship(service(externalAccountId = "foo")) olarak ifade edilmesi gerekecek.

  • AccountsService belgelerinde, bağımsız hesap oluşturulamayacağı açıklandı.

3 Mart 2025 haftası

-accounts.onlineReturnPolicies#SeasonalOverride, daha net ve tutarlı olması için yeniden düzenlendi. Bu güncellemeler şunları içerir:

  • Alanları yeniden adlandırma:
    • begin artık start_date.
    • end artık end_date.
  • Alan kaldırma:
    • Desteği sonlandırılan policy alanı kaldırıldı.

-Geliştiriciler, kodlarını bu değişiklikleri yansıtacak şekilde güncellemelidir.

Aşağıdakileri yönetmek için kullanabileceğiniz AutomaticImprovements hizmetinin kullanıma sunulması:

Daha fazla bilgi için Otomatik iyileştirmeleri etkinleştirme başlıklı makaleyi inceleyin.

17 Şubat 2025 haftası

callerHasAccessToProviderFilter() yüklemi hesap filtresinden kaldırıldı.

10 Şubat 2025 haftası

  • AccountsService.List yöntemiyle ilgili belgeler iyileştirildi. Yalnızca bağımsız hesapları değil, kullanıcının erişebildiği tüm hesapları döndürür.

  • Tüm RPC yöntemleri için 10 dakikalık varsayılan son tarih eklendi.

  • Mevcut program adlarının listesi, accounts.programs kaynak açıklamasına eklendi.

  • User.accessRights artık REQUIRED. Bu değişiklik hem UserService.Create hem de AccountsService.CreateAndConfigure yöntemlerini etkiliyor.

27 Ocak 2025 haftası

AccountsService.ListAccounts (ve geçişli olarak AccountsService.ListSubAccounts) artık güçlü bir okuma yerine hesapları nihai tutarlı bir şekilde döndürür.

20 Ocak 2025 haftası

CreateAndConfigureAccountRequest öğesinin users alanı, yeni bir user lehine kullanımdan kaldırıldı. Referans verilen CreateUserRequest, CreateAndConfigureAccountRequest bağlamında gerekli olmayan parent alanını içeriyor.

6 Ocak 2025 haftası

CreateUserRequest mesajının user alanı artık doğru şekilde OPTIONAL olarak işaretleniyor.

Döndürülen hatalardaki domain alanı artık global yerine merchantapi.googleapis.com ile dolduruluyor.

2 Aralık 2024 haftası

Hesapları filtrelemek için externalAccountId yüklemi, relationship düzeyinden service düzeyine taşınır. Bu nedenle, relationship(externalAccountId = "foo") filtresinin artık relationship(service(externalAccountId = "foo")) olarak yazılması gerekir. Eski biçim, geriye dönük uyumluluk için hâlâ desteklenmektedir ancak desteği sonlandırılmıştır ve yakın gelecekte hata verecektir. Tüm dokümanlarda yalnızca yeni biçimden bahsedilecek.

18 Kasım 2024 haftası

CreateAndConfigureAccountRequest.service.provider alanındaki sağlayıcı artık providers/GOOGLE_ADS veya providers/GOOGLE_BUSINESS_PROFILE de olabilir. Diğer hesaplar providers/123 (accounts/123 yerine) olarak adlandırılmalıdır. Bu, alanın artık hesap referansı olarak ek açıklama içermediği anlamına gelir. Ancak geriye dönük uyumluluk için accounts/123 gibi hesap adlarını kullanmak da mümkündür.

ListSubAccountsRequest içindeki sağlayıcı artık providers/123 biçiminde olmalıdır ancak geriye dönük uyumluluk için accounts/123 kullanmak hâlâ mümkün olacaktır.

4 Kasım 2024 haftası

BusinessIdentity kaynağında promotions_consent REQUIRED (OPTIONAL üzerinden) işaretleyin. Bu durum yalnızca güncelleme yöntemini etkiler. promotions_consent, UNSPECIFIED olarak güncellenemez. Bu işlem zaten yapılamıyordu ancak hata artık daha açıklayıcı ve alan doğru şekilde açıklanıyor.

28 Ekim 2024 haftası

User, Homepage, BusinessInfo gibi Accounts alt API'sinin çeşitli kaynaklarıyla ilgili belgeleri iyileştirme.

21 Ekim 2024 haftası

Güncelleme isteklerindeki update_mask alanlarının belgelerini iyileştirerek hangi alanların güncelleme için desteklendiğini açıkça belirtin.

Desteklenen operatörler için Google İşletme Yardım Merkezi bağlantısı, ShippingSettings kaynağının harici dokümanına eklendi.

14 Ekim 2024 haftası

AccountsService.CreateAndConfigureAccountRequest.AddAccountService içinde provider adlı öğeyi REQUIRED olarak işaretle.

update_mask parametresini Accounts alt API'sinde (ör. işletme kimliği, işletme bilgileri, ana sayfa vb.) ve geriye dönük olarak ConversionSources kaynağı için isteğe bağlı hale getirin.

overwrite parametresi ClaimHomepageRequest öğesine eklendi.

30 Eylül 2024 haftası

"Accounts.delete" yöntemi için "force" parametresinin kullanıma sunulması.

23 Eylül 2024 haftası

RetrieveLatestTermsOfServiceRequest içinde region_code ve kind öğelerini REQUIRED olarak işaretleyin.

16 Eylül 2024 haftası

ListAccountIssuesRequest içinde time_zone parametresinin türü dize olarak değiştirildi.

12 Ağustos 2024 haftası

BusinessInfo kaynağına korean_business_registration_number alanı eklendi.

27 Mayıs 2024 haftası

Accounts alt API'sinin beta sürümü