- Représentation JSON
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- Date
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- Revenus
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
- EventMetadata
- Surface
Une URL d'action, en même temps que la langue associée, la liste des restrictions locales applicables et une plate-forme facultative sur laquelle cette action doit être effectuée.
| Représentation JSON |
|---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
| Champs | |
|---|---|
url |
L'URL du point d'entrée correspondant à ce lien d'action. |
language |
Balise de langue BCP-47 identifiant la langue du contenu associé à cet URI. |
restrictedCountry[] |
Code pays ISO 3166-1 Alpha-2. Laissez ce champ vide si vous ne souhaitez pas restreindre la visibilité du contenu. |
platform |
Plate-forme sur laquelle cette action doit être effectuée. Si ce champ n'est pas défini, ACTION_PLATFORM_WEB_APPLICATION est utilisé à la place. |
actionLinkType |
Type d'action prédéterminé. |
orderOnlineMetadata |
Métadonnées du lien de commande en ligne. Compatible avec les actions dont ActionLinkType est défini sur ACTION_LINK_TYPE_SHOP_ONLINE. |
foodOrderingMetadata |
Métadonnées pour les liens de commande de repas. Types d'actions acceptés : * |
eventMetadata |
Informations supplémentaires sur le lien d'action, propres au secteur des événements. |
ActionPlatform
Plate-forme sur laquelle l'action est effectuée. "Application Web" est la valeur utilisée par défaut. Il est recommandé de définir au moins un ActionLink avec la valeur ACTION_PLATFORM_WEB_APPLICATION. Les liens définissant Android ou iOS comme plate-forme ne sont utilisés que sur le système respectif.
| Énumérations | |
|---|---|
ACTION_PLATFORM_UNSPECIFIED |
La plate-forme n'est pas spécifiée. |
ACTION_PLATFORM_WEB_APPLICATION |
La plate-forme associée à l'action est le Web en général. |
ACTION_PLATFORM_MOBILE_WEB |
La plate-forme associée à l'action est le Web mobile. |
ACTION_PLATFORM_ANDROID |
La plate-forme associée à l'action est Android OS. |
ACTION_PLATFORM_IOS |
La plate-forme associée à l'action est iOS. |
ActionLinkType
Type d'action prédéterminé associé à un lien d'action.
| Énumérations | |
|---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
Le type de lien d'action n'est pas spécifié. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
Le lien d'action est de type "prendre rendez-vous". |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
Le lien d'action est de type "effectuer des réservations en ligne". |
ACTION_LINK_TYPE_ORDER_FOOD |
Le lien d'action est de type "commander des plats en livraison ou à emporter, ou les deux à la fois". |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
Le lien d'action est de type "commander des plats en livraison". |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
Le lien d'action est de type "commander des plats à emporter". |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
Le lien d'action est de type "effectuer une réservation au restaurant". |
ACTION_LINK_TYPE_SHOP_ONLINE |
Le lien d'action est de type "commander des articles", qui peuvent être livrés ou retirés, ou les deux à la fois. |
OrderOnlineMetadata
Métadonnées d'un lien d'action "Commander en ligne".
| Représentation JSON |
|---|
{
"fulfillmentOption": [
{
object ( |
| Champs | |
|---|---|
fulfillmentOption[] |
Options de traitement disponibles pour un lien d'action de commande en ligne. |
FulfillmentOption
Option de traitement pour un lien d'action de commande en ligne.
| Représentation JSON |
|---|
{ "fulfillmentType": enum ( |
| Champs | |
|---|---|
fulfillmentType |
Obligatoire. Type de traitement. |
availableDay[] |
Obligatoire. Liste des jours où cette méthode de traitement est disponible (de préférence au moins deux). |
feeDetails |
Obligatoire. Détails des frais pour la méthode de traitement. |
minimumOrder |
Obligatoire. Montant minimal de la commande pour la méthode de traitement associée au lien d'action. |
FulfillmentType
Type de traitement associé à un lien d'action.
| Enums | |
|---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
Le type de traitement n'est pas spécifié. |
FULFILLMENT_TYPE_DELIVERY |
Le type de traitement est la livraison. |
FULFILLMENT_TYPE_PICKUP |
Le type de traitement est "retrait". |
AvailableDay
Disponibilité au niveau du jour.
| Représentation JSON |
|---|
{
"fulfillmentDate": {
object ( |
| Champs | |
|---|---|
fulfillmentDate |
Obligatoire. Date de disponibilité d'une méthode de traitement. Il est supposé être dans le fuseau horaire du marchand. |
lastOrderingTime |
Obligatoire. Horodatage UNIX. Dernière date à laquelle un utilisateur peut commander et recevoir des articles : Par exemple, si la valeur de fulfillmentDate est "2020-08-10", une valeur de lastOrderingTime de "2020-08-10 18:00" signifie que, pour recevoir sa commande le 10 août 2020, un client doit la passer avant 18h ce même jour. - Une valeur lastOrderingTime de 2020-08-08 20:00 signifie que, pour recevoir sa commande le 10 août 2020, un client doit la passer avant 20h le 8 août. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
Date
Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date correspond au calendrier grégorien proleptique. Il peut s'agir de l'un des éléments suivants :
- Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
- Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
- Une année seule, avec un mois et un jour nuls.
- Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).
Types associés :
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| Représentation JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Champs | |
|---|---|
year |
Année de la date. Elle doit être comprise entre 1 et 9 999, ou égale à 0 si vous spécifiez une date sans année. |
month |
Mois d'une année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une année sans mois ni jour. |
day |
Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez une année seule, ou une année et un mois où le jour n'est pas significatif. |
FeeDetails
Détails des frais pour la méthode de traitement associée au lien d'action.
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union fee_details. Modèle de frais pour la méthode de fulfillment. fee_details ne peut être qu'un des éléments suivants : |
|
noFee |
Aucun frais pour la méthode de fulfillment. |
baseFee |
Frais de base associés à la méthode de traitement. |
fixedFee |
Frais fixes associés à la méthode d'exécution. |
NoFee
Ce type ne comporte aucun champ.
Aucun frais n'est requis pour le mode de traitement associé au lien d'action.
MinimumFee
Frais minimum requis pour la méthode de traitement associée au lien d'action.
| Représentation JSON |
|---|
{
"baseFeeAmount": {
object ( |
| Champs | |
|---|---|
baseFeeAmount |
Obligatoire. Montant des frais de base pour la méthode de fulfillment. |
FixedFee
Frais fixes requis pour la méthode de traitement associée au lien d'action.
| Représentation JSON |
|---|
{
"amount": {
object ( |
| Champs | |
|---|---|
amount |
Obligatoire. Montant des frais fixes pour la méthode de traitement. |
FoodOrderingMetadata
Métadonnées pour les liens d'action de commande de repas.
| Représentation JSON |
|---|
{ "feeDetails": [ { object ( |
| Champs | |
|---|---|
feeDetails[] |
Détails des frais facturés à l'utilisateur en plus du montant total des articles. Répété pour différents types de frais, comme les frais de service, les frais de livraison, etc. |
advanceOrderDetails |
Informations sur la prise en charge des commandes avancées, également appelées "commander à l'avance", qui permettent aux utilisateurs de passer une commande pour une exécution ultérieure. |
Champ d'union fulfillment_duration_options. Durée de traitement de la commande à partir de la confirmation de la commande. Pour les commandes en livraison, durée jusqu'à la livraison des plats. Pour les commandes à retirer, durée jusqu'à ce que la nourriture soit prête à être retirée. fulfillment_duration_options ne peut être qu'un des éléments suivants : |
|
fulfillmentLeadTimeDuration |
Durée fixe. Par exemple, 30 min. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
fulfillmentLeadTimeDurationRange |
Une plage de durée. Exemples : * 30 à 45 min * Plus de 30 min * Moins de 50 min |
FeeDetails
Détails des frais.
| Représentation JSON |
|---|
{ "type": enum ( |
| Champs | |
|---|---|
type |
Type de frais. (obligatoire) |
feeAmount |
Montant des frais en devise de l'unité, en pourcentage de la valeur du panier ou en combinant les deux. (obligatoire) |
FeeType
Type de frais.
| Enums | |
|---|---|
FEE_TYPE_UNSPECIFIED |
Type de frais non spécifié. |
DELIVERY |
Pour les frais de livraison. |
SERVICE |
Pour les frais de service. |
FeeAmount
Exemples de FeeAmount : * Frais fixes : 0 USD (aucun frais), 1,5 USD * Gamme de frais fixes : 1,0 USD (minimum), 3,0 USD (maximum), 5,0-6,0 USD * Pourcentage de la taille du panier : 15,5 %, 10-20 %, 10 % (minimum), 15 % (maximum) * Combinaison d'une gamme et d'un pourcentage : 25,5 % et 2,5 USD (minimum), 25,5 % et 4,5 USD (maximum), 10 % et 1,5-2,5 USD, 10,5-20 % et 2,5-3,5 USD
| Représentation JSON |
|---|
{ "cartPercentage": { object ( |
| Champs | |
|---|---|
cartPercentage |
Frais en pourcentage de la valeur du panier. Accepte une plage (bornée et non bornée) ou un pourcentage fixe. La valeur doit être comprise entre 0 et 100. Exemples : * 5,5 % fixe * 5,5 % minimum * 5,5 % maximum * 4,5 % à 5,5 % |
Champ d'union amount_options. Options permettant de spécifier un montant monétaire. amount_options ne peut être qu'un des éléments suivants : |
|
amount |
Montant fixe. Par exemple, 3,5 USD. |
amountRange |
Plage de montants. Exemples : * De 3,5 USD à 5,5 USD * Au moins 3,5 USD * Au plus 5,5 USD |
amountUnknown |
Montant inconnu. |
Valeur monétaire
Représente un montant associé à un type de devise.
| Représentation JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| Champs | |
|---|---|
currencyCode |
Code de devise à trois lettres défini par la norme ISO 4217. |
units |
Unités entières du montant. Par exemple, si |
nanos |
Nombre de nano-unités (10^-9) du montant. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus. Si |
MoneyRange
Wrapper pour une plage de montants monétaires pouvant être limitée ou illimitée. Vous devez indiquer au moins l'une des valeurs minAmount et maxAmount.
| Représentation JSON |
|---|
{ "minAmount": { object ( |
| Champs | |
|---|---|
minAmount |
Montant minimal. |
maxAmount |
Montant maximal. |
QuantitativeValue
Wrapper pour une valeur numérique pouvant être une plage ou une valeur fixe. Exemples pour QuantitativeValue : * Valeur unique : value: 10.5 * Plage limitée : valueRange {minValue: 5.5, maxValue 10.5} * Limite inférieure : valueRange {minValue: 5.5} * Limite supérieure : valueRange {maxValue: 10.5}
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union value_options. (obligatoire) value_options ne peut être qu'un des éléments suivants : |
|
value |
Valeur singulière. Exemple : 5.6 |
valueRange |
Plage de valeurs pouvant être ouverte ou limitée. Exemples : * Au moins 5,5 * Au plus 5,5 * 5,5 à 6,5 |
RangeValue
Plage de valeurs telle que minValue < maxValue. Vous devez indiquer au moins l'une des valeurs suivantes : minValue ou maxValue.
| Représentation JSON |
|---|
{ "minValue": number, "maxValue": number } |
| Champs | |
|---|---|
minValue |
Valeur minimale. |
maxValue |
Valeur maximale. |
DurationRange
Wrapper pour une plage de durée pouvant être limitée ou illimitée. Vous devez indiquer au moins l'une des valeurs minDuration et maxDuration.
| Représentation JSON |
|---|
{ "minDuration": string, "maxDuration": string } |
| Champs | |
|---|---|
minDuration |
Durée minimale. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
maxDuration |
Durée maximale. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
AdvanceOrderDetails
Pour l'assistance concernant les commandes à l'avance.
| Représentation JSON |
|---|
{ "isSupported": boolean } |
| Champs | |
|---|---|
isSupported |
Vrai si les commandes anticipées, également appelées "Commander à l'avance", sont acceptées. (obligatoire) |
EventMetadata
Informations supplémentaires sur le lien d'action, propres au secteur des événements.
| Représentation JSON |
|---|
{
"surface": enum ( |
| Champs | |
|---|---|
surface |
Surface d'événement prédéterminée associée à un lien d'action. Cette option n'est utilisée que pour le secteur des événements. |
Surface
Surface d'événement prédéterminée associée à un lien d'action. Cette option n'est utilisée que pour le secteur des événements.
| Enums | |
|---|---|
SURFACE_UNSPECIFIED |
La surface n'est pas spécifiée. |
SURFACE_SEARCH |
Le lien d'action permet de réserver un billet pour un événement dans la recherche. |
SURFACE_YOUTUBE |
Le lien d'action permet de réserver un billet pour un événement sur YouTube. |
SURFACE_ADS |
Le lien d'action correspond au clic sur une annonce pour l'événement. |