ממשק API לאימות באינטרנט
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משלבים חייבים להטמיע מארח אתרי אינטרנט כדי להפנות את המשתמשים למטרות אימות. האימות מתבצע בדרך אחרת, אבל אותה מטרה כמו האימות שסופק על ידי אימות Android.
למארח האינטרנט הזה חייב להיות אתר שמתאים לניידים.
מארח אתרי האינטרנט חייב לקבוע את בקשות האינטרנט לנייד לעומת בקשות האינטרנט למחשבים על סמך ערך הכותרת של הסוכן המשתמש. הדף שנמסר בבקשות אינטרנט לנייד חייב להיות ידידותי לאינטרנט לנייד ב-Android וב-iOS. מלבד ערך הכותרת של סוכן המשתמש, הלקוח לא יספק לכם רמז נוסף לגבי הסביבה שבה המשתמש מבצע את הבקשה (מחשב או אינטרנט).
השרת חייב ליישם פרוטוקול HTTPS באמצעות GET. מבצע השילוב יכול להגדיר את הנתיב והמארח. מבצע השילוב חייב לתמוך באורכים של כתובות URL של 2,048 תווים. זה כולל את הסכמה, המארח, היציאה, הנתיב והפרמטרים.
כל הפרמטרים יהיו בקידוד UTF-8 לפני קידוד כתובות URL.
בקשה
אם תתקבל בקשה לכך, Google מספקת את הפרטים הבאים כפרמטרים של כתובות URL:
| שדות |
|---|
gspMajorVersion
|
int
מספר הגרסה הראשית לבקשה הזו.
|
gspAuthenticationRequest
|
AuthenticationRequest
בקשת אימות.
|
gspAssociationId
|
string
אם הוא קיים, הוא מכיל מזהה שמשמש את מבצע השילוב כדי לחפש את פרטי הכניסה של המשתמש שמתבצעת עליו אתגר. אם הפרטים האלה לא מופיעים,
למשתמש תהיה אפשרות לשנות את זיהוי החשבון.
|
gspCallbackUrl
|
string
כתובת ה-URL שאליה המשתמש יופנה כדי לסיים את תהליך האימות ב-Google. הערך הזה מקודד בכתובת ה-URL.
|
תשובה
אחרי שהאימות יושלם, המשתמש יופנה אוטומטית ל-gspCallbackUrl באמצעות HTTPS GET. כתובת ה-URL הזו חייבת לכלול את הפרמטרים הבאים של השאילתה:
| שדות |
gspResult
|
int
100
|
האימות הצליח.
|
201
|
המשתמש ביטל את התהליך באופן ידני ויש לבטל את הזרימה.
|
202
|
האימות נכשל מסיבה חמורה, ויש לבטל את הזרימה.
|
|
gspAuthenticationResponse
|
AuthenticationResponse
תגובת אימות.
|
כל הזכויות שמורות. Java הוא סימן מסחרי רשום של Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[[["התוכן קל להבנה","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-25 (שעון UTC)."],[[["Integrators must implement a mobile-friendly web host to redirect users for authentication, similar to Android authentication but utilizing a web-based approach."],["The web host should distinguish between mobile and desktop requests using the user-agent header and deliver a mobile-friendly experience for both Android and iOS."],["The server must use HTTPS GET with a definable path and host, supporting URLs up to 2,048 characters, including parameters encoded in UTF-8 before URL encoding."],["Google provides URL parameters for the request including version, authentication request, association ID (for credential lookup), and a callback URL for redirection after authentication."],["Upon authentication completion, the user is redirected to the provided callback URL with parameters indicating the result (success, cancellation, or failure) and an authentication response."]]],["Integrators must host a mobile-friendly website for user authentication, distinguishing between mobile and desktop requests via the user-agent header. The server must utilize HTTPS GET, with a definable path and host, supporting URLs up to 2,048 characters. Google provides parameters like `gspMajorVersion`, `gspAuthenticationRequest`, `gspAssociationId`, and `gspCallbackUrl` within the request. Upon authentication completion, the user is redirected to `gspCallbackUrl` via HTTPS GET, including `gspResult` and `gspAuthenticationResponse` parameters. All parameters are UTF-8 and URL-encoded.\n"]]
