تتيح واجهات برمجة التطبيقات المتقدّمة في نصوص "إعلانات Google" البرمجية للمطوّرين الربط ببعض واجهات برمجة التطبيقات العامة من Google من خلال إعدادات أقلّ من استخدام واجهات HTTP. يمكنك استخدام واجهات برمجة التطبيقات هذه مثل الخدمات المضمّنة في النصوص البرمجية، وهي توفّر الميزات نفسها مثل الإكمال التلقائي والمصادقة التلقائية.
يُرجى الرجوع إلى صفحة مقتطفات الرموز للاطّلاع على بعض الأمثلة التي توضّح كيفية استخدام واجهات برمجة التطبيقات هذه.
واجهات برمجة التطبيقات المتقدّمة المتاحة
- إحصاءات Google
- ملاحظة: تستهدف واجهة برمجة التطبيقات المتقدّمة
Analyticsفي مربّع الحوار واجهات برمجة التطبيقات المتقدّمة واجهة برمجة التطبيقات Universal Analytics v3 التي تم إيقافها، ويتعذّر تنفيذ الطلبات المرسَلة إليها. لا تتيح نصوص "إعلانات Google" البرمجية استخدام الخدمات المتقدّمةAnalyticsDataأوAnalyticsAdminفي "إحصاءات Google 4". لطلب بيانات "إحصاءات Google 4" من نص برمجي، أرسِل طلبات HTTPS إلى Google Analytics Data API باستخدام خدمةUrlFetchAppوOAuth 2.0. يمكنك أيضًا ربط موقع على "إحصاءات Google 4" بحسابك على "إعلانات Google" لمشاركة بيانات الإحالات الناجحة على الموقع الإلكتروني والتطبيق مباشرةً. للحصول على تعليمات الإعداد، يُرجى الاطّلاع على دليل إعداد "إحصاءات Google". - Google BigQuery
- يمكنك تحميل كميات كبيرة من البيانات إلى Google Cloud Storage، ثم الاستعلام عن هذه البيانات باستخدام Google BigQuery. على سبيل المثال، يمكنك تحميل بيانات الطقس المتاحة للجميع خلال السنوات العشر الماضية، ثم الاستعلام عن متوسط درجة الحرارة في منطقة معيّنة في نص برمجي يستخدم هذه المعلومات في تعديل عروض الأسعار. ويمكنك أيضًا استخدامها لإجراء عمليات حسابية على بيانات أداء حسابك على مدار عدة سنوات.
- تقويم Google
- يمكن للنص البرمجي إنشاء أحداث للمهام المستقبلية (على سبيل المثال، تشغيل تقرير أداء لحملاتك بعد أسبوعين من اليوم)، أو تنفيذ إجراءات استنادًا إلى إدخال أنشأته في تقويمك (على سبيل المثال، تفعيل حملة في تاريخ معيّن).
- العروض التقديمية من Google
- يمكن للنص البرمجي تصدير تفاصيل الحملة أو إحصاءاتها إلى "العروض التقديمية من Google" لنشر هذه المعلومات بتنسيق قابل للعرض.
- مهام Google
- يمكن أن ينشئ النص البرمجي قائمة تذكيرات للمهام المستقبلية (على سبيل المثال، تشغيل تقرير أداء لحملاتك بعد أسبوعين من اليوم)، أو تنفيذ إجراءات استنادًا إلى إدخال أنشأته في قائمة التذكيرات (على سبيل المثال، تفعيل حملة في تاريخ معيّن).
- Merchant API
- يمكن أن يستخدم النص البرمجي Merchant API لتحميل بيانات المنتجات وإدارتها، وإدارة حساباتك على Google Merchant Center. في النصوص البرمجية، يمكن أن يكون ذلك مفيدًا للتحقّق من بيانات المنتجات وربط منتجات معيّنة بإعلانات معيّنة. تتضمّن Merchant API واجهات برمجة تطبيقات فرعية يمكن تفعيلها بشكل فردي في مربّع الحوار واجهات برمجة التطبيقات المتقدّمة. يمكنك الاطّلاع على مزيد من المعلومات حول ربط حسابك على Google Merchant Center من خلال دليل التسجيل كمطوّر.
- محتوى التسوّق
- يمكن أن يستخدم النص البرمجي Google Content API for Shopping لتحميل بيانات المنتجات وإدارتها، وكذلك إدارة حساباتك على Google Merchant Center. في النصوص البرمجية، يمكن أن يكون ذلك مفيدًا للتحقّق من بيانات المنتجات وربط منتجات معيّنة بإعلانات معيّنة. ملاحظة: سيتم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026. بدلاً من ذلك، يمكنك استخدام Merchant API الموضّحة في القسم السابق.
- YouTube وإحصاءات YouTube
- يمكنك استرداد وتعديل فيديوهاتك وقوائم التشغيل وما إلى ذلك، بالإضافة إلى بيانات أداء فيديوهاتك لاتّخاذ قرارات بشأن عروض الأسعار.
تفعيل واجهات برمجة التطبيقات المتقدّمة
لمعرفة واجهات برمجة تطبيقات Google المتاحة كواجهات برمجة تطبيقات متقدّمة، انقر على واجهات برمجة التطبيقات المتقدّمة في شريط المحرِّر العلوي لعرض مربّع حوار واجهات برمجة التطبيقات المتقدّمة. اختَر واجهات برمجة التطبيقات التي تريد تفعيلها.
انقر على حفظ لحفظ اختياراتك والعودة إلى محرِّر النصوص البرمجية. سيتم تفعيل واجهات برمجة التطبيقات الجديدة للنص البرمجي وستكون متاحة في قائمة الإكمال التلقائي.
اعتبارات أخرى
هناك بعض الأمور التي يجب وضعها في الاعتبار عند العمل مع واجهات برمجة التطبيقات المتقدّمة.
الاعتمادية
يمكن فقط للمستخدم الذي أنشأ النص البرمجي في الحساب تغيير تبعيات واجهات برمجة التطبيقات المتقدّمة لهذا النص البرمجي.
الأذونات
عند الوصول إلى واجهات برمجة التطبيقات المتقدّمة، يستخدم النص البرمجي أذونات المستخدم الذي
سمح بالنص البرمجي. يجب أن يكون لدى المستخدم المفوَّض إذن الوصول المطلوب إلى جميع
البيانات التي يحتاجها النص البرمجي. على سبيل المثال، لاستخدام واجهة برمجة التطبيقات المتقدّمة BigQuery،
يجب أن يملك المستخدم المفوَّض الأذونات المطلوبة لمشروع Google Cloud المستهدَف ومجموعة بيانات BigQuery.
اعتبارات بشأن النصوص البرمجية التي تم إنشاؤها قبل مايو 2019
بالنسبة إلى النصوص البرمجية التي تم إنشاؤها قبل مايو 2019، قد تحتاج إلى تفعيل واجهات برمجة التطبيقات ذات الصلة يدويًا في مشروع Google Cloud المرتبط بالنص البرمجي. يمكنك معرفة ما إذا كان النص البرمجي سيتأثر بهذا التغيير من خلال ظهور رابط إلى Google Cloud Console في مربّع حوار واجهات برمجة التطبيقات المتقدّمة.
تفعيل واجهات برمجة التطبيقات المتقدّمة
بالنسبة إلى النصوص البرمجية التي تم إنشاؤها قبل عام 2019، عليك تفعيل كل واجهة برمجة تطبيقات متقدّمة يدويًا إذا أردت استخدامها في النص البرمجي:
- انقر على الزر واجهات برمجة التطبيقات المتقدّمة. في نافذة الحوار التالية، انقر فوق الرابط إلى Google Cloud Console.
- إذا لم يكن مشروعك محدّدًا، اختَره من القائمة المنسدلة "المشروع".
- ابحث عن واجهات برمجة التطبيقات التي تريد استخدامها في النص البرمجي عن طريق إدخال اسم واجهة برمجة التطبيقات في شريط البحث.
- اختَر واجهة برمجة التطبيقات من نتائج البحث، وانقر على الزر "تفعيل" في الصفحة التالية.
إذا تمت إزالة المستخدم الذي أنشأ النص البرمجي من الحساب لاحقًا، سيُطلب من أي مستخدم جديد يحاول الوصول إلى النص البرمجي تفعيل تبعيات واجهة برمجة التطبيقات المتقدّمة مرة أخرى، بالإضافة إلى إعادة تفويض النص البرمجي.