REST Resource: accounts.locations.localPosts

Risorsa: LocalPost

Rappresenta un post locale di 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 di Google per questo post locale nel formato: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

La lingua del post locale.
summary

string

Descrizione/corpo del post locale.
callToAction

object (CallToAction)

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

string (Timestamp format)

Solo output. Data e ora di creazione del post.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi 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. L'ora dell'ultima modifica del post effettuata dall'utente.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi 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 in quale parte del suo ciclo di vita si trova.
media[]

object (MediaItem)

L'elemento multimediale associato al post. sourceUrl è l'unico campo dati supportato per LocalPost MediaItem.
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 il quale è stato creato il post. Questo campo è applicabile solo per i post di topicType Alert e si comporta come un sottotipo di Alert.
offer

object (LocalPostOffer)

Dati aggiuntivi per i post di offerte. 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 verrà reindirizzato l'utente quando fa clic. Questo campo non deve essere impostato 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 chiede a un utente di prenotare un appuntamento/un tavolo e così via.
ORDER Questo post chiede a un utente di ordinare qualcosa.
SHOP Questo post chiede a un utente di sfogliare un catalogo di prodotti.
LEARN_MORE Questo post desidera che un utente possa ottenere maggiori informazioni (sul sito web).
SIGN_UP Questo post richiede che un utente si registri, si iscriva o si iscriva a qualcosa.
GET_OFFER

Deprecato. Utilizza OFFER in LocalPostTopicType per creare un post con contenuti relativi all'offerta.
CALL Questo post chiede a un utente di chiamare l'attività.

LocalPostEvent

Tutte le informazioni relative a un evento pubblicate 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 del periodo.
startTime

object (TimeOfDay)

L'ora di inizio di questo periodo.
endDate

object (Date)

La data di fine del periodo.
endTime

object (TimeOfDay)

L'ora di fine del 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

Le ore del giorno nel formato 24 ore. Il valore deve essere compreso tra 0 e 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura di un'attività.
minutes

integer

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

integer

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

integer

Frazioni di secondi in nanosecondi. Il valore 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 ed è attualmente 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 Nessun tipo di post specificato.
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 il quale è stato creato il post di avviso.

Enum
ALERT_TYPE_UNSPECIFIED Nessun avviso specificato.
COVID_19 Avvisi relativi alla pandemia da 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 sono più pertinenti, la creazione di nuovi post di avviso per il tipo COVID-19 verrà disattivata. Tuttavia, il commerciante potrà continuare a gestire i post relativi al COVID-19 esistenti.

LocalPostOffer

Campi specifici per i post di offerte.

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

string

Campo facoltativo. Codice offerta utilizzabile in negozio oppure online.
redeemOnlineUrl

string

Campo facoltativo. Link online per utilizzare l'offerta.
termsConditions

string

Campo facoltativo. Termini e condizioni dell'offerta.

Metodi

create

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

delete

 Elimina un post locale.

get

 Restituisce 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 informazioni per un insieme di post locali associati a una singola scheda.