تسمح واجهات برمجة التطبيقات المتقدمة في النصوص البرمجية في إعلانات Google للمطورين ذوي الخبرة بالاتصال ببعض واجهات Google APIs العامة بإعداد أقل مقارنةً باستخدام واجهات HTTP. أنت تستخدم واجهات برمجة التطبيقات هذه مثل الخدمات المضمنة في النصوص البرمجية إلى حد كبير، وتقدم وسائل الراحة نفسها مثل الإكمال التلقائي والتفويض التلقائي.
الاستخدامات الممكنة لواجهات برمجة التطبيقات المتقدمة
- إحصاءات Google
- يمكنك أيضًا استخدام "إحصاءات Google" لتتبُّع عدد الزيارات الواردة إلى موقعك الإلكتروني وتعديل عروض أسعار حملاتك وفقًا لذلك. إذا ربطت موقعًا على "إحصاءات Google" بحسابك على "إعلانات Google"، يمكنك أيضًا تحليل نشاط العملاء على موقعك الإلكتروني. ويمكن لهذه المعلومات أن تسلّط الضوء على عدد الزيارات أو المبيعات التي تحقّقها موقعك الإلكتروني من خلال "إعلانات Google"، وتساعدك على تحسين إعلاناتك وموقعك الإلكتروني. يمكنك الاطّلاع على مزيد من المعلومات عن ربط حساب "إحصاءات Google" بحساب "إعلانات Google" في مركز المساعدة.
- Google BigQuery
- يمكنك تحميل كميات كبيرة من البيانات إلى Google Cloud Storage، ثم الاستعلام عن تلك البيانات باستخدام Google BigQuery. على سبيل المثال، يمكنك تحميل بيانات الطقس العامة للأعوام العشرة الماضية، ثم الاستعلام عن متوسط درجة الحرارة لمنطقة ما في نص برمجي يستخدم هذه المعلومات في تعديل عروض الأسعار. وهناك استخدام آخر وهو مراجعة بيانات أداء حسابك على مدار عدة سنوات.
- YouTube و"إحصاءات YouTube"
- يمكنك استرداد الفيديوهات وقوائم التشغيل وغيرها وتعديلها، بالإضافة إلى بيانات أداء فيديوهاتك، وذلك لاتخاذ قرارات بشأن عروض الأسعار.
- تقويم Google
- يمكن للنص البرمجي إنشاء أحداث للمهام المستقبلية (على سبيل المثال، تنفيذ تقرير أداء لحملاتك بعد أسبوعين من اليوم)، أو تنفيذ إجراءات استنادًا إلى إدخال أنشأته في تقويمك (على سبيل المثال، تفعيل حملة في تاريخ محدّد).
- محتوى Shopping
- يمكن أن يستخدم النص البرمجي Google Content API for Shopping في "برمجة التطبيقات". تتيح واجهة برمجة التطبيقات هذه لمستخدمي Google Merchant Center إمكانية تحميل بيانات منتجاتهم وإدارتها، فضلاً عن إدارة حساباتهم على Merchant Center. في النصوص البرمجية، قد يكون هذا الإجراء مفيدًا للتحقق من بيانات المنتجات وربط منتجات معيّنة بإعلانات معيّنة.
- مهام Google
- يمكن للنص البرمجي إنشاء قائمة تذكيرات للمهام المستقبلية (على سبيل المثال، تنفيذ تقرير أداء لحملاتك بعد أسبوعَين من اليوم)، أو تنفيذ إجراءات استنادًا إلى إدخال أنشأته في قائمة التذكير (على سبيل المثال، تفعيل حملة في تاريخ محدّد).
- العروض التقديمية من Google
- يمكن للنص البرمجي تصدير تفاصيل الحملة أو إحصاءاتها إلى "العروض التقديمية من Google" لنشر هذه المعلومات بتنسيق قابل للعرض.
تفعيل واجهات برمجة التطبيقات المتقدمة
لمعرفة Google APIs المتاحة كواجهات برمجة تطبيقات متقدّمة، انقر على الزرّ واجهات برمجة التطبيقات المتقدّمة في شريط المحرّر العلوي.
سيؤدي ذلك إلى ظهور مربّع الحوار Advanced APIs (واجهات برمجة التطبيقات المتقدّمة). تحقَّق من واجهات برمجة التطبيقات التي تريد تفعيلها.
بعد ذلك، انقر على رابط وحدة تحكم واجهة برمجة تطبيقات Google لإظهار صفحة وحدة تحكم واجهة برمجة التطبيقات في وحدة التحكم، مع المشروع المرتبط بالنص البرمجي؛ أو إذا لم يتم تحديد مشروعك بالفعل، حدده من القائمة المنسدلة للمشروع. ابحث عن واجهات برمجة التطبيقات التي تريد استخدامها في النص البرمجي من خلال إدخال اسم واجهة برمجة التطبيقات في شريط البحث.
في نتائج البحث، اختَر واجهة برمجة التطبيقات، وفي الصفحة التالية، اختَر تفعيل. وإذا ظهر لك الزر إيقاف، يعني ذلك أنّه سبق أن تم تفعيل واجهة برمجة التطبيقات هذه. كرِّر هذا الإجراء لكل واجهة برمجة تطبيقات تريد تفعيلها.
لعرض قائمة بواجهات برمجة التطبيقات المفعَّلة للمشروع، اختَر صفحة لوحة البيانات. تأكَّد من إدراج جميع واجهات برمجة التطبيقات المتقدّمة التي تريد استخدامها في النص البرمجي.
أغلق الآن مربّع حوار واجهات برمجة التطبيقات المتقدّمة للعودة إلى المحرِّر. سيتم تفعيل واجهات برمجة التطبيقات الجديدة للنص البرمجي وستصبح متوفرة في قائمة الإكمال التلقائي.
واجهات برمجة التطبيقات المتاحة
تتوفّر واجهات برمجة التطبيقات التالية للاستخدام:
| اسم واجهة برمجة التطبيقات | الوثائق |
|---|---|
| إحصاءات Google | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| تقويم Google | https://developers.google.com/apps-script/advanced/calendar |
| العروض التقديمية من Google | https://developers.google.com/apps-script/advanced/slides |
| مهام Google | https://developers.google.com/apps-script/advanced/tasks |
| محتوى Shopping | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| إحصاءات YouTube | https://developers.google.com/apps-script/advanced/youtube-analytics |
يمكنك أيضًا الرجوع إلى صفحة مقتطفات الرمز للاطّلاع على بعض الأمثلة حول كيفية استخدام واجهات برمجة التطبيقات هذه.
نقاط أخيرة يجب أخذها في الاعتبار
هناك بعض النقاط التي يجب أخذها في الاعتبار عند العمل باستخدام واجهات برمجة التطبيقات المتقدمة.
رقم تعريف المشروع
يحتوي كل نص برمجي في "إعلانات Google" على رقم تعريف مشروع في Google Cloud Platform (يُعرف أيضًا باسم رقم المشروع) مرتبطًا به. يمكنك العثور على رقم مشروع النص البرمجي عن طريق فتح صفحة وحدة التحكم في واجهة Google API من مربع الحوار واجهات برمجة التطبيقات المتقدمة. يتم إنشاء رقم تعريف المشروع عند إنشاء النص البرمجي، ويتم ربطه بالمستخدم الذي أنشأ النص البرمجي في "إعلانات Google". إذا تمت إزالة المستخدم الذي أنشأ النص البرمجي لاحقًا من الحساب، سيُطلب من المستخدم الذي يحاول الوصول إلى النص البرمجي إعادة تفويض النص البرمجي وإعداد تبعيات واجهة برمجة التطبيقات المتقدمة مرة أخرى. سيتم أيضًا إنشاء معرّف مشروع جديد لمطوّر برامج Google، وستحتاج إلى إعداد واجهات برمجة التطبيقات المتقدمة مرة أخرى، كما هو موضّح سابقًا في هذا المستند.
التبعيات
يمكن للمستخدم الذي أنشأ النص البرمجي في الحساب فقط تغيير تبعيات واجهات برمجة التطبيقات المتقدمة لهذا النص البرمجي.
الأذونات
عند الوصول إلى واجهات برمجة التطبيقات، يستخدم النص البرمجي أذونات المستخدم الذي فوَّض النص البرمجي. تأكّد من أنّ المستخدم الذي فوَّض النص البرمجي لديه إذن الوصول المطلوب إلى جميع واجهات برمجة التطبيقات المتقدمة التي يتم استخدامها، فضلاً عن البيانات التي يحتاج إليها النص البرمجي. إذا كنت تستخدم Google Analytics API، تأكّد من أنّ المستخدم الذي فوّض النص البرمجي يملك الأذونات اللازمة لحساب "إحصاءات Google" الذي يتم الوصول إليه.
الأحكام والشروط
قد تشتمل كل واجهة من واجهات برمجة التطبيقات المتقدمة على أحكام وشروط خاصة بها عليك قبولها عند تفعيل واجهة برمجة التطبيقات في وحدة تحكم واجهة Google API.
الحصة
تتمتع معظم واجهات برمجة التطبيقات المتقدمة بحصة يومية مجانية مرتبطة بها. بعد أن يتجاوز النص البرمجي هذه الحصة، ستتوقف واجهة برمجة التطبيقات عن العمل إلى أن تطلب بيانات إضافية أو يتم تجديد الحصة المجانية. يمكنك مراقبة الحصة التي يستخدمها النص البرمجي عن طريق فتح وحدة التحكم في واجهة Google API للنص البرمجي من مربّع الحوار واجهات برمجة التطبيقات المتقدّمة. كما توفر وحدة تحكم واجهة برمجة تطبيقات Google طريقة لطلب حصة إضافية لواجهة برمجة التطبيقات.
الفوترة
تتطلب منك بعض واجهات برمجة التطبيقات المتقدمة الدفع مقابل الاستخدام. تتم إدارة هذه الدفعات من خلال مشروع Google Cloud Platform المرتبط بالنص البرمجي، وليس من خلال "إعلانات Google". راجِع المستندات لمعرفة المزيد من التفاصيل حول كيفية تفعيل الفوترة لمشروع Google Cloud Platform الخاص بنصك البرمجي.