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 yêu cầu Python 3.9 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 sẽ cần có mã của nhà phát triển cho API Google Ads và mã khách hàng gồm 10 chữ số cho tài khoản Google Ads của bạn.
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 thời gian chạy Python trong phần Các phiên bản được hỗ trợ do Python Software Foundation xuất bản, 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".
Chúng tôi 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 chúng được phát hành và được Python Software Foundation hỗ trợ chính thức.
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 các thời gian chạy EOL, vì chúng tôi có thể phát hành một phiên bản thư viện không tương thích với các thời gian chạy đó bất cứ lúc nào sau ngày EOL.
Đố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), chúng tôi sẽ duy trì khả năng tương thích với các gói do Google duy trì và được coi là "được hỗ trợ" theo Chính sách thay đổi gây ảnh hưởng đến OSS của Google.
Để xem danh sách đầy đủ các thời gian chạy và phần phụ thuộc Python được hỗ trợ, hãy xem trang Phần phụ thuộc.
Cài đặt
Hướng dẫn cài đặt của chúng tôi cho thấy tất cả các cách cài đặt thư viện. Cách đơn giản nhất (và nên dùng) để 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 sẽ 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 của chúng tôi.
Xác thực
Sau khi chọn một phương pháp định cấu hình, bạn có thể 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 và để biết thêm thông tin chung, hãy xem 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ụ get campaigns (lấy chiến dịch) để có cách nhanh chóng kiểm tra xem thư viện đã được định cấu hình đúng cách để thực hiện các yêu cầu API hay chưa.
Để chạy mẫu get_campaigns.py, trong thư mục gốc của thư viện ứng dụng googleads-python được cài đặt cục bộ, hãy chạy lệnh sau:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
Tài nguyên khác
Sau khi bạn có thể thực hiện một yêu cầu API, hãy chuyển sang các cách sử dụng sau đây của thư viện ứng dụng: