Kurulum

Kitaplığı PyPI'dan yüklüyor veya GitHub'dan kopyalıyorsanız etkin bir sanal ortam kullanarak aşağıdaki adımları uygulayın. Sanal ortam oluşturma ve etkinleştirme hakkında bilgi edinmek için Sanal Ortam belgelerine bakın.

Hızlı bir şekilde sanal ortam oluşturup etkinleştirmek için:

python3 -m venv env
source env/bin/activate

Modülü PyPI'dan yükleme

Kitaplık, PyPI'da dağıtılır ve aşağıdaki komutla pip kullanılarak yüklenebilir:

python -m pip install google-ads

Yüklemeyi doğrula

Modülün doğru şekilde yüklendiğini doğrulayın:

python -c "import google.ads.googleads"

Kitaplığı GitHub'dan yükleme

Kitaplığın kaynak kodu GitHub'dan yerel makinenize kopyalanabilir. Kaynak kodunu klonlamak, örnekleri yürütmek veya kitaplığı geliştirmek için kullanışlıdır. Referans olarak, kimlik doğrulama örneklerinden birini çalıştırmak, kitaplığı kullanıma yapılandırmak için gerekli bir adımdır.

  1. Ortamınızda desteklenen bir Python sürümünün (Python 3.9 - 3.14; Python 3.11 veya sonraki sürümler önerilir) bulunduğundan emin olun. En basit yöntem, pyenv kullanmaktır:

    pyenv install 3.13
pyenv local 3.13

  2. İstemci kitaplığını GitHub'dan kopyalayın:

    git clone https://github.com/googleads/google-ads-python.git

  3. Depoya girin ve düzenlenebilir modda yükleyin:

    cd google-ads-python
python -m pip install -e .

  4. Kitaplığı geliştirmeyi planlıyorsanız değişiklik yapmadan önce ve yaptıktan sonra birim testlerini çalıştırın:

    1. pyenv komutunu kullanarak Python dilinin desteklenen tüm sürümlerinin ortamınızda mevcut olduğundan emin olun:

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

    2. Kitaplığın teste özel bağımlılıklarını yükleyin:

      python -m pip install -e ".[tests]"

    3. Kitaplığın düzgün çalıştığından emin olmak için birim testlerini çalıştırın:

      nox

    4. İsteğe bağlı: Birim testlerini Docker kullanarak da çalıştırabilirsiniz. Öncelikle Docker'ın yüklü olduğundan emin olun. Ardından, google-ads-python dizininden aşağıdaki komutları çalıştırın:

      docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox