iTunes se connecte
1.0.0
Ce joyau fournit un utilitaire de ligne de commande très simple et une « bibliothèque » de support (si je peux avoir l'audace d'utiliser le terme dans ce contexte) pour accéder aux rapports de ventes à partir du site Web iTunes Connect d'Apple. Si vous souhaitez automatiser la récupération de rapports depuis l'App Store, cet outil est fait pour vous.
Ce joyau est livré avec l'exécutable itunes_connect que vous pouvez utiliser pour télécharger des rapports, les importer dans une base de données SQLite et créer des rapports.
Vous pouvez spécifier les valeurs par défaut d'une poignée d'options de ligne de commande en les plaçant dans un fichier nommé .itunesrc dans votre répertoire personnel. Le fichier est au format YAML et doit avoir les clés suivantes :
* nom d'utilisateur * mot de passe * base de données (chemin d'accès au fichier sqlite3, facultatif)
Vous pouvez télécharger des rapports depuis iTunes Connect à l'aide de itunes_connect download . Vous pouvez spécifier vos informations d'identification iTunes Connect sur la ligne de commande ou vous pouvez les mettre au format YAML dans ~/.itunesrc avec les clés :username et :password .
Vous pouvez également transférer le rapport dans un fichier (ou une sortie standard) :
iTunes_connect télécharger -o /tmp/report.txt
Ou vous pouvez le vider directement dans une base de données sqlite3 :
iTunes_connect télécharger -b /tmp/report.db
Par défaut, la commande download récupérera le rapport quotidien le plus récent. Si vous avez une clé database dans votre fichier ~/.itunesrc et que vous _ne spécifiez pas_ de fichier de sortie, le rapport sera automatiquement importé dans la base de données.
Vous pouvez également demander des rapports hebdomadaires ou mensuels en utilisant l'option de ligne de commande -r . Notez que vous ne pouvez pas importer un rapport mensuel directement dans la base de données car les rapports mensuels n'ont aucun jour associé aux entrées.
Exécutez itunes_connect help download pour obtenir tous les détails d'utilisation.
La commande import vous permet de vider un fichier de rapport existant dans la base de données. Ceci est utile si vous avez déjà téléchargé un certain nombre de rapports depuis iTunes Connect et que vous souhaitez simplement les insérer dans la base de données.
Exécutez itunes_connect help import pour obtenir tous les détails d'utilisation.
La commande report interroge votre base de données et peut produire une sortie détaillée ou groupée. Dans les deux cas, vous pouvez limiter la requête à n’importe quelle combinaison de pays, date de début et date de fin.
Exécutez itunes_connect help report pour obtenir des détails complets sur l’utilisation.
Consultez la documentation des classes ItunesConnect::Connection, ItunesConnect::Report et ItunesConnect::Store pour plus de détails.
Forkez le projet.
Ajoutez votre fonctionnalité ou corrigez un bug.
Ajoutez des tests pour cela. C'est important donc je ne le casse pas involontairement dans une future version.
Validez, ne jouez pas avec le rakefile, la version ou l'historique. (si vous voulez avoir votre propre version, c'est bien mais
version bump dans un commit par lui-même, je peux l'ignorer quand je tire)
Envoyez-moi une pull request. Points bonus pour les branches thématiques.
Copyright © 2009 Alex Vollmer. Voir LICENCE pour plus de détails.
