Informacje o wersji interfejsu Merchant Accounts API

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. Funkcja dostępna 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 porównywania cen potrzebuje czasu na wykonanie niezbędnych czynności czyszczących, zanim konto zostanie w pełni przeniesione do nowej usługi porównywania cen.

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 należy wysłać e-maila weryfikacyjnego.

  • 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.

  • Opublikuj 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.

  • Uruchomienie zasobu 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.

  • Uruchomienie prawa 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.

  • Uruchomienie zasobu Online Return Policy, 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 obsługą wielokanałową.
  • Uruchomienie usługi LfpProvidersService i zasobu LfpProvider, które umożliwiają użytkownikom interfejsu API zarządzanie relacjami w ramach partnerstwa w zakresie lokalnych plików danych.
  • Uruchomienie usługi GbpAccountsService i zasobu GbpAccount, które umożliwiają użytkownikom interfejsu API zarządzanie profilem firmy w Google.
  • Uruchomienie typu usługi 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 usługi AccountService i zasobów 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 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 zwiększyć 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ć kod, aby uwzględniał te zmiany.

Uruchomienie usługi 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 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. 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 powodować 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 komunikat o błędzie 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. w przypadku tożsamości firmy, informacji o firmie, strony głównej 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.

Uruchomienie wersji beta podrzędnego interfejsu Accounts API