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