https://github.com/yeriomin/play-store-api
Google Play Store protobuf API wrapper in java
https://github.com/yeriomin/play-store-api
api-wrapper floss google google-play-store play-store playstore protobuf protobuf-java
Last synced: 24 days ago
JSON representation
Google Play Store protobuf API wrapper in java
- Host: GitHub
- URL: https://github.com/yeriomin/play-store-api
- Owner: yeriomin
- License: gpl-3.0
- Created: 2016-12-17T02:56:22.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2020-11-16T05:41:15.000Z (over 4 years ago)
- Last Synced: 2025-03-30T16:12:20.250Z (about 1 month ago)
- Topics: api-wrapper, floss, google, google-play-store, play-store, playstore, protobuf, protobuf-java
- Language: Java
- Size: 7.33 MB
- Stars: 331
- Watchers: 44
- Forks: 131
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# play-store-api [](https://travis-ci.org/yeriomin/play-store-api) [](https://jitpack.io/#yeriomin/play-store-api) [](https://jitpack.io/#yeriomin/play-store-api)
Google Play Store protobuf API wrapper in java
## Include
Get it from [jitpack](https://jitpack.io/#yeriomin/play-store-api). Or...
## Build separately
git clone https://github.com/yeriomin/play-store-api
gradlew :assemble
gradlew :build
Protobuf classes generation happens on `assemble` step, tests a ran on `build` step.
## Usage
### First login
```java
// A device definition is required to log in
// See resources for a list of available devices
Properties properties = new Properties();
try {
properties.load(getClass().getClassLoader().getSystemResourceAsStream("device-honami.properties"));
} catch (IOException e) {
System.out.println("device-honami.properties not found");
return null;
}
PropertiesDeviceInfoProvider deviceInfoProvider = new PropertiesDeviceInfoProvider();
deviceInfoProvider.setProperties(properties);
deviceInfoProvider.setLocaleString(Locale.ENGLISH.toString());
// Provide valid google account info
PlayStoreApiBuilder builder = new PlayStoreApiBuilder()
// Extend HttpClientAdapter using a http library of your choice
.setHttpClient(new HttpClientAdapterImplementation())
.setDeviceInfoProvider(deviceInfoProvider)
.setEmail(email)
.setPassword(password)
;
GooglePlayAPI api = builder.build();
// We are logged in now
// Save and reuse the generated auth token and gsf id,
// unless you want to get banned for frequent relogins
api.getToken();
api.getGsfId();
// API wrapper instance is ready
DetailsResponse response = api.details("com.cpuid.cpu_z");
```
### Further logins
```java
// A device definition is required for routine requests too
// See resources for a list of available devices
Properties properties = new Properties();
try {
properties.load(getClass().getClassLoader().getSystemResourceAsStream("device-honami.properties"));
} catch (IOException e) {
System.out.println("device-honami.properties not found");
return null;
}
PropertiesDeviceInfoProvider deviceInfoProvider = new PropertiesDeviceInfoProvider();
deviceInfoProvider.setProperties(properties);
deviceInfoProvider.setLocaleString(Locale.ENGLISH.toString());
// Provide auth token and gsf id you previously saved
PlayStoreApiBuilder builder = new PlayStoreApiBuilder()
// Extend HttpClientAdapter using a http library of your choice
.setHttpClient(new HttpClientAdapterImplementation())
.setDeviceInfoProvider(deviceInfoProvider)
.setToken(token)
.setGsfId(gsfId)
;
GooglePlayAPI api = builder.build();
// API wrapper instance is ready
DetailsResponse response = api.details("com.cpuid.cpu_z");
```
### Examples
See [tests](https://github.com/yeriomin/play-store-api/blob/master/src/test/java/com/github/yeriomin/playstoreapi/GooglePlayAPITest.java) and [the project which this library was made for](https://github.com/yeriomin/YalpStore) for examples.
### Further studies
Looking through [GooglePlay.proto](https://github.com/yeriomin/play-store-api/blob/master/src/main/proto/GooglePlay.proto) will let you know what responses to expect.
## License
play-store-api is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
## Credits
play-store-api is a fork of https://github.com/Akdeniz/google-play-crawler
play-store-api has [protobuf-java](https://mvnrepository.com/artifact/com.google.protobuf/protobuf-java) built-in. protobuf-java was modified to work with java 1.5 which is required for play-store-api to work on old android versions.