Làm quen với CSS API

Sau đây là cách sử dụng CSS API:

Quyền

Để sử dụng CSS API, bạn cần định cấu hình quyền ở hai nơi: Google Cloud và CSS Center.

  1. IAM của Google Cloud:

    • Tạo một tài khoản dịch vụ trong Bảng điều khiển Google Cloud. Hãy làm theo hướng dẫn tương tự như đối với Content API để tạo và tải tệp thông tin đăng nhập JSON xuống. Bước này xác thực tài khoản dịch vụ của bạn với tư cách là một thực thể hợp lệ trên Google Cloud.
    • Nếu đang sử dụng quyền truy cập REST trực tiếp hoặc Thư viện ứng dụng API của Google, bạn cũng cần có một Khoá API được tạo từ Google Cloud Console.

  2. CSS Center:

    • Địa chỉ email của tài khoản dịch vụ (ví dụ: your-service-account-name@your-project-id.iam.gserviceaccount.com) phải được thêm làm người dùng có quyền Quản trị đối với tài khoản CSS Center của bạn. Bước này cho phép tài khoản dịch vụ truy cập và quản lý dữ liệu Trung tâm CSS của bạn.
    • Bạn có thể cấp quyền truy cập ở cấp Nhóm CSS (để truy cập vào tất cả các miền) hoặc cho các tài khoản Miền CSS cụ thể. Đối với quyền truy cập vào API, việc cấp quyền truy cập ở cấp Nhóm CSS là điều thường thấy.
    • Cách thêm tài khoản dịch vụ:
      • Đăng nhập vào CSS Center bằng tài khoản người dùng quản trị.
      • Chuyển đến mục Quyền truy cập vào tài khoản (trong biểu tượng bánh răng ⚙️).
      • Nhấp vào + Thêm người dùng rồi nhập email của tài khoản dịch vụ.
      • Đặt cấp truy cập thành Quản trị viên.
    • Có thể mất đến 30 phút thì các quyền mới có hiệu lực. Nếu bạn gặp lỗi về quyền, hãy thử lại sau.

Phạm vi xác thực:

Phạm vi OAuth 2.0 bắt buộc đối với CSS API là:

  • https://www.googleapis.com/auth/content

Xác minh rằng ứng dụng của bạn yêu cầu phạm vi này khi xác thực.

Bật CSS API

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

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

CSS API 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ó một trang về 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 mà lệnh gọi của bạn tác động đến.

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

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

Sau đây là cách xoá một tài nguyên bằng REST:

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

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

Sử dụng gRPC hoặc REST

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

gRPC (nên dùng) REST
  1. Tạo nội dung yêu cầu dưới dạng vùng đệm giao thức.
  2. Gửi phần 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 thành vùng đệm giao thức.
  4. Diễn giải kết quả.
  1. Tạo nội dung yêu cầu dưới dạng đối tượng JSON.
  2. Gửi mã này đến máy chủ bằng HTTP 1.1.
  3. Giải tuần tự hoá phản hồi dưới dạng một đố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 mọi vấn đề.

Dưới đây là cách bạn có thể cung cấp thêm ý kiến phản hồi nếu 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:

  • Các tính năng của API: Gửi biểu mẫu phản hồi
  • Tài liệu: Sử dụng nút đánh giá bằng biểu tượng ngón tay cái trên trang và nút Gửi ý kiến phản hồi.
  • Mẫu và thư viện: Sử dụng nút Vấn đề mới trên GitHub.

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

Trước
Tổng quan
Tiếp
Các phương pháp hay nhất