פיד מוצרים

פיד המוצרים הוא הדרך העיקרית שבה אפשר לספק ל-Google רשימה של מוצרים מסוג 'פעילויות' שרוצים להציג בפלטפורמות שונות של Google.

אובייקט ProductFeed מורכב מאובייקט FeedMetadata אחד ומאפס או יותר אובייקטים מסוג Product. אם לא מספקים את Product בכל הרסיסים, כל המוצרים נמחקים.

ProductFeed

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
FeedMetadata	feed_metadata	חובה. מטא-נתונים של הפיד.
repeated Product	מוצרים	אופציונלי. אם לא מגדירים את המאפיין הזה בכל הרסיסים, כל המוצרים נמחקים. feed_metadata/max_removal_share יכול להיות שיהיה צורך להגדיר את הערך הזה כשמסירים מספר גדול של מוצרים.

דוגמאות

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

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
uint32	shard_id	חובה אם הערך של total_shards_count גדול מ-1. מבוסס על אפס. אין צורך להעביר את הרסיסים בסדר מסוים. העיבוד יתחיל רק אחרי שכל חלקי הנתונים יועלו.
uint32	total_shards_count	חובה, הערך חייב להיות ‎>= 1.
uint64	צופן חד-פעמי (nonce)	חובה אם הערך של total_shards_count גדול מ-1. חייב להיות זהה לכל הרסיסים בהעברה.
טיפוסים בני מנייה (enum)	processing_instruction	חובה. PROCESS_AS_SNAPSHOT הוא הערך היחיד שנתמך.
double	max_removal_share	אופציונלי. החלק המקסימלי של מוצרים פעילים שאפשר להסיר בהעלאה. אם יוסרו עוד מוצרים במהלך ההעברה הזו, ההעברה כולה תידחה. ההגנה הזו נועדה למנוע הסרה לא מכוונת של חלק משמעותי ממלאי שטחי הפרסום. אפשר להגדיר את הערך כ-1.0 כדי לאפשר הסרה של כל המלאי.

דוגמאות

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

מוצר

אב

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 [features.enforce_naming_style = STYLE_LEGACY];

    // Booking is confirmed to the end user within 48 hours.
    CONFIRMATION_TYPE_48HRS = 3 [features.enforce_naming_style = STYLE_LEGACY];
  }

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

הערות לגבי הטמעה

סוג	שדה	הערות
מחרוזת	id [מזהה]	חובה, אורך מקסימלי של 255 תווים. מחרוזת ייחודית שמזהה את המוצר. התווים המותרים הם אלפאנומריים, _, ו-.
LocalizedTextSet	title	חובה, אורך מומלץ עד 50 תווים, אורך מקסימלי 150 תווים. פרטים נוספים מופיעים בהנחיות לכתיבת שם וdescription.
LocalizedTextSet	תיאור	מומלץ, אורך מומלץ <= 10,000, אורך מקסימלי 16,000 תווים. פרטים נוספים מופיעים בהנחיות לכתיבת שם וdescription.
‫repeated TextFeature	product_features	מומלץ, מספר הישויות המקסימלי: 100.
דירוג	סיווג	מומלץ. מומלץ מאוד לספק דירוגים, כי מוצרים עם דירוגים משיגים שיעור קליקים גבוה יותר.
repeated Media	related_media	מומלץ, מספר המדיה המקסימלי: 30 מומלץ מאוד לספק יותר מתמונה אחת. ההנחיות בנוגע לתמונות כוללות מדריך מפורט בנושא תמונות.
בוליאני	use_media_order	אופציונלי הוספת רמז ל-Google שלפיו צריך להתחשב בסדר שבו מוצגים פריטי המדיה שקשורים למוצר בפיד, כשבוחרים איזו תמונה להציג.
repeated Option	options	חובה, מספר האפשרויות המקסימלי: 20 לכל מוצר צריכה להיות לפחות אפשרות אחת.
אופרטור	אופרטור	אופציונלי.
טיפוסים בני מנייה (enum)	deprecated inventory_type	אופציונלי. INVENTORY_TYPE_OFFICIAL אפשר להגדיר את המאפיין הזה רק במוצרים שמקשרים לאתר הכרטיסים הרשמי של נקודת עניין. אפשר להגדיר את הערך הזה רק אחרי בדיקת הזכאות. השדה הזה הוצא משימוש והוחלף בשדה החדש inventory_types שחוזר על עצמו.
חוזר	inventory_types	אופציונלי. רשימה חוזרת של סוגי מלאי ייחודיים שהמוצר הזה שייך אליהם. INVENTORY_TYPE_OFFICIAL אפשר להגדיר את המאפיין הזה רק במוצרים שמקשרים לאתר הכרטיסים הרשמי של נקודת עניין. אפשר להגדיר את הערך הזה רק אחרי בדיקת הזכאות. INVENTORY_TYPE_OPERATOR_DIRECT אפשר להגדיר את המאפיין הזה רק במוצרים שמקשרים לאתר של מפעיל הסיורים. אפשר להגדיר את הערך הזה רק אחרי בדיקת הזכאות.
טיפוסים בני מנייה (enum)	confirmation_type	אופציונלי.
FulfillmentType	fulfillment_type	מומלץ. אם מגדירים את התנאי הזה, לפחות שדה אחד ב-fulfillment_rype צריך להיות נכון. מגדיר דרכים לקבלת מסמך לאישור ההזמנה. אפשר להשתמש בשילובים, למשל: נייד + מודפס, או מודפס בבית + איסוף אישי.
LocalizedTextSet	brand_name	אורך מקסימלי 100. שם המותג שיוצג במוצר. הערך הזה מחליף את הערך `operator/name` שיצא משימוש. אפשר להגדיר רק אחד משני הערכים.

