Produktfeed

Über den Produktfeed können Sie Google in erster Linie eine Liste von Produkten für Aktivitäten zur Verfügung stellen, die auf verschiedenen Google-Plattformen präsentiert werden sollen.

Ein ProductFeed-Objekt besteht aus einem einzelnen FeedMetadata-Objekt und null oder mehr Product-Objekten. Wenn in allen Shards kein Product angegeben ist, werden alle Produkte gelöscht.

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

Implementierungshinweise

Typ	Feld	Hinweise
FeedMetadata	feed_metadata	ERFORDERLICH. Metadaten für diesen Feed.
wiederholte Produkt	Produkte	OPTIONAL. Wenn in allen Shards nicht festgelegt, werden alle Produkte gelöscht. feed_metadata/max_removal_share muss möglicherweise festgelegt werden, wenn eine große Anzahl von Produkten entfernt wird.

Beispiele

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

Implementierungshinweise

Typ	Feld	Hinweise
uint32	shard_id	ERFORDERLICH, wenn total_shards_count > 1.  Nullbasiert. Shards müssen nicht in der richtigen Reihenfolge übertragen werden. Die Verarbeitung beginnt erst, nachdem alle Shards hochgeladen wurden.
uint32	total_shards_count	ERFORDERLICH, muss >= 1 sein.
uint64	Nonce	ERFORDERLICH, wenn total_shards_count > 1. Muss für alle Shards innerhalb der Übertragung gleich sein.
enum	processing_instruction	ERFORDERLICH. PROCESS_AS_SNAPSHOT ist der einzige unterstützte Wert.
double	max_removal_share	OPTIONAL. Maximaler Anteil aktiver Produkte, die durch einen Upload entfernt werden dürfen. Wenn durch diese Übertragung weitere Produkte entfernt werden, wird die gesamte Übertragung abgelehnt. Dies soll verhindern, dass ein erheblicher Teil des Inventars versehentlich entfernt wird. Kann auf 1,0 gesetzt werden, um die vollständige Entfernung des Inventars zu ermöglichen.

Beispiele

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

Implementierungshinweise

Typ	Feld	Hinweise
String	id	ERFORDERLICH, maximale Länge: 255 Zeichen. Ein eindeutiger String, der das Produkt identifiziert. Zulässige Zeichen sind alphanumerische Zeichen, Unterstriche und Bindestriche.
LocalizedTextSet	Titel	ERFORDERLICH, empfohlene Länge: max. 50 Zeichen, maximale Länge: 150 Zeichen. Weitere Informationen finden Sie unter Richtlinien für Titel und Beschreibungen.
LocalizedTextSet	Beschreibung	EMPFOHLEN, empfohlene Länge <= 10.000, maximale Länge 16.000 Zeichen. Weitere Informationen finden Sie unter Richtlinien für Titel und Beschreibungen.
wiederholtes TextFeature	product_features	EMPFOHLEN, maximale Anzahl von Attributen: 100.
Bewertung	rating	EMPFOHLEN Es wird dringend empfohlen, Bewertungen anzugeben, da Produkte mit Bewertungen zu einer höheren Klickrate führen.
wiederholte Media	related_media	EMPFOHLEN, maximale Anzahl von Media: 30  Es wird dringend empfohlen, mehr als ein Bild bereitzustellen. Weitere Informationen
boolean	use_media_order	OPTIONAL Hinweis an Google, dass die Reihenfolge, in der verknüpfte Media im Feed aufgeführt sind, bei der Auswahl des anzuzeigenden Bildes berücksichtigt werden sollte.
repeated Option	Optionen	ERFORDERLICH, max. Anzahl der Optionen: 20 Jedes Produkt muss mindestens eine Produktoption haben.
Operator	Operator	OPTIONAL.
enum	deprecated inventory_type	OPTIONAL. INVENTORY_TYPE_OFFICIAL kann nur in Produkten festgelegt werden, die auf die offizielle Ticketwebsite eines POI verweisen. Die Möglichkeit, diesen Wert festzulegen, wird erst nach einer Eignungsüberprüfung aktiviert. Dieses Feld wurde eingestellt und durch das neue wiederholte Feld „inventory_types“ ersetzt.
repeated	inventory_types	OPTIONAL. Wiederholte Liste der eindeutigen Inventartypen, zu denen dieses Produkt gehört. INVENTORY_TYPE_OFFICIAL kann nur in Produkten festgelegt werden, die auf die offizielle Ticketwebsite eines POI verweisen. Die Möglichkeit, diesen Wert festzulegen, wird erst nach einer Eignungsüberprüfung aktiviert. INVENTORY_TYPE_OPERATOR_DIRECT kann nur für Produkte festgelegt werden, die auf die Website des Touranbieters verweisen. Die Möglichkeit, diesen Wert festzulegen, wird erst nach einer Eignungsüberprüfung aktiviert.
enum	confirmation_type	OPTIONAL.
FulfillmentType	fulfillment_type	EMPFOHLEN Wenn festgelegt, muss mindestens ein Feld in fulfillment_rype „true“ sein. Legt fest, wie ein Dokument zur Bestätigung der Buchung abgerufen werden kann. Kombinationen sind möglich, z. B. mobil + gedruckt oder zu Hause gedruckt + persönliche Abholung.
LocalizedTextSet	brand_name	Maximale Länge: 100 Zeichen. Der Markenname, der für das Produkt angezeigt werden soll. Er ersetzt den jetzt eingestellten `operator/name`. Es kann nur einer der beiden Werte festgelegt werden.

Beispiele

{
  "id": "product-1",
  "title": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans bike tour"
          },
          {
              "language_code": "es",
              "text": "Tour en bicicleta por Dans"
          },
          {
              "language_code": "zh-HK",
              "text": "丹斯自行車之旅"
          }
      ]
  },
  "description": {
    "localized_texts": [
        {
            "language_code": "en",
            "text": "<p>A very fun bike tour<p>"
        },
        {
            "language_code": "es",
            "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
        },
        {
            "language_code": "zh-HK",
            "text": "<p>一個非常有趣的自行車之旅.</p>"
        }
    ]
  },
  "brand_name": {
      "localized_texts": [
          {
              "language_code": "en",
              "text": "Dans Bikes"
          }
      ]
  },
  "rating": {
      "average_value": 4.6,
      "rating_count": 192
  },
  "product_features": [{
    "feature_type": "TEXT_FEATURE_INCLUSION",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
          {
              "language_code": "es",
              "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
          },
          {
              "language_code": "zh-HK",
              "text": "<p>一個非常有趣的自行車之旅.</p>"
          }
      ]
    }
  },{
    "feature_type": "TEXT_FEATURE_HIGHLIGHT",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
              },
              {
                  "language_code": "es",
                  "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
              },
              {
                  "language_code": "zh-HK",
                  "text": "<p>一個非常有趣的自行車之旅.</p>"
              }
          ]
      }
  },{
    "feature_type": "TEXT_FEATURE_MUST_KNOW",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
            {
                "language_code": "es",
                "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
            },
            {
                "language_code": "zh-HK",
                "text": "<p>一個非常有趣的自行車之旅.</p>"
            }
        ]
      }
  }],
  "options": [{
    "id": "option-1",
    "title": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "Sunset tour"
            },
            {
                "language_code": "es",
                "text": "Tour al atardecer"
            },
            {
                "language_code": "zh-HK",
                "text": "日落之旅"
            }
        ]
    },
    "landing_page": {
        "url": "https://www.danstour.com/sunset?language={lang}&currency={currency}"
    },
    "cancellation_policy": {
        "refund_conditions": [
            {
                "min_duration_before_start_time_sec": 86400,
                "refund_percent": 100
            }
        ]
    },
    "option_categories": [
        {
            "label": "sports"
        },
        {
            "label": "bike-tours"
        }
    ],
    "related_locations": [
        {
            "location": {
                "location": {
                    "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        },
        {
            "location": {
                "location": {
                    "lat_lng": {
                        "latitude": 53.339688,
                        "longitude": 6.236688
                    }
                }
            },
            "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
        }
    ],
    "price_options": [
        {
            "id": "option-1-adult",
            "title": "Adult (14+)",
            "price": {
                "currency_code": "EUR",
                "units": 20
            },
            "fees_and_taxes": {
                "per_ticket_fee": {
                    "currency_code": "EUR",
                    "units": 1
                },
                "per_ticket_tax": {
                    "currency_code": "EUR",
                    "units": 1
                }
            }
        }
    ]},{
      "id": "option-2",
      "title": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Sunrise tour"
              },
              {
                  "language_code": "es",
                  "text": "Tour al amanecer"
              },
              {
                  "language_code": "zh-HK",
                  "text": "日出之旅"
              }
          ]
      },
      "landing_page": {
          "url": "https://www.danstour.com/sunrise?language={lang}&currency={currency}"
      },
      "cancellation_policy": {
          "refund_conditions": [
              {
                  "min_duration_before_start_time_sec": 86400,
                  "refund_percent": 100
              }
          ]
      },
      "option_categories": [
          {
              "label": "sports"
          },
          {
              "label": "bike-tours"
          }
      ],
      "related_locations": [
          {
              "location": {
                  "location": {
                      "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
                  }
              },
              "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
          }
      ],
      "price_options": [
          {
              "id": "option-2-adult",
              "title": "Adult (14+)",
              "price": {
                  "currency_code": "EUR",
                  "units": 20,
                  "nanos": 0
              }
          }
      ],
      "meeting_point": {
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          },
          "description": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Sunrise tour"
                  },
                  {
                      "language_code": "es",
                      "text": "Tour al amanecer"
                  },
                  {
                      "language_code": "zh-HK",
                      "text": "日出之旅"
                  }
              ]
          }
      }
    }
  ],
  "related_media": [
      {
          "url": "http://www.danstour.com/photo1.jpg",
          "type": "MEDIA_TYPE_PHOTO"
      },
      {
          "url": "http://www.danstour.com/photo2.jpg",
          "type": "MEDIA_TYPE_PHOTO",
          "attribution": {
              "localized_texts": [
                  {
                      "language_code": "en",
                      "text": "Dans Photos"
                  }
              ]
          }
      }
  ],
  "operator": {
      "name": {
          "localized_texts": [
              {
                  "language_code": "en",
                  "text": "Dans Bikes"
              }
          ]
      },
      "phone_number": "01234567",
      "locations": [{
          "location": {
              "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
          }
        }]
  },
  "inventory_types": ["INVENTORY_TYPE_OPERATOR_DIRECT"]
}

Option

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

Implementierungshinweise

Typ	Feld	Hinweise
String	id	ERFORDERLICH. Options-ID Muss innerhalb eines Produkts eindeutig sein.
LocalizedTextSet	Titel	ERFORDERLICH, empfohlene Länge: 50 Zeichen, maximale Länge: 150 Zeichen. Wenn es nur eine Option gibt, kann der Optionstitel mit dem Produkttitel identisch sein. Wenn mehrere Produktoptionen präsentiert werden, muss der Titel für die jeweilige Option eindeutig sein. Weitere Informationen finden Sie unter Richtlinien für Titel und Beschreibungen.
LocalizedTextSet	Beschreibung	EMPFOHLEN, empfohlene Länge: 10.000, maximale Länge: 16.000. Weitere Informationen finden Sie unter Richtlinien für Titel und Beschreibungen.
DeepLink	landing_page	ERFORDERLICH.  Muss eine Schaltfläche oder einen Link zum Buchen des Produkts enthalten. Weitere Informationen finden Sie in den Richtlinien für Landingpages.
DeepLink	landing_page_list_view	EMPFOHLEN  Link zu einer Listenansicht mit einer höheren Anzahl verfügbarer Tickets und Touren, in der diese Option möglicherweise neben anderen Optionen gut sichtbar angezeigt wird. Weitere Informationen finden Sie in den Richtlinien für Landingpages.
wiederholtes TextFeature	option_features	OPTIONAL, maximale Anzahl von Features: 100.  Die Details aus der Produktebene dürfen nicht dupliziert werden.
CancellationPolicy	cancellation_policy	EMPFOHLEN
repeated Category	option_categories	Optional, maximale Anzahl von Kategorien: 100. Relevante Kategorien für diese Option. Weitere empfohlene Werte finden Sie in der Dokumentation zur Produktkategorie.
repeated RelatedLocation	related_location	EMPFOHLEN, maximale Anzahl von Standorten: 100. Eine genaue Liste der zugehörigen Standorte ist sehr wichtig, damit das Produkt an den relevantesten Stellen präsentiert wird. Wenn Sie jedoch zu viele Tags verwenden oder ungenaue Daten angeben, wird das Produkt entfernt. Weitere Informationen finden Sie im Leitfaden Standort und POI.
bool	base_ticket	OPTIONAL. Wird verwendet, um anzugeben, ob die Produktoption das Basisticket ist.
repeated PriceOption	price_options	ERFORDERLICH, mindestens 1. Alle möglichen Preise für diese Option. Hinweis: Es wird nur der Preis für Erwachsene unterstützt. Wenn mehrere Preisoptionen angegeben wurden, wird der erste Preis verwendet, der die Prüfung der geografischen Einschränkung besteht. Bei Gruppentickets muss stattdessen der volle Preis für die gesamte Gruppe verwendet werden.
uint32	duration_sec	OPTIONAL. Dauer der Option in Sekunden, sofern zutreffend, z. B. bei geführten Touren oder Bootsfahrten. Das sollte die Dauer des Tests (nicht die Gültigkeitsdauer) widerspiegeln.
repeated Language	Sprachen	EMPFOHLEN, maximale Anzahl von Sprachen: 100. Sprachen, in denen die Option verfügbar ist. Wenn es für den Endnutzer wichtig ist, die Sprache zu verstehen und/oder zu lesen, um die Inhalte nutzen zu können. Zum Beispiel für eine Führung.
Standort	meeting_point	OPTIONAL. Fügen Sie nur Orte hinzu, die relevant und nützlich sind, z. B. den Ort, an dem der Teilnehmer den Reiseleiter trifft, um eine Wanderung zu beginnen, den Ort, an dem der Teilnehmer für eine Stadtrundfahrt abgeholt wird, oder das Dock, an dem eine Kreuzfahrt beginnt.

Beispiele

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

Implementierungshinweise

Typ	Feld	Hinweise
enum	feature_type	ERFORDERLICH. Funktionstyp, mögliche Werte: TEXT_FEATURE_INCLUSION: Das Feature ist eine Einbeziehung. TEXT_FEATURE_EXCLUSION: Das Feature ist ein Ausschluss. TEXT_FEATURE_HIGHLIGHT: Das Feature ist ein Highlight. TEXT_FEATURE_MUST_KNOW: Die Funktion ist ein „Must-know“. TEXT_FEATURE_SAFETY_INFORMATION: Das Feature enthält Informationen zu Sicherheitsmaßnahmen.
LocalizedTextSet	Wert	ERFORDERLICH, empfohlene Länge: max. 1.000 Zeichen, maximale Länge: 2.000 Zeichen. Unterstützte HTML-Formatierungstags: br, strong, em, i Nur die vier oben genannten Tags werden unterstützt. br kann für Zeilenumbrüche in Absätzen verwendet werden, mit strong/em/i lässt sich wichtiger Text hervorheben. Alle anderen Wortgruppentags werden ignoriert. Alle anderen Tags und benutzerdefinierten Formate sind nicht zulässig und werden entfernt. URLs, Anchor-Tags und Links werden entfernt und Endnutzern nie angezeigt.

Beispiele

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

Bewertung

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

Implementierungshinweise

