Google Ads API Explorer

Google Ads API Explorer 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, công cụ này xử lý các điểm 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 từ 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 và phản hồi HTTP để hiểu cách API hoạt động.
  • Nguyên mẫu có độ ma sát thấp: Xác minh ngay hành vi của điểm cuối và kiểm tra các phản hồi thô của API trước khi triển khai logic trong ứng dụng của bạn.
  • Quy trình 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, 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ả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ở Trình khám phá: Tìm bảng điều khiển "Dùng thử!" ở bên phải trang.
  3. Định cấu hình yêu cầu:
    • Nhập các tham số Yêu cầu bắt buộc, chẳng hạn như developer-token và login-customer-id.
    • 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 `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 sản xuất hoặc tài khoản thử nghiệm của bạn.
  • Định dạng tải trọng JSON: Tương tác để tạo các đối tượng JSON phức tạp cho các yêu cầu, trong đó công cụ này 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 hoạt động của các bản cập nhật tài nguyên một phần trong thực tế.
  • Kiểm tra lỗi: Xem thông báo 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 Trình khám phá API.

Ví dụ về các trường hợp sử dụng

  • 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 get hoặc search.
  • Thử nghiệm các hoạt động sửa đổi: Xác minh mức độ thành công của việc tạo chiến dịch hoặc cập nhật ngân sách trước khi triển khai mã cho hoạt động sản xuấ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 những gì bạn mong đợi ở ứng dụng.
  • 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ể.