Informacje o wersji interfejsu Merchant Accounts API

Tydzień zaczynający się 28 września 2026 r.

Wprowadzenie wersji alfa usługi LoyaltyPrograms, która umożliwia zarządzanie programami lojalnościowymi. Ta funkcja jest dostępna tylko dla wybranych sprzedawców. Więcej informacji znajdziesz w omówieniu programów lojalnościowych.

Tydzień rozpoczynający się 3 sierpnia 2026 r.

  • Dodano „ucp_checkout_management” jako typ usługi do zasobu usługi konta. Uwaga: płatność UCP to funkcja z ograniczonym dostępem.
  • Dodaliśmy obsługę programu „ucp-integration” (dostęp ograniczony).
  • Dodaliśmy obsługę rodzaju warunków korzystania z usługi „ucp_integration”.

Tydzień rozpoczynający się 29 czerwca 2026 r.

Tydzień zaczynający się 20 kwietnia 2026 r.

  • Dodano youtube-affiliate do listy dostępnych nazw programów w accounts.programs opisie zasobu.
  • Włącz interfejs API programu dla partnerów Zakupów na YouTube. Dostępna dla zaufanych testerów.

Tydzień zaczynający się 6 kwietnia 2026 r.

  • Dodano stan WAITING do stanu zatwierdzenia. W przypadku usług porównywania cen (CSS) stan WAITING jest stanem przejściowym między stanami PENDING i ESTABLISHED. Używane, gdy oryginalna usługa porównywania cen potrzebuje czasu na przeprowadzenie niezbędnych działań porządkowych przed pełnym przeniesieniem konta do nowej usługi porównywania cen.

Tydzień zaczynający się 16 marca 2026 r.

  • Udostępniliśmy metodę CreateTestAccount w interfejsie Accounts API. Umożliwia to programistom tworzenie dedykowanych kont testowych, które działają w izolowanym środowisku podobnym do piaskownicy, zapewniając bezpieczną przestrzeń do tworzenia i testowania integracji.

Tydzień zaczynający się 17 listopada 2025 r.

  • CreateAndConfigureAccountRequest oferuje teraz nowe usługi, które można skonfigurować podczas zakładania konta. Należy podać tylko jedną z tych wartości: AccountAggregation, AccountManagement lub ComparisonShopping. Dodatkowo można określić dowolną liczbę usług ProductsManagement i CampaignsManagement. Nie mogą jednak istnieć 2 takie usługi, które mają tego samego dostawcę i identyfikatory konta zewnętrznego.

  • Metoda AccountsService.CreateAndConfigure ma teraz ustawienie, które pozwala określić, czy należy wysłać e-maila weryfikacyjnego.

  • CreateAndConfigureAccountRequest.AddAccountService ma teraz pole external_account_id (to pole istnieje już w zasobie AccountService). Można go określić razem z usługami CampaignsManagement i ProductsManagement.

  • Dodano usługę ComparisonShopping do zasobu AccountService. Więcej informacji znajdziesz na stronie https://support.google.com/merchants/answer/12653197.

  • Podczas tworzenia konta można teraz ustawić alias relacji za pomocą pola setAlias w CreateAndConfigureAccountRequest.

  • Dodaliśmy metodę VerifySelf do interfejsu UserService, która umożliwia aktualizowanie stanu z PENDING na VERIFIED w przypadku zasobu User reprezentującego użytkownika wykonującego połączenie.

  • Wprowadzenie nowego pola radius_area w ładunku Region interfejsu Regions API, które umożliwi sprzedawcom tworzenie regionów na podstawie obszaru o określonym promieniu.

Tydzień zaczynający się 10 listopada 2025 r.

  • Opublikuj wersję alfa 1 interfejsu Services API.
  • Wprowadzimy nowe pole product_filters w CampaignManagementładunku interfejsu Services API, które umożliwi sprzedawcom udostępnianie kontom Google Ads tylko podzbioru pliku danych na podstawie filtrowania warunkowego atrybutów produktów sprzedawcy. Jest to funkcja dostępna tylko dla sprzedawców znajdujących się na liście dozwolonych.

Tydzień zaczynający się 25 sierpnia 2025 r.

  • Nowe metody wsadowe dodane do interfejsu Regions API:
    • BatchCreateRegions: umożliwia utworzenie wielu regionów w ramach jednego żądania.
    • BatchUpdateRegions: umożliwia aktualizowanie wielu regionów w ramach jednego żądania.
    • BatchDeleteRegions: umożliwia usunięcie wielu regionów według nazwy w jednym żądaniu.

Tydzień od 1 lipca 2025 r.

  • Wprowadzenie 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 prawem 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ń rozpoczynają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 wrażeniami w wielu kanałach.
  • 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 typ usługi LocalListingManagement w AccountService, który łą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 być zgodne z formatem 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 już 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 dokumentacji AccountsService wyjaśniliśmy, że nie można tworzyć kont autonomicznych.

Tydzień od 3 marca 2025 r.

– accounts.onlineReturnPolicies#SeasonalOverride została zmodyfikowana, aby zwiększyć jej przejrzystość i spójność. Obejmują one:

  • 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ędnić 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ń zaczynają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ń rozpoczynający się 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 na rzecz nowego pola user. W odwołaniu do CreateUserRequest znajduje się pole parent, które nie jest wymagane w kontekście CreateAndConfigureAccountRequest.

Tydzień od 6 stycznia 2025 r.

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

Pole domain w zwracanych błędach jest teraz wypełniane wartością 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. Filtr relationship(externalAccountId = "foo") należy teraz zapisać jako relationship(service(externalAccountId = "foo")). Stary format jest nadal obsługiwany ze względu na zgodność wsteczną, ale jest wycofywany i w najbliższej przyszłości będzie zgłaszać błąd. W całej dokumentacji będzie mowa tylko o nowym formacie.

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

Usługodawcą 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. Możesz jednak nadal używać nazw kont, takich jak accounts/123, aby zachować zgodność wsteczną.

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

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

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

Tydzień od 28 października 2024 r.

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

Tydzień rozpoczynają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.

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

Tydzień rozpoczynają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 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” w metodzie „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.

Uruchomienie wersji beta interfejsu API kont