Esta joia fornece um utilitário de linha de comando muito simples e uma “biblioteca” de apoio (se posso ser ousado em usar o termo neste contexto) para acessar relatórios de vendas do site iTunes Connect da Apple. Se você deseja automatizar a obtenção de relatórios da App Store, esta ferramenta é para você.
Esta joia vem com o executável itunes_connect
que você pode usar para baixar relatórios, importar para um banco de dados sqlite e gerar relatórios.
Você pode especificar os valores padrão para algumas opções de linha de comando, colocando-as em um arquivo chamado .itunesrc
em seu diretório inicial. O arquivo está no formato YAML e deve ter as seguintes chaves:
* nome de usuário * senha * banco de dados (caminho para o arquivo sqlite3, opcional)
Você pode baixar relatórios do iTunes Connect usando itunes_connect download
. Você pode especificar suas credenciais do iTunes Connect na linha de comando ou colocá-las no formato YAML em ~/.itunesrc
com as chaves :username
e :password
.
Você também pode despejar o relatório em um arquivo (ou padronizar):
baixar itunes_connect -o /tmp/report.txt
Ou você pode despejá-lo diretamente em um banco de dados sqlite3:
baixar itunes_connect -b /tmp/report.db
Por padrão, o comando download
recuperará o relatório diário mais recente. Se você tiver uma chave database
em seu arquivo ~/.itunesrc
e _não_ especificar um arquivo out, o relatório será automaticamente importado para o banco de dados.
Você também pode solicitar relatórios semanais ou mensais usando a opção de linha de comando -r
. Observe que você não pode importar um relatório mensal diretamente para o banco de dados porque os relatórios mensais não possuem dias associados às entradas.
Execute itunes_connect help download
para obter detalhes completos de uso.
O comando import
permite despejar um arquivo de relatório existente no banco de dados. Isso é útil se você já baixou vários relatórios do iTunes Connect e deseja apenas colocá-los no banco de dados.
Execute itunes_connect help import
para obter detalhes completos de uso.
O comando report
consulta seu banco de dados e pode produzir resultados detalhados ou agrupados. Em ambos os casos, você pode restringir a consulta a qualquer combinação de país, data de início e data de término.
Execute itunes_connect help report
para obter detalhes completos de uso.
Consulte a documentação das classes ItunesConnect::Connection, ItunesConnect::Report e ItunesConnect::Store para obter detalhes.
Bifurque o projeto.
Faça sua adição de recurso ou correção de bug.
Adicione testes para isso. Isso é importante para que eu não o quebre acidentalmente em uma versão futura.
Confirme, não mexa com rakefile, versão ou histórico. (se você quiser ter sua própria versão, tudo bem, mas
versão bump em um commit por si só, posso ignorar quando puxo)
Envie-me uma solicitação de pull. Pontos de bônus para ramos de tópicos.
Direitos autorais © 2009 Alex Vollmer. Consulte LICENÇA para obter detalhes.