REST Resource: accounts.locations.localPosts

Risorsa: LocalPost

Rappresenta un post locale per una località.

Rappresentazione JSON 
{
  "name": string,
  "languageCode": string,
  "summary": string,
  "callToAction": {
    object (CallToAction)
  },
  "createTime": string,
  "updateTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),
  "offer": {
    object (LocalPostOffer)
  }
}
Campi
name

string

Solo output. Identificatore Google di questo post locale nel formato: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

La lingua del post locale.
summary

string

Descrizione/testo del post locale.
callToAction

object (CallToAction)

L'URL a cui vengono reindirizzati gli utenti quando fanno clic sulla promozione. Ignorato per il tipo di argomento OFFER.
createTime

string (Timestamp format)

Solo output. Ora di creazione del post.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo output. Ora dell'ultima modifica del post apportata dall'utente.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

Informazioni sull'evento. Obbligatorio per i tipi di argomenti EVENT e OFFER.
state

enum (LocalPostState)

Solo output. Lo stato del post, che indica la fase del suo ciclo di vita.
media[]

object (MediaItem)

I contenuti multimediali associati al post. sourceUrl è l'unico campo di dati supportato per un MediaItem di LocalPost.
searchUrl

string

Solo output. Il link al post locale nella Ricerca Google. Questo link può essere utilizzato per condividere il post tramite social media, email, SMS e così via.
topicType

enum (LocalPostTopicType)

Obbligatorio. Il tipo di argomento del post: standard, evento, offerta o avviso.
alertType

enum (AlertType)

Il tipo di avviso per cui è stato creato il post. Questo campo è applicabile solo ai post di tipo di argomento Avviso e si comporta come un sottotipo di avvisi.
offer

object (LocalPostOffer)

Dati aggiuntivi per i post con le offerte. Questo valore deve essere impostato solo quando topicType è OFFER.

CallToAction

Un'azione che viene eseguita quando l'utente fa clic sul post

Rappresentazione JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
Campi
actionType

enum (ActionType)

Il tipo di azione che verrà eseguita.
url

string

L'URL a cui l'utente viene reindirizzato dopo aver fatto clic. Questo campo deve essere lasciato vuoto per l'invito all'azione di chiamata.

ActionType

Il tipo di azione che verrà eseguita.

Enum
ACTION_TYPE_UNSPECIFIED Tipo non specificato.
BOOK Questo post vuole che un utente prenoti un appuntamento/un tavolo e così via.
ORDER Questo post vuole che un utente ordini qualcosa.
SHOP Questo post vuole che un utente sfogli un catalogo di prodotti.
LEARN_MORE Questo post vuole che un utente scopra di più (sul suo sito web).
SIGN_UP Questo post vuole che un utente si registri/abboni/partecipi a qualcosa.
GET_OFFER

Deprecato. Utilizza OFFER in LocalPostTopicType per creare un post con contenuti dell'offerta.
CALL Questo post vuole che un utente chiami l'attività.

LocalPostEvent

Tutte le informazioni relative a un evento in un post locale.

Rappresentazione JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  }
}
Campi
title

string

Nome dell'evento.
schedule

object (TimeInterval)

Data/ora di inizio e di fine dell'evento.

TimeInterval

Un intervallo di tempo, incluso. Deve contenere tutti i campi per essere valido.

Rappresentazione JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Campi
startDate

object (Date)

La data di inizio di questo periodo.
startTime

object (TimeOfDay)

L'ora di inizio di questo periodo.
endDate

object (Date)

La data di fine di questo periodo.
endTime

object (TimeOfDay)

L'ora di fine di questo periodo.

TimeOfDay

Rappresenta un'ora del giorno. La data e il fuso orario non sono significativi o sono specificati altrove. Un'API può scegliere di consentire i secondi intercalari. I tipi correlati sono google.type.Date e google.protobuf.Timestamp.

Rappresentazione JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campi
hours

integer

Ore del giorno nel formato 24 ore. Deve essere compreso tra 0 e 23. Un'API potrebbe scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.
minutes

integer

Minuti dell'ora del giorno. Il valore deve essere compreso tra 0 e 59.
seconds

integer

Secondi di minuti del tempo. Deve essere compreso tra 0 e 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.
nanos

integer

Frazioni di secondo in nanosecondi. Deve essere compreso tra 0 e 999.999.999.

LocalPostState

Indica lo stato del post

Enum
LOCAL_POST_STATE_UNSPECIFIED Stato non specificato.
REJECTED Questo post è stato rifiutato a causa di una violazione delle norme relative ai contenuti.
LIVE Questo post è stato pubblicato e al momento viene visualizzato nei risultati di ricerca.
PROCESSING Questo post è in fase di elaborazione e non viene visualizzato nei risultati di ricerca.

LocalPostTopicType

Il tipo di argomento del post locale, utilizzato per selezionare diversi modelli per creare e visualizzare un post.

Enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Non è specificato alcun tipo di post.
STANDARD Il post contiene informazioni di base, come riepilogo e immagini.
EVENT Il post contiene informazioni di base e un evento.
OFFER Il post contiene informazioni di base, un evento e contenuti correlati all'offerta (ad es. codice coupon)
ALERT Annunci tempestivi e con priorità elevata relativi a un evento in corso. Questi tipi di post non sono sempre disponibili per la creazione.

AlertType

Il tipo di evento per cui è stato creato il post di avviso.

Enum
ALERT_TYPE_UNSPECIFIED Non è specificato alcun avviso.
COVID_19 Avvisi relativi alla pandemia di coronavirus del 2019. I post relativi al COVID-19 supportano solo un campo di riepilogo e un campo di invito all'azione. Quando questi avvisi non saranno più pertinenti, la creazione di nuovi post di avviso per il tipo COVID-19 verrà disattivata. Tuttavia, il commerciante potrà comunque gestire i post esistenti relativi al COVID-19.

LocalPostOffer

Campi specifici per i post con offerte.

Rappresentazione JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
Campi
couponCode

string

Facoltativo. Codice dell'offerta utilizzabile in negozio o online.
redeemOnlineUrl

string

Facoltativo. Link online per utilizzare l'offerta.
termsConditions

string

Facoltativo. Termini e condizioni dell'offerta.

Metodi

create

 Crea e restituisce un nuovo post locale associato alla località specificata.

delete

 Consente di eliminare un post locale.

get

 Recupera il post locale specificato.

list

 Restituisce un elenco di post locali associati a una località.

patch

 Aggiorna il post locale specificato e restituisce il post locale aggiornato.

reportInsights

 Restituisce approfondimenti per un insieme di post locali associati a una singola scheda.