Use o método aggregateProductStatuses.list
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 todos 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
a inserção ou atualização de um produto e o momento em que 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.listprecisam 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.
Confira uma visão geral de todos os status de 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
Veja 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/en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/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/en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/en~US~SKU002"
]
}
]
}
]
}
Receber status de produtos para um país e destino específicos
Filtre 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. Por exemplo, country = "US" AND reportingContext = "SHOPPING_ADS".
Para mais informações sobre a sintaxe do filtro, consulte
Sintaxe do filtro.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses?filter=countryCode%3D"US"%20AND%20reportingContext%3D"SHOPPING_ADS"
Veja 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/en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/en~US~SKU003"
]
}
]
}
]
}