קבלת מפתח API

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

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

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

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

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

המסוף

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

    לדף Credentials

  2. בדף Credentials, לוחצים על Create credentials > מפתח API.
    תיבת הדו-שיח API key created מציגה את מפתח ה-API החדש שיצרתם.
  3. לוחצים על סגירה.
    מפתח ה-API החדש מופיע בדף Credentials בקטע מפתחות API.
    (חשוב לזכור להגביל את מפתח ה-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:

המסוף

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

    לדף Credentials

  2. בוחרים את מפתח ה-API שרוצים להגדיר עליו הגבלה. מופיע דף המאפיין של מפתח ה-API.
  3. בקטע Key restrictions, מגדירים את ההגבלות הבאות:
    • הגבלות על אפליקציות:
      1. בוחרים באפשרות אפליקציות ל-iOS.
      2. כדי לאשר בקשות מהאפליקציה ל-iOS באמצעות מזהה החבילה שסיפקתם, צריך לבחור מהרשימה את מזהה החבילה המתאים ב-iOS.
    • הגבלות על ממשקי API:
      1. לוחצים על Restrict key.
      2. בוחרים באפשרות מפות SDK ל-iOS בתפריט הנפתח Select APIs. אם ה-SDK של מפות Google ל-iOS לא מופיע ברשימה, צריך enable אותו.
  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 ועל הפקודות הבאות:

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

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

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