Ver estatísticas e problemas do produto

Você pode usar o aggregateProductStatuses.list método para ter uma visão geral do status dos produtos na sua conta do Merchant Center. Isso é útil para monitorar a integridade geral dos dados do produto sem precisar buscar cada item individualmente. Esse método fornece o número total de produtos que você tem, divididos por status (aprovado, pendente, reprovado), e também lista os problemas que estão afetando seus produtos.

Considerações especiais

Há considerações especiais ao usar o método aggregateProductStatuses.list.

  • Disponibilidade de dados: espere um atraso de mais de 30 minutos entre o momento em que um produto é inserido ou atualizado e quando o status dele é refletido na aggregateProductStatuses resposta.
  • Consistência de problemas: os títulos e as descrições de problemas retornados pelo aggregateProductStatuses.list método devem ser consistentes com os problemas retornados pela API Products. No entanto, eles podem ser diferentes das descrições de problemas mostradas na interface do usuário do Merchant Center.

Conferir uma visão geral de todos os status dos produtos

Este exemplo mostra como recuperar uma lista de recursos AggregateProductStatus. Cada recurso representa o status dos produtos para uma combinação específica de destino e país. Chamar aggregateProductStatuses.list sem parâmetros retorna todos os status disponíveis para sua conta.

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

Confira um exemplo de resposta de uma chamada bem-sucedida:

{
  "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"
          ]
        }
      ]
    }
  ]
}

Conferir o status dos produtos para um país e destino específicos

Você pode filtrar os resultados para conferir o status de um país e destino específicos usando o parâmetro de consulta filter com o método aggregateProductStatuses.list. Por exemplo: country = "US" AND reportingContext = "SHOPPING_ADS". Para mais informações, consulte Sintaxe de filtro.

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

Confira um exemplo de resposta de uma chamada bem-sucedida:

{
  "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"
          ]
        }
      ]
    }
  ]
}
Anterior
Display issues and solutions to businesses