Просмотр статистики и проблем с продуктом

Вы можете использовать метод aggregateProductStatuses.list , чтобы получить общее представление о состоянии товаров в вашем аккаунте Merchant Center. Это полезно для мониторинга общего состояния данных о ваших товарах без необходимости получать информацию о каждом отдельном товаре. Этот метод предоставляет общее количество товаров с разбивкой по статусу (одобрено, в ожидании, отклонено), а также перечисляет любые проблемы, влияющие на ваши товары.

Особые соображения

При использовании метода aggregateProductStatuses.list необходимо учитывать особые моменты.

• Доступность данных : Ожидается задержка более 30 минут между моментом добавления или обновления продукта и моментом, когда его статус отобразится в ответе aggregateProductStatuses .
• Согласованность задач : Заголовки и описания задач, возвращаемые методом aggregateProductStatuses.list , должны соответствовать задачам, возвращаемым API продуктов. Однако они могут отличаться от описаний задач, отображаемых в пользовательском интерфейсе Merchant Center.

Получите обзор всех статусов товаров.

В этом примере показано, как получить список ресурсов AggregateProductStatus . Каждый ресурс представляет статус товаров для определенной комбинации пункта назначения и страны. Вызов aggregateProductStatuses.list без параметров возвращает все доступные статусы для вашей учетной записи.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses

Вот пример ответа после успешного звонка:

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/{ACCOUNT_ID}/aggregateProductStatuses/SHOPPING_ADS~US",
      "reportingContext": "SHOPPING_ADS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1500",
        "pendingCount": "50",
        "disapprovedCount": "25"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU003"
          ]
        }
      ]
    },
    {
      "name": "accounts/{ACCOUNT_ID}/aggregateProductStatuses/FREE_LISTINGS~US",
      "reportingContext": "FREE_LISTINGS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1510",
        "pendingCount": "50",
        "disapprovedCount": "15"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        }
      ]
    }
  ]
}

Получите информацию о статусе товаров для конкретной страны и региона назначения.

Вы можете отфильтровать результаты, чтобы увидеть статус для конкретной страны и направления, используя параметр запроса filter в методе aggregateProductStatuses.list . Например: country = "US" AND reportingContext = "SHOPPING_ADS" . Для получения дополнительной информации см. синтаксис фильтра .

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses?filter=countryCode%3D"US"%20AND%20reportingContext%3D"SHOPPING_ADS"

Вот пример ответа после успешного звонка:

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/{ACCOUNT_ID}/aggregateProductStatuses/SHOPPING_ADS~US",
      "reportingContext": "SHOPPING_ADS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1500",
        "pendingCount": "50",
        "disapprovedCount": "25"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU003"
          ]
        }
      ]
    }
  ]
}