تتيح واجهات برمجة التطبيقات المتقدّمة في النصوص البرمجية لإعلانات 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 من خلال دليل التسجيل كمطوّر برامج.
- محتوى تسوّق
- يمكن للنص البرمجي استخدام 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.
- إذا لم يكن مشروعك محدّدًا بعد، اختَره من القائمة المنسدلة "المشروع".
- ابحث عن واجهات برمجة التطبيقات التي تريد استخدامها في النص البرمجي من خلال إدخال اسم واجهة برمجة التطبيقات في شريط البحث.
- اختَر واجهة برمجة التطبيقات من نتائج البحث، وانقر على الزر "تفعيل" في الصفحة التالية.
إذا تمت إزالة المستخدم الذي أنشأ النص البرمجي من الحساب لاحقًا، سيُطلب من أي مستخدم جديد يحاول الوصول إلى النص البرمجي تفعيل الاعتماديات على واجهات برمجة التطبيقات المتقدّمة مرة أخرى، بالإضافة إلى إعادة منح الإذن للنص البرمجي.