Cómo crear publicaciones en Google

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

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

Antes de comenzar

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

Para obtener detalles sobre cómo comenzar a usar la API de Google Mi Negocio, consulta Configuración básica.

Publicaciones de eventos

Notifica a tus clientes sobre el próximo evento de 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 crear una publicación en una cuenta asociada con un usuario, usa la accounts.locations.localPosts API.

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 llamados 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 está determinado por el campo actionType de la publicación. Se agrega un vínculo a una URL proporcionada por el usuario al botón.

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 llamados a la acción pueden tener diferentes tipos de acciones que determinan el tipo de publicación de llamado a la acción.

Estos son 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 que le solicita 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 que vea detalles adicionales en un sitio web.
SIGN_UP Crea una publicación que le solicita al usuario que se registre, se inscriba o se una a algo.
CALL Crea una publicación que le solicita al usuario que llame a una empresa.

Publicaciones de ofertas

Para crear una publicación de ofertas, 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}