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,
  "scheduledTime": string,
  "recurringInstanceTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),

  // Union field topic_type_specific_fields can be only one of the following:
  "offer": {
    object (LocalPostOffer)
  }
  // End of list of possible types for union field topic_type_specific_fields.
}
Campi
name

string

Solo output. Identificatore Google per questo post locale nel formato: accounts/{accountId}/locations/{locationId}/localPosts/{local_post_id}
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.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

Se impostata, determina quando verrà pubblicato un post. Può essere impostato dall'utente per programmare i post in anticipo.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
recurringInstanceTime
(deprecated)

string (Timestamp format)

Solo output. Deprecato: utilizza event.recurring_instance_time. Questo campo verrà rimosso in una versione futura. Solo output. Ora dell'ultimo aggiornamento dell'istanza ricorrente del post.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
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 fase 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 elemento multimediale 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, messaggi 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 viene creato il post. Questo campo è applicabile solo ai post di tipo Alert e si comporta come un sottotipo di avvisi.
Campo unione topic_type_specific_fields. Campi specifici per un tipo di argomento. topic_type_specific_fields può essere solo uno dei seguenti tipi:
offer

object (LocalPostOffer)

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

CallToAction

Un'azione 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 verrà indirizzato quando fa clic. Questo campo deve essere lasciato vuoto per l'invito all'azione Chiama.

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/ecc.
ORDER Questo post vuole che un utente ordini qualcosa.
SHOP Questo post vuole che un utente sfogli un catalogo dei 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/iscriva/aderisca 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 presente in un post locale.

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

string

Nome dell'evento.
schedule

object (TimeInterval)

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

object (RecurrenceInfo)

Facoltativo. Memorizza informazioni sulla cadenza di un post ricorrente. Verrà impostato solo se il post è un post ricorrente.
recurringInstanceTime

string (Timestamp format)

Solo output. Ora dell'ultimo aggiornamento dell'istanza ricorrente del post.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

TimeInterval

Un intervallo di tempo, inclusivo. 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 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.

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o sono insignificanti. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • Un mese e un giorno, con un anno pari a zero (ad esempio, un anniversario).
  • Un anno da solo, con un mese e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

L'anno della data. Deve essere compreso tra 1 e 9999 oppure tra 0 e 9999 per specificare una data senza anno.
month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 o 0 per specificare un anno senza mese e giorno.
day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure compreso tra 0 e 31 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

TimeOfDay

Rappresenta un orario della giornata. 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 di un giorno nel formato 24 ore. Deve essere maggiore o uguale a 0 e in genere deve essere minore o uguale a 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.
minutes

integer

Minuti di un'ora. Deve essere maggiore o uguale a 0 e minore o uguale a 59.
seconds

integer

Secondi di un minuto. Deve essere maggiore o uguale a 0 e in genere minore o uguale a 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.
nanos

integer

Frazioni di secondi, in nanosecondi. Deve essere maggiore o uguale a 0 e minore o uguale a 999.999.999.

RecurrenceInfo

Rappresenta le informazioni sulla ricorrenza di un post locale.

Rappresentazione JSON 
{
  "seriesEndTime": string,

  // Union field occurrence_pattern can be only one of the following:
  "dailyPattern": {
    object (DailyOccurrencePattern)
  },
  "weeklyPattern": {
    object (WeeklyOccurrencePattern)
  },
  "monthlyPattern": {
    object (MonthlyOccurrencePattern)
  }
  // End of list of possible types for union field occurrence_pattern.
}
Campi
seriesEndTime

string (Timestamp format)

Facoltativo. L'ora di fine della serie di ricorrenze.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
Campo unione occurrence_pattern. Il pattern di ricorrenza del post ricorrente. occurrence_pattern può essere solo uno dei seguenti tipi:
dailyPattern

object (DailyOccurrencePattern)

Pattern di occorrenza giornaliero.
weeklyPattern

object (WeeklyOccurrencePattern)

Pattern di occorrenza settimanale.
monthlyPattern

object (MonthlyOccurrencePattern)

Pattern di ricorrenza mensile.

DailyOccurrencePattern

Questo tipo non contiene campi.

Rappresenta un pattern di occorrenza giornaliera.

WeeklyOccurrencePattern

Rappresenta un pattern di ricorrenza settimanale.

Rappresentazione JSON 
{
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Campi
daysOfWeek[]

enum (DayOfWeek)

Facoltativo. L'elenco dei giorni della settimana per l'offerta/l'evento. Se è vuoto, il post verrà ripetuto nello stesso giorno della settimana dell'ora di inizio di schedule.start_time dell'evento.

DayOfWeek

Rappresenta un giorno della settimana.

Enum
DAY_OF_WEEK_UNSPECIFIED Il giorno della settimana non è specificato.
MONDAY Lunedì
TUESDAY Martedì
WEDNESDAY Mercoledì
THURSDAY Giovedì
FRIDAY Venerdì
SATURDAY Sabato
SUNDAY Domenica

MonthlyOccurrencePattern

Rappresenta un pattern di ricorrenza mensile.

Rappresentazione JSON 
{

  // Union field monthly_option can be only one of the following:
  "dayOfMonth": integer,
  "dayOfWeekOccurrence": enum (DayOfWeekOccurrence)
  // End of list of possible types for union field monthly_option.
}
Campi
Campo unione monthly_option. L'opzione di ricorrenza per il pattern di occorrenza mensile. monthly_option può essere solo uno dei seguenti tipi:
dayOfMonth

integer

Il giorno del mese.
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

Il giorno della settimana in cui si verifica l'evento nel mese. Il giorno della settimana è implicito nell'ora di inizio dell'evento. Ad esempio, se un evento inizia di venerdì e dayOfWeekOccurrence è SECOND, l'evento si ripeterà il secondo venerdì di ogni mese.

DayOfWeekOccurrence

Il giorno della settimana in cui si verifica l'evento nel mese.

Enum
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED Occorrenza di un giorno della settimana non specificato.
FIRST Il primo giorno della settimana del mese.
SECOND Secondo giorno della settimana del mese.
THIRD Il terzo giorno della settimana del mese.
FOURTH Quarto giorno della settimana del mese.
LAST Ultimo giorno della settimana del mese.

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 è pubblicato e attualmente viene visualizzato nei risultati di ricerca.
PROCESSING Questo post è in fase di elaborazione e non viene visualizzato nei risultati di ricerca.
SCHEDULED Questo post è programmato per il futuro e non viene visualizzato nei risultati di ricerca.
RECURRING Questo post è un post ricorrente e al momento viene visualizzato nei risultati di ricerca.

LocalPostTopicType

Il tipo di argomento del post locale, che viene utilizzato per selezionare modelli diversi 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 il riepilogo e le 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 Nessun avviso specificato.
COVID_19 Avvisi relativi alla pandemia di coronavirus del 2019. I post sul COVID-19 supportano solo un campo riepilogativo e un campo invito all'azione. Quando questi avvisi non saranno più pertinenti, la creazione di nuovi post di avviso di tipo COVID-19 verrà disattivata. Tuttavia, il commerciante potrà comunque gestire i suoi 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 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 località.

patch

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