Тестирование – важный этап создания успешной интеграции с Google Ads API. Оно необходимо как при разработке приложения, так и при его поддержке или добавлении новых функций в существующую интеграцию. В этом руководстве представлены рекомендации по тестированию интеграции с Google Ads API.
Тестовые и рабочие аккаунты
Для разработки можно использовать тестовые аккаунты. Тестовые аккаунты позволяют проверить, правильно ли работают код и конфигурация приложения.
Однако в тестовом аккаунте доступны не все функции.
Если ограничения тестового аккаунта не позволяют вам проверить некоторые функции интеграции, вы можете использовать для разработки рабочий аккаунт. Чтобы вызвать рабочий аккаунт, у вашего проекта Google Cloud должен быть как минимум уровень доступа "Исследователь" (Исследователь, Базовый или Стандартный). Обратите внимание, что доступ исследователя не позволяет пользоваться некоторыми сервисами, включая платежные (BillingSetupService и AccountBudgetProposalService), планирование, создание аккаунтов и приглашение пользователей (см. Ограничения функций для исследователей). Для этого требуется базовый или стандартный доступ. При попытке вызвать рабочий аккаунт из проекта с тестовым уровнем доступа возвращается ошибка AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION (начиная с v25) или AuthorizationError.ACTION_NOT_PERMITTED (в v24 и более ранних версиях).
Рабочие аккаунты для разработки отличаются от тестовых аккаунтов следующим образом:
- Показывайте объявления, которые пользователи могут увидеть
- Требовать действительные URL
- Должны соответствовать правилам размещения рекламы.
Поскольку в рабочих аккаунтах показываются объявления, они генерируют показатели, позволяющие тестировать отчеты об эффективности, а также разблокировать все остальные функции Google Ads API. Однако при использовании их для разработки требуется особая осторожность. Рекомендуем принять следующие меры:
- Предоставляйте доступ только тем пользователям, которым он нужен для разработки.
- Установить фиксированный низкий дневной бюджет аккаунта
- Используйте рабочие аккаунты для разработки, только если нельзя использовать тестовые.
Таким образом, для полного тестирования интеграции вам, скорее всего, понадобятся как тестовые, так и рабочие учетные данные.
Учетные данные тестового аккаунта
Чтобы снизить риск случайного изменения рабочих аккаунтов при попытке изменить аккаунты разработчика, рекомендуем использовать набор тестовых учетных данных, отличный от учетных данных рабочего приложения.
Чтобы создать набор тестовых учетных данных, выполните следующие действия:
- Создайте аккаунт электронной почты (например,
api.test@example.com) или сервисный аккаунт, который будет использоваться только для тестирования. - Добавьте этого пользователя или сервисный аккаунт в качестве действительного пользователя в аккаунты Google Рекламы, на которых вы проводите тестирование. Убедитесь, что вы предоставили пользователю или сервисному аккаунту подходящий уровень доступа. Не предоставляйте этому пользователю или сервисному аккаунту доступ к рабочим аккаунтам.
- Если вы используете процесс аутентификации пользователей OAuth 2.0, а не процесс сервисного аккаунта, сгенерируйте токен обновления для тестового аккаунта пользователя.
- Используйте эти новые учетные данные при тестировании приложения. Идентификатор клиента и секретный код клиента можно использовать повторно в целях тестирования, поскольку они не влияют на то, к каким аккаунтам Google Рекламы можно получить доступ. Надежно храните все учетные данные и токены обновления и никогда не добавляйте их в систему контроля версий.
Запросить проверку
Если вам нужно проверить, действителен ли запрос, например чтобы убедиться, что он правильно структурирован и не нарушает правила, вы можете использовать поле validate_only, которое доступно для запросов GoogleAdsService.Search (обратите внимание, что GoogleAdsService.SearchStream не поддерживает validate_only) и большинства запросов mutate. Чтобы узнать, доступно ли это поле для определенного метода, ознакомьтесь со справочной документацией.
REST API
Для специальных тестов, например чтобы проверить, соответствует ли запрос ожидаемому результату, часто удобнее всего использовать REST API. Ознакомьтесь с примерами REST, чтобы узнать, как использовать curl для отправки запросов к REST API. Также попробуйте выполнить тестирование в REST Explorer.