מדריך להעברת מזהי לקוחות

סקירה כללית

כדי להתחיל, צריך לבצע את ההוראות הבאות:

  1. בדיקת השימוש הנוכחי במזהה הלקוח
  2. הכנת מפתחות API
  3. בדיקת הגדרות המכסות
  4. עדכון הקוד
  5. מעקב אחרי התנועה של מזהה הלקוח
  6. השהיית מזהה הלקוח
  7. הפעלה מחדש זמנית של מזהה לקוח בשירות עצמי

בדיקת השימוש הנוכחי במזהה הלקוח

לפני שמתחילים בתהליך ההעברה, צריך להכין רשימה של:

  • שירותי הפלטפורמה של מפות Google שבהם אתם משתמשים עם מזהה הלקוח שלכם.
  • אפליקציות, אתרים או מערכות שבהם אתם משתמשים במזהה הלקוח שלכם.

במאי 2025, Google שלחה התראה באימייל ללקוחות שהושפעו מהוצאה משימוש של מזהה הלקוח. המידע הזה מופיע גם בהתראה באימייל.

במסוף Cloud, אתם יכולים לבדוק את הסטטוס העדכני של השימוש במזהה הלקוח בדף המדדים של מפות Google.

לרשימה של שירותי הפלטפורמה של מפות Google:

  1. פותחים את הדף Metrics במסוף Cloud.
  2. מסננים את השימוש באמצעות ההגדרות הבאות:
    • פרטי כניסה: בוחרים רק באפשרות "project_number:<numerical identifier>".
  3. מגדירים את המסנן הבא.
    • קיבוץ לפי: API

לרמזים לגבי אפליקציות, אתרים או מערכות:

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

  1. פותחים את הדף Metrics במסוף Cloud.
  2. בוחרים שירות של הפלטפורמה של מפות Google מהתפריט הנפתח.
  3. מסננים את השימוש באמצעות ההגדרות הבאות:
    • פרטי כניסה: בוחרים רק באפשרות "project_number:<numerical identifier>".
  4. מגדירים את המסנן הבא.
    • קיבוץ לפי: פלטפורמה או דומיין
  5. חוזרים על הפעולות משלב 2 לכל שירות של הפלטפורמה של מפות Google שרוצים לבדוק את התנועה שלו.

