이 페이지는 Cloud Translation API를 통해 번역되었습니다.

제품 피드

제품 피드는 다양한 Google 표시 경로에 표시할 할 일 제품 목록을 Google에 제공하는 기본적인 방법입니다.

ProductFeed 객체는 하나의 FeedMetadata 객체와 0개 이상의 Product 객체로 구성됩니다. 모든 샤드에 Product가 제공되지 않으면 모든 제품이 삭제됩니다.

ProductFeed

Proto

message ProductFeed {
  // Metadata for this feed.
  // Required.
  FeedMetadata feed_metadata = 1;

  // List of the products.
  // Optional. When unset in all shards, all products will be deleted.
  repeated Product products = 2;
}

구현 참고사항

유형	필드	Notes
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

Proto

message FeedMetadata {
  // The current shard ID, zero-based. Shards do not need to be transferred in
  // order. Processing will start only after a full set of shards was uploaded.
  // Required when total_shards_count > 1.
  uint32 shard_id = 1;

  // Total number of shards in this transfer.
  // Required. Must be >= 1.
  uint32 total_shards_count = 2;

  // An arbitrary number used to link multiple shards to the same transfer.
  // Required when total_shards_count > 1.
  // Must be the same for all shards within the transfer.
  uint64 nonce = 3;

  enum ProcessingInstruction {
    // For compatibility, don't use.
    PROCESS_AS_UNSPECIFIED = 0;

    // This Feed upload should be processed as a complete snapshot replacing any
    // previously uploaded data of this type.
    // Supported feed types: product.
    PROCESS_AS_SNAPSHOT = 1;

    // This Feed upload should be processed as an upsert, updating or adding
    // data to the previous uploads. Supported feed types: reviews,
    // availability.
    PROCESS_AS_UPSERT = 2;
  }
  // Processing instruction for this upload.
  // Required.
  ProcessingInstruction processing_instruction = 4;

  // Maximal share of currently active products that are allowed to be removed
  // by an upload. If more products will be removed by this transfer, the whole
  // transfer will be rejected.
  // This is a safeguard against unintentional take down of a significant part
  // of the inventory. Can be set to 1.0 to allow complete inventory take down.
  // Optional.
  double max_removal_share = 5;
}

구현 참고사항

유형	필드	Notes
uint32	shard_id	`total_shards_count` > 1인 경우 필수사항입니다. 0부터 시작합니다. 샤드를 순서대로 이전할 필요가 없습니다. 전체 샤드 집합이 업로드된 후에만 처리가 시작됩니다.
uint32	total_shards_count	필수사항이며 1 이상이어야 합니다.
uint64	nonce	`total_shards_count` > 1인 경우 필수사항입니다. 전송 내의 모든 샤드에서 동일해야 합니다.
enum	processing_instruction	필수사항입니다. 지원되는 유일한 값은 `PROCESS_AS_SNAPSHOT`입니다.
double	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
}

제품

Proto

message Product {
  // An opaque string from the partner which uniquely identifies the product.
  // Allowed characters are alphanumeric, _, and -. Max length: 255.
  // Required.
  string id = 1;

  // The title of the product in plain text, e.g. "Horseback riding on the
  // moon". See definition of "LocalizedTextSet" message for the details on the
  // localization.
  // Recommended to not exceed length of 50 in any language. Max length: 150.
  // Required.
  LocalizedTextSet title = 2;

  // The description of the product. Limited formatting options are allowed in
  // the HTML format. Supported tags:
  //   * h1-h5
  //   * ul, ol, li
  //   * strong, italic, em
  //   * p, br
  // Other tags are not supported and will be removed. CSS, tables, style
  // property, `a` links are not supported. Images are not allowed, use the
  // related_media field instead.
  // Important notes:
  //   * Try not to use other tags except for the supported ones mentioned
  //     above, because the contents within unsupported tags will be stripped,
  //     and may lead to an undesirable user experience.
  //   * Try avoid deep nested structures like more than 3 different heading
  //     levels or nested lists. Keeping the structure flat, simple, and
  //     straightforward, helps to create a better user experience.
  //   * Do not duplicate info from the product_features field below in the
  //     description as both would normally be shown side by side.
  // Recommended to not exceed length of 10000 in any language. Max length:
  // 16000.
  // Recommended.
  LocalizedTextSet description = 3;

  // Structured details about the product features.
  // Max number of features: 100.
  // Recommended.
  repeated TextFeature product_features = 4;

  // Aggregated product rating.
  // Recommended.
  Rating rating = 5;

  // Related media such as photos or videos.
  // Max number of media: 30.
  // Recommended.
  repeated Media related_media = 6;

  // Whether Google should make use of the order in which related media are
  // listed in the feed or not. The media order would be used to influence
  // the final image order for the product in the UI.
  // Optional, default is false.
  bool use_media_order = 13;

  // Options available for this product.
  // Max number of options: 20.
  // At least one is required.
  repeated Option options = 7;

  // Operator details.
  // Optional.
  Operator operator = 8;

  // Inventory type of this product.
  enum InventoryType {
    // Default inventory type.
    INVENTORY_TYPE_DEFAULT = 0;
    // Product is an official ticket to a point of interest. To learn what
    // qualifies as official inventory, refer to the policy doc.
    INVENTORY_TYPE_OFFICIAL = 1;
    // Product is coming directly from the operator or their official
    // Connectivity Provider / ResTech.
    INVENTORY_TYPE_OPERATOR_DIRECT = 2;
  }
  // Optional.
  InventoryType inventory_type = 9;

  // Should contain only distinct values of InventoryType.
  // Max number of inventory types: 2.
  // Optional.
  repeated InventoryType inventory_types = 12;

  // Confirmation type of this product.
  enum ConfirmationType {
    // Type of confirmation is unknown.
    CONFIRMATION_TYPE_UNKNOWN = 0;
    // Booking is confirmed to the end user immediately.
    CONFIRMATION_TYPE_INSTANT = 1;
    // Booking is confirmed to the end user within 24 hours.
    CONFIRMATION_TYPE_24HRS = 2;
    // Booking is confirmed to the end user within 48 hours.
    CONFIRMATION_TYPE_48HRS = 3;
  }
  // Optional.
  ConfirmationType confirmation_type = 10;

  // Possible fulfillment types -- ways to obtain a document to confirm the
  // booking. Combinations are possible, e.g. mobile + printed, or
  // printed at home + in-person pickup is available.
  // At least one field must be true.
  message FulfillmentType {
    // Confirmation on a mobile phone, e.g. with a QR code.
    bool mobile = 1;
    // Printable confirmation.
    bool print_at_home = 2;
    // Admission documents to be picked up in person.
    bool pickup = 3;
  }
  // Recommended.
  FulfillmentType fulfillment_type = 11;

  // Provider brand name.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 100.
  // Optional.
  LocalizedTextSet brand_name = 14;
}

