Plik danych o produktach

Plik danych o produktach to podstawowy sposób przesyłania do Google listy rzeczy aby tworzyć produkty, które mają być wyświetlane w różnych usługach Google.

Obiekt ProductFeed składa się z jednego obiektu FeedMetadata oraz zero lub więcej obiektów Product. Jeśli nie podano Product we wszystkich fragmentach, 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;
}

Uwagi dotyczące implementacji

Typ Pole Uwagi
FeedMetadata feed_metadata WYMAGANE.
Metadane tego kanału.
powtórzony
Iloczyn		 produkty OPCJONALNE.
Jeśli zasada jest nieskonfigurowana we wszystkich fragmentach, wszystkie produkty zostały usunięte. feed_metadata/max_removal_share może być konieczne w przypadku usunięcia dużej liczby 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;
}

Uwagi dotyczące implementacji

Typ Pole Uwagi
uint32 shard_id WYMAGANE, gdy total_shards_count > 1.
Od zera. Fragmenty nie muszą być przenoszone kolejno. Przetwarzanie rozpoczyna się dopiero po przesłaniu pełnego zestawu fragmentów.
uint32 total_shards_count WYMAGANE, musi wynosić >= 1.
uint64 liczba jednorazowa WYMAGANE, gdy total_shards_count > 1.
Musi być taka sama we wszystkich fragmentach w ramach transferu.
enum | typ wyliczeniowy processing_instruction WYMAGANE.
Jedyną wartością jest PROCESS_AS_SNAPSHOT. obsługiwane.
double, max_removal_share OPCJONALNIE.
Maksymalny udział aktywnych produktów, które są mogą zostać usunięte za pomocą przesłanego materiału. Jeśli usuniesz więcej produktów w ramach tego przeniesienia zostanie odrzucone w całości. To jest przed przypadkowym usunięciem znacznej części zasobów reklamowych. Aby umożliwić pełne usunięcie zasobów reklamowych, można ustawić wartość 1.0.

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

Uwagi dotyczące implementacji

Typ Pole Uwagi
ciąg znaków id WYMAGANE, maksymalna długość 255 znaków.
Unikalny ciąg znaków, który identyfikuje usługi. Dozwolone są znaki alfanumeryczne oraz _ i -.
LocalizedTextSet tytuł WYMAGANE, zalecana długość <= 50, maksymalna długość 150 znaków.
Więcej informacji znajdziesz we wskazówkach dotyczących tytułu i opisu.
LocalizedTextSet opis ZALECANE, zalecana długość <= 10 000, maksymalna długość 16 000 znaków.
Więcej informacji znajdziesz we wskazówkach dotyczących tytułu i opisu.
repeated
TextFeature		 product_features ZALECANA, maksymalna liczba funkcji: 100.
Ocena ocena ZALECANE.
Podawanie ocen jest zdecydowanie zalecane, ponieważ wyświetlanie ocen produktów przekłada się na wyższy współczynnik klikalności.
repeated
Media		 related_media ZALECANE, maksymalna liczba multimediów: 30
Zdecydowanie zalecamy przesłanie więcej niż jednego obrazu. Szczegółowe wskazówki dotyczące obrazów znajdziesz w wytycznych dotyczących obrazów.
wartość logiczna use_media_order OPCJONALNIE
Wskazówka dla Google, że przy wyborze obrazu do wyświetlenia należy wziąć pod uwagę kolejność, w jakiej powiązane multimedia są wymienione w kanale.
repeated
Option		 Opcje WYMAGANE, maksymalna liczba opcji: 20
Każdy produkt musi mieć co najmniej 1 opcję produktu.
Operator operator OPCJONALNE.
enum | typ wyliczeniowy deprecated
inventory_type		 OPCJONALNE.
INVENTORY_TYPE_OFFICIAL można skonfigurować tylko w usługach, które prowadzą do oficjalnej strony internetowej biletu w danym miejscu a interesem publicznym. Możliwość ustawienia tej wartości jest włączana dopiero po sprawdzeniu kwalifikowalności.
To pole zostało wycofane i zastąpione nowym polem powtarzanych zasobów typu Inventory_types.
powtarzane inventory_types OPCJONALNE.
Powtarzająca się lista unikalnych typów zasobów reklamowych, do których należy ten produkt.
INVENTORY_TYPE_OFFICIAL można skonfigurować tylko w usługach, które prowadzą do oficjalnej strony internetowej biletu w danym miejscu a interesem publicznym. Możliwość ustawienia tej wartości jest włączana dopiero po sprawdzeniu kwalifikowalności.
INVENTORY_TYPE_OPERATOR_DIRECT można ustawić tylko w usługach, które prowadzą do strony organizatora turystyki. Możliwość ustawienia tej wartości jest włączana dopiero po sprawdzeniu kwalifikowalności.
enum | typ wyliczeniowy confirmation_type OPCJONALNE.
FulfillmentType fulfillment_type ZALECANE. Jeśli jest ustawiona, co najmniej 1 pole w fulfillment_rype musi mieć wartość prawda.
Określa sposób uzyskania dokumentu potwierdzającego rezerwację. Kombinacje są możliwe, np. telefon komórkowy + wydrukowany lub wydrukowany w domu + odbiór osobisty jest dostępna.
LocalizedTextSet brand_name maksymalna długość to 100.
Nazwa marki, którą powinna wyświetlać produkt. Zastąpiła ona nazwę nieaktualną „operator/nazwa”. 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;
}

