این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

خوراک محصول

فید محصول، روش اصلی شما برای ارائه فهرستی از محصولات «کارهایی برای انجام دادن» به گوگل است که قرار است در سطوح مختلف گوگل نمایش داده شوند.

یک شیء ProductFeed شامل یک شیء FeedMetadata و صفر یا چند شیء Product است. اگر هیچ Product در تمام Shardها ارائه نشود، تمام محصولات حذف می‌شوند.

فید محصول

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
فیدفراداده	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": []
}

فیدفراداده

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
واحد۳۲	shard_id	وقتی `total_shards_count` > 1 باشد، الزامی است. مبتنی بر صفر. نیازی نیست که Shardها به ترتیب منتقل شوند. پردازش فقط پس از آپلود شدن مجموعه کامل Shardها شروع می‌شود.
واحد۳۲	تعداد خرده ریزهای کل	الزامی، باید >= 1 باشد.
واحد64	نانس	وقتی `total_shards_count` > 1 باشد، الزامی است. باید برای همه شاردها (shards) درون انتقال یکسان باشد.
شمارشی	دستورالعمل پردازش	الزامی است. تنها مقداری که پشتیبانی می‌شود `PROCESS_AS_SNAPSHOT` است.
دو برابر	max_removal_share	اختیاری. حداکثر سهم محصولات فعال که مجاز به حذف شدن توسط آپلود هستند. اگر محصولات بیشتری توسط این انتقال حذف شوند، کل انتقال رد می‌شود. این یک محافظ در برابر حذف غیرعمدی بخش قابل توجهی از موجودی است. می‌توان آن را روی ۱.۰ تنظیم کرد تا امکان حذف کامل موجودی فراهم شود.

مثال‌ها

// Example 1: metadata single JSON file
{
    "shard_id": 0,
    "total_shards_count": 1,
    "processing_instruction": "PROCESS_AS_SNAPSHOT",
    "nonce": 202113041501
}

// Example 2a: two JSON files (1st file)
{
    "shard_id": 0,
    "total_shards_count": 2,
    "processing_instruction": "PROCESS_AS_SNAPSHOT",
    "nonce": 202213041502
}

// Example 2b: two JSON files (2nd file)
{
    "shard_id": 1,
    "total_shards_count": 2,
    "processing_instruction": "PROCESS_AS_SNAPSHOT",
    "nonce": 202213041502
}

محصول

پروتو

