Flux de produits

Le flux de produits est le moyen principal de fournir à Google une liste de produits Activités à découvrir à afficher sur différentes surfaces Google.

Un objet ProductFeed se compose d'un seul objet FeedMetadata et d'un ou plusieurs objets Product. Si aucun Product n'est fourni dans tous les fragments, tous les produits sont supprimés.

ProductFeed

ProtoRemarques d'implémentationExemples

message ProductFeed {
  // Metadata for this feed.
  // Required.
  FeedMetadata feed_metadata = 1;

  // List of the products.
  // Optional. When unset in all shards, all products will be deleted.
  repeated Product products = 2;
}

Type	Champ	Remarques
FeedMetadata	feed_metadata	OBLIGATOIRE. Métadonnées de ce flux.
répété Produit	produits	FACULTATIF. Si ce paramètre n'est pas défini dans tous les segments, tous les produits sont supprimés. Vous devrez peut-être définir feed_metadata/max_removal_share lorsque vous supprimez un grand nombre de produits.

// Example 1: Basic structure
{
  "feed_metadata": {
    ...
  },
  "products": [
    ...
  ]
}

// Example 2: Wipe all products
{
  "feed_metadata": {
    "shard_id": 0,
    "total_shards_count": 1,
    "processing_instruction": "PROCESS_AS_SNAPSHOT",
    "nonce": 202113041501,
    "max_removal_share": 1.0
  },
  "products": []
}

FeedMetadata

ProtoRemarques d'implémentationExemples

message FeedMetadata {
  // The current shard ID, zero-based. Shards do not need to be transferred in
  // order. Processing will start only after a full set of shards was uploaded.
  // Required when total_shards_count > 1.
  uint32 shard_id = 1;

  // Total number of shards in this transfer.
  // Required. Must be >= 1.
  uint32 total_shards_count = 2;

  // An arbitrary number used to link multiple shards to the same transfer.
  // Required when total_shards_count > 1.
  // Must be the same for all shards within the transfer.
  uint64 nonce = 3;

  enum ProcessingInstruction {
    // For compatibility, don't use.
    PROCESS_AS_UNSPECIFIED = 0;

    // This Feed upload should be processed as a complete snapshot replacing any
    // previously uploaded data of this type.
    // Supported feed types: product.
    PROCESS_AS_SNAPSHOT = 1;

    // This Feed upload should be processed as an upsert, updating or adding
    // data to the previous uploads. Supported feed types: reviews,
    // availability.
    PROCESS_AS_UPSERT = 2;
  }

  // Processing instruction for this upload.
  // Required.
  ProcessingInstruction processing_instruction = 4;

  // Maximal share of currently active products that are allowed to be removed
  // by an upload. If more products will be removed by this transfer, the whole
  // transfer will be rejected.
  // This is a safeguard against unintentional take down of a significant part
  // of the inventory. Can be set to 1.0 to allow complete inventory take down.
  // Optional.
  double max_removal_share = 5;
}

Type	Champ	Remarques
uint32	shard_id	OBLIGATOIRE lorsque total_shards_count > 1.  Basé sur le zéro. Les fragments n'ont pas besoin d'être transférés dans l'ordre. Le traitement ne commence qu'après l'importation d'un ensemble complet de fragments.
uint32	total_shards_count	OBLIGATOIRE, doit être supérieur ou égal à 1.
uint64	nonce	OBLIGATOIRE lorsque total_shards_count > 1. doit être identique pour tous les fragments du transfert.
énum	processing_instruction	OBLIGATOIRE. PROCESS_AS_SNAPSHOT est la seule valeur acceptée.
double	max_removal_share	FACULTATIF. Partage maximal des produits actifs pouvant être supprimés par importation. Si davantage de produits sont supprimés par ce transfert, l'ensemble du transfert est refusé. Il s'agit d'une mesure de protection contre la suppression involontaire d'une partie importante de l'inventaire. Peut être défini sur 1,0 pour permettre la suppression complète de l'inventaire.

// Example 1: metadata single JSON file
{
    "shard_id": 0,
    "total_shards_count": 1,
    "processing_instruction": "PROCESS_AS_SNAPSHOT",
    "nonce": 202113041501
}

// Example 2a: two JSON files (1st file)
{
    "shard_id": 0,
    "total_shards_count": 2,
    "processing_instruction": "PROCESS_AS_SNAPSHOT",
    "nonce": 202213041502
}

// Example 2b: two JSON files (2nd file)
{
    "shard_id": 1,
    "total_shards_count": 2,
    "processing_instruction": "PROCESS_AS_SNAPSHOT",
    "nonce": 202213041502
}

Produit

ProtoRemarques d'implémentationExemples

message Product {
  // An opaque string from the partner which uniquely identifies the product.
  // Allowed characters are alphanumeric, _, and -. Max length: 255.
  // Required.
  string id = 1;

  // The title of the product in plain text, e.g. "Horseback riding on the
  // moon". See definition of "LocalizedTextSet" message for the details on the
  // localization.
  // Recommended to not exceed length of 50 in any language. Max length: 150.
  // Required.
  LocalizedTextSet title = 2;

  // The description of the product. Limited formatting options are allowed in
  // the HTML format. Supported tags:
  //   * h1-h5
  //   * ul, ol, li
  //   * strong, italic, em
  //   * p, br
  // Other tags are not supported and will be removed. CSS, tables, style
  // property, `a` links are not supported. Images are not allowed, use the
  // related_media field instead.
  // Important notes:
  //   * Try not to use other tags except for the supported ones mentioned
  //     above, because the contents within unsupported tags will be stripped,
  //     and may lead to an undesirable user experience.
  //   * Try avoid deep nested structures like more than 3 different heading
  //     levels or nested lists. Keeping the structure flat, simple, and
  //     straightforward, helps to create a better user experience.
  //   * Do not duplicate info from the product_features field below in the
  //     description as both would normally be shown side by side.
  // Recommended to not exceed length of 10000 in any language. Max length:
  // 16000.
  // Recommended.
  LocalizedTextSet description = 3;

  // Structured details about the product features.
  // Max number of features: 100.
  // Recommended.
  repeated TextFeature product_features = 4;

  // Aggregated product rating.
  // Recommended.
  Rating rating = 5;

  // Related media such as photos or videos.
  // Max number of media: 30.
  // Recommended.
  repeated Media related_media = 6;

  // Whether Google should make use of the order in which related media are
  // listed in the feed or not. The media order would be used to influence
  // the final image order for the product in the UI.
  // Optional, default is false.
  bool use_media_order = 13;

  // Options available for this product.
  // Max number of options: 20.
  // At least one is required.
  repeated Option options = 7;

  // Operator details.
  // Optional.
  Operator operator = 8;

  // Inventory type of this product.
  enum InventoryType {
    // Default inventory type.
    INVENTORY_TYPE_DEFAULT = 0;

    // Product is an official ticket to a point of interest. To learn what
    // qualifies as official inventory, refer to the policy doc.
    INVENTORY_TYPE_OFFICIAL = 1;

    // Product is coming directly from the operator or their official
    // Connectivity Provider / ResTech.
    INVENTORY_TYPE_OPERATOR_DIRECT = 2;
  }

  // Optional.
  InventoryType inventory_type = 9;

  // Should contain only distinct values of InventoryType.
  // Max number of inventory types: 2.
  // Optional.
  repeated InventoryType inventory_types = 12;

  // Confirmation type of this product.
  enum ConfirmationType {
    // Type of confirmation is unknown.
    CONFIRMATION_TYPE_UNKNOWN = 0;

    // Booking is confirmed to the end user immediately.
    CONFIRMATION_TYPE_INSTANT = 1;

    // Booking is confirmed to the end user within 24 hours.
    CONFIRMATION_TYPE_24HRS = 2;

    // Booking is confirmed to the end user within 48 hours.
    CONFIRMATION_TYPE_48HRS = 3;
  }

  // Optional.
  ConfirmationType confirmation_type = 10;

  // Possible fulfillment types -- ways to obtain a document to confirm the
  // booking. Combinations are possible, e.g. mobile + printed, or
  // printed at home + in-person pickup is available.
  // At least one field must be true.
  message FulfillmentType {
    // Confirmation on a mobile phone, e.g. with a QR code.
    bool mobile = 1;

    // Printable confirmation.
    bool print_at_home = 2;

    // Admission documents to be picked up in person.
    bool pickup = 3;
  }

  // Recommended.
  FulfillmentType fulfillment_type = 11;

  // Provider brand name.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 100.
  // Optional.
  LocalizedTextSet brand_name = 14;
}

Type	Champ	Remarques
chaîne	id	OBLIGATOIRE, longueur maximale de 255 caractères. Chaîne unique qui identifie le produit. Les caractères autorisés sont les caractères alphanumériques, _ et -.
LocalizedTextSet	titre	OBLIGATOIRE. Longueur recommandée : 50 caractères maximum. Pour en savoir plus, consultez les consignes relatives aux titres et aux descriptions.
LocalizedTextSet	description	RECOMMANDÉ, longueur recommandée ≤ 10 000, longueur maximale : 16 000 caractères. Pour en savoir plus, consultez les consignes relatives aux titres et aux descriptions.
repeated TextFeature	product_features	RECOMMANDÉ : nombre maximal d'éléments : 100.
Note	rating	RECOMMANDÉ. Nous vous recommandons vivement de fournir des notes, car les produits qui en affichent enregistrent un taux de clics plus élevé.
repeated Media	related_media	RECOMMANDÉ : nombre maximal de contenus multimédias : 30 Nous vous recommandons vivement d'inclure plusieurs images. Pour en savoir plus sur les images, consultez les consignes relatives aux images.
booléen	use_media_order	FACULTATIF Indiquez à Google que l'ordre dans lequel les contenus multimédias associés sont listés dans le flux doit être pris en compte lors du choix de l'image à afficher.
répété Option	options	OBLIGATOIRE, nombre maximal d'options: 20 Chaque produit doit comporter au moins une option.
Opérateur	opérateur	FACULTATIF.
énum	obsolète inventory_type	FACULTATIF. INVENTORY_TYPE_OFFICIAL ne peut être défini que dans les produits qui redirigent vers le site officiel de vente de billets d'un point d'intérêt. Vous ne pourrez définir cette valeur qu'après un examen d'éligibilité. Ce champ est obsolète et remplacé par le nouveau champ répété inventory_types.
repeated	inventory_types	FACULTATIF. Liste répétée des types d'inventaires uniques auxquels appartient ce produit. INVENTORY_TYPE_OFFICIAL ne peut être défini que dans les produits qui redirigent vers le site officiel de vente de billets d'un point d'intérêt. Vous ne pourrez définir cette valeur qu'après un examen d'éligibilité. INVENTORY_TYPE_OPERATOR_DIRECT ne peut être défini que dans les produits qui redirigent vers le site du voyagiste. Vous ne pourrez définir cette valeur qu'après un examen d'éligibilité.
énum	confirmation_type	FACULTATIF.
FulfillmentType	fulfillment_type	RECOMMANDÉ. Si ce champ est défini, au moins un champ de fulfillment_rype doit être défini sur "True". Définit les méthodes permettant d'obtenir un document pour confirmer la réservation. Des combinaisons sont possibles, par exemple mobile + imprimé, ou imprimé à domicile + retrait en personne.
LocalizedTextSet	brand_name	Longueur maximale : 100. Nom de la marque que le produit doit afficher. Remplace l'élément "opérateur/nom", désormais obsolète. Seule l'une des deux valeurs peut être définie.

{
  "id": "product-1",
  "title": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans bike tour"
          },
          {
              "language_code": "es",
              "text": "Tour en bicicleta por Dans"
          },
          {
              "language_code": "zh-HK",
              "text": "丹斯自行車之旅"
          }
      ]
  },
  "description": {
    "localized_texts": [
        {
            "language_code": "en",
            "text": "<p>A very fun bike tour<p>"
        },
        {
            "language_code": "es",
            "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
        },
        {
            "language_code": "zh-HK",
            "text": "<p>一個非常有趣的自行車之旅.</p>"
        }
    ]
  },
  "brand_name": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans Bikes"
          }
      ]
  },
  "rating": {
      "average_value": 4.6,
      "rating_count": 192
  },
  "product_features": [{
    "feature_type": "TEXT_FEATURE_INCLUSION",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
          {
              "language_code": "es",
              "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
          },
          {
              "language_code": "zh-HK",
              "text": "<p>一個非常有趣的自行車之旅.</p>"
          }
      ]
    }
  },{
    "feature_type": "TEXT_FEATURE_HIGHLIGHT",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
              },
              {
                  "language_code": "es",
                  "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
              },
              {
                  "language_code": "zh-HK",
                  "text": "<p>一個非常有趣的自行車之旅.</p>"
              }
          ]
      }
  },{
    "feature_type": "TEXT_FEATURE_MUST_KNOW",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
            {
                "language_code": "es",
                "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
            },
            {
                "language_code": "zh-HK",
                "text": "<p>一個非常有趣的自行車之旅.</p>"
            }
        ]
      }
  }],
  "options": [{
    "id": "option-1",
    "title": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "Sunset tour"
            },
            {
                "language_code": "es",
                "text": "Tour al atardecer"
            },
            {
                "language_code": "zh-HK",
                "text": "日落之旅"
            }
        ]
    },
    "landing_page": {
        "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
    },
    "cancellation_policy": {
        "refund_conditions": [
            {
                "min_duration_before_start_time_sec": 86400,
                "refund_percent": 100
            }
        ]
    },
    "option_categories": [
        {
            "label": "sports"
        },
        {
            "label": "bike-tours"
        }
    ],
    "related_locations": [
        {
            "location": {
                "location": {
                    "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        },
        {
            "location": {
                "location": {
                    "lat_lng": {
                        "latitude": 53.339688,
                        "longitude": 6.236688
                    }
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        }
    ],
    "price_options": [
        {
            "id": "option-1-adult",
            "title": "Adult (14+)",
            "price": {
                "currency_code": "EUR",
                "units": 20
            },
            "fees_and_taxes": {
                "per_ticket_fee": {
                    "currency_code": "EUR",
                    "units": 1
                },
                "per_ticket_tax": {
                    "currency_code": "EUR",
                    "units": 1
                }
            }
        }
    ]},{
      "id": "option-2",
      "title": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Sunrise tour"
              },
              {
                  "language_code": "es",
                  "text": "Tour al amanecer"
              },
              {
                  "language_code": "zh-HK",
                  "text": "日出之旅"
              }
          ]
      },
      "landing_page": {
          "url": "https://www.danstour.com/sunrise?language={lang}&currency={currency}"
      },
      "cancellation_policy": {
          "refund_conditions": [
              {
                  "min_duration_before_start_time_sec": 86400,
                  "refund_percent": 100
              }
          ]
      },
      "option_categories": [
          {
              "label": "sports"
          },
          {
              "label": "bike-tours"
          }
      ],
      "related_locations": [
          {
              "location": {
                  "location": {
                      "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                  }
              },
              "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
          }
      ],
      "price_options": [
          {
              "id": "option-2-adult",
              "title": "Adult (14+)",
              "price": {
                  "currency_code": "EUR",
                  "units": 20,
                  "nanos": 0
              }
          }
      ],
      "meeting_point": {
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          },
          "description": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Sunrise tour"
                  },
                  {
                      "language_code": "es",
                      "text": "Tour al amanecer"
                  },
                  {
                      "language_code": "zh-HK",
                      "text": "日出之旅"
                  }
              ]
          }
      }
    }
  ],
  "related_media": [
      {
          "url": "http://www.danstour.com/photo1.jpg",
          "type": "MEDIA_TYPE_PHOTO"
      },
      {
          "url": "http://www.danstour.com/photo2.jpg",
          "type": "MEDIA_TYPE_PHOTO",
          "attribution": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Dans Photos"
                  }
              ]
          }
      }
  ],
  "operator": {
      "name": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Dans Bikes"
              }
          ]
      },
      "phone_number": "01234567",
      "locations": [{
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          }
        }]
  },
  "inventory_types": ["INVENTORY_TYPE_OPERATOR_DIRECT"]
}

