نصب و راه اندازی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
چه در حال نصب کتابخانه از 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 .
اگر می‌خواهید کتابخانه را توسعه دهید، تست‌های واحد را قبل و بعد از ایجاد هرگونه تغییر اجرا کنید:
اطمینان حاصل کنید که تمام نسخه های پشتیبانی شده از زبان پایتون را در محیط خود در دسترس دارید. استفاده از 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\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"]]
