Dieses Juwel bietet ein sehr einfaches Befehlszeilen-Dienstprogramm und eine unterstützende „Bibliothek“ (wenn ich den Begriff in diesem Zusammenhang so mutig verwenden darf) für den Zugriff auf Verkaufsberichte über die iTunes Connect-Website von Apple. Wenn Sie das Abrufen von Berichten aus dem App Store automatisieren möchten, ist dieses Tool genau das Richtige für Sie.
Dieses Juwel wird mit der ausführbaren Datei itunes_connect
geliefert, mit der Sie Berichte herunterladen, in eine SQLite-Datenbank importieren und daraus Berichte erstellen können.
Sie können die Standardwerte für eine Handvoll Befehlszeilenoptionen angeben, indem Sie sie in einer Datei mit dem Namen .itunesrc
in Ihrem Home-Verzeichnis ablegen. Die Datei liegt im YAML-Format vor und sollte die folgenden Schlüssel haben:
* Benutzername * Passwort * Datenbank (Pfad zur SQLite3-Datei, optional)
Sie können Berichte von iTunes Connect mit itunes_connect download
herunterladen. Sie können Ihre iTunes Connect-Anmeldeinformationen in der Befehlszeile angeben oder sie im YAML-Format in ~/.itunesrc
mit den Schlüsseln :username
und :password
eingeben.
Sie können den Bericht auch in eine Datei sichern (oder standardmäßig ausgeben):
itunes_connect download -o /tmp/report.txt
Oder Sie können es direkt in eine SQLite3-Datenbank kopieren:
itunes_connect download -b /tmp/report.db
Standardmäßig ruft der download
-Befehl den aktuellsten Tagesbericht ab. Wenn Sie einen database
in Ihrer ~/.itunesrc
Datei haben und keine Out-Datei angeben, wird der Bericht automatisch in die Datenbank importiert.
Sie können auch wöchentliche oder monatliche Berichte anfordern, indem Sie die Befehlszeilenoption -r
verwenden. Beachten Sie, dass Sie einen Monatsbericht nicht direkt in die Datenbank importieren können, da den Monatsberichten keine Tage mit den Einträgen zugeordnet sind.
Führen Sie itunes_connect help download
aus, um vollständige Nutzungsdetails zu erhalten.
Mit dem import
können Sie eine vorhandene Berichtsdatei in die Datenbank kopieren. Dies ist nützlich, wenn Sie bereits mehrere Berichte von iTunes Connect heruntergeladen haben und diese nur noch in die Datenbank einfügen möchten.
Führen Sie itunes_connect help import
aus, um vollständige Nutzungsdetails zu erhalten.
Der Befehl report
fragt Ihre Datenbank ab und kann entweder eine detaillierte oder gruppierte Ausgabe erzeugen. In beiden Fällen können Sie die Abfrage auf eine beliebige Kombination aus Land, Startdatum und Enddatum beschränken.
Führen Sie itunes_connect help report
aus, um vollständige Nutzungsdetails zu erhalten.
Weitere Informationen finden Sie in der Dokumentation zu den Klassen ItunesConnect::Connection, ItunesConnect::Report und ItunesConnect::Store.
Forken Sie das Projekt.
Nehmen Sie Ihre Funktionserweiterung oder Fehlerbehebung vor.
Fügen Sie Tests dafür hinzu. Dies ist wichtig, damit ich es nicht unbeabsichtigt in einer zukünftigen Version kaputt mache.
Commit, nicht mit Rakefile, Version oder Verlauf herumspielen. (Wenn Sie Ihre eigene Version haben möchten, ist das in Ordnung, aber
Bump-Version in einem Commit für sich, kann ich beim Pullen ignorieren)
Schicken Sie mir eine Pull-Anfrage. Bonuspunkte für Themenzweige.
Copyright © 2009 Alex Vollmer. Einzelheiten finden Sie unter LIZENZ.