Historia zmian

v4.9

Nowe funkcje

MoreHours
MoreHours można teraz ustawić w ramach informacji o firmie.
MoreHourTypes można pobrać dla każdej kategorii za pomocą wywołania categories.batchGet.

Zmiany w zachowaniu

Wycofanie kont w wersji 4.x
Interfejsy
accounts, accounts.admins, accounts.invitations i accounts.locations.admins są teraz wycofane z interfejsu API Google Moja firma. Więcej informacji znajdziesz w historii zmian dotyczących wycofania.
Posty z przyciskiem wezwania do działania
W II kwartale 2021 r. CallToActionposty z parametrem GET_OFFER ActionType przestaną być akceptowane.

v4.8

Nowe funkcje

Udogodnienia w hotelu
Pobieranie i aktualizowanie udogodnień obiektu zakwaterowania. Więcej informacji
Dodanie punktu końcowego GetGoogleUpdated dla obiektów zakwaterowania.
Dodanie wartości logicznej canOperateLodgingData w LocationState
Atrybuty podmiotu medycznego
Pobieranie i aktualizowanie atrybutów HealthProviderAttributes. Więcej informacji
Dodanie wartości logicznej canOperateHealthData w LocationState
Sieci ubezpieczeniowe
Lista sieci ubezpieczeniowych akceptowanych przez lokalizacje. 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 rozwiązywane podczas wywoływania interfejsu API, ale ważne jest, aby w ciągu 30 dni od wywołania punktu końcowego listReviews odświeżyć wszystkie identyfikatory opinii zapisane w Twoim systemie zgodnie z naszymi zasadami.
Firmy działające na określonym obszarze
W I kw. 2021 r. w obiekcie Location dla firm CUSTOMER_LOCATION_ONLY nie będzie już zwracana wartość Address.

v4.7

Nowe funkcje

Menu z jedzeniem
Pobieranie i aktualizowanie menu restauracji. Więcej informacji

v4.6

Nowe funkcje

Listy usług
Teraz możesz pobierać i aktualizować usługi oferowane przez firmę. Więcej informacji
Dodanie wartości logicznej canModifyServiceList w atrybucie LocationState
Wskazuje, czy lokalizacja kwalifikuje się do modyfikowania list usługWięcej informacji
Wstępnie zdefiniowane ServiceTypes dla kategorii
Wstępnie zdefiniowane typy usług są teraz uwzględniane w obiekcie categories.Więcej informacji
CategoryView
Możliwość wyświetlania w przypadku kategorii widoku BASIC lub FULL. Widok FULL zawiera dodatkowe informacje, takie jak typy usług. Więcej informacji
Metoda Categories.BatchGet
Ta nowa metoda umożliwia podanie listy kategorii i zwraca informacje tylko o tych kategoriach. Więcej informacji

v4.5 Aktualizacja COVID-19 2

Nowe funkcje

Typ wpisu dotyczącego alertu COVID-19
Teraz możesz tworzyć posty COVID_19 za pomocą interfejsu API. Więcej informacji

v4.5 Aktualizacja COVID-19 1

Nowe funkcje

Tymczasowo zamknięte
Teraz możesz ustawić firmę jako CLOSED_TEMPORARILY za pomocą interfejsu API. Więcej informacji

v4.5

Nowe funkcje

Pub/Sub na potrzeby sekcji Pytania i odpowiedzi
Możesz teraz otrzymywać powiadomienia Google Cloud Pub/Sub dotyczące nowych lub zaktualizowanych pytań i odpowiedzi dotyczących lokalizacji. Więcej informacji
Pub/Sub do wyświetlania stanu
Możesz teraz otrzymywać powiadomienia Google Cloud Pub/Sub o zmianie stanu oferty. Więcej informacji

v4.4

Nowe funkcje

Weryfikacja firm świadczących usługi lokalne
Firmy świadczące usługi lokalne mogą teraz przechodzić weryfikację za pomocą interfejsu API. Więcej informacji
Liczba obserwatorów
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 polu LocationState
Wskazuje, czy właściwości lokalizacji są w stanie oczekiwania na edycję. Więcej informacji

Zmiany w zachowaniu

