Questa pagina è stata tradotta dall'API Cloud Translation.

ActionLink

Rappresentazione JSON
ActionPlatform
ActionLinkType
OrderOnlineMetadata
- Rappresentazione JSON
FulfillmentOption
- Rappresentazione JSON
FulfillmentType
AvailableDay
- Rappresentazione JSON
Data
- Rappresentazione JSON
FeeDetails
- Rappresentazione JSON
NoFee
MinimumFee
- Rappresentazione JSON
FixedFee
- Rappresentazione JSON
FoodOrderingMetadata
- Rappresentazione JSON
FeeDetails
- Rappresentazione JSON
FeeType
FeeAmount
- Rappresentazione JSON
Denaro
- Rappresentazione JSON
MoneyRange
- Rappresentazione JSON
QuantitativeValue
- Rappresentazione JSON
RangeValue
- Rappresentazione JSON
DurationRange
- Rappresentazione JSON
AdvanceOrderDetails
- Rappresentazione JSON
EventMetadata
- Rappresentazione JSON
Superficie

Un URL dell'azione con lingua associata, elenco di paesi limitati e piattaforma facoltativa che indica la piattaforma su cui deve essere eseguita questa azione.

Rappresentazione JSON

Rappresentazione JSON
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum (`ActionPlatform`), "actionLinkType": enum (`ActionLinkType`), "orderOnlineMetadata": { object (`OrderOnlineMetadata`) }, "foodOrderingMetadata": { object (`FoodOrderingMetadata`) }, "eventMetadata": { object (`EventMetadata`) } }

{
  "url": string,
  "language": string,
  "restrictedCountry": [
    string
  ],
  "platform": enum (ActionPlatform),
  "actionLinkType": enum (ActionLinkType),
  "orderOnlineMetadata": {
    object (OrderOnlineMetadata)
  },
  "foodOrderingMetadata": {
    object (FoodOrderingMetadata)
  },
  "eventMetadata": {
    object (EventMetadata)
  }
}

Campi
`url`	`string` L'URL del punto di ingresso per questo link di azione.
`language`	`string` Il tag lingua BCP-47 che identifica la lingua in cui sono disponibili i contenuti di questo URI.
`restrictedCountry[]`	`string` Codice paese ISO 3166-1 alpha-2. Lascia vuoto per visibilità senza limitazioni.
`platform`	`enum (ActionPlatform)` La piattaforma su cui deve essere eseguita questa azione. Se questo campo non viene impostato, ACTION_PLATFORM_WEB_APPLICATION verrà utilizzato come riserva.
`actionLinkType`	`enum (ActionLinkType)` Tipo di azione predeterminato.
`orderOnlineMetadata`	`object (OrderOnlineMetadata)` Metadati per il link online dell'ordine. Supporta l'azione con ActionLinkType di ACTION_LINK_TYPE_SHOP_ONLINE.
`foodOrderingMetadata`	`object (FoodOrderingMetadata)` Metadati per i link di ordinazione di cibo. Supporta il tipo di azione: * `ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY` * `ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT` NON supporta `ACTION_LINK_TYPE_ORDER_FOOD`.
`eventMetadata`	`object (EventMetadata)` Ulteriori informazioni sul link di azione univoco per il verticale Eventi.

ActionPlatform

La piattaforma su cui viene eseguita l'azione. L'applicazione web è l'elemento di riserva generale. Ti consigliamo di avere almeno un ActionLink con ACTION_PLATFORM_WEB_APPLICATION. I link con Android e iOS come piattaforma vengono utilizzati solo sul rispettivo sistema.

Enum
`ACTION_PLATFORM_UNSPECIFIED`	La piattaforma non è specificata.
`ACTION_PLATFORM_WEB_APPLICATION`	La piattaforma di azione riguarda il web in generale.
`ACTION_PLATFORM_MOBILE_WEB`	La piattaforma di azione è basata sul web sui dispositivi mobili.
`ACTION_PLATFORM_ANDROID`	La piattaforma di azione è il sistema operativo Android.
`ACTION_PLATFORM_IOS`	La piattaforma dell'azione è iOS.

ActionLinkType

Tipo predeterminato di azione associata a un link di azione.