Typ	Feld	Hinweise
double	average_value	OPTIONAL. Durchschnittliche Bewertung. Der Wert muss zwischen 1 und 5 liegen. Er darf nur dann weggelassen werden, wenn rating_count null ist.
uint64	rating_count	ERFORDERLICH. Anzahl der Bewertungen, die der Berechnung des Werts zugrunde liegen.

Beispiele

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

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

Medien

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

Implementierungshinweise

Typ	Feld	Hinweise
String	URL	ERFORDERLICH, maximale Länge: 2.000 Zeichen. Die URL der Medienquelle. Google crawlt die Medien, die unter dieser URL gehostet werden.
enum	Typ	ERFORDERLICH. Typ dieser Medienquelle. Mögliche Werte: MEDIA_TYPE_PHOTO: Gibt an, dass es sich bei den über die URL bereitgestellten Medien um ein Foto handelt.
LocalizedTextSet	Attribution	OPTIONAL, empfohlene Länge: 1.000, maximale Länge: 2.000.  Angaben zur Quelle des Fotos. Das Feld muss festgelegt werden, wenn die Quellenangaben zusammen mit dem Foto angezeigt werden sollen, um den Fotografen oder die Agentur zu nennen.

Beispiele

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

Kategorie

Proto

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

Implementierungshinweise

Typ	Feld	Hinweise
String	Label	ERFORDERLICH. Eine Liste der gültigen Werte finden Sie in der Dokumentation zur Produktkategorie.

Beispiele

{
    "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 {
    RELATION_TYPE_UNSPECIFIED = 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;

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

  // Relation type of an option for the given location.
  // Required.
  RelationType relation_type = 2;
}

Implementierungshinweise

Definiert die Beziehung zwischen einer Option und einem Ort.

Typ	Feld	Hinweise
Standort	Standort	ERFORDERLICH. Standort in Bezug auf eine Option. Kann ein POI (z. B. Eiffelturm), ein Stadtteil (z. B. Altstadt) oder eine Adresse bzw. ein beliebiger Kartenpunkt sein.
enum	relation_type	ERFORDERLICH. Beziehungstyp einer Option für den angegebenen Standort. Mögliche Werte: RELATION_TYPE_RELATED_NO_ADMISSION: Der Ort ist verwandt, aber die Beziehung erlaubt keinen Eintritt oder der Eintritt ist irrelevant, z. B. wenn der Ort ein Platz ist, der in einer Stadtführung hervorgehoben wird. RELATION_TYPE_ADMISSION_TICKET: Die Beziehung gewährt den Zugriff auf diesen zugehörigen Ort. RELATION_TYPE_SUPPLEMENTARY_ADDON: Mit „Relation“ wird ein zusätzlicher Dienst deklariert, der den Nutzer nicht zum zugehörigen Ort bringt, z. B. ein Parkticket oder eine temporäre Ausstellung.

Beispiele

// 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": {
          "place_info": {
              "name": "Eiffel Tower",
              "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
          }
        }
    },
    "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;
}

Implementierungshinweise

Definition von Deeplinks. Kann Wertparameter enthalten, die zum Zeitpunkt der Auslieferung erweitert werden.

Typ	Feld	Hinweise
String	URL	OPTIONAL, max. Länge: 2.000. URL-Vorlage für die Landingpage für Computer. Entweder `url` oder `localized_url` ist erforderlich.
LocalizedTextSet	localized_url	OPTIONAL, maximale Länge: 2.000, maximale Anzahl an lokalen Einheiten: 50. Lokalisierte Landingpages-URL-Vorlage für Desktop. Wenn sowohl url als auch localized_url angegeben sind, wird url als Fallback verwendet, falls keine URL mit dem Gebietsschema des Nutzers übereinstimmt. Wenn url nicht verfügbar ist und keine Sprache angegeben ist, wird die englische URL verwendet.

Beispiele

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

Implementierungshinweise