message Product {
  // An opaque string from the partner which uniquely identifies the product.
  // Allowed characters are alphanumeric, _, and -. Max length: 255.
  // Required.
  string id = 1;

  // The title of the product in plain text, e.g. "Horseback riding on the
  // moon". See definition of "LocalizedTextSet" message for the details on the
  // localization.
  // Recommended to not exceed length of 50 in any language. Max length: 150.
  // Required.
  LocalizedTextSet title = 2;

  // The description of the product. Limited formatting options are allowed in
  // the HTML format. Supported tags:
  //   * h1-h5
  //   * ul, ol, li
  //   * strong, italic, em
  //   * p, br
  // Other tags are not supported and will be removed. CSS, tables, style
  // property, `a` links are not supported. Images are not allowed, use the
  // related_media field instead.
  // Important notes:
  //   * Try not to use other tags except for the supported ones mentioned
  //     above, because the contents within unsupported tags will be stripped,
  //     and may lead to an undesirable user experience.
  //   * Try avoid deep nested structures like more than 3 different heading
  //     levels or nested lists. Keeping the structure flat, simple, and
  //     straightforward, helps to create a better user experience.
  //   * Do not duplicate info from the product_features field below in the
  //     description as both would normally be shown side by side.
  // Recommended to not exceed length of 10000 in any language. Max length:
  // 16000.
  // Recommended.
  LocalizedTextSet description = 3;

  // Structured details about the product features.
  // Max number of features: 100.
  // Recommended.
  repeated TextFeature product_features = 4;

  // Aggregated product rating.
  // Recommended.
  Rating rating = 5;

  // Related media such as photos or videos.
  // Max number of media: 30.
  // Recommended.
  repeated Media related_media = 6;

  // Whether Google should make use of the order in which related media are
  // listed in the feed or not. The media order would be used to influence
  // the final image order for the product in the UI.
  // Optional, default is false.
  bool use_media_order = 13;

  // Options available for this product.
  // Max number of options: 20.
  // At least one is required.
  repeated Option options = 7;

  // Operator details.
  // Optional.
  Operator operator = 8;

  // Inventory type of this product.
  enum InventoryType {
    // Default inventory type.
    INVENTORY_TYPE_DEFAULT = 0;

    // Product is an official ticket to a point of interest. To learn what
    // qualifies as official inventory, refer to the policy doc.
    INVENTORY_TYPE_OFFICIAL = 1;

    // Product is coming directly from the operator or their official
    // Connectivity Provider / ResTech.
    INVENTORY_TYPE_OPERATOR_DIRECT = 2;
  }

  // Optional.
  InventoryType inventory_type = 9;

  // Should contain only distinct values of InventoryType.
  // Max number of inventory types: 2.
  // Optional.
  repeated InventoryType inventory_types = 12;

  // Confirmation type of this product.
  enum ConfirmationType {
    // Type of confirmation is unknown.
    CONFIRMATION_TYPE_UNKNOWN = 0;

    // Booking is confirmed to the end user immediately.
    CONFIRMATION_TYPE_INSTANT = 1;

    // Booking is confirmed to the end user within 24 hours.
    CONFIRMATION_TYPE_24HRS = 2 [features.enforce_naming_style = STYLE_LEGACY];

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

  // Optional.
  ConfirmationType confirmation_type = 10;

  // Possible fulfillment types -- ways to obtain a document to confirm the
  // booking. Combinations are possible, e.g. mobile + printed, or
  // printed at home + in-person pickup is available.
  // At least one field must be true.
  message FulfillmentType {
    // Confirmation on a mobile phone, e.g. with a QR code.
    bool mobile = 1;

    // Printable confirmation.
    bool print_at_home = 2;

    // Admission documents to be picked up in person.
    bool pickup = 3;
  }

  // Recommended.
  FulfillmentType fulfillment_type = 11;

  // Provider brand name.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 100.
  // Optional.
  LocalizedTextSet brand_name = 14;
}

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
رشته	شناسه	الزامی، حداکثر طول ۲۵۵. یک رشته منحصر به فرد که محصول را مشخص می‌کند. کاراکترهای مجاز عبارتند از حروف و اعداد، _ و -.
مجموعه متن محلی	عنوان	الزامی، طول توصیه شده <= 50، حداکثر طول 150 کاراکتر. برای جزئیات بیشتر به دستورالعمل‌های عنوان و توضیحات مراجعه کنید.
مجموعه متن محلی	توضیحات	توصیه می‌شود، طول توصیه‌شده <= 10000، حداکثر طول 16000 کاراکتر. See Title and description guidelines for more detail.
تکرار شده ویژگی متن	ویژگی‌های_محصول	توصیه می‌شود، حداکثر تعداد ویژگی‌ها: ۱۰۰.
رتبه‌بندی	رتبه‌بندی	توصیه شده. ارائه رتبه‌بندی اکیداً توصیه می‌شود زیرا محصولاتی که رتبه‌بندی را نشان می‌دهند، نرخ کلیک بالاتری دارند.
تکرار شده رسانه	رسانه‌های مرتبط	توصیه می‌شود، حداکثر تعداد رسانه‌ها: ۳۰ ارائه بیش از یک تصویر اکیداً توصیه می‌شود. برای راهنمای دقیق در مورد تصاویر، به دستورالعمل‌های تصویر مراجعه کنید.
بولی	استفاده از_رسانه_سفارش	اختیاری به گوگل تذکر دهید که هنگام انتخاب تصویر برای نمایش، باید ترتیب فهرست شدن رسانه‌های مرتبط در فید را در نظر بگیرد.
تکرار شده گزینه	گزینه‌ها	الزامی، حداکثر تعداد گزینه‌ها: ۲۰ هر محصول باید حداقل یک گزینه محصول داشته باشد.
اپراتور	اپراتور	اختیاری.
شمارشی	منسوخ شده نوع_موجودی	اختیاری. `INVENTORY_TYPE_OFFICIAL` فقط در محصولاتی قابل تنظیم است که به سایت رسمی بلیط یک نقطه مورد نظر لینک می‌شوند. قابلیت تنظیم این مقدار تنها پس از بررسی واجد شرایط بودن فعال می‌شود. این فیلد منسوخ شده و با فیلد تکراری جدید inventory_types جایگزین شده است.
تکرار شده	انواع_موجودی	اختیاری. فهرست تکراری از انواع موجودی منحصر به فرد که این محصول به آن تعلق دارد. `INVENTORY_TYPE_OFFICIAL` فقط در محصولاتی قابل تنظیم است که به سایت رسمی بلیط یک نقطه مورد نظر لینک می‌شوند. قابلیت تنظیم این مقدار تنها پس از بررسی واجد شرایط بودن فعال می‌شود. `INVENTORY_TYPE_OPERATOR_DIRECT` فقط در محصولاتی که به سایت برگزارکننده تور لینک دارند قابل تنظیم است. قابلیت تنظیم این مقدار تنها پس از بررسی واجد شرایط بودن فعال می‌شود.
شمارشی	نوع_تایید	اختیاری.
نوع انجام سفارش	نوع_تحقق	توصیه می‌شود. در صورت تنظیم، حداقل یک فیلد در `fulfillment_rype` باید درست باشد. روش‌های دریافت سند برای تأیید رزرو را تعیین می‌کند. ترکیب‌ها امکان‌پذیر است، به عنوان مثال، موبایل + چاپ، یا چاپ در منزل + تحویل حضوری در دسترس است.
مجموعه متن محلی	نام_برند	حداکثر طول ۱۰۰ نام تجاری که محصول باید نشان دهد، این جایگزین `operator/name` منسوخ شده می‌شود. فقط یکی از دو مقدار را می‌توان تنظیم کرد.

مثال‌ها

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

گزینه

پروتو

message Option {
  // Option ID. Must be unique within a product.
  // Required.
  string id = 1;

  // The title of the option in plain text, e.g. "Sunset tour".
  //
  // If there is only a single option, the option title may be the same as the
  // product title. If multiple product options are presented, the title must be
  // unique to the option.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 150.
  // Required.
  LocalizedTextSet title = 2;

  // The description of the option. Limited formatting options are allowed in
  // the HTML format, see product description field for more details.
  // Recommended to not exceed length of 10000 in any language.
  // Max length: 16000.
  // Recommended.
  LocalizedTextSet description = 3;

  // Landing page URL for this option. The page should include a button to start
  // the booking/checkout flow.
  // Required.
  DeepLink landing_page = 5;

  // Link to a list view at a higher level of available tickets and tours,
  // prominently showing this option possibly among other options.
  // Recommended.
  DeepLink landing_page_list_view = 6;

  // Additional structured details about the option features. Should not
  // duplicate the details from the product level.
  // Max number of features: 100.
  // Optional.
  repeated TextFeature option_features = 7;

  // Cancellation policy for this option.
  // Recommended.
  CancellationPolicy cancellation_policy = 8;

  // Relevant categories for this Option. Refer to the documentation for valid
  // and mutually exclusive values.
  // Max number of categories: 100.
  // Optional.
  repeated Category option_categories = 9;

  // List of locations related to this option.
  // Max number of locations: 100.
  // Recommended.
  repeated RelatedLocation related_locations = 10;

  // If true, the option is a *typical ticket* that a user would expect to buy
  // to participate in the experience, whether it's an attraction admission or
  // a slot in a tour.
  // Optional, default is false.
  bool base_ticket = 11;

  // All possible prices for this option.
  // Note: With Feed Spec v1 only single Adult price is supported. If multiple
  // price options were provided, the lowest price, possibly with notion
  // "from ..." would be displayed.
  // At least one is required.
  repeated PriceOption price_options = 12;

  // Duration of the option in seconds, where applicable, e.g. for guided tours,
  // boat trips etc. This should reflect the duration of experience (not
  // validity time).
  // Optional.
  uint32 duration_sec = 16;

  // Languages of the option. Only where relevant -- when it's important for
  // the end user to understand and/or read in the language to enjoy the
  // experience. E.g. relevant for a guided tour, but not for a mini-golf pass.
  // Max number of languages: 100.
  // Recommended.
  repeated Language languages = 14;

  // Meeting point -- the start location. Only add where relevant and
  // beneficial, e.g. the place where participant will meet the tour guide to
  // start a walking tour, the place where participant will be picked up for a
  // city tour, the dock where a cruise trip will start.
  // Optional.
  Location meeting_point = 15;
}

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
رشته	شناسه	الزامی است. شناسه گزینه. باید در هر محصول منحصر به فرد باشد.
مجموعه متن محلی	عنوان	الزامی، طول توصیه‌شده: ۵۰، حداکثر طول: ۱۵۰ کاراکتر. اگر فقط یک گزینه وجود داشته باشد، عنوان گزینه می‌تواند همان عنوان محصول باشد. اگر چندین گزینه محصول ارائه شده باشد، عنوان باید مختص به آن گزینه باشد. برای جزئیات بیشتر به دستورالعمل‌های عنوان و توضیحات مراجعه کنید.
مجموعه متن محلی	توضیحات	توصیه شده، طول توصیه شده: 10000، حداکثر طول: 16000. برای جزئیات بیشتر به دستورالعمل‌های عنوان و توضیحات مراجعه کنید.
دیپ لینک	صفحه فرود	الزامی است. باید حاوی دکمه یا لینکی برای رزرو محصول باشد. برای جزئیات بیشتر به دستورالعمل‌های صفحه فرود مراجعه کنید.
دیپ لینک	نمای_لیست_صفحه_لندینگ	توصیه شده. به نمای فهرستی در سطح بالاتری از بلیط‌ها و تورهای موجود پیوند دهید، که این گزینه را به طور برجسته در میان سایر گزینه‌ها نشان می‌دهد. برای جزئیات بیشتر به دستورالعمل‌های صفحه فرود مراجعه کنید.
تکرار شده ویژگی متن	ویژگی‌ها	اختیاری، حداکثر تعداد ویژگی‌ها: ۱۰۰. نباید جزئیات سطح محصول را کپی کند.
سیاست لغو	سیاست لغو	توصیه شده.
تکرار شده دسته بندی	گزینه_دسته‌بندی‌ها	اختیاری، حداکثر تعداد دسته‌ها: ۱۰۰. دسته بندی های مرتبط با این گزینه. برای مقادیر توصیه شده بیشتر به مستندات دسته بندی محصول مراجعه کنید.
تکرار شده مکان مرتبط	related_location	توصیه می‌شود، حداکثر تعداد مکان‌ها: ۱۰۰. ارائه فهرست دقیقی از مکان‌های مرتبط برای نمایش محصول در مرتبط‌ترین مکان‌ها بسیار مهم است، با این حال، تگ‌گذاری بیش از حد یا ارائه داده‌های دقیق منجر به حذف محصول می‌شود. برای جزئیات بیشتر به راهنمای مکان و نقاط مورد علاقه مراجعه کنید.
بول	بلیط_پایه	اختیاری. برای نشان دادن اینکه آیا گزینه محصول، بلیط ورودی پایه است یا خیر، استفاده می‌شود.
تکرار شده گزینه قیمت	گزینه‌های_قیمت	الزامی، حداقل ۱. تمام قیمت‌های ممکن برای این گزینه. توجه: فقط قیمت بزرگسال پشتیبانی می‌شود. اگر چندین گزینه قیمت ارائه شود، اولین قیمتی که از بررسی محدودیت جغرافیایی عبور کند، استفاده خواهد شد. برای بلیط‌های گروهی، باید از قیمت کامل کل گروه استفاده شود.
واحد۳۲	مدت_ثانیه	اختیاری. مدت زمان گزینه به ثانیه، در صورت لزوم، مانند تورهای همراه با راهنما، سفرهای قایقی. این باید مدت زمان تجربه را نشان دهد (نه زمان اعتبار).
تکرار شده زبان	زبان‌ها	توصیه می‌شود، حداکثر تعداد زبان‌ها: ۱۰۰. زبان‌هایی که این گزینه برای آنها در دسترس است. وقتی برای کاربر نهایی مهم است که زبان را بفهمد و/یا بخواند تا از تجربه لذت ببرد. مانند یک تور با راهنما.
مکان	نقطه_جلسه	اختیاری. فقط جاهایی را اضافه کنید که مرتبط و مفید باشند، مثلاً جایی که شرکت‌کننده برای شروع تور پیاده‌روی با راهنمای تور ملاقات می‌کند یا جایی که شرکت‌کننده برای گشت شهری سوار می‌شود، یا اسکله‌ای که سفر دریایی از آنجا شروع می‌شود.

مثال‌ها

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

ویژگی متن

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
شمارشی	نوع_ویژگی	الزامی است. نوع ویژگی، مقادیر ممکن: `TEXT_FEATURE_INCLUSION` : ویژگی یک شمول است. `TEXT_FEATURE_EXCLUSION` : ویژگی یک استثنا است. `TEXT_FEATURE_HIGHLIGHT` : ویژگی یک هایلایت است. `TEXT_FEATURE_MUST_KNOW` : ویژگی «باید شناخته شود». `TEXT_FEATURE_SAFETY_INFORMATION` : ویژگی، اطلاعاتی در مورد اقدامات ایمنی را نشان می‌دهد.
مجموعه متن محلی	ارزش	الزامی، طول توصیه‌شده <= ۱۰۰۰ کاراکتر، حداکثر طول: ۲۰۰۰. تگ‌های قالب‌بندی HTML پشتیبانی‌شده: br، strong، em، i فقط چهار تگ ذکر شده پشتیبانی می‌شوند. `br` می‌تواند برای شکستن خطوط در پاراگراف‌ها و `strong` / `em` / `i` می‌تواند برای برجسته کردن متن مهم استفاده شود. هر تگ عبارتی دیگری نادیده گرفته خواهد شد. سایر تگ‌ها و سبک‌های سفارشی مجاز نیستند و حذف خواهند شد. هرگونه URL، لنگر و پیوند حذف می‌شوند و هرگز برای کاربران نهایی نمایش داده نمی‌شوند.

مثال‌ها

{
    "feature_type": "TEXT_FEATURE_HIGHLIGHT",
    "value": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "<p>A very fun bike tour<p>"
            },
            {
                "language_code": "es",
                "text": "<p>Un recorrido en bicicleta muy divertido.</p>"
            },
            {
                "language_code": "zh-HK",
                "text": "<p>一個非常有趣的自行車之旅.</p>"
            }
        ]
    }
}

رتبه‌بندی

پروتو

message Rating {
  // Average rating value.
  // The value must be in the range of [1, 5] and can be omitted if and only if
  // the rating_count is zero.
  double average_value = 1;

  // Number of ratings used in calculating the value.
  // Required.
  uint64 rating_count = 2;
}

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
دو برابر	مقدار_میانگین	اختیاری. میانگین مقدار امتیاز. این مقدار باید در محدوده [1، 5] باشد و اگر و فقط اگر `rating_count` صفر باشد، می‌توان آن را حذف کرد.
واحد64	rating_count	الزامی است. تعداد رتبه‌بندی‌های استفاده شده در محاسبه‌ی مقدار.

مثال‌ها

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

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

رسانه

پروتو

  message Media {
  // URL of this media source. Google will crawl the media hosted at this URL.
  // Max length: 2000.
  // Required.
  string url = 1;

  enum MediaType {
    // Don't use, for backwards compatibility only.
    MEDIA_TYPE_UNSPECIFIED = 0;

    // Indicates the media provided by the url is a photo.
    MEDIA_TYPE_PHOTO = 1;
  }

  // Type of this media source.
  // Required.
  MediaType type = 2;

  // Attribution information about the source of the media. Note that if
  // the attribution is required to display with the media to give credit to
  // photographer or agency, this field must be set.
  // Recommended to not exceed length of 1000 in any language.
  // Max length: 2000.
  // Optional.
  LocalizedTextSet attribution = 3;
}

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
رشته	آدرس اینترنتی	الزامی، حداکثر طول: ۲۰۰۰ آدرس اینترنتی (URL) این منبع رسانه. گوگل رسانه‌های میزبانی شده در این آدرس اینترنتی را بررسی خواهد کرد.
شمارشی	نوع	الزامی است. نوع این منبع رسانه. مقادیر ممکن: `MEDIA_TYPE_PHOTO` : نشان می‌دهد که رسانه ارائه شده توسط URL یک عکس است.
مجموعه متن محلی	انتساب	اختیاری، طول پیشنهادی: ۱۰۰۰، حداکثر طول: ۲۰۰۰. اطلاعات مربوط به منبع رسانه. توجه داشته باشید که اگر لازم است این اطلاعات به همراه رسانه نمایش داده شود تا به عکاس یا آژانس اعتبار داده شود، این فیلد باید تنظیم شود.

مثال‌ها

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

دسته بندی

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
رشته	برچسب	الزامی. برای مشاهده‌ی لیست مقادیر معتبر، به مستندات دسته‌بندی محصولات مراجعه کنید.

مثال‌ها

{
    "label": "sports"
}

مکان مرتبط

پروتو

// 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_RELATED_NO_ADMISSION` : مکان مرتبط است اما رابطه اجازه پذیرش نمی‌دهد یا پذیرش بی‌ربط است، مانند مکان که یک مربع برجسته در یک تور شهری است. `RELATION_TYPE_ADMISSION_TICKET` : رابطه، مجوز ورود به این مکان مرتبط را می‌دهد. `RELATION_TYPE_SUPPLEMENTARY_ADDON` : Relation یک سرویس اضافی را اعلام می‌کند که کاربر را به مکان مرتبط مانند بلیط پارکینگ یا نمایشگاه موقت هدایت نمی‌کند.

مثال‌ها

// Example of place ID POI with no admissions
{
    "location": {
        "location": {
            "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
        }
    },
    "relation_type": "RELATION_TYPE_RELATED_NO_ADMISSION"
}

// Example of Address POI with admissions
{
    "location": {
        "location": {
          "place_info": {
              "name": "Eiffel Tower",
              "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
          }
        }
    },
    "relation_type": "RELATION_TYPE_ADMISSION_TICKET"
}

دیپ لینک

پروتو

// 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` یا `localized_url` الزامی است.
مجموعه متن محلی	آدرس اینترنتی محلی	اختیاری، حداکثر طول: ۲۰۰۰، حداکثر تعداد افراد محلی ۵۰. الگوی آدرس صفحه فرود محلی‌سازی شده برای دسکتاپ. اگر هر دو `url` و `localized_url` ارائه شده باشند، از اولی به عنوان جایگزین در صورتی که هیچ آدرس اینترنتی با زبان کاربر مطابقت نداشته باشد، استفاده می‌شود. اگر `url` در دسترس نباشد و زبان ارائه نشده باشد، از آدرس اینترنتی انگلیسی استفاده می‌شود.

مثال‌ها

// Example 1: single landing page URL.
{
  "url": "https://www.danstour.com/bike-tours/?language={lang}&currency={currency}"
}

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

اپراتور

پروتو

message Operator {
  // Operator name.
  // Recommended to not exceed length of 50 in any language. Max length: 100.
  // Required.

  LocalizedTextSet name = 1;

  // Operator business name as it is registered in Google Business Profile and
  // appearing on Google Maps.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 100.
  // Required.
  LocalizedTextSet google_business_profile_name = 4;

  // Operator phone number. Prefer full international phone number format.
  // Max length: 64.
  // Optional.
  string phone_number = 2;

  // List of operator locations.
  // Max number of locations: 1.
  // Optional.
  repeated Location locations = 3;
}

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
مجموعه متن محلی	نام [منسوخ شده]	اختیاری، طول پیشنهادی: ۵۰، حداکثر طول: ۱۰۰. نام تجاری فروشنده این محصول. OTA ها باید این را به عنوان نام تجاری OTA تنظیم کنند. این فیلد اکنون منسوخ شده و با brand_name در زیر محصولات جایگزین شده است.
مجموعه متن محلی	نام_پروفایل_کسب_و_کار_گوگل	الزامی، حداکثر طول: ۱۰۰ نام تجاری اپراتور همانطور که در نمایه تجاری گوگل ثبت شده و در نقشه‌های گوگل نمایش داده می‌شود. این فیلد برای شرکت در ماژول رزرو اپراتور الزامی است.
رشته	شماره_تلفن	اختیاری، حداکثر طول: ۶۴. شماره تلفن اپراتور. فرمت کامل شماره تلفن بین‌المللی را ترجیح دهید.
تکرار شده مکان	مکان‌ها	اختیاری، حداکثر تعداد: ۱. آدرس کسب و کار اپراتور. در صورت استفاده از رشته آدرس، نام کسب و کار را به عنوان بخشی از رشته آدرس وارد کنید. به عنوان مثال "نام کسب و کار، آدرس خیابان". کسب و کار اپراتور باید در نقشه‌های گوگل قابل یافتن باشد تا ماژول رزرو اپراتور فعال شود، در صورتی که کسب و کار اپراتور در نقشه‌های گوگل قابل یافتن نیست، باید یک نمایه کسب و کار در گوگل ثبت کند.

مثال‌ها

// Example 1: Sending operator information for operator booking module:
operator: {
  "google_business_profile_name": {
    "localized_texts": [{
      "language_code": "en",
      "text": "Dans Bikes"}]
  },
  "locations": [{
    "location": { //Operator business address
    "place_info": {
      "name": "Dans Bike Tour",
      "unstructured_address": "123 Baker st..."
    }
  }}]
}

زبان

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
رشته	کد	یک کد زبان سازگار با BCP-47 مانند "en" یا "de-CH".

مثال‌ها

{
    "code": "de-CH"
}

گزینه قیمت

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
رشته	شناسه	الزامی، حداکثر طول: ۲۵۵. شناسه منحصر به فرد در محدوده قیمت تعیین شده.
رشته	عنوان	الزامی، حداکثر طول: ۱۵۰ شرح مختصری از گزینه قیمت، برای مثال "روز هفته بزرگسالان".
نوع.گوگل.پول	قیمت	وقتی `is_free` false داشته باشد، الزامی است. قیمت باید با قیمت نهایی در صفحه پرداخت، شامل تمام مالیات‌ها و هزینه‌ها، مطابقت داشته باشد. به سیاست قیمت‌گذاری مراجعه کنید. واحد پول در هنگام پرداخت به واحد پول کاربر تبدیل می‌شود.
بول	رایگان است	اختیاری، پیش‌فرض false است. ورود یا بلیط رایگان است. برای گزینه‌های بدون قیمت باید روی true تنظیم شود.
تکرار شده ژئوکریتوریون	معیارهای جغرافیایی	اختیاری. فهرست مناطق جغرافیایی که این قیمت برای آنها اعمال می‌شود. در صورت خالی بودن، برای همه مکان‌ها اعمال می‌شود.
تکرار شده قیمت، هزینه‌ها و مالیات	هزینه‌ها و مالیات‌ها	اختیاری. تفکیک هزینه‌ها و مالیات‌های لحاظ شده در قیمت.

مثال‌ها

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

ژئوکریتوریون

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
رشته	کد کشور	الزامی است. کد کشور دو حرفی مطابق تعریف ISO 3166-1.
بول	منفی است	اختیاری. اگر درست باشد، معیار منفی است (کد کشور لحاظ نمی‌شود).

مثال‌ها

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

قیمت، هزینه‌ها و مالیات

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
نوع.گوگل.پول	هزینه بلیط به ازای هر نفر	اختیاری. هزینه رزرو در قیمت نهایی محصول برای یک بلیط واحد لحاظ شده است.
نوع.گوگل.پول	مالیات بر بلیط (per_ticket_tax)	اختیاری. مالیات ایالتی در قیمت نهایی محصول برای یک بلیط واحد لحاظ شده است.

مثال‌ها

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

مکان

پروتو

message Location {
  // At least one of (location, description) must be set, and we highly
  // recommend populating location wherever possible.
  //
  // To emphasize, both fields can be populated together, e.g. you can set
  // Central Park New York for the location and "In front of the 72 Street
  // Station" for the description.
  GeoLocation location = 1;

  // Additional description in human-readable form, e.g.
  //     "On the left side of the fountain on the Palace square".
  // At least one of (location, description) must be set.
  // Recommended to not exceed length of 1000 in any language. Max length: 2000.
  LocalizedTextSet description = 2;
}

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
موقعیت جغرافیایی	مکان	اختیاری، حداقل یکی از مکان‌ها یا توضیحات باید وجود داشته باشد. موقعیت جغرافیایی.
مجموعه متن محلی	توضیحات	اختیاری، طول توصیه شده: ۱۰۰۰، حداکثر طول: ۲۰۰۰، حداقل یکی از مکان‌ها یا توضیحات باید وجود داشته باشد. توضیحات اضافی به شکل خوانا برای انسان، مانند «در سمت چپ فواره در میدان کاخ».

مثال‌ها

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

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

