Ürün feed'i

Ürün feed'i, çeşitli Google platformlarında gösterilecek Yapılacaklar ürünlerinin listesini Google'a sağlamanın birincil yöntemidir.

ProductFeed nesnesi, tek bir FeedMetadata nesnesinden ve sıfır veya daha fazla Product nesnesinden oluşur. Tüm parçalarda Product sağlanmazsa tüm ürünler silinir.

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

Uygulama Notları

Tür Alan Notlar
FeedMetadata feed_metadata ZORUNLU.
Bu feed ile ilgili meta veriler.
tekrarlanan
Ürün		 ürün İSTEĞE BAĞLI.
Tüm parçalarda ayarlanmadığında tüm ürünler silinir. Çok sayıda ürün kaldırıldığında feed_metadata/max_removal_share özelliğinin ayarlanması gerekebilir.

Örnekler

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

Uygulama Notları

Tür Alan Notlar
uint32 shard_id total_shards_count > 1 olduğunda ZORUNLUDUR.
Sıfır tabanlı. Parçaların sırayla aktarılması gerekmez. İşleme, yalnızca tam kırık grubu yüklendikten sonra başlar.
uint32 total_shards_count ZORUNLU, >= 1 olmalıdır.
uint64 tek seferlik rastgele sayı total_shards_count > 1 olduğunda ZORUNLUDUR.
Aktarım içindeki tüm parçalar için aynı olmalıdır.
enum processing_instruction ZORUNLU.
Desteklenen tek değerdir PROCESS_AS_SNAPSHOT.
double max_removal_share İSTEĞE BAĞLI.
Bir yükleme tarafından kaldırılmasına izin verilen etkin ürünlerin maksimum payı. Bu aktarımla daha fazla ürün kaldırılırsa aktarımın tamamı reddedilir. Bu, envanterin önemli bir bölümünün yanlışlıkla kaldırılmasına karşı bir korumadır. Envanterin tamamen yayından kaldırılmasını sağlamak için 1,0 olarak ayarlanabilir.

Örnekler

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

Ürün

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

Uygulama Notları

Tür Alan Notlar
dize id ZORUNLU, maks. uzunluk 255.
Ürünü tanımlayan benzersiz bir dize. İzin verilen karakterler alfanümerik, _ ve -.
LocalizedTextSet ünvan ZORUNLU, önerilen uzunluk<= 50, maks. uzunluk 150 karakter.
Daha fazla ayrıntı için Başlık ve açıklama yönergelerine bakın.
LocalizedTextSet açıklama ÖNERİLİR, önerilen uzunluk <= 10.000, maksimum uzunluk 16.000 karakter.
Daha fazla ayrıntı için Başlık ve açıklama yönergelerine bakın.
tekrarlanan
TextFeature		 product_features ÖNERİLİR, maksimum özellik sayısı: 100.
Puan rating ÖNERİLİR.
Puan gösteren ürünler daha yüksek tıklama oranı sağladığından puan sağlamanız kesinlikle önerilir.
tekrarlanan
Medya		 related_media ÖNERİLİR, maksimum medya sayısı: 30
Birden fazla resim sağlamanız önemle tavsiye edilir. Resimler hakkında ayrıntılı kılavuz için Resim kurallarına bakın.
boolean use_media_order İSTEĞE BAĞLI
Google'a, gösterilecek resmi seçerken ilgili medyanın feed'de listelendiği sıranın dikkate alınması gerektiğini söyleyin.
tekrarlanan
Seçenek		 seçenekler ZORUNLU, maksimum seçenek sayısı: 20
Her üründe en az bir ürün seçeneği olmalıdır.
Operatör operatör İSTEĞE BAĞLI.
enum kullanımdan kaldırıldı
inventory_type		 İSTEĞE BAĞLI.
INVENTORY_TYPE_OFFICIAL, yalnızca önemli yerin resmi bilet sitesine bağlantı veren ürünlerde ayarlanabilir. Bu değeri ayarlama özelliği yalnızca uygunluk incelemesinden sonra etkinleştirilir.
Bu alanın desteği sonlandırıldı ve alanın yerine yeni tekrarlanan inventory_types alanı kullanılacak.
tekrarlı inventory_types İSTEĞE BAĞLI.
Bu ürünün ait olduğu benzersiz envanter türlerinin tekrarlanan listesi.
INVENTORY_TYPE_OFFICIAL, yalnızca önemli yerin resmi bilet sitesine bağlantı veren ürünlerde ayarlanabilir. Bu değeri ayarlama özelliği yalnızca uygunluk incelemesinden sonra etkinleştirilir.
INVENTORY_TYPE_OPERATOR_DIRECT yalnızca tur operatörü sitesine bağlantı veren ürünlerde ayarlanabilir. Bu değeri ayarlama özelliği yalnızca uygunluk incelemesinden sonra etkinleştirilir.
enum confirmation_type İSTEĞE BAĞLI.
FulfillmentType fulfillment_type ÖNERİLİR. Ayarlanırsa fulfillment_rype içindeki en az bir alan doğru olmalıdır.
Rezervasyonu onaylamak için belge alma yöntemlerini belirler. Mobil + basılı veya basılı ya da evde basılı + şahsi teslim alma gibi kombinasyonlar kullanılabilir.
LocalizedTextSet brand_name maks. uzunluk 100'dür.
Ürünün gösterilmesi gereken marka adı. Bu ad, artık kullanımdan kaldırılan "operatör/ad"ın yerini alır. İki değerden yalnızca biri ayarlanabilir.

Örnekler

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

Option

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

Uygulama Notları

Tür Alan Notlar
dize id ZORUNLU.
Seçenek kimliği. Bir ürün içinde benzersiz olmalıdır.
LocalizedTextSet ünvan ZORUNLU, önerilen uzunluk: 50, maks. uzunluk: 150 karakter.
Tek bir seçenek varsa seçenek başlığı ürün başlığıyla aynı olabilir. Birden fazla ürün seçeneği sunulursa başlık seçeneğe özgü olmalıdır. Daha fazla ayrıntı için Başlık ve açıklama yönergelerine bakın.
LocalizedTextSet açıklama ÖNERİLİR, önerilen uzunluk: 10.000, maksimum uzunluk: 16.000.
Daha fazla ayrıntı için Başlık ve açıklama yönergelerine bakın.
DeepLink landing_page ZORUNLU.
Ürünü ayırtmak için kullanılacak düğme veya bağlantı içermelidir. Daha ayrıntılı bilgi için Açılış sayfası yönergeleri bölümüne bakın.
DeepLink landing_page_list_view ÖNERİLİR.
Mevcut biletlerin ve turların daha üst düzey bir liste görünümüne bağlantı verin. Bu seçenek, diğer seçeneklerin yanında belirgin bir şekilde gösterilmelidir. Daha ayrıntılı bilgi için Açılış sayfası yönergeleri bölümüne bakın.
tekrarlanan
TextFeature		 option_features İSTEĞE BAĞLI, maksimum özellik sayısı: 100.
Ayrıntılar, ürün düzeyinden kopyalanmamalıdır.
CancellationPolicy cancellation_policy ÖNERİLİR.
tekrarlanan
Kategori		 option_categories İsteğe bağlı, maksimum kategori sayısı: 100.
Bu Seçenek ile ilgili kategoriler. Bu nedenle, tura dayalı olmayan tüm etkinlikler için self-guided politikasının, tur tabanlı etkinlikler için de guided-tour ayarlandığından emin olun. Önerilen diğer değerler için Ürün kategorisi belgelerine bakın.
tekrarlanan
RelatedLocation		 related_location ÖNERİLİR, maksimum konum sayısı: 100.
Alakalı konumların doğru listesini sunmak, bir ürünün en alakalı yerlerde gösterilmesi için son derece önemlidir ancak fazla etiketleme veya doğru veri sağlamak, ürünün kaldırılmasına neden olur. Daha fazla bilgi için Konum ve önemli yer rehberine bakın.
bool base_ticket İSTEĞE BAĞLI.
Ürün seçeneğinin temel giriş bileti olup olmadığını belirtmek için kullanılır.
tekrarlı
PriceOption		 price_options En az 1 ZORUNLU.
Bu seçenek için mümkün olan tüm fiyatlar. Not: Yalnızca Yetişkinler için fiyat desteklenir. Birden fazla fiyat seçeneği sağlandıysa coğrafi kısıtlama kontrolünden geçen ilk fiyat kullanılır. Grup biletleri için bunun yerine grubun tamamının tam fiyatı kullanılmalıdır.
uint32 duration_sec İSTEĞE BAĞLI.
Geçerli olduğunda, seçeneğin saniye cinsinden süresi (ör.rehberli turlar, tekne gezileri vb. için). Bu, deneyimin süresini yansıtmalıdır (geçerlilik süresini değil).
tekrarlanan
Dil		 diller ÖNERİLİR, maksimum dil sayısı: 100.
Seçeneğin kullanıma sunulduğu diller. Son kullanıcının deneyimden keyif alması için dili anlamasının ve/veya okumasının önemli olduğu durumlar. Ör. rehberli bir turla alakalı.
Konum meeting_point İSTEĞE BAĞLI.
Yalnızca alakalı ve faydalı olan yerleri ekleyin (ör. katılımcının yürüyüş turu başlatmak için tur rehberiyle buluşacağı yer, şehir turu için alınacak yer, gemi turunun başlayacağı iskele).

Örnekler

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

Uygulama Notları

Tür Alan Notlar
enum feature_type ZORUNLU.
Özellik türü, olası değerler:
  • TEXT_FEATURE_INCLUSION: Bu özellik, kapsayıcıdır.
  • TEXT_FEATURE_EXCLUSION: Bu özellik bir hariç tutma işlemidir.
  • TEXT_FEATURE_HIGHLIGHT: Öne çıkan özellik.
  • TEXT_FEATURE_MUST_KNOW: Bu özellik, "bilinmesi gereken" bir özelliktir.
  • TEXT_FEATURE_SAFETY_INFORMATION: Özellik, güvenlik önlemleriyle ilgili bilgileri temsil eder.
    		•
    LocalizedTextSet value ZORUNLU, önerilen uzunluk <= 1000 karakter, maksimum uzunluk: 2000.
    Desteklenen HTML biçimlendirme etiketleri: br, strong, em, i
    Yalnızca yukarıda belirtilen dört etiket desteklenir. br, paragraflardaki satırları bölmek için, strong/em/i ise önemli metni vurgulamak için kullanılabilir. Diğer tüm kelime öbeği etiketleri yoksayılır.
    Diğer hiçbir etiket ve özel stile izin verilmez ve bu etiketler kaldırılacaktır. Tüm URL'ler, bağlantılar ve bağlantılar kaldırılır ve hiçbir zaman son kullanıcılara gösterilmez.

    Örnekler

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

    Derecelendirme

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

    Uygulama Notları

    Tür Alan Notlar
    double average_value İSTEĞE BAĞLI.
    Ortalama puan değeri. Değer [1, 5] aralığında olmalıdır ve yalnızca rating_count sıfırsa atlanabilir.
    uint64 rating_count ZORUNLU.
    Değerin hesaplanmasında kullanılan puan sayısı.

    Örnekler

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

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

    Medya

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

    Uygulama Notları

    Tür Alan Notlar
    dize url ZORUNLU, maks. uzunluk: 2000.
    Bu medya kaynağının URL'si. Google, bu URL'de barındırılan medyayı tarar.
    enum tür ZORUNLU.
    Bu medya kaynağının türü. Olası değerler:
  • MEDIA_TYPE_PHOTO: URL tarafından sağlanan medyanın bir fotoğraf olduğunu belirtir.
    		•
    LocalizedTextSet attribution İSTEĞE BAĞLI, önerilen uzunluk: 1000, maks. uzunluk: 2000.
    Medyanın kaynağıyla ilgili ilişkilendirme bilgileri. İlişkilendirmenin, fotoğrafçıya veya ajansa atıfta bulunmak için medyayla birlikte görüntülenmesi gerekiyorsa bu alanın ayarlanması gerektiğini unutmayın.

    Örnekler

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

    Kategori tanımı

    Proto

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

    Uygulama Notları

    Tür Alan Notlar
    dize etiket ZORUNLU. Geçerli değerler listesi için ürün kategorisi belgelerine bakın.

    Örnekler

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

    Uygulama Notları

    Bir seçenek ile konum arasındaki ilişkiyi tanımlar.

    Tür Alan Notlar
    Konum konum ZORUNLU.
    Bir seçenekle ilgili konum. Bir ÖY (ör. Eyfel kulesi), bir mahalle (ör. Eski Şehir) veya bir adres / rastgele harita noktası olabilir.
    enum relation_type ZORUNLU.
    Belirtilen konum için bir seçeneğin ilişki türü. Olası değerler:
  • RELATION_TYPE_RELATED_NO_ADMISSION: Konum alakalı ancak ilişki girişe izin vermiyor veya girişe izin vermiyor. Örneğin, şehir turunda konumun vurgulandığı bir kare olması.
  • RELATION_TYPE_ADMISSION_TICKET: İlişki, bu ilgili konuma giriş izni verir.
  • RELATION_TYPE_SUPPLEMENTARY_ADDON: İlişki, kullanıcıyı ilgili konuma getirmeyen ek bir hizmet (ör.otopark bileti, geçici sergi vb.) beyan eder.

    • Örnekler

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

    Uygulama Notları

    Derin bağlantı tanımı. Sunum sırasında genişletilecek değer parametreleri içerebilir.

    Tür Alan Notlar
    dize url İSTEĞE BAĞLI, maks. uzunluk: 2000.
    Masaüstü için açılış sayfası URL'si şablonu. "url" veya "localized_url" gereklidir.
    dize mobile_url İSTEĞE BAĞLI, maks. uzunluk: 2000.
    Mobil cihazlar için açılış sayfası URL şablonu.
    LocalizedTextSet localized_url İSTEĞE BAĞLI, maksimum uzunluk: 2000, maksimum yerel sayısı 50.
    Masaüstü için yerelleştirilmiş açılış sayfası URL'si şablonu. Hem url hem de localized_url sağlanmışsa URL'nin kullanıcının yerel ayarıyla eşleşmemesi ihtimaline karşı birinci taraf yedek olarak kullanılır. url kullanılamıyorsa ve dil sağlanmazsa İngilizce URL kullanılır.
    LocalizedTextSet localized_mobile_url İSTEĞE BAĞLI, maks. uzunluk: 2000, maksimum yerel sayısı 50.
    Mobil cihazlar için yerelleştirilmiş mobil_açılış sayfası URL'si şablonu.

    Örnekler

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

    Operatör

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

    Uygulama Notları

    Tür Alan Notlar
    LocalizedTextSet ad [kullanımdan kaldırıldı] İsteğe bağlı, önerilen uzunluk: 50, maks. uzunluk: 100.
    Bu ürünün satıcısının marka adı. OTA'lar bunu OTA markası olarak ayarlamalıdır. Bu alan kullanımdan kaldırılmıştır ve ürünler altında brand_name ile değiştirilmiştir
    LocalizedTextSet google_business_profile_name ZORUNLU, maks. uzunluk: 100.
    Google İşletme Profili'nde kayıtlı olduğu ve Google Haritalar'da göründüğü şekliyle operatör işletme adı. Operatör rezervasyon modülüne katılmak için bu alan gereklidir.
    dize phone_number İSTEĞE BAĞLI, maksimum uzunluk: 64.
    Operatör telefon numarası. Tam uluslararası telefon numarası biçimini tercih ediyorum.
    tekrarlanan
    Konum    		 konumlar İSTEĞE BAĞLI, maks. sayı: 1.
    Operatörün işletme adresi. Adres dizesi kullanılıyorsa işletme adını adres dizesinin bir parçası olarak ekleyin. Ör. ", ". Operatör rezervasyon modülünün tetiklenmesi için operatör işletme Google Haritalar'da bulunabilir olmalıdır. İşletme Google Haritalar'da bulunamıyorsa operatör bir Google İşletme Profili kaydetmelidir.

    Örnekler

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

    Dil tanımı

    Proto

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

    Uygulama Notları

    Tür Alan Notlar
    dize kod "en" veya "de-CH" gibi BCP-47 uyumlu bir dil kodu.

    Örnekler

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

    Uygulama Notları

    Tür Alan Notlar
    dize id ZORUNLU, maks. uzunluk: 255.
    Ayarlanan fiyat içindeki benzersiz kimlik.
    dize ünvan ZORUNLU, maks.uzunluk: 150.
    Fiyat seçeneğinin kısa açıklaması, ör. "Yetişkin hafta içi".
    google.type.Money fiyat is_free yanlış olduğunda zorunludur.
    Fiyat değeri, tüm vergiler ve ücretler dahil olmak üzere ödeme sayfasındaki son fiyatla eşleşmelidir. Fiyat politikasını inceleyin. Para birimi, oluşturma sırasında kullanıcının para birimine dönüştürülür.
    bool is_free İSTEĞE BAĞLI, varsayılan değer false (yanlış) şeklindedir.
    Giriş veya bilet ücretsizdir. Sıfır fiyat seçenekleri için doğru değerine ayarlanmalıdır.
    tekrarlanan
    GeoCriterion    		 geo_criteria İSTEĞE BAĞLI.
    Bu fiyatın geçerli olduğu coğrafi bölgelerin listesi. Boşsa tüm konumlar için geçerli olur.
    tekrarlanan
    PriceFeesAndTaxes    		 fees_and_taxes İSTEĞE BAĞLI.
    Yukarıdaki fiyata dahil olan ücretlerin ve vergilerin dökümü.

    Örnekler

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

    Uygulama Notları

    Tür Alan Notlar
    dize country_code ZORUNLU.
    ISO 3166-1'de tanımlandığı şekilde 2 harfli ülke kodu.
    bool is_negative İSTEĞE BAĞLI.
    Doğru ise, ölçüt negatif olur (ülke kodu hariç tutulur).

    Örnekler

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

    Uygulama Notları

    Tür Alan Notlar
    google.type.Money per_ticket_fee İSTEĞE BAĞLI.
    Rezervasyon ücretleri, tek biletin nihai ürün fiyatına dahildir.
    google.type.Money per_ticket_tax İSTEĞE BAĞLI.
    Tek bir bilet için nihai ürün fiyatına dahil olan devlet vergileridir.

    Örnekler

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

    Konum

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

    Uygulama Notları

    Tür Alan Notlar
    GeoLocation konum İSTEĞE BAĞLI, konum veya açıklamadan en az biri mevcut olmalıdır.
    Coğrafi konum.
    LocalizedTextSet açıklama İSTEĞE BAĞLI, önerilen uzunluk: 1000, maksimum uzunluk: 2000, en az bir yer veya açıklama bulunmalıdır.
    Ek açıklama, kullanıcıların okuyabileceği biçimde olmalıdır, ör. "Saray meydanındaki çeşmenin sol tarafında".

    Örnekler

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

    GeoLocation

    Her ipucu türü hakkında daha ayrıntılı bilgi için kullanım yönergelerini inceleyin.

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

    Uygulama Notları

    Tür Alan Notlar
    dize place_id İSTEĞE BAĞLI; place_id, address, place_info, business_profile_id veya lat_lng değerlerinden tam olarak biri bulunmalıdır.
    Places API tarafından tanımlandığı şekliyle PlaceId. Google'da bir ÖY'yi benzersiz şekilde tanımlar. Bu verilerin kaynağı, Yer Arama veya Otomatik Yer Tamamlama gibi Places API uç noktaları kullanılarak ya da Things to Do Center'daki Konum Eşleşmelerini Bul aracı kullanılarak manuel olarak yapılabilir.
    dize adres İSTEĞE BAĞLI; place_id, address, place_info, business_profile_id veya lat_lng değerlerinden tam olarak biri bulunmalıdır.
    KULLANIMDAN KALDIRILDI. Eski tek satırlı adres. Maksimum uzunluk: 200. Bileşenlerin virgülle ayrılmış olması beklenir. İlk bileşen, Google'da gösterildiği şekliyle yer adı olacaktır. Eşleşmenin daha doğru olması için yerin Google'da gösterilen açık adresini kullanın.
    PlaceInfo place_info İSTEĞE BAĞLI; place_id, address, place_info, business_profile_id veya lat_lng değerlerinden tam olarak biri bulunmalıdır.
    Yapılandırılmış yer bilgileri.
    uint64 business_profile_id İSTEĞE BAĞLI; place_id, address, place_info, business_profile_id veya lat_lng değerlerinden tam olarak biri bulunmalıdır.
    Google İşletme Profili ayarlar sayfasında bulunan İşletme Profili kimliği. Konumları doğrudan yer için Google İşletme Profili'ne erişimi olan ve bu tür bir kimlik sağlayabilecek yer sahibinden tedarik ederken bu alanı kullanın.
    google.type.LatLng lat_lng İSTEĞE BAĞLI; place_id, address, place_info, business_profile_id veya lat_lng değerlerinden tam olarak biri bulunmalıdır.
    Coğrafi koordinatlar. Bu alan, belirli bir yeri veya işletmeleri tanımlamak için çok belirsiz olduğundan yalnızca bir şehri veya coğrafi bölgeyi belirlemek için kullanılabilir. Belirli bir yeri ada ve koordinatlara göre eşleştirmek için bunun yerine place_info kullanın.

    Örnekler

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

    Uygulama Notları

    Tür Alan Notlar
    dize ad ZORUNLU. Maksimum uzunluk: 300. Yer veya işletme adı. Eşleşmenin daha doğru olması için bu ad, ilgili yerin Google'da gösterilen adıyla aynı olmalıdır. Google İşletme Profili hak talebinde bulunulmuş yerler için bu ad, işletme profilinde yapılandırılan işletme adıyla aynı olmalıdır.
    dize phone_number İSTEĞE BAĞLI. Maksimum uzunluk: 30. Uluslararası önek de dahil olmak üzere telefon numarası. Daha yüksek eşleşme doğruluğu için bu numara, ilgili yer için Google'da gösterilen telefon numarasıyla aynı olmalıdır. Yaygın olarak kullanılan ayırıcı karakterleri içerebilir. Örnekler: "+1 212-363-3200", "+91 562 222 7261".
    dize website_url İSTEĞE BAĞLI. Maksimum uzunluk: 1.000. Yer için Google'da gösterilen web sitesinin URL'si; tercihen Google Haritalar'daki veya yerle ilgili Arama'daki işletme girişinden bağlantı verilen URL'dir.
    google.type.LatLng koordinatlar İSTEĞE BAĞLI. Yerin coğrafi koordinatları. Boş bırakılırsa Google, koordinatları adresten belirler. İsteğe bağlıdır ancak coordinates veya structured_address ve unstructured_address özelliklerinden biri sağlanmalıdır.
    StructuredAddress structured_address İSTEĞE BAĞLI. structured_address veya unstructured_address özelliklerinden tam olarak biri mevcut olabilir, ikisini birden kullanamazsınız.
    dize unstructured_address İSTEĞE BAĞLI. structured_address veya unstructured_address özelliklerinden tam olarak biri mevcut olabilir, ikisini birden kullanamazsınız.

    Örnekler

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

    Uygulama Notları

    Tür Alan Notlar
    dize street_address ZORUNLU. Maksimum uzunluk: 200. Bina numarası ve aşağıda tanımlanan daha spesifik alanlar kullanılarak sağlanamayan diğer bilgiler dahil olmak üzere açık adres. Yer veya işletme adını içermemelidir. Bu ad, PlaceInfo altındaki name alanı kullanılarak ayrıca sağlanmalıdır. Ayrıca posta kodu, bölge veya ülke bilgisi de içermemelidir. Bunlar aşağıdaki ilgili alanlar kullanılarak sağlanmalıdır.
    dize şehir İSTEĞE BAĞLI. Maksimum uzunluk: 80. Konum, genellikle bir adresin şehir veya ilçe bölümünü ifade eder. Dünyanın iyi tanımlanmadığı veya bu yapıya uygun olmadığı bölgeleri boş bırakın.
    dize administrative_area İSTEĞE BAĞLI. Maksimum uzunluk: 80. Belirli bir ülkenin veya bölgenin posta adresleri için kullanılan en yüksek idari alt birim. Bu bir eyalet, bölge, il, oblast, vilayet vb. olabilir. Bölgenin, ilgili ülkenin posta adreslerinde genellikle nasıl temsil edildiğine bağlı olarak bir kısaltma veya tam ad olabilir.
    dize postal_code İSTEĞE BAĞLI. Maksimum uzunluk: 30. Posta kodu. Ülke posta kodlarını destekliyorsa gereklidir; aksi takdirde boş bırakılmalıdır.
    dize country_code İSTEĞE BAĞLI. Maksimum uzunluk: 2. ISO 3166 alfa-2 standardına göre Unicode "CLDR" ile tanımlanan ülke kodu. Unicode dokümanlarına bakın.

    Örnekler

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

    Uygulama Notları

    Tür Alan Notlar
    tekrarlanan
    google.type.LocalizedText    		 localized_texts Her yerel ayar için yerelleştirilmiş metin değerleri.

    Örnekler

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

    Uygulama Notları

    Tek bir geri ödeme koşulu tanımlar. "Geri ödeme adımlarını" hizmetin başlangıç zamanından önceki çeşitli süreler olarak tanımlamak için birden fazla geri ödeme koşulu kullanılabilir.

    Tür Alan Notlar
    RefundCondition refund_conditions İSTEĞE BAĞLI, maksimum geri ödeme koşulu sayısı: 10.

    RefundCondition

    Tür Alan Notlar
    uint32 min_duration_before_start_time_sec İsteğe bağlı.
    Başlangıç zamanından önceki, refund_percent özelliğinde belirtilen hizmet maliyetinin bir kısmı için müşterinin geri ödeme alabileceği zamana kadar geçen saniye cinsinden süre. Ayarlanmazsa veya 0'a ayarlanırsa hizmet herhangi bir zamanda iptal edilebilir.
    uint32 refund_percent İSTEĞE BAĞLI.
    Hizmet rezervasyonu, hizmetin başlangıç zamanından en az min_duration_before_start_time önce [0, 100] aralığında iptal edildiği sürece geri ödeme yapılabilecek yüzde. Ayarlanmaz veya 0 olarak ayarlanırsa hizmet için geri ödeme yapılmaz. 100 olarak ayarlandığında bu hizmet için tamamen geri ödeme yapılabilir.
    google.type.Money refund_fee İSTEĞE BAĞLI.
    Geri ödemeden düşülen sabit bir ücrettir. Ayrı olarak veya yukarıdaki refund_percent ile birlikte kullanılabilir. İkinci durumda, önce geri ödeme yüzdesi uygulanır ve ücret düşülür.

    Örnekler

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