דוגמאות

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

אפשרות

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
מחרוזת	id [מזהה]	חובה. מזהה האפשרות. המזהה חייב להיות ייחודי במסגרת מוצר.
LocalizedTextSet	title	חובה, אורך מומלץ: 50, אורך מקסימלי: 150 תווים. אם יש רק אפשרות אחת, יכול להיות ששם האפשרות יהיה זהה לשם המוצר. אם מוצגות כמה אפשרויות של מוצר, השם צריך להיות ייחודי לאפשרות. פרטים נוספים מופיעים בהנחיות לכתיבת שם ותיאור.
LocalizedTextSet	תיאור	מומלץ, אורך מומלץ: 10,000, אורך מקסימלי: 16,000. פרטים נוספים מופיעים בהנחיות לכתיבת שם וdescription.
DeepLink	landing_page	חובה. חובה לכלול לחצן או קישור להזמנת המוצר. פרטים נוספים זמינים בהנחיות לגבי דפי נחיתה.
DeepLink	landing_page_list_view	מומלץ. קישור לתצוגת רשימה ברמה גבוהה יותר של כרטיסים וסיורים זמינים, עם הצגה בולטת של האפשרות הזו, אולי בין אפשרויות אחרות. פרטים נוספים זמינים בהנחיות לגבי דפי נחיתה.
‫repeated TextFeature	option_features	אופציונלי, מספר התכונות המקסימלי: 100. אל תכללו פרטים שמופיעים ברמת המוצר.
CancellationPolicy	cancellation_policy	מומלץ.
‫repeated Category	option_categories	אופציונלי, מספר הקטגוריות המקסימלי: 100. קטגוריות רלוונטיות לאפשרות הזו. במאמר בנושא קטגוריית מוצרים מפורטים ערכים מומלצים נוספים.
‫repeated RelatedLocation	related_location	מומלץ, מספר המיקומים המקסימלי: 100. חשוב מאוד לספק רשימה מדויקת של מיקומים רלוונטיים כדי שהמוצר יוצג במקומות הרלוונטיים ביותר. עם זאת, אם תתייגו יותר מדי מיקומים או תספקו נתונים לא מדויקים, המוצר יוסר. פרטים נוספים זמינים במדריך בנושא מיקום ונקודות עניין.
בוליאני	base_ticket	אופציונלי. המאפיין הזה משמש כדי לציין אם אפשרות המוצר היא כרטיס כניסה בסיסי.
repeated PriceOption	price_options	חובה, לפחות מחיר אחד. כל המחירים האפשריים לאפשרות הזו. הערה: אפשר להציג רק מחיר למבוגרים. אם צוינו כמה אפשרויות מחיר, המערכת תשתמש במחיר הראשון שעובר את בדיקת ההגבלה הגיאוגרפית. במקרה של כרטיסים קבוצתיים, צריך להשתמש במחיר המלא של כל הקבוצה.
uint32	duration_sec	אופציונלי. משך האפשרות בשניות, במקרים הרלוונטיים, כמו סיורים מודרכים או טיולים בסירה. הערך הזה צריך לשקף את משך החוויה (לא את זמן התוקף).
repeated Language	שפות	מומלץ, מספר השפות המקסימלי: 100. השפות שבהן האפשרות זמינה. כשחשוב שמשתמש הקצה יבין ו/או יקרא בשפה כדי ליהנות מהחוויה. למשל: לסיור מודרך.
מיקום	meeting_point	אופציונלי. מוסיפים רק מיקומים רלוונטיים ומועילים, כמו המקום שבו המשתתפים יפגשו עם המדריך כדי להתחיל סיור רגלי, המקום שבו המשתתפים ייאספו לסיור בעיר או הרציף שבו יתחיל שייט.

דוגמאות

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

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
טיפוסים בני מנייה (enum)	feature_type	חובה. סוג התכונה, ערכים אפשריים: ‫TEXT_FEATURE_INCLUSION: התכונה כלולה. ‫TEXT_FEATURE_EXCLUSION: התכונה היא החרגה. ‫TEXT_FEATURE_HIGHLIGHT: התכונה היא נקודת שיא. TEXT_FEATURE_MUST_KNOW: התכונה היא 'מידע חשוב'. ‫TEXT_FEATURE_SAFETY_INFORMATION: התכונה מייצגת מידע על אמצעי בטיחות.
LocalizedTextSet	ערך	חובה, אורך מומלץ: עד 1,000 תווים, אורך מקסימלי: 2,000 תווים. תגי עיצוב HTML נתמכים: br, strong, em, i רק ארבעת התגים שצוינו נתמכים. אפשר להשתמש ב-br כדי ליצור מעברי שורה בפסקאות, וב-strong/em/i כדי להדגיש טקסט חשוב. המערכת תתעלם מתגי ביטוי אחרים. אסור להשתמש בתגים אחרים ובסגנונות בהתאמה אישית, והם יוסרו. כל כתובות ה-URL, העוגנים והקישורים יוסרו ולא יוצגו למשתמשי קצה.

דוגמאות

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

דירוג

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
double	average_value	אופציונלי. ערך הדירוג הממוצע. הערך צריך להיות בטווח [1, 5]. אפשר להשמיט אותו רק אם rating_count הוא אפס.
uint64	rating_count	חובה. מספר הדירוגים שמשמשים לחישוב הערך.

דוגמאות

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

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

מדיה

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
מחרוזת	כתובת אתר	חובה, אורך מקסימלי: 2,000. כתובת ה-URL של מקור המדיה הזה. ‫Google תסרוק את המדיה שמתארחת בכתובת ה-URL הזו.
טיפוסים בני מנייה (enum)	סוג	חובה. סוג מקור המדיה. ערכים אפשריים: ‫MEDIA_TYPE_PHOTO: מציין שהמדיה שסופקה בכתובת ה-URL היא תמונה.
LocalizedTextSet	ייחוס למקורות תנועה	אופציונלי, אורך מומלץ: 1,000, אורך מקסימלי: 2,000. שיוך מידע על מקור המדיה. חשוב לזכור שאם נדרש ציון הקרדיט לצד המדיה כדי לתת קרדיט לצלם או לסוכנות, צריך להגדיר את השדה הזה.

דוגמאות

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

קטגוריה

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
מחרוזת	תווית	חובה. רשימת הערכים התקינים מופיעה במסמכי התיעוד בנושא קטגוריות מוצרים.

דוגמאות

{
    "label": "sports"
}

RelatedLocation

אב

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

הערות לגבי הטמעה

המאפיין מגדיר את הקשר בין אפשרות למיקום.

סוג	שדה	הערות
מיקום	location	חובה. מיקום שקשור לאפשרות. יכול להיות נקודת עניין (למשל, מגדל אייפל), שכונה (למשל, העיר העתיקה) או כתובת / נקודה במפה.
טיפוסים בני מנייה (enum)	relation_type	חובה. סוג הקשר של אפשרות למיקום הנתון. ערכים אפשריים: ‫RELATION_TYPE_RELATED_NO_ADMISSION: המיקום קשור אבל הקשר לא מאפשר כניסה או שהכניסה לא רלוונטית, למשל אם המיקום הוא כיכר שמודגשת בסיור בעיר. ‫RELATION_TYPE_ADMISSION_TICKET: Relation מעניק כניסה למיקום הקשור הזה. ‫RELATION_TYPE_SUPPLEMENTARY_ADDON: מאפיין Relation מציין שירות נוסף שלא מאפשר למשתמש להגיע למיקום שקשור אליו, כמו כרטיס חנייה או תערוכה זמנית.

דוגמאות

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

אב

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

הערות לגבי הטמעה

הגדרה של קישור עומק. יכול לכלול פרמטרים של ערכים שיוצגו בזמן הצגת המודעה.

סוג	שדה	הערות
מחרוזת	כתובת אתר	אופציונלי, אורך מקסימלי: 2,000. תבנית של כתובת URL של דף נחיתה למחשב. חובה לציין את המאפיין `url` או את המאפיין `localized_url`.
LocalizedTextSet	localized_url	אופציונלי, אורך מקסימלי: 2,000, מספר מקסימלי של מקומיים: 50. Localized landing page URL template for desktop. אם מספקים את url ואת localized_url, הראשון משמש כברירת מחדל למקרה שאין כתובת URL שתואמת ללוקאל של המשתמש. אם url לא זמין ולא צוינה שפה, המערכת תשתמש בכתובת ה-URL באנגלית.

דוגמאות

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

מפעיל

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
LocalizedTextSet	שם [deprecated]	אופציונלי, אורך מומלץ: 50, אורך מקסימלי: 100. שם המותג של מוכר המוצר. סוכנויות נסיעות אונליין צריכות להגדיר את הערך הזה כמותג של סוכנות הנסיעות. השדה הזה הוצא משימוש והוחלף בשדה brand_name בקטע products
LocalizedTextSet	google_business_profile_name	חובה, אורך מקסימלי: 100. שם העסק של המפעיל כפי שהוא רשום בפרופיל העסק ב-Google ומופיע במפות Google. כדי להשתתף במודול ההזמנות של המפעיל, חובה למלא את השדה הזה.
מחרוזת	phone_number	אופציונלי, אורך מקסימלי: 64. מספר הטלפון של המפעיל. מומלץ להשתמש בפורמט מלא של מספר טלפון בינלאומי.
repeated Location	locations	אופציונלי, מספר מקסימלי: 1. כתובת העסק של המפעיל. אם משתמשים במחרוזת כתובת, צריך לכלול את שם העסק כחלק ממחרוזת הכתובת. לדוגמה: 'שם העסק, כתובת הרחוב'. כדי שמודול ההזמנות של המפעיל יופעל, העסק של המפעיל צריך להיות ניתן לאיתור במפות Google. אם העסק לא ניתן לאיתור במפות Google, המפעיל צריך לרשום פרופיל עסק ב-Google.

דוגמאות

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

שפה

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
מחרוזת	קוד	קוד שפה שתואם ל-BCP-47, כמו 'en' או 'de-CH'.

דוגמאות

{
    "code": "de-CH"
}

PriceOption

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
מחרוזת	id [מזהה]	חובה, אורך מקסימלי: 255. מזהה ייחודי בתוך קבוצת המחירים.
מחרוזת	title	חובה, אורך מקסימלי: 150. תיאור קצר של אפשרות התמחור, לדוגמה 'מבוגר ביום חול'.
google.type.Money	price	חובה אם הערך של is_free הוא false. ערך המחיר, שצריך להיות זהה למחיר הסופי בדף התשלום, כולל כל המיסים והחיובים. אפשר לעיין במדיניות בנושא מחירים. המטבע יומר למטבע של המשתמש בזמן העיבוד.
בוליאני	is_free	אופציונלי, ברירת המחדל היא False. הכניסה או הכרטיס הם בחינם. צריך להגדיר את הערך true לאפשרויות שבהן המחיר הוא אפס.
‫repeated GeoCriterion	geo_criteria	אופציונלי. רשימת האזורים הגיאוגרפיים שבהם המחיר הזה חל. אם לא תציינו ערך בשדה הזה, המועד האחרון לטיפול בהזמנות יחול על כל המיקומים.
‫repeated PriceFeesAndTaxes	fees_and_taxes	אופציונלי. פירוט של העמלות והמיסים שנכללים במחיר.

דוגמאות

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

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
מחרוזת	country_code	חובה. קוד מדינה בן 2 אותיות לפי ההגדרה בתקן ISO 3166-1.
בוליאני	is_negative	אופציונלי. אם הערך הוא true, הקריטריון הוא שלילי (קוד המדינה מוחרג).

דוגמאות

{
    "country_code": "US",
    "is_negative": "true"
}

