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 các yêu cầu API trực tiếp ngay trên trình duyệt. Được nhúng trong tài liệu tham khảo, trình khám phá 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

  • Kiểm thử không cần mã: Thực thi 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 API hoạt động.
  • Tạo mẫu nhanh chóng: Xác minh hành vi của điểm cuối và kiểm tra phản hồi API thô ngay trước khi triển khai logic trong ứng dụng.
  • Đơn giản hoá quy trình xác thực: Công cụ này tự động quản lý các luồng OAuth 2.0, cho phép bạn tập trung vào yêu cầu API thay vì quản lý thông tin đăng nhập.

Bắt đầu

  1. Chuyển đến tài liệu: Chuyển đến Tài liệu tham khảorồ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ở Trình khám phá: 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 các 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ã thông báo dành cho 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 biểu mẫu nhắc bạn.
    • 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. Thực thi: Nhấp vào Thực thi để gửi yêu cầu. Công cụ này sẽ hiển thị toàn bộ yêu cầu HTTP 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 sản xuất.
  • Định dạng tải trọng JSON: Xây dựng các đối tượng JSON phức tạp cho các yêu cầu một cách tương tác, trong đó công cụ này 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ác bản cập nhật tài nguyên một phần hoạt động như thế nào 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 APIs Explorer.

Trường hợp sử dụng minh hoạ

  • 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 việc tạo chiến dịch hoặc cập nhật ngân sách thành công trước khi triển khai mã vào môi trường sản xuất.
  • Gỡ lỗi GAQL: Sử dụng Trình khám phá để chạy 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 những gì ứng dụng của bạn mong đợi.
  • Xác minh giao thức: Kiểm tra chính xác các tiêu đề HTTP và cấu trúc lồng JSON cần thiết cho một phiên bản API cụ thể.