Kurulum

Kitaplığı PyPI'den mi yoksa GitHub'dan mı yüklediğinize bakılmaksızın, aşağıdaki adımları etkin bir sanal ortamda uygulamanızı öneririz. Sanal ortam oluşturma ve etkinleştirme hakkında bilgi edinmek için Sanal Ortam belgelerine 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 kopyalanabilir. Örnekleri kolayca çalıştırmak veya kitaplığı geliştirmek için kaynak kodunu klonlamak faydalıdır. Referans olarak belirtmek gerekirse, kitaplığı kullanıma hazır hale getirmek için kimlik doğrulama örneklerinden birini çalıştırmak gerekli bir adımdır.

1. Ortamınızda python3.8 veya sonraki bir sürümün yüklü olduğ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. Depoya girip yükleyin:

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

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

   1. Ortamınızda Python dilinin desteklenen tüm sürümlerinin bulunduğundan emin olun. pyenv kullanılıyor::

      pyenv local 3.8 3.9 3.10 3.11 3.12

   2. Kitaplığın teste özgü 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'ın yüklü olması 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