การติดตั้ง

ไม่ว่าคุณจะติดตั้งไลบรารีจาก 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. ตรวจสอบว่าคุณมี Python ทุกเวอร์ชันที่รองรับในสภาพแวดล้อมของคุณ การใช้ pyenv::

      pyenv local 3.8 3.9 3.10 3.11 3.12

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

      python -m pip install .[tests]

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

      nox

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

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