Feed de productos

El feed de productos es la forma principal de proporcionarle a Google una lista de productos de Actividades que se mostrarán en varias plataformas de Google.

Un objeto ProductFeed consta de un solo objeto FeedMetadata y cero o más objetos Product. Si no se proporciona un Product en todos los fragmentos, se borrarán todos los productos.

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

Notas de implementación

Tipo	Campo	Notas
FeedMetadata	feed_metadata	OBLIGATORIO. Metadatos de este feed.
repetido Producto	products	OPCIONAL. Si no se configura en todos los fragmentos, se borran todos los productos. Es posible que debas configurar feed_metadata/max_removal_share cuando se quite una gran cantidad de productos.

Ejemplos

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

Notas de implementación

Tipo	Campo	Notas
uint32	shard_id	OBLIGATORIO cuando total_shards_count > 1. Basado en cero. No es necesario transferir los fragmentos en orden. El procesamiento comienza solo después de que se suba un conjunto completo de fragmentos.
uint32	total_shards_count	OBLIGATORIO, debe ser mayor o igual que 1.
uint64	nonce	OBLIGATORIO cuando total_shards_count > 1. Debe ser el mismo para todos los fragmentos dentro de la transferencia.
enum	processing_instruction	REQUIRED. PROCESS_AS_SNAPSHOT es el único valor admitido.
doble	max_removal_share	OPCIONAL. Es el porcentaje máximo de productos activos que se pueden quitar mediante una carga. Si se quitan más productos durante esta transferencia, se rechaza toda la transferencia. Esta es una protección contra la eliminación accidental de una parte significativa del inventario. Se puede establecer en 1.0 para permitir la eliminación completa del inventario.

Ejemplos

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

Producto

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

Notas de implementación

Tipo	Campo	Notas
cadena	id	OBLIGATORIO. Longitud máxima: 255. : Es una cadena única que identifica el producto. Se permiten los caracteres alfanuméricos, _ y -.
LocalizedTextSet	título	OBLIGATORIO. Longitud recomendada: <= 50, longitud máxima de 150 caracteres. Consulta los Lineamientos del título y la descripción para obtener más información.
LocalizedTextSet	descripción	RECOMMENDED, longitud recomendada <= 10,000, longitud máxima 16,000 caracteres. Consulta los Lineamientos del título y la descripción para obtener más información.
repetido TextFeature	product_features	RECOMENDADO, cantidad máxima de funciones: 100.
Calificación	clasificación	RECOMENDADO. Se recomienda proporcionar calificaciones, ya que los productos que muestran calificaciones generan una mayor tasa de clics.
contenido multimedia repetido	related_media	RECOMENDADO, cantidad máxima de archivos multimedia: 30 Se recomienda proporcionar más de una imagen. Consulta los lineamientos sobre imágenes para obtener una guía detallada sobre las imágenes.
boolean	use_media_order	OPCIONAL Pide a Google que el orden en el que se muestran los medios relacionados en el feed debe tener en cuenta cuando elijas qué imagen mostrar.
repetido Opción	Opciones	OBLIGATORIO, cantidad máxima de opciones: 20 Cada producto debe tener al menos una opción de producto.
Operador	operador	OPCIONAL.
enum	obsoleto inventory_type	OPCIONAL. INVENTORY_TYPE_OFFICIAL solo se puede configurar en productos que vinculen al sitio oficial de entradas de un lugar de interés. La capacidad de establecer este valor se habilita solo después de una revisión de elegibilidad. Este campo dejó de estar disponible y se reemplazó por el nuevo campo repetido Inventory_types.
repeated	inventory_types	OPCIONAL. Es una lista repetida de los tipos de inventario únicos a los que pertenece este producto. INVENTORY_TYPE_OFFICIAL solo se puede configurar en productos que vinculen al sitio oficial de entradas de un lugar de interés. La capacidad de establecer este valor se habilita solo después de una revisión de elegibilidad. INVENTORY_TYPE_OPERATOR_DIRECT solo se puede configurar en los productos que estén vinculados al sitio del operador turístico. La capacidad de establecer este valor se habilita solo después de una revisión de elegibilidad.
enum	confirmation_type	OPCIONAL.
FulfillmentType	fulfillment_type	RECOMENDADO. Si se establece, al menos un campo en fulfillment_rype debe ser verdadero. Establece las formas de obtener un documento para confirmar la reserva. Se pueden utilizar combinaciones, por ejemplo, en dispositivos móviles + impresos o impresos en casa + retiro en persona.
LocalizedTextSet	brand_name	longitud máxima 100. Es el nombre de marca que debería mostrar el producto. Esto reemplaza al "operador/nombre" ya obsoleto. Solo se puede establecer uno de los dos valores.

