Historia zmian

v4.9

Nowe funkcje

MoreHours
Strona MoreHours może być teraz częścią wizytówki firmy.
MoreHourTypes można pobrać z każdej kategorii za pomocą polecenia categories.batchGet.

Zmiany w zachowaniu

Wycofanie kont w wersji 4.x
Konta accounts, accounts.admins, accounts.invitations i accounts.locations.admins zostały wycofane z interfejsu Google Moja Firma API. Więcej informacji znajdziesz w historii zmian wycofywania.
Posty z wezwaniem do działania
W II kwartale 2021 r. CallToAction posty z atrybutem GET_OFFER ActionType przestaną być ważne.

v4.8

Nowe funkcje

Udogodnienia w noclegach
Uzyskiwanie informacji i aktualizowanie udogodnień w kwaterach. Więcej informacji
Dodano punkt końcowy GetGoogleUpdated na potrzeby Lodging.
Dodano canOperateLodgingData wartość logiczną w parametrze LocationState
Atrybuty dostawcy zdrowia
Pobieranie i aktualizacja atrybutu HealthProviderAttributes. Więcej informacji
Dodano wartość logiczną canOperateHealthData w tabeli LocationState
Sieci ubezpieczeniowe
Wyświetl listę agencji ubezpieczeniowych akceptowanych w poszczególnych 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 okres, gdy do wywołania interfejsu API zostaną użyte stare identyfikatory opinii, trzeba będzie je odświeżyć w ciągu 30 dni zgodnie z naszymi zasadami, wywołując punkt końcowy listReviews.
Firmy działające na określonym obszarze
W I kwartale 2021 r. wartości danych Address nie będą już zwracane w obiekcie Location w przypadku firm z kategorii CUSTOMER_LOCATION_ONLY.

v4.7

Nowe funkcje

Menu
Pobieranie i aktualizowanie jedzenia. Więcej informacji

v4.6

Nowe funkcje

Listy usług
Możesz teraz pobierać i aktualizować usługi oferowane przez Twoją firmę. Więcej informacji
Dodanie wartości logicznej canModifyServiceList w parametrze LocationState
Wskazuje, czy lokalizacja może modyfikować listy usług.Więcej informacji
Wstępnie zdefiniowany ServiceTypes dla kategorii
Wstępnie zdefiniowane typy usług są teraz zawarte w obiekcie kategorii.Więcej informacji
CategoryView
Możliwość określenia widoku BASIC lub FULL dla kategorii. Widok FULL zwraca dodatkowe informacje, takie jak typy usług. Więcej informacji
Metoda Kategorie.BatchGet
Ta nowa metoda umożliwia wpisanie listy kategorii i zwracanie informacji dotyczących tylko tych kategorii. Więcej informacji

COVID-19 (aktualizacja 2) w wersji 4.5

Nowe funkcje

Rodzaj posta z powiadomieniem o COVID-19
Możesz teraz tworzyć posty w COVID_19 za pomocą interfejsu API. Więcej informacji

Aktualizacja 1 w związku z COVID-19 (wersja 4.5)

Nowe funkcje

Tymczasowo zamknięte
Możesz teraz ustawić status firmy na CLOSED_TEMPORARILY za pomocą interfejsu API. Więcej informacji

v4.5

Nowe funkcje

Pub/Sub na potrzeby pytań i odpowiedzi
Możesz teraz otrzymywać powiadomienia Google Cloud Pub/Sub dotyczące nowych/zaktualizowanych pytań i odpowiedzi w wybranej lokalizacji. Więcej informacji
Pub/Sub dla stanu listy
Możesz teraz otrzymywać powiadomienia o zmianie stanu strony z Google Cloud Pub/Sub. Więcej informacji

v4.4

Nowe funkcje

Weryfikacje firm świadczących usługi lokalne
Lokalne firmy usługowe można teraz zweryfikować za pomocą interfejsu API. Więcej informacji
Liczba obserwatorów
Możesz teraz pobierać metadane dotyczące obserwatorów. Więcej informacji
Grupy użytkowników i grupy lokalizacji
Grupy użytkowników i grupy lokalizacji można teraz tworzyć przy użyciu interfejsu API. Więcej informacji
Dodanie pola hasPendingEdits w parametrze LocationState
Wskazuje, czy usługi w lokalizacji są w stanie oczekiwania na zmianę. Więcej informacji

Zmiany w działaniu

