Feed dei prodotti

Il feed dei prodotti è lo strumento principale per fornire a Google un elenco di cose per realizzare prodotti che devono essere mostrati su varie piattaforme Google.

Un oggetto ProductFeed è composto da un singolo oggetto FeedMetadata e zero o più oggetti Product. Se non viene fornito alcun valore Product in tutti gli shard, tutti i prodotti vengono eliminati.

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

Note di implementazione

Tipo	Campo	Note
FeedMetadata	feed_metadata	OBBLIGATORIO. Metadati per questo feed.
ripetuto Prodotto	prodotti	FACOLTATIVO. Se il criterio non viene impostato in tutti gli shard, prodotti vengono eliminati. feed_metadata/max_removal_share potrebbe essere necessario impostare quando viene rimosso un numero elevato di prodotti.

Esempi

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

Note di implementazione

Tipo	Campo	Note
uint32	shard_id	OBBLIGATORIO quando total_shards_count > 1. In base a zero. Non è necessario trasferire gli shard in ordine. Inizio elaborazione solo dopo aver caricato un set completo di shard.
uint32	total_shards_count	OBBLIGATORIO, deve essere maggiore o uguale a 1.
uint64	nonce	OBBLIGATORIO quando total_shards_count > 1. Deve essere uguale per tutti gli shard all'interno del trasferimento.
enum	processing_instruction	OBBLIGATORIO. PROCESS_AS_SNAPSHOT è l'unico valore supportati.
double	max_removal_share	FACOLTATIVO. Quota massima di prodotti attivi che sono che può essere rimossa con un caricamento. Se vengono rimossi altri prodotti con questo trasferimento, l'intero trasferimento viene rifiutato. Si tratta di un evitare la rimozione accidentale di una parte significativa dei inventario. Può essere impostato su 1,0 per consentire la rimozione completa dell'inventario.

Esempi

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

Prodotto

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

Note di implementazione

Tipo	Campo	Note
stringa	id	OBBLIGATORIO, lunghezza massima 255. Una stringa univoca che identifica prodotto. Sono consentiti caratteri alfanumerici, _ e -.
LocalizedTextSet	titolo	OBBLIGATORIO, lunghezza consigliata<= 50, lunghezza massima 150 caratteri. Per ulteriori dettagli, consulta le linee guida relative ai titoli e alle descrizioni.
LocalizedTextSet	descrizione	CONSIGLIATA, lunghezza consigliata <= 10.000, lunghezza massima 16000 caratteri. Per ulteriori dettagli, consulta le linee guida relative ai titoli e alle descrizioni.
repeated TextFeature	product_features	CONSIGLIATO. Numero massimo di funzionalità: 100.
Valutazione	classificazione	CONSIGLIATA. Ti consigliamo vivamente di fornire valutazioni, in quanto i prodotti che mostrano valutazioni generano una percentuale di clic più elevata.
repeated Media	related_media	CONSIGLIATO, numero massimo di contenuti multimediali: 30 Ti consigliamo vivamente di fornire più di un'immagine. Consulta le linee guida per le immagini per una guida dettagliata sulle immagini.
booleano	use_media_order	FACOLTATIVO Suggerimento a Google di prendere in considerazione l'ordine in cui i contenuti multimediali correlati sono elencati nel feed al momento di scegliere l'immagine da mostrare.
repeated Option	opzioni	OBBLIGATORIO, numero massimo di opzioni: 20 Ogni prodotto deve avere almeno un'opzione di prodotto.
Operatore	operatore	FACOLTATIVO.
enum	deprecated inventory_type	FACOLTATIVO. Il campo INVENTORY_TYPE_OFFICIAL può essere impostato solo nei prodotti con link al sito ufficiale dei biglietti di un punto di interesse. La possibilità di impostare questo valore viene attivata solo dopo una verifica dell'idoneità. Questo campo è obsoleto e sostituito dal nuovo campo ripetuto Inventory_types.
ripetuto	inventory_types	FACOLTATIVO. Elenco ripetuto di tipi di inventario univoci a cui appartiene questo prodotto. Il campo INVENTORY_TYPE_OFFICIAL può essere impostato solo nei prodotti con link al sito ufficiale dei biglietti di un punto di interesse. La possibilità di impostare questo valore viene attivata solo dopo una verifica dell'idoneità. Il campo INVENTORY_TYPE_OPERATOR_DIRECT può essere impostato solo nei prodotti che rimandano al sito dei tour operator. La possibilità di impostare questo valore viene attivata solo dopo una verifica dell'idoneità.
enum	confirmation_type	FACOLTATIVO.
FulfillmentType	fulfillment_type	CONSIGLIATA. Se impostato, almeno un campo in fulfillment_rype deve essere true. Imposta i modi per ottenere un documento per confermare la prenotazione. Le combinazioni sono possibile, ad esempio dispositivo mobile + stampa o stampa a domicilio + ritiro di persona è disponibile.
LocalizedTextSet	brand_name	lunghezza massima 100. Il nome del brand che dovrebbe mostrare il prodotto, che sostituisce l'elenco ora deprecato "operatore/nome". È possibile impostare solo uno dei due valori.