Option

ProtoRemarques d'implémentationExemples

message Option {
  // Option ID. Must be unique within a product.
  // Required.
  string id = 1;

  // The title of the option in plain text, e.g. "Sunset tour".
  //
  // If there is only a single option, the option title may be the same as the
  // product title. If multiple product options are presented, the title must be
  // unique to the option.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 150.
  // Required.
  LocalizedTextSet title = 2;

  // The description of the option. Limited formatting options are allowed in
  // the HTML format, see product description field for more details.
  // Recommended to not exceed length of 10000 in any language.
  // Max length: 16000.
  // Recommended.
  LocalizedTextSet description = 3;

  // Landing page URL for this option. The page should include a button to start
  // the booking/checkout flow.
  // Required.
  DeepLink landing_page = 5;

  // Link to a list view at a higher level of available tickets and tours,
  // prominently showing this option possibly among other options.
  // Recommended.
  DeepLink landing_page_list_view = 6;

  // Additional structured details about the option features. Should not
  // duplicate the details from the product level.
  // Max number of features: 100.
  // Optional.
  repeated TextFeature option_features = 7;

  // Cancellation policy for this option.
  // Recommended.
  CancellationPolicy cancellation_policy = 8;

  // Relevant categories for this Option. Refer to the documentation for valid
  // and mutually exclusive values.
  // Max number of categories: 100.
  // Optional.
  repeated Category option_categories = 9;

  // List of locations related to this option.
  // Max number of locations: 100.
  // Recommended.
  repeated RelatedLocation related_locations = 10;

  // If true, the option is a *typical ticket* that a user would expect to buy
  // to participate in the experience, whether it's an attraction admission or
  // a slot in a tour.
  // Optional, default is false.
  bool base_ticket = 11;

  // All possible prices for this option.
  // Note: With Feed Spec v1 only single Adult price is supported. If multiple
  // price options were provided, the lowest price, possibly with notion
  // "from ..." would be displayed.
  // At least one is required.
  repeated PriceOption price_options = 12;

  // Duration of the option in seconds, where applicable, e.g. for guided tours,
  // boat trips etc. This should reflect the duration of experience (not
  // validity time).
  // Optional.
  uint32 duration_sec = 16;

  // Languages of the option. Only where relevant -- when it's important for
  // the end user to understand and/or read in the language to enjoy the
  // experience. E.g. relevant for a guided tour, but not for a mini-golf pass.
  // Max number of languages: 100.
  // Recommended.
  repeated Language languages = 14;

  // Meeting point -- the start location. Only add where relevant and
  // beneficial, e.g. the place where participant will meet the tour guide to
  // start a walking tour, the place where participant will be picked up for a
  // city tour, the dock where a cruise trip will start.
  // Optional.
  Location meeting_point = 15;
}

Type	Champ	Remarques
chaîne	id	OBLIGATOIRE. ID de l'option. Doit être unique au sein d'un produit.
LocalizedTextSet	titre	OBLIGATOIRE. Longueur recommandée: 50 caractères. Longueur maximale: 150 caractères. S'il n'y a qu'une seule option, le titre de l'option peut être identique à celui du produit. Si plusieurs options de produit sont présentées, le titre doit être unique pour chaque option. Pour en savoir plus, consultez les Consignes concernant les titres et les descriptions.
LocalizedTextSet	description	RECOMMANDÉ, longueur recommandée: 10 000, longueur maximale: 16 000. Pour en savoir plus, consultez les consignes relatives aux titres et aux descriptions.
DeepLink	landing_page	OBLIGATOIRE.  Doit contenir un bouton ou un lien permettant de réserver le produit. Pour en savoir plus, consultez les consignes relatives aux pages de destination.
DeepLink	landing_page_list_view	RECOMMANDÉ. Lien vers une vue Liste d'un niveau supérieur des billets et des visites disponibles, en affichant cette option de manière bien visible parmi d'autres options. Pour en savoir plus, consultez les consignes relatives aux pages de destination.
repeated TextFeature	option_features	FACULTATIF, nombre maximal d'éléments: 100. Ne doit pas dupliquer les informations au niveau du produit.
CancellationPolicy	cancellation_policy	RECOMMANDÉ.
répété Catégorie	option_categories	Facultatif, nombre maximal de catégories: 100. Catégories pertinentes pour cette option. Pour connaître d'autres valeurs recommandées, consultez la documentation sur la catégorie de produits.
répété RelatedLocation	related_location	RECOMMANDÉ : nombre maximal d'emplacements : 100. Fournir une liste précise des lieux associés est extrêmement important pour que le produit s'affiche dans les lieux les plus pertinents. Toutefois, le surtaggage ou la fourniture de données inexactes entraîne la suppression du produit. Pour en savoir plus, consultez le guide Emplacement et point d'intérêt.
Bool	base_ticket	FACULTATIF. Indique si l'option de produit correspond au billet d'entrée de base.
répété PriceOption	price_options	OBLIGATOIRE, au moins 1. Tous les prix possibles pour cette option. Remarque: Seul le tarif adulte est accepté. Si plusieurs options de prix ont été fournies, le premier prix qui passe la vérification de restriction géographique est utilisé. Pour les billets de groupe, le prix total de l'ensemble du groupe doit être utilisé à la place.
uint32	duration_sec	FACULTATIF. Durée de l'option en secondes, le cas échéant, par exemple pour les visites guidées ou les excursions en bateau. Il doit refléter la durée de l'expérience (et non la date de validité).
répété Langue	langues	RECOMMANDÉ : nombre maximal de langues : 100. Langues dans lesquelles l'option est disponible. Lorsque l'utilisateur final doit comprendre et/ou lire dans sa langue pour profiter de l'expérience. Par exemple, pour une visite guidée.
Emplacement	meeting_point	FACULTATIF. N'ajoutez des lieux que si cela est pertinent et utile, par exemple le lieu où le participant rencontrera le guide pour commencer une visite à pied, ou le lieu où le participant sera pris en charge pour une visite de la ville, ou le quai où commencera un voyage en croisière.

{
  "id": "option-1",
  "title": {
    "localized_texts": [
    {
            "language_code": "en",
            "text": "Sunset tour"
        },
        {
            "language_code": "es",
            "text": "Tour al atardecer"
        },
        {
            "language_code": "zh-HK",
            "text": "日落之旅"
        }
    ]
  },
  "landing_page": {
      "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
  },
  "cancellation_policy": {
      "refund_conditions": [
          {
              "min_duration_before_start_time_sec": 86400,
              "refund_percent": 100
          }
      ]
  },
  "option_categories": [
      {
          "label": "sports"
      },
      {
          "label": "bike-tours"
      }
  ],
  "related_locations": [
      {
          "location": {
              "location": {
                  "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      },
      {
          "location": {
              "location": {
                  "lat_lng": {
                      "latitude": 53.339688,
                      "longitude": 6.236688
                  }
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      }
  ],
  "price_options": [
      {
          "id": "option-1-adult",
          "title": "Adult (14+)",
          "price": {
              "currency_code": "EUR",
              "units": 20
          },
          "fees_and_taxes": {
              "per_ticket_fee": {
                  "currency_code": "EUR",
                  "units": 1
              },
              "per_ticket_tax": {
                  "currency_code": "EUR",
                  "units": 1
              }
          }
      }
  ]
}

TextFeature

ProtoRemarques d'implémentationExemples

message TextFeature {
  enum TextFeatureType {
    // Don't use, for backwards compatibility only.
    TEXT_FEATURE_UNKNOWN = 0;

    // Feature is an inclusion.
    TEXT_FEATURE_INCLUSION = 1;

    // Feature is an exclusion.
    TEXT_FEATURE_EXCLUSION = 2;

    // Feature is a highlight.
    TEXT_FEATURE_HIGHLIGHT = 3;

    // Feature is a "must know".
    TEXT_FEATURE_MUST_KNOW = 4;

    // Feature represents information about safety measures.
    TEXT_FEATURE_SAFETY_INFORMATION = 5;
  }

  // Feature type.
  // Required.
  TextFeatureType feature_type = 1;

  // LocalizedTextSet content of the feature. Values support both plain-text
  // and HTML-like text for basic formatting. Supported HTML formatting tags:
  //
  // Phrase tags: <br>, <strong>, <em>, <i>:
  //   Only the four tags mentioned above are supported. <br> can be used to
  //   break lines in paragraphs, and <strong>/<em>/<i> can be used to highlight
  //   important text. Any other phrase tags will be ignored.
  //
  // All other tags and custom styles are not allowed and will be removed. Any
  // URLs, anchors, and links will be stripped, and will never be displayed to
  // end-users.
  // Recommended to not exceed length of 1000 in any language. Max length: 2000.
  // Required.
  LocalizedTextSet value = 2;
}

Type	Champ	Remarques
énum	feature_type	OBLIGATOIRE. Type d'éléments géographiques, valeurs possibles: TEXT_FEATURE_INCLUSION: la fonctionnalité est une inclusion. TEXT_FEATURE_EXCLUSION: la fonctionnalité est une exclusion. TEXT_FEATURE_HIGHLIGHT: la fonctionnalité est un point fort. TEXT_FEATURE_MUST_KNOW: la fonctionnalité est indispensable. TEXT_FEATURE_SAFETY_INFORMATION: la fonctionnalité représente des informations sur les mesures de sécurité.
LocalizedTextSet	valeur	OBLIGATOIRE, longueur recommandée : 1 000 caractères maximum, longueur maximale : 2 000. Balises de mise en forme HTML compatibles: br, strong, em, i Seules les quatre balises mentionnées sont acceptées. Vous pouvez utiliser la balise br pour créer des sauts de ligne au sein de paragraphes, et les balises strong/em/i pour mettre des contenus textuels en évidence. Le système ignorera toute autre balise d'expressions. Toutes les autres balises et tous les autres styles personnalisés ne sont pas autorisés et seront supprimés. Les URL, les ancres et les liens seront supprimés et ne seront jamais présentés aux utilisateurs finaux.

{
    "feature_type": "TEXT_FEATURE_HIGHLIGHT",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
            {
                "language_code": "es",
                "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
            },
            {
                "language_code": "zh-HK",
                "text": "<p>一個非常有趣的自行車之旅.</p>"
            }
        ]
    }
}

Notes

ProtoRemarques d'implémentationExemples

message Rating {
  // Average rating value.
  // The value must be in the range of [1, 5] and can be omitted if and only if
  // the rating_count is zero.
  double average_value = 1;

  // Number of ratings used in calculating the value.
  // Required.
  uint64 rating_count = 2;
}

Type	Champ	Remarques
double	average_value	FACULTATIF. Valeur de la note moyenne. La valeur doit être comprise dans la plage [1, 5] et peut être omise si (et seulement si) rating_count est égal à zéro.
uint64	rating_count	OBLIGATOIRE. Nombre d'avis utilisés dans le calcul de la valeur.

// Example 1
{
    "average_value": 4.6,
    "rating_count": 192
}

// Example 2: No ratings data
{
    "rating_count": 0
}

Contenus multimédias

ProtoRemarques d'implémentationExemples

  message Media {
  // URL of this media source. Google will crawl the media hosted at this URL.
  // Max length: 2000.
  // Required.
  string url = 1;

  enum MediaType {
    // Don't use, for backwards compatibility only.
    MEDIA_TYPE_UNSPECIFIED = 0;

    // Indicates the media provided by the url is a photo.
    MEDIA_TYPE_PHOTO = 1;
  }

  // Type of this media source.
  // Required.
  MediaType type = 2;

  // Attribution information about the source of the media. Note that if
  // the attribution is required to display with the media to give credit to
  // photographer or agency, this field must be set.
  // Recommended to not exceed length of 1000 in any language.
  // Max length: 2000.
  // Optional.
  LocalizedTextSet attribution = 3;
}

Type	Champ	Remarques
chaîne	url	OBLIGATOIRE, longueur maximale: 2 000. URL de cette source multimédia. Google explore le contenu multimédia hébergé sur cette URL.
énum	type	OBLIGATOIRE. Type de cette source multimédia. Valeurs possibles: MEDIA_TYPE_PHOTO: indique que le contenu multimédia fourni par l'URL est une photo.
LocalizedTextSet	attribution	FACULTATIF, longueur recommandée: 1 000, longueur maximale: 2 000.  Informations sur l'attribution associée à la source de l'élément multimédia. Notez que ce champ doit être défini si l'attribution doit s'afficher avec l'élément multimédia (par exemple, pour ajouter un crédit photographique).

{
    "url": "http://www.danstour.com/photo2.jpg",
    "type": "MEDIA_TYPE_PHOTO",
    "attribution": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "Dans Photos"
            }
        ]
    }
}

