ไลบรารีของไคลเอ็นต์ 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 เราไม่สามารถรับประกันความเข้ากันได้กับรันไทม์ EOL เนื่องจากไลบรารีที่เผยแพร่หลังจากวันที่ EOL อาจทำให้เกิดปัญหาความเข้ากันได้
สำหรับทรัพยากร Dependency (โดยเฉพาะแพ็กเกจที่ Google ดูแลรักษาและ ระบุว่าไลบรารีของไคลเอ็นต์ Python ต้องใช้) เราจะยังคงความเข้ากันได้กับแพ็กเกจที่ Google ดูแลรักษาและถือว่า "รองรับ" ตามนโยบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบของ OSS ของ Google
ดูรายการรันไทม์ Python และส่วนประกอบที่ต้องใช้ทั้งหมดที่รองรับได้ในหน้า ส่วนประกอบที่ต้องใช้
การติดตั้ง
คู่มือการติดตั้งจะอธิบายวิธีต่างๆ ในการ
ติดตั้งไลบรารี วิธีที่ง่ายที่สุด (และแนะนำ) ในการติดตั้งไลบรารีลงในแอปพลิเคชันคือการใช้ 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 ได้แล้ว ให้ดำเนินการตามการใช้งานไลบรารีของไคลเอ็นต์ต่อไปนี้