Nguồn cấp dữ liệu về giá

Nguồn cấp dữ liệu giá chứa thông tin về giá cho tất cả hành trình du lịch bằng du thuyền. Giá này bao gồm giá cabin rẻ nhất cho một chuyến du thuyền theo từng loại tiền tệ. Bạn có thể tải nguồn cấp dữ liệu về giá lên ở định dạng CSV.

Google hỗ trợ các đơn vị tiền tệ sau:

  • USD
  • CAD
  • AUD
  • GBP

USD là đơn vị tiền tệ duy nhất được hỗ trợ để tích hợp với Google. Bạn có thể cung cấp các đơn vị tiền tệ được hỗ trợ khác nhưng chỉ đơn vị tiền tệ USD mới xuất hiện. Chúng tôi sẽ hỗ trợ thêm các loại tiền tệ khác trong danh sách này trong tương lai. Hãy tham khảo danh sách các đơn vị tiền tệ được hỗ trợ khác và mã đơn vị tiền tệ tương ứng gồm 3 chữ cái.

Thành phần chính

Nguồn cấp dữ liệu về giá có các trường bắt buộc không phân biệt chữ hoa chữ thường. Một số trường là không bắt buộc và có thể để trống. Việc gửi dữ liệu không bắt buộc sẽ giúp cải thiện chất lượng dữ liệu.

Tệp này có các trường bắt buộc sau:

  • sail_id: Giá trị nhận dạng riêng biệt của chuyến đi thuyền cho một chuyến đi cụ thể.

  • currency_code: Mã đơn vị tiền tệ gồm 3 chữ cái duy nhất cho đơn vị tiền tệ cụ thể.

  • cruise_line: Tên của hãng tàu du lịch.

  • starting_price: Tổng giá của hành trình du lịch bằng tàu biển, bao gồm cả thuế.

  • sail_url: URL của trang đích cho thấy thông tin về giá.

Trường

Tên trường Bắt buộc? Loại Mô tả
sail_id Required string Giá trị nhận dạng riêng biệt của chuyến đi thuyền cho một chuyến đi cụ thể trong hành trình có ngày bắt đầu và ngày kết thúc. Ví dụ: đối với một hành trình 5 đêm có 3 điểm dừng, sail_id là duy nhất và vẫn giữ nguyên cho cả 3 điểm dừng. Ví dụ về sail_id là ABC12345.

Lưu ý: sail_id và currency_code được nối để tạo thành một khoá chính tổng hợp và phải là duy nhất.
currency_code Required currency Mã đơn vị tiền tệ gồm 3 chữ cái của giá. Ví dụ: currency_code có thể là USD.

Lưu ý: sail_id và currency_code được nối để tạo thành một khoá chính tổng hợp và phải là duy nhất.
cruise_line Required string Tên của hãng tàu du lịch. cruise_line là thông tin bắt buộc đối với những đơn vị tập hợp đang bán hàng thay mặt cho các công ty khác. Ví dụ: Norwegian Cruise Line.
starting_price Required decimal Tổng giá của hành trình trên du thuyền, bao gồm cả thuế. Tổng giá, bao gồm cả thuế và giá vé du thuyền. Đây phải là giá trị giống với giá trị xuất hiện trên trang web của đối tác khi bạn mở URL của sản phẩm. Ví dụ: 1000.00.
sail_url Required URL URL của trang đích cho thấy thông tin về giá. Ví dụ: https://partner.com/path.html&id=XYZ12345
offer_desc Optional string Nội dung mô tả về ưu đãi liên quan đến giá hoặc tên cabin. Ví dụ: Inside Cabin.
image_url Optional URL URL của một hình ảnh đại diện cho hành trình. Hình ảnh phải liên quan đến nội thất của chuyến du thuyền, chẳng hạn như hình ảnh về cabin, boong tàu và các tiện nghi khác trên tàu. Hình ảnh không nhất thiết phải là hình ảnh chính xác của cabin được đăng. Bạn có thể sử dụng một hình ảnh khác về cabin. Ví dụ về image_url là https://partner.com/images/XXXXX.jpg
brand_name Optional string Khoá phụ để cho phép nhiều sail_url cho cùng một sail_id và currency_code. Ví dụ: Fancy Crusies.
updated_at Optional datetime Ngày và giờ cập nhật mục này gần đây nhất theo Giờ phối hợp quốc tế(UTC). Thông tin này hữu ích cho việc xác định dữ liệu lỗi thời. Thuộc tính này phải tuân theo định dạng ISO 8601. Ví dụ: updated_at là 2025-01-22T00:00:00+00:00.

Ví dụ

Sau đây là ví dụ cơ bản về nguồn cấp dữ liệu giá cho hai chuyến đi thuyền, trong đó một chuyến là chuyến đi một chiều và chuyến còn lại là chuyến đi khứ hồi.

Các ví dụ này minh hoạ cả định dạng CSV và JSON. Các trường sail_id, currency_code được nối để tạo thành khoá chính tổng hợp và phải là duy nhất cho mỗi hàng.

CSV

Các trường bắt buộc

Sau đây là ví dụ về các trường bắt buộc trong Nguồn cấp dữ liệu về giá:

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

Tất cả các trường có sẵn

Ví dụ sau đây là ví dụ cho tất cả các trường có trong nguồn cấp dữ liệu Giá:

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 (chỉ mang tính chất thông tin)

Các trường bắt buộc

Sau đây là ví dụ về các trường bắt buộc trong Nguồn cấp dữ liệu về giá:

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

Tất cả các trường có sẵn

Ví dụ sau đây là ví dụ cho tất cả các trường có trong nguồn cấp dữ liệu Giá:

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