Na dowolny dzień
Możesz teraz ustawić datę otwarcia wizytówki w przyszłości.
PointRadius
PointRadius jest teraz tylko do odczytu. Aby wprowadzać zmiany lub tworzyć firmy działające lokalnie, musisz użyć usługi Miejsca.

v4.3

Nowe funkcje

Interfejsy API pytań i odpowiedzi
Odbieraj pytania, publikuj odpowiedzi i podawaj najczęstsze pytania dotyczące adresów sklepów. Więcej informacji
Opinie zbiorcze
Pobieraj opinie o wielu lokalizacjach w trakcie jednego połączenia. Więcej informacji
Polecane lokalizacje Google
Wyświetlanie niezarezerwowanych lokalizacji, które według Google mogą należeć do Ciebie. Więcej informacji
Zgłoś problemy z usługą lokalizacji Google
Zgłoś problemy z wynikami RecommendedGoogleLocations lub GoogleLocations. Więcej informacji
Enum usługi dla sekcji PriceList
Wskaż, w której sekcji PriceList znajdują się JEDZENIE lub USŁUGI. Więcej informacji
Opis multimediów
Dodaj podpis podczas przesyłania nowych multimediów. Więcej informacji
Statystyki (CHAINS_QUERIES)
Pobierz informacje o tym, ile razy lokalizacja została wyświetlona w wyniku wyszukiwania w sieci, do której należy. Więcej informacji

Zmiany w zachowaniu

Powiadomienia dotyczące kont organizacji i grup lokalizacji
Konta skonfigurowane do wysyłania 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 dla konta organizacji i grup lokalizacji
Usługa accounts.locations.list zadzwoniła przy użyciu konta grupy użytkowników lub organizacji teraz wyświetla wszystkie lokalizacje, do których można uzyskać dostęp z tego konta.

v4.2

Nowe funkcje

Interfejsy API weryfikacji
Wyświetl listę i aktywuj dostępne metody weryfikacji dla niezweryfikowanych lokalizacji. Więcej informacji
Interfejs API lokalizacji Google
Wyszukaj w Google istniejące lokalizacje, które chcesz zarezerwować, lub pobierz link, aby poprosić o dostęp do wybranych 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 sieci
Wskaż członkostwo w lokalizacji jako części sieci (np. Walmart, Target itp.). Więcej informacji
Informacje o organizacji
Informacje z kont organizacji będą teraz wyświetlane w ramach obiektów Account. Więcej informacji
Zdjęcie profilowe recenzenta
Adresy URL zdjęć profilowych recenzentów są teraz dołączane do obiektu opinii. Więcej informacji

v4.1

Nowe funkcje

Multimedia dostarczane przez klienta
Możesz teraz pobierać i wyświetlać statystyki dotyczące zdjęć i filmów wygenerowanych przez użytkowników w lokalizacjach, których jesteś właścicielem i którymi zarządzasz. Więcej informacji
Interfejsy API do zarządzania administratorami
Możesz teraz wyświetlać, akceptować i odrzucać zaproszenia związane z kontem lub kontem związane z lokalizacją. Więcej informacji
Profile (opis podany przez sprzedawcę)
Opisz swoją firmę własnymi słowami i podziel się z użytkownikami wyjątkową historią firmy oraz jej oferty. Więcej informacji
Pole openingDate
Podaj datę otwarcia swojej lokalizacji. Więcej informacji
Wpisy typu oferty
Nowy typ wpisu w Google, który ułatwia użytkownikom znajdowanie okazji dostępnych w Twoich lokalizacjach. Więcej informacji

v4

Nowe funkcje

Posty w Google
Posty w Google możesz teraz tworzyć bezpośrednio przez interfejs API.
Import zdjęć
Oprócz przesyłania adresów URL zdjęcia można teraz przesyłać bezpośrednio przez interfejs API.
Filtrowanie/włączanie powiadomień
Teraz możesz filtrować powiadomienia, które są wysyłane do tematów Pub/Sub. Kolejne powiadomienia nie będą wysyłane do wszystkich użytkowników, lecz będą wykorzystywały ten mechanizm.
UPDATED_REVIEW powiadomienia
Możesz teraz zasubskrybować powiadomienia w czasie rzeczywistym o nowościach w opiniach klientów.
Obsługa grup użytkowników
Interfejs API Google Moja Firma obsługuje teraz konta typu Grupy użytkowników.

