Tài liệu này cung cấp hướng dẫn về các phương pháp hay nhất. Hãy xem Mẹo về hiệu suất để biết thêm thông tin.
Thời điểm 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ới hệ thống ERP (Lập kế hoạch tài nguyên cho doanh nghiệp), thì 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 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ý. Có thể có độ trễ từ 5 đến 10 giây đố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 dần dữ liệu kho hàng di chuyển nhanh của mình nhiều lần trong một ngày, nhưng 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ó từng bản cập nhật, 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 để có thể gộp lại nhiều bản cập nhật. Tương tự, nếu các bản cập nhật được cung cấp theo lô, hãy gửi các bản cập nhật đó theo lô, đừng chia nhỏ các bản cập nhật đó thành các yêu cầu riêng lẻ.
Cách quản lý nhiều tài khoản phụ
Các tài khoản Merchant Center mới tạo là các tài khoản đơn lẻ, dựa trên tập hợp dữ liệu sản phẩm riêng. Cách này hiệu quả trong hầu hết các trường hợp. Tuy nhiên, 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 của mình. Trong 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ý ở cấp độ API của tài khoản MCA 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
Không sử dụng API này vì bạn sẽ 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.
Đừ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 có 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 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 các vấn đề khi thiết kế giải pháp sử dụng Content API. Tuy nhiên, các chức năng 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 các ứ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 đị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 các 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 sử dụng nguồn cấp dữ liệu nữa để gửi các mặt hàng. 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 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 việc quản lý nguồn cấp dữ liệu trên 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 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.
Sau đây là một số ví dụ khác về cách có thể chấp nhận để sử dụng chung nguồn cấp dữ liệu và API:
Thực thi các yêu cầu chỉ đọc (nhận hoặc danh sách) 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 sản phẩm của họ. Điều này là chấp nhận được vì chỉ nguồn cấp dữ liệu mới cập nhật thông tin sản phẩm.
Sử dụng API này để quản lý các tài khoản phụ (Tài khoản dịch vụ) 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 vận chuyển). Đây không phải là các hàm mà Datafeed có thể cung cấp, vì vậy, không có xung đột với việc sử dụng API để quản lý các hàm này.
Làm cách nào để chuyển từ 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 tải dữ liệu sản phẩm lên lại bằng API này. 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. Đảm bảo rằng không có nội dung cập nhật nguồn cấp dữ liệu nào 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 có 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à 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, bạn chỉ cần thêm nguồn cấp dữ liệu mới vào tài khoản Merchant Center của mình và họ sẽ sở hữu các sản phẩm đã đăng. Nếu muốn xoá những sản phẩm bạn muốn xoá trước khi hết hạn nhưng chỉ được tải lên bằng API, thì bạn phải xoá các sản phẩm đó qua Merchant Center hoặc qua API.
Làm thế nào để tôi nhắm đến nhiều quốc gia bằng sản phẩm bằng 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 qua Content API, hãy thiết lập các quốc gia bổ sung 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 bổ sung đó 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 cho 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 thư viện ứng dụng của Google để tương tác với Content API, hãy nhớ dùng trình quản lý gói cho ngôn ngữ lập trình đã chọn và đảm bảo phiên bản thư viện đó là 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.
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 nào sẽ xuất hiện trong các chương trình mua sắm
Content API tự động áp dụng 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 đã chọn tham gia một chương trình, ví dụ như Mua trên Google (trước đây gọi 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ị. Nếu không có lỗi, lựa chọn này sẽ thay thế chế độ cài đặt nguồn cấp dữ liệu mặc định trong Merchant Center, đồng thời 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 được chọn tham gia vào một chương trình, chẳng hạn như Mua sắm, bạn có thể đưa các mặt hàng riêng lẻ vào bằng cách sử dụng thuộc tính includedDestinations và Shopping_ads làm giá trị, khi đó 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ề 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ục không thay đổi trước khi hết hạn, 30 ngày sau lần cập nhật gần 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ục đó để 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 lúc mà hãy trải đều tải trong nhiều ngày.
Khô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 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. Lần đầu tiên bạn tải một sản phẩm có channel:local 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 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 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 bạn xoá, các sản phẩm trực tuyến hoặc tại địa phương mà bạn đã thêm vào Merchant Center thông qua Content API sẽ bị xoá.
Tạo lô 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 gói tuỳ chỉnh 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 gửi yêu cầu đến điểm cuối API chỉ xảy ra một lần đối với lệnh gọi theo lô tuỳ chỉnh thay vì trong từng yêu cầu riêng lẻ. Điều này đặc biệt quan trọng nếu bạn đang thực hiện 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ặt hàng trong một lô
Thao tác này sẽ cung cấp 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 nội dung cập nhật cho các mục chưa được thay đổi
Hãy đảm bảo bạn chỉ gửi yêu cầu cho các mục sản phẩm mới, đã thay đổi hoặc đã bị xoá, trừ phi các mục đó 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 vấn đề khi cập nhật thông tin về giá, tình trạng còn hàng hoặc ư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 để gửi thông tin cập nhật cho riêng 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 hơn trong một khoảng thời gian cụ thể so với việc cập nhật toàn bộ sản phẩm. Việc này giúp đảm bảo giá và tình trạng còn hàng của sản phẩm luôn nhất quán với 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 thuộc tính này cùng với các bản cập nhật API để tránh trường hợp 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ỏ về tính 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 phải là giải pháp thay thế mà vẫn cung cấp thông tin chính xác thông qua API.
Thời điểm 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. 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à thứ mà các nhà phát triển muốn sử dụng, vì mã này không cần phải nhắc người dùng xác thực nhiều lần, vì mã truy cập chỉ tồn tại 60 phút trước khi hết hạn.