Catégorie

ProtoRemarques d'implémentationExemples

message Category {
  // Refer to the documentation for the valid values list.
  // Required.
  string label = 1;
}

Type	Champ	Remarques
chaîne	étiquette	OBLIGATOIRE. Pour connaître la liste des valeurs valides, consultez la documentation sur les catégories de produits.

{
    "label": "sports"
}

RelatedLocation

ProtoRemarques d'implémentationExemples

// Defines relation between an option and a location.
message RelatedLocation {
  // Location related to an option. Can be a POI (e.g. Eiffel tower),
  // neighbourhood (e.g. Old Town) or an address / arbitrary map point.
  // Required.
  Location location = 1;

  enum RelationType {
    // Location is related but relation does not allow admission or admission is
    // irrelevant, e.g. location is a square highlighted in a city tour.
    RELATION_TYPE_RELATED_NO_ADMISSION = 0;

    // Relation grants admission to this related location.
    RELATION_TYPE_ADMISSION_TICKET = 1;

    // Relation declares an additional service which doesn't get the user into
    // the related location, e.g. a parking ticket, a temporary exhibition, etc.
    RELATION_TYPE_SUPPLEMENTARY_ADDON = 2;
  }

  // Relation type of an option for the given location.
  // Required.
  RelationType relation_type = 2;
}

Définit la relation entre une option et un emplacement.

Type	Champ	Remarques
Emplacement	position	OBLIGATOIRE. Emplacement associé à une option. Il peut s'agir d'un POI (par exemple, la Tour Eiffel), d'un quartier (par exemple, la vieille ville) ou d'une adresse / d'un point de carte arbitraire.
énum	relation_type	OBLIGATOIRE. Type de relation d'une option pour l'emplacement donné. Valeurs possibles: RELATION_TYPE_RELATED_NO_ADMISSION: le lieu est associé, mais la relation n'autorise pas l'accès ou l'accès est sans rapport (par exemple, le lieu est une place mise en avant dans une visite de la ville). RELATION_TYPE_ADMISSION_TICKET: la relation permet d'accéder à cet emplacement associé. RELATION_TYPE_SUPPLEMENTARY_ADDON: la relation déclare un service supplémentaire qui ne permet pas à l'utilisateur d'accéder à l'emplacement associé, comme un ticket de parking ou une exposition temporaire.

// Example of place ID POI with no admissions
{
    "location": {
        "location": {
            "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
        }
    },
    "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
}

// Example of Address POI with admissions
{
    "location": {
        "location": {
            "address": "Madame Tussauds Berlin, Unter den Linden 74, 10117 Berlin, Germany"
        }
    },
    "relation_type": "RELATION_TYPE_ADMISSION_TICKET"
}

DeepLink

ProtoRemarques d'implémentationExemples

// Deep link definition. Can include value parameters that will be expanded on
// serve time.
message DeepLink {
  // Landing page URL template for desktop. If both `url` and `localized_url`
  // are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Either `url` or `localized_url` is required.
  string url = 1;

  // Localized landing page URL template for desktop. If both `url` and
  // `localized_url` are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Max number of locales: 50.
  // Either `url` or `localized_url` is required.
  LocalizedTextSet localized_url = 3;

  reserved 2, 4;
}

Définition d'un lien profond. Peut inclure des paramètres de valeur qui seront développés au moment de la diffusion.

Type	Champ	Remarques
chaîne	url	FACULTATIF, longueur maximale: 2 000. Modèle d'URL de page de destination pour ordinateur. L'attribut "url" ou "localized_url" est obligatoire.
LocalizedTextSet	localized_url	FACULTATIF, longueur maximale : 2 000, nombre maximal de locaux : 50. Modèle d'URL de page de destination localisée pour ordinateur. Si les options url et localized_url sont fournies, la première est utilisée en remplacement si aucune URL ne correspond à la langue de l'utilisateur. Si url n'est pas disponible et que la langue n'est pas spécifiée, l'URL en anglais est utilisée.

// Example 1: single landing page URL.
{
  "url": "https://www.danstour.com/bike-tours/?language={lang}&currency={currency}"
}

// Example 2: localized landing page url with fallback
{
  "url": "https://www.danstour.com/bike-tours/?currency={currency}",
  "localized_url": {
    "localized_texts": [{
          "language_code": "de",
          "text": "https://www.danstour.com.de/bike-tours/?currency={currency}"
    }, {
          "language_code": "es-MX",
          "text": "https://mx.danstour.com/bike-tours/?currency={currency}"
    }, {
          "language_code": "zh-HK",
          "text": "https://hk.danstour.com.es/bike-tours/?currency={currency}"
    }]
  }
}

Opérateur

ProtoRemarques d'implémentationExemples

message Operator {
  // Operator name.
  // Recommended to not exceed length of 50 in any language. Max length: 100.
  // Required.

  LocalizedTextSet name = 1;

  // Operator business name as it is registered in Google Business Profile and
  // appearing on Google Maps.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 100.
  // Required.
  LocalizedTextSet google_business_profile_name = 4;

  // Operator phone number. Prefer full international phone number format.
  // Max length: 64.
  // Optional.
  string phone_number = 2;

  // List of operator locations.
  // Max number of locations: 1.
  // Optional.
  repeated Location locations = 3;
}

Type	Champ	Remarques
LocalizedTextSet	nom [obsolète]	FACULTATIF, longueur recommandée: 50, longueur maximale: 100. Nom de la marque du vendeur de ce produit. Les OTA doivent définir cette valeur comme marque de l'OTA. Ce champ est désormais obsolète et remplacé par "brand_name" sous "products".
LocalizedTextSet	google_business_profile_name	OBLIGATOIRE, longueur maximale: 100. Nom de l'opérateur tel qu'il figure dans la fiche d'établissement Google et sur Google Maps Ce champ est obligatoire pour participer au module de réservation d'opérateur.
chaîne	phone_number	FACULTATIF, longueur maximale: 64. Numéro de téléphone de l'opérateur. Préférez le format complet du numéro de téléphone international.
répété Emplacement	zones géographiques	FACULTATIF, nombre maximal: 1. Adresse professionnelle de l'opérateur. Si vous utilisez une chaîne d'adresse, incluez le nom de l'entreprise dans la chaîne d'adresse. (par exemple, "nom de l'entreprise, adresse"). L'établissement de l'opérateur doit être visible sur Google Maps pour que le module de réservation de l'opérateur se déclenche. L'opérateur doit créer une fiche d'établissement Google s'il n'est pas visible dans Google Maps.

