Gerenciamento de Perguntas e Contatos
Conteúdos
→Descrição de parâmetros →Total de perguntas →Perguntas por data →Total de telefones de contato →Telefones de contato por data →Visitas por anúncio
Descrição de parâmetros
Tipo | Parâmetro | Descrição |
---|---|---|
Integer | {userId} | ID de usuário. |
Integer | {itemId} | ID do anúncio. |
Date | {dateFrom} | Data, no formato ISO, que define o início da consulta. |
Date | {dateTo} | Data, no formato ISO, que define o final da consulta. |
Integer | {limit} | Opcional. Quantidade máxima de anúncios a devolver. |
Integer | {offset} | Opcional. Paginação. |
Integer | {last} | Opcional. Denota quantas horas/dias a amostra abrangerá. |
String | {unit} | Unidade de consulta, valores possíveis: [“dia”, “hora”]. |
Date | {ending} | Opcional. Data, em formato ISO, estabelecendo o tempo de finalização da amostra; por padrão, deve ser a data e a hora atuais. |
String | {order} | Opcional. Classifica os resultados por data: [“desc”, “asc”] (por padrão, “asc”). |
Total de perguntas
Você pode acessar o total de perguntas que um anúncio teve, ou o total de perguntas recebidas por um vendedor em todos os seus anúncios, em um intervalo de tempo.
Por anúncios
currl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TO
Por usuário
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TO
Exemplo:
curl -X GET https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999
Resposta:
{
"date_from": "2014-08-01T00:00:00.000-03:00",
"date_to": "2014-08-02T23:59:59.999",
"item_id": "MLV421672596",
"total": 9
}
Perguntas por data
Este recurso permite acessar as perguntas sobre um determinado anúncio ou vendedor durante um intervalo de tempo especificado. Além disso, você obtém detalhes sobre contatos feitos em modo convidado (usuários que não fizeram login ou não são cadastrados), em intervalos de tempo, por hora ou por dia.
Por anúncio
curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/questions/time_window?last=$LAST&unit=$UNIT
Caso você precise concatenar anúncios, faça o seguinte:
curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/questions/time_window?ids=$ID1,ID2&last=$LAST&unit=$UNIT&ending=$ENDING_DATE
Por usuário
curl -X GET https://api.mercadolibre.com/users/$USERR_ID/contacts/questions/time_window?last=$LAST&unit=$UNIT
Exemplo:
curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour
Resposta:
{
"item_id": "MLA510272257",
"total": 0,
"date_from": "2014-08-06T12:00:00Z",
"date_to": "2014-08-06T14:00:00Z",
"last": 2,
"unit": "hour",
"results": [
{
"date": "2014-08-06T12:00:00Z",
"total": 0
},
{
"date": "2014-08-06T13:00:00Z",
"total": 0
}
]
}
Total de telefones de contato
Você pode acessar o total de cliques da opção “Ver telefone“ de um anúncio, ou para cada um dos anúncios de um usuário, em intervalos de tempo.
Por anúncio
curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/phone_views?date_from=$DATE_FROM&date_to=$DATE_TO
Por usuário
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views?date_from=$DATE_FROM&date_to=$DATE_TO
Exemplo:
curl -X GET https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999
Resposta:
{
"date_from": "2014-05-28T00:00:00.000-03:00",
"date_to": "2014-05-29T23:59:59.999",
"total": 71,
"user_id": "52366166"
}
Telefones de contato por data
Você pode acessar o total de cliques da opção “Ver telefone" de um anúncio, ou para cada um dos anúncios de um usuário, durante um determinado intervalo de tempo. Além de fornecer o total de visitas, as informações são listadas e agrupadas por intervalos de tempo.
Por anúncio
curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/phone_views/time_window?last=$LAST&unit=$UNIT
Caso você precise concatenar anúncios, faça o seguinte:
curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=$ID1,ID2&last=$LAST&unit=$UNIT&ending=$ENDING_DATE
Por usuário
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views/time_window?last=$LAST&unit=$UNIT
Exemplo:
curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00
Resposta:
[
{
"item_id": "MLA510272257",
"total": 0,
"date_from": "2014-05-28T02:00:00Z",
"date_to": "2014-05-28T04:00:00Z",
"last": 2,
"unit": "hour",
"results": [
{
"date": "2014-05-28T02:00:00Z",
"total": 0
},
{
"date": "2014-05-28T03:00:00Z",
"total": 0
}
]
},
{
"item_id": "MLA489747739",
"total": 0,
"date_from": "2014-05-28T02:00:00Z",
"date_to": "2014-05-28T04:00:00Z",
"last": 2,
"unit": "hour",
"results": [
{
"date": "2014-05-28T02:00:00Z",
"total": 0
},
{
"date": "2014-05-28T03:00:00Z",
"total": 0
}
]
}
]
Visitas por anúncio
Para consultar as visitas por anúncio, utilize o artigo sobre o Recurso Visits.
Próximo: Recebimento de notificações.