تتيح واجهات برمجة التطبيقات المتقدّمة في نصوص "إعلانات Google" البرمجية للمطوّرين الاتصال بواجهات برمجة تطبيقات Google العلنية معيّنة من خلال إعدادات أقلّ من استخدام واجهات HTTP. يمكنك استخدام واجهات برمجة التطبيقات هذه بشكلٍ مشابه للخدمات المضمّنة في البرامج النصية، وهي تقدّم الميزات نفسها، مثل الإكمال التلقائي والتخويل التلقائي.
يُرجى الرجوع إلى صفحة مقتطفات الرموز البرمجية للاطّلاع على بعض الأمثلة التي توضّح كيفية استخدام واجهات برمجة التطبيقات هذه.
واجهات برمجة التطبيقات المتقدّمة المتاحة
- إحصاءات Google
- يمكنك استخدام "إحصاءات Google" لتتبُّع عدد الزيارات إلى موقعك الإلكتروني وتعديل عروض أسعار حملتك وفقًا لذلك. إذا ربطت موقعًا على "إحصاءات Google" بحسابك على "إعلانات Google"، يمكنك أيضًا تحليل نشاط العملاء على موقعك الإلكتروني. ويمكن لهذه المعلومات أن تسلّط الضوء على عدد الزيارات أو المبيعات التي تتحقق في موقعك الإلكتروني من خلال "إعلانات Google"، كما تساعدك على تحسين أداء إعلاناتك وموقعك الإلكتروني. يمكنك الاطّلاع على مزيد من المعلومات عن ربط حسابات "إحصاءات Google" و"إعلانات 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 من خلال دليل التسجيل كمطوّر برامج.
- محتوى Shopping
- يمكن للبرنامج النصي استخدام Google Content API for Shopping لتحميل قوائم منتجاتك وإدارتها وإدارة حساباتك على Google Merchant Center. في البرامج النصية، يمكن أن يكون ذلك مفيدًا للتحقّق من قوائم المنتجات وربط منتجات معيّنة بإعلانات معيّنة. ملاحظة: سيتم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026. يمكنك استخدام Merchant API الموضّحة في القسم السابق بدلاً من ذلك.
- YouTube و"إحصاءات YouTube"
- يمكنك استرداد فيديوهاتك وقوائم التشغيل وما إلى ذلك وتعديلها، بالإضافة إلى بيانات أداء فيديوهاتك لاتّخاذ قرارات بشأن عروض الأسعار.
تفعيل واجهات برمجة التطبيقات المتقدّمة
للاطّلاع على واجهات برمجة تطبيقات Google المتاحة كواجهات برمجة تطبيقات متقدّمة، انقر على واجهات برمجة التطبيقات المتقدّمة في شريط المحرّر العلوي لعرض مربّع حوار واجهات برمجة التطبيقات المتقدّمة. اختَر واجهات برمجة التطبيقات التي تريد تفعيلها.
انقر على حفظ لحفظ اختياراتك والرجوع إلى محرّر البرامج النصية. سيتم تفعيل واجهات برمجة التطبيقات الجديدة لبرنامجك النصي وستكون متاحة في قائمة الإكمال التلقائي.
اعتبارات أخرى
هناك بعض العوامل التي يجب أخذها في الاعتبار عند استخدام واجهات برمجة التطبيقات المتقدّمة.
الاعتمادية
لا يمكن لأحد تغيير الاعتماديات على واجهات برمجة التطبيقات المتقدّمة لبرنامج نصي معيّن سوى المستخدم الذي أنشأ البرنامج النصي في الحساب.
الأذونات
عند الوصول إلى واجهات برمجة التطبيقات، يستخدم البرنامج النصي أذونات المستخدم الذي خوّل البرنامج النصي. تأكَّد من أنّ المستخدم الذي خوّل البرنامج النصي لديه إذن الوصول المطلوب إلى جميع البيانات التي يحتاجها البرنامج النصي. إذا كنت تستخدم Google Analytics API، تأكَّد من أنّ المستخدم الذي خوّل البرنامج النصي لديه الأذونات اللازمة لحساب "إحصاءات Google" الذي يتم الوصول إليه.
اعتبارات البرامج النصية التي تم إنشاؤها قبل مايو 2019
بالنسبة إلى البرامج النصية التي تم إنشاؤها قبل مايو 2019، قد تحتاج إلى تفعيل واجهات برمجة التطبيقات ذات الصلة يدويًا في مشروع Google Cloud المرتبط بالبرنامج النصي. ستعرف ما إذا كان البرنامج النصي متأثرًا إذا ظهر لك رابط يؤدي إلى Google Cloud Console في مربّع حوار واجهات برمجة التطبيقات المتقدّمة.
تفعيل واجهات برمجة التطبيقات المتقدّمة
بالنسبة إلى البرامج النصية التي تم إنشاؤها قبل عام 2019، عليك تفعيل كل واجهة برمجة تطبيقات متقدّمة تريد استخدامها في البرنامج النصي يدويًا:
- انقر على الزر واجهات برمجة التطبيقات المتقدّمة. في مربّع الحوار التالي، انقر على الرابط الذي يؤدي إلى Google Cloud Console.
- إذا لم يكن مشروعك محدّدًا بعد، اختَره من القائمة المنسدلة "المشروع".
- ابحث عن واجهات برمجة التطبيقات التي تريد استخدامها في البرنامج النصي من خلال إدخال اسم واجهة برمجة التطبيقات في شريط البحث.
- اختَر واجهة برمجة التطبيقات من نتائج البحث، وانقر على الزر "تفعيل" في الصفحة التالية.
إذا تمت إزالة المستخدم الذي أنشأ البرنامج النصي من الحساب لاحقًا، سيُطلب من أي مستخدم جديد يحاول الوصول إلى البرنامج النصي تفعيل الاعتماديات على واجهات برمجة التطبيقات المتقدّمة مرة أخرى، بالإضافة إلى إعادة تخويل البرنامج النصي.