Döşeme

Kitaplığı ister PyPI'dan ister GitHub'dan klonlarken, aşağıdaki adımları etkin bir sanal ortam kullanarak uygulamanızı öneriyoruz. Sanal ortam oluşturma ve etkinleştirme hakkında bilgi için Sanal Ortam belgelerine bakın.

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

Kitaplığı GitHub'dan yükleyin

Kitaplığın kaynak kodu, GitHub'dan yerel makinenize klonlanabilir. Örnekleri kolayca yürütmek veya kitaplığın kendisini geliştirmek için kaynak kodu klonlamak yararlıdır. Kimlik doğrulama örneklerinden birini çalıştırmak, kitaplığın kullanım için yapılandırılmasında gerekli bir adımdır.

1. Ortamınızda python3.8 veya sonraki bir sürümün mevcut olduğundan emin olun. En basit yol pyenv kullanmaktır:

   pyenv local 3.8
   

2. GitHub'dan istemci kitaplığını klonlayın:

   git clone [e-mail]:googleads/google-ads-python.git
   

3. Depoyu girin ve yükleyin:

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

4. Kitaplığı geliştirmeyi düşünüyorsanız değişiklikleri 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 kullanılarak:

      pyenv local 3.8 3.9 3.10 3.11 3.12
      

   2. Kitaplığın teste özgü bağımlılıkları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. İlk olarak, Docker'ı yüklemiş olmanız gerekir. Ardından, google-ads-python dizininden aşağıdaki komutu çalıştırın:

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