Enum
`ACTION_LINK_TYPE_UNSPECIFIED`	Il tipo di link all'azione non è specificato.
`ACTION_LINK_TYPE_BOOK_APPOINTMENT`	Il tipo di link all'azione è la prenotazione di un appuntamento.
`ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT`	Il tipo di link all'azione è la prenotazione di un appuntamento online.
`ACTION_LINK_TYPE_ORDER_FOOD`	Il tipo di link all'azione è l'ordine di cibo da asporto o con consegna a domicilio o entrambi.
`ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY`	Il tipo di link all'azione è l'ordine di cibo da asporto.
`ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT`	Il tipo di collegamento all'azione è l'ordine di cibo da asporto.
`ACTION_LINK_TYPE_MAKE_DINING_RESERVATION`	Il tipo di link all'azione sta prenotando un ristorante.
`ACTION_LINK_TYPE_SHOP_ONLINE`	Il tipo di link di azione è l'ordinazione per gli acquisti: può essere con consegna a domicilio, ritiro o entrambi.

OrderOnlineMetadata

Metadati per un link all'azione di ordine online.

Rappresentazione JSON
{ "fulfillmentOption": [ { object (`FulfillmentOption`) } ] }

Campi

fulfillmentOption[]

object (FulfillmentOption)

Opzioni di evasione degli ordini disponibili per un link di azione online per l'ordine.

FulfillmentOption

L'opzione di evasione di un link di azione online per l'ordine.

Rappresentazione JSON
{ "fulfillmentType": enum (`FulfillmentType`), "availableDay": [ { object (`AvailableDay`) } ], "feeDetails": { object (`FeeDetails`) }, "minimumOrder": { object (`Price`) } }

Campi
`fulfillmentType`	`enum (FulfillmentType)` Obbligatorio. Il tipo di completamento.
`availableDay[]`	`object (AvailableDay)` Obbligatorio. Un elenco dei giorni in cui è disponibile questo metodo di evasione degli ordini (preferibilmente almeno 2).
`feeDetails`	`object (FeeDetails)` Obbligatorio. Dettagli delle commissioni per il metodo di evasione degli ordini.
`minimumOrder`	`object (Price)` Obbligatorio. Ordine minimo per il metodo di evasione degli ordini associato al link di azione.

FulfillmentType

Il tipo di completamento associato a un link di azione.

Enum
`FULFILLMENT_TYPE_UNSPECIFIED`	Il tipo di evasione degli ordini non è specificato.
`FULFILLMENT_TYPE_DELIVERY`	Il tipo di evasione è la consegna.
`FULFILLMENT_TYPE_PICKUP`	Il tipo di evasione degli ordini è Ritiro.

AvailableDay

Disponibilità a livello di giorno.

Rappresentazione JSON
{ "fulfillmentDate": { object (`Date`) }, "lastOrderingTime": string }

Campi

Campi
`fulfillmentDate`	`object (Date)` Obbligatorio. Una data disponibile per un metodo di evasione degli ordini. Sia nel fuso orario del commerciante.
`lastOrderingTime`	`string (Timestamp format)` Obbligatorio. Timestamp Unix. L'ultima volta che un utente ha potuto ordinare e ricevere articoli entro il giorno `fulfillmentDate`. In altre parole, dopo lastOrderingTime, fulfillmentDate non verrà più mostrato come disponibile. Ad esempio, se fulfillmentDate è 2020-08-10: - un valore lastOrderingTime 2020-08-10 18:00 significa che, per ricevere l'ordine il 10-08-2020, un cliente deve effettuarlo entro le 18:00 dello stesso giorno. - un valore lastOrderingTime pari a 08-08-2020 20:00 indica che, per ricevere l'ordine il 10-08-2020, un cliente deve effettuare l'ordine entro le 20:00 di due giorni prima. 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"`.

fulfillmentDate

object (Date)

Obbligatorio. Una data disponibile per un metodo di evasione degli ordini. Sia nel fuso orario del commerciante.

lastOrderingTime

string (Timestamp format)

Obbligatorio. Timestamp Unix. L'ultima volta che un utente ha potuto ordinare e ricevere articoli entro il giorno fulfillmentDate. In altre parole, dopo lastOrderingTime, fulfillmentDate non verrà più mostrato come disponibile.

Ad esempio, se fulfillmentDate è 2020-08-10: - un valore lastOrderingTime 2020-08-10 18:00 significa che, per ricevere l'ordine il 10-08-2020, un cliente deve effettuarlo entro le 18:00 dello stesso giorno. - un valore lastOrderingTime pari a 08-08-2020 20:00 indica che, per ricevere l'ordine il 10-08-2020, un cliente deve effettuare l'ordine entro le 20:00 di due giorni prima.

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".

Data

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

Una data completa, con valori di anno, mese e giorno diversi da zero.
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