PriceFeesAndTaxes

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
google.type.Money	per_ticket_fee	אופציונלי. עמלות הזמנה שכלולות במחיר הסופי של כרטיס בודד.
google.type.Money	per_ticket_tax	אופציונלי. מיסים ברמת המדינה שכלולים במחיר הסופי של כרטיס יחיד.

דוגמאות

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

מיקום

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
GeoLocation	location	אופציונלי, צריך לציין לפחות מיקום אחד או תיאור אחד. המיקום הגיאוגרפי.
LocalizedTextSet	תיאור	אופציונלי, אורך מומלץ: 1,000, אורך מקסימלי: 2,000, צריך לציין לפחות אחד מהערכים location או description. תיאור נוסף בצורה שנוחה לקריאה, כמו "בצד שמאל של המזרקה בכיכר הארמון".

דוגמאות

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

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

GeoLocation

מידע מפורט יותר על כל סוג של רמז זמין בהנחיות לשימוש.

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
מחרוזת	place_id	אופציונלי, צריך לציין בדיוק אחד מהערכים הבאים: place_id, address, place_info, business_profile_id או lat_lng. מזהה המקום כפי שמוגדר על ידי Places API. מזהה באופן ייחודי נקודת עניין ב-Google. כדי למצוא את המזהה הרלוונטי, נעזרים באפשרויות להזנת נקודות קצה ב-Places API, למשל "חיפוש מקומות" או "השלמה אוטומטית למקומות", או נכנסים למרכז "דברים שאפשר לעשות" ומשתמשים בכלי "חיפוש נתוני מיקומים" כדי להזין את המשתנה ידנית.
מחרוזת	כתובת	אופציונלי, צריך לציין בדיוק אחד מהערכים הבאים: place_id, address, place_info, business_profile_id או lat_lng. הוצא משימוש. כתובת מדור קודם בשורה אחת. אורך מקסימלי: 200. המרכיבים צריכים להיות מופרדים באמצעות פסיקים, והמרכיב הראשון צריך להיות שם המקום כפי שהוא מוצג ב-Google. כדי לשפר את דיוק ההתאמה, כדאי להשתמש בכתובת הרחוב שמופיעה ב-Google לגבי המקום.
PlaceInfo	place_info	אופציונלי, צריך לציין בדיוק אחד מהערכים הבאים: place_id, address, place_info, business_profile_id או lat_lng. פרטי המקום בפורמט המתאים.
uint64	business_profile_id	אופציונלי, צריך לציין בדיוק אחד מהערכים הבאים: place_id, address, place_info, business_profile_id או lat_lng. מזהה פרופיל העסק, כפי שמופיע בדף ההגדרות של פרופיל העסק ב-Google. משתמשים בשדה הזה כשמקור המיקומים הוא ישירות מבעל המקום, שיש לו גישה לפרופיל העסק ב-Google של המקום ויכול לספק את המזהה הזה.
google.type.LatLng	lat_lng	אופציונלי, צריך לציין בדיוק אחד מהערכים הבאים: place_id, address, place_info, business_profile_id או lat_lng. קואורדינטות גיאוגרפיות. אפשר להשתמש בשדה הזה רק כדי לקבוע עיר או אזור גיאוגרפי, כי הוא לא מספיק חד-משמעי כדי לזהות מקום ספציפי או עסקים. במקום זאת, אפשר להשתמש ב-place_info כדי להתאים למקום ספציפי לפי שם וקואורדינטות.

דוגמאות

"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

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
מחרוזת	שם	חובה. אורך מקסימלי: 300. שם המקום או העסק. כדי להשיג רמת דיוק גבוהה יותר בהתאמה, השם צריך להיות זהה לשם שמוצג ב-Google עבור המקום. במקומות שיש להם פרופיל עסק מאומת ב-Google, השם צריך להיות זהה לשם העסק שמוגדר בפרופיל העסק.
מחרוזת	phone_number	אופציונלי. אורך מקסימלי: 30. מספר טלפון, כולל הקידומת הבינלאומית. כדי לשפר את רמת הדיוק של ההתאמה, מספר הטלפון הזה צריך להיות זהה למספר הטלפון שמוצג ב-Google לגבי המקום. הוא יכול לכלול תווים נפוצים להפרדה. דוגמאות: "[phone]", "[phone]".
מחרוזת	website_url	אופציונלי. אורך מקסימלי: 1,000. כתובת האתר שמוצגת ב-Google עבור המקום, רצוי כתובת האתר שמקושרת מהדף העסקי במפות Google או בחיפוש Google עבור המקום.
google.type.LatLng	קואורדינטות	אופציונלי. הקואורדינטות הגיאוגרפיות של המקום. אם השדה יישאר ריק, Google תסיק את הקואורדינטות מהכתובת. אופציונלי, אבל צריך לציין את הערך coordinates או את הערכים structured_address ו-unstructured_address.
StructuredAddress	structured_address	אופציונלי, יכול להיות שיופיע בדיוק אחד מהערכים structured_address או unstructured_address, אבל אף פעם לא שניהם.
מחרוזת	unstructured_address	אופציונלי, יכול להיות שיופיע בדיוק אחד מהערכים structured_address או unstructured_address, אבל אף פעם לא שניהם.

דוגמאות

"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

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
מחרוזת	street_address	חובה. אורך מקסימלי: 200. כתובת, כולל מספר הבית וכל רכיב אחר שלא ניתן לספק באמצעות השדות הספציפיים יותר. הוא לא יכול לכלול את שם המקום או העסק, שאותם צריך לציין בנפרד בשדה name בקטע PlaceInfo. בנוסף, אסור לכלול בו מיקוד, יישוב או מדינה, כי צריך לספק את הפרטים האלה בשדות המתאימים.
מחרוזת	רשות מוניציפאלית	אופציונלי. אורך מקסימלי: 80. יישוב, בדרך כלל מתייחס לחלק של העיר או העיירה בכתובת. באזורים בעולם שבהם היישובים לא מוגדרים היטב או לא מתאימים למבנה הזה, צריך להשאיר את השדה ריק.
מחרוזת	administrative_area	אופציונלי. אורך מקסימלי: 80. החלוקה המנהלית הגבוהה ביותר שמשמשת לכתובות למשלוח דואר במדינה או באזור הספציפיים. הערך יכול להיות מדינה, אזור, מחוז, מחוז משנה או תחום שיפוט. אפשר להשתמש בקיצור או בשם מלא, בהתאם לאופן שבו האזור מיוצג בדרך כלל בכתובות למשלוח דואר במדינה הספציפית.
מחרוזת	postal_code	אופציונלי. אורך מקסימלי: 30. המיקוד. חובה אם המדינה תומכת במיקודים, אחרת צריך להשאיר את השדה ריק.
מחרוזת	country_code	אופציונלי. אורך מקסימלי: 2. קוד המדינה, כפי שמוגדר ב-Unicode ‏'CLDR'‏, שמבוסס בעצמו על תקן ISO 3166 alpha-2. אפשר לעיין בתיעוד בנושא Unicode.

דוגמאות

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

LocalizedTextSet

אב

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

הערות לגבי הטמעה

סוג	שדה	הערות
‫repeated google.type.LocalizedText	localized_texts	ערכי טקסט מקומיים לכל לוקאל. מספר הלוקאלים המקסימלי: 50.

דוגמאות

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

CancellationPolicy

אב

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

הערות לגבי הטמעה

הגדרה של תנאי החזר כספי יחיד. אפשר להשתמש בכמה תנאים להחזר כספי כדי לתאר 'שלבים להחזר כספי' כמשכי זמן שונים לפני שעת ההתחלה של השירות.

סוג	שדה	הערות
RefundCondition	refund_conditions	אופציונלי, מספר התנאים המקסימלי להחזר כספי: 10.

RefundCondition

סוג	שדה	הערות
uint32	min_duration_before_start_time_sec	אופציונלי. משך הזמן בשניות לפני שעת ההתחלה, עד המועד שבו הלקוח יכול לקבל החזר כספי על חלק מעלות השירות שצוינה ב-refund_percent. אם לא מגדירים את הערך או מגדירים אותו כ-0, אפשר לבטל את השירות בכל שלב.
uint32	refund_percent	אופציונלי. אחוז ההחזר הכספי שאפשר לקבל, בתנאי שהזמנת השירות בוטלה לפחות min_duration_before_start_time לפני שעת ההתחלה של השירות, בטווח [0, 100]. אם לא מגדירים את הערך או מגדירים אותו כ-0, לא ניתן לקבל החזר כספי על השירות. אם הערך מוגדר כ-100, השירות הזה ניתן להחזר מלא.
google.type.Money	refund_fee	אופציונלי. עמלה קבועה שמופחתת מההחזר הכספי. אפשר להשתמש בהן בנפרד או בשילוב עם refund_percent. במקרה השני, קודם יוחל אחוז ההחזר ואז תנוכה העמלה.

דוגמאות

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