Removed documentation folder

It will be reorganized as a Wiki on GitHub
This commit is contained in:
Domenico Iezzi 2019-01-23 14:35:16 +01:00
parent 23b83ad81a
commit 6ca31cc1d2
7 changed files with 0 additions and 2346 deletions

View File

@ -1,13 +0,0 @@
# Documentation
This is a collection of API requests and response for most of the
paths that google play API offers. In general, each requests
usually return the following protobuf objects:
- *payload*: contains the response object
(see `googleplay.proto` for all types of responses).
- (optional) *preFetch*: if the payload contains an URL to be fetched
in order to get results, these results may be pre-fetched by google
servers and included in the original response.
Each requests is discussed in the related subfolder.

View File

@ -1,48 +0,0 @@
## Auth (with token)
### Details
**URL**
```
POST https://android.clients.google.com/auth HTTP/1.1
```
**HEADERS**
```
device: <hidden_device_id>
app: com.google.android.gms
Accept-Encoding: gzip
User-Agent: GoogleAuth/1.4 (A0001 NJH47F); gzip
content-length: 638
content-type: application/x-www-form-urlencoded
Host: android.clients.google.com
Connection: Keep-Alive
```
**URLEncoded query string**
```
androidId=<hidden>&lang=en_US&google_play_services_version=11509438&sdk_version=25&device_country=it&request_visible_actions=&client_sig=38918a453d07199354f8b19af05ec6562ced5788&callerSig=38918a453d07199354f8b19af05ec6562ced5788&Email=<hidden>&service=oauth2%3Ahttps%3A%2F%2Fwww.googleapis.com%2Fauth%2Fplacesserver&app=com.google.android.gms&check_email=1&token_request_options=CAA4AQ%3D%3D&system_partition=1&callerPkg=com.google.android.gms&Token=<hidden>
```
**URLEncoded parsed**
```
androidId: <hidden>
lang: en_US
google_play_services_version: 11509438
sdk_version: 25
device_country: it
request_visible_actions:
client_sig: 38918a453d07199354f8b19af05ec6562ced5788
callerSig: 38918a453d07199354f8b19af05ec6562ced5788
Email: <hidden>
service: oauth2:https://www.googleapis.com/auth/placesserver
app: com.google.android.gms
check_email: 1
token_request_options: CAA4AQ==
system_partition: 1
callerPkg: com.google.android.gms
Token: <hidden>
```
### Notes
TODO

View File

@ -1,37 +0,0 @@
## Download ( /fdfe/delivery )
### Details
**URL**
```
GET https://android.clients.google.com/fdfe/delivery?doc=com.termux.api&ot=1&st=EP6Gwc0FGc3MvN8QbNZBIhcI35bT8qSL1gIQAxABEAQQAhAGEAoYAg%3D%3D&vc=15&fdcf=1&fdcf=2
```
**PARSED GET PARAMETERS**
```
doc: com.termux.api
ot: 1
st: EP6Gwc0FGc3MvN8QbNZBIhcI35bT8qSL1gIQAxABEAQQAhAGEAoYAg==
vc: 15
fdcf: 1
```
**HEADERS**
```
X-DFE-MCCMNC: 22201
X-DFE-Device-Id: <hidden>
X-DFE-Content-Filters:
X-DFE-Network-Type: 4
X-DFE-Request-Params: timeoutMs=4000
User-Agent: Android-Finsky/8.1.72.S-all [6] [PR] 165478484 (api=3,versionCode=80817206,sdk=25,device=A0001,hardware=bacon,product=bacon,platformVersionRelease=7.1.2,model=A0001,buildId=NJH47F,isWideScreen=0,supportedAbis=armeabi-v7a;armeabi)
X-DFE-Client-Id: am-android-oneplus
Authorization: GoogleLogin auth=<hidden>
Accept-Language: en-US
Host: android.clients.google.com
Connection: Keep-Alive
Accept-Encoding: gzip
```
### Notes
TODO

View File

