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 Business Profile API to interfejsy programowania, które umożliwiają deweloperom tworzenie aplikacji do zarządzania kontem i danymi o lokalizacji w Profilu Firmy. Interfejsy API umożliwiają sprzedawcom lub ich przedstawicielom zarządzanie sposobem wyświetlania ich danych w Google oraz kontrolowanie, kto może współzarządzać ich danymi. Za pomocą interfejsów API można też zarządzać danymi utworzonymi przez użytkowników, takimi jak zdjęcia, wpisy i opinie.

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ć aktualizacji Google w takim samym zakresie jak użytkownicy interfejsu.

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

Interfejsy GBP nie są dostępne publicznie. Aby móc korzystać z interfejsów GBP, użytkownicy muszą poprosić o dostęp do nich. Dostęp do interfejsów API Google Play mają osoby i firmy, które mogą przedstawić uzasadniony powód biznesowy. Oto kilka rekomendacji dotyczących wykazania nielegalności działalności:

Użyj prawidłowego firmowego adresu e-mail powiązanego z Twoją domeną firmową.
Upewnij się, że witryna firmy jest aktualna i aktywna.

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

Nie. Nawet jeśli masz dostęp do interfejsów GBP API, nie możesz wysyłać zapytań o dane w profilu firmy w Google, 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ązanych 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 zawiera te ważne funkcje wywołania interfejsu API:
- FoodMenus
- Media
- Reviews
- LocalPosts
My Business Account Management API
My Business Lodging API
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 identyfikatorze 12345678, to dostęp zostanie przyznany do projektu o identyfikatorze 12345678. W związku z tym 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 tabeli poniżej znajdziesz informacje o różnych interfejsach API i ich możliwościach.

API	Dokumentacja źródłowa	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 podrzę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.
Lodging API	Dokumentacja	Umożliwia zarządzanie danymi dotyczącymi zakwaterowania, np. udogodnieniami obiektu i zasadami dla firm w Google. Interfejs API jest przeznaczony dla firm, które świadczą usługi zakwaterowania, np. hoteli. Interfejs Lodging API umożliwia deweloperom 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 przypadku firm. Przekierowywać użytkowników do wykonywania działań takich jak rezerwacja spotkania, rezerwacja stolika czy zamawianie jedzenia z dostawą.
Notifications API	Dokumentacja	Umożliwia zarządzanie ustawieniami powiadomień na wybranych kontach.
Verifications API	Dokumentacja	Rozpoczyna proces weryfikacji lokalizacji. Raportuje wszystkie dostępne opcje weryfikacji dla lokalizacji w określonym języku.
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 interfejsów API przesyłanie zdjęć i filmów do profilu firmy.
Reviews API	Dokumentacja	Umożliwia sprzedawcom otrzymywanie opinii i odpowiadanie na nie 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 masz pytania dotyczące dostępnych danych lub sposobu uzyskiwania do nich dostępu, wypełnij ten formularz.

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

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

Jako agencja zarejestruj konto organizacji w Profilu Firmy.
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 GBP do edycji i uzyskiwania dostępu do danych GBP.

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 ponad 10 lokalizacji?

Tak. Możesz poprosić o weryfikację zbiorczą co najmniej 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). Menedżerowie witryn są na przykład traktowani inaczej i mogą dodawać siebie do lokalizacji franczyz.

Jakie są limity dotyczące interfejsów API?

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

O ile limitów mogę poprosić?

Limit to ograniczony zasób. Zespół pomocy interfejsu GBP API określa, czy Twoja prośba o zwiększenie limitu kwalifikuje się do rozpatrzenia, na podstawie potwierdzenia wykorzystania limitu w przeszłości. Jeśli średnie wykorzystanie limitu jest mniejsze niż 70% obecnych limitów, możemy odmówić dalszego zwiększenia limitów.

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 albo użycie informacji o kliencie i przeniesienie ich do folderu prywatnego (pod warunkiem, że nie zmienisz żadnych podstawowych informacji o informacjach, takich jak nazwa, adres, kategoria) albo utworzenie informacji o siedzibie 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.