Uwagi dotyczące implementacji

Typ Pole Uwagi
ciąg znaków id WYMAGANE.
Identyfikator opcji. Musi być niepowtarzalna w obrębie produktu.
LocalizedTextSet tytuł WYMAGANE, zalecana długość: 50, maksymalna długość: 150 znaków.
Jeśli jest tylko jedna opcja, tytuł opcji może być taki sam jak tytuł produktu. Jeśli kilka opcje produktu, tytuł musi być unikalny dla danej opcji. Więcej informacji znajdziesz we wskazówkach dotyczących tytułu i opisu.
LocalizedTextSet opis ZALECANE, zalecana długość: 10 000, maksymalna długość: 16 000.
Więcej informacji znajdziesz we wskazówkach dotyczących tytułu i opisu.
DeepLink landing_page WYMAGANE.
Musi zawierać przycisk lub link umożliwiający zarezerwowanie produktu. Więcej informacji znajdziesz we wskazówkach na temat stron docelowych.
DeepLink landing_page_list_view ZALECANE.
Utwórz link do widoku listy na wyższym poziomie dostępnych biletów i wycieczek. Widać tę opcję w widocznym miejscu wśród innych opcji. Więcej informacji znajdziesz we wskazówkach na temat stron docelowych.
repeated
TextFeature		 option_features OPCJONALNE, maksymalna liczba cech: 100.
Nie może powielać szczegółów z poziomu produktu.
CancellationPolicy cancellation_policy ZALECANE.
repeated
Category		 option_categories Opcjonalnie, maksymalna liczba kategorii: 100.
Trafne kategorie dla tej opcji. Szczególnie ważne jest, aby ustawić self-guided dla wszystkich aktywności niezwiązanych z wycieczkami, a guided-tour – do aktywności w ramach wycieczki. Dodatkowe zalecane elementy znajdziesz w dokumentacji kategorii produktów. .
repeated
RelatedLocation		 related_location ZALECANE, maksymalna liczba lokalizacji: 100.
Podawanie dokładnej listy powiązane lokalizacje są niezwykle ważne, aby produkt wyświetlał się w odpowiednich miejscach. Jednak nadmierne tagowanie i podanie dokładnych danych może spowodować usunięty produkt. Więcej informacji znajdziesz w przewodniku Lokalizacja i ciekawe miejsca.
wartość logiczna base_ticket OPCJONALNY.
Wskazuje, czy dana opcja produktu jest podstawowym biletem wstępu.
repeated
PriceOption		 price_options WYMAGANE, co najmniej 1.
Wszystkie możliwe ceny w przypadku tej opcji. Uwaga: obsługiwana jest tylko cena dla dorosłych. Jeśli istnieje kilka opcji cenowych została podana, pierwsza cena, która przeszła kontrolę ograniczeń geograficznych zastosowali różne metody. W przypadku biletów grupowych jest to pełna cena użyj całej grupy.
uint32 duration_sec OPCJONALNE.
Czas trwania opcji w sekundach, przy czym np. wycieczek z przewodnikiem czy rejsów łodzią. Powinny odzwierciedlić czas trwania doświadczenia (nie okres ważności).
repeated
Language		 języki ZALECANA, maksymalna liczba języków: 100.
Języki, w których jest dostępna w. Kiedy ważne jest, aby użytkownik rozumieć i/lub czytać w danym języku, aby czerpać przyjemność z prezentowanych materiałów. Na przykład na wycieczkę z przewodnikiem.
Lokalizacja meeting_point OPCJONALNE.
Dodaj tylko te, które są przydatne i przydatne, np. miejsce, w którym uczestnik spotka się z przewodnikiem, aby rozpocząć spacer. wycieczki lub miejsca, z którego zostanie zabrany uczestnik na wycieczkę po mieście, miejsca, z którego rozpocznie się rejs wycieczkowy.

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

