Фид товаров

Товарный фид — это основной способ предоставить Google список товаров из категории «Что делать», которые должны отображаться на различных платформах Google.

Объект ProductFeed состоит из одного объекта FeedMetadata и нуля или более объектов Product . Если ни один 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	НЕОБХОДИМЫЙ. Метаданные для этого канала.
повтор Продукт	продукты	НЕОБЯЗАТЕЛЬНЫЙ. Если параметр `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": []
}

Метаданные ленты

Прото

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 [features.enforce_naming_style = STYLE_LEGACY];

    // Booking is confirmed to the end user within 48 hours.
    CONFIRMATION_TYPE_48HRS = 3 [features.enforce_naming_style = STYLE_LEGACY];
  }

  // 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 символов. Более подробная информация содержится в разделе «Рекомендации по оформлению заголовков и описаний» .
Локализованный набор текста	описание	РЕКОМЕНДУЕМАЯ длина: рекомендуемая длина <= 10000 символов, максимальная длина 16000 символов. Более подробная информация содержится в разделе «Рекомендации по оформлению заголовков и описаний» .
повтор Текстовая функция	продукт_функции	РЕКОМЕНДУЕМОЕ максимальное количество функций: 100.
Рейтинг	рейтинг	РЕКОМЕНДУЕТСЯ. Настоятельно рекомендуется указывать рейтинги, поскольку товары с рейтингами приводят к более высокому показателю кликабельности.
повтор СМИ	связанные_медиа	РЕКОМЕНДУЕМОЕ максимальное количество носителей: 30 Настоятельно рекомендуется предоставить более одного изображения. Подробные рекомендации по изображениям см. в разделе «Рекомендации по изображениям».
логический	use_media_order	НЕОБЯЗАТЕЛЬНЫЙ Подсказка для Google: при выборе изображения для отображения следует учитывать порядок отображения связанных медиафайлов в ленте.
повтор Вариант	параметры	ОБЯЗАТЕЛЬНО, максимальное количество вариантов: 20 Для каждого товара должен быть доступен как минимум один вариант.
Оператор	оператор	НЕОБЯЗАТЕЛЬНЫЙ.
перечисление	устаревший inventory_type	НЕОБЯЗАТЕЛЬНЫЙ. INVENTORY_TYPE_OFFICIAL можно установить только для товаров, которые ссылаются на официальный сайт продажи билетов в интересующем вас месте. Возможность установки этого значения становится доступной только после проверки соответствия требованиям. Это поле устарело и заменено новым повторяющимся полем inventory_types.
повтор	inventory_types	НЕОБЯЗАТЕЛЬНЫЙ. Повторяющийся список уникальных типов товаров, к которым относится данный продукт. INVENTORY_TYPE_OFFICIAL можно установить только для товаров, которые ссылаются на официальный сайт продажи билетов в интересующем вас месте. Возможность установки этого значения становится доступной только после проверки соответствия требованиям. INVENTORY_TYPE_OPERATOR_DIRECT можно установить только для товаров, ссылки на которые размещены на сайте туроператора. Возможность установки этого значения предоставляется только после проверки соответствия требованиям.
перечисление	confirmation_type	НЕОБЯЗАТЕЛЬНЫЙ.
Тип выполнения	тип выполнения	РЕКОМЕНДУЕТСЯ. Если задано, то как минимум одно поле в 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. Не следует дублировать детали на уровне продукта.
Политика отмены	политика отмены	РЕКОМЕНДУЕТСЯ.
повтор Категория	option_categories	Необязательно, максимальное количество категорий: 100. Для данного варианта указаны соответствующие категории. Дополнительные рекомендуемые значения см. в документации по категориям товаров .
повтор Связанное местоположение	связанное_местоположение	РЕКОМЕНДУЕМОЕ максимальное количество точек: 100. Предоставление точного списка связанных местоположений крайне важно для того, чтобы продукт отображался в наиболее релевантных местах. Однако излишняя маркировка или предоставление неточных данных приводит к удалению продукта. Более подробную информацию см. в руководстве по местоположениям и достопримечательностям .
буль	базовый_билет	НЕОБЯЗАТЕЛЬНЫЙ. Используется для указания того, является ли данный вариант продукта базовым входным билетом.
повтор Вариант цены	price_options	ОБЯЗАТЕЛЬНО, как минимум 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 : Feature is a "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 {
    RELATION_TYPE_UNSPECIFIED = 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;

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

  // Relation type of an option for the given location.
  // Required.
  RelationType relation_type = 2;
}

Примечания по внедрению

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

Тип	Поле	Примечания
Расположение	расположение	НЕОБХОДИМЫЙ. Местоположение, связанное с выбранным вариантом. Это может быть точка интереса (например, Эйфелева башня), район (например, Старый город) или адрес/произвольная точка на карте.
перечисление	relation_type	НЕОБХОДИМЫЙ. Тип связи опции для данного местоположения. Возможные значения: RELATION_TYPE_RELATED_NO_ADMISSION : Местоположение связано, но связь не допускает допуска или допуск не имеет значения, например, местоположение — это площадь, выделенная в рамках городской экскурсии. RELATION_TYPE_ADMISSION_TICKET : Связь предоставляет доступ в это связанное место. RELATION_TYPE_SUPPLEMENTARY_ADDON : Relation declares an additional service which doesn't get the user into the related location such as a parking ticket or a temporary exhibition.

Примеры

// 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": {
          "place_info": {
              "name": "Eiffel Tower",
              "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
          }
        }
    },
    "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`.
Локализованный набор текста	локализованный_урл	НЕОБЯЗАТЕЛЬНО, максимальная длина: 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. Это поле устарело и заменено на brand_name в разделе товаров.
Локализованный набор текста	google_business_profile_name	ОБЯЗАТЕЛЬНО, максимальная длина: 100. Название компании-оператора, как оно зарегистрировано в профиле Google Business и отображается на Google Maps. Это поле обязательно для участия в модуле бронирования операторов.
нить	номер телефона	ДОПОЛНИТЕЛЬНО, максимальная длина: 64. Номер телефона оператора. Предпочтительно использовать полный международный формат номера телефона.
повтор Расположение	местоположения	НЕОБЯЗАТЕЛЬНО, максимальное количество: 1. Адрес компании-оператора. Если используется строковый адрес, включите в него название компании. Например, "название компании, адрес". Для запуска модуля бронирования оператор должен быть доступен на Google Maps; если компания недоступна на Google Maps, оператор должен зарегистрировать профиль Google Business Profile.

Примеры

// 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
    "place_info": {
      "name": "Dans Bike Tour",
      "unstructured_address": "123 Baker 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.
повтор ГеоКритерион	гео_критерии	НЕОБЯЗАТЕЛЬНЫЙ. Список географических регионов, на которые распространяется данная цена. Если список пуст, цена распространяется на все регионы.
повтор Цены, сборы и налоги	сборы и налоги	НЕОБЯЗАТЕЛЬНЫЙ. Подробная разбивка сборов и налогов, включенных в цену.

Примеры

{
    "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	НЕОБЯЗАТЕЛЬНЫЙ. Если это так, критерий считается отрицательным (код страны исключается).

Примеры

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

{
    "location": {
      "place_info": {
          "name": "Eiffel Tower",
          "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
        }
    }
}

Геолокация

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

Прото

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. Его можно получить, используя конечные точки API Places, например, Place Search или Place Autocomplete, или вручную с помощью инструмента Find Location Matches в Things to Do Center.
нить	адрес	НЕОБЯЗАТЕЛЬНО: должен присутствовать ровно один из следующих параметров: 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"

"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]".
нить	веб-сайт_url	НЕОБЯЗАТЕЛЬНО. Максимальная длина: 1000 символов. URL-адрес веб-сайта, отображаемый в Google для данного места, предпочтительно URL-адрес, на который ведет ссылка из описания компании в Google Maps или в результатах поиска.
google.type.LatLng	координаты	НЕОБЯЗАТЕЛЬНО. Географические координаты места. Если оставить поле пустым, Google определит координаты по адресу. Необязательно, но необходимо указать либо coordinates , либо любой из structured_address или unstructured_address .
StructuredAddress	структурированный_адрес	НЕОБЯЗАТЕЛЬНО: может присутствовать только один из параметров 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 символов. Населенный пункт, как правило, город или поселок в адресе. В регионах мира, где населенные пункты четко не определены или плохо вписываются в эту структуру, оставьте поле пустым.
нить	административная_зона	НЕОБЯЗАТЕЛЬНО. Максимальная длина: 80 символов. Высшее административное подразделение, используемое в почтовых адресах конкретной страны или региона. Это может быть штат, регион, провинция, область, префектура. Это может быть аббревиатура или полное название, в зависимости от того, как регион обычно представлен в почтовых адресах конкретной страны.
нить	Почтовый индекс	НЕОБЯЗАТЕЛЬНО. Максимальная длина: 30 символов. Почтовый индекс. Обязательно, если страна поддерживает почтовые индексы, в противном случае поле следует оставить пустым.
нить	код страны	OPTIONAL. 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"
  }
}

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

Прото

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

Примечания по внедрению

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

Примеры

{
    "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	мин_длительность_до_начала_время_сек	Необязательный. Длительность в секундах до момента начала услуги, до которого клиент может получить возврат части стоимости услуги, указанной в 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
  }]

Отправить отзыв