Com a API Google My Business, você pode criar postagens no Pesquisa Google em várias categorias, como notícias, eventos e ofertas.
Este tutorial mostra como fazer o seguinte:
- Crie postagens de eventos.
- Crie postagens com call-to-action.
- Crie postagens de ofertas.
- Editar postagens.
- Excluir postagens.
Antes de começar
Antes de usar a API Google My Business, você precisa registrar seu aplicativo e receber as credenciais do OAuth 2.0.
Para saber como começar a usar a API Google My Business, consulte Noções básicas configuração.
Postagens de eventos
Faça uma postagem para avisar seus clientes sobre o próximo evento na sua empresa. Seu A postagem de um evento inclui datas e horários de início e término, que mostram com destaque na postagem.
Para fazer uma postagem em uma conta associada a um usuário, utilize o
API accounts.locations.localPosts
.
Para criar uma postagem para um usuário autenticado, use o seguinte:
$ 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" }
Postagens com call-to-action
As postagens com call-to-action incluem um botão. O texto da call-to-action
é determinado pelo campo actionType
da postagem. Um link para um
URL fornecido pelo usuário é adicionado ao botão.
Para criar uma postagem com um botão de call-to-action, use o seguinte:
$ 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" }
Tipos de ação
As postagens com call-to-action podem ter diferentes tipos de ação que determinam o tipo de postagem com call-to-action.
Confira a seguir os tipos de call-to-action compatíveis:
Tipos de ação | |
---|---|
BOOK |
Cria uma postagem que pede para o usuário agendar um horário, reservar uma mesa ou algo semelhante. |
ORDER |
Uma postagem que incentiva o usuário a fazer um pedido |
SHOP |
Uma postagem que incentiva o usuário a procurar um produto no seu catálogo. |
LEARN_MORE |
uma postagem que pede para o usuário ver mais detalhes sobre uma site. |
SIGN_UP |
uma postagem que incentiva o usuário a se registrar, inscrever-se ou participar; alguma coisa. |
CALL |
Uma postagem que incentiva o usuário a ligar para uma empresa |
Postagens de ofertas
Para criar uma postagem de oferta, use o seguinte:
$ 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" }
Editar postagens
Depois de criar uma postagem, você pode editá-la com uma solicitação PATCH
.
Para editar uma postagem, use o seguinte:
$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
Excluir postagens
Depois que uma postagem for criada, você poderá excluí-la com uma solicitação DELETE
.
Para excluir uma postagem, use o seguinte:
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}