ไลบรารีของไคลเอ็นต์ 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
ดูรายการรันไทม์และทรัพยากร Dependency ของ Python ที่รองรับทั้งหมดได้ที่หน้า ทรัพยากร Dependency
การติดตั้ง
คู่มือการติดตั้งของเราแสดงวิธีต่างๆ
ในการติดตั้งไลบรารี วิธีที่ง่ายที่สุด (และแนะนำ) ในการติดตั้งไลบรารีลงในแอปพลิเคชันคือการใช้ pip
$ python -m pip install google-ads
การกำหนดค่า
เมื่อติดตั้งไลบรารีแล้ว คุณจะต้องตั้งค่าการกำหนดค่าสำหรับไลบรารี คุณกำหนดค่าไลบรารีได้หลายวิธี ซึ่งอธิบายไว้ใน คู่มือการกำหนดค่า
การตรวจสอบสิทธิ์
เมื่อเลือกแนวทางการกำหนดค่าแล้ว คุณก็ตั้งค่าการกำหนดค่าการตรวจสอบสิทธิ์ได้ ดูวิธีการแบบทีละขั้นตอนได้ที่ คู่มือการตรวจสอบสิทธิ์ไลบรารีของไคลเอ็นต์ Python และดูข้อมูลเบื้องหลังทั่วไปเพิ่มเติมได้ที่ ภาพรวมของ OAuth
ส่งคำขอ API
เมื่อตั้งค่าการกำหนดค่าการตรวจสอบสิทธิ์แล้ว คุณก็พร้อมที่จะส่งคำขอ API โปรดดูตัวอย่าง การรับแคมเปญเพื่อดู วิธีที่รวดเร็วในการทดสอบว่าไลบรารีได้รับการกำหนดค่าอย่างถูกต้องเพื่อส่งคำขอ API
หากต้องการเรียกใช้ตัวอย่าง get_campaigns.py ให้เรียกใช้คำสั่งต่อไปนี้ในไดเรกทอรีรากของไลบรารีของไคลเอ็นต์ googleads-python ที่ติดตั้งในเครื่อง
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
แหล่งข้อมูลเพิ่มเติม
หลังจากส่งคำขอ API ได้แล้ว ให้ดำเนินการตามการใช้งานไลบรารีของไคลเอ็นต์ต่อไปนี้