Trình xác thực truy vấn của Google Ads

Trình xác thực truy vấn Google Ads là một công cụ tương tác được thiết kế để giúp nhà phát triển xây dựng và xác minh các truy vấn Ngôn ngữ truy vấn Google Ads (GAQL) trước khi tích hợp các truy vấn đó vào ứng dụng. Công cụ này cho phép bạn nhập một chuỗi truy vấn GAQL và nhận ý kiến phản hồi ngay lập tức về tính hợp lệ của chuỗi đó, giúp phát hiện lỗi cú pháp, trường không tương thích và các vấn đề khác ngay từ đầu trong quá trình phát triển.

Lợi ích

  • Ngăn chặn lỗi: Phát hiện sớm các truy vấn không hợp lệ trước khi chúng được tích hợp vào ứng dụng, giúp giảm lỗi thời gian chạy và lỗi lệnh gọi API.
  • Phát triển nhanh hơn: Cho phép kiểm thử và gỡ lỗi nhanh các câu lệnh GAQL mà không cần phải thực hiện toàn bộ chu kỳ yêu cầu API và phản hồi.
  • Tìm hiểu các quy tắc ràng buộc của GAQL: Giúp nhà phát triển tìm hiểu các quy tắc phức tạp về những trường tương thích và mối quan hệ giữa các tài nguyên.
  • Truy vấn gỡ lỗi: Cung cấp thông báo lỗi cụ thể khi một truy vấn không hợp lệ, thường chi tiết hơn lỗi API chung và đôi khi đề xuất các phương án thay thế hợp lệ.
  • Hiệu quả sử dụng tài nguyên: Tránh các lệnh gọi API không cần thiết bằng các truy vấn chắc chắn sẽ không thành công.

Cách hoạt động

Trình xác thực truy vấn phân tích cú pháp truy vấn GAQL của bạn theo giản đồ của Google Ads API và các quy tắc được xác định trong Ngôn ngữ truy vấn của Google Ads. Công cụ này sử dụng siêu dữ liệu (phần lớn có thể truy cập được từ GoogleAdsFieldService) để thực hiện các bước kiểm tra, bao gồm:

  1. Cú pháp và cấu trúc: Đảm bảo truy vấn tuân theo ngữ pháp GAQL chính xác, bao gồm cả việc sử dụng và thứ tự thích hợp của các mệnh đề như SELECT, FROM, WHERE, ORDER BY, LIMIT và PARAMETERS.
  2. Tính hợp lệ của trường: Kiểm tra xem tất cả các trường được chỉ định (tài nguyên, phân đoạn, chỉ số) có tồn tại và được viết đúng chính tả hay không.
  3. Khả năng tương thích của tài nguyên: Xác minh rằng các trường được chọn trong mệnh đề SELECT tương thích với tài nguyên chính được chỉ định trong mệnh đề FROM.
  4. Khả năng tương thích của phân khúc và chỉ số: Đảm bảo rằng các phân khúc và chỉ số được dùng cùng nhau trong cùng một truy vấn tương thích với nhau và với tài nguyên trong mệnh đề FROM.
  5. Yêu cầu về mệnh đề: Xác thực các quy tắc như yêu cầu đối với các trường được dùng trong mệnh đề ORDER BY và một số trường được dùng trong mệnh đề WHERE (chẳng hạn như phân khúc) cũng phải có trong mệnh đề SELECT.
  6. Cách sử dụng toán tử: Kiểm tra xem toán tử có được sử dụng đúng cách trong các điều kiện của mệnh đề WHERE hay không.

Nếu truy vấn hợp lệ, công cụ sẽ xác nhận truy vấn đó. Nếu phát hiện thấy vấn đề, công cụ này sẽ cung cấp thông báo lỗi được thiết kế để giúp xác định vấn đề, đôi khi đưa ra đề xuất khắc phục, chẳng hạn như các tài nguyên tương thích cho một chỉ số nhất định.

Bắt đầu

Cách sử dụng Trình xác thực truy vấn Google Ads:

  1. Chuyển đến Trình xác thực truy vấn.
  2. Nhập truy vấn GAQL của bạn.
  3. Nhấp vào nút Xác thực truy vấn.
  4. Xem thông báo xác thực xuất hiện bên dưới tiện ích Trình xác thực truy vấn. Thông báo thành công cho biết truy vấn là hợp lệ. Nếu không, một thông báo lỗi mô tả vấn đề sẽ xuất hiện. Thông báo lỗi sẽ hướng dẫn bạn cách sửa truy vấn. Ví dụ: lỗi không tương thích trường có thể liệt kê các tài nguyên thay thế tương thích với chỉ số hoặc phân đoạn mà bạn đang cố gắng truy vấn.

Để biết thêm nội dung giải thích chuyên sâu về các khái niệm và cú pháp GAQL, hãy xem Hướng dẫn về Ngôn ngữ truy vấn Google Ads. Để tạo và kiểm thử các truy vấn GAQL một cách tương tác, bạn cũng có thể sử dụng Trình tạo truy vấn và API Explorer.