Testowanie to ważny krok w tworzeniu udanej integracji z interfejsem Google Ads API, niezależnie od tego, czy dopiero zaczynasz, utrzymujesz aplikację, czy dodajesz nowe funkcje do istniejącej integracji. W tym przewodniku znajdziesz sprawdzone metody testowania integracji z interfejsem Google Ads API.
Konta testowe i konta produkcyjne
Do celów programistycznych dostępne są konta testowe. Dzięki kontom testowym możesz sprawdzić, czy kod aplikacji i konfiguracja działają zgodnie z oczekiwaniami.
Pamiętaj jednak, że na koncie testowym nie można przetestować wszystkich funkcji.
Jeśli ograniczenia konta testowego uniemożliwiają przetestowanie niektórych funkcji integracji, możesz użyć konta produkcyjnego. Aby wywołać konto produkcyjne, projekt Google Cloud musi mieć co najmniej poziom dostępu Explorer (Explorer, Basic lub Standard). Pamiętaj, że dostęp eksploracyjny nadal ogranicza niektóre usługi, w tym płatności (BillingSetupService i AccountBudgetProposalService), planowanie, tworzenie kont i zaproszenia użytkowników (patrz Ograniczenia funkcji eksploracyjnych), które wymagają dostępu podstawowego lub standardowego. Próba wywołania konta produkcyjnego z projektu z poziomem dostępu Test zwróci błąd AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION (od v25) lub AuthorizationError.ACTION_NOT_PERMITTED (w v24 i wcześniej).
Konta produkcyjne do programowania różnią się od kont testowych pod tymi względami:
- Wyświetlanie reklam, które mogą być widoczne dla użytkowników
- Wymagaj prawidłowych adresów URL
- musi być zgodna z zasadami reklamowymi.
Konta produkcyjne wyświetlają reklamy, więc generują dane, które umożliwiają testowanie raportów skuteczności i odblokowanie wszystkich innych funkcji interfejsu Google Ads API. Jednak używanie ich do programowania wymaga zachowania szczególnej ostrożności. Zalecamy podjęcie tych działań:
- Przyznawaj dostęp tylko użytkownikom, którzy potrzebują go do celów programistycznych.
- Ustaw stały, niski budżet konta dzienny.
- Używaj kont produkcyjnych do programowania tylko wtedy, gdy nie można używać kont testowych.
Dlatego do pełnego przetestowania integracji prawdopodobnie będziesz potrzebować zarówno danych logowania do środowiska testowego, jak i produkcyjnego.
Testowe dane logowania
Aby zminimalizować ryzyko przypadkowej modyfikacji kont produkcyjnych podczas próby modyfikacji kont deweloperskich, zalecamy przechowywanie zestawu danych logowania do testów, który jest oddzielony od danych logowania do aplikacji produkcyjnej.
Aby utworzyć zestaw danych logowania do testów:
- Utwórz konto e-mail (na przykład
api.test@example.com) lub konto usługi, które będzie używane tylko do testowania. - Dodaj tego użytkownika lub konto usługi jako prawidłowego użytkownika na kontach Google Ads, na których przeprowadzasz testy. Pamiętaj, aby przyznać temu użytkownikowi lub kontu usługi odpowiednie poziomy dostępu. Nie przyznawaj temu użytkownikowi ani kontu usługi dostępu do żadnych kont produkcyjnych.
- Jeśli używasz procesu uwierzytelniania użytkownika OAuth 2.0, a nie procesu konta usługi, wygeneruj token odświeżania dla testowego konta użytkownika.
- Użyj tych nowych danych logowania podczas testowania aplikacji. Identyfikator klienta i tajny klucz klienta można wykorzystać do celów testowych, ponieważ nie mają one wpływu na określanie, do których kont Google Ads można uzyskać dostęp. Przechowuj wszystkie dane logowania i tokeny odświeżania w bezpiecznym miejscu i nigdy nie przekazuj ich do systemu kontroli wersji.
Poproś o weryfikację
Jeśli chcesz tylko sprawdzić, czy żądanie jest prawidłowe, np. czy ma poprawną strukturę i nie narusza zasad, możesz użyć pola validate_only, które jest dostępne w przypadku żądań GoogleAdsService.Search (pamiętaj, że GoogleAdsService.SearchStream nie obsługuje validate_only) i większości żądań modyfikacji. Aby sprawdzić, czy to pole jest dostępne w przypadku danej metody, zapoznaj się z dokumentacją.
Interfejs API typu REST
W przypadku testów ad hoc, np. w celu sprawdzenia, czy żądanie daje oczekiwane wyniki, najłatwiejszym rozwiązaniem jest często użycie interfejsu REST API. Zapoznaj się z przykładami REST, aby dowiedzieć się, jak używać curl do wysyłania żądań do interfejsu REST API. Możesz też przeprowadzić testy w eksploratorze REST.