الإعداد السريع لمستخدمي المكوّن الإضافي "منصة خرائط Google"

نافذة نجاح التطبيق المصغّر

إذا كنت بصدد تطوير مكوّن إضافي لمنصة "خرائط Google" على منصات مثل WordPress وShopify وMagento وغيرها، يوضّح هذا الموضوع كيفية إعداد مستخدمي المكوّن الإضافي بسرعة على "منصة خرائط Google" وإنشاء مفتاح API.

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

لمساعدة مستخدمي المكوّن الإضافي في إنشاء مفتاح واجهة برمجة تطبيقات بسرعة، يمكنك توفير رابط أو زر يفتح "أداة البدء السريع"، وهي نافذة منبثقة سهلة الاستخدام توجّه المستخدمين خلال بضع خطوات بسيطة. تساعد أداة Quick Start Widget أيضًا في إبقاء مستخدمي الإضافة على منصتك بدلاً من إرسالهم إلى "وحدة تحكّم Google Cloud" لتنفيذ هذه المهام في نوافذ متعددة.

تشغيل أداة "البدء السريع"

تطبيق Quick Start Widget هو مجرد صفحة ويب يمكنك التحكّم في حجم نافذتها من خلال طلب JavaScript window.open. على سبيل المثال:

<script>
  function openPopupWindow() {
    var winWidth=570;
    var winHeight=700;
    var left = (screen.width-winWidth)/2;
    var top = (screen.height-winHeight)/2;

    window.open('https://console.cloud.google.com/google/maps-hosted', 'Quick Start Widget',
    'resizable=yes,width='+winWidth+',height='+winHeight+',left='+left+',top='+top);
      return false;
  }
</script>

<!-- CTA to generate Google Maps API Key -->
<button type="button" onClick="openPopupWindow()" style="color: white; background-color: #1a73e8" href="#">
    Get an API Key
</button>

قصص نجاح:

عندما ينقر المستخدم على الزر، يتم فتح أداة "البدء السريع" في نافذة منبثقة، ويتم تنفيذ ما يلي أثناء تنقّل المستخدم في الأداة:

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

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

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

الأسئلة الشائعة

هل عليّ الدفع مقابل استخدام أداة "التشغيل السريع"؟

لا، فالأداة Quick Start Widget مجانية ومتاحة لجميع المطوّرين لتسهيل عملية إعداد "منصة خرائط Google".

هل يمكن استخدام أداة "البدء السريع" على WordPress وShopify فقط؟

يمكن استخدام أداة &quot;البدء السريع&quot; على أي موقع إلكتروني تابع لجهة خارجية، وليس فقط على أدوات إنشاء المواقع الإلكترونية أو مواقع التجارة الإلكترونية.

هل يمكن للمنصة التابعة لجهة خارجية الاطّلاع على معلومات الفوترة التي يدخلها المستخدم؟

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

هل يمكنني استخدام مشروعي الحالي ومفتاح واجهة برمجة التطبيقات؟

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

كيف يحافظ مستخدمو المكوّنات الإضافية على أمان مفاتيح واجهة برمجة التطبيقات؟

يقدّم موضوع أفضل الممارسات المتعلّقة بأمان واجهة برمجة التطبيقات إرشادات حول كيفية تأمين مفتاح واجهة برمجة التطبيقات. بعد استخدام أداة &quot;البدء السريع&quot;، يتلقّى المستخدمون أيضًا رسالة إلكترونية تتضمّن تعليمات ورابطًا إلى Google Cloud Console لتأمين مفتاح واجهة برمجة التطبيقات.