Criar postagens no Google

Com a API Google My Business, você pode criar postagens em várias categorias na Pesquisa Google, como notícias, eventos e ofertas.

Este tutorial mostra como fazer o seguinte:

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 o artigo Configuração básica.

Postagens de eventos

Use uma postagem para notificar os clientes sobre o próximo evento na sua empresa. A postagem de um evento inclui datas e horários de início e término, que aparecem em destaque.

Para fazer uma postagem em uma conta associada a um usuário, use a API accounts.locations.localPosts.

Se quiser criar uma postagem para um usuário autenticado, use o seguinte:

HTTP
$ 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 uma call-to-action incluem um botão. O texto dele é 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:

HTTP
$ 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.

Confira a seguir os tipos de call-to-action compatíveis:

Tipos de ação
BOOK Uma postagem que incentiva o usuário a agendar um horário, uma mesa ou algo semelhante
ORDER Uma postagem que incentiva o usuário a pedir algo
SHOP Uma postagem que incentiva o usuário a navegar por um catálogo de produtos
LEARN_MORE Cria uma postagem que solicita que o usuário veja mais detalhes em um site.
SIGN_UP Uma postagem que incentiva o usuário a se registrar, se inscrever ou participar de algo
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:

HTTP
$ 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 que uma postagem é criada, você pode editá-la usando uma solicitação PATCH.

Para editar uma postagem, use o seguinte:

HTTP
$ 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 é criada, você pode excluí-la com uma solicitação DELETE.

Para excluir uma postagem, use o seguinte:

HTTP
$ DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}