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

تحتوي خلاصة الأسعار على معلومات عن الأسعار لجميع برامج الرحلات البحرية. ويشمل ذلك أرخص سعر لمقصورة في رحلة بحرية لكل نوع من العملات. يمكنك تحميل خلاصات الأسعار بتنسيق 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 فريدًا ويظلّ كما هو في كل 3 محطات. من الأمثلة على sail_id هو ABC12345.

ملاحظة: يتم تسلسل sail_id و currency_code لإنشاء مفتاح أساسي composit ، ويجب أن يكون فريدًا.
currency_code Required currency رمز العملة المكوّن من ثلاثة أحرف للسعر على سبيل المثال، currency_code يمكن أن يكون USD.

ملاحظة: يتم تسلسل sail_id و currency_code لإنشاء مفتاح أساسي composit ، ويجب أن يكون فريدًا.
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

حقول مطلوبة

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

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