Historia zmian

v4.9

Nowe funkcje

2026-10-09

Food Menus Dietary Restrictions: wyliczenie DietaryRestriction obsługuje teraz atrybuty GLUTEN_FREE i DAIRY_FREE w przypadku pozycji w menu w accounts.locations.getFoodMenus i accounts.locations.updateFoodMenus.

2026-07-24

review_reply_url: adres URL reviewReplyUrl można teraz pobrać za pomocą metod accounts.locations.reviews.get, accounts.locations.reviews.list i accounts.locations.batchGetReviews.

2026-07-01

Policy Violation: pole PolicyViolation jest teraz uwzględnione w polu ReviewReply w przypadku opinii. PolicyViolation można pobrać za pomocą metod accounts.locations.reviews.get, accounts.locations.reviews.list i accounts.locations.batchGetReviews. Zapewnia większą przejrzystość w zakresie przyczyn odrzucenia odpowiedzi na opinię podczas moderacji.

2026-04-20

Review Media Items: Obiekty ReviewMediaItems można teraz pobierać w ramach opinii. ReviewMediaItems można pobrać za pomocą metod accounts.locations.reviews.get, accounts.locations.reviews.list i accounts.locations.batchGetReviews.

2026-04-07

Recurrence Info: możesz teraz planować cykliczne posty, ustawiając RecurrenceInfo podczas tworzenia LocalPost.

Food Menus: w sekcji Menu możesz teraz zarządzać maksymalnie 200 zdjęciami dań za pomocą accounts.locations.updateFoodMenus.

2026-04-01

Review Reply State: ReviewReplyState można teraz pobierać w ramach opinii. ReviewReplyState można pobrać za pomocą metod accounts.locations.reviews.get, accounts.locations.reviews.list i accounts.locations.batchGetReviews. Zapewnia większą przejrzystość stanu moderacji przesłanych odpowiedzi na opinie.

2021-02-24

MoreHours : MoreHours można teraz ustawić w ramach wizytówki firmy. : MoreHourTypes można pobrać dla każdej kategorii za pomocą categories.batchGet.

Zmiany zachowania

Wycofanie kont w wersji 4.x
accounts, accounts.admins, accounts.invitations i accounts.locations.admins zostały wycofane z interfejsu Google My Business API. Więcej informacji znajdziesz w historii zmian związanych z wycofaniem.
Posty z wezwaniem do działania

W II kwartale 2021 r. CallToAction postów z

GET_OFFER ActionType nie będzie już ważny.

v4.8

Nowe funkcje

Udogodnienia w obiekcie: : Pobieranie i aktualizowanie udogodnień w obiekcie. Więcej informacji: : Dodanie punktu końcowego GetGoogleUpdated dla obiektów noclegowych. : Dodanie wartości logicznej canOperateLodgingData w LocationState

Atrybuty dostawcy usług medycznych: : Pobieranie i aktualizowanie atrybutów dostawcy usług medycznych. Więcej informacji: dodanie wartości logicznej canOperateHealthData do elementu LocationState

Sieci ubezpieczeniowe: : Lista sieci ubezpieczeniowych akceptowanych w lokalizacjach. Więcej informacji

Zmiany zachowania

Identyfikatory opinii
Identyfikatory opinii zostały przeniesione do nowego formatu. Ten nowy identyfikator będzie teraz zwracany we wszystkich odpowiednich odpowiedziach interfejsu API. Przez krótki czas stare identyfikatory opinii będą nadal działać podczas wywoływania interfejsu API, ale w ciągu 30 dni musisz odświeżyć wszystkie identyfikatory opinii przechowywane w Twoim systemie, zgodnie z naszymi zasadami, wywołując punkt końcowy listReviews.
Firma działająca na określonym obszarze

W I kwartale 2021 r. pole Address nie będzie już zwracane w odpowiedzi na

Obiekt Location dla CUSTOMER_LOCATION_ONLY firm.

v4.7

Nowe funkcje

Menu:pobieranie i aktualizowanie menu. Więcej informacji

v4.6

Nowe funkcje

