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

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şebildiğiniz 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ı

  • youtube-affiliate, accounts.programs kaynak açıklaması için kullanılabilir program adları listesine eklendi.
  • YouTube Alışveriş satış ortağı programı için program API'sini etkinleştirin. Güvenilir test kullanıcıları tarafından kullanılabilir.

6 Nisan 2026 haftası

  • Onay durumuna WAITING durumu eklendi. Karşılaştırmalı Alışveriş Hizmetleri (CSS) için WAITING, PENDING ve ESTABLISHED arasındaki geçiş durumudur. Hesap yeni CSS'ye tamamen aktarılmadan önce orijinal CSS'nin gerekli temizliği yapması gerektiğinde 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. Bu da entegrasyonları geliştirmek ve test etmek için güvenli bir alan sağlar.

17 Kasım 2025 haftası

  • CreateAndConfigureAccountRequest artık hesap kurulumu sırasında yapılandırılabilen yeni hizmetler sunuyor. Tam olarak AccountAggregation, AccountManagement ve ComparisonShopping özelliklerinden biri belirtilmelidir. Ayrıca, istenen sayıda ProductsManagement ve CampaignsManagement hizmeti belirtmek de mümkündür. Ancak aynı sağlayıcıya ve harici hesap kimliklerine sahip iki hizmet olmamalıdır.

  • AccountsService.CreateAndConfigure yöntemi artık doğrulama e-postası gönderilip gönderilmeyeceğini kontrol etmenizi sağlayan 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 adresine bakın.

  • Artık CreateAndConfigureAccountRequest'daki setAlias alanı kullanılarak hesap oluşturma sırasında bir ilişki için takma ad ayarlamak mümkün.

  • Arayan kullanıcıyı temsil eden User kaynağının durumunu PENDING'dan VERIFIED'ye güncellemeye olanak tanıyan VerifySelf yöntemi UserService'ye eklendi.

  • Bölgeler API'sinin Region yükünde, satıcıların yarıçap alanını kullanarak bölge oluşturmasına olanak tanıyan yeni radius_area alanını kullanıma sunun.

10 Kasım 2025 haftası

  • Services API'nin v1alpha sürümünü yayınlayın.
  • Services API'nin CampaignManagement yükünde yeni bir product_filters alanı kullanıma sunulacak. Bu alan, satıcıların feed'lerinin yalnızca bir alt kümesini Google Ads hesaplarıyla paylaşmasına olanak tanıyacak. Bu işlem, satıcının ürünlerinin özellikleriyle ilgili bazı koşullu filtrelemelere göre yapılacak. Bu özellik yalnızca izin verilenler listesindeki sınırlı sayıda satıcı tarafından kullanılabilir.

25 Ağustos 2025 haftası

  • Bölgeler API'sine yeni toplu işlemler 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 ödeme ayarlarını 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 tek olası değer CAN_UPLOAD_PRODUCTS'dır. Bu filtre, ürün yükleyebilen hesapları almanıza olanak tanır. Bu nedenle, aşağıdaki maddeler artık hesap düzeyinde kullanılabilir:

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS Daha fazla bilgi için filtreleme kılavuzuna bakın.

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

19 Mayıs 2025 haftası

  • Program API'siyle ilgili dokümanlar güncellendi. Enable/Disable yöntemlerinin yönetici kullanıcılarla sınırlı 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 İade Politikası 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 İş Ortağı ilişkilerini yönetmelerine 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 LocalListingManagement hizmet türünü başlatın. Bu hizmet türü, yerel envanter reklamları veya ücretsiz yerel listelemeler için kullanılan işletme grubunu bağlar.

28 Nisan 2025 haftası

  • API kullanıcılarının ilişkileri yönetmesine ve hizmet 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 yanıt türüne sarılmış olarak kabul edilen TermsOfServiceAgremeentState değerini döndürüyor.

  • TermsOfServiceService.AcceptTermsOfService işleminin fiili artık POST (önceden GET olarak kullanılıyordu).

  • AccountsService.ListSubAccounts yönteminin accounts/... biçiminde (providers/... yerine) çağrılması gerektiği netleştirildi. Bu, yöntemin accounts kapsamı dışında kalmasını önlemek için yapıldı (yani GET providers/123:listSubAccounts yerine GET accounts/123:listSubAccounts).

31 Mart 2025 haftası

  • Hesapları filtrelemek için kullanılan externalAccountId filtresinin desteğinin sonlandırılacağı 2 Aralık 2024 haftasında duyurulmuştu ve bu filtre artık kullanılamıyor. Bu nedenle, externalAccountId ile filtreleme artık yalnızca service düzeyinde mümkündür. relationship(externalAccountId = "foo") gibi bir filtre artık çalışmayacak ve relationship(service(externalAccountId = "foo")) olarak ifade edilmesi gerekecek.

  • AccountsService dokümanlarında bağımsız hesap oluşturulamayacağı netleştirildi.

3 Mart 2025 haftası

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

  • Alan 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üncellemeli.

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ı

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

10 Şubat 2025 haftası

  • AccountsService.List yöntemiyle ilgili dokümanlar 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 varsayılan son tarih 10 dakika olarak eklendi.

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

  • User.accessRights artık REQUIRED olup 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 olmak yerine sonuçta tutarlı bir şekilde hesapları döndürüyor.

20 Ocak 2025 haftası

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

6 Ocak 2025 haftası

CreateUserRequest iletisinin 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 koşulu, 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 bahsedilir.

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 accounts/123 yerine providers/123 olarak adlandırılmalıdır. Bu, alanın artık hesap referansı olarak açıklama eklenmediğ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 kullanmaya devam edebilirsiniz.

4 Kasım 2024 haftası

BusinessIdentity kaynağında promotions_consent REQUIRED (OPTIONAL) öğesini işaretleyin. Bu durum yalnızca güncelleme yöntemini etkiler. promotions_consent öğesinin UNSPECIFIED olarak güncellenmesinin mümkün olmadığını belirtmek isteriz. Bu zaten mümkün değildi ancak hata artık daha açıklayıcı ve alan doğru şekilde açıklama eklenmiş durumda.

28 Ekim 2024 haftası

Hesaplar alt API'sinin çeşitli kaynaklarının (ör. User, Homepage, BusinessInfo) belgelerini iyileştirme

21 Ekim 2024 haftası

Güncelleme isteklerindeki update_mask alanlarının dokümanlarını iyileştirerek hangi alanların güncelleme için desteklendiğini özellikle 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ı

provider adlı kartı AccountsService.CreateAndConfigureAccountRequest.AddAccountService içinde REQUIRED olarak işaretle.

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

ClaimHomepageRequest listesine overwrite parametresi 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ı

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

12 Ağustos 2024 haftası

korean_business_registration_number alanı, BusinessInfo kaynağına eklendi.

27 Mayıs 2024 haftası

Accounts sub-API'nin beta sürümü kullanıma sunuldu