Esempi

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

Opzione

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

Note di implementazione

Tipo	Campo	Note
stringa	id	OBBLIGATORIO. ID opzione. Deve essere univoco all'interno di un prodotto.
LocalizedTextSet	titolo	OBBLIGATORIO, lunghezza consigliata: 50, lunghezza massima: 150 caratteri. Se è presente una sola opzione, il titolo dell'opzione può corrispondere a quello del prodotto. Se più vengono presentate le opzioni del prodotto, il titolo deve essere univoco per l'opzione. Per ulteriori dettagli, consulta le linee guida relative a titoli e descrizione.
LocalizedTextSet	descrizione	CONSIGLIATA, lunghezza consigliata: 10.000, lunghezza massima: 16.000. Per ulteriori dettagli, consulta le linee guida relative ai titoli e alle descrizioni.
DeepLink	landing_page	OBBLIGATORIO. Deve contenere un pulsante o un link per prenotare il prodotto. Per ulteriori dettagli, consulta le linee guida sulla pagina di destinazione.
DeepLink	landing_page_list_view	CONSIGLIATA. Includere un link a una visualizzazione elenco a un livello superiore di biglietti e tour disponibili, mettendo in evidenza questa opzione insieme ad altre opzioni. Per ulteriori dettagli, consulta le linee guida sulla pagina di destinazione.
repeated TextFeature	option_features	FACOLTATIVO, numero massimo di elementi: 100. Non devono essere duplicati i dettagli a livello di prodotto.
CancellationPolicy	cancellation_policy	CONSIGLIATA.
repeated Category	option_categories	Facoltativo, numero massimo di categorie: 100. Categorie pertinenti per questa opzione. Di particolare importanza, assicurati che self-guided sia impostato per tutte le attività non basate sui tour e che guided-tour sia impostato per le attività basate sui tour. Consulta la documentazione relativa alla categoria di prodotto per ulteriori suggerimenti e i relativi valori.
repeated RelatedLocation	related_location	CONSIGLIATO, numero massimo di sedi: 100. Fornendo un elenco accurato di località correlate è estremamente importante perché il prodotto venga mostrato nei pertinenti, ma l'eccesso di tag o la fornitura di dati precisi si traduce in del prodotto che viene rimosso. Per ulteriori dettagli, consulta la guida Località e punti d'interesse.
bool	base_ticket	FACOLTATIVO. Utilizzato per indicare se l'opzione del prodotto è il biglietto di ingresso di base.
repeated PriceOption	price_options	OBBLIGATORIO, almeno 1. Tutti i prezzi possibili per questa opzione. Nota: è supportato solo il prezzo per adulti. Se sono presenti più opzioni di prezzo sono stati forniti, il primo prezzo che supera il controllo delle restrizioni geografiche . Per i biglietti di gruppo, il prezzo intero del utilizzare l'intero gruppo.
uint32	duration_sec	FACOLTATIVO. La durata dell'opzione in secondi, dove applicabile, ad esempio per tour guidati, gite in barca. Questo dovrebbe riflettere la durata dell'esperienza (non la data di validità).
repeated Language	lingue	CONSIGLIATO. Numero massimo di lingue: 100. Lingue utilizzate è disponibile. Quando è importante che l'utente finale comprendere e/o leggere nella lingua per godersi l'esperienza. Ad esempio per un tour guidato.
Località	meeting_point	FACOLTATIVO. Aggiungila solo se pertinente e utile, ad esempio luogo in cui il partecipante incontrerà la guida del tour per iniziare una camminata tour o il luogo da cui verrà effettuato un tour della città, dal molo da cui ha inizio il viaggio in crociera.

Esempi

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

Note di implementazione

Tipo	Campo	Note
enum	feature_type	OBBLIGATORIO. Tipo di caratteristica, valori possibili: TEXT_FEATURE_INCLUSION: la funzionalità è un'inclusione. TEXT_FEATURE_EXCLUSION: la funzionalità è un'esclusione. TEXT_FEATURE_HIGHLIGHT: La funzionalità è un punto di forza. TEXT_FEATURE_MUST_KNOW: La funzionalità è indispensabile. TEXT_FEATURE_SAFETY_INFORMATION: la funzionalità rappresenta informazioni sulle misure di sicurezza.
LocalizedTextSet	valore	OBBLIGATORIO, lunghezza consigliata <= 1000 caratteri, lunghezza massima 2000. Tag di formattazione HTML supportati: br, strong, em, i Sono supportati solo i quattro tag menzionati. L'app br può essere utilizzata per interruzioni nei paragrafi e strong/em/i può essere utilizzata per evidenziare testo importante. Eventuali altri tag di corrispondenza a frase verranno ignorati. Tutti gli altri tag e stili personalizzati non sono consentiti e verranno rimossi. Qualsiasi URL, ancoraggi e link verranno rimossi e non saranno mai visualizzati per gli utenti finali.

Esempi

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

Classificazione

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

Note di implementazione

Tipo	Campo	Note
double	average_value	FACOLTATIVO. Valore medio della valutazione. Il valore deve essere compreso tra [1, 5] e può essere omesso se e solo se rating_count è pari a zero.
uint64	rating_count	OBBLIGATORIO. Numero di valutazioni utilizzate per il calcolo del valore.

Esempi

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

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

Media

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

Note di implementazione

Tipo	Campo	Note
stringa	url	OBBLIGATORIO, lunghezza massima: 2000. L'URL di questa fonte multimediale. Google eseguirà la scansione dei contenuti multimediali ospitati a questo URL.
enum	tipo	OBBLIGATORIO. Tipo di origine multimediale. Valori possibili: MEDIA_TYPE_PHOTO: indica che i contenuti multimediali forniti dall'URL sono una foto.
LocalizedTextSet	attribuzione	FACOLTATIVO, lunghezza consigliata: 1000, lunghezza massima: 2000.Attribuzione informazioni sulla fonte dei contenuti multimediali. Tieni presente che se l'attribuzione è da mostrare insieme ai media per citare il fotografo o l'agenzia, è necessario impostare questo campo.

Esempi

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

Categoria

Proto

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

Note di implementazione

Tipo	Campo	Note
stringa	etichetta	OBBLIGATORIO. Per l'elenco dei valori validi, consulta la documentazione relativa alle categorie di prodotto.

Esempi

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

Note di implementazione

Definisce la relazione tra un'opzione e una località.

Tipo	Campo	Note
Località	località	OBBLIGATORIO. Località correlata a un'opzione. Può essere un PDI (ad es. Torre Eiffel), un quartiere (ad es. Centro storico) oppure un indirizzo / un punto sulla mappa arbitrario.
enum	relation_type	REQUIRED. Tipo di relazione di un'opzione per la località specificata. Valori possibili: RELATION_TYPE_RELATED_NO_ADMISSION: la località è correlata ma è correlata non consente l'ingresso oppure l'ingresso è irrilevante, ad esempio il luogo è un quadrato evidenziato in un tour della città. RELATION_TYPE_ADMISSION_TICKET: la relazione concede l'accesso a questo località correlata. RELATION_TYPE_SUPPLEMENTARY_ADDON: la relazione dichiara un'ulteriore che non porta l'utente nella località correlata, ad esempio una biglietto per il parcheggio o mostra temporanea.

Esempi

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

Note di implementazione

Definizione di link diretti. Può includere parametri valore che verranno espansi al momento della pubblicazione.

Tipo	Campo	Note
stringa	url	FACOLTATIVO, lunghezza massima: 2000. Modello di URL pagina di destinazione per computer. È obbligatorio specificare "url" o "localized_url".
stringa	mobile_url	FACOLTATIVO, lunghezza massima: 2000. Modello di URL pagina di destinazione per dispositivi mobili.
LocalizedTextSet	localized_url	FACOLTATIVO, lunghezza massima: 2000, numero massimo di locali 50. Modello di URL pagina di destinazione localizzato per computer. Se vengono forniti sia url sia localized_url, la prima viene utilizzata come alternativa nel caso in cui nessun URL corrisponda alla lingua dell'utente. Se url non è disponibile e la lingua non viene specificata, viene utilizzato l'URL in inglese.
LocalizedTextSet	localized_mobile_url	FACOLTATIVO, lunghezza massima: 2000, numero massimo di locali 50. Modello di URL pagina di destinazione mobile localizzato per dispositivi mobili.

Esempi

// 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}"
    }]
  }
}

Operatore

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

Note di implementazione

Tipo	Campo	Note
LocalizedTextSet	nome [deprecato]	FACOLTATIVO, lunghezza consigliata: 50, lunghezza massima: 100. Il nome del brand del venditore di questo prodotto. Gli OTA devono impostare quello del brand OTA. Questo campo è obsoleto e sostituito da brand_name nella sezione Prodotti
LocalizedTextSet	google_business_profile_name	OBBLIGATORIO, lunghezza massima: 100. Nome dell'attività dell'operatore così come è registrato in Profilo dell'attività su Google e visualizzato su Google Maps. Questo campo è obbligatorio per partecipare al modulo di prenotazione dell'operatore.
stringa	phone_number	FACOLTATIVO, lunghezza massima: 64. Numero di telefono dell'operatore. Preferisci il formato completo dei numeri di telefono internazionali.
repeated Location	posizioni	FACOLTATIVO, numero massimo: 1. L'indirizzo dell'attività dell'operatore. Se viene utilizzata la stringa indirizzo, includi il nome dell'attività commerciale nella . Ad esempio "nome dell'attività, indirizzo". Operatore l'attività deve essere individuabile su Google Maps per consentire all'operatore di effettuare la prenotazione per attivare il modulo, l'operatore deve registrare un Profilo dell'attività su Google se la sua attività non è reperibile su Google Maps.

Esempi

// 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…"
  }}]
}

Lingua

Proto

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

Note di implementazione

Tipo	Campo	Note
stringa	codice	Un codice lingua conforme a BCP-47, ad esempio "en" o "de-CH".

Esempi

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

Note di implementazione

Tipo	Campo	Note
stringa	id	OBBLIGATORIO, lunghezza massima: 255. ID univoco all'interno del prezzo impostato.
stringa	titolo	OBBLIGATORIO, lunghezza massima: 150. Breve descrizione dell'opzione di prezzo, ad esempio "Giorno della settimana per adulti".
google.type.Money	prezzo	OBBLIGATORIO quando is_free è falso. Il valore del prezzo deve corrispondere a prezzo finale nella pagina di pagamento, comprensivo di tutte le tasse e gli addebiti, consulta norme sui prezzi. Al momento del rendering, la valuta verrà convertita nella valuta dell'utente.
bool	is_free	FACOLTATIVO, il valore predefinito è false. L'ingresso o il biglietto sono senza costi. Deve essere impostato su true per le opzioni a prezzo zero.
repeated GeoCriterion	geo_criteria	FACOLTATIVO. Elenco delle aree geografiche a cui si applica questo prezzo. Se vuoto, il campo può essere applicato a tutte le sedi.
repeated PriceFeesAndTaxes	fees_and_taxes	FACOLTATIVO. Scopri le commissioni e le tasse incluse nel prezzo.

