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

نظرة عامة

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

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 لكل خدمة من &quot;منصة خرائط Google&quot; تريد التحقّق من عدد الزيارات إليها.

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

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

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

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

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

• اضبط قيودًا على تطبيق مفتاح واجهة برمجة التطبيقات (مثل المواقع الإلكترونية أو عناوين 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>" فقط.
   • بعد ذلك، ستظهر لك قائمة بأسماء الطرق مع عدد الزيارات في الرسم البياني "الزيارات حسب طريقة واجهة برمجة التطبيقات".

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

تعديل الرمز

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

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

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

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

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

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

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

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

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

Signing Secret for Imagery APIs

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

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

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

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

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

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

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

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

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

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

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

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

يمكن أن يكون التحقّق من تقارير الفوترة بدلاً من مقاييس المشروع مفيدًا للمستخدمين الذين لا يمكنهم الوصول إلى مقاييس المشروع، مثل مشرفي الفوترة (خاصةً شركاء "منصة خرائط 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"
}