ภาพรวม

ไลบรารีของไคลเอ็นต์ 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 ดูตัวอย่างรับแคมเปญเพื่อทดสอบอย่างรวดเร็วว่าไลบรารีได้รับการกำหนดค่าอย่างถูกต้องเพื่อส่งคำขอ API

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

python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE

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

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