Informacje o wersji interfejsu Merchant Accounts API

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

  • Wprowadziliśmy metodę CreateTestAccount w interfejsie Accounts API. Umożliwia to programistom tworzenie dedykowanych kont testowych, które działają w odizolowanym środowisku podobnym do piaskownicy, 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 jeden z tych atrybutów: AccountAggregation, AccountManagement lub ComparisonShopping. Dodatkowo możesz 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 kontrolować, 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 ją 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.

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

  • Wprowadzimy nowe pole radius_area w ładunku Region interfejsu Regions API, które umożliwi sprzedawcom tworzenie regionów za pomocą obszaru o określonym promieniu.

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

  • Opublikuj wersję alfa 1 interfejsu Services API.
  • Wprowadzenie nowego pola 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 z listy 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 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 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 ś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 TermsOfServiceAgremeentState, które zostało zaakceptowane i zawiera 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 filtrowania kont 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") nie będzie już działać i trzeba go będzie zastąpić filtrem relationship(service(externalAccountId = "foo")).

  • W dokumentacji AccountsService 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ę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ń 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 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. Odwołanie CreateUserRequest zawiera pole parent, które nie jest wymagane w kontekście CreateAndConfigureAccountRequest.

Tydzień od 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ść wsteczną, ale jest wycofany i w najbliższej przyszłości będzie zgłaszać błąd. W całej 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. Można jednak nadal używać nazw kont, takich jak accounts/123, aby zachować zgodność wsteczną.

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

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.

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 Accounts API (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ń zaczynają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 do wersji beta interfejsu API kont