Hướng dẫn tích hợp

Lấy khoá riêng tư

Sử dụng Giao diện tham gia

Để tích hợp với API này, bạn phải tạo một Dự án Google Cloud. Sau đó, hãy 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 khoá theo cách thủ công

Nếu giao diện trên không hoạt động, vui lòng thử làm như sau:

  1. Chuyển đến Google Cloud Console.
  2. Chọn dự án mà bạn sẽ dùng để truy cập vào API.
  3. Trong trình đơn IAM và quản trị ở bên trái, hãy tìm tài khoản dịch vụ rồi tạo một Tài khoản dịch vụ mới 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 khoá riêng tư.

Tài khoản dịch vụ trong danh sách cho phép

Sau khi bạn tạo một 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 là chủ sở hữu của 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 của 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 thông tin ISP của Google. Hãng vận chuyển có thể tạo mối liên kết này bằng cách chuyển đến phần Quyền truy cập vào API.

Bật thư viện

Sau khi bạn thêm vào danh sách cho phép:

  1. Truy cập vào Google Cloud Console.
  2. Đảm bảo bạn đã 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 Mobile Data Plan Sharing API trong Thư viện API.
  4. Bật Preprod Mobile Data Plan Sharing API trong Thư viện API.

Quyền truy cập vào API kiểm thử

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

  1. Cài đặt oauth2l.

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

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

    Xin lưu ý rằng mã 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ã truy cập mới, hãy chạy oauth2l reset để xoá bộ nhớ đệm cục bộ.

  3. Đưa ra các lệnh gọi kiểm thử như sau. YOUR-ASN phải là một trong những ASN mà 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à đầu ra 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 các lệnh gọi được uỷ quyền đến 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ù quá trình thiết lập ban đầu chỉ 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 uỷ quyền sở hữu dự án. Trên Google Cloud Console, trong trình đơn IAM và quản trị, bạn có thể thêm thành viên mới (bao gồm cả tài khoản nhóm Google) làm chủ sở hữu của dự án.