Popularity
2.3
Declining
Activity
0.0
Stable
15
1
1

Monthly Downloads: 0
Programming language: Protocol Buffer
License: MIT License
Tags: Third Party APIs    
Latest version: v0.1.5

explay alternatives and similar packages

Based on the "Third Party APIs" category.
Alternatively, view explay alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of explay or a related project?

Add another 'Third Party APIs' Package

README

ExPlay

Google Play (Android Market) API in Elixir :computer:

(Ported from node-google-play)

Installation

Add explay to your list of dependencies in mix.exs:

def deps do
  [{:explay, "~> 0.1.5"}]
end

Install JS Dependency

Right now, there isn't an erlang/elixir implementation of Google's Protobuf library that can decode v2 data correctly, so we're relying on the npm module protobufjs. In your project's root, run:

npm init
npm install protobufjs --save

or if you prefer yarn:

yarn add protobufjs

Usage

There are a lot of modules, each handling their own relevant API calls, but you need to be concerned with only two:

  • ExPlay.Account
  • ExPlay.Request

Authentication

To interact with the Google Play API and get back data, you need a valid and authenticated Google account (with email, password and device id).

# Save this account object to later use in API requests

account = %ExPlay.Account{email: "[email protected]", password: "12345678", device_id: "XXXXXXXX"}
account = ExPlay.Account.authenticate!(account)

Get App Details

{:ok, app} = ExPlay.Request.package_details(account, "com.facebook.katana")

app.title
# => "Facebook"

app.descriptionHtml
# => "Keeping up with friends is faster than ever..."

app.details.appDetails.numDownloads
# => "1,000,000,000+ downloads"

app.details.appDetails.versionCode
# => 41212272

# And lots of other stuff. Use Map.keys(app) to get an idea of the response.

Get App Delivery Data

You can get an app's delivery data using ExPlay.Request.package_download_info/2. It will return a map with a downloadable APK url and authorization cookies which you can pass to any HTTP client to download the APK (Even wget or curl).

Note: The package here can be the app's bundle identifier string or a {bundle, version} tuple.

{:ok, info} = ExPlay.Request.package_download_info(account, "com.facebook.katana")

info.downloadUrl
# => "https://play.googlezip.net/market/download/Download?packageName=com.facebook.katana&versionCode=41212272&ssl..."

info.downloadAuthCookie
# => [%{"name" => "MarketDA", "value" => "09919279757374609811"}]

Download APK

Alternatively, you can let ExPlay download the app for you. Specify the package you want to download and a (writable) path where you'd like to save it.

Note: The package here can be the app's bundle identifier string or a {bundle, version} tuple.

ExPlay.Request.download!(account, "com.facebook.katana", "/tmp/facebook.apk")
# => :ok

Roadmap

  • [ ] Write missing Tests
  • [x] Write Documentation
  • [ ] Update documentation with more information and examples
  • [ ] Implement pure Erlang/Elixir Protobuf v2 solution for decoding data
  • [ ] Cover all API calls
    • [x] Authentication
    • [x] Package Details
    • [ ] Bulk Package Details
    • [ ] Search Apps
    • [ ] Related Apps
    • [ ] Categories
    • [ ] App Reviews
    • [x] Download App
    • [ ] Download App Data

Contributing

  • Fork, Enhance, Send PR
  • Lock issues with any bugs or feature requests
  • Implement something from Roadmap
  • Spread the word

License

This package is available as open source under the terms of the MIT License.


*Note that all licence references and agreements mentioned in the explay README section above are relevant to that project's source code only.