Thông báo Giao dịch sẽ gửi dữ liệu về phòng, giá và gói dịch vụ cho Google. Có hai loại thông báo Giao dịch chính:
Dữ liệu về hành trình: Xác định dữ liệu về gói dịch vụ phòng và lịch trình, trong đó có:
Giá khách sạn và quỹ phòng: Đặt giá tối thiểu cho những lịch trình đáp ứng một số yêu cầu. Để biết thêm thông tin, hãy xem bài viết Cập nhật giá. Bạn cũng có thể xoá phòng khỏi quỹ phòng. Để biết thêm thông tin, hãy xem bài viết Xoá khoảng không quảng cáo.
Gói dịch vụ phòng: Đặt giá theo lịch trình cho một tổ hợp phòng thực tế và gói dịch vụ bổ sung. Để biết thêm thông tin, hãy xem bài viết Gói dịch vụ phòng. Google lưu nội dung của thông báo Giao dịch vào bộ nhớ đệm để giá luôn có sẵn. Trong một số trường hợp, Google xác định rằng các giá trị trong bộ nhớ đệm chưa cập nhật. Vì vậy, Google có thể gửi thêm thông báo
<Query>(hoặc trong một số trường hợp là Truy vấn Yêu cầu cung cấp giá hiện tại) để nhận giá mới. Thông thường, dữ liệu này thay đổi rất thường xuyên. Để xác định giá và tình trạng còn hàng của thông báo Giao dịch, hãy sử dụng<Result>.
Siêu dữ liệu về phòng và gói dịch vụ: Cho biết thông tin chi tiết về phòng và gói dịch vụ, chẳng hạn như nội dung mô tả, ảnh và số người lưu trú tối đa. Dữ liệu này không thường xuyên thay đổi. Để xác định siêu dữ liệu của các thông báo Giao dịch, hãy sử dụng
<PropertyDataSet>. Google lưu trữ siêu dữ liệu này để bạn có thể tham chiếu đến siêu dữ liệu này trong thông báo giá thay vì phải thêm thông tin lặp lại về phòng và gói dịch vụ trong mỗi thông báo. Để biết thêm thông tin, hãy xem phần Xác định siêu dữ liệu về phòng và gói dịch vụ.
Thành phần gốc của thông báo Giao dịch là <Transaction>. Những thông báo dùng phần tử <Transaction> làm phần tử gốc cần có ít nhất một trong các phần tử con. Thông báo Giao dịch có thể có số lượng phần tử con bất kỳ, miễn là tổng kích thước thông báo không vượt quá 100 MB.
Để biết ví dụ về các thông báo Giao dịch phản hồi yêu cầu của Google, hãy xem Tài liệu tham khảo XML về Giá và quỹ phòng (Giao dịch).
Chế độ phân phối
Loại và tần suất gửi thông báo Giao dịch phụ thuộc vào chế độ phân phối của bạn:
- Đối với chế độ phân phối Lấy dữ liệu, bạn sẽ gửi thông báo Giao dịch khi nhận được
<Query>từ Google. - Đối với chế độ phân phối Mức giá đã thay đổi, bạn sẽ gửi thông báo Giao dịch sau khi nhận và phản hồi
<HintRequest>và<Query>.
Để biết thêm thông tin, hãy xem bài viết Chế độ phân phối giá.
Truy vấn về chế độ cung cấp mức giá hiện tại
Bất kể bạn chọn chế độ phân phối nào, Google cũng có thể gửi cho bạn các yêu cầu được gọi là Truy vấn cung cấp mức giá hiện tại. Những Thông báo truy vấn này tìm kiếm giá để phản hồi một lượt tìm kiếm hiện tại. Nếu bạn phản hồi trong khung thời gian quy định (thường là vài trăm mili giây), thì quảng cáo của bạn có thể xuất hiện trong phiên đấu giá. Kết quả của bạn cũng có thể phù hợp hơn với khách hàng, bao gồm cả quốc gia, loại thiết bị của khách hàng và số lượng khách mà họ đã chỉ định. Để biết thêm thông tin, hãy xem phần Truy vấn cung cấp mức giá hiện tại.
Kích thước thư
Bạn có thể đưa mọi kiểu kết hợp thông tin cập nhật dữ liệu vào một thông báo Giao dịch, nhưng mỗi thông báo bị giới hạn là 100 MB. Thông thường, tất cả các Yêu cầu lấy dữ liệu và Yêu cầu gợi ý đều có giới hạn thời gian phản hồi là 100 giây. Thời gian chờ là một trường có thể định cấu hình mà Google có thể điều chỉnh theo yêu cầu. Bạn nên đặt thời gian chờ là 10 phút đối với các thông báo có kích thước rất lớn.
Để giảm đáng kể kích thước của thông báo và có thể tránh sự cố về kích thước và thời gian chờ của thông báo, hãy sử dụng thông báo Giao dịch để xác định trước siêu dữ liệu về phòng và gói dịch vụ của bạn.
Bạn cũng có thể thêm nội dung nén GNU vào thông báo bằng cách thêm Content-Encoding: gzip vào tiêu đề của thông báo.