Historia zmian

v4.9

Nowe funkcje

2026-04-07

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

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.listaccounts.locations.batchGetReviews. Zapewnia większą przejrzystość stanu moderacji przesłanych odpowiedzi na opinie.

2021-02-24

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

Zmiany w zachowaniu

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

W II kwartale 2021 r. posty użytkownika CallToAction z

GET_OFFER ActionType nie będzie już prawidłowa.

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 canOperateLodgingDataLocationState

Atrybuty podmiotu medycznego:pobieranie i aktualizowanie atrybutów podmiotu medycznego. Więcej informacji: dodanie wartości logicznej w LocationState.canOperateHealthData

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

Zmiany w zachowaniu

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.
Firmy działające na określonym obszarze

W I kwartale 2021 r. w odpowiedzi na żądanieAddress

Obiekt Location dla CUSTOMER_LOCATION_ONLY firm.

v4.7

Nowe funkcje

Menu restauracji: Pobieranie i aktualizowanie menu restauracji. 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 atrybucie 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ędnione w obiekcie kategorii. Więcej informacji

CategoryView

Możliwość określenia widoku BASIC lub FULL dla kategorii. WidokFULL zwróci dodatkowe szczegóły, takie jak typy usług. Więcej informacji

Metoda Categories.BatchGet

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

v4.5 COVID-19 Update 2

Nowe funkcje

Typ posta z alertem dotyczącym COVID-19

Za pomocą interfejsu API możesz teraz tworzyć posty COVID_19.

Więcej informacji

v4.5 COVID-19 Update 1

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 być weryfikowane 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 działaniu

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 dotyczące lokalizacji Twojej firmy. Więcej informacji
Czytanie opinii zbiorczo

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

Więcej informacji

Recommended GoogleLocations

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

Zgłaszanie problemów z GoogleLocation

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

Wyliczenie usługi dla sekcji PriceList

Określ, czy PriceListsekcja zawiera produkty spożywcze czy 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 do otrzymywania powiadomień Pub/Sub będą teraz otrzymywać te powiadomienia także w przypadku wszystkich wizytówek znajdujących się na koncie organizacji lub w grupach lokalizacji, których są administratorami.
ListLocations w przypadku kont organizacji i grup lokalizacji
accounts.locations.listWywołanie z użyciem konta grupy użytkowników lub 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 przesłania prośby o dostęp do przejętych lokalizacji. Więcej informacji
Rozwinięte filtry lokalizacji
Dodatkowe opcje ograniczania wyników zwracanych przez wywołanie Locations.List. Więcej informacji
Członkostwo w łańcuchu
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 osób, które wystawiły opinię, są teraz uwzględniane w obiekcie opinii. 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 lokalizacji.

Więcej informacji

Wpisy o ofertach

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.
Import 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 Pub/Sub. W przyszłości powiadomienia będą wysyłane tylko do użytkowników, którzy wyrażą na to zgodę, a nie do wszystkich.
UPDATED_REVIEW powiadomienia
Możesz teraz subskrybować powiadomienia w czasie rzeczywistym o aktualizacjach opinii klientów.
Obsługa grup użytkowników
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 w API nierozróżnialni od głównych właścicieli (wszyscy mieli rolę 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 o kategorii używany w przypadku primary_categoryadditional_categories nie zawiera już formy czytelnej dla człowieka. Aby uzyskać przetłumaczone, czytelne nazwy kategorii, użytkownicy powinni korzystać z usługi kategorii w Google My Business API.

v3.3

Nowe funkcje

Uporządkowane menu

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

  • Wiele menu w danej lokalizacji
  • Dodawanie wielu sekcji menu do menu
  • 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 dojazdu za pomocą interfejsu API.
Powiadomienia
Możesz teraz subskrybować powiadomienia w czasie rzeczywistym o nowych aktualizacjach Google.

Zmiany powodujące brak zgodności wstecznej

  • Usunięto wcześniej nieużywane pola languageCodesplatformsUrlAttributeValue.
  • 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ę
Flaga
canReopen wskazuje lokalizacje zamknięte na stałe, 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
Teraz możesz 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.
Znajdź pasującą lokalizację
Znajdź i ręcznie powiąż istniejące lokalizacje w Mapach z adresem sklepu.
Lokalizacja przeniesienia
Nowe działanie w przypadku Location :transfer. Umożliwia przeniesienie lokalizacji z jednego konta (firmowego lub osobistego) na inne.
Preferowane zdjęcie
Wskaż, które zdjęcie ma wyświetlać się jako pierwsze w Mapach i wyszukiwarce Google.
Nowe filtry wyszukiwania
Nowe filtry wyszukiwania obejmują any_google_updates, is_suspendedis_duplicate.
Nowe stany lokalizacji
Stany lokalizacji obejmują teraz też is_verifiedneeds_reverification.
Ulepszenia adresu URL zdjęcia
Interfejs API akceptuje teraz adresy URL zdjęć bez sufiksu formatu obrazu.

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