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

تم إنشاء Search Ads 360 API استنادًا إلى HTTP وJSON، ما يتيح لأي عميل HTTP عادي إرسال طلبات إلى الواجهة وتحليل استجاباتها.

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

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

البدء

احصل على أحدث مكتبة برامج لواجهة Search Ads 360 API للغة Go (الإصدار الأولي). راجِع دليل المطوّر الخاص بمكتبة البرامج.

Java

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

• تصفَّح مرجع JavaDoc حول Search Ads 360 API.
• اطَّلِع على دليل المطوّر لمكتبة برامج Google API للغة Java.
• تفاعَل مع واجهة برمجة التطبيقات هذه في متصفّحك باستخدام أداة "مستكشف واجهات برمجة التطبيقات" في Search Ads 360 API.

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

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

Maven

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

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

Gradle

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

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

JavaScript

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

NET.

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

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

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

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

Node.js

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

Obj-C

يمكنك الحصول على أحدث مكتبة برامج لواجهة برمجة تطبيقات "إعلانات شبكة البحث 360" من أجل تحديد هدف-ج. راجِع دليل المطوّر الخاص بمكتبة البرامج.

PHP

يمكنك الحصول على أحدث مكتبة برامج لواجهة برمجة التطبيقات في "إعلانات شبكة البحث 360" للغة PHP. راجِع دليل المطوّر الخاص بمكتبة البرامج.

Python

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

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

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

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

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

يمكنك استخدام أداة إدارة الحِزم أو تنزيل مكتبة برامج 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

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

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

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

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

في حال لم يسبق لك تثبيت مكتبة برامج Google API للغة Ruby، ثبِّتها باستخدام RubyGems:

gem install google-api-client

إذا سبق لك تثبيت الأداة، يمكن تحديثها إلى أحدث إصدار:

gem update -y google-api-client

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

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

طرق أخرى للوصول إلى Search Ads 360 API

يسرد الجدول التالي طرقًا أخرى للوصول إلى Search Ads 360 API:

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