iTunes接続

itunes_connect ¶ ↑

この gem は、非常にシンプルなコマンドライン ユーティリティと、Apple の iTunes Connect Web サイトから販売レポートにアクセスするための補助「ライブラリ」(この文脈で大胆にこの用語を使用できるのであれば) を提供します。 App Store からのレポートの取得を自動化したい場合は、このツールが最適です。

使用法¶ ↑

コマンドラインの使用法¶ ↑

この gem には、レポートのダウンロード、sqlite データベースへのインポート、およびレポート作成に使用できるitunes_connect実行可能ファイルが付属しています。

いくつかのコマンド ライン オプションのデフォルト値を指定するには、ホーム ディレクトリの.itunesrcという名前のファイルにオプションを入れます。ファイルは YAML 形式であり、次のキーが含まれている必要があります。

 * ユーザー名
* パスワード
* データベース (sqlite3 ファイルへのパス、オプション) 

レポートのダウンロード¶ ↑

itunes_connect download使用して、iTunes Connect からレポートをダウンロードできます。 iTunes Connect 資格情報はコマンドラインで指定することも、 :usernameと:passwordのキーを使用して YAML 形式で~/.itunesrcに置くこともできます。

レポートをファイル (または標準出力) にダンプすることもできます。

 itunes_connect ダウンロード -o /tmp/report.txt

または、それを sqlite3 データベースに直接ダンプすることもできます。

 itunes_connect ダウンロード -b /tmp/report.db

デフォルトでは、 downloadコマンドは最新の日次レポートを取得します。 ~/.itunesrcファイルにdatabaseキーがあり、出力ファイルを指定しない場合、レポートは自動的にデータベースにインポートされます。

-rコマンドライン オプションを使用して、週次レポートまたは月次レポートを要求することもできます。月次レポートにはエントリに関連付けられた日がないため、月次レポートをデータベースに直接インポートできないことに注意してください。

完全な使用方法の詳細については、 itunes_connect help download実行してください。

レポートのインポート¶ ↑

importコマンドを使用すると、既存のレポート ファイルをデータベースにダンプできます。これは、iTunes Connect からすでに多数のレポートをダウンロードしていて、それらをデータベースに保存したい場合に便利です。

詳しい使用方法については、 itunes_connect help import実行してください。

レポート¶ ↑

reportコマンドはデータベースにクエリを実行し、詳細な出力またはグループ化された出力を生成できます。どちらの場合も、クエリを国、開始日、終了日の任意の組み合わせに制限できます。

完全な使用方法の詳細については、 itunes_connect help report実行してください。

プログラムによる使用法¶ ↑

詳細については、ItunesConnect::Connection、ItunesConnect::Report、および ItunesConnect::Store クラスのドキュメントを参照してください。

パッチ/プルリクエストに関する注意事項¶ ↑

• プロジェクトをフォークします。

• 機能追加やバグ修正を行います。

• それにテストを追加します。これは将来のバージョンで意図せずに壊さないようにするために重要です。

• コミットします。rakefile、バージョン、履歴をいじらないでください。 (独自のバージョンが必要な場合は問題ありませんが、

  コミット自体でバージョンをバンプするので、プルするときに無視できます)

• プルリクエストを送ってください。トピックブランチのボーナスポイント。

著作権¶ ↑

著作権 © 2009 Alex Vollmer。詳細については、「ライセンス」を参照してください。