Plik danych o produktach

Plik danych o produktach to główny sposób przesyłania do Google listy produktów, które mają być wyświetlane w różnych miejscach w Google.

Obiekt ProductFeed składa się z jednego obiektu FeedMetadata i 0 lub więcej obiektów Product. Jeśli na wszystkich fragmentach nie ma wartości Product, wszystkie produkty zostaną usunięte.

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
FeedMetadata	feed_metadata	WYMAGANE. Metadane tego pliku danych.
powtórzony Produkt	produkty	OPCJONALNIE. Jeśli nie zostanie ustawiony we wszystkich fragmentach, wszystkie produkty zostaną usunięte. feed_metadata/max_removal_sharemoże być konieczne, gdy usuniesz dużą liczbę produktów.

Przykłady

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
uint32	shard_id	WYMAGANY, gdy total_shards_count > 1. Liczona od 0. Fragmenty nie muszą być przenoszone w kolejności. Przetwarzanie rozpoczyna się dopiero po przesłaniu pełnego zestawu fragmentów.
uint32	total_shards_count	WYMAGANY. Musi być większy niż 1.
uint64	liczba jednorazowa	WYMAGANY, gdy total_shards_count > 1. Musi być taki sam dla wszystkich fragmentów w ramach przenoszenia.
enum | typ wyliczeniowy	processing_instruction	REQUIRED. PROCESS_AS_SNAPSHOT jest jedyną obsługiwaną wartością.
double,	max_removal_share	OPCJONALNIE. Maksymalny udział aktywnych produktów, które można usunąć przez przesłanie. Jeśli w efekcie tego przeniesienia zostanie usuniętych więcej produktów, cała operacja zostanie odrzucona. Jest to zabezpieczenie przed przypadkowym usunięciem znacznej części zasobów reklamowych. Może być ustawiony na wartość 1,0, aby umożliwić całkowite usunięcie asortymentu.

Przykłady

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

Produkt

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
ciąg znaków	id	WYMAGANE. Maksymalna długość: 255. Unikalny ciąg znaków, który identyfikuje produkt. Dozwolone są znaki alfanumeryczne, _ i -.
LocalizedTextSet	tytuł	OBOWIĄZKOWE. Zalecana długość: <= 50 znaków. Maksymalna długość: 150 znaków. Zapoznaj się ze wskazówkami dotyczącymi tytułów i opisów.
LocalizedTextSet	opis	ZALECANA: zalecana długość do 10 000 znaków, maksymalna długość 16 000 znaków. Zapoznaj się ze wskazówkami dotyczącymi tytułów i opisów, aby dowiedzieć się więcej.
powtórzony TextFeature	product_features	ZALECANA, maksymalna liczba funkcji: 100.
Ocena	ocena	Zalecane. Zalecane jest podawanie ocen, ponieważ produkty z oceniami mają wyższy współczynnik klikalności.
powtórzony Media	related_media	ZALECANE, maksymalna liczba multimediów: 30 Zdecydowanie zalecamy przesłanie więcej niż 1 zdjęcia. Szczegółowe informacje o obrazach znajdziesz w wytycznych dotyczących obrazów.
wartość logiczna	use_media_order	OPCJONALNIE Podpowiedz Google, że przy wyborze obrazu do wyświetlenia należy wziąć pod uwagę kolejność, w jakiej powiązane multimedia są wymienione w pliku danych.
powtórzony Opcja	Opcje	OBOWIĄZKOWE. Maksymalna liczba opcji: 20 Każdy produkt musi mieć co najmniej jedną opcję produktu.
Operator	operator	OPCJONALNIE.
enum | typ wyliczeniowy	wycofany inventory_type	OPCJONALNIE. INVENTORY_TYPE_OFFICIAL można ustawić tylko w przypadku produktów, które zawierają link do oficjalnej strony internetowej umożliwiającej zakup biletów na dane miejsce. Możliwość ustawienia tej wartości jest dostępna dopiero po sprawdzeniu spełnienia wymagań. To pole zostało wycofane i zastąpione nowym powtarzalnym polem inventory_types.
powtarzane	inventory_types	OPCJONALNIE. Powtarzająca się lista unikalnych typów zasobów reklamowych, do których należy ten produkt. INVENTORY_TYPE_OFFICIAL można ustawić tylko w przypadku produktów, które zawierają link do oficjalnej strony internetowej umożliwiającej zakup biletów na dane miejsce. Możliwość ustawienia tej wartości jest dostępna dopiero po sprawdzeniu spełnienia wymagań. INVENTORY_TYPE_OPERATOR_DIRECT można ustawić tylko w przypadku produktów, które zawierają link do witryny organizatora wycieczki. Możliwość ustawienia tej wartości jest dostępna dopiero po sprawdzeniu spełnienia wymagań.
enum | typ wyliczeniowy	confirmation_type	OPCJONALNIE.
FulfillmentType	fulfillment_type	Zalecane. Jeśli to pole jest ustawione, co najmniej 1 pole w grupie fulfillment_rype musi być prawdziwe. Określa sposoby uzyskania dokumentu potwierdzającego rezerwację. Możliwe są różne kombinacje, na przykład mobilny + wydrukowany lub wydrukowany w domu + odbiór osobisty.
LocalizedTextSet	brand_name	Maksymalna długość: 100. Nazwa marki, która powinna być wyświetlana w przypadku produktu. Zastępuje ona obecnie nieużywany parametr „operator/name”. Można ustawić tylko jedną z tych 2 wartości.

Przykłady

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

Opcja

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
ciąg znaków	id	WYMAGANE. Identyfikator opcji. Musi być unikalna w ramach produktu.
LocalizedTextSet	tytuł	OBOWIĄZKOWE. Zalecana długość: 50 znaków, maksymalna długość: 150 znaków. Jeśli jest tylko jedna opcja, tytuł opcji może być taki sam jak tytuł produktu. Jeśli prezentowanych jest kilka opcji produktu, tytuł musi być unikalny dla danej opcji. Więcej informacji znajdziesz we wskazówkach dotyczących tytułów i opisów.
LocalizedTextSet	opis	ZALECANA: zalecana długość: 10 000, maksymalna długość: 16 000. Zapoznaj się ze wskazówkami dotyczącymi tytułów i opisów, aby dowiedzieć się więcej.
DeepLink	landing_page	WYMAGANE. Musi zawierać przycisk lub link do rezerwacji produktu. Więcej informacji znajdziesz w wytycznych dotyczących strony docelowej.
DeepLink	landing_page_list_view	ZALECANE. Link do widoku listy na wyższym poziomie dostępnych biletów i wycieczek, który wyróżnia tę opcję spośród innych. Więcej informacji znajdziesz w wytycznych dotyczących strony docelowej.
powtórzony TextFeature	option_features	OPCJONALNIE, maksymalna liczba cech: 100. Nie powtarzaj informacji z poziomu produktu.
CancellationPolicy	cancellation_policy	ZALECANE.
powtórzona Kategoria	option_categories	Opcjonalnie, maksymalna liczba kategorii: 100. Kategorie istotne w przypadku tej opcji. Aby poznać dodatkowe zalecane wartości, zapoznaj się z dokumentacją dotyczącą kategorii produktów.
repeated RelatedLocation	related_location	ZALECANE: maksymalna liczba lokalizacji: 100. Podanie dokładnej listy powiązanych lokalizacji jest bardzo ważne, aby produkt wyświetlał się w najbardziej odpowiednich miejscach. Jednak nadmierne tagowanie lub podawanie dokładnych danych może spowodować usunięcie produktu. Więcej informacji znajdziesz w przewodniku Lokalizacja i miejsce docelowe.
wartość logiczna	base_ticket	OPCJONALNIE. Używane do wskazania, czy opcja produktu jest podstawowym biletem wstępnym.
repeated PriceOption	price_options	WYMAGANE, co najmniej 1. Wszystkie możliwe ceny dla tej opcji. Uwaga: obsługiwana jest tylko cena dla dorosłych. Jeśli podano kilka opcji cenowych, zostanie użyta pierwsza cena, która przejdzie weryfikację ograniczeń geograficznych. W przypadku biletów grupowych należy zastosować pełną cenę całej grupy.
uint32	duration_sec	OPCJONALNIE. Czas trwania opcji w sekundach, w stosownych przypadkach, na przykład w przypadku wycieczek z przewodnikiem lub rejsów łodzią. Powinien on odzwierciedlać czas trwania eksperymentu (a nie czas ważności).
powtórzony Język	języki	ZALECANA maksymalna liczba języków: 100. Języki, w których dostępna jest ta opcja. gdy ważne jest, aby użytkownik rozumiał lub czytał w danym języku, aby móc korzystać z aplikacji; na przykład w przypadku wycieczki z przewodnikiem.
Lokalizacja	meeting_point	OPCJONALNIE. Dodaj tylko te miejsca, które są istotne i przydatne, np. miejsce, w którym uczestnik spotka się z przewodnikiem, aby rozpocząć wycieczkę pieszą, lub miejsce, w którym uczestnik zostanie odebrany na wycieczkę po mieście, czy też przystań, z której rozpocznie się rejs.

Przykłady

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

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
enum | typ wyliczeniowy	feature_type	WYMAGANE. Typ funkcji, możliwe wartości: TEXT_FEATURE_INCLUSION: funkcja jest uwzględniona. TEXT_FEATURE_EXCLUSION: funkcja jest wykluczeniem. TEXT_FEATURE_HIGHLIGHT: funkcja jest wyróżniona. TEXT_FEATURE_MUST_KNOW: funkcja, którą musisz znać. TEXT_FEATURE_SAFETY_INFORMATION: funkcja zawiera informacje o środkach bezpieczeństwa.
LocalizedTextSet	wartość	OBOWIĄZKOWE. Zalecana długość: do 1000 znaków. Maksymalna długość: 2000. Obsługiwane tagi formatowania HTML: br, strong, em, i Obsługiwane są tylko 4 wymienione tagi. Tag br służy do dzielenia wierszy w akapitach, a tagi strong/em/i – do wyróżniania ważnego tekstu. Pozostałe tagi fraz zostaną zignorowane. Wszystkie inne tagi i niestandardowe style są niedozwolone i zostaną usunięte. Wszystkie adresy URL, kotwy i linki zostaną usunięte i nigdy nie będą widoczne dla użytkowników.

Przykłady

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

Ocena

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
double,	average_value	OPCJONALNIE. Średnia wartość oceny. Wartość musi mieścić się w zakresie [1, 5] i może być pominięta tylko wtedy, gdy rating_count = 0.
uint64	rating_count	WYMAGANE. Liczba ocen użytych do obliczenia wartości.

Przykłady

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

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

Multimedia

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
ciąg znaków	URL	WYMAGANE. Maksymalna długość: 2000. Adres URL źródła multimediów. Google będzie indeksować multimedia hostowane pod tym adresem URL.
enum | typ wyliczeniowy	typ	WYMAGANE. Typ źródła multimediów. Możliwe wartości: MEDIA_TYPE_PHOTO: wskazuje, że multimedia podane w adresie URL to zdjęcie.
LocalizedTextSet	Atrybucja	OPCJONALNE, zalecana długość: 1000, maksymalna długość: 2000. informacje o źródle multimediów. Pamiętaj, że jeśli uznanie autorstwa jest wymagane do wyświetlania wraz z multimediami, aby uhonorować fotografa lub agencję, to pole musi być wypełnione.

Przykłady

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

Kategoria

Proto

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
ciąg znaków	etykieta	WYMAGANE. Listę prawidłowych wartości znajdziesz w dokumentacji kategorii produktów.

Przykłady

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

Wskazówki dotyczące implementacji

Określa relację między opcją a lokalizacją.

