Hướng dẫn cho quá trình tích hợp

Lấy khóa riêng tư

Sử dụng giao diện giới thiệu

Để tích hợp với API này, bạn phải tạo một Dự án Google Cloud. Sau đó, tạo một tài khoản dịch vụ và lấy khoá riêng tư. Để bắt đầu, hãy nhấp vào nút sau:

Tạo tài khoản dịch vụ

Tạo khóa theo cách thủ công

Nếu giao diện trên không thành công, vui lòng thử các cách sau:

  1. Truy cập vào Google Cloud Console.
  2. Chọn dự án sử dụng API đó để truy cập.
  3. Trong trình đơn quản trị và amp &IAM ở bên trái, hãy tìm tài khoản dịch vụ và tạo một Tài khoản dịch vụ mới. Tài khoản này sẽ là chủ sở hữu của dự án.
  4. Sau khi tạo tài khoản dịch vụ, bạn sẽ nhận được một khóa riêng tư.

Đưa tài khoản dịch vụ vào danh sách cho phép

Sau khi tạo tài khoản dịch vụ:

  1. Liên hệ với nhóm GTAF theo địa chỉ mdp-support@google.com bằng Tài khoản Google (chủ sở hữu dự án). Chúng tôi sẽ đưa Tài khoản Google vào danh sách cho phép để truy cập vào các điểm cuối API Chia sẻ gói dữ liệu di động.
  2. Liên kết tài khoản dịch vụ với nhà mạng trên Cổng Google ISP. Nhà mạng có thể thực hiện việc liên kết này bằng cách chuyển đến phần API Access (Quyền truy cập của API).

Bật thư viện

Sau khi đưa được vào danh sách cho phép, hãy:

  1. Truy cập vào Google Cloud Console.
  2. Hãy nhớ chọn đúng dự án trong trình đơn thả xuống trên thanh trình đơn ở trên cùng.
  3. Bật API Chia sẻ gói dữ liệu di động trong Thư viện API.
  4. Bật API Sản xuất chia sẻ gói dữ liệu di động Preprod trong Thư viện API.

Kiểm tra quyền truy cập API

Cách kiểm tra quyền truy cập của bạn vào các phương thức phụ của Google:

  1. Cài đặt oauth2l.

  2. Lấy mã truy cập cho tài khoản dịch vụ như sau. your-service-account-key-file.json là một tệp khoá của tài khoản dịch vụ của bạn.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    Xin lưu ý rằng mã thông báo truy cập sẽ hết hạn sau khoảng một giờ. Trước khi bạn chạy lại lệnh trên cho mã thông báo truy cập mới, hãy chạy oauth2l reset để xoá bộ nhớ đệm cục bộ.

  3. Phát hành cuộc gọi thử nghiệm như sau. YOUR-ASN phải là một trong các ASN bạn gửi cho chúng tôi khi chúng tôi định cấu hình GTAF trong quá trình tích hợp. ACCESS-TOKEN-OBTAINED là kết quả của lệnh oauth2l fetch trên. PLAN_STATUS là nội dung yêu cầu PlanStatus mà bạn muốn gửi đến GTAF.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

Lệnh gọi API có lập trình

Làm theo hướng dẫn để thực hiện lệnh gọi được ủy quyền tới các phương thức phía Google, với phạm vi OAuth sau:

https://www.googleapis.com/auth/dataplansharing

Chia sẻ quyền sở hữu dự án

Mặc dù việc thiết lập ban đầu liên quan đến một Tài khoản Google, nhưng bạn nên để một nhóm người dùng được ủy quyền có quyền sở hữu dự án. Trên Google Cloud Console, trong trình đơn quản trị và quản lý danh tính và quyền truy cập (IAM), bạn có thể thêm thành viên mới (bao gồm cả tài khoản nhóm của Google) làm chủ sở hữu của dự án.