Interfejs Google Moja Firma API umożliwia tworzenie w wyszukiwarce Google wpisów z kilku kategorii, takich jak wiadomości, wydarzenia i oferty.
W tym samouczku pokazujemy, jak:
- Twórz wpisy o wydarzeniach.
- Utwórz posty z wezwaniem do działania.
- Twórz wpisy z ofertami.
- Edytuj posty.
- Usuń posty.
Zanim zaczniesz
Zanim zaczniesz korzystać z interfejsu Google Moja Firma API, musisz zarejestrować swoją aplikację i uzyskać dane uwierzytelniające OAuth 2.0.
Więcej informacji o tym, jak zacząć korzystać z interfejsu Google My Business API, znajdziesz w artykule o podstawowej konfiguracji.
Wpisy o wydarzeniach
Powiadom klientów o następnym wydarzeniu w Twojej firmie za pomocą wpisu. Twój post o wydarzeniu zawiera daty i godziny rozpoczęcia i zakończenia, które są wyraźnie widoczne we wpisie.
Aby opublikować posta na koncie powiązanym z użytkownikiem, użyj interfejsu API accounts.locations.localPosts
.
Aby utworzyć posta dla uwierzytelnionego użytkownika, wykonaj te czynności:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Come in for our spooky Halloween event!", "event": { "title": "Halloween Spook-tacular!", "schedule": { "startDate": { "year": 2017, "month": 10, "day": 31, }, "startTime": { "hours": 9, "minutes": 0, "seconds": 0, "nanos": 0, }, "endDate": { "year": 2017, "month": 10, "day": 31, }, "endTime": { "hours": 17, "minutes": 0, "seconds": 0, "nanos": 0, }, } }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-image.jpg", } ], "topicType": "EVENT" }
Posty z wezwaniem do działania
Posty z wezwaniem do działania zawierają przycisk. Tekst na przycisku z wezwaniem do działania jest określany w polu actionType
posta. Do przycisku zostanie dodany link do adresu URL podanego przez użytkownika.
Aby utworzyć wpis z przyciskiem wezwania do działania:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Order your Thanksgiving turkeys now!!", "callToAction": { "actionType": "ORDER", "url": "http://google.com/order_turkeys_here", }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-turkey-photo.jpg", } ], "topicType": "OFFER" }
Typy działań
Wezwanie do działania w sekcji „Posty” może mieć różne typy działań, które określają ich rodzaj.
Obsługiwane typy wezwań do działania:
Typy działań | |
---|---|
BOOK |
Tworzy posta z prośbą o umówienie się na spotkanie, stolik itp. |
ORDER |
Tworzy posta, który zachęca użytkownika do zamówienia. |
SHOP |
Tworzy posta, który zachęca użytkownika do przeglądania katalogu produktów. |
LEARN_MORE |
Tworzy posta z prośbą o zapoznanie się z dodatkowymi informacjami na stronie internetowej. |
SIGN_UP |
Tworzy posta, który zachęca użytkownika do zarejestrowania się, zarejestrowania lub dołączenia do czegoś. |
CALL |
Tworzy posta z prośbą o zadzwonienie do firmy. |
Wpisy z ofertami specjalnymi
Aby utworzyć wpis z ofertą, użyj tych elementów:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Buy one Google jetpack, get a second one free!!", "offer": { "couponCode": “BOGO-JET-CODE”, "redeemOnlineUrl": “https://www.google.com/redeem”, "termsConditions": “Offer only valid if you can prove you are a time traveler” }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-jetpack-photo.jpg", } ], "topicType": "OFFER" }
Edytuj posty
Po utworzeniu posta możesz go edytować, przesyłając prośbę o PATCH
.
Aby edytować posta:
$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
Usuń posty
Po utworzeniu posta możesz go usunąć, przesyłając prośbę o DELETE
.
Aby usunąć posta:
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}