Creare post su Google

L'API Google My Business ti consente di creare post nella Ricerca Google in diverse categorie, come notizie, eventi e offerte.

Questo tutorial illustra come:

Prima di iniziare

Prima di utilizzare l'API Google My Business, devi registrare la tua applicazione e ottenere le credenziali OAuth 2.0.

Per informazioni dettagliate su come iniziare a utilizzare l'API Google My Business, consulta la sezione Configurazione di base.

Post sugli eventi

Comunica ai clienti il prossimo evento della tua attività con un post. Il post per un evento include le date e le ore di inizio e di fine, che vengono visualizzate in evidenza nel post.

Per pubblicare un post in un account associato a un utente, utilizza l'API accounts.locations.localPosts.

Per creare un post per un utente autenticato, utilizza quanto segue:

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

Post con invito all'azione

I post con un invito all'azione includono un pulsante. Il testo del pulsante di invito all'azione è determinato dal campo actionType del post. Al pulsante viene aggiunto un link a un URL fornito dall'utente.

Per creare un post con un pulsante di invito all'azione, utilizza quanto segue:

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

Tipi di azioni

I post con invito all'azione possono avere diversi tipi di azioni che determinano il tipo di post con invito all'azione.

Di seguito sono riportati i tipi di inviti all'azione supportati:

Tipi di azioni
BOOK Crea un post che chiede all'utente di prenotare un appuntamento, un tavolo o qualcosa di simile.
ORDER Crea un post che chiede all'utente di ordinare qualcosa.
SHOP Crea un post che chiede all'utente di sfogliare un catalogo di prodotti.
LEARN_MORE Crea un post che chiede all'utente di visualizzare ulteriori dettagli su un sito web.
SIGN_UP Crea un post che chiede all'utente di registrarsi, iscriversi o partecipare a qualcosa.
CALL Crea un post che chiede all'utente di chiamare un'attività.

Post sulle offerte

Per creare un post di offerta, utilizza quanto segue:

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

Modificare i post

Una volta creato un post, puoi modificarlo con una richiesta PATCH.

Per modificare un post, utilizza quanto segue:

HTTP
$ PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary
{
  "summary": "Order your Christmas turkeys now!!"
}

Eliminare i post

Dopo aver creato un post, puoi eliminarlo con una richiesta DELETE.

Per eliminare un post, utilizza quanto segue:

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