خلاصة الأسعار

تحتوي خلاصة الأسعار على معلومات التسعير لجميع مسارات الرحلات البحرية. وتشمل أرخص سعر لمقصورة في رحلة بحرية لكل نوع من أنواع العملات. يمكنك تحميل خلاصات الأسعار بتنسيق CSV.

تتوفّر العملات التالية مع Google:

  • USD
  • CAD
  • AUD
  • GBP

الدولار الأمريكي هو العملة الوحيدة المتاحة للتكامل مع Google. يمكنك تقديم عملات أخرى متوافقة، ولكن يتم عرض الدولار الأمريكي فقط. ستتوفّر عملات إضافية من القائمة في المستقبل. راجِع قائمة العملات الأخرى المتوافقة ورمز العملة المقابل المكوّن من ثلاثة أحرف.

المكوّنات الرئيسية

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

تحتوي خلاصة الأسعار على الحقول الإلزامية التالية:

  • sail_id: معرّف فريد للرحلة البحرية لرحلة معيّنة

  • currency_code: رمز عملة فريد مكوّن من ثلاثة أحرف للعملة المحدّدة.

  • cruise_line: اسم شركة الرحلات البحرية

  • starting_price: السعر الإجمالي لمسار الرحلة البحرية، بما في ذلك الضرائب

  • sail_url: عنوان URL للصفحة المقصودة التي تعرض معلومات السعر

الحقول

اسم الحقل مطلوب؟ النوع الوصف
sail_id Required string معرّف فريد للرحلة البحرية لرحلة معيّنة في المسار مع تاريخَي البدء والانتهاء على سبيل المثال، بالنسبة إلى مسار رحلة بحرية مدتها 5 ليالٍ تتضمّن 3 محطات توقف، يكون 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 عنوان 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's متعددة للقيمتَين 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

حقول مطلوبة

في ما يلي مثال على الحقول المطلوبة في خلاصة الأسعار:

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