קבלת מפתח API

בחירת פלטפורמה: Android iOS JavaScript

אחרי שהגדרתם את החיוב והפרויקט, הפעלתם את ה-SDK והתקנתם את מנהל יחסי התלות המועדף עליכם ותוכנות אחרות, אתם מוכנים ליצור, להוסיף ולהגביל את מפתח ה-API.

יצירת מפתחות API

מפתח ה-API הוא מזהה ייחודי שמאמת בקשות המשויכות לפרויקט שלכם לצורכי שימוש וחיובים. צריך להיות לפחות מפתח API אחד שמשויך לפרויקט.

כך יוצרים מפתח API:

המסוף

1. עוברים לדף פלטפורמת מפות Google > פרטי כניסה.

   כניסה לדף Credentials

2. בדף Credentials, לוחצים על Create credentials > API key.
   תיבת הדו-שיח API key created מציגה את מפתח ה-API החדש שיצרתם.
3. לוחצים על סגירה.
   מפתח ה-API החדש מופיע בדף Credentials בקטע API keys.
   (חשוב לזכור להגביל את מפתח ה-API לפני שמשתמשים בו בסביבת הייצור).

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

מידע נוסף על Google Cloud SDK, על התקנת Cloud SDK ועל הפקודות הבאות:

• gcloud alpha services api-keys create

מפתח ה-API הזה נדרש כשיוצרים את פרויקט Xcode, כפי שמתואר במאמר הגדרת פרויקט Xcode.

הערה: אפשר להשתמש באותו מפתח API באפליקציות SDK של מפות ל-iOS ו-SDK של מפות Google ל-iOS.

הגבלת מפתחות API

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

כשמגבילים מפתח API במסוף Cloud, ההגבלות על האפליקציה מבטלות את ההגבלות על ממשקי ה-API שהוגדרו בקטע הגבלות על ממשקי API. מומלץ ליצור מפתח API נפרד לכל אפליקציה ולכל פלטפורמה שבה האפליקציה זמינה.

כדי להגביל מפתח API:

המסוף

1. עוברים לדף פלטפורמת מפות Google > פרטי כניסה.

   כניסה לדף Credentials

2. בוחרים את מפתח ה-API שרוצים להגדיר לו הגבלה. יופיע הדף של נכס מפתח ה-API.
3. בקטע Key restrictions, מגדירים את ההגבלות הבאות:
• הגבלות על אפליקציות:
1. בוחרים באפשרות אפליקציות ל-iOS.
2. כדי לקבל בקשות מהאפליקציה ל-iOS עם מזהה החבילה שסיפקתם, בוחרים את מזהה החבילה המתאים ל-iOS מהרשימה.
• הגבלות על ממשקי API:
1. לוחצים על Restrict key.
2. בוחרים באפשרות Maps SDK for iOS בתפריט הנפתח Select APIs. אם ה-SDK של מפות ל-iOS לא מופיע ברשימה, צריך להפעיל אותו.
4. כדי לסיים את השינויים, לוחצים על שמירה.
   

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 ועל הפקודות הבאות:

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

עכשיו, אחרי שקיבלת את מפתח ה-API ל-SDK של מפות Google ל-iOS, אפשר להתחיל.

המאמרים הבאים

עכשיו, אחרי שיש לכם מפתח API, תוכלו ליצור ולהגדיר את פרויקט Xcode שלכם כפי שמתואר במאמר הגדרת פרויקט Xcode.