Google Ads API Explorer

Trình khám phá API Google Ads là một môi trường thực thi tương tác cho phép bạn tạo và gửi yêu cầu API trực tiếp ngay từ trình duyệt. Được nhúng trong tài liệu tham khảo, công cụ này xử lý các vấn đề phức tạp của quy trình xác thực OAuth 2.0 và định dạng tải trọng JSON, cho phép bạn kiểm thử các dịch vụ và phương thức cụ thể mà không cần viết một dòng mã nào.

Lợi ích

  • Thử nghiệm không cần mã: Thực hiện các lệnh gọi API trực tiếp (cả đọc và ghi) ngay trong tài liệu mà không cần thiết lập môi trường phát triển cục bộ.
  • Khám phá giao thức: Xem cấu trúc chính xác của các yêu cầu HTTP và phản hồi để hiểu cách hoạt động của API.
  • Tạo nguyên mẫu dễ dàng: Xác minh hành vi của điểm cuối và kiểm tra phản hồi thô của API ngay trước khi triển khai logic trong ứng dụng.
  • Xác thực đơn giản: Công cụ này tự động quản lý các quy trình OAuth 2.0, giúp bạn tập trung vào yêu cầu API thay vì quản lý thông tin xác thực.

Bắt đầu

  1. Chuyển đến tài liệu: Chuyển đến Tài liệu tham khảo rồi chọn dịch vụ và phương thức bạn muốn kiểm thử, chẳng hạn như GoogleAdsService/Search.
  2. Mở Explorer: Tìm bảng điều khiển Thử phương thức này ở bên phải trang.
  3. Định cấu hình yêu cầu:
    • Nhập Tham số yêu cầu bắt buộc, chẳng hạn như customerId, rồi mở rộng Tiêu đề để cung cấp tiêu đề HTTP không bắt buộc, chẳng hạn như login-customer-id (chỉ bắt buộc khi truy cập vào một tài khoản thông qua tài khoản người quản lý). Xin lưu ý rằng mã của nhà phát triển (developer-token) đã ngừng hoạt động vào ngày 9 tháng 9 năm 2026 và bị máy chủ API bỏ qua, mặc dù bạn vẫn có thể nhập một giá trị nếu được biểu mẫu nhắc.
    • Xác định Nội dung yêu cầu bằng trình chỉnh sửa JSON tương tác nếu phương thức yêu cầu tải trọng, chẳng hạn như đối với các thao tác search hoặc mutate.
  4. Execute (Thực thi): Nhấp vào Execute (Thực thi) để gửi yêu cầu. Công cụ này hiển thị yêu cầu HTTP đầy đủ và phản hồi JSON trực tiếp từ API.

Các tính năng chính

  • Thực thi trực tiếp: Thực hiện các thao tác search và mutate theo thời gian thực đối với tài khoản thử nghiệm hoặc tài khoản chính thức của bạn.
  • Định dạng tải trọng JSON: Tạo các đối tượng JSON phức tạp cho yêu cầu một cách tương tác, trong đó công cụ sẽ làm nổi bật các trường bắt buộc và cấu trúc giản đồ hợp lệ.
  • Mặt nạ trường: Kiểm thử logic update_mask để xem cách các bản cập nhật tài nguyên một phần hoạt động trong thực tế.
  • Kiểm tra lỗi: Xem thông báo lỗi và mã lỗi chi tiết (chẳng hạn như QUERY_ERROR hoặc AUTHENTICATION_ERROR) trong phản hồi thô để gỡ lỗi nhanh hơn.
  • Xuất mã: Xuất các lệnh curl, yêu cầu HTTP thô hoặc mã JavaScript mẫu từ chế độ xem mở rộng của API Explorer.

Trường hợp sử dụng mẫu

  • Kiểm tra chế độ cài đặt tài khoản: Nhanh chóng truy xuất cấu hình hoặc siêu dữ liệu ở cấp tài khoản bằng cách thực thi yêu cầu GoogleAdsService/Search đối với tài nguyên customer.
  • Kiểm thử các thay đổi: Xác minh xem việc tạo chiến dịch hoặc cập nhật ngân sách có thành công hay không trước khi triển khai mã vào môi trường thực tế.
  • Gỡ lỗi GAQL: Sử dụng Trình khám phá để chạy một chuỗi Ngôn ngữ truy vấn Google Ads (GAQL) và xác minh rằng cấu trúc JSON được trả về khớp với kỳ vọng của ứng dụng.
  • Xác minh giao thức: Kiểm tra chính xác các tiêu đề HTTP và lồng ghép JSON cần thiết cho một phiên bản API cụ thể.