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; Python 3.14 được thêm vào v28.2.0). Vì Python 3.9 và 3.10 đưa ra cảnh báo ngừng sử dụng khi nhập trong google-ads v32.0.0 trở lên, nên bạn nên sử dụng Python 3.11 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 của khách hàng gồm 10 chữ số của tài khoản Google Ads.
Khả năng tương thích của 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 môi trường thời gian chạy Python trong phần 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 đặt mục tiêu áp dụng các phiên bản mới của môi trường thời gian chạy Python ngay khi các phiên bản đó được phát hành và được Python Software Foundation chính thức hỗ trợ.
Những môi trường 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 Unsupported Versions (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 các môi trường thời gian chạy đã ngừng hoạt động, vì các bản phát hành của thư viện sau ngày ngừng hoạt động có thể khô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 theo 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 về thay đổi có thể gây lỗi đối với phần mềm nguồn mở của Google.
Để xem danh sách đầy đủ các phần phụ thuộc và môi trường thời gian chạy Python được 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 cấu hình.
Xác thực
Sau khi chọn một phương pháp định cấu hình, hãy thiết lập cấu hình xác thực. Để biết 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 cơ bản 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 có thể gửi yêu cầu API. Tham khảo ví dụ về lấy chiến dịch để biết cách nhanh chóng kiểm tra xem thư viện đã được định cấu hình đúng cách để gửi yêu cầu API hay chưa.
Để 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 tiếp tục sử dụng thư viện ứng dụng theo các cách sau: