Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

خلاصة المنتجات

تشكّل خلاصة المنتجات الطريقة الأساسية لتزويد 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;
}

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

النوع	الحقل	ملاحظات
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

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

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

النوع	الحقل	ملاحظات
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 [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 حرفًا. يمكنك الاطّلاع على إرشادات العناوين والأوصاف لمزيد من التفاصيل.
LocalizedTextSet	الوصف	مُوصى به، الطول المقترَح <= 10000، الحد الأقصى للطول 16000 حرف يمكنك الاطّلاع على إرشادات العناوين والأوصاف لمزيد من التفاصيل.
repeated TextFeature	product_features	يُنصح باستخدامها، والحد الأقصى لعدد الميزات هو 100.
التقييم	rating	ننصح بها. ننصح بشدة بتقديم تقييمات لأنّ المنتجات التي تعرض تقييمات تؤدي إلى زيادة نسبة النقر إلى الظهور.
‫repeated Media	related_media	يُنصح باستخدام 30 وسيطًا كحدّ أقصى ننصح بشدة بتوفير أكثر من صورة واحدة. راجِع إرشادات الصور للحصول على دليل مفصّل حول الصور.
قيمة منطقية	use_media_order	اختياري إشارة إلى Google بأنّه يجب أخذ ترتيب الوسائط ذات الصلة في الخلاصة في الاعتبار عند اختيار الصورة التي سيتم عرضها.
repeated Option	الخيارات	مطلوب، الحدّ الأقصى لعدد الخيارات: 20 يجب أن يتضمّن كل منتج خيارًا واحدًا على الأقل.
عامل التشغيل	معامل \|\| عامل تشغيل	اختياري.
تعداد	deprecated inventory_type	اختياري.لا يمكن ضبط السمة `INVENTORY_TYPE_OFFICIAL` إلا في المنتجات التي تتضمّن روابط تؤدي إلى الموقع الإلكتروني الرسمي الخاص بالتذاكر الخاصة بنقطة الاهتمام. لا يمكن ضبط هذه القيمة إلا بعد مراجعة الأهلية. تم إيقاف العمل بهذا الحقل واستبداله بالحقل المتكرّر الجديد inventory_types.
متكرّرة	inventory_types	اختياري. قائمة متكرّرة بأنواع المستودع الفريدة التي ينتمي إليها هذا المنتج.لا يمكن ضبط السمة `INVENTORY_TYPE_OFFICIAL` إلا في المنتجات التي تتضمّن روابط تؤدي إلى الموقع الإلكتروني الرسمي الخاص بالتذاكر الخاصة بنقطة الاهتمام. لا يمكن ضبط هذه القيمة إلا بعد مراجعة الأهلية. لا يمكن ضبط قيمة `INVENTORY_TYPE_OPERATOR_DIRECT` إلا في المنتجات التي تتضمّن روابط تؤدي إلى الموقع الإلكتروني لمنظّم الجولات السياحية. لا يمكن ضبط هذه القيمة إلا بعد مراجعة الأهلية.
تعداد	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"]
}

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

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

النوع	الحقل	ملاحظات
سلسلة	id	مطلوب. معرّف الخيار يجب أن يكون المعرّف فريدًا ضمن المنتج.
LocalizedTextSet	title	مطلوبة، الطول المقترَح: 50 حرفًا، الحد الأقصى للطول: 150 حرفًا. إذا كان هناك خيار واحد فقط، قد يكون عنوان الخيار هو نفسه عنوان المنتج. إذا تم عرض خيارات متعدّدة للمنتج، يجب أن يكون العنوان فريدًا لكل خيار. اطّلِع على إرشادات العناوين والأوصاف لمزيد من التفاصيل.
LocalizedTextSet	الوصف	RECOMMENDED، الطول المقترَح: 10000، الطول الأقصى: 16000. يمكنك الاطّلاع على إرشادات العناوين والأوصاف لمزيد من التفاصيل.
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

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

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

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

التقييم

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

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

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

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

النوع	الحقل	ملاحظات
سلسلة	url	مطلوب، الحد الأقصى للطول: 2000 حرف عنوان URL لمصدر الوسائط هذا: سيزحف محرك بحث Google إلى الوسائط المستضافة على عنوان URL هذا.
تعداد	النوع	مطلوبة. تحدّد هذه السمة نوع مصدر الوسائط. القيم المحتمَلة: `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"
            }
        ]
    }
}

الفئة

Proto

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

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

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

أمثلة

{
    "label": "sports"
}

RelatedLocation

Proto

// Defines relation between an option and a location.
message RelatedLocation {
  // Location related to an option. Can be a POI (e.g. Eiffel tower),
  // neighbourhood (e.g. Old Town) or an address / arbitrary map point.
  // Required.
  Location location = 1;

  enum RelationType {
    RELATION_TYPE_UNSPECIFIED = 0;

    // Relation grants admission to this related location.
    RELATION_TYPE_ADMISSION_TICKET = 1;

    // Relation declares an additional service which doesn't get the user into
    // the related location, e.g. a parking ticket, a temporary exhibition, etc.
    RELATION_TYPE_SUPPLEMENTARY_ADDON = 2;

    // Location is related but relation does not allow admission or admission is
    // irrelevant, e.g. location is a square highlighted in a city tour.
    RELATION_TYPE_RELATED_NO_ADMISSION = 3;
  }

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

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

تحدّد هذه السمة العلاقة بين خيار وموقع جغرافي.

النوع	الحقل	ملاحظات
الموقع الجغرافي	الموقع	مطلوبة. الموقع الجغرافي المرتبط بخيار. يمكن أن يكون نقطة اهتمام (مثل برج إيفل) أو حيًا (مثل المدينة القديمة) أو عنوانًا أو موقعًا عشوائيًا على الخريطة.
تعداد	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": {
          "place_info": {
              "name": "Eiffel Tower",
              "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
          }
        }
    },
    "relation_type": "RELATION_TYPE_ADMISSION_TICKET"
}

DeepLink

Proto

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

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

  reserved 2, 4;
}

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

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

النوع	الحقل	ملاحظات
سلسلة	url	اختياري، الحدّ الأقصى للطول: 2, 000 حرف. نموذج عنوان URL للصفحة المقصودة على الكمبيوتر المكتبي. يجب توفير إما `url` أو `localized_url`.
LocalizedTextSet	localized_url	اختياري، الحد الأقصى للطول: 2000، الحد الأقصى لعدد المواقع الجغرافية 50 نموذج عنوان URL للصفحة المقصودة المتوافق مع اللغة المحلية لأجهزة الكمبيوتر المكتبي في حال توفير كل من `url` و`localized_url`، يتم استخدام `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}"
    }]
  }
}

عامل التشغيل

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

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

النوع	الحقل	ملاحظات
LocalizedTextSet	name [deprecated]	اختيارية، الطول المقترَح: 50، الطول الأقصى: 100. تمثّل اسم العلامة التجارية لبائع هذا المنتج. على وكالات السفر على الإنترنت ضبط هذا الخيار على علامة وكالة السفر على الإنترنت. تم إيقاف هذا الحقل نهائيًا واستبداله بالحقل brand_name ضمن المنتجات
LocalizedTextSet	google_business_profile_name	مطلوب، الحد الأقصى للطول: 100 حرف تمثّل هذه السمة اسم المؤسسة المشغّلة كما هو مسجّل في "الملف التجاري على Google" ويظهر على "خرائط Google". هذا الحقل مطلوب للمشاركة في وحدة حجز المشغّل.
سلسلة	phone_number	اختياري، الحد الأقصى للطول: 64 حرفًا. رقم هاتف المشغّل. يُفضّل استخدام تنسيق رقم الهاتف الدولي الكامل.
repeated Location	مواقع جغرافية	اختيارية، الحد الأقصى للعدد: 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..."
    }
  }}]
}

اللغة

Proto

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

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

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

النوع	الحقل	ملاحظات
سلسلة	id	مطلوب، الحد الأقصى للطول: 255 حرفًا معرّف فريد ضمن مجموعة الأسعار.
سلسلة	title	مطلوبة، الحد الأقصى للطول: 150 حرفًا. وصف مختصر لخيار السعر، مثل "سعر البالغين في أيام الأسبوع".
google.type.Money	price	هذه السمة مطلوبة عندما تكون قيمة `is_free` هي false. قيمة السعر، ويجب أن تتطابق مع السعر النهائي في صفحة الدفع، بما في ذلك جميع الضرائب والرسوم. يُرجى الاطّلاع على سياسة الأسعار. سيتم تحويل العملة إلى عملة المستخدم عند العرض.
قيمة منطقية	is_free	اختياري، القيمة التلقائية هي false. يشير إلى أنّ الدخول أو التذكرة مجانيان. يجب ضبطها على "صحيح" للخيارات التي لا تتضمّن سعرًا.
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

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

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

النوع	الحقل	ملاحظات
سلسلة	country_code	مطلوبة. تمثّل هذه السمة رمز البلد المكوّن من حرفَين وفقًا للمعيار ISO 3166-1.
قيمة منطقية	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;
}

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

النوع	الحقل	ملاحظات
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;
}

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

النوع	الحقل	ملاحظات
GeoLocation	الموقع	اختياري، يجب توفير موقع جغرافي أو وصف واحد على الأقل. الموقع الجغرافي
LocalizedTextSet	الوصف	اختيارية، الطول المقترَح: 1000، الطول الأقصى: 2000، يجب توفير وصف أو موقع جغرافي واحد على الأقل. وصف إضافي بصيغة قابلة للقراءة، مثل "على الجانب الأيسر من النافورة في ساحة القصر".

أمثلة

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

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

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

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

