Nguồn cấp dữ liệu 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 thuyền. Giá này bao gồm giá phòng giá 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 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ó thể 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 hiển thị. Chúng tôi sẽ hỗ trợ thêm các đơn vị 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ệ gồm ba chữ cái tương ứng.

Các thành phần chính

Nguồn cấp dữ liệu 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 chuyến đi biển duy nhất 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 hãng tàu du lịch.

  • starting_price: Tổng giá của hành trình du thuyề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 chuyến đi biển duy nhất 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 với nhau để 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ã tiền tệ gồm ba chữ cái của giá. Ví dụ: currency_code có thể là USD.

Lưu ý: sail_id và currency_code được nối với nhau để 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à yêu cầu bắt buộc đối với các công ty tổng hợp đang bán 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 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 mở URL của mặt hàng. Ví dụ: 1000.00.
sail_url Required URL URL của trang đích hiển thị thông tin về giá. Ví dụ: https://partner.com/path.html&id=XYZ12345
offer_desc Optional string Nội dung mô tả ưu đãi liên kết với giá hoặc tên khoang. Ví dụ: Inside Cabin.
image_url Optional URL URL của 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 tàu du lịch, chẳng hạn như hình ảnh của phòng, boong tàu và các cơ sở vật chất khác được cung cấp 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 phòng được đăng. Bạn có thể sử dụng một hình ảnh khác về khoang hành khách. 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 cũ. Ngày phát hành 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, trong đó một chuyến đi là một chiều và chuyến còn lại là khứ hồi.

Các ví dụ cho thấy cả định dạng CSV và JSON. Các trường sail_id, currency_code được nối với nhau để 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 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ó sẵn 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 (dùng để tham khảo)

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 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ó sẵn 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"
  }
]