Rejestrowanie lokalizacji w profilu firmy

Profil Firmy to bezpłatne i łatwe w użyciu narzędzie dla firm i organizacji, które służy do zarządzania obecnością w internecie w usługach Google, np. w wyszukiwarce i Mapach.

Interfejs Google Business Profile API udostępnia interfejs do zarządzania informacjami o lokalizacji firmy w Google. Firma może przyznać dostęp za pośrednictwem protokołu OAuth innej firmie, aby mogła zarządzać jej profilem w jej imieniu.

Zarządzane firmy w Profilu Firmy zostały już zweryfikowane w ramach procesu weryfikacji. Możesz przedłużyć proces wyrażania zgody w Profilu Firmy, aby uwzględnić te firmy w Business Messages i automatycznie je zweryfikować przed uruchomieniem w Business Messages.

Jest to bardziej skalowalna i szybsza metoda uruchamiania Business Messages oraz zalecana metoda włączania wiadomości w przypadku lokalizacji profilu firmy.

Wymagania wstępne

Musisz być istniejącym partnerem Profilu Firmy z dostępem do interfejsów Google Business Profile API. Jeśli nie, postępuj zgodnie z wymaganiami wstępnymi Profilu Firmy, aby poprosić o dostęp.

Po uzyskaniu dostępu do interfejsu Google Business Profile API postępuj zgodnie z instrukcjami dotyczącymi konfiguracji podstawowej oraz konfiguracji OAuth.

Włączanie funkcji Business Messages dla zweryfikowanej lokalizacji profilu firmy

Poniższy diagram pokazuje, w jaki sposób Twoja usługa internetowa może korzystać z weryfikacji lokalizacji Profilu Firmy dla agenta Business Messages. Poniżej znajdziesz szczegółowe instrukcje.

Schemat blokowy procesu automatycznej weryfikacji pracowników przy użyciu weryfikacji profilu firmy

  1. W dotychczasowym procesie uzyskiwania zgody OAuth, w ramach którego właściciel konta w Profilu Firmy przyznaje Ci uprawnienia do wywoływania interfejsów API Profilu Firmy w jego imieniu, zaktualizuj zakresy interfejsów API, tak aby zawierały

    • https://www.googleapis.com/auth/business.manage
    • https://www.googleapis.com/auth/businesscommunications

    Oba zakresy są wymagane do automatycznej weryfikacji lokalizacji agenta i firmy.

  2. Utwórz agenta z displayName, który odpowiada nazwie co najmniej jednej z wizytówek w Profilu Firmy w Google należących do danych logowania OAuth uzyskanych w poprzednim kroku. Wyszukaj lokalizacje za pomocą interfejsu Google Business Profile API, aby znaleźć nazwy firm.

    W przypadku dopasowywania nazwy

    • Wielkość liter nie jest rozróżniana.
    • Imię i nazwisko agenta musi być identyczne z pierwszym wyrazem lub słowem w nazwie lokalizacji w profilu firmy. Na przykład agent o nazwie „Piekarnia GBP” jest zgodny z hasłami „Piekarnia Gbp”, „Piekarnia BBQ” i „Piekarnia Sylwia”, ale nie pasuje do „Piekarnia Kraków”.

  3. Dla każdej lokalizacji w usłudze Profil Firmy utwórz lokalizację o tym samym identyfikatorze placeId. Tag placeId lokalizacji profilu firmy jest zawarty w obiekcie LocationKey podczas pobierania lokalizacji przez interfejs Google Business Profile API.

  4. W przypadku utworzonego agenta i uzyskanego tokena OAuth poproś o weryfikację agenta.

    Prośba o weryfikację wymaga podania informacji kontaktowych marki. Jednak proces weryfikacji nie wyśle e-maila do marki, jeśli nazwa agenta pasuje do nazwy profilu firmy, a token OAuth został uzyskany w prawidłowym zakresie.

    Jeśli zrobisz to prawidłowo, dane wyjściowe żądania weryfikacji powinny od razu zwrócić wartość verificationState (VERIFICATION_STATE_VERIFIED). Jeśli verificationState zwraca inną wartość, prawdopodobnie podczas wysyłania żądania nie był używany prawidłowy token OAuth lub nie udało się dopasować agenta do lokalizacji profilu firmy.

  5. Użyj tego samego tokena OAuth, aby poprosić o weryfikację lokalizacji dla wszystkich lokalizacji należących do firmy w profilu firmy.

    Tak jak w przypadku weryfikacji agenta, jeśli zostało wykonane poprawnie, dane wyjściowe żądania weryfikacji powinny od razu zwracać wartość verificationState równą VERIFICATION_STATE_VERIFIED. Jeśli verificationState zwraca inną wartość, prawdopodobnie podczas wysyłania żądania nie był używany prawidłowy token OAuth albo lokalizacja w Profilu Firmy nie jest zarezerwowana i zweryfikowana.

  6. Uruchom agenta z punktem wejścia LOCATION.

  7. Włącz przesyłanie wiadomości do określonych lokalizacji poprzez uruchomienie lokalizacji, która ma być dostępna w wyszukiwarce i Mapach. Po rozpoczęciu procesu publikowania wiadomości dla każdej wprowadzonej lokalizacji będą dostępne dla użytkowników w ciągu kilku godzin.

Gdy wykonasz te czynności, wszystkie wiadomości klientów będą publikowane w Twoim zarejestrowanym webhooku Business Messages. Odpowiedzi musisz wysyłać klientom za pomocą interfejsu Business Messages API.