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 API usługi Profil Firmy w Google?

Interfejsy Business Profile API to interfejsy programistyczne umożliwiające deweloperom pisanie aplikacji do zarządzania kontem w Profilu Firmy i danymi o lokalizacji. Interfejsy API umożliwiają sprzedawcom i ich przedstawicielom zarządzanie sposobem wyświetlania ich danych w Google oraz kontrolę nad tym, kto 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, posty i opinie).

Interfejsy Business Profile API oferują prawie te same funkcje co interfejs Profilu Firmy, ale zawierają też kilka dodatkowych funkcji charakterystycznych dla interfejsów API. Użytkownicy interfejsów API mogą oczekiwać aktualizacji Google tak samo jak w przypadku użytkowników interfejsu.

Kto może uzyskać dostęp do interfejsów API usługi Profil Firmy w Google?

Interfejsy API Profilu Firmy w Google nie są dostępne publicznie. Aby z nich korzystać, użytkownicy muszą poprosić o dostęp do interfejsów API usługi Profil Firmy w Google. Każda osoba lub firma, która może wykazać, że ma uzasadnienie prawne, aby uzyskać dostęp do interfejsów API Profilu Firmy w Google, może z niej korzystać. Oto kilka zaleceń, które pomogą Ci potwierdzić legalność Twojej firmy:

Użyj prawidłowego firmowego adresu e-mail, który jest powiązany z domeną Twojej firmy.
Upewnij się, że strona internetowa firmy jest aktualna i aktywna.

Czy dostęp do interfejsów Profilu Firmy w Google umożliwia użytkownikom wysyłanie zapytań o dane z Profilu Firmy w Google?

Nie. Nawet jeśli masz dostęp do interfejsów Profilu Firmy w Google, nie możesz wysyłać zapytań dotyczących danych z Profilu Firmy w Google, chyba że masz dostęp do tego konkretnego Profilu Firmy w Google.

Jakie zasady obowiązują użytkowników interfejsu API usługi Profil Firmy w Google?

Partnerzy muszą przestrzegać zasad Profilu Firmy w Google oraz wszystkich zasad i Warunków korzystania z usługi interfejsu API.

W jaki sposób użytkownicy mogą uzyskać dostęp do interfejsu API Profilu Firmy w Google?

Aby utworzyć pierwszą aplikację kliencką, 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 mogą uzyskać dostęp do określonego interfejsu API w ramach GBP API?

Z Profilem Firmy jest 8 interfejsów API, które musisz włączyć w Konsoli interfejsów API Google:

Interfejs API Google Moja Firma w wersji 4.9, który zawiera te ważne wywołania interfejsu API:
- FoodMenus
- Media
- Reviews
- LocalPosts
Interfejs API zarządzania kontem My Business
Interfejs API My Business Lodging
Interfejs API My Business Place Actions
My Business Notifications API
Interfejs API weryfikacji firmy
Interfejs API informacji o firmie
Interfejs API My Business Q&A
Interfejs Business Profile Performance API

Jeśli aplikacja użytkownika, która prosi o dostęp, zostanie zatwierdzona, otrzyma standardowy limit domyślny dla wszystkich 8 interfejsów API.

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

Dostęp do interfejsu API Profilu Firmy w Google 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 projekcie nr 12345678, zostanie przyznany dostęp do projektu nr – 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 Google Business Profile API. Partnerzy muszą kontrolować dostęp do projektu Google Cloud, przyznając mu odpowiedni dostęp, aby uniknąć nadużyć.

