README.md

App Store Connect

A Ruby interface to the App Store Connect API

Installation

Add this line to your application's Gemfile:

gem 'app_store_connect'

And then execute:

$ bundle

Or install it yourself as:

$ gem install app_store_connect

Usage

AppStoreConnect.config = {
  issuer_id: 'issuer_id',
  key_id: 'key_id',
  private_key: File.read(File.new("/Path/AuthKey.p8"))
}

app_store_connect = AppStoreConnect::Client.new

app_store_connect.apps 
app_store_connect.app(id: '1234')
app_store_connect.builds(id: '1234')

Create Bundle ID

app_store_connect.create_bundle_id(
  name: 'Example', 
  identifier: 'com.kyledecot.Example', 
  platform: 'IOS'
) 

Sales Reports

app_store_connect.sales_reports(
  filter: {
    report_type: 'SALES',
    report_sub_type: 'SUMMARY',
    frequency: 'DAILY',
    vendor_number: '123456'
  }
)

Fetch All Devices

fetchAllDevices = app_store_connect.devices
puts JSON.pretty_generate(fetchAllDevice)

Register a New Device

result = app_store_connect.create_device(
    name: 'name',
    platform: 'IOS',
    udid: 'udid'
  )

puts JSON.pretty_generate(result)

Update an App Store Version

app_store_connect.update_app_store_version id: '<app-store-version-id>', version_string: '1.0'

Link a Build to an App Store Version

app_store_connect.update_app_store_version_build id: '<app-store-version-id>', build_id: '<build-id>'

Create a Review Submission Item

app_store_connect.create_review_submission_item relationships: {reviewSubmission: {data: {id: '<review-submission-id>', type: 'reviewSubmissions'}},
                                                                appStoreVersion: {data: {id: '<app-store-version-id>', type: 'appStoreVersions'}}}

Q&A

How to understand the devices, sales_reports, create_bundle_id keyword seen in the demo?

It's function key from schema.json file.

How to understand () in the demo, and when should use it? eg: create_bundle_id(), sales_reports()

() is mean: you have mapped to http_body_type in file schema.json

How to set this content in ()

http_body_type have a value type. Based on this value, we can find the definition of the relevant configuration in the source code of ruby.

Development

After checking out the repo, run bundle install to install dependencies. Then, run rake spec to run the tests. You can also run rake console for an interactive prompt that will allow you to experiment.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/kyledecot/app_store_connect.

License

The gem is available as open source under the terms of the MIT License.