Listy usług

Możesz teraz

pobierać i aktualizować usługi oferowane przez firmę. Więcej informacji

Dodanie wartości logicznej canModifyServiceList w LocationState

Określa, czy lokalizacja kwalifikuje się do modyfikowania list usług. Więcej informacji

Wstępnie zdefiniowane ServiceTypes dla kategorii

Wstępnie zdefiniowane typy usług są teraz uwzględniane w obiekcie kategorii. Więcej informacji

CategoryView

Możliwość określenia widoku BASIC lub FULL dla kategorii. Widok FULL zawiera dodatkowe informacje, takie jak typy usług. Więcej informacji

Categories.BatchGet Method

Ta nowa metoda umożliwia wpisanie listy kategorii i zwraca informacje tylko o tych kategoriach. Więcej informacji

v4.5 Aktualizacja 2 dotycząca COVID-19

Nowe funkcje

Typ posta z alertem dotyczącym COVID-19

Możesz teraz utworzyć COVID_19 post za pomocą interfejsu API.

Więcej informacji

v4.5 Aktualizacja 1 dotycząca COVID-19

Nowe funkcje

Tymczasowo zamknięte
Za pomocą interfejsu API możesz teraz ustawić stan firmy na CLOSED_TEMPORARILY. Więcej informacji

v4.5

Nowe funkcje

Pub/Sub do pytań i odpowiedzi
Możesz teraz otrzymywać powiadomienia Google Cloud Pub/Sub o nowych lub zaktualizowanych pytaniach i odpowiedziach dotyczących lokalizacji. Więcej informacji
Pub/Sub na potrzeby stanu informacji
Możesz teraz otrzymywać powiadomienia Google Cloud Pub/Sub o zmianie stanu informacji. Więcej informacji

v4.4

Nowe funkcje

Weryfikacja firm świadczących usługi lokalne
Firmy świadczące usługi lokalne mogą teraz przejść weryfikację za pomocą interfejsu API. Więcej informacji
Liczba obserwujących

Możesz teraz pobierać metadane dotyczące obserwujących.

Więcej informacji

Grupy użytkowników i grupy lokalizacji

Grupy użytkowników i grupy lokalizacji można teraz tworzyć za pomocą interfejsu API. Więcej informacji

Dodanie pola hasPendingEdits w LocationState

Wskazuje, czy właściwości lokalizacji są w stanie oczekiwania na edycję. Więcej informacji

Zmiany w zachowaniu

Na dowolny dzień
Możesz teraz ustawić przyszłą datę otwarcia wizytówki.

PointRadius : PointRadius jest teraz tylko do odczytu. Edytowanie lub tworzenie firm świadczących usługi lokalne będzie wymagać użycia Miejsc.

v4.3

Nowe funkcje

Interfejsy API pytań i odpowiedzi
Pobieraj pytania, publikuj odpowiedzi i udostępniaj najczęstsze pytania w lokalizacjach swojej firmy. Więcej informacji
Czytanie opinii zbiorczo

Pobieranie opinii o wielu lokalizacjach w ramach jednego wywołania.

Więcej informacji

Recommended GoogleLocations

Wyświetl nieprzejęte lokalizacje, które według Google mogą należeć do Ciebie. Więcej informacji

Zgłaszanie problemów z Google Location

Zgłaszaj problemy z wynikami RecommendedGoogleLocations lub GoogleLocations. Więcej informacji

Wyliczenie usługi dla sekcji PriceList

Określ, czy PriceList zawiera produkty SPOŻYWCZE czy ŚWIADCZONE USŁUGI. Więcej informacji

Opis multimediów

Podaj podpis podczas przesyłania nowych multimediów.

Więcej informacji

CHAINS_QUERIES Statystyki

Pobierz liczbę wyświetleń lokalizacji w wyniku wyszukiwania sieci, do której należy. Więcej informacji

Zmiany w działaniu

Powiadomienia dotyczące kont organizacji i grup lokalizacji
Konta skonfigurowane pod kątem powiadomień Pub/Sub będą teraz otrzymywać te powiadomienia w przypadku wszystkich wizytówek znajdujących się na koncie organizacji lub w grupach lokalizacji, których są administratorami.
ListLocations w przypadku konta organizacji i grup lokalizacji.
accounts.locations.listWywołanie z grupą użytkowników lub kontem organizacji wyświetla teraz wszystkie lokalizacje, do których to konto ma dostęp.

v4.2

Nowe funkcje

Interfejsy API weryfikacji
Wyświetlanie listy dostępnych metod weryfikacji i ich uruchamianie w przypadku niezweryfikowanych lokalizacji. Więcej informacji
GoogleLocations API
Wyszukaj w Google istniejące lokalizacje, aby je przejąć, lub uzyskaj link do zgłoszenia prośby o dostęp do przejętych lokalizacji. Więcej informacji
Rozwinięte filtry lokalizacji
Dodatkowe opcje ograniczania liczby wyników zwracanych przez wywołanie Locations.List. Więcej informacji
Członkostwo w grupie
Wskazanie, że lokalizacja należy do sieci (np. Walmart, Target itp.). Więcej informacji
Informacje o organizacji
Informacje o kontach organizacji będą teraz wyświetlane jako część obiektów konta. Więcej informacji
Zdjęcie profilowe recenzenta
Adresy URL zdjęć profilowych recenzentów są teraz uwzględniane w obiekcie recenzji. Więcej informacji

v4.1

Nowe funkcje

Media dostarczone przez klienta
Możesz teraz pobierać i wyświetlać statystyki dotyczące zdjęć i filmów przesłanych przez użytkowników w przypadku lokalizacji, których jesteś właścicielem i którymi zarządzasz. Więcej informacji
Interfejsy API do zarządzania administracyjnego
Możesz teraz wyświetlać, akceptować i odrzucać zaproszenia dotyczące konta i lokalizacji. Więcej informacji
Profile (Opis podany przez sprzedawcę)
Opisz swoją firmę własnymi słowami i podziel się z użytkownikami wyjątkową historią swojej firmy i oferty. Więcej informacji
openingDate Pole

Podaj datę otwarcia Twojej lokalizacji.

Więcej informacji

Posty z ofertami

Nowy typ posta w Google, który pomaga użytkownikom znajdować oferty dostępne w Twoich lokalizacjach. Więcej informacji

v4

Nowe funkcje

Posty w Google
Możesz teraz tworzyć posty w Google bezpośrednio za pomocą interfejsu API.
Przesyłanie zdjęć
Zdjęcia można teraz przesyłać bezpośrednio za pomocą interfejsu API, a także za pomocą dotychczasowej metody przesyłania za pomocą adresu URL.
Filtrowanie powiadomień i wyrażanie zgody na ich otrzymywanie
Możesz teraz filtrować powiadomienia wysyłane do tematów pubsub. Przyszłe powiadomienia będą korzystać z tego mechanizmu, aby były akceptowane, a nie wysyłane do wszystkich użytkowników.
UPDATED_REVIEW powiadomienia
Możesz teraz subskrybować powiadomienia w czasie rzeczywistym o aktualizacjach opinii klientów.
Obsługa grup użytkowników
Interfejs Google My Business API obsługuje teraz konta typu Grupa użytkowników.

Zmiany powodujące brak zgodności wstecznej

  • Zdjęcia, które wcześniej były polem obiektów location, są teraz zasobem w sekcji lokalizacja (accounts/<var>account_ID</var>/locations/<var>location_ID</var>/photos).
  • Pole adresu Country to teraz region_code, a sub_locality to teraz sublocality.
  • Usunięto wycofane wcześniej pole Ownership.
  • Wcześniej współwłaściciele kont i lokalizacji byli nieodróżnialni od głównych właścicieli za pomocą interfejsu API (wszyscy byli oznaczani jako OWNER). Teraz główni właściciele będą mieli rolę OWNER, a inni właściciele – rolę CO_OWNER.
  • AccountType.BUSINESS ma teraz nazwę AccountType.LOCATION_GROUP.
  • Jeśli używasz maski pola do aktualizowania lokalizacji, podaj update_mask zamiast dotychczasowego field_mask.
  • Komunikat kategorii używany w przypadku primary_category i additional_categories nie zawiera już formy zrozumiałej dla człowieka. Aby uzyskać przetłumaczone, zrozumiałe dla człowieka nazwy kategorii, użytkownicy powinni korzystać z usługi kategorii interfejsu Google My Business API.

