Feed produk

Feed produk adalah cara utama bagi Anda untuk memberikan daftar produk Rekomendasi aktivitas kepada Google yang akan ditampilkan di berbagai platform Google.

Objek ProductFeed terdiri dari satu objek FeedMetadata dan nol atau beberapa objek Product. Jika tidak ada Product yang disediakan di semua shard, semua produk akan dihapus.

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

Catatan Penerapan

Jenis Kolom Catatan
FeedMetadata feed_metadata WAJIB.
Metadata untuk feed ini.
berulang
Produk		 produk OPSIONAL.
Jika tidak disetel di semua shard, semua produk akan dihapus. feed_metadata/max_removal_share mungkin perlu ditetapkan jika sejumlah besar produk dihapus.

Contoh

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

Catatan Penerapan

Jenis Kolom Catatan
uint32 shard_id WAJIB saat total_shards_count > 1.
Berbasis nol. Shard tidak perlu ditransfer secara berurutan. Pemrosesan hanya dimulai setelah set lengkap shard diupload.
uint32 total_shards_count WAJIB, harus >= 1.
uint64 nonce WAJIB saat total_shards_count > 1.
Harus sama untuk semua shard dalam transfer.
enum processing_instruction WAJIB.
PROCESS_AS_SNAPSHOT adalah satu-satunya nilai yang didukung.
ganda max_removal_share OPSIONAL.
Bagian maksimal dari produk aktif yang diizinkan untuk dihapus melalui upload. Jika lebih banyak produk dihapus melalui transfer ini, seluruh transfer akan ditolak. Tindakan ini merupakan pengamanan terhadap penghapusan yang tidak disengaja atas sebagian besar inventaris. Dapat ditetapkan ke 1.0 untuk mengizinkan penghapusan inventaris sepenuhnya.

Contoh

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

Produk

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

Catatan Penerapan

Jenis Kolom Catatan
string id WAJIB, panjang maks 255.
String unik yang mengidentifikasi produk. Karakter yang diizinkan adalah alfanumerik, _, dan -.
LocalizedTextSet title WAJIB, panjang yang disarankan<= 50, panjang maks. 150 karakter.
Lihat Panduan judul dan deskripsi untuk detail selengkapnya.
LocalizedTextSet deskripsi DIREKOMENDASIKAN, panjang yang disarankan <= 10.000, panjang maks. 16.000 karakter.
Lihat Panduan judul dan deskripsi untuk detail selengkapnya.
berulang
TextFeature		 product_features DIREKOMENDASIKAN, jumlah fitur maksimal: 100.
Rating rating DIREKOMENDASIKAN.
Memberikan rating sangat direkomendasikan karena produk yang menampilkan rating menghasilkan rasio klik-tayang yang lebih tinggi.
berulang
Media		 related_media DIREKOMENDASIKAN, jumlah media maksimal: 30
Menyediakan lebih dari satu gambar sangat direkomendasikan. Lihat Pedoman gambar untuk panduan mendetail tentang gambar.
boolean use_media_order OPSIONAL
Petunjuk Google bahwa urutan media terkait yang tercantum dalam feed harus diperhitungkan saat memilih gambar yang akan ditampilkan.
berulang
Opsi		 opsi WAJIB, jumlah opsi maks: 20
Setiap produk harus memiliki minimal satu opsi produk.
Operator operator OPSIONAL.
enum tidak digunakan lagi
inventory_type		 OPSIONAL.
INVENTORY_TYPE_OFFICIAL hanya dapat ditetapkan di produk yang tertaut ke situs tiket resmi lokasi menarik. Kemampuan untuk menetapkan nilai ini diaktifkan hanya setelah peninjauan kelayakan.
Kolom ini tidak digunakan lagi dan diganti dengan inventory_types kolom berulang yang baru.
berulang inventory_types OPSIONAL.
Daftar berulang jenis inventaris unik yang mencakup produk ini.
INVENTORY_TYPE_OFFICIAL hanya dapat ditetapkan di produk yang tertaut ke situs tiket resmi lokasi menarik. Kemampuan untuk menetapkan nilai ini diaktifkan hanya setelah peninjauan kelayakan.
INVENTORY_TYPE_OPERATOR_DIRECT hanya dapat ditetapkan di produk yang ditautkan ke situs operator tur. Kemampuan untuk menetapkan nilai ini diaktifkan hanya setelah peninjauan kelayakan.
enum confirmation_type OPSIONAL.
FulfillmentType fulfillment_type DIREKOMENDASIKAN. Jika ditetapkan, setidaknya satu kolom di fulfillment_rype harus bernilai benar (true).
Menetapkan cara mendapatkan dokumen untuk mengonfirmasi pemesanan. Anda dapat menggunakan kombinasi, misalnya perangkat seluler + cetakan, atau dicetak di rumah + pengambilan secara langsung tersedia.
LocalizedTextSet brand_name panjang maks 100.
Nama merek yang harus ditampilkan produk. Nama ini menggantikan `operator/nama` yang sekarang tidak digunakan lagi. Hanya salah satu dari dua nilai yang dapat ditetapkan.

