مكان إدارة معرِّف العميل في Google Cloud Console
تتوفر وظيفة إدارة معرِّف العميل للخطة المميزة في Cloud Console في أسفل صفحة بيانات اعتماد "منصة خرائط Google"، ضمن قسم معرّف العميل.
![منطقة "معرِّف العميل" الجديدة في صفحة "بيانات الاعتماد"](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/premium/images/new-client-id-area.png?authuser=7&hl=ar)
يمكن الوصول إلى المزيد من مهام إدارة معرِّفات العميل، بما في ذلك إدارة تفويض عنوان URL وسر توقيع معرِّف العميل، من خلال صفحة معرِّف العميل المنفصلة، بالنقر على رمز تعديل في أقصى يسار قسم معرِّف العميل.
ملاحظة مهمة: لم تعد الخطة المميّزة في "منصة خرائط Google" متاحة للاشتراك أو للعملاء الجدد.
تتناول هذه الأسئلة الشائعة أسئلة محدّدة بخصوص الخطة المميّزة من "منصة خرائط Google".
يُرجى الرجوع إلى الأسئلة الشائعة حول "منصة خرائط Google" للاطّلاع على الأسئلة الشائعة على جميع "منصة خرائط Google".
الخطوات الأولى
- ما كانت الخطة المميّزة في "منصة خرائط Google"؟
- ما هي واجهات برمجة التطبيقات التي تم تضمينها في الخطة المميّزة من "منصة خرائط Google"؟
- كيف يمكنني إعادة ضبط بيانات اعتماد تسجيل الدخول إلى Google Cloud Console؟
- ما هي بنود الخدمة للخطة المميّزة في "منصة خرائط Google"؟
حدود الاستخدام
- كيف يتم احتساب استخدام الخطة المميّزة في "منصة خرائط Google" ؟
- كيف يمكنني تتبُّع استخدام "الخطة المميّزة" من "منصة خرائط Google" في تطبيقي؟
- لماذا يتم تحصيل رسوم مقابل طلبات "الحصول على تفاصيل واجهة برمجة تطبيقات الأماكن" بسعر واحد بينما يتم تحصيل رسوم أقل بكثير على طلبات الإكمال التلقائي للأماكن.
تطوير تطبيقك
- هل سيتم إصدار رقم تعريف مشروع ومعرّف عميل معًا؟
- هل يجب استخدام كلٍ من مفتاح واجهة برمجة التطبيقات ومعرِّف العميل الخاص بي للمصادقة؟
- هل سيتم تفعيل جميع واجهات برمجة التطبيقات المتاحة في مشروع Google Cloud Console الذي قدّمتُه؟
- ما هي الاختلافات بين مفتاح واجهة برمجة التطبيقات ومعرّف العميل؟
- كيف يمكنني الوصول إلى الميزات المدفوعة للأجهزة الجوّالة باستخدام الخطة المميّزة في "منصة خرائط Google"؟
- هل المكتبة الديناميكية متاحة لنظام التشغيل Android مع الخطة المميّزة في "منصة خرائط Google"؟
- كيف يمكنني الوصول إلى واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" باستخدام معرِّف عميل "الخطة المميّزة" من "منصة خرائط Google" من صفحة تم تحميلها عبر طبقة المقابس الآمنة (SSL)؟
التصميم
الخطوات الأولى
-
أتاحت "الخطة المميّزة" من "منصة خرائط Google" (الخطة المميّزة) للمشاركين إمكانية الوصول إلى مجموعتنا من الخدمات، مع ضمان حصولهم على جميع الأدوات التي يحتاجونها لتنفيذ خرائط قابلة للتخصيص ومتوافقة مع الأجهزة الجوّالة وقابلة للتطوّر في تطبيقاتهم ومواقعهم الإلكترونية.
لم تعد الخطة المميّزة في "منصة خرائط Google" متاحة للاشتراك أو للعملاء الجدد.
- ما هي واجهات برمجة التطبيقات التي تم تضمينها في الخطة المميّزة من "منصة خرائط Google"؟
-
تم تضمين منتجات Google التالية في الخطة المميّزة من "منصة خرائط Google". أما التطبيقات التي تستخدم هذه المنتجات، فقد كانت مشمولة في اتفاقية مستوى الخدمة في "خطة مستوى الخدمة في Google Maps Platform Premium"، وكانت مؤهَّلة للحصول على الدعم الفني.
- واجهة برمجة تطبيقات JavaScript للخرائط
- واجهة برمجة التطبيقات الثابتة في "خرائط Google"
- واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي"
- Geocoding API
- واجهة برمجة التطبيقات لرصد الموقع الجغرافي
- واجهة برمجة التطبيقات Elevation
- واجهة برمجة التطبيقات للاتجاهات
- واجهة برمجة التطبيقات لمصفوفة المسافة
- واجهة برمجة تطبيقات المنطقة الزمنية
- واجهة برمجة تطبيقات الطرق
- Places API ومكتبة الأماكن في واجهة برمجة تطبيقات JavaScript للخرائط *
- حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
- حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS
* Places API غير مشمولة في ترخيص تتبُّع مواد العرض في الخطة المميّزة. إذا كان لديك ترخيص تتبُّع مواد العرض وتريد استخدام Places API، يُرجى التواصل مع فريق مبيعات "خرائط Google".
لا تغطي الخطة المميّزة في "منصة خرائط Google" واجهات برمجة التطبيقات التالية. يجب أن تمتثل التطبيقات التي تستخدم واجهات برمجة التطبيقات هذه لبنود الخدمة المنشورة لواجهات برمجة التطبيقات هذه، ولا تخضع لاتفاقية مستوى الخدمة للخطة المميزة في Google Maps Platform أو مؤهلة للحصول على الدعم الفني:
- كيف يمكنني إعادة ضبط بيانات اعتماد تسجيل الدخول إلى Google Cloud Console؟
-
إعادة ضبط كلمة مرور حسابك على Google يتوفر هذا الرابط أيضًا من صفحة تسجيل الدخول إلى Cloud Console.
- ما هي بنود الخدمة للخطة المميّزة في "منصة خرائط Google"؟
-
إذا كنت أحد عملاء "الخطة المميّزة" من "منصة خرائط Google"، يُرجى الرجوع إلى اتفاقيتك للتعرّف على البنود التي تحكم استخدامك لـ "منصة خرائط Google".
حدود الاستخدام
- كيف يتم احتساب استخدام الخطة المميّزة في "منصة خرائط Google" ؟
-
في السابق، من خلال الخطة المميّزة في "منصة خرائط Google"، كان المشاركون يشترون مسبقًا الأرصدة التي سيتم استخدامها في تطبيقاتهم، وكانوا يستهلكون أسعارًا مختلفة بناءً على واجهات برمجة التطبيقات المطلوبة. في الوقت الحالي، تتوفّر جميع واجهات برمجة التطبيقات بموجب نموذج تسعير "الدفع حسب الاستخدام". لمزيد من المعلومات، يُرجى الاطّلاع على دليل الفوترة في "خرائط Google".
- كيف يمكنني تتبُّع استخدام "الخطة المميّزة" من "منصة خرائط Google" في تطبيقي؟
-
للحصول على معلومات عن تتبُّع استخدام تطبيقك، بالإضافة إلى تقارير الاستخدام والإحصاءات الأخرى، يمكنك الاطّلاع على دليل إعداد تقارير "منصة خرائط Google".
- لماذا يتم تحصيل رسوم مقابل طلبات الحصول على تفاصيل واجهة برمجة تطبيقات الأماكن بينما يتم تحصيل رسوم أقل بكثير على طلبات الإكمال التلقائي للأماكن؟
-
تستخدم Places API قاعدة بيانات شاملة عن الأنشطة التجارية وبيانات الأماكن الأخرى. ويستغرق الحفاظ على دقة قاعدة البيانات هذه الكثير من الوقت والجهد، فتفتح الأنشطة التجارية وتُغلق بشكل متكرر. وبالتالي، نحتاج إلى دفع المزيد مقابل طلبات الحصول على تفاصيل الأماكن. بالنسبة إلى ميزة "الإكمال التلقائي" للأماكن، ندرك أنّ المستخدمين غالبًا ما يحتاجون إلى كتابة عدة أحرف للعثور على مكان، لذلك نحصّل منك مبلغًا أقل بكثير عن كل طلب.
تطوير تطبيقك
- هل تمّ إصدار رقم تعريف مشروع ومعرّف عميل معًا؟
-
تضمّنت رسالة الترحيب الواردة من عملاء "الخطة المميّزة" السابقين كلاً من معرّف المشروع ومعرّف العميل.
- هل يجب أن أستخدم كلاً من مفتاح واجهة برمجة التطبيقات ومعرِّف العميل الخاص بي للمصادقة؟
يمكن للعملاء السابقين في "الخطة المميّزة" تضمين مفتاح واجهة برمجة التطبيقات أو معرّف العميل في طلبات واجهة برمجة التطبيقات، وليس كلاهما. إذا اختَرت استخدام معرِّف العميل، عليك إزالة أيّ مَعلمات
key
. إذا كان طلبك يتضمّن معرِّف عميل ومفتاح واجهة برمجة تطبيقات، قد يواجه تطبيقك سلوكًا أو أخطاءً غير متوقّعة.اعتبارًا من تشرين الثاني (نوفمبر) 2021، ننصح باستخدام مفتاح واجهة برمجة التطبيقات بدلاً من معرّف العميل لأي استخدام جديد للتطبيق.
- هل تم تفعيل جميع واجهات برمجة التطبيقات المتاحة في مشروع Google Cloud Console الذي قدّمتُه؟
-
نعم، من خلال الخطة المميّزة، وفّرنا تلقائيًا جميع واجهات برمجة التطبيقات لمشروع Cloud Console نفسه. ويمكن للعملاء السابقين في "الخطة المميزة" الوصول إلى جميع واجهات برمجة التطبيقات في مشروع واحد. يمكن لواجهات برمجة التطبيقات على النظام الأساسي نفسه (الويب أو خدمات الويب أو Android أو iOS) مشاركة مفتاح واجهة برمجة التطبيقات نفسه.
- ما هي الاختلافات بين مفتاح واجهة برمجة التطبيقات ومعرّف العميل؟
-
باستخدام رقم تعريف مشروعك، يمكنك إنشاء مفاتيح واجهة برمجة التطبيقات في Cloud Console. إليك الاختلافات الأساسية بين استخدام مفاتيح واجهة برمجة التطبيقات ومعرِّف العميل:
- دعم واجهة برمجة التطبيقات: يمكنك استخدام مفتاح واجهة برمجة التطبيقات مع أي من واجهات برمجة التطبيقات للخرائط. بدلاً من ذلك، يمكنك استخدام معرّف العميل مع أي واجهة برمجة تطبيقات، باستثناء Places API وGeolocation API و Roads API وMaps SDK لتطبيقات Android وحزمة تطوير البرامج بالاستناد إلى بيانات الخرائط لنظام التشغيل iOS.
- الأمان: إنّ مفتاحَي واجهة برمجة التطبيقات ومعرّف العميل آمنان بشكل متساوٍ، طالما
يتم اتّباع الإرشادات التالية:
- إذا كنت تستخدم مفتاح واجهة برمجة التطبيقات، تأكَّد من الحفاظ على سرية المفتاح. تستخدم جميع الطلبات الموجّهة إلى واجهات برمجة تطبيقات "خرائط Google" بروتوكول HTTPS، لذلك تكون مخاطر اعتراض أي شخص لحركة بياناتك محدودة. في المقابل، إذا حصل شخص على مفتاحك، يمكنه تقديم طلبات للحصول على واجهات برمجة تطبيقات "خرائط Google" باستخدام مفتاحك. لمنع هذا الخطر على واجهات برمجة التطبيقات من جهة العميل، يمكنك حظر النطاقات التي يمكنها استخدام مفتاحك. بالنسبة إلى واجهات برمجة التطبيقات من جهة الخادم، عليك تقييد مفتاحك بحيث لا يُسمح بالطلبات إلا من عناوين IP المصدر للخوادم. يمكنك الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات للحصول على مزيد من المعلومات حول استخدام مفاتيح واجهة برمجة التطبيقات بأمان.
- إذا كنت تستخدم معرِّف العميل، تأكَّد من الحفاظ على سرية مفتاح التشفير (الذي تستخدمه لإنشاء التوقيعات الرقمية). احرِص أيضًا على عدم استخدام مفتاح التشفير في طلبات البيانات من واجهة برمجة التطبيقات أو استخدامه لتوقيع عناوين URL باستخدام JavaScript، لأنّ هذه الممارسات قد تكشف عن مفتاحك.
- كيف يمكنني الوصول إلى ميزات الأجهزة الجوّالة المدفوعة من خلال الخطة المميّزة في "منصة خرائط Google"؟
-
يمكنك الاستفادة من الميزات المدفوعة الخاصة بالأجهزة الجوّالة باستخدام حِزم تطوير البرامج (SDK) نفسها المتاحة لمستخدمي واجهة برمجة التطبيقات العادية: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS وحزمة تطوير البرامج (SDK) لخدمة "خرائط Google" لنظام التشغيل Android. للوصول إلى الميزات المدفوعة، احرص على استخدام مفتاح واجهة برمجة التطبيقات من المشروع الذي تم إنشاؤه لك أثناء عملية الاشتراك. لإثبات إمكانية وصولك إلى الميزات المدفوعة للأجهزة الجوّالة، حمِّل خريطة باستخدام المكتبة الثابتة. لمزيد من المعلومات، يمكنك الاطّلاع على أدلة بدء استخدام "الخطة المميّزة" على Android وعلى iOS.
- هل تتوفر المكتبة الديناميكية لنظام التشغيل Android مع الخطة المميّزة من "منصة خرائط Google"؟
-
نعم، من خلال الخطة المميّزة، يمكنك أيضًا استخدام المكتبة الديناميكية لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android بدلاً من المكتبة الثابتة. لمزيد من المعلومات، راجِع دليل بدء استخدام الخطة المميّزة على Android.
- كيف يمكنني الوصول إلى واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" باستخدام معرّف عميل الخطة المميّزة في "منصة خرائط Google" من صفحة تم تحميلها عبر بروتوكول HTTPS (طبقة المقابس الآمنة)؟
-
للوصول إلى واجهة برمجة تطبيقات JavaScript للخرائط من صفحة تم تحميلها عبر HTTPS، عليك أولاً تفويض عناوين URL التي تستخدم HTTPS التي تريد استخدام واجهة برمجة التطبيقات عليها.
التصميم
- لماذا لا تظهر الأنشطة التجارية على خريطتي؟
-
عند تحميل خريطة باستخدام واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" بما في ذلك بيانات اعتماد خطتك المميّزة (إما مَعلمة
key
أوclient
)، يتم تلقائيًا إيقاف بيانات الأنشطة التجارية على الخريطة. لتفعيلها مرة أخرى، يجب تضمين بعض رموز التصميم مع خريطتك:var styles = [ { featureType: 'poi.business', stylers: [ { visibility: 'on' } ] } ]; map.setOptions({styles: styles});