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

25 Ağustos 2025 haftası

  • Bölgeler API'sine yeni toplu iş yöntemleri 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 sarmalanmış 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çindir (GET accounts/123:listSubAccounts yerine GET providers/123:listSubAccounts).

31 Mart 2025 haftası

  • Hesapları filtrelemek için kullanılan externalAccountId filtresinin desteğinin 2 Aralık 2024 haftasında sonlandırıldığı 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 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öntemi için 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 ve 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 hesap 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") filtresi artık relationship(service(externalAccountId = "foo")) olarak yazılmalıdır. Eski biçim, geriye dönük uyumluluk için hâlâ destekleniyor ancak desteği sonlandırıldı ve yakın gelecekte hata verecek. 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 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ı kullanmaya devam edebilirsiniz.

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 alt API'sinin beta sürümü