Zmiany niezgodne wstecz

  • Zdjęcia, które dawniej zawierały pole obiektów location, są teraz zasobem w lokalizacji (accounts/account_ID/locations/location_ID/photos).

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

  • Usunięto wcześniej wycofane pole Ownership.

  • Wcześniej w interfejsie API nie można było odróżniać współwłaścicieli kont i lokalizacji od głównych właścicieli (wszyscy użytkownicy wyświetlali się jako OWNER). Teraz główni właściciele otrzymają rolę OWNER, a inni właściciele otrzymają rolę CO_OWNER.

  • AccountType.BUSINESS nazywa się teraz AccountType.LOCATION_GROUP.

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

  • Wiadomość kategorii używana w przypadku primary_category i additional_categories nie zawiera już postaci zrozumiałej dla człowieka. Użytkownicy powinni korzystać z usługi kategorii w interfejsie API Google Moja Firma, aby uzyskiwać przetłumaczone, zrozumiałe dla człowieka nazwy kategorii.

v3.3

Nowe funkcje

Menu ustrukturyzowane

Teraz możesz dodać, zaktualizować lub usunąć:

  • Wiele menu w danej lokalizacji

  • Uwzględnianie wielu sekcji menu w obrębie menu

  • Pokaż 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 zasubskrybować powiadomienia w czasie rzeczywistym o nowych aktualizacjach Google.

Zmiany niezgodne wstecz

  • Nieużywane wcześniej pola languageCodes i platforms UrlAttributeValue zostały usunięte.

  • SAME w wycofanej wyliczeniu własności ma teraz zastosowanie tylko wtedy, gdy lokalizacja, w której dany duplikat ma tego samego głównego właściciela. Wcześniej działanie to opierało się na bardziej złożonych obliczeniach własności.

v3.1

Nowe funkcje

Powiadomienia
Możesz teraz zasubskrybować powiadomienia w czasie rzeczywistym o nowych opiniach.
URL-e Map Google
Adresy URL z Map Google są uwzględniane w odpowiedziach dotyczących lokalizacji, co pozwala użytkownikom łatwo dodawać linki do Map Google.
Stany lokalizacji
Dodatkowe stany wskazujące, kiedy wizytówka zostanie opublikowana, wyłączono, oczekuje na weryfikację.
Flaga ponownego otwarcia
Flaga canReopen wskazuje lokalizacje zamknięte na stałe, które można ponownie otworzyć, w porównaniu z tymi, które nie są bezpieczne.
Atrybuty
Obsługa atrybutów URL i Enum.
Punkt końcowy kategorii
Zobacz listę obsługiwanych kategorii według kraju i języka (zamiast plików CSV).

v3

Nowe funkcje

Opinie
Możesz teraz pobierać opinie o firmie i odpowiadać na nie przez interfejs API.
Atrybuty
Podaj dodatkowe informacje o lokalizacjach związane z konkretną kategorią.
Znajdź pasującą lokalizację
Znajduj i ręcznie łącz istniejące lokalizacje na mapach z lokalizacją swojej firmy.
Przenieś lokalizację
Nowe działanie w aplikacji Location :transfer. Umożliwia przenoszenie lokalizacji z jednego konta (firmowego lub osobistego) na inne.
Preferowane zdjęcie
Wybierz zdjęcie, które ma być wyświetlane jako pierwsze w wyszukiwarce i Mapach Google.
Nowe filtry wyszukiwania
Do nowych filtrów wyszukiwania należą any_google_updates, is_suspended i is_duplicate.
Nowe stany lokalizacji
Stany lokalizacji obejmują teraz także is_verified i needs_reverification.
Ulepszenia adresu URL zdjęć
Interfejs API akceptuje teraz adresy URL zdjęć bez sufiksu formatu obrazu.

Zmiany niezgodne wstecz

  • Zdjęcia można teraz aktualizować tylko w przypadku lokalizacji, które mają stronę Google+ (wcześniej zostały zaakceptowane i usunięte bez powiadomienia).

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

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

  • Operacje tworzenia/aktualizacji przyjmują teraz lokalizację jako ładunek treści. Inne parametry są przenoszone do ciągu zapytania.

v2

Zmiany niezgodne wstecz

  • Musisz teraz określić request_id w wywołaniach CreateLocation. Identyfikator musi być unikalny dla każdej lokalizacji. Dzięki temu na koncie nie da się utworzyć duplikatów lokalizacji. Podejmuje próbę utworzenia lokalizacji, w której identyfikator żądania jest zgodny z wcześniej utworzoną lokalizacją, po prostu zwraca istniejącą lokalizację i nie tworzy jej duplikatu na koncie.

    • Nazwa komponentu business_hours w sekcji Lokalizacja została zmieniona na regular_hours.