Informacje o wersji interfejsu Merchant Accounts API

Tydzień zaczynający się 1 lipca 2025 r.

  • Uruchomienie zasobu CheckoutSettings, który umożliwia użytkownikom interfejsu API tworzenie, aktualizowanie, usuwanie i pobieranie ustawień płatności.

Tydzień rozpoczynający się 26 maja 2025 r.

  • Możesz teraz filtrować konta według capabilities. Obecnie jedyną możliwą wartością jest CAN_UPLOAD_PRODUCTS. Ten filtr umożliwia pobieranie kont, na których można przesyłać produkty. Oznacza to, że na poziomie konta można teraz używać tych klauzul:

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS Więcej informacji znajdziesz w przewodniku po filtrowaniu.

  • Wprowadzenie uprawnień dostępu tylko do odczytu. Użytkownicy z uprawnieniami dostępu tylko do odczytu mogą wyświetlać dane sprzedawcy, ale nie mogą ich modyfikować.

Tydzień od 19 maja 2025 r.

  • Zaktualizowaliśmy dokumentację interfejsu API programu, usuwając nieprawdziwe stwierdzenie, że metody Enable/Disable są ograniczone do użytkowników z uprawnieniami administracyjnymi.

Tydzień zaczynający się 12 maja 2025 r.

  • Uruchomienie zasobu Zasady zwrotów online, który umożliwia użytkownikom interfejsu API tworzenie, aktualizowanie i usuwanie zasad zwrotów.
  • Uruchomienie usługi OmnichannelSettingsService i zasobu OmnichannelSetting, które umożliwiają użytkownikom interfejsu API zarządzanie środowiskiem wielokanałowym.
  • Uruchomienie usługi LfpProvidersService i zasobu LfpProvider, które umożliwiają użytkownikom interfejsu API zarządzanie relacjami w ramach programu Local Feeds Partnership.
  • Uruchomienie usługi GbpAccountsService i zasobu GbpAccount, które umożliwiają użytkownikom interfejsu API zarządzanie profilem firmy w Google.
    • Uruchom usługę LocalListingManagement w AccountService, która łączy grupę firm używaną w reklamach lokalnego asortymentu produktów lub bezpłatnych lokalnych informacjach.

Tydzień od 28 kwietnia 2025 r.

  • Uruchomienie zasobów AccountService i AccountRelationship, które umożliwiają użytkownikom interfejsu API zarządzanie relacjami i ustanawianie usług dla dostawców usług.

Tydzień od 14 kwietnia 2025 r.

  • TermsOfServiceService.AcceptTermsOfService zwraca teraz zaakceptowany element TermsOfServiceAgremeentState opakowany w typ odpowiedzi.

  • Czasownik działania TermsOfServiceService.AcceptTermsOfService to teraz POST (wcześniej GET).

  • Wyjaśniliśmy, że wywołanie funkcji AccountsService.ListSubAccounts musi mieć format accounts/... (a nie providers/...). Ma to zapobiec wyjściu tej metody poza zakres accounts (czyli GET accounts/123:listSubAccounts zamiast GET providers/123:listSubAccounts).

Tydzień od 31 marca 2025 r.

  • W przypadku kont filtrujących filtr externalAccountId został wycofany w tygodniu rozpoczynającym się 2 grudnia 2024 r. i jest obecnie niedostępny. Oznacza to, że filtrowanie według externalAccountId jest teraz możliwe tylko na poziomie service. Filtr taki jak relationship(externalAccountId = "foo") przestanie działać i trzeba go będzie zastąpić filtrem relationship(service(externalAccountId = "foo")).

  • W AccountsService dokumentacji wyjaśniono, że nie można tworzyć kont autonomicznych.

Tydzień od 3 marca 2025 r.

– accounts.onlineReturnPolicies#SeasonalOverride został zmodyfikowany, aby zwiększyć jego przejrzystość i spójność. W skład tych aktualizacji wchodzą:

  • Zmiana nazwy pola:
    • begin to teraz start_date.
    • end to teraz end_date.
  • Usuwanie pól:
    • Wycofane pole policy zostało usunięte.

– Deweloperzy powinni zaktualizować kod, aby uwzględniał te zmiany.

Uruchomienie usługi AutomaticImprovements, która umożliwia zarządzanie tymi elementami:

Więcej informacji znajdziesz w artykule Włączanie automatycznych ulepszeń.

Tydzień rozpoczynający się 17 lutego 2025 r.

Usunięto predykat callerHasAccessToProviderFilter() z filtra konta.

