Testowanie jest ważnym krokiem w tworzeniu skutecznej 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 interfejsu Google Ads API.
Konta testowe i konta produkcyjne
Konta testowe są dostępne do celów programistycznych. Konta testowe umożliwiają sprawdzenie, czy kod aplikacji i konfiguracja działają zgodnie z oczekiwaniami.
Jednak nie wszystkie funkcje można przetestować na koncie testowym.
Jeśli ograniczenia konta testowego uniemożliwiają Ci testowanie niektórych funkcji w integracji, możesz zamiast tego użyć konta produkcyjnego do celów programistycznych. Twój projekt Google Cloud musi mieć co najmniej poziom dostępu Eksplorator (Eksplorator, Podstawowy lub Standardowy), aby wywoływać konto produkcyjne. Pamiętaj, że dostęp do eksploratora nadal ogranicza dostęp do niektórych usług, w tym do płatności (BillingSetupService i AccountBudgetProposalService), planowania, tworzenia kont i zapraszania użytkowników (więcej informacji znajdziesz w sekcji Ograniczenia funkcji eksploratora), które wymagają dostępu podstawowego lub standardowego. Próba wywołania konta produkcyjnego z projektu z poziomem dostępu Test zwraca błąd AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION od v25 lub AuthorizationError.ACTION_NOT_PERMITTED w v24 i wcześniejszych wersjach.
Konta produkcyjne do celów deweloperskich różnią się od kont testowych w tych aspektach:
- Wyświetlanie reklam, które mogą być widoczne dla użytkowników
- Wymagaj prawidłowych adresów URL
- Muszą być zgodne z zasadami reklamowymi.
Konta produkcyjne wyświetlają reklamy, więc generują dane, które umożliwiają testowanie raportów skuteczności, a także odblokowują wszystkie inne funkcje interfejsu Google Ads API. Jednak używanie ich do celów programistycznych wymaga zachowania szczególnej ostrożności. Zalecamy podjęcie tych środków:
- Przyznawaj dostęp tylko użytkownikom, którzy potrzebują go do celów związanych z programowaniem.
- Ustaw stały, niski budżet konta dzienny.
- Kont produkcyjnych używaj do programowania tylko wtedy, gdy nie można używać kont testowych.
Aby w pełni przetestować integrację, prawdopodobnie będziesz potrzebować zarówno danych logowania do testowania, jak i danych logowania do środowiska produkcyjnego.
Testowe dane logowania
Aby zminimalizować ryzyko przypadkowego zmodyfikowania kont produkcyjnych podczas próby zmodyfikowania kont deweloperskich, zalecamy utrzymywanie zestawu danych logowania testowych, które są oddzielone od danych logowania aplikacji produkcyjnej.
Aby utworzyć zestaw danych logowania do testów:
- Utwórz konto e-mail (np.
api.test@example.com) lub konto usługi, które będzie używane tylko do celów testowych. - Dodaj tego użytkownika lub konto usługi jako prawidłowego użytkownika na kontach Google Ads, na których przeprowadzane są testy. Upewnij się, że temu użytkownikowi lub kontu usługi przyznano 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 zamiast procesu konta usługi, wygeneruj token odświeżania dla testowego konta użytkownika.
- Podczas testowania aplikacji używaj tych nowych danych logowania. Identyfikator klienta i klucz tajny klienta można ponownie wykorzystać do celów testowych, ponieważ nie mają one wpływu na to, do których kont Google Ads można uzyskać dostęp. Przechowuj wszystkie dane logowania i tokeny odświeżania w bezpieczny sposób i nigdy nie przesyłaj ich do systemu kontroli wersji.
Poproś o weryfikację
Jeśli chcesz tylko sprawdzić, czy żądanie jest prawidłowe, np. aby upewnić się, że jest poprawnie sformatowane 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ń zmiany. 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 dane wyjściowe, najłatwiej jest użyć interfejsu API REST. Zapoznaj się z przykładami REST, aby dowiedzieć się, jak używać curl do wysyłania żądań do interfejsu REST API. Możesz też przetestować to w eksploratorze REST.