Na dowolny dzień
Teraz możesz ustawić datę otwarcia oferty na przyszłość.
PointRadius
PointRadius jest teraz dostępny tylko do odczytu. Aby edytować lub tworzyć firmy świadczące usługi lokalne, musisz korzystać z usługi Miejsca.

v4.3

Nowe funkcje

Interfejsy API Pytania i odpowiedzi
Pobierz pytania, opublikuj odpowiedzi i utwórz najczęstsze pytania dotyczące lokalizacji Twojej firmy. Więcej informacji
Czytanie wielu opinii
Pobieranie opinii dotyczących wielu lokalizacji w ramach jednego wywołania. Więcej informacji
Zalecane miejsca w Google
wyświetlać niezarejestrowane lokalizacje, które według Google mogą należeć do Ciebie; Więcej informacji
Zgłaszanie problemów z GoogleLocation
Zgłoś problemy z wynikami RecommendedGoogleLocations lub GoogleLocations. Więcej informacji
Wykaz usług w sekcji PriceList
Określ, czy sekcja PriceList zawiera produkty spożywcze czy świadczone USŁUGI. Więcej informacji
Opis multimediów
Podczas przesyłania nowych multimediów podaj podpis. Więcej informacji
CHAINS_QUERIES Statystyki
Pobierz liczbę wyświetleń lokalizacji w wyniku wyszukiwania łańcucha, do którego 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 również w przypadku wszystkich informacji zawartych na koncie organizacji lub w grupach lokalizacji, których są administratorami.
ListLocations dla kont organizacji i grup lokalizacji
accounts.locations.list wywoływana z konta grupy użytkowników lub organizacji, wyświetla teraz wszystkie lokalizacje dostępne dla tego konta.

v4.2

Nowe funkcje

Interfejsy API weryfikacji
Wyświetla listę dostępnych metod weryfikacji i uruchamia je w przypadku niezweryfikowanych lokalizacji. Więcej informacji
GoogleLocations API
Wyszukaj w Google istniejące lokalizacje, aby je zgłosić, lub pobierz link, aby poprosić o dostęp do zgłoszonych lokalizacji. Więcej informacji
Rozwinięte filtry lokalizacji
Dodatkowe opcje ograniczania wyników zwracanych przez wywołanie Locations.List. Więcej informacji.
Wspieranie kanału
Wskaż, że dana lokalizacja należy do sieci (np. Walmart, Target itp.). Więcej informacji
Informacje o organizacji
Informacje o kontach organizacji będą teraz wyświetlane w ramach obiektów konta. Więcej informacji
Zdjęcie profilowe recenzenta
Adresy URL zdjęć profilowych autorów opinii są teraz uwzględniane w obiekcie opinii. Więcej informacji

v4.1

Nowe funkcje

Multimedia dostarczone przez klienta
Możesz teraz pobierać i wyświetlać statystyki dotyczące zdjęć i filmów utworzonych przez użytkowników w przypadku lokalizacji, które są Twoją własnością lub którymi zarządzasz. Więcej informacji
Interfejsy API do zarządzania przez administratora
Możesz teraz wyświetlać, akceptować i odrzucać zaproszenia związane z kontem i lokalizacją. Więcej informacji
Profile (opis sprzedawcy)
Opisać swoją firmę własnymi słowami i przedstawić użytkownikom jej wyjątkową historię i ofertę. Więcej informacji
openingDate Pole
Podaj datę otwarcia lokalizacji. Więcej informacji
Wpisy o typie oferty
Nowy typ postu w Google, który pomaga użytkownikom znaleźć oferty dostępne w Twoich lokalizacjach. Więcej informacji

v4

Nowe funkcje

