Kurulum

Kitaplığı PyPI'den yüklüyor veya GitHub'dan klonluyor olmanız fark etmeksizin, 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ıca sanal ortam oluşturup etkinleştirmek için:

python3 -m venv env
source env/bin/activate

Modülü PyPI'den yükleyin.

Kitaplık PyPI'de 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 kodu klonlamak, örnekleri yürütmek veya kitaplığı geliştirmek için yararlıdır. Referans olarak, kimlik doğrulama örneklerinden birini çalıştırmak, kitaplığı kullanıma hazırlamak 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 herhangi bir değişiklik yapmadan önce ve sonra birim testlerini çalıştırın:

    1. pyenv kullanarak ortamınızda Python dilinin desteklenen tüm sürümlerinin bulunduğ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