Google Cloud API هو العنصر الأساسي في Google Cloud Platform. يساعد المستخدمين على تنفيذ قوة كل شيء بدءًا من الوصول إلى التخزين إلى تحليلات الصور القائمة على التعلم الآلي إلى تطبيقات Cloud Platform الخاصة بهم.
يمكن الوصول إلى Cloud APIs من تطبيقات الخادم مع مكتبات عملاء Google في مجموعة واسعة من لغات البرمجة المعروفة ، وأيضًا من تطبيقات الأجهزة المحمولة المزودة بحزم Firebase SDK ، أو عبر عملاء تابعين لجهات خارجية.
أنواع واجهات برمجة التطبيقات
هناك أكثر من 20 فئة من واجهات برمجة التطبيقات في مكتبة Google. دعونا نناقش بعضها.
للحصول على مزيد من المعلومات حول كل واجهة برمجة تطبيقات تقدمها Google ، قم بزيارة مكتبة API . الآن بعد أن اخترت تلك التي تلبي احتياجاتك ، دعنا ننتقل إلى الخطوة التالية.
كيفية العمل مع Cloud APIs
أول شيء تحتاجه للعمل مع Cloud APIs هو حساب Google. يسمح لك بتطبيق منتجات مطوري Google مثل Cloud Console و Stackdriver Logging and Monitoring. إذا لم يكن لديك حساب Google حتى الآن ، يمكنك التسجيل بالضغط هنا .
الخطوة 1. إنشاء مشروع Google
لاستخدام أي من Cloud APIs ، يجب أن يكون لديك مشروع Google يعادل حساب مطور. تعمل كحاوية ملاذ لموارد Google Cloud Platform (GCP) وتوفر حدًا للعزل لاستخدام خدماتها. يمكنك إنشاء مشروعك باستخدام Cloud Console .
يمكن أن يمتلك مشروعك نطاقًا واسعًا من الموارد ، على سبيل المثال ، مفاتيح واجهة برمجة التطبيقات وعملاء OAuth وقواعد بيانات BigQuery. عندما يستدعي أحد التطبيقات Cloud API ، يُطلق على المشروع الذي يمتلك بيانات اعتماد التطبيق اسم مشروع العميل ، بينما يُطلق على المشروع الذي يمتلك المورد المستهدف اسم مشروع المورد. أيضًا ، قد يتطرق طلب واحد لواجهة برمجة التطبيقات إلى موارد متعددة.
الخطوة 2. تمكين واجهات برمجة التطبيقات
لاستخدام Cloud API ، يجب عليك تمكينها لمشروعك أو مشاريعك (إن وجدت). لتمكين واجهة برمجة التطبيقات (API) ، يتعين عليك قبول شروط الخدمة ومسؤولية الفواتير الخاصة بواجهة برمجة التطبيقات.
لتمكين واجهة برمجة التطبيقات ، اتبع الخطوات التالية:
- افتح مكتبة Google Cloud Console API.
- حدد مشروعًا من قائمة المشاريع ، أو أنشئ مشروعًا جديدًا.
- في مكتبة API ، حدد API الذي تريد تمكينه.
- انقر فوق تمكين في صفحة API.
أنت حر دائمًا في تعطيل واجهة برمجة التطبيقات لمشروعك في نفس الصفحة إذا لم تعد تستخدمها. يمكن أيضًا تمكين Cloud API أو تعطيله عن طريق Cloud SDK و Service Usage API.
الخطوة 3. ابدأ في إنشاء التطبيقات
لإنشاء التطبيقات بمساعدة Cloud APIs ، يوصى بتطبيق Google Cloud Client Libraries إذا كان ذلك متاحًا. تتعامل جميع مكتبات السحابة مع ميزات واجهة برمجة التطبيقات الشائعة: المصادقة ومعالجة الأخطاء وإعادة المحاولة والتحقق من صحة الحمولة.
للعمل بنجاح مع تطبيقات Google Cloud ، يتعين على المستخدمين إنشاء مفاتيح API. دعونا نرى كيف يمكن القيام بذلك.
استخدام والحصول على مفاتيح API
مفتاح API عبارة عن سلسلة مشفرة بسيطة تستخدم لاستدعاء واجهة برمجة تطبيقات معينة لا تحتاج إلى الوصول إلى بيانات المستخدم الخاصة. إنها ميزة مفيدة في العملاء مثل المتصفح وتطبيقات الجوال التي لا تحتوي على خادم خلفي.
جميع مفاتيح API لها بعض القيود:
- يسمح فقط عدد محدود من خدمات Google Cloud بالوصول باستخدام مفتاح API فقط ، دون استخدام نوع آخر من بيانات الاعتماد.
- لا يمكنك تقييد الوصول إلى حسابات خدمة أو مستخدمين محددين لأن مفاتيح واجهة برمجة التطبيقات لا تحدد مستخدم التطبيق الذي يقوم بطلب واجهة برمجة التطبيقات.
- من الأسهل على الآخرين استخدام مفتاح API الخاص بك.
بسبب القيود المذكورة أعلاه ، توصي Google باستخدام تدفق المصادقة القياسي. ولكن هناك حالات محدودة عندما تكون مفاتيح API أكثر ملاءمة.
1. إنشاء مفتاح API الخاص بك
يجب منح حسابك دور المحرر الأساسي في المشروع الحالي حتى تتمكن من إنشاء مفتاح API.
لإنشاء مفتاح API ، اتبع الخطوات التالية:
- انتقل إلى واجهات برمجة التطبيقات والخدمات → لوحة بيانات الاعتماد في وحدة التحكم السحابية.
- اختر خيار إنشاء بيانات الاعتماد ثم حدد مفتاح API من القائمة المنسدلة.
- سيعرض مربع الحوار المفتاح الذي تم إنشاؤه حديثًا.
في حالة احتياجك إلى تحديد صفحات الويب أو عناوين IP أو التطبيقات التي يمكنها استخدام مفتاح API الخاص بك ، يمكنك إضافة قيود التطبيق بناءً على نوع التطبيق الخاص بك. ضع في اعتبارك أنه يمكنك فقط تعيين نوع تقييد واحد لكل مفتاح API.
2. استخدم مفتاح API الخاص بك
للقيام بذلك ، يجب عليك تمرير مفتاح API إلى استدعاء REST API كمعامل استعلام بالتنسيق التالي. استبدل API_KEY هنا بمفتاح API الخاص بك:
وإليك مثال على تمرير مفتاح API لطلب API سحابة اللغة الطبيعية ل documents.analyzeEntities :
3. تأمين مفاتيح API الخاصة بك
يجب عليك دائمًا الحفاظ على أمان مفتاح API الخاص بك. اتبع هذه الممارسات لجعلها ممكنة:
- لا تقم أبدًا بتضمين مفاتيح واجهة برمجة التطبيقات مباشرةً في التعليمات البرمجية حيث قد يتم عرضها للجمهور عن طريق الخطأ.
- لا تقم بتخزين مفاتيح API الخاصة بك في ملفات داخل شجرة مصدر التطبيق الخاص بك.
- بدء التطبيق وقيود المفتاح. يمكن أن يمنع هذا تأثير مفتاح API المخترق.
- لا تنس حذف جميع مفاتيح API غير الضرورية.
- قم بإعادة إنشاء مفاتيح API الخاصة بك بشكل دوري من صفحة بيانات الاعتماد .
- تأكد من أن التعليمات البرمجية الخاصة بك لا تحتوي على مفاتيح API قبل تحريرها.
بعد التأكد من أن مفاتيح API الخاصة بك آمنة ، حان الوقت لإضافة قيود.
4. إضافة قيود إلى مفاتيح API
جميع مفاتيح API غير مقيدة بشكل افتراضي. يجب عليك تقييدها لمنع عرضها علنًا – على سبيل المثال ، من متصفح أو على جهاز حيث يتم الاحتفاظ بالمفتاح.
اتبع هذه الخطوات لإضافة قيود مفتاح API:
- انتقل إلى واجهات برمجة التطبيقات والخدمات → قسم بيانات الاعتماد في Cloud Console.
- اختر اسم مفتاح API الحالي.
يمكنك أيضًا إضافة قيود التطبيق. تحدد هذه المواقع أو عناوين IP أو التطبيقات التي يمكنها استخدام مفتاح API.
هناك خمسة أنواع من القيود يمكنك الاختيار من بينها وفقًا لاحتياجات تطبيقك:
- لا يمكن استخدام أي منها لأغراض الاختبار فقط.
- يمكن استخدام إحالات HTTP لعملاء واجهة برمجة التطبيقات التي تعمل على متصفح الويب.
- يمكن استخدام عناوين IP لتقييد وصول مفتاح API إلى بعض عناوين IP المعينة.
- تطبيقات Android متوفرة لتطبيقات Android.
- يمكن لتطبيقات iOS تقييد استدعاءات API لحزم iOS معينة.
أسعار وحدود Google Cloud Platform
تحتوي منصة Google Cloud API على الكثير من خيارات التسعير لجميع أنواع العملاء. يمكنك رؤيتها جميعًا في صفحة قائمة الأسعار .
ولكن هناك أيضًا Free Tier – فهو يضمن الاستخدام المجاني حتى الحدود الشهرية للمنتجات المحددة ، بما في ذلك BigQuery و Compute Engine. تتضمن خيارات Google السحابية المجانية وظائف السحابة والتخزين وغير ذلك الكثير.
على سبيل المثال:
| اسم | حدود |
| واجهة برمجة تطبيقات تقويم Google | 1،000،000 استفسار يوميًا |
| واجهة برمجة تطبيقات محرر مستندات Google | شحن مجاني |
| واجهة برمجة تطبيقات Gmail | 1،000،000،000 وحدة حصص في اليوم |
| Sheets API | 500 طلب لكل 100 ثانية لكل مشروع ، 100 طلب لكل 100 ثانية لكل مستخدم |
بالنسبة لأولئك الذين يريدون معرفة تكلفة الخدمات المدفوعة ، هناك حاسبة تسعير . للاستخدام ، ما عليك سوى ملء جميع الحقول الفارغة والاطلاع على التكلفة على Google Cloud Products المحسوبة بشكل مناسب لاحتياجاتك.