// Example 1: Sending operator information for operator booking module:
operator: {
  "google_business_profile_name": {
    "localized_texts": [{
      "language_code": "en",
      "text": "Dans Bikes"}]
  },
  "locations": [{
    "location": { //Operator business address
     "address": "Dans Bikes, 123 NYC st…"
  }}]
}

Langue

ProtoRemarques d'implémentationExemples

message Language {
  // A BCP 47 compliant language code such as "en" or "de-CH".
  string code = 1;
}

Type	Champ	Remarques
chaîne	code	Code de langue conforme à la norme BCP-47, tel que "en" ou "de-CH".

{
    "code": "de-CH"
}

PriceOption

ProtoRemarques d'implémentationExemples

message PriceOption {
  // Unique ID within the price set.
  // Max length: 255.
  // Required.
  string id = 1;

  // Short description of the price option, e.g. "Adult weekday".
  // Max length: 150.
  // Required.
  string title = 2;

  // Price value, must match the final price on the checkout page, including all
  // taxes and charges, see price policy. Currency will be converted to the user
  // currency on rendering.
  // Required when is_free is false.
  google.type.Money price = 3;

  // Admission or ticket is free. Must be set to true for zero-price options.
  // Optional, default is false.
  bool is_free = 4;

  // List of geographical regions this price is applicable to. If empty,
  // applicable to all locations.
  // Optional.
  repeated GeoCriterion geo_criteria = 5;

  // Break down of fees and taxes included in the price above.
  // Optional.
  PriceFeesAndTaxes fees_and_taxes = 6;
}

Type	Champ	Remarques
chaîne	id	OBLIGATOIRE, longueur maximale: 255. Identifiant unique dans l'ensemble de prix.
chaîne	titre	OBLIGATOIRE, longueur maximale: 150. Brève description de l'option de prix, par exemple "Adulte en semaine".
google.type.Money	price	OBLIGATOIRE lorsque is_free est défini sur "false". Valeur du prix. Elle doit correspondre au prix final affiché sur la page de paiement, y compris toutes les taxes et charges. Consultez le règlement sur les prix. La devise sera convertie dans la devise de l'utilisateur lors de l'affichage.
Bool	is_free	FACULTATIF, la valeur par défaut est "false". L'entrée ou le billet est sans frais. Doit être défini sur "true" (vrai) pour les options de prix nul.
répété GeoCriterion	geo_criteria	FACULTATIF. Liste des régions géographiques auxquelles ce prix s'applique. Si ce champ est vide, il s'applique à tous les emplacements.
répété PriceFeesAndTaxes	fees_and_taxes	FACULTATIF. Détail des frais et taxes inclus dans le prix.

{
    "id": "option-1-adult",
    "title": "Adult (14+)",
    "price": {
        "currency_code": "EUR",
        "units": 20
    },
    "fees_and_taxes": {
        "per_ticket_fee": {
            "currency_code": "EUR",
            "units": 1
        },
        "per_ticket_tax": {
            "currency_code": "EUR",
            "units": 1
        }
    }
}

GeoCriterion

ProtoRemarques d'implémentationExemples

message GeoCriterion {
  // 2-letter country code as defined in ISO 3166-1.
  // Required.
  string country_code = 1;

  // If true, criterion is negative (the country code is excluded).
  bool is_negative = 2;
}

Type	Champ	Remarques
chaîne	country_code	OBLIGATOIRE. Code pays à deux lettres, tel que défini dans la norme ISO 3166-1.
Bool	is_negative	FACULTATIF. Si la valeur est "true", le critère est négatif (le code pays est exclu).

{
    "country_code": "US",
    "is_negative": "true"
}

PriceFeesAndTaxes

ProtoRemarques d'implémentationExemples

message PriceFeesAndTaxes {
  // Booking fees included in the final product price for a single ticket.
  // Optional.
  google.type.Money per_ticket_fee = 1;

  // State taxes included in the final product price for a single ticket.
  // Optional.
  google.type.Money per_ticket_tax = 2;
}

Type	Champ	Remarques
google.type.Money	per_ticket_fee	FACULTATIF. Frais de réservation inclus dans le prix final du produit pour un seul billet.
google.type.Money	per_ticket_tax	FACULTATIF. Taxes locales incluses dans le prix final du produit pour un seul billet.

{
    "per_ticket_fee": {
        "currency_code": "EUR",
        "units": 1
    },
    "per_ticket_tax": {
        "currency_code": "EUR",
        "units": 1
    }
}

Emplacement

ProtoRemarques d'implémentationExemples

message Location {
  // At least one of (location, description) must be set, and we highly
  // recommend populating location wherever possible.
  //
  // To emphasize, both fields can be populated together, e.g. you can set
  // Central Park New York for the location and "In front of the 72 Street
  // Station" for the description.
  GeoLocation location = 1;

  // Additional description in human-readable form, e.g.
  //     "On the left side of the fountain on the Palace square".
  // At least one of (location, description) must be set.
  // Recommended to not exceed length of 1000 in any language. Max length: 2000.
  LocalizedTextSet description = 2;
}

Type	Champ	Remarques
GeoLocation	position	FACULTATIF : au moins un emplacement ou une description doit être présent. Emplacement géographique.
LocalizedTextSet	description	FACULTATIF, longueur recommandée: 1 000, longueur maximale: 2 000, au moins un emplacement ou une description doit être présent. Description supplémentaire sous forme lisible par l'homme, par exemple "Sur le côté gauche de la fontaine sur la place du palais".

{
    "location": {
        "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
}

GeoLocation

Pour en savoir plus sur chaque type d'indice, consultez les consignes d' utilisation.

ProtoRemarques d'implémentationExemples

message GeoLocation {
  // Required (exactly one variant from oneof).
  // See
  // https://developers.google.com/travel/things-to-do/guides/partner-integration/location
  // for detailed guidelines.
  oneof value {
    // Place ID as defined by the Places API:
    //   https://developers.google.com/places/web-service/place-id
    //
    // Uniquely identifies a POI on Google.
    // It can be sourced using the Places API endpoints, for instance Place
    // Search or Place Autocomplete, or manually using the Find Location Matches
    // tool in Things to Do Center.
    string place_id = 1;

    // Legacy single-line address.
    // Components are expected to be comma-separated, with the first component
    // being the place name as it is displayed on Google.
    // For higher matching accuracy, use the street address shown on Google for
    // the place.
    //
    // Examples:
    // - "Colosseum, Piazza del Colosseo, 1, 00184 Roma RM, Italy"
    // - "The British Museum, Great Russell St, London WC1B 3DG, United Kingdom"
    //
    // Max length: 200.
    //
    // Deprecated: use `place_info` for higher matching accuracy, which provides
    // a separate field for the place name and supports both structured and
    // unstructured address formats.
    string address = 3 [deprecated = true];

    // Structured place information.
    PlaceInfo place_info = 4;

    // Business Profile ID, as found in the Google Business Profile settings
    // page. Use this field when sourcing locations directly from the place
    // owner, who has access to the Google Business Profile for the place and
    // can provide such ID.
    uint64 business_profile_id = 5;

    // Geographic coordinates.
    // This field can only be used to determine a city or geographical region,
    // as it is too ambiguous to identify a specific place or businesses.
    // Use `place_info` instead to match to a specific place by name and
    // coordinates.
    google.type.LatLng lat_lng = 2;
  }
}

Type	Champ	Remarques
chaîne	place_id	FACULTATIF : vous devez indiquer exactement l'un des éléments suivants : place_id, address, place_info, business_profile_id ou lat_lng. PlaceId tel que défini par l' API Places. Identifie de manière unique un POI sur Google. Vous pouvez l'obtenir à l'aide des points de terminaison de l'API Places, par exemple Place Search ou Place Autocomplete, ou manuellement à l'aide de l'outil Trouver des correspondances de lieux dans le Centre d'activités à découvrir.
chaîne	adresse	FACULTATIF : exactement l'un des éléments place_id, address, place_info, business_profile_id ou lat_lng doit être présent. OBSOLÈTE. Ancienne adresse sur une seule ligne. Longueur maximale: 200. Les composants doivent être séparés par une virgule, le premier composant étant le nom du lieu tel qu'il s'affiche sur Google. Pour une meilleure précision de mise en correspondance, utilisez l'adresse postale affichée sur Google pour l'établissement.
PlaceInfo	place_info	FACULTATIF : vous devez indiquer exactement l'un des éléments suivants : place_id, address, place_info, business_profile_id ou lat_lng. Informations structurées sur un lieu.
uint64	business_profile_id	FACULTATIF : vous devez indiquer exactement l'un des éléments suivants : place_id, address, place_info, business_profile_id ou lat_lng. ID de la fiche d'établissement, comme indiqué sur la page des paramètres de la fiche d'établissement Google. Utilisez ce champ lorsque vous obtenez des établissements directement auprès du propriétaire de l'établissement, qui a accès à la fiche d'établissement Google de l'établissement et peut fournir cet ID.
google.type.LatLng	lat_lng	FACULTATIF : vous devez indiquer exactement l'un des éléments suivants : place_id, address, place_info, business_profile_id ou lat_lng. Coordonnées géographiques. Ce champ ne peut être utilisé que pour déterminer une ville ou une région géographique, car il est trop ambigu pour identifier un lieu ou une entreprise spécifique. Utilisez plutôt place_info pour faire correspondre un lieu spécifique par nom et coordonnées.

"place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"

"address": "Eiffel Tower, 5 Av. Anatole France, 75007 Paris, France"

"place_info": {
  "name": "Eiffel Tower",
  "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
}

"business_profile_id": 11458995034835395294

"lat_lng": {
  "latitude": -25.3511774,
  "longitude": 131.0326859
}

PlaceInfo

ProtoRemarques d'implémentationExemples

message PlaceInfo {
  // Place or business name.
  // For higher matching accuracy, this should be the same as the name shown on
  // Google for the place. For places with a claimed Google Business Profile,
  // this should be the same as the business name configured in the business
  // profile.
  // Max length: 100.
  // Required.
  string name = 1;

  // Phone number, including the international prefix.
  // For higher matching accuracy, this should be the same as the phone number
  // shown on Google for the place.
  // It can include commonly used separator characters.
  // Examples: "[phone]", "[phone]".
  // Max length: 30.
  // Optional.
  string phone_number = 2;

  // Website URL shown on Google for the place, preferably the URL linked from
  // the business listing in Google Maps or Search for the place.
  // Max length: 1000.
  // Optional.
  string website_url = 3;

  // Geographic coordinates of the place.
  // If left empty, Google will infer the coordinates from the address.
  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  google.type.LatLng coordinates = 4;

  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  oneof address_type {
    // Structured address.
    // Prefer this format whenever possible for higher matching accuracy.
    StructuredAddress structured_address = 5;

    // Unstructured address.
    // It should not include the place or business name, which must instead be
    // provided separately using the `name` field.
    //
    // Examples:
    // - `name`: "Colosseum", `unstructured_address`: "Piazza del Colosseo, 1,
    // 00184 Roma RM, Italy".
    // - `name`: "The British Museum", `unstructured_address`: "Great Russell
    // St, London WC1B 3DG, United Kingdom".
    //
    // Max length: 400.
    string unstructured_address = 6;
  }
}

Type	Champ	Remarques
chaîne	nom	OBLIGATOIRE. Longueur maximale: 300. Nom du lieu ou de l'établissement. Pour une meilleure précision de la correspondance, ce champ doit être identique au nom affiché sur Google pour le lieu. Pour les lieux pour lesquels une fiche d'établissement Google a été revendiquée, ce champ doit être identique au nom de l'établissement configuré dans la fiche.
chaîne	phone_number	FACULTATIF. Longueur maximale: 30. Numéro de téléphone, y compris le préfixe international. Pour une meilleure précision des correspondances, ce numéro doit être identique à celui indiqué sur Google pour l'établissement. Il peut inclure des caractères de séparateur couramment utilisés. Exemples: "[phone]", "[phone]".
chaîne	website_url	FACULTATIF. Longueur maximale: 1 000. URL du site Web affichée sur Google pour le lieu, de préférence l'URL associée à la fiche d'établissement dans Google Maps ou dans la recherche pour le lieu.
google.type.LatLng	coordonnées	FACULTATIF. Coordonnées géographiques du lieu. Si vous ne renseignez pas ce champ, Google inférera les coordonnées à partir de l'adresse. Facultatif, mais coordinates ou l'un des éléments structured_address et unstructured_address doit être fourni.
StructuredAddress	structured_address	FACULTATIF : un seul élément structured_address ou unstructured_address peut être présent, jamais les deux.
chaîne	unstructured_address	FACULTATIF : un seul élément structured_address ou unstructured_address peut être présent, jamais les deux.

"place_info": {
  "name": "Colosseum",
  "phone_number": "[phone]",
  "website_url": "https://colosseo.it/",
  "coordinates": {
    "latitude": 41.8902102,
    "longitude": 12.4922309
  },
  "structured_address" {
    "street_address": "Piazza del Colosseo, 1",
    "locality": "Roma",
    "administrative_area": "RM",
    "postal_code": "00184",
    "country_code": "IT"
  }
}

"place_info": {
  "name": "Eiffel Tower",
  "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
}

"place_info": {
  "name": "Mutitjulu Waterhole",
  "coordinates": {
    "latitude": -25.3511774,
    "longitude": 131.0326859
  }
}

StructuredAddress

ProtoRemarques d'implémentationExemples

message StructuredAddress {
  // Street address, including house number and any other component that cannot
  // be provided using the more specific fields defined below. It should not
  // include the place or business name, which must instead be provided
  // separately using the `name` field under `PlaceInfo`. It should also not
  // include postal code, locality or country as those should be provided using
  // the corresponding fields below.
  //
  // Examples:
  // - "Piazza del Colosseo, 1" for the Colosseum.
  // - "Great Russell St" for The British Museum.
  // - "Champ de Mars, 5 Av. Anatole France" for the Eiffel Tower.
  //
  // Max length: 200.
  // Required.
  string street_address = 1;

  // Locality, generally referring to the city/town portion of an address.
  // Examples: "New York", "Rome", "London", "Tokyo".
  // In regions of the world where localities are not well defined or do not fit
  // into this structure well, leave empty.
  // Max length: 80.
  // Optional.
  string locality = 2;

  // Highest administrative subdivision used for postal addresses of the
  // specific country or region. This can be a state, a region, a province, an
  // oblast, a prefecture, etc.
  // It can be an abbreviation or a full name, depending on how the region is
  // usually represented in the postal addresses of the specific country. For
  // example, "CA" or "California" for US addresses, "RM" for Rome province in
  // Italy.
  // Many countries don't use an administrative area in postal addresses. For
  // instance, this field should not be used for addresses in Switzerland.
  // Max length: 80.
  // Optional.
  string administrative_area = 3;

  // The postal code or zip code.
  // Examples: "75007", "WC1B 3DG", etc.
  // Required if the country supports postal codes, otherwise it should be left
  // empty.
  // Max length: 30.
  // Optional.
  string postal_code = 4;

  // Country code, as defined by Unicode's "CLDR", itself based on the ISO 3166
  // alpha-2 standard. See
  // https://unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html.
  //
  // Examples: "US" for the United States, "FR" for France, "GB" for the United
  // Kingdom, etc.
  // Max length: 2.
  // Required.
  string country_code = 5;
}

Type	Champ	Remarques
chaîne	street_address	OBLIGATOIRE. Longueur maximale: 200. Adresse postale, y compris le numéro de la maison et tout autre élément qui ne peut pas être fourni à l'aide des champs plus spécifiques. Il ne doit pas inclure le lieu ni le nom de l'entreprise, qui doivent être indiqués séparément à l'aide du champ name sous PlaceInfo. Il ne doit pas non plus inclure de code postal, de localité ni de pays, car ceux-ci doivent être fournis à l'aide des champs correspondants.
chaîne	localité	FACULTATIF. Longueur maximale: 80. Localité, fait généralement référence à la partie "ville" d'une adresse Dans les régions du monde où les localités ne sont pas bien définies ou ne s'intègrent pas bien dans cette structure, laissez le champ vide.
chaîne	administrative_area	FACULTATIF. Longueur maximale: 80. Subdivision administrative la plus élevée utilisée pour les adresses postales d'un pays ou d'une région spécifique. Il peut s'agir d'un État, d'une région, d'une province, d'un oblast ou d'une préfecture. Il peut s'agir d'une abréviation ou d'un nom complet, selon la façon dont la région est généralement représentée dans les adresses postales du pays concerné.
chaîne	postal_code	FACULTATIF. Longueur maximale: 30. Code postal. Obligatoire si le pays accepte les codes postaux, sinon laissez ce champ vide.
chaîne	country_code	FACULTATIF. Longueur maximale: 2. Code pays, tel que défini par Unicode "CLDR", lui-même basé sur la norme ISO 3166 alpha-2. Consultez la documentation Unicode.

{
  "structured_address" {
    "street_address": "Piazza del Colosseo, 1",
    "locality": "Roma",
    "administrative_area": "RM",
    "postal_code": "00184",
    "country_code": "IT"
  }
}

LocalizedTextSet

ProtoRemarques d'implémentationExemples

// Values of the localized fields.
message LocalizedTextSet {
  // Per-locale LocalizedText values.
  // Maximum repeatedness: 50
  repeated google.type.LocalizedText localized_texts = 1;
}

Type	Champ	Remarques
répété google.type.LocalizedText	localized_texts	Valeurs textuelles localisées par paramètre régional.

{
    "language_code": "en",
    "text": "Sunrise tour"
}

CancellationPolicy

ProtoRemarques d'implémentationExemples

// Cancellation policy for a product.
message CancellationPolicy {
  // Defines a single refund condition. Multiple refund conditions could be
  // used together to describe "refund steps" as various durations before the
  // service start time.
  message RefundCondition {
    // Duration in seconds before the start time, until when the customer can
    // receive a refund for part of the service's cost specified in
    // `refund_percent`.
    // When unset or set to 0 the service can be cancelled at any time.
    // Optional.
    uint32 min_duration_before_start_time_sec = 1;

    // The percent that can be refunded, as long as the service booking is
    // cancelled at least `min_duration_before_start_time` before the service
    // start time, in the range of [0, 100].
    // When unset or set to 0, the service is not refundable. When set to 100
    // this service is fully refundable.
    // Optional.
    uint32 refund_percent = 2;

    // A flat fee deducted on refund. Could be used separately, or in
    // combination with the refund_percent above. In the latter case, refund
    // percent applies first, then the fee is deducted.
    // Optional.
    google.type.Money refund_fee = 3;
  }

  // Zero or more refund conditions applicable to the policy.
  // Max number of refund conditions: 10.
  repeated RefundCondition refund_conditions = 1;
}

Définit une seule condition de remboursement. Pour décrire les "étapes de remboursement", vous pouvez définir différentes périodes d'annulation avant l'heure de début du service et y associer différentes conditions de remboursement regroupées ensemble.

Type	Champ	Remarques
RefundCondition	refund_conditions	FACULTATIF : nombre maximal de conditions de remboursement : 10.

RefundCondition

Type	Champ	Remarques
uint32	min_duration_before_start_time_sec	Facultatif. Durée en secondes avant l'heure de début jusqu'à laquelle le client peut recevoir un remboursement pour une partie du coût du service spécifié dans refund_percent. Si la valeur n'est pas définie ou est définie sur 0, le service peut être résilié à tout moment.
uint32	refund_percent	FACULTATIF. Pourcentage remboursable, à condition que la réservation du service soit annulée au moins min_duration_before_start_time avant l'heure de début du service, dans la plage de [0, 100]. Si la valeur n'est pas définie ou est définie sur 0, le service n'est pas remboursable. Si la valeur est définie sur 100 (valeur par défaut), le service est remboursable dans son intégralité.
google.type.Money	refund_fee	FACULTATIF. Frais forfaitaires déduits du remboursement. Peut être utilisé séparément ou en combinaison avec refund_percent. Dans ce dernier cas, le pourcentage de remboursement s'applique d'abord, puis les frais sont déduits.

"refund_conditions": [
  {
    "min_duration_before_start_time_sec": 86400,
    "refund_percent": 100
  }]