Informacje o wersji interfejsu Merchant Accounts API

Tydzień od 26 października 2026 r.

  • Uzupełniliśmy dokumentację dotyczącą metody accounts.homepage.unclaim i pola claimed zasobu Homepage. Jeśli konto dziedziczy prawa do strony głównej z konta zaawansowanego, unclaim zwraca odpowiedź o powodzeniu, ale strona główna pozostaje objęta prawami. Jeśli konto jest wyłączone z możliwości zgłaszania roszczeń, unclaim zwraca błąd FAILED_PRECONDITION.

Tydzień od 28 września 2026 r.

  • Dodano youtube_affiliate_management jako typ usługi do zasobu AccountService w: v1alpha. Uwaga: zarządzanie podmiotami stowarzyszonymi w YouTube to funkcja z ograniczonym dostępem.

  • Wprowadzamy wersję alfa usługi LoyaltyPrograms, której możesz używać do zarządzania programami lojalnościowymi. Ta funkcja jest dostępna tylko dla wybranych sprzedawców. Więcej informacji znajdziesz w artykule Omówienie programów lojalnościowych.

  • Dodano pole home_page_uri tylko do odczytu do zasobu accounts, aby zwracać identyfikator URI strony głównej sklepu.

Tydzień od 3 sierpnia 2026 r.

  • Dodano „ucp_checkout_management” jako typ usługi do zasobu usługi konta. Uwaga: płatność na platformie 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.

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

Tydzień od 6 kwietnia 2026 r.

  • Dodano stan WAITING do stanu zatwierdzenia. W przypadku usług porównywania cen (CSS) WAITING to stan przejściowy między PENDING a ESTABLISHED. Używane, gdy pierwotna usługa porównywania cen potrzebuje czasu na przeprowadzenie niezbędnych działań porządkowych, zanim konto zostanie w pełni przeniesione do nowej usługi porównywania cen.

