Feed de produtos

O feed de produtos é a principal maneira de fornecer ao Google uma lista de itens da seção "Coisas legais para fazer" que vão aparecer em várias plataformas do Google.

Um objeto ProductFeed consiste em um único objeto FeedMetadata e zero ou mais objetos Product. Se nenhum Product for fornecido em todos os fragmentos, todos os produtos serão excluídos.

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

Observações sobre implementação

Tipo	Campo	Observações
FeedMetadata	feed_metadata	OBRIGATÓRIO. Metadados deste feed.
repetido Produto	produtos	OPCIONAL. Quando a política não for definida em todos os fragmentos, todos os produtos serão excluídos. feed_metadata/max_removal_share pode precisar ser definido quando um grande número de produtos for removido.

Exemplos

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

Observações sobre implementação

Tipo	Campo	Observações
uint32	shard_id	OBRIGATÓRIO quando total_shards_count > 1. Baseado em zero. Os fragmentos não precisam ser transferidos em ordem. O processamento começa somente após o upload de um conjunto completo de fragmentos.
uint32	total_shards_count	OBRIGATÓRIO, precisa ser >= 1.
uint64	nonce	OBRIGATÓRIO quando total_shards_count > 1. Precisa ser o mesmo para todos os fragmentos dentro da transferência.
enum	processing_instruction	REQUIRED. PROCESS_AS_SNAPSHOT é o único valor compatível.
dupla	max_removal_share	OPCIONAL. Compartilhamento máximo de produtos ativos que podem ser removidos por um upload. Se mais produtos forem removidos por essa transferência, a transferência inteira será rejeitada. Essa é uma proteção contra a remoção não intencional de uma parte significativa do inventário. Pode ser definido como 1,0 para permitir a remoção completa do inventário.

Exemplos

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

Product

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

Observações sobre implementação

Tipo	Campo	Observações
string	id	OBRIGATÓRIO, tamanho máximo de 255. – Uma string exclusiva que identifica o produto. Os caracteres permitidos são alfanuméricos, _ e -.
LocalizedTextSet	título	OBRIGATÓRIO, tamanho recomendado: 50 ou 150 caracteres. Consulte as diretrizes de título e descrição para mais detalhes.
LocalizedTextSet	descrição	RECOMENDADO, tamanho recomendado <= 10.000, comprimento máximo de 16.000 caracteres. Consulte as diretrizes de título e descrição para mais detalhes.
repetido TextFeature	product_features	RECOMENDADO. Número máximo de recursos: 100.
Classificação	classificação	RECOMENDADO. É altamente recomendável fornecer classificações, já que produtos com esse tipo de conteúdo resultam em uma taxa de cliques mais alta.
repetido Mídia	related_media	RECOMENDADO, número máximo de mídia: 30 É altamente recomendável fornecer mais de uma imagem. Consulte o guia detalhado sobre imagens em Diretrizes de imagens.
boolean	use_media_order	OPCIONAL Indique ao Google que a ordem em que as mídias relacionadas aparecem no feed deve ser levada em consideração ao escolher a imagem a ser exibida.
repetido Opção	opções	OBRIGATÓRIO, número máximo de opções: 20 Cada produto precisa ter pelo menos uma opção de produto.
Operador	operador	OPCIONAL.
enum	descontinuado inventory_type	OPCIONAL. O atributo INVENTORY_TYPE_OFFICIAL só pode ser definido em produtos com links para o site oficial de ingressos de um ponto de interesse. A capacidade de definir esse valor só será ativada após a análise de qualificação. Este campo foi descontinuado e substituído pelo novo campo repetidoinventory_types.
repeated	inventory_types	OPCIONAL. Lista repetida de tipos de inventário exclusivos a que o produto pertence. O atributo INVENTORY_TYPE_OFFICIAL só pode ser definido em produtos com links para o site oficial de ingressos de um ponto de interesse. A capacidade de definir esse valor só será ativada após a análise de qualificação. INVENTORY_TYPE_OPERATOR_DIRECT só pode ser definido em produtos com links para o site da agência de turismo. A capacidade de definir esse valor só será ativada após a análise de qualificação.
enum	confirmation_type	OPCIONAL.
FulfillmentType	fulfillment_type	RECOMENDADO. Se definido, pelo menos um campo em fulfillment_rype precisará ser verdadeiro. Define maneiras de conseguir um documento para confirmar a reserva. É possível fazer combinações. Por exemplo, dispositivo móvel + impresso ou impresso em casa + retirada no local disponíveis.
LocalizedTextSet	brand_name	comprimento máximo de 100. O nome da marca que o produto precisa mostrar. Isso substitui o agora descontinuado "operador/nome". Apenas um dos dois valores pode ser definido.

