ภาพรวม

ไลบรารีของไคลเอ็นต์ Python โฮสต์ใน GitHub และแพ็กเกจมีอยู่ใน PyPI

ข้อกำหนด

ไลบรารีนี้ต้องใช้ Python 3.8 ขึ้นไป

ข้อกำหนดเบื้องต้น

ก่อนติดตั้งไลบรารี คุณจะต้องมีโทเค็นนักพัฒนาแอปและรหัสลูกค้า วิธีการรับข้อมูลดังกล่าวระบุไว้ในส่วนข้อกําหนดเบื้องต้น โปรดทราบว่าคุณจะสร้างโทเค็น OAuth2 อื่นๆ ที่จำเป็นในขั้นตอนถัดไป

ความเข้ากันได้ของรันไทม์และ Dependency

ไลบรารีของไคลเอ็นต์ Python รักษาความเข้ากันได้กับรันไทม์ของ Python ใน เวลา เวอร์ชันที่รองรับ เผยแพร่โดย Python Software Foundation ยกเว้น เวอร์ชันที่มีสถานะ "ฟีเจอร์" หรือ "prerelease"

เมื่อใช้รันไทม์ Python เวอร์ชันใหม่ เราตั้งเป้าที่จะเผยแพร่รันไทม์ ไลบรารีของไคลเอ็นต์ Python เวอร์ชันที่ใช้งานร่วมกับรันไทม์ล่าสุดได้ ภายในสิ้นไตรมาสหลังจากการเปิดตัว เช่น หากรันไทม์ใหม่เปิดตัวในเดือนตุลาคม ไลบรารีไคลเอ็นต์ Python เวอร์ชันที่เข้ากันได้จะพร้อมใช้งานภายในสิ้นเดือนมีนาคมของปีถัดไป

ระบบจะไม่รองรับรันไทม์ Python ที่สิ้นสุดอายุการใช้งาน (EOL) ไปแล้วหลังจากวันที่สิ้นสุดอายุการใช้งานในส่วนเวอร์ชันที่ไม่รองรับของ python.org

เราอาจเผยแพร่ไลบรารีของไคลเอ็นต์ Python เวอร์ชันที่เข้ากันไม่ได้กับ รันไทม์ของ Python ที่ไม่รองรับในช่วงใดก็ได้หลังจากไปถึง EOL แล้ว

สำหรับไลบรารีที่ใช้ร่วมกัน (โดยเฉพาะแพ็กเกจที่ Google ดูแลซึ่งระบุไว้ว่าต้องใช้งานโดยไลบรารีไคลเอ็นต์ Python) เราจะรักษาความเข้ากันได้กับแพ็กเกจที่ Google ดูแล และถือว่า "รองรับ" ตามนโยบายการเปลี่ยนแปลงที่ก่อให้เกิดข้อขัดข้องใน OSS ของ Google

ดูรายการรันไทม์และไลบรารีที่รองรับทั้งหมดของ Python ได้ที่หน้าไลบรารี

การติดตั้ง

ทำตามคำแนะนำในการติดตั้งของเรา เอกสารประกอบการติดตั้งไลบรารีจาก PyPi และกลับมาที่หน้านี้

การกำหนดค่า

เมื่อคุณติดตั้งไลบรารีแล้ว คุณจะต้องตั้งค่าการกำหนดค่าสำหรับ ได้ คุณสามารถกำหนดค่าไลบรารีได้หลายวิธี ซึ่งอธิบายไว้ใน configuration

การตรวจสอบสิทธิ์

เมื่อคุณเลือกประเภทการกำหนดค่าแล้ว คุณก็สามารถสร้าง โทเค็น OAuth2 ที่เหลือซึ่งจำเป็นต่อการส่งคำขอไปยัง API มีหลายขั้นตอน OAuth2 ที่รองรับ ซึ่งระบุไว้ในรายการด้านล่าง ดูรายละเอียดเกี่ยวกับความแตกต่างระหว่างขั้นตอนต่างๆ และความช่วยเหลือในการตัดสินใจว่าขั้นตอนใดเหมาะกับแอปพลิเคชันของคุณมากที่สุดได้ที่เอกสารประกอบเกี่ยวกับ OAuth

การส่งคำขอ API

เมื่อคุณรวมโทเค็น OAuth2 เข้ากับการกำหนดค่าแล้ว คุณจะทำสิ่งต่อไปนี้ได้ พร้อมที่จะส่งคำขอ API โปรดดู ตัวอย่าง get campaign สำหรับ วิธีง่ายๆ ในการทดสอบว่ามีการกำหนดค่าไลบรารีอย่างเหมาะสมเพื่อทำ API คำขอ

หากต้องการเรียกใช้ตัวอย่าง get_campaigns.py ให้เรียกใช้คําสั่งต่อไปนี้ในไดเรกทอรีรูทของไลบรารีไคลเอ็นต์ googleads-python ที่ติดตั้งในเครื่อง

$ python examples/basic_operations/get_campaigns.py -c \
  INSERT_YOUR_CUSTOMER_ID_HERE

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

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