Ejemplos

{
  "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?source={src}&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?source={src}&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"]
}

Opción

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

Notas de implementación

Tipo	Campo	Notas
cadena	id	OBLIGATORIO. ID de la opción. Debe ser único dentro de un producto.
LocalizedTextSet	título	OBLIGATORIO. Longitud recomendada: 50 caracteres; longitud máxima: 150 caracteres. Si solo hay una opción, el título de la opción puede ser el mismo que el título del producto. Si se presentan varias opciones de productos, el título debe ser único para cada opción. Consulta los lineamientos para el título y la descripción para obtener más información.
LocalizedTextSet	descripción	RECOMENDADA, longitud recomendada: 10,000, longitud máxima: 16,000. Consulta los Lineamientos del título y la descripción para obtener más información.
DeepLink	landing_page	OBLIGATORIO. Debe contener un botón o vínculo para reservar el producto. Consulta los Lineamientos de las páginas de destino para obtener más información.
DeepLink	landing_page_list_view	RECOMENDADO. Agrega un vínculo a una vista de lista en un nivel superior de entradas y recorridos disponibles para destacar esta opción, entre otras. Consulta los Lineamientos de las páginas de destino para obtener más información.
repetido TextFeature	option_features	OPCIONAL, cantidad máxima de funciones: 100. No debes duplicar los detalles a nivel del producto.
CancellationPolicy	cancellation_policy	RECOMENDADO.
repetido Categoría	option_categories	Opcional, cantidad máxima de categorías: 100. Categorías relevantes para esta opción. Es especialmente importante que configures self-guided para todas las actividades que no se basan en giras y que guided-tour esté configurado para las actividades que se basan en visitas guiadas. Consulta la documentación de Categoría de producto para obtener valores recomendados adicionales.
repetido RelatedLocation	related_location	RECOMENDADO, cantidad máxima de ubicaciones: 100. Proporcionar una lista precisa de las ubicaciones relacionadas es extremadamente importante para que el producto aparezca en los lugares más relevantes. Sin embargo, si lo haces en exceso o si proporcionas datos precisos, se quitará el producto. Consulta la guía Ubicación y lugar de interés para obtener más detalles.
bool	base_ticket	OPCIONAL. Se usa para indicar si la opción de producto es la entrada básica.
repetido PriceOption	price_options	OBLIGATORIO, al menos 1. Todos los precios posibles para esta opción. Nota: Solo se admite el precio para adultos. Si se proporcionaran varias opciones de precios, se usará el primer precio que supere la verificación de restricción geográfica. En el caso de las entradas grupales, se debe usar el precio total de todo el grupo.
uint32	duration_sec	OPCIONAL. Duración de la opción en segundos, si corresponde, p.ej., para visitas guiadas, viajes en bote, etc. Debe reflejar la duración de la experiencia (no el tiempo de validez).
Idioma repetido	lenguajes	RECOMENDADO, cantidad máxima de idiomas: 100. Idiomas en los que está disponible la opción. Cuando es importante que el usuario final comprenda el idioma o lea en él para disfrutar de la experiencia. P.ej., relevante para una visita guiada.
Ubicación	meeting_point	OPCIONAL. Solo agrega cuando sea relevante y beneficioso, p.ej., el lugar donde el participante se reunirá con la guía turística para comenzar una visita guiada, el lugar donde se recogerá al participante para hacer un recorrido por la ciudad, el muelle donde comenzará el viaje en crucero.

