Le flux de produits est le moyen principal de fournir à Google une liste d'objets pour créer des produits qui s'afficheront sur différentes plates-formes Google.
Un objet ProductFeed
se compose d'un seul objet FeedMetadata
.
zéro ou plusieurs objets Product
. Si aucun Product
n'est fourni dans tous les segments,
tous les produits sont alors 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 | OBLIGATOIRE. Métadonnées de ce flux. |
répété Produit |
produits | FACULTATIF. Si cette règle n'est pas définie dans tous les segments, sont supprimés. feed_metadata/max_removal_share
lorsque vous supprimez un grand nombre de produits. |
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.Base zéro. Les segments n'ont pas besoin d'être transférés dans l'ordre. Début du traitement qu'après l'importation d'un ensemble complet de segments. |
uint32 | total_shards_count | OBLIGATOIRE, doit être >= 1. |
uint64 | nonce | OBLIGATOIRE lorsque total_shards_count > 1.Doit être identique pour tous les segments du transfert. |
énum | processing_instruction | OBLIGATOIRE.PROCESS_AS_SNAPSHOT est la seule valeur.
compatibles.
|
double | max_removal_share | FACULTATIF. Part maximale des produits actifs peuvent être supprimées lors d'une importation. Si d'autres produits sont supprimés par ce transfert, l'ensemble du transfert est refusé. Il s'agit d'un une protection contre le retrait involontaire d'une grande partie 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;
// 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;
}
Remarques sur l'implémentation
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, les traits de soulignement (_) et les tirets (-). |
LocalizedTextSet | titre | OBLIGATOIRE, longueur recommandée <= 50, longueur maximale de 150 caractères. Pour en savoir plus, consultez les consignes relatives aux titres et aux descriptions. |
LocalizedTextSet | description | RECOMMANDÉ, longueur recommandée <= 10 000, longueur maximale de 16 000 caractères. Pour en savoir plus, consultez les consignes relatives aux titres et aux descriptions. |
repeated TextFeature |
product_features | RECOMMANDÉ, nombre maximal de fonctionnalités: 100. |
Note | rating | RECOMMANDÉ. Il est vivement recommandé d'attribuer des notes, car les produits associés à des notes génèrent un taux de clics plus élevé. |
repeated Media |
related_media | RECOMMANDÉ, nombre maximal de médias: 30 Nous vous recommandons vivement de fournir plusieurs images. Consultez les consignes relatives aux images pour obtenir un guide détaillé sur les images. |
booléen | use_media_order | FACULTATIF Indiquez à Google que l'ordre dans lequel les médias associés sont listés dans le flux doit être pris en compte au moment de choisir 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. |
énum | deprecated inventory_type |
FACULTATIF.INVENTORY_TYPE_OFFICIAL ne peut être défini que dans des produits qui renvoient vers le site officiel de billetterie d'un point de terminaison
d’intérêt. Vous ne pourrez définir cette valeur qu'après un examen d'éligibilité. Ce champ est obsolète et a été 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 ce produit appartient. INVENTORY_TYPE_OFFICIAL ne peut être défini que dans des produits qui renvoient vers le site officiel de billetterie d'un point de
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 des produits redirigeant 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É. S'il est défini, au moins un champ de fulfillment_rype doit être défini sur "true".Définit les moyens d'obtenir un document pour confirmer la réservation. Les combinaisons sont (par exemple, mobile + imprimé, ou imprimé à domicile + retrait en magasin) est disponible. |
LocalizedTextSet | brand_name | la longueur maximale est de 100. Nom de la marque que le produit doit afficher, à la place de celui désormais obsolète "operator/name". Vous ne pouvez définir qu'une seule des deux valeurs. |
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}¤cy={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}¤cy={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 | OBLIGATOIRE. ID d'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 propre à 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 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É. Affichez un lien vers une vue sous forme de liste à un niveau supérieur des billets et visites disponibles, en mettant en avant cette option, éventuellement, entre autres. 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 détaillées au niveau du produit. |
CancellationPolicy | cancellation_policy | RECOMMANDÉ. |
repeated Category |
option_categories | Facultatif. Nombre maximal de catégories: 100. Catégories pertinentes pour cette option. Il est particulièrement important que self-guided soit défini pour toutes les activités qui ne sont pas liées à la visite et que guided-tour soit défini pour les activités basées sur une visite.
Consultez la documentation sur la catégorie de produits pour découvrir d'autres recommandations
valeurs.
|
repeated RelatedLocation |
related_location | RECOMMANDÉ, nombre maximal d'établissements: 100. Fournir une liste exacte de les emplacements associés est extrêmement important pour que le produit apparaisse sur les lieux pertinents. Toutefois, vous pouvez surbaliser ou fournir des données précises le produit en cours de suppression. Pour en savoir plus, consultez le guide Zones géographiques et points d'intérêt. |
Bool | base_ticket | FACULTATIF. Indique si l'option du 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 réservé aux adultes est accepté. Si plusieurs options de prix a été fournie, le premier prix qui réussit la vérification des restrictions géographiques serait utilisé. Pour les billets de groupe, le prix total l'ensemble du groupe doit être utilisé à la place. |
uint32 | duration_sec | FACULTATIF. Durée de l'option en secondes, où telles que les visites guidées ou les excursions en bateau. Cela doit refléter la durée de l'expérience (et non la durée de validité). |
repeated Language |
langues | RECOMMANDÉ, nombre maximal de langues: 100. Langues est disponible. Lorsqu'il est important pour l'utilisateur final comprendre et/ou lire la langue pour profiter de l'expérience. Par exemple, pour une visite guidée. |
Emplacement | meeting_point | FACULTATIF. N'ajoutez des éléments que lorsque cela est pertinent et utile, par exemple le lieu où le participant rencontrera le guide touristique pour commencer une randonnée visite ou le lieu où les participants seront pris en charge pour une visite de la ville, 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}¤cy={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 |
---|---|---|
énum | feature_type | OBLIGATOIRE. Type de caractéristique, valeurs possibles: TEXT_FEATURE_INCLUSION : la caractéristique est une inclusion.TEXT_FEATURE_EXCLUSION : la caractéristique est une exclusion.TEXT_FEATURE_HIGHLIGHT : la fonctionnalité est un temps fort.TEXT_FEATURE_MUST_KNOW : cette fonctionnalité est "à savoir".TEXT_FEATURE_SAFETY_INFORMATION : la caractéristique 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 compatibles: br, strong, em, i Seules les quatre balises mentionnées sont acceptées. br permet d'effectuer les opérations suivantes :
sauter des lignes dans des paragraphes et strong /em /i
peut être utilisée pour mettre
en évidence du texte important. Toutes les autres balises d'expressions seront ignorées.Les autres balises et styles personnalisés ne sont pas autorisés et seront supprimés. N'importe quelle valeur Les URL, les ancres et les liens sont supprimés et ne seront jamais affiché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. Note moyenne. La valeur doit être comprise dans la plage [1, 5]. Elle peut être omise si et seulement si rating_count est égal à zéro. |
uint64 | rating_count | OBLIGATOIRE. Nombre de notes utilisées pour calculer la valeur. |
Exemples
// Example 1
{
"average_value": 4.6,
"rating_count": 192
}
// Example 2: No ratings data
{
"rating_count": 0
}
Multimédia
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 média hébergé sur cette URL. |
énum | type | OBLIGATOIRE. Type de la 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. Attribution des informations sur la source du média. Notez que si l'attribution est doivent figurer avec les médias pour mentionner le photographe ou l'agence ; ce champ doit être défini. |
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 | OBLIGATOIRE. Reportez-vous à 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 {
// 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;
}
Remarques sur l'implémentation
Définit la relation entre une option et un lieu.
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 / point arbitraire sur la carte. |
énum | relation_type | OBLIGATOIRE. Type de relation d'une option pour l'établissement donné. Valeurs possibles: RELATION_TYPE_RELATED_NO_ADMISSION : l'établissement est lié, mais la relation
n'autorise pas l'admission ou l'admission n'a pas d'importance, par exemple un lieu
mis en évidence dans
une visite de la ville.RELATION_TYPE_ADMISSION_TICKET : la relation accorde l'admission à ce
à un emplacement connexe.RELATION_TYPE_SUPPLEMENTARY_ADDON : la relation déclare une valeur
qui ne redirige pas l'utilisateur vers la page correspondante,
un ticket de stationnement
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": {
"address": "Madame Tussauds Berlin, Unter den Linden 74, 10117 Berlin, Germany"
}
},
"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;
// Landing page URL template for mobile. If omitted, it defaults to the `url`
// value.
// Max length: 2000.
// Optional.
string mobile_url = 2;
// 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;
// Localized landing page URL template for mobile.
// Max length: 2000.
// Max number of locales: 50.
// Optional.
LocalizedTextSet localized_mobile_url = 4;
}
Remarques sur l'implémentation
Définition d'un lien profond. Peut inclure des paramètres de valeur qui seront étendus 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. Veuillez saisir "url" ou "localized_url". |
chaîne | mobile_url | FACULTATIF, longueur maximale: 2 000. Modèle d'URL de page de destination pour mobile. |
LocalizedTextSet | localized_url | FACULTATIF, longueur maximale : 2 000, nombre maximal d'utilisateurs locaux : 50. Modèle d'URL de page de destination localisé pour ordinateur. Si url et localized_url sont tous les deux fournis,
le premier est utilisé comme solution de remplacement si aucune URL ne correspond aux paramètres régionaux de l'utilisateur. Si url n'est pas disponible et
langue non fournie, l'URL en anglais est utilisée. |
LocalizedTextSet | localized_mobile_url | FACULTATIF, longueur maximale : 2 000, nombre maximal d'utilisateurs locaux : 50. Modèle d'URL mobile_landing page localisé pour mobile. |
Exemples
// Example 1: single landing page URL.
{
"url": "https://www.danstour.com/bike-tours/?language={lang}¤cy={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 | nom [obsolète] | FACULTATIF, longueur recommandée: 50, longueur maximale: 100. Marque du vendeur de ce produit. Pour les agences de voyages en ligne, la marque 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'entreprise de l'opérateur, tel qu'il est enregistré dans la fiche d'établissement Google et affiché 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 un numéro de téléphone international complet. |
repeated Location |
zones géographiques | FACULTATIF, nombre max. : 1. Adresse professionnelle de l'opérateur. Si vous utilisez une chaîne d'adresse, incluez le nom de l'entreprise dans le d'adresse e-mail. Par exemple : "nom de l'entreprise, adresse postale". Opérateur l'établissement doit être visible sur Google Maps pour que l'opérateur puisse effectuer des réservations l'opérateur doit enregistrer une fiche d'établissement Google si son établissement n'est pas visible dans Google Maps. |
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
"address": "Dans Bikes, 123 NYC 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 | Un 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 | titre | OBLIGATOIRE, longueur maximale: 150. Brève description de l'option de prix, par exemple "En semaine pour adultes". |
google.type.Money | price | OBLIGATOIRE lorsque is_free est défini sur "false".La valeur du prix doit correspondre à prix final affiché sur la page de paiement, taxes et frais compris, consultez règles de tarification. 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" pour les options sans prix. |
repeated GeoCriterion |
geo_criteria | FACULTATIF. Liste des zones géographiques auxquelles ce prix s'applique. Si ce champ est vide, applicable à tous les établissements. |
repeated PriceFeesAndTaxes |
fees_and_taxes | FACULTATIF. Détail 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 | 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 unique. |
google.type.Money | per_ticket_tax | FACULTATIF. Les taxes d'État sont incluses dans le prix final du produit pour un seul billet. |
Exemples
{
"per_ticket_fee": {
"currency_code": "EUR",
"units": 1
},
"per_ticket_tax": {
"currency_code": "EUR",
"units": 1
}
}
Lieu
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, vous devez indiquer au moins l'un des éléments suivants : lieu ou description. Emplacement géographique. |
LocalizedTextSet | description | FACULTATIF, longueur recommandée: 1 000, longueur maximale: 2 000, au moins une
du lieu ou de la description doivent être présentes. Description supplémentaire dans un format lisible tel que "Sur le côté gauche de la fontaine sur la place du Palais". |
Exemples
{
"location": {
"place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
}
GeoLocation
Voir <ph type="x-smartling-placeholder"></ph> utilisation pour obtenir des informations plus détaillées sur chaque type d'indication.
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, correspond exactement à l'une des valeurs place_id ,
address , place_info ,
business_profile_id ou lat_lng doit être
à l'heure actuelle.PlaceId, tel que défini par <ph type="x-smartling-placeholder"></ph> L'API Places Identifie un POI de manière unique sur Google. Il peut être récupéré à l'aide de la classe Places les points de terminaison de l'API, par exemple Place Search ou Place Autocomplete ; manuellement à l'aide de l'outil Rechercher des correspondances de lieux dans Things to Do Center. |
chaîne | adresse | FACULTATIF, correspond exactement à l'une des valeurs place_id ,
address , place_info ,
business_profile_id ou lat_lng doit être
à l'heure actuelle.OBSOLÈTE. Ancienne adresse sur une seule ligne. Longueur maximale: 200. Les composants doivent être séparés par une virgule. Le premier composant correspondant au nom du lieu tel qu'il apparaît sur Google. Pour une meilleure correspondance précision, utilisez l'adresse postale indiquée sur Google pour le lieu. |
PlaceInfo | place_info | FACULTATIF, correspond exactement à l'une des valeurs place_id ,
address , place_info ,
business_profile_id ou lat_lng doit être
à l'heure actuelle.Informations structurées sur des lieux. |
uint64 | business_profile_id | FACULTATIF, correspond exactement à l'une des valeurs place_id ,
address , place_info ,
business_profile_id ou lat_lng doit être
à l'heure actuelle.ID de la fiche d'établissement, tel qu'indiqué dans les paramètres de la fiche d'établissement Google . Utilisez ce champ lorsque vous vous procurez des points de vente directement auprès de l'entreprise qui a accès à sa fiche d'établissement Google. peut fournir cet identifiant. |
google.type.LatLng | lat_lng | FACULTATIF, correspond exactement à l'une des valeurs place_id ,
address , place_info ,
business_profile_id ou lat_lng doit être
à l'heure actuelle.Coordonnées géographiques Ce champ ne peut être utilisé que pour déterminer une ville ou une région géographique spécifique, car il est trop ambigu pour qu'il soit possible d'identifier un ou plusieurs établissements. Utilisez plutôt place_info pour établir une correspondance avec un
un lieu spécifique par son nom et ses coordonnées. |
Exemples
"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
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: "+1 212-363-3200", "+91 562 222 7261".
// 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 | OBLIGATOIRE. Longueur maximale: 300. Nom du lieu ou de l'entreprise Pour un débit plus élevé la précision de la mise en correspondance, elle doit être identique au nom affiché sur Google. pour le lieu en question. Pour les lieux disposant d'une fiche d'établissement Google revendiquée : doit être identique au nom configuré dans l'établissement profil. |
chaîne | phone_number | FACULTATIF. Longueur maximale: 30. Numéro de téléphone, y compris le préfixe international. Pour une plus grande précision de mise en correspondance, il doit s'agir de identique au numéro de téléphone affiché sur Google pour ce lieu. Il peut inclure de caractères de séparation couramment utilisés. Exemples : "+1 212-363-3200", "+91 562 222 7261". |
chaîne | website_url | FACULTATIF. Longueur maximale: 1 000. URL du site Web affichée sur Google pour le de préférence, l'URL de la fiche d'entreprise sur Google sur Maps ou recherchez le lieu. |
google.type.LatLng | coordonnées géographiques | FACULTATIF. Coordonnées géographiques du lieu Si vous ne renseignez pas ce champ,
déduira les coordonnées à partir de l'adresse. Facultatif, mais
coordinates ou l'une des valeurs suivantes : structured_address et
Vous devez indiquer unstructured_address . |
StructuredAddress | structured_address | FACULTATIF, correspond exactement à l'une des valeurs structured_address ou
unstructured_address peut être présent, jamais les deux. |
chaîne | unstructured_address | FACULTATIF, correspond exactement à l'une des valeurs structured_address ou
unstructured_address peut être présent, jamais les deux. |
Exemples
"place_info": {
"name": "Colosseum",
"phone_number": "+39 063 99 67 700",
"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 | OBLIGATOIRE. Longueur maximale: 200. Adresse postale, y compris le numéro de rue
et tout autre composant qui ne peut pas être fourni à l'aide de la méthode
. Il ne doit pas inclure le nom du lieu ou de l'entreprise,
qui doit être fourni séparément à l'aide de name
sous PlaceInfo . Il doit
ni le code postal, la localité ou le pays,
à l'aide des champs correspondants. |
chaîne | localité | FACULTATIF. Longueur maximale: 80. Localité, faisant généralement référence à la ville ou la partie ville d'une adresse. Dans les régions du monde où les localités ne sont pas bien définis ou ne s'intègrent pas bien dans cette structure, 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 un état, une région, une province, un oblast, une préfecture. Il peut s'agir une abréviation ou un nom complet, selon la région représentées dans les adresses postales du pays spécifique. |
chaîne | postal_code | FACULTATIF. Longueur maximale: 30. Code postal. Obligatoire si le pays accepte les codes postaux. Sinon, laissez le champ vide. |
chaîne | country_code | FACULTATIF. Longueur maximale: 2. Code pays, tel que défini par le format Unicode "CLDR", sur la base de la norme ISO 3166 alpha-2. Voir <ph type="x-smartling-placeholder"></ph> 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 du texte localisé par paramètres régionaux. |
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. Vous pouvez utiliser plusieurs conditions de remboursement pour décrire les "étapes de remboursement" que différentes durées avant que le service l'heure de début.
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 et jusqu'à quand le client peut recevoir un remboursement correspondant à une partie du coût du service indiqué dans refund_percent Si cette règle n'est pas configurée ou si elle est définie sur 0, le service peut être annulé à tout moment. |
uint32 | refund_percent | FACULTATIF. Pourcentage pouvant être remboursé, à condition que le la réservation au service est annulée au moins le min_duration_before_start_time
avant l'heure de début du service, dans l'intervalle [0, 100]. Si la règle n'est pas définie ou
défini sur 0, le service n'est pas remboursable. Si la valeur est définie sur 100, ce service
entièrement remboursable. |
google.type.Money | refund_fee | FACULTATIF. Montant fixe déduit lors du remboursement. Peuvent être utilisées séparément ou en combinaison avec refund_percent . Dans
Dans ce cas, le pourcentage de remboursement s'applique d'abord, puis les frais sont déduits. |
Exemples
"refund_conditions": [
{
"min_duration_before_start_time_sec": 86400,
"refund_percent": 100
}]