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

17 Kasım 2025 haftası

  • CreateAndConfigureAccountRequest artık hesap kurulumu sırasında yapılandırılabilen yeni hizmetler sunuyor. Tam olarak bir AccountAggregation, AccountManagement ve ComparisonShopping 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 adresini ziyaret edin.

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

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

10 Kasım 2025 haftası

  • Hizmetler API'sinin v1alpha sürümünü yayınlayın.
  • Services API'nin CampaignManagement yükünde yeni product_filters alanını kullanıma sunun. Bu alan, satıcıların feed'lerinin yalnızca bir alt kümesini Google Ads hesaplarıyla paylaşmasına olanak tanır. Bu işlem, satıcının ürünlerinin özellikleriyle ilgili bazı koşullu filtrelemelere göre yapılır. Bu özellik yalnızca sınırlı sayıda satıcının erişebildiği, izin verilenler listesine eklenmiş bir özelliktir.

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 filtrelemek mümkündür. Ş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 okuma 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'si 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'ler İş 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önetmelerine 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 hizmetler 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 2 Aralık 2024 haftasında sonlandırılacağı duyurulmuştu ve bu filtre artık kullanılamıyor. Bu nedenle, artık externalAccountId ile filtreleme 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 anlaşılır 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 10 dakikalık son tarih 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 zorunlu 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 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 belgelerde 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 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. Bu, promotions_consent öğesinin UNSPECIFIED olarak güncellenmesinin mümkün olmadığını açıklamak içindir. Bu işlem 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 update_mask'yı isteğe bağlı hale getirin.ConversionSources

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ı

region_code ve kind öğelerini RetrieveLatestTermsOfServiceRequest içinde 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ı

BusinessInfo kaynağına korean_business_registration_number alanı eklendi.

27 Mayıs 2024 haftası

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