Informacje o wersji interfejsu Merchant Accounts API

Tydzień od 3 sierpnia 2026 r.

  • Dodaliśmy „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” (ograniczony dostęp).
  • Dodaliśmy obsługę rodzaju warunków korzystania z usługi „ucp_integration”.

Tydzień od 29 czerwca 2026 r.

Tydzień od 20 kwietnia 2026 r.

  • Dodaliśmy youtube-affiliate do listy dostępnych nazw programów w opisie zasobu accounts.programs.
  • Włącz interfejs API programu dla programu partnerskiego Zakupy na YouTube. Dostępne dla zaufanych testerów.

Tydzień od 6 kwietnia 2026 r.

  • Dodaliśmy 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. Jest używany, gdy oryginalna usługa CSS wymaga czasu na wykonanie niezbędnego czyszczenia, zanim konto zostanie w pełni przeniesione do nowej usługi CSS.

Tydzień od 16 marca 2026 r.

  • Uruchomiliśmy metodę CreateTestAccount w interfejsie Accounts API. Umożliwia ona programistom programowe tworzenie dedykowanych kont testowych, które działają w izolowanym środowisku podobnym do piaskownicy, zapewniając bezpieczne miejsce do tworzenia i testowania integracji.

Tydzień od 17 listopada 2025 r.

  • CreateAndConfigureAccountRequest oferuje teraz nowe usługi, które można skonfigurować podczas konfigurowania konta. Należy określić dokładnie jedną z tych usług: AccountAggregation, AccountManagement i ComparisonShopping. Dodatkowo można określić dowolną liczbę usług ProductsManagement i CampaignsManagement. Nie mogą jednak istnieć 2 takie usługi, które mają te same identyfikatory dostawcy i konta zewnętrznego.

  • Metoda AccountsService.CreateAndConfigure udostępnia teraz ustawienie, które pozwala określić, czy ma zostać wysłany e-mail weryfikacyjny.

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

  • Dodaliśmy 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 UserService, która umożliwia zmianę stanu z PENDING na VERIFIED w przypadku zasobu User reprezentującego użytkownika wykonującego połączenie.

  • Uruchomiliśmy nowe pole radius_area w ładunku Region interfejsu Regions API, które umożliwi sprzedawcom tworzenie regionów za pomocą obszaru promienia.

Tydzień od 10 listopada 2025 r.

  • Opublikowaliśmy wersję alfa 1 interfejsu Services API.
  • Uruchomiliśmy nowe pole product_filters w ładunku CampaignManagement interfejsu Services API, które umożliwi sprzedawcom udostępnianie tylko podzbioru pliku danych na kontach Google Ads na podstawie filtrowania warunkowego atrybutów produktów sprzedawcy. Jest to funkcja dostępna tylko dla wybranych sprzedawców.

Tydzień od 25 sierpnia 2025 r.

  • Dodaliśmy nowe metody zbiorcze do interfejsu Regions API:
    • BatchCreateRegions: umożliwia tworzenie wielu regionów w jednym żądaniu.
    • BatchUpdateRegions: umożliwia aktualizowanie wielu regionów w jednym żądaniu.
    • BatchDeleteRegions: umożliwia usuwanie wielu regionów według nazwy w jednym żądaniu.

Tydzień od 1 lipca 2025 r.

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

Tydzień od 26 maja 2025 r.

  • Można 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.

  • Uruchomiliśmy prawo 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 Program API, usuwając nieprawidłowe stwierdzenie, że metody Enable i Disable są ograniczone do administratorów.

Tydzień od 12 maja 2025 r.

  • Uruchomiliśmy zasób Online Return Policy, który umożliwia użytkownikom interfejsu API tworzenie, aktualizowanie i usuwanie zasad zwrotów.
  • Uruchomiliśmy usługę OmnichannelSettingsService i zasób OmnichannelSetting, które umożliwiają użytkownikom interfejsu API zarządzanie obsługą wielokanałową.
  • Uruchomiliśmy usługę LfpProvidersService i zasób LfpProvider, które umożliwiają użytkownikom interfejsu API zarządzanie relacjami w ramach programu Local Feeds Partnership.
  • Uruchomiliśmy usługę GbpAccountsService i zasób GbpAccount, które umożliwiają użytkownikom interfejsu API zarządzanie profilem firmy w Google.
  • Uruchomiliśmy typ usługi LocalListingManagement w usłudze 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.

  • Uruchomiliśmy usługę AccountService i zasoby AccountRelationship, które umożliwiają użytkownikom interfejsu API zarządzanie relacjami i ustanawianie usług dla usługodawców.

