ภาพรวม

ไลบรารีของไคลเอ็นต์ Python โฮสต์ใน GitHub และแพ็กเกจพร้อมให้บริการใน PyPI

ข้อกำหนด

ไลบรารีรองรับ Python 3.9 ถึง 3.14 (>=3.9, <3.15; เพิ่มการรองรับ Python 3.14 ใน v28.2.0) เนื่องจาก Python 3.9 และ 3.10 จะแสดงคำเตือนการเลิกใช้งาน เมื่อนำเข้าใน google-ads v32.0.0 และเวอร์ชันที่ใหม่กว่า เราจึงขอแนะนำให้ใช้ Python 3.11 หรือ เวอร์ชันที่ใหม่กว่า

ข้อกำหนดเบื้องต้น

ก่อนที่จะดำเนินการตามคำแนะนำนี้ คุณต้องมีรหัสลูกค้าของลูกค้า 10 หลักของบัญชี Google Ads

ความเข้ากันได้ของรันไทม์และการขึ้นต่อกัน

ไลบรารีของไคลเอ็นต์ Python จะรักษาความเข้ากันได้กับรันไทม์ Python ในส่วนเวอร์ชันที่รองรับซึ่งเผยแพร่โดยPython Software Foundation ยกเว้นเวอร์ชันที่มีสถานะเป็น "ฟีเจอร์" หรือ "รุ่นก่อนเปิดตัว"

ทีม Google Ads API ตั้งเป้าที่จะนำรันไทม์ Python เวอร์ชันใหม่มาใช้ทันที ที่ได้รับการเผยแพร่และได้รับการสนับสนุนอย่างเป็นทางการจาก Python Software Foundation

รันไทม์ Python ที่สิ้นสุดอายุการใช้งาน (EOL) จะไม่ได้รับการรองรับหลังจากวันที่ EOL ในส่วนเวอร์ชันที่ไม่รองรับของ python.org เราไม่สามารถรับประกันความเข้ากันได้กับรันไทม์ที่สิ้นสุดการสนับสนุนแล้ว เนื่องจากรุ่นของไลบรารี หลังจากวันที่สิ้นสุดการสนับสนุนอาจทำให้ความเข้ากันได้เสียไป

สำหรับทรัพยากร Dependency (โดยเฉพาะแพ็กเกจที่ Google ดูแลรักษาซึ่งระบุว่าจำเป็นโดยไลบรารีของไคลเอ็นต์ Python) จะมีการรักษาความเข้ากันได้กับแพ็กเกจที่ Google ดูแลรักษาและถือว่าเป็น "รองรับ" ตามนโยบายการเปลี่ยนแปลงที่ทำให้ใช้งานไม่ได้ของ OSS ของ Google

ดูรายการรันไทม์และทรัพยากร Dependency ของ Python ที่รองรับทั้งหมดได้ในหน้าทรัพยากร Dependency

การติดตั้ง

คู่มือการติดตั้งจะอธิบายวิธีต่างๆ ในการติดตั้งไลบรารี วิธีที่ง่ายที่สุด (และแนะนำ) ในการติดตั้งไลบรารี ลงในแอปพลิเคชันคือการใช้ pip:

python -m pip install google-ads

การกำหนดค่า

หลังจากติดตั้งไลบรารีแล้ว คุณต้องตั้งค่าการกำหนดค่าสำหรับไลบรารี คุณกำหนดค่าไลบรารีได้หลายวิธีตามที่อธิบายไว้ในคู่มือการกำหนดค่า

การตรวจสอบสิทธิ์

เมื่อเลือกแนวทางการกำหนดค่าแล้ว ให้ตั้งค่าการกำหนดค่าการตรวจสอบสิทธิ์ ดูวิธีการแบบทีละขั้นตอนได้ที่คู่มือการตรวจสอบสิทธิ์ของไลบรารีไคลเอ็นต์ Python ดูข้อมูลพื้นฐานเพิ่มเติมได้ที่ภาพรวมของ OAuth

ส่งคำขอ API

เมื่อตั้งค่าการกำหนดค่าการตรวจสอบสิทธิ์แล้ว คุณก็พร้อมที่จะส่งคำขอ API ดูตัวอย่าง get campaigns เพื่อดูวิธีที่รวดเร็ว ในการทดสอบว่าได้กําหนดค่าไลบรารีอย่างถูกต้องเพื่อทําคําขอ API

หากต้องการเรียกใช้get_campaigns.pyตัวอย่าง ให้โคลนgoogle-ads-pythonที่เก็บก่อน จากนั้นจากไดเรกทอรีรากของที่เก็บที่โคลน ให้เรียกใช้คำสั่งต่อไปนี้

python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE

แหล่งข้อมูลเพิ่มเติม

หลังจากส่งคำขอ API ได้แล้ว ให้ดำเนินการต่อเพื่อใช้ไคลเอ็นต์ ไลบรารีในกรณีต่อไปนี้