Penginstalan

Baik Anda menginstal library dari PyPI atau meng-clone codelab dari GitHub, kami sebaiknya Anda melakukan langkah-langkah di bawah ini menggunakan lingkungan fleksibel App Engine. Untuk informasi cara membuat dan mengaktifkan virtual lihat dokumentasi Lingkungan Virtual.

Menginstal modul dari PyPI

Library ini didistribusikan di PyPI dan dapat diinstal menggunakan pip dengan perintah berikut:

python -m pip install google-ads

Menginstal library dari GitHub

Kode sumber untuk library dapat di-clone dari GitHub ke komputer lokal Anda. Berguna untuk mengkloning kode sumber agar mudah untuk mengeksekusi contoh atau mengembangkan library itu sendiri. Sebagai referensi, menjalankan salah satu contoh otentikasi adalah langkah yang diperlukan dalam mengonfigurasi {i>library<i} untuk digunakan.

1. Pastikan python3.8 atau yang lebih baru ada di lingkungan Anda. Cara paling mudah adalah menggunakan pyenv:

   pyenv local 3.8
   

2. Clone library klien dari GitHub:

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

3. Masukkan repositori, lalu instal:

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

4. Jika Anda ingin mengembangkan library, jalankan pengujian unit sebelum dan sesudah melakukan perubahan:

   1. Pastikan Anda memiliki semua versi bahasa Python yang didukung yang tersedia di lingkungan Anda. Menggunakan pyenv::

      pyenv local 3.8 3.9 3.10 3.11 3.12
      

   2. Instal dependensi library khusus pengujian:

      python -m pip install .[tests]
      

   3. Jalankan pengujian unit untuk memastikan library berfungsi dengan baik:

      nox
      

   4. Opsional: pengujian unit juga dapat dijalankan menggunakan Docker. Pertama, Anda harus menginstal Docker. Kemudian, dari direktori google-ads-python, jalankan perintah berikut:

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