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:
- Crea publicaciones de eventos.
- Crea publicaciones de llamado a la acción.
- Crea publicaciones de oferta.
- Cómo editar publicaciones
- Borrar publicaciones.
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:
$ 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:
$ 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:
$ 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:
$ 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:
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}