סקירה כללית

Nearby Messages API הוא ממשק API לרישום פרסום שמאפשר להעביר מטענים ייעודיים (payloads) בינאריים קטנים בין מכשירי Android ו-iOS שמחוברים לאינטרנט. המכשירים לא חייבים להיות מחוברים לאותה רשת, אבל הם חייבים להיות מחוברים לאינטרנט.

Nearby עושה שימוש ב-Bluetooth Low Energy כדי להעביר קוד התאמה ייחודי בזמן בין מכשירים. השרת מאפשר העברת הודעות בין מכשירים שמזהים את אותו קוד התאמה. כשמכשיר מזהה קוד התאמה ממכשיר בקרבת מקום, הוא שולח את קוד ההתאמה לשרת Nearby Messages לאימות, ולבדיקה אם יש הודעות להעברה לקבוצת המינויים הנוכחית של האפליקציה.

אפליקציית Messages בקרבת מקום לא מאומתת ולא דורשת חשבון Google.

המנגנון המדויק לחילופי נתונים עשוי להשתנות מגרסה להפצה. הרצף הבא מציג את האירועים שמובילים לחילופי הודעות:

  1. אפליקציית פרסום שולחת בקשה לשייך מטען ייעודי (payload) בינארי (ההודעה) לקוד התאמה ייחודי בזמן (אסימון). השרת מבצע שיוך זמני בין המטען הייעודי (Payload) של ההודעות לבין האסימון.

  2. המכשיר המפרסם משתמש ב-Bluetooth Low Energy כדי לאפשר זיהוי של האסימון על ידי מכשירים בקרבת מקום. מכשיר הפרסום משתמש גם ב-Bluetooth Low Energy כדי לחפש אסימונים ממכשירים אחרים.

  3. אפליקציית הרשמה משייכת את המינוי שלה לאסימון ומשתמשת ב-Bluetooth Low Energy כדי לשלוח את האסימון שלה לבעל התוכן הדיגיטלי ולזהות את האסימון של בעל התוכן הדיגיטלי.

  4. כשאחד מהצדדים מזהה את האסימון של הצד השני, הוא מדווח עליו לשרת.

  5. השרת מאפשר החלפת הודעות בין שני מכשירים כאשר שניהם משויכים לאסימון משותף, ומפתחות ה-API שמשמשים את אפליקציות הקריאה משויכים לאותו פרויקט ב-Google Developers Console.

כשמשתמשים ב-SDK של Google Play Services בקרבת מקום, נאספים נתוני שימוש כדי לשפר את חוויית השימוש.

  • מדדי ביצועים: איסוף של משך הפרסום והמינויים ומספר ההודעות שהתקבלו כשמשתמשים ב-SDK בקרבת מקום.
  • מידע מהמכשירים: דגם המכשיר, המדינה, גרסת ה-build ושם החבילה של האפליקציה נאספים ומשויכים למדדי הביצועים כדי לזהות פרוסות לפי אזור או מכשיר ספציפי.
  • פרסום הודעות בקרבת מקום: נתונים שמתפרסמים באמצעות Nearby Messages נשמרים על ידי Google עד לפרסום ההודעה. הנתונים האלה משותפים עם מנויים שנמצאים בקרבת המכשיר.

משתמשי הקצה יכולים לאשר או לדחות את האוסף הזה על ידי מעבר ל'הגדרות' > Google > אופן השימוש בנתונים וניתוח הביצועים.