Thư viện ứng dụng Python được lưu trữ trên GitHub và gói này có trên PyPI.
Yêu cầu
Thư viện này hỗ trợ Python 3.9 đến 3.14 (>=3.9, <3.15; tính năng hỗ trợ Python 3.14
đã được thêm vào v28.2.0). Vì Python 3.9 và 3.10 phát ra cảnh báo không dùng nữa
khi nhập trong google-ads v32.0.0 trở lên, nên bạn nên sử dụng Python 3.11 hoặc
trở lên.
Điều kiện tiên quyết
Trước khi tiếp tục với hướng dẫn này, bạn cần có mã khách hàng gồm 10 chữ số Khách hàng của khách hàng của tài khoản Google Ads.
Khả năng tương thích về thời gian chạy và phần phụ thuộc
Thư viện ứng dụng Python duy trì khả năng tương thích với thời gian chạy Python trong phần Các phiên bản được hỗ trợ do Python Software Foundation phát hành, ngoại trừ các phiên bản có trạng thái "tính năng" hoặc "bản phát hành trước".
Nhóm Google Ads API hướng đến việc áp dụng các phiên bản mới của thời gian chạy Python ngay khi các phiên bản này được Python Software Foundation phát hành và chính thức hỗ trợ.
Các thời gian chạy Python đã hết vòng đời (EOL) sẽ không được hỗ trợ sau ngày EOL trong phần Các phiên bản không được hỗ trợ của python.org. Chúng tôi không thể đảm bảo khả năng tương thích với thời gian chạy EOL, vì các bản phát hành của thư viện sau ngày EOL có thể làm mất khả năng tương thích.
Đối với các phần phụ thuộc (cụ thể là mọi gói do Google duy trì được liệt kê là bắt buộc đối với thư viện ứng dụng Python), khả năng tương thích được duy trì với các gói do Google duy trì và được coi là "được hỗ trợ" theo Chính sách của Google về thay đổi có thể gây lỗi OSS.
Để xem danh sách đầy đủ các thời gian chạy và phần phụ thuộc được Python hỗ trợ, hãy xem trang Phần phụ thuộc.
Cài đặt
Hướng dẫn cài đặt trình bày tất cả các cách
cài đặt thư viện. Cách đơn giản nhất (và được đề xuất) để cài đặt thư viện vào ứng dụng là dùng pip:
python -m pip install google-ads
Cấu hình
Sau khi cài đặt thư viện, bạn cần thiết lập cấu hình cho thư viện đó. Có nhiều cách để định cấu hình thư viện, được mô tả trong hướng dẫn định cấu hình.
Xác thực
Sau khi chọn phương pháp định cấu hình, hãy thiết lập cấu hình xác thực. Để xem hướng dẫn từng bước, hãy xem hướng dẫn xác thực thư viện ứng dụng Python. Để biết thêm thông tin chung, hãy xem bài viết Tổng quan về OAuth.
Tạo yêu cầu API
Sau khi thiết lập cấu hình xác thực, bạn đã sẵn sàng tạo yêu cầu API. Hãy tham khảo ví dụ về cách nhận chiến dịch để kiểm thử nhanh rằng thư viện được định cấu hình đúng cách để tạo yêu cầu API.
Để chạy mẫu get_campaigns.py, trước tiên, hãy sao chép kho lưu trữ
google-ads-python. Sau đó, từ thư mục gốc của kho lưu trữ đã sao chép, hãy chạy lệnh sau:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Tài nguyên khác
Sau khi bạn có thể tạo yêu cầu API, hãy chuyển sang các trường hợp sử dụng thư viện ứng dụng sau: