Flux de produits

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

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

ProductFeed

Proto

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;
}

Remarques sur l'implémentation

Type	Champ	Remarques
FeedMetadata	feed_metadata	REQUIRED. Métadonnées de ce flux.
repeated Product	produits	FACULTATIF. Si ce paramètre n'est pas défini dans tous les fragments, tous les produits sont supprimés. feed_metadata/max_removal_share peut être défini lorsqu'un grand nombre de produits sont supprimés.

Exemples

// 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

Proto

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;
}

Remarques sur l'implémentation

Type	Champ	Remarques
uint32	shard_id	OBLIGATOIRE lorsque total_shards_count > 1.  Basé sur zéro. Les segments n'ont pas besoin d'être transférés dans l'ordre. Le traitement ne commence qu'une fois l'ensemble complet des partitions importé.
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.
enum	processing_instruction	OBLIGATOIRE. PROCESS_AS_SNAPSHOT est la seule valeur acceptée.
double	max_removal_share	FACULTATIF. Part maximale de produits actifs pouvant être supprimés par un import. Si ce transfert entraîne la suppression d'un plus grand nombre de produits, il est refusé. Il s'agit d'une mesure de protection contre le retrait involontaire d'une partie importante de l'inventaire. Peut être défini sur 1.0 pour permettre la suppression complète de l'inventaire.

Exemples

// 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

Proto

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 [features.enforce_naming_style = STYLE_LEGACY];

    // Booking is confirmed to the end user within 48 hours.
    CONFIRMATION_TYPE_48HRS = 3 [features.enforce_naming_style = STYLE_LEGACY];
  }

  // 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;
}

Remarques sur l'implémentation

Type	Champ	Remarques
chaîne	id	OBLIGATOIRE, longueur maximale : 255  Chaîne unique qui identifie le produit. Les caractères alphanumériques, ainsi que les caractères _ et - sont autorisés.
LocalizedTextSet	title	OBLIGATOIRE, longueur recommandée : 50 caractères maximum, longueur maximale : 150 caractères. 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 caractères. Pour en savoir plus, consultez les consignes concernant les titres et les descriptions.
repeated TextFeature	product_features	RECOMMANDÉ, nombre maximal de caractéristiques : 100.
Note	rating	RECOMMANDÉ. Nous vous recommandons vivement de fournir des notes, car les produits qui en affichent génèrent un taux de clics plus élevé.
repeated Media	related_media	RECOMMANDÉ, nombre maximal de contenus multimédias : 30 Nous vous recommandons vivement de fournir plusieurs images. Pour obtenir un guide détaillé sur les images, consultez les Consignes relatives aux images.
booléen	use_media_order	FACULTATIF Indique à 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.
repeated Option	options	OBLIGATOIRE, nombre maximal d'options : 20 Chaque produit doit comporter au moins une option.
Opérateur	opérateur	FACULTATIF.
enum	deprecated inventory_type	FACULTATIF. INVENTORY_TYPE_OFFICIAL ne peut être défini que dans les produits qui renvoient vers le site officiel de billetterie 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'inventaire uniques auxquels appartient ce produit. INVENTORY_TYPE_OFFICIAL ne peut être défini que dans les produits qui renvoient vers le site officiel de billetterie 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 renvoient au site du voyagiste. Vous ne pourrez définir cette valeur qu'après un examen d'éligibilité.
enum	confirmation_type	FACULTATIF.
FulfillmentType	fulfillment_type	RECOMMANDÉ. Si cette valeur est définie, 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. Les combinaisons sont possibles, par exemple mobile + imprimé, ou imprimé à la maison + retrait en personne.
LocalizedTextSet	brand_name	Longueur maximale : 100. Nom de marque à afficher pour le produit. Remplace `operator/name`, qui est désormais obsolète. Seule l'une des deux valeurs peut être définie.

Exemples

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

Proto

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;
}

Remarques sur l'implémentation

Type	Champ	Remarques
chaîne	id	REQUIRED. ID de l'option. Cet ID doit être unique dans un produit.
LocalizedTextSet	title	OBLIGATOIRE, longueur recommandée : 50 caractères, longueur maximale : 150 caractères. S'il n'y a qu'une seule option, son titre peut être identique à celui du produit. Si plusieurs options de produit sont présentées, le titre doit être unique à l'option. 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. Pour en savoir plus, consultez les consignes concernant les titres et les descriptions.
DeepLink	landing_page	REQUIRED.  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 à un niveau supérieur des billets et visites disponibles, avec cette option mise en évidence parmi d'autres. Pour en savoir plus, consultez les Consignes relatives aux pages de destination.
repeated TextFeature	option_features	FACULTATIF, nombre maximal de caractéristiques : 100.  Ne doit pas dupliquer les informations au niveau du produit.
CancellationPolicy	cancellation_policy	RECOMMANDÉ.
repeated Category	option_categories	Facultatif, nombre maximal de catégories : 100. Catégories concernées par cette option. Pour connaître d'autres valeurs recommandées, consultez la documentation sur la catégorie de produit.
repeated RelatedLocation	related_location	RECOMMANDÉ, nombre maximal de lieux : 100. Il est extrêmement important de fournir une liste précise des lieux associés pour que le produit s'affiche dans les endroits les plus pertinents. Toutefois, si vous ajoutez trop de tags ou fournissez des données inexactes, le produit sera supprimé. Pour en savoir plus, consultez le guide Emplacement et point d'intérêt.
booléen	base_ticket	FACULTATIF. Permet d'indiquer si l'option de produit correspond au billet d'entrée de base.
repeated PriceOption	price_options	OBLIGATOIRE, au moins 1. Tous les prix possibles pour cette option. Remarque : Seul le prix pour les adultes est accepté. Si plusieurs options de prix ont été fournies, le premier prix qui passe le contrôle des restrictions géographiques sera utilisé. Pour les billets de groupe, vous devez indiquer le prix total du groupe.
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. Elle doit refléter la durée de l'expérience (et non la durée de validité).
repeated 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 la langue pour profiter de l'expérience. Par exemple, pour une visite guidée.
Emplacement	meeting_point	FACULTATIF. N'ajoutez un lieu que s'il est pertinent et utile, par exemple le lieu où le participant rencontrera le guide pour commencer une visite à pied, le lieu où le participant sera pris en charge pour une visite de la ville ou le quai où commencera une croisière.

Exemples

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

Proto

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;
}

Remarques sur l'implémentation

Type	Champ	Remarques
enum	feature_type	REQUIRED. Type de fonctionnalité, valeurs possibles : TEXT_FEATURE_INCLUSION : la fonctionnalité est incluse. TEXT_FEATURE_EXCLUSION : la fonctionnalité est une exclusion. TEXT_FEATURE_HIGHLIGHT : la fonctionnalité est une mise en avant. TEXT_FEATURE_MUST_KNOW : la fonctionnalité est "incontournable". 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, longueur maximale : 2 000. Balises de mise en forme HTML acceptées : 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.

Exemples

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

Proto

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;
}

Remarques sur l'implémentation

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	REQUIRED. Nombre d'évaluations utilisées pour calculer la valeur.

Exemples

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

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

Contenus multimédias

Proto

  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;
}

Remarques sur l'implémentation

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.
enum	type	OBLIGATOIRE. Type de 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).

Exemples

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

Catégorie

Proto

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

Remarques sur l'implémentation

Type	Champ	Remarques
chaîne	étiquette	REQUIRED. Consultez la documentation sur les catégories de produits pour obtenir la liste des valeurs valides.

Exemples

{
    "label": "sports"
}

RelatedLocation

Proto

// 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 {
    RELATION_TYPE_UNSPECIFIED = 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;

    // 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 = 3;
  }

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

Remarques sur l'implémentation

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

Type	Champ	Remarques
Emplacement	position	OBLIGATOIRE. Lieu 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 la carte arbitraire.
enum	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 ne permet pas l'accès ou l'accès n'est pas pertinent (par exemple, le lieu est une place mise en avant dans une visite de ville). RELATION_TYPE_ADMISSION_TICKET : la relation permet d'accéder à ce lieu associé. RELATION_TYPE_SUPPLEMENTARY_ADDON : la relation déclare un service supplémentaire qui ne permet pas à l'utilisateur d'accéder au lieu associé, comme un ticket de parking ou une exposition temporaire.