구현 참고사항

유형	필드	Notes
string	id	필수사항이며 최대 길이는 255자입니다. : 제품을 식별하는 고유한 문자열입니다. 허용되는 문자는 영숫자, _, -입니다.
LocalizedTextSet	제목	필수, 권장 길이<= 50, 최대 길이 150자(영문 기준) 자세한 내용은 제목 및 설명 가이드라인을 참고하세요.
LocalizedTextSet	설명	권장 길이: 10,000자(영문 기준), 최대 길이는 16,000자(영문 기준)입니다(RECOMMENDED). 자세한 내용은 제목 및 설명 가이드라인을 참고하세요.
반복됨 TextFeature	product_features	권장사항(RECOMMENDED), 최대 기능 개수: 100개.
평점	rating	권장사항입니다. 평점을 표시하는 것은 클릭률이 높아지므로 평점을 제공하는 것이 좋습니다.
반복되는 미디어	related_media	권장, 최대 미디어 수: 30 2개 이상의 이미지를 제공하는 것이 좋습니다. 이미지에 관한 자세한 가이드는 이미지 가이드라인을 참고하세요.
boolean	use_media_order	선택사항 표시할 이미지를 선택할 때 피드에 관련 미디어가 나열되는 순서를 고려해야 한다는 점을 Google에 알려 주세요.
반복 옵션	옵션	필수(필수) 최대 옵션 수: 20 각 제품에는 하나 이상의 제품 옵션이 있어야 합니다.
연산자	연산자	선택사항입니다.
enum	지원 중단됨 inventory_type	선택사항입니다. `INVENTORY_TYPE_OFFICIAL`는 관심 장소의 공식 티켓 사이트로 연결되는 제품에서만 설정할 수 있습니다. 이 값을 설정하는 기능은 자격 요건을 검토한 후에만 사용 설정됩니다. 이 필드는 지원 중단되었으며 새로운 반복 필드 Inventory_types로 대체되었습니다.
repeated	inventory_types	선택사항입니다. 이 제품이 속한 고유 인벤토리 유형의 반복되는 목록입니다. `INVENTORY_TYPE_OFFICIAL`는 관심 장소의 공식 티켓 사이트로 연결되는 제품에서만 설정할 수 있습니다. 이 값을 설정하는 기능은 자격 요건을 검토한 후에만 사용 설정됩니다. `INVENTORY_TYPE_OPERATOR_DIRECT`은 관광업체 사이트로 연결되는 제품에서만 설정할 수 있습니다. 이 값을 설정하는 기능은 자격 요건을 검토한 후에만 사용 설정됩니다.
enum	confirmation_type	선택사항입니다.
FulfillmentType	fulfillment_type	권장사항입니다. 설정된 경우 `fulfillment_rype`의 하나 이상의 필드가 true여야 합니다. 예약을 확인하기 위해 문서를 받는 방법을 설정합니다. 조합은 가능합니다. 예를 들어 모바일 + 인쇄물 또는 집으로 인쇄 + 방문 수령이 가능합니다.
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?source={src}&language={lang}&currency={currency}"
    },
    "cancellation_policy": {
        "refund_conditions": [
            {
                "min_duration_before_start_time_sec": 86400,
                "refund_percent": 100
            }
        ]
    },
    "option_categories": [
        {
            "label": "sports"
        },
        {
            "label": "bike-tours"
        }
    ],
    "related_locations": [
        {
            "location": {
                "location": {
                    "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        },
        {
            "location": {
                "location": {
                    "lat_lng": {
                        "latitude": 53.339688,
                        "longitude": 6.236688
                    }
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        }
    ],
    "price_options": [
        {
            "id": "option-1-adult",
            "title": "Adult (14+)",
            "price": {
                "currency_code": "EUR",
                "units": 20
            },
            "fees_and_taxes": {
                "per_ticket_fee": {
                    "currency_code": "EUR",
                    "units": 1
                },
                "per_ticket_tax": {
                    "currency_code": "EUR",
                    "units": 1
                }
            }
        }
    ]},{
      "id": "option-2",
      "title": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Sunrise tour"
              },
              {
                  "language_code": "es",
                  "text": "Tour al amanecer"
              },
              {
                  "language_code": "zh-HK",
                  "text": "日出之旅"
              }
          ]
      },
      "landing_page": {
          "url": "https://www.danstour.com/sunrise?source={src}&language={lang}&currency={currency}"
      },
      "cancellation_policy": {
          "refund_conditions": [
              {
                  "min_duration_before_start_time_sec": 86400,
                  "refund_percent": 100
              }
          ]
      },
      "option_categories": [
          {
              "label": "sports"
          },
          {
              "label": "bike-tours"
          }
      ],
      "related_locations": [
          {
              "location": {
                  "location": {
                      "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                  }
              },
              "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
          }
      ],
      "price_options": [
          {
              "id": "option-2-adult",
              "title": "Adult (14+)",
              "price": {
                  "currency_code": "EUR",
                  "units": 20,
                  "nanos": 0
              }
          }
      ],
      "meeting_point": {
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          },
          "description": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Sunrise tour"
                  },
                  {
                      "language_code": "es",
                      "text": "Tour al amanecer"
                  },
                  {
                      "language_code": "zh-HK",
                      "text": "日出之旅"
                  }
              ]
          }
      }
    }
  ],
  "related_media": [
      {
          "url": "http://www.danstour.com/photo1.jpg",
          "type": "MEDIA_TYPE_PHOTO"
      },
      {
          "url": "http://www.danstour.com/photo2.jpg",
          "type": "MEDIA_TYPE_PHOTO",
          "attribution": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Dans Photos"
                  }
              ]
          }
      }
  ],
  "operator": {
      "name": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Dans Bikes"
              }
          ]
      },
      "phone_number": "01234567",
      "locations": [{
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          }
        }]
  },
  "inventory_types": ["INVENTORY_TYPE_OPERATOR_DIRECT"]
}