Exemplos

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

Opção

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

Observações sobre implementação

Tipo	Campo	Observações
string	id	OBRIGATÓRIO. ID da opção. Precisa ser exclusivo em um produto.
LocalizedTextSet	título	OBRIGATÓRIO, tamanho recomendado: 50, tamanho máximo: 150 caracteres. Se houver apenas uma opção, o título da opção poderá ser igual ao título do produto. Se várias opções de produtos forem apresentadas, o título precisará ser exclusivo. Consulte as diretrizes de título e descrição para mais detalhes.
LocalizedTextSet	descrição	RECOMENDADO, tamanho recomendado: 10.000, comprimento máximo: 16.000. Consulte as diretrizes de título e descrição para mais detalhes.
DeepLink	landing_page	OBRIGATÓRIO. Precisa conter o botão ou link para reservar o produto. Consulte as diretrizes da página de destino para mais detalhes.
DeepLink	landing_page_list_view	RECOMENDADO. Adicione um link para uma visualização em lista em um nível mais alto de ingressos e excursões disponíveis, destacando essa opção, possivelmente entre outras. Consulte as diretrizes da página de destino para mais detalhes.
repetido TextFeature	option_features	OPCIONAL, número máximo de recursos: 100. não pode duplicar os detalhes do nível do produto.
CancellationPolicy	cancellation_policy	RECOMENDADO.
repetido Categoria	option_categories	Opcional, número máximo de categorias: 100. Categorias relevantes para esta opção. É importante lembrar que self-guided esteja definido para todas as atividades que não sejam em tours e guided-tour para atividades desse tipo. Consulte a documentação Categoria de produtos para conferir outros valores recomendados.
repetido RelatedLocation	related_location	RECOMENDADO, número máximo de locais: 100. Fornecer uma lista precisa de locais relacionados é extremamente importante para que o produto apareça nos lugares mais relevantes. No entanto, incluir tags demais ou fornecer dados precisos resulta na remoção do produto. Consulte o guia Local e ponto de interesse para mais detalhes.
bool	base_ticket	OPCIONAL. Usado para indicar se a opção do produto é o ingresso de entrada básico.
repetido PriceOption	price_options	OBRIGATÓRIO, pelo menos 1. Todos os preços possíveis para esta opção. Observação: somente preços para adultos são aceitos. Se várias opções de preço tiverem sido fornecidas, o primeiro preço que passar na verificação de restrição geográfica será usado. Para ingressos de grupos, o preço total de todo o grupo precisa ser usado.
uint32	duration_sec	OPCIONAL. Duração da opção em segundos, quando aplicável, por exemplo, para tours guiados, passeios de barco etc. Isso precisa refletir a duração da experiência (não o tempo de validade).
repetido Idioma	linguagens	RECOMENDADO, número máximo de idiomas: 100. Idiomas em que a opção está disponível. Quando é importante que o usuário final entenda e/ou leia no idioma para aproveitar a experiência. Por exemplo, relevante para um tour guiado.
Local	meeting_point	OPCIONAL. Adicione apenas quando for relevante e benéfico, por exemplo, o local em que o participante encontrará o guia para iniciar o passeio a pé, o local onde o participante será levado para um passeio pela cidade ou a doca onde o cruzeiro começará.

Exemplos

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

Observações sobre implementação

Tipo	Campo	Observações
enum	feature_type	OBRIGATÓRIO. Tipo de atributo, valores possíveis: TEXT_FEATURE_INCLUSION: o recurso é uma inclusão. TEXT_FEATURE_EXCLUSION: o recurso é uma exclusão. TEXT_FEATURE_HIGHLIGHT: o recurso é um destaque. TEXT_FEATURE_MUST_KNOW: o recurso é essencial. TEXT_FEATURE_SAFETY_INFORMATION: o recurso representa informações sobre medidas de segurança.
LocalizedTextSet	valor	OBRIGATÓRIO, tamanho recomendado: 1.000 caracteres ou menos. Tamanho máximo: 2.000. Tags de formatação HTML compatíveis: br, strong, em, i Somente as quatro tags mencionadas acima são compatíveis. br pode ser usado para quebrar linhas em parágrafos e strong/em/i para destacar textos importantes. Outras tags de frase serão ignoradas. Todas as outras tags e estilos personalizados não são permitidos e serão removidos. Todos os URLs, âncoras e links serão removidos e nunca serão exibidos aos usuários finais.

Exemplos

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

Classificação

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

