Google Ads API Explorer

Eksplorator interfejsu Google Ads API to interaktywne środowisko wykonawcze, które umożliwia tworzenie i wysyłanie żądań do interfejsu API bezpośrednio z przeglądarki. Jest on osadzony w dokumentacji referencyjnej i obsługuje złożone procesy uwierzytelniania OAuth 2.0 oraz formatowania ładunku JSON, co pozwala 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 odczytu, jak i zapisu) bezpośrednio z dokumentacji bez konfigurowania lokalnego środowiska programistycznego.
  • Wykrywanie protokołu: możesz zobaczyć dokładną strukturę żądań i odpowiedzi HTTP, aby zrozumieć, jak działa interfejs API.
  • Prototypowanie bez zakłóceń: weryfikuj działanie punktów końcowych i sprawdzaj nieprzetworzone odpowiedzi interfejsu API bezpośrednio przed wdrożeniem 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. Przejdź do dokumentacji: otwórz dokumentację referencyjną i wybierz usługę oraz metodę, którą chcesz przetestować, np. GoogleAdsService/Search.
  2. Otwórz eksplorator: po prawej stronie ekranu znajdź panel Wypróbuj tę metodę.
  3. Skonfiguruj żądanie:
    • Wpisz wymagane parametry żądania, takie jak customerId, i rozwiń Nagłówki, aby podać opcjonalne nagłówki HTTP, takie jak login-customer-id (wymagane tylko wtedy, gdy uzyskujesz dostęp do konta przez konto 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 nadal możesz wpisać wartość, jeśli pojawi się prośba w formularzu.
    • Zdefiniuj treść żądania za pomocą interaktywnego edytora JSON, jeśli metoda wymaga ładunku, np. w przypadku operacji search lub mutate.
  4. Wykonaj: kliknij Wykonaj, aby wysłać żądanie. Narzędzie wyświetla pełne żądanie HTTP i odpowiedź JSON z interfejsu API na żywo.

Najważniejsze funkcje

  • Wykonywanie na żywo: przeprowadzaj 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ń, korzystając z narzędzia, które wyróżnia wymagane pola i prawidłowe struktury schematu.
  • Maski pól: przetestuj logikę update_mask, aby zobaczyć, jak w praktyce zachowują się częściowe aktualizacje zasobów.
  • Sprawdzanie błędów: wyświetlaj szczegółowe komunikaty o błędach i kody błędów (takie jak 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 APIs Explorer.

Przykłady użycia

  • Sprawdzanie ustawień konta: możesz szybko pobierać konfiguracje lub metadane na poziomie konta, wykonując żądanie GoogleAdsService/Search względem zasobu customer.
  • Testowanie mutacji: przed wdrożeniem kodu w środowisku produkcyjnym sprawdź, czy kampania została utworzona lub czy budżet został zaktualizowany.
  • Debugowanie GAQL: użyj Eksploratora, aby uruchomić ciąg znaków w języku zapytań Google Ads (GAQL) i sprawdzić, czy zwrócona struktura JSON jest zgodna z oczekiwaniami aplikacji.
  • Weryfikacja protokołu: sprawdź dokładne nagłówki HTTP i zagnieżdżenie JSON wymagane w przypadku konkretnej wersji interfejsu API.