Cài đặt

Cho dù bạn cài đặt thư viện từ PyPI hay sao chép thư viện từ GitHub, chúng tôi bạn nên thực hiện các bước bên dưới bằng cách sử dụng một môi trường. Để biết thông tin về cách tạo và kích hoạt tài khoản ảo hãy 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 sau đây:

python -m pip install google-ads

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

Bạn có thể sao chép mã nguồn của thư viện từ GitHub trên máy cục bộ của bạn. 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 chính thư viện. Để tham khảo, chạy một trong các ví dụ về xác thực là bước bắt buộc trong quá trình định cấu hình thư viện để sử dụng.

  1. Đảm bảo rằng python3.8 trở lên hiện diện 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 từ GitHub:

    git clone git@github.com:googleads/google-ads-python.git
    
  3. Nhập và cài đặt kho lưu trữ:

    cd google-ads-python
    python -m pip install .
    
  4. Nếu bạn có ý định phát triển thư viện này, hãy chạy các bài kiểm thử đơn vị trước và sau 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 được hỗ trợ của ngôn ngữ Python môi trường của bạn. 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 dành riêng cho kiểm thử của thư viện:

      python -m pip install .[tests]
      
    3. Chạy bài 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 bài 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