API של מזהה מופע
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
באמצעות Instance ID API אפשר לשלב את Instance ID באפליקציה ל-Android או ל-iOS. Instance ID מספק מזהה ייחודי לכל מופע של האפליקציה ומנגנון לאימות ולמתן הרשאה לפעולות. InstanceID הוא מפתח לטווח ארוך, אבל התוקף שלו עשוי לפוג מהסיבות הבאות:
- איפוס המכשיר להגדרות המקוריות.
- המשתמש מסיר את האפליקציה.
- המשתמש מבצע פעולת 'ניקוי נתונים' באפליקציה.
- המכשיר לא היה בשימוש במשך תקופה ממושכת (התקופה נקבעת לפי המכשיר והאזור).
- שירות מזהה המכונה מזהה ניצול לרעה או שגיאות ומאפס את
InstanceID.
- קוד בצד השרת, אם אפליקציית הלקוח שלכם דורשת את הפונקציונליות הזו.
שירות מזהה המכונה מודיע לאפליקציה על איפוס של InstanceID באמצעות קריאה חוזרת (callback) ל-InstanceIDListenerService. אם האפליקציה מקבלת את ההתראה הזו, היא צריכה לבצע קריאה ל-getToken() ולאחזר את InstanceID החדש ולעדכן את השרתים שלה.
משתמשים בשיטה getToken כדי להוכיח את הבעלות על InstanceID ולאפשר לשרתים לגשת לנתונים או לשירותים המשויכים לאפליקציה. השיטה פועלת לפי התבניות של OAuth2, ומחייבת authorizedEntity ו-scope. הערך של authorizedEntity יכול להיות מזהה פרויקט או InstanceID אחר, והוא קובע אילו שירותים מורשים להשתמש באסימון שנוצר. השדה scope קובע לאילו נתונים או לשירות ספציפיים האסימון מאפשר גישה.
מידע נוסף על Instance ID API זמין עבור:
Android
iOS
שרת
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\u003cp\u003eThe Instance ID API provides a unique identifier for each app instance and enables authentication and authorization.\u003c/p\u003e\n"],["\u003cp\u003eInstance IDs are long-lived but can expire due to various factors like device reset, uninstallation, data clearing, extended inactivity, or service-detected issues.\u003c/p\u003e\n"],["\u003cp\u003eUpon Instance ID reset, apps are notified and must retrieve a new ID using \u003ccode\u003egetToken()\u003c/code\u003e and update their servers.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetToken()\u003c/code\u003e method, using OAuth2 patterns, verifies Instance ID ownership and grants server access to associated data or services based on authorized entity and scope.\u003c/p\u003e\n"]]],[],null,["# Instance ID API\n\nThe Instance ID API lets you integrate Instance ID with your Android\nor iOS app. Instance ID provides a unique identifier for each instance of\nyour app and a mechanism to authenticate and authorize actions. The `InstanceID` is long\nlived, but may expire for the following reasons:\n\n- Device factory reset.\n- User uninstalls the app.\n- User performs \"Clear Data\" in the app.\n- Device unused for an extended period (device and region determines the timespan).\n- Instance ID service detects abuse or errors and resets the `InstanceID`.\n- Server-side code if your client app requires that functionality.\n\nThe Instance ID service notifies your app of an `InstanceID` reset via\ncallback to a `InstanceIDListenerService`. If your app receives this\nnotification, it must call `getToken()` and retrieve the new `InstanceID`,\nand update its servers.\n\nUse the `getToken` method to prove the ownership of the `InstanceID` and to allow\nservers to access data or services associated with the app. The method follows\nthe patterns of OAuth2, and requires an `authorizedEntity` and `scope`. The\n`authorizedEntity` can be a project ID or another `InstanceID`, and it determines\nthe services that are authorized to use the generated token. The `scope`\ndetermines the specific service or data to which the token allows access.\n\nLearn more about the Instance ID API for:\n\n[Android](/instance-id/reference/android/api)\n[iOS](/instance-id/reference/ios/api)\n[Server](/instance-id/reference/server)"]]
