קבלת מפתח API

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

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

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

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

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

המסוף

1. עוברים לדף Google Maps Platform > Credentials (הפלטפורמה של מפות Google > פרטי כניסה).

   מעבר לדף Credentials

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

Cloud SDK

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

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

• gcloud services api-keys create

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

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

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

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

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

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

המסוף

1. עוברים לדף Google Maps Platform > Credentials (הפלטפורמה של מפות Google > פרטי כניסה).

   מעבר לדף Credentials

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

Cloud SDK

מציגים רשימה של מפתחות קיימים.

gcloud services api-keys list --project="PROJECT"

ניקוי ההגבלות הקיימות במפתח הקיים.

gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

הגדרת הגבלות חדשות על מפתח קיים.

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=maps-ios-backend.googleapis.com
    --allowed-bundle-ids="BUNDLE_NAME"

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

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

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

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

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