hhy5277 / google-play-crawler

Play with Google Play API :)

Google Play Crawler JAVA API

google-play-crawler is simply for searching android applications on GooglePlay, and also downloading them.

Now you can dowload applications with single click from web to your desktop.

It also has checkin ability to generate ANDROID-ID for you.

While doing checkin with your account, it uses Galaxy S3 properties. So only Galaxy S3 compatible applications will be retrieved. If you try to download incompatible application for Galaxy S3, you will get an exception like this :

"The item you were attempting to purchase could not be found."

Motivated users can add other device properties from here : http://www.glbenchmark.com/phonedetails.jsp?benchmark=glpro25&D=Samsung+GT-I9300+Galaxy+S+III&testgroup=system

This project is available thanks to this project : https://github.com/egirault/googleplay-api.

Take a look at code, it is not that sophisticated..

Building and running

###SBT

Make sure you hava protoc installed (version 2.5!). On OSX:

brew install protobuf

Ubuntu/Debian:

sudo apt-get install protobuf-compiler libprotobuf-java

Install SBT: http://www.scala-sbt.org/release/docs/Getting-Started/Setup.html

To build:

sbt assembly

Note: This will generate the protobuf java files and compile them as part of the project.

###Maven

Install Maven 3 & protobuf compiler (version 2.5!)

sudo apt-get install maven protobuf-compiler libprotobuf-java

And build:

mvn package -Dmaven.test.skip=true

This will ignore the tests and pack for you. If you want to run tests, you need to edit login.conf with your google account credentials.

Usage

Maven Reference

<dependency>
    <groupId>com.akdeniz</groupId>
	<artifactId>googleplaycrawler</artifactId>
	<version>0.2</version>
</dependency>

<repository>
	<id>github.release.repo</id>
	<url>https://raw.github.com/Akdeniz/akdeniz-repo/master/repo/releases/</url>
</repository>

General

java -jar googleplay.jar --help
usage: googleplay [-h] [-f [CONF]] [-i [ANDROIDID]] [-e [EMAIL]]
                  [-p [PASSWORD]] [-t [SECURITYTOKEN]] [-a [HOST]] 
                  [-l [PORT]]
                  {download,checkin,list,categories,search,permissions,reviews,register,usegcm}
                  ...

Play with Google Play API :)

optional arguments:
  -h, --help             show this help message and exit
  -f [CONF], --conf [CONF]
                         Configuration file to used for login! If any of
                         androidid, email and password is supplied, it
                         will be ignored!
  -i [ANDROIDID], --androidid [ANDROIDID]
                         ANDROID-ID to be used! You can use "Checkin"
                         mechanism, if you don't have one!
  -e [EMAIL], --email [EMAIL]
                         Email address to be used for login.
  -p [PASSWORD], --password [PASSWORD]
                         Password to be used for login.
  -t [SECURITYTOKEN], --securitytoken [SECURITYTOKEN]
                        Security token that was generated at checkin. It
                        is only required for "usegcm" option
  -a [HOST], --host [HOST]
                         Proxy host
  -l [PORT], --port [PORT]
                         Proxy port

subcommands:
  Command to be executed.

  {download,checkin,list,categories,search,permissions,reviews,register, usegcm}

Sub-commands

You can get usage of sub-commands like this :

java -jar googleplay.jar list --help
usage: googleplay list [-h] [-s SUBCATEGORY] [-o OFFSET] [-n NUMBER]
                  category

Lists sub-categories and applications within them!

positional arguments:
  category               defines category

optional arguments:
  -h, --help             show this help message and exit
  -s SUBCATEGORY, --subcategory SUBCATEGORY
                         defines sub-category
  -o OFFSET, --offset OFFSET
                         offset to define where list begins
  -n NUMBER, --number NUMBER
                         how many app will be listed

About Login & Proxy Arguments

Login & Proxy arguments (androidid, email, password, host, port) can be defined in a configuration file not to pass them every time in command line. If you don't want to use proxy, just comment proxy host and port!

# Login Information
email = [email protected]
password = xxxxxxxxx
androidid = xxxxxxxxxxxxxxxx
# security token only needed for "usegcm" option
securitytoken = xxxxxxxx

# Proxy Information
host=localhost
port=8888

You can use this file like this:

java -jar googleplay.jar --conf crawler.conf ...

Note that "usegcm" option does not operate on HTTP, so it won't be proxified by this configuration.

About Account Page Registration

To see your chekined device at your account page(https://play.google.com/store/account), you should register it like this:

java -jar googleplay.jar -f crawler.conf register

and download a few application after registration!(same behaviour of android market application!)

Of course this does not allow you to click and download from web page! It is just for information right now!

But I will see if I can simulate Android GCM(Google Cloud Messaging) push-in mechanism when I have time! So stay tuned.. ;)

About "usegcm" Option

You can use usegcm option to download applications from web to your desktop like installing to your phone.

All you have to do register your checkined device as described above and execute google-play-crawler like this:

java -jar googleplay.jar -f crawler.conf usegcm

Now you can login to your account from web browser and try to install any application.

TODO

Add other device properties to use with checkin.. (Tablet,.. etc.)

Simulate Android GCM Push-in mechanism to allow download from web!

License

Copyright (c) 2012, Akdeniz
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met: 

1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer. 
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution. 

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The views and conclusions contained in the software and documentation are those
of the authors and should not be interpreted as representing official policies, 
either expressed or implied, of the FreeBSD Project.