تتيح الخدمات المتقدمة في برمجة التطبيقات للمطوّرين ذوي الخبرة الاتصال بعض واجهات Google APIs العامة التي تحتاج إلى إعداد أقل من استخدام واجهات HTTP. أما الخدمات المتقدمة، فهي في الأساس عبارة عن برنامج تضمين رفيع حول واجهات Google APIs هذه. هم مثل لغة برمجة تطبيقات الخدمات المدمجة، على سبيل المثال، تقدم والإكمال التلقائي، وتتعامل "برمجة تطبيقات Google" مع تدفق التفويض تلقائيًا. ومع ذلك، يجب تفعيل خدمة متقدّمة قبل. يمكنك استخدامها في برنامج نصي.
للاطّلاع على واجهات Google APIs المتاحة كخدمات متقدّمة، ابحث عن قسم خدمات Google المتقدمة في المرجع: إذا كنت تريد استخدام واجهة برمجة تطبيقات من Google غير متاحة كخدمة متقدمة، فما عليك سوى الاتصال بها مثل أي خدمة أخرى واجهة برمجة تطبيقات خارجية.
الخدمات المتقدمة أم HTTP؟
ترتبط كل خدمة من خدمات Google المتقدمة بواجهة Google API عامة.
في "برمجة تطبيقات Google"، يمكنك الوصول إلى واجهات برمجة التطبيقات هذه من خلال خدمات متقدّمة أو ببساطة
وإنشاء طلبات واجهة برمجة التطبيقات بشكل مباشر باستخدام
UrlFetch
إذا كنت تستخدم طريقة الخدمة المتقدمة، ستتعامل "برمجة التطبيقات" مع مسار التفويض والعروض دعم الإكمال التلقائي ومع ذلك، يجب عليك تفعيل الخدمة المتقدّمة قبل أن تتمكّن من استخدام بها. بالإضافة إلى ذلك، لا توفر بعض الخدمات المتقدمة إلا مجموعة فرعية من الوظائف المتوفرة في واجهة برمجة التطبيقات.
إذا كنت تستخدم طريقة UrlFetch للوصول إلى واجهة برمجة التطبيقات مباشرةً،
التعامل مع واجهة برمجة تطبيقات Google بشكل أساسي
واجهة برمجة التطبيقات الخارجية. باستخدام هذه الطريقة، سيتم
من جوانب واجهة برمجة التطبيقات. مع ذلك، يجب معالجة واجهة برمجة التطبيقات.
التفويض بنفسك. يجب أيضًا إنشاء أي رؤوس مطلوبة وتحليلها
استجابات واجهة برمجة التطبيقات.
بوجه عام، من الأسهل استخدام إحدى الخدمات المتقدمة حيثما أمكن
استخدام الطريقة UrlFetch عندما لا توفر الخدمة المتقدمة
الوظائف التي تحتاجها.
المتطلبات
قبل أن تتمكّن من استخدام إحدى الخدمات المتقدّمة، عليك استيفاء المتطلبات التالية: المتطلبات:
- يجب تفعيل الخدمة المتقدّمة. في مشروع النص لديك.
يجب التأكد من تفعيل واجهة برمجة التطبيقات المتوافقة مع الخدمة المتقدّمة في مشروع Cloud Platform (GCP) الذي يستخدمه النص.
في حال كان مشروع النص البرمجي يستخدِم مشروع Google Cloud Platform تلقائي تم إنشاؤه في 8 نيسان (أبريل) 2019 أو بعده، سيتم تفعيل واجهة برمجة التطبيقات تلقائيًا بعد تفعيل الخدمة المتقدّمة وحفظ مشروع النص البرمجي. إذا كنت لم تفعل ذلك بالفعل، فربما طُلب منك الموافقة على Google Cloud وGoogle APIs أيضًا.
إذا كان مشروع النص البرمجي يستخدم مشروع Google Cloud Platform عادي أو مشروع Google Cloud Platform تلقائي أقدم، يجب تفعيل واجهة برمجة التطبيقات المقابلة للخدمة المتقدّمة. في مشروع Google Cloud Platform يدويًا. يجب أن يكون لديك الإذن بتعديل مشروع Google Cloud Platform. لإجراء هذا التغيير.
الاطّلاع على مشاريع Cloud Platform لمزيد من المعلومات.
تفعيل الخدمات المتقدمة
لاستخدام إحدى خدمات Google المتقدّمة، يُرجى اتّباع التعليمات التالية:
- افتح مشروع "برمجة تطبيقات Google".
- على يمين الصفحة، انقر على رمز المحرِّر .
- على يمين الشاشة، بجانب الخدمات، انقر على إضافة خدمة.
- اختَر إحدى خدمات Google المتقدّمة وانقر على إضافة.
بعد تفعيل إحدى الخدمات المتقدمة، تصبح متاحة في ميزة الإكمال التلقائي.
طريقة تحديد توقيعات الطرق
تستخدم الخدمات المتقدمة عمومًا الكائنات وأسماء الطرق والمعلمات نفسها كواجهات برمجة التطبيقات العامة المقابلة، على الرغم من ترجمة توقيعات الطرق إلى استخدامها في برمجة التطبيقات. وظيفة محرر النصوص البرمجية وظيفة الإكمال التلقائي عادةً ما توفر معلومات كافية للبدء، ولكن القواعد أدناه توضح كيف تنشئ "برمجة التطبيقات" توقيع طريقة من واجهة Google API عامة.
يمكن أن تقبل طلبات Google APIs أنواعًا مختلفة من البيانات، بما في ذلك مَعلمات المسار و/أو مَعلمات طلب البحث ونص الطلب و/أو الوسائط تحميل المرفق. يمكن لبعض الخدمات المتقدمة أيضًا قبول طلب HTTP محدد. (على سبيل المثال، خدمة "تقويم Google" المتقدمة).
يحتوي توقيع الطريقة المقابل في "برمجة تطبيقات Google" على ما يلي: الوسيطات:
- نص الطلب (يكون عادةً موردًا)، باعتباره كائن JavaScript.
- المسار أو المَعلمات المطلوبة كوسيطات فردية.
- مرفق تحميل الوسائط، كـ
Blobالوسيطة. - المعلمات الاختيارية، كأسماء معلمات تعيين كائن JavaScript القيم.
- عناوين طلبات HTTP، كأسماء عناوين في ربط كائن JavaScript للعنوان القيم.
إذا كانت الطريقة لا تحتوي على أي عناصر في فئة معينة، فإن هذا الجزء من يتم حذف التوقيع.
ثمة بعض الاستثناءات الخاصة التي يجب التنبّه لها:
- بالنسبة إلى الطرق التي تقبل تحميل الوسائط، يتم ضبط المعلمة
uploadTypeتلقائيًا. - يُطلق على الطرق المسماة
deleteفي Google API اسمremoveفي "برمجة تطبيقات Google". لأنّdeleteهي كلمة محجوزة في JavaScript. - إذا تمت تهيئة خدمة متقدمة لقبول عناوين طلبات HTTP، ضبط كائن JavaScript لعناوين الطلبات، ففي هذه الحالة عليك أيضًا تحديد كائن JavaScript للمعلمات (إلى كائن فارغ إذا كنت لا تستخدم المعلمات الاختيارية).
دعم الخدمات المتقدّمة
والخدمات المتقدمة هي عبارة عن برنامج تضمينات من شأنها أن تتيح استخدام حساب واجهات برمجة التطبيقات في "برمجة تطبيقات Google" وبناءً على ذلك، فإن أي مشكلة تحدث أثناء استخدامها هي مشكلة عادةً في واجهة برمجة التطبيقات الأساسية، وليس في برمجة التطبيقات نفسها.
أما إذا واجهت أي مشكلة أثناء استخدام إحدى الخدمات المتقدمة، فينبغي أن تكون باستخدام إرشادات الدعم لواجهة برمجة التطبيقات الأساسية. روابط إلى هذه هذا الدليل في كل دليل خدمة متقدمة في قسم مرجع برمجة التطبيقات.