Atención: se ha lanzado la versión 4.7 de la API. Consulta el registro de cambios. Las cadenas aún pueden hacer publicaciones relacionadas con el COVID‑19.

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 ver información detallada sobre cómo empezar a usar la API de Google My Business, consulta la sección 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",
    }
  ],
}

Publicaciones de llamada a la acción

Las publicaciones con una llamada a la acción incluyen un botón. El texto de este 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",
    }
  ],
}

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

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}