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 zintegrowaniem ich z aplikacjami. Umożliwia wpisanie ciągu zapytania GAQL i natychmiastowe otrzymanie informacji o jego prawidłowości, co pomaga wykryć błędy składniowe, niezgodności pól i inne problemy na wczesnym etapie procesu tworzenia.

Korzyści

  • Zapobieganie błędom: narzędzie wykrywa nieprawidłowe zapytania na wczesnym etapie, zanim zostaną one zintegrowane z aplikacjami, co zmniejsza liczbę błędów w czasie działania i nieudanych wywołań interfejsu API.
  • Szybsze tworzenie: 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ń: w przypadku nieprawidłowego zapytania wyświetla konkretne komunikaty o błędach, często bardziej szczegółowe niż ogólny błąd interfejsu API, a czasami sugeruje prawidłowe alternatywy.
  • Efektywne wykorzystanie zasobów: pozwala uniknąć niepotrzebnych wywołań interfejsu API w przypadku zapytań, które nie mogą się powieść.

Jak to działa

Walidator zapytań analizuje zapytanie GAQL na podstawie schematu interfejsu Google Ads API i reguł zdefiniowanych w języku Google Ads Query Language. Do przeprowadzania kontroli używa metadanych, z których większość jest dostępna w usłudze GoogleAdsFieldService. Sprawdza m.in.:

  1. Składnia i struktura: sprawdza, czy zapytanie jest zgodne z prawidłową gramatyką GAQL, w tym czy prawidłowo użyto i uporządkowano klauzule takie jak SELECT, FROM, WHERE, ORDER BY i LIMIT.
  2. Prawidłowość pól: sprawdza, czy wszystkie określone pola (zasoby, segmenty, dane) istnieją i są poprawnie 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ą ze sobą zgodne oraz czy są zgodne z zasobem w klauzuli FROM.
  5. Wymagania dotyczące klauzul: sprawdza reguły, takie jak wymaganie, aby niektóre pola używane w klauzulach WHERE lub ORDER BY były też 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świetli komunikaty o błędach, które pomogą je zidentyfikować. Czasami może też zaproponować rozwiązania, np. zgodne zasoby dla danego wskaźnika.

Rozpocznij

Aby użyć walidatora zapytań Google Ads:

  1. Otwórz walidator zapytań.
  2. Wpisz zapytanie GAQL.
  3. Kliknij przycisk Sprawdź zapytanie.
  4. Sprawdź komunikat o weryfikacji, który pojawi się pod widżetem walidatora zapytań. Komunikat o powodzeniu oznacza, że zapytanie jest prawidłowe. W przeciwnym razie wyświetli się komunikat o błędzie opisujący problem. Komunikaty o błędach pomogą Ci poprawić zapytanie. Na przykład komunikat o błędzie niezgodności pól może zawierać listę alternatywnych zasobów, które *są* zgodne z wskaźnikiem lub segmentem, o który chcesz zapytać.

Więcej informacji o koncepcjach i weryfikacji GAQL znajdziesz też w przewodnikach wideo dotyczących GAQL.