تتيح واجهات برمجة التطبيقات المتقدّمة في نصوص "إعلانات 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 API المتاحة كواجهات برمجة تطبيقات متقدّمة، انقر على الزر واجهات برمجة التطبيقات المتقدّمة في شريط المحرّر العلوي.
سيؤدي ذلك إلى فتح مربّع الحوار واجهات برمجة التطبيقات المتقدّمة. ضَع علامة في مربّع واجهات برمجة التطبيقات التي تريد تفعيلها.
بعد ذلك، انقر على الرابط وحدة تحكّم Google API لفتح صفحة وحدة تحكّم API في وحدة التحكّم، مع المشروع المرتبط ببرنامجك النصي. إذا لم يكن مشروعك محدّدًا بعد، اختَره من القائمة المنسدلة "المشروع". ابحث عن واجهات برمجة التطبيقات التي تريد استخدامها في برنامجك النصي عن طريق إدخال اسم واجهة برمجة التطبيقات في شريط البحث.
في نتائج البحث، اختَر واجهة برمجة التطبيقات، وفي الصفحة التالية، انقر على تفعيل. إذا ظهر لك الزر إيقاف، يعني ذلك أنّ واجهة برمجة التطبيقات هذه مفعَّلة حاليًا . كرِّر هذا الإجراء لكل واجهة برمجة تطبيقات تريد تفعيلها.
للاطّلاع على قائمة واجهات برمجة التطبيقات المفعَّلة للمشروع، اختَر صفحة لوحة البيانات. تأكَّد من إدراج جميع واجهات برمجة التطبيقات المتقدّمة التي تريد استخدامها للبرنامج النصي.
أغلِق الآن مربّع الحوار "واجهات برمجة التطبيقات المتقدّمة" للرجوع إلى المحرّر. سيتم تفعيل واجهات برمجة التطبيقات الجديدة لبرنامجك النصي وستكون متاحة في قائمة الإكمال التلقائي.
نقاط أخيرة يجب أخذها في الاعتبار
هناك بعض النقاط التي يجب أخذها في الاعتبار عند استخدام واجهات برمجة التطبيقات المتقدّمة.
رقم تعريف المشروع
لكل برنامج نصي في "إعلانات Google" رقم تعريف مشروع على Google Cloud (يُعرف أيضًا باسم رقم المشروع) مرتبط به. يمكنك العثور على رقم تعريف مشروع البرنامج النصي عن طريق فتح صفحة وحدة تحكّم Google API من مربّع الحوار واجهات برمجة التطبيقات المتقدّمة. يتم إنشاء رقم تعريف المشروع هذا عند إنشاء البرنامج النصي، وهو مرتبط بالمستخدم الذي أنشأ البرنامج النصي في "إعلانات Google". إذا تمت إزالة المستخدم الذي أنشأ البرنامج النصي من الحساب لاحقًا، سيُطلب من المستخدم الذي يحاول الوصول إلى البرنامج النصي إعادة تفويضه وإعداد تبعيات واجهة برمجة التطبيقات المتقدّمة مرة أخرى. سيتم أيضًا إنشاء رقم تعريف جديد لمشروع المطوّر على Google، وعليك إعداد واجهات برمجة التطبيقات المتقدّمة مرة أخرى، كما هو موضّح سابقًا في هذا المستند.
الاعتمادية
لا يمكن لأحد تغيير تبعيات واجهات برمجة التطبيقات المتقدّمة للبرنامج النصي سوى المستخدم الذي أنشأ البرنامج النصي في الحساب.
الأذونات
عند الوصول إلى واجهات برمجة التطبيقات، يستخدم البرنامج النصي أذونات المستخدم الذي فوّض البرنامج النصي. تأكَّد من أنّ المستخدم الذي فوّض البرنامج النصي لديه إذن الوصول المطلوب إلى جميع واجهات برمجة التطبيقات المتقدّمة المستخدَمة، بالإضافة إلى البيانات التي يحتاجها البرنامج النصي. إذا كنت تستخدم Google Analytics API، تأكَّد من أنّ المستخدم الذي فوّض البرنامج النصي لديه الأذونات اللازمة لحساب "إحصاءات Google" الذي يتم الوصول إليه.
الأحكام والشروط
قد يكون لكل واجهة من واجهات برمجة التطبيقات المتقدّمة أحكام وشروط خاصة بها يجب الموافقة عليها عند تفعيل واجهة برمجة التطبيقات في وحدة تحكّم Google API.
Quota
تتضمّن معظم واجهات برمجة التطبيقات المتقدّمة حصة يومية مجانية مرتبطة بها. بعد أن يتجاوز برنامجك النصي هذه الحصة، ستتوقف واجهة برمجة التطبيقات عن العمل إلى أن تطلب بيانات إضافية أو يتم تجديد الحصة المجانية. يمكنك مراقبة الحصة التي يستخدمها برنامجك النصي عن طريق فتح وحدة تحكّم Google API للبرنامج النصي من مربّع الحوار واجهات برمجة التطبيقات المتقدّمة. توفّر لك وحدة تحكّم Google API أيضًا طريقة لطلب حصة إضافية لواجهة برمجة التطبيقات.
الفوترة
تتطلب بعض واجهات برمجة التطبيقات المتقدّمة الدفع مقابل الاستخدام. تتم إدارة هذه الدفعات من خلال مشروع Google Cloud المرتبط بالنص البرمجي، وليس من خلال "إعلانات Google". يُرجى الاطّلاع على مستنداتنا لمزيد من التفاصيل حول كيفية تفعيل الفوترة لمشروع Google Cloud الخاص بالنص البرمجي.