Bắt đầu sử dụng Dịch vụ so sánh giá (CSS)

Thực hiện các thao tác cơ bản bằng API là một cách hay để bắt đầu sử dụng API này.

Điều kiện tiên quyết

Trước khi bắt đầu, hãy hoàn thành các bước sau:

  • Đảm bảo rằng bạn có một tài khoản CSS Center hợp lệ.
  • Đăng ký nhà phát triển API.
  • Xác minh tính chính xác của chế độ thiết lập quyền.
  • Xác minh rằng bạn đã bật CSS API.
  • Xác minh rằng bạn đã cài đặt các thư viện ứng dụng cho môi trường của mình.

Để biết thêm thông tin, hãy xem phần Bắt đầu nhanh.

Bật CSS API

Để đăng ký làm nhà phát triển sử dụng CSS API, bạn phải liên kết tài khoản CSS Center và dự án Google Cloud bằng phương thức Đăng ký nhà phát triển, như sau:

Liên kết CSS Center và dự án Google Cloud của bạn: Mối liên kết sẽ được thiết lập tự động, vì phương thức gọi có quyền truy cập vào dự án Google Cloud dựa trên Mã truy cập hoặc khoá API, đồng thời là người dùng được uỷ quyền của tài khoản CSS Center.

Đăng ký nhà phát triển API

Thêm người dùng nhà phát triển API vào tài khoản CSS Center: Nếu người dùng đã tồn tại, họ sẽ chỉ được cấp loại quyền truy cập "Nhà phát triển API" mới. Trong trường hợp là người dùng mới, họ sẽ nhận được lời mời qua email từ CSS Center.

Sau khi đăng ký, bạn có thể xem Trạng thái đăng ký bằng cách sử dụng GetDeveloperRegistration hoặc huỷ đăng ký bằng cách sử dụng UnregisterGCP. Bạn có thể sử dụng lệnh gọi đăng ký sau:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

Sau khi yêu cầu chạy thành công, hãy chờ phản hồi:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

Sản phẩm CSS

Tương tự như API phụ Products, CSS API phân biệt giữa CssProductInput và ListCssProduct. Chèn một sản phẩm bằng InsertCssProductInput.

Sau khi hệ thống nội bộ của chúng tôi xử lý sản phẩm (có thể mất vài phút), hãy truy xuất sản phẩm đó bằng ListCssProducts.

Xác định sản phẩm bằng raw_provided_id. Bạn nên sử dụng một mã nhận dạng mà bạn đang dùng trong hệ thống của riêng mình. Ngoài ra, các phương thức phổ biến để tạo một phương thức bao gồm việc sử dụng một trong những phương thức sau:

  • Giá trị nhận dạng duy nhất trên toàn cầu (GUID)
  • Giá trị nhận dạng duy nhất trên toàn cầu (UUID)
  • Thuộc tính sản phẩm riêng biệt được kết hợp (ví dụ: thương hiệu_mẫu_màu_kích thước)

Để biết thêm thông tin, hãy xem phần Chèn/Liệt kê/Cập nhật/Xoá một sản phẩm.

Các thao tác cơ bản

Sau đây là một số yêu cầu cơ bản mà bạn có thể thử.

  1. Chèn một sản phẩm kiểm thử bằng cách sử dụng InsertCssProductInput. Để biết thông tin trợ giúp về các thuộc tính cần gửi, hãy xem mã mẫu này.

  2. Liệt kê tất cả sản phẩm bằng cách sử dụng ListCssProducts. Xin lưu ý rằng có một chút chậm trễ trong quá trình xử lý giữa thời điểm bạn chèn một sản phẩm và thời điểm sản phẩm đó xuất hiện trong trang thông tin. Nếu bạn không thấy mã nào ngay lập tức, hãy thử lại sau vài giây.

  3. 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 những thuộc tính cần cập nhật. Để biết ví dụ, hãy xem mã mẫu.

  4. Xoá sản phẩm kiểm thử bằng cách sử dụng DeleteCssProductInpu, cung cấp raw_provided_id.

Các điểm hạn chế

Việc chèn hoặc xoá từng sản phẩm có thể mất nhiều thời gian. Để cải thiện hiệu suất, hãy Sử dụng Async để cải thiện hiệu suất. Điều này cho phép gọi API song song.

Liệt kê và gắn nhãn tài khoản

Tính năng Quản lý nhãn trong CSS API cho phép bạn lập trình để sắp xếp các tài khoản Merchant Center của khách hàng bằng cách sử dụng thẻ tuỳ chỉnh. Tính năng này giúp bạn phân loại khách hàng một cách hiệu quả (ví dụ: theo loại hoặc chiến lược), nhờ đó, bạn có thể sắp xếp và tinh giản các hoạt động một cách hiệu quả hơn. Bạn có thể dùng API này để thực hiện các chức năng sau trên nhãn: