การติดตั้ง

ไม่ว่าคุณจะติดตั้งไลบรารีจาก 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. ทำการทดสอบ 1 หน่วยเพื่อให้แน่ใจว่าไลบรารีทำงานอย่างถูกต้อง ดังนี้

      nox
      

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

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