Ejemplos

{
  "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?source={src}&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;
}

Notas de implementación

Tipo	Campo	Notas
enum	feature_type	OBLIGATORIO. Tipo de atributo, valores posibles: TEXT_FEATURE_INCLUSION: El atributo es una inclusión. TEXT_FEATURE_EXCLUSION: La función es una exclusión. TEXT_FEATURE_HIGHLIGHT: El componente es un elemento destacado. TEXT_FEATURE_MUST_KNOW: El atributo es "fundamental". TEXT_FEATURE_SAFETY_INFORMATION: La función representa información sobre las medidas de seguridad.
LocalizedTextSet	valor	OBLIGATORIO, con una longitud recomendada de 1,000 caracteres o menos, con una longitud máxima de 2,000 Etiquetas de formato HTML compatibles: br, strong, em e i Solo se admiten las cuatro etiquetas mencionadas anteriormente. Se puede usar br para dividir líneas en párrafos y strong, em y i para destacar texto importante. Se ignorará cualquier otra etiqueta de frase. No se permiten las demás etiquetas ni estilos personalizados, y se quitarán. Se quitarán las URLs, las anclas y los vínculos, y nunca se mostrarán a los usuarios finales.

Ejemplos

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

Rating

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

Notas de implementación

Tipo	Campo	Notas
doble	average_value	OPCIONAL. Valor de calificación promedio. El valor debe estar en el rango de [1, 5] y se puede omitir solo si rating_count es cero.
uint64	rating_count	OBLIGATORIO. Es la cantidad de calificaciones que se usan para calcular el valor.

Ejemplos

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

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

Contenido multimedia

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

Notas de implementación

Tipo	Campo	Notas
cadena	url	OBLIGATORIO, longitud máxima: 2,000. Es la URL de esta fuente de contenido multimedia. Google rastreará el contenido multimedia alojado en esta URL.
enum	tipo	OBLIGATORIO. Es el tipo de esta fuente de contenido multimedia. Valores posibles: MEDIA_TYPE_PHOTO: Indica que el contenido multimedia que proporciona la URL es una foto.
LocalizedTextSet	atribución	OPCIONAL, longitud recomendada: 1,000, longitud máxima: 2,000. Es la información de atribución sobre la fuente del contenido multimedia. Ten en cuenta que, si se requiere que la atribución se muestre con el contenido multimedia para dar crédito al fotógrafo o la agencia, se debe establecer este campo.

Ejemplos

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

Definición de categoría

Proto

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

Notas de implementación

Tipo	Campo	Notas
cadena	etiqueta	OBLIGATORIO. Consulta la documentación sobre categorías de productos para conocer la lista de valores válidos.

Ejemplos

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

Notas de implementación

Define la relación entre una opción y una ubicación.

Tipo	Campo	Notas
Ubicación	ubicación	OBLIGATORIO. La ubicación está relacionada con una opción. Puede ser un lugar de interés (p.ej., la torre Eiffel), un vecindario (p.ej., el casco antiguo) o una dirección o un punto arbitrario en el mapa.
enum	relation_type	OBLIGATORIO. Tipo de relación de una opción para la ubicación determinada. Valores posibles: RELATION_TYPE_RELATED_NO_ADMISSION: La ubicación está relacionada, pero la relación no permite la entrada o la entrada es irrelevante, p.ej., la ubicación es un cuadrado destacado en un recorrido por la ciudad. RELATION_TYPE_ADMISSION_TICKET: La relación otorga la admisión a esta ubicación relacionada. RELATION_TYPE_SUPPLEMENTARY_ADDON: La relación declara un servicio adicional que no lleva al usuario a la ubicación relacionada, p.ej., una multa de estacionamiento, una exhibición temporal, etcétera.

