Фид товаров

Фид товаров – это основной способ предоставить Google список товаров, которые нужно сделать, которые будут отображаться на различных платформах Google.

Объект ProductFeed состоит из одного объекта FeedMetadata и нуля или более объектов Product . Если во всех шардах не указан ни один Product , то все продукты удаляются.

Фид продукта

Прото Замечания по реализацииПримеры

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

Тип	Поле	Примечания
Метаданные фида	фид_метаданные	НЕОБХОДИМЫЙ. Метаданные для этого фида.
повторенный Продукт	продукты	НЕОБЯЗАТЕЛЬНЫЙ. Если параметр отключен во всех сегментах, все товары удаляются. feed_metadata/max_removal_share может потребоваться, если удаляется большое количество продуктов.

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

Метаданные фида

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
uint32	shard_id	ТРЕБУЕТСЯ, когда total_shards_count > 1. С нуля. Осколки не нужно передавать по порядку. Обработка начинается только после загрузки полного набора шардов.
uint32	total_shards_count	ОБЯЗАТЕЛЬНО, должно быть >= 1.
uint64	одноразовый номер	ТРЕБУЕТСЯ, когда total_shards_count > 1. Должен быть одинаковым для всех осколков в рамках передачи.
перечисление	инструкция_обработки	НЕОБХОДИМЫЙ. PROCESS_AS_SNAPSHOT — единственное поддерживаемое значение.
двойной	max_removal_share	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная доля активных товаров, которые можно удалить при загрузке. Если в ходе этой передачи будет удалено больше продуктов, вся передача будет отклонена. Это гарантия от непреднамеренного удаления значительной части инвентаря. Можно установить значение 1.0, чтобы разрешить полное удаление инвентаря.

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

Продукт

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	ОБЯЗАТЕЛЬНО, максимальная длина 255. Уникальная строка, идентифицирующая продукт. Допустимые символы: буквенно-цифровые, _ и -.
Локализованныйтекстсет	заголовок	ОБЯЗАТЕЛЬНО, рекомендуемая длина <= 50, максимальная длина 150 символов. Более подробную информацию см. в разделе «Рекомендации по названиям и описаниям» .
Локализованныйтекстсет	описание	РЕКОМЕНДУЕТСЯ, рекомендуемая длина <= 10 000, максимальная длина 16 000 символов. Более подробную информацию см. в разделе «Рекомендации по названиям и описаниям» .
повторенный Текстовая функция	Product_features	РЕКОМЕНДУЕТСЯ, максимальное количество функций: 100.
Рейтинг	рейтинг	РЕКОМЕНДУЕТСЯ. Настоятельно рекомендуется предоставлять рейтинги, поскольку продукты, отображающие рейтинги, приводят к более высокому рейтингу кликов.
повторенный СМИ	родственные_медиа	РЕКОМЕНДУЕТСЯ, максимальное количество носителей: 30. Настоятельно рекомендуется предоставить более одного изображения. Подробное руководство по изображениям см. в разделе Рекомендации по изображениям.
логическое значение	use_media_order	НЕОБЯЗАТЕЛЬНЫЙ Подскажите Google, что при выборе изображения для показа следует учитывать порядок, в котором связанные медиа-файлы перечислены в ленте.
повторенный Вариант	параметры	ОБЯЗАТЕЛЬНО, максимальное количество опций: 20 У каждого продукта должен быть хотя бы один вариант продукта.
Оператор	оператор	НЕОБЯЗАТЕЛЬНЫЙ.
перечисление	устарел тип_инвентаря	НЕОБЯЗАТЕЛЬНЫЙ. INVENTORY_TYPE_OFFICIAL можно установить только в продуктах, которые ссылаются на официальный сайт билетов интересующей точки. Возможность установки этого значения активируется только после проверки приемлемости. Это поле устарело и заменено новым повторяющимся полем Inventory_types.
повторенный	инвентарные_типы	НЕОБЯЗАТЕЛЬНЫЙ. Повторяющийся список уникальных типов инвентаря, к которым принадлежит этот товар. INVENTORY_TYPE_OFFICIAL можно установить только в продуктах, которые ссылаются на официальный сайт билетов интересующей точки. Возможность установки этого значения активируется только после проверки приемлемости. INVENTORY_TYPE_OPERATOR_DIRECT можно установить только в продуктах, которые ссылаются на сайт туроператора. Возможность установки этого значения активируется только после проверки приемлемости.
перечисление	тип_подтверждения	НЕОБЯЗАТЕЛЬНЫЙ.
Тип выполнения	тип_выполнения	РЕКОМЕНДУЕТСЯ. Если установлено, хотя бы одно поле в fulfillment_rype должно иметь значение true. Устанавливает способы получения документа для подтверждения бронирования. Возможны комбинации, например мобильный + распечатанный или распечатанный дома + возможен самовывоз.
Локализованныйтекстсет	название бренда	максимальная длина 100. Название бренда, которое должно отображаться на продукте, заменяет устаревшее `operator/name`. Можно установить только одно из двух значений.

{
  "id": "product-1",
  "title": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans bike tour"
          },
          {
              "language_code": "es",
              "text": "Tour en bicicleta por Dans"
          },
          {
              "language_code": "zh-HK",
              "text": "丹斯自行車之旅"
          }
      ]
  },
  "description": {
    "localized_texts": [
        {
            "language_code": "en",
            "text": "<p>A very fun bike tour<p>"
        },
        {
            "language_code": "es",
            "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
        },
        {
            "language_code": "zh-HK",
            "text": "<p>一個非常有趣的自行車之旅.</p>"
        }
    ]
  },
  "brand_name": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans Bikes"
          }
      ]
  },
  "rating": {
      "average_value": 4.6,
      "rating_count": 192
  },
  "product_features": [{
    "feature_type": "TEXT_FEATURE_INCLUSION",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
          {
              "language_code": "es",
              "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
          },
          {
              "language_code": "zh-HK",
              "text": "<p>一個非常有趣的自行車之旅.</p>"
          }
      ]
    }
  },{
    "feature_type": "TEXT_FEATURE_HIGHLIGHT",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
              },
              {
                  "language_code": "es",
                  "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
              },
              {
                  "language_code": "zh-HK",
                  "text": "<p>一個非常有趣的自行車之旅.</p>"
              }
          ]
      }
  },{
    "feature_type": "TEXT_FEATURE_MUST_KNOW",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
            {
                "language_code": "es",
                "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
            },
            {
                "language_code": "zh-HK",
                "text": "<p>一個非常有趣的自行車之旅.</p>"
            }
        ]
      }
  }],
  "options": [{
    "id": "option-1",
    "title": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "Sunset tour"
            },
            {
                "language_code": "es",
                "text": "Tour al atardecer"
            },
            {
                "language_code": "zh-HK",
                "text": "日落之旅"
            }
        ]
    },
    "landing_page": {
        "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
    },
    "cancellation_policy": {
        "refund_conditions": [
            {
                "min_duration_before_start_time_sec": 86400,
                "refund_percent": 100
            }
        ]
    },
    "option_categories": [
        {
            "label": "sports"
        },
        {
            "label": "bike-tours"
        }
    ],
    "related_locations": [
        {
            "location": {
                "location": {
                    "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        },
        {
            "location": {
                "location": {
                    "lat_lng": {
                        "latitude": 53.339688,
                        "longitude": 6.236688
                    }
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        }
    ],
    "price_options": [
        {
            "id": "option-1-adult",
            "title": "Adult (14+)",
            "price": {
                "currency_code": "EUR",
                "units": 20
            },
            "fees_and_taxes": {
                "per_ticket_fee": {
                    "currency_code": "EUR",
                    "units": 1
                },
                "per_ticket_tax": {
                    "currency_code": "EUR",
                    "units": 1
                }
            }
        }
    ]},{
      "id": "option-2",
      "title": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Sunrise tour"
              },
              {
                  "language_code": "es",
                  "text": "Tour al amanecer"
              },
              {
                  "language_code": "zh-HK",
                  "text": "日出之旅"
              }
          ]
      },
      "landing_page": {
          "url": "https://www.danstour.com/sunrise?language={lang}&currency={currency}"
      },
      "cancellation_policy": {
          "refund_conditions": [
              {
                  "min_duration_before_start_time_sec": 86400,
                  "refund_percent": 100
              }
          ]
      },
      "option_categories": [
          {
              "label": "sports"
          },
          {
              "label": "bike-tours"
          }
      ],
      "related_locations": [
          {
              "location": {
                  "location": {
                      "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                  }
              },
              "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
          }
      ],
      "price_options": [
          {
              "id": "option-2-adult",
              "title": "Adult (14+)",
              "price": {
                  "currency_code": "EUR",
                  "units": 20,
                  "nanos": 0
              }
          }
      ],
      "meeting_point": {
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          },
          "description": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Sunrise tour"
                  },
                  {
                      "language_code": "es",
                      "text": "Tour al amanecer"
                  },
                  {
                      "language_code": "zh-HK",
                      "text": "日出之旅"
                  }
              ]
          }
      }
    }
  ],
  "related_media": [
      {
          "url": "http://www.danstour.com/photo1.jpg",
          "type": "MEDIA_TYPE_PHOTO"
      },
      {
          "url": "http://www.danstour.com/photo2.jpg",
          "type": "MEDIA_TYPE_PHOTO",
          "attribution": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Dans Photos"
                  }
              ]
          }
      }
  ],
  "operator": {
      "name": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Dans Bikes"
              }
          ]
      },
      "phone_number": "01234567",
      "locations": [{
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          }
        }]
  },
  "inventory_types": ["INVENTORY_TYPE_OPERATOR_DIRECT"]
}

Вариант

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	НЕОБХОДИМЫЙ. Идентификатор варианта. Должно быть уникальным внутри продукта.
Локализованныйтекстсет	заголовок	ОБЯЗАТЕЛЬНО, рекомендуемая длина: 50, максимальная длина: 150 символов. Если имеется только один вариант, название варианта может совпадать с названием продукта. Если представлено несколько вариантов продукта, заголовок должен быть уникальным для каждого варианта. Более подробную информацию см. в разделе «Рекомендации по названиям и описаниям» .
Локализованныйтекстсет	описание	РЕКОМЕНДУЕТСЯ, рекомендуемая длина: 10000, максимальная длина: 16000. Более подробную информацию см. в разделе «Рекомендации по названиям и описаниям» .
ДипЛинк	целевая_страница	НЕОБХОДИМЫЙ. Должен содержать кнопку или ссылку для бронирования продукта. Более подробную информацию можно найти в разделе «Рекомендации по созданию целевых страниц» .
ДипЛинк	Landing_page_list_view	РЕКОМЕНДУЕТСЯ. Ссылка на просмотр списка доступных билетов и туров на более высоком уровне, где этот вариант, возможно, будет заметно показан среди других вариантов. Более подробную информацию можно найти в разделе «Рекомендации по созданию целевых страниц» .
повторенный Текстовая функция	option_features	ДОПОЛНИТЕЛЬНО, максимальное количество функций: 100. Не следует дублировать детали уровня продукта.
Политика отмены	cancel_policy	РЕКОМЕНДУЕТСЯ.
повторенный Категория	option_categories	Необязательно, максимальное количество категорий: 100. Соответствующие категории для этой опции. Дополнительные рекомендуемые значения см. в документации по категории продукта .
повторенный СвязанноеМестоположение	связанное_местоположение	РЕКОМЕНДУЕТСЯ, максимальное количество локаций: 100. Предоставление точного списка связанных местоположений чрезвычайно важно для того, чтобы продукт отображался в наиболее подходящих местах, однако чрезмерное количество тегов или предоставление точных данных приводит к удалению продукта. Для получения более подробной информации см. Путеводитель по местоположению и достопримечательностям .
логическое значение	base_ticket	НЕОБЯЗАТЕЛЬНЫЙ. Используется для указания, является ли опция продукта базовым входным билетом.
повторенный ЦенаОпция	цена_опции	ОБЯЗАТЕЛЬНО, минимум 1. Все возможные цены на этот вариант. Примечание. Поддерживается только цена для взрослых. Если было предоставлено несколько вариантов цен, будет использоваться первая цена, которая прошла проверку географических ограничений. Для групповых билетов вместо этого необходимо использовать полную стоимость всей группы.
uint32	продолжительность_сек	НЕОБЯЗАТЕЛЬНЫЙ. Продолжительность действия опции в секундах, где это применимо, например, для экскурсий или прогулок на лодке. Это должно отражать продолжительность опыта (а не срок действия).
повторенный Язык	языки	РЕКОМЕНДУЕТСЯ, максимальное количество языков: 100. Языки, на которых доступна опция. Когда конечному пользователю важно понимать язык и/или читать на нем, чтобы получить удовольствие от работы. Например, для экскурсии.
Расположение	место встречи	НЕОБЯЗАТЕЛЬНЫЙ. Добавляйте только там, где это уместно и полезно, например, место, где участник встретится с гидом, чтобы начать пешеходную экскурсию, или место, где участника заберут для экскурсии по городу, пристань, с которой начнется круиз.

{
  "id": "option-1",
  "title": {
    "localized_texts": [
    {
            "language_code": "en",
            "text": "Sunset tour"
        },
        {
            "language_code": "es",
            "text": "Tour al atardecer"
        },
        {
            "language_code": "zh-HK",
            "text": "日落之旅"
        }
    ]
  },
  "landing_page": {
      "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
  },
  "cancellation_policy": {
      "refund_conditions": [
          {
              "min_duration_before_start_time_sec": 86400,
              "refund_percent": 100
          }
      ]
  },
  "option_categories": [
      {
          "label": "sports"
      },
      {
          "label": "bike-tours"
      }
  ],
  "related_locations": [
      {
          "location": {
              "location": {
                  "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      },
      {
          "location": {
              "location": {
                  "lat_lng": {
                      "latitude": 53.339688,
                      "longitude": 6.236688
                  }
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      }
  ],
  "price_options": [
      {
          "id": "option-1-adult",
          "title": "Adult (14+)",
          "price": {
              "currency_code": "EUR",
              "units": 20
          },
          "fees_and_taxes": {
              "per_ticket_fee": {
                  "currency_code": "EUR",
                  "units": 1
              },
              "per_ticket_tax": {
                  "currency_code": "EUR",
                  "units": 1
              }
          }
      }
  ]
}

Текстовая функция

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
перечисление	Feature_type	НЕОБХОДИМЫЙ. Тип объекта, возможные значения: TEXT_FEATURE_INCLUSION : функция является включенной. TEXT_FEATURE_EXCLUSION : функция является исключением. TEXT_FEATURE_HIGHLIGHT : функция является выделенной. TEXT_FEATURE_MUST_KNOW : функция, которую необходимо знать. TEXT_FEATURE_SAFETY_INFORMATION : функция представляет информацию о мерах безопасности.
Локализованныйтекстсет	ценить	ОБЯЗАТЕЛЬНО, рекомендуемая длина <= 1000 символов, максимальная длина: 2000. Поддерживаемые теги форматирования HTML: br,strong,em,i Поддерживаются только четыре упомянутых тега. br можно использовать для разрыва строк в абзацах, а strong / em / i — для выделения важного текста. Любые другие теги фраз будут игнорироваться. Все остальные теги и пользовательские стили запрещены и будут удалены. Любые URL-адреса, привязки и ссылки будут удалены и никогда не будут отображаться конечным пользователям.

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

Рейтинг

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
двойной	среднее_значение	НЕОБЯЗАТЕЛЬНЫЙ. Среднее значение рейтинга. Значение должно находиться в диапазоне [1, 5] и может быть опущено тогда и только тогда, когда rating_count равен нулю.
uint64	рейтинг_счет	НЕОБХОДИМЫЙ. Количество рейтингов, использованных при расчете значения.

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

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

СМИ

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	URL	ОБЯЗАТЕЛЬНО, максимальная длина: 2000. URL-адрес этого медиа-источника. Google будет сканировать медиафайлы, размещенные по этому URL.
перечисление	тип	НЕОБХОДИМЫЙ. Тип этого медиа-источника. Возможные значения: MEDIA_TYPE_PHOTO : указывает, что медиафайл, предоставленный URL-адресом, является фотографией.
Локализованныйтекстсет	атрибуция	ДОПОЛНИТЕЛЬНО, рекомендуемая длина: 1000, максимальная длина: 2000. Атрибутивная информация об источнике СМИ. Обратите внимание: если атрибуция должна отображаться в средствах массовой информации, чтобы отдать должное фотографу или агентству, это поле должно быть установлено.

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

Категория

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	этикетка	НЕОБХОДИМЫЙ. Список допустимых значений см. в документации по категории продукта .

{
    "label": "sports"
}

СвязанноеМестоположение

Прото Замечания по реализации Примеры

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

Определяет связь между опцией и местоположением.

Тип	Поле	Примечания
Расположение	расположение	НЕОБХОДИМЫЙ. Местоположение, связанное с опцией. Это может быть POI (например, Эйфелева башня), район (например, Старый город) или адрес/произвольная точка на карте.
перечисление	тип_отношения	НЕОБХОДИМЫЙ. Тип связи опции для данного местоположения. Возможные значения: RELATION_TYPE_RELATED_NO_ADMISSION : местоположение связано, но отношение не позволяет войти, или вход не имеет значения, например, местоположение — это площадь, выделенная на обзорной экскурсии по городу. RELATION_TYPE_ADMISSION_TICKET : связь предоставляет доступ к этому связанному местоположению. RELATION_TYPE_SUPPLEMENTARY_ADDON : Связь объявляет дополнительную услугу, которая не позволяет пользователю попасть в соответствующее место, например парковочный талон или временную выставку.

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

ДипЛинк

Прото Замечания по реализации Примеры

// Deep link definition. Can include value parameters that will be expanded on
// serve time.
message DeepLink {
  // Landing page URL template for desktop. If both `url` and `localized_url`
  // are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Either `url` or `localized_url` is required.
  string url = 1;

  // Localized landing page URL template for desktop. If both `url` and
  // `localized_url` are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Max number of locales: 50.
  // Either `url` or `localized_url` is required.
  LocalizedTextSet localized_url = 3;

  reserved 2, 4;
}

Определение глубокой ссылки. Может включать параметры значений, которые будут расширены во время обслуживания.

Тип	Поле	Примечания
нить	URL	НЕОБЯЗАТЕЛЬНО, максимальная длина: 2000. Шаблон URL-адреса целевой страницы для ПК. Требуется либо URL, либо localized_url.
Локализованныйтекстсет	localized_url	НЕОБЯЗАТЕЛЬНО, максимальная длина: 2000, максимальное количество локальных пользователей 50. Шаблон URL-адреса локализованной целевой страницы для настольных компьютеров. Если указаны и url , и localized_url , первый используется в качестве запасного варианта, если ни один URL-адрес не соответствует языковому стандарту пользователя. Если url недоступен и язык не указан, используется URL-адрес на английском языке.

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

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

Оператор

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
Локализованныйтекстсет	имя [устарело]	ДОПОЛНИТЕЛЬНО, рекомендуемая длина: 50, максимальная длина: 100. Торговая марка продавца данного товара. OTA должны установить это как бренд OTA. Это поле устарело и заменено на «название бренда» в разделе «Продукты».
Локализованныйтекстсет	google_business_profile_name	ОБЯЗАТЕЛЬНО, максимальная длина: 100. Название компании оператора, зарегистрированное в профиле компании Google и отображаемое на Картах Google. Это поле обязательно для участия в модуле бронирования оператора.
нить	номер телефона	ДОПОЛНИТЕЛЬНО, максимальная длина: 64. Телефон оператора. Предпочитайте полный международный формат телефонного номера.
повторенный Расположение	локации	НЕОБЯЗАТЕЛЬНО, максимальное количество: 1. Юридический адрес оператора. Если используется строка адреса, включите название компании как часть строки адреса. Например, «название компании, почтовый адрес». Чтобы активировать модуль бронирования оператора, компания оператора должна быть доступна для поиска на Картах Google. Оператор должен зарегистрировать профиль компании в Google, если его компания не может быть найдена на Картах Google.

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

Язык

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	код	Код языка, совместимый с BCP-47, например «en» или «de-CH».

{
    "code": "de-CH"
}

ЦенаОпция

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	ОБЯЗАТЕЛЬНО, максимальная длина: 255. Уникальный идентификатор в рамках ценового набора.
нить	заголовок	ОБЯЗАТЕЛЬНО, максимальная длина: 150. Краткое описание варианта цены, например «Взрослый будний день».
google.type.Money	цена	ОБЯЗАТЕЛЬНО, если is_free имеет значение false. Значение цены должно соответствовать окончательной цене на странице оформления заказа, включая все налоги и сборы, см. ценовую политику. Валюта будет конвертирована в валюту пользователя при рендеринге.
логическое значение	is_free	НЕОБЯЗАТЕЛЬНО, по умолчанию — false. Вход или билет бесплатный. Должно быть установлено значение true для вариантов с нулевой ценой.
повторенный Геокритерион	geo_criteria	НЕОБЯЗАТЕЛЬНЫЙ. Список географических регионов, к которым применима данная цена. Если пусто, применимо ко всем местоположениям.
повторенный ЦенаКомиссионные и налоги	сборы_и_налоги	НЕОБЯЗАТЕЛЬНЫЙ. Разбивка сборов и налогов, включенных в цену.

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

Геокритерион

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	код_страны	НЕОБХОДИМЫЙ. Двухбуквенный код страны, определенный в ISO 3166-1.
логическое значение	is_negative	НЕОБЯЗАТЕЛЬНЫЙ. Если true, критерий отрицательный (код страны исключается).

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

ЦенаКомиссионные и налоги

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
google.type.Money	per_ticket_fee	НЕОБЯЗАТЕЛЬНЫЙ. Плата за бронирование включена в окончательную цену продукта за один билет.
google.type.Money	per_ticket_tax	НЕОБЯЗАТЕЛЬНЫЙ. Государственные налоги включены в конечную цену продукта за один билет.

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

Расположение

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
Геолокация	расположение	НЕОБЯЗАТЕЛЬНО, должно присутствовать хотя бы одно из названий местоположения или описания. Географическое положение.
Локализованныйтекстсет	описание	НЕОБЯЗАТЕЛЬНО, рекомендуемая длина: 1000, максимальная длина: 2000, должно присутствовать хотя бы одно местоположение или описание. Дополнительное описание в удобочитаемой форме типа «С левой стороны фонтана на Дворцовой площади».

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

Геолокация

Более подробную информацию о каждом типе подсказок см. в руководстве по использованию.

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	Place_id	НЕОБЯЗАТЕЛЬНО, должно присутствовать ровно одно из place_id , address , place_info , business_profile_id или lat_lng . PlaceId, как определено API Places . Уникально идентифицирует POI в Google. Его можно получить с помощью конечных точек Places API, например «Поиск мест» или «Автозаполнение мест», или вручную с помощью инструмента «Найти совпадения местоположений» в Центре дел.
нить	адрес	НЕОБЯЗАТЕЛЬНО, должно присутствовать ровно одно из place_id , address , place_info , business_profile_id или lat_lng . УСТАРЕЛО. Устаревший однострочный адрес. Максимальная длина: 200. Предполагается, что компоненты будут разделены запятыми, причем первым компонентом будет название места, отображаемое в Google. Для более высокой точности сопоставления используйте адрес места, указанный в Google.
Информация о месте	место_информация	НЕОБЯЗАТЕЛЬНО, должно присутствовать ровно одно из place_id , address , place_info , business_profile_id или lat_lng . Структурированная информация о месте.
uint64	business_profile_id	НЕОБЯЗАТЕЛЬНО, должно присутствовать ровно одно из place_id , address , place_info , business_profile_id или lat_lng . Идентификатор профиля компании, указанный на странице настроек профиля компании в Google. Используйте это поле при поиске местоположений непосредственно у владельца места, который имеет доступ к профилю компании в Google и может предоставить такой идентификатор.
google.type.LatLng	lat_lng	НЕОБЯЗАТЕЛЬНО, должно присутствовать ровно одно из place_id , address , place_info , business_profile_id или lat_lng . Географические координаты. Это поле можно использовать только для определения города или географического региона, поскольку оно слишком неоднозначно для идентификации конкретного места или предприятия. Вместо этого используйте place_info для сопоставления определенного места по имени и координатам.

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

Информация о месте

Прото Замечания по реализации Примеры

message PlaceInfo {
  // Place or business name.
  // For higher matching accuracy, this should be the same as the name shown on
  // Google for the place. For places with a claimed Google Business Profile,
  // this should be the same as the business name configured in the business
  // profile.
  // Max length: 100.
  // Required.
  string name = 1;

  // Phone number, including the international prefix.
  // For higher matching accuracy, this should be the same as the phone number
  // shown on Google for the place.
  // It can include commonly used separator characters.
  // Examples: "[phone]", "[phone]".
  // Max length: 30.
  // Optional.
  string phone_number = 2;

  // Website URL shown on Google for the place, preferably the URL linked from
  // the business listing in Google Maps or Search for the place.
  // Max length: 1000.
  // Optional.
  string website_url = 3;

  // Geographic coordinates of the place.
  // If left empty, Google will infer the coordinates from the address.
  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  google.type.LatLng coordinates = 4;

  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  oneof address_type {
    // Structured address.
    // Prefer this format whenever possible for higher matching accuracy.
    StructuredAddress structured_address = 5;

    // Unstructured address.
    // It should not include the place or business name, which must instead be
    // provided separately using the `name` field.
    //
    // Examples:
    // - `name`: "Colosseum", `unstructured_address`: "Piazza del Colosseo, 1,
    // 00184 Roma RM, Italy".
    // - `name`: "The British Museum", `unstructured_address`: "Great Russell
    // St, London WC1B 3DG, United Kingdom".
    //
    // Max length: 400.
    string unstructured_address = 6;
  }
}

Тип	Поле	Примечания
нить	имя	НЕОБХОДИМЫЙ. Максимальная длина: 300. Место или название компании. Для более высокой точности соответствия оно должно совпадать с названием места, отображаемым в Google. Для мест с заявленным профилем компании в Google оно должно совпадать с названием компании, настроенным в профиле компании.
нить	номер телефона	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная длина: 30. Номер телефона, включая международный префикс. Для более высокой точности сопоставления он должен совпадать с номером телефона, указанным в Google для этого места. Он может включать часто используемые символы-разделители. Примеры: «[phone]», «[phone]».
нить	URL-адрес_сайта	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная длина: 1000. URL-адрес веб-сайта, указанный в Google для этого места, предпочтительно URL-адрес, указанный в списке компаний на Картах Google или в Поиске этого места.
google.type.LatLng	координаты	НЕОБЯЗАТЕЛЬНЫЙ. Географические координаты места. Если оставить пустым, Google определит координаты по адресу. Необязательно, но необходимо указать либо coordinates , либо любой из structured_address и unstructured_address .
Структурированный адрес	структурированный_адрес	НЕОБЯЗАТЕЛЬНО, может присутствовать только один из structured_address или unstructured_address , но не оба.
нить	неструктурированный_адрес	НЕОБЯЗАТЕЛЬНО, может присутствовать только один из structured_address или unstructured_address , но не оба.

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

Структурированный адрес

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	адрес улицы	НЕОБХОДИМЫЙ. Максимальная длина: 200. Адрес, включая номер дома и любые другие компоненты, которые невозможно указать в более конкретных полях. Оно не должно включать название места или компании, которое необходимо указать отдельно, используя поле name в разделе PlaceInfo . Он также не должен включать почтовый индекс, населенный пункт или страну, поскольку они должны быть указаны в соответствующих полях.
нить	местность	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная длина: 80. Местоположение, обычно относится к части адреса, посвященной городу. В регионах мира, где населенные пункты не определены четко или не вписываются в эту структуру, оставьте пустым.
нить	административная_область	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная длина: 80. Высшее административное подразделение, используемое для почтовых адресов конкретной страны или региона. Это может быть штат, регион, провинция, область, префектура. Это может быть аббревиатура или полное название, в зависимости от того, как обычно представлен регион в почтовых адресах конкретной страны.
нить	Почтовый индекс	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная длина: 30. Почтовый индекс или почтовый индекс. Требуется, если страна поддерживает почтовые индексы, в противном случае его следует оставить пустым.
нить	код_страны	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная длина: 2. Код страны, определенный Unicode «CLDR», основанный на стандарте ISO 3166 альфа-2. См. документацию Unicode .

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

Локализованныйтекстсет

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
повторенный google.type.LocalizedText	локализованные_тексты	Локализованные текстовые значения для каждой локали.

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

Политика отмены

Прото Замечания по реализации Примеры

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

Определяет одно условие возврата. Несколько условий возврата можно использовать вместе, чтобы описать «этапы возврата» как различную продолжительность до начала услуги.

Тип	Поле	Примечания
Условия возврата	условия_возврата	НЕОБЯЗАТЕЛЬНО, максимальное количество условий возврата: 10.

Условия возврата

Тип	Поле	Примечания
uint32	min_duration_before_start_time_sec	Необязательный. Продолжительность в секундах до времени начала, до которой клиент сможет получить возмещение части стоимости услуги, указанной в refund_percent . Если параметр не установлен или установлен на 0, услугу можно отменить в любое время.
uint32	возврат_процента	НЕОБЯЗАТЕЛЬНЫЙ. Процент, который может быть возвращен, если бронирование услуги отменено как минимум за min_duration_before_start_time до времени начала услуги, в диапазоне [0, 100]. Если этот параметр не установлен или установлен на 0, оплата за услугу не подлежит возврату. Если установлено значение 100, эта услуга подлежит полному возврату.
google.type.Money	возврат_комиссии	НЕОБЯЗАТЕЛЬНЫЙ. При возврате удерживается фиксированная комиссия. Может использоваться отдельно или в сочетании с refund_percent . В последнем случае сначала применяется процент возврата, затем удерживается комиссия.

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

,

Фид товаров – это основной способ предоставить Google список товаров, которые нужно сделать, которые будут отображаться на различных платформах Google.

Объект ProductFeed состоит из одного объекта FeedMetadata и нуля или более объектов Product . Если во всех шардах не указан ни один Product , то все продукты удаляются.

Фид продукта

Прото Замечания по реализацииПримеры

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

Тип	Поле	Примечания
Метаданные фида	фид_метаданные	НЕОБХОДИМЫЙ. Метаданные для этого фида.
повторенный Продукт	продукты	НЕОБЯЗАТЕЛЬНЫЙ. Если параметр отключен во всех сегментах, все товары удаляются. feed_metadata/max_removal_share может потребоваться, если удаляется большое количество продуктов.

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

Метаданные фида

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
uint32	shard_id	ТРЕБУЕТСЯ, когда total_shards_count > 1. С нуля. Осколки не нужно передавать по порядку. Обработка начинается только после загрузки полного набора шардов.
uint32	total_shards_count	ОБЯЗАТЕЛЬНО, должно быть >= 1.
uint64	одноразовый номер	ТРЕБУЕТСЯ, когда total_shards_count > 1. Должен быть одинаковым для всех осколков в рамках передачи.
перечисление	инструкция_обработки	НЕОБХОДИМЫЙ. PROCESS_AS_SNAPSHOT — единственное поддерживаемое значение.
двойной	max_removal_share	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная доля активных товаров, которые можно удалить при загрузке. Если в ходе этой передачи будет удалено больше продуктов, вся передача будет отклонена. Это гарантия от непреднамеренного удаления значительной части инвентаря. Можно установить значение 1.0, чтобы разрешить полное удаление инвентаря.

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

Продукт

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	ОБЯЗАТЕЛЬНО, максимальная длина 255. Уникальная строка, идентифицирующая продукт. Допустимые символы: буквенно-цифровые, _ и -.
Локализованныйтекстсет	заголовок	ОБЯЗАТЕЛЬНО, рекомендуемая длина <= 50, максимальная длина 150 символов. Более подробную информацию см. в разделе «Рекомендации по названиям и описаниям» .
Локализованныйтекстсет	описание	РЕКОМЕНДУЕТСЯ, рекомендуемая длина <= 10 000, максимальная длина 16 000 символов. Более подробную информацию см. в разделе «Рекомендации по названиям и описаниям» .
повторенный Текстовая функция	Product_features	РЕКОМЕНДУЕТСЯ, максимальное количество функций: 100.
Рейтинг	рейтинг	РЕКОМЕНДУЕТСЯ. Настоятельно рекомендуется предоставлять рейтинги, поскольку продукты, отображающие рейтинги, приводят к более высокому рейтингу кликов.
повторенный СМИ	родственные_медиа	РЕКОМЕНДУЕТСЯ, максимальное количество носителей: 30. Настоятельно рекомендуется предоставить более одного изображения. Подробное руководство по изображениям см. в разделе Рекомендации по изображениям.
логическое значение	use_media_order	НЕОБЯЗАТЕЛЬНЫЙ Подскажите Google, что при выборе изображения для показа следует учитывать порядок, в котором связанные медиа-файлы перечислены в ленте.
повторенный Вариант	параметры	ОБЯЗАТЕЛЬНО, максимальное количество опций: 20 У каждого продукта должен быть хотя бы один вариант продукта.
Оператор	оператор	НЕОБЯЗАТЕЛЬНЫЙ.
перечисление	устарел тип_инвентаря	НЕОБЯЗАТЕЛЬНЫЙ. INVENTORY_TYPE_OFFICIAL можно установить только в продуктах, которые ссылаются на официальный сайт билетов интересующей точки. Возможность установки этого значения активируется только после проверки приемлемости. Это поле устарело и заменено новым повторяющимся полем Inventory_types.
повторенный	инвентарные_типы	НЕОБЯЗАТЕЛЬНЫЙ. Повторяющийся список уникальных типов инвентаря, к которым принадлежит этот товар. INVENTORY_TYPE_OFFICIAL можно установить только в продуктах, которые ссылаются на официальный сайт билетов интересующей точки. Возможность установки этого значения активируется только после проверки приемлемости. INVENTORY_TYPE_OPERATOR_DIRECT можно установить только в продуктах, которые ссылаются на сайт туроператора. Возможность установки этого значения активируется только после проверки приемлемости.
перечисление	тип_подтверждения	НЕОБЯЗАТЕЛЬНЫЙ.
Тип выполнения	тип_выполнения	РЕКОМЕНДУЕТСЯ. Если установлено, хотя бы одно поле в fulfillment_rype должно иметь значение true. Устанавливает способы получения документа для подтверждения бронирования. Возможны комбинации, например мобильный + распечатанный или распечатанный дома + возможен самовывоз.
Локализованныйтекстсет	название бренда	максимальная длина 100. Название бренда, которое должно отображаться на продукте, заменяет устаревшее `operator/name`. Можно установить только одно из двух значений.

{
  "id": "product-1",
  "title": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans bike tour"
          },
          {
              "language_code": "es",
              "text": "Tour en bicicleta por Dans"
          },
          {
              "language_code": "zh-HK",
              "text": "丹斯自行車之旅"
          }
      ]
  },
  "description": {
    "localized_texts": [
        {
            "language_code": "en",
            "text": "<p>A very fun bike tour<p>"
        },
        {
            "language_code": "es",
            "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
        },
        {
            "language_code": "zh-HK",
            "text": "<p>一個非常有趣的自行車之旅.</p>"
        }
    ]
  },
  "brand_name": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans Bikes"
          }
      ]
  },
  "rating": {
      "average_value": 4.6,
      "rating_count": 192
  },
  "product_features": [{
    "feature_type": "TEXT_FEATURE_INCLUSION",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
          {
              "language_code": "es",
              "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
          },
          {
              "language_code": "zh-HK",
              "text": "<p>一個非常有趣的自行車之旅.</p>"
          }
      ]
    }
  },{
    "feature_type": "TEXT_FEATURE_HIGHLIGHT",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
              },
              {
                  "language_code": "es",
                  "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
              },
              {
                  "language_code": "zh-HK",
                  "text": "<p>一個非常有趣的自行車之旅.</p>"
              }
          ]
      }
  },{
    "feature_type": "TEXT_FEATURE_MUST_KNOW",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
            {
                "language_code": "es",
                "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
            },
            {
                "language_code": "zh-HK",
                "text": "<p>一個非常有趣的自行車之旅.</p>"
            }
        ]
      }
  }],
  "options": [{
    "id": "option-1",
    "title": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "Sunset tour"
            },
            {
                "language_code": "es",
                "text": "Tour al atardecer"
            },
            {
                "language_code": "zh-HK",
                "text": "日落之旅"
            }
        ]
    },
    "landing_page": {
        "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
    },
    "cancellation_policy": {
        "refund_conditions": [
            {
                "min_duration_before_start_time_sec": 86400,
                "refund_percent": 100
            }
        ]
    },
    "option_categories": [
        {
            "label": "sports"
        },
        {
            "label": "bike-tours"
        }
    ],
    "related_locations": [
        {
            "location": {
                "location": {
                    "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        },
        {
            "location": {
                "location": {
                    "lat_lng": {
                        "latitude": 53.339688,
                        "longitude": 6.236688
                    }
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        }
    ],
    "price_options": [
        {
            "id": "option-1-adult",
            "title": "Adult (14+)",
            "price": {
                "currency_code": "EUR",
                "units": 20
            },
            "fees_and_taxes": {
                "per_ticket_fee": {
                    "currency_code": "EUR",
                    "units": 1
                },
                "per_ticket_tax": {
                    "currency_code": "EUR",
                    "units": 1
                }
            }
        }
    ]},{
      "id": "option-2",
      "title": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Sunrise tour"
              },
              {
                  "language_code": "es",
                  "text": "Tour al amanecer"
              },
              {
                  "language_code": "zh-HK",
                  "text": "日出之旅"
              }
          ]
      },
      "landing_page": {
          "url": "https://www.danstour.com/sunrise?language={lang}&currency={currency}"
      },
      "cancellation_policy": {
          "refund_conditions": [
              {
                  "min_duration_before_start_time_sec": 86400,
                  "refund_percent": 100
              }
          ]
      },
      "option_categories": [
          {
              "label": "sports"
          },
          {
              "label": "bike-tours"
          }
      ],
      "related_locations": [
          {
              "location": {
                  "location": {
                      "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                  }
              },
              "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
          }
      ],
      "price_options": [
          {
              "id": "option-2-adult",
              "title": "Adult (14+)",
              "price": {
                  "currency_code": "EUR",
                  "units": 20,
                  "nanos": 0
              }
          }
      ],
      "meeting_point": {
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          },
          "description": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Sunrise tour"
                  },
                  {
                      "language_code": "es",
                      "text": "Tour al amanecer"
                  },
                  {
                      "language_code": "zh-HK",
                      "text": "日出之旅"
                  }
              ]
          }
      }
    }
  ],
  "related_media": [
      {
          "url": "http://www.danstour.com/photo1.jpg",
          "type": "MEDIA_TYPE_PHOTO"
      },
      {
          "url": "http://www.danstour.com/photo2.jpg",
          "type": "MEDIA_TYPE_PHOTO",
          "attribution": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Dans Photos"
                  }
              ]
          }
      }
  ],
  "operator": {
      "name": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Dans Bikes"
              }
          ]
      },
      "phone_number": "01234567",
      "locations": [{
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          }
        }]
  },
  "inventory_types": ["INVENTORY_TYPE_OPERATOR_DIRECT"]
}

Вариант

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	НЕОБХОДИМЫЙ. Идентификатор варианта. Должно быть уникальным внутри продукта.
Локализованныйтекстсет	заголовок	ОБЯЗАТЕЛЬНО, рекомендуемая длина: 50, максимальная длина: 150 символов. Если имеется только один вариант, название варианта может совпадать с названием продукта. Если представлено несколько вариантов продукта, заголовок должен быть уникальным для каждого варианта. Более подробную информацию см. в разделе «Рекомендации по названиям и описаниям» .
Локализованныйтекстсет	описание	РЕКОМЕНДУЕТСЯ, рекомендуемая длина: 10000, максимальная длина: 16000. Более подробную информацию см. в разделе «Рекомендации по названиям и описаниям» .
ДипЛинк	целевая_страница	НЕОБХОДИМЫЙ. Должен содержать кнопку или ссылку для бронирования продукта. Более подробную информацию можно найти в разделе «Рекомендации по созданию целевых страниц» .
ДипЛинк	Landing_page_list_view	РЕКОМЕНДУЕТСЯ. Ссылка на просмотр списка доступных билетов и туров на более высоком уровне, где этот вариант, возможно, будет заметно показан среди других вариантов. Более подробную информацию можно найти в разделе «Рекомендации по созданию целевых страниц» .
повторенный Текстовая функция	option_features	ДОПОЛНИТЕЛЬНО, максимальное количество функций: 100. Не следует дублировать детали уровня продукта.
Политика отмены	cancel_policy	РЕКОМЕНДУЕТСЯ.
повторенный Категория	option_categories	Необязательно, максимальное количество категорий: 100. Соответствующие категории для этой опции. Дополнительные рекомендуемые значения см. в документации по категории продукта .
повторенный СвязанноеМестоположение	связанное_местоположение	РЕКОМЕНДУЕТСЯ, максимальное количество локаций: 100. Предоставление точного списка связанных местоположений чрезвычайно важно для того, чтобы продукт отображался в наиболее подходящих местах, однако чрезмерное количество тегов или предоставление точных данных приводит к удалению продукта. Для получения более подробной информации см. Путеводитель по местоположению и достопримечательностям .
логическое значение	base_ticket	НЕОБЯЗАТЕЛЬНЫЙ. Используется для указания, является ли опция продукта базовым входным билетом.
повторенный ЦенаОпция	цена_опции	ОБЯЗАТЕЛЬНО, минимум 1. Все возможные цены на этот вариант. Примечание. Поддерживается только цена для взрослых. Если было предоставлено несколько вариантов цен, будет использоваться первая цена, которая прошла проверку географических ограничений. Для групповых билетов вместо этого необходимо использовать полную стоимость всей группы.
uint32	продолжительность_сек	НЕОБЯЗАТЕЛЬНЫЙ. Продолжительность действия опции в секундах, где это применимо, например, для экскурсий или прогулок на лодке. Это должно отражать продолжительность опыта (а не срок действия).
повторенный Язык	языки	РЕКОМЕНДУЕТСЯ, максимальное количество языков: 100. Языки, на которых доступна опция. Когда конечному пользователю важно понимать язык и/или читать на нем, чтобы получить удовольствие от работы. Например, для экскурсии.
Расположение	место встречи	НЕОБЯЗАТЕЛЬНЫЙ. Добавляйте только там, где это уместно и полезно, например, место, где участник встретится с гидом, чтобы начать пешеходную экскурсию, или место, где участника заберут для экскурсии по городу, пристань, с которой начнется круиз.

{
  "id": "option-1",
  "title": {
    "localized_texts": [
    {
            "language_code": "en",
            "text": "Sunset tour"
        },
        {
            "language_code": "es",
            "text": "Tour al atardecer"
        },
        {
            "language_code": "zh-HK",
            "text": "日落之旅"
        }
    ]
  },
  "landing_page": {
      "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
  },
  "cancellation_policy": {
      "refund_conditions": [
          {
              "min_duration_before_start_time_sec": 86400,
              "refund_percent": 100
          }
      ]
  },
  "option_categories": [
      {
          "label": "sports"
      },
      {
          "label": "bike-tours"
      }
  ],
  "related_locations": [
      {
          "location": {
              "location": {
                  "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      },
      {
          "location": {
              "location": {
                  "lat_lng": {
                      "latitude": 53.339688,
                      "longitude": 6.236688
                  }
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      }
  ],
  "price_options": [
      {
          "id": "option-1-adult",
          "title": "Adult (14+)",
          "price": {
              "currency_code": "EUR",
              "units": 20
          },
          "fees_and_taxes": {
              "per_ticket_fee": {
                  "currency_code": "EUR",
                  "units": 1
              },
              "per_ticket_tax": {
                  "currency_code": "EUR",
                  "units": 1
              }
          }
      }
  ]
}

Текстовая функция

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
перечисление	Feature_type	НЕОБХОДИМЫЙ. Тип объекта, возможные значения: TEXT_FEATURE_INCLUSION : функция является включенной. TEXT_FEATURE_EXCLUSION : функция является исключением. TEXT_FEATURE_HIGHLIGHT : функция является выделенной. TEXT_FEATURE_MUST_KNOW : функция, которую необходимо знать. TEXT_FEATURE_SAFETY_INFORMATION : функция представляет информацию о мерах безопасности.
Локализованныйтекстсет	ценить	ОБЯЗАТЕЛЬНО, рекомендуемая длина <= 1000 символов, максимальная длина: 2000. Поддерживаемые теги форматирования HTML: br,strong,em,i Поддерживаются только четыре упомянутых тега. br можно использовать для разрыва строк в абзацах, а strong / em / i — для выделения важного текста. Любые другие теги фраз будут игнорироваться. Все остальные теги и пользовательские стили запрещены и будут удалены. Любые URL-адреса, привязки и ссылки будут удалены и никогда не будут отображаться конечным пользователям.

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

Рейтинг

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
двойной	среднее_значение	НЕОБЯЗАТЕЛЬНЫЙ. Среднее значение рейтинга. Значение должно находиться в диапазоне [1, 5] и может быть опущено тогда и только тогда, когда rating_count равен нулю.
uint64	рейтинг_счет	НЕОБХОДИМЫЙ. Количество рейтингов, использованных при расчете значения.

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

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

СМИ

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	URL	ОБЯЗАТЕЛЬНО, максимальная длина: 2000. URL-адрес этого медиа-источника. Google будет сканировать медиафайлы, размещенные по этому URL.
перечисление	тип	НЕОБХОДИМЫЙ. Тип этого медиа-источника. Возможные значения: MEDIA_TYPE_PHOTO : указывает, что медиафайл, предоставленный URL-адресом, является фотографией.
Локализованныйтекстсет	атрибуция	ДОПОЛНИТЕЛЬНО, рекомендуемая длина: 1000, максимальная длина: 2000. Атрибутивная информация об источнике СМИ. Обратите внимание: если атрибуция должна отображаться в средствах массовой информации, чтобы отдать должное фотографу или агентству, это поле должно быть установлено.

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

Категория

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	этикетка	НЕОБХОДИМЫЙ. Список допустимых значений см. в документации по категории продукта .

{
    "label": "sports"
}

СвязанноеМестоположение

Прото Замечания по реализации Примеры

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

Определяет связь между опцией и местоположением.

Тип	Поле	Примечания
Расположение	расположение	НЕОБХОДИМЫЙ. Местоположение, связанное с опцией. Это может быть POI (например, Эйфелева башня), район (например, Старый город) или адрес/произвольная точка на карте.
перечисление	тип_отношения	НЕОБХОДИМЫЙ. Тип связи опции для данного местоположения. Возможные значения: RELATION_TYPE_RELATED_NO_ADMISSION : Местоположение связано, но отношение не позволяет войти, или вход не имеет значения, например, местоположение представляет собой площадь, выделенную на обзорной экскурсии по городу. RELATION_TYPE_ADMISSION_TICKET : связь предоставляет доступ к этому связанному местоположению. RELATION_TYPE_SUPPLEMENTARY_ADDON : Связь объявляет дополнительную услугу, которая не позволяет пользователю попасть в соответствующее место, например парковочный талон или временную выставку.

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

ДипЛинк

Прото Замечания по реализации Примеры

// Deep link definition. Can include value parameters that will be expanded on
// serve time.
message DeepLink {
  // Landing page URL template for desktop. If both `url` and `localized_url`
  // are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Either `url` or `localized_url` is required.
  string url = 1;

  // Localized landing page URL template for desktop. If both `url` and
  // `localized_url` are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Max number of locales: 50.
  // Either `url` or `localized_url` is required.
  LocalizedTextSet localized_url = 3;

  reserved 2, 4;
}

Определение глубокой ссылки. Может включать параметры значений, которые будут расширены во время обслуживания.

Тип	Поле	Примечания
нить	URL	НЕОБЯЗАТЕЛЬНО, максимальная длина: 2000. Шаблон URL-адреса целевой страницы для ПК. Требуется либо URL, либо localized_url.
Локализованныйтекстсет	localized_url	НЕОБЯЗАТЕЛЬНО, максимальная длина: 2000, максимальное количество локальных пользователей 50. Шаблон URL-адреса локализованной целевой страницы для настольных компьютеров. Если указаны и url , и localized_url , первый используется в качестве запасного варианта, если ни один URL-адрес не соответствует языковому стандарту пользователя. Если url недоступен и язык не указан, используется URL-адрес на английском языке.

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

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

Оператор

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
Локализованныйтекстсет	имя [устарело]	ДОПОЛНИТЕЛЬНО, рекомендуемая длина: 50, максимальная длина: 100. Торговая марка продавца данного товара. OTA должны установить это как бренд OTA. Это поле устарело и заменено на «название бренда» в разделе «Продукты».
Локализованныйтекстсет	google_business_profile_name	ОБЯЗАТЕЛЬНО, максимальная длина: 100. Название компании оператора, зарегистрированное в профиле компании Google и отображаемое на Картах Google. Это поле обязательно для участия в модуле бронирования оператора.
нить	номер телефона	ДОПОЛНИТЕЛЬНО, максимальная длина: 64. Телефон оператора. Предпочитайте полный международный формат телефонного номера.
повторенный Расположение	локации	НЕОБЯЗАТЕЛЬНО, максимальное количество: 1. Юридический адрес оператора. Если используется строка адреса, включите название компании как часть строки адреса. Например, «название компании, почтовый адрес». Чтобы активировать модуль бронирования оператора, компания оператора должна быть доступна для поиска на Картах Google. Оператор должен зарегистрировать профиль компании в Google, если его компания не может быть найдена на Картах Google.

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

Язык

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	код	Код языка, совместимый с BCP-47, например «en» или «de-CH».

{
    "code": "de-CH"
}

ЦенаОпция

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	ОБЯЗАТЕЛЬНО, максимальная длина: 255. Уникальный идентификатор в рамках ценового набора.
нить	заголовок	ОБЯЗАТЕЛЬНО, максимальная длина: 150. Краткое описание варианта цены, например «Взрослый будний день».
google.type.Money	цена	ОБЯЗАТЕЛЬНО, если is_free имеет значение false. Значение цены должно соответствовать окончательной цене на странице оформления заказа, включая все налоги и сборы, см. ценовую политику. Валюта будет конвертирована в валюту пользователя при рендеринге.
логическое значение	is_free	НЕОБЯЗАТЕЛЬНО, по умолчанию — false. Вход или билет бесплатный. Должно быть установлено значение true для вариантов с нулевой ценой.
повторенный Геокритерион	geo_criteria	НЕОБЯЗАТЕЛЬНЫЙ. Список географических регионов, к которым применима данная цена. Если пусто, применимо ко всем местоположениям.
повторенный ЦенаКомиссионные и налоги	сборы_и_налоги	НЕОБЯЗАТЕЛЬНЫЙ. Разбивка сборов и налогов, включенных в цену.

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

Геокритерион

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	код_страны	НЕОБХОДИМЫЙ. Двухбуквенный код страны, определенный в ISO 3166-1.
логическое значение	is_negative	НЕОБЯЗАТЕЛЬНЫЙ. Если true, критерий отрицательный (код страны исключается).

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

ЦенаКомиссионные и налоги

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
google.type.Money	per_ticket_fee	НЕОБЯЗАТЕЛЬНЫЙ. Плата за бронирование включена в окончательную цену продукта за один билет.
google.type.Money	per_ticket_tax	НЕОБЯЗАТЕЛЬНЫЙ. Государственные налоги включены в конечную цену продукта за один билет.

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

Расположение

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
Геолокация	расположение	НЕОБЯЗАТЕЛЬНО, должно присутствовать хотя бы одно из названий местоположения или описания. Географическое положение.
Локализованныйтекстсет	описание	НЕОБЯЗАТЕЛЬНО, рекомендуемая длина: 1000, максимальная длина: 2000, должно присутствовать хотя бы одно местоположение или описание. Дополнительное описание в удобочитаемой форме типа «С левой стороны фонтана на Дворцовой площади».

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

Геолокация

Более подробную информацию о каждом типе подсказок см. в руководстве по использованию.

Прото Замечания по реализации Примеры

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

Тип	Поле	Примечания
нить	Place_id	НЕОБЯЗАТЕЛЬНО, должно присутствовать ровно одно из place_id , address , place_info , business_profile_id или lat_lng . PlaceId, как определено API Places . Уникально идентифицирует POI в Google. Его можно получить с помощью конечных точек Places API, например «Поиск мест» или «Автозаполнение мест», или вручную с помощью инструмента «Найти совпадения местоположений» в Центре дел.
нить	адрес	НЕОБЯЗАТЕЛЬНО, должно присутствовать ровно одно из place_id , address , place_info , business_profile_id или lat_lng . УСТАРЕЛО. Устаревший однострочный адрес. Максимальная длина: 200. Предполагается, что компоненты будут разделены запятыми, причем первым компонентом будет название места, отображаемое в Google. Для более высокой точности сопоставления используйте адрес места, указанный в Google.
Информация о месте	место_информация	НЕОБЯЗАТЕЛЬНО, должно присутствовать ровно одно из place_id , address , place_info , business_profile_id или lat_lng . Структурированная информация о месте.
uint64	business_profile_id	НЕОБЯЗАТЕЛЬНО, должно присутствовать ровно одно из place_id , address , place_info , business_profile_id или lat_lng . Идентификатор профиля компании, указанный на странице настроек профиля компании в Google. Используйте это поле при поиске местоположений непосредственно у владельца места, который имеет доступ к профилю компании в Google и может предоставить такой идентификатор.
google.type.LatLng	lat_lng	НЕОБЯЗАТЕЛЬНО, должно присутствовать ровно одно из place_id , address , place_info , business_profile_id или lat_lng . Географические координаты. Это поле можно использовать только для определения города или географического региона, поскольку оно слишком неоднозначно для идентификации конкретного места или предприятия. Вместо этого используйте place_info для сопоставления определенного места по имени и координатам.

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

Информация о месте

Прото Замечания по реализации Примеры

message PlaceInfo {
  // Place or business name.
  // For higher matching accuracy, this should be the same as the name shown on
  // Google for the place. For places with a claimed Google Business Profile,
  // this should be the same as the business name configured in the business
  // profile.
  // Max length: 100.
  // Required.
  string name = 1;

  // Phone number, including the international prefix.
  // For higher matching accuracy, this should be the same as the phone number
  // shown on Google for the place.
  // It can include commonly used separator characters.
  // Examples: "[phone]", "[phone]".
  // Max length: 30.
  // Optional.
  string phone_number = 2;

  // Website URL shown on Google for the place, preferably the URL linked from
  // the business listing in Google Maps or Search for the place.
  // Max length: 1000.
  // Optional.
  string website_url = 3;

  // Geographic coordinates of the place.
  // If left empty, Google will infer the coordinates from the address.
  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  google.type.LatLng coordinates = 4;

  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  oneof address_type {
    // Structured address.
    // Prefer this format whenever possible for higher matching accuracy.
    StructuredAddress structured_address = 5;

    // Unstructured address.
    // It should not include the place or business name, which must instead be
    // provided separately using the `name` field.
    //
    // Examples:
    // - `name`: "Colosseum", `unstructured_address`: "Piazza del Colosseo, 1,
    // 00184 Roma RM, Italy".
    // - `name`: "The British Museum", `unstructured_address`: "Great Russell
    // St, London WC1B 3DG, United Kingdom".
    //
    // Max length: 400.
    string unstructured_address = 6;
  }
}

Тип	Поле	Примечания
нить	имя	НЕОБХОДИМЫЙ. Максимальная длина: 300. Место или название компании. Для более высокой точности соответствия оно должно совпадать с названием места, отображаемым в Google. Для мест с заявленным профилем компании в Google оно должно совпадать с названием компании, настроенным в профиле компании.
нить	номер телефона	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная длина: 30. Номер телефона, включая международный префикс. Для более высокой точности сопоставления он должен совпадать с номером телефона, указанным в Google для этого места. Он может включать часто используемые символы-разделители. Примеры: «[phone]», «[phone]».
нить	URL-адрес_сайта	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная длина: 1000. URL-адрес веб-сайта, указанный в Google для этого места, предпочтительно URL-адрес, указанный в списке компаний на Картах Google или в Поиске этого места.
google.type.LatLng	координаты	НЕОБЯЗАТЕЛЬНЫЙ. Географические координаты места. Если оставить пустым, Google определит координаты по адресу. Необязательно, но необходимо указать либо coordinates , либо любой из structured_address и unstructured_address .
Структурированный адрес	структурированный_адрес	НЕОБЯЗАТЕЛЬНО, может присутствовать только один из structured_address или unstructured_address , но не оба.
нить	неструктурированный_адрес	Необязательно, именно один из structured_address или unstructured_address может присутствовать, никогда не оба.

"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

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	адрес улицы	НЕОБХОДИМЫЙ. Макс. Длина: 200. Уличный адрес, включая номер дома и любой другой компонент, который не может быть предоставлен с использованием более конкретных полей. Он не должен включать в себя место или название предприятия, которое вместо этого должно быть предоставлено отдельно, используя поле name под PlaceInfo . Он также не должен включать почтовый кодекс, местонахождение или страну, поскольку они должны быть предоставлены с использованием соответствующих полей.
нить	местность	НЕОБЯЗАТЕЛЬНЫЙ. Макс. Длина: 80. Местонахождение, обычно относящаяся к городу или городской части адреса. В регионах мира, где населенные пункты не хорошо определены или плохо вписываются в эту структуру, оставляйте пустым.
нить	Administrative_area	НЕОБЯЗАТЕЛЬНЫЙ. Макс. Это может быть государство, регион, провинция, область, префектура. Это может быть аббревиатура или полное имя, в зависимости от того, как регион обычно представлен в почтовых адресах конкретной страны.
нить	Почтовый индекс	НЕОБЯЗАТЕЛЬНЫЙ. Макс. Длина: 30. Почтовый код или почтовый индекс. Требуется, если страна поддерживает почтовые коды, в противном случае она должна быть пустой.
нить	Country_code	НЕОБЯЗАТЕЛЬНЫЙ. Макс. Длина: 2. Код страны, как определено Unicode "CLDR", на основе стандарта ISO 3166 Alpha-2. Смотрите документацию Unicode .

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

LocalizedTextSet

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
повторенный Google.Type.LocalizedText	локализованный_texts	Первые локализованные текстовые значения.

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

Отменаполитика

Прото Примечания к реализации Примеры

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

Определяет одно условие возврата. Многочисленные условия возврата могут быть использованы вместе для описания «шагов возврата» как различные продолжительности до времени начала службы.

Тип	Поле	Примечания
Возврат	refund_conditions	Необязательно, максимальное количество условий возврата: 10.

Возврат

Тип	Поле	Примечания
uint32	min_duration_before_start_time_sec	Необязательный. Продолжительность за несколько секунд до начала времени, пока клиент не сможет получить возмещение за часть стоимости услуги, указанную в refund_percent . Когда вы не установку или установку на 0, услуга может быть отменена в любое время.
uint32	refund_percent	НЕОБЯЗАТЕЛЬНЫЙ. Процент, который может быть возвращен, до тех пор, пока бронирование услуг отменяется, по крайней мере, min_duration_before_start_time до времени начала службы, в диапазоне [0, 100]. Когда вы не установку в 0, служба не подлежит возврату. Когда установлено в 100, эта служба полностью подлежит возврату.
Google.Type.money	refund_fee	НЕОБЯЗАТЕЛЬНЫЙ. Фиксированная плата, вычтенная при возмещении. Можно использовать отдельно или в сочетании с refund_percent . В последнем случае процент возмещения применяется сначала, а затем вычитается плата.

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

,

Корм продукта является основным способом предоставить Google список вещей, которые можно сделать продуктами, которые должны отображаться на различных поверхностях Google.

Объект ProductFeed состоит из одного объекта FeedMetadata и нулевого или более объектов Product . Если во всех осколках не предоставляется Product , то все продукты удаляются.

Продукт

Прото Примечания к реализацииПримеры

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

Тип	Поле	Примечания
FEEDMETADATA	FEED_METADATA	НЕОБХОДИМЫЙ. Метаданные для этого корма.
повторенный Продукт	продукты	НЕОБЯЗАТЕЛЬНЫЙ. Когда не установлены во всех осколках, все продукты удаляются. feed_metadata/max_removal_share возможно, потребуется установить при удалении большого количества продуктов.

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

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
uint32	shard_id	Требуется, когда total_shards_count > 1. Основанная на ноль. Шарсы не нужно переносить по порядку. Обработка начинается только после того, как был загружен полный набор осколков.
uint32	total_shards_count	Требуется, должно быть> = 1.
uint64	нон	Требуется, когда total_shards_count > 1. Должен быть одинаковым для всех осколков в рамках передачи.
перечисление	Обработка_инстрокция	НЕОБХОДИМЫЙ. PROCESS_AS_SNAPSHOT является единственным поддерживаемым значением.
двойной	max_removal_share	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная доля активных продуктов, которые могут быть удалены при загрузке. Если с помощью этой передачи удаляется больше продуктов, вся передача отклоняется. Это защита от непреднамеренного снесения значительной части инвентаря. Может быть установлен на 1.0, чтобы позволить полный инвентарь.

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

Продукт

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	Требуется, максимальная длина 255. Уникальная строка, которая идентифицирует продукт. Разрешенные символы являются буквенно -цифровыми, _ и -.
LocalizedTextSet	заголовок	Требуется, рекомендуемая длина <= 50, максимальная длина 150 символов. См. Название и описание Руководства для более подробной информации.
LocalizedTextSet	описание	Рекомендуемая, рекомендуемая длина <= 10000, максимальная длина 16000 символов. См. Название и описание Руководства для более подробной информации.
повторенный Текстовое отверстие	product_features	Рекомендуется, максимальное количество функций: 100.
Рейтинг	рейтинг	РЕКОМЕНДУЕТСЯ. Предоставление рейтингов настоятельно рекомендуется, поскольку продукты, отображающие рейтинги, приводят к более высокой скорости прохождения кликов.
повторенный СМИ	Связанная_медия	Рекомендуется, максимальное количество средств массовой информации: 30 Предоставление более одного изображения настоятельно рекомендуется. См. Руководство по изображениям для подробного руководства по изображениям.
логическое значение	use_media_order	НЕОБЯЗАТЕЛЬНЫЙ Намекните на Google, что порядок, в котором связанные носители указаны в канале, следует учитывать при выборе того изображения.
повторенный Вариант	параметры	Требуется, максимальное количество опций: 20 Каждый продукт должен иметь хотя бы один вариант продукта.
Оператор	оператор	НЕОБЯЗАТЕЛЬНЫЙ.
перечисление	устарел inventory_type	НЕОБЯЗАТЕЛЬНЫЙ. INVENTORY_TYPE_OFFICIAL может быть установлен только в продуктах, которые ссылаются на официальный сайт билета, представляющий интерес. Возможность установить это значение включена только после обзора приемлемости. Это поле устарело и заменено новым повторным полем Inventory_Types.
повторенный	inventory_types	НЕОБЯЗАТЕЛЬНЫЙ. Повторный список уникальных типов инвентаризации. Этот продукт принадлежит. INVENTORY_TYPE_OFFICIAL может быть установлен только в продуктах, которые ссылаются на официальный сайт билета, представляющий интерес. Возможность установить это значение включена только после обзора приемлемости. INVENTORY_TYPE_OPERATOR_DIRECT может быть установлен только в продуктах, которые ссылаются на сайт туроператора. Возможность установить это значение включена только после обзора приемлемости.
перечисление	Подтверждение_тип	НЕОБЯЗАТЕЛЬНЫЙ.
FulfillmentType	fulfillment_type	РЕКОМЕНДУЕТСЯ. Если установлено, по крайней мере одно поле в fulfillment_rype должно быть правдой. Устанавливает способы получить документ для подтверждения бронирования. Комбинации возможны, например, мобильные + напечатаны или напечатаны дома + личный пикап.
LocalizedTextSet	brand_name	Максимальная длина 100. Название бренда, которую продукт должен показывать, это заменяет теперь устаревший «оператор/имя». Только одно из двух значений может быть установлено.

{
  "id": "product-1",
  "title": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans bike tour"
          },
          {
              "language_code": "es",
              "text": "Tour en bicicleta por Dans"
          },
          {
              "language_code": "zh-HK",
              "text": "丹斯自行車之旅"
          }
      ]
  },
  "description": {
    "localized_texts": [
        {
            "language_code": "en",
            "text": "<p>A very fun bike tour<p>"
        },
        {
            "language_code": "es",
            "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
        },
        {
            "language_code": "zh-HK",
            "text": "<p>一個非常有趣的自行車之旅.</p>"
        }
    ]
  },
  "brand_name": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans Bikes"
          }
      ]
  },
  "rating": {
      "average_value": 4.6,
      "rating_count": 192
  },
  "product_features": [{
    "feature_type": "TEXT_FEATURE_INCLUSION",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
          {
              "language_code": "es",
              "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
          },
          {
              "language_code": "zh-HK",
              "text": "<p>一個非常有趣的自行車之旅.</p>"
          }
      ]
    }
  },{
    "feature_type": "TEXT_FEATURE_HIGHLIGHT",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
              },
              {
                  "language_code": "es",
                  "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
              },
              {
                  "language_code": "zh-HK",
                  "text": "<p>一個非常有趣的自行車之旅.</p>"
              }
          ]
      }
  },{
    "feature_type": "TEXT_FEATURE_MUST_KNOW",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
            {
                "language_code": "es",
                "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
            },
            {
                "language_code": "zh-HK",
                "text": "<p>一個非常有趣的自行車之旅.</p>"
            }
        ]
      }
  }],
  "options": [{
    "id": "option-1",
    "title": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "Sunset tour"
            },
            {
                "language_code": "es",
                "text": "Tour al atardecer"
            },
            {
                "language_code": "zh-HK",
                "text": "日落之旅"
            }
        ]
    },
    "landing_page": {
        "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
    },
    "cancellation_policy": {
        "refund_conditions": [
            {
                "min_duration_before_start_time_sec": 86400,
                "refund_percent": 100
            }
        ]
    },
    "option_categories": [
        {
            "label": "sports"
        },
        {
            "label": "bike-tours"
        }
    ],
    "related_locations": [
        {
            "location": {
                "location": {
                    "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        },
        {
            "location": {
                "location": {
                    "lat_lng": {
                        "latitude": 53.339688,
                        "longitude": 6.236688
                    }
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        }
    ],
    "price_options": [
        {
            "id": "option-1-adult",
            "title": "Adult (14+)",
            "price": {
                "currency_code": "EUR",
                "units": 20
            },
            "fees_and_taxes": {
                "per_ticket_fee": {
                    "currency_code": "EUR",
                    "units": 1
                },
                "per_ticket_tax": {
                    "currency_code": "EUR",
                    "units": 1
                }
            }
        }
    ]},{
      "id": "option-2",
      "title": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Sunrise tour"
              },
              {
                  "language_code": "es",
                  "text": "Tour al amanecer"
              },
              {
                  "language_code": "zh-HK",
                  "text": "日出之旅"
              }
          ]
      },
      "landing_page": {
          "url": "https://www.danstour.com/sunrise?language={lang}&currency={currency}"
      },
      "cancellation_policy": {
          "refund_conditions": [
              {
                  "min_duration_before_start_time_sec": 86400,
                  "refund_percent": 100
              }
          ]
      },
      "option_categories": [
          {
              "label": "sports"
          },
          {
              "label": "bike-tours"
          }
      ],
      "related_locations": [
          {
              "location": {
                  "location": {
                      "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                  }
              },
              "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
          }
      ],
      "price_options": [
          {
              "id": "option-2-adult",
              "title": "Adult (14+)",
              "price": {
                  "currency_code": "EUR",
                  "units": 20,
                  "nanos": 0
              }
          }
      ],
      "meeting_point": {
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          },
          "description": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Sunrise tour"
                  },
                  {
                      "language_code": "es",
                      "text": "Tour al amanecer"
                  },
                  {
                      "language_code": "zh-HK",
                      "text": "日出之旅"
                  }
              ]
          }
      }
    }
  ],
  "related_media": [
      {
          "url": "http://www.danstour.com/photo1.jpg",
          "type": "MEDIA_TYPE_PHOTO"
      },
      {
          "url": "http://www.danstour.com/photo2.jpg",
          "type": "MEDIA_TYPE_PHOTO",
          "attribution": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Dans Photos"
                  }
              ]
          }
      }
  ],
  "operator": {
      "name": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Dans Bikes"
              }
          ]
      },
      "phone_number": "01234567",
      "locations": [{
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          }
        }]
  },
  "inventory_types": ["INVENTORY_TYPE_OPERATOR_DIRECT"]
}

