apple_vpp
Ruby bindings for the Apple VPP Managed App License Distribution API.
Installation
Add this line to your application's Gemfile:
gem 'apple_vpp'
And then execute:
$ bundle
Or install it yourself as:
$ gem install apple_vpp
Usage
Use the library like this:
s_token = File.read './from_apple_portal.vpptoken'
c = AppleVPP::Client.new s_token
resp = c.get_users
c.edit_user user_id: resp[:users].first[:user_id],
email: '[email protected]'
Methods
For information beyond what is included here, refer to the "Mobile Device Management Protocol Reference" documentation on Apple's Developer site.
associate_license_with_user
One of these is required:
- user_id
- client_user_id_str
One of these is required:
- adam_id
- license_id
Optional:
- pricing_param
client_config
Optional:
- client_context
- apn_token
disassociate_license_from_user
Required:
- license_id
edit_user
One of these is required:
- user_id
- client_user_id_str
Optional:
get_licenses
Optional:
- since_modified_token
- adam_id
- pricing_param
get_user
One of these is required:
- user_id
- client_user_id_str
Optional:
- its_id_hash
get_users
Optional:
- since_modified_token
- include_retired
register_user
Required:
- client_user_id_str
Optional:
retire_user
One of these is required:
- user_id
- client_user_id_str
Error Handling
Should an error be reported by the Apple API service, the library will raise a custom error class that will correspond to the Apple error code like so:
AppleVPP::Error::Code#{error_code}
A message will also be provided with the error.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request