Ejemplos

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

Notas de implementación

Definición de vínculo directo. Pueden incluir parámetros de valor que se expandirán en el momento de la publicación.

Tipo	Campo	Notas
cadena	url	OPCIONAL, longitud máxima: 2,000. Plantilla de URL de página de destino para computadoras de escritorio. Se requiere `url` o `localized_url`.
cadena	mobile_url	OPCIONAL, longitud máxima: 2,000. Plantilla de URL de página de destino para dispositivos móviles.
LocalizedTextSet	localized_url	OPCIONAL, longitud máxima: 2,000, cantidad máxima de locales: 50. Plantilla de URL de página de destino localizada para computadoras de escritorio. Si se proporcionan url y localized_url, el primero se usa como resguardo en caso de que ninguna URL coincida con la configuración regional del usuario. Si url no está disponible y no se proporciona el idioma, se usa la URL en inglés.
LocalizedTextSet	localized_mobile_url	OPCIONAL, longitud máxima: 2,000, cantidad máxima de locales, 50. Plantilla de URL de página de destino para dispositivos móviles localizada para dispositivos móviles.

Ejemplos

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

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

Operador

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

Notas de implementación

Tipo	Campo	Notas
LocalizedTextSet	nombre [obsoleto]	OPCIONAL, longitud recomendada: 50, longitud máxima: 100. Es el nombre de la marca del vendedor de este producto. Las OTA deben establecer esto como la marca OTA. Este campo dejó de estar disponible y se reemplazó por brand_name en products
LocalizedTextSet	google_business_profile_name	OBLIGATORIO, longitud máxima: 100. Es el nombre de la empresa del operador tal como está registrado en el Perfil de Negocio de Google y aparece en Google Maps. Este campo es obligatorio para participar en el módulo de reserva del operador.
cadena	phone_number	OPCIONAL, longitud máxima: 64. Número de teléfono del operador. Prefiero el formato de número de teléfono internacional completo.
repetido Ubicación	de ubicaciones	OPCIONAL, número máximo: 1. La dirección de la empresa del operador. Si se usa una cadena de dirección, incluye el nombre de la empresa como parte de esa cadena, p. ej., ", ". La empresa del operador debe poder encontrarse en Google Maps para que se active el módulo de reserva del operador, el operador debe registrar un Perfil de Negocio de Google si su empresa no se encuentra en Google Maps.

Ejemplos

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

Definición de idioma

Proto

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

Notas de implementación

Tipo	Campo	Notas
cadena	código	Un código de idioma que cumpla con la norma BCP-47, como "en" o "de-CH".

Ejemplos

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

Notas de implementación

Tipo	Campo	Notas
cadena	id	OBLIGATORIO, longitud máxima: 255. Es un ID único dentro del precio establecido.
cadena	título	OBLIGATORIO, longitud máxima: 150. Descripción breve de la opción de precio, p.ej., “Día de la semana para adultos”.
google.type.Money	precio	OBLIGATORIO cuando is_free es falso. El valor del precio debe coincidir con el precio final que aparece en la página de confirmación de compras, incluidos todos los impuestos y cargos. Consulta la política de precios. La moneda se convertirá a la moneda del usuario en el momento del procesamiento.
bool	is_free	OPCIONAL; el valor predeterminado es falso. La entrada o la entrada son gratuitas. Debe establecerse como verdadero para las opciones de precio cero.
repetido GeoCriterion	geo_criteria	OPCIONAL. Lista de regiones geográficas a las que se aplica este precio. Si está vacío, se aplica a todas las ubicaciones.
repetido PriceFeesAndTaxes	fees_and_taxes	OPCIONAL. Desglose de las tarifas y los impuestos incluidos en el precio anterior.

Ejemplos

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

Notas de implementación

Tipo	Campo	Notas
cadena	country_code	OBLIGATORIO. El código de país de 2 letras se define en ISO 3166-1.
bool	is_negative	OPCIONAL. Si es verdadero, el criterio es negativo (se excluye el código de país).

Ejemplos

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

Notas de implementación

Tipo	Campo	Notas
google.type.Money	per_ticket_fee	OPCIONAL. Las tarifas de reserva se incluyen en el precio final del producto para un boleto de ida.
google.type.Money	per_ticket_tax	OPCIONAL. Indica los impuestos incluidos en el precio final del producto para un boleto de ida.

Ejemplos

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

Location

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

Notas de implementación

Tipo	Campo	Notas
GeoLocation	ubicación	OPCIONAL: Se debe incluir al menos una ubicación o una descripción. La ubicación geográfica.
LocalizedTextSet	descripción	OPCIONAL; longitud recomendada: 1,000; longitud máxima: 2,000; se debe incluir al menos una ubicación o una descripción. Descripción adicional en formato legible; p.ej., "A la izquierda de la fuente en la plaza del Palacio".

Ejemplos

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

GeoLocation

Consulta los lineamientos de uso para obtener información más detallada sobre cada tipo de sugerencia.

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

Notas de implementación

Tipo	Campo	Notas
cadena	place_id	OPCIONAL, debe estar presente exactamente uno de los valores place_id, address, place_info, business_profile_id o lat_lng. PlaceId, según lo define la API de Places. Identifica de manera inequívoca un lugar de interés en Google. Se puede obtener con los extremos de la API de Places, por ejemplo, Place Search o Place Autocomplete, o manualmente con la herramienta Find Location Matches en Things to Do Center.
cadena	de la página web.	OPCIONAL, debe estar presente exactamente uno de los valores place_id, address, place_info, business_profile_id o lat_lng. OBSOLETO. Dirección heredada de una línea. Longitud máxima: 200. Se espera que los componentes estén separados por comas. El primer componente debe ser el nombre del lugar tal como se muestra en Google. Para obtener una mayor precisión de las coincidencias, usa la dirección que se muestra en Google para el lugar.
PlaceInfo	place_info	OPCIONAL, debe estar presente exactamente uno de los valores place_id, address, place_info, business_profile_id o lat_lng. Información estructurada del lugar.
uint64	business_profile_id	OPCIONAL, debe estar presente exactamente uno de los valores place_id, address, place_info, business_profile_id o lat_lng. Es el ID del Perfil de Negocio, como se encuentra en la página de configuración del Perfil de Negocio de Google. Utiliza este campo cuando obtengas ubicaciones directamente del propietario del lugar, quien tiene acceso al Perfil de Negocio de Google del lugar y puede proporcionar ese ID.
google.type.LatLng	lat_lng	OPCIONAL, debe estar presente exactamente uno de los valores place_id, address, place_info, business_profile_id o lat_lng. Coordenadas geográficas. Este campo solo se puede utilizar para determinar una ciudad o una región geográfica, ya que es demasiado ambiguo como para identificar un lugar o empresas específicos. Utiliza place_info para buscar coincidencias con un lugar específico por nombre y coordenadas.

Ejemplos

"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: 300.
  // 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;
  }
}

Notas de implementación

