تثبيت مكتبات البرامج

تعتمد واجهة برمجة التطبيقات لتقرير تجارب إعلانات Google على HTTP وJSON، ما يتيح لأي برنامج HTTP عادي إرسال طلبات إلى المحتوى وتحليل الردود.

في المقابل، توفر مكتبات برامج واجهة Google API نتائج أفضل على مستوى التكامل اللغوي والأمان، كما تقدّم إمكانات أفضل في إجراء الطلبات التي تحتاج إلى إذن من المستخدم. تتوفر مكتبات البرامج بعدّة لغات برمجة. ويغنيك استخدام هذه المكتبات عن إعداد طلبات HTTP وتحليل الاستجابات يدويًا.

للبدء، اختَر لغة البرمجة التي تستخدمها في التطوير.

البدء

احصل على أحدث مكتبة عميل لواجهة برمجة التطبيقات لتقرير تجارب إعلانات Google لتطبيق Go (الإصدار الأولي). راجِع دليل المطوّر لمكتبة البرامج.

لغة Java

تحتوي هذه الصفحة على معلومات عن كيفية البدء في استخدام واجهة برمجة التطبيقات لتقرير تجارب الإعلانات باستخدام "مكتبة برامج Google API" للغة Java. لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:

• تصفَّح مرجع JavaScript لواجهة برمجة تطبيقات تقرير تجارب الإعلانات.
• اطَّلِع على دليل المطوّر لمكتبة برامج Google API للغة Java.
• التفاعل مع واجهة برمجة التطبيقات هذه في متصفحك باستخدام مستكشف واجهات برمجة التطبيقات لواجهة برمجة تطبيقات تقرير تجارب الإعلانات.

إضافة مكتبة البرامج إلى مشروعك

يمكنك اختيار بيئة الإصدار (Maven أو Gradle) من بين علامات التبويب التالية:

Maven

أضِف ما يلي إلى ملف pom.xml:

راجِع جميع الإصدارات المتوفّرة في مستودع Maven المركزي.

أداة Grad

أضِف ما يلي إلى ملف build.gradle:

راجِع جميع الإصدارات المتوفّرة في مستودع Maven المركزي.

JavaScript

راجِع دليل المطوّر لمكتبة البرامج.

NET.

تحتوي هذه الصفحة على معلومات عن كيفية البدء في استخدام تقرير تجارب الإعلانات من خلال واجهة برمجة التطبيقات لـ "مكتبة عملاء Google API" لنظام التشغيل NET. لمزيد من المعلومات، اطّلِع على المستندات التالية:

• يمكنك تصفُّح المستندات المرجعية لنظام.NET من أجل واجهة برمجة التطبيقات لتقرير تجارب الإعلانات.
• اطَّلِع على دليل المطوّر لمكتبة برامج Google API لنظام ‎NET.
• التفاعل مع واجهة برمجة التطبيقات هذه في متصفحك باستخدام مستكشف واجهات برمجة التطبيقات لواجهة برمجة تطبيقات تقرير تجارب الإعلانات.

تنزيل المكتبة

ثبِّت حزمة NuGet: Google.Apis.

Node.js

يمكنك الحصول على أحدث مكتبة عميل لواجهة برمجة التطبيقات لتقرير تجارب إعلانات Google من أجل Node.js. راجِع دليل المطوّر لمكتبة البرامج.

Obj-C

يمكنك الحصول على أحدث مكتبة عميل لواجهة برمجة التطبيقات لتقرير تجارب الإعلانات من Google للهدف C. راجِع دليل المطوّر لمكتبة البرامج.

لغة PHP

احصل على أحدث مكتبة عميل لواجهة برمجة التطبيقات لتقرير تجارب إعلانات Google للغة PHP (إصدار تجريبي). راجِع دليل المطوّر لمكتبة البرامج.

لغة Python

تحتوي هذه الصفحة على معلومات عن كيفية بدء استخدام واجهة برمجة التطبيقات لتقرير تجارب الإعلانات باستخدام "مكتبة برامج Google API" للغة Python. لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:

• تصفَّح مرجع PyDoc لواجهة برمجة التطبيقات لتقرير تجارب الإعلانات.
• اطَّلِع على دليل المطوّر لمكتبة برامج Google API للغة Python.
• التفاعل مع واجهة برمجة التطبيقات هذه في متصفحك باستخدام مستكشف واجهات برمجة التطبيقات لواجهة برمجة تطبيقات تقرير تجارب الإعلانات.

متطلبات النظام

• أنظمة التشغيل:
  • Linux
  • Mac OS X
  • Windows
• الإصدار 2.7 أو 3.4 أو الإصدارات اللاحقة من نظام Python

تثبيت مكتبة البرامج

يمكنك استخدام مدير حُزم أو تنزيل مكتبة برامج Python يدويًا وتثبيتها:

التثبيت المُدار

استخدِم pip أو Setuptools لإدارة التثبيت. قد تحتاج إلى تشغيل sudo أولاً.

• pip (الخيار المفضّل):

  pip install --upgrade google-api-python-client

• أدوات الإعداد:

  easy_install --upgrade google-api-python-client

التثبيت اليدوي

1. نزِّل مكتبة البرامج الأحدث للغة Python.
2. فُكَّ حزمة الرمز.
3. تثبيت:

   python setup.py install

App Engine

بما أنّ مكتبات برامج Python غير مثبَّتة في بيئة وقت تشغيل Python في App Engine، عليك نسخها إلى تطبيقك كما هي الحال مع مكتبات الجهات الخارجية.

Ruby

تحتوي هذه الصفحة على معلومات عن كيفية البدء في استخدام تقرير تجارب الإعلانات من خلال استخدام "مكتبة عميل Google API" لخدمة Ruby. لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:

• اطَّلِع على دليل البدء لمكتبة برامج Google API للغة Ruby.
• التفاعل مع واجهة برمجة التطبيقات هذه في متصفحك باستخدام مستكشف واجهات برمجة التطبيقات لواجهة برمجة تطبيقات تقرير تجارب الإعلانات.

تنزيل أداة google-api-client

وفقًا للنظام الذي تستخدمه، قد تحتاج إلى إضافة هذه الأوامر أولاً باستخدام sudo.

إذا لم يسبق لك تثبيت "مكتبة برامج Google API" لواجهة Ruby، يمكنك تثبيتها باستخدام RubyGems:

gem install google-api-client

إذا سبق لك تثبيت اللعبة، يُرجى التحديث إلى أحدث إصدار:

gem update -y google-api-client

بدء استخدام مكتبة برامج Google API للغة Ruby

للاطّلاع على كيفية تقديم طلبك الأول، راجِع دليل البدء.

طرق أخرى للوصول إلى واجهة برمجة التطبيقات لتقرير تجارب إعلانات Google

يسرد الجدول التالي طرقًا أخرى للوصول إلى واجهة برمجة التطبيقات لتقرير تجارب إعلانات Google:

طريقة الدخول	الوصف
مستكشف واجهات برمجة التطبيقات	أداة تفاعلية تتيح لك تجربة Google APIs من متصفّحك مباشرةً.