Creare post su Google

L'API Google My Business consente di creare Post in Ricerca Google all'interno di diverse categorie, ad esempio notizie, eventi e offerte.

Questo tutorial ti mostra 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 Configurazione di base.

Post su eventi

Comunica ai tuoi clienti il prossimo evento nella tua attività con un post. Il post per un evento include le date e gli orari di inizio e di fine, che vengono visualizzati in evidenza sul post.

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

Per creare un post per un utente autenticato, utilizza il seguente codice:

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 di invito all'azione

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

Per creare un post con un pulsante di invito all'azione, utilizza la seguente interfaccia:

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 azione

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

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

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

Post su offerte

Per creare un post con 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"
}

Modifica post

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

Per modificare un post, utilizza i seguenti metodi:

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

Elimina post

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

Per eliminare un post, utilizza la seguente istruzione:

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