Tipo	Campo	Notas
cadena	name	OBLIGATORIO. Longitud máxima: 300. Nombre del lugar o de la empresa Para obtener una mayor precisión de las coincidencias, este nombre debe ser el mismo que se muestra en Google para el lugar. En el caso de los lugares con un Perfil de Negocio de Google reclamado, debe coincidir con el nombre de la empresa configurado en el perfil.
cadena	phone_number	OPCIONAL. Longitud máxima: 30. Número de teléfono con el prefijo internacional Para una mayor precisión, debe ser el mismo número de teléfono que se muestra en Google para el lugar. Puede incluir caracteres separadores de uso común. Ejemplos: “[phone]” o “[phone]”.
cadena	website_url	OPCIONAL. Longitud máxima: 1,000. URL del sitio web que se muestra en Google para el lugar, preferentemente la URL vinculada en la ficha de la empresa en Google Maps o en la Búsqueda del lugar.
google.type.LatLng	coordenadas	OPCIONAL. Coordenadas geográficas del lugar Si se deja vacío, Google inferirá las coordenadas a partir de la dirección. Opcional, pero se debe proporcionar coordinates o cualquiera de structured_address y unstructured_address.
StructuredAddress	structured_address	OPCIONAL; puede haber solo uno de structured_address o unstructured_address, pero nunca ambos.
cadena	unstructured_address	OPCIONAL; puede haber solo uno de structured_address o unstructured_address, pero nunca ambos.

Ejemplos

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

Notas de implementación

Tipo	Campo	Notas
cadena	street_address	OBLIGATORIO. Longitud máxima: 200. Dirección, incluido el número de la casa y cualquier otro componente que no se pueda proporcionar con los campos más específicos que se definen a continuación No debe incluir el nombre del lugar ni de la empresa, que debe proporcionarse por separado mediante el campo name en PlaceInfo. Tampoco se deben incluir el código postal, la localidad o el país, ya que se deben proporcionar mediante los campos correspondientes que se muestran más abajo.
cadena	localidad	OPCIONAL. Longitud máxima: 80. Localidad, que generalmente se refiere a la parte de una dirección que indica la ciudad o el pueblo. En regiones del mundo donde las localidades no están bien definidas o no se ajustan bien a esta estructura, deja el campo vacío.
cadena	administrative_area	OPCIONAL. Longitud máxima: 80. Subdivisión administrativa más alta que se usa para las direcciones postales del país o la región específicos. Puede ser un estado, una región, una provincia, un óblast, una prefectura, etc. Puede ser una abreviatura o un nombre completo, según cómo se representa generalmente la región en las direcciones postales del país específico.
cadena	postal_code	OPCIONAL. Longitud máxima: 30. Indica el código postal. Obligatorio si el país admite códigos postales; de lo contrario, debe dejarse vacío.
cadena	country_code	OPCIONAL. Longitud máxima: 2. Es el código de país, según lo define Unicode “CLDR”, basado en el estándar ISO 3166 alpha-2. Consulta la documentación de Unicode.

Ejemplos

{
  "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.
  repeated google.type.LocalizedText localized_texts = 1;
}

Notas de implementación

Tipo	Campo	Notas
repetido google.type.LocalizedText	localized_texts	Valores de texto localizados por configuración regional.

Ejemplos

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

Notas de implementación

Define una sola condición de reembolso. Se podrían usar varias condiciones de reembolso juntas para describir los "pasos de reembolso" como varias duraciones antes de la hora de inicio del servicio.

Tipo	Campo	Notas
RefundCondition	refund_conditions	OPCIONAL, cantidad máxima de condiciones de reembolso: 10.

RefundCondition

Tipo	Campo	Notas
uint32	min_duration_before_start_time_sec	Opcional. Es la duración en segundos antes de la hora de inicio, hasta que el cliente puede recibir un reembolso por una parte del costo del servicio especificado en refund_percent. Si no se establece o se establece en 0, el servicio se puede cancelar en cualquier momento.
uint32	refund_percent	OPCIONAL. El porcentaje que se puede reembolsar, siempre que la reserva del servicio se cancele al menos min_duration_before_start_time antes de la hora de inicio del servicio, en el rango de [0, 100]. Cuando no se establece o se establece en 0, el servicio no es reembolsable. Cuando se establece en 100, el servicio es completamente reembolsable.
google.type.Money	refund_fee	OPCIONAL. Se deduce una tarifa fija sobre el reembolso. Se podría usar por separado o en combinación con el refund_percent anterior. En el último caso, se aplica primero el porcentaje de reembolso y, luego, se deduce la tarifa.

Ejemplos

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