خلاصة المنتج

خلاصة المنتجات هي الطريقة الأساسية لتزويد Google بقائمة من منتجات النشاطات المقترَحة التي سيتم عرضها على مساحات عرض مختلفة في Google.

يتكوّن عنصر ProductFeed من عنصر FeedMetadata واحد وعناصر Product بقيمة صفرية أو أكثر. وإذا لم يتم توفير Product في جميع الأجزاء، سيتم حذف جميع المنتجات.

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

ملاحظات التنفيذ

النوع الحقل Notes
FeedMetadata feed_metadata مطلوب.
البيانات الوصفية لهذه الخلاصة
متكرّر
المنتج
المنتجات اختياري.
عند إلغاء الضبط في جميع الأجزاء، يتم حذف جميع المنتجات. قد تحتاج إلى ضبط السمة 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

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

ملاحظات التنفيذ

النوع الحقل Notes
uint32 shard_id مطلوب عندما يكون total_shards_count > 1.
قاعدة صفرية. لا يلزم نقل الأجزاء بالترتيب. تبدأ المعالجة فقط بعد تحميل مجموعة كاملة من الأجزاء.
uint32 total_shards_count مطلوب، يجب أن يكون >= 1.
uint64 رقم خاص مطلوب عندما يكون total_shards_count > 1.
يجب أن يكون متطابقًا مع جميع الأجزاء ضمن عملية النقل.
تعداد processing_instruction مطلوب.
PROCESS_AS_SNAPSHOT هي القيمة الوحيدة المتوافقة.
مزدوج 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
}

المنتَج

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

ملاحظات التنفيذ

النوع الحقل Notes
سلسلة id مطلوب، الحد الأقصى للطول 255.
سلسلة فريدة تحدِّد المنتج الأحرف المسموح بها هي أحرف أبجدية رقمية و_ و-.
LocalizedTextSet العنوان مطلوب، والطول المقترح<= 50، الحد الأقصى للطول 150 حرفًا.
يمكنك الاطّلاع على إرشادات العنوان والوصف للحصول على مزيد من التفاصيل.
LocalizedTextSet الوصف يُوصى به، والطول الموصى به أقل من 10, 000 حرف، والطول الأقصى 16, 000 حرف.
يمكنك الاطّلاع على إرشادات العنوان والوصف للحصول على مزيد من التفاصيل.
ميزة
TextFeature المتكررة
product_features مقترَح، الحدّ الأقصى لعدد الميزات: 100.
التقييم تقييم موصى به.
ننصحك بشدة بتقديم تقييمات، لأنّ المنتجات التي تعرض تقييمات تؤدي إلى ارتفاع نسبة النقر إلى الظهور.

وسائط متكررة
related_media يُنصَح باستخدام حدّ أقصى لعدد الوسائط: 30
يُنصح بشدة بتوفير أكثر من صورة واحدة. يمكنك الاطّلاع على إرشادات الصور للحصول على دليل تفصيلي حول الصور.
boolean use_media_order اختياري
يُرجى إبلاغ Google بأنّه يجب مراعاة ترتيب إدراج الوسائط ذات الصلة في الخلاصة عند اختيار الصورة التي سيتم عرضها.
تكرار
خيار
الخيارات مطلوب، الحد الأقصى لعدد الخيارات: 20
يجب أن يحتوي كل منتج على خيار منتج واحد على الأقل.
عامل التشغيل معامل || عامل تشغيل اختياري.
تعداد متوقف نهائيًا
inventory_type
اختياري.
لا يمكن ضبط السمة INVENTORY_TYPE_OFFICIAL إلا في المنتجات التي تتضمّن روابط تؤدي إلى الموقع الإلكتروني الرسمي للتذاكر الخاصة بنقطة اهتمام. لا يمكن ضبط هذه القيمة إلا بعد إجراء مراجعة للتحقّق من الأهلية.
تم إيقاف هذا الحقل نهائيًا واستبداله بحقل "invent_types" (أنواع المستودع) الجديد الجديد.
متكرّر inventory_types اختياري.
قائمة متكرّرة بأنواع المستودعات الفريدة التي ينتمي إليها هذا المنتج
لا يمكن ضبط السمة INVENTORY_TYPE_OFFICIAL إلا في المنتجات التي تتضمّن روابط تؤدي إلى الموقع الإلكتروني الرسمي للتذاكر الخاصة بنقطة اهتمام. لا يمكن ضبط هذه القيمة إلا بعد إجراء مراجعة للتحقّق من الأهلية.
لا يمكن ضبط السمة INVENTORY_TYPE_OPERATOR_DIRECT إلا في المنتجات التي ترتبط بالموقع الإلكتروني لمنظِّم الجولات. لا يمكن ضبط هذه القيمة إلا بعد إجراء مراجعة للتحقّق من الأهلية.
تعداد confirmation_type اختياري.
FulfillmentType fulfillment_type موصى به. في حال ضبط السياسة، يجب أن يكون حقل واحد على الأقل في fulfillment_rype صحيحًا.
يتيح ضبط طرق للحصول على مستند لتأكيد الحجز. ويمكن إجراء المجموعات، على سبيل المثال، الهاتف الجوّال + الطباعة أو الطباعة في المنزل + الاستلام شخصيًا.
LocalizedTextSet brand_name الحد الأقصى للطول 100.
اسم العلامة التجارية الذي يجب أن يعرضه المنتج، وهذا يحل محل "عامل التشغيل/الاسم" المتوقّف نهائيًا. لا يمكن ضبط سوى قيمة واحدة من القيمتَين.

أمثلة

{
  "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?source={src}&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?source={src}&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;
}

ملاحظات التنفيذ

النوع الحقل Notes
سلسلة id مطلوب.
رقم تعريف الخيار. يجب أن يكون فريدًا داخل المنتج.
LocalizedTextSet العنوان مطلوب، والطول المقترح: 50، الحد الأقصى للطول: 150 حرفًا.
إذا توفر خيار واحد فقط، قد يكون عنوان الخيار مطابقًا لعنوان المنتج. في حال تقديم خيارات منتجات متعددة، يجب أن يكون العنوان فريدًا للخيار. يمكنك الاطّلاع على إرشادات العناوين والوصف للحصول على مزيد من التفاصيل.
LocalizedTextSet الوصف القيمة المقترَحة للطول: 10, 000، والطول الأقصى: 16, 000.
يمكنك الاطّلاع على إرشادات العنوان والوصف للحصول على مزيد من التفاصيل.
DeepLink landing_page مطلوب.
يجب أن يحتوي على زر أو رابط لحجز المنتج. يمكنك الاطّلاع على إرشادات الصفحة المقصودة للحصول على مزيد من التفاصيل.
DeepLink landing_page_list_view موصى به.
أدرِج رابطًا يؤدي إلى عرض على شكل قائمة على مستوى أعلى من التذاكر والجولات المتاحة، مع إظهار هذا الخيار بشكل بارز من بين خيارات أخرى. يمكنك الاطّلاع على إرشادات الصفحة المقصودة للحصول على مزيد من التفاصيل.
ميزة
TextFeature المتكررة
option_features اختياري، الحد الأقصى لعدد الميزات: 100.يجب ألا تكرّر السمة
التفاصيل على مستوى المنتج.
CancellationPolicy cancellation_policy موصى به.

الفئة المتكررة
option_categories اختياري، الحد الأقصى لعدد الفئات: 100.
الفئات ذات الصلة بهذا الخيار: على وجه الخصوص، يُرجى التأكد من ضبط self-guided لجميع الأنشطة غير المستندة إلى الجولات وضبط guided-tour للأنشطة المستندة إلى الجولة. يُرجى الرجوع إلى مستندات فئة المنتج للاطّلاع على القيم الإضافية المقترَحة.
حقل متكرّر
RelatedLocation
related_location مقترح، الحد الأقصى لعدد المواقع: 100.
إنّ تقديم قائمة دقيقة بالمواقع الجغرافية ذات الصلة من المهم جدًا لكي يظهر المنتج في المواضع الأكثر صلة، إلّا أنّ المبالغة في وضع العلامات أو تقديم بيانات دقيقة تؤدي إلى إزالة المنتج. راجع دليل الموقع الجغرافي ونقاط الاهتمام لمزيد من التفاصيل.
bool base_ticket اختياري.
تُستخدَم هذه السمة للإشارة إلى ما إذا كان خيار المنتج هو تذكرة الدخول الأساسية.
متكرّرة
PriceOption
price_options مطلوب، 1 على الأقل.
كل الأسعار الممكنة لهذا الخيار. ملاحظة: يمكن استخدام سعر البالغين فقط. في حال توفير خيارات أسعار متعددة، سيتم استخدام السعر الأول الذي يجتاز عمليات التحقّق من القيود الجغرافية. بالنسبة إلى التذاكر الجماعية، يجب استخدام السعر الكامل للمجموعة بأكملها بدلاً من ذلك.
uint32 duration_sec اختياري.
مدة الخيار بالثواني، حيثما ينطبق ذلك، مثل الجولات الإرشادية أو رحلات القوارب وما إلى ذلك. ويجب أن تعكس هذه المدة مدة التجربة (وليس مدة الصلاحية).
اللغة
المتكرّرة
اللغات مستحسن، الحد الأقصى لعدد اللغات: 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?source={src}&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;
}

