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

نظرة عامة

لزيادة أمان المصادقة وموثوقيتها، تم إيقاف معرّفات عملاء منصّة "خرائط 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".

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

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

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

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

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

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

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

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

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

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

خدمة لتعديل الحصة

google.routes.Directions.Javascript

خدمة الاتجاهات

Directions API

google.routes.DistanceMatrix.Javascript

خدمة Distance Matrix

Distance Matrix API

google.maps.Elevation.Javascript

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

Elevation API

google.places.Geocoding.Javascript

خدمة الترميز الجغرافي

Geocoding API

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

مكتبة الأماكن

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

تعديل الرمز

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

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

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

  • Directions API (الإصدار القديم)
  • Distance Matrix API (الإصدار القديم)
  • Geocoding API
  • Elevation API
  • Time Zone API

اطّلِع على نظرة عامة على الخطة المدفوعة لمزيد من المعلومات.

مفتاح التوقيع لواجهات برمجة التطبيقات لصور "خرائط Google"

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

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

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

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

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

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

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

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

خطأ 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"
}