gpapi 6.1.0

A library for interacting with the Google Play API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

<!--- `README.md` is automatically generated from the rustdoc using [`cargo-readme`](https://crates.io/crates/cargo-readme). -->
# `gpapi` - Google Play API for Rust

[![crates.io](https://img.shields.io/crates/v/gpapi.svg)](https://crates.io/crates/gpapi)
[![Documentation](https://docs.rs/gpapi/badge.svg)](https://docs.rs/gpapi)
[![MIT licensed](https://img.shields.io/crates/l/gpapi.svg)](./LICENSE)
[![CI](https://github.com/EFForg/rs-google-play/actions/workflows/ci.yml/badge.svg)](https://github.com/EFForg/rs-google-play/actions/workflows/ci.yml)

A library for interacting with the Google Play API.

## Getting Started

There are two ways to authenticate with the Google Play API:

### Option 1: Using OAuth Token (recommended for personal accounts)

First, obtain an OAuth token by visiting the Google
[embedded setup page](https://accounts.google.com/EmbeddedSetup)
and opening the browser debugging console, logging in, and looking for the `oauth_token` cookie
being set on your browser. It will be present in the last requests being made and start with
"oauth2_4/". Copy this value. It can only be used once, in order to obtain the `aas_token`,
which can be used subsequently. To obtain this token:

```rust
use gpapi::Gpapi;

#[tokio::main]
async fn main() {
    let mut api = Gpapi::new("sm_a13_5g", &email);
    api.request_aas_token(oauth_token).await.unwrap();
    println!("{:?}", api.get_aas_token());
}
```

Now, you can begin interacting with the API by setting the `aas_token` and logging in.

```rust
use gpapi::Gpapi;

#[tokio::main]
async fn main() {
    let mut api = Gpapi::new("px_9a", &email);
    api.set_aas_token(aas_token);
    api.login().await.unwrap();
    // do something
}
```

### Option 2: Using AUTH Token directly (for token dispensers)

If you have an AUTH token (e.g., from Aurora Store's token dispenser), you can use it directly
without going through the OAuth/AAS token flow:

```rust
use gpapi::Gpapi;

#[tokio::main]
async fn main() {
    let mut api = Gpapi::new("px_9a", &email);
    api.set_auth_token(auth_token); // AUTH tokens typically start with "ya29."
    api.login().await.unwrap();
    // do something
}
```

## Downloading Apps

From here, you can get package details, get the info to download a package, or use the library to download it.

```rust
let details = api.details("com.instagram.android").await;
println!("{:?}", details);

let download_info = api.get_download_info("com.instagram.android", None).await;
println!("{:?}", download_info);

api.download("com.instagram.android", None, true, true, true, &Path::new("/tmp/testing"), None).await;
```

## Advanced Options

### Custom Device Properties

If you wish to specify a custom device properties file (e.g. one you've exported from Aurora
Store's spoof manager):

```rust
let mut api = Gpapi::from_device_properties_file("default", &email, "/path/to/device.properties");
```

If multiple devices are specified in the file, replace "default" with the device name you've
specified in the section header.  You can reference the default [device properties file](https://github.com/EFForg/rs-google-play/blob/master/gpapi/device.properties).

## Docs

Documentation for this crate can be found on [docs.rs](https://docs.rs/gpapi/).

## Todo

This inludes some subset, but not all, of the Google Play API library. Some of the functionality  is missing, such as browsing and searching for packages.

## Credits

This library was originally created by David Weinstein, and is currently maintained by Bill Budington.

It follows some of the conventions set by Aurora's [gplayapi java library](https://gitlab.com/AuroraOSS/gplayapi/).

License: MIT