Interfejs Google Business Performance API udostępnia NOWĄ metodę interfejsu API, która umożliwia pobieranie wielu parametrów „DailyMetrics” w jednym żądaniu API.
Zapoznaj się z harmonogramem wycofywania i instrukcjami, jak przejść z metody raportu API w wersji 4 na interfejs Google Business Profile Performance API.

Ta strona została przetłumaczona przez Cloud Translation API.

Najczęstsze pytania

Czym są interfejsy GBP API?

Interfejsy API Profilu Firmy to interfejsy programowania, które umożliwiają deweloperom tworzenie aplikacji do zarządzania kontem Profilu Firmy i danymi o lokalizacji. Interfejsy API umożliwiają sprzedawcom lub ich przedstawicielom zarządzanie sposobem wyświetlania ich danych w Google oraz kontrolowanie, kto współzarządza ich danymi. Dane utworzone przez użytkowników, takie jak zdjęcia, posty czy opinie, mogą być również zarządzane za pomocą interfejsów API.

Interfejsy Business Profile API oferują prawie te same funkcje co interfejs użytkownika Profilu Firmy, a także kilka dodatkowych funkcji specyficznych dla interfejsów API. Użytkownicy interfejsów API mogą oczekiwać, że aktualizacje Google będą przebiegać w taki sam sposób jak inni użytkownicy.

Kto może uzyskać dostęp do interfejsów GBP API?

Interfejsy GBP nie są dostępne publicznie. Aby móc korzystać z interfejsów GBP, użytkownicy muszą poprosić o dostęp do nich. Każda osoba lub firma, która może wykazać, że mają podstawy prawne do korzystania z interfejsów API Profilu Firmy, może uzyskać dostęp. Oto kilka rekomendacji dotyczących wykazania nielegalności działalności:

Użyj prawidłowego firmowego adresu e-mail, który jest powiązany z domeną Twojej firmy.
Sprawdź, czy strona firmy jest zaktualizowana i opublikowana.

Czy dostęp do interfejsów API Profilu Firmy w Google pozwala użytkownikowi wysyłać zapytania dotyczące dowolnych danych Profilu Firmy w Google?

Nie. Nawet jeśli masz dostęp do interfejsów API Profilu Firmy w Google, nie możesz wysyłać zapytań o dane w profilu firmy, chyba że masz dostęp do tego konkretnego Profilu Firmy w Google.

Jakie zasady obowiązują użytkowników interfejsu GBP API?

Partnerzy muszą przestrzegać zasad dotyczących Profilu Firmy w Google, a także wszystkich zasad i warunków korzystania z usługi interfejsu API.

Jak użytkownicy uzyskują dostęp do interfejsu GBP API?

Aby utworzyć pierwszą aplikację klienta, musisz spełnić te wymagania wstępne:

Załóż konto Google.
Wypróbuj Profil Firmy
Utwórz projekt w Konsoli interfejsów API Google.
Poproś o dostęp do interfejsu API: prośby są rozpatrywane w ciągu 14 dni.

Jak użytkownicy uzyskują dostęp do określonego interfejsu GBP API?

Z Profilem Firmy jest powiązane 8 interfejsów API, które należy włączyć w konsoli interfejsów API Google:

Interfejs API Google Moja Firma w wersji 4.9, który obejmuje te ważne funkcje wywołań interfejsu API:
- FoodMenus
- Media
- Reviews
- LocalPosts
My Business Account Management API
Interfejs My Business Lodging API
Interfejs My Business Place Actions API
My Business Notifications API
My Business Verifications API
My Business Business Information API
My Business Q&A API
Interfejs Performance API dla profilu firmy

Jeśli prośba o dostęp zostanie zatwierdzona, użytkownik otrzyma standardowy domyślny limit dla wszystkich 8 interfejsów API.

Jak działa dostęp do interfejsu GBP API?

Dostęp do interfejsu GBP API jest przyznawany na poziomie projektu Google Cloud. Jeśli użytkownik A przesłał prośbę o dostęp do interfejsu Google Business Profile API w przypadku projektu o numerze 12345678, to dostęp zostanie przyznany do projektu o numerze 12345678. Dzięki temu każdy użytkownik (w tym użytkownik A z dostępem do projektu Google Cloud) może wywoływać interfejsy API Profilu Firmy w Google. Aby uniknąć nadużyć, partnerzy muszą kontrolować dostęp do projektu Google Cloud na podstawie zasady „tylko wtedy, gdy jest to konieczne”.

Czy masz podsumowanie interfejsów API i przykłady ich możliwości?

W tej tabeli znajdziesz informacje o różnych interfejsach API i ich możliwościach.

API	Dokumentacja	Przykładowe możliwości
Interfejs API zarządzania kontem	Dokumentacja	Zarządzaj dostępem do lokalizacji. Tworzy konto o określonej nazwie i typie pod podanym elementem nadrzędnym. Wyświetla wszystkie konta uwierzytelnionego użytkownika. Lista oczekujących zaproszeń na określone konto. Przenosi lokalizację z konta należącego do użytkownika na inne konto. Aktualizuje administratora określonej lokalizacji.
Business Information API	Dokumentacja	Interfejs Business Information API umożliwia zarządzanie cyklem życia profilu oraz dodawanie informacji o firmie i zarządzanie nimi w Google Play. Umożliwia sprzedawcom uzyskiwanie, tworzenie, aktualizowanie i usuwanie profili firm w Google. Umożliwia sprzedawcom pobieranie i aktualizowanie atrybutów profilu. Umożliwia sprzedawcom uzyskiwanie informacji o sieciach i kategoriach profili oraz ich wyszukiwanie.
Interfejs Lodging API	Dokumentacja	Umożliwia zarządzanie danymi dotyczącymi zakwaterowania, np. udogodnieniami, oraz zasadami dla firm w Google. Interfejs API jest przeznaczony dla firm, które świadczą usługi zakwaterowania, np. hoteli. Interfejs Lodging API umożliwia programistom aktualizowanie atrybutów obiektów zakwaterowania w profilu firmy w Google.
Interfejs API działań lokalnych	Dokumentacja	Umożliwia zarządzanie linkami do działań związanych z miejscem w firmach. Przekierowywać użytkowników do wykonywania działań takich jak rezerwacja spotkania, rezerwacja stolika czy zamawianie dostawy jedzenia.
Notifications API	Dokumentacja	Umożliwia zarządzanie ustawieniami powiadomień na wybranych kontach.
Verifys API	Dokumentacja	Rozpoczyna proces weryfikacji lokalizacji. Raportuje wszystkie odpowiednie opcje weryfikacji dla lokalizacji w określonym języku.
interfejs Q&A API,	Dokumentacja	Umożliwia zarządzanie pytaniami i odpowiedziami dotyczącymi lokalizacji.
Interfejs Business Profile Performance API	Dokumentacja	Umożliwia sprzedawcom pobieranie statystyk dotyczących wyników wizytówki ich firmy w Google. Statystyki obejmują wyświetlenia firmy, prośby o wskazówki dojazdu, kliknięcia połączeń, kliknięcia witryny, rezerwacje, zamówienia jedzenia, interakcje z menu i inne.
Media API	Dokumentacja	Umożliwia deweloperom interfejsu API przesyłanie zdjęć i filmów do profilu firmy.
Reviews API	Dokumentacja	Umożliwia sprzedawcom uzyskiwanie opinii i odpowiadanie na opinie w profilu firmy.
Local Posts API	Dokumentacja	Umożliwia sprzedawcom uzyskiwanie, tworzenie i aktualizowanie wpisów lokalnych.
FoodMenus API	Dokumentacja	Umożliwia sprzedawcom pobieranie, tworzenie i aktualizowanie menu w profilu firmy.

Jeśli nadal masz pytania dotyczące dostępnych danych lub sposobu uzyskiwania do nich dostępu, skorzystaj z tych formularzy, aby przesłać prośbę:

Jak partnerzy mogą skonfigurować strukturę konta, aby korzystać z interfejsów GBP API?

Jeśli jesteś zewnętrznym partnerem, który zarządza wizytówkami firm:

Zarejestruj konto organizacji w Google Partner Store jako agencja.
Zapoznaj się z koncepcjami grup użytkowników i grup biznesowych.
Zapoznaj się z tym przewodnikiem, aby dowiedzieć się, jak zarządzać lokalizacjami w imieniu firm.

Jak firmy autoryzują partnera interfejsu GBP do zarządzania wizytówką firmy?

Firmy mogą przyznawać dostęp partnerowi zewnętrznemu na 2 sposoby:

Konfiguracja OAuth: przeczytaj ten przewodnik, aby dowiedzieć się, jak platformy partnerskie innych firm używają danych sprzedawcy do edytowania i dostępu do danych w Profilu Firmy w Google w imieniu sprzedawcy lub firmy.
Dostęp właściciela lub menedżera: jeśli partner zewnętrzny zostanie dodany jako menedżer profilu firmy w Google przez sprzedawcę, który powinien być głównym właścicielem profilu, partner zewnętrzny nie będzie musiał używać danych logowania sprzedawcy, aby korzystać z interfejsów API profilu firmy w Google w celu edycji danych w profilu firmy w Google i uzyskiwania do nich dostępu.

Uwaga: zdecydowanie zalecamy, aby partnerzy zewnętrzni nie dodawali siebie jako właściciela grupy produktów, ale tylko jako menedżera.

Czy istnieje możliwość zbiorczej weryfikacji, jeśli firma ma co najmniej 10 lokalizacji?

Tak. Możesz poprosić o weryfikację zbiorczą ponad 10 profili. Po weryfikacji opublikowane lokalizacje sieci można zarządzać za pomocą interfejsów API profilu firmy w taki sam sposób jak innymi lokalizacjami (z pewnymi wyjątkami). Na przykład menedżerowie lokalizacji są traktowani inaczej, więc mogą dodawać się do placówek franczyzowych.

Jakie są limity w przypadku różnych interfejsów API?

Standardowe limity znajdziesz w sekcji Limity wykorzystania. Jeśli potrzebujesz wyższych limitów, możesz przesłać standardową prośbę o kwotę limitu.

O jaki limit mogę poprosić?

Limit to ograniczony zasób. Zespół pomocy GBP API ustala, czy możesz poprosić o zwiększenie limitu, potwierdzając wcześniejsze wykorzystanie limitu. Jeśli średnie wykorzystanie limitu jest mniejsze niż 70% bieżących limitów, dalsze zwiększenie limitów może zostać odrzucone.

Czy partnerzy interfejsu GBP API mogą utworzyć konto testowe dla wersji produkcyjnej?

Nie. Niestety nie ma bezpośredniego sposobu na utworzenie fałszywej oferty w produkcji za pomocą interfejsu GBP lub interfejsu API i przetestowanie jej.

Większość fałszywych ofert jest oznaczana przez moderatorów i zawieszana. Zalecamy skorzystanie z wizytówki klienta i skorzystanie z niej po godzinach (pod warunkiem, że nie zmienisz żadnych podstawowych informacji o firmie, takich jak nazwa, adres czy kategoria) lub utwórz wizytówkę dla centrali firmy. Jeśli chcesz przetestować odpowiedź interfejsu API, aby zweryfikować informacje lub wykonać inne działanie, które wymaga wersji produkcyjnej, możesz użyć przykładowych odpowiedzi interfejsu API.