Google Ads API Explorer

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

Zalety

  • Testowanie bez kodu: wykonuj wywołania interfejsu API na żywo (zarówno odczytu, jak i zapisu) 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 bez komplikacji: sprawdź działanie punktu końcowego i przejrzyj nieprzetworzone odpowiedzi 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 API, a nie na zarządzaniu danymi logowania.

Rozpocznij

  1. Otwórz dokumentację: otwórz dokumentację i wybierz usługę oraz metodę, którą chcesz przetestować, np. GoogleAdsService/Search.
  2. Otwórz narzędzie Explorer: po prawej stronie strony znajdź panel Wypróbuj tę metodę.
  3. Skonfiguruj żądanie:
    • wpisz wymagane parametry żądania, np. customerId, i rozwiń sekcję Nagłówki, aby podać opcjonalne nagłówki HTTP, takie jak login-customer-id (wymagany tylko wtedy, gdy uzyskujesz dostęp 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 API, ale jeśli formularz o to poprosi, możesz nadal wpisać wartość.
    • Jeśli metoda wymaga ładunku, np. w przypadku operacji search lub mutate, zdefiniuj treść żądania za pomocą interaktywnego edytora JSON.
  4. Wykonaj: aby wysłać żądanie, kliknij Wykonaj. Narzędzie wyświetli pełne żądanie HTTP i odpowiedź JSON na żywo z interfejsu API.

Najważniejsze funkcje

  • Wykonanie na żywo: wykonuj operacje search i mutate w czasie rzeczywistym na kontach produkcyjnych lub testowych.
  • Formatowanie ładunku JSON: interaktywnie twórz złożone obiekty JSON na potrzeby żądań. Narzędzie będzie wyróżniać wymagane pola i prawidłowe struktury schematu.
  • Maski pól: testuj logikę update_mask, aby sprawdzić, jak w praktyce działają częściowe aktualizacje zasobów.
  • Sprawdzanie błędów: wyświetlaj szczegółowe komunikaty o błędach i kody (np. QUERY_ERROR lub AUTHENTICATION_ERROR) w nieprzetworzonej odpowiedzi, aby przyspieszyć debugowanie.
  • Eksportowanie kodu: eksportuj polecenia curl, nieprzetworzone żądania HTTP lub przykładowy kod JavaScript z rozwiniętego widoku narzędzia API Explorer.

Przykłady użycia