Google Ads API Explorer

Google Ads API Explorer to interaktywne środowisko wykonawcze, które umożliwia tworzenie i wysyłanie żądań interfejsu Google Ads API w czasie rzeczywistym bezpośrednio z przeglądarki. Jest on zintegrowany z dokumentacją i obsługuje złożone procesy uwierzytelniania OAuth 2.0 oraz formatowania ładunków JSON, dzięki czemu możesz testować konkretne usługi i metody bez pisania ani jednej linii kodu.

Korzyści

  • Testowanie bez kodu: wykonuj wywołania interfejsu API na żywo (zarówno odczyt, jak i zapis) bezpośrednio z dokumentacji bez konfigurowania lokalnego środowiska programistycznego.
  • Odkrywanie protokołu: zobacz dokładną strukturę żądań i odpowiedzi HTTP, aby zrozumieć, jak działa interfejs API.
  • Prototypowanie o niskim poziomie trudności: sprawdzaj zachowanie punktu końcowego i kontroluj surowe odpowiedzi interfejsu API bezpośrednio przed zaimplementowaniem logiki w aplikacji.
  • Uproszczone uwierzytelnianie: narzędzie automatycznie zarządza przepływami OAuth 2.0, dzięki czemu możesz skupić się na żądaniu do interfejsu API, a nie na zarządzaniu danymi logowania.

Rozpocznij

  1. Otwórz dokumentację: otwórz dokumentację referencyjną i wybierz usługę oraz metodę, które chcesz przetestować, np. GoogleAdsService/Search.
  2. Otwórz Eksploratora: po prawej stronie ekranu znajdź panel Wypróbuj tę metodę.
  3. Skonfiguruj żądanie:
    • Wpisz wymagane parametry żądania, np. customerId, i rozwiń nagłówki, aby podać opcjonalne nagłówki HTTP, np. login-customer-id (wymagane tylko w przypadku uzyskiwania dostępu do konta za pomocą konta menedżera). Pamiętaj, że tokeny dewelopera (developer-token) zostały wycofane 9 września 2026 r. i są ignorowane przez serwery interfejsu API, ale w razie potrzeby możesz nadal wpisywać wartość w formularzu.
    • Zdefiniuj treść żądania za pomocą interaktywnego edytora JSON, jeśli metoda wymaga ładunku, np. w przypadku operacji search lub mutate.
  4. Wykonaj: aby wysłać prośbę, kliknij Wykonaj. Narzędzie wyświetla pełne żądanie HTTP i odpowiedź JSON z interfejsu API.

Najważniejsze funkcje

  • Wykonanie na żywo: wykonuj w czasie rzeczywistym operacje search i mutate na kontach produkcyjnych lub testowych.
  • Formatowanie ładunku JSON: interaktywne tworzenie złożonych obiektów JSON na potrzeby żądań z narzędziem, które wyróżnia wymagane pola i prawidłowe struktury schematu.
  • Maski pól: przetestuj logikę update_mask, aby sprawdzić, jak w praktyce działają częściowe aktualizacje zasobów.
  • Sprawdzanie błędów: w surowej odpowiedzi możesz wyświetlać szczegółowe komunikaty i kody błędów (np. QUERY_ERROR lub AUTHENTICATION_ERROR), co ułatwia szybsze debugowanie.
  • Eksportowanie kodu: eksportuj polecenia curl, surowe żądania HTTP lub przykładowy kod JavaScript z widoku rozwiniętego Eksploratora interfejsu API.

Przykłady użycia

  • Sprawdzanie ustawień konta: szybkie pobieranie konfiguracji lub metadanych na poziomie konta przez wykonanie żądania GoogleAdsService/Search w odniesieniu do zasobu customer.
  • Testowanie mutacji: przed wdrożeniem kodu w środowisku produkcyjnym sprawdź, czy utworzenie kampanii lub aktualizacja budżetu zakończyły się powodzeniem.
  • Debugowanie GAQL: użyj Eksploratora, aby uruchomić ciąg języka zapytań Google Ads (GAQL) i sprawdzić, czy zwrócona struktura JSON odpowiada oczekiwaniom aplikacji.
  • Weryfikacja protokołu: sprawdź dokładne nagłówki HTTP i zagnieżdżenie JSON wymagane w przypadku konkretnej wersji interfejsu API.