@ -1,41 +0,0 @@
# Search
## Request
GET https://android.clients.google.com/fdfe/search?c=3&q=firefox HTTP/1.1
Required headers are marked with a '*'
[ ] X-Ad-Id: 70417864-0f86-4451-b5aa-103de27a6af5
[ ] X-DFE-Content-Filters:
[ ] X-DFE-Network-Type: 4
[*] X-DFE-Encoded-Targets: CAESqwGzlYEGDsgF3gTRAkIC2AMCFJIHgAIWjgi1AVhAmQGOA4ICb+kKmAHgAQyGAS9o8gLzAe0BFvsLuAMBAsADjwLDFYUBNS2lCJYStgEBfgegAm2xAgEoAQYo4wvDAtAFqwIB+APWArYDwgHhBf0BjAICU+MGmgGRAZsC0AFMmgPkAuUBKyHOAVIC5QECrwEYAQYBowFLYgGpBYgDhQEBY0o2SqEDggJpYYgDtAMa9gQTAg7OATu1AaABCFoCAwRrN4DTzwKCu7EDAQEDAgQJCAgBAQIIAwEBAgEBAQICAgYBBhQKAQcCAwMEAhABAQHKAQETAwQCDecBfQolAhYFAgEKG3UMMxcBIQoUDwYHIjeEAQ4MFk0JUwV/EREYAQMNfgRfHhQQIwsOcGQEDQ9qowHAAoQBBIQBAgEBfA4ZGDYVARgBCwEoZQICJShzFCehBQYRGg43GBxpjQG0AVnQAR4nCzQmL1vUAWV3CQEK3gF2A30tDAMsZJ4BBIEBdFAfcogBigHMAgUFCc0BBUWgATk4jQIaYDUuzgENcqoBASCLA5IBqAImlwNhrQKEBnbjBfgBXaEBAQ8GAQEChwQEc5YBBlVtAUUB3AUyDnuzAZIBA4YGKxihAQcwASEBBwIgCBIdB6YDOAEaRoQBAfsBQHWnARkiAqMCLBYPvAsDAoABIocBO8kBygG2AQENAyeIAx7bAVKoBIMEqgETKQSLAbIDOhAndFdEOBWjAQGNAfUBGguZAUUMCwgvWwFpGrkBDhEgP3wLuAEhBgIUAb4DFG8TIa4BjgFFBgQCAQECWUKdAmIVBAEUxwESASQLWgoeJQIChAXCAQYjFTISxwFoBSFHEAEBWcsBMU5KkgEW0wGeAQceCDtk6AEGU44CpAHRAZIBC88BegEiTV0HSgQBBLgBDSYIMB0VCwIBed8BLW4DATaWAT0odAwCXztnERRVDSoDCkM/IwfKAgIHXQwCP1Y2bgQM+QICBgcUBREEWCZMAwwUGCRVKlNjHAMGGET/AQwBCwUHBJMBAn8RBx8eTwUqAgsJCw8HFAYECgoWBFoK0wIWMwY
[ ] X-DFE-Cookie: <hidden>
[*] User-Agent: Android-Finsky/8.1.72.S-all [6] [PR] 165478484 (api=3,versionCode=80817206,sdk=25,device=A0001,hardware=bacon,product=bacon,platformVersionRelease=7.1.2,model=A0001,buildId=NJH47F,isWideScreen=0,supportedAbis=armeabi-v7a;armeabi)
[ ] X-DFE-Client-Id: am-android-oneplus
[ ] X-Limit-Ad-Tracking-Enabled: false
[ ] X-DFE-MCCMNC: 22201
[*] X-DFE-Device-Id: <hidden>
[ ] X-DFE-Request-Params: timeoutMs=4000
[*] Accept-Language: en-US
[*] Authorization: GoogleLogin auth=<hidden>
[*] Host: android.clients.google.com
[ ] Connection: Keep-Alive
[ ] Accept-Encoding: gzip
## Notes
Search results can be divided into two categories:
1. Search query is *specific*.
2. Search query is *general*.
In the **(1)** case, the result will contain 4 DocV1 objects
- **doc[0]** contains only one element, which is the specific app (e.g. firefox).
- **doc[1]** corresponds to the `You Might Also Like` section, and contains other less related apps.
- **doc[2]** corresponds to the `Similar Apps` section of the play store, with nearly 20 apps.
- **doc[3]** corresponds to the `More Result` section, with nearly 20 apps related to the search query.
You can verify this behaviour by yourself reading the `search-response-specific.txt`, where the query was `firefox`.
In the **(2)** case, the results contains only 1 DocV1 objects, with at most 21-22 apps. There is also a *containerMetadata* object with the URL for the next page of results.

File diff suppressed because it is too large Load Diff

View File

@ -1,21 +0,0 @@
# userProfile
## Request
GET https://android.clients.google.com/fdfe/api/userProfile HTTP/1.1
Required headers are marked with a '*'
[ ] X-DFE-MCCMNC: 22201
[ ] X-DFE-Logging-Id:
[*] X-DFE-Device-Id: <hidden>
[ ] X-DFE-Request-Params: timeoutMs=8000
[*] User-Agent: Android-com.android.vending/8.4.19.V-all%20%5B0%5D%20%5BFP%5D%20175058788 (api=4,versionCode=80841900,sdk=25,device=A0001,hardware=bacon,product=bacon)
[*] X-DFE-Client-Id: am-android-oneplus
[*] Authorization: GoogleLogin auth=<hidden>
[*] Accept-Language: it-IT
[*] Host: android.clients.google.com
[ ] Connection: Keep-Alive
[ ] Accept-Encoding: gzip
## Notes