Exemples

// 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": {
          "place_info": {
              "name": "Eiffel Tower",
              "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
          }
        }
    },
    "relation_type": "RELATION_TYPE_ADMISSION_TICKET"
}

DeepLink

Proto

// 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;
}

Remarques sur l'implémentation

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 la page de destination pour ordinateur. `url` ou `localized_url` est obligatoire.
LocalizedTextSet	localized_url	FACULTATIF, longueur max : 2 000, nombre max de locaux : 50. Modèle d'URL de page de destination localisé pour ordinateur. Si les deux sont fournis, url est utilisé comme solution de secours si aucune URL ne correspond aux paramètres régionaux de l'utilisateur.localized_url Si url n'est pas disponible et qu'aucune langue n'est spécifiée, l'URL en anglais est utilisée.

Exemples

// 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

Proto

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;
}

Remarques sur l'implémentation

Type	Champ	Remarques
LocalizedTextSet	name [deprecated]	FACULTATIF, longueur recommandée : 50, longueur maximale : 100. Nom de marque du vendeur de ce produit. Les agences de voyages en ligne doivent définir cette valeur sur la marque de l'agence. Ce champ est désormais obsolète et remplacé par brand_name sous "products"
LocalizedTextSet	google_business_profile_name	OBLIGATOIRE, longueur maximale : 100.  Nom commercial de l'opérateur tel qu'il est enregistré dans la fiche d'établissement Google et tel qu'il apparaît sur Google Maps. Ce champ est obligatoire pour participer au module de réservation de l'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.
repeated Location	zones géographiques	FACULTATIF, nombre maximal : 1. Adresse professionnelle de l'exploitant. Si une chaîne d'adresse est utilisée, incluez le nom de l'établissement dans la chaîne d'adresse. Par exemple, "nom de l'établissement, adresse". Pour que le module de réservation de l'opérateur se déclenche, l'établissement de l'opérateur doit être trouvable sur Google Maps. Si ce n'est pas le cas, l'opérateur doit enregistrer une fiche d'établissement Google.

Exemples

// 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
    "place_info": {
      "name": "Dans Bike Tour",
      "unstructured_address": "123 Baker st..."
    }
  }}]
}

Langue

Proto

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

Remarques sur l'implémentation

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

Exemples

{
    "code": "de-CH"
}

PriceOption

Proto

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;
}

Remarques sur l'implémentation

Type	Champ	Remarques
chaîne	id	OBLIGATOIRE, longueur maximale : 255.  Identifiant unique dans l'ensemble de prix.
chaîne	title	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. Doit correspondre au prix final sur la page de paiement, y compris toutes les taxes et tous les frais. Consultez les règles concernant les prix. La devise sera convertie dans la devise de l'utilisateur lors du rendu.
booléen	is_free	FACULTATIF, la valeur par défaut est "false". L'entrée ou le billet sont sans frais. Doit être défini sur "true" pour les options sans frais.
repeated GeoCriterion	geo_criteria	FACULTATIF. Liste des régions géographiques auxquelles ce prix s'applique. Si ce champ est vide, la règle s'applique à tous les lieux.
repeated PriceFeesAndTaxes	fees_and_taxes	FACULTATIF. Répartition des frais et taxes inclus dans le prix.

Exemples

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

Proto

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;
}

Remarques sur l'implémentation

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

Exemples

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

PriceFeesAndTaxes

Proto

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;
}

Remarques sur l'implémentation

Type	Champ	Remarques
google.type.Money	per_ticket_fee	FACULTATIF. Frais de réservation inclus dans le prix final du produit pour un billet individuel.
google.type.Money	per_ticket_tax	FACULTATIF. Taxes d'État incluses dans le prix final d'un billet individuel.

Exemples

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

Emplacement

Proto

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;
}

Remarques sur l'implémentation

