Tài liệu này mô tả một số phương pháp hay nhất để sử dụng API CSS. Bạn không bắt buộc phải làm theo lời khuyên trên trang này để sử dụng API, nhưng lời khuyên này có thể giúp làm rõ một số mục đích sử dụng.
Thiết lập môi trường
Để thiết lập môi trường phát triển, hãy làm theo các bước trong tài liệu Làm quen nhanh.
- Tạo người dùng và tệp JSON chứa quyền trên Google Cloud Console
- Bật CSS API trong Google Cloud Console
- Thêm người dùng đó (có quyền Quản trị) vào Tài khoản CSS (nhóm hoặc miền) của bạn
Thư viện ứng dụng hiện nằm trong kho lưu trữ chuẩn cho hầu hết ngôn ngữ lập trình. Bạn có thể tìm thấy danh sách các thư viện đó trên trang thư viện ứng dụng của chúng tôi.
Các phương pháp hay để bắt đầu
Bạn nên kiểm thử bằng các phương thức sau:
ListChildAccounts
ListChildAccounts là lệnh gọi chỉ có thể đọc, liệt kê tất cả các miền CSS (nếu được gọi cho một Nhóm CSS) hoặc Người bán (nếu được gọi cho một miền CSS). Do đó, đây là một phương pháp hay để kiểm tra xem mọi thứ đã được thiết lập chính xác hay chưa.
Chèn/Liệt kê/Cập nhật/Xoá sản phẩm
Sau khi bạn biết rằng API đó hoạt động, hãy thử thêm một sản phẩm. Hãy nhớ sử dụng một raw_provided_id mà bạn nhớ.
- Chèn một sản phẩm thử nghiệm bằng cách sử dụng InsertCssProductInput. Chúng tôi có mã mẫu nếu bạn cần trợ giúp về những thuộc tính cần gửi.
- Liệt kê tất cả sản phẩm bằng cách sử dụng ListCssProducts. Có một độ trễ nhỏ trong quá trình xử lý trước khi sản phẩm xuất hiện sau khi chèn, vì vậy, nếu bạn không thấy sản phẩm, hãy thử lại sau vài giây.
- Cập nhật một sản phẩm bằng cách sử dụng UpdateCssProductInput thông qua
cssproductinput.name. Bạn chỉ cần gửi các thuộc tính cần cập nhật. Tham khảo mã mẫu tại đây. - Xoá sản phẩm kiểm thử bằng cách sử dụng DeleteCssProductInput.
Bạn sẽ cần sử dụng
raw_provided_id.
Sử dụng Async để cải thiện hiệu suất
CSS API được thiết kế cho các lệnh gọi song song. Bạn sẽ thấy hiệu suất của các thao tác đơn lẻ có thể chậm, nhưng sẽ nhanh hơn nhiều khi gọi cùng một thao tác nhiều lần song song. Cách tốt nhất để sử dụng tính năng này là sử dụng chức năng không đồng bộ của ngôn ngữ lập trình.
Ví dụ về một số ngôn ngữ lập trình:
- Đối với Java, hãy sử dụng insertCssProductInputCallable().futureCall()
- Đối với Python, hãy sử dụng CssProductInputsServiceAsyncClient
- Đối với C#, hãy sử dụng InsertCssProductInputAsync
Tìm và sử dụng chức năng Async của ngôn ngữ lập trình để chèn nhiều sản phẩm cùng một lúc. Bạn không cần lo lắng về việc quá tải hệ thống của chúng tôi – đó là lý do chúng tôi đặt ra hạn mức hạn mức.
Bạn có thể xem thêm thông tin chi tiết trên trang hiệu suất của chúng tôi.
Cập nhật sản phẩm
Sau khi được tải lên, sản phẩm sẽ vẫn nằm trong hệ thống của chúng tôi cho đến khi được cập nhật, xoá hoặc hết hạn.
- Bạn có thể cập nhật toàn bộ sản phẩm bằng cách gửi lại yêu cầu
InsertCssProductInput, sử dụng cùng mộtraw_provided_idmà bạn đã sử dụng ban đầu. Hiện tại, bạn cần gửi toàn bộ dữ liệu sản phẩm, ngay cả khi chỉ một số thuộc tính (có thể chỉ là giá/khả năng cung cấp) thay đổi. - Bạn có thể cập nhật một số phần của sản phẩm bằng phương thức PATCH
UpdateCssProductInput, chỉ định tên sản phẩm và nội dung JSON chứa dữ liệu bạn muốn cập nhật cho sản phẩm. Không giống nhưInsertCssProductInput, yêu cầu bạn phải cung cấp tất cả các trường có thể áp dụng,UpdateCssProductInputchỉ yêu cầu bạn chỉ định các trường mà bạn muốn thay đổi. - Bạn có thể xoá một sản phẩm bằng cách gọi
DeleteCssProductInputbằng cùng mộtraw_provided_id. - Sản phẩm sẽ tự động hết hạn khoảng một tháng sau lần cập nhật gần đây nhất.
Chế độ hoạt động liên tục
Chế độ hoạt động liên tục có thể có dạng như sau:
- Sử dụng mã nhận dạng nội bộ của riêng bạn làm
raw_provided_id. - Tải tất cả sản phẩm lên lại theo lịch trình đều đặn, có thể là hằng tuần. Điều này sẽ đảm bảo rằng các sản phẩm đang hoạt động không hết hạn.
- Cập nhật từng sản phẩm ngay khi bạn nhận được dữ liệu đã thay đổi từ người bán.
- Nếu bạn không thể phản ứng ngay lập tức với các thay đổi, hãy thường xuyên tìm tất cả sản phẩm đã thay đổi (có thể là hằng giờ) và chỉ tải lại những sản phẩm đó lên.
- Đối với các sản phẩm không còn hàng, bạn có thể sử dụng lệnh gọi xoá hoặc đặt số lượng mặt hàng còn hàng thành 0.
- Đừng gửi cho chúng tôi những sản phẩm không thay đổi thường xuyên. Các lệnh gọi này sẽ được tính vào hạn mức API của bạn. Bạn chỉ cần làm mới hằng tuần là đủ.
Lựa chọn ưu đãi trên tiêu đề
Ưu đãi trên tiêu đề không nhất thiết phải là ưu đãi hàng đầu hoặc ưu đãi rẻ nhất trên trang web của bạn, nhưng phải được giới thiệu nổi bật. Bạn có thể sử dụng tính năng này trong trường hợp ưu đãi hàng đầu của bạn thay đổi nhanh chóng: Tại đây, bạn có thể chọn một ưu đãi khác ổn định hơn.
Thỉnh thoảng kiểm tra lại tài liệu này
Chúng tôi đã nhận được ý kiến phản hồi về cách cải thiện API này và đang nỗ lực cung cấp một số điểm cải tiến này. Trang này sẽ được cập nhật khi chúng tôi có các tính năng mới giúp đơn giản hoá việc sử dụng API CSS.