Тестовые аккаунты в Merchant API

Функция тестовых аккаунтов для API продавцов предоставляет безопасное и изолированное пространство для тщательного тестирования интеграций перед их развертыванием в рабочей среде. Используя изолированные тестовые аккаунты, вы можете экспериментировать с вызовами API, проверять код и выявлять потенциальные проблемы на ранних этапах разработки, не затрагивая данные в рабочей среде, не нарушая работу в режиме реального времени и непреднамеренно не нарушая политики Merchant Center.

Предварительные требования

Прежде чем создавать и использовать тестовые учетные записи, убедитесь, что вы соответствуете следующим требованиям:

  • Для работы с учетной записью Merchant Center необходимо иметь учетную запись Merchant Center.
  • Доступ к API для продавцов: Вы должны быть зарегистрированным пользователем API для продавцов.

Преимущества тестовых аккаунтов

Использование тестовых аккаунтов предоставляет ряд ключевых преимуществ:

  • Простая настройка: настройка тестового аккаунта — это простой процесс, позволяющий быстро начать тестирование функций и интеграций.
  • Целостность и безопасность данных: производственные данные остаются защищенными, а риск нарушений политики в производственных учетных записях исключен.
  • Эффективность тестирования: Вы можете тестировать широкий спектр разнообразных сценариев и граничных случаев без необходимости поддерживать параллельную рабочую учетную запись для целей тестирования.
  • Мгновенная проверка предложений: Воспользуйтесь автоматическим освобождением от необходимости подтверждения и проверки на главной странице для тестовых аккаунтов, чтобы быстро протестировать размещение предложений. Предложения одобряются по умолчанию для тестовых аккаунтов.
  • Реалистичное моделирование: среда имитирует производственное поведение для критически важных функций, таких как загрузка продукции и управление запасами, что обеспечивает надежность результатов тестирования.
  • Более плавная миграция API: тестовые учетные записи обеспечивают уверенный и беспроблемный переход для тех, кто переходит с Content API на Merchant API или с одной версии API на другую, позволяя проводить параллельную проверку.

Как создать тестовые аккаунты

Тестовые учетные записи создаются с использованием специального пользовательского метода в API для продавцов.

Используйте метод accounts.createTestAccount :

  POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
  Content-Type: application/json
  Authorization: Bearer {ACCESS_TOKEN}"

  {
    "account_name": "{TEST_ACCOUNT_NAME}",
    "time_zone": {
      "id": "America/Los_Angeles"
    },
    "language_code": "en-US"
  }

Замените следующее:

  • ACCOUNT_ID : ваш идентификатор Merchant Center.
  • ACCESS_TOKEN : токен авторизации для выполнения вызова API.
  • TEST_ACCOUNT_NAME : имя тестовой учетной записи. Мы рекомендуем использовать осмысленные имена, указывающие на то, что они используются для тестирования. Например, в имени тестовой учетной записи должно быть слово test .

При создании тестовой учетной записи необходимо заполнить следующие поля:

  • time_zone : Часовой пояс для формирования отчетов и отображения информации в учетной записи.
  • language_code : Языковой код BCP-47 для учетной записи, например, en-US .

В случае успешного вызова возвращается ресурс Account , содержащий уникальный accountId и имя ресурса новой тестовой учетной записи:

  {
    "name": "accounts/{TEST_ACCOUNT_ID}",
    "accountId": "{TEST_ACCOUNT_ID}",
    "accountName": "{TEST_ACCOUNT_NAME}",
    "adultContent": false,
    "testAccount": true,
    "timeZone": {
      "id": "America/Los_Angeles"
    },
    "languageCode": "en-US"
  }

Ограничения

Тестовые учетные записи предназначены для функциональной проверки и имеют определенные ограничения:

  • Количество тестовых аккаунтов: Вы можете создать максимум 5 тестовых аккаунтов на один аккаунт Google. Тестовые аккаунты учитываются в вашем стандартном лимите аккаунтов Merchant Center на один аккаунт Google.
  • Интеграция с квотами Merchant API: С точки зрения квот API, Merchant API рассматривает тестовые учетные записи как рабочие. На тестовые учетные записи распространяются те же квоты, что и на рабочие. Увеличение квот для тестовых учетных записей невозможно.
  • Расширенные учетные записи: Вы не можете создавать расширенные тестовые учетные записи или преобразовывать расширенную учетную запись в тестовую.
  • Публичная публикация: данные, отправленные в тестовый аккаунт, никогда не будут опубликованы ни на одной платформе Google, например, в результатах поиска или в товарной рекламе.
  • Ограниченные конечные точки: Вы не можете использовать тестовые учетные записи при использовании определенных функций, таких как:
  • Ограничения на привязку: Вы не можете привязать тестовые аккаунты к другим аккаунтам Google Ads или аккаунтам Google Business Profile.
  • Регистрация тестовых аккаунтов невозможна: Вы не можете зарегистрировать тестовый аккаунт.

Передовые методы

Мы рекомендуем следовать некоторым передовым методам при использовании тестовых учетных записей:

  • Разработка с учетом принципа «песочницы»: всегда проверяйте новые функции интеграции в тестовой учетной записи, прежде чем применять их в рабочей среде.
  • Автоматизированное интеграционное тестирование: используйте тестовые учетные записи в качестве стабильной среды для запуска автоматизированных регрессионных тестов.
  • Именование тестовых учетных записей: используйте account_name , чтобы указать назначение каждой тестовой учетной записи, например, «Тестирование миграции» или «Учетная запись для интеграционного тестирования».