تثبيت مكتبات العملاء

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

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

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

انتقال

يمكنك الحصول على أحدث مكتبة لبرامج Google Ad Experience Report API للغة Go (). يُرجى مراجعة دليل المطوّر الخاص بمكتبة البرامج.

Java

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

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

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

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

Maven

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

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

Gradle

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

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

JavaScript

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

NET.

تتضمّن هذه الصفحة معلومات حول بدء استخدام Ad Experience Report API من خلال مكتبة برامج Google API لنظام ‎ .NET. لمزيد من المعلومات، يمكنك الاطّلاع على المستندات التالية:

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

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

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

Node.js

يمكنك الحصول على أحدث مكتبة برامج خاصة بواجهة Google Ad Experience Report API لنظام Node.js. راجِع دليل المطوّر الخاص بمكتبة البرامج.

Obj-C

يمكنك الحصول على أحدث مكتبة برامج خاصة بواجهة Google Ad Experience Report API للغة Objective-C. راجِع دليل المطوّر الخاص بمكتبة البرامج.

PHP

يمكنك الحصول على أحدث مكتبة برامج لواجهة Google Ad Experience Report API للغة PHP. راجِع دليل المطوّر الخاص بمكتبة البرامج.

Python

تتضمّن هذه الصفحة معلومات حول بدء استخدام Ad Experience Report API من خلال مكتبة برامج Google API للغة Python (الإصدار 1 أو 2). لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:

• تصفَّح مرجع PyDoc حول Ad Experience Report API.
• اطّلِع على دليل المطوّر لمكتبة برامج Google API للغة Python (v1/v2).
• تفاعَل مع واجهة برمجة التطبيقات هذه في متصفحك باستخدام مستكشف واجهات برمجة التطبيقات لـ "واجهة برمجة التطبيقات لتقرير تجارب الإعلانات".

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

• أنظمة التشغيل:
  • Linux
  • Mac OS X
  • Windows
• تتطلّب مكتبة البرامج v1 توفّر الإصدار 2.7 أو الإصدارات اللاحقة من نظام Python. أما مكتبة البرامج v2، فتتطلّب توفّر الإصدار 3.7 أو الإصدارات اللاحقة.

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

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

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

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

• pip (يفضَّل استخدامها):

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

• Setuptools:

  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 Ad Experience Report API

يتضمّن الجدول التالي طرقًا أخرى للدخول إلى Google Ad Experience Report API:

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