Type	Champ	Remarques
GeoLocation	position	FACULTATIF, au moins un des éléments "location" (lieu) ou "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".

Exemples

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

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

GeoLocation

Consultez les consignes d' utilisation pour en savoir plus sur chaque type d'indice.

Proto

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;
  }
}

Remarques sur l'implémentation

Type	Champ	Remarques
chaîne	place_id	FACULTATIF : exactement l'un des éléments place_id, address, place_info, business_profile_id ou lat_lng doit être présent. 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 Things to Do Center.
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 étant le nom du lieu tel qu'il est affiché sur Google. Pour une mise en correspondance plus précise, utilisez l'adresse de la rue indiquée sur Google pour le lieu.
PlaceInfo	place_info	FACULTATIF : exactement l'un des éléments place_id, address, place_info, business_profile_id ou lat_lng doit être présent. Informations structurées sur le lieu.
uint64	business_profile_id	FACULTATIF : exactement l'un des éléments place_id, address, place_info, business_profile_id ou lat_lng doit être présent. ID de la fiche d'établissement, tel qu'il figure 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 du lieu, qui a accès à la fiche d'établissement Google du lieu et peut fournir cet ID.
google.type.LatLng	lat_lng	FACULTATIF : exactement l'un des éléments place_id, address, place_info, business_profile_id ou lat_lng doit être présent. 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 des établissements spécifiques. Utilisez plutôt place_info pour faire correspondre un lieu spécifique par son nom et ses coordonnées.

Exemples

"place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"

"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

Proto

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;
  }
}

Remarques sur l'implémentation

Type	Champ	Remarques
chaîne	nom	REQUIRED. Longueur maximale : 300 Nom du lieu ou de l'établissement. Pour une meilleure précision de la correspondance, ce nom doit être identique à celui affiché sur Google pour le lieu. Pour les lieux dont la fiche d'établissement Google a été revendiquée, ce nom doit être identique à celui configuré dans la fiche d'établissement.
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 de la correspondance, ce numéro doit être identique à celui affiché sur Google pour le lieu. Il peut inclure des caractères de séparation 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 la recherche Google pour le lieu.
google.type.LatLng	coordonnées	FACULTATIF. Coordonnées géographiques du lieu. Si vous ne renseignez pas ce champ, Google déduira les coordonnées à partir de l'adresse. Facultatif, mais vous devez indiquer coordinates ou structured_address et unstructured_address.
StructuredAddress	structured_address	FACULTATIF, un seul des éléments structured_address ou unstructured_address peut être présent, jamais les deux.
chaîne	unstructured_address	FACULTATIF, un seul des éléments structured_address ou unstructured_address peut être présent, jamais les deux.

Exemples

"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

Proto

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;
}

Remarques sur l'implémentation

Type	Champ	Remarques
chaîne	street_address	REQUIRED. Longueur maximale : 200. Adresse postale, y compris le numéro de 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 nom du lieu ou de l'établissement, qui doit être fourni 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 ces informations doivent être fournies à l'aide des champs correspondants.
chaîne	localité	FACULTATIF. Longueur maximale : 80. Localité, qui 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. Plus haute subdivision administrative utilisée pour les adresses postales du pays ou de la région concernés. 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 manière 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, ce champ doit être laissé vide.
chaîne	country_code	FACULTATIF. Longueur maximale : 2. Code pays, tel que défini par le CLDR Unicode, lui-même basé sur la norme ISO 3166 alpha-2. Consultez la documentation Unicode.

Exemples

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

LocalizedTextSet

Proto

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

Remarques sur l'implémentation

Type	Champ	Remarques
repeated google.type.LocalizedText	localized_texts	Valeurs textuelles localisées par paramètre régional. Nombre maximal de paramètres régionaux : 50.

Exemples

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

CancellationPolicy

Proto

// 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;
}

Remarques sur l'implémentation

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 annulé à 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 fixes déduits en cas de remboursement. Peut être utilisé séparément ou en combinaison avec refund_percent. Dans ce dernier cas, le pourcentage de remboursement s'applique en premier, puis les frais sont déduits.

Exemples

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