Tipos de publicação e atualização de anúncios
Tipos de anúncios por site
Você precisa que ter em conta que cada site tem seus próprios tipos de publicação. Para ver todos os tipos de publicação de um site, você deve realizar uma chamada GET aos recursos listing_types com o Site_id:
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLC/listing_types
Resposta:
[
{
"site_id": "MLC",
"id": "gold_pro",
"name": "Premium"
},
{
"site_id": "MLC",
"id": "gold_premium",
"name": "Oro Premium"
},
{
"site_id": "MLC",
"id": "gold_special",
"name": "Clásica"
},
{
"site_id": "MLC",
"id": "gold",
"name": "Oro"
},
{
"site_id": "MLC",
"id": "silver",
"name": "Plata"
},
{
"site_id": "MLC",
"id": "bronze",
"name": "Bronce"
},
{
"site_id": "MLC",
"id": "free",
"name": "Gratuita"
}
]
Em determinados sites os tipos de anúncios sofreram mudanças, para saber quais são sugerimos revisar a seguinte novidade. Na API ainda pode se ver os anteriores, que serão mapeados automaticamente para que não tenha erros em sua integração. Sugerimos publicar da seguinte forma:
Mercado Livre Argentina, Brasil, Chile, México e Colombia
gold_pro: Premium
gold_special: Clásica
free: Gratuita
Mercado Livre Peru, Venezuela, Equador e Uruguai
gold_special: Premium
bronze: Clásica
free: Gratuita
Especificações do tipo de anuncio
Você precisa que ter em conta que cada site tem seus próprios tipos de publicação. Para ver todos os tipos de publicação de um site, você deve realizar uma chamada GET aos recursos listing_types com o Site_id:
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_types/bronze
Resposta:
{
"id": "bronze",
"not_available_in_categories": [
"MLA1743",
"MLA1459"
],
"configuration": {
"name": "Bronce",
"listing_exposure": "low",
"requires_picture": false,
"max_stock_per_item": 9999,
"deduction_profile_id": null,
"differential_pricing_id": null,
"duration_days": {
"buy_it_now": 60,
"auction": 7,
"classified": null
},
"immediate_payment": {
"buy_it_now": false,
"auction": false,
"classified": false
},
"mercado_pago": "mandatory",
"listing_fee_criteria": {
"min_fee_amount": 0,
"max_fee_amount": 0,
"percentage_of_fee_amount": 0,
"currency": "ARS"
},
"sale_fee_criteria": {
"min_fee_amount": 0,
"max_fee_amount": 100000000000000000,
"percentage_of_fee_amount": 11,
"currency": "ARS"
}
},
"exceptions_by_category": [
{
"category_id": "MLA1540",
"category_name": "Servicios",
"configuration": {
"name": "Básico 90",
"listing_exposure": "mid",
"requires_picture": false,
"max_stock_per_item": 999,
"deduction_profile_id": null,
"differential_pricing_id": null,
"duration_days": {
"buy_it_now": null,
"auction": null,
"classified": 90
},
"immediate_payment": {
"buy_it_now": false,
"auction": false,
"classified": false
},
"mercado_pago": "not_available",
"listing_fee_criteria": {
"min_fee_amount": 347,
"max_fee_amount": 347,
"percentage_of_fee_amount": 0,
"currency": "ARS"
},
"sale_fee_criteria": {
"min_fee_amount": 0,
"max_fee_amount": 0,
"percentage_of_fee_amount": 0,
"currency": null
}
},
"exceptions_by_category": [
]
}
]
}
Os itens Clássico e Premium terão duração ilimitada; você pode consultar no campo stop_time:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MCO415406202?attributes=stop_time
Além disso, esses anúncios serão pausados caso o estoque for 0 e serão ativados quando uma nova quantidade for adicionada. Você vai visualizar o item assim:
"status": "paused",
"sub_status": [
"out_of_stock"
]
Se você quiser adicionar estoque e ativar novamente o item, deverá fazer o seguinte:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"available_quantity": 1
}
https://api.mercadolibre.com/items/ITEM_ID
Lembre que o tipo de anúncio Gratuito vai manter o fluxo atual. O vendedor poderá trocar entre os tipos de anúncio Clássico e Premium toda vez que desejar sem custo algum, e poderá pausar e finalizar os itens da mesma maneira em que funciona agora.
Se você quiser trocar de Premium para Clássico, deverá seguir estes passos:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"id": "gold"
}
https://api.mercadolibre.com/items/{Item_id}/listing_type
Tipos de anúncios disponíveis
Você pode consultar os tipos de publicação disponíveis por usuário e para um category_id determinado.
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/{Cust_id}/available_listing_types?category_id={Category_id}
Resposta:
{
"category_id": "MLC3530",
"available": [
{
"site_id": "MLC",
"id": "gold_premium",
"name": "Oro Premium",
"remaining_listings": null
},
{
"site_id": "MLC",
"id": "gold",
"name": "Oro",
"remaining_listings": null
},
{
"site_id": "MLC",
"id": "silver",
"name": "Plata",
"remaining_listings": null
},
{
"site_id": "MLC",
"id": "bronze",
"name": "Bronce",
"remaining_listings": null
},
{
"site_id": "MLC",
"id": "free",
"name": "Gratuita",
"remaining_listings": null
}
]
}
Se você não consegue publicar em certos tipo de anúncio e quer saber porque não consegue, você pode realizar uma chamada GET para verificar o motivo.
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/{Cust_id}/available_listing_type/free?category_id={Category_id}
Resposta:
{
"available": false,
"cause": "You have more than 5 transactions in the last year.",
"code": "list.transactions.exceeded"
}
Exposições das publicações
Este recurso da nossa API devolve informação sobre os níveis de exposição associados a todos os tipos de publicações no Mercado Livre. Você pode consultar todas as exposições disponíveis para as publicações por site, com uma chamada GET simples.
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_exposures
Resposta:
{[
{
"id": "lowest",
"name": "Última",
"home_page": false,
"category_home_page": false,
"advertising_on_listing_page": true,
"priority_in_search": 4
},
{
"id": "low",
"name": "Inferior",
"home_page": false,
"category_home_page": false,
"advertising_on_listing_page": false,
"priority_in_search": 3
},
{
"id": "mid",
"name": "Media",
"home_page": false,
"category_home_page": true,
"advertising_on_listing_page": false,
"priority_in_search": 2
},
{
"id": "high",
"name": "Alta",
"home_page": false,
"category_home_page": true,
"advertising_on_listing_page": false,
"priority_in_search": 1
},
{
"id": "highest",
"name": "Superior",
"home_page": true,
"category_home_page": true,
"advertising_on_listing_page": false,
"priority_in_search": 0
}
]
E fazer uma consulta por seu ID:
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_exposures/high
Resposta:
{
"id": "high",
"name": "Alta",
"home_page": false,
"category_home_page": true,
"advertising_on_listing_page": false,
"priority_in_search": 1
}
Atualizações disponíveis
Você pode atualizar seu anúncio para uma exposição maior apenas uma vez. Se precisa realizar outras atualizações, você pode ver que tipos de exposição estão disponíveis para seu anúncio.
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/{Item_id}/available_upgrades
Resposta:
[
{
"site_id": "MLC",
"id": "gold_premium",
"name": "Oro Premium"
},
{
"site_id": "MLC",
"id": "gold",
"name": "Oro"
},
{
"site_id": "MLC",
"id": "silver",
"name": "Plata"
}
]
Muito bem! Agora você está pronto para acessar a exposições corretas para seus produtos e realizar atualizações. Como sabemos que às vezes você precisa mais de uma tentativa para realizar sua publicação, te oferecemos a possibilidade de validar o seu artigo antes de tentar uma publicação. Por favor, leia este artigo para mais informações sobre o nosso validador de publicações.
Baixar um anúncio a um tipo de publicação inferior (downgrades)
Downgrade é reduzir a exposição de um anúncio ao atualizá-lo em um tipo de publicação inferior. Está disponível para alguns casos particulares:
- Está permitido realizar downgrades nos anúncios entre gold_pro a gold_special.
- Antes de começar, você pode realizar downgrades para as publicações em payment_required.
- Não está permitido realizar downgrade de um anúncio gratuito.