ملاحظات التنفيذ

النوع الحقل Notes
تعداد feature_type مطلوب.
نوع الميزة، القيم المحتمَلة:
  • TEXT_FEATURE_INCLUSION: الميزة هي عملية تضمين.
  • TEXT_FEATURE_EXCLUSION: الميزة استثناء.
  • TEXT_FEATURE_HIGHLIGHT: يتم إبراز الميزة.
  • TEXT_FEATURE_MUST_KNOW: الميزة "يجب معرفتها".
  • TEXT_FEATURE_SAFETY_INFORMATION: تمثل الميزة معلومات عن تدابير السلامة.
  • LocalizedTextSet القيمة مطلوب، والطول المقترح <= 1000 حرف، الحد الأقصى للطول: 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>"
                }
            ]
        }
    }
    

    Rating

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    مزدوج 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
    }
    

    الوسائط

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    سلسلة url مطلوب، الحد الأقصى للطول: 2000.
    عنوان URL لمصدر الوسائط هذا. سيزحف محرّك بحث Google إلى الوسائط المستضافة على عنوان URL هذا.
    تعداد كتابة مطلوب.
    نوع مصدر الوسائط هذا. القيم المتاحة:
  • MEDIA_TYPE_PHOTO: يشير إلى أن الوسائط التي يوفّرها عنوان URL هي عبارة عن صورة.
  • LocalizedTextSet attribution اختياري، الطول المقترَح: 1, 000، والحدّ الأقصى للطول: 2, 000.
    معلومات تحديد المصدر عن مصدر الوسائط يُرجى العلم أنّه إذا كان من المطلوب عرض الإسناد مع وسائل الإعلام لمنح ذِكر المصوّر أو الوكالة، يجب ضبط هذا الحقل.

    أمثلة

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

    تعريف الفئة

    Proto

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    سلسلة label مطلوب. يُرجى الرجوع إلى مستندات فئة المنتج للاطّلاع على قائمة القيم الصالحة.

    أمثلة

    {
        "label": "sports"
    }
    

    RelatedLocation

    Proto

    // Defines relation between an option and a location.
    message RelatedLocation {
      // Location related to an option. Can be a POI (e.g. Eiffel tower),
      // neighbourhood (e.g. Old Town) or an address / arbitrary map point.
      // Required.
      Location location = 1;
    
      enum RelationType {
        // Location is related but relation does not allow admission or admission is
        // irrelevant, e.g. location is a square highlighted in a city tour.
        RELATION_TYPE_RELATED_NO_ADMISSION = 0;
        // Relation grants admission to this related location.
        RELATION_TYPE_ADMISSION_TICKET = 1;
        // Relation declares an additional service which doesn't get the user into
        // the related location, e.g. a parking ticket, a temporary exhibition, etc.
        RELATION_TYPE_SUPPLEMENTARY_ADDON = 2;
      }
      // Relation type of an option for the given location.
      // Required.
      RelationType relation_type = 2;
    }
    

    ملاحظات التنفيذ

    تحدد العلاقة بين الخيار والموقع.

    النوع الحقل Notes
    الموقع الجغرافي موقع جغرافي مطلوب.
    الموقع الجغرافي المرتبط بخيار معيّن. يمكن أن تكون إحدى نقاط الاهتمام (مثل برج إيفل) أو الحي (مثل البلدة القديمة) أو عنوانًا / نقطة عشوائية على الخريطة.
    تعداد relation_type مطلوب.
    نوع علاقة الخيار للموقع الجغرافي المحدّد. القيم المتاحة:
  • RELATION_TYPE_RELATED_NO_ADMISSION: الموقع الجغرافي مرتبط ولكن العلاقة لا تتيح
  • RELATION_TYPE_ADMISSION_TICKET: علاقة تمنح إذن الدخول إلى هذا الموقع الجغرافي ذي الصلة.
  • RELATION_TYPE_SUPPLEMENTARY_ADDON: تشير العلاقة إلى خدمة إضافية لا تتيح للمستخدم الوصول إلى الموقع ذي الصلة، مثل تذكرة لركن السيارات أو معرض مؤقت أو غير ذلك.
  • أمثلة

    // Example of place id POI with no admissions
    {
        "location": {
            "location": {
                "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
            }
        },
        "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
    }
    
    // Example of Address POI with admissions
    {
        "location": {
            "location": {
                "address": "Madame Tussauds Berlin, Unter den Linden 74, 10117 Berlin, Germany"
            }
        },
        "relation_type": "RELATION_TYPE_ADMISSION_TICKET"
    }
    
    

    Proto

    // Deep link definition. Can include value parameters that will be expanded on
    // serve time.
    message DeepLink {
      // Landing page URL template for desktop. If both `url` and `localized_url`
      // are provided, the former is used as a fallback in case
      // no URL matches the user’s locale.
      // Max length: 2000.
      // Either `url` or `localized_url` is required.
      string url = 1;
    
      // Landing page URL template for mobile. If omitted, it defaults to the `url`
      // value.
      // Max length: 2000.
      // Optional.
      string mobile_url = 2;
    
      // Localized landing page URL template for desktop. If both `url` and
      // `localized_url` are provided, the former is used as a fallback in case
      // no URL matches the user’s locale.
      // Max length: 2000.
      // Max number of locales: 50.
      // Either `url` or `localized_url` is required.
      LocalizedTextSet localized_url = 3;
    
      // Localized landing page URL template for mobile.
      // Max length: 2000.
      // Max number of locales: 50.
      // Optional.
      LocalizedTextSet localized_mobile_url = 4;
    }
    

    ملاحظات التنفيذ

    تعريف الروابط المؤدية إلى صفحات في التطبيق: يمكن أن يتضمّن مَعلمات قيم سيتم توسيعها في وقت العرض.

    النوع الحقل Notes
    سلسلة url اختياري، الحد الأقصى للطول: 2000.
    نموذج عنوان URL للصفحة المقصودة لأجهزة الكمبيوتر المكتبي. يجب إدخال إما `url` أو `localized_url`.
    سلسلة mobile_url اختياري، الحد الأقصى للطول: 2000.
    نموذج عنوان URL للصفحة المقصودة للأجهزة الجوّالة.
    LocalizedTextSet localized_url اختياري، الحدّ الأقصى للطول: 2,000، والحدّ الأقصى لعدد السكان المحليين 50.
    نموذج عنوان URL للصفحة المقصودة المترجَمة لأجهزة الكمبيوتر المكتبي في حال توفير كل من url وlocalized_url، يتم استخدام العنوان الأول كعنصر احتياطي في حال عدم تطابق أي عنوان URL مع لغة المستخدم. إذا لم تكن السمة url متاحة ولم يتم توفير لغة، سيتم استخدام عنوان URL باللغة الإنجليزية.
    LocalizedTextSet localized_mobile_url اختياري، الحد الأقصى للطول: 2000، الحد الأقصى لعدد المواقع المحلية: 50.
    نموذج عنوان URL لصفحة الجوّال_المحللة للجوّال.

    أمثلة

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

    المؤثِّر

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    LocalizedTextSet الاسم [deprecated] اختياري، الطول المقترَح: 50، الحدّ الأقصى للطول: 100.
    اسم العلامة التجارية لبائع هذا المنتج. يجب أن تعيّن OTA هذه على أنها العلامة التجارية عبر الهواء. تم إيقاف هذا الحقل نهائيًا واستبداله بـ Brand_name ضمن المنتجات.
    LocalizedTextSet google_business_profile_name مطلوب، الحد الأقصى للطول: 100.
    اسم النشاط التجاري لمشغِّل شبكة الجوّال، كما هو مسجَّل في "الملف التجاري على Google" ويظهر على "خرائط Google". يجب ملء هذا الحقل للمشاركة في وحدة حجز مشغّل شبكة الجوّال.
    سلسلة phone_number اختياري، الحدّ الأقصى للطول: 64.
    رقم هاتف المشغّل. أفضّل تنسيق رقم الهاتف الدولي الكامل.

    الموقع الجغرافي مكرّر
    المواقع الجغرافية اختياري، الحد الأقصى للعدد: 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
         "address": "Dans Bikes, 123 NYC st…"
      }}]
    }
    

    تعريف اللغة

    Proto

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    سلسلة رمز رمز لغة متوافق مع BCP-47، مثل en أو de-CH

    أمثلة

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    سلسلة id مطلوب، الحد الأقصى للطول: 255.
    معرّف فريد ضمن السعر المحدّد
    سلسلة العنوان مطلوب، الحد الأقصى للطول: 150.
    وصف قصير لخيار السعر، مثل "أيام الأسبوع للبالغين".
    google.type.Money السعر مطلوبة عندما تكون السمة is_free غير صحيحة.
    يجب أن تتطابق قيمة السعر مع السعر النهائي الوارد على صفحة الدفع، بما في ذلك جميع الضرائب والرسوم، راجِع سياسة السعر. سيتم تحويل العملة إلى عملة المستخدم عند العرض.
    bool is_free (اختياري) تكون القيمة التلقائية "خطأ".
    يمكن الدخول أو التذكرة مجانًا. يجب ضبط القيمة على "صحيح" في خيارات السعر بدون تكلفة.

    GeoCriterion متكرّر
    geo_criteria اختياري.
    قائمة بالمناطق الجغرافية التي ينطبق عليها هذا السعر إذا كان الحقل فارغًا، يسري العرض على جميع المواقع الجغرافية.
    محتوى متكرّر
    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

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    سلسلة country_code مطلوب.
    رمز البلد المكوّن من حرفَين كما هو محدّد في ISO 3166-1.
    bool is_negative اختياري.
    إذا كانت الإجابة "صحيح"، يكون المعيار سالبًا (يتم استبعاد رمز البلد).

    أمثلة

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    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
        }
    }
    

    الموقع الجغرافي

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    GeoLocation موقع جغرافي اختياري، يجب أن يتوفّر موقع جغرافي أو وصف واحد على الأقل.
    الموقع الجغرافي.
    LocalizedTextSet الوصف اختياري، والطول المقترَح: 1,000، والحدّ الأقصى للطول: 2000، ويجب تقديم وصف واحد على الأقل للموقع الجغرافي أو وصفه.
    وصف إضافي بصيغة يمكن للإنسان فهمها، على سبيل المثال "على الجانب الأيسر من النافورة في ساحة القصر".

    أمثلة

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

    GeoLocation

    يمكنك الاطّلاع على إرشادات الاستخدام للحصول على معلومات أكثر تفصيلاً حول كل نوع من التلميحات.

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    سلسلة place_id اختياري، يجب أن تتوفر خاصية place_id أو address أو place_info أو business_profile_id أو lat_lng.
    رقم تعريف المكان على النحو المحدّد في Places API. يحدِّد نقطة اهتمام على Google بشكل فريد. ويمكن الحصول عليها من خلال نقاط نهاية واجهة برمجة تطبيقات الأماكن، مثل ميزة "البحث عن الأماكن" أو ميزة "الإكمال التلقائي" عن الأماكن، أو يدويًا باستخدام أداة "العثور على الموقع الجغرافي" في Things to Do Center.
    سلسلة معالجة اختياري، يجب أن تتوفر خاصية 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"
    
    "address": "Eiffel Tower, 5 Av. Anatole France, 75007 Paris, France"
    
    "place_info": {
      "name": "Eiffel Tower",
      "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
    }
    
    "business_profile_id": 11458995034835395294
    
    "lat_lng": {
      "latitude": -25.3511774,
      "longitude": 131.0326859
    }
    

    PlaceInfo

    Proto

    message PlaceInfo {
      // Place or business name.
      // For higher matching accuracy, this should be the same as the name shown on
      // Google for the place. For places with a claimed Google Business Profile,
      // this should be the same as the business name configured in the business
      // profile.
      // Max length: 300.
      // Required.
      string name = 1;
    
      // Phone number, including the international prefix.
      // For higher matching accuracy, this should be the same as the phone number
      // shown on Google for the place.
      // It can include commonly used separator characters.
      // Examples: "+1 212-363-3200", "+91 562 222 7261".
      // Max length: 30.
      // Optional.
      string phone_number = 2;
    
      // Website URL shown on Google for the place, preferably the URL linked from
      // the business listing in Google Maps or Search for the place.
      // Max length: 1000.
      // Optional.
      string website_url = 3;
    
      // Geographic coordinates of the place.
      // If left empty, Google will infer the coordinates from the address.
      // Optional, but either `coordinates` or one of `address_type` must be
      // provided.
      google.type.LatLng coordinates = 4;
    
      // Optional, but either `coordinates` or one of `address_type` must be
      // provided.
      oneof address_type {
        // Structured address.
        // Prefer this format whenever possible for higher matching accuracy.
        StructuredAddress structured_address = 5;
    
        // Unstructured address.
        // It should not include the place or business name, which must instead be
        // provided separately using the `name` field.
        //
        // Examples:
        // - `name`: "Colosseum", `unstructured_address`: "Piazza del Colosseo, 1,
        // 00184 Roma RM, Italy".
        // - `name`: "The British Museum", `unstructured_address`: "Great Russell
        // St, London WC1B 3DG, United Kingdom".
        //
        // Max length: 400.
        string unstructured_address = 6;
      }
    }
    

    ملاحظات التنفيذ

    النوع الحقل Notes
    سلسلة اسم مطلوب. الحدّ الأقصى للطول: 300. اسم المكان أو النشاط التجاري للحصول على دقة أعلى في المطابقة، يجب أن يكون هذا الاسم مطابقًا للاسم المعروض على Google للمكان. بالنسبة إلى الأماكن التي يتوفّر فيها ملف تجاري على Google تمّت المطالبة به، يجب أن يكون هذا الاسم مطابقًا لاسم النشاط التجاري الذي تم إعداده في الملف التجاري.
    سلسلة phone_number اختياري. الحدّ الأقصى للطول: 30. رقم الهاتف، بما في ذلك البادئة الدولية. للحصول على دقة أعلى في المطابقة، يجب أن يكون هذا الرقم مطابقًا لرقم الهاتف المعروض على Google للمكان. ويمكن أن يتضمّن أحرفًا فاصلة شائعة الاستخدام. أمثلة: "3200-363-212-1+"، " +91 562 222 7261".
    سلسلة website_url اختياري. الحدّ الأقصى للطول: 1,000. عنوان URL للموقع الإلكتروني المعروض على Google المتعلّق بالمكان، ويُفضَّل أن يكون عنوان URL المرتبط ببيانات النشاط التجاري في "خرائط 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": "+39 063 99 67 700",
      "website_url": "https://colosseo.it/",
      "coordinates": {
        "latitude": 41.8902102,
        "longitude": 12.4922309
      },
      "structured_address" {
        "street_address": "Piazza del Colosseo, 1",
        "locality": "Roma",
        "administrative_area": "RM",
        "postal_code": "00184",
        "country_code": "IT"
      }
    }
    
    "place_info": {
      "name": "Eiffel Tower",
      "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
    }
    
    "place_info": {
      "name": "Mutitjulu Waterhole",
      "coordinates": {
        "latitude": -25.3511774,
        "longitude": 131.0326859
      }
    }
    

    StructuredAddress

    Proto

    message StructuredAddress {
      // Street address, including house number and any other component that cannot
      // be provided using the more specific fields defined below. It should not
      // include the place or business name, which must instead be provided
      // separately using the `name` field under `PlaceInfo`. It should also not
      // include postal code, locality or country as those should be provided using
      // the corresponding fields below.
      //
      // Examples:
      // - "Piazza del Colosseo, 1" for the Colosseum.
      // - "Great Russell St" for The British Museum.
      // - "Champ de Mars, 5 Av. Anatole France" for the Eiffel Tower.
      //
      // Max length: 200.
      // Required.
      string street_address = 1;
    
      // Locality, generally referring to the city/town portion of an address.
      // Examples: "New York", "Rome", "London", "Tokyo".
      // In regions of the world where localities are not well defined or do not fit
      // into this structure well, leave empty.
      // Max length: 80.
      // Optional.
      string locality = 2;
    
      // Highest administrative subdivision used for postal addresses of the
      // specific country or region. This can be a state, a region, a province, an
      // oblast, a prefecture, etc.
      // It can be an abbreviation or a full name, depending on how the region is
      // usually represented in the postal addresses of the specific country. For
      // example, "CA" or "California" for US addresses, "RM" for Rome province in
      // Italy.
      // Many countries don't use an administrative area in postal addresses. For
      // instance, this field should not be used for addresses in Switzerland.
      // Max length: 80.
      // Optional.
      string administrative_area = 3;
    
      // The postal code or zip code.
      // Examples: "75007", "WC1B 3DG", etc.
      // Required if the country supports postal codes, otherwise it should be left
      // empty.
      // Max length: 30.
      // Optional.
      string postal_code = 4;
    
      // Country code, as defined by Unicode's "CLDR", itself based on the ISO 3166
      // alpha-2 standard. See
      // https://unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html.
      //
      // Examples: "US" for the United States, "FR" for France, "GB" for the United
      // Kingdom, etc.
      // Max length: 2.
      // Required.
      string country_code = 5;
    }
    

    ملاحظات التنفيذ

    النوع الحقل Notes
    سلسلة street_address مطلوب. الحدّ الأقصى للطول: 200. عنوان الشارع، بما في ذلك رقم المنزل وأي عنصر آخر لا يمكن تقديمه باستخدام الحقول الأكثر تحديدًا المحددة أدناه. ويجب ألا يتضمّن اسم المكان أو النشاط التجاري، ويجب تقديم هذا الاسم بشكل منفصل باستخدام الحقل name ضمن PlaceInfo. ويجب أيضًا ألا يتضمّن الرمز البريدي أو المنطقة المحلية أو البلد حيث يجب تقديمها باستخدام الحقول المقابلة أدناه.
    سلسلة منطقة محلية اختياري. الحدّ الأقصى للطول: 80. المنطقة المحلية، والتي تشير بشكل عام إلى المدينة أو جزء البلدة من العنوان. أمّا في المناطق من العالم التي لم يتم تعريفها بشكل جيد أو لا تتناسب مع هذه البنية، فيجب تركها فارغة.
    سلسلة administrative_area اختياري. الحدّ الأقصى للطول: 80. أعلى قسم فرعي إداري يُستخدم للعناوين البريدية في البلد أو المنطقة المحدّدة. يمكن أن يكون هذا النوع ولاية أو منطقة أو مقاطعة أو مقاطعة أو محافظة وما إلى ذلك، ويمكن أن يكون اختصارًا أو اسمًا كاملاً، حسب الطريقة التي يتم بها تمثيل المنطقة عادةً في العناوين البريدية للبلد المحدّد.
    سلسلة postal_code اختياري. الحدّ الأقصى للطول: 30. تمثّل هذه السمة الرمز البريدي. مطلوبة إذا كانت البلد تتيح الرموز البريدية، وإلا يجب تركها فارغة.
    سلسلة country_code اختياري. الحدّ الأقصى للطول: 2. رمز البلد، كما هو محدّد في يونيكود "CLDR"، نفسه استنادًا إلى معيار ISO 3166 alpha-2. راجِع مستندات يونيكود.

    أمثلة

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

    ملاحظات التنفيذ

    النوع الحقل Notes
    تكرار
    google.type.LocalizedText
    localized_texts قيم النص المترجَم لكل لغة

    أمثلة

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

    ملاحظات التنفيذ

    تحدد شرطًا واحدًا لردّ الأموال. يمكن استخدام شروط متعددة لرد الأموال معًا لوصف "خطوات رد الأموال" كمدد مختلفة قبل وقت بدء الخدمة.

    النوع الحقل Notes
    RefundCondition refund_conditions اختياري، الحد الأقصى لعدد شروط ردّ الأموال: 10.

    RefundCondition

    النوع الحقل Notes
    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
      }]