Làm quen với CSS API

Dưới đây là cách sử dụng CSS API:

Quyền

Tạo một tài khoản dịch vụ trong Bảng điều khiển API của Google tương tự như thời gian hướng dẫn về Content API rồi tải tệp JSON chứa thông tin đăng nhập đó xuống.

Nếu bạn muốn truy cập vào tài liệu dịch vụ (chỉ cần thiết để truy cập trực tiếp vào REST hoặc cho thư viện Ứng dụng API của Google), bạn cũng cần tạo và hãy sử dụng khoá API. Bạn có thể làm việc đó trong Bảng điều khiển API của Google. Bạn có thể tìm thêm thông tin trong tài liệu chung về Khoá API.

Bạn cần thêm địa chỉ email của tài khoản dịch vụ đó có Quyền quản trị các quyền đối với nhóm Dịch vụ so sánh giá hoặc tài khoản miền của bạn. Việc lan truyền những có thể mất nửa giờ nên hãy thử lại sau nếu bạn nhận được lỗi bị từ chối quyền.

Bật CSS API

Để sử dụng CSS API, bạn cần bật API này trong Google Cloud dự án. Bạn có thể tìm thấy thư viện tại https://console.cloud.google.com/apis/library/css.googleapis.com.

Bắt đầu lập trình

CSS API có các mã mẫu, và thư viện ứng dụng để giúp bạn bắt đầu. Chúng tôi cũng có các phương pháp hay nhất.

Gửi yêu cầu

Gửi yêu cầu đến các URL theo định dạng sau:

https://css.googleapis.com/{version}/{resource name}:{method}

Trong đó {resource name} là tên của tài nguyên tác động đến cuộc gọi của bạn.

Ví dụ: dưới đây là cách xoá tài nguyên bằng gRPC:

https://css.googleapis.com/v1/{resource name}:delete

Dưới đây là cách xoá tài nguyên bằng REST:

DELETE https://css.googleapis.com/v1/{resource name}

Xem CSS API tài liệu tham khảo để biết thêm thông tin về các dịch vụ cụ thể.

Sử dụng gRPC hoặc REST

CSS API hỗ trợ gRPCREST. Sau đây là có 2 cách để thực hiện lệnh gọi CSS API:

gRPC (nên dùng) Kiến trúc chuyển trạng thái đại diện (REST)
  1. Tạo phần nội dung của yêu cầu làm vùng đệm giao thức.
  2. Gửi nội dung yêu cầu đến máy chủ bằng HTTP/2.
  3. Giải tuần tự phản hồi đến vùng đệm giao thức.
  4. Diễn giải kết quả.
  1. Tạo phần nội dung yêu cầu dưới dạng đối tượng JSON.
  2. Gửi yêu cầu đến máy chủ bằng HTTP 1.1.
  3. Giải tuần tự phản hồi dưới dạng đối tượng JSON.
  4. Diễn giải kết quả.

Nhận trợ giúp

Hãy liên hệ với người đại diện của Google để được hỗ trợ hoặc sử dụng biểu mẫu phản hồi để báo cáo vấn đề.

Sau đây là cách gửi thêm ý kiến phản hồi nếu bạn gặp vấn đề:

Gửi ý kiến phản hồi

Để gửi ý kiến phản hồi, hãy gửi một trong những thông tin sau:

  • Tính năng API: Gửi biểu mẫu phản hồi
  • Tài liệu: Dùng điểm xếp hạng thích trên trang và Gửi ý kiến phản hồi .
  • Mẫu và thư viện: Dùng nút New issue (Vấn đề mới) trên GitHub.

Để đưa ra ý kiến phản hồi chung sau khi triển khai mỗi nhiệm vụ, hãy sử dụng ý kiến phản hồi biểu mẫu.