Kurulum

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.

  1. 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
  2. İstemci kitaplığını GitHub'dan kopyalayın:

    git clone git@github.com:googleads/google-ads-python.git
  3. Depoyu girip yükleyin:

    cd google-ads-python
    python -m pip install .
  4. Kitaplığı geliştirmeyi planlıyorsanız değişiklik yapmadan önce ve sonra birim testlerini çalıştırın:

    1. 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
    2. Kitaplığın teste özel bağımlılarını yükleyin:

      python -m pip install .[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 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