קבלת מפתח API
אחרי שהגדרתם את החיוב ואת הפרויקט, הפעלתם את ה-SDK והתקנתם את מנהל יחסי התלות המועדף עליכם ותוכנות אחרות, אתם מוכנים ליצור, להוסיף ולהגביל את מפתח ה-API.
יצירת מפתחות API
מפתח ה-API הוא מזהה ייחודי שמאמת בקשות המשויכות לפרויקט שלכם לצורכי שימוש וחיובים. צריך להיות לפחות מפתח API אחד שמשויך לפרויקט.
כך יוצרים מפתח API:
המסוף
-
עוברים לדף פלטפורמת מפות Google > פרטי כניסה.
-
בדף Credentials, לוחצים על Create credentials > API key.
תיבת הדו-שיח API key created מציגה את מפתח ה-API החדש שיצרתם. -
לוחצים על סגירה.
מפתח ה-API החדש מופיע בדף Credentials בקטע API keys.
(חשוב לזכור להגביל את מפתח ה-API לפני שמשתמשים בו בסביבת הייצור).
Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
מידע נוסף על Google Cloud SDK, על התקנת Cloud SDK ועל הפקודות הבאות:
מפתח ה-API הזה נדרש כשיוצרים את פרויקט Xcode, כפי שמתואר במאמר הגדרת פרויקט Xcode.
הגבלת מפתחות API
Google ממליצה מאוד להגביל את מפתחות ה-API על ידי הגבלת השימוש בהם רק לממשקי ה-API הנחוצים לאפליקציה. הגבלת מפתחות ה-API מוסיפה אבטחה לאפליקציה על ידי הגנה עליה מפני בקשות לא רצויות. למידע נוסף, תוכלו לקרוא את המאמר שיטות מומלצות לאבטחת API.
כדי להגביל מפתח API:
המסוף
-
עוברים לדף פלטפורמת מפות Google > פרטי כניסה.
- בוחרים את מפתח ה-API שרוצים להגדיר לו הגבלה. יופיע הדף של נכס מפתח ה-API.
- בקטע Key restrictions, מגדירים את ההגבלות הבאות:
- הגבלות על אפליקציות:
- בוחרים באפשרות אפליקציות ל-iOS.
- כדי לקבל בקשות מהאפליקציה ל-iOS עם מזהה החבילה שסיפקתם, בוחרים את מזהה החבילה המתאים ל-iOS מהרשימה.
- הגבלות על ממשקי API:
- לוחצים על Restrict key.
- בוחרים באפשרות Maps SDK for iOS בתפריט הנפתח Select APIs. אם ה-SDK של מפות ל-iOS לא מופיע ברשימה, צריך להפעיל אותו.
- כדי לסיים את השינויים, לוחצים על שמירה.
Cloud SDK
הצגת רשימה של המפתחות הקיימים.
gcloud services api-keys list --project="PROJECT"
ביטול ההגבלות הקיימות על מפתח קיים.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
להגדיר הגבלות חדשות על מפתח קיים.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --api-target="maps-ios-backend.googleapis.com" --allowed-bundle-ids="BUNDLE_NAME"
מידע נוסף על Google Cloud SDK, על התקנת Cloud SDK ועל הפקודות הבאות:
עכשיו, אחרי שקיבלת את מפתח ה-API ל-SDK של מפות Google ל-iOS, אפשר להתחיל.
המאמרים הבאים
עכשיו, אחרי שיש לכם מפתח API, תוכלו ליצור ולהגדיר את פרויקט Xcode שלכם כפי שמתואר במאמר הגדרת פרויקט Xcode.