Тестирование – важный этап успешной интеграции 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.