Tydzień od 14 kwietnia 2025 r.

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

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

  • Wyjaśniliśmy, że AccountsService.ListSubAccounts należy wywoływać w formacie accounts/... (a nie providers/...). Ma to na celu uniknięcie wyjścia tej metody poza zakres accounts (czyli GET accounts/123:listSubAccounts zamiast GET providers/123:listSubAccounts).

Tydzień od 31 marca 2025 r.

  • W przypadku filtrowania kont filtr externalAccountId został oznaczony jako wycofany w tygodniu od 2 grudnia 2024 r. i jest teraz niedostępny. Oznacza to, że filtrowanie według externalAccountId jest teraz możliwe tylko na poziomie service. Filtr taki jak relationship(externalAccountId = "foo") nie będzie już działać i należy go wyrazić jako relationship(service(externalAccountId = "foo")).

  • W dokumentacji AccountsService wyjaśniliśmy, że nie można tworzyć samodzielnych kont.

Tydzień od 3 marca 2025 r.

-Zmieniliśmy strukturę accounts.onlineReturnPolicies#SeasonalOverride , aby poprawić przejrzystość i spójność. Te zmiany obejmują:

  • Zmiana nazwy pola:
    • begin to teraz start_date.
    • end to teraz end_date.
  • Usunięcie pola:
    • Usunęliśmy wycofane pole policy.

-Programiści powinni zaktualizować swój kod, aby uwzględnić te zmiany.

Uruchomiliśmy usługę AutomaticImprovements, której możesz używać do zarządzania tymi elementami:

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

Tydzień od 17 lutego 2025 r.

Usunęliśmy predykat callerHasAccessToProviderFilter() z filtra konta.

Tydzień od 10 lutego 2025 r.

  • Ulepszyliśmy dokumentację metody AccountsService.List. Zwraca ona wszystkie konta, do których użytkownik ma dostęp, a nie tylko konta samodzielne.

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

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

  • User.accessRights jest teraz REQUIRED, co wpływa na metody UserService.Create i AccountsService.CreateAndConfigure.

Tydzień od 27 stycznia 2025 r.

AccountsService.ListAccounts (i pośrednio 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. CreateUserRequest, do którego się odwołujemy, zawiera 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 oznaczone jako OPTIONAL.

Pole domain w zwracanych błędach jest teraz wypełniane wartością merchantapi.googleapis.com zamiast global.

Tydzień od 2 grudnia 2024 r.

W przypadku filtrowania kont predykat externalAccountId został przeniesiony 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 wycofany i wkrótce będzie zgłaszać błąd. Cała dokumentacja będzie zawierać tylko nowy format.

Tydzień od 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 należy określać jako providers/123 (a nie accounts/123). Oznacza to, że pole nie jest już oznaczone jako odniesienie 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 postać providers/123, ale ze względu na zgodność wsteczną nadal będzie można używać accounts/123.

Tydzień od 4 listopada 2024 r.

Oznaczyliśmy promotions_consent jako REQUIRED (z OPTIONAL) w zasobie BusinessIdentity. Dotyczy to tylko metody aktualizacji. Ma to na celu wyjaśnienie, ż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.

Ulepszyliśmy dokumentację różnych zasobów podrzędnego interfejsu Accounts API, takich jak User, Homepage, BusinessInfo itp.

Tydzień od 21 października 2024 r.

Ulepszyliśmy dokumentację pól update_mask w żądaniach aktualizacji, aby wyraźnie wskazać, które pola są obsługiwane w przypadku aktualizacji.

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

Tydzień od 14 października 2024 r.

Oznaczyliśmy provider jako REQUIRED w AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

Uczyniliśmy update_mask opcjonalnym w całym podrzędnym interfejsie Accounts API (np. tożsamość firmy, informacje o firmie, strona główna itp.) oraz wstecznie w przypadku zasobu ConversionSources.

Dodaliśmy parametr overwrite do ClaimHomepageRequest.

Tydzień od 30 września 2024 r.

Uruchomiliśmy parametr „force” dla metody „Accounts.delete”.

Tydzień od 23 września 2024 r.

Oznaczyliśmy region_code i kind jako REQUIRED w RetrieveLatestTermsOfServiceRequest.

Tydzień od 16 września 2024 r.

Zmieniliśmy typ parametru time_zone na ciąg znaków w ListAccountIssuesRequest.

Tydzień od 12 sierpnia 2024 r.

Dodaliśmy pole korean_business_registration_number do zasobu BusinessInfo.

Tydzień od 27 maja 2024 r.

Uruchomiliśmy wersję beta podrzędnego interfejsu Accounts API.