Google Ads API Explorer

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 on osadzony w dokumentacji referencyjnej 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 linii 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 o niskim poziomie skomplikowania: możesz od razu sprawdzić działanie punktu końcowego i przeanalizować nieprzetworzone 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ę referencyjną i wybierz usługę oraz metodę, które chcesz przetestować, np. GoogleAdsService/Search.
  2. Otwórz Eksploratora: poszukaj panelu „Wypróbuj” po prawej stronie ekranu.
  3. Skonfiguruj żądanie:
    • Wpisz wymagane parametry żądania, np. developer-token i login-customer-id.
    • Zdefiniuj treść żądania za pomocą interaktywnego edytora JSON, jeśli metoda wymaga ładunku, np. w przypadku operacji `mutate`.
  4. Wykonaj: kliknij Wykonaj, aby wysłać żądanie. Narzędzie wyświetli pełne żądanie HTTP i odpowiedź JSON z interfejsu API.

Najważniejsze funkcje

  • Wykonanie na żywo: przeprowadzaj 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ń. Narzędzie 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: wyświetlaj szczegółowe komunikaty i kody błędów (np. QUERY_ERROR lub AUTHENTICATION_ERROR) w surowej odpowiedzi, aby przyspieszyć debugowanie.
  • Eksportowanie kodu: eksportuj polecenia curl, surowe żądania HTTP lub przykładowy kod JavaScript z widoku rozwiniętego Eksploratora interfejsów API.

Przykłady użycia

  • Sprawdzanie ustawień konta: szybkie pobieranie konfiguracji lub metadanych na poziomie konta przez wykonanie żądania get lub search.
  • 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.