Đặc tả Atom 1.0

Tài liệu này cung cấp các nguyên tắc cho việc tạo nguồn cấp dữ liệu sản phẩm XML ở định dạng Atom 1.0. Chúng tôi đã liên kết các thuộc tính tiêu chuẩn với các phần tương ứng trong đặc tả chính thức của Atom 1.0 để hỗ trợ bạn tìm thêm thông tin về các thành phần trong ví dụ của chúng tôi. Mặc dù có đưa ra ví dụ về các tệp Atom 1.0 nhưng chúng tôi chỉ cung cấp thông tin tối thiểu về tiêu chuẩn Atom 1.0 này. Nếu muốn tìm hiểu thêm về tiêu chuẩn này, bạn nên xem phần quy cách này trong tài liệu Định dạng phân phối Atom.

Để tải một tệp Atom 1.0 mẫu xuống, vui lòng nhấp vào đây.

Phần 1: Atom 1.0

Dựa trên đặc tả Atom 1.0, có 5 thành phần được xác định trước ở cấp độ nhập dữ liệu, đó là tiêu đề, mã nhận dạng, đường liên kết, tóm tắt và cập nhật. Mặc dù đây là những thành phần không bắt buộc trong tiêu chuẩn Atom 1.0, nhưng nguồn cấp dữ liệu sản phẩm cần phải có các thành phần này.

Nguồn cấp dữ liệu sản phẩm cũng yêu cầu thêm các thành phần như giá và tình trạng. Để bao gồm thông tin chi tiết hơn về mặt hàng, chúng tôi đã mở rộng Atom 1.0 bằng cách thêm vùng chứa tên Google Merchant Center. Việc xác định vùng chứa tên Google Merchant Center cho phép bạn sử dụng các thành phần bổ sung, được gọi là "thuộc tính" và tăng lượng thông tin mà bạn có thể cung cấp về mỗi sản phẩm trong nguồn cấp dữ liệu.

Dưới đây là ví dụ về tài liệu Atom 1.0 cơ bản chứa một mặt hàng:

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"

xmlns:g="http://base.google.com/ns/1.0">
<title>The name of your data feed</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <updated>2006-06-11T18:30:02Z</updated> <author> <name>Google</name> </author>
<id>tag:example.com,2006-06-11:/support/products</id> <entry> 
<title>Red wool sweater</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Comfortable and soft, this sweater will keep you warm on those cold winter nights.</summary> 

<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition>
</entry> </feed>

 

Ví dụ này có hai nội dung bổ sung chính là thêm phần khai báo vùng chứa tên và thêm 3 thuộc tính (đường liên kết của hình ảnh [image_link], giá [price] và tình trạng [condition]).

Khai báo vùng chứa tên Google Merchant Center

Bạn phải khai báo vùng chứa tên sau đây để sử dụng các thuộc tính vốn chỉ được xác định trong vùng chứa tên Google Merchant Center.

xmlns:g="http://base.google.com/ns/1.0"

Ngoài việc khai báo vùng chứa tên Google Merchant Center, bạn cũng phải thêm một tiền tố vào bên trong mỗi thẻ thuộc tính. Chúng tôi thêm tiền tố này vào các thuộc tính để phân biệt thuộc tính được xác định trong vùng chứa tên của chúng tôi với thành phần được xác định trong Atom 1.0. Tiền tố được chọn để khai báo vùng chứa tên này là "g":

<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>

Thuộc tính trong vùng chứa tên Google Merchant Center phải bao gồm tiền tố này, nếu không thì các thuộc tính và bất kỳ giá trị nào có trong thuộc tính sẽ bị bỏ qua.

Thuộc tính

Bạn có thể sử dụng thuộc tính liên quan dành riêng cho sản phẩm của mình càng nhiều càng tốt. Khi sử dụng các thuộc tính này để cung cấp thêm thông tin về sản phẩm, cơ hội để các sản phẩm của bạn hiển thị trong các kết quả sẽ tăng lên đáng kể. Ngoài ra, bạn cũng có thể sử dụng các thuộc tính được xác định trong vùng chứa tên trên Google Merchant Center nhiều lần trong một sản phẩm. Bằng cách này, bạn có thể thêm nhiều thông tin có sẵn hơn về một sản phẩm trong nguồn cấp dữ liệu.

Phần 2: Danh sách kiểm tra quan trọng

Trước khi gửi nguồn cấp dữ liệu, bạn đặc biệt nên xem qua danh sách sau đây để đảm bảo định dạng tệp đúng cách:

1. Tên tệp phải kết thúc bằng đuôi .xml.
2. Tên tệp của nguồn cấp dữ liệu mà bạn đăng ký trong tài khoản Google Merchant Center phải khớp với tên chỉ định cho tệp.
3. Nhớ khai báo vùng chứa tên. Những giá trị này phải khớp chính xác như ví dụ bên dưới.
   1. Vùng chứa tên trên Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. Vùng chứa tên của thuộc tính tùy chỉnh: xmlns:[prefix]="http://base.google.com/cns/1.0", trong đó tiền tố [prefix] được thay bằng tiền tố bạn đã thêm vào tệp.
4. Xác minh xem tiền tố có trong thẻ thuộc tính của Google Merchant Center và Google Merchant Center tùy chỉnh có khớp với tiền tố được xác định trong phần khai báo vùng chứa tên hay không.
5. Xóa các thuộc tính không chứa bất kỳ giá trị nào.

Phần 3: Lưu ý cuối cùng

Dữ liệu được nhập làm mẫu trong tài liệu này đã được đơn giản hóa để giúp tập trung hơn vào kiến thức cơ bản của việc tạo nguồn cấp dữ liệu XML trong Google Merchant Center. Mặc dù chúng tôi chấp nhận các nguồn cấp dữ liệu chứa các thành phần khác được xác định trong tiêu chuẩn Atom 1.0 hoặc trong vùng chứa tên của riêng bạn, nhưng bất kỳ thông tin nào thuộc các thành phần này đều bị bỏ qua trong quá trình xử lý và sẽ không hiển thị trong quảng cáo hoặc trang thông tin miễn phí về sản phẩm. Hiện tại, chúng tôi sẽ chỉ xử lý những dữ liệu có trong các thành phần mặc định theo tiêu chuẩn Atom 1.0 và trong các thuộc tính thuộc vùng chứa tên Google Merchant Center và vùng chứa tên Google Merchant Center tuỳ chỉnh.