Czy macie podsumowanie interfejsów API i przykładowe 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
Account Management API,	Dokumentacja	Zarządzać dostępem do lokalizacji. Tworzy konto o określonej nazwie i typie w ramach danego konta nadrzędnego. Wyświetla listę wszystkich kont uwierzytelnionego użytkownika. Wyświetla listę oczekujących zaproszeń dla określonego konta. Przenosi lokalizację z konta należącego do użytkownika na inne konto. Aktualizuje administratora w określonej lokalizacji.
Interfejs Business Information API	Dokumentacja	Interfejs Business Information API umożliwia zarządzanie cyklem życia profilu i dodawanie informacji o firmie w Profilu Firmy oraz zarządzanie nimi. Umożliwia sprzedawcom pobieranie, tworzenie, aktualizowanie i usuwanie profili firm w Google. Umożliwia sprzedawcom pobieranie lub aktualizowanie atrybutów profilu. Umożliwia sprzedawcom pobieranie lub wyszukiwanie sieci i kategorii profili.
Lodging API	Dokumentacja	Umożliwia zarządzanie danymi dotyczącymi miejsc noclegowych, np. udogodnieniami w hotelu i zasadami dotyczącymi firm w Google. Interfejs API jest przeznaczony dla firm świadczących usługi hotelarskie, takich jak hotele. Lodging API umożliwia deweloperom aktualizowanie atrybutów zakwaterowania w Profilu Firmy w Google.
Place Actions API,	Dokumentacja	Umożliwia zarządzanie linkami do działań związanych z miejscem dotyczącymi firm. Przekierowuj użytkowników, aby wykonywali takie działania jak np. rezerwacja stolika czy dostawę jedzenia.
Interfejs API powiadomień	Dokumentacja	Umożliwia zarządzanie ustawieniami powiadomień na określonych kontach.
Weryfikacja za pomocą interfejsu API	Dokumentacja	Rozpoczyna proces weryfikacji lokalizacji. Raportuje wszystkie opcje weryfikacji obowiązujące w danej lokalizacji w określonym języku.
Interfejs API Q&A	Dokumentacja	Umożliwia zarządzanie pytaniami i odpowiedziami dotyczącymi lokalizacji.
Business Profile Performance API	Dokumentacja	Umożliwia sprzedawcom pobieranie statystyk skuteczności ich wizytówki w Google. Statystyki obejmują wyświetlenia strony firmy, prośby o wskazówki dojazdu, kliknięcia prowadzące do połączenia, kliknięcia prowadzące do witryny, rezerwacje, zamówienia jedzenia czy interakcje w menu.
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 pobieranie, tworzenie i aktualizowanie postów lokalnych.
Interfejs API FoodMenus	Dokumentacja	Umożliwia sprzedawcom pobieranie, tworzenie i aktualizowanie menu jedzenia w profilu firmy.

W jaki sposób partnerzy mogą skonfigurować strukturę konta, aby korzystać z interfejsów usługi Profil Firmy w Google?

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

Zarejestruj konto organizacji GBP jako agencja.
Poznaj pojęcia grup użytkowników i grup firmowych.
Z tego przewodnika dowiesz się, jak zarządzać lokalizacjami w imieniu firm.

W jaki sposób firmy upoważniają partnera API do zarządzania informacjami o firmie?

Firmy przyznają dostęp partnerowi zewnętrznemu na 2 sposoby:

Konfiguracja protokołu OAuth: zapoznaj się z tym przewodnikiem , aby dowiedzieć się, jak platformy partnerów zewnętrznych wykorzystują dane logowania sprzedawcy do edytowania i uzyskiwania dostępu do danych w Profilu Firmy w Google w imieniu sprzedawcy lub firmy.
Dostęp właściciela lub menedżera: jeśli sprzedawca uwzględni w Profilu Firmy w Google jako menedżera Profilu Firmy w Google partnera, który powinien być głównym właścicielem tej usługi, partner zewnętrzny nie musi używać danych logowania sprzedawcy do używania interfejsów API Profilu Firmy w celu edytowania i uzyskiwania dostępu do danych z Profilu Firmy w Google.

Uwaga: zdecydowanie zalecamy, aby partnerzy 3P nie zgłaszali się jako właściciele Profilu Firmy, a jedynie siebie jako menedżera.

Czy jeśli firma ma ponad 10 lokalizacji, czy można ją zweryfikować zbiorczo?

Tak. Możesz poprosić o weryfikację zbiorczą w przypadku ponad 10 profili. Po weryfikacji opublikowanymi lokalizacjami sklepów można zarządzać za pomocą interfejsów Business Profile API w taki sam sposób jak innymi lokalizacjami, z kilkoma wyjątkami. Na przykład menedżerowie lokalizacji są traktowani inaczej i mogą dodawać siebie do oddziałów franczyzowych.

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

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

O jaki limit mogę poprosić?

Limit jest ograniczony. Zespół pomocy interfejsu GBP API określa, czy możesz poprosić o zwiększenie limitu, potwierdzając wcześniejsze wykorzystanie limitu. Jeśli średnie wykorzystanie limitu wynosi mniej niż 70% bieżących limitów, możesz utracić możliwość dalszego zwiększania limitów.

Czy partnerzy korzystający z interfejsu GBP API mogą utworzyć konto testowe dla usługi produkcyjnej?

Nie. Niestety nie można bezpośrednio utworzyć fałszywej informacji o Profilu Firmy w środowisku produkcyjnym za pomocą jej interfejsu użytkownika lub interfejsu API i przetestować ją pod ich kątem.

Większość utworzonych fałszywych informacji o firmie jest zgłaszana przez nasze moderowanie i zawieszana. Najlepiej jest skorzystać z wizytówki klienta i pracować nad nią po godzinach (pod warunkiem, że nie zmienisz żadnych podstawowych informacji we wpisie, takich jak nazwa, adres czy kategoria) lub utworzysz wizytówkę dla siedziby firmy. Jeśli chcesz przetestować odpowiedź interfejsu API, aby zweryfikować informacje o produkcie lub inne działanie, które wymaga podania informacji o produkcie, możesz użyć przykładowych odpowiedzi interfejsu API.