Tydzień od 10 lutego 2025 r.

  • Ulepszona dokumentacja metody AccountsService.List. Zwraca wszystkie konta, do których użytkownik ma dostęp, a nie tylko konta samodzielne.

  • Dodano domyślny termin 10 minut dla wszystkich metod RPC.

  • Dodaliśmy listę dostępnych nazw programów do opisu zasobu accounts.programs.

  • User.accessRights to teraz REQUIRED, co ma wpływ na metody UserService.Create i AccountsService.CreateAndConfigure.

Tydzień od 27 stycznia 2025 r.

AccountsService.ListAccounts (i przechodnio AccountsService.ListSubAccounts) zwracają teraz konta w sposób ostatecznie spójny, a nie jako silny odczyt.

Tydzień od 20 stycznia 2025 r.

Pole users w CreateAndConfigureAccountRequest zostało wycofane i zastąpione nowym polem user. Odwołanie CreateUserRequest zawiera pole parent, które nie jest wymagane w kontekście CreateAndConfigureAccountRequest.

Tydzień zaczynający się 6 stycznia 2025 r.

Pole user wiadomości CreateUserRequest jest teraz prawidłowo oznaczone jako OPTIONAL.

Pole domain w zwracanych błędach zawiera teraz wartość merchantapi.googleapis.com zamiast global.

Tydzień rozpoczynający się 2 grudnia 2024 r.

W przypadku filtrowania kont predykat externalAccountId jest przenoszony z poziomu relationship na poziom service. Dlatego filtr relationship(externalAccountId = "foo") należy teraz zapisać jako relationship(service(externalAccountId = "foo")). Stary format jest nadal obsługiwany ze względu na zgodność z wcześniejszymi wersjami, ale jest już przestarzały i w najbliższej przyszłości będzie powodować błędy. W dokumentacji będzie wspominany tylko nowy format.

Tydzień zaczynający się 18 listopada 2024 r.

Dostawcą w polu CreateAndConfigureAccountRequest.service.provider może być teraz też providers/GOOGLE_ADS lub providers/GOOGLE_BUSINESS_PROFILE. Inne konta powinny być oznaczane jako providers/123 (a nie accounts/123). Oznacza to, że pole nie jest już oznaczone jako odwołanie do konta. Ze względu na zgodność wsteczną nadal można jednak używać nazw kont, takich jak accounts/123.

Dostawca w ListSubAccountsRequest powinien mieć teraz format providers/123, ale ze względu na zgodność wsteczną nadal będzie można używać accounts/123.

Tydzień zaczynający się 4 listopada 2024 r.

Oznacz promotions_consent REQUIRED (z OPTIONAL) w BusinessIdentity zasobie. Dotyczy to tylko metody aktualizacji. Chcemy wyjaśnić, że nie można zmienić promotions_consent na UNSPECIFIED. Nie było to już możliwe, ale błąd jest teraz bardziej opisowy, a pole jest prawidłowo oznaczone.

Tydzień od 28 października 2024 r.

Ulepszyliśmy dokumentację różnych zasobów interfejsu sub-API kont, takich jak User, Homepage, BusinessInfo itp.

Tydzień zaczynający się 21 października 2024 r.

Ulepsz dokumentację pól update_mask w żądaniach aktualizacji, aby wskazywać, które pola są obsługiwane w przypadku aktualizacji.

Dodano link do Centrum pomocy Google dla firm w przypadku obsługiwanych operatorów do zewnętrznego dokumentu zasobu ShippingSettings

Tydzień zaczynający się 14 października 2024 r.

Oznacz provider jako REQUIRED w AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

Ustawienie update_mask jako opcjonalne w całym interfejsie API podrzędnym Kont (np. tożsamość firmy, informacje o firmie, strona główna itp.) i wstecznie w przypadku zasobu ConversionSources.

Dodano parametr overwrite do ClaimHomepageRequest.

Tydzień od 30 września 2024 r.

Wprowadzenie parametru „force” dla metody „Accounts.delete”.

Tydzień rozpoczynający się 23 września 2024 r.

Oznacz region_code i kind jako REQUIRED w RetrieveLatestTermsOfServiceRequest.

Tydzień od 16 września 2024 r.

Zmieniono typ parametru time_zone na ciąg znaków w pliku ListAccountIssuesRequest

Tydzień zaczynający się 12 sierpnia 2024 r.

Dodano pole korean_business_registration_number do zasobu BusinessInfo.

Tydzień od 27 maja 2024 r.

Wprowadzenie wersji beta interfejsu API podrzędnego Accounts