Cho dù đang cài đặt thư viện từ PyPI hay sao chép thư viện từ GitHub, bạn nên thực hiện các bước dưới đây bằng cách sử dụng môi trường ảo đang hoạt động. Để biết thông tin về cách tạo và kích hoạt môi trường ảo, vui lòng xem tài liệu về Môi trường ảo.
Cài đặt mô-đun qua PyPI
Thư viện này được phân phối trên PyPI và có thể được cài đặt bằng pip với lệnh sau:
python -m pip install google-ads
Cài đặt thư viện qua GitHub
Bạn có thể sao chép mã nguồn cho thư viện từ GitHub vào máy cục bộ. Bạn nên sao chép mã nguồn để dễ dàng thực thi các ví dụ hoặc phát triển thư viện. Để tham khảo, việc chạy một trong các ví dụ xác thực là bước bắt buộc khi định cấu hình thư viện để sử dụng.
Đảm bảo rằng
python3.8
trở lên có trong môi trường của bạn. Cách đơn giản nhất là sử dụngpyenv
:pyenv local 3.8
Sao chép thư viện ứng dụng từ GitHub:
git clone git@github.com:googleads/google-ads-python.git
Nhập kho lưu trữ và cài đặt:
cd google-ads-python python -m pip install .
Nếu bạn có ý định phát triển thư viện, hãy chạy kiểm thử đơn vị trước và sau khi thực hiện bất kỳ thay đổi nào:
Đảm bảo rằng bạn có tất cả phiên bản ngôn ngữ Python được hỗ trợ trong môi trường của mình. Sử dụng
pyenv
::pyenv local 3.8 3.9 3.10 3.11 3.12
Cài đặt các phần phụ thuộc dành riêng cho kiểm thử của thư viện:
python -m pip install .[tests]
Chạy chương trình kiểm thử đơn vị để đảm bảo thư viện hoạt động đúng cách:
nox
Không bắt buộc: bạn cũng có thể chạy kiểm thử đơn vị bằng Docker. Trước tiên, bạn phải cài đặt Docker. Sau đó, từ thư mục
google-ads-python
, hãy chạy lệnh sau:docker build -t google-ads-python:test . docker run -it google-ads-python:test nox