توفر هذه الجوهرة أداة مساعدة بسيطة للغاية لسطر الأوامر و"مكتبة" داعمة (إذا كنت جريئًا جدًا في استخدام المصطلح في هذا السياق) للوصول إلى تقارير المبيعات من موقع iTunes Connect الخاص بشركة Apple. إذا كنت تريد أتمتة عملية الحصول على التقارير من متجر التطبيقات، فهذه الأداة مناسبة لك.
تأتي هذه الجوهرة مع الملف القابل للتنفيذ itunes_connect
والذي يمكنك استخدامه لتنزيل التقارير والاستيراد إلى قاعدة بيانات sqlite وإعداد التقارير منها.
يمكنك تحديد القيم الافتراضية لعدد قليل من خيارات سطر الأوامر عن طريق وضعها في ملف يسمى .itunesrc
في الدليل الرئيسي لديك. الملف بتنسيق YAML ويجب أن يحتوي على المفاتيح التالية:
* اسم المستخدم * كلمة المرور * قاعدة البيانات (المسار إلى ملف sqlite3، اختياري)
يمكنك تنزيل التقارير من iTunes Connect باستخدام itunes_connect download
. يمكنك تحديد بيانات اعتماد iTunes Connect الخاصة بك في سطر الأوامر أو يمكنك وضعها بتنسيق YAML في ~/.itunesrc
باستخدام مفاتيح :username
و :password
.
يمكنك أيضًا تفريغ التقرير إلى ملف (أو إخراج قياسي):
itunes_connect تنزيل -o /tmp/report.txt
أو يمكنك تفريغها مباشرة في قاعدة بيانات sqlite3:
itunes_connect تنزيل -b /tmp/report.db
افتراضيًا، سيقوم أمر download
باسترداد أحدث تقرير يومي. إذا كان لديك مفتاح database
في ملف ~/.itunesrc
الخاص بك ولم تقم بتحديد ملف إخراج، فسيتم استيراد التقرير تلقائيًا إلى قاعدة البيانات.
يمكنك أيضًا طلب تقارير أسبوعية أو شهرية باستخدام خيار سطر الأوامر -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 أليكس فولمر. راجع الترخيص للحصول على التفاصيل.