تثبيت مكتبات العملاء
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تم إنشاء Search Ads 360 API استنادًا إلى HTTP وJSON، ما يتيح لأي عميل HTTP عادي إرسال طلبات إلى الواجهة وتحليل استجاباتها.
في المقابل، توفّر مكتبات برامج واجهة Google API نتائج أفضل على مستوى التكامل اللغوي والأمان المعزَّز، كما تتيح إمكانية إجراء الطلبات التي تحتاج إلى إذن من المستخدم. تتوفر مكتبات البرامج بعدّة لغات برمجة. ويغنيك استخدام هذه المكتبات عن إعداد طلبات HTTP وتحليل الاستجابات يدويًا.
للبدء، اختَر لغة البرمجة التي تستخدمها في التطوير.
Java
تحتوي هذه الصفحة على معلومات حول بدء استخدام Search Ads 360 API من خلال مكتبة برامج Google API للغة Java. لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:
إضافة مكتبة البرامج إلى مشروعك
يمكنك اختيار بيئة الإصدار (Maven أو Gradle) من بين علامات التبويب التالية:
NET.
تحتوي هذه الصفحة على معلومات حول بدء استخدام Search Ads 360 API من خلال مكتبة برامج Google API لنظام .NET. لمزيد من المعلومات، يمكنك الاطّلاع على المستندات التالية:
Python
تضم هذه الصفحة معلومات عن بدء استخدام Search Ads 360 API باستخدام مكتبة برامج Google API للغة Python. لمزيد من المعلومات، يمكن الاطّلاع على المستندات التالية:
تثبيت مكتبة البرامج
يمكنك استخدام أداة إدارة الحِزم أو تنزيل مكتبة برامج Python يدويًا وتثبيتها:
التثبيت المُدار
استخدِم pip أو setuptools لإدارة التثبيت. قد تحتاج إلى تشغيل sudo
أولاً.
- pip (يفضَّل استخدامها):
pip install --upgrade google-api-python-client
- Setuptools:
easy_install --upgrade google-api-python-client
التثبيت اليدوي
- نزِّل مكتبة البرامج الأحدث للغة Python.
- فُكَّ حزمة الرمز.
- ثبِّت المكتبة:
python setup.py install
App Engine
بما أنّ مكتبات برامج Python غير مثبَّتة في بيئة وقت تشغيل Python في App Engine، عليك نسخها إلى تطبيقك كما هي الحال مع مكتبات الجهات الخارجية.
Ruby
تحتوي هذه الصفحة على معلومات عن بدء استخدام Search Ads 360 API من خلال مكتبة برامج 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
للاطّلاع على كيفية تقديم طلبك الأول، راجِع دليل البدء.
طرق أخرى للوصول إلى Search Ads 360 API
يسرد الجدول التالي طرقًا أخرى للوصول إلى Search Ads 360 API:
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-07 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-07 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Install Client Libraries\n\nThe Search Ads 360 API is built on HTTP and JSON, so any standard HTTP client\ncan send requests to it and parse the responses.\n\nHowever, the Google API client libraries provide better language\nintegration, improved security, and support for making calls that require\nuser authorization. The client libraries are available in a number of\nprogramming languages; by using them you can avoid the need to manually set\nup HTTP requests and parse the responses.\n\nTo get started, select the programming language that you are using for\ndevelopment. \n\n### Go\n\nGet the latest [Search Ads 360 API client library for Go ()](https://github.com/google/google-api-go-client). Read the\nclient library's [developer's guide](https://github.com/google/google-api-go-client).\n\n### Java\n\n\u003cbr /\u003e\n\n\nThis page contains information about getting started with the Search Ads 360 API by using\nthe Google API Client Library for Java. For more information, see the following documentation:\n\n- Browse the [Javadoc reference for the Search Ads 360 API](https://googleapis.dev/java/google-api-services-doubleclicksearch/latest/).\n- Read the [Developer's Guide for the Google API Client Library for Java](https://github.com/googleapis/google-api-java-client/).\n- Interact with this API in your browser using the [APIs Explorer for the Search Ads 360 API](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/).\n\nAdd the client library to your project\n--------------------------------------\n\nSelect your build environment (Maven or Gradle) from the following tabs:\n\n\nMaven\n\nAdd the following to your `pom.xml` file:\n\n```\nRefreshing Maven content...\n```\n\nSee [all versions available on the Maven Central Repository](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.google.apis%22%20AND%20a%3A%22google-api-services-doubleclicksearch%22).\nGradle\n\nAdd the following to your `build.gradle` file:\n\n```\nRefreshing Gradle content...\n```\n\nSee [all versions available on the Maven Central Repository](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.google.apis%22%20AND%20a%3A%22google-api-services-doubleclicksearch%22).\n\n### JavaScript\n\nRead the client library's [developer's guide](/api-client-library/javascript/start/start-js).\n\n### .NET\n\n\nThis page contains information about getting started with the Search Ads 360 API by using\nthe Google API Client Library for .NET. For more information, see the following documentation:\n\n- Browse the [.NET reference documentation for the Search Ads 360 API](https://googleapis.dev/dotnet/Google.Apis/latest/api/Google.Apis.html).\n- Read the [Developer's guide for the Google API Client Library for .NET](/api-client-library/dotnet/get_started).\n- Interact with this API in your browser using the [APIs Explorer for the Search Ads 360 API](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/).\n\nDownloading the library\n-----------------------\n\nInstall the NuGet package:\n[Google.Apis](https://www.nuget.org/packages/Google.Apis).\n\n### Node.js\n\nGet the latest [Search Ads 360 API client library for Node.js](https://github.com/google/google-api-nodejs-client/). Read the\nclient library's [developer's guide](https://github.com/google/google-api-nodejs-client/).\n\n### Obj-C\n\nGet the latest [Search Ads 360 API client library for Objective-C](https://github.com/google/google-api-objectivec-client-for-rest). Read the\nclient library's [developer's guide](https://github.com/google/google-api-objectivec-client-for-rest/wiki).\n\n### PHP\n\nGet the latest [Search Ads 360 API client library for PHP](https://github.com/google/google-api-php-client). Read the\nclient library's [developer's guide](/api-client-library/php).\n\n### Python\n\n\nThis page contains information about getting started with the Search Ads 360 API by using\nthe Google API Client Library for Python (v1/v2). For more information, see the following documentation:\n\n- Browse the [PyDoc reference for the Search Ads 360 API](https://googleapis.github.io/google-api-python-client/docs/dyn/doubleclicksearch_v2.html).\n- Read the [Developer's guide for the Google API Client Library for Python (v1/v2)](/api-client-library/python).\n- Interact with this API in your browser using the [APIs Explorer for the Search Ads 360 API](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/).\n\nSystem requirements\n-------------------\n\n- Operating systems:\n - Linux\n - macOS X\n - Windows\n- [The v1 client library requires Python 2.7 or higher. The v2 client library requires 3.7 or higher.](http://python.org/download/)\n\nInstall the client library\n--------------------------\n\nYou can either use a package manager or manually download and install the Python client library:\n\n### Managed install\n\nUse pip or setuptools to manage your installation. You might\nneed to run `sudo` first.\n\n- [pip](http://pypi.python.org/pypi/pip) (preferred): \n\n ```\n pip install --upgrade google-api-python-client\n ```\n- [Setuptools](http://pypi.python.org/pypi/setuptools): \n\n ```\n easy_install --upgrade google-api-python-client\n ```\n\n### Manual install\n\n1. [Download the latest client\n library for Python](https://pypi.python.org/pypi/google-api-python-client/).\n2. Unpack the code.\n3. Install: \n\n ```\n python setup.py install\n ```\n\n### App Engine\n\nBecause the Python client libraries aren't installed in the\n[App Engine Python runtime environment](https://cloud.google.com/appengine/docs/python/),\nyou must [copy them into your application](https://cloud.google.com/appengine/docs/python/tools/libraries27#vendoring) just like third-party libraries.\n\n\u003cbr /\u003e\n\n### Ruby\n\n\nThis page contains information about getting started with the Search Ads 360 API by using\nthe Google API Client Library for Ruby. For more information, see the following documentation:\n\n- Read the [Get started guide for the Google API Client Library for Ruby](/api-client-library/ruby/start/get_started).\n- Interact with this API in your browser using the [APIs Explorer for the Search Ads 360 API](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/).\n\nInstall the `google-api-client` gem\n-----------------------------------\n\n\nDepending on your system, you might need to prepend these commands with `sudo`.\n\n\nIf you haven't installed the Google API Client Library for Ruby before, install by using `RubyGems`: \n\n```\ngem install google-api-client\n```\n\n\u003cbr /\u003e\n\n\nIf you already have the gem installed, update to the latest version: \n\n```\ngem update -y google-api-client\n```\n\n\u003cbr /\u003e\n\nGet started with the Google API Client Library for Ruby\n-------------------------------------------------------\n\n\nTo learn how to make your first request, see the\n[Get started guide](/api-client-library/ruby/start/get_started).\n\n\u003cbr /\u003e\n\nOther ways to access the Search Ads 360 API\n-------------------------------------------\n\nThe following table lists other ways to access the Search Ads 360 API:\n\n| Access method | Description |\n| [APIs Explorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/) | An interactive tool that lets you try out Google APIs right from your browser. |\n|---------------------------------------------------------------------------------------|--------------------------------------------------------------------------------|"]]