Ra mắt Trợ lý nhà phát triển Google Ads API phiên bản 2.0

Thứ Năm, ngày 26 tháng 2 năm 2026

Bản cập nhật quan trọng này biến Trợ lý từ một công cụ tạo mã mạnh mẽ thành một đối tác chủ động khắc phục sự cố và tự động hoá cho các nhà phát triển Google Ads. Kể từ khi phát hành phiên bản 1.6.0, chúng tôi đã lắng nghe ý kiến phản hồi của bạn và tập trung vào những phần khó khăn nhất trong quá trình phát triển API: chẩn đoán, tính nhất quán và thiết lập.

Tính năng mới trong phiên bản 2.0

1. Cài đặt và bảo trì đơn giản hơn

Việc thiết lập môi trường phát triển đa ngôn ngữ không nên là một việc vặt.

  • Thiết lập bằng một lệnh: Sử dụng cờ --install-deps mới với install.sh hoặc install.ps1 để xử lý các phần phụ thuộc pip, composer và bundler cùng một lúc.
  • Cấu trúc thư mục hợp nhất: Tất cả mã được tạo, tệp CSV xuất và báo cáo chẩn đoán hiện được sắp xếp trong một thư mục saved/ duy nhất, có các thư mục con cho từng loại kết quả.
  • Cập nhật bằng một lệnh: Khi phiên bản mới của API và thư viện ứng dụng được phát hành, bạn cần thực thi update.sh để làm việc với phiên bản mới nhất. Bạn cũng có thể sử dụng update.sh để thêm các thư viện ứng dụng khác vào bối cảnh của mình.

2. Khắc phục sự cố về lượt chuyển đổi do tác nhân thực hiện

Theo dõi lượt chuyển đổi ngoại tuyến là một trong những tính năng mạnh mẽ nhất nhưng cũng phức tạp nhất của API Google Ads. Việc gỡ lỗi để tìm hiểu lý do một lượt chuyển đổi không được phân bổ có thể là một quy trình thủ công tốn thời gian.

Trong phiên bản 2.0, chúng tôi đã ra mắt một bộ công cụ chuyên biệt để Khắc phục sự cố và chẩn đoán lượt chuyển đổi.

  • Tập lệnh mới: api_examples/collect_conversions_troubleshooting_data.py
  • Lệnh mới: /conversions_support_data

Tập lệnh này chạy các báo cáo chuẩn để khắc phục sự cố về lượt chuyển đổi và cung cấp bối cảnh để Trợ lý khắc phục vấn đề của bạn.

Lệnh này hữu ích nhất sau khi Trợ lý đã phân tích vấn đề về lượt chuyển đổi và cố gắng giải quyết vấn đề đó. Nếu không thể và bạn cần liên hệ với nhóm hỗ trợ, thì lệnh này sẽ phân tích chế độ cài đặt khách hàng, hành động chuyển đổi và thông tin tóm tắt về lượt tải lên để tạo báo cáo chẩn đoán có cấu trúc dựa trên thông tin phân tích đã thực hiện. Công cụ này thậm chí còn tự động xác định các trạng thái "không ổn định" và tỷ lệ lỗi cao, giúp bạn tiết kiệm hàng giờ tìm hiểu nhật ký. Công cụ này lưu kết quả vào một tệp văn bản mà bạn có thể đính kèm vào yêu cầu hỗ trợ nếu cần gửi yêu cầu.

3. Được xây dựng cho API mới nhất (phiên bản 23)

Phiên bản 2.0 hỗ trợ đầy đủ Google Ads API phiên bản 23. Tất cả ví dụ tương tác của chúng tôi đều đã được cập nhật và bối cảnh nội bộ của Trợ lý hiện được tối ưu hoá cho các tài nguyên và trường mới nhất, đảm bảo mã bạn tạo đã sẵn sàng cho môi trường thực tế.

4. Tự động hoá liền mạch bằng Session Hook

