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 My Business, consulta Configuración básica.

Publicaciones de eventos

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

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

Los siguientes son los tipos de llamados a la acción admitidos:

Tipos de acciones
BOOK Crea una publicación que le solicite al usuario que reserve una cita, una mesa o algo similar.
ORDER Crea una publicación que le solicite al usuario que realice un pedido.
SHOP Crea una publicación que le solicite al usuario que explore un catálogo de productos.
LEARN_MORE Crea una publicación que le solicite al usuario que vea detalles adicionales en un sitio web.
SIGN_UP Crea una publicación que le solicite al usuario que se registre, se inscriba o se una a algo.
CALL Crea una publicación que le solicite al usuario que llame a una empresa.

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}