ไม่ว่าคุณจะติดตั้งไลบรารีจาก PyPI หรือโคลนจาก GitHub เราขอแนะนำให้คุณทำตามขั้นตอนด้านล่างโดยใช้สภาพแวดล้อมเสมือนที่ใช้งานอยู่ ดูข้อมูลเกี่ยวกับวิธีสร้างและเปิดใช้งานสภาพแวดล้อมเสมือนได้ในเอกสารประกอบสภาพแวดล้อมเสมือน
ติดตั้งโมดูลจาก PyPI
ไลบรารีจะกระจายอยู่บน PyPI และติดตั้งได้โดยใช้ pip ด้วยคำสั่งต่อไปนี้
python -m pip install google-ads
ติดตั้งไลบรารีจาก GitHub
คุณโคลนซอร์สโค้ดของไลบรารีจาก GitHub ลงในเครื่องของคุณได้ การโคลนซอร์สโค้ดเพื่อให้เรียกใช้ตัวอย่างหรือพัฒนาไลบรารีได้ง่ายก็จะเป็นประโยชน์เช่นกัน สำหรับการอ้างอิง การเรียกใช้ตัวอย่างการตรวจสอบสิทธิ์เป็นขั้นตอนที่จำเป็นในการกำหนดค่าไลบรารีสำหรับการใช้งาน
ตรวจสอบว่า
python3.8
ขึ้นไปอยู่ในสภาพแวดล้อมของคุณ วิธีที่ง่ายที่สุดในการใช้คือการใช้pyenv
ดังนี้pyenv local 3.8
โคลนไลบรารีไคลเอ็นต์จาก GitHub ดังนี้
git clone git@github.com:googleads/google-ads-python.git
ป้อนที่เก็บและติดตั้งที่เก็บด้วยคำสั่งต่อไปนี้
cd google-ads-python python -m pip install .
หากคุณต้องการพัฒนาไลบรารี ให้เรียกใช้การทดสอบ 1 หน่วยก่อนและหลังการเปลี่ยนแปลงต่อไปนี้
ตรวจสอบว่าคุณมีภาษา Python เวอร์ชันที่รองรับทั้งหมดในสภาพแวดล้อมของคุณ กำลังใช้
pyenv
:pyenv local 3.8 3.9 3.10 3.11 3.12
ติดตั้งทรัพยากร Dependency เฉพาะทดสอบของไลบรารี
python -m pip install .[tests]
ทำการทดสอบ 1 หน่วยเพื่อให้แน่ใจว่าไลบรารีทำงานอย่างถูกต้อง ดังนี้
nox
ไม่บังคับ: คุณเรียกใช้การทดสอบ 1 หน่วยโดยใช้ Docker ได้ด้วย ขั้นแรก คุณต้องติดตั้ง Docker จากนั้นเรียกใช้ต่อไปนี้จากไดเรกทอรี
google-ads-python
docker build -t google-ads-python:test . docker run -it google-ads-python:test nox