التثبيت
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
سواء كنت تثبّت المكتبة من PyPI أو تنسخها من GitHub، ننصحك بتنفيذ الخطوات أدناه باستخدام بيئة افتراضية نشطة. للحصول على معلومات حول كيفية إنشاء بيئة افتراضية وتفعيلها، يُرجى الاطّلاع على مستندات البيئة الافتراضية.
تثبيت الوحدة من PyPI
يتم توزيع المكتبة على PyPI ويمكن تثبيتها باستخدام pip من خلال الأمر التالي:
python -m pip install google-ads
تثبيت المكتبة من GitHub
يمكن استنساخ الرمز المصدر للمكتبة من GitHub إلى جهازك المحلي. من المفيد استنساخ الرمز المصدر لتنفيذ الأمثلة بسهولة أو لتطوير المكتبة نفسها. للعلم، يُعدّ تشغيل أحد أمثلة المصادقة خطوة مطلوبة عند إعداد المكتبة لاستخدامها.
تأكَّد من توفُّر الإصدار python3.8 أو إصدار أحدث في بيئتك.
أبسط طريقة هي استخدام pyenv:
pyenv local 3.8
استنسِخ مكتبة البرامج من GitHub:
git clone git@github.com:googleads/google-ads-python.git
أدخِل المستودع وثبِّته:
cd google-ads-python
python -m pip install .
إذا كنت تنوي تطوير المكتبة، نفِّذ اختبارات الوحدات قبل إجراء أي تغييرات وبعده:
تأكَّد من توفُّر جميع الإصدارات المتوافقة من لغة Python في بيئتك. استخدام pyenv::
pyenv local 3.8 3.9 3.10 3.11 3.12
ثبِّت الموارد التابعة الخاصة بالاختبار في المكتبة:
python -m pip install .[tests]
نفِّذ اختبارات الوحدات للتأكّد من أنّ المكتبة تعمل بشكلٍ سليم:
nox
اختياري: يمكن أيضًا تشغيل اختبارات الوحدة باستخدام Docker. أولاً، يجب أن يكون Docker مثبّتًا. بعد ذلك، نفِّذ ما يلي من دليل google-ads-python:
docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Ads Python library can be installed from PyPI using pip with the command \u003ccode\u003epython -m pip install google-ads\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo install from GitHub, clone the repository, navigate into it, and run \u003ccode\u003epython -m pip install .\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEnsure you have Python 3.8 or later installed in your environment, potentially using pyenv.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should run unit tests before and after making changes, utilizing nox or Docker for execution.\u003c/p\u003e\n"],["\u003cp\u003eFor library setup and usage, refer to the Virtual Environment and authentication example documentation.\u003c/p\u003e\n"]]],[],null,["# Installation\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhether you're installing the library from PyPI or cloning it from GitHub, we\nrecommended that you conduct the below steps using an active virtual\nenvironment. For information on how to create and activate a virtual\nenvironment, see the [Virtual Environment](//docs.python.org/3/tutorial/venv.html) documentation.\n\nInstall the module from PyPI\n----------------------------\n\nThe library is distributed on [PyPI](//pypi.org/project/google-ads/) and can\nbe installed using [pip](//pip.pypa.io/en/stable/installing) with the\nfollowing command: \n\n python -m pip install google-ads\n\nInstall the library from GitHub\n-------------------------------\n\nThe source code for the library can be cloned from [GitHub](https://github.com/googleads/google-ads-python/)\nonto your local machine. It's useful to clone the source code in order to easily\nexecute the examples or to develop the library itself. For reference, running\none of the authentication examples is a required step in configuring the library\nfor use.\n\n1. Ensure that `python3.8` or later is present in your environment.\n The simplest way is to use [`pyenv`](//github.com/pyenv/pyenv-installer):\n\n pyenv local 3.8\n\n2. Clone the client library from GitHub:\n\n git clone git@github.com:googleads/google-ads-python.git\n\n3. Enter the repository and install it:\n\n cd google-ads-python\n python -m pip install .\n\n4. If you intend to develop the library, run the unit tests before and after\n making any changes:\n\n 1. Ensure you have all supported versions of the Python language available in\n your environment. Using `pyenv`::\n\n pyenv local 3.8 3.9 3.10 3.11 3.12\n\n 2. Install the test-specific dependencies of the library:\n\n python -m pip install .[tests]\n\n 3. Run the unit tests to ensure the library is functioning properly:\n\n nox\n\n 4. Optional: the unit tests can also be run using Docker. First, you must\n have [Docker installed](https://docs.docker.com/get-docker/). Then, from\n the `google-ads-python` directory, run the following:\n\n docker build -t google-ads-python:test .\n docker run -it google-ads-python:test nox"]]