Вариант

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	НЕОБХОДИМЫЙ. Идентификатор опции. Должен быть уникальным в продукте.
LocalizedTextSet	заголовок	Требуется, рекомендуется длина: 50, максимум длина: 150 символов. Если есть только один вариант, заголовок опции может быть таким же, как и заголовок продукта. Если представлены несколько вариантов продукта, заголовок должен быть уникальным для этой опции. См. Название и описание Руководства для более подробной информации.
LocalizedTextSet	описание	Рекомендуемая, рекомендуемая длина: 10000, максимальная длина: 16000. См. Название и описание Руководства для более подробной информации.
Deeplink	landing_page	НЕОБХОДИМЫЙ. Должен содержать кнопку или ссылку, чтобы забронировать продукт. Смотрите руководящие принципы целевой страницы для более подробной информации.
Deeplink	landing_page_list_view	РЕКОМЕНДУЕТСЯ. Ссылка на просмотр списка на более высоком уровне доступных билетов и туров, заметно показывая этот вариант, возможно, среди других вариантов. Смотрите руководящие принципы целевой страницы для более подробной информации.
повторенный Текстовое отверстие	option_features	Необязательно, максимальное количество функций: 100. Не должно дублировать детали с уровня продукта.
Отменаполитика	Cancellation_policy	РЕКОМЕНДУЕТСЯ.
повторенный Категория	опция_категории	Необязательно, максимальное количество категорий: 100. Соответствующие категории для этого варианта. Обратитесь к документации категории продукта для дополнительных рекомендуемых значений.
повторенный Связанная разведка	Связанный_локация	Рекомендуется, максимальное количество мест: 100. Предоставление точного списка связанных мест чрезвычайно важно для того, чтобы продукт мог показать в наиболее важных местах, однако загрязнение или предоставление точных результатов данных при удалении продукта. Смотрите местоположение и руководство по интересам для получения более подробной информации.
логическое значение	base_ticket	НЕОБЯЗАТЕЛЬНЫЙ. Используется для указания, является ли опция продукта основным входным билетом.
повторенный Цена	PROCE_OPTIONS	Требуется, по крайней мере 1. Все возможные цены на этот вариант. Примечание: поддерживается только цена взрослого. Если было предоставлено несколько вариантов цены, будет использоваться первая цена, которая проходит проверку географического ограничения. Для групповых билетов полная цена всей группы должна использоваться вместо этого.
uint32	duration_sec	НЕОБЯЗАТЕЛЬНЫЙ. Продолжительность опциона в секундах, где это применимо, например, для экскурсий, поездок на лодке. Это должно отражать продолжительность опыта (не время достоверности).
повторенный Язык	языки	Рекомендуется, максимальное количество языков: 100. Языки, в которых есть вариант, доступен. Когда для конечного пользователя важно понимать и/или читать на языке, чтобы насладиться опытом. Например, для экскурсии.
Расположение	Meeting_point	НЕОБЯЗАТЕЛЬНЫЙ. Только добавьте, где актуально и полезно, например, место, где участник встретится с гидом, чтобы начать пешеходную экскурсию или место, где участник будет выбран на городской тур, док, где начнется круизная поездка.

{
  "id": "option-1",
  "title": {
    "localized_texts": [
    {
            "language_code": "en",
            "text": "Sunset tour"
        },
        {
            "language_code": "es",
            "text": "Tour al atardecer"
        },
        {
            "language_code": "zh-HK",
            "text": "日落之旅"
        }
    ]
  },
  "landing_page": {
      "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
  },
  "cancellation_policy": {
      "refund_conditions": [
          {
              "min_duration_before_start_time_sec": 86400,
              "refund_percent": 100
          }
      ]
  },
  "option_categories": [
      {
          "label": "sports"
      },
      {
          "label": "bike-tours"
      }
  ],
  "related_locations": [
      {
          "location": {
              "location": {
                  "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      },
      {
          "location": {
              "location": {
                  "lat_lng": {
                      "latitude": 53.339688,
                      "longitude": 6.236688
                  }
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      }
  ],
  "price_options": [
      {
          "id": "option-1-adult",
          "title": "Adult (14+)",
          "price": {
              "currency_code": "EUR",
              "units": 20
          },
          "fees_and_taxes": {
              "per_ticket_fee": {
                  "currency_code": "EUR",
                  "units": 1
              },
              "per_ticket_tax": {
                  "currency_code": "EUR",
                  "units": 1
              }
          }
      }
  ]
}

Текстовое отверстие

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
перечисление	feature_type	НЕОБХОДИМЫЙ. Тип функции, возможные значения: TEXT_FEATURE_INCLUSION : функция является включением. TEXT_FEATURE_EXCLUSION : функция является исключением. TEXT_FEATURE_HIGHLIGHT : функция является основным моментом. TEXT_FEATURE_MUST_KNOW : функция - это «должен знать». TEXT_FEATURE_SAFETY_INFORMATION : функция представляет информацию о мерах безопасности.
LocalizedTextSet	ценить	Требуется, рекомендуемая длина <= 1000 символов, максимальная длина: 2000. Поддерживаемые теги форматирования HTML: Br, Strong, Em, I Поддерживаются только четыре упомянутых тега. br может использоваться для разбивания линий в параграфах, а strong / em / i можно использовать для выделения важного текста. Любые другие фразы будут проигнорированы. Все остальные теги и пользовательские стили не допускаются и будут удалены. Любые URL-адреса, якоря и ссылки будут разделены и никогда не будут отображаться для конечных пользователей.

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

Рейтинг

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
двойной	Средний_value	НЕОБЯЗАТЕЛЬНЫЙ. Среднее значение оценки. Значение должно быть в диапазоне [1, 5] и может быть опущено тогда и только тогда, когда rating_count равен нулю.
uint64	rating_count	НЕОБХОДИМЫЙ. Количество рейтингов, используемых при расчете значения.

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

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

СМИ

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	URL	Требуется, максимальная длина: 2000. URL этого источника СМИ. Google будет ползти СМИ, размещенные на этом URL.
перечисление	тип	НЕОБХОДИМЫЙ. Тип этого источника медиа. Возможные значения: MEDIA_TYPE_PHOTO : Указывает, что носитель, предоставляемый URL -адресом, - это фото.
LocalizedTextSet	атрибуция	Необязательная, рекомендуемая длина: 1000, максимальная длина: 2000. Информация о атрибуции об источнике СМИ. Обратите внимание, что если атрибуция требуется для отображения со СМИ, чтобы отдать должное фотографу или агентству, это поле должно быть установлено.

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

Категория

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	этикетка	НЕОБХОДИМЫЙ. Обратитесь к документации категории продукта для списка действительных значений.

{
    "label": "sports"
}

Связанная разведка

Прото Примечания к реализации Примеры

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

Определяет связь между опцией и местоположением.

Тип	Поле	Примечания
Расположение	расположение	НЕОБХОДИМЫЙ. Местоположение, связанное с вариантом. Может быть POI (например, Эйфелевая башня), район (например, Старый город) или адрес / произвольная карта.
перечисление	отношение_type	НЕОБХОДИМЫЙ. Тип отношения опции для данного местоположения. Возможные значения: RELATION_TYPE_RELATED_NO_ADMISSION : местоположение связано, но соотношение не допускает приема или приема, не имеет значения, например, местоположение, является квадратом, выделенным в городском туре. RELATION_TYPE_ADMISSION_TICKET : Отношение предоставлено поступлением на это связанное место. RELATION_TYPE_SUPPLEMENTARY_ADDON : отношение объявляет дополнительную услугу, которая не попадает пользователю в соответствующее место, такое как парковочный билет или временная выставка.

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

Прото Примечания к реализации Примеры

// Deep link definition. Can include value parameters that will be expanded on
// serve time.
message DeepLink {
  // Landing page URL template for desktop. If both `url` and `localized_url`
  // are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Either `url` or `localized_url` is required.
  string url = 1;

  // Localized landing page URL template for desktop. If both `url` and
  // `localized_url` are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Max number of locales: 50.
  // Either `url` or `localized_url` is required.
  LocalizedTextSet localized_url = 3;

  reserved 2, 4;
}

Глубокая ссылка определение. Может включать параметры значения, которые будут расширены во время обслуживания.

Тип	Поле	Примечания
нить	URL	Необязательно, максимальная длина: 2000. Шаблон URL -адреса целевой страницы для рабочего стола. Требуется либо `url`, либо` localize_url`.
LocalizedTextSet	Локализованный_урл	Необязательно, максимальная длина: 2000, максимальное количество местных жителей 50. Локализованная целевая страница шаблон URL для настольного компьютера. Если предоставляются как url , так и localized_url , первое используется в качестве запасной части в случае, если URL -адрес не соответствует локале пользователя. Если url не доступен, а язык не предоставлен, используется английский URL.

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

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

Оператор

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
LocalizedTextSet	имя [устарело]	Необязательно, рекомендуемая длина: 50, максимальная длина: 100. Фирменная марка продавца этого продукта. OTA должен установить это как бренд OTA. Это поле сейчас устарело и заменено Brand_Name под продуктами
LocalizedTextSet	Google_business_profile_name	Требуется, максимальная длина: 100. Название бизнеса оператора, как это зарегистрировано в профиле бизнеса Google и появляется на картах Google. Это поле требуется для участия в модуле бронирования оператора.
нить	номер телефона	Необязательно, максимальная длина: 64. Номер телефона оператора. Предпочитаю полный международный формат номера телефона.
повторенный Расположение	локации	Необязательно, максимальное число: 1. Бизнес -адрес оператора. Если используется адресная строка, включите название бизнеса как часть строки адресов. Например, «название бизнеса, уличный адрес». Операторский бизнес должен быть найден на картах Google для запуска модуля бронирования оператора, оператор должен зарегистрировать бизнес -профиль Google, если их бизнес не может быть найден на картах Google.

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

Язык

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	код	Языковой код, соответствующий BCP-47, такой как «en» или «de-ch».

{
    "code": "de-CH"
}

Цена

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	Требуется, максимальная длина: 255. Уникальный идентификатор в рамках ценовой установки.
нить	заголовок	Требуется, максимальная длина: 150. Краткое описание опции цен, например, «Взрослый будний день».
Google.Type.money	цена	Требуется, когда is_free неверно. Цена, должна соответствовать окончательной цене на странице оформления заказа, включая все налоги и сборы, см. Ценовую политику. Валюта будет преобразована в пользовательскую валюту при рендеринге.
логическое значение	is_free	Необязательно, по умолчанию неверно. Вход или билет бесплатный. Должен быть установлен на True для вариантов нулевой ценности.
повторенный Геокритерион	geo_criteria	НЕОБЯЗАТЕЛЬНЫЙ. Список географических регионов, к которой применима эта цена. Если пуст, применимо ко всем местам.
повторенный Цена	fees_and_taxes	НЕОБЯЗАТЕЛЬНЫЙ. Разрушение сборов и налогов, включенных в цену.

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

Геокритерион

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	Country_code	НЕОБХОДИМЫЙ. 2-буквенное код страны, как определено в ISO 3166-1.
логическое значение	is_negative	НЕОБЯЗАТЕЛЬНЫЙ. Если это правда, критерий отрицательный (код страны исключен).

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

Цена

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
Google.Type.money	per_ticket_fee	НЕОБЯЗАТЕЛЬНЫЙ. Плата за бронирование включена в конечную цену продукта за один билет.
Google.Type.money	per_ticket_tax	НЕОБЯЗАТЕЛЬНЫЙ. Государственные налоги включены в конечную цену продукта за один билет.

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

Расположение

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
Геолокация	расположение	Необязательно, по крайней мере один из местоположений или описания должен присутствовать. Географическое расположение.
LocalizedTextSet	описание	Необязательная, рекомендуемая длина: 1000, максимальная длина: 2000, по крайней мере один из местоположений или описания должны присутствовать. Дополнительное описание в читаемой человеке, такой как «на левой стороне фонтана на площади дворца».

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

Геолокация

См. Руководство по использованию более подробной информации о каждом типе подсказки.

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	Place_id	Необязательно, именно один из place_id , address , place_info , business_profile_id или lat_lng должен присутствовать. Placeid, как определено местами API . Уникально идентифицирует POI в Google. Его можно найти с помощью конечных точек API Place, например, размещать поиск или поместить автозаполнение, или вручную с использованием инструмента «Найти местоположение» в вещах, которые можно сделать в центре.
нить	адрес	Необязательно, именно один из place_id , address , place_info , business_profile_id или lat_lng должен присутствовать. Устарел. Наследие однострочное адрес. Макс. Длина: 200. Ожидается, что компоненты будут разделены запятыми, причем первым компонентом является название места, как он отображается в Google. Для более высокой точности сопоставления используйте уличный адрес, показанный в Google для этого места.
Placeinfo	Place_info	Необязательно, именно один из place_id , address , place_info , business_profile_id или lat_lng должен присутствовать. Структурированная информация о месте.
uint64	business_profile_id	Необязательно, именно один из place_id , address , place_info , business_profile_id или lat_lng должен присутствовать. Идентификатор бизнес -профиля, как найдено на странице «Настройки профиля бизнеса Google». Используйте это поле при поиске местоположений непосредственно от владельца места, который имеет доступ к бизнес -профилю Google для этого места и может предоставить такой идентификатор.
google.type.latlng	lat_lng	Необязательно, именно один из place_id , address , place_info , business_profile_id или lat_lng должен присутствовать. Географические координаты. Это поле можно использовать только для определения города или географического региона, так как оно слишком неоднозначно, чтобы идентифицировать конкретное место или предприятия. Вместо этого используйте place_info , чтобы соответствовать конкретному месту по имени и координаты.

"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

Прото Примечания к реализации Примеры

message PlaceInfo {
  // Place or business name.
  // For higher matching accuracy, this should be the same as the name shown on
  // Google for the place. For places with a claimed Google Business Profile,
  // this should be the same as the business name configured in the business
  // profile.
  // Max length: 100.
  // Required.
  string name = 1;

  // Phone number, including the international prefix.
  // For higher matching accuracy, this should be the same as the phone number
  // shown on Google for the place.
  // It can include commonly used separator characters.
  // Examples: "[phone]", "[phone]".
  // Max length: 30.
  // Optional.
  string phone_number = 2;

  // Website URL shown on Google for the place, preferably the URL linked from
  // the business listing in Google Maps or Search for the place.
  // Max length: 1000.
  // Optional.
  string website_url = 3;

  // Geographic coordinates of the place.
  // If left empty, Google will infer the coordinates from the address.
  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  google.type.LatLng coordinates = 4;

  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  oneof address_type {
    // Structured address.
    // Prefer this format whenever possible for higher matching accuracy.
    StructuredAddress structured_address = 5;

    // Unstructured address.
    // It should not include the place or business name, which must instead be
    // provided separately using the `name` field.
    //
    // Examples:
    // - `name`: "Colosseum", `unstructured_address`: "Piazza del Colosseo, 1,
    // 00184 Roma RM, Italy".
    // - `name`: "The British Museum", `unstructured_address`: "Great Russell
    // St, London WC1B 3DG, United Kingdom".
    //
    // Max length: 400.
    string unstructured_address = 6;
  }
}

Тип	Поле	Примечания
нить	имя	НЕОБХОДИМЫЙ. Макс. Длина: 300. Место или название бизнеса. Для более высокой точности сопоставления это должно быть так же, как и имя, показанное в Google для этого места. Для мест с заявленным бизнес -профилем Google это должно быть так же, как и название бизнеса, настроенное в бизнес -профиле.
нить	номер телефона	НЕОБЯЗАТЕЛЬНЫЙ. Макс. Длина: 30. Номер телефона, включая международный префикс. Для более высокой точности сопоставления это должно быть так же, как и номер телефона, указанный в Google для этого места. Он может включать в себя обычно используемые символы сепаратора. Примеры: "[phone]", "[phone]".
нить	webse_url	НЕОБЯЗАТЕЛЬНЫЙ. Макс.
google.type.latlng	координаты	НЕОБЯЗАТЕЛЬНЫЙ. Географические координаты этого места. Если оставить пустым, Google выведет координаты с адреса. Необязательно, но должны быть предоставлены либо coordinates , либо любой из structured_address и unstructured_address .
StructuredAddress	structured_address	Необязательно, именно один из structured_address или unstructured_address может присутствовать, никогда не оба.
нить	unctructured_address	Необязательно, именно один из structured_address или unstructured_address может присутствовать, никогда не оба.

"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

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	адрес улицы	НЕОБХОДИМЫЙ. Макс. Длина: 200. Уличный адрес, включая номер дома и любой другой компонент, который не может быть предоставлен с использованием более конкретных полей. Он не должен включать в себя место или название предприятия, которое вместо этого должно быть предоставлено отдельно, используя поле name под PlaceInfo . Он также не должен включать почтовый кодекс, местонахождение или страну, поскольку они должны быть предоставлены с использованием соответствующих полей.
нить	местность	НЕОБЯЗАТЕЛЬНЫЙ. Макс. Длина: 80. Местонахождение, обычно относящаяся к городу или городской части адреса. В регионах мира, где населенные пункты не хорошо определены или плохо вписываются в эту структуру, оставляйте пустым.
нить	Administrative_area	НЕОБЯЗАТЕЛЬНЫЙ. Макс. Это может быть государство, регион, провинция, область, префектура. Это может быть аббревиатура или полное имя, в зависимости от того, как регион обычно представлен в почтовых адресах конкретной страны.
нить	Почтовый индекс	НЕОБЯЗАТЕЛЬНЫЙ. Макс. Длина: 30. Почтовый код или почтовый индекс. Требуется, если страна поддерживает почтовые коды, в противном случае она должна быть пустой.
нить	Country_code	НЕОБЯЗАТЕЛЬНЫЙ. Макс. Длина: 2. Код страны, как определено Unicode "CLDR", на основе стандарта ISO 3166 Alpha-2. Смотрите документацию Unicode .

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

LocalizedTextSet

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
повторенный Google.Type.LocalizedText	локализованный_texts	Первые локализованные текстовые значения.

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

Отменаполитика

Прото Примечания к реализации Примеры

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

Определяет одно условие возврата. Многочисленные условия возврата могут быть использованы вместе для описания «шагов возврата» как различные продолжительности до времени начала службы.

Тип	Поле	Примечания
Возврат	refund_conditions	Необязательно, максимальное количество условий возврата: 10.

Возврат

Тип	Поле	Примечания
uint32	min_duration_before_start_time_sec	Необязательный. Продолжительность за несколько секунд до начала времени, пока клиент не сможет получить возмещение за часть стоимости услуги, указанную в refund_percent . Когда вы не установку или установку на 0, услуга может быть отменена в любое время.
uint32	refund_percent	НЕОБЯЗАТЕЛЬНЫЙ. Процент, который может быть возвращен, до тех пор, пока бронирование услуг отменяется, по крайней мере, min_duration_before_start_time до времени начала службы, в диапазоне [0, 100]. Когда вы не установку в 0, служба не подлежит возврату. Когда установлено в 100, эта служба полностью подлежит возврату.
Google.Type.money	refund_fee	НЕОБЯЗАТЕЛЬНЫЙ. Фиксированная плата, вычтенная при возмещении. Можно использовать отдельно или в сочетании с refund_percent . В последнем случае процент возмещения применяется сначала, а затем вычитается плата.

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

,

Корм продукта является основным способом предоставить Google список вещей, которые можно сделать продуктами, которые должны отображаться на различных поверхностях Google.

Объект ProductFeed состоит из одного объекта FeedMetadata и нулевого или более объектов Product . Если во всех осколках не предоставляется Product , то все продукты удаляются.

Продукт

Прото Примечания к реализацииПримеры

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

Тип	Поле	Примечания
FEEDMETADATA	FEED_METADATA	НЕОБХОДИМЫЙ. Метаданные для этого корма.
повторенный Продукт	продукты	НЕОБЯЗАТЕЛЬНЫЙ. Когда не установлены во всех осколках, все продукты удаляются. feed_metadata/max_removal_share возможно, потребуется установить при удалении большого количества продуктов.

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

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
uint32	shard_id	Требуется, когда total_shards_count > 1. Основанная на ноль. Шарсы не нужно переносить по порядку. Обработка начинается только после того, как был загружен полный набор осколков.
uint32	total_shards_count	Требуется, должно быть> = 1.
uint64	нон	Требуется, когда total_shards_count > 1. Должен быть одинаковым для всех осколков в рамках передачи.
перечисление	Обработка_инстрокция	НЕОБХОДИМЫЙ. PROCESS_AS_SNAPSHOT является единственным поддерживаемым значением.
двойной	max_removal_share	НЕОБЯЗАТЕЛЬНЫЙ. Максимальная доля активных продуктов, которые могут быть удалены при загрузке. Если с помощью этой передачи удаляется больше продуктов, вся передача отклоняется. Это защита от непреднамеренного снесения значительной части инвентаря. Может быть установлен на 1.0, чтобы позволить полный инвентарь.

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

Продукт

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	Требуется, максимальная длина 255. Уникальная строка, которая идентифицирует продукт. Разрешенные символы являются буквенно -цифровыми, _ и -.
LocalizedTextSet	заголовок	Требуется, рекомендуемая длина <= 50, максимальная длина 150 символов. См. Название и описание Руководства для более подробной информации.
LocalizedTextSet	описание	Рекомендуемая, рекомендуемая длина <= 10000, максимальная длина 16000 символов. См. Название и описание Руководства для более подробной информации.
повторенный Текстовое отверстие	product_features	Рекомендуется, максимальное количество функций: 100.
Рейтинг	рейтинг	РЕКОМЕНДУЕТСЯ. Предоставление рейтингов настоятельно рекомендуется, поскольку продукты, отображающие рейтинги, приводят к более высокой скорости прохождения кликов.
повторенный СМИ	Связанная_медия	Рекомендуется, максимальное количество средств массовой информации: 30 Предоставление более одного изображения настоятельно рекомендуется. См. Руководство по изображениям для подробного руководства по изображениям.
логическое значение	use_media_order	НЕОБЯЗАТЕЛЬНЫЙ Намекните на Google, что порядок, в котором связанные носители указаны в канале, следует учитывать при выборе того изображения.
повторенный Вариант	параметры	Требуется, максимальное количество опций: 20 Каждый продукт должен иметь хотя бы один вариант продукта.
Оператор	оператор	НЕОБЯЗАТЕЛЬНЫЙ.
перечисление	устарел inventory_type	НЕОБЯЗАТЕЛЬНЫЙ. INVENTORY_TYPE_OFFICIAL может быть установлен только в продуктах, которые ссылаются на официальный сайт билета, представляющий интерес. Возможность установить это значение включена только после обзора приемлемости. Это поле устарело и заменено новым повторным полем Inventory_Types.
повторенный	inventory_types	НЕОБЯЗАТЕЛЬНЫЙ. Повторный список уникальных типов инвентаризации. Этот продукт принадлежит. INVENTORY_TYPE_OFFICIAL может быть установлен только в продуктах, которые ссылаются на официальный сайт билета, представляющий интерес. Возможность установить это значение включена только после обзора приемлемости. INVENTORY_TYPE_OPERATOR_DIRECT может быть установлен только в продуктах, которые ссылаются на сайт туроператора. Возможность установить это значение включена только после обзора приемлемости.
перечисление	Подтверждение_тип	НЕОБЯЗАТЕЛЬНЫЙ.
FulfillmentType	fulfillment_type	РЕКОМЕНДУЕТСЯ. Если установлено, по крайней мере одно поле в fulfillment_rype должно быть правдой. Устанавливает способы получить документ для подтверждения бронирования. Комбинации возможны, например, мобильные + напечатаны или напечатаны дома + личный пикап.
LocalizedTextSet	brand_name	Максимальная длина 100. Название бренда, которую продукт должен показывать, это заменяет теперь устаревший «оператор/имя». Только одно из двух значений может быть установлено.

{
  "id": "product-1",
  "title": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans bike tour"
          },
          {
              "language_code": "es",
              "text": "Tour en bicicleta por Dans"
          },
          {
              "language_code": "zh-HK",
              "text": "丹斯自行車之旅"
          }
      ]
  },
  "description": {
    "localized_texts": [
        {
            "language_code": "en",
            "text": "<p>A very fun bike tour<p>"
        },
        {
            "language_code": "es",
            "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
        },
        {
            "language_code": "zh-HK",
            "text": "<p>一個非常有趣的自行車之旅.</p>"
        }
    ]
  },
  "brand_name": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans Bikes"
          }
      ]
  },
  "rating": {
      "average_value": 4.6,
      "rating_count": 192
  },
  "product_features": [{
    "feature_type": "TEXT_FEATURE_INCLUSION",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
          {
              "language_code": "es",
              "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
          },
          {
              "language_code": "zh-HK",
              "text": "<p>一個非常有趣的自行車之旅.</p>"
          }
      ]
    }
  },{
    "feature_type": "TEXT_FEATURE_HIGHLIGHT",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
              },
              {
                  "language_code": "es",
                  "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
              },
              {
                  "language_code": "zh-HK",
                  "text": "<p>一個非常有趣的自行車之旅.</p>"
              }
          ]
      }
  },{
    "feature_type": "TEXT_FEATURE_MUST_KNOW",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
            {
                "language_code": "es",
                "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
            },
            {
                "language_code": "zh-HK",
                "text": "<p>一個非常有趣的自行車之旅.</p>"
            }
        ]
      }
  }],
  "options": [{
    "id": "option-1",
    "title": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "Sunset tour"
            },
            {
                "language_code": "es",
                "text": "Tour al atardecer"
            },
            {
                "language_code": "zh-HK",
                "text": "日落之旅"
            }
        ]
    },
    "landing_page": {
        "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
    },
    "cancellation_policy": {
        "refund_conditions": [
            {
                "min_duration_before_start_time_sec": 86400,
                "refund_percent": 100
            }
        ]
    },
    "option_categories": [
        {
            "label": "sports"
        },
        {
            "label": "bike-tours"
        }
    ],
    "related_locations": [
        {
            "location": {
                "location": {
                    "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        },
        {
            "location": {
                "location": {
                    "lat_lng": {
                        "latitude": 53.339688,
                        "longitude": 6.236688
                    }
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        }
    ],
    "price_options": [
        {
            "id": "option-1-adult",
            "title": "Adult (14+)",
            "price": {
                "currency_code": "EUR",
                "units": 20
            },
            "fees_and_taxes": {
                "per_ticket_fee": {
                    "currency_code": "EUR",
                    "units": 1
                },
                "per_ticket_tax": {
                    "currency_code": "EUR",
                    "units": 1
                }
            }
        }
    ]},{
      "id": "option-2",
      "title": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Sunrise tour"
              },
              {
                  "language_code": "es",
                  "text": "Tour al amanecer"
              },
              {
                  "language_code": "zh-HK",
                  "text": "日出之旅"
              }
          ]
      },
      "landing_page": {
          "url": "https://www.danstour.com/sunrise?language={lang}&currency={currency}"
      },
      "cancellation_policy": {
          "refund_conditions": [
              {
                  "min_duration_before_start_time_sec": 86400,
                  "refund_percent": 100
              }
          ]
      },
      "option_categories": [
          {
              "label": "sports"
          },
          {
              "label": "bike-tours"
          }
      ],
      "related_locations": [
          {
              "location": {
                  "location": {
                      "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                  }
              },
              "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
          }
      ],
      "price_options": [
          {
              "id": "option-2-adult",
              "title": "Adult (14+)",
              "price": {
                  "currency_code": "EUR",
                  "units": 20,
                  "nanos": 0
              }
          }
      ],
      "meeting_point": {
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          },
          "description": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Sunrise tour"
                  },
                  {
                      "language_code": "es",
                      "text": "Tour al amanecer"
                  },
                  {
                      "language_code": "zh-HK",
                      "text": "日出之旅"
                  }
              ]
          }
      }
    }
  ],
  "related_media": [
      {
          "url": "http://www.danstour.com/photo1.jpg",
          "type": "MEDIA_TYPE_PHOTO"
      },
      {
          "url": "http://www.danstour.com/photo2.jpg",
          "type": "MEDIA_TYPE_PHOTO",
          "attribution": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Dans Photos"
                  }
              ]
          }
      }
  ],
  "operator": {
      "name": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Dans Bikes"
              }
          ]
      },
      "phone_number": "01234567",
      "locations": [{
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          }
        }]
  },
  "inventory_types": ["INVENTORY_TYPE_OPERATOR_DIRECT"]
}

