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

Thứ Tư, ngày 10 tháng 6 năm 2026

Chúng tôi rất vui mừng thông báo về việc phát hành phiên bản 3.0.0 của Trợ lý nhà phát triển Google Ads API. Bản phát hành chính này đánh dấu một cột mốc quan trọng trong quá trình phát triển của Trợ lý, tập trung vào việc hiện đại hoá cấu trúc, cải thiện độ tin cậy và thiết kế mô-đun hơn.

Trong bản phát hành này, chúng tôi sẽ di chuyển Trợ lý sang khung tác nhân Antigravity của Google và chuyển sang cấu trúc dựa trên Kỹ năng. Những thay đổi này giúp Trợ lý hoạt động hiệu quả hơn, dễ bảo trì hơn và giảm mức sử dụng mã thông báo.

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

1. Dựa trên khung Antigravity

Trợ lý nhà phát triển Google Ads API đã di chuyển từ gemini-cli sang khung tác nhân Antigravity (phiên bản 3.0.0). Bản nâng cấp khung cơ bản này mang đến một môi trường thực thi có cấu trúc và đáng tin cậy hơn. Cùng với đó, cấu trúc thư mục và tệp của dự án đã được cập nhật để hoàn toàn sẵn sàng cho Antigravity.

Chúng tôi sẽ ngừng hỗ trợ gemini-cli kể từ ngày 18 tháng 6 năm 2026, như đã nêu chi tiết trong thông báo này trên blog của Google.

2. Kiến trúc dạng mô-đun, dựa trên kỹ năng

Chúng tôi đã chuyển các chức năng cốt lõi của Trợ lý sang Kỹ năng. Thay vì dựa vào các hướng dẫn chung chung, không có cấu trúc trong tệp ngữ cảnh, Trợ lý giờ đây sẽ tải động các thư mục công cụ chuyên biệt, đã được kiểm thử (Kỹ năng) khi cần. Điều này giúp giảm đáng kể tình trạng "ảo tưởng" và đảm bảo các nhiệm vụ được thực thi bằng quy trình chính xác, đã được xác minh.

Những điểm cập nhật chính trong quá trình chuyển đổi sang mô-đun này bao gồm:

  • Xác thực GAQL (validate_gaql): Chuyển sang một kỹ năng chuyên biệt. Giờ đây, công cụ này có các tính năng kiểm tra truy vấn tĩnh nâng cao cho các phân đoạn ngày, bộ lọc một ngày click_view và ranh giới change_status.
  • Khắc phục sự cố về lượt chuyển đổi (troubleshoot_conversions): Thay thế conversions_support_package cũ. Kỹ năng này hợp nhất tất cả các tập lệnh và bài kiểm thử về việc khắc phục sự cố và tải bản tóm tắt lượt chuyển đổi lên thành một thư mục kỹ năng duy nhất và gắn kết.
  • Lệnh có cấu trúc (explain và step_by_step): Được chuyển đổi thành kỹ năng để thực thi bố cục nhất quán, có cấu trúc cho nội dung giải thích.
  • Liên kết tài khoản mới (get_cids_under_mcc): Một kỹ năng mới để truy xuất tất cả tài khoản con trong một Tài khoản người quản lý (MCC).
  • Kiểm tra đối tượng mới (inspect_object): Một kỹ năng mới để tự động tra cứu thông báo Protobuf và Enum, giúp đảm bảo Trợ lý luôn sử dụng đúng cấu trúc.
  • Bộ lọc trang thông tin mới của chiến dịch Tối đa hoá hiệu suất (pmax_listing_filter): Một kỹ năng mới để chuẩn hoá các nội dung sửa đổi đối với cây loại trừ trang web của nhóm trang thông tin cho chiến dịch Tối đa hoá hiệu suất.

3. Tăng cường tính nhất quán và nghiêm ngặt

Chúng tôi đã đưa ra các quy tắc và yêu cầu nghiêm ngặt hơn để giúp đảm bảo việc tạo mã và xác thực truy vấn có chất lượng cao:

  • Tạo phiên bản API rõ ràng: Các kỹ năng quan trọng như get_cids_under_mcc, validate_gaql và troubleshoot_conversions hiện yêu cầu đối số api_version rõ ràng, giúp loại bỏ sự mơ hồ.
  • Quy tắc nghiêm ngặt của GAQL:
    • Thêm một quy tắc vào AGENTS.md để ngăn việc sử dụng các hàm tổng hợp SQL (chẳng hạn như SUM, COUNT và AVG) trong truy vấn GAQL, vì các hàm này không được hỗ trợ.
    • Thêm một quy tắc để kiểm tra ghi chú phát hành trên trang web dành cho nhà phát triển Google Ads API trước tiên cho phiên bản API hiện tại để đảm bảo Trợ lý sử dụng tài liệu mới nhất.
    • Cấu hình tinh gọn: AGENTS.md đã được tinh gọn, giúp cửa sổ ngữ cảnh ban đầu nhỏ hơn. Tài liệu về lượt chuyển đổi trùng lặp đã bị xoá để nhường chỗ cho các kỹ năng lập trình.

4. Cải thiện trải nghiệm cho nhà phát triển (DX)

Chúng tôi đã thực hiện một số điểm cải tiến về chất lượng để giúp vòng lặp phát triển của bạn nhanh hơn và mượt mà hơn:

  • Môi trường ảo ổn định (.venv): Môi trường ảo không còn bị xoá khi kết thúc phiên. Khi khởi động, Trợ lý sẽ kiểm tra phiên bản Python của hệ thống; Trợ lý chỉ tạo lại .venv nếu có phiên bản Python mới hơn.
  • Lưu phiên bản API thông minh vào bộ nhớ đệm: Trợ lý hiện lưu phiên bản Google Ads API hiện tại vào bộ nhớ đệm với TTL là 19 giờ, giúp giảm thời gian khởi động bằng cách tránh các hoạt động kiểm tra mạng thừa.
  • Gỡ lỗi hiệu quả hơn nhờ nhật ký ổn định: Thông điệp nhật ký hiện có dấu ngày giờ. Tệp nhật ký được ghi vào thư mục .agents/ và không còn được đặt lại sau mỗi lần chạy, giúp lưu giữ nhật ký để khắc phục sự cố.

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

Việc nâng cấp lên phiên bản 3.0.0 chủ yếu là về độ tin cậy và cấu trúc. Bằng cách chuyển sang khung Antigravity và mô-đun hoá các tính năng thành Kỹ năng, chúng tôi đã giúp Trợ lý hoạt động dễ dự đoán hơn và sử dụng tài nguyên hiệu quả hơn.

Nếu muốn khởi động nhanh hơn, xác thực GAQL đáng tin cậy hơn và khắc phục sự cố hiệu quả hơn, bạn nên nâng cấp lên phiên bản 3.0.0.

Bắt đầu

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

  1. Cài đặt Antigravity CLI: Làm theo hướng dẫn tại https://antigravity.google/.
  2. Sao chép Trợ lý: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. Chạy tập lệnh cài đặt:
    • Linux/macOS: Chạy ./install.sh (mặc định là hỗ trợ Python, sử dụng các cờ như --php hoặc --ruby cho các ngôn ngữ khác).
    • Windows: Mở PowerShell rồi chạy .\install.ps1.

Nâng cấp từ phiên bản 2.x

  1. Sao chép mọi mã hoặc dữ liệu tuỳ chỉnh từ saved/ vào một vị trí an toàn bên ngoài thư mục dự án.
  2. Xoá bản sao cục bộ của Trợ lý.
  3. Sao chép kho lưu trữ:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. Chạy tập lệnh cài đặt (install.sh hoặc install.ps1) để khởi động môi trường Antigravity mới.

Bob Hancock, Nhóm Google Ads API

Nhãn: google-ads-api, release