تتيح واجهات برمجة التطبيقات المتقدّمة في نصوص "إعلانات Google" للمطوّرين المدرَّبين إمكانية الربط ببعض واجهات برمجة تطبيقات Google المتاحة للجميع من خلال إعدادات أقلّ من استخدام واجهات HTTP. ويمكنك استخدام واجهات برمجة التطبيقات هذه تمامًا مثل الخدمات المضمّنة في النصوص البرمجية، كما أنّها توفّر ميزات الراحة نفسها، مثل الإكمال التلقائي والتفويض التلقائي.
الاستخدامات المحتمَلة لواجهات برمجة التطبيقات المتقدّمة
- إحصاءات Google
- يمكنك استخدام "إحصاءات Google" لتتبُّع عدد الزيارات الواردة إلى موقعك الإلكتروني و تعديل عروض أسعار حملاتك وفقًا لذلك. في حال ربط موقع على "إحصاءات Google" بحسابك على "إعلانات Google"، يمكنك أيضًا تحليل نشاط العملاء على موقعك الإلكتروني. ويمكن لهذه المعلومات أن تسلّط الضوء على عدد الزيارات أو المبيعات التي تتحقق في موقعك الإلكتروني من خلال "إعلانات Google"، كما تساعدك على تحسين إعلاناتك وموقعك الإلكتروني. يمكنك معرفة المزيد من المعلومات عن ربط حسابَي "إحصاءات Google" و"إعلانات Google" في مركز المساعدة.
- Google BigQuery
- يمكنك تحميل كميات كبيرة من البيانات إلى Google Cloud Storage، ثم الاستعلام عن هذه البيانات باستخدام Google BigQuery. على سبيل المثال، يمكنك تحميل بيانات الطقس العلنية للسنوات العشر الماضية، ثم البحث عن متوسط درجة الحرارة في منطقة معيّنة في نص برمجي يستخدم هذه المعلومات في تعديل عروض الأسعار. ويمكنك أيضًا استخدامها للقيام بعمليات جمع وتحليل للأرقام في بيانات أداء حسابك على مدار عدة سنوات.
- YouTube و"إحصاءات YouTube"
- يمكنك استرداد فيديوهاتك وقوائم التشغيل وما إلى ذلك وتعديلها، بالإضافة إلى بيانات أداء فيديوهاتك لاتّخاذ قرارات بشأن عروض الأسعار.
- تقويم Google
- يمكن للنص البرمجي إنشاء أحداث للمهام المستقبلية (على سبيل المثال، تنفيذ تقرير أداء لحملاتك بعد أسبوعَين من اليوم) أو تنفيذ إجراءات استنادًا إلى إدخال أنشأته في تقويمك (على سبيل المثال، تفعيل حملة في تاريخ محدّد).
- محتوى Shopping
- يمكن أن يستخدِم النص البرمجي Google Content API for Shopping في Apps Script. تمنح هذه واجهة برمجة التطبيقات مستخدمي Google Merchant Center إمكانية تحميل بيانات المنتجات وإدارتها وإدارة حساباتهم على Merchant Center. في النصوص البرمجية، يمكن أن يكون هذا الإجراء مفيداً للتحقق من بيانات المنتجات وربط منتجات معيّنة بإعلانات معيّنة.
- مهام Google
- يمكن للنص البرمجي إنشاء قائمة تذكيرات للمهام المستقبلية (على سبيل المثال، تنفيذ تقرير أداء لحملاتك بعد أسبوعَين من اليوم) أو تنفيذ إجراءات استنادًا إلى إدخال أنشأته في قائمة التذكيرات (على سبيل المثال، تفعيل حملة في تاريخ محدّد).
- العروض التقديمية من Google
- يمكن لنصّك البرمجي تصدير تفاصيل الحملة أو إحصاءاتها إلى "العروض التقديمية من Google" لنشر هذه المعلومات بتنسيق يسهل عرضه.
تفعيل واجهات برمجة التطبيقات المتقدّمة
للاطّلاع على واجهات برمجة التطبيقات من Google المتاحة كواجهات برمجة تطبيقات متقدّمة، انقر على الزر واجهات برمجة التطبيقات المتقدّمة في أعلى شريط المحرّر.
يؤدي ذلك إلى ظهور مربّع الحوار واجهات برمجة التطبيقات المتقدّمة. ضَع علامة في المربّع بجانب واجهات برمجة التطبيقات التي تريد تفعيلها.
بعد ذلك، انقر على رابط وحدة تحكّم واجهة برمجة التطبيقات في Google لعرض صفحة وحدة تحكّم واجهة برمجة التطبيقات في "وحدة التحكّم"، مع المشروع المرتبط بنصك البرمجي، أو اختَر مشروعك من القائمة المنسدلة "المشروع" إذا لم يكن قد تم اختياره من قبل. ابحث عن واجهات برمجة التطبيقات التي تريد استخدامها في النص البرمجي عن طريق إدخال اسم واجهة برمجة التطبيقات في شريط البحث.
في نتائج البحث، اختَر واجهة برمجة التطبيقات، وفي الصفحة التالية اختَر تفعيل. إذا ظهر لك زر إيقاف، يعني ذلك أنّ واجهة برمجة التطبيقات هذه مفعّلة. كرِّر هذا الإجراء لكل واجهة برمجة تطبيقات تريد تفعيلها.
للاطّلاع على قائمة واجهات برمجة التطبيقات المفعَّلة للمشروع، اختَر صفحة لوحة البيانات. تأكَّد من أنّه تم إدراج جميع واجهات برمجة التطبيقات المتقدّمة التي تريد استخدامها في النص البرمجي.
أغلِق الآن مربّع الحوار Advanced APIs (واجهات برمجة التطبيقات المتقدّمة) للعودة إلى المحرِّر. سيتم تفعيل واجهات برمجة التطبيقات الجديدة لنصك البرمجي وستتوفّر في قائمة الإكمال التلقائي.
واجهات برمجة التطبيقات المتاحة
تتوفّر واجهات برمجة التطبيقات التالية للاستخدام:
| اسم واجهة برمجة التطبيقات | الوثائق |
|---|---|
| إحصاءات 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، وسيكون عليك إعداد IDE Advanced APIs مرة أخرى، كما هو موضّح سابقًا في هذا المستند.
التبعيات
لا يمكن إلّا للمستخدم الذي أنشأ البرنامج النصي في الحساب تغيير التبعيات المتقدّمة لواجهة برمجة التطبيقات لهذا البرنامج النصي.
الأذونات
عند الوصول إلى واجهات برمجة التطبيقات، يستخدم النص البرمجي أذونات المستخدم الذي منح الإذن للنص البرمجي. تأكَّد من أنّ المستخدم الذي فوّض البرنامج النصي لديه إذن الوصول المُطلوب إلى جميع واجهات برمجة التطبيقات المتقدّمة المستخدَمة بالإضافة إلى البيانات التي يحتاج إليها البرنامج النصي. إذا كنت تستخدِم Google Analytics API، تأكَّد من أنّ المستخدِم الذي أذن للنص البرمجي لديه الأذونات اللازمة لحساب "إحصاءات Google" الذي يتم الوصول إليه.
الأحكام والشروط
قد يكون لكلّ من واجهات برمجة التطبيقات المتقدّمة بنود وأحكام خاصة بها يجب قبولها عند تفعيل واجهة برمجة التطبيقات في "وحدة تحكّم واجهة برمجة التطبيقات من Google".
الحصة
ترتبط معظم واجهات برمجة التطبيقات المتقدّمة بحصة يومية مجانية. بعد أن يتجاوز النص البرمجي هذا الحدّ الأقصى، سيتوقف عمل واجهة برمجة التطبيقات إلى أن تطلب مزيدًا من البيانات أو تتم إعادة تعبئة الحصة المجانية. يمكنك مراقبة الحصة المستخدَمة في النص البرمجي من خلال فتح "وحدة تحكّم واجهة برمجة التطبيقات في Google" للنص البرمجي من مربّع حوار واجهات برمجة التطبيقات المتقدمة. توفّر لك "وحدة تحكّم واجهة برمجة تطبيقات Google" أيضًا طريقة لطلب حصة إضافية لواجهة برمجة التطبيقات.
الفوترة
تتطلّب بعض واجهات برمجة التطبيقات المتقدّمة الدفع مقابل الاستخدام. تتم إدارة هذه الدفعات من خلال مشروع Google Cloud Platform المرتبط بنصّك البرمجي، وليس من خلال "إعلانات Google". يمكنك الاطّلاع على المستندات للحصول على مزيد من التفاصيل حول كيفية تفعيل الفوترة لمشروع "برمجة التطبيقات" على Google Cloud Platform.