Crea publicaciones en Google

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

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

Antes de comenzar

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

Para obtener más información sobre cómo empezar a utilizar la API de Google My Business, consulta la sección Información básica sobre configuración.

Publicaciones de eventos

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

Para realizar una publicación en una cuenta asociada a un usuario, utiliza el 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 con llamado a la acción

Las publicaciones con un llamado a la acción incluyen un botón. El texto del llamado a la acción está determinado por el campo actionType de la publicación. Un vínculo a un la URL proporcionada por el usuario se agregará 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 acción

Las publicaciones con llamado a la acción pueden tener diferentes tipos de acción que determinen su tipo. de la publicación de llamado a la acción.

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

Tipos de acción
BOOK Crea una publicación que le pide a un usuario que reserve una cita, una mesa o algo similar.
ORDER Crea una publicación en la que se le pide al usuario que haga un pedido.
SHOP Crea una publicación que solicite al usuario explorar un producto. en tu catálogo de productos.
LEARN_MORE Crea una publicación que le solicita al usuario ver detalles adicionales de un sitio web.
SIGN_UP Crea una publicación que le solicite a un usuario que se registre, se registre o se una. o algo.
CALL Crea una publicación que 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

Después de crear 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 mediante una solicitud DELETE.

Para borrar una publicación, usa lo siguiente:

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