دليل نقل معرّف العميل

نظرة عامة

لزيادة أمان المصادقة وموثوقيتها، تم إيقاف معرّفات عملاء "منصة خرائط Google" نهائيًا اعتبارًا من 26 مايو 2025، ولن يعود بإمكانك استخدامها بعد 31 مايو 2026.

بدلاً من استخدام معرّف عميل، عليك استخدام بيانات اعتماد مفتاح واجهة برمجة التطبيقات لمصادقة زيارات خدمة Google Maps API. يوضّح لك هذا الدليل كيفية الانتقال من استخدام معرّفات العملاء إلى استخدام مفاتيح واجهة برمجة التطبيقات.

يرجى اتباع الخطوات التالية للبدء:

  1. الاطّلاع على استخدام معرّف العميل الحالي
  2. إعداد مفاتيح واجهة برمجة التطبيقات
  3. مراجعة إعدادات الحصة
  4. تعديل الرمز
  5. مراقبة زيارات معرّف العميل
  6. إيقاف معرّف العميل مؤقتًا

الاطّلاع على استخدام معرّف العميل الحالي

قبل بدء عملية نقل البيانات، ضَع قائمة بما يلي:

  • خدمات "منصة خرائط Google" التي تستخدمها مع معرّف العميل
  • التطبيقات أو المواقع الإلكترونية أو الأنظمة التي تستخدم معرّف العميل معها

أرسلت Google رسالة إلكترونية تتضمّن إشعارًا إلى العملاء المتأثرين بإيقاف معرّف العميل نهائيًا في مايو 2025. يمكنك العثور على هذه المعلومات في رسالة الإشعار الإلكترونية أيضًا.

في Cloud Console، يمكنك الاطّلاع على أحدث حالة لاستخدام معرّف العميل في صفحة مقاييس "خرائط Google"

للاطّلاع على قائمة بخدمات "منصة خرائط Google":

  1. افتح صفحة المقاييس في Cloud Console.
  2. فلتر استخدامك باستخدام الإعدادات التالية:
    • بيانات الاعتماد: اختَر "project_number:<numerical identifier>" فقط.
  3. اضبط الفلتر التالي.
    • مجمّع حسب: واجهة برمجة التطبيقات

للاطّلاع على تلميحات حول التطبيقات أو المواقع الإلكترونية أو الأنظمة:

لا يعرض Cloud Console تفاصيل تطبيقاتك أو مواقعك الإلكترونية أو أنظمتك. ولكن يمكنك العثور على بعض التلميحات حول مصادر زيارات معرّف العميل. اتّبِع الخطوات التالية:

  1. افتح صفحة المقاييس في Cloud Console.
  2. اختَر خدمة من "منصة خرائط Google" من القائمة المنسدلة.
  3. فلتر استخدامك باستخدام الإعدادات التالية:
    • بيانات الاعتماد: اختَر "project_number:<numerical identifier>" فقط.
  4. اضبط الفلتر التالي.
    • التجميع حسب: النظام الأساسي أو النطاق
  5. كرِّر الخطوات بدءًا من الخطوة 2 لكل خدمة من خدمات "منصة خرائط Google" تحتاج إلى الاطّلاع على زياراتها.

إعداد مفاتيح واجهة برمجة التطبيقات

ترتبط جميع معرّفات العملاء بمشروع على Google Cloud، وسيمنحك استخدام مفتاح واجهة برمجة تطبيقات من هذا المشروع إمكانية الوصول إلى الميزات نفسها التي سبق لك الوصول إليها باستخدام معرّف العميل. ننصحك بنقل البيانات إلى المشروع المرتبط لتجنُّب حدوث مشاكل في الحصص أو فقدان الميزات.

  1. ابحث عن مشروع Cloud المرتبط بمعرّف العميل:
  2. تأكَّد من أنّ مشروع Cloud مرتبط بحساب فوترة مفتوح.
  3. أنشئ مفتاح واجهة برمجة تطبيقات جديدًا لنقل معرّف العميل.
    • يمكنك إعادة استخدام أي مفاتيح حالية لواجهة برمجة التطبيقات في مشروع Cloud.
    • يمكنك استخدام عدة مفاتيح لواجهة برمجة التطبيقات من مشروع Cloud نفسه، مثلاً لفصل الزيارات لكل خدمة من خدمات "منصة خرائط Google"، أو لفصل الزيارات من منصات مختلفة (المتصفح أو تطبيق الأجهزة الجوّالة وما إلى ذلك). راجِع دليل الأمان للتعرّف على أفضل الممارسات المتعلّقة بإدارة مفاتيح واجهة برمجة التطبيقات.

تأمين مفتاح واجهة برمجة التطبيقات

احرص على تأمين مفتاح واجهة برمجة التطبيقات لحمايته من الوصول غير المصرَّح به.

  • اضبط قيودًا على التطبيق لمفتاح واجهة برمجة التطبيقات (مثل المواقع الإلكترونية أو عناوين IP أو تطبيقات Android أو تطبيقات iOS).
  • اضبط قيودًا على واجهة برمجة التطبيقات لمفتاح واجهة برمجة التطبيقات.

لمزيد من التفاصيل، يُرجى الاطّلاع على إرشادات الأمان في "منصة خرائط Google".

بالنسبة إلى Maps JavaScript API وMaps Static API وStreet View Static API، يمكنك نقل المحيلين الموثوق بهم على معرّف العميل إلى القيود المفروضة على مفتاح واجهة برمجة التطبيقات. يمكنك العثور على قائمة بالمحيلين الموثوق بهم في Cloud Console.

مراجعة إعدادات الحصة

تأكَّد من أنّ لديك إعدادات الحصة المتوقّعة في مشروع Cloud. عليك إجراء ذلك فقط إذا كنت تستدعي خدمات Maps JavaScript API من جهة العميل من معرّف عميل. يمكنك الاطّلاع على إعدادات الحصة وتعديلها على صفحة الحصص في "خرائط Google".

مزيد من المعلومات عن تقارير الحصة

زيادة الحصة لخدمات Maps JavaScript API من جهة العميل

إذا كنت تستخدم الخدمات التالية على Maps JavaScript API، سيظهر لك زيادة في استخدام الحصة بعد نقل البيانات إلى مفتاح واجهة برمجة التطبيقات.

راجِع إعدادات الحصة الحالية والاستخدام الحالي، وع دِّل حدود الحصة وفقًا لذلك.

  1. تأكَّد مما إذا كنت تستخدم خدمات Maps JavaScript API من جهة العميل مع معرّف عميل.
    • افتح صفحة المقاييس في Cloud Console.
    • فلتر استخدامك باستخدام الإعدادات التالية:
      • مجمّع حسب: طريقة واجهة برمجة التطبيقات
      • بيانات الاعتماد: اختَر "project_number:<numerical identifier>" فقط.
    • بعد ذلك، ستظهر لك قائمة بأسماء الطرق مع زياراتها في الرسم البياني "الزيارات حسب طريقة واجهة برمجة التطبيقات".

طريقة واجهة برمجة التطبيقات

الخدمة من جهة العميل

الخدمة التي يجب تعديل الحصة لها

google.routes.Directions.Javascript

Directions Service

واجهة برمجة تطبيقات Directions

google.routes.DistanceMatrix.Javascript

خدمة Distance Matrix

Distance Matrix API

google.maps.Elevation.Javascript

خدمة تحديد الارتفاع

واجهة برمجة تطبيقات Elevation

google.places.Geocoding.Javascript

Geocoding Service

Geocoding API

google.places.*.Javascript، باستثناء google.places.Geocoding.Javascript

Places Library

Places API
  • إذا كنت لا تستخدم طرق واجهة برمجة التطبيقات هذه، لن تحتاج إلى القلق بشأن إعدادات الحصة، لأنّ زيارات معرّف العميل تستهلك حصة مشروعك حاليًا.
  • تقدير استخدام الحصة لمعرّف العميل
    • بالنسبة إلى كل خدمة، اطّلِع على كل من الدقة في الثانية والدقة في اليوم.
    • الرسم البياني "في الثانية": اضرب الحد الأقصى للزيارات في 60 لمعرفة الحصة الإضافية المطلوبة في الدقيقة.
    • الرسم البياني "في اليوم": يجب أن يكون الحد الأقصى للزيارات هو الحصة الإضافية المطلوبة في اليوم.
  • عدِّل الحصة في خدمات "منصة خرائط Google" المقابلة
    • استنادًا إلى اسم الطريقة الذي تعثر عليه في الخطوة 1، عدِّل الحصة في الخدمات المقابلة.

تعديل الرمز

استبدال مَعلمة العميل بمَعلمة المفتاح

عدِّل بيانات المصادقة من URL&client={value} إلى URL&key={value} في طلبات البيانات من GMP API الصادرة. إذا كانت تطبيقاتك تستخدم بروتوكول HTTP للوصول إلى خدمات GMP، عدِّلها لاستخدام بروتوكول HTTPS.

تعديل مَعلمة القناة لإعداد التقارير

