Ürün feed'i

Ürün feed'i, Google'a Nesneler listesi sağlamanın birincil yoludur. çeşitli Google yüzeylerinde gösterilecek ürünler yapmak.

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

ProductFeed

Protokol

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'in meta verileri.
tekrarlı
Ürün		 ürün İSTEĞE BAĞLI.
Tüm kırıklarda ayarlanmadan bırakılırsa tümü ürünler silinir. feed_metadata/max_removal_share. çok sayıda ürün kaldırıldığında 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

Protokol

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 Şu durumlarda zorunludur: total_shards_count > 1.
Sıfır tabanlı. Parçaların sırayla aktarılmasına gerek yoktur. İşleme başlangıç tarihi ancak tam bir parça grubu yüklendikten sonra otomatik olarak gösterilir.
uint32 total_shards_count Zorunlu, >= 1 olmalıdır.
uint64 tek seferlik rastgele sayı Şu durumlarda zorunludur: total_shards_count > 1.
. Aktarım içindeki tüm kırıklar için aynı olmalıdır.
enum processing_instruction ZORUNLU.
Tek değer PROCESS_AS_SNAPSHOT desteklenir.
double max_removal_share İSTEĞE BAĞLI.
Aşağıdaki etkin ürünlerin maksimum payı: bir yüklemeyle kaldırılmasına izin veriliyor. Daha fazla ürün kaldırılırsa tüm aktarım reddedilir. Bu, yanlışlıkla yayından kaldırılmasını önlemek için envanter. Envanterin tamamının 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

Protokol

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.
belirler. İzin verilen karakterler alfanümerik, _ ve - şeklindedir.
LocalizedTextSet title ZORUNLU, önerilen uzunluk<= 50, maks. uzunluk 150 karakter.
. Daha fazla ayrıntı için Başlık ve açıklama yönergelerini inceleyin.
LocalizedTextSet açıklama ÖNERİLİR, önerilen uzunluk <= 10.000, maks. uzunluk 16.000 karakter.
. Daha fazla ayrıntı için Başlık ve açıklama yönergelerini inceleyin.
repeated
TextFeature		 product_features ÖNERİLİR, maksimum özellik sayısı: 100.
Derecelendirme derecelendirme ÖNERİLİR.
Puan gösteren ürünler daha yüksek tıklama oranı sağladığından puan sağlamanız önemle tavsiye edilir.
repeated
Media		 related_media ÖNERİLİR, maksimum medya sayısı: 30
Birden fazla resim sağlamanız kesinlikle önerilir. Resimlerle ilgili ayrıntılı kılavuz için Resim kuralları bölümüne bakın.
boolean use_media_order İSTEĞE BAĞLI
Google, gösterilecek resmi seçerken ilgili medyanın feed'de listelenme sırasının dikkate alınması gerektiğini hatırlatır.
repeated
Option		 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 deprecated
inventory_type		 İSTEĞE BAĞLI.
. INVENTORY_TYPE_OFFICIAL yalnızca bir noktanın resmi bilet sitesine bağlantı veren ürünlerde ayarlanabilir. ilgi alanı. 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 envanter_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 bir noktanın resmi bilet sitesine bağlantı veren ürünlerde ayarlanabilir. ilgi alanı. 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 alanındaki en az bir alanın doğru olması gerekir.
. Rezervasyonu onaylamak için doküman alma yöntemlerini ayarlar. Kombinasyonlar: Mümkün (ör. cep telefonu + basılı veya evde basılı ürün + mağazadan teslim alma) kullanılabilir.
LocalizedTextSet brand_name maks. uzunluk 100.
. Ürünün gösterilmesi gereken marka adı. Bu ad, kullanımdan kaldırılan adın yerini alır. "operatör/ad". İ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?language={lang}&currency={currency}"
    },
    "cancellation_policy": {
        "refund_conditions": [
            {
                "min_duration_before_start_time_sec": 86400,
                "refund_percent": 100
            }
        ]
    },
    "option_categories": [
        {
            "label": "sports"
        },
        {
            "label": "bike-tours"
        }
    ],
    "related_locations": [
        {
            "location": {
                "location": {
                    "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        },
        {
            "location": {
                "location": {
                    "lat_lng": {
                        "latitude": 53.339688,
                        "longitude": 6.236688
                    }
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        }
    ],
    "price_options": [
        {
            "id": "option-1-adult",
            "title": "Adult (14+)",
            "price": {
                "currency_code": "EUR",
                "units": 20
            },
            "fees_and_taxes": {
                "per_ticket_fee": {
                    "currency_code": "EUR",
                    "units": 1
                },
                "per_ticket_tax": {
                    "currency_code": "EUR",
                    "units": 1
                }
            }
        }
    ]},{
      "id": "option-2",
      "title": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Sunrise tour"
              },
              {
                  "language_code": "es",
                  "text": "Tour al amanecer"
              },
              {
                  "language_code": "zh-HK",
                  "text": "日出之旅"
              }
          ]
      },
      "landing_page": {
          "url": "https://www.danstour.com/sunrise?language={lang}&currency={currency}"
      },
      "cancellation_policy": {
          "refund_conditions": [
              {
                  "min_duration_before_start_time_sec": 86400,
                  "refund_percent": 100
              }
          ]
      },
      "option_categories": [
          {
              "label": "sports"
          },
          {
              "label": "bike-tours"
          }
      ],
      "related_locations": [
          {
              "location": {
                  "location": {
                      "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                  }
              },
              "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
          }
      ],
      "price_options": [
          {
              "id": "option-2-adult",
              "title": "Adult (14+)",
              "price": {
                  "currency_code": "EUR",
                  "units": 20,
                  "nanos": 0
              }
          }
      ],
      "meeting_point": {
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          },
          "description": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Sunrise tour"
                  },
                  {
                      "language_code": "es",
                      "text": "Tour al amanecer"
                  },
                  {
                      "language_code": "zh-HK",
                      "text": "日出之旅"
                  }
              ]
          }
      }
    }
  ],
  "related_media": [
      {
          "url": "http://www.danstour.com/photo1.jpg",
          "type": "MEDIA_TYPE_PHOTO"
      },
      {
          "url": "http://www.danstour.com/photo2.jpg",
          "type": "MEDIA_TYPE_PHOTO",
          "attribution": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Dans Photos"
                  }
              ]
          }
      }
  ],
  "operator": {
      "name": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Dans Bikes"
              }
          ]
      },
      "phone_number": "01234567",
      "locations": [{
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          }
        }]
  },
  "inventory_types": ["INVENTORY_TYPE_OPERATOR_DIRECT"]
}

Option

Protokol

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 Ürün içinde benzersiz olmalıdır.
LocalizedTextSet title 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çenekleri sunuluyorsa başlık o seçeneğe özgü olmalıdır. Daha fazla ayrıntı için Başlık ve açıklama yönergelerini inceleyin.
LocalizedTextSet açıklama ÖNERİLİR, önerilen uzunluk: 10.000, maks. uzunluk: 16.000.
. Daha fazla ayrıntı için Başlık ve açıklama yönergelerini inceleyin.
DeepLink landing_page ZORUNLU.
Ürün rezervasyonu için düğme veya bağlantı içermelidir. Daha fazla bilgi için Açılış sayfası yönergeleri bölümüne bakın.
DeepLink landing_page_list_view ÖNERİLİR.
Mevcut bilet ve turların daha yüksek bir düzeyde yer aldığı bir liste görünümüne bağlantı vererek bu seçeneği diğer seçeneklerin yanında belirgin bir şekilde gösterin. Daha fazla bilgi için Açılış sayfası yönergeleri bölümüne bakın.
repeated
TextFeature		 option_features İSTEĞE BAĞLI, maksimum özellik sayısı: 100.
Ürün düzeyindeki ayrıntılar yinelenmemelidir.
CancellationPolicy cancellation_policy ÖNERİLİR.
repeated
Category		 option_categories İsteğe bağlı, maksimum kategori sayısı: 100.
Alakalı kategoriler seçeneğini belirleyin. Lütfen self-guided özelliğinin tura dayalı olmayan tüm etkinlikler için, guided-tour özelliğinin ise tur tabanlı etkinlikler için ayarlandığından emin olun. Önerilen ek açıklamalar için Ürün kategorisi belgelerine bakın değerler.
repeated
RelatedLocation		 related_location ÖNERİLİR, maksimum konum sayısı: 100.
Doğru bir teslimat listesi alakalı konumların, ürünün en çok gösterildiği zamanlarda gösterilmesi son derece önemlidir. alakalı yerlerle alakalı olsa da, aşırı etiketleme veya doğru veri sağlama geri dönelim. Daha fazla ayrıntı için Konum ve önemli yer kılavuzuna 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.
repeated
PriceOption		 price_options ZORUNLU, en az 1.
Bu seçenek için olası tüm fiyatlar. Not: Yalnızca Yetişkin fiyatı desteklenir. Birden fazla fiyat seçeneği sağlanmışsa, coğrafi kısıtlama kontrolünü geçen ilk fiyat için kullanılır. Grup biletleri için grubun tamamı kullanılmalıdır.
uint32 duration_sec İSTEĞE BAĞLI.
Seçeneğin saniye cinsinden süresi (burada) (ör. rehberli turlar, tekne gezileri için) geçerli. Bu değer, geçerlilik süresi değil, deneyim süresidir.
repeated
Language		 diller ÖNERİLİR, maksimum dil sayısı: 100.
Aşağıdaki diller seçeneği mevcuttur. Son kullanıcı için deneyimden keyif almak için o dilde okuyun ve/veya okuyun. Örneğin rehberli tur turuna katılın.
Konum meeting_point İSTEĞE BAĞLI.
Yalnızca şunun gibi alakalı ve faydalı olduğunda ekleyin: Katılımcının yürüyüşe başlamak için tur rehberiyle buluşacağı yer katılımcının şehir turuna alınacağı yer, gemi seyahatinin başlayacağı rıhtım.

Ö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?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

Protokol

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: Özellik kapsayıcıdır.
  • TEXT_FEATURE_EXCLUSION: Bu özellik hariçtir.
  • TEXT_FEATURE_HIGHLIGHT: Öne çıkan bir özellik.
  • TEXT_FEATURE_MUST_KNOW: Özellik "bilinmesi gereken" bir özelliktir.
  • TEXT_FEATURE_SAFETY_INFORMATION: Özellik, güvenlik önlemleriyle ilgili bilgileri temsil eder.
    		•
    LocalizedTextSet value ZORUNLU, önerilen uzunluk <= 1000 karakter, maks. uzunluk: 2000.
    . Desteklenen HTML biçimlendirme etiketleri: br, strong, em, i
    Yalnızca belirtilen dört etiket desteklenir. br, şunlar için kullanılabilir: paragraflarda kesme satırları ve strong/em/i önemli metinleri 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 türler kaldırılır. Herhangi biri URL'ler, sabitler ve bağlantılar kaldırılır ve son kullanıcılara göre anlamına gelir.

    Ö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

    Protokol

    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 şu aralıkta olmalıdır: [1, 5] 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

    Protokol

      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: 2.000.
    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 ilişkilendirme İSTEĞE BAĞLI, önerilen uzunluk: 1000, maks. uzunluk: 2000.
    İlişkilendirmesi medya kaynağı hakkındaki bilgilere. İlişkilendirme fotoğrafçı veya ajansa atıfta bulunmak için medyayla birlikte bu alan ayarlanmalıdır.

    Örnekler

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

    Kategori

    Protokol

    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

    Protokol

    // 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. Önemli yer (ör. Eyfel Kulesi), mahalle (ör. Tarihi Şehir) veya 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 alakalıdır girişe izin vermemek veya girişin alakasız olması; örneğin, bir şehir turunda vurgulanan kare.
  • RELATION_TYPE_ADMISSION_TICKET: İlişki buna giriş izni verir alakalı konum.
  • RELATION_TYPE_SUPPLEMENTARY_ADDON: İlişki, ek bir beyan ediyor veya başka bir yerinde çalışmayan bir hizmet (örneğin, park cezası veya geçici sergi.

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

    Protokol

    // 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ı. Yayın sırasında genişletilecek değer parametreleri içerebilir.

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

    Örnekler

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

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

    Operatör

    Protokol

    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 [desteği sonlandırıldı] İSTEĞE BAĞLI, önerilen uzunluk: 50, maks. uzunluk: 100.
    Bu ürünün satıcısının marka adı. OTA'lar ayarlanmalıdır OTA markası olabilir. Bu alanın desteği sonlandırıldı ve alanlar altında brand_name ile değiştirildi
    LocalizedTextSet google_business_profile_name ZORUNLU, maks. uzunluk: 100.
    Google İşletme Profili'nde kayıtlı olan ve Google Haritalar'da görünen operatör işletme adı. Bu alan, operatör rezervasyon modülüne katılmak için gereklidir.
    dize phone_number İSTEĞE BAĞLI, maks. uzunluk: 64.
    Operatör telefon numarası. Tam uluslararası telefon numarası biçimini tercih edin.
    repeated
    Location    		 konumlar İSTEĞE BAĞLI, maks. sayı: 1.
    Operatörün işletme adresi. Adres dizesi kullanılıyorsa adres dizesi. Örneğin "işletme adı, açık adresi". Operatör operatörün rezervasyon yapabilmesi için işletmenin Google Haritalar'da bulunabilmesi gerekir. modülünün tetiklenmesini istiyorsanız, operatör bir Google İşletme Profili kaydetmelidir. Google Haritalar'da bulunabilir değilse.

    Ö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

    Protokol

    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 BCP-47 uyumlu bir dil kodu (ör. "en") "de-CH" gibi bir ad verebilirsiniz.

    Örnekler

    {
    "code": "de-CH"
}

    PriceOption

    Protokol

    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.
    Belirlenen fiyat içindeki benzersiz kimlik.
    dize title ZORUNLU, maks. uzunluk: 150.
    Fiyat seçeneğinin kısa açıklaması, örneğin "Yetişkinler için hafta içi".
    google.type.Money fiyat is_free yanlış olduğunda ZORUNLUDUR.
    Fiyat değeri ödeme sayfasındaki son fiyatı (tüm vergiler ve ücretler dahil) fiyat politikası. Para birimi, oluşturma sırasında kullanıcı para birimine dönüştürülür.
    bool is_free İSTEĞE BAĞLI, varsayılan değer false'tur.
    Giriş veya bilet ücretsizdir. Sıfır fiyat seçenekleri için doğru olarak ayarlanmalıdır.
    repeated
    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çerlidir.
    repeated
    PriceFeesAndTaxes    		 fees_and_taxes İSTEĞE BAĞLI.
    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

    Protokol

    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

    Protokol

    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 bir biletin son ürün fiyatına dahildir.
    google.type.Money per_ticket_tax İSTEĞE BAĞLI.
    Tek bir biletin son ürün fiyatına dahil edilen eyalet vergileri.

    Örnekler

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

    Konum

    Protokol

    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çıklama özelliklerinden en az biri bulunmalıdır.
    Coğrafi konum.
    LocalizedTextSet açıklama İSTEĞE BAĞLI, önerilen uzunluk: 1.000, maks. uzunluk: 2.000, en az bir yer veya açıklama bulunmalıdır.
    Ek açıklama kullanıcılar tarafından okunabilecek şekilde "Saray meydanındaki çeşmenin sol tarafında".

    Örnekler

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

    GeoLocation

    Bkz. kullanım yönergelerine göz atın.

    Protokol

    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, tam olarak place_id, address place_info, business_profile_id veya lat_lng olmalıdır devam eder.
    . Tanımlandığı yer kimliği: Places API. Google'da bir ÖY'yi benzersiz bir şekilde tanımlar. Bu bilgiler, Yerler Yer Arama veya Otomatik Yer Tamamlama gibi API uç noktaları ya da manuel olarak da kullanabilirsiniz.
    dize adres İSTEĞE BAĞLI, tam olarak place_id, address place_info, business_profile_id veya lat_lng olmalıdır devam eder.
    . KULLANIMDAN KALDIRILDI. Tek satırlı eski adres. Maksimum uzunluk: 200. Bileşenlerin, ilk bileşenle virgülle ayrılmış olması beklenir. Google'da görüntülendiği şekliyle yer adıdır. Daha yüksek eşleşme için yer için Google'da gösterilen açık adresi kullanın.
    PlaceInfo place_info İSTEĞE BAĞLI, tam olarak place_id, address place_info, business_profile_id veya lat_lng olmalıdır devam eder.
    . Yapılandırılmış yer bilgileri.
    uint64 business_profile_id İSTEĞE BAĞLI, tam olarak place_id, address place_info, business_profile_id veya lat_lng olmalıdır devam eder.
    . Google İşletme Profili ayarlarında bulunan İşletme Profili kimliği sayfasını ziyaret edin. Konumları doğrudan bir yerden temin ederken bu alanı kullanın ve bu kişi, söz konusu yerin Google İşletme Profili'ne erişimi olan ve böyle bir kimlik sağlayabilir.
    google.type.LatLng lat_lng İSTEĞE BAĞLI, tam olarak place_id, address place_info, business_profile_id veya lat_lng olmalıdır devam eder.
    . Coğrafi koordinatlar. Bu alan yalnızca bir şehri belirlemek için kullanılabilir çok muğlak olduğundan, belirli bir coğrafi bölgede yer veya işletmeler. Şununla eşleştirmek için bunun yerine place_info kullanın: adı ve koordinatları olan belirli bir yeri görebilirsiniz.

    Ö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

    Protokol

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

  // Phone number, including the international prefix.
  // For higher matching accuracy, this should be the same as the phone number
  // shown on Google for the place.
  // It can include commonly used separator characters.
  // Examples: "+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ı. Daha yüksek doğruluk oranı, Google'da gösterilen adla aynı olmalıdır. bahsedeceğim. Hak talebinde bulunulmuş bir Google İşletme Profili bulunan yerler için bu işletmede yapılandırılan işletme adıyla aynı olmalıdır. seçin.
    dize phone_number İSTEĞE BAĞLI. Maksimum uzunluk: 30. Telefon numarası ve dikkate almalısınız. Daha yüksek eşleşme doğruluğu için bu değer yer için Google'da gösterilen telefon numarasıyla aynıdır. Şunları içerebilir: yaygın olarak kullanılan ayırıcı karakterlerdir. Örnekler: "+1 212-363-3200", "+91 562 222 7261".
    dize website_url İSTEĞE BAĞLI. Maksimum uzunluk: 1.000. için Google'da gösterilen web sitesinin URL'si yer, tercihen Google'daki işletme girişinden bağlantı verilen URL Haritalar veya Arama'ya dokunun.
    google.type.LatLng koordinatlar İSTEĞE BAĞLI. Yerin coğrafi koordinatları. Boş bırakılırsa Google, şeklinden koordinatlar çıkarılacaktır. İsteğe bağlıdır, ancak coordinates veya structured_address ve unstructured_address sağlanmalıdır.
    StructuredAddress structured_address İSTEĞE BAĞLI, tam olarak structured_address veya unstructured_address mevcut olabilir, ancak ikisi birden bulunmayabilir.
    dize unstructured_address İSTEĞE BAĞLI, tam olarak structured_address veya unstructured_address mevcut olabilir, ancak ikisi birden bulunmayabilir.

    Ö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

    Protokol

    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. Açık adres (ev numarası dahil) ve daha spesifik bilgi bölümü kullanılarak sağlanamayan alanları. Belge yer veya işletme adını içermemelidir. Bunun yerine, name kullanılarak ayrı olarak sağlanmalıdır. PlaceInfo altındaki alana gidin. Uygulama posta kodu, şehir veya ülkeyi de eklemeyin. Bunlar doğru şekilde bilgileri girin.
    dize şehir İSTEĞE BAĞLI. Maksimum uzunluk: 80. Genellikle şehri ifade eden konum bir adresin şehir bölümüdür. Dünyanın, yerel işletmelerin bulunduğu bölgelerde iyi tanımlanmayan veya yapıya uygun olmayan boştur.
    dize administrative_area İSTEĞE BAĞLI. Maksimum uzunluk: 80. Kullanılan en yüksek idari alt bölüm belirli bir ülke veya bölgenin posta adresleri için Bu, bir eyalet, bölge, il, oblast, idari bölge. Bu bir bir kısaltma veya tam ad kullanabilirsiniz. Bu, bölgenin genellikle İlgili ülkenin posta adreslerinde temsil edilir.
    dize postal_code İSTEĞE BAĞLI. Maksimum uzunluk: 30. Posta kodu. Şu durumda gereklidir: ülke posta kodlarını destekliyor; aksi takdirde boş bırakılmalıdır.
    dize country_code İSTEĞE BAĞLI. Maks. uzunluk: 2 Unicode "CLDR" ile tanımlandığı şekilde ülke kodu . Bkz. Unicode dokümanları bilgisine erişmenize olanak tanır.

    Örnekler

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

    LocalizedTextSet

    Protokol

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

    Uygulama Notları

    Tür Alan Notlar
    repeated
    google.type.LocalizedText    		 localized_texts Yerel ayara göre yerelleştirilmiş metin değerleri.

    Örnekler

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

    CancellationPolicy

    Protokol

    // 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şulunu tanımlar. Birden fazla geri ödeme koşulu kullanılabilir açıklamak için "geri ödeme adımlarını" hizmetten önce çeşitli sürelerde başlangıç zamanı.

    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 önce, belirli bir tarihe kadar geçen süre (saniye cinsinden) Müşteri, hizmetin maliyetinin bir kısmı için geri ödeme alabilir. refund_percent. Ayarlanmazsa veya 0 değerine ayarlanırsa hizmet herhangi bir zamanda iptal edilebilir.
    uint32 refund_percent İSTEĞE BAĞLI.
    hizmet rezervasyonu en az min_duration_before_start_time tarihinde iptal edildi [0, 100] aralığında olması gerekir. Ayarlanmazsa veya 0 olarak ayarlanırsa hizmet için geri ödeme yapılmaz. 100 olarak ayarlandığında bu hizmet iade edilebilir.
    google.type.Money refund_fee İSTEĞE BAĞLI.
    Geri ödemede sabit ücret düşülür. Kullanılabilir ayrı ayrı veya refund_percent ile birlikte kullanılabilir. İkinci durumda önce geri ödeme yüzdesi uygulanır, ardından ücret düşülür.

    Örnekler

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