Trình tạo truy vấn của Google Ads là một công cụ tương tác được thiết kế để giúp bạn tạo và xác thực các truy vấn một cách tương tác bằng cách sử dụng Ngôn ngữ truy vấn của Google Ads (GAQL). Cho dù bạn là người mới sử dụng GAQL hay là người dùng có kinh nghiệm, Trình tạo truy vấn đều có thể đơn giản hoá quy trình tìm nạp dữ liệu chính xác mà bạn cần từ API Google Ads.
Lợi ích
- Dễ sử dụng: Đơn giản hoá quy trình viết truy vấn GAQL mà không yêu cầu bạn phải nắm rõ cú pháp cụ thể và các trường có sẵn.
- Khả năng khám phá: Giúp khám phá và tìm các tài nguyên, trường, phân đoạn và chỉ số có sẵn trong mô hình dữ liệu Google Ads API.
- Giảm lỗi: Bằng cách cung cấp một giao diện có cấu trúc và trình đơn thả xuống gồm các lựa chọn hợp lệ, công cụ này giúp ngăn chặn lỗi cú pháp và lỗi chính tả, đảm bảo truy vấn được tạo là hợp lệ.
- Tạo truy vấn nhanh hơn: Đẩy nhanh quy trình phát triển bằng cách tự động hoá quá trình tạo chuỗi truy vấn.
- Xác thực: Công cụ này được liên kết với API Explorer và Query Validator để kiểm tra các truy vấn theo quy tắc API trước khi thực thi.
Cách hoạt động
Trình tạo truy vấn của Google Ads cung cấp một giao diện thân thiện với người dùng để tạo truy vấn GAQL một cách trực quan. Sau đây là quy trình làm việc cơ bản:
- Chọn một tài nguyên: Bạn bắt đầu bằng cách chọn tài nguyên chính trong thẻ Tài liệu tham khảo cho phiên bản mà bạn muốn truy vấn. Tài nguyên này sẽ nằm trong điều khoản
FROM. Tài nguyên đại diện cho các thực thể trong Google Ads, chẳng hạn nhưcampaign,ad_grouphoặckeyword_view. Trình tạo liệt kê tất cả các tài nguyên có sẵn. - Chọn trường: Sau khi bạn chọn một tài nguyên, công cụ sẽ hiển thị tất cả các trường có thể chọn, bao gồm cả thuộc tính, phân đoạn và chỉ số liên quan đến tài nguyên đó và các tài nguyên được phân bổ (có thể kết hợp ngầm). Bạn có thể đánh dấu vào các hộp để thêm trường vào mệnh đề
SELECT. Khi bạn chọn, công cụ này sẽ tự động tạo chuỗi truy vấn GAQL tương ứng, hiển thị mọi lỗi và lọc ra các tổ hợp trường không tương thích. - Áp dụng bộ lọc: Bạn có thể thêm các điều kiện của mệnh đề
WHEREđể lọc kết quả. Trình tạo này giúp bạn chọn các trường, toán tử và giá trị, đảm bảo cú pháp chính xác. - Sắp xếp kết quả: Chỉ định thứ tự sắp xếp bằng cách sử dụng mệnh đề
ORDER BY. - Đặt giới hạn: Thêm mệnh đề
LIMITđể kiểm soát số lượng kết quả được trả về. - Xác thực: Công cụ này vốn dĩ sẽ hướng dẫn bạn kết hợp các trường hợp lệ, nhưng cũng liên kết đến API Explorer để bạn có thể kiểm thử truy vấn dựa trên dữ liệu tài khoản của mình. Ngoài ra, còn có một [Trình xác thực truy vấn](link to page) riêng biệt, nơi bạn có thể dán và kiểm tra các truy vấn GAQL được viết theo cách thủ công.
- Xuất: Sau khi hài lòng với truy vấn, hãy sao chép và dán chuỗi GAQL đã kiểm thử, đúng cú pháp vào các yêu cầu của ứng dụng
GoogleAdsService.SearchhoặcSearchStream.
Trình tạo đảm bảo rằng các trường, phân đoạn và chỉ số đã chọn tương thích và có thể được dùng cùng nhau trong một truy vấn duy nhất, tham chiếu đến siêu dữ liệu cơ bản của API Google Ads.
Bắt đầu
Có hai cách để truy cập vào Trình tạo truy vấn. Một lựa chọn là xem một trang cụ thể trong tài liệu tham khảo về báo cáo và lựa chọn còn lại là khám phá từ trang tổng quan về Trình tạo truy vấn.
Từ tài liệu tham khảo về báo cáo
- Bắt đầu bằng tài liệu tham khảo về báo cáo và chọn một tài nguyên cụ thể để bắt đầu trong danh sách tất cả các tài nguyên. Hoặc bạn có thể chuyển trực tiếp đến tài nguyên đó từ ngăn điều hướng bên trái.
- Nhấp vào Giúp tôi tạo một truy vấn. Thao tác này sẽ đưa bạn đến Trình tạo truy vấn cho tài nguyên cụ thể đó.
Trên trang tổng quan của Trình tạo truy vấn
Chuyển đến phần Trình tạo truy vấn trong tài liệu tham khảo về báo cáo rồi chọn tài nguyên bạn muốn khám phá.
Tích hợp với các công cụ khác
Trình tạo truy vấn được tích hợp với các công cụ khác trong Bộ công cụ dành cho nhà phát triển API Google Ads. Bạn có thể lấy một truy vấn được tạo trong Trình tạo truy vấn và kiểm thử truy vấn đó trong API Explorer hoặc xác thực truy vấn đó bằng Trình xác thực truy vấn.
API Explorer
Sau khi bạn tạo xong truy vấn, hãy nhấp vào Thử trong API Explorer để mở truy vấn trong API Explorer. Truy vấn của bạn sẽ tự động được điền sẵn vào nội dung yêu cầu, sau đó bạn có thể kiểm thử truy vấn bằng cách chạy truy vấn đó dựa trên dữ liệu tài khoản của bạn. Hãy xem API Explorer để biết thêm thông tin về công cụ đó.
Trình xác thực truy vấn
Khi bạn nhấp vào Nhập hoặc chỉnh sửa truy vấn, Trình xác thực truy vấn sẽ mở ra. Sử dụng Trình xác thực truy vấn để xác thực cú pháp của truy vấn. Mọi truy vấn được tạo hoàn toàn thông qua Trình tạo truy vấn đều đã có cú pháp chính xác, nhưng nếu bạn quen thuộc với tài nguyên mà bạn đang truy vấn, thì Trình xác thực truy vấn sẽ cung cấp một cách nhanh chóng để nhập truy vấn và kiểm tra tính hợp lệ của truy vấn đó. Hãy xem phần Trình xác thực truy vấn để biết thêm thông tin về công cụ đó.