النوع	الحقل	ملاحظات
سلسلة	place_id	اختياري، يجب توفير قيمة واحدة فقط من القيم `place_id` أو `address` أو `place_info` أو `business_profile_id` أو `lat_lng`. PlaceId كما هو محدّد في 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

Proto

message PlaceInfo {
  // Place or business name.
  // For higher matching accuracy, this should be the same as the name shown on
  // Google for the place. For places with a claimed Google Business Profile,
  // this should be the same as the business name configured in the business
  // profile.
  // Max length: 100.
  // Required.
  string name = 1;

  // Phone number, including the international prefix.
  // For higher matching accuracy, this should be the same as the phone number
  // shown on Google for the place.
  // It can include commonly used separator characters.
  // Examples: "+1 212-363-3200", "+91 562 222 7261".
  // Max length: 30.
  // Optional.
  string phone_number = 2;

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

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

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

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

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

النوع	الحقل	ملاحظات
سلسلة	الاسم	مطلوب. الحدّ الأقصى للطول: 300 حرف اسم المكان أو النشاط التجاري للحصول على دقة مطابقة أعلى، يجب أن يكون هذا الاسم مطابقًا للاسم الظاهر على Google للمكان. بالنسبة إلى الأماكن التي تم تأكيد ملكية ملفها التجاري على Google، يجب أن يكون هذا الاسم هو نفسه اسم المؤسسة الذي تم ضبطه في الملف التجاري.
سلسلة	phone_number	اختياري. الحدّ الأقصى للطول: 30 حرفًا رقم الهاتف، بما في ذلك البادئة الدولية للحصول على دقة مطابقة أعلى، يجب أن يكون هذا الرقم هو نفسه رقم الهاتف المعروض على Google للمكان. يمكن أن يتضمّن أحرف فاصلة شائعة الاستخدام. أمثلة: "+1 212-363-3200"، "+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;
}

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

النوع	الحقل	ملاحظات
سلسلة	street_address	مطلوب. الحد الأقصى للطول: 200 حرف عنوان الشارع، بما في ذلك رقم المنزل وأي مكون آخر لا يمكن تقديمه باستخدام الحقول الأكثر تحديدًا يجب ألا يتضمّن اسم المكان أو المؤسسة، بل يجب تقديمه بشكل منفصل باستخدام الحقل `name` ضمن `PlaceInfo`. يجب ألا يتضمّن أيضًا الرمز البريدي أو الموقع الجغرافي أو البلد، لأنّه يجب تقديم هذه المعلومات باستخدام الحقول المناسبة.
سلسلة	المنطقة المحلية	اختياري. الحدّ الأقصى للطول: 80 حرفًا المنطقة المحلية، وتشير عادةً إلى جزء المدينة أو البلدة من العنوان في مناطق العالم التي لا تكون فيها الأماكن المحددة معرَّفة جيدًا أو لا تتناسب مع هذا التصميم، اترك الحقل فارغًا.
سلسلة	administrative_area	اختياري. الحدّ الأقصى للطول: 80 حرفًا أعلى تقسيم فرعي إداري مستخدَم للعناوين البريدية في البلد أو المنطقة المحدّدين يمكن أن يكون ذلك ولاية أو منطقة أو مقاطعة أو أوبلاست أو محافظة. يمكن أن يكون اختصارًا أو اسمًا كاملاً، وذلك حسب الطريقة التي يتم بها عادةً تمثيل المنطقة في العناوين البريدية الخاصة بالبلد المعنيّ.
سلسلة	postal_code	اختياري. الحدّ الأقصى للطول: 30 حرفًا تمثّل هذه السمة الرمز البريدي. هذا الحقل مطلوب إذا كان البلد يتيح استخدام الرموز البريدية، وإلا يجب تركه فارغًا.
سلسلة	country_code	اختياري. الحدّ الأقصى للطول: 2. تمثّل هذه السمة رمز البلد، كما هو محدّد في "بيانات الموقع الجغرافي الشائعة" (CLDR) من Unicode، وهي تستند إلى معيار 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

Proto

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

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

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

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

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

خلاصة المنتجات تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

ProductFeed

Proto

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

أمثلة

FeedMetadata

Proto

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

أمثلة

المنتج

Proto

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

أمثلة

Option

Proto

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

أمثلة

TextFeature

Proto

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

أمثلة

التقييم

Proto

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

أمثلة

الوسائط

Proto

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

أمثلة

الفئة

Proto

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

أمثلة

RelatedLocation

Proto

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

أمثلة

DeepLink

Proto

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

أمثلة

عامل التشغيل

Proto

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

أمثلة

اللغة

Proto

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

أمثلة

PriceOption

Proto

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

أمثلة

GeoCriterion

Proto

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

أمثلة

PriceFeesAndTaxes

Proto

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

أمثلة

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

Proto

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

أمثلة

GeoLocation

Proto

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

أمثلة

PlaceInfo

Proto

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

أمثلة

StructuredAddress

Proto

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

أمثلة

LocalizedTextSet

Proto

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

خلاصة المنتجات