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.8 trở lên.
Điều kiện tiên quyết
Trước khi cài đặt thư viện, bạn cần có mã thông báo dành cho nhà phát triển và mã khách hàng của ứng dụng. Hướng dẫn về cách lấy các tệp này được nêu trong phần điều kiện tiên quyết. Xin lưu ý rằng bạn sẽ tạo các mã thông báo OAuth2 bắt buộc khác ở các bước sau.
Khả năng tương thích với 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 các 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 là "tính năng" hoặc "bản phát hành trước".
Khi sử dụng các phiên bản mới của môi trường thời gian chạy Python, chúng tôi dự định phát hành phiên bản mới của thư viện ứng dụng Python tương thích với môi trường thời gian chạy mới nhất vào cuối quý sau khi phát hành. Ví dụ: nếu thời gian chạy mới được phát hành vào tháng 10, thì phiên bản tương thích của thư viện ứng dụng Python sẽ ra mắt vào cuối tháng 3 năm sau.
Chúng tôi không hỗ trợ các môi trường thời gian chạy Python đã hết hạn sử dụng (EOL) sau ngày hết hạn sử dụng trong mục Phiên bản không được hỗ trợ trên python.org.
Chúng tôi có thể phát hành một phiên bản thư viện ứng dụng Python không tương thích với các môi trường thời gian chạy Python không được hỗ trợ bất cứ lúc nào sau khi các phiên bản đó đạt đến EOL.
Đối với các phần phụ thuộc (cụ thể là mọi gói do Google duy trì được thư viện ứng dụng Python liệt kê là bắt buộc), 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 về thay đổi có thể gây lỗi OSS của Google.
Để xem danh sách đầy đủ các môi trường thời gian chạy và phần phụ thuộc được hỗ trợ của Python, hãy xem trang Phần phụ thuộc.
Cài đặt
Làm theo hướng dẫn trong tài liệu cài đặt của chúng tôi để cài đặt thư viện từ PyPi và quay lại trang này.
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 tài liệu về cấu hình của chúng tôi.
Xác thực
Sau khi chọn một loại cấu hình, bạn có thể tiếp tục tạo các mã thông báo OAuth2 còn lại cần thiết để gửi yêu cầu đến API. Có nhiều luồng OAuth2 được hỗ trợ, được ghi lại trong danh sách bên dưới. Để biết thông tin chi tiết về sự khác biệt giữa các luồng và giúp bạn quyết định luồng nào phù hợp nhất với ứng dụng của mình, hãy xem tài liệu về OAuth của chúng tôi.
Tạo yêu cầu API
Sau khi tích hợp mã thông báo OAuth2 vào cấu hình, bạn đã sẵn sàng tạo yêu cầu API. Hãy tham khảo ví dụ về cách lấy chiến dịch để biết một cách đơn giản để kiểm tra xem thư viện có được định cấu hình đúng cách để tạo các yêu cầu API hay không.
Để 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ể 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: