Baik Anda menginstal library dari PyPI atau meng-clone-nya dari GitHub, sebaiknya lakukan langkah-langkah di bawah ini menggunakan lingkungan virtual yang aktif. Untuk informasi tentang cara membuat dan mengaktifkan lingkungan 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 mesin lokal. Sebaiknya clone kode sumber agar dapat mengeksekusi contoh dengan mudah atau untuk mengembangkan library itu sendiri. Sebagai referensi, menjalankan salah satu contoh autentikasi merupakan langkah yang diperlukan dalam mengonfigurasi library yang akan digunakan.
Pastikan
python3.8
atau yang lebih baru ada di lingkungan Anda. Cara paling mudah adalah menggunakanpyenv
:pyenv local 3.8
Clone library klien dari GitHub:
git clone git@github.com:googleads/google-ads-python.git
Masukkan repositori, lalu instal:
cd google-ads-python python -m pip install .
Jika Anda ingin mengembangkan library, jalankan pengujian unit sebelum dan sesudah melakukan perubahan apa pun:
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
Instal dependensi library khusus pengujian:
python -m pip install .[tests]
Jalankan pengujian unit untuk memastikan library berfungsi dengan baik:
nox
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