Typ	Pole	Uwagi
Lokalizacja	lokalizacja	WYMAGANE. Lokalizacja powiązana z opcją. Może to być punkt orientacyjny (np. wieża Eiffla), dzielnica (np. Stare Miasto) lub dowolny punkt na mapie.
enum | typ wyliczeniowy	relation_type	WYMAGANE. Typ relacji opcji w danej lokalizacji. Możliwe wartości: RELATION_TYPE_RELATED_NO_ADMISSION: lokalizacja jest powiązana, ale relacja nie pozwala na wstęp lub wstęp jest nieistotny, np. lokalizacja to plac wyróżniony w podczas wycieczki po mieście. RELATION_TYPE_ADMISSION_TICKET: relacja uprawnia do wstępu do tej powiązanej lokalizacji. RELATION_TYPE_SUPPLEMENTARY_ADDON: relacja określa dodatkową usługę, która nie umożliwia użytkownikowi dotarcia do powiązanej lokalizacji, taką jak bilet parkingowy lub tymczasowa wystawa.

Przykłady

// Example of place ID POI with no admissions
{
    "location": {
        "location": {
            "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
        }
    },
    "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
}

// Example of Address POI with admissions
{
    "location": {
        "location": {
            "address": "Madame Tussauds Berlin, Unter den Linden 74, 10117 Berlin, Germany"
        }
    },
    "relation_type": "RELATION_TYPE_ADMISSION_TICKET"
}

DeepLink

Proto

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

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

  reserved 2, 4;
}

Wskazówki dotyczące implementacji

Definicja precyzyjnego linku. Może zawierać parametry wartości, które zostaną rozwinięte w momencie wyświetlenia.

Typ	Pole	Uwagi
ciąg znaków	URL	OPCJONALNE, maksymalna długość: 2000. Szablon adresu URL strony docelowej na komputer. Wymagana jest właściwość `url` lub `localized_url`.
ciąg znaków	mobile_url	OPCJONALNE, maksymalna długość: 2000. Szablon adresu URL strony docelowej na urządzenia mobilne.
LocalizedTextSet	localized_url	OPCJONALNE, maksymalna długość: 2000, maksymalna liczba lokalizacji: 50. Szablon adresu URL strony docelowej w wersji na komputer z tłumaczeniem na język docelowy. Jeśli podano zarówno parametr url, jak i localized_url, pierwszy z nich jest używany jako wartość zastępcza, gdy żaden adres URL nie pasuje do lokalizacji użytkownika. Jeśli url jest niedostępny i nie podano języka, używany jest angielski URL.
LocalizedTextSet	localized_mobile_url	OPCJONALNE, maksymalna długość: 2000, maksymalna liczba lokalnych wersji: 50. Szablon adresu URL strony docelowej na urządzenia mobilne w wersji zlokalizowanej.

Przykłady

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

Operator

Proto

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

  LocalizedTextSet name = 1;

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

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

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
LocalizedTextSet	name [wycofane]	OPCJONALNIE, zalecana długość: 50, maksymalna długość: 100. Nazwa marki sprzedawcy tego produktu. OTA powinny ustawić tę wartość jako markę OTA. To pole zostało wycofane i zastąpione polem nazwa_marki w produktach
LocalizedTextSet	google_business_profile_name	OBOWIĄZKOWE, maksymalna długość: 100. Nazwa operatora zarejestrowana w Profilu Firmy w Google i wyświetlana w Mapach Google. To pole jest wymagane, aby można było korzystać z modułu rezerwacji operatora.
ciąg znaków	phone_number	OPCJONALNIE, maksymalna długość: 64. Numer telefonu operatora. Preferuj pełny format numeru telefonu międzynarodowego.
powtarzane Lokalizacja	lokalizacje	OPCJONALNIE, maksymalna liczba: 1. Adres pocztowy operatora. Jeśli używasz ciągu adresu, dodaj nazwę firmy jako część ciągu adresu. Na przykład „nazwa firmy, adres ulicy”. Aby moduł rezerwacji operatora mógł się aktywować, firma operatora musi być widoczna w Mapach Google. Jeśli nie jest widoczna, operator powinien zarejestrować profil firmy w Google.

Przykłady

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

Język

Proto

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
ciąg znaków	kod	Kod języka zgodny ze standardem BCP-47, np. „pl” lub „de-CH”.

Przykłady

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
ciąg znaków	id	OBOWIĄZKOWE, maksymalna długość: 255. Unikalny identyfikator w ramach zestawu cen.
ciąg znaków	tytuł	OBOWIĄZKOWE. Maksymalna długość: 150. Krótki opis opcji cenowej, np. „Dorośli w tygodniu”.
google.type.Money	cena	OBOWIĄZKOWE, gdy is_free ma wartość false. Wartość ceny musi być zgodna z ostateczną ceną na stronie płatności, łącznie z podatkami i opłatami. Zapoznaj się z zasadami dotyczącymi cen. Waluta zostanie przeliczona na walutę użytkownika podczas renderowania.
wartość logiczna	is_free	OPCJONALNE, domyślnie ustawione na „fałsz”. Wstęp lub bilet jest bezpłatny. W przypadku opcji z ceną zerową musi być ustawiona wartość true (prawda).
powtórzony GeoCriterion	geo_criteria	OPCJONALNIE. Lista regionów geograficznych, w których cena ma zastosowanie. Jeśli jest puste, dotyczy wszystkich lokalizacji.
repeated PriceFeesAndTaxes	fees_and_taxes	OPCJONALNIE. Wyszczególnienie opłat i podatków uwzględnionych w cenie.

Przykłady

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
ciąg znaków	country_code	OBOWIĄZKOWE. Dwuliterowy kod kraju zgodnie ze standardem ISO 3166-1.
wartość logiczna	is_negative	OPCJONALNIE. Jeśli wartość to prawda, kryterium jest negatywne (kod kraju jest wykluczony).

Przykłady

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
google.type.Money	per_ticket_fee	OPCJONALNIE. Opłaty za rezerwację wliczone w ostateczną cenę produktu za pojedynczy bilet.
google.type.Money	per_ticket_tax	OPCJONALNIE. Podawaj podatki stanowe w cenie końcowej produktu za pojedynczy bilet.

Przykłady

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

Lokalizacja

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
GeoLocation	lokalizacja	OPCJONALNIE: musisz podać co najmniej lokalizację lub opis. Lokalizacja geograficzna.
LocalizedTextSet	opis	FACULTATIVE (opcjonalne), zalecana długość: 1000, maksymalna długość: 2000, musi być obecny co najmniej jeden opis lub lokalizacja. Dodatkowy opis w formie zrozumiałej dla człowieka, np. „Po lewej stronie fontanny na Placu Pałacowym”.

Przykłady

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

GeoLocation

Więcej informacji o każdym typie podpowiedzi znajdziesz w  wytycznych dotyczących ich stosowania.

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
ciąg znaków	place_id	OPCJONALNIE: musi być podany dokładnie jeden z atrybutów: place_id, address, place_info, business_profile_id lub lat_lng. PlaceId zgodnie z definicją w  interfejsie Places API. jednoznacznie identyfikuje punkt zainteresowania w Google; Można go używać za pomocą punktów końcowych interfejsu Places API, np. wyszukiwania miejsc lub autouzupełniania miejsc, lub ręcznie za pomocą narzędzia Znajdź dopasowane lokalizacje w Centrum Atrakcji.
ciąg znaków	adres	OPCJONALNIE: musi być podany dokładnie jeden z atrybutów: place_id, address, place_info, business_profile_id lub lat_lng. WYCOFANY. Stary adres jednowierszowy. Maksymalna długość: 200. Składniki powinny być rozdzielone przecinkami, a pierwszy składnik powinien być nazwą miejsca wyświetlaną w Google. Aby zapewnić większą dokładność dopasowania, użyj adresu ulicy wyświetlanego w Google dla danego miejsca.
PlaceInfo	place_info	OPCJONALNIE: musi być podany dokładnie jeden z atrybutów: place_id, address, place_info, business_profile_id lub lat_lng. Informacje o miejscu w uporządkowanym formacie.
uint64	business_profile_id	OPCJONALNIE: musi być podany dokładnie jeden z atrybutów: place_id, address, place_info, business_profile_id lub lat_lng. Identyfikator profilu firmy, który znajdziesz na stronie ustawień Profilu Firmy w Google. Użyj tego pola, gdy pobierasz dane o lokalizacjach bezpośrednio od właściciela miejsca, który ma dostęp do Profilu Firmy w Google dla danego miejsca i może podać taki identyfikator.
google.type.LatLng	lat_lng	OPCJONALNIE: musi być podany dokładnie jeden z atrybutów: place_id, address, place_info, business_profile_id lub lat_lng. Współrzędne geograficzne. To pole może służyć tylko do określenia miasta lub regionu geograficznego, ponieważ jest zbyt niejednoznaczne, aby można było na jego podstawie zidentyfikować konkretne miejsce lub firmę. Zamiast tego użyj polecenia place_info, aby dopasować dane miejsce do nazwy i współrzędnych.

