REST Resource: accounts.locations.localPosts

Risorsa: LocalPost

Rappresenta un post locale di una sede.

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 per questo post locale nel modulo: 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. Ora di creazione del post.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 nel formato RFC3339 UTC "Zulu" 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 argomento 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)

I contenuti multimediali associati al post. sourceUrl è l'unico campo di dati supportato per un 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 cui è stato creato il post. Questo campo si applica solo ai post di avviso topicType e si comporta come un sottotipo di avvisi.
offer

object (LocalPostOffer)

Dati aggiuntivi per i post sulle offerte. Deve essere impostato solo se il valore di 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à indirizzato 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 richiede che un utente prenoti un appuntamento, un tavolo e così via.
ORDER Questo post richiede all'utente di ordinare qualcosa.
SHOP Questo post vuole che un utente sfogli il catalogo di un prodotto.
LEARN_MORE Questo post vuole che l'utente riceva ulteriori informazioni (sul proprio sito web).
SIGN_UP Questo post richiede che un utente si registri/si iscriva o partecipi a qualcosa.
GET_OFFER

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

LocalPostEvent

Tutte le informazioni relative a un evento presenti 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. Per essere valido, deve contenere tutti i campi.

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 del periodo.
endDate

object (Date)

La data di fine del 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

Le ore del giorno nel formato 24 ore. 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 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. 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. 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 ad alta priorità 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 Nessun avviso specificato.
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 sono più pertinenti, verrà disattivata la creazione di nuovi post di avviso per il tipo COVID-19. Tuttavia, il commerciante potrà continuare a gestire i suoi post esistenti relativi al COVID-19.

LocalPostOffer

Campi specifici per i post sulle offerte.

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

string

(Facoltativo) Codice 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 un nuovo post locale associato alla posizione specificata e lo restituisce.

delete

 Elimina un post locale.

get

 Recupera il post locale specificato.

list

 Restituisce un elenco di post locali associati a una posizione.

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.