Crear publicaciones en Google

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

En este tutorial te explicamos cómo hacer lo siguiente:

Antes de empezar

Para usar la API de Google My Business, debes registrar tu aplicación y obtener credenciales de OAuth 2.0.

Para saber cómo empezar a usar la API de Google My Business, consulta el artículo Configuración básica.

Publicaciones sobre eventos

Informa a tus clientes sobre el próximo evento que tendrá lugar en tu empresa mediante una publicación. La publicación de un evento incluye de forma destacada la fecha y la hora de inicio y de finalización.

Si quieres crear una publicación en una cuenta asociada a un usuario, utiliza la API accounts.locations.localPosts.

Si quieres crear una publicación para un usuario autenticado, haz 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 llamada a la acción

Las publicaciones con una llamada a la acción incluyen un botón. El texto de ese botón viene determinado por el campo actionType de la publicación. Al botón se le añade un enlace a una URL proporcionada por el usuario.

Para crear una publicación con un botón de llamada a la acción, utiliza 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 acción

Las publicaciones de llamada a la acción pueden tener diferentes tipos de acción que determinan el tipo de publicación de llamada a la acción.

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

Tipos de acción
BOOK Crea una publicación que pide a un usuario que reserve una cita, una mesa o algo similar.
ORDER Crea una publicación que pide a un usuario que haga un pedido.
SHOP Crea una publicación que pide a un usuario que navegue por un catálogo de productos.
LEARN_MORE Crea una publicación que pide a un usuario que obtenga más información en un sitio web.
SIGN_UP Crea una publicación que pide a un usuario que se registre en una página o se una a algo.
CALL Crea una publicación que pide al usuario que llame a una empresa.

Publicaciones sobre ofertas

Para crear una publicación sobre ofertas, usa estos elementos:

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 ha creado una publicación, puedes editarla con una solicitud PATCH.

Para editar una publicación, utiliza lo siguiente:

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

Eliminar publicaciones

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

Para eliminar una publicación, utiliza lo siguiente:

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