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