خوراک قیمت

فید قیمت شامل اطلاعات قیمت‌گذاری برای همه برنامه‌های سفر دریایی است. این فید شامل ارزان‌ترین قیمت کابین برای یک سفر دریایی برای هر نوع ارز است. می‌توانید فیدهای قیمت را با فرمت CSV بارگذاری کنید.

ارزهای زیر در گوگل موجود است:

  • USD
  • CAD
  • AUD
  • GBP

دلار آمریکا تنها ارز موجود برای ادغام با گوگل است. می‌توانید ارزهای پشتیبانی‌شده‌ی دیگری را نیز ارائه دهید، اما فقط ارز دلار آمریکا نمایش داده می‌شود. ارزهای اضافی موجود در لیست در آینده پشتیبانی خواهند شد. به لیست سایر ارزهای پشتیبانی‌شده و کد ارز سه‌حرفی مربوطه مراجعه کنید.

اجزای کلیدی

فید قیمت فیلدهای اجباری دارد که به حروف کوچک و بزرگ حساس نیستند. برخی از فیلدها اختیاری هستند و می‌توانند خالی گذاشته شوند. ارسال داده‌های اختیاری، کیفیت داده‌ها را بهبود می‌بخشد.

دارای فیلدهای اجباری زیر است:

  • sail_id : یک شناسه منحصر به فرد برای یک سفر دریایی خاص.

  • currency_code : یک کد ارز سه حرفی منحصر به فرد برای یک ارز خاص.

  • cruise_line : نام خط کشتیرانی.

  • starting_price : قیمت کل برنامه سفر دریایی شامل مالیات.

  • sail_url : آدرس صفحه فرود که اطلاعات قیمت را نشان می‌دهد.

فیلدها

نام فیلد الزامی است؟ نوع توضیحات
sail_id Required string شناسه منحصر به فرد سفر دریایی برای یک سفر خاص در برنامه سفر با تاریخ شروع و پایان. به عنوان مثال، برای یک برنامه سفر ۵ شبی که ۳ توقف دارد، sail_id منحصر به فرد است و برای هر ۳ توقف یکسان باقی می‌ماند. نمونه‌ای از sail_id ، ABC12345 است.

نکته: sail_id و currency_code به هم متصل می‌شوند تا یک کلید اصلی مرکب تشکیل دهند و باید منحصر به فرد باشند.

currency_code Required currency کد ارز سه حرفی برای قیمت. برای مثال، currency_code می‌تواند USD باشد.

نکته: sail_id و currency_code به هم متصل می‌شوند تا یک کلید اصلی مرکب تشکیل دهند و باید منحصر به فرد باشند.

cruise_line Required string نام خط کشتی کروز. cruise_line برای گردآورندگانی که از طرف شرکت‌های دیگر می‌فروشند، الزامی است. به عنوان مثال، Norwegian Cruise Line .
starting_price Required decimal قیمت کل برنامه سفر دریایی شامل مالیات. قیمت کل، شامل مالیات و کرایه سفر دریایی. این باید همان مقداری باشد که در وب‌سایت همکار نمایش داده می‌شود؛ هنگام باز کردن URL پیشنهاد. به عنوان مثال 1000.00 .
sail_url Required URL آدرس اینترنتی صفحه فرود که اطلاعات قیمت را نشان می‌دهد. برای مثال، https://partner.com/path.html&id=XYZ12345
offer_desc Optional string توضیحی از پیشنهاد مرتبط با قیمت یا نام کابین. برای مثال، Inside Cabin .
image_url Optional URL آدرس اینترنتی تصویری که برنامه سفر را نشان می‌دهد. تصویر باید مربوط به فضای داخلی کشتی باشد، مانند تصویری از کابین، عرشه کشتی و سایر امکانات ارائه شده در کشتی. تصویر لازم نیست دقیقاً مربوط به همان کابین ذکر شده باشد. می‌توانید از تصویر کابین دیگری استفاده کنید. نمونه‌ای از image_url https://partner.com/images/XXXXX.jpg است.
brand_name Optional string کلید ثانویه برای مجاز کردن چندین sail_url برای sail_id و currency_code یکسان. برای مثال، Fancy Crusies .
updated_at Optional datetime تاریخ و زمانی که این ورودی آخرین بار بر اساس زمان هماهنگ جهانی (UTC) به‌روزرسانی شده است. این اطلاعات برای شناسایی داده‌های قدیمی مفید است. باید از فرمت ISO 8601 پیروی کند. برای مثال، updated_at برابر است با 2025-01-22T00:00:00+00:00 .

مثال‌ها

در زیر یک مثال اساسی از تغذیه قیمت برای دو بادبان آورده شده است که در آن یک بادبان یک طرفه و دیگری رفت و برگشت است.

مثال‌ها هر دو فرمت CSV و JSON را نشان می‌دهند. فیلدهای sail_id و currency_code به هم متصل می‌شوند تا کلید اصلی مرکب را تشکیل دهند و باید برای هر ردیف منحصر به فرد باشند.

سی اس وی

فیلدهای مورد نیاز

مثال زیر برای فیلدهای الزامی در فید قیمت است:

sail_id; currency_code; cruise_line; starting_price; sail_url
12345; USD; Happy Cruises Company; 2198; https://partner.com/path.html&id=XYZ12345
54321; GBP; Happy Cruises Company; 449; https://partner.com/path.html&id=ABC12345
54321; USD; Happy Cruises Company; 430; https://partner.com/path.html&id=ABC12345

همه فیلدهای موجود

مثال زیر نمونه‌ای از تمام فیلدهای موجود در فید قیمت است:

sail_id; currency_code; cruise_line; starting_price; sail_url; offer_desc; image_url; brand_name; updated_at
12345; USD; Happy Cruises Company; 2198; https://partner.com/path.html&id=XYZ12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Fancy Cruises; 2025-06-20T00:00:00+00:00
54321; GBP; Happy Cruises Company; 449; https://partner.com/path.html&id=ABC12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Caribbean Crusies; 2025-06-20T00:00:00+00:00
54321; USD; Happy Cruises Company; 430; https://partner.com/path.html&id=ABC12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Caribbean Crusies; 2025-06-20T00:00:00+00:00

JSON (برای اهداف اطلاعاتی)

فیلدهای مورد نیاز

مثال زیر برای فیلدهای الزامی در فید قیمت است:

[
  {
    "sail_id": "12345",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 2198,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  },
  {
    "sail_id": "54321",
    "currency_code": "GBP",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 449,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  },
  {
    "sail_id": "54321",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 430,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  }
]

همه فیلدهای موجود

مثال زیر نمونه‌ای از تمام فیلدهای موجود در فید قیمت است:

[
  {
    "sail_id": "12345",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 2198,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Fancy Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  },
  {
    "sail_id": "54321",
    "currency_code": "GBP",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 449,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Caribbean Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  },
  {
    "sail_id": "54321",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 430,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Caribbean Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  }
]