การติดตั้ง

ไม่ว่าคุณจะติดตั้งไลบรารีจาก PyPI หรือโคลนไลบรารีจาก GitHub เราขอแนะนำให้คุณทำตามขั้นตอนด้านล่างโดยใช้สภาพแวดล้อมเสมือนที่ใช้งานอยู่ ดูข้อมูลเกี่ยวกับวิธีสร้างและเปิดใช้งานสภาพแวดล้อมเสมือนได้ที่เอกสารสภาพแวดล้อมเสมือน

ติดตั้งโมดูลจาก PyPI

ไลบรารีกระจายอยู่ใน PyPI และติดตั้งได้โดยใช้ pip ด้วยคำสั่งต่อไปนี้

python -m pip install google-ads

ติดตั้งไลบรารีจาก GitHub

คุณโคลนซอร์สโค้ดของไลบรารีจาก GitHub ไปยังเครื่องของคุณได้ การโคลนซอร์สโค้ดเพื่อให้เรียกใช้ตัวอย่างหรือพัฒนาไลบรารีได้ง่ายๆ นั้นมีประโยชน์ เพื่อเป็นข้อมูลอ้างอิง การเรียกใช้ตัวอย่างการตรวจสอบสิทธิ์เป็นขั้นตอนที่จำเป็นในการกำหนดค่าไลบรารีเพื่อใช้งาน

  1. ตรวจสอบว่ามี python3.8 ขึ้นไปในสภาพแวดล้อมของคุณ วิธีที่ง่ายที่สุดคือการใช้ pyenv ดังนี้

    pyenv local 3.8

  2. โคลนไลบรารีของไคลเอ็นต์จาก GitHub โดยทำดังนี้

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

  3. ป้อนที่เก็บแล้วติดตั้ง

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

  4. หากคุณต้องการพัฒนาไลบรารี ให้เรียกใช้การทดสอบ 1 หน่วยก่อนและหลังทำการเปลี่ยนแปลง

    1. ตรวจสอบว่าคุณมีภาษา Python เวอร์ชันที่รองรับทั้งหมดที่พร้อมใช้งานในสภาพแวดล้อมของคุณ ใช้ pyenv:

      pyenv local 3.8 3.9 3.10 3.11 3.12

    2. ติดตั้งทรัพยากร Dependency สำหรับการทดสอบของไลบรารีด้วยการดำเนินการต่อไปนี้

      python -m pip install .[tests]

    3. เรียกใช้การทดสอบหน่วยเพื่อตรวจสอบว่าไลบรารีทำงานได้อย่างถูกต้อง ดังนี้

      nox

    4. ไม่บังคับ: คุณทำการทดสอบ 1 หน่วยโดยใช้ Docker ได้ด้วย ก่อนอื่นคุณต้องติดตั้ง Docker จากนั้นเรียกใช้จากไดเรกทอรี google-ads-python ดังนี้

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