Thứ Ba, ngày 25 tháng 8 năm 2026
Bản phát hành chính của Trợ lý nhà phát triển Google Ads API hiện đã ra mắt. Bản phát hành này chuyển trợ lý từ một dự án độc lập sang một cấu trúc trình bổ trợ hợp nhất, được thiết kế để đưa các chức năng chuyên biệt của Google Ads API trực tiếp vào quy trình làm việc của tác nhân AI.
Định nghĩa
Trợ lý nhà phát triển Google Ads API mang đến kiến thức chuyên môn sâu về Google Ads cho các môi trường lập trình AI như Antigravity và Claude Code. Tính năng này trang bị cho trợ lý AI của bạn các công cụ và rào chắn chuyên biệt. Các chức năng bao gồm:
- Tạo mã thành ngữ: Tạo mã tích hợp đã được kiểm thử và áp dụng các phương pháp hay nhất trên Python, Java, PHP, .NET và Ruby.
- Xác thực truy vấn GAQL: Tự động xác minh cú pháp, khả năng tương thích của trường, phân đoạn ngày và quy tắc không có lượt hiển thị trước khi chạy truy vấn.
- Kiểm tra giản đồ Protobuf: Khám phá theo yêu cầu các trường tài nguyên, kiểu dữ liệu và định nghĩa enum cho mọi phiên bản Google Ads API đang hoạt động để đảm bảo các trường truy vấn GAQL là hợp lệ.
- Khắc phục các vấn đề về API: Chẩn đoán lỗi khi tải lượt chuyển đổi ngoại tuyến lên, thao tác trong hệ phân cấp tài khoản người quản lý và tạo bộ lọc trang thông tin cho chiến dịch Tối đa hoá hiệu suất. Bạn có thể đặt câu hỏi bằng ngôn ngữ tự nhiên, chẳng hạn như "Cho tôi xem tất cả quảng cáo có vấn đề trong tài khoản của tôi và đề xuất cách khắc phục".
- Trả lời các câu hỏi về API: Trợ lý trả lời các câu hỏi bằng cách kết hợp các quy tắc kiến trúc được nhúng của API Google Ads với quy trình kiểm tra giản đồ Protobuf cục bộ, linh động để cung cấp hướng dẫn chính xác theo phiên bản và đoạn mã đã xác minh. Công cụ này đưa ra câu trả lời dựa trực tiếp vào các định nghĩa API chính thức và mã nguồn thư viện ứng dụng, thay vì chỉ dựa vào quá trình huấn luyện mô hình chung. Ví dụ: "Tập hợp dùng chung là gì và cách sử dụng như thế nào?"
- Báo cáo đặc biệt: Bạn có thể yêu cầu dữ liệu hiệu suất bằng tiếng Anh đơn giản và trợ lý sẽ ngay lập tức tạo, xác thực và chạy các truy vấn GAQL cần thiết ngay trong tài khoản Google Ads của bạn. Tính năng này truyền kết quả trực tiếp trở lại cuộc trò chuyện của bạn dưới dạng bảng rõ ràng, được định dạng, giúp bạn dễ dàng báo cáo đột xuất và điều tra chỉ số. Nếu bạn muốn lưu kết quả, hãy yêu cầu Gemini "Lưu kết quả dưới dạng tệp CSV trong <thư mục của bạn>" và bạn có thể tải tệp đó vào một bảng tính để phân tích.
Hỗ trợ Antigravity và Claude Code
Bản phát hành này hỗ trợ hai nền tảng:
- Antigravity: Hỗ trợ gốc cho môi trường phát triển Antigravity với tính năng đăng ký trình bổ trợ chung và trình bổ trợ không gian làm việc.
- Claude Code: Tích hợp đầy đủ với hệ thống trình bổ trợ CLI của Claude Code, bao gồm cả các lệnh dấu gạch chéo tuỳ chỉnh (chẳng hạn như
/validate-gaql,/inspect-object,/troubleshoot-conversionsvà/get-cids).
Tập lệnh cài đặt hợp nhất có sẵn cho Linux, macOS (bash) và Windows (PowerShell) để cung cấp khả năng quản lý vòng đời nhất quán trên cả ba nền tảng.
Cải tiến hiệu suất
- Giảm mức tiêu thụ mã thông báo: Việc tiết lộ dần các quy tắc và giản đồ chỉ tải bối cảnh cần thiết cho một nhiệm vụ nhất định, giúp giảm mức hao tổn mã thông báo câu lệnh.
- Thời gian phản hồi nhanh hơn: Việc thực thi kỹ năng theo yêu cầu và định tuyến lệnh theo mục tiêu giúp hoàn thành nhiệm vụ từ đầu đến cuối nhanh hơn.
- Mức sử dụng CPU thấp hơn: Quy trình thực thi được tinh giản giúp loại bỏ mức hao tổn của quy trình trong nền trong các phiên phát triển.
- Giảm số lượng thao tác I/O trên ổ đĩa: Việc giảm số lượng tệp không cần thiết trong cây trình bổ trợ sẽ giúp trình theo dõi tệp, trình tìm lỗi mã nguồn và trình lập chỉ mục IDE không phải quét hàng chục nghìn tệp protobuf/SDK không dùng đến.
- Giảm mức sử dụng bộ nhớ (RAM) và không tốn tài nguyên cho trình nền: Giờ đây, các kỹ năng và lệnh chỉ chạy tạm thời dưới dạng các tiến trình con nhanh khi được gọi, giúp giảm mức sử dụng tài nguyên hệ thống xuống bằng 0 khi không hoạt động.
- Phiên bản API được lưu vào bộ nhớ đệm và phân giải giản đồ Protobuf: Trợ lý tránh thực hiện các lệnh gọi API phản chiếu hoặc siêu dữ liệu từ xa lặp lại khi kiểm tra các trường, tài nguyên và enum chuẩn.
- Thực thi lệnh tất định so với suy luận LLM nhiều lượt: Thay vì LLM đoán hoặc gỡ lỗi cú pháp GAQL lặp đi lặp lại qua 3-4 lượt, trình xác thực cục bộ sẽ kiểm tra các trường, tài nguyên, chỉ số không có lượt hiển thị và mệnh đề ngày trong một bước duy nhất.
Bản phát hành chính được xây dựng trên cấu trúc trình bổ trợ hiện đại
Đây là một bản phát hành chính không tương thích với các bản phát hành trước. Các phiên bản trước đó dựa vào cấu trúc dự án không gian làm việc cục bộ. Phiên bản này được xây dựng trên kiến trúc trình bổ trợ chuẩn hoá, được cài đặt để có thể sử dụng trên toàn cầu.
Việc mô-đun hoá các quy tắc, kỹ năng và lệnh chẩn đoán thành một gói trình bổ trợ độc lập cho phép nhà phát triển cài đặt, cập nhật và quản lý trợ lý trên nhiều môi trường và dự án.
Hãy xem tệp README.md để biết thông tin kỹ thuật chi tiết về cấu trúc trình bổ trợ.
Bắt đầu
Do những thay đổi về cấu trúc trong bản phát hành này, hãy xem tài liệu trước khi cài đặt:
- Đọc README_BEFORE_INSTALLATION.md để biết các điều kiện tiên quyết và cách chuẩn bị môi trường.
- Làm theo hướng dẫn cài đặt trong README.md.
Chúng tôi rất mong bạn đóng góp ý kiến
Chia sẻ ý kiến phản hồi, báo cáo vấn đề và đề xuất tính năng bằng biểu mẫu khảo sát:
Nhãn: google-ads-api, release