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

نظرة عامة

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

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

التحقّق من استخدام معرِّف العميل الحالي

قبل بدء عملية نقل البيانات، يجب إدراج ما يلي:

• "خدمات منصة خرائط 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. تأكَّد من أنّ مشروعك على السحابة الإلكترونية مرتبط بحساب فوترة مفتوح.
3. أنشئ مفتاح واجهة برمجة التطبيقات لنقل معرّف العميل.
   • يمكنك إعادة استخدام أي مفاتيح حالية لواجهة برمجة التطبيقات في مشروع Cloud.
   • يمكنك استخدام عدة مفاتيح لواجهة برمجة التطبيقات من مشروع على السحابة الإلكترونية نفسه، على سبيل المثال، لفصل عدد الزيارات لكل خدمة من خدمات "منصة خرائط Google"، أو لفصل عدد الزيارات من منصات مختلفة (المتصفّح وتطبيق الأجهزة الجوّالة وما إلى ذلك). يُرجى الرجوع إلى دليل الأمان للاطّلاع على أفضل الممارسات المتعلّقة بإدارة مفاتيح واجهة برمجة التطبيقات.

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

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

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

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

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

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

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

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

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

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

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

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

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

تعديل الرمز

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إعادة تفعيل معرّف العميل مؤقتًا من خلال الخدمة الذاتية

بما أنّ معرّفات عملاء "منصة خرائط Google" دخلت فترة الإيقاف التدريجي في مايو 2026، لم يعُد توفّر الخدمة مضمونًا. سيتم حظر الوصول بشكل دوري كجزء من عملية إنهاء الخدمة المجدوَلة. على الرغم من أنّ الخدمة تتم استعادتها عادةً تلقائيًا في غضون بضع ساعات، يمكنك اختيار إعادة تفعيل إمكانية الوصول يدويًا إذا كانت الاستعادة الفورية مطلوبة.

لاستعادة إمكانية الوصول بشكل عاجل، يمكنك إعادة تفعيل الخدمة الذاتية من خلال Google Cloud Console:

• انتقِل إلى صفحة بيانات الاعتماد في "منصة خرائط Google".
• ابحثوا عن مشروعكم المحدّد على Cloud المرتبط بمعرّف العميل.
• انقر على رمز استئناف الخدمة في أقصى يسار الإدخال لاستعادة الخدمة.

إذا لم تتمكّن من الانتقال بسرعة إلى مفاتيح واجهة برمجة التطبيقات وأردت أن يتم إعفاؤك مؤقتًا من أي انقطاعات أخرى، يُرجى التواصل مع فريق الدعم في "منصة خرائط Google" وتقديم التفاصيل التالية:

• معرِّف العميل
• حالة استخدام معيّنة
• تاريخ النقل المستهدَف
• تقييم التأثير في المؤسسة

تقرير استخدام معرّف العميل - من تقارير الفوترة

يمكن أن يكون الاطّلاع على تقارير الفوترة بدلاً من مقاييس المشروع مفيدًا للمستخدمين الذين ليس لديهم إذن الوصول إلى مقاييس المشروع، مثل مشرفي الفوترة (خاصةً شركاء "منصة خرائط Google"). على الرغم من أنّ "تقارير الفوترة" تتأخر لمدة يوم أو يومين، إلا أنّها تتيح عرض إحصاءات الاستخدام والتكلفة لأكثر من 30 يومًا.

يمكنك مراقبة استخدام معرِّف العميل من خلال Google Cloud Console باتّباع الخطوات التالية:

1. انتقِل إلى صفحة الفوترة > التقارير في Google Cloud Console.
2. (اختياري، ينطبق على الشركاء فقط) طبِّق فلترًا لاختيار حساب الفوترة الفرعي المطلوب.
3. تجميع بيانات التقرير حسب مفتاح التصنيف goog-maps-api-key-suffix يعرض هذا التصنيف الأحرف اللاحقة لمفتاح واجهة برمجة التطبيقات.
4. يمكنك تحديد زيارات معرّف العميل من خلال البحث عن الإدخالات التي لا تتضمّن التصنيف goog-maps-api-key-suffix أو التي يكون فيها هذا التصنيف فارغًا، لأنّه لا تتم تعبئته لطلبات معرّف العميل.
5. تجاهَل رموز التخزين التعريفية التي لا يُفترض ربطها بطلبات البيانات من واجهة برمجة التطبيقات، مثل رموز التخزين التعريفية للاشتراكات.

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

كيف يمكننا معرفة ما إذا كان طلبنا يتعذّر تنفيذه أم لا؟

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

خطأ "ApiNotActivatedMapError" أو "REQUEST_DENIED"

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

خطأ واحد (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"
}