Przykłady

"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: 100.
  // Required.
  string name = 1;

  // Phone number, including the international prefix.
  // For higher matching accuracy, this should be the same as the phone number
  // shown on Google for the place.
  // It can include commonly used separator characters.
  // Examples: "[phone]", "[phone]".
  // Max length: 30.
  // Optional.
  string phone_number = 2;

  // Website URL shown on Google for the place, preferably the URL linked from
  // the business listing in Google Maps or Search for the place.
  // Max length: 1000.
  // Optional.
  string website_url = 3;

  // Geographic coordinates of the place.
  // If left empty, Google will infer the coordinates from the address.
  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  google.type.LatLng coordinates = 4;

  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  oneof address_type {
    // Structured address.
    // Prefer this format whenever possible for higher matching accuracy.
    StructuredAddress structured_address = 5;

    // Unstructured address.
    // It should not include the place or business name, which must instead be
    // provided separately using the `name` field.
    //
    // Examples:
    // - `name`: "Colosseum", `unstructured_address`: "Piazza del Colosseo, 1,
    // 00184 Roma RM, Italy".
    // - `name`: "The British Museum", `unstructured_address`: "Great Russell
    // St, London WC1B 3DG, United Kingdom".
    //
    // Max length: 400.
    string unstructured_address = 6;
  }
}

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
ciąg znaków	nazwa	WYMAGANE. Maksymalna długość: 300. Nazwa miejsca lub firmy. Aby zwiększyć dokładność dopasowania, nazwa powinna być taka sama jak nazwa wyświetlana w Google w przypadku danego miejsca. W przypadku miejsc, w których zgłoszono profil firmy w Google, ta nazwa powinna być taka sama jak nazwa firmy skonfigurowana w profilu firmy.
ciąg znaków	phone_number	OPCJONALNIE. Maksymalna długość: 30. Numer telefonu, w tym prefiks międzynarodowy. Aby zwiększyć dokładność dopasowywania, numer telefonu powinien być taki sam jak numer telefonu wyświetlany w Google w przypadku danego miejsca. Może zawierać często używane znaki rozdzielające. Przykłady: „[phone]”, „[phone]”.
ciąg znaków	website_url	OPCJONALNIE. Maksymalna długość: 1000. Adres URL witryny wyświetlany w Google w przypadku danego miejsca, najlepiej adres URL powiązany z wizytówką firmy w Mapach Google lub wyszukiwarce.
google.type.LatLng	współrzędne	OPCJONALNIE. Współrzędne geograficzne miejsca. Jeśli pozostanie puste, Google wywnioskuje współrzędne na podstawie adresu. Opcjonalnie, ale należy podać albo coordinates, albo dowolną z wartości structured_address lub unstructured_address.
StructuredAddress	structured_address	OPCJONALNIE: można podać dokładnie jedną z opcji structured_address lub unstructured_address, ale nie obie.
ciąg znaków	unstructured_address	OPCJONALNIE: można podać dokładnie jedną z opcji structured_address lub unstructured_address, ale nie obie.

Przykłady

