تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
العديد من وظائف الجهاز الأساسية، مثل قراءة سجلات المكالمات وإرسال الرسائل القصيرة SMS
على الوصول إلى معلومات المستخدم الحساسة. حماية المستخدم
الخصوصية وتوفير مزيد من التحكم في المعلومات التي
توفيره للتطبيقات على أجهزتهم، يقيّد Google Play الوصول إلى المكالمات
ومجموعات الأذونات المتعلّقة بالمراسلة
إذا كنت توزّع تطبيقك على "متجر Google Play" وتريد الوصول إلى البيانات الحسّاسة
معلومات المستخدم المتعلقة بسجلات المكالمات ورسائل SMS، يحتاج تطبيقك إلى
تسجيله باعتباره المعالج التلقائي للمستخدم لوظيفة الجهاز الأساسية
ذات الصلة بهذا الإذن، ما لم يستوفِ تطبيقك إحدى
حالات الاستثناء
التي تظهر في مركز مساعدة Play Console على سبيل المثال، للوصول إلى
الأذونات المتعلقة بالمكالمات، يجب تسجيل تطبيقك كالتطبيق التلقائي للمستخدم
الهاتف أو معالج "مساعد Google"، ما لم يستوفِ تطبيقك حالة استثنائية.
يوفّر هذا الدليل نظرة عامة مختصرة حول كيفية وصول المستخدمين إلى المعالجات التلقائية في
الأجهزة التي تعمل بنظام التشغيل Android يراجع الدليل بعد ذلك متطلبات تشغيل التطبيق
يجب أن يستوفيه قبل أن يصبح مؤهلاً ليكون معالجًا افتراضيًا. أخيرًا،
يرشدك خلال عملية الحصول على موافقة المستخدم لتصبح
المعالِج التلقائي.
لمزيد من المعلومات حول المعالِجات التلقائية وكذلك كيفية التعامل مع الأذونات في
التطبيق المتوفّر في "متجر Play"، راجِع سياسة الأذونات.
الدليل.
عرض مجموعة المعالِجات التلقائية وتغييرها
يتيح Android للمستخدمين ضبط المعالِجات التلقائية لعدة حالات استخدام أساسية، مثل
إجراء المكالمات الهاتفية وإرسال رسائل SMS وتوفير التكنولوجيا المساعدة
والإمكانات.
يتضمن تطبيق "الإعدادات" في نظام التشغيل Android شاشة تعرض للمستخدمين التطبيقات
المعالِجات التلقائية حاليًا للوظائف الأساسية للجهاز،
كما هو موضح في الشكل 1. من هذه الشاشة، يمكن للمستخدمين تغيير المعالج الافتراضي
دالة معينة، كما هو موضح في الشكل 2.
الشكل 1. شاشة إعدادات النظام تعرض قائمة بالمعالجات التلقائية
على الجهاز.
الشكل 2. شاشة إعدادات النظام تعرض كيفية تغيير الإعدادات التلقائية
معالِج الرسائل القصيرة (SMS).
اتباع متطلبات المعالِجات التلقائية
بناءً على المعلومات الحساسة للمستخدم التي يصل إليها أحد التطبيقات أثناء العمل
لا يمكن للتطبيق أن يصبح معالجًا افتراضيًا ما لم يستوفِ
اتّباع متطلبات الوظائف الأساسية وبطاقة بيانات المتجر على Play:
يجب أن يتمكّن تطبيقك من أداء الوظائف التي يستخدمها التطبيق بشكل تلقائي.
. على سبيل المثال، يجب أن يتمكن المعالج التلقائي للرسائل القصيرة SMS من إرسال نص.
الرسائل.
يجب أن يوفّر تطبيقك سياسة خصوصية.
يجب أن يوضّح وصف تطبيقك وظائفه الأساسية في وصف "متجر Play".
على سبيل المثال، يجب أن يصف المعالج التلقائي للهاتف التطبيقات ذات الصلة بالهاتف.
الأساسية في الوصف.
يجب أن يطلب التطبيق أن يصبح معالِجًا تلقائيًا قبل أن يطلب
الأذونات المرتبطة بكونك ذلك المعالج. على سبيل المثال، يجب أن يطلب أحد التطبيقات
ليكون المعالج التلقائي للرسائل القصيرة SMS قبل طلب إذن READ_SMS.
طلب موافقة المستخدم
بعد التأكّد من أنّ تطبيقك يستوفي كلّ المتطلّبات اللازمة
معالجًا افتراضيًا، يمكنك إضافة منطق لعرض مربع الحوار المعروض في
الشكل 3. يطلب هذا مربع الحوار من المستخدم جعل تطبيقك هو المعالج التلقائي
في حالة استخدام معينة.
الشكل 3. طلب سؤال المستخدم عما إذا كان يريد تغيير
المعالِج التلقائي للرسائل القصيرة SMS على الجهاز.
يوضح الرمز في المثال التالي المنطق اللازم لعرض طلب
يطلب من المستخدم تغيير المعالج التلقائي للرسائل القصيرة على جهازه:
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Permissions used only in default handlers\n\n| **Note:** This guide primarily applies to Android app developers who are publishing apps on the [Google Play Store](https://play.google.com/store/apps). However, to protect your users' privacy, it's best to complete the tasks described on this page regardless of where you publish your Android app.\n\nSeveral core device functions, such as reading call logs and sending SMS\nmessages, depend on access to sensitive user information. To protect user\nprivacy and provide users with more control over the information that they\nprovide to apps on their device, Google Play restricts apps' access to call-\nand messaging-related permission groups.\n\nIf you distribute your app on the Google Play Store and want to access sensitive\nuser information related to call logs and SMS messages, your app needs\nto be registered as the user's *default handler* for the core device function\nrelated to that permission, unless your app satisfies one of the\n[exception cases](https://support.google.com/googleplay/android-developer/answer/9047303#exceptions)\nthat appear in the Play Console Help Center. For example, to access\ncall-related permissions, your app needs to be registered as the user's default\nPhone or Assistant handler, unless your app satisfies an exception case.\n\nThis guide provides a brief overview of how users access default handlers on\nAndroid-powered devices. The guide then reviews the requirements that an app\nmust satisfy before becoming eligible to be a default handler. Finally, the\nguide walks you through the process of receiving user consent to become a\ndefault handler.\n\nTo learn more about default handlers, as well as how to handle permissions in an\napp that's available on the Play Store, [see the Permissions policy\nguide](https://play.google.com/about/privacy-security-deception/permissions/).\n\nView and change the set of default handlers\n-------------------------------------------\n\nAndroid lets users set default handlers for several core use cases, such as\nplacing phone calls, sending SMS messages, and providing assistive technology\ncapabilities.\n\nThe Settings app on Android includes a screen that shows users which apps are\ncurrently default handlers for the device's core functions, as\nshown in figure 1. From this screen, users can change the default handler for a\ngiven function, as shown in figure 2. \n**Figure 1.** System settings screen showing list of default handlers on a device. \n**Figure 2.** System settings screen showing how to change the default SMS handler.\n\nFollow requirements for default handlers\n----------------------------------------\n\nGiven the sensitive user information that an app accesses while serving as a\ndefault handler, your app cannot become a default handler unless it meets the\nfollowing Play Store listing and core functionality requirements:\n\n- Your app must be able to perform the functionality for which it's a default handler. For example, a default SMS handler must be able to send text messages.\n- Your app must provide a privacy policy.\n- Your app must make its core functionality clear in the Play Store description. For example, a default Phone handler should describe its phone-related capabilities in the description.\n- Your app must declare permissions that are appropriate for its use case. For more details about which permissions you can declare as a given handler, see the [guidance on using SMS or call log permission\n groups](https://support.google.com/googleplay/android-developer/answer/9047303#intended) in the Play Console Help Center.\n- Your app must ask to become a default handler **before** it requests the permissions associated with being that handler. For example, an app must request to become the default SMS handler before it requests the `READ_SMS` permission.\n\nRequest user consent\n--------------------\n\nAfter ensuring that your app follows each of the requirements necessary to\nbecome a default handler, you can add logic to display the dialog shown in\nfigure 3. This dialog asks the user to make your app the default handler for a\nparticular use case. \n**Figure 3.** Prompt asking the user whether they want to change their device's default SMS handler.\n| **Note:** Your app must ask to become a default handler **before** it requests the permissions associated with being that handler. For example, an app must request to become the default SMS handler before it requests the `READ_SMS` permission.\n\n\nThe following example code shows the logic necessary to display a prompt that\nasks the user to change their device's default SMS handler: \n\n### Kotlin\n\n```kotlin\nval setSmsAppIntent = Intent(Telephony.Sms.Intents.ACTION_CHANGE_DEFAULT)\nsetSmsAppIntent.putExtra(Telephony.Sms.Intents.EXTRA_PACKAGE_NAME, packageName)\nstartActivityForResult(setSmsAppIntent, your-result-code)\n```\n\n### Java\n\n```java\nIntent setSmsAppIntent =\n new Intent(Telephony.Sms.Intents.ACTION_CHANGE_DEFAULT);\nsetSmsAppIntent.putExtra(Telephony.Sms.Intents.EXTRA_PACKAGE_NAME,\n getPackageName());\nstartActivityForResult(setSmsAppIntent, your-result-code);\n```"]]