Typ	Feld	Hinweise
LocalizedTextSet	name [deprecated]	OPTIONAL, empfohlene Länge: 50, maximale Länge: 100. Der Markenname des Verkäufers dieses Produkts. OTAs sollten dies als OTA-Marke festlegen. Dieses Feld wird nicht mehr verwendet und wurde durch „brand_name“ unter „products“ ersetzt.
LocalizedTextSet	google_business_profile_name	ERFORDERLICH, maximale Länge: 100 Zeichen.  Name des Betreiberunternehmens, wie er im Unternehmensprofil registriert ist und in Google Maps angezeigt wird. Dieses Feld ist für die Teilnahme am Buchungsmodul für Betreiber erforderlich.
String	phone_number	OPTIONAL, max. Länge: 64. Telefonnummer des Betreibers. Bevorzugen Sie das vollständige internationale Telefonnummernformat.
repeated Location	Standorte	OPTIONAL, max. Anzahl: 1. Die Geschäftsadresse des Betreibers. Wenn ein Adressstring verwendet wird, muss der Name des Unternehmens Teil des Adressstrings sein. Beispiel: „Name des Unternehmens, Adresse“. Betreiber Das Unternehmen muss auf Google Maps zu finden sein, damit das Buchungsmodul des Betreibers ausgelöst wird. Wenn das Unternehmen nicht auf Google Maps zu finden ist, sollte der Betreiber ein Unternehmensprofil bei Google registrieren.

Beispiele

// 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
    "place_info": {
      "name": "Dans Bike Tour",
      "unstructured_address": "123 Baker st..."
    }
  }}]
}

Sprache

Proto

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

Implementierungshinweise

Typ	Feld	Hinweise
String	Code	Ein BCP-47-konformer Sprachcode wie „en“ oder „de-CH“.

Beispiele

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

Implementierungshinweise

Typ	Feld	Hinweise
String	id	ERFORDERLICH, maximale Länge: 255 Zeichen.  Eindeutige ID innerhalb des Preissatzes.
String	Titel	ERFORDERLICH, maximale Länge: 150. Kurze Beschreibung der Preisoption, z. B. „Erwachsene, Wochentag“.
google.type.Money	Preis	ERFORDERLICH, wenn is_free „false“ ist. Preiswert, muss mit dem Endpreis auf der Bezahlseite übereinstimmen, einschließlich aller Steuern und Gebühren (siehe Preisrichtlinie). Die Währung wird beim Rendern in die Währung des Nutzers umgerechnet.
bool	is_free	OPTIONAL, Standardwert ist „false“. Der Eintritt oder die Tickets sind kostenlos. Muss für Optionen mit dem Preis „0“ auf „true“ gesetzt werden.
repeated GeoCriterion	geo_criteria	OPTIONAL. Liste der geografischen Regionen, für die dieser Preis gilt. Wenn leer, gilt die Einstellung für alle Standorte.
repeated PriceFeesAndTaxes	fees_and_taxes	OPTIONAL. Aufschlüsselung der im Preis enthaltenen Gebühren und Steuern.

Beispiele

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

Implementierungshinweise

Typ	Feld	Hinweise
String	country_code	ERFORDERLICH. Zweistelliger Ländercode gemäß ISO 3166-1.
bool	is_negative	OPTIONAL. Wenn „true“, ist das Kriterium negativ (der Ländercode wird ausgeschlossen).

Beispiele

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

Implementierungshinweise

Typ	Feld	Hinweise
google.type.Money	per_ticket_fee	OPTIONAL. Im endgültigen Produktpreis für ein einzelnes Ticket enthaltene Buchungsgebühren.
google.type.Money	per_ticket_tax	OPTIONAL. Geben Sie die im Endpreis für ein einzelnes Ticket enthaltenen Steuern an.

Beispiele

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

Standort

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

Implementierungshinweise

Typ	Feld	Hinweise
GeoLocation	Standort	OPTIONAL, mindestens einer der Parameter „location“ oder „description“ muss vorhanden sein. Der geografische Standort.
LocalizedTextSet	Beschreibung	OPTIONAL, empfohlene Länge: 1.000, maximale Länge: 2.000, mindestens eine der Angaben „location“ oder „description“ muss vorhanden sein. Zusätzliche Beschreibung in menschenlesbarer Form, z. B. „Auf der linken Seite des Brunnens auf dem Schlossplatz“.

Beispiele

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

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

GeoLocation

Weitere Informationen zu den einzelnen Hinweistypen

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

Implementierungshinweise

Typ	Feld	Hinweise
String	place_id	OPTIONAL, genau einer der Werte place_id, address, place_info, business_profile_id oder lat_lng muss vorhanden sein. PlaceId gemäß Definition in der Places API. Hiermit wird ein POI bei Google eindeutig identifiziert. Sie können sie über die Places API-Endpunkte, z. B. Place Search oder Place Autocomplete, oder manuell über das Tool „Passende Orte finden“ im Things to Do Center beziehen.
String	Adresse	OPTIONAL, genau einer der Werte place_id, address, place_info, business_profile_id oder lat_lng muss vorhanden sein. VERALTET. Veraltete einzeilige Adresse. Maximale Länge: 200 Zeichen. Die Komponenten müssen durch Kommas getrennt sein. Die erste Komponente ist der Ortsname, wie er auf Google angezeigt wird. Für eine höhere Genauigkeit beim Abgleich verwenden Sie die Straßenadresse, die bei Google für den Ort angezeigt wird.
PlaceInfo	place_info	OPTIONAL, genau einer der Werte place_id, address, place_info, business_profile_id oder lat_lng muss vorhanden sein. Strukturierte Ortsinformationen.
uint64	business_profile_id	OPTIONAL, genau einer der Werte place_id, address, place_info, business_profile_id oder lat_lng muss vorhanden sein. Unternehmensprofil-ID, die Sie auf der Seite „Einstellungen“ in Ihrem Unternehmensprofil finden. Verwenden Sie dieses Feld, wenn Sie Standorte direkt vom Inhaber des Orts beziehen, der Zugriff auf das Google Unternehmensprofil für den Ort hat und eine solche ID angeben kann.
google.type.LatLng	lat_lng	OPTIONAL, genau einer der Werte place_id, address, place_info, business_profile_id oder lat_lng muss vorhanden sein. Geografische Koordinaten. Dieses Feld kann nur verwendet werden, um eine Stadt oder geografische Region zu ermitteln, da es zu ungenau ist, um einen bestimmten Ort oder ein bestimmtes Unternehmen zu identifizieren. Verwenden Sie stattdessen place_info, um einen bestimmten Ort anhand von Name und Koordinaten zu finden.

Beispiele

"place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"

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

Implementierungshinweise

Typ	Feld	Hinweise
String	name	ERFORDERLICH. Maximale Länge: 300. Name des Orts oder Unternehmens. Für eine höhere Übereinstimmungsgenauigkeit sollte dieser Name mit dem Namen übereinstimmen, der bei Google für den Ort angezeigt wird. Bei Orten mit einem beanspruchten Google Unternehmensprofil sollte dies mit dem im Unternehmensprofil konfigurierten Namen des Unternehmens übereinstimmen.
String	phone_number	OPTIONAL. Maximale Länge: 30. Telefonnummer, einschließlich der internationalen Vorwahl. Für eine höhere Abgleichgenauigkeit sollte diese mit der Telefonnummer übereinstimmen, die bei Google für den Ort angezeigt wird. Sie kann häufig verwendete Trennzeichen enthalten. Beispiele: „[phone]“, „[phone]“.
String	website_url	OPTIONAL. Maximale Länge: 1.000. Website-URL, die bei Google für den Ort angezeigt wird, vorzugsweise die URL, die im Brancheneintrag in Google Maps oder der Google Suche für den Ort verlinkt ist.
google.type.LatLng	Koordinaten	OPTIONAL. Geografische Koordinaten des Orts. Wenn Sie das Feld leer lassen, leitet Google die Koordinaten aus der Adresse ab. Optional, aber entweder coordinates oder structured_address und unstructured_address müssen angegeben werden.
StructuredAddress	structured_address	OPTIONAL: Es kann genau eines von structured_address oder unstructured_address vorhanden sein, aber niemals beide.
String	unstructured_address	OPTIONAL: Es kann genau eines von structured_address oder unstructured_address vorhanden sein, aber niemals beide.

Beispiele

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

Implementierungshinweise

Typ	Feld	Hinweise
String	street_address	ERFORDERLICH. Maximale Länge: 200 Zeichen. Adresse, einschließlich Hausnummer und aller anderen Komponenten, die nicht über die spezifischeren Felder angegeben werden können. Sie darf nicht den Namen des Orts oder Unternehmens enthalten, der stattdessen separat über das Feld name unter PlaceInfo angegeben werden muss. Sie sollte auch keine Postleitzahl, keinen Ort und kein Land enthalten, da diese in den entsprechenden Feldern angegeben werden sollten.
String	Ortsteil	OPTIONAL. Maximale Länge: 80. Ort, der sich in der Regel auf den Stadt- oder Ortsteil einer Adresse bezieht. Lassen Sie in Regionen der Welt, in denen Postorte nicht hinreichend definiert sind oder nicht dieser Struktur entsprechen, diese Angabe leer.
String	administrative_area	OPTIONAL. Maximale Länge: 80. Höchste Ebene der Verwaltungsgliederung, die für Postadressen des jeweiligen Landes oder der jeweiligen Region verwendet wird. Dies kann ein Bundesland, eine Region, eine Provinz, eine Oblast oder eine Präfektur sein. Das kann eine Abkürzung oder ein vollständiger Name sein, je nachdem, wie die Region in den Postadressen des jeweiligen Landes normalerweise dargestellt wird.
String	Postleitzahl	OPTIONAL. Maximale Länge: 30. Die Postleitzahl. Erforderlich, wenn das Land Postleitzahlen unterstützt. Andernfalls sollte das Feld leer bleiben.
String	country_code	OPTIONAL. Maximale Länge: 2. Ländercode gemäß Unicode-„CLDR“, der auf dem ISO 3166-Alpha-2-Standard basiert. Weitere Informationen finden Sie in der Unicode-Dokumentation.

Beispiele

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

Implementierungshinweise

Typ	Feld	Hinweise
repeated google.type.LocalizedText	localized_texts	Lokalisierte Textwerte pro Sprache Maximale Anzahl von Sprachen: 50.

Beispiele

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

Implementierungshinweise

Definiert eine einzelne Erstattungsbedingung. Mehrere Erstattungsbedingungen können zusammen verwendet werden, um „Erstattungsschritte“ als verschiedene Zeiträume vor der Startzeit der Dienstleistung zu beschreiben.

Typ	Feld	Hinweise
RefundCondition	refund_conditions	OPTIONAL, maximale Anzahl der Erstattungsbedingungen: 10.

RefundCondition

Typ	Feld	Hinweise
uint32	min_duration_before_start_time_sec	Optional. Dauer in Sekunden vor der Startzeit, bis zu der der Kunde eine Erstattung für einen Teil der in refund_percent angegebenen Kosten für die Dienstleistung erhält. Wenn der Wert nicht festgelegt oder auf 0 gesetzt ist, kann die Dienstleistung jederzeit storniert werden.
uint32	refund_percent	OPTIONAL. Der Prozentsatz im Bereich von [0, 100], der erstattet werden kann, solange die Buchung mindestens min_duration_before_start_time vor der Startzeit der Dienstleistung storniert wird. Wenn der Wert nicht festgelegt oder auf 0 gesetzt ist, ist keine Erstattung möglich. Ist er auf 100 gesetzt, kann die Dienstleistung vollständig erstattet werden.
google.type.Money	refund_fee	OPTIONAL. Eine Pauschalgebühr, die bei einer Erstattung abgezogen wird. Kann separat oder in Kombination mit refund_percent verwendet werden. Im letzteren Fall wird zuerst der Erstattungsbetrag berechnet und dann die Gebühr abgezogen.

Beispiele

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