Weryfikator zapytań Google Ads

Walidator zapytań Google Ads to interaktywne narzędzie, które pomaga deweloperom tworzyć i weryfikować zapytania w języku Google Ads Query Language (GAQL) przed ich zintegrowaniem z aplikacjami. Umożliwia wpisanie ciągu zapytania GAQL i natychmiastowe otrzymanie informacji o jego poprawności, co pomaga wykrywać błędy składni, niezgodności pól i inne problemy na wczesnym etapie procesu programowania.

Korzyści

  • Zapobieganie błędom: wykrywa nieprawidłowe zapytania na wczesnym etapie, zanim zostaną zintegrowane z aplikacjami, co zmniejsza liczbę błędów środowiska wykonawczego i nieudanych wywołań interfejsu API.
  • Szybsze programowanie: umożliwia szybkie testowanie i debugowanie instrukcji GAQL bez narzutu pełnych cykli żądań do interfejsu API i odpowiedzi.
  • Zrozumienie ograniczeń GAQL: pomaga deweloperom poznać złożone reguły dotyczące tego, które pola są zgodne i jak zasoby są ze sobą powiązane.
  • Debugowanie zapytań: gdy zapytanie jest nieprawidłowe, wyświetla konkretne komunikaty o błędach, które często są bardziej szczegółowe niż ogólny błąd interfejsu API, a czasami sugeruje prawidłowe alternatywy.
  • Efektywność zasobów: unikanie niepotrzebnych wywołań interfejsu API z zapytaniami, które nie mogą się powieść.

Jak to działa

Walidator zapytań analizuje zapytanie GAQL pod kątem schematu interfejsu Google Ads API i reguł zdefiniowanych w języku zapytań Google Ads. Wykorzystuje metadane, z których wiele jest dostępnych w GoogleAdsFieldService, do przeprowadzania kontroli, takich jak:

  1. Składnia i struktura: sprawdza, czy zapytanie jest zgodne z prawidłową gramatyką GAQL, w tym czy klauzule takie jak SELECT, FROM, WHERE, ORDER BY, LIMIT i PARAMETERS są używane w odpowiedni sposób i we właściwej kolejności.
  2. Prawidłowość pól: sprawdza, czy wszystkie określone pola (zasoby, segmenty, dane) istnieją i czy są prawidłowo zapisane.
  3. Zgodność zasobów: sprawdza, czy pola wybrane w klauzuli SELECT są zgodne z zasobem podstawowym określonym w klauzuli FROM.
  4. Zgodność segmentów i danych: sprawdza, czy segmenty i dane używane razem w tym samym zapytaniu są zgodne ze sobą i z zasobem w klauzuli FROM.
  5. Wymagania dotyczące klauzul: sprawdza reguły, takie jak wymaganie, aby pola używane w klauzulach ORDER BY i niektóre pola używane w klauzulach WHERE (np. segmenty) były również obecne w klauzuli SELECT.
  6. Użycie operatorów: sprawdza, czy operatory są prawidłowo używane w warunkach klauzuli WHERE.

Jeśli zapytanie jest prawidłowe, narzędzie to potwierdzi. Jeśli zostaną wykryte problemy, wyświetla komunikaty o błędach, które pomagają je zidentyfikować, a czasem oferuje sugestie dotyczące poprawek, np. zasoby zgodne z danym wskaźnikiem.

Rozpocznij

Aby użyć walidatora zapytań Google Ads:

  1. Otwórz walidator zapytań.
  2. Wpisz zapytanie GAQL.
  3. Kliknij przycisk Sprawdź poprawność zapytania.
  4. Sprawdź komunikat walidacji, który pojawi się pod widżetem walidatora zapytań. Pojawi się komunikat z informacją, że zapytanie jest prawidłowe. W przeciwnym razie wyświetli się komunikat o błędzie z opisem problemu. Komunikaty o błędach pomogą Ci poprawić zapytanie. Na przykład błąd niezgodności pola może zawierać listę zasobów alternatywnych, które są zgodne z danymi lub segmentem, o które próbujesz przesłać zapytanie.

Więcej szczegółowych informacji o pojęciach i składni GAQL znajdziesz w przewodniku po języku Google Ads Query Language. Aby interaktywnie tworzyć i testować zapytania GAQL, możesz też używać Kreatora zapytań i narzędzia APIs Explorer.