Kreator zapytań Google Ads to interaktywne narzędzie, które pomaga tworzyć i weryfikować zapytania za pomocą języka Google Ads Query Language (GAQL). Niezależnie od tego, czy dopiero zaczynasz korzystać z GAQL, czy masz już doświadczenie, Kreator zapytań może uprościć proces pobierania z interfejsu Google Ads API dokładnie tych danych, których potrzebujesz.
Korzyści
- Łatwość użycia: upraszcza proces pisania zapytań GAQL, nie wymagając znajomości konkretnej składni i dostępnych pól.
- Wykrywalność: pomaga odkrywać i znajdować dostępne zasoby, pola, segmenty i dane w modelu danych interfejsu Google Ads API.
- Mniej błędów: dzięki uporządkowanemu interfejsowi i menu z prawidłowymi opcjami pomaga zapobiegać błędom składni i literówkom, co zapewnia prawidłowość wygenerowanego zapytania.
- Szybsze tworzenie zapytań: przyspiesza proces programowania dzięki automatycznemu generowaniu ciągów zapytań.
- Weryfikacja: narzędzie jest połączone z APIs Explorer i walidatorem zapytań, co umożliwia sprawdzanie zapytań pod kątem reguł interfejsu API przed ich wykonaniem.
Jak to działa
Kreator zapytań Google Ads udostępnia przyjazny dla użytkownika interfejs do wizualnego tworzenia zapytań GAQL. Tak wygląda podstawowa procedura:
- Wybierz zasób: zacznij od wybrania zasobu podstawowego na karcie Dokumentacja dla wersji, którą chcesz sprawdzić. Ten zasób jest umieszczony w klauzuli
FROM. Zasoby reprezentują elementy w Google Ads, takie jakcampaign,ad_grouplubkeyword_view. Kreator wyświetla listę wszystkich dostępnych zasobów. - Wybierz pola: po wybraniu zasobu narzędzie wyświetla wszystkie pola, które można wybrać, w tym atrybuty, segmenty i dane powiązane z tym zasobem i zasobami, które są mu przypisane (które można z nim połączyć). Możesz zaznaczyć pola wyboru, aby uwzględnić pola w klauzuli
SELECT. Gdy dokonujesz wyborów, narzędzie dynamicznie generuje odpowiedni ciąg zapytania GAQL, wyświetla błędy i odfiltrowuje niezgodne kombinacje pól. - Zastosuj filtry: dodaj warunki klauzuli
WHERE, aby filtrować wyniki. Kreator pomaga wybrać pola, operatory i wartości, zapewniając poprawną składnię. - Porządkowanie wyników: określ kolejność sortowania za pomocą klauzuli
ORDER BY. - Ustawianie limitów: dodaj klauzulę
LIMIT, aby kontrolować liczbę zwracanych wyników. - Weryfikacja: narzędzie w naturalny sposób prowadzi Cię do prawidłowych kombinacji pól, a także zawiera link do APIs Explorer, dzięki czemu możesz przetestować zapytanie na danych na koncie. Dostępny jest też osobny walidator zapytań, w którym możesz wklejać i sprawdzać ręcznie napisane zapytania GAQL.
- Eksportowanie: gdy zapytanie będzie gotowe, skopiuj i wklej przetestowany, poprawny składniowo ciąg GAQL do żądań klienta
GoogleAdsService.SearchlubSearchStream.
Kreator sprawdza, czy wybrane pola, segmenty i dane są zgodne i czy można ich używać razem w jednym zapytaniu, odwołując się do metadanych interfejsu Google Ads API.
Rozpocznij
Kreator zapytań możesz otworzyć na 2 sposoby: na konkretnej stronie w dokumentacji raportowania lub na stronie przeglądu kreatora zapytań.
Z dokumentacji dotyczącej raportowania
- Zacznij od dokumentacji raportowania i wybierz konkretny zasób na liście wszystkich zasobów. Możesz też przejść bezpośrednio do zasobu z panelu nawigacji po lewej stronie.
- Kliknij Pomóż mi utworzyć zapytanie, aby otworzyć kreator zapytań dla tego konkretnego zasobu.
Na stronie Przegląd kreatora zapytań
Przejdź do sekcji Kreator zapytań w dokumentacji referencyjnej dotyczącej raportowania i wybierz zasób, który chcesz sprawdzić.
Integracja z innymi narzędziami
Kreator zapytań jest zintegrowany z innymi narzędziami w pakiecie narzędzi dla programistów interfejsu Google Ads API. Możesz utworzyć zapytanie w kreatorze zapytań i przetestować je w narzędziu APIs Explorer lub sprawdzić za pomocą walidatora zapytań.
API Explorer
Po utworzeniu zapytania kliknij Wypróbuj w narzędziu APIs Explorer, aby otworzyć zapytanie w tym narzędziu. Zapytanie zostanie automatycznie wypełnione w treści żądania, a następnie możesz je przetestować, uruchamiając je na danych na koncie. Więcej informacji o tym narzędziu znajdziesz w artykule API Explorer.
walidator zapytań
Gdy klikniesz Wpisz lub edytuj zapytanie, otworzy się walidator zapytań. Użyj walidatora zapytań, aby sprawdzić składnię zapytania. Każde zapytanie utworzone w całości za pomocą kreatora zapytań ma już prawidłową składnię, ale jeśli znasz zasób, którego dotyczy zapytanie, walidator zapytań umożliwia szybkie wpisanie zapytania i sprawdzenie jego poprawności. Więcej informacji o tym narzędziu znajdziesz w artykule Walidator zapytań.