Reminder: By Aug 31, 2025, all new apps and updates to existing apps must use Billing Library version 7 or newer. If you need more time to update your app, you can request an extension until Nov 1, 2025. Learn about
Play Billing Library version deprecation.
واجهات برمجة التطبيقات للعروض الخارجية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
في بعض البلدان، يمكن للمطوّرين المؤهَّلين توجيه المستخدمين خارج
التطبيق، بما في ذلك الترويج للعروض التي توفّرها الميزات والخدمات الرقمية داخل التطبيق. يتناول هذا الدليل واجهات برمجة التطبيقات لتفعيل العروض الخارجية. ينبغي لك مراجعة
متطلبات البرنامج والتسجيل في برنامج العروض الخارجية قبل
استخدام واجهات برمجة التطبيقات هذه.
مسرد المصطلحات
اصطلاحات المصطلحات المتبعة في هذا الدليل:
- واجهات برمجة التطبيقات للعروض الخارجية: هي واجهات برمجة التطبيقات المستخدَمة لتوجيه المستخدم خارج التطبيق، بما في ذلك عرض شاشة المعلومات المطلوبة وإعداد تقارير عن المعاملات السارية.
- المعاملة الخارجية: هي معاملة مؤهَّلة تحدث خارج
التطبيق على النحو المحدّد في متطلبات البرنامج.
- الرمز المميّز للمعاملة الخارجية: هو رمز مميّز يتم تقديمه إلى المطوّر من خلال
"مكتبة الفوترة في Play" ليتمكّن المطوّر من استخدامه عندما يُكمل المستخدم
معاملة خارجية. ويُستخدم هذا الرمز المميز
لإشعار Google Play بإتمام عملية شراء ناجحة.
- معرِّف المعاملة الخارجية: معرِّف فريد ينشئه المطوِّر لتحديد المعاملة الخارجية.
دعم العروض الخارجية
يوضِّح هذا القسم طريقة إتاحة العروض الخارجية.
قبل استخدام واجهات برمجة التطبيقات هذه، يُرجى التأكّد ممّا يلي:
الضبط في Play Console
لضبط العروض الخارجية في Play Console، اتّبِع الخطوات الموضّحة في
متطلبات البرنامج.
تساعد شاشة المعلومات المستخدمين في فهم أنهم على وشك زيارة
موقع ويب خارجي. ستظهر شاشة المعلومات للمستخدمين في كل مرة قبل
توجيههم خارج التطبيق باستخدام واجهات برمجة تطبيقات العروض الخارجية.
شاشة المعلومات
|
هذا مثال لأغراض التوضيح فقط.
الخطوات التالية
لبدء دمج واجهات برمجة التطبيقات للعروض الخارجية، اتّبِع الأدلة التفصيلية
لكل من التكامل داخل التطبيق ودمج الخلفية.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# External offers APIs\n\nIn certain countries, eligible developers are able to lead users outside the\napp, including to promote offers for in-app digital features and services. This\nguide addresses the APIs to enable external offers. You should review the\n[program requirements](https://support.google.com/googleplay/android-developer/answer/14372887) and enroll in the external offers program before\nusing these APIs.\n\nGlossary of terms\n-----------------\n\nTerm conventions followed by this guide:\n\n- **External offers APIs**: APIs used to direct the user outside of the app, including surfacing required information screen and reporting applicable transactions.\n- **External transaction** : A qualifying transaction that occurs outside of the app as defined by the [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n- **External transaction token**: A token provided to the developer through the Play Billing Library for the developer to use when the user completes an external transaction. This token is used to notify Google Play of a successful purchase.\n- **External transaction ID**: A unique identifier generated by the developer to identify an external transaction.\n\nSupport external offers\n-----------------------\n\nThis section describes how to support external offers.\nBefore using these APIs, ensure the following:\n\n- Review the eligibility requirements for the relevant program and complete the onboarding steps outlined in the [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n- Integrate [Play Billing Library 6.2.1](/google/play/billing/release-notes) or higher.\n\n### Configure in Play Console\n\nTo configure external offers in Play Console, follow the steps outlined in\nthe [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n\n### Information screen for users\n\nThe information screen helps users understand that they are about to visit an\nexternal website. The information screen will be shown to users each time before\nthey are directed outside of the app using the external offers APIs. \n\n|--------------------|\n| Information screen |\n\nExample for illustrative purposes only.\n\n### Next steps\n\nTo begin integrating the external offers APIs, follow the in-depth guides\nfor both [in-app integration](/google/play/billing/external/integration) and [backend integration](/google/play/billing/outside-gpb-backend)."]]