Tài liệu này cung cấp các nguyên tắc về các phương pháp hay nhất. Hãy xem phần Mẹo về hiệu suất để biết thêm thông tin.
Trường hợp sử dụng API
Cách 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 của quy trình làm việc hay tạo một trình bổ trợ vào hệ thống ERP (Lập kế hoạch tài nguyên doanh nghiệp), Content API đều cho phép bạn gửi nội dung cập nhật ngay khi kho hàng thay đổi.
Cách nhận ý kiến phản hồi tức thì
Trong Content API, bạn sẽ nhận được phản hồi tức thì cho mọi yêu cầu, thay vì thông qua bản tóm tắt qua email sau khi nguồn cấp dữ liệu được xử lý. Độ trễ dự kiến từ 5 đến 10 giây đối với các yêu cầu theo lô lớn.
Cách 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 dần kho hàng sản phẩm thay đổi nhanh nhiều lần trong ngày, trong khi không thể gửi toàn bộ nguồn cấp dữ liệu mỗi lần. Nếu các bản cập nhật được cung cấp riêng lẻ, hãy gửi từng bản cập nhật, đừng đợi đến khi có nhiều bản cập nhật để bạn có thể gửi hàng loạt. Tương tự, nếu có bản cập nhật theo lô, hãy gửi các bản cập nhật đó theo lô, đừng chia thành các yêu cầu riêng lẻ.
Cách quản lý nhiều tài khoản phụ
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. Phương thức này hoạt động hiệu quả trong hầu hết các trường hợp, nhưng khi tài khoả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ể thực hiện việc 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
Khô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 chỉ cập nhật 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 qua tài nguyên products sẽ tiêu tốn nhiều thời gian và tài nguyên hơn cho cả Google và bạn.
Khô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 thường xuyên 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. Đối với các ứng dụ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 API này không dùng để truy xuất thông tin sản phẩm thường xuyên của những ứng dụng như vậy. 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 tại đị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 đó.
Không sử dụng cả nguồn cấp dữ liệu và Content API để gửi mặt hàng
Nếu bạn đang cân nhắc chuyển sang 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ục trên cả hai phương tiện, thì kết quả không mong muốn có thể xảy ra.
Có cách nào để 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ù việc này sẽ giúp bạn dễ dàng quản lý nguồn cấp dữ liệu ở quy mô lớn hơn, 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.
Sau đây là một số ví dụ khác về cách chấp nhận được để sử dụng đồng thời nguồn cấp dữ liệu và API:
Thực thi các yêu cầu chỉ có thể đọc (lấy 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à cập nhật trạng thái về sản phẩm của họ. Điều này là 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ụ (Accounts Service) và/hoặc chế độ cài đặt thuế và thông tin vận chuyển ở cấp tài khoản (Accounttax Service và Shippingsettings Service). Đây không phải là những hàm mà Nguồn cấp dữ liệu có thể cung cấp, vì vậy, việc sử dụng API để quản lý các hàm này sẽ không gây xung đột.
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à muốn chuyển sang chỉ sử dụng API để cập nhật sản phẩm, thì bạn cần tải dữ liệu sản phẩm lên lại 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ó nội dung cập nhật nào trong 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 xoá chính nguồn cấp dữ liệu đó, nếu không, nguồn cấp dữ liệu sẽ lấy 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 tại bạn chỉ sử dụng API cho thông tin sản phẩm và 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. Sau đó, nguồn cấp dữ liệu đó sẽ sở hữu các sản phẩm được đăng. Nếu có sản phẩm mà bạn muốn xoá trước khi hết hạn và sản phẩ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 đến nhiều quốc gia bằng sản phẩm thông qua Content API for Shopping?
Để nhắm đế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 Content API trong Merchant Center hoặc thêm các quốc gia đó 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 quảng cáo Mua sắm và trang thông tin miễn phí ở nhiều quốc gia.
Đảm bảo 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 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 mà 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 phần Mẫu và thư viện.
Hãy nhớ sử dụng các thuộc tính đích đến để kiểm soát sản phẩm xuất hiện trong các chương trình mua sắm
Content API sẽ tự động áp dụng 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 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à Hành động mua sắm), nhưng bạn muốn loại trừ một số sản phẩm nhất định, hãy sử dụng thuộc tính excludedDestinations và chỉ định Shopping Actions làm giá trị. Nếu 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 chương trình Mua trên Google (trước đây gọi là Mua sắm trực tiếp). 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, thì bạn có thể thêm từng mặt hàng bằng cách sử dụng thuộc tính includedDestinations và giá trị Shopping_ads. 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.
Hãy nhớ cập nhật các mục 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, hãy cập nhật mặt hàng đó 30 ngày sau lần cập nhật gần nhất hoặc vào ngày hết hạn đã chỉ định nếu sớm hơn, để tránh bị vô hiệu hoá. Nếu bạn cần cập nhật nhiều mục vì không có mục 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ả các mục cùng một lúc mà hãy chia đều tải trong 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 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 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 thực tế. 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 nguồn cấp dữ liệu Content API cục bộ. Tuỳ thuộc vào nguồn cấp dữ liệu mà bạn xoá, các sản phẩm trực tuyến hoặc sản phẩm tại cửa hàng thực tế mà bạn đã thêm vào Merchant Center thông qua Content API sẽ bị xoá.
Gửi nhiều yêu cầu cùng một lúc đến cùng một dịch vụ bằng phương thức custombatch
Thay vì tạo nhiều yêu cầu tuần tự hoặc song song cho cùng một dịch vụ, hãy tạo một yêu cầu theo lô tuỳ chỉnh chứa tất cả các yêu cầu mong muốn. Bằng cách này, độ trễ khi gửi yêu cầu đến điểm cuối API chỉ xảy ra một lần cho lệnh gọi theo lô tuỳ chỉnh 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 gửi các yêu cầu tuần tự.
Không gửi nhiều nội dung cập nhật cho một mục trong một lô
Điều này sẽ dẫn đến kết quả không mong muốn do không chắc chắn về trình tự cập nhật và có thể gây ra lỗi xung đột.
Không gửi thông tin cập nhật cho các mục không thay đổi
Hãy đảm bảo bạn chỉ gửi yêu cầu đối với 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 sự cố khi cập nhật giá, tình trạng còn hàng hoặc thông tin giảm giá 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ì các nội dung cập nhật nguồn cấp dữ liệu bổ sung
có kích thước nhỏ, nên bạn có thể thực hiện nhiều nội dung cập nhật nguồn cấp dữ liệu bổ sung hơn trong một khoảng thời gian
cụ thể so với nội dung cập nhật sản phẩm đầy đủ. Điều này sẽ giúp giá và tình trạng còn hàng của sản phẩm
phù hợp với trang đích của bạn.
Bạn cũng có thể sử dụng tính năng tự động cập nhật mặt hàng để cập nhật giá và tình trạng còn hàng của sản phẩm. Bạn có thể sử dụng tính năng này ngoài tính năng cập nhật API để tránh tình trạng thông tin trong Merchant Center không khớp với thông tin trên trang đích của sản phẩm. Tuy nhiên, xin lưu ý rằng tính năng này được thiết kế để khắc phục các vấn đề nhỏ liên quan đến tính chính xác về 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ã thông báo làm mới
Mã thông báo làm mới được trả về trong tiêu đề HTTP của các yêu cầu uỷ quyền. Tệp này chứa nhiều thông tin khác liên quan đến việc xác thực, nhưng mã thông báo làm mới thường là phần mà nhà phát triển muốn sử dụng, vì mã này giúp bạn không cần phải liên tục nhắc người dùng xác thực, vì mã truy cập chỉ có thời hạn 60 phút trước khi hết hạn.