Google Ads API Explorer

Narzędzie Google Ads API Explorer to interaktywne środowisko wykonawcze, które umożliwia tworzenie i wysyłanie żądań do interfejsu Google Ads API 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.

Korzyści

  • Testowanie bez kodu: Wykonuj wywołania interfejsu API w czasie rzeczywistym (zarówno odczytu, jak i zapisu) bezpośrednio z dokumentacji bez konfigurowania lokalnego środowiska programistycznego.
  • Odkrywanie protokołu: możesz zobaczyć dokładną strukturę żądań i odpowiedzi HTTP, aby zrozumieć, jak działa interfejs API.
  • Prototypowanie bez komplikacji: możesz sprawdzić działanie punktu końcowego i natychmiast zbadać surowe odpowiedzi interfejsu API, zanim zaimplementujesz logikę 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.

Pierwsze kroki

  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”.
  3. Skonfiguruj żądanie:
    • wpisz wymagane parametry żądania, takie jak developer-token i login-customer-id.
    • Jeśli metoda wymaga ładunku, np. w przypadku operacji 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 z interfejsu API w czasie rzeczywistym.

Najważniejsze funkcje

  • Wykonanie na żywo: możesz wykonywać operacje search i mutate w czasie rzeczywistym na kontach produkcyjnych lub testowych.
  • Formatowanie ładunku JSON: możesz interaktywnie tworzyć złożone obiekty JSON na potrzeby żądań, a narzędzie będzie wyróżniać wymagane pola i prawidłowe struktury schematu.
  • Maski pól: możesz przetestować logikę update_mask, aby zobaczyć, jak w praktyce działają częściowe aktualizacje zasobów.
  • Sprawdzanie błędów: możesz wyświetlać szczegółowe komunikaty i kody błędów (np. QUERY_ERROR lub AUTHENTICATION_ERROR) w surowej odpowiedzi, aby szybciej debugować.
  • Eksportowanie kodu: możesz eksportować polecenia curl, surowe żądania HTTP lub przykładowy kod JavaScript z rozwiniętego widoku narzędzia API Explorer.

Przykłady użycia

  • Audyt ustawień konta: możesz szybko pobrać konfiguracje lub metadane na poziomie konta, wykonując żądanie get lub search.
  • Testowanie mutacji: możesz sprawdzić, czy utworzenie kampanii lub aktualizacja budżetu się powiodły, zanim wdrożysz kod w środowisku produkcyjnym.
  • Debugowanie GAQL: możesz użyć narzędzia Explorer, aby uruchomić ciąg znaków w języku Google Ads Query Language (GAQL) i sprawdzić, czy zwrócona struktura JSON jest zgodna z oczekiwaniami aplikacji.
  • Weryfikacja protokołu: możesz sprawdzić dokładne nagłówki HTTP i zagnieżdżenie JSON wymagane w przypadku konkretnej wersji interfejsu API.