إذا كنت بصدد تطوير مكوّن إضافي لمنصة خرائط Google لمنصات مثل WordPress وShopify وMigento وغيرها، يصف هذا الموضوع كيفية إعداد مستخدمي المكوّن الإضافي بسرعة إلى "منصة خرائط Google" وإنشاء مفتاح واجهة برمجة التطبيقات.
يرتبط مفتاح واجهة برمجة التطبيقات، الذي يحتاج المكوّن الإضافي إلى إرساله مع كل طلب إلى "منصة خرائط Google"، بحساب المستخدم على Google ومعلومات الفوترة، ويتيح إمكانية الوصول إلى ميزات إنشاء الخرائط في المكوّن الإضافي.
لمساعدة مستخدمي المكوّن الإضافي في إنشاء مفتاح واجهة برمجة التطبيقات بسرعة، قدِّم رابطًا أو زرًا يشغِّل أداة التشغيل السريع، وهي نافذة منبثقة ملائمة توجّه المستخدمين خلال بضع خطوات بسيطة. وتحتفظ أيضًا أداة البدء السريع بمستخدمي المكونات الإضافية في منصتك بدلاً من إرسالهم إلى Google Cloud Console لتنفيذ هذه المهام في نوافذ متعددة.
تشغيل أداة البدء السريع
إنّ أداة البدء السريع هي مجرد صفحة ويب يمكنك التحكّم في حجم نافذتها من خلال استدعاء window.open بلغة JavaScript. مثلاً:
<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، حيث يمكنه الحصول على مفتاح واجهة برمجة تطبيقات حالي أو إنشاء مفتاح جديد.
يمكنك توجيه مستخدمي المكوّن الإضافي إلى الموضوع لمحة عن أداة البدء السريع للحصول على مزيد من المعلومات.
الأسئلة الشائعة
هل يتعين عليّ الدفع مقابل استخدام أداة البدء السريع؟
لا، أداة البدء السريع مجانية ومتاحة لجميع المطوّرين لتسهيل عملية إعداد "منصة خرائط Google".
هل يمكن استخدام Quick Start Widget (أداة البدء السريع) فقط على WordPress وShopify؟
يمكن استخدام أداة البدء السريع على أي موقع ويب تابع لجهة خارجية، وليس فقط على أدوات إنشاء مواقع الويب أو مواقع التجارة الإلكترونية.
هل يمكن للمنصة التابعة لجهة خارجية عرض معلومات الفوترة التي يُدخِلها المستخدم؟
بعد إجراء المستخدمين للمصادقة مع Google، لا يمكن الوصول إلى معلومات الفوترة وغيرها من المعلومات إلا من قِبَلهم. لا يمكن لمطوّري البرامج ومنصّات الجهات الخارجية الوصول إلى هذه المعلومات.
هل يمكنني استخدام مشروعي الحالي ومفتاح واجهة برمجة التطبيقات الحاليَّين؟
إذا كان لديك حساب حالي على "منصة خرائط Google"، ستعيدك أداة البدء السريع إلى توجيهك إلى Google Cloud Console حيث يمكنك استخدام مفتاح واجهة برمجة تطبيقات حالي أو إنشاء مفتاح جديد.
كيف يؤمن مستخدمو المكونات الإضافية مفاتيح واجهة برمجة التطبيقات الخاصة بهم؟
يوفر موضوع أفضل ممارسات أمان واجهة برمجة التطبيقات إرشادات حول تأمين مفتاح واجهة برمجة التطبيقات. بعد استخدام أداة "البدء السريع"، يتلقّى المستخدمون أيضًا رسالة إلكترونية تحتوي على تعليمات ورابط إلى Google Cloud Console لتأمين مفتاح واجهة برمجة التطبيقات.