Tydzień od 16 marca 2026 r.

  • Wprowadziliśmy metodę CreateTestAccount w interfejsie Accounts API. Dzięki temu deweloperzy mogą automatycznie tworzyć dedykowane konta testowe, które działają w odizolowanym środowisku przypominającym piaskownicę, co zapewnia 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ć dokładnie jedną z tych wartości: AccountAggregation, AccountManagement lub ComparisonShopping. Można też określić dowolną liczbę usług ProductsManagement i CampaignsManagement. Nie mogą jednak istnieć 2 takie usługi, które mają tego samego dostawcę i te same identyfikatory kont zewnętrznych.

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

  • Zasób CreateAndConfigureAccountRequest.AddAccountService ma teraz pole external_account_id (to pole już istnieje 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.

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

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

  • Wprowadź nowe pole radius_area w ładunku Region interfejsu Regions API, które umożliwi sprzedawcom tworzenie regionu za pomocą obszaru promienia.

Tydzień od 10 listopada 2025 r.

  • Opublikuj wersję v1alpha interfejsu Services API.
  • Wprowadź nowe pole product_filters w danych CampaignManagement interfejsu Services API, które umożliwi sprzedawcom udostępnianie kontom Google Ads tylko podzbioru ich pliku danych na podstawie filtrowania warunkowego atrybutów produktów sprzedawcy. Ta funkcja jest dostępna tylko dla kont znajdujących się na liście dozwolonych i może z niej korzystać tylko ograniczona liczba sprzedawców.

Tydzień od 25 sierpnia 2025 r.

  • Do interfejsu Regions API dodano nowe metody zbiorcze:
    • BatchCreateRegions: umożliwia tworzenie wielu regionów w jednym żądaniu.
    • BatchUpdateRegions: umożliwia aktualizowanie wielu regionów w jednym żądaniu.
    • 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ń od 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, które mogą 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 dostępem 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 nieprawidłowe stwierdzenie, że metody Enable/Disable są ograniczone do administratorów.

Tydzień od 12 maja 2025 r.

  • Udostępniliśmy zasób Online Return Policy, który umożliwia użytkownikom interfejsu API tworzenie, aktualizowanie i usuwanie zasad zwrotów.
  • Wprowadzenie usługi OmnichannelSettingsService i zasobu OmnichannelSetting, które umożliwiają użytkownikom interfejsu API zarządzanie wielokanałowością.
  • Uruchomienie usługi LfpProvidersService i zasobu LfpProvider, które umożliwiają użytkownikom interfejsu API zarządzanie relacjami w ramach programu partnerskiego dotyczącego lokalnych plików danych.
  • Wprowadzenie 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ę firmową używaną w reklamach lokalnego asortymentu produktów lub bezpłatnych lokalnych informacjach.

Tydzień od 28 kwietnia 2025 r.

  • Wprowadzenie 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 obiekt TermsOfServiceAgremeentState opakowany w typ odpowiedzi.

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

  • Wyjaśniliśmy, że metodę AccountsService.ListSubAccounts należy wywoływać w formacie accounts/... (a nie providers/...). Ma to na celu uniknięcie sytuacji, w której ta metoda wykracza poza zakres accounts (czyli GET accounts/123:listSubAccounts, a nie GET providers/123:listSubAccounts).

Tydzień od 31 marca 2025 r.

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

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

Tydzień od 3 marca 2025 r.

– accounts.onlineReturnPolicies#SeasonalOverride zostały poddane refaktoryzacji, aby były bardziej przejrzyste i spójne. 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ć swój kod, aby odzwierciedlić te zmiany.

Uruchomienie usługi AutomaticImprovements, której możesz używać do zarządzania:

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

Tydzień od 17 lutego 2025 r.

Usunięto z filtra konta predykat callerHasAccessToProviderFilter().

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.

  • Dodano listę dostępnych nazw programów do opisu zasobu accounts.programs.

  • User.accessRights to teraz REQUIRED, co wpływa zarówno na metodę UserService.Create, jak i AccountsService.CreateAndConfigure.

Tydzień od 27 stycznia 2025 r.

AccountsService.ListAccounts (oraz przejściowo AccountsService.ListSubAccounts) zwracają teraz konta w sposób spójności wynikowej, a nie jako silny odczyt.

Tydzień od 20 stycznia 2025 r.

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

Tydzień od 6 stycznia 2025 r.

Pole user komunikatu 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") trzeba teraz zapisać jako relationship(service(externalAccountId = "foo")). Stary format jest nadal obsługiwany ze względu na zgodność wsteczną, ale został wycofany i w najbliższej przyszłości będzie powodować błąd. Wszystkie dokumenty będą zawierać tylko nowy format.

Tydzień od 18 listopada 2024 r.

Dostawca w polu CreateAndConfigureAccountRequest.service.provider może teraz być również jednym z tych: providers/GOOGLE_ADS lub providers/GOOGLE_BUSINESS_PROFILE. Inne konta powinny być określane jako providers/123 (a nie accounts/123). Oznacza to, że pole nie jest już oznaczone jako odwołanie do konta. Jednak ze względu na zgodność wsteczną nadal można 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.

Oznacz gościa promotions_consent REQUIRED (z OPTIONAL) w zasobie BusinessIdentity. Ma to wpływ tylko na metodę aktualizacji. Chcemy wyjaśnić, że nie można zaktualizować promotions_consent do UNSPECIFIED. Już wcześniej nie było to 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 interfejsu sub-API kont, takich jak User, Homepage, BusinessInfo itd.

Tydzień od 21 października 2024 r.

Ulepszyliśmy dokumentację dotyczącą pól update_mask w żądaniach aktualizacji, aby wyraźnie wskazać, które pola można aktualizować.

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

Tydzień od 14 października 2024 r.

Oznacz provider jako REQUIRED w AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

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

Dodano parametr overwrite do: ClaimHomepageRequest.

Tydzień od 30 września 2024 r.

Wprowadzenie parametru „force” w metodzie „Accounts.delete”.

Tydzień od 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 ListAccountIssuesRequest

Tydzień od 12 sierpnia 2024 r.

Dodano pole korean_business_registration_number do zasobu BusinessInfo.

Tydzień od 27 maja 2024 r.

Wersja beta interfejsu Accounts sub-API