Contoh

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

Opsi

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

Catatan Penerapan

Jenis Kolom Catatan
string id WAJIB.
ID opsi. Harus unik di dalam suatu produk.
LocalizedTextSet title WAJIB, panjang yang direkomendasikan: 50, panjang maks: 150 karakter.
Jika hanya ada satu opsi, judul opsi mungkin sama dengan judul produk. Jika beberapa opsi produk ditampilkan, judul harus unik untuk opsi tersebut. Lihat Panduan judul dan deskripsi untuk detail selengkapnya.
LocalizedTextSet deskripsi DIREKOMENDASIKAN, panjang yang direkomendasikan: 10.000, panjang maks: 16.000.
Lihat Panduan judul dan deskripsi untuk detail selengkapnya.
DeepLink landing_page WAJIB.
Harus berisi tombol atau link untuk memesan produk. Lihat Pedoman halaman landing untuk detail selengkapnya.
DeepLink landing_page_list_view DIREKOMENDASIKAN.
Berikan link ke tampilan daftar pada tingkat tiket dan tur yang tersedia lebih tinggi, yang secara jelas menunjukkan opsi ini mungkin di antara opsi lainnya. Lihat Pedoman halaman landing untuk detail selengkapnya.
berulang
TextFeature		 option_features OPSIONAL, jumlah fitur maks: 100.
Tidak boleh menduplikasi detail dari tingkat produk.
CancellationPolicy cancellation_policy DIREKOMENDASIKAN.
berulang
Kategori		 option_categories Opsional, jumlah maksimal kategori: 100.
Kategori yang relevan untuk Opsi ini. Hal yang sangat penting, pastikan self-guided disetel untuk semua aktivitas yang bukan berbasis tur dan guided-tour disetel untuk aktivitas berbasis tur. Lihat dokumentasi Kategori produk untuk nilai tambahan yang direkomendasikan.
berulang
RelatedLocation		 related_location DIREKOMENDASIKAN, jumlah maksimum lokasi: 100.
Memberikan daftar lokasi terkait yang akurat sangat penting bagi produk untuk ditampilkan di tempat yang paling relevan, tetapi pemberian tag yang berlebihan atau pemberian data yang akurat dapat menyebabkan produk tersebut dihapus. Lihat panduan Lokasi dan lokasi menarik untuk detail selengkapnya.
bool base_ticket OPSIONAL.
Digunakan untuk menunjukkan apakah opsi produk adalah tiket masuk dasar.
berulang
PriceOption		 price_options WAJIB, setidaknya 1.
Semua harga yang mungkin untuk opsi ini. Catatan: Hanya harga Dewasa yang didukung. Jika beberapa opsi harga diberikan, harga pertama yang lulus pemeriksaan batasan geografis akan digunakan. Untuk tiket grup, harga penuh seluruh grup harus digunakan.
uint32 duration_sec OPSIONAL.
Durasi opsi dalam hitungan detik, jika berlaku, misalnya untuk tur berpemandu, perjalanan perahu, dll. Harus mencerminkan durasi pengalaman (bukan waktu validitas).
berulang
Bahasa		 bahasa DIREKOMENDASIKAN, jumlah bahasa maksimal: 100.
Bahasa yang menyediakan opsi ini. Saat penting bagi pengguna akhir untuk memahami dan/atau membaca bahasa tersebut untuk menikmati pengalamannya. Mis. relevan untuk tur terpandu.
Lokasi meeting_point OPSIONAL.
Hanya tambahkan jika relevan dan bermanfaat, misalnya tempat peserta akan bertemu dengan pemandu wisata untuk memulai tur jalan kaki, tempat peserta akan dijemput untuk tur kota, dermaga tempat perjalanan kapal pesiar akan dimulai.

Contoh

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

Catatan Penerapan

Jenis Kolom Catatan
enum feature_type WAJIB.
Jenis fitur, nilai yang memungkinkan:
  • TEXT_FEATURE_INCLUSION: Fitur adalah penyertaan.
  • TEXT_FEATURE_EXCLUSION: Fitur merupakan pengecualian.
  • TEXT_FEATURE_HIGHLIGHT: Fitur adalah sorotan.
  • TEXT_FEATURE_MUST_KNOW: Fitur adalah "wajib diketahui".
  • TEXT_FEATURE_SAFETY_INFORMATION: Fitur mewakili informasi tentang langkah-langkah pengamanan.
    		•
    LocalizedTextSet value WAJIB, panjang yang disarankan <= 1000 karakter, panjang maks: 2000.
    Tag pemformatan HTML yang didukung: br, strong, em, i
    Hanya empat tag yang disebutkan di atas yang didukung. br dapat digunakan untuk memisahkan baris dalam paragraf, dan strong/em/i dapat digunakan untuk menandai teks penting. Tag frasa lainnya akan diabaikan.
    Semua tag dan gaya kustom lainnya tidak diizinkan dan akan dihapus. Semua URL, anchor, dan link akan dihapus, dan tidak akan ditampilkan kepada pengguna akhir.

    Contoh

    {
    "feature_type": "TEXT_FEATURE_HIGHLIGHT",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
            {
                "language_code": "es",
                "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
            },
            {
                "language_code": "zh-HK",
                "text": "<p>一個非常有趣的自行車之旅.</p>"
            }
        ]
    }
}

    Rating

    Proto

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

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

    Catatan Penerapan

    Jenis Kolom Catatan
    ganda average_value OPSIONAL.
    Nilai rating rata-rata. Nilai harus berada dalam rentang [1, 5] serta dapat dihilangkan jika dan hanya jika rating_count adalah nol.
    uint64 rating_count WAJIB.
    Jumlah rating yang digunakan dalam menghitung nilai.

    Contoh

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

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

    Media

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

    Catatan Penerapan

    Jenis Kolom Catatan
    string url WAJIB, panjang maks: 2000.
    URL sumber media ini. Google akan meng-crawl media yang dihosting di URL ini.
    enum tipe WAJIB.
    Jenis sumber media ini. Nilai yang memungkinkan:
  • MEDIA_TYPE_PHOTO: Menunjukkan media yang disediakan oleh URL adalah foto.
    		•
    LocalizedTextSet attribution OPSIONAL, panjang yang direkomendasikan: 1000, panjang maks: 2000.
    Informasi atribusi tentang sumber media. Perhatikan bahwa jika atribusi diperlukan untuk ditampilkan dengan media guna memberikan kredit kepada fotografer atau agensi, kolom ini harus ditetapkan.

    Contoh

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

    Definisi kategori

    Proto

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

    Catatan Penerapan

    Jenis Kolom Catatan
    string label WAJIB. Lihat Dokumentasi kategori produk untuk daftar nilai yang valid.

    Contoh

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

    Catatan Penerapan

    Menentukan hubungan antara opsi dan lokasi.

    Jenis Kolom Catatan
    Lokasi lokasi WAJIB.
    Lokasi yang terkait dengan opsi. Dapat berupa POI (misalnya, menara Eiffel), lingkungan (misalnya Kota Tua), atau alamat / titik peta arbitrer.
    enum relation_type WAJIB.
    Jenis hubungan opsi untuk lokasi yang ditentukan. Nilai yang memungkinkan:
  • RELATION_TYPE_RELATED_NO_ADMISSION: Lokasi terkait, tetapi keterkaitannya tidak mengizinkan akses masuk atau tiket masuk tidak relevan, misalnya lokasi adalah persegi yang disorot dalam tur kota.
  • RELATION_TYPE_ADMISSION_TICKET: Hubungan memberikan izin masuk ke lokasi terkait ini.
  • RELATION_TYPE_SUPPLEMENTARY_ADDON: Hubungan mendeklarasikan layanan tambahan yang tidak mengarahkan pengguna ke lokasi terkait, misalnya tiket parkir, pameran sementara, dll.

    • Contoh

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

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

    Catatan Penerapan

    Definisi deep link. Dapat mencakup parameter nilai yang akan diperluas saat penayangan.

    Jenis Kolom Catatan
    string url OPSIONAL, panjang maks: 2000.
    Template URL halaman landing untuk desktop. `url` atau `localized_url` wajib diisi.
    string mobile_url OPSIONAL, panjang maks: 2000.
    Template URL halaman landing untuk seluler.
    LocalizedTextSet localized_url OPSIONAL, panjang maks: 2000, jumlah maks lokal 50.
    Template URL halaman landing yang dilokalkan untuk desktop. Jika url dan localized_url disediakan, yang pertama akan digunakan sebagai penggantian jika tidak ada URL yang cocok dengan lokalitas pengguna. Jika url tidak tersedia dan bahasa tidak disediakan, URL dalam bahasa Inggris akan digunakan.
    LocalizedTextSet localized_mobile_url OPSIONAL, panjang maks: 2000, jumlah lokal maks 50.
    Template URL halaman landing seluler yang dilokalkan untuk seluler.

    Contoh

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

    Operator

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

    Catatan Penerapan

    Jenis Kolom Catatan
    LocalizedTextSet nama [tidak digunakan lagi] OPSIONAL, panjang yang direkomendasikan: 50, panjang maks: 100.
    Nama merek penjual produk ini. OTA harus menetapkan ini sebagai merek OTA. Kolom ini sekarang tidak digunakan lagi dan diganti dengan brand_name di bagian produk
    LocalizedTextSet google_business_profile_name WAJIB, panjang maks: 100.
    Nama bisnis operator seperti yang terdaftar di Google Profil Bisnis dan muncul di Google Maps. Kolom ini wajib diisi untuk berpartisipasi dalam modul pemesanan operator.
    string phone_number OPSIONAL, panjang maks: 64.
    Nomor telepon operator. Lebih suka format nomor telepon internasional lengkap.
    berulang
    Lokasi    		 lokasi OPSIONAL, angka maks: 1.
    Alamat bisnis operator. Jika string alamat digunakan, sertakan nama bisnis sebagai bagian dari string alamat. Misalnya, ", ". Bisnis operator harus dapat ditemukan di Google Maps agar modul pemesanan operator dapat dipicu, operator harus mendaftarkan Google Profil Bisnis jika bisnisnya tidak dapat ditemukan di Google Maps.

    Contoh

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

    Definisi bahasa

    Proto

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

    Catatan Penerapan

    Jenis Kolom Catatan
    string kode Kode bahasa yang sesuai dengan BCP-47, seperti "en" atau "de-CH".

    Contoh

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

    Catatan Penerapan

    Jenis Kolom Catatan
    string id WAJI, panjang maks: 255.
    ID unik dalam harga yang ditetapkan.
    string title WAJIB, panjang maks: 150.
    Deskripsi singkat opsi harga, mis. "Hari kerja dewasa".
    google.type.Money price WAJIB jika is_free salah.
    Nilai harga, harus sama dengan harga akhir di halaman checkout, termasuk semua pajak dan biaya, lihat kebijakan harga. Mata uang akan dikonversi ke mata uang pengguna saat proses rendering.
    bool is_free OPSIONAL, defaultnya adalah salah.
    Tiket masuk atau tiket gratis. Harus ditetapkan ke true untuk opsi harga nol.
    berulang
    GeoCriterion    		 geo_criteria OPSIONAL.
    Daftar wilayah geografis tempat harga ini berlaku. Jika kosong, berlaku untuk semua lokasi.
    berulang
    PriceFeesAndTaxes    		 fees_and_taxes OPSIONAL.
    Perincian biaya dan pajak yang termasuk dalam harga di atas.

    Contoh

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

    Catatan Penerapan

    Jenis Kolom Catatan
    string country_code WAJIB.
    Kode negara 2 huruf seperti yang ditetapkan dalam ISO 3166-1.
    bool is_negative OPSIONAL.
    Jika benar, kriterianya negatif (kode negara tidak termasuk).

    Contoh

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

    Catatan Penerapan

    Jenis Kolom Catatan
    google.type.Money per_ticket_fee OPSIONAL.
    Biaya pemesanan termasuk dalam harga akhir produk untuk satu tiket.
    google.type.Money per_ticket_tax OPSIONAL.
    Pajak negara bagian disertakan dalam harga akhir produk untuk satu tiket.

    Contoh

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

    Lokasi

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

    Catatan Penerapan

    Jenis Kolom Catatan
    GeoLocation lokasi OPSIONAL, minimal satu lokasi atau deskripsi harus ada.
    Lokasi geografis.
    LocalizedTextSet deskripsi OPSIONAL, panjang yang direkomendasikan: 1000, panjang maks: 2000, minimal satu lokasi atau deskripsi harus ada.
    Deskripsi tambahan dalam bentuk yang dapat dibaca manusia, mis. "Di sisi kiri air mancur di alun-alun Istana".

    Contoh

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

    GeoLocation

    Lihat pedoman penggunaan untuk mendapatkan informasi lebih mendetail tentang setiap jenis petunjuk.

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

    Catatan Penerapan

    Jenis Kolom Catatan
    string place_id OPSIONAL, harus ada salah satu dari place_id, address, place_info, business_profile_id, atau lat_lng.
    PlaceId seperti yang ditentukan oleh Places API. Secara unik mengidentifikasi POI di Google. Sumber data dapat diperoleh menggunakan endpoint Places API, misalnya Place Search atau Place Autocomplete, atau secara manual menggunakan alat Pencari Kecocokan Lokasi di Pusat Rekomendasi Aktivitas.
    string alamat OPSIONAL, harus ada salah satu dari place_id, address, place_info, business_profile_id, atau lat_lng.
    TIDAK DIGUNAKAN LAGI. Alamat satu baris lama. Panjang maks: 200. Komponen diharapkan dipisahkan koma, dengan komponen pertama berupa nama tempat seperti yang ditampilkan di Google. Untuk akurasi pencocokan yang lebih tinggi, gunakan alamat yang ditampilkan di Google untuk tempat tersebut.
    PlaceInfo place_info OPSIONAL, harus ada salah satu dari place_id, address, place_info, business_profile_id, atau lat_lng.
    Informasi tempat yang terstruktur.
    uint64 business_profile_id OPSIONAL, harus ada salah satu dari place_id, address, place_info, business_profile_id, atau lat_lng.
    ID Profil Bisnis, seperti yang dapat ditemukan di halaman setelan Google Profil Bisnis. Gunakan kolom ini saat mencari lokasi langsung dari pemilik tempat, yang memiliki akses ke Google Profil Bisnis untuk tempat tersebut dan dapat memberikan ID tersebut.
    google.type.LatLng lat_lng OPSIONAL, harus ada salah satu dari place_id, address, place_info, business_profile_id, atau lat_lng.
    Koordinat geografis. Kolom ini hanya dapat digunakan untuk menentukan kota atau wilayah geografis, karena terlalu ambigu untuk mengidentifikasi tempat atau bisnis tertentu. Sebagai gantinya, gunakan place_info untuk mencocokkan tempat tertentu berdasarkan nama dan koordinat.

    Contoh

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

    Catatan Penerapan

    Jenis Kolom Catatan
    string name WAJIB. Panjang maks: 300. Tempat atau nama bisnis. Untuk mendapatkan akurasi pencocokan yang lebih tinggi, nama ini harus sama dengan nama yang ditampilkan di Google untuk tempat tersebut. Untuk tempat dengan Google Profil Bisnis yang diklaim, nama ini harus sama dengan nama bisnis yang dikonfigurasi di profil bisnis.
    string phone_number OPSIONAL. Panjang maks: 30. Nomor telepon, termasuk awalan internasional. Untuk mendapatkan akurasi pencocokan yang lebih tinggi, nomor ini harus sama dengan nomor telepon yang ditampilkan di Google untuk tempat tersebut. Atribut ini dapat menyertakan karakter pemisah yang biasa digunakan. Contoh: "+1 212-363-3200", "+91 562 222 7261".
    string website_url OPSIONAL. Panjang maks: 1.000. URL situs yang ditampilkan di Google untuk tempat, sebaiknya URL yang ditautkan dari listingan bisnis di Google Maps atau Penelusuran tempat.
    google.type.LatLng koordinat OPSIONAL. Koordinat geografis tempat. Jika dibiarkan kosong, Google akan menyimpulkan koordinat dari alamat. Opsional, tetapi coordinates atau structured_address dan unstructured_address harus diberikan.
    StructuredAddress structured_address OPSIONAL, hanya salah satu dari structured_address atau unstructured_address mungkin ada, tidak pernah keduanya.
    string unstructured_address OPSIONAL, hanya salah satu dari structured_address atau unstructured_address mungkin ada, tidak pernah keduanya.

    Contoh

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

    Catatan Penerapan

    Jenis Kolom Catatan
    string street_address WAJIB. Panjang maks: 200. Alamat, termasuk nomor rumah dan komponen lain yang tidak dapat diberikan menggunakan kolom yang lebih spesifik yang didefinisikan di bawah ini. Ini tidak boleh menyertakan tempat atau nama bisnis, yang harus diberikan secara terpisah menggunakan kolom name di bawah PlaceInfo. File ini juga tidak boleh menyertakan kode pos, lokalitas, atau negara karena harus diberikan menggunakan kolom yang sesuai di bawah ini.
    string lokalitas OPSIONAL. Panjang maks: 80. Lokalitas, umumnya mengacu pada bagian kota atau kota besar dari sebuah alamat. Di wilayah dunia dengan lokalitas yang tidak didefinisikan dengan baik atau tidak cocok dengan struktur ini, biarkan kosong.
    string administrative_area OPSIONAL. Panjang maks: 80. Subdivisi administratif tertinggi yang digunakan untuk alamat pos negara atau wilayah tertentu. Ini dapat berupa negara bagian, wilayah, provinsi, oblast, prefektur, dll. Dapat berupa singkatan atau nama lengkap, bergantung pada cara wilayah biasanya direpresentasikan di alamat pos negara tertentu.
    string postal_code OPSIONAL. Panjang maks: 30. Kode pos. Wajib diisi jika negara mendukung kode pos. Jika tidak, kolom ini harus dibiarkan kosong.
    string country_code OPSIONAL. Panjang maks: 2. Kode negara, seperti yang ditetapkan oleh Unicode "CLDR", itu sendiri didasarkan pada standar ISO 3166 alpha-2. Lihat dokumentasi Unicode.

    Contoh

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

    Catatan Penerapan

    Jenis Kolom Catatan
    berulang
    google.type.LocalizedText    		 localized_texts Nilai teks yang dilokalkan per lokal.

    Contoh

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

    Catatan Penerapan

    Menentukan satu kondisi pengembalian dana. Beberapa kondisi pengembalian dana dapat digunakan bersama untuk menjelaskan "langkah pengembalian dana" sebagai berbagai durasi sebelum waktu mulai layanan.

    Jenis Kolom Catatan
    RefundCondition refund_conditions OPSIONAL, jumlah maksimal kondisi pengembalian dana: 10.

    RefundCondition

    Jenis Kolom Catatan
    uint32 min_duration_before_start_time_sec Opsional.
    Durasi dalam detik sebelum waktu mulai, hingga saat pelanggan dapat menerima pengembalian dana untuk sebagian biaya layanan yang ditentukan dalam refund_percent. Jika tidak disetel atau disetel ke 0, layanan dapat dibatalkan kapan saja.
    uint32 refund_percent OPSIONAL.
    Persentase yang dapat dikembalikan dananya, selama pemesanan layanan dibatalkan setidaknya min_duration_before_start_time sebelum waktu mulai layanan, dalam rentang [0, 100]. Jika tidak disetel atau ditetapkan ke 0, layanan tidak dapat dikembalikan dananya. Jika ditetapkan ke 100, layanan ini dapat dikembalikan sepenuhnya.
    google.type.Money refund_fee OPSIONAL.
    Biaya tetap dipotong dari pengembalian dana. Dapat digunakan secara terpisah, atau dikombinasikan dengan refund_percent di atas. Pada kasus yang kedua, persentase pengembalian dana berlaku terlebih dahulu, lalu biaya dipotong.

    Contoh

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