การติดตั้ง

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

วิธีสร้างและเปิดใช้งานสภาพแวดล้อมเสมือนอย่างรวดเร็ว

python3 -m venv env
source env/bin/activate

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

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

python -m pip install google-ads

ยืนยันการติดตั้ง

ตรวจสอบว่าติดตั้งโมดูลอย่างถูกต้อง โดยทำดังนี้

python -c "import google.ads.googleads"

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

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

1. ตรวจสอบว่าสภาพแวดล้อมของคุณมี Python เวอร์ชันที่รองรับ (Python 3.9 ถึง 3.14 โดยแนะนำให้ใช้ Python 3.11 ขึ้นไป) วิธีที่ง่ายที่สุดคือใช้ pyenv โดยทำดังนี้

   pyenv install 3.13
   pyenv local 3.13

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

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

3. ป้อนที่เก็บและติดตั้งในโหมดที่แก้ไขได้ โดยทำดังนี้

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

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

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

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

   2. ติดตั้งทรัพยากร Dependency เฉพาะการทดสอบของไลบรารี

      python -m pip install -e ".[tests]"

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

      nox

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

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