Posty w Google
Możesz teraz tworzyć Posty na Google bezpośrednio za pomocą interfejsu API.
Import zdjęć
Oprócz przesyłania za pomocą adresu URL możesz teraz przesyłać zdjęcia bezpośrednio przez interfejs API.
Filtrowanie powiadomień/wyrażenie zgody
Teraz możesz filtrować powiadomienia wysyłane do tematów pubsub. Przyszłe powiadomienia będą wysyłane tylko do użytkowników, którzy wyrazili na nie zgodę, a nie 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 ramach lokalizacji (accounts/account_ID/locations/location_ID/photos).

  • Pole adresu Country to teraz region_code, a sub_locality to sublocality.

  • Usunięto wcześniej wycofane pole Ownership.

  • Wcześniej współwłaściciele kont i lokalizacji nie różnili się od głównych właścicieli w interfejsie API (wszyscy byli widoczni jako OWNER). Teraz głównym właścicielom przypisana zostanie rola OWNER, a innym właścicielom rola CO_OWNER.

  • Urządzenie AccountType.BUSINESS ma teraz nazwę AccountType.LOCATION_GROUP.

  • Jeśli do aktualizowania lokalizacji używasz maski pola, zamiast dotychczasowego field_mask podaj update_mask.

  • Komunikat kategorii używany w przypadku primary_category i additional_categories nie zawiera już formy zrozumiałej dla człowieka. Użytkownicy powinni korzystać z kategorii usługi w Google My Business API, aby uzyskać przetłumaczone, czytelne nazwy kategorii.

v3.3

Nowe funkcje

Menu uporządkowane

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

  • Wiele menu w danej lokalizacji

  • Dodawanie wielu sekcji menu w menu

  • lista pozycji menu z nazwą, opisem, ceną i zdjęciami;

v3.2

Nowe funkcje

Statystyki
Teraz możesz pobierać statystyki dotyczące 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

  • Nieużywane pola languageCodes i platforms w elementach UrlAttributeValue zostały usunięte.

  • Wartość SAME w wycofanym typie zbiorczego Ownership obowiązuje teraz tylko wtedy, gdy miejsce, które jest duplikowane, ma tego samego głównego właściciela. Wcześniej to zachowanie było oparte na bardziej złożonym obliczeniu 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 na pytania o lokalizację, co pozwala użytkownikom łatwo łączyć się z Mapami Google.
Stany lokalizacji
Dodatkowe stany lokalizacji wskazujące, czy wizytówka jest opublikowana, wyłączona czy oczekuje na weryfikację.
Flaga ponownego otwarcia
Flaga
canReopen wskazuje, czy lokalizacja jest zamknięta na stałe, czy może zostać ponownie otwarta.
Atrybuty
Obsługa atrybutów URL i enum.
Punkt końcowy kategorii
Zobacz 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
Podaj dodatkowe informacje o lokalizacjach związane z konkretną kategorią.
Znajdowanie pasującej lokalizacji
Znajduj i ręcznie powiązaj istniejące lokalizacje na mapie z lokalizacją firmy.
Przenoszenie lokalizacji
Nowe działanie dotyczące 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 Google i wyszukiwarce.
Nowe filtry wyszukiwania
Nowe filtry wyszukiwania to any_google_updates, is_suspended i is_duplicate.
Nowe stany lokalizacji
Stany lokalizacji obejmują teraz także is_verified i needs_reverification.
Ulepszenia adresów URL zdjęć
Interfejs API akceptuje teraz adresy URL zdjęć bez przyrostka formatu obrazu.

Zmiany powodujące brak zgodności wstecznej

  • Zdjęcia można teraz aktualizować tylko w przypadku lokalizacji z poziomu strony Google+ (wcześniej były one akceptowane i cicho usuwane).

  • Pola location_name i category_name są teraz tylko wyjściowe. Podczas ustawiania kategorii używaj tylko identyfikatorów kategorii.

  • Maski pól nie powinny już zawierać prefiksu location. w przypadku uwzględnionych pól.

  • Operacje tworzenia i aktualizowania teraz przyjmują lokalizację jako ładunek w ciele; inne parametry są przenoszone do ciągu zapytania.

v2

Zmiany powodujące brak zgodności wstecznej

  • Teraz musisz podać request_id w wywołaniach CreateLocation. Identyfikator musi być unikalny dla każdej lokalizacji. Pomaga to uniknąć tworzenia na koncie podwójnych lokalizacji. Próby utworzenia lokalizacji, w której identyfikator żądania pasuje do wcześniej utworzonej lokalizacji, zwracają po prostu tę lokalizację, co zapobiega tworzeniu duplikatu na Twoim koncie.