"place_info": {
  "name": "Colosseum",
  "phone_number": "[phone]",
  "website_url": "https://colosseo.it/",
  "coordinates": {
    "latitude": 41.8902102,
    "longitude": 12.4922309
  },
  "structured_address" {
    "street_address": "Piazza del Colosseo, 1",
    "locality": "Roma",
    "administrative_area": "RM",
    "postal_code": "00184",
    "country_code": "IT"
  }
}

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

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

StructuredAddress

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

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
ciąg znaków	street_address	WYMAGANE. Maksymalna długość: 200. Ulica i numer budynku oraz inne elementy, których nie można podać za pomocą bardziej szczegółowych pól. Nie może ona zawierać nazwy miejsca ani nazwy firmy. Należy je podać oddzielnie w polu name w sekcji PlaceInfo. Nie powinien też zawierać kodu pocztowego, miejscowości ani kraju, ponieważ te informacje należy podać w odpowiednich polach.
ciąg znaków	miejscowość	OPCJONALNIE. Maksymalna długość: 80. Miejscowość, która zazwyczaj odnosi się do miasta lub miejscowości w adresie. W regionach świata, w których okręgi administracyjne są słabo zdefiniowane lub nie pasują do tej struktury, pozostaw to pole puste.
ciąg znaków	administrative_area	OPCJONALNIE. Maksymalna długość: 80. Najwyższy podział administracyjny używany w przypadku adresów pocztowych w danym kraju lub regionie. Może to być stan, region, prowincja, obwód lub prefektura. Może to być skrót lub pełna nazwa, w zależności od tego, jak region jest zwykle reprezentowany w adresach pocztowych w danym kraju.
ciąg znaków	postal_code	OPCJONALNIE. Maksymalna długość: 30. Kod pocztowy. Wymagane, jeśli kraj obsługuje kody pocztowe. W przeciwnym razie pole należy pozostawić puste.
ciąg znaków	country_code	OPCJONALNIE. Maksymalna długość: 2. Kod kraju zdefiniowany przez standard Unicode „CLDR”, który jest zgodny ze standardem ISO 3166 alfa-2. Zapoznaj się z dokumentacją Unicode.

Przykłady

{
  "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.
  // Maximum repeatedness: 50
  repeated google.type.LocalizedText localized_texts = 1;
}

Wskazówki dotyczące implementacji

Typ	Pole	Uwagi
repeated google.type.LocalizedText	localized_texts	Wartości tekstowe zlokalizowane według lokalizacji.

Przykłady

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

Wskazówki dotyczące implementacji

Określa pojedynczy warunek zwrotu środków. Wiele warunków zwrotu środków może być używanych razem do opisywania „kroków zwrotu środków” jako różnych okresów przed czasem rozpoczęcia usługi.

Typ	Pole	Uwagi
RefundCondition	refund_conditions	OPCJONALNIE, maksymalna liczba warunków zwrotu środków: 10.

RefundCondition

Typ	Pole	Uwagi
uint32	min_duration_before_start_time_sec	Opcjonalnie. Czas w sekundach przed czasem rozpoczęcia, do którego klient może otrzymać zwrot części kosztu usługi określony w refund_percent. Jeśli wartość nie jest ustawiona lub jest ustawiona na 0, usługę można anulować w dowolnym momencie.
uint32	refund_percent	OPCJONALNIE. Procent, który może zostać zwrócony, o ile rezerwacja usługi zostanie anulowana co najmniej min_duration_before_start_time przed rozpoczęciem usługi, w zakresie [0, 100]. Jeśli ta wartość nie jest ustawiona lub jest ustawiona na 0, usługa nie podlega zwrotowi. Gdy wartość tego parametru wynosi 100, usługa jest w pełni zwracana.
google.type.Money	refund_fee	OPCJONALNIE. Opłata stała odliczana przy zwrocie środków. Można go używać oddzielnie lub w połączeniu z opcją refund_percent. W tym drugim przypadku najpierw stosuje się procent zwrotu, a następnie odlicza się opłatę.

Przykłady

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