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

סקירה כללית

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

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

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

לפני שמתחילים בתהליך ההעברה, צריך לרשום את הפרטים הבאים:

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

במאי 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 לכל שירות של Maps Platform שרוצים לבדוק את התנועה שלו.

הכנת מפתחות 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, אפשר להעביר את כתובות ה-referrer המהימנות במזהה הלקוח להגבלות על מפתח ה-API. אפשר למצוא את רשימת מקורות התנועה המהימנים במסוף Cloud.

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

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

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

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

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

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

  1. בודקים אם אתם משתמשים בשירותים בצד הלקוח של Maps JavaScript API עם מזהה לקוח.
    • פותחים את הדף Metrics במסוף Cloud.
    • מסננים את השימוש באמצעות ההגדרות הבאות:
      • הקיבוץ לפי: שיטת 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 API

google.places.Geocoding.Javascript

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

Geocoding API

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

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

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

עדכון הקוד

החלפת פרמטר הלקוח בפרמטר המפתח

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

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

כדי לעקוב אחרי השימוש בערוצים, צריך לציין את פרמטר הערוץ בבקשות ה-API. מפתחות API תומכים רק בערכים מספריים בפרמטר channel. אם אתם משתמשים במזהה הלקוח עם ערכים לא מספריים כלשהם לפרמטר 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.

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

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

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

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

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

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

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

במקרים שבהם למשתמשים אין גישה למדדי הפרויקט, יכול להיות שימושי לבדוק את דוחות החיוב. לדוגמה, אדמינים של חיוב (במיוחד שותפים של Maps Platform). לדוחות החיוב יש השהיה של יום עד יומיים, אבל היתרון שלהם הוא שהם מציגים נתונים על שימוש ועלויות מלפני יותר מ-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)

אם דומיין המקור לא נוסף למפתח ה-API, תופיע השגיאה RefererNotAllowedMapError. מעיינים בקטע 'אבטחת מפתח 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"
}