Tài liệu này cung cấp hướng dẫn về các phương pháp hay nhất. Xem 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
Dù bạn muốn tự động hoá mọi phần trong quy trình công việc hay tạo nội dung kết nối 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 thông tin cập nhật ngay khi kho hàng thay đổi.
Để nhận được ý 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ì qua email tóm tắt sau khi nguồn cấp dữ liệu được xử lý. Độ trễ từ 5 đến 10 giây có thể sẽ xảy ra đối với các yêu cầu hàng loạt có kích thước lớn.
Để thường xuyên thay đổi dữ liệu sản phẩm của bạn
Với Content API, bạn có thể cập nhật gia tăng kho hàng hoạt động nhanh nhiều lần trong 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ó các bản cập nhật riêng lẻ, hãy gửi từng bản cập nhật, đừng đợi cho đến khi có một số bản cập nhật để bạn có thể xử lý theo lô. Tương tự, nếu có các bản cập nhật theo lô, hãy gửi các bản cập nhật đó theo lô, không chia nhỏ thành từng 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à các tài khoản đơn lẻ, sử dụng tập 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ể nhận 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 của mình. Nếu đây là trường hợp của bạn, hãy cân nhắc sử dụng tài khoản nhiều khách hàng (MCA). Bạn có thể tiến hành 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ý các 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ư khi 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 đó, chỉ cập nhật cụ thể 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 của bạn 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.
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 bằng phương thức products.get hoặc products.list. Đối với những ứng dụng tải thông tin lên, các phương thức này có thể giúp bạn khắc phục vấn đề khi thiết kế giải pháp sử dụng Content API. Tuy nhiên, các trình xử lý này không dành cho việc thường xuyên truy xuất thông tin sản phẩm 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 tại cửa hàng đị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 việ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 các mặt hàng sản phẩm nữa. Nếu bạn tiếp tục gửi các 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 đồng thời API và nguồn cấp dữ liệu 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 của mình bằng cách sử dụng Dịch vụ nguồn cấp dữ liệu của API. Mặc dù việc này sẽ giúp việc quản lý nguồn cấp dữ liệu trên quy mô lớn trở nên dễ dàng hơn nhiều, nhưng xin lưu ý rằng bạn không nên chèn hoặc cập nhật sản phẩm bằng cách sử dụng API đồng thời với nguồn cấp dữ liệu, vì kết quả không mong muốn có thể xảy ra.
Một số ví dụ khác về cách sử dụng đồng thời nguồn cấp dữ liệu và API:
Thực hiện 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 này để tìm nạp thông tin và nội dung cập nhật trạng thái trên sản phẩm của họ. Điều này chấp nhận được vì chỉ có nguồn cấp dữ liệu mới cập nhật thông tin sản phẩm.
Sử dụng API để quản lý các 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ụ Accounttax và Dịch vụ cài đặt vận chuyển). Đây không phải là những chức năng 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ý những chức năng này sẽ không ảnh hưởng.
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 đ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, bạn cần phải 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á nguồn cấp dữ liệu sẽ không xoá thông tin sản phẩm khỏi tài khoản Merchant Center của bạn nữa. Đảm bảo rằng không có thông tin cập nhật 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ẽ 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 dùng nguồn cấp dữ liệu làm nguồn chính cho thông tin sản phẩm, 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 để họ sẽ sở hữu các sản phẩm mà họ đăng. Nếu có những sản phẩm được tải lên chỉ bằng API trước khi hết hạn, bạn phải xoá các sản phẩm đó qua Merchant Center hoặc qua API.
Làm cách nào để nhắm đến nhiều quốc gia có sản phẩm bằng Content API for Shopping?
Để nhắm đến nhiều quốc gia có quảng cáo và trang thông tin miễn phí cho các sản phẩm được gửi qua Content API, hãy thiết lập các quốc gia khác trong 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 đó qua trường shipping trong 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 rằng thư viện ứng dụng của bạn được cập nhật
Nếu bạn đang dùng một 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 phiên bản thư viện đó là phiên bản mới nhất. Để biết thêm thông tin, hãy xem hướng dẫn của 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 vị trí xuất hiện để kiểm soát những sản phẩm sẽ xuất hiện trong các chương trình mua sắm khác nhau
Content API 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ư được đị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 một 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 đã được chọn tham gia một chương trình, chẳng hạn như Mua trên Google (trước đây là Mua sắm Trực tiếp), 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, chế độ cài đặt này sẽ thay thế 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 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 được 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à Shopping_ads làm giá trị, đồng thời 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ặt hàng trước khi chúng 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 được 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ụ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 cho 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
Trong lần đầu tiên bạn tải một sản phẩm có channel:online lên 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 đề Content API. Trong 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 đề 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 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 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á.
Tạo nhóm nhiều yêu cầu cho cùng một dịch vụ bằng phương thức gói tuỳ chỉnh
Thay vì thực hiện nhiều yêu cầu tuần tự hoặc song song cho cùng một dịch vụ, hãy thực hiện một yêu cầu tuỳ chỉnh duy nhất có 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 tuỳ chỉnh, thay vì đối với từng yêu cầu riêng lẻ. Điều này đặc biệt quan trọng nếu bạn thực hiện các yêu cầu theo 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ẽ mang lại kết quả không mong muốn do sự 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 nội dung cập nhật cho các mục không thay đổi
Đảm bảo rằng bạn chỉ gửi yêu cầu về các mặt hàng sản phẩm mới, đã thay đổi hoặc đã bị 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 không cập nhật được giá, tình trạng còn hàng hoặc thông tin ưu đãi 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 các thuộc tính đó. Vì việc 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 so với việc cập nhật toàn bộ sản phẩm. Điều này giúp giá và tình trạng còn hàng của sản phẩm khớp với thông tin trên các trang đích.
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 thông tin này cùng với thông tin cập nhật API để tránh việc thông tin trong Merchant Center và thông tin trên trang đích của sản phẩm không khớp với nhau. 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ỏ 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ã làm mới
Mã làm mới được trả về trong tiêu đề HTTP của yêu cầu uỷ quyền. Thư viện 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 họ không phải liên tục nhắc người dùng xác thực, vì mã truy cập chỉ tồn tại 60 phút trước khi hết hạn.