Chúng tôi đã thêm móc SessionStart và SessionEnd để giúp quy trình làm việc của bạn thực sự suôn sẻ.

  • Cấu hình tự động: Trợ lý hiện có thể tự động tìm tệp cấu hình trong thư mục $HOME của bạn khi bắt đầu một phiên. Thao tác này sẽ sao chép tệp vào thư mục con config trong thư mục dự án của bạn. Python là ngôn ngữ mà Gemini ưu tiên sử dụng để truy vấn API. Vì vậy, nếu bạn đang sử dụng một ngôn ngữ khác, thì thư viện này sẽ đọc tệp cấu hình của bạn và tạo một tệp google-ads.yaml tạm thời trong cấu hình cho các truy vấn của thư viện, nhưng vẫn tiếp tục phản hồi bằng mã của ngôn ngữ bạn ưu tiên.
  • Tự động dọn dẹp: Các cấu hình tạm thời sẽ được xoá một cách an toàn khi bạn thoát, giúp không gian làm việc của bạn luôn sạch sẽ và thông tin đăng nhập của bạn luôn an toàn.

5. Xác thực GAQL thông minh hơn

Việc tạo các truy vấn GAQL phức tạp trở nên dễ dàng hơn bao giờ hết. Chúng tôi đã cập nhật GEMINI.md và conversions/GEMINI.md bằng các quy tắc xác thực nghiêm ngặt cho các trường hợp hiếm gặp mới nhất của API, bao gồm cả việc cải thiện cách xử lý các phân đoạn ngày và yêu cầu về phạm vi hữu hạn. Giờ đây, Trợ lý sẽ phát hiện lỗi logic trước khi bạn thực thi truy vấn.

6. Kỹ năng

Hãy coi Kỹ năng là một trình bổ trợ nhỏ hoặc một "bản thiết kế hành vi". Mặc dù bối cảnh chung (như tệp GEMINI.md của bạn) cung cấp thông tin cơ bản, nhưng một Kỹ năng chỉ được "tải" vào bộ não của AI khi AI cần thực hiện một nhiệm vụ phức tạp, theo quy trình, chẳng hạn như lấy phiên bản hiện tại của tiện ích này. Bạn không trực tiếp thực thi Kỹ năng. Gemini sẽ quyết định khi nào cần dùng.

Mặc dù vẫn là một tính năng thử nghiệm, nhưng chúng tôi đã đưa một tính năng vào bản phát hành này để bổ sung cho việc sử dụng hook để khởi chạy và dọn dẹp phiên.

Tại sao bạn nên nâng cấp?

Bước nhảy vọt từ phiên bản 1.6.0 lên 2.0.0 không chỉ mang đến các tính năng mới mà còn cải thiện độ tin cậy. Bằng cách tích hợp kiến thức chuyên sâu về API với các công cụ chẩn đoán tự động, phiên bản 2.0 giúp giảm bớt quy trình "thử và sai" thường làm chậm quá trình tích hợp API.

Cho dù bạn đang gỡ lỗi cho việc tải lượt chuyển đổi lên hay xây dựng quy trình báo cáo phức tạp, phiên bản 2.0 đều cung cấp cho bạn các công cụ để làm việc nhanh hơn và tự tin hơn.

Bắt đầu

Lần cài đặt đầu tiên

Nâng cấp từ phiên bản trước

  • Sao chép mọi mã tuỳ chỉnh từ saved_code/ và saved_csv/ vào một vị trí an toàn.
  • Xoá bản sao cục bộ của Trợ lý nhà phát triển Google Ads API bằng cách xoá thư mục dự án cũng như tất cả thư mục con và tệp.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • Trong thư mục dự án, hãy chạy install.sh hoặc install.ps1 để cài đặt tiện ích và thư viện ứng dụng.

Bob Hancock, Nhóm Google Ads API

Nhãn: google-ads-api, release