Trước khi có thể bắt đầu thực hiện lệnh gọi API, bạn cần thiết lập quyền truy cập API vào Tài khoản nhà phát triển của mình trên Google Play. Việc này liên quan đến những thay đổi trong cả Google Play Console và Google Cloud Console. Các hướng dẫn sau đây giải thích các bước cần thiết để bắt đầu sử dụng API Nhà phát triển Google Play.
- Tạo một dự án trên Google Cloud.
- Bật Google Play Developer API cho Dự án Google Cloud của bạn.
- Thiết lập một tài khoản dịch vụ có các quyền thích hợp trên Google Play Console để truy cập vào Google Play Developer API.
Tạo một dự án trên Google Cloud
Bạn có thể bỏ qua bước này nếu đã có một Dự án trên Google Cloud mà bạn muốn sử dụng.
Tạo một dự án trong Google Cloud Console.
Để biết thêm thông tin về Dự án trên Google Cloud, hãy tham khảo bài viết Tạo và quản lý dự án.
Bật API
Sau khi thiết lập Dự án Google Cloud, bạn cần bật API Nhà phát triển Google Play cho dự án này.
Cách bật API Nhà phát triển Google Play:
- Truy cập vào trang Google Play Developer API trong Google Cloud Console.
- Nhấp vào Bật.
Định cấu hình OAuth và Tài khoản dịch vụ
Bạn cần định cấu hình quyền truy cập vào Google Play Developer API bằng ứng dụng OAuth hoặc tài khoản dịch vụ. Trong hầu hết các trường hợp, bạn nên sử dụng tài khoản dịch vụ để truy cập API.
Bạn phải sử dụng tài khoản dịch vụ trong một môi trường an toàn, chẳng hạn như máy chủ của bạn. Bạn cần quản lý thông tin đăng nhập của tài khoản dịch vụ một cách an toàn để không ai có quyền sử dụng API biết được.
Bạn nên sử dụng mã ứng dụng OAuth nếu cần truy cập vào API thay cho một người dùng cá nhân. Ví dụ: nếu trang web của bạn cần truy cập vào API Nhà phát triển Google Play từ ứng dụng web thay mặt cho người dùng, thì bạn có thể sử dụng Mã ứng dụng. Người dùng sẽ được xác thực bằng Tài khoản Google của họ thay vì tài khoản dịch vụ. Điều này cho phép bạn thực hiện các lệnh gọi API thay mặt cho người dùng mà không làm lộ thông tin đăng nhập tài khoản dịch vụ.
- Tài khoản dịch vụ: Một dịch vụ phần mềm bảo mật sẽ truy cập vào API (phổ biến nhất)
- Ứng dụng OAuth: Người dùng sẽ truy cập vào API
Sử dụng tài khoản dịch vụ
Bạn có thể tạo một tài khoản dịch vụ trong Google Play Console.
- Trong Google Cloud Console, hãy chuyển đến phần Tài khoản dịch vụ.
- Nhấp vào Tạo tài khoản dịch vụ rồi làm theo các bước.
- Chuyển đến trang Người dùng và quyền trên Google Play Console.
- Nhấp vào Mời người dùng mới.
Nhập địa chỉ email cho tài khoản dịch vụ của bạn vào trường địa chỉ email và cấp các quyền cần thiết để thực hiện hành động.
Để sử dụng Google Play Billing API, bạn phải cấp các quyền sau:
- Xem dữ liệu tài chính, đơn đặt hàng, cũng như phản hồi trong bản khảo sát về quyết định huỷ đăng ký
- Quản lý đơn đặt hàng và gói thuê bao
Nhấp vào Mời người dùng.
Tại thời điểm này, bạn sẽ có thể truy cập vào API Nhà phát triển Google Play thông qua tài khoản dịch vụ. Để biết thêm thông tin, hãy xem bài viết Sử dụng OAuth 2.0 cho các ứng dụng từ máy chủ đến máy chủ.
Sử dụng ứng dụng OAuth
Bạn có thể cho phép người dùng thực hiện các thao tác bằng API trong thông tin xác thực của riêng họ bằng cách sử dụng ứng dụng OAuth. Hành động của người dùng chỉ giới hạn trong những hành động được cấp quyền thông qua trang Người dùng và quyền trên Google Play Console.
Trước khi tạo ứng dụng OAuth, bạn cần định cấu hình thông tin thương hiệu cho sản phẩm của mình. Để biết thêm thông tin, hãy xem bài viết Thiết lập màn hình đồng ý OAuth.
- Trong Google Cloud Console, hãy chuyển đến trang Màn hình đồng ý OAuth.
- Làm theo các bước để tạo màn hình đồng ý OAuth.
Cách tạo ứng dụng OAuth:
- Trong Google Cloud Console, hãy chuyển đến phần Thông tin đăng nhập.
- Nhấp vào Tạo thông tin xác thực > Mã ứng dụng OAuth.
- Chọn loại đơn đăng ký của bạn rồi làm theo hướng dẫn.
Thông tin khác
Hãy sử dụng các mẹo và thủ thuật sau để giúp bạn bắt đầu sử dụng API trên Google Play.
Lấy mã nhà phát triển
Một số API yêu cầu bạn cung cấp Mã nhận dạng nhà phát triển Google Play Console. Đây là một dãy số dài được chỉ định khi bạn tạo Tài khoản nhà phát triển trên Google Play. Bạn có thể tìm thấy Mã nhận dạng nhà phát triển trong URL của hầu hết mọi trang trên Google Play Console, chẳng hạn như trang Quyền truy cập API.
Ví dụ: hãy xem xét URL của Google Play Console:
https://play.google.com/console/developers/1234567890123456789/api-access
Trong URL ở trên, Mã nhận dạng nhà phát triển sẽ là 1234567890123456789.
Lưu ý: Nếu một ứng dụng được chuyển từ Tài khoản nhà phát triển trên Google Play này sang một tài khoản khác, thì Mã nhà phát triển liên kết với ứng dụng đó sẽ thay đổi. Điều này có nghĩa là sau khi hoàn tất việc chuyển, bạn phải sử dụng Mã nhận dạng nhà phát triển cho tài khoản Google Play Developer Account mới trong các lệnh gọi API cho ứng dụng đó.
API chuyên biệt
API Nhà phát triển Google Play chứa một số API chuyên biệt cho phép bạn thực hiện các loại phân tích cụ thể trên ứng dụng của mình:
- Reply to Reviews API
- Cho phép bạn xem ý kiến phản hồi của người dùng về ứng dụng của mình và trả lời ý kiến phản hồi này.
- Voided Purchases API
- Cho phép bạn thu hồi quyền truy cập vào các sản phẩm trong ứng dụng liên kết với các giao dịch mua mà người dùng đã vô hiệu.
Thư viện ứng dụng
Chúng tôi đã cung cấp các thư viện ứng dụng mà bạn có thể dùng để truy cập vào các API REST theo phương thức lập trình. Để biết thêm thông tin, hãy xem phần Thư viện ứng dụng và mã mẫu.