Cài đặt

Cho dù bạn đang cài đặt thư viện từ PyPI hay nhân bản 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, hãy xem tài liệu về Môi trường ảo.

Cài đặt mô-đun từ PyPI

Thư viện này được phân phối trên PyPI và bạn có thể cài đặt bằng pip bằng lệnh sau:

python -m pip install google-ads

Cài đặt thư viện từ GitHub

Bạn có thể sao chép mã nguồn của thư viện từ GitHub sang máy của mình. Bạn nên nhân bản mã nguồn để dễ dàng thực thi các ví dụ hoặc tự phát triển thư viện. Để tham khảo, bạn cần chạy một trong các ví dụ về xác thực trong bước định cấu hình thư viện để sử dụng.

  1. Đả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ụng pyenv:

    pyenv local 3.8

  2. Sao chép thư viện ứng dụng trên GitHub:

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

  3. Truy cập vào kho lưu trữ rồi cài đặt:

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

  4. Nếu bạn dự đị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:

    1. Đảm bảo 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

    2. Cài đặt các phần phụ thuộc cụ thể theo kiểm thử của thư viện:

      python -m pip install .[tests]

    3. Chạy kiểm thử đơn vị để đảm bảo thư viện hoạt động đúng cách:

      nox

    4. 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