옵션

Proto

message Option {
  // Option ID. Must be unique within a product.
  // Required.
  string id = 1;

  // The title of the option in plain text, e.g. "Sunset tour".
  //
  // If there is only a single option, the option title may be the same as the
  // product title. If multiple product options are presented, the title must be
  // unique to the option.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 150.
  // Required.
  LocalizedTextSet title = 2;

  // The description of the option. Limited formatting options are allowed in
  // the HTML format, see product description field for more details.
  // Recommended to not exceed length of 10000 in any language.
  // Max length: 16000.
  // Recommended.
  LocalizedTextSet description = 3;

  // Landing page URL for this option. The page should include a button to start
  // the booking/checkout flow.
  // Required.
  DeepLink landing_page = 5;

  // Link to a list view at a higher level of available tickets and tours,
  // prominently showing this option possibly among other options.
  // Recommended.
  DeepLink landing_page_list_view = 6;

  // Additional structured details about the option features. Should not
  // duplicate the details from the product level.
  // Max number of features: 100.
  // Optional.
  repeated TextFeature option_features = 7;

  // Cancellation policy for this option.
  // Recommended.
  CancellationPolicy cancellation_policy = 8;

  // Relevant categories for this Option. Refer to the documentation for valid
  // and mutually exclusive values.
  // Max number of categories: 100.
  // Optional.
  repeated Category option_categories = 9;

  // List of locations related to this option.
  // Max number of locations: 100.
  // Recommended.
  repeated RelatedLocation related_locations = 10;

  // If true, the option is a *typical ticket* that a user would expect to buy
  // to participate in the experience, whether it's an attraction admission or
  // a slot in a tour.
  // Optional, default is false.
  bool base_ticket = 11;

  // All possible prices for this option.
  // Note: With Feed Spec v1 only single Adult price is supported. If multiple
  // price options were provided, the lowest price, possibly with notion
  // "from ..." would be displayed.
  // At least one is required.
  repeated PriceOption price_options = 12;

  // Duration of the option in seconds, where applicable, e.g. for guided tours,
  // boat trips etc. This should reflect the duration of experience (not
  // validity time).
  // Optional.
  uint32 duration_sec = 16;

  // Languages of the option. Only where relevant -- when it's important for
  // the end user to understand and/or read in the language to enjoy the
  // experience. E.g. relevant for a guided tour, but not for a mini-golf pass.
  // Max number of languages: 100.
  // Recommended.
  repeated Language languages = 14;

  // Meeting point -- the start location. Only add where relevant and
  // beneficial, e.g. the place where participant will meet the tour guide to
  // start a walking tour, the place where participant will be picked up for a
  // city tour, the dock where a cruise trip will start.
  // Optional.
  Location meeting_point = 15;
}

구현 참고사항

유형	필드	Notes
string	id	필수사항입니다. 옵션 ID. 제품 내에서 고유해야 합니다.
LocalizedTextSet	제목	필수사항(REQUIRED)이며 권장 길이는 50자, 최대 길이는 150자(영문 기준)입니다. 옵션이 하나만 있는 경우 옵션 제목이 제품명과 같을 수 있습니다. 여러 제품 옵션이 표시되는 경우 제품명은 옵션마다 고유해야 합니다. 자세한 내용은 제목 및 설명 가이드라인을 참고하세요.
LocalizedTextSet	설명	권장 길이: 10,000, 최대 길이: 16,000 자세한 내용은 제목 및 설명 가이드라인을 참고하세요.
DeepLink	landing_page	필수사항입니다. 제품을 예약하는 버튼 또는 링크를 포함해야 합니다. 자세한 내용은 방문 페이지 가이드라인을 참고하세요.
DeepLink	landing_page_list_view	권장사항입니다. 구매 가능한 티켓 및 투어의 상위 수준의 목록 보기에 연결하여 이 옵션을 다른 옵션 중에서 눈에 잘 띄게 표시합니다. 자세한 내용은 방문 페이지 가이드라인을 참고하세요.
반복됨 TextFeature	option_features	선택사항, 최대 기능 수: 100개 제품 수준의 세부정보를 중복하면 안 됩니다.
CancellationPolicy	cancellation_policy	권장사항입니다.
반복 카테고리	option_categories	선택사항, 최대 카테고리 수: 100개 이 옵션의 관련 카테고리입니다. 특히 중요한 점은 `self-guided`가 투어 기반이 아닌 모든 활동에 설정되어 있고 `guided-tour`가 투어 기반 활동에 설정되어 있는지 확인해야 합니다. 추가 권장 값은 제품 카테고리 문서를 참조하세요.
반복됨 RelatedLocation	related_location	권장사항(RECOMMENDED)의 최대 위치 수는 100개입니다. 제품을 가장 관련성 높은 위치에 표시하려면 정확한 관련 위치 목록을 제공하는 것이 매우 중요합니다. 그러나 태그를 과도하게 지정하거나 정확한 데이터를 제공하면 제품이 삭제됩니다. 자세한 내용은 위치 및 관심 장소 가이드를 참고하세요.
bool	base_ticket	선택사항입니다. 제품 옵션이 기본 입장권인지 여부를 나타내는 데 사용됩니다.
반복됨 PriceOption	price_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?source={src}&language={lang}&currency={currency}"
  },
  "cancellation_policy": {
      "refund_conditions": [
          {
              "min_duration_before_start_time_sec": 86400,
              "refund_percent": 100
          }
      ]
  },
  "option_categories": [
      {
          "label": "sports"
      },
      {
          "label": "bike-tours"
      }
  ],
  "related_locations": [
      {
          "location": {
              "location": {
                  "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      },
      {
          "location": {
              "location": {
                  "lat_lng": {
                      "latitude": 53.339688,
                      "longitude": 6.236688
                  }
              }
          },
          "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
      }
  ],
  "price_options": [
      {
          "id": "option-1-adult",
          "title": "Adult (14+)",
          "price": {
              "currency_code": "EUR",
              "units": 20
          },
          "fees_and_taxes": {
              "per_ticket_fee": {
                  "currency_code": "EUR",
                  "units": 1
              },
              "per_ticket_tax": {
                  "currency_code": "EUR",
                  "units": 1
              }
          }
      }
  ]
}

TextFeature

Proto

message TextFeature {
  enum TextFeatureType {
    // Don't use, for backwards compatibility only.
    TEXT_FEATURE_UNKNOWN = 0;
    // Feature is an inclusion.
    TEXT_FEATURE_INCLUSION = 1;
    // Feature is an exclusion.
    TEXT_FEATURE_EXCLUSION = 2;
    // Feature is a highlight.
    TEXT_FEATURE_HIGHLIGHT = 3;
    // Feature is a "must know".
    TEXT_FEATURE_MUST_KNOW = 4;
    // Feature represents information about safety measures.
    TEXT_FEATURE_SAFETY_INFORMATION = 5;
  }
  // Feature type.
  // Required.
  TextFeatureType feature_type = 1;

  // LocalizedTextSet content of the feature. Values support both plain-text
  // and HTML-like text for basic formatting. Supported HTML formatting tags:
  //
  // Phrase tags: <br>, <strong>, <em>, <i>:
  //   Only the four tags mentioned above are supported. <br> can be used to
  //   break lines in paragraphs, and <strong>/<em>/<i> can be used to highlight
  //   important text. Any other phrase tags will be ignored.
  //
  // All other tags and custom styles are not allowed and will be removed. Any
  // URLs, anchors, and links will be stripped, and will never be displayed to
  // end-users.
  // Recommended to not exceed length of 1000 in any language. Max length: 2000.
  // Required.
  LocalizedTextSet value = 2;
}

구현 참고사항

유형	필드	Notes
enum	feature_type	필수사항입니다. 지형지물 유형, 가능한 값: `TEXT_FEATURE_INCLUSION`: 지형지물이 포함입니다. `TEXT_FEATURE_EXCLUSION`: 지형지물이 제외됩니다. `TEXT_FEATURE_HIGHLIGHT`: 지형지물이 하이라이트입니다. `TEXT_FEATURE_MUST_KNOW`: '반드시 알아야 할' 지형지물입니다. `TEXT_FEATURE_SAFETY_INFORMATION`: 기능이 안전 조치에 관한 정보를 나타냅니다.
LocalizedTextSet	값	필수사항(REQUIRED), 권장 길이: 1,000자(영문 기준), 최대 길이: 2,000자 지원되는 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>"
            }
        ]
    }
}

등급

Proto

message Rating {
  // Average rating value.
  // The value must be in the range of [1, 5] and can be omitted if and only if
  // the rating_count is zero.
  double average_value = 1;

  // Number of ratings used in calculating the value.
  // Required.
  uint64 rating_count = 2;
}

구현 참고사항

유형	필드	Notes
double	average_value	선택사항입니다. 평균 평점 값입니다. 값은 [1, 5] 의 범위 내에 있어야 하며 `rating_count`가 0인 경우에만 생략할 수 있습니다.
uint64	rating_count	필수사항입니다. 값을 계산하는 데 사용되는 평점 수입니다.

예

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

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

미디어

Proto

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

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

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

구현 참고사항

유형	필드	Notes
string	url	필수, 최대 길이: 2,000자 이 미디어 소스의 URL입니다. Google은 이 URL에서 호스팅되는 미디어를 크롤링합니다.
enum	유형	필수사항입니다. 이 미디어 소스의 유형입니다. 가능한 값은 다음과 같습니다. `MEDIA_TYPE_PHOTO`: URL에서 제공하는 미디어가 사진임을 나타냅니다.
LocalizedTextSet	attribution	선택사항, 권장 길이: 1,000, 최대 길이: 2,000 미디어 소스에 대한 저작자 표시 정보입니다. 미디어에 저작자를 표시하여 사진가 또는 대행사의 이름을 밝힐 수 있도록 해야 하는 경우에는 이 필드를 설정해야 합니다.

예

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

카테고리 정의

Proto

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

구현 참고사항

유형	필드	Notes
string	라벨	필수사항입니다. 유효한 값 목록은 제품 카테고리 문서를 참고하세요.

예

{
    "label": "sports"
}

RelatedLocation

Proto

// Defines relation between an option and a location.
message RelatedLocation {
  // Location related to an option. Can be a POI (e.g. Eiffel tower),
  // neighbourhood (e.g. Old Town) or an address / arbitrary map point.
  // Required.
  Location location = 1;

  enum RelationType {
    // Location is related but relation does not allow admission or admission is
    // irrelevant, e.g. location is a square highlighted in a city tour.
    RELATION_TYPE_RELATED_NO_ADMISSION = 0;
    // Relation grants admission to this related location.
    RELATION_TYPE_ADMISSION_TICKET = 1;
    // Relation declares an additional service which doesn't get the user into
    // the related location, e.g. a parking ticket, a temporary exhibition, etc.
    RELATION_TYPE_SUPPLEMENTARY_ADDON = 2;
  }
  // Relation type of an option for the given location.
  // Required.
  RelationType relation_type = 2;
}

구현 참고사항

옵션과 위치 간의 관계를 정의합니다.

유형	필드	Notes
위치	위치	필수사항입니다. 옵션과 관련된 위치입니다. 관심 장소 (예: 에펠탑), 인근 지역 (예: 구시가지) 또는 주소 / 임의의 지도 지점이 될 수 있습니다.
enum	relation_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

Proto

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

  // Landing page URL template for mobile. If omitted, it defaults to the `url`
  // value.
  // Max length: 2000.
  // Optional.
  string mobile_url = 2;

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

  // Localized landing page URL template for mobile.
  // Max length: 2000.
  // Max number of locales: 50.
  // Optional.
  LocalizedTextSet localized_mobile_url = 4;
}

구현 참고사항

딥 링크 정의 게재 시 확장되는 값 매개변수를 포함할 수 있습니다.

유형	필드	Notes
string	url	선택사항, 최대 길이: 2,000자 데스크톱용 방문 페이지 URL 템플릿 `url` 또는 `localized_url` 이 필요합니다.
string	mobile_url	선택사항, 최대 길이: 2,000자 모바일용 방문 페이지 URL 템플릿
LocalizedTextSet	localized_url	선택사항, 최대 길이: 2,000개, 최대 로컬 수 50개 데스크톱의 현지화된 방문 페이지 URL 템플릿 `url`와 `localized_url`가 모두 제공된 경우 사용자의 언어와 일치하는 URL이 없을 경우 전자가 대체로 사용됩니다. `url`를 사용할 수 없고 언어가 제공되지 않은 경우 영어 URL이 사용됩니다.
LocalizedTextSet	localized_mobile_url	선택사항, 최대 길이: 2,000, 최대 로컬 수 50명 모바일용 현지화된 모바일_방문 페이지 URL 템플릿

예

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

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

운영자

Proto

message Operator {
  // Operator name.
  // Recommended to not exceed length of 50 in any language. Max length: 100.
  // Required.

  LocalizedTextSet name = 1;
  // Operator business name as it is registered in Google Business Profile and
  // appearing on Google Maps.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 100.
  // Required.
  LocalizedTextSet google_business_profile_name = 4;

  // Operator phone number. Prefer full international phone number format.
  // Max length: 64.
  // Optional.
  string phone_number = 2;

  // List of operator locations.
  // Max number of locations: 1.
  // Optional.
  repeated Location locations = 3;
}

구현 참고사항