v3.3

Nowe funkcje

Menu strukturalne

Możesz teraz dodawać, aktualizować i usuwać:

  • Wiele menu w danej lokalizacji
  • Dodawanie do menu kilku sekcji
  • wyświetlać pozycje menu z nazwą, opisem, ceną i zdjęciami;

v3.2

Nowe funkcje

Statystyki
Możesz teraz pobierać statystyki lokalizacji i dane dotyczące jazdy za pomocą interfejsu API.
Powiadomienia
Możesz teraz subskrybować powiadomienia w czasie rzeczywistym o nowych aktualizacjach Google.

Zmiany powodujące brak zgodności wstecznej

  • Wycofaliśmy wcześniej nieużywane pola languageCodes i platforms w UrlAttributeValue.
  • SAME w wycofanym wyliczeniu Ownership ma teraz zastosowanie tylko wtedy, gdy lokalizacja, którą duplikuje, ma tego samego głównego właściciela. Wcześniej zachowanie było oparte na bardziej złożonym obliczaniu własności.

v3.1

Nowe funkcje

Powiadomienia
Możesz teraz subskrybować powiadomienia w czasie rzeczywistym o nowych opiniach.
URL-e Map Google
Adresy URL Map Google są uwzględniane w odpowiedziach dotyczących lokalizacji, co umożliwia użytkownikom tworzenie linków do Map Google.
Stany lokalizacji
Dodatkowe stany lokalizacji wskazujące, kiedy wizytówka jest opublikowana, wyłączona lub oczekuje na weryfikację.
Otwórz ponownie flagę
canReopen Flaga wskazuje zamknięte na stałe lokalizacje, które można ponownie otworzyć, oraz te, których nie można.
Atrybuty
Obsługa atrybutów URL i Enum.
Punkt końcowy kategorii
Pobierz listę obsługiwanych kategorii według kraju i języka (zastępuje pliki CSV).

Wersja 3

Nowe funkcje

Opinie
Możesz teraz pobierać opinie o firmie i na nie odpowiadać za pomocą interfejsu API.
Atrybuty
Podawaj dodatkowe informacje o lokalizacjach, które są specyficzne dla danej kategorii.
Znajdowanie pasującej lokalizacji
Znajdź i ręcznie powiąż istniejące lokalizacje w Mapach z lokalizacją Twojej firmy.
Przenoszenie lokalizacji
Nowe działanie w Location :transfer. Umożliwia przeniesienie lokalizacji z jednego konta (firmowego lub osobistego) na inne.
Preferowane zdjęcie
Wskaż, które zdjęcie ma się wyświetlać jako pierwsze w Mapach i wyszukiwarce Google.
Nowe filtry wyszukiwania
Nowe filtry wyszukiwania obejmują any_google_updates, is_suspended i is_duplicate.
Stany nowej lokalizacji
Stany lokalizacji obejmują teraz też is_verified i needs_reverification.
Ulepszenia adresu URL zdjęcia
Interfejs API akceptuje teraz adresy URL zdjęć bez sufiksu formatu pliku graficznego.

Zmiany powodujące brak zgodności wstecznej

  • W wywołaniach CreateLocation musisz teraz podać request_id. Ten identyfikator musi być unikalny dla każdej lokalizacji. Pomaga on zapobiegać tworzeniu na koncie zduplikowanych lokalizacji. Próba utworzenia lokalizacji, w której identyfikator żądania pasuje do wcześniej utworzonej lokalizacji, zwraca istniejącą lokalizację i zapobiega utworzeniu duplikatu na koncie.
  • business_hours w sekcji Lokalizacja została zmieniona na regular_hours.