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

نظرة عامة

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

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، وسيمنحك استخدام مفتاح واجهة برمجة التطبيقات من هذا المشروع إمكانية الوصول إلى الميزات نفسها التي سبق لك الوصول إليها باستخدام رقم تعريف العميل. ننصحك بنقل بياناتك إلى المشروع المرتبط لتجنُّب المشاكل المتعلّقة بالحِصص أو الميزات غير المتوفّرة.

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

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

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

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

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

تعديل الرمز

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك تتبُّع استخدام معرّف العميل من خلال &quot;وحدة تحكّم Google Cloud&quot; باتّباع الخطوات التالية:

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"
}