يمكنك تتبُّع استخدامك لكل قناة من خلال تحديد مَعلمة القناة لطلبات البيانات من واجهة برمجة التطبيقات. لا تقبل مفاتيح واجهة برمجة التطبيقات سوى القيم الرقمية لمَعلمة القناة. إذا كنت تستخدم معرّف العميل مع أي قيم غير رقمية لمَعلمة القناة، عدِّلها إلى قيمة رقمية من القيم المتوافقة.

لمزيد من المعلومات، يُرجى الاطّلاع على إعداد التقارير في "منصة خرائط Google".

إزالة مَعلمة التوقيع لخدمات الويب

بالنسبة إلى واجهات برمجة التطبيقات التالية لخدمات الويب، لا تكون مَعلمة التوقيع مطلوبة عند الوصول إليها باستخدام مفتاح واجهة برمجة التطبيقات. أزِل مَعلمة التوقيع فقط من طلبات البيانات من واجهة برمجة التطبيقات.

  • Directions API (قديمة)
  • واجهة برمجة تطبيقات Distance Matrix (قديمة)
  • Geocoding API
  • واجهة برمجة تطبيقات Elevation
  • Time Zone API

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على الخطة المميّزة.

توقيع سرّي لواجهات برمجة التطبيقات للصور

لا يزال كل من Maps Static API وStreet View Static API يتطلبان مَعلمة التوقيع. تقبل واجهات برمجة التطبيقات هذه عددًا قليلاً من الطلبات بدون توقيع لأغراض الاختبار، ولكنها تبدأ في عرض أخطاء عند بلوغ الحدّ الأدنى في بيئة الإنتاج. استبدِل التوقيع السرّي الخاص بمعرّف العميل بالتوقيع السرّي الخاص بمفتاح واجهة برمجة التطبيقات. يمكنك استخدام خوارزمية التوقيع نفسها، ولكن عليك استخدام توقيع سرّي آخر. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام توقيع رقمي.

مراقبة زيارات معرّف العميل

بعد النشر، تأكَّد من نقل الزيارات بنجاح باستخدام لوحات البيانات في Cloud Console. ستبدأ في ملاحظة انخفاض في زيارات معرّف العميل، والتي تظهر بتنسيق "project_number:123456" على لوحة البيانات عند التجميع حسب بيانات الاعتماد.

إيقاف معرّف العميل مؤقتًا

ننصح المطوّرين بشدة بإيقاف معرّفات العملاء مؤقتًا بعد نقل البيانات. يساعد ذلك في حماية بيانات الاعتماد من أي زيارات غير مقصودة، والتأكّد من أنّ أي استخدام متبقٍّ لمعرّف العميل ليس مهمًا (مثل الاختبار أو ذاكرات التخزين المؤقت أو برامج التتبُّع وما إلى ذلك) ويمكن أن يعرض أخطاء بدون التأثير في المؤسسة. يمكنك إيقاف معرّف العميل مؤقتًا في Cloud Console. لمزيد من التفاصيل، يُرجى الاطّلاع على نظرة عامة على مصادقة الخطة المميّزة.

تحديد المشاكل وحلّها

كيف يمكننا معرفة ما إذا كان طلبنا يعرض خطأ أم لا؟

يمكنك الاطّلاع على إحصاءات الأخطاء في الرسوم البيانية لرموز الاستجابة

الخطأ ApiNotActivatedMapError أو REQUEST_DENIED

سيظهر لك الخطأ ApiNotActivatedMapError أو REQUEST_DENIED إذا لم تفعِّل الخدمة في مشروع Cloud. اتّبِع التعليمات لتفعيل الخدمة.

الخطأ RefererNotAllowedMapError

سيظهر لك الخطأ RefererNotAllowedMapError إذا لم تتم إضافة نطاق المصدر إلى مفتاح واجهة برمجة التطبيقات. راجِع قسم "تأمين مفتاح واجهة برمجة التطبيقات"، وأضِف نطاقك إلى مفتاح واجهة برمجة التطبيقات.

الخطأ OverQuotaMapError أو OVER_QUERY_LIMIT

سيظهر لك الخطأ OverQuotaMapError أو OVER_QUERY_LIMIT إذا لم تكن الحصة التي ضبطتها كافية لتغطية زياراتك. راجِع قسم "مراجعة إعدادات الحصة"، وعدِّل الحصة وفقًا لذلك.

الخطأ "يجب أن تكون الطلبات إلى واجهة برمجة التطبيقات هذه عبر طبقة المقابس الآمنة"

إذا ظهرت لك رسالة الخطأ التالية، عدِّل طلبات البيانات من واجهة برمجة التطبيقات من "http://" إلى "https://".

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

  "results" : [],

  "status" : "REQUEST_DENIED"
}