Thông báo Giao dịch 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 Gói dịch vụ phòng và dữ liệu về hành trình, bao gồm:
Giá khách sạn và quỹ phòng: Đặt giá tối thiểu cho một hành 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ể xóa phòng khỏi quỹ phòng. Để biết thêm thông tin, hãy xem bài viết Xóa quỹ phòng.
Gói dịch vụ phòng: Đặt giá lịch trình cho một kiểu kế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 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 không cập nhật, nên 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) để lấy giá mới. Dữ liệu này thường thay đổi rất thường xuyên. Để xác định giá và tình trạng phò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ụ: Chỉ định thông tin chi tiết về phòng và gói dịch vụ, chẳng hạn như thông tin mô tả, ảnh và sức chứa tối đa. Dữ liệu này không thay đổi thường xuyên. Để xác định siêu dữ liệu của 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 khảo siêu dữ liệu này trong thông báo giá thay vì bao gồ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 bài viết Xác định siêu dữ liệu về phòng và gói dịch vụ.
Phần tử gốc của thông báo Giao dịch là <Transaction>. Những thông báo sử 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 không hạn chế, miễn là tổng dung lượng thông báo không vượt quá 100 MB.
Để biết ví dụ về 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ế độ gử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 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 gọi là Truy vấn Yêu cầu cung cấp giá hiện tại. Các thông báo Truy vấn này tì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ị và số lượng khách mà họ đã chỉ định. Để biết thêm thông tin, hãy xem bài viết Truy vấn Yêu cầu cung cấp giá hiện tại.
Kích thước thư
Bạn có thể đưa mọi tổ hợp cập nhật dữ liệu vào một Thông báo giao dịch duy nhất, nhưng có giới hạn 100 MB cho kích thước của mỗi thông báo. Thông thường, tất cả các Yêu cầu kéo và 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ờ thành 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à 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ụ.
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 đề thư.