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 on wpisanie ciągu zapytania GAQL i natychmiastowe uzyskanie informacji o jego prawidłowości. Pomaga to wykrywać błędy składni, niezgodności pól i inne problemy na wczesnym etapie procesu tworzenia.

Korzyści

  • Zapobieganie błędom: wczesne wykrywanie nieprawidłowych zapytań, 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 związanego z pełnymi cyklami żądań do interfejsu API i odpowiedzi.
  • Poznawanie ograniczeń GAQL: pomaga programistom poznać złożone reguły dotyczące tego, które pola są ze sobą zgodne i jak zasoby są ze sobą powiązane.
  • Zapytania debugowania: wyświetla konkretne komunikaty o błędach, gdy zapytanie jest nieprawidłowe. Są one często bardziej szczegółowe niż ogólny błąd interfejsu API i czasami sugerują prawidłowe alternatywy.
  • Efektywność wykorzystania zasobów: zapobiega niepotrzebnym wywołaniom interfejsu API za pomocą zapytań, które z góry są skazane na niepowodzenie.

Jak to działa

Weryfikator zapytań analizuje zapytanie GAQL pod kątem schematu interfejsu Google Ads API i reguł zdefiniowanych w języku zapytań Google Ads. Korzysta z metadanych, z których większość jest dostępna na stronie GoogleAdsFieldService, aby przeprowadzać kontrole, w tym:

  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 i ułożone we właściwy sposób.
  2. Prawidłowość pól: sprawdza, czy wszystkie określone pola (zasoby, segmenty, dane) istnieją i czy są poprawnie napisane.
  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żyte razem w tym samym zapytaniu są ze sobą zgodne oraz czy są zgodne z zasobem w klauzuli FROM.
  5. Wymagania dotyczące klauzuli: weryfikuje 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 też obecne w klauzuli SELECT.
  6. Użycie operatorów: sprawdza prawidłowe użycie operatorów 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ą Ci je zidentyfikować. Czasami zaproponuje też rozwiązania, np. kompatybilne zasoby dla danego rodzaju danych.

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 weryfikacyjny, który pojawi się pod widżetem Weryfikator zapytań. Pojawi się komunikat informujący o tym, że zapytanie jest prawidłowe. W przeciwnym razie pojawi się komunikat o błędzie opisujący problem. Komunikaty o błędach pomogą Ci poprawić zapytanie. Na przykład błąd niezgodności pola może zawierać listę alternatywnych zasobów, które są zgodne z danymi lub segmentem, o które chcesz wysłać zapytanie.

Bardziej szczegółowe wyjaśnienia dotyczące koncepcji i weryfikacji GAQL znajdziesz w filmach z przewodnikami po GAQL. Możesz też skorzystać z Kreatora zapytań i API Explorer.