הכנת מפתחות API

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

  1. מאתרים את הפרויקט ב-Cloud שמזהה הלקוח מקושר אליו:
  2. מוודאים שפרויקט הענן שלכם מקושר לחשבון לחיוב פתוח.
  3. יוצרים מפתח API חדש להעברת מזהה הלקוח.
    • אתם יכולים להשתמש שוב במפתחות API קיימים בפרויקט בענן.
    • אתם יכולים להשתמש בכמה מפתחות API מאותו פרויקט ב-Cloud, למשל כדי להפריד בין התנועה לכל שירות בפלטפורמה של מפות Google, או כדי להפריד בין התנועה מפלטפורמות שונות (דפדפן, אפליקציה לנייד וכו'). במדריך האבטחה מפורטות השיטות המומלצות לניהול מפתחות API.

אבטחה של מפתח ה-API

חשוב לאבטח את מפתח ה-API כדי להגן עליו מפני גישה לא מורשית.

  • מגדירים הגבלה על אפליקציות למפתח ה-API (למשל: אתרים, כתובות IP, אפליקציות ל-Android או אפליקציות ל-iOS).
  • מגדירים הגבלות על מפתח ה-API.

פרטים נוספים זמינים בהנחיות האבטחה של Google Maps Platform.

ב-Maps JavaScript API, ב-Maps Static API וב-Street View Static API, אתם יכולים להעביר את הגורמים המפנים המהימנים במזהה הלקוח להגבלות על מפתחות ה-API. רשימת הגורמים המפנים המהימנים מופיעה במסוף Cloud.

בדיקת הגדרות המכסות

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

מידע נוסף על דוחות מכסות

הגדלת המכסה לשירותים בצד הלקוח של Maps JavaScript API

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

בודקים את הגדרת המכסה הנוכחית ואת השימוש הנוכחי, ומשנים את מגבלות המכסה בהתאם.

  1. בודקים אם אתם משתמשים בשירותים בצד הלקוח של Maps JavaScript API עם מזהה לקוח.
    • פותחים את הדף Metrics במסוף Cloud.
    • מסננים את השימוש באמצעות ההגדרות הבאות:
      • קיבוץ לפי: ה-Method ב-API
      • פרטי כניסה: בוחרים רק באפשרות "project_number:<numerical identifier>".
    • אחר כך תופיע רשימה של שמות השיטות עם התנועה שלהן בתרשים "תנועה לפי שיטת API".

ה-Method ב-API

שירות בצד הלקוח

שירות לשינוי המכסה

google.routes.Directions.Javascript

Directions Service

Directions API

google.routes.DistanceMatrix.Javascript

שירות מטריצת מרחקים

Distance Matrix API

google.maps.Elevation.Javascript

שירות Elevation

Elevation API

google.places.Geocoding.Javascript

שירות המרת כתובות לקואורדינטות (geocoding)

Geocoding API

‫google.places.*.Javascript, חוץ מ-google.places.Geocoding.Javascript

ספריית מקומות

Places API
  • אם אתם לא משתמשים בשיטות ה-API האלה, אתם לא צריכים לדאוג לגבי הגדרות המכסות, כי התנועה של מזהה הלקוח כבר צורכת את המכסה של הפרויקט.
  • הערכת השימוש במכסת מזהי הלקוח
    • לכל אחד מהשירותים, בודקים את רמת הפירוט Per Second ו-Per Day.
    • בתרשים "לשנייה": מכפילים את שיא התנועה ב-60 כדי לקבל את המכסה הנוספת לדקה שצריך.
    • תרשים "ליום": שיא התנועה צריך להיות המכסה הנוספת ליום שנדרשת.
  • לשנות את המכסה בשירותים הרלוונטיים של הפלטפורמה של מפות Google
    • בהתאם לשם השיטה שמצאתם בשלב 1, משנים את המכסה בשירותים המתאימים.

עדכון הקוד

החלפת הפרמטר client בפרמטר key

מעדכנים את פרטי הכניסה לאימות מ-URL&client={value} ל-URL&key={value} בקריאות ל-API של GMP היוצאות. אם האפליקציות שלכם משתמשות ב-HTTP כדי לגשת לשירותי GMP, צריך לעדכן אותן כך שישתמשו ב-HTTPS.

עדכון פרמטר הערוץ לצורך דיווח

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

מידע נוסף זמין במאמר בנושא דוחות בפלטפורמה של מפות Google.

הסרת פרמטר החתימה לשירותי אינטרנט

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

  • ‫Directions API (הגרסה הקודמת)
  • ‫Distance Matrix API (הגרסה הקודמת)
  • Geocoding API
  • Elevation API
  • Time Zone API

מידע נוסף זמין בסקירה הכללית על תוכנית Premium.

מפתח חתימה לממשקי API של תמונות

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

מעקב אחרי התנועה של מזהה הלקוח

אחרי הפריסה, צריך לוודא שהתנועה הועברה בהצלחה באמצעות מרכזי הבקרה במסוף Cloud. תתחילו לראות ירידה בתנועה של מזהה הלקוח, שמוצגת בפורמט "project_number:123456" במרכז הבקרה כשמקבצים לפי פרטי כניסה.

השהיית מזהה הלקוח

אנחנו ממליצים מאוד למפתחים להשהות את מזהי הלקוחות אחרי ההעברה. כך תוכלו להגן על פרטי הכניסה שלכם מפני תנועה לא מכוונת, ולוודא שכל שימוש שנותר במזהה הלקוח שלכם לא קריטי (למשל בדיקות, מטמונים, בוטים וכו') ויכול להחזיר שגיאות בלי להשפיע על העסק. אפשר להשהות את מזהה הלקוח במסוף Cloud. לפרטים נוספים, ראו סקירה כללית על אימות בתוכנית Premium.

הפעלה מחדש זמנית של מזהה לקוח בשירות עצמי

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

כדי לשחזר את הגישה באופן דחוף, אפשר לבצע הפעלה מחדש בשירות עצמי דרך מסוף Google Cloud:

  • נכנסים לדף Credentials בפלטפורמה של מפות Google.
  • מאתרים את פרויקט הענן הספציפי שמקושר למזהה הלקוח.
  • כדי להחזיר את השירות, לוחצים על סמל ביטול ההשהיה בקצה השמאלי של הרשומה.

אם אינכם יכולים לעבור במהירות למפתחות API ורוצים לקבל פטור זמני מהפסקות נוספות, פנו לצוות התמיכה של Google Maps Platform עם הפרטים הבאים:

  • Client-ID
  • תרחיש שימוש ספציפי
  • תאריך היעד להעברה
  • הערכת ההשפעה על העסק

דוח שימוש במזהה לקוח – מתוך דוחות החיוב

בדיקה של דוחות החיוב במקום מדדי הפרויקט יכולה להיות שימושית למשתמשים שאין להם גישה למדדי הפרויקט, למשל אדמינים לענייני חיוב (במיוחד שותפים של הפלטפורמה של מפות Google). למרות שהנתונים בדוחות החיוב מתעדכנים באיחור של יום או יומיים, היתרון שלהם הוא שהם מציגים תובנות לגבי השימוש והעלויות במשך יותר מ-30 יום.

כדי לעקוב אחרי השימוש במזהה הלקוח דרך מסוף Google Cloud:

  1. נכנסים לדף Billing > Reports במסוף Google Cloud.
  2. (אופציונלי, רלוונטי רק לשותפים) מפעילים מסנן כדי לבחור את החשבון המשני לחיוב הרצוי.
  3. מקבלים את נתוני הדוח לפי מפתח התווית goog-maps-api-key-suffix. בתווית הזו מוצגים התווים האחרונים של מפתח ה-API.
  4. כדי לזהות תנועה של מזהה לקוח, חפשו רשומות שבהן התווית goog-maps-api-key-suffix חסרה או ריקה, כי התווית הזו לא מאוכלסת בבקשות של מזהה לקוח.
  5. התעלמו ממק"טים שלא אמורים להיות משויכים לבקשות API, למשל מק"טים של מינויים.

פתרון בעיות

איך אפשר לראות אם הבקשה נכשלה או לא?

אפשר לבדוק את הנתונים הסטטיסטיים של השגיאות בתרשימים של קודי התגובה.

שגיאה מסוג ApiNotActivatedMapError או REQUEST_DENIED

אם לא הפעלתם את השירות בפרויקט בענן, תופיע השגיאה ApiNotActivatedMapError או REQUEST_DENIED. פועלים לפי ההוראות כדי להפעיל את השירות.

שגיאה אחת (RefererNotAllowedMapError)

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

שגיאה מסוג OverQuotaMapError או OVER_QUERY_LIMIT

אם המכסה שהגדרתם לא מספיקה כדי לכסות את התנועה, תראו את השגיאה OverQuotaMapError או OVER_QUERY_LIMIT. בודקים את הקטע "בדיקת הגדרות המכסות" ומשנים את המכסה בהתאם.

השגיאה "בקשות ל-API הזה חייבות להיות דרך SSL"

אם מופיעה הודעת השגיאה הבאה, צריך לעדכן את בקשות ה-API מ-"http://‎" ל-"https://‎".

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}