Ver estatísticas e problemas do produto

Você pode usar o método aggregateProductStatuses.list para ter uma visão geral de alto nível do status dos produtos na sua conta do Merchant Center. Isso é útil para monitorar a integridade geral dos dados de produtos sem precisar buscar cada item individual. Esse método fornece o número total de produtos que você tem, dividido 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 resposta aggregateProductStatuses.
• Consistência de problemas: os títulos e as descrições de problemas retornados pelo método aggregateProductStatuses.list devem ser consistentes com os problemas retornados pela API Products. No entanto, elas podem ser diferentes das descrições de problemas mostradas na interface do usuário do Merchant Center.

Ter 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/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"
          ]
        }
      ]
    }
  ]
}

Receber status de produtos para um país e destino específicos

É possível filtrar os resultados para ver o status de um país e destino específicos usando o parâmetro de consulta filter com o método aggregateProductStatuses.list. 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/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"
          ]
        }
      ]
    }
  ]
}