Campi
`year`	`integer` Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
`month`	`integer` Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
`day`	`integer` Giorno di un mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

year

integer

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

month

integer

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

day

integer

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

FeeDetails

Dettagli delle tariffe per il metodo di evasione degli ordini associato al link all'azione.

Rappresentazione JSON

Rappresentazione JSON
{ // Union field `fee_details` can be only one of the following: "noFee": { object (`NoFee`) }, "baseFee": { object (`MinimumFee`) }, "fixedFee": { object (`FixedFee`) } // End of list of possible types for union field `fee_details`. }

{

  // Union field fee_details can be only one of the following:
  "noFee": {
    object (NoFee)
  },
  "baseFee": {
    object (MinimumFee)
  },
  "fixedFee": {
    object (FixedFee)
  }
  // End of list of possible types for union field fee_details.
}

Campi
Campo unione `fee_details`. Modello di commissione per il metodo di evasione degli ordini. `fee_details` può essere solo uno dei seguenti:
`noFee`	`object (NoFee)` Nessuna commissione per il metodo di evasione degli ordini.
`baseFee`	`object (MinimumFee)` La tariffa di base associata al metodo di evasione degli ordini.
`fixedFee`	`object (FixedFee)` La tariffa fissa associata al metodo di evasione degli ordini.

Senza costi

Questo tipo non contiene campi.

Non è richiesta alcuna commissione per il metodo di completamento associato al link di azione.

MinimumFee

La tariffa minima richiesta per il metodo di completamento associato al link di azione.

Rappresentazione JSON
{ "baseFeeAmount": { object (`Price`) } }

Campi

Campi
`baseFeeAmount`	`object (Price)` Obbligatorio. L'importo della tariffa base per il metodo di evasione degli ordini.

baseFeeAmount

object (Price)

Obbligatorio. L'importo della tariffa base per il metodo di evasione degli ordini.

FixedFee

La tariffa fissa richiesta per il metodo di evasione degli ordini associato al link all'azione.

Rappresentazione JSON
{ "amount": { object (`Price`) } }

Campi

Campi
`amount`	`object (Price)` Obbligatorio. L'importo della tariffa fissa per il metodo di evasione degli ordini.

amount

object (Price)

Obbligatorio. L'importo della tariffa fissa per il metodo di evasione degli ordini.

FoodOrderingMetadata

Metadati per i link alle azioni di ordinazione di cibo.

Rappresentazione JSON

Rappresentazione JSON
{ "feeDetails": [ { object (`FeeDetails`) } ], "advanceOrderDetails": { object (`AdvanceOrderDetails`) }, // Union field `fulfillment_duration_options` can be only one of the following: "fulfillmentLeadTimeDuration": string, "fulfillmentLeadTimeDurationRange": { object (`DurationRange`) } // End of list of possible types for union field `fulfillment_duration_options`. }

{
  "feeDetails": [
    {
      object (FeeDetails)
    }
  ],
  "advanceOrderDetails": {
    object (AdvanceOrderDetails)
  },

  // Union field fulfillment_duration_options can be only one of the following:
  "fulfillmentLeadTimeDuration": string,
  "fulfillmentLeadTimeDurationRange": {
    object (DurationRange)
  }
  // End of list of possible types for union field fulfillment_duration_options.
}

Campi
`feeDetails[]`	`object (FeeDetails)` Dettagli delle tariffe addebitate all'utente, oltre al totale dell'articolo. Ripetuto per diversi tipi di commissioni, come commissione di servizio, commissione di consegna e così via.
`advanceOrderDetails`	`object (AdvanceOrderDetails)` Dettagli sull'assistenza per gli ordini avanzati, nota anche come ordine anticipato, in cui l'utente può effettuare un ordine per l'evasione in un secondo momento.
Campo unione `fulfillment_duration_options`. Durata del tempo di evasione dell'ordine dalla conferma dell'ordine. Per gli ordini con consegna, il tempo necessario per la consegna del cibo. Per gli ordini da asporto, il tempo necessario per il ritiro del cibo. `fulfillment_duration_options` può essere solo uno dei seguenti:
`fulfillmentLeadTimeDuration`	`string (Duration format)` Durata fissa. Ad esempio: 30 min. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "`s`". Esempio: `"3.5s"`.
`fulfillmentLeadTimeDurationRange`	`object (DurationRange)` Un intervallo di durata. Esempi: * Da 30 a 45 minuti * Più di 30 minuti * Meno di 50 minuti

FeeDetails

Dettagli della commissione.

Rappresentazione JSON
{ "type": enum (`FeeType`), "feeAmount": { object (`FeeAmount`) } }

Campi

Campi
`type`	`enum (FeeType)` Tipo di tariffa. (obbligatorio)
`feeAmount`	`object (FeeAmount)` Importo della tariffa in valuta unitaria, una percentuale del valore del carrello o una combinazione di entrambi. (obbligatorio)

type

enum (FeeType)

Tipo di tariffa. (obbligatorio)

feeAmount

object (FeeAmount)

Importo della tariffa in valuta unitaria, una percentuale del valore del carrello o una combinazione di entrambi. (obbligatorio)

FeeType

Tipo di tariffa.

Enum
`FEE_TYPE_UNSPECIFIED`	Tipo di tariffa non specificato.
`DELIVERY`	Per le spese di consegna.
`SERVICE`	Per le commissioni di servizio.

FeeAmount

Esempi di FeeAmount: * Commissione fissa: 0 $ (nessuna commissione), 1,5 $ * Intervallo di commissione fissa: 1 $ (minima), 3 $ (massima), 5-6 $ * Percentuale della dimensione del carrello: 15,5%, 10-20%, 10% (minima), 15% (massima) * Composto di intervallo e percentuale: 25,5% e 2,5 $ (minima), 25,5% e 4,5 $ (massima), 10% e 1,5-2,5 $, 10,5-20% e 2,5-3,5 $

Rappresentazione JSON

Rappresentazione JSON
{ "cartPercentage": { object (`QuantitativeValue`) }, // Union field `amount_options` can be only one of the following: "amount": { object (`Money`) }, "amountRange": { object (`MoneyRange`) }, "amountUnknown": boolean // End of list of possible types for union field `amount_options`. }

{
  "cartPercentage": {
    object (QuantitativeValue)
  },

  // Union field amount_options can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountRange": {
    object (MoneyRange)
  },
  "amountUnknown": boolean
  // End of list of possible types for union field amount_options.
}

Campi
`cartPercentage`	`object (QuantitativeValue)` Tariffa in termini di percentuale del valore del carrello. Supporta un intervallo (limitato e illimitato) o una percentuale fissa. Il valore deve essere compreso tra 0 e 100. Esempi: * Fisso 5,5% * Almeno 5,5% * Al massimo 5,5% * Da 4,5% a 5,5%
Campo unione `amount_options`. Opzioni per specificare un importo monetario. `amount_options` può essere solo uno dei seguenti:
`amount`	`object (Money)` Importo fisso. Ad esempio 3,5 EUR.
`amountRange`	`object (MoneyRange)` Intervallo di importo. Esempi: * Da 3,5 € a 5,5 € * Almeno 3,5 € * Massimo 5,5 €
`amountUnknown`	`boolean` Importo sconosciuto.

Denaro

Rappresenta un importo con il relativo tipo di valuta.

Rappresentazione JSON
{ "currencyCode": string, "units": string, "nanos": integer }

Campi

Campi
`currencyCode`	`string` Il codice valuta di tre lettere definito in ISO 4217.
`units`	`string (int64 format)` Le unità intere dell'importo. Ad esempio, se `currencyCode` è `"USD"`, 1 unità equivale a un dollaro statunitense.
`nanos`	`integer` Numero di nano (10^-9) unità dell'importo. Il valore deve essere compreso tra -999.999.999 e +999.999.999 compresi. Se `units` è positivo, `nanos` deve essere positivo o zero. Se `units` è zero, `nanos` può essere positivo, zero o negativo. Se `units` è negativo, `nanos` deve essere negativo o zero. Ad esempio -1,75 $ è rappresentato come `units`=-1 e `nanos`=-750.000.000.

currencyCode

string

Il codice valuta di tre lettere definito in ISO 4217.

units

string (int64 format)

Le unità intere dell'importo. Ad esempio, se currencyCode è "USD", 1 unità equivale a un dollaro statunitense.

nanos

integer

Numero di nano (10^-9) unità dell'importo. Il valore deve essere compreso tra -999.999.999 e +999.999.999 compresi. Se units è positivo, nanos deve essere positivo o zero. Se units è zero, nanos può essere positivo, zero o negativo. Se units è negativo, nanos deve essere negativo o zero. Ad esempio -1,75 $ è rappresentato come units=-1 e nanos=-750.000.000.

MoneyRange

Wrapper per un intervallo di importo monetario che potrebbe essere limitato o illimitato. È obbligatorio specificare almeno un valore minAmount e maxAmount.

Rappresentazione JSON
{ "minAmount": { object (`Money`) }, "maxAmount": { object (`Money`) } }

Campi

Campi
`minAmount`	`object (Money)` Importo minimo.
`maxAmount`	`object (Money)` Importo massimo.

minAmount

object (Money)

Importo minimo.

maxAmount

object (Money)

Importo massimo.

QuantitativeValue

Wrapper per un valore numerico che può essere un intervallo o un valore fisso. Esempi di QuantitativeValue: * Valore singolare: value: 10.5 * Intervallo limitato: valueRange {minValue: 5.5, maxValue 10.5} * Limite inferiore: valueRange {minValue: 5.5} * Limite superiore: valueRange {maxValue: 10.5}

Rappresentazione JSON
{ // Union field `value_options` can be only one of the following: "value": number, "valueRange": { object (`RangeValue`) } // End of list of possible types for union field `value_options`. }

Campi

Campi
Campo unione `value_options`. (obbligatorio) `value_options` può essere solo uno dei seguenti:
`value`	`number` Un valore singolare. Ad esempio: 5,6
`valueRange`	`object (RangeValue)` Un intervallo di valori che potrebbe essere aperto o limitato. Esempi: * Almeno 5,5 * Massimo 5,5 * 5,5-6,5

Campo unione value_options. (obbligatorio) value_options può essere solo uno dei seguenti:

value

number

Un valore singolare. Ad esempio: 5,6

valueRange

object (RangeValue)

Un intervallo di valori che potrebbe essere aperto o limitato. Esempi: * Almeno 5,5 * Massimo 5,5 * 5,5-6,5

RangeValue

Intervallo di valori tali che minValue < maxValue. Richiede almeno uno dei seguenti valori: minValue e maxValue.

Rappresentazione JSON
{ "minValue": number, "maxValue": number }

Campi

Campi
`minValue`	`number` Valore minimo.
`maxValue`	`number` Valore massimo.

minValue

number

Valore minimo.

maxValue

number

Valore massimo.

DurationRange

Elemento contenitore per un intervallo di durata che può essere limitato o illimitato. È obbligatoria almeno una delle durate minDuration e maxDuration.

Rappresentazione JSON
{ "minDuration": string, "maxDuration": string }

Campi

Campi
`minDuration`	`string (Duration format)` Durata minima. Durata in secondi con un massimo di nove cifre frazionarie e termina con "`s`". Esempio: `"3.5s"`.
`maxDuration`	`string (Duration format)` Durata massima. Durata in secondi con un massimo di nove cifre frazionarie e termina con "`s`". Esempio: `"3.5s"`.

minDuration

string (Duration format)

Durata minima.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

maxDuration

string (Duration format)

Durata massima.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

AdvanceOrderDetails

Per assistenza su ordinazione.

Rappresentazione JSON
{ "isSupported": boolean }

Campi

Campi
`isSupported`	`boolean` True se gli Ordini anticipati, noti anche come Ordine in anticipo, sono supportati. (obbligatorio)

isSupported

boolean

True se gli Ordini anticipati, noti anche come Ordine in anticipo, sono supportati. (obbligatorio)

EventMetadata

Ulteriori informazioni sul link di azione univoco per il verticale Eventi.

Rappresentazione JSON
{ "surface": enum (`Surface`) }

Campi

surface

enum (Surface)

Piattaforma di eventi predeterminata associata a un link di azioni. Viene utilizzato solo per il verticale Eventi.

Piattaforma

Piattaforma evento predeterminata associata a un link di azione. Viene utilizzato solo per il verticale Eventi.

Enum
`SURFACE_UNSPECIFIED`	La superficie non è specificata.
`SURFACE_SEARCH`	Il link di azione è la prenotazione di un biglietto per un evento nella Ricerca.
`SURFACE_YOUTUBE`	Il link di azione consiste nella prenotazione di un biglietto per un evento su YouTube.
`SURFACE_ADS`	Il link all'azione è un clic su un annuncio per l'evento.

ActionLink Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

ActionPlatform

ActionLinkType

OrderOnlineMetadata

FulfillmentOption

FulfillmentType

AvailableDay

Data

FeeDetails

Senza costi

MinimumFee

FixedFee

FoodOrderingMetadata

FeeDetails

FeeType

FeeAmount

Denaro

MoneyRange

QuantitativeValue

RangeValue

DurationRange

AdvanceOrderDetails

EventMetadata

Piattaforma

ActionLink