موقعیت جغرافیایی

برای اطلاعات بیشتر در مورد هر نوع اشاره، به دستورالعمل‌های استفاده مراجعه کنید.

پروتو

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` ، `address` ، `place_info` ، `business_profile_id` یا `lat_lng` باید وجود داشته باشد. شناسه مکان (PlaceId) همانطور که توسط API مکان‌ها تعریف شده است. به طور منحصر به فرد یک نقطه مورد علاقه (POI) را در گوگل مشخص می‌کند. می‌توان آن را با استفاده از نقاط پایانی API مکان‌ها، به عنوان مثال جستجوی مکان یا تکمیل خودکار مکان، یا به صورت دستی با استفاده از ابزار یافتن تطابق مکان در مرکز کارها، پیدا کرد.
رشته	آدرس	اختیاری، دقیقاً یکی از `place_id` ، `address` ، `place_info` ، `business_profile_id` یا `lat_lng` باید وجود داشته باشد. منسوخ شده. آدرس تک خطی قدیمی. حداکثر طول: ۲۰۰. انتظار می‌رود اجزا با کاما از هم جدا شوند و اولین جزء نام مکان باشد، همانطور که در گوگل نمایش داده می‌شود. برای دقت بالاتر در تطبیق، از آدرس خیابان نشان داده شده در گوگل برای مکان استفاده کنید.
اطلاعات مکان	اطلاعات_مکان	اختیاری، دقیقاً یکی از `place_id` ، `address` ، `place_info` ، `business_profile_id` یا `lat_lng` باید وجود داشته باشد. اطلاعات مکانی ساختاریافته.
واحد64	شناسه_پروفایل_کسب_وکار	اختیاری، دقیقاً یکی از `place_id` ، `address` ، `place_info` ، `business_profile_id` یا `lat_lng` باید وجود داشته باشد. شناسه نمایه کسب‌وکار، همانطور که در صفحه تنظیمات نمایه کسب‌وکار گوگل یافت می‌شود. هنگام تهیه مکان‌ها مستقیماً از مالک مکان، که به نمایه کسب‌وکار گوگل آن مکان دسترسی دارد و می‌تواند چنین شناسه‌ای را ارائه دهد، از این فیلد استفاده کنید.
نوع.گوگل.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
}

اطلاعات مکان

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
رشته	نام	الزامی. حداکثر طول: ۳۰۰. نام مکان یا کسب و کار. برای دقت بالاتر در تطبیق، این نام باید با نامی که در گوگل برای مکان نشان داده شده است، یکسان باشد. برای مکان‌هایی که دارای نمایه تجاری گوگل (Google Business Profile) هستند، این نام باید با نام تجاری پیکربندی شده در نمایه تجاری یکسان باشد.
رشته	شماره_تلفن	اختیاری. حداکثر طول: ۳۰. شماره تلفن، شامل پیشوند بین‌المللی. برای دقت بالاتر در تطبیق، این شماره باید با شماره تلفنی که برای آن مکان در گوگل نشان داده می‌شود، یکسان باشد. می‌تواند شامل کاراکترهای جداکننده رایج باشد. مثال‌ها: "+1 212-363-3200"، "+91 562 222 7261".
رشته	آدرس وب‌سایت	اختیاری. حداکثر طول: ۱۰۰۰. نشانی وب‌سایت نمایش داده شده در گوگل برای آن مکان، ترجیحاً نشانی اینترنتی لینک شده از فهرست کسب‌وکار در نقشه‌های گوگل یا جستجوی مکان.
نوع.گوگل.LatLng	مختصات	اختیاری. مختصات جغرافیایی مکان. اگر خالی بماند، گوگل مختصات را از آدرس استنباط می‌کند. اختیاری است، اما باید `coordinates` یا هر یک از `structured_address` و `unstructured_address` ارائه شود.
آدرس ساختاریافته	آدرس_ساختاریافته	اختیاری، دقیقاً یکی از `structured_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
  }
}

آدرس ساختاریافته

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
رشته	آدرس_خیابان	الزامی. حداکثر طول: ۲۰۰. آدرس خیابان، شامل پلاک خانه و هر جزء دیگری که نمی‌توان با استفاده از فیلدهای خاص‌تر ارائه داد. نباید شامل نام مکان یا کسب و کار باشد، که در عوض باید جداگانه با استفاده از فیلد `name` در `PlaceInfo` ارائه شوند. همچنین نباید شامل کد پستی، محل یا کشور باشد زیرا این موارد باید با استفاده از فیلدهای مربوطه ارائه شوند.
رشته	محل	اختیاری. حداکثر طول: ۸۰. محل، عموماً به بخش شهر یا شهرستان یک آدرس اشاره دارد. در مناطقی از جهان که محل‌ها به خوبی تعریف نشده‌اند یا به خوبی در این ساختار جای نمی‌گیرند، خالی بگذارید.
رشته	ناحیه اداری	اختیاری. حداکثر طول: ۸۰. بالاترین تقسیم‌بندی اداری مورد استفاده برای آدرس‌های پستی یک کشور یا منطقه خاص. این می‌تواند یک ایالت، یک منطقه، یک استان، یک استان، یک بخش یا یک استان باشد. بسته به نحوه نمایش معمول منطقه در آدرس‌های پستی یک کشور خاص، می‌تواند یک اختصار یا یک نام کامل باشد.
رشته	کد پستی	اختیاری. حداکثر طول: ۳۰. کد پستی. در صورتی که کشور از کدهای پستی پشتیبانی کند، الزامی است، در غیر این صورت باید خالی بماند.
رشته	کد کشور	اختیاری. حداکثر طول: ۲. کد کشور، همانطور که توسط یونیکد "CLDR" تعریف شده است، خود بر اساس استاندارد ISO 3166 alpha-2. به مستندات یونیکد مراجعه کنید.