Uwagi dotyczące implementacji

Typ Pole Uwagi
enum | typ wyliczeniowy feature_type WYMAGANE.
Typ cechy, możliwe wartości:
  • TEXT_FEATURE_INCLUSION: funkcja jest uwzględniana.
  • TEXT_FEATURE_EXCLUSION: cecha jest wykluczeniem.
  • TEXT_FEATURE_HIGHLIGHT: cecha jest wyróżniona.
  • TEXT_FEATURE_MUST_KNOW: ta funkcja jest „niezbędna”.
  • TEXT_FEATURE_SAFETY_INFORMATION: funkcja przedstawia informacje o środkach bezpieczeństwa.
    		•
    LocalizedTextSet wartość WYMAGANE, zalecana długość <= 1000 znaków, maksymalna długość: 2000 znaków.
    Obsługiwane tagi formatowania HTML: br, strong, em oraz i
    Obsługiwane są tylko wymienione cztery tagi. Za pomocą br można: linie podziału w akapitach i strong/em/i pozwalają wyróżnić ważny tekst. Pozostałe tagi do wyrażenia będą ignorowane.
    Wszystkie inne tagi oraz style niestandardowe są niedozwolone i zostaną usunięte. Dowolne Adresy URL, kotwice i linki zostaną usunięte i nigdy nie będą wyświetlane 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;
}

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    double, average_value OPCJONALNE.
    Średnia wartość oceny. Wartość musi się mieścić w zakresie [1, 5] i można go pominąć tylko wtedy, gdy rating_count ma wartość 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;
}

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    ciąg znaków URL WYMAGANE, maksymalna długość: 2000 znaków.
    Adres URL tego źródła multimediów. Google zindeksuje multimedia przechowywane pod tym adresem URL.
    enum | typ wyliczeniowy typ WYMAGANE.
    Typ tego źródła multimediów. Możliwe wartości:
  • MEDIA_TYPE_PHOTO: oznacza, że multimedia dostarczony w adresie URL to zdjęcie.
    		•
    LocalizedTextSet Atrybucja OPCJONALNE, zalecana długość: 1000, maksymalna długość: 2000.Atrybucja
    informacje o źródle mediów. Pamiętaj, że jeśli atrybucja to musi być prezentowana w mediach, aby umieścić informację o autorze lub agencji, to pole musi być ustawione.

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

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

    Uwagi dotyczące implementacji

    Definiuje relację między opcją a lokalizacją.

    Typ Pole Uwagi
    Lokalizacja lokalizacja WYMAGANE.
    Lokalizacja związana z opcją. Może to być ciekawe miejsce (np. wieża Eiffla), dzielnica (np. Stare Miasto) lub adres bądź 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 zezwala na wstęp lub wstęp jest nieistotny, np. lokalizacja skwer podświetlony na trasie wycieczki po mieście.
  • RELATION_TYPE_ADMISSION_TICKET: związek daje do tego dostęp w powiązanej lokalizacji.
  • RELATION_TYPE_SUPPLEMENTARY_ADDON: relacja deklaruje dodatkowy usługa, która nie przenosi użytkownika do powiązanej lokalizacji, np. bilet parkingowy lub wystawa czasowa.

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

    Proto

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

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

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

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

    Uwagi dotyczące implementacji

    Definicja precyzyjnego linku. Może zawierać parametry wartości, które zostaną rozszerzone przy wyświetlaniu reklamy.

    Typ Pole Uwagi
    ciąg znaków URL OPCJONALNE, maksymalna długość: 2000.
    Szablon adresu URL strony docelowej na komputery. Wymagany jest parametr „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 miejsc docelowych: 50.
    Zlokalizowany szablon URL strony docelowej na komputery. Jeśli podano zarówno url, jak i localized_url, pierwszy jest używany jako wartość zastępcza, jeśli żaden adres URL nie pasuje do języka użytkownika. Jeśli usługa url jest niedostępna i w języku angielskim, użyty zostanie adres URL w języku angielskim.
    LocalizedTextSet localized_mobile_url OPCJONALNE, maksymalna długość: 2000, maksymalna liczba miejsc docelowych 50.
    Zlokalizowany szablon adresu URL strony mobilnej na komórki (mobile_landing page_URL for mobile).

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

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    LocalizedTextSet nazwa [wycofane] OPCJONALNIE, zalecana długość: 50, maksymalna długość: 100.
    Nazwa marki sprzedawcy tego produktu. Aplikacje OTA powinny być ustawione jest to marka OTA. To pole zostało wycofane i zastąpione wartością „brand_name” w sekcji „Produkty”
    LocalizedTextSet google_business_profile_name WYMAGANE, maksymalna długość: 100 znaków.
    Nazwa firmy operatora zarejestrowana w Profilu Firmy w Google i wyświetlana w Mapach Google. To pole jest wymagane, jeśli chcesz korzystać z modułu rezerwacji u operatora.
    ciąg znaków phone_number OPCJONALNIE, maksymalna długość: 64.
    Numer telefonu operatora. Preferuj pełny międzynarodowy format numerów telefonów.
    repeated
    Location    		 lokalizacje OPCJONALNE, maksymalna liczba: 1.
    Adres firmy operatora. Jeśli używasz ciągu adresu, umieść nazwę firmy jako część ciągu adresu. Na przykład „nazwa firmy, adres”. Operator firma musi być dostępna do znalezienia w Mapach Google, aby możliwe było dokonanie rezerwacji przez operatora do uruchomienia modułu, operator powinien zarejestrować profil firmy w Google jeśli nie można znaleźć firmy w Mapach 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;
}

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    ciąg znaków kod kod języka zgodny z BCP-47, np. „en”; 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;
}

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    ciąg znaków id WYMAGANE, maksymalna długość: 255 znaków
    Unikalny identyfikator w ramach ustawionej ceny.
    ciąg znaków tytuł WYMAGANE, maksymalna długość: 150.
    Krótki opis opcji cenowej, na przykład „Dzień powszedni dla dorosłych”.
    google.type.Money cena WYMAGANE, gdy is_free ma wartość fałsz.
    Wartość ceny musi być zgodna z ostateczna cena na stronie płatności, w tym wszystkie podatki i opłaty, zobacz zasady dotyczące cen. Podczas renderowania waluta zostanie przeliczona na walutę użytkownika.
    wartość logiczna is_free OPCJONALNE – wartość domyślna to false (fałsz).
    Wstęp lub bilet są bezpłatne. W przypadku opcji z ceną zerową musi mieć wartość Prawda.
    repeated
    GeoCriterion    		 geo_criteria OPCJONALNIE.
    Lista regionów geograficznych, których dotyczy ta cena. Jeśli pole jest puste, dotyczy wszystkich lokalizacji.
    repeated
    PriceFeesAndTaxes    		 fees_and_taxes OPCJONALNIE.
    Zestawienie 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;
}

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    ciąg znaków country_code WYMAGANE.
    2-literowy kod kraju określony w normie ISO 3166-1.
    wartość logiczna is_negative OPCJONALNE.
    Jeśli ma wartość prawda, kryterium jest ujemne (kod kraju jest wykluczany).

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

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    google.type.Money per_ticket_fee OPCJONALNE.
    Opłaty za rezerwację są uwzględnione w ostatecznej cenie produktu za pojedynczy bilet.
    google.type.Money per_ticket_tax OPCJONALNIE.
    Podatki stanowe są uwzględnione w ostatecznej cenie produktu za jeden 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;
}

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    GeoLocation lokalizacja OPCJONALNIE: należy podać co najmniej jedną lokalizację lub opis.
    Położenie geograficzne.
    LocalizedTextSet opis OPCJONALNE, zalecana długość: 1000, maksymalna długość: 2000, co najmniej 1 należy podać lokalizację lub opis.
    Dodatkowy opis w postaci zrozumiałej dla człowieka, na przykład „Po lewej stronie fontanny na placu Pałacowym”.

    Przykłady

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

    GeoLocation

    Zobacz , gdzie znajdziesz bardziej szczegółowe informacje o każdym typie podpowiedzi.

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

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    ciąg znaków place_id OPTIONAL, dokładnie 1 z place_id, address, place_info Wartość business_profile_id lub lat_lng musi być obecnie.
    Identyfikator PlaceId określony przez Places API. Jednoznacznie identyfikuje ciekawe miejsce w Google. Można ją znaleźć na stronie Miejsca punkty końcowe interfejsu API, takie jak Wyszukiwanie miejsc lub Autouzupełnianie, lub ręcznie za pomocą narzędzia do znajdowania dopasowań lokalizacji w Centrum Atrakcji.
    ciąg znaków adres OPTIONAL, dokładnie 1 z place_id, address, place_info Wartość business_profile_id lub lat_lng musi być obecnie.
    WYCOFANY. Starszy adres jednowierszowy. Maksymalna długość: 200 znaków. Komponenty powinny być rozdzielone przecinkami, a pierwszy z nich to nazwa miejsca wyświetlana w Google. Lepsze dopasowanie dokładności, użyj adresu tego miejsca widocznego w Google.
    PlaceInfo place_info OPTIONAL, dokładnie 1 z place_id, address, place_info Wartość business_profile_id lub lat_lng musi być obecnie.
    Uporządkowane informacje o miejscu.
    uint64 business_profile_id OPTIONAL, dokładnie 1 z place_id, address, place_info Wartość business_profile_id lub lat_lng musi być obecnie.
    Identyfikator profilu firmy zgodny z ustawieniami profilu firmy w Google stronę. Użyj tego pola przy pozyskaniu lokalizacji bezpośrednio z miejsca właściciela danego miejsca, który ma dostęp do Profilu Firmy w Google może dostarczyć taki identyfikator.
    google.type.LatLng lat_lng OPTIONAL, dokładnie 1 z place_id, address, place_info Wartość business_profile_id lub lat_lng musi być obecnie.
    Współrzędne geograficzne. Tego pola można użyć tylko do określenia miasta czy region geograficzny, ponieważ jest zbyt niejednoznaczny, aby można było zidentyfikować miejsca i firmy. Zamiast tego użyj parametru place_info, aby dopasować do konkretne miejsce, podając jego nazwę i współrzędne.

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

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    ciąg znaków nazwa WYMAGANE. Maksymalna długość: 300 znaków. Nazwa miejsca lub firmy. Wyższe dokładności, musi być taka sama jak nazwa wyświetlana w Google danego miejsca. W przypadku miejsc, do których zgłoszono prawa w Profilu Firmy w Google, Powinna być taka sama jak nazwa firmy skonfigurowana w tej firmie profil.
    ciąg znaków phone_number OPCJONALNE. Maksymalna długość: 30 znaków. Numer telefonu wraz z międzynarodowy prefiks. Aby zwiększyć dokładność dopasowania, należy podać taki sam jak numer telefonu tego miejsca widoczny w Google. Mogą one obejmować często używane znaki separatora. Przykłady: "+1 212-363-3200", „+91 562 222 7261”.
    ciąg znaków website_url OPCJONALNE. Maksymalna długość: 1000 znaków. Adres URL witryny wyświetlanej w Google dla najlepiej podać adres URL, do którego link znajduje się w informacjach o firmie w Google Mapy lub wyszukiwanie miejsca.
    google.type.LatLng współrzędne OPCJONALNE. Współrzędne geograficzne miejsca. Jeśli pozostawisz to pole puste, Google będzie określać współrzędne na podstawie adresu. Opcjonalna, ale możesz też coordinates lub dowolne z tych elementów: structured_address i Musisz podać wartość unstructured_address.
    StructuredAddress structured_address OPCJONALNE, dokładnie 1 z structured_address lub Może występować unstructured_address, ale nie oba jednocześnie.
    ciąg znaków unstructured_address OPCJONALNE, dokładnie 1 z structured_address lub Może występować unstructured_address, ale nie oba jednocześnie.

    Przykłady

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

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

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

    StructuredAddress

    Proto

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

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

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

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

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

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    ciąg znaków street_address WYMAGANE. Maksymalna długość: 200 znaków. Ulica i numer domu oraz innych komponentów, których nie można dostarczyć za pomocą bardziej szczegółowego . Nie może zawierać nazwy miejsca ani firmy, które należy podać oddzielnie za pomocą atrybutu name w sekcji PlaceInfo. Powinna nie zawierają również kodu pocztowego, miejscowości ani kraju, ponieważ podane za pomocą odpowiednich pól.
    ciąg znaków rejon OPCJONALNE. Maksymalna długość: 80 znaków. rejon, zwykle odnoszący się do miasta, czy części adresu miejscowości. w regionach świata, w których miejscowości nie są dobrze zdefiniowane lub nie pasują do tej struktury, pozostaw puste.
    ciąg znaków administrative_area OPCJONALNE. Maksymalna długość: 80 znaków. Najwyższy stosowany podział administracyjny adresów pocztowych w konkretnym kraju lub regionie. Może to być stan, region, prowincja, obwód, prefektura. Może to być skrót lub pełną nazwę, w zależności od regionu zawarte w adresach pocztowych poszczególnych krajów.
    ciąg znaków postal_code OPCJONALNE. Maksymalna długość: 30 znaków. Kod pocztowy. Wymagany, jeśli kraj obsługuje kody pocztowe. W przeciwnym razie pole powinno pozostać puste.
    ciąg znaków country_code OPCJONALNE. Maksymalna długość: 2. Kod kraju określony przez Unicode „CLDR”. zgodny ze standardem ISO 3166 alfa-2. Zobacz 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;
}

    Uwagi dotyczące implementacji

    Typ Pole Uwagi
    repeated
    google.type.LocalizedText    		 localized_texts Wartości tekstowe zlokalizowanego tekstu dla poszczególnych języków.

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

    Uwagi dotyczące implementacji

    Określa pojedynczy warunek zwrotu środków. Można określić wiele warunków zwrotu środków razem opisują „czynności dotyczące zwrotu środków”. w postaci różnych czasów trwania przed godzinę rozpoczęcia.

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

    RefundCondition

    Typ Pole Uwagi
    uint32 min_duration_before_start_time_sec Opcjonalnie.
    Czas trwania w sekundach przed czasem rozpoczęcia, do kiedy klient może otrzymać zwrot części kosztów usługi określonej w refund_percent Gdy zasada jest nieskonfigurowana lub ma wartość 0, usługę można w każdej chwili anulować.
    uint32 refund_percent OPCJONALNE.
    Procent kwoty zwrotu, o ile rezerwacja usługi została anulowana co najmniej min_duration_before_start_time przed godziną rozpoczęcia usługi w zakresie [0, 100]. Gdy zasada jest nieskonfigurowana lub ma wartość 0, usługa nie podlega zwrotowi. Gdy ustawisz wartość 100, ta usługa będzie podlegają pełnym zwrotom.
    google.type.Money refund_fee OPCJONALNE.
    Stała opłata odliczana od zwrotu środków. Można użyć oddzielnie lub w połączeniu z atrybutem refund_percent. W w drugim przypadku jako pierwszy obowiązuje procent zwrotu środków, a później odejmowana jest opłata.

    Przykłady

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