Esempi

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

Note di implementazione

Tipo	Campo	Note
stringa	country_code	OBBLIGATORIO. Codice paese di due lettere come definito nello standard ISO 3166-1.
bool	is_negative	FACOLTATIVO. Se true, il criterio è negativo (il codice paese è escluso).

Esempi

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

Note di implementazione

Tipo	Campo	Note
google.type.Money	per_ticket_fee	FACOLTATIVO. Tariffe di prenotazione incluse nel prezzo finale del prodotto per un biglietto singolo.
google.type.Money	per_ticket_tax	FACOLTATIVO. Tasse statali incluse nel prezzo finale del prodotto per un biglietto singolo.

Esempi

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

Località

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

Note di implementazione

Tipo	Campo	Note
GeoLocation	località	FACOLTATIVO, deve essere presente almeno una località o una descrizione. La posizione geografica.
LocalizedTextSet	descrizione	FACOLTATIVO, lunghezza consigliata: 1000, lunghezza massima: 2000, almeno uno del luogo o della descrizione. Una descrizione aggiuntiva in formato leggibile, ad esempio "Sul lato sinistro della fontana nella piazza del Palazzo."

Esempi

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

GeoLocation

Vedi utilizzo per informazioni più dettagliate su ogni tipo di suggerimento.

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

Note di implementazione

Tipo	Campo	Note
stringa	place_id	FACOLTATIVO, esattamente uno tra place_id, address, place_info business_profile_id o lat_lng devono essere presenti. PlaceId come definito da API Places. Identifica in modo univoco un PDI su Google. Può essere ottenuta utilizzando lo strumento Places Endpoint API, ad esempio Place Search o Place Autocomplete oppure manualmente usando lo strumento Trova corrispondenze di località nel Centro Cose da fare.
stringa	indirizzo	FACOLTATIVO, esattamente uno tra place_id, address, place_info business_profile_id o lat_lng devono essere presenti. OBSOLETO. Indirizzo precedente a una riga. Lunghezza massima: 200. I componenti devono essere separati da virgole, con il primo componente ovvero il nome del luogo visualizzato su Google. Per una maggiore corrispondenza , utilizza la via mostrata su Google per il luogo.
PlaceInfo	place_info	FACOLTATIVO, esattamente uno tra place_id, address, place_info business_profile_id o lat_lng devono essere presenti. Informazioni strutturate sui luoghi.
uint64	business_profile_id	FACOLTATIVO, esattamente uno tra place_id, address, place_info business_profile_id o lat_lng devono essere presenti. ID del profilo dell'attività, come indicato nelle impostazioni di Profilo dell'attività su Google . Utilizza questo campo quando acquisisci le sedi direttamente dal luogo proprietario, che ha accesso al profilo dell'attività su Google del luogo e può fornire questo ID.
google.type.LatLng	lat_lng	FACOLTATIVO, esattamente uno tra place_id, address, place_info business_profile_id o lat_lng devono essere presenti. Coordinate geografiche. Questo campo può essere utilizzato solo per determinare una città o una regione geografica, perché è troppo ambiguo identificare una specifica luogo o attività commerciali. Usa invece place_info per trovare una corrispondenza con un luogo specifico in base al nome e alle coordinate.

Esempi

"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: "[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;
  }
}

Note di implementazione