مثال‌ها

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

مجموعه متن محلی

پروتو

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

یادداشت‌های اجرایی

نوع	میدان	یادداشت‌ها
تکرار شده متن محلی شده google.type	متون_محلی	مقادیر متنی محلی‌سازی‌شده برای هر زبان. حداکثر تعداد زبان‌ها: ۵۰.

مثال‌ها

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

سیاست لغو

پروتو

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

یادداشت‌های اجرایی

یک شرط بازپرداخت واحد را تعریف می‌کند. می‌توان از چندین شرط بازپرداخت با هم برای توصیف «مراحل بازپرداخت» به عنوان مدت زمان‌های مختلف قبل از زمان شروع سرویس استفاده کرد.

نوع	میدان	یادداشت‌ها
شرایط بازپرداخت	شرایط_بازپرداخت	اختیاری، حداکثر تعداد شرایط بازپرداخت: ۱۰.

شرایط بازپرداخت

نوع	میدان	یادداشت‌ها
واحد۳۲	دقیقه_مدت_قبل_از_شروع_زمان_ثانیه	اختیاری. مدت زمان (بر حسب ثانیه) قبل از زمان شروع، تا زمانی که مشتری بتواند بخشی از هزینه سرویس مشخص شده در `refund_percent` را بازپرداخت دریافت کند. در صورت عدم تنظیم یا تنظیم روی ۰، سرویس می‌تواند در هر زمانی لغو شود.
واحد۳۲	درصد بازپرداخت	اختیاری. درصدی که می‌تواند بازپرداخت شود، مادامی که رزرو سرویس حداقل `min_duration_before_start_time` قبل از زمان شروع سرویس لغو شود، در محدوده [0، 100]. وقتی تنظیم نشود یا روی 0 تنظیم شود، سرویس قابل استرداد نیست. وقتی روی 100 تنظیم شود، این سرویس به طور کامل قابل استرداد است.
نوع.گوگل.پول	هزینه_بازپرداخت	اختیاری. یک هزینه ثابت هنگام بازپرداخت کسر می‌شود. می‌تواند جداگانه یا در ترکیب با `refund_percent` استفاده شود. در حالت دوم، ابتدا درصد بازپرداخت اعمال می‌شود و سپس هزینه کسر می‌شود.

مثال‌ها

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

خوراک محصول با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

فید محصول

پروتو

یادداشت‌های اجرایی

مثال‌ها

فیدفراداده

پروتو

یادداشت‌های اجرایی

مثال‌ها

محصول

پروتو

یادداشت‌های اجرایی

مثال‌ها

گزینه

پروتو

یادداشت‌های اجرایی

مثال‌ها

ویژگی متن

پروتو

یادداشت‌های اجرایی

مثال‌ها

رتبه‌بندی

پروتو

یادداشت‌های اجرایی

مثال‌ها

رسانه

پروتو

یادداشت‌های اجرایی

مثال‌ها

دسته بندی

پروتو

یادداشت‌های اجرایی

مثال‌ها

مکان مرتبط

پروتو

یادداشت‌های اجرایی

مثال‌ها

دیپ لینک

پروتو

یادداشت‌های اجرایی

مثال‌ها

اپراتور

پروتو

یادداشت‌های اجرایی

مثال‌ها

زبان

پروتو

یادداشت‌های اجرایی

مثال‌ها

گزینه قیمت

پروتو

یادداشت‌های اجرایی

مثال‌ها

ژئوکریتوریون

پروتو

یادداشت‌های اجرایی

مثال‌ها

قیمت، هزینه‌ها و مالیات

پروتو

یادداشت‌های اجرایی

مثال‌ها

مکان

پروتو

یادداشت‌های اجرایی

مثال‌ها

موقعیت جغرافیایی

پروتو

یادداشت‌های اجرایی

مثال‌ها

اطلاعات مکان

پروتو

یادداشت‌های اجرایی

مثال‌ها

آدرس ساختاریافته

پروتو

یادداشت‌های اجرایی

مثال‌ها

مجموعه متن محلی

پروتو

یادداشت‌های اجرایی

خوراک محصول