Kurulum
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kitaplığı PyPI'den yüklüyor veya GitHub'dan klonluyor olmanız fark etmeksizin, aşağıdaki adımları etkin bir sanal ortam kullanarak uygulamanızı öneririz. Sanal ortam oluşturma ve etkinleştirme hakkında bilgi edinmek için Sanal Ortam dokümanlarına bakın.
Modülü PyPI'den yükleme
Kitaplık PyPI'de dağıtılır ve aşağıdaki komutla pip kullanılarak yüklenebilir:
python -m pip install google-ads
Kitaplığı GitHub'dan yükleme
Kitaplığın kaynak kodu GitHub'dan yerel makinenize klonlanabilir. Örnekleri kolayca çalıştırmak veya kitaplığı geliştirmek için kaynak kodu klonlamak faydalıdır. Referans olarak, kimlik doğrulama örneklerinden birini çalıştırmak, kitaplığı kullanıma hazırlamak için gerekli bir adımdır.
Ortamınızda python3.8 veya sonraki bir sürümün bulunduğundan emin olun.
En basit yöntem pyenv kullanmaktır:
pyenv local 3.8
İstemci kitaplığını GitHub'dan kopyalayın:
git clone git@github.com:googleads/google-ads-python.git
Depoyu girip yükleyin:
cd google-ads-python
python -m pip install .
Kitaplığı geliştirmeyi planlıyorsanız değişiklik yapmadan önce ve sonra birim testlerini çalıştırın:
Ortamınızda Python dilinin desteklenen tüm sürümlerinin bulunduğundan emin olun. pyenv kullanma:
pyenv local 3.8 3.9 3.10 3.11 3.12
Kitaplığın teste özel bağımlılarını yükleyin:
python -m pip install .[tests]
Kitaplığın düzgün çalıştığından emin olmak için birim testlerini çalıştırın:
nox
İsteğe bağlı: Birim testleri Docker kullanılarak da çalıştırılabilir. Öncelikle Docker'ı yüklemeniz gerekir. Ardından, google-ads-python dizininden aşağıdakileri çalıştırın:
docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-27 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-27 UTC."],[[["\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"]]
