Informacje o wersji interfejsu Merchant Accounts API

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 tworzenie 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ń rozpoczynający się 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ń 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 uprawnieniami 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ń zaczynają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 był to GET).

• Wyjaśniliśmy, że wywołanie funkcji AccountsService.ListSubAccounts musi mieć format 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ć wyrażeniem relationship(service(externalAccountId = "foo")).

• W AccountsService dokumentacji wyjaśniliśmy, ż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:

• Aktualizacje produktów
• Poprawki zdjęcia
• Ulepszenia dostawy

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ń 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 i zastąpione nowym polem user. Odwołanie CreateUserRequest zawiera pole parent, które nie jest wymagane w kontekście CreateAndConfigureAccountRequest.

Tydzień zaczynający się 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. Filtr relationship(externalAccountId = "foo") należy teraz zapisać jako relationship(service(externalAccountId = "foo")). Stary format jest nadal obsługiwany ze względu na zgodność z wcześniejszymi wersjami, ale jest wycofywany i w najbliższej przyszłości będzie powodować 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, ze względu na 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ń zaczynają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 zmienić promotions_consent na 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.

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 opcjonalnego w całym interfejsie API podrzędnym 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ń 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