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

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

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

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

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

Получите обзор всех статусов продукта

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

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

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

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/12345/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/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU003"
          ]
        }
      ]
    },
    {
      "name": "accounts/12345/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/12345/products/online~en~US~SKU001",
            "accounts/12345/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/12345/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/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU003"
          ]
        }
      ]
    }
  ]
}