تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
Nearby Messages API هي واجهة برمجة تطبيقات للنشر والاشتراك تتيح لك نقل حمولات برمجية ثنائية صغيرة بين أجهزة Android وiOS المتصلة بالإنترنت. ليس من الضروري أن يكون الجهازان متّصلَين بالشبكة نفسها، ولكن يجب أن يكونا متّصلَين بالإنترنت.
تستخدم ميزة "الأجهزة المجاورة" تقنية طاقة البلوتوث المنخفضة لإرسال رمز إقران فريد في الوقت المناسب
بين الأجهزة. يسهّل الخادم تبادل الرسائل بين الأجهزة التي ترصد رمز الإقران نفسه. عندما يرصد جهاز ما رمز إقران من جهاز مجاور، يُرسِل رمز الإقران إلى خادم "الرسائل المجاورة" للتحقّق منه،
والتحقّق مما إذا كانت هناك أي رسائل لإرسالها إلى مجموعة الاشتراكات
الحالية للتطبيق.
لا تتطلّب ميزة "الرسائل القريبة" مصادقة ولا تتطلّب حسابًا على Google.
قد تختلف الآلية الدقيقة لتبادل البيانات من إصدار إلى آخر. يعرض التسلسل التالي الأحداث التي تؤدّي إلى تبادل الرسائل:
يقدّم تطبيق النشر طلبًا لربط الحمولة الثنائية (الرسالة)
برمز إقران فريد في الوقت (الرمز المميّز). يُجري الخادم ربطًا مؤقتًا
بين الحمولة البرمجية للرسالة والرمز المميّز.
يستخدم جهاز النشر تقنية "طاقة البلوتوث المنخفضة" لجعل الرمز المميّز قابلاً للاكتشاف
من قِبل الأجهزة المجاورة. يستخدم جهاز النشر أيضًا تقنية Bluetooth Low Energy للبحث
عن الرموز المميّزة من الأجهزة الأخرى.
يربط التطبيق المشترِك اشتراكه برمز مميّز ويستخدم تقنية )"طاقة بلوتوث منخفضة" لإرسال رمزه المميّز إلى الناشر ورصد رمزه المميّز.
عندما يرصد أي من الجانبَين رمز مميّز للجانب الآخر، يُبلغ الخادم بذلك.
يسهّل الخادم تبادل الرسائل بين جهازَين عندما يكون كلاهما مرتبطًا برمز تعريف مشترك، وتكون مفاتيح واجهة برمجة التطبيقات المستخدَمة من قِبل التطبيقات التي تطلب البيانات مرتبطة بالمشروع نفسه في Google Developers Console.
عند استخدام حزمة تطوير البرامج (SDK) لميزة "الاقتران عن قرب" في "خدمات Google Play"، يتم جمع إحصاءات الاستخدام بهدف
تحسين التجربة.
مقاييس الأداء: يتم جمع مدة عمليات النشر والاشتراكات و
عدد الرسائل المستلَمة عند استخدام حزمة تطوير البرامج (SDK) لميزة "الاقتراب".
معلومات الجهاز: يتم جمع طراز الجهاز والبلد وإصدار الإصدار
واسم حزمة التطبيق وربطها بمقاييس الأداء
لتحديد الشرائح المتعلّقة بالمنطقة والجهاز.
نشر "رسائل الأجهزة المجاورة": تخزِّن Google البيانات المنشورة من خلال "رسائل الأجهزة المجاورة" إلى أن يتم إيقاف نشر الرسالة. تتم مشاركة هذه البيانات
مع المشتركين الذين يكونون بالقرب من الجهاز.
يمكن للمستخدمين النهائيين السماح بهذه العملية أو رفضها من خلال الانتقال إلى الإعدادات > Google >
الاستخدام وبيانات التشخيص.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eNearby Messages, a publish-subscribe API, enables the exchange of small data payloads between nearby Android and iOS devices over the internet using Bluetooth Low Energy.\u003c/p\u003e\n"],["\u003cp\u003eThis API, set to be deprecated in December 2023, is unauthenticated, doesn't require a Google account, and leverages a unique pairing code system for device discovery and message delivery.\u003c/p\u003e\n"],["\u003cp\u003eGoogle collects performance metrics, device information, and published message data to improve the service; however, users can control this data collection through their device settings.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers are encouraged to migrate to Nearby Connections for continued support and functionality.\u003c/p\u003e\n"]]],[],null,["# Overview\n\n| **Warning:** Nearby Messages is deprecated and will stop working as of December 2023. Please migrate to [Nearby Connections](//developers.google.com/nearby/connections/overview) for further support.\n\nThe Nearby Messages API is a publish-subscribe API that lets you pass small\nbinary payloads between internet-connected Android and iOS devices. The devices\ndon't have to be on the same network, but they do have to be connected to the\nInternet.\n\nNearby uses Bluetooth Low Energy to communicate a unique-in-time pairing code\nbetween devices. The server facilitates message exchange between devices that\ndetect the same pairing code. When a device detects a pairing code from a nearby\ndevice, it sends the pairing code to the Nearby Messages server for validation,\nand to check whether there are any messages to deliver for the application's\ncurrent set of subscriptions.\n\nNearby Messages is unauthenticated and does not require a Google Account.\n\nThe exact mechanism for data exchange may vary from release to release. The\nfollowing sequence shows the events leading to message exchange:\n\n1. A publishing app makes a request to associate a binary payload (the message)\n with a unique-in-time pairing code (token). The server makes a temporary\n association between the message payload and the token.\n\n2. The publishing device uses Bluetooth Low Energy to make the token detectable\n by nearby devices. The publishing device also uses Bluetooth Low Energy to scan\n for tokens from other devices.\n\n3. A subscribing app associates its subscription with a token and uses Bluetooth\n Low Energy to send its token to the publisher, and to detect the publisher's\n token.\n\n4. When either side detects the other's token, it reports it to the server.\n\n5. The server facilitates message exchange between two devices when both are\n associated with a common token, and the API keys used by the calling apps are\n associated with the same project in the [Google Developers Console](https://console.developers.google.com/).\n\nWhen using the Google Play services Nearby SDK, usage analytics are collected to\nimprove the experience.\n\n- **Performance metrics:** The duration of publishes and subscriptions and the number of messages received is collected when using the Nearby SDK.\n- **Device information:** Device model, country, build version and the application package name are collected and associated with the performance metrics to identify regional and device-specific slices.\n- **Nearby Messages publishes:** Data published through Nearby Messages is stored by Google until the message is no longer published. This data is shared with subscribers who are near the device.\n\nEnd users can allow or deny this collection by navigating to Settings \\\u003e Google \\\u003e\nUsage \\& diagnostics."]]