유형	필드	Notes
LocalizedTextSet	이름[지원 중단됨]	선택사항, 권장 길이: 50자, 최대 길이: 100자 이 제품 판매자의 브랜드 이름입니다. OTA는 이를 OTA 브랜드로 설정해야 합니다. 이 필드는 이제 지원 중단되었으며 제품의 brand_name으로 대체되었습니다.
LocalizedTextSet	google_business_profile_name	필수사항(REQUIRED)이며 최대 길이는 100자(영문 기준)입니다. Google 비즈니스 프로필에 등록되어 있고 Google 지도에 표시되는 사업자 업체명입니다. 운영자 예약 모듈에 참여하려면 이 필드가 필요합니다.
string	phone_number	선택사항, 최대 길이: 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…"
  }}]
}

언어 정의

Proto

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

구현 참고사항

유형	필드	Notes
string	코드	BCP-47 규정 준수 언어 코드(예: 'en' 또는 'de-CH').

예

{
    "code": "de-CH"
}

PriceOption

Proto

message PriceOption {
  // Unique ID within the price set.
  // Max length: 255.
  // Required.
  string id = 1;

  // Short description of the price option, e.g. "Adult weekday".
  // Max length: 150.
  // Required.
  string title = 2;

  // Price value, must match the final price on the checkout page, including all
  // taxes and charges, see price policy. Currency will be converted to the user
  // currency on rendering.
  // Required when is_free is false.
  google.type.Money price = 3;

  // Admission or ticket is free. Must be set to true for zero-price options.
  // Optional, default is false.
  bool is_free = 4;

  // List of geographical regions this price is applicable to. If empty,
  // applicable to all locations.
  // Optional.
  repeated GeoCriterion geo_criteria = 5;

  // Break down of fees and taxes included in the price above.
  // Optional.
  PriceFeesAndTaxes fees_and_taxes = 6;
}

구현 참고사항

유형	필드	Notes
string	id	필수, 최대 길이: 255자 가격 세트 내의 고유 ID.
string	제목	필수사항(REQUIRED)이며 최대 길이는 150자(영문 기준)입니다. 가격 옵션에 대한 간단한 설명(예: '성인 평일')입니다.
google.type.Money	가격	`is_free`이(가) false인 경우 필수사항입니다. 가격 값은 모든 세금 및 요금을 포함하여 결제 페이지의 최종 가격과 일치해야 합니다. 가격 정책을 참조하세요. 렌더링 시 통화가 사용자 통화로 변환됩니다.
bool	is_free	선택사항, 기본값은 거짓입니다. 입장권 또는 티켓은 무료입니다. 가격이 전혀 없는 옵션의 경우 true로 설정해야 합니다.
반복됨 GeoCriterion	geo_criteria	선택사항입니다. 이 가격이 적용되는 지역의 목록입니다. 비어 있으면 모든 위치에 적용됩니다.
반복된 PriceFeesAndTaxes	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
        }
    }
}

GeoCriterion

Proto

message GeoCriterion {
  // 2-letter country code as defined in ISO 3166-1.
  // Required.
  string country_code = 1;

  // If true, criterion is negative (the country code is excluded).
  bool is_negative = 2;
}

구현 참고사항

유형	필드	Notes
string	country_code	필수사항입니다. ISO 3166-1에 정의된 2자리 국가 코드입니다.
bool	is_negative	선택사항입니다. true인 경우 기준은 음수입니다 (국가 코드는 제외됨).

예

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

PriceFeesAndTaxes

Proto

message PriceFeesAndTaxes {
  // Booking fees included in the final product price for a single ticket.
  // Optional.
  google.type.Money per_ticket_fee = 1;

  // State taxes included in the final product price for a single ticket.
  // Optional.
  google.type.Money per_ticket_tax = 2;
}

구현 참고사항

유형	필드	Notes
google.type.Money	per_ticket_fee	선택사항입니다. 예약 수수료는 티켓 1장의 최종 제품 가격에 포함됩니다.
google.type.Money	per_ticket_tax	선택사항입니다. 티켓 1장의 최종 제품 가격에 주 세금이 포함됩니다.

예

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

위치

Proto

message Location {
  // At least one of (location, description) must be set, and we highly
  // recommend populating location wherever possible.
  //
  // To emphasize, both fields can be populated together, e.g. you can set
  // Central Park New York for the location and "In front of the 72 Street
  // Station" for the description.
  GeoLocation location = 1;

  // Additional description in human-readable form, e.g.
  //     "On the left side of the fountain on the Palace square".
  // At least one of (location, description) must be set.
  // Recommended to not exceed length of 1000 in any language. Max length: 2000.
  LocalizedTextSet description = 2;
}

구현 참고사항