Observações sobre implementação

Tipo	Campo	Observações
dupla	average_value	OPCIONAL. Valor da nota média. O valor precisa estar no intervalo de [1, 5] e só pode ser omitido se rating_count for zero.
uint64	rating_count	OBRIGATÓRIO. Número de notas usadas no cálculo do valor.

Exemplos

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

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

Mídia

Proto

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

  enum MediaType {
    // Don't use, for backwards compatibility only.
    MEDIA_TYPE_UNSPECIFIED = 0;
    // Indicates the media provided by the url is a photo.
    MEDIA_TYPE_PHOTO = 1;
  }
  // Type of this media source.
  // Required.
  MediaType type = 2;

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

Observações sobre implementação

Tipo	Campo	Observações
string	url	OBRIGATÓRIO, tamanho máximo: 2.000. URL desta fonte de mídia. O Google vai rastrear a mídia hospedada nesse URL.
enum	digitar	OBRIGATÓRIO. Tipo dessa fonte de mídia. Valores possíveis: MEDIA_TYPE_PHOTO: indica que a mídia fornecida pelo URL é uma foto.
LocalizedTextSet	attribution	OPCIONAL, comprimento recomendado: 1.000, comprimento máximo: 2.000. Informações de atribuição sobre a fonte da mídia. Se a atribuição for necessária com a mídia para dar crédito ao fotógrafo ou à agência, esse campo vai precisar ser definido.

Exemplos

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

Definição de categoria

Proto

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

Observações sobre implementação

Tipo	Campo	Observações
string	Identificador	OBRIGATÓRIO. Consulte a documentação da categoria de produto para acessar a lista de valores válidos.

Exemplos

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

Observações sobre implementação

Define a relação entre uma opção e um local.

Tipo	Campo	Observações
Local	local	OBRIGATÓRIO. Local relacionado a uma opção. Pode ser um PDI (por exemplo, Torre Eiffel), um bairro (por exemplo, Cidade Velha) ou um endereço / ponto do mapa arbitrário.
enum	relation_type	OBRIGATÓRIO. Tipo de relação de uma opção para o local especificado. Valores possíveis: RELATION_TYPE_RELATED_NO_ADMISSION: o local está relacionado, mas a relação não permite a entrada ou a entrada é irrelevante. Por exemplo, o local é um quadrado destacado em um tour pela cidade. RELATION_TYPE_ADMISSION_TICKET: a relação concede admissão a esse local relacionado. RELATION_TYPE_SUPPLEMENTARY_ADDON: a relação declara um serviço adicional que não coloca o usuário no local relacionado, por exemplo, uma multa de estacionamento, uma exposição temporária etc.

Exemplos

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

Observações sobre implementação

Definição de link direto. Pode incluir parâmetros de valor que serão expandidos no momento da veiculação.

Tipo	Campo	Observações
string	url	OPCIONAL, tamanho máximo: 2.000. Modelo de URL da página de destino para computador. É obrigatório "url" ou "localized_url".
string	mobile_url	OPCIONAL, tamanho máximo: 2.000. Modelo de URL da página de destino para dispositivos móveis.
LocalizedTextSet	localized_url	OPCIONAL, comprimento máximo: 2.000, número máximo de locais 50. Modelo de URL da página de destino localizado para computadores. Se url e localized_url forem fornecidos, o primeiro será usado como substituto caso nenhum URL corresponda à localidade do usuário. Se url não estiver disponível e o idioma não for fornecido, o URL em inglês será usado.
LocalizedTextSet	localized_mobile_url	OPCIONAL, comprimento máximo: 2.000, número máximo de locais 50. Modelo de URL da página de destino mobile_local localizado para dispositivos móveis.

Exemplos

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

Observações sobre implementação

Tipo	Campo	Observações
LocalizedTextSet	nome [descontinuado]	OPCIONAL, tamanho recomendado: 50; comprimento máximo: 100. É o nome da marca do vendedor do produto. As OTAs precisam definir a marca como a marca OTA. Esse campo foi descontinuado e substituído por "brand_name" em "products"
LocalizedTextSet	google_business_profile_name	OBRIGATÓRIO, tamanho máximo: 100. Nome da empresa do operador como está registrado no Perfil da Empresa no Google e aparece no Google Maps. Este campo é obrigatório para participar do módulo de reserva do operador.
string	phone_number	OPCIONAL, tamanho máximo: 64. Número de telefone da operadora. Prefira o formato completo de número de telefone internacional.
repetido Local	locais	OPCIONAL, número máximo: 1. O endereço comercial do operador. Se a string de endereço for usada, inclua o nome da empresa como parte dela. Por exemplo, ", ". A empresa do operador precisa ser encontrada no Google Maps para que o módulo de reserva seja acionado, então o operador precisa registrar um Perfil da Empresa no Google se a empresa não for encontrada no Maps.

Exemplos

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

Definição de linguagem

Proto

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

Observações sobre implementação

Tipo	Campo	Observações
string	código	Um código de idioma compatível com BCP-47, como "en" ou "de-CH".

Exemplos

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

Observações sobre implementação

Tipo	Campo	Observações
string	id	OBRIGATÓRIO, tamanho máximo: 255. : ID exclusivo no conjunto de preços.
string	título	OBRIGATÓRIO, tamanho máximo: 150. Breve descrição da opção de preço, por exemplo, "Dia da semana para adultos".
google.type.Money	preço	OBRIGATÓRIO quando is_free for falso. O valor do preço precisa corresponder ao preço final na página de finalização da compra, incluindo todos os tributos e cobranças. Consulte a política de preços. A moeda será convertida para a moeda do usuário na renderização.
bool	is_free	OPCIONAL, o padrão é "false". A entrada ou o ingresso é sem custo financeiro. Precisa ser definido como verdadeiro para opções de preço zero.
repetido GeoCriterion	geo_criteria	OPCIONAL. Lista de regiões geográficas às quais esse preço é aplicável. Se estiver vazio, ela será aplicável a todos os locais.
repetido PriceFeesAndTaxes	fees_and_taxes	OPCIONAL. Confira os detalhes das tarifas e tributos incluídos no preço acima.

Exemplos

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

Observações sobre implementação

Tipo	Campo	Observações
string	country_code	OBRIGATÓRIO. Código do país de duas letras conforme definido na ISO 3166-1.
bool	is_negative	OPCIONAL. Se verdadeiro, o critério será negativo (o código do país será excluído).

Exemplos

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

Observações sobre implementação

Tipo	Campo	Observações
google.type.Money	per_ticket_fee	OPCIONAL. Taxas de reserva incluídas no preço final do produto para um único ingresso.
google.type.Money	per_ticket_tax	OPCIONAL. Tributos estaduais incluídos no preço final do produto de um único ingresso.

Exemplos

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

Local

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

Observações sobre implementação

Tipo	Campo	Observações
GeoLocation	local	OPCIONAL, pelo menos um local ou uma descrição precisa estar presente. A localização geográfica.
LocalizedTextSet	descrição	OPCIONAL, tamanho recomendado: 1.000, comprimento máximo: 2.000. Pelo menos um local ou descrição precisa estar presente. Descrição adicional em formato legível, por exemplo, "Do lado esquerdo da fonte na praça do Palácio".

Exemplos

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

GeoLocation

Consulte as diretrizes de uso para ver informações mais detalhadas sobre cada tipo de dica.

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

Observações sobre implementação

Tipo	Campo	Observações
string	place_id	OPCIONAL: exatamente um de place_id, address, place_info, business_profile_id ou lat_lng precisa estar presente. PlaceId, conforme definido pela API Places. Identifica exclusivamente um PDI no Google. Ele pode ser originado usando os endpoints da API Places, como Place Search ou Place Autocomplete, ou manualmente, usando a ferramenta Encontrar correspondências de local na Central de Coisas legais para fazer.
string	endereço	OPCIONAL: exatamente um de place_id, address, place_info, business_profile_id ou lat_lng precisa estar presente. USO SUSPENSO. Endereço legado de linha única. Comprimento máximo: 200. Os componentes precisam ser separados por vírgula, sendo o primeiro componente o nome do local conforme exibido no Google. Para maior precisão de correspondência, use o endereço mostrado no Google para o lugar.
PlaceInfo	place_info	OPCIONAL: exatamente um de place_id, address, place_info, business_profile_id ou lat_lng precisa estar presente. Informações estruturadas do lugar.
uint64	business_profile_id	OPCIONAL: exatamente um de place_id, address, place_info, business_profile_id ou lat_lng precisa estar presente. ID do Perfil da Empresa no Google, conforme encontrado na página de configurações do Perfil da Empresa no Google. Use esse campo ao procurar locais diretamente do proprietário do lugar, que tem acesso ao Perfil da Empresa no Google do lugar e pode fornecer esse ID.
google.type.LatLng	lat_lng	OPCIONAL: exatamente um de place_id, address, place_info, business_profile_id ou lat_lng precisa estar presente. Coordenadas geográficas. Esse campo só pode ser usado para determinar uma cidade ou região geográfica, já que é ambíguo para identificar um lugar ou empresas específicos. Use place_info para corresponder a um lugar específico por nome e coordenadas.

Exemplos

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

Observações sobre implementação

Tipo	Campo	Observações
string	name	OBRIGATÓRIO. Comprimento máximo: 300. Lugar ou nome da empresa. Para maior precisão, ele precisa ser igual ao nome do lugar mostrado no Google. Para lugares com um Perfil da Empresa no Google reivindicado, ele precisa ser o mesmo nome configurado no perfil.
string	phone_number	OPCIONAL. Comprimento máximo: 30. Número de telefone, incluindo o prefixo internacional. Para maior precisão, esse número precisa ser o mesmo que o número de telefone do lugar mostrado no Google. Pode incluir caracteres separadores usados com frequência. Exemplos: "[phone]", "[phone]".
string	website_url	OPCIONAL. Comprimento máximo: 1.000. URL do site mostrado no Google para o lugar, de preferência o URL vinculado à ficha da empresa no Google Maps ou na Pesquisa Google do lugar.
google.type.LatLng	coordenadas	OPCIONAL. Coordenadas geográficas do lugar. Se deixado em branco, o Google vai inferir as coordenadas do endereço. Opcional, mas é preciso fornecer coordinates ou structured_address e unstructured_address.
StructuredAddress	structured_address	OPCIONAL, exatamente um de structured_address ou unstructured_address pode estar presente, nunca ambos.
string	unstructured_address	OPCIONAL, exatamente um de structured_address ou unstructured_address pode estar presente, nunca ambos.

Exemplos

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

Observações sobre implementação

Tipo	Campo	Observações
string	street_address	OBRIGATÓRIO. Comprimento máximo: 200. Endereço, incluindo o número da casa e qualquer outro componente que não possa ser fornecido usando os campos mais específicos definidos abaixo. Ele não deve incluir o lugar ou o nome da empresa, que devem ser fornecidos separadamente usando o campo name em PlaceInfo. Também não deve incluir código postal, localidade ou país, porque eles devem ser fornecidos usando os campos correspondentes abaixo.
string	localidade	OPCIONAL. Comprimento máximo: 80. Região administrativa, geralmente relacionada à cidade ou município de um endereço. Em regiões do mundo em que as localidades não são bem definidas ou não se encaixam bem nessa estrutura, deixe o campo em branco.
string	administrative_area	OPCIONAL. Comprimento máximo: 80. A maior subdivisão administrativa usada para endereços postais do país ou da região específica. Pode ser um estado, uma região, uma província, um oblast, uma prefeitura etc. Pode ser uma abreviação ou um nome completo, dependendo de como a região geralmente é representada nos endereços postais do país específico.
string	postal_code	OPCIONAL. Comprimento máximo: 30. É o código postal ou CEP. Obrigatório se o país aceitar códigos postais. Caso contrário, deixe em branco.
string	country_code	OPCIONAL. Comprimento máximo: 2. Código do país, conforme definido pelo Unicode "CLDR", com base no padrão ISO 3166 alfa-2. Consulte a documentação sobre Unicode.

Exemplos

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

Observações sobre implementação

Tipo	Campo	Observações
repetido google.type.LocalizedText	localized_texts	Valores de texto localizados por localidade.

Exemplos

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

Observações sobre implementação

Define uma única condição de reembolso. Várias condições podem ser usadas em conjunto para descrever "etapas de reembolso" como várias durações antes do horário de início do serviço.

Tipo	Campo	Observações
RefundCondition	refund_conditions	OPCIONAL, número máximo de condições de reembolso: 10.

RefundCondition

Tipo	Campo	Observações
uint32	min_duration_before_start_time_sec	Opcional. Duração em segundos antes do horário de início até o momento em que o cliente poderá receber um reembolso por parte do custo do serviço especificado em refund_percent. Se ela não for definida ou for definida como 0, o serviço poderá ser cancelado a qualquer momento.
uint32	refund_percent	OPCIONAL. A porcentagem que pode ser reembolsada, desde que a reserva do serviço seja cancelada pelo menos min_duration_before_start_time antes do horário de início do serviço, no intervalo de [0, 100]. Quando não definido ou definido como 0, o serviço não é reembolsável. O valor 100 indica que o serviço é totalmente reembolsável.
google.type.Money	refund_fee	OPCIONAL. Uma taxa fixa deduzida do reembolso. Pode ser usado separadamente ou em combinação com os refund_percent acima. No último caso, a porcentagem do reembolso é aplicada primeiro e, em seguida, a taxa é deduzida.

Exemplos

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