التحضير لعملية النقل

يسرد هذا الموضوع خطوات الإعداد التي عليك اتّخاذها قبل أن تتمكّن من بيع المنتجات في تطبيقك ويصفها. على المستوى العام، يتضمّن هذا الإعداد إنشاء حساب مطوّر، وإنشاء المنتجات التي تريد بيعها وإعدادها، وتفعيل واجهات برمجة التطبيقات التي تستخدمها لبيع منتجاتك وإدارتها وإعدادها. يصف هذا الموضوع أيضًا كيفية إعداد "الإشعارات في الوقت الفعلي الخاصة بالمطوّرين" لتلقّي إشعار عند حدوث تغيير في حالة منتج.

إعداد حساب مطوّر على Google Play

لنشر تطبيقاتك وألعابك على Google Play، استخدِم الـ Google Play Console. يمكنك أيضًا استخدام Google Play Console لإدارة منتجاتك وإعداداتك المتعلّقة بالفوترة.

للوصول إلى Google Play Console، عليك إعداد حساب مطوّر على Google Play.

لبيع التطبيقات المدفوعة والمنتجات داخل التطبيقات على Google Play، عليك أيضًا إعداد ملف في مركز دفعات Google و ثم ربط هذا الملف بحساب المطوّر على Google Play. لمعرفة كيفية ربط ملفك الشخصي بحسابك أو كيفية التحقّق مما إذا كان لديك حساب وملف شخصي مرتبطَين، يُرجى الاطّلاع على ربط حساب مطوّر على Google Play بملف الدفع.

تفعيل الميزات المتعلّقة بالفوترة في Google Play Console

بعد إعداد حساب مطوّر، عليك نشر إصدار من تطبيقك يتضمّن "Google Play Billing Library". هذه الخطوة مطلوبة لتفعيل الميزات المتعلّقة بالفوترة في Google Play Console، مثل ضبط المنتجات التي تريد بيعها.

إضافة عنصر تابع للمكتبة

لدمج نظام الفوترة في Google Play، أضِف أولاً عنصرًا تابعًا لملف مكتبة Google Play Billing Library في تطبيقك. تتيح لك هذه المكتبة الوصول إلى واجهات برمجة تطبيقات Android التي تربطك بحسابك على Google Play. ومن هناك، يمكنك الوصول إلى معلومات الشراء، والبحث عن آخر الأخبار حول عمليات الشراء، وحث المستخدم على إجراء عمليات شراء جديدة، وغير ذلك.

تتوفّر ‫"Google Play Billing Library" من خلال مستودع Maven من Google. أضِف التبعية إلى ملف build.gradle في تطبيقك كما هو موضّح:

أنيق

dependencies {
    def billing_version = "8.3.0"

    implementation "com.android.billingclient:billing:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "8.3.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

إذا كنت تستخدم Kotlin، تحتوي وحدة Play Billing Library KTX على إضافات Kotlin ودعم للروتينات الفرعية التي تتيح لك كتابة لغة Kotlin اصطلاحية عند استخدام نظام الفوترة في Google Play. لتضمين هذه الإضافات في مشروعك، أضِف التبعية التالية إلى ملف build.gradle في تطبيقك كما هو موضّح:

Groovy

dependencies {
    def billing_version = "8.3.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "8.3.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

تستفيد أمثلة رمز Kotlin البرمجي في هذه الصفحة من KTX حيثما أمكن ذلك.

تحميل تطبيقك

بعد إضافة المكتبة إلى تطبيقك، أنشِئ تطبيقك وانشُره. في هذه الخطوة، أنشِئ تطبيقك ثم انشُره في أي مسار، بما في ذلك مسار الاختبار الداخلي.

إنشاء منتجاتك وإعدادها

بعد تفعيل ميزات "الفوترة في Google Play" لتطبيقك، عليك إعداد المنتجات لبيعها.

تشبه خطوات إنشاء المنتجات التي يتم تحصيل سعرها مرة واحدة والاشتراكات بعضها. بالنسبة إلى كل منتج، عليك تقديم معرّف منتج فريد وعنوان ووصف ومعلومات التسعير. تتضمّن الاشتراكات معلومات إضافية مطلوبة، مثل تحديد ما إذا كان نوع التجديد في الخطة الأساسية هو التجديد التلقائي أو التجديد المُسبق الدفع.

توفّر Google Play Console واجهة ويب يمكنك استخدامها لإدارة منتجاتك.

  • لإنشاء المنتجات التي يتم تحصيل سعرها مرة واحدة وإعدادها، يُرجى الاطّلاع على مقالة إنشاء منتج مُدار. يُرجى العِلم أنّ Google Play Console تشير إلى المنتجات التي يتم تحصيل سعرها مرة واحدة باسم المنتجات المُدارة.

  • لإنشاء الاشتراكات وإعدادها، يُرجى الاطّلاع على مقالة إنشاء اشتراك.

كبديل لواجهة الويب، يمكنك أيضًا إدارة منتجاتك باستخدام الـ inappproducts REST resource للمنتجات داخل التطبيق وmonetization.subscriptions REST resource لمنتجات الاشتراك في Google Play Developer API.

إعداد Google Play Developer API

‫Google Play Developer API هي واجهة برمجة تطبيقات من خادم إلى خادم تُكمّل Google Play Billing Library على Android. توفّر واجهة برمجة التطبيقات هذه وظائف غير متاحة في Google Play Billing Library، مثل التحقّق من عمليات الشراء بشكل آمن وإصدار المبالغ المستردة لمستخدميك.

كجزء من دمج نظام الفوترة في Google Play في تطبيقك، عليك إعداد إمكانية الوصول إلى Google Play Developer API من خلال Google Play Console. لمعرفة التعليمات، يُرجى الاطّلاع على مقالة البدء في استخدام Google Play Developer API.

بعد إعداد إمكانية الوصول إلى Google Play Developer API، تأكَّد من منح إذن عرض البيانات المالية اللازم للوصول إلى الوظائف المتعلّقة بالفوترة. للحصول على معلومات عن أفضل الممارسات، بالإضافة إلى مزيد من المعلومات عن إعداد الأذونات، يُرجى الاطّلاع على مقالة إضافة مستخدمين إلى حساب المطوّر وإدارة الأذونات الممنوحة لهم.

إعداد "الإشعارات في الوقت الفعلي الخاصة بالمطوّرين"

الإشعارات في الوقت الفعلي الخاصة بالمطوّرين هي آلية لتلقّي إشعارات من Google عند حدوث تغيير في إذن وصول مستخدم داخل تطبيقك. تستفيد هذه الإشعارات من استخدام Google Cloud Pub/Sub، ما يتيح لك تلقّي البيانات التي يتم دفعها إلى عنوان URL تم ضبطه أو يتم استطلاعها باستخدام مكتبة عملاء. تتيح لك هذه الإشعارات التفاعل على الفور مع التغييرات في حالة الاشتراك، ما يجنبك الحاجة إلى فحص Google Play Developer API. يُرجى العلم أنّ الاستخدام غير الفعّال لواجهة برمجة التطبيقات Google Play Developer API قد يؤدي إلى فرض قيود على حصة واجهة برمجة التطبيقات.

Cloud Pub/Sub هي خدمة مراسلة في الوقت الفعلي مُدارة بالكامل يمكنك استخدامها لإرسال الرسائل وتلقّيها بين تطبيقات مستقلة. يستخدم Google Play خدمة Cloud Pub/Sub لنشر الإشعارات الفورية في المواضيع التي تشترك فيها.

لتلقّي الإشعارات، عليك إنشاء خادم خلفية لاستهلاك الرسائل المُرسَلة إلى موضوعك. يمكن لخادمك بعد ذلك استهلاك هذه الرسائل من خلال الردّ على طلبات HTTPS إلى نقطة نهاية مسجَّلة أو باستخدام مكتبات عملاء Cloud Pub/Sub. تتوفّر هذه المكتبات بمجموعة متنوعة من اللغات. يمكنك أيضًا العثور على مزيد من المعلومات في قسم إنشاء اشتراك في Pub/Sub في هذا الموضوع.

تحديد الأسعار والحصص

للحصول على تفاصيل عن الأسعار والحصص، يُرجى الرجوع إلى مقالة الأسعار و الحصص.

تقدير استخدام البيانات

يبلغ جزء البيانات في إشعار الاشتراك حوالي كيلوبايت واحد من البيانات لكل طلب. يتطلّب كل من النشر والاستلام طلبًا منفصلاً، أو حوالي 2 كيلوبايت من البيانات لكل إشعار. يعتمد عدد الإشعارات في الشهر على دورة الفوترة وسلوك المستخدمين. يجب أن تتوقّع تلقّي إشعار واحد على الأقل لكل مستخدم خلال دورة الفوترة.

إعداد Cloud Pub/Sub

لتفعيل ميزة "الإشعارات في الوقت الفعلي الخاصة بالمطوّرين"، عليك أولاً إعداد Cloud Pub/Sub باستخدام مشروعك على Google Cloud Platform (GCP)، ثم تفعيل الإشعارات لتطبيقك.

لاستخدام Cloud Pub/Sub، يجب أن يكون لديك مشروع على GCP مع تفعيل Cloud Pub/Sub API. إذا لم تكن على دراية بـ GCP وCloud Pub/Sub، يُرجى الاطّلاع على دليل البدء السريع.

إنشاء موضوع

لبدء تلقّي الإشعارات، عليك إنشاء موضوع يجب أن ينشر Google Play الإشعارات فيه. لإنشاء موضوع، اتّبِع التعليمات الواردة في مقالة إنشاء الموضوع.

إنشاء اشتراك في Pub/Sub

لتلقّي الرسائل المنشورة في موضوع، عليك إنشاء اشتراك في Pub/Sub لهذا الموضوع. لإنشاء اشتراك في Pub/Sub، اتّبِع الخطوات التالية:

  1. اقرأ دليل المشترك في Cloud Pub/Sub لتحديد ما إذا كنت تريد إعداد الاشتراك كـ اشتراك فوري أو اشتراك في ميزة "الاستلام".
    • يسمح الاشتراك الفوري لخدمة Cloud Pub/Sub بإرسال إشعارات إلى خادم الخلفية الآمن من خلال إصدار طلبات HTTPS.
    • يتطلّب الاشتراك في ميزة "الاستلام" أن يبدأ خادم الخلفية الآمن طلبات إلى خادم Cloud Pub/Sub لاسترداد الرسائل.
  2. اتّبِع التعليمات الواردة في مقالة إضافة اشتراك لإنشاء اشتراك.

منح حقوق النشر في موضوعك

تتطلّب خدمة Cloud Pub/Sub منح Google Play امتيازات لنشر الإشعارات في موضوعك.

  1. افتح Google Cloud Console.
  2. اختَر مشروعك، ثم انقر على Pub/Sub في لوحة التنقّل اليمنى.

  3. ابحث عن موضوعك وافتح تفاصيل الأذونات.

    الوصول إلى إعدادات موضوع الأذونات
    الشكل 1. الوصول إلى إعدادات موضوع الأذونات

  4. أضِف حساب الخدمة google-play-developer-notifications@system.gserviceaccount.com، وامنحه دور ناشر Pub/Sub.

    إضافة حساب خدمة Google Play كناشر Pub/Sub
    الشكل 2. إضافة حساب خدمة Google Play كناشر Pub/Sub.

  5. انقر على حفظ لإكمال إعداد الموضوع.

    موضوع تم ضبطه
    الشكل 3. موضوع تم إعداده.

تفعيل "الإشعارات في الوقت الفعلي الخاصة بالمطوّرين" لتطبيقك

لتفعيل ميزة "الإشعارات في الوقت الفعلي الخاصة بالمطوّرين" لتطبيقك، اتّبِع الخطوات التالية:

  1. افتح Google Play Console.
  2. اختيار تطبيقك
  3. انتقِل إلى تحقيق الربح > إعداد تحقيق الربح.

  4. انتقِل إلى قسم الإشعارات في الوقت الفعلي الخاصة بالمطوّرين في أعلى الصفحة.

    قسم "الإشعارات في الوقت الفعلي الخاصة بالمطوّرين"
    الشكل 4. قسم "الإشعارات في الوقت الفعلي الخاصة بالمطوّرين"

  5. ضَع علامة في المربّع بجانب تفعيل الإشعارات الفورية.

  6. في حقل اسم الموضوع ، أدخِل اسم موضوع Cloud Pub/Sub الكامل الذي أعددته سابقًا. يجب أن يكون اسم الموضوع بالتنسيق projects/{project_id}/topics/{topic_name}، حيث project_id هو المعرّف الفريد لمشروعك، وtopic_name هو اسم الموضوع الذي تم إنشاؤه سابقًا.

  7. انقر على إرسال رسالة اختبار لإرسال رسالة اختبار. يساعد إجراء عملية نشر تجريبية في التأكّد من إعداد كل شيء بشكل صحيح. إذا نجحت عملية النشر التجريبي، ستظهر رسالة تشير إلى نجاحها. إذا أرفقت اشتراكًا بهذا الموضوع، من المفترض أن تتلقّى رسالة الاختبار.

    بالنسبة إلى الاشتراك في ميزة "الاستلام"، انتقِل إلى الاشتراك في Cloud Console، وانقر على عرض الرسائل، ثم استلِم الرسائل. عليك تأكيد أي رسالة استلمتها لتجنُّب تكرار تسليمها من قِبل Cloud Pub/Sub. بالنسبة إلى اشتراك فوري ، تحقَّق مما إذا تم تسليم رسالة الاختبار إلى نقطة النهاية الفورية. سيكون رمز الردّ الناجح بمثابة تأكيد للرسالة.

    إذا تعذّر النشر، سيظهر خطأ. تأكَّد من أنّ اسم الموضوع صحيح وأنّ حساب الخدمة google-play-developer-notifications@system.gserviceaccount.com لديه إذن ناشر Pub/Sub للوصول إلى الموضوع.

  8. اختَر أنواع الإشعارات التي تريد تلقّيها.

    • تلقّي إشعارات بشأن الاشتراكات وجميع عمليات الشراء المُلغاة: يمكنك تلقّي إشعارات في الوقت الفعلي خاصة بالمطوّرين بشأن الاشتراكات وعمليات الشراء المُلغاة. لن تتلقّى إشعارات بشأن عمليات شراء المنتجات التي يتم تحصيل سعرها مرة واحدة.
    • تلقّي جميع الإشعارات بشأن الاشتراكات والمنتجات التي يتم تحصيل سعرها مرة واحدة : يمكنك تلقّي إشعارات بشأن جميع أحداث الاشتراك وعمليات الشراء المُلغاة. ستتلقّى أيضًا أحداث شراء المنتجات التي يتم تحصيل سعرها مرة واحدة، مثل ONE_TIME_PRODUCT_PURCHASED وONE_TIME_PRODUCT_CANCELED. يُرجى الاطّلاع على مقالة دورة حياة عملية الشراء لمرة واحدة لمزيد من المعلومات عن أحداث الشراء هذه.

  9. انقر على حفظ التغييرات.

تأكيد الإعدادات

لتلقّي إشعارات في الوقت الفعلي خاصة بالمطوّرين، عليك إنشاء ملف شخصي آمن لخادم الخلفية لاستهلاك الرسائل المُرسَلة إلى موضوع Cloud Pub/Sub.

يمكنك اختبار إعداداتك باستخدام الزر إرسال رسالة اختبار في Google Play Console كما هو موضّح في القسم السابق. إذا لم تكن قد أعددت خادم خلفية لاستهلاك الإشعارات، يمكنك استخدام أداة سطر الأوامر gcloud للتحقّق من الإعدادات. لمعرفة تعليمات معالجة الرسائل باستخدام gcloud، يُرجى الاطّلاع على مقالة استلام الرسالة من الاشتراك.

الخطوات التالية