Вариант

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	НЕОБХОДИМЫЙ. Идентификатор опции. Должен быть уникальным в продукте.
LocalizedTextSet	заголовок	Требуется, рекомендуется длина: 50, максимум длина: 150 символов. Если есть только один вариант, заголовок опции может быть таким же, как и заголовок продукта. Если представлены несколько вариантов продукта, заголовок должен быть уникальным для этой опции. См. Название и описание Руководства для более подробной информации.
LocalizedTextSet	описание	Рекомендуемая, рекомендуемая длина: 10000, максимальная длина: 16000. См. Название и описание Руководства для более подробной информации.
Deeplink	landing_page	НЕОБХОДИМЫЙ. Должен содержать кнопку или ссылку, чтобы забронировать продукт. Смотрите руководящие принципы целевой страницы для более подробной информации.
Deeplink	landing_page_list_view	РЕКОМЕНДУЕТСЯ. Ссылка на просмотр списка на более высоком уровне доступных билетов и туров, заметно показывая этот вариант, возможно, среди других вариантов. Смотрите руководящие принципы целевой страницы для более подробной информации.
повторенный Текстовое отверстие	option_features	Необязательно, максимальное количество функций: 100. Не должно дублировать детали с уровня продукта.
Отменаполитика	Cancellation_policy	РЕКОМЕНДУЕТСЯ.
повторенный Категория	опция_категории	Необязательно, максимальное количество категорий: 100. Соответствующие категории для этого варианта. Обратитесь к документации категории продукта для дополнительных рекомендуемых значений.
повторенный Связанная разведка	Связанный_локация	Рекомендуется, максимальное количество мест: 100. Предоставление точного списка связанных мест чрезвычайно важно для того, чтобы продукт мог показать в наиболее важных местах, однако загрязнение или предоставление точных результатов данных при удалении продукта. Смотрите местоположение и руководство по интересам для получения более подробной информации.
логическое значение	base_ticket	НЕОБЯЗАТЕЛЬНЫЙ. Используется для указания, является ли опция продукта основным входным билетом.
повторенный Цена	PROCE_OPTIONS	Требуется, по крайней мере 1. Все возможные цены на этот вариант. Примечание: поддерживается только цена взрослого. Если было предоставлено несколько вариантов цены, будет использоваться первая цена, которая проходит проверку географического ограничения. Для групповых билетов полная цена всей группы должна использоваться вместо этого.
uint32	duration_sec	НЕОБЯЗАТЕЛЬНЫЙ. Продолжительность опциона в секундах, где это применимо, например, для экскурсий, поездок на лодке. Это должно отражать продолжительность опыта (не время достоверности).
повторенный Язык	языки	Рекомендуется, максимальное количество языков: 100. Языки, в которых есть вариант, доступен. Когда для конечного пользователя важно понимать и/или читать на языке, чтобы насладиться опытом. Например, для экскурсии.
Расположение	Meeting_point	НЕОБЯЗАТЕЛЬНЫЙ. Только добавьте, где актуально и полезно, например, место, где участник встретится с гидом, чтобы начать пешеходную экскурсию или место, где участник будет выбран на городской тур, док, где начнется круизная поездка.

{
  "id": "option-1",
  "title": {
    "localized_texts": [
    {
            "language_code": "en",
            "text": "Sunset tour"
        },
        {
            "language_code": "es",
            "text": "Tour al atardecer"
        },
        {
            "language_code": "zh-HK",
            "text": "日落之旅"
        }
    ]
  },
  "landing_page": {
      "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
  },
  "cancellation_policy": {
      "refund_conditions": [
          {
              "min_duration_before_start_time_sec": 86400,
              "refund_percent": 100
          }
      ]
  },
  "option_categories": [
      {
          "label": "sports"
      },
      {
          "label": "bike-tours"
      }
  ],
  "related_locations": [
      {
          "location": {
              "location": {
                  "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      },
      {
          "location": {
              "location": {
                  "lat_lng": {
                      "latitude": 53.339688,
                      "longitude": 6.236688
                  }
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      }
  ],
  "price_options": [
      {
          "id": "option-1-adult",
          "title": "Adult (14+)",
          "price": {
              "currency_code": "EUR",
              "units": 20
          },
          "fees_and_taxes": {
              "per_ticket_fee": {
                  "currency_code": "EUR",
                  "units": 1
              },
              "per_ticket_tax": {
                  "currency_code": "EUR",
                  "units": 1
              }
          }
      }
  ]
}

Текстовое отверстие

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
перечисление	feature_type	НЕОБХОДИМЫЙ. Тип функции, возможные значения: TEXT_FEATURE_INCLUSION : функция является включением. TEXT_FEATURE_EXCLUSION : функция является исключением. TEXT_FEATURE_HIGHLIGHT : функция является основным моментом. TEXT_FEATURE_MUST_KNOW : функция - это «должен знать». TEXT_FEATURE_SAFETY_INFORMATION : функция представляет информацию о мерах безопасности.
LocalizedTextSet	ценить	Требуется, рекомендуемая длина <= 1000 символов, максимальная длина: 2000. Поддерживаемые теги форматирования HTML: Br, Strong, Em, I Поддерживаются только четыре упомянутых тега. br может использоваться для разбивания линий в параграфах, а strong / em / i можно использовать для выделения важного текста. Любые другие фразы будут проигнорированы. Все остальные теги и пользовательские стили не допускаются и будут удалены. Любые URL-адреса, якоря и ссылки будут разделены и никогда не будут отображаться для конечных пользователей.

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

Рейтинг

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
двойной	Средний_value	НЕОБЯЗАТЕЛЬНЫЙ. Среднее значение оценки. Значение должно быть в диапазоне [1, 5] и может быть опущено тогда и только тогда, когда rating_count равен нулю.
uint64	rating_count	НЕОБХОДИМЫЙ. Количество рейтингов, используемых при расчете значения.

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

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

СМИ

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	URL	Требуется, максимальная длина: 2000. URL этого источника СМИ. Google будет ползти СМИ, размещенные на этом URL.
перечисление	тип	НЕОБХОДИМЫЙ. Тип этого источника медиа. Возможные значения: MEDIA_TYPE_PHOTO : Указывает, что носитель, предоставляемый URL -адресом, - это фото.
LocalizedTextSet	атрибуция	Необязательная, рекомендуемая длина: 1000, максимальная длина: 2000. Информация о атрибуции об источнике СМИ. Обратите внимание, что если атрибуция требуется для отображения со СМИ, чтобы отдать должное фотографу или агентству, это поле должно быть установлено.

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

Категория

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	этикетка	НЕОБХОДИМЫЙ. Обратитесь к документации категории продукта для списка действительных значений.

{
    "label": "sports"
}

Связанная разведка

Прото Примечания к реализации Примеры

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

Определяет связь между опцией и местоположением.

Тип	Поле	Примечания
Расположение	расположение	НЕОБХОДИМЫЙ. Местоположение, связанное с вариантом. Может быть POI (например, Эйфелевая башня), район (например, Старый город) или адрес / произвольная карта.
перечисление	отношение_type	НЕОБХОДИМЫЙ. Тип отношения опции для данного местоположения. Возможные значения: RELATION_TYPE_RELATED_NO_ADMISSION : местоположение связано, но соотношение не допускает приема или приема, не имеет значения, например, местоположение, является квадратом, выделенным в городском туре. RELATION_TYPE_ADMISSION_TICKET : Отношение предоставлено поступлением на это связанное место. RELATION_TYPE_SUPPLEMENTARY_ADDON : отношение объявляет дополнительную услугу, которая не попадает пользователю в соответствующее место, такое как парковочный билет или временная выставка.

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

Прото Примечания к реализации Примеры

// Deep link definition. Can include value parameters that will be expanded on
// serve time.
message DeepLink {
  // Landing page URL template for desktop. If both `url` and `localized_url`
  // are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Either `url` or `localized_url` is required.
  string url = 1;

  // Localized landing page URL template for desktop. If both `url` and
  // `localized_url` are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Max number of locales: 50.
  // Either `url` or `localized_url` is required.
  LocalizedTextSet localized_url = 3;

  reserved 2, 4;
}

Глубокая ссылка определение. Может включать параметры значения, которые будут расширены во время обслуживания.

Тип	Поле	Примечания
нить	URL	Необязательно, максимальная длина: 2000. Шаблон URL -адреса целевой страницы для рабочего стола. Требуется либо `url`, либо` localize_url`.
LocalizedTextSet	Локализованный_урл	Необязательно, максимальная длина: 2000, максимальное количество местных жителей 50. Локализованная целевая страница шаблон URL для настольного компьютера. Если предоставляются как url , так и localized_url , первое используется в качестве запасной части в случае, если URL -адрес не соответствует локале пользователя. Если url не доступен, а язык не предоставлен, используется английский URL.

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

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

Оператор

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
LocalizedTextSet	имя [устарело]	Необязательно, рекомендуемая длина: 50, максимальная длина: 100. Фирменная марка продавца этого продукта. OTA должен установить это как бренд OTA. Это поле сейчас устарело и заменено Brand_Name под продуктами
LocalizedTextSet	Google_business_profile_name	Требуется, максимальная длина: 100. Название бизнеса оператора, как это зарегистрировано в профиле бизнеса Google и появляется на картах Google. Это поле требуется для участия в модуле бронирования оператора.
нить	номер телефона	Необязательно, максимальная длина: 64. Номер телефона оператора. Предпочитаю полный международный формат номера телефона.
повторенный Расположение	локации	Необязательно, максимальное число: 1. Бизнес -адрес оператора. Если используется адресная строка, включите название бизнеса как часть строки адресов. Например, «название бизнеса, уличный адрес». Операторский бизнес должен быть найден на картах Google для запуска модуля бронирования оператора, оператор должен зарегистрировать бизнес -профиль Google, если их бизнес не может быть найден на картах Google.

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

Язык

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	код	Языковой код, соответствующий BCP-47, такой как «en» или «de-ch».

{
    "code": "de-CH"
}

Цена

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	идентификатор	Требуется, максимальная длина: 255. Уникальный идентификатор в рамках ценовой установки.
нить	заголовок	Требуется, максимальная длина: 150. Краткое описание опции цен, например, «Взрослый будний день».
Google.Type.money	цена	Требуется, когда is_free неверно. Цена, должна соответствовать окончательной цене на странице оформления заказа, включая все налоги и сборы, см. Ценовую политику. Валюта будет преобразована в пользовательскую валюту при рендеринге.
логическое значение	is_free	Необязательно, по умолчанию неверно. Вход или билет бесплатный. Должен быть установлен на True для вариантов нулевой ценности.
повторенный Геокритерион	geo_criteria	НЕОБЯЗАТЕЛЬНЫЙ. Список географических регионов, к которой применима эта цена. Если пуст, применимо ко всем местам.
повторенный Цена	fees_and_taxes	НЕОБЯЗАТЕЛЬНЫЙ. Разрушение сборов и налогов, включенных в цену.

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

Геокритерион

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	Country_code	НЕОБХОДИМЫЙ. 2-буквенное код страны, как определено в ISO 3166-1.
логическое значение	is_negative	НЕОБЯЗАТЕЛЬНЫЙ. Если это правда, критерий отрицательный (код страны исключен).

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

Цена

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
Google.Type.money	per_ticket_fee	НЕОБЯЗАТЕЛЬНЫЙ. Плата за бронирование включена в конечную цену продукта за один билет.
Google.Type.money	per_ticket_tax	НЕОБЯЗАТЕЛЬНЫЙ. Государственные налоги включены в конечную цену продукта за один билет.

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

Расположение

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
Геолокация	расположение	Необязательно, по крайней мере один из местоположений или описания должен присутствовать. Географическое расположение.
LocalizedTextSet	описание	Необязательная, рекомендуемая длина: 1000, максимальная длина: 2000, по крайней мере один из местоположений или описания должны присутствовать. Дополнительное описание в читаемой человеке, такой как «на левой стороне фонтана на площади дворца».

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

Геолокация

См. Руководство по использованию более подробной информации о каждом типе подсказки.

Прото Примечания к реализации Примеры

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

Тип	Поле	Примечания
нить	Place_id	Необязательно, именно один из place_id , address , place_info , business_profile_id или lat_lng должен присутствовать. Placeid, как определено местами API . Уникально идентифицирует POI в Google. It can be sourced using the Places API endpoints, for example Place Search or Place Autocomplete, or manually using the Find Location Matches tool in Things to Do Center.
нить	адрес	OPTIONAL, exactly one of place_id , address , place_info , business_profile_id , or lat_lng must be present. DEPRECATED. Legacy single-line address. Max length: 200. 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.
PlaceInfo	place_info	OPTIONAL, exactly one of place_id , address , place_info , business_profile_id , or lat_lng must be present. Structured place information.
uint64	business_profile_id	OPTIONAL, exactly one of place_id , address , place_info , business_profile_id , or lat_lng must be present. 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.
google.type.LatLng	lat_lng	OPTIONAL, exactly one of place_id , address , place_info , business_profile_id , or lat_lng must be present. 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.

"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

Прото Implementation Notes Примеры

message PlaceInfo {
  // Place or business name.
  // For higher matching accuracy, this should be the same as the name shown on
  // Google for the place. For places with a claimed Google Business Profile,
  // this should be the same as the business name configured in the business
  // profile.
  // Max length: 100.
  // Required.
  string name = 1;

  // Phone number, including the international prefix.
  // For higher matching accuracy, this should be the same as the phone number
  // shown on Google for the place.
  // It can include commonly used separator characters.
  // Examples: "[phone]", "[phone]".
  // Max length: 30.
  // Optional.
  string phone_number = 2;

  // Website URL shown on Google for the place, preferably the URL linked from
  // the business listing in Google Maps or Search for the place.
  // Max length: 1000.
  // Optional.
  string website_url = 3;

  // Geographic coordinates of the place.
  // If left empty, Google will infer the coordinates from the address.
  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  google.type.LatLng coordinates = 4;

  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  oneof address_type {
    // Structured address.
    // Prefer this format whenever possible for higher matching accuracy.
    StructuredAddress structured_address = 5;

    // Unstructured address.
    // It should not include the place or business name, which must instead be
    // provided separately using the `name` field.
    //
    // Examples:
    // - `name`: "Colosseum", `unstructured_address`: "Piazza del Colosseo, 1,
    // 00184 Roma RM, Italy".
    // - `name`: "The British Museum", `unstructured_address`: "Great Russell
    // St, London WC1B 3DG, United Kingdom".
    //
    // Max length: 400.
    string unstructured_address = 6;
  }
}

Тип	Поле	Примечания
нить	имя	НЕОБХОДИМЫЙ. Max length: 300. 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: 30. 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]".
нить	website_url	НЕОБЯЗАТЕЛЬНЫЙ. Max length: 1000. Website URL shown on Google for the place, preferably the URL linked from the business listing in Google Maps or Search for the place.
google.type.LatLng	координаты	НЕОБЯЗАТЕЛЬНЫЙ. Geographic coordinates of the place. If left empty, Google will infer the coordinates from the address. Optional, but either coordinates or any of structured_address and unstructured_address must be provided.
StructuredAddress	structured_address	OPTIONAL, exactly one of structured_address or unstructured_address may be present, never both.
нить	unstructured_address	OPTIONAL, exactly one of structured_address or unstructured_address may be present, never both.

"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

Прото Implementation Notes Примеры

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

Тип	Поле	Примечания
нить	адрес улицы	НЕОБХОДИМЫЙ. Max length: 200. Street address, including house number and any other component that cannot be provided using the more specific fields. It shouldn't 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.
нить	местность	НЕОБЯЗАТЕЛЬНЫЙ. Max length: 80. Locality, generally referring to the city or town portion of an address. In regions of the world where localities are not well defined or don't fit into this structure well, leave empty.
нить	administrative_area	НЕОБЯЗАТЕЛЬНЫЙ. Max length: 80. 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. 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.
нить	Почтовый индекс	НЕОБЯЗАТЕЛЬНЫЙ. Max length: 30. The postal code or zip code. Required if the country supports postal codes, otherwise it should be left empty.
нить	country_code	НЕОБЯЗАТЕЛЬНЫЙ. Max length: 2. Country code, as defined by Unicode "CLDR", itself based on the ISO 3166 alpha-2 standard. See Unicode documentation.

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

LocalizedTextSet

Прото Implementation Notes Примеры

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

Тип	Поле	Примечания
повторенный google.type.LocalizedText	localized_texts	Per-locale localized text values.

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

CancellationPolicy

Прото Implementation Notes Примеры

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

Defines a single refund condition. Multiple refund conditions could be used together to describe "refund steps" as various durations before the service start time.

Тип	Поле	Примечания
RefundCondition	refund_conditions	OPTIONAL, max number of refund conditions: 10.

RefundCondition

Тип	Поле	Примечания
uint32	min_duration_before_start_time_sec	Необязательный. 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.
uint32	refund_percent	НЕОБЯЗАТЕЛЬНЫЙ. 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.
google.type.Money	refund_fee	НЕОБЯЗАТЕЛЬНЫЙ. A flat fee deducted on refund. Could be used separately, or in combination with the refund_percent . In the latter case, refund percent applies first, then the fee is deducted.

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