Tipo	Campo	Note
stringa	nome	OBBLIGATORIO. Lunghezza massima: 300. Luogo o nome dell'attività commerciale. Per la precisione della corrispondenza, deve essere uguale al nome mostrato su Google per il luogo. Per i luoghi in cui è stato rivendicato un profilo dell'attività su Google, Deve corrispondere al nome dell'attività configurato nell'attività. profilo.
stringa	phone_number	FACOLTATIVO. Lunghezza massima: 30. Numero di telefono, comprensivo del prefisso internazionale. Per una maggiore precisione della corrispondenza, dovrebbe essere uguale al numero di telefono mostrato su Google per il luogo. Può includere separatori di uso comune. Esempi: "[phone]", "[phone]".
stringa	website_url	FACOLTATIVO. Lunghezza massima: 1000. URL del sito web mostrato su Google per , preferibilmente l'URL a cui rimanda la scheda dell'attività su Google Maps o Cerca il luogo.
google.type.LatLng	coordinate	FACOLTATIVO. Coordinate geografiche del luogo. Se viene lasciato vuoto, Google deduce le coordinate dall'indirizzo. Facoltativo, ma coordinates o un valore qualsiasi tra structured_address e È necessario specificare unstructured_address.
StructuredAddress	structured_address	FACOLTATIVO, esattamente uno tra structured_address o Potrebbero essere presenti unstructured_address, mai entrambi.
stringa	unstructured_address	FACOLTATIVO, esattamente uno tra structured_address o Potrebbero essere presenti unstructured_address, mai entrambi.

Esempi

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

Note di implementazione

Tipo	Campo	Note
stringa	street_address	OBBLIGATORIO. Lunghezza massima: 200. Via, incluso il numero civico e qualsiasi altro componente che non può essere fornito utilizzando il modello campi. Non deve includere il luogo o il nome dell'attività, che devono invece essere forniti separatamente usando name sotto PlaceInfo. Dovrebbe non devono neanche includere codice postale, località o paese come dovrebbero forniti utilizzando i campi corrispondenti.
stringa	località	FACOLTATIVO. Lunghezza massima: 80. Località, in genere con riferimento alla città o la città di un indirizzo. Nelle regioni del mondo in cui le località non sono ben definiti o non si adattano bene a questa struttura, lascia vuoto.
stringa	administrative_area	FACOLTATIVO. Lunghezza massima: 80. Suddivisione amministrativa più alta utilizzata per gli indirizzi postali del paese o della regione specifici. Può essere un stato, regione, provincia, oblast, prefettura. Può essere un un'abbreviazione o un nome completo, a seconda di come è generalmente la regione indicati nell'indirizzo postale del paese specifico.
stringa	postal_code	FACOLTATIVO. Lunghezza massima: 30. Il codice postale. Obbligatorio se se il paese supporta i codici postali, altrimenti deve essere lasciato vuoto.
stringa	country_code	FACOLTATIVO. Lunghezza massima: 2. Il codice paese, come definito da Unicode "CLDR", sulla base dello standard ISO 3166 alpha-2. Vedi Unicode.

Esempi

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

Note di implementazione

Tipo	Campo	Note
repeated google.type.LocalizedText	localized_texts	Valori di testo localizzati per ogni lingua.

Esempi

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

Note di implementazione

Definisce una singola condizione di rimborso. Potrebbero essere utilizzate più condizioni di rimborso per descrivere i passaggi del rimborso come varie durate prima che il servizio all'ora di inizio.

Tipo	Campo	Note
RefundCondition	refund_conditions	FACOLTATIVO, numero massimo di condizioni di rimborso: 10.

RefundCondition

Tipo	Campo	Note
uint32	min_duration_before_start_time_sec	(Facoltativo) Durata in secondi prima dell'ora di inizio, fino a quando il cliente può ricevere un rimborso per una parte del costo del servizio specificato in refund_percent. Se il criterio non viene configurato o se viene impostato su 0, il servizio può essere annullato in qualsiasi momento.
uint32	refund_percent	FACOLTATIVO. La percentuale che può essere rimborsata, a condizione che la prenotazione del servizio è stata annullata almeno min_duration_before_start_time prima dell'ora di inizio del servizio, nell'intervallo [0, 100]. Se il criterio non viene configurato o Se impostato su 0, il servizio non è rimborsabile. Se il valore è impostato su 100, il servizio completamente rimborsabile.
google.type.Money	refund_fee	FACOLTATIVO. Una commissione fissa detratta dal rimborso. Possibili applicazioni separatamente o in combinazione con refund_percent. Nella Nel secondo caso, si applica prima la percentuale di rimborso, dopodiché la commissione viene detratta.

Esempi

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