Crea publicaciones en Google

La API de Google Mi Negocio te permite crear publicaciones en la Búsqueda de Google dentro de varias categorías, como noticias, eventos y ofertas.

En este instructivo, se muestra cómo hacer lo siguiente:

Antes de comenzar

Antes de utilizar la API de Google Mi Negocio, debes registrar tu aplicación y obtener las credenciales de OAuth 2.0.

Si deseas obtener detalles para comenzar a usar la API de Google My Business, consulta la Configuración básica.

Publicaciones de eventos

Notifica a tus clientes sobre el próximo evento en tu empresa con una publicación. La publicación de un evento incluye las fechas y horas de inicio y finalización, que se muestran de forma destacada en la publicación.

Para realizar una publicación en una cuenta asociada con un usuario, usa la API de accounts.locations.localPosts.

Para crear una Publicación para un usuario autenticado, usa lo siguiente:

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"
}

Publicaciones de llamado a la acción

Las publicaciones con un llamado a la acción incluyen un botón. El texto del botón de llamado a la acción se determina mediante el campo actionType de la publicación. Se agrega al botón un vínculo a una URL proporcionada por el usuario.

Para crear una publicación con un botón de llamado a la acción, usa lo siguiente:

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 acciones

Las publicaciones de llamado a la acción pueden tener diferentes tipos de acción que determinan su tipo.

A continuación, se indican los tipos de llamados a la acción admitidos:

Tipos de acciones
BOOK Crea una publicación que le solicita al usuario que reserve una cita, una mesa o algo similar.
ORDER Crea una publicación en la que se le pide al usuario que pida algo.
SHOP Crea una publicación que le solicita al usuario que explore un catálogo de productos.
LEARN_MORE Crea una publicación que le solicita al usuario ver detalles adicionales en un sitio web.
SIGN_UP Crea una publicación en la que se le solicita al usuario que se registre, se registre o se una a algo.
CALL Crea una publicación que le solicita al usuario que llame a un negocio.

Publicaciones de ofertas

Para crear una Publicación de oferta, usa lo siguiente:

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 publicaciones

Una vez que se crea una publicación, puedes editarla con una solicitud PATCH.

Para editar una Publicación, usa lo siguiente:

HTTP
$ PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary
{
  "summary": "Order your Christmas turkeys now!!"
}

Borrar publicaciones

Después de crear una publicación, puedes borrarla con una solicitud DELETE.

Para borrar una publicación, usa lo siguiente:

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