유형	필드	Notes
GeoLocation	위치	선택사항, 위치 또는 설명 중 하나 이상이 있어야 합니다. 지리적 위치입니다.
LocalizedTextSet	설명	선택사항, 권장 길이: 1,000, 최대 길이: 2,000, 하나 이상의 위치 또는 설명이 있어야 합니다. 사람이 읽을 수 있는 형식으로 된 추가 설명(예: '궁전 광장 분수 쪽)'

예

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

GeoLocation

각 힌트 유형에 관한 자세한 내용은 사용 가이드라인을 참고하세요.

Proto

message GeoLocation {
  // Required (exactly one variant from oneof).
  // See
  // https://developers.google.com/travel/things-to-do/guides/partner-integration/location
  // for detailed guidelines.
  oneof value {
    // Place ID as defined by the Places API:
    //   https://developers.google.com/places/web-service/place-id
    //
    // Uniquely identifies a POI on Google.
    // It can be sourced using the Places API endpoints, for instance Place
    // Search or Place Autocomplete, or manually using the Find Location Matches
    // tool in Things to Do Center.
    string place_id = 1;

    // Legacy single-line address.
    // Components are expected to be comma-separated, with the first component
    // being the place name as it is displayed on Google.
    // For higher matching accuracy, use the street address shown on Google for
    // the place.
    //
    // Examples:
    // - "Colosseum, Piazza del Colosseo, 1, 00184 Roma RM, Italy"
    // - "The British Museum, Great Russell St, London WC1B 3DG, United Kingdom"
    //
    // Max length: 200.
    //
    // Deprecated: use `place_info` for higher matching accuracy, which provides
    // a separate field for the place name and supports both structured and
    // unstructured address formats.
    string address = 3 [deprecated = true];

    // Structured place information.
    PlaceInfo place_info = 4;

    // Business Profile ID, as found in the Google Business Profile settings
    // page. Use this field when sourcing locations directly from the place
    // owner, who has access to the Google Business Profile for the place and
    // can provide such ID.
    uint64 business_profile_id = 5;

    // Geographic coordinates.
    // This field can only be used to determine a city or geographical region,
    // as it is too ambiguous to identify a specific place or businesses.
    // Use `place_info` instead to match to a specific place by name and
    // coordinates.
    google.type.LatLng lat_lng = 2;
  }
}

구현 참고사항

유형	필드	Notes
string	place_id	선택사항. `place_id`, `address`, `place_info`, `business_profile_id` 또는 `lat_lng` 중 정확히 하나가 있어야 합니다. Places API에 정의된 PlaceId입니다. Google에서 관심 장소를 고유하게 식별합니다. Places API 엔드포인트(예: Place Search 또는 Place Autocomplete)를 사용하거나 할 일 센터의 일치하는 위치 찾기 도구를 사용하여 수동으로 가져올 수 있습니다.
string	주소	선택사항. `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 비즈니스 프로필 설정 페이지에 표시되는 비즈니스 프로필 ID입니다. 장소의 Google 비즈니스 프로필에 액세스할 수 있고 이 ID를 제공할 수 있는 장소 소유자로부터 직접 위치를 얻을 때 이 필드를 사용합니다.
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

Proto

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

  // Phone number, including the international prefix.
  // For higher matching accuracy, this should be the same as the phone number
  // shown on Google for the place.
  // It can include commonly used separator characters.
  // Examples: "+1 212-363-3200", "+91 562 222 7261".
  // 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;
  }
}

구현 참고사항

유형	필드	Notes
string	이름	필수사항입니다. 최대 길이: 300 장소 또는 업체 이름 일치 정확도를 높이려면 이 이름이 Google에 표시된 장소 이름과 동일해야 합니다. 소유권을 주장한 Google 비즈니스 프로필이 있는 장소의 경우 이 이름은 비즈니스 프로필에 구성된 비즈니스 이름과 동일해야 합니다.
string	phone_number	선택사항입니다. 최대 길이: 30자(영문 기준) 국가 번호를 포함한 전화번호입니다. 일치 정확도를 높이려면 이 번호가 Google에 표시되는 장소 전화번호와 동일해야 합니다. 일반적으로 사용되는 구분자 문자가 포함될 수 있습니다. 예: '+1 212-363-3200', '+91 562 222 7261'.
string	website_url	선택사항입니다. 최대 길이: 1,000자 장소에 대해 Google에 표시되는 웹사이트 URL. 가능하면 Google 지도 또는 Google 검색의 비즈니스 정보에서 연결된 URL을 사용하는 것이 좋습니다.
google.type.LatLng	좌표	선택사항입니다. 장소의 지리적 좌표입니다. 비워 두면 Google이 주소의 좌표를 추론합니다. 선택사항이지만 `coordinates` 또는 `structured_address`와 `unstructured_address` 중 하나를 제공해야 합니다.
StructuredAddress	structured_address	선택사항, `structured_address` 또는 `unstructured_address` 중 정확히 하나만 존재할 수 있으며 둘 다 있으면 안 됩니다.
string	unstructured_address	선택사항, `structured_address` 또는 `unstructured_address` 중 정확히 하나만 존재할 수 있으며 둘 다 있으면 안 됩니다.

예

"place_info": {
  "name": "Colosseum",
  "phone_number": "+39 063 99 67 700",
  "website_url": "https://colosseo.it/",
  "coordinates": {
    "latitude": 41.8902102,
    "longitude": 12.4922309
  },
  "structured_address" {
    "street_address": "Piazza del Colosseo, 1",
    "locality": "Roma",
    "administrative_area": "RM",
    "postal_code": "00184",
    "country_code": "IT"
  }
}

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

"place_info": {
  "name": "Mutitjulu Waterhole",
  "coordinates": {
    "latitude": -25.3511774,
    "longitude": 131.0326859
  }
}

StructuredAddress

Proto

message StructuredAddress {
  // Street address, including house number and any other component that cannot
  // be provided using the more specific fields defined below. It should not
  // include the place or business name, which must instead be provided
  // separately using the `name` field under `PlaceInfo`. It should also not
  // include postal code, locality or country as those should be provided using
  // the corresponding fields below.
  //
  // Examples:
  // - "Piazza del Colosseo, 1" for the Colosseum.
  // - "Great Russell St" for The British Museum.
  // - "Champ de Mars, 5 Av. Anatole France" for the Eiffel Tower.
  //
  // Max length: 200.
  // Required.
  string street_address = 1;

  // Locality, generally referring to the city/town portion of an address.
  // Examples: "New York", "Rome", "London", "Tokyo".
  // In regions of the world where localities are not well defined or do not fit
  // into this structure well, leave empty.
  // Max length: 80.
  // Optional.
  string locality = 2;

  // Highest administrative subdivision used for postal addresses of the
  // specific country or region. This can be a state, a region, a province, an
  // oblast, a prefecture, etc.
  // It can be an abbreviation or a full name, depending on how the region is
  // usually represented in the postal addresses of the specific country. For
  // example, "CA" or "California" for US addresses, "RM" for Rome province in
  // Italy.
  // Many countries don't use an administrative area in postal addresses. For
  // instance, this field should not be used for addresses in Switzerland.
  // Max length: 80.
  // Optional.
  string administrative_area = 3;

  // The postal code or zip code.
  // Examples: "75007", "WC1B 3DG", etc.
  // Required if the country supports postal codes, otherwise it should be left
  // empty.
  // Max length: 30.
  // Optional.
  string postal_code = 4;

  // Country code, as defined by Unicode's "CLDR", itself based on the ISO 3166
  // alpha-2 standard. See
  // https://unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html.
  //
  // Examples: "US" for the United States, "FR" for France, "GB" for the United
  // Kingdom, etc.
  // Max length: 2.
  // Required.
  string country_code = 5;
}

구현 참고사항

유형	필드	Notes
string	street_address	필수사항입니다. 최대 길이: 200자 아래에 정의된 더 구체적인 필드를 사용하여 제공할 수 없는 번지 및 기타 구성요소를 포함한 상세 주소 장소 또는 업체 이름을 포함하면 안 되며 대신 `PlaceInfo`의 `name` 필드를 사용하여 별도로 제공해야 합니다. 우편번호, 지역 또는 국가는 아래의 해당 필드를 사용하여 입력해야 하므로 포함하지 않아야 합니다.
string	locality	선택사항입니다. 최대 길이: 80자(영문 기준) 지역. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 비워 둡니다.
string	administrative_area	선택사항입니다. 최대 길이: 80자(영문 기준) 특정 국가 또는 지역의 우편 주소에 사용되는 가장 높은 행정 구역 단위입니다. 주, 지역, 도, 현 등일 수 있습니다. 지역이 일반적으로 특정 국가의 우편 주소로 표시되는 방식에 따라 약어 또는 전체 이름이 될 수 있습니다.
string	postal_code	선택사항입니다. 최대 길이: 30자(영문 기준) 우편번호입니다. 국가에서 우편번호를 지원하는 경우 필수 항목이며, 지원되지 않는 경우에는 비워 두어야 합니다.
string	country_code	선택사항입니다. 최대 길이: 2자 ISO 3166 alpha-2 표준을 기반으로 유니코드 'CLDR'으로 정의된 국가 코드입니다. 유니코드 문서를 참조하세요.

예

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

LocalizedTextSet

Proto

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

구현 참고사항

유형	필드	Notes
반복됨 google.type.LocalizedText	localized_texts	언어별로 현지화된 텍스트 값입니다.

예

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

CancellationPolicy

Proto

// Cancellation policy for a product.
message CancellationPolicy {
  // Defines a single refund condition. Multiple refund conditions could be
  // used together to describe "refund steps" as various durations before the
  // service start time.
  message RefundCondition {
    // Duration in seconds before the start time, until when the customer can
    // receive a refund for part of the service's cost specified in
    // `refund_percent`.
    // When unset or set to 0 the service can be cancelled at any time.
    // Optional.
    uint32 min_duration_before_start_time_sec = 1;

    // The percent that can be refunded, as long as the service booking is
    // cancelled at least `min_duration_before_start_time` before the service
    // start time, in the range of [0, 100].
    // When unset or set to 0, the service is not refundable. When set to 100
    // this service is fully refundable.
    // Optional.
    uint32 refund_percent = 2;

    // A flat fee deducted on refund. Could be used separately, or in
    // combination with the refund_percent above. In the latter case, refund
    // percent applies first, then the fee is deducted.
    // Optional.
    google.type.Money refund_fee = 3;
  }
  // Zero or more refund conditions applicable to the policy.
  // Max number of refund conditions: 10.
  repeated RefundCondition refund_conditions = 1;
}

구현 참고사항

단일 환불 조건을 정의합니다. 여러 환불 조건을 함께 사용하여 '환불 단계'를 서비스 시작 시간 이전의 다양한 기간으로 설명할 수 있습니다.

유형	필드	Notes
RefundCondition	refund_conditions	선택사항, 환불 조건의 최대 개수: 10개

RefundCondition

유형	필드	Notes
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
  }]