ไลบรารีของไคลเอ็นต์ Python โฮสต์ใน GitHub และแพ็กเกจพร้อมใช้งานใน PyPI
ข้อกำหนด
ไลบรารีต้องใช้ Python 3.9 ขึ้นไป
ข้อกำหนดเบื้องต้น
ก่อนที่จะดำเนินการตามคำแนะนำนี้ คุณจะต้องมีโทเค็นของนักพัฒนาซอฟต์แวร์สำหรับ Google Ads API และรหัสลูกค้าของลูกค้า 10 หลักสำหรับบัญชี Google Ads
ความเข้ากันได้ของรันไทม์และการขึ้นต่อกัน
ไลบรารีของไคลเอ็นต์ Python จะรักษาความเข้ากันได้กับรันไทม์ Python ในส่วนเวอร์ชันที่รองรับที่เผยแพร่โดยPython Software Foundation ยกเว้นเวอร์ชันที่มีสถานะเป็น "ฟีเจอร์" หรือ "รุ่นก่อนเปิดตัว"
เรามุ่งมั่นที่จะนำรันไทม์ 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 ดูตัวอย่าง get campaigns เพื่อดูวิธีทดสอบอย่างรวดเร็วว่ากำหนดค่าไลบรารีอย่างถูกต้องเพื่อส่งคำขอ API หรือไม่
หากต้องการเรียกใช้ตัวอย่าง get_campaigns.py ให้เรียกใช้คำสั่งต่อไปนี้ในไดเรกทอรีรากของไลบรารีไคลเอ็นต์ googleads-python ที่ติดตั้งในเครื่อง
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
แหล่งข้อมูลเพิ่มเติม
หลังจากส่งคำขอ API ได้แล้ว ให้ดำเนินการต่อเพื่อใช้ไลบรารีไคลเอ็นต์ดังนี้