خوراک قیمت

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

ارزهای زیر با Google در دسترس هستند:

  • USD
  • CAD
  • AUD
  • GBP

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

اجزای کلیدی

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

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

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

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

  • cruise_line : نام خط کروز.

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

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

فیلدها

نام فیلد مورد نیاز؟ تایپ کنید توضیحات
sail_id Required string شناسه قایقرانی منحصر به فرد برای یک سفر خاص در برنامه سفر با تاریخ شروع و پایان. به عنوان مثال، برای یک برنامه سفر 5 شبه که 3 توقف دارد، sail_id منحصر به فرد است و برای هر 3 توقف ثابت می ماند. نمونه ای از 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 URL صفحه فرود که اطلاعات قیمت را نشان می دهد. برای مثال، https://partner.com/path.html&id=XYZ12345
offer_desc Optional string شرح پیشنهاد مرتبط با قیمت یا نام کابین. به عنوان مثال، Inside Cabin .
image_url Optional URL 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 به هم پیوسته اند تا کلید اولیه ترکیبی را تشکیل دهند و باید برای هر ردیف منحصر به فرد باشند.

CSV

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

مثال زیر برای فیلدهای الزامی در فید Price آورده شده است:

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

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

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

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 (برای اهداف اطلاعاتی)

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

مثال زیر برای فیلدهای الزامی در فید Price آورده شده است:

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

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

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

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