Tài liệu này cung cấp nguyên tắc về các phương pháp hay nhất. Hãy xem bài viết Mẹo về hiệu suất để biết thêm thông tin.
Trường hợp sử dụng API
Để gửi yêu cầu theo phương thức lập trình
Cho dù bạn muốn tự động hoá mọi phần trong quy trình làm việc hay tạo một hook vào hệ thống ERP (Lập kế hoạch nguồn lực doanh nghiệp), Content API đều cho phép bạn gửi thông tin cập nhật ngay khi kho hàng của bạn thay đổi.
Để nhận ý kiến phản hồi ngay lập tức
Trong Content API, bạn sẽ nhận được phản hồi cho mọi yêu cầu ngay lập tức, thay vì nhận được email tóm tắt sau khi nguồn cấp dữ liệu được xử lý. Độ trễ dự kiến là từ 5 đến 10 giây đối với các yêu cầu hàng loạt lớn.
Để thường xuyên thay đổi dữ liệu sản phẩm
Với Content API, bạn có thể cập nhật tăng dần kho hàng sản phẩm bán chạy nhiều lần trong một ngày, trong khi việc gửi toàn bộ nguồn cấp dữ liệu mỗi lần là không khả thi. Nếu có thông tin cập nhật riêng lẻ, hãy gửi riêng từng thông tin cập nhật, đừng đợi cho đến khi có nhiều thông tin cập nhật để bạn có thể gửi hàng loạt. Tương tự, nếu có thông tin cập nhật hàng loạt, hãy gửi hàng loạt, đừng chia thành các yêu cầu riêng lẻ.
Để quản lý nhiều tài khoản phụ
Các tài khoản Merchant Center mới tạo là tài khoản đơn lẻ, lưu giữ bộ dữ liệu sản phẩm riêng. Điều này hoạt động tốt trong hầu hết các trường hợp, nhưng khi tài khoản của bạn phát triển, bạn có thể thấy rằng mình cần một hệ thống quản lý phức tạp hơn cho các sản phẩm. Nếu bạn gặp trường hợp này, hãy cân nhắc sử dụng tài khoản nhiều khách hàng (MCA). Bạn có thể quản lý tài khoản MCA ở cấp API thông qua dịch vụ Tài khoản, đồng thời cho phép thêm và quản lý tài khoản phụ theo phương thức lập trình. Bạn có thể xem thêm thông tin về cách lấy tài khoản MCA tại đây.
Cách sử dụng API
Đừng sử dụng API như cách bạn sử dụng nguồn cấp dữ liệu
Tránh cập nhật toàn bộ nguồn cấp dữ liệu sản phẩm hằng ngày khi sử dụng tài nguyên products.
Thay vào đó, hãy cập nhật riêng những sản phẩm có dữ liệu thực sự thay đổi. Việc gửi toàn bộ nguồn cấp dữ liệu thông qua tài nguyên products sẽ tốn nhiều thời gian và tài nguyên hơn cho cả Google và bạn.
Đừng sử dụng API để thường xuyên truy xuất thông tin sản phẩm mà bạn đã tải lên
Nếu bạn chịu trách nhiệm duy trì thông tin sản phẩm trong một
tài khoản Merchant Center cụ thể, hãy tránh yêu cầu thông tin sản phẩm
từ Content API thông qua các phương thức
products.get
hoặc
products.list
một cách thường xuyên. Đối với những khách hàng tải thông tin lên, các phương thức này có thể giúp bạn gỡ lỗi khi thiết kế các giải pháp sử dụng Content API. Tuy nhiên, các phương thức này không dành cho việc truy xuất thông tin sản phẩm thường xuyên của những khách hàng đó. Bạn nên có một nguồn khác cho thông tin sản phẩm, chẳng hạn như cơ sở dữ liệu sản phẩm địa phương và các sản phẩm trong Merchant Center phải phản ánh nội dung của nguồn đó.
Đừng sử dụng cả nguồn cấp dữ liệu và Content API để gửi mặt hàng sản phẩm
Nếu bạn đang cân nhắc chuyển sang sử dụng API để gửi mặt hàng, hãy đảm bảo rằng bạn không còn sử dụng nguồn cấp dữ liệu để gửi mặt hàng sản phẩm nữa. Nếu bạn tiếp tục gửi mặt hàng trên cả hai phương tiện, thì có thể xảy ra kết quả không mong muốn.
Tôi có thể sử dụng API và nguồn cấp dữ liệu cùng nhau một cách an toàn không?
Bạn có thể thao tác với nguồn cấp dữ liệu bằng Dịch vụ nguồn cấp dữ liệu của API. Mặc dù điều này sẽ giúp bạn quản lý nguồn cấp dữ liệu ở quy mô lớn dễ dàng hơn nhiều, nhưng hãy lưu ý rằng bạn không nên chèn hoặc cập nhật sản phẩm bằng API đồng thời với nguồn cấp dữ liệu, vì có thể xảy ra kết quả không mong muốn.
Một số ví dụ khác về các cách chấp nhận được để sử dụng nguồn cấp dữ liệu và API cùng nhau bao gồm:
Thực thi các yêu cầu chỉ đọc (nhận hoặc liệt kê) từ API: một số người bán muốn sử dụng API để tìm nạp thông tin và thông tin cập nhật về trạng thái của sản phẩm. Điều này có thể chấp nhận được vì thông tin sản phẩm chỉ được cập nhật bằng nguồn cấp dữ liệu.
Sử dụng API để quản lý tài khoản phụ (Dịch vụ tài khoản) và/hoặc chế độ cài đặt thuế và thông tin vận chuyển ở cấp tài khoản (Dịch vụ thuế tài khoản và Dịch vụ cài đặt thông tin vận chuyển). Đây không phải là các chức năng mà Nguồn cấp dữ liệu có thể cung cấp, vì vậy, không có xung đột khi sử dụng API để quản lý các chức năng này.
Làm cách nào để di chuyển từ việc sử dụng nguồn cấp dữ liệu sang chỉ sử dụng API hoặc ngược lại?
Nếu hiện đang sử dụng nguồn cấp dữ liệu và bạn chỉ muốn sử dụng API để cập nhật sản phẩm, thì bạn cần tải lại dữ liệu sản phẩm bằng API. Khi bạn sử dụng dịch vụ sản phẩm để cập nhật một sản phẩm nhất định, API sẽ kiểm soát thông tin sản phẩm và việc xoá sản phẩm khỏi nguồn cấp dữ liệu hoặc xoá chính nguồn cấp dữ liệu sẽ không còn xoá thông tin sản phẩm khỏi tài khoản Merchant Center của bạn nữa. Hãy đảm bảo rằng không có thông tin cập nhật nào về nguồn cấp dữ liệu nếu bạn muốn xoá sản phẩm khỏi nguồn cấp dữ liệu hoặc chính nguồn cấp dữ liệu đó, nếu không, nguồn cấp dữ liệu sẽ giành lại quyền sở hữu và việc xoá sản phẩm khỏi nguồn cấp dữ liệu sẽ khiến sản phẩm bị xoá.
Nếu hiện chỉ sử dụng API cho thông tin sản phẩm và bạn muốn sử dụng nguồn cấp dữ liệu làm nguồn thông tin sản phẩm chính, thì bạn chỉ cần thêm nguồn cấp dữ liệu mới vào tài khoản Merchant Center và các nguồn cấp dữ liệu này sẽ giành quyền sở hữu các sản phẩm được liệt kê. Nếu có những sản phẩm bạn muốn xoá trước khi hết hạn mà chỉ được tải lên từ API, thì bạn phải xoá các sản phẩm đó thông qua Merchant Center hoặc thông qua API.
Làm cách nào để nhắm mục tiêu đến nhiều quốc gia bằng sản phẩm thông qua Content API for Shopping?
Để nhắm mục tiêu đến nhiều quốc gia bằng quảng cáo và trang thông tin miễn phí cho các sản phẩm được gửi
thông qua Content API, hãy định cấu hình các quốc gia khác trên nguồn cấp dữ liệu chính của Content API
trong Merchant Center hoặc thêm các quốc gia khác đó thông qua trường shipping
trên tài nguyên products.
Dưới đây là ví dụ về cách sửa đổi chế độ cài đặt nguồn cấp dữ liệu chính của Content API.
Để biết thêm thông tin, hãy xem bài viết: Nhắm mục tiêu đến quảng cáo Mua sắm và trang thông tin miễn phí ở nhiều quốc gia.
Đảm bảo rằng thư viện ứng dụng của bạn đã được cập nhật
Nếu bạn đang sử dụng thư viện ứng dụng của Google để tương tác với Content API, hãy nhớ sử dụng trình quản lý gói cho ngôn ngữ lập trình bạn chọn và đảm bảo rằng phiên bản thư viện đã được cập nhật. Để biết thêm thông tin, hãy xem hướng dẫn dành cho nhà phát triển về ngôn ngữ bạn chọn trong Mẫu và thư viện.
Nhớ sử dụng các thuộc tính nền tảng để kiểm soát những sản phẩm xuất hiện trong các chương trình mua sắm khác nhau
Content API sẽ tự động áp dụng các chế độ cài đặt mặc định cho nguồn cấp dữ liệu Content API như đã định cấu hình trong Merchant Center. Bạn có thể sử dụng các thuộc tính sản phẩm includedDestinations hoặc excludedDestinations để kiểm soát việc tham gia chương trình ở cấp sản phẩm trong nguồn cấp dữ liệu hoặc thông qua Content API.
Nếu nguồn cấp dữ liệu API của bạn đã chọn tham gia một chương trình, chẳng hạn như Mua trên Google (trước đây gọi là Mua sắm), nhưng bạn muốn loại trừ một số sản phẩm, hãy sử dụng thuộc tính excludedDestinations và chỉ định Shopping Actions làm giá trị. Miễn là không có lỗi, thao tác này sẽ ghi đè chế độ cài đặt nguồn cấp dữ liệu mặc định trong Merchant Center và mặt hàng cụ thể đó sẽ không xuất hiện trong Mua trên Google (trước đây gọi là Mua sắm). Ngược lại, nếu nguồn cấp dữ liệu của bạn chưa chọn tham gia một chương trình, chẳng hạn như Mua sắm, bạn có thể thêm các mặt hàng riêng lẻ bằng cách sử dụng thuộc tính includedDestinations và Shopping_ads làm giá trị. Mặt hàng đó sẽ xuất hiện trong quảng cáo Mua sắm.
Để biết thêm thông tin về các thuộc tính sản phẩm includedDestinations và
excludedDestinations, hãy xem
Trung tâm trợ giúp.
Nhớ cập nhật mặt hàng trước khi hết hạn
Nếu một mặt hàng không thay đổi trước khi hết hạn (30 ngày sau lần cập nhật gần đây nhất hoặc vào ngày hết hạn đã chỉ định nếu sớm hơn), hãy cập nhật mặt hàng đó để tránh bị huỷ kích hoạt. Nếu bạn cần cập nhật nhiều mặt hàng vì không có mặt hàng nào thay đổi hoặc bạn không thể theo dõi thời điểm cập nhật gần đây nhất, đừng cập nhật tất cả mặt hàng cùng một lúc mà hãy phân bổ đều tải trên nhiều ngày.
Đừng xoá nguồn cấp dữ liệu Content API nếu không sản phẩm của bạn có thể biến mất
Lần đầu tiên bạn tải một sản phẩm lên bằng channel:online thông qua Content API, một nguồn cấp dữ liệu mới sẽ xuất hiện trong Merchant Center có tiêu đề là Content API. Lần đầu tiên bạn tải một sản phẩm lên bằng channel:local thông qua Content API, một nguồn cấp dữ liệu mới sẽ xuất hiện trong Merchant Center có tiêu đề là Content API với tiêu đề phụ là Sản phẩm tại cửa hàng địa phương. Hãy đảm bảo rằng bạn không vô tình xoá nguồn cấp dữ liệu Content API trực tuyến hoặc tại cửa hàng địa phương. Tuỳ thuộc vào nguồn cấp dữ liệu bạn xoá, các sản phẩm trực tuyến hoặc tại cửa hàng địa phương mà bạn đã thêm vào Merchant Center thông qua Content API sẽ bị xoá.
Gửi hàng loạt nhiều yêu cầu đến cùng một dịch vụ bằng phương thức custombatch
Thay vì đưa ra nhiều yêu cầu tuần tự hoặc song song đến cùng một dịch vụ, hãy đưa ra một yêu cầu custombatch duy nhất chứa tất cả các yêu cầu mong muốn. Bằng cách này, độ trễ khi đưa ra yêu cầu đến điểm cuối API chỉ xảy ra một lần cho lệnh gọi custombatch thay vì trên từng yêu cầu riêng lẻ. Điều này đặc biệt quan trọng nếu bạn đang đưa ra các yêu cầu tuần tự.
Đừng gửi nhiều thông tin cập nhật cho một mặt hàng trong một lô duy nhất
Đừng gửi thông tin cập nhật cho các mặt hàng không thay đổi
Hãy đảm bảo rằng bạn chỉ gửi yêu cầu cho các mặt hàng sản phẩm mới, đã thay đổi hoặc đã xoá, trừ phi các mặt hàng đó sẽ hết hạn.
Sử dụng nguồn cấp dữ liệu bổ sung nếu giá và/hoặc tình trạng còn hàng thay đổi nhanh chóng
Nếu bạn gặp khó khăn trong việc cập nhật giá, tình trạng còn hàng hoặc thông tin bán hàng của sản phẩm
, hãy cân nhắc sử dụng
Nguồn cấp dữ liệu bổ sung trong tài nguyên products
để chỉ gửi thông tin cập nhật cho những thuộc tính đó. Vì thông tin cập nhật nguồn cấp dữ liệu bổ sung có quy mô nhỏ, nên bạn có thể cập nhật nguồn cấp dữ liệu bổ sung nhiều lần hơn trong một khoảng thời gian nhất định so với việc cập nhật toàn bộ sản phẩm. Điều này sẽ giúp giá và tình trạng còn hàng của sản phẩm khớp với trang đích của bạn.
Một cách khác để cập nhật giá và tình trạng còn hàng của sản phẩm là sử dụng tính năng tự động cập nhật mặt hàng. Bạn có thể sử dụng tính năng này ngoài các thông tin cập nhật API để tránh tình trạng không khớp giữa thông tin trong Merchant Center và thông tin trên trang đích của sản phẩm. Tuy nhiên, hãy lưu ý rằng tính năng này được thiết kế để khắc phục các vấn đề nhỏ về độ chính xác của giá và tình trạng còn hàng của sản phẩm, vì vậy, tính năng tự động cập nhật mặt hàng không thay thế cho việc cung cấp thông tin chính xác thông qua API.
Trường hợp sử dụng mã làm mới
Mã làm mới được trả về trong tiêu đề HTTP của các yêu cầu uỷ quyền. Mã này chứa nhiều thông tin khác liên quan đến việc xác thực, nhưng mã làm mới thường là phần mà nhà phát triển muốn có được, vì mã này giúp loại bỏ nhu cầu liên tục nhắc người dùng xác thực, vì mã truy cập chỉ tồn tại trong 60 phút trước khi hết hạn.