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

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 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 iş ortaklığı 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 idi).

  • 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 (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, 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, kaynak açıklamasına accounts.programs 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 nihai olarak 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 kullanımdan kaldı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ı netleştirmek 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) dokümanlarını iyileştirin.

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 net bir şekilde 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ı öğeyi 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ı

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ü