/api/v4/locations/listings/mark-as-duplicateMarcar listagem como duplicada
Sinaliza um ou mais itens de listagem detectados como duplicatas confirmadas para que a Listings API possa suprimi-los.
Parâmetros
Corpo
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| input.listingItemIds | array | obrigatório | Array of base64-encoded listing item IDs to mark as duplicates. Use the `listingItemId` values from the duplicate-listings endpoints. |
| input.locationId | string | opcional | Location that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location. |
Exemplo de requisição
Corpo pronto para colar. Substitua os IDs e valores de exemplo pelos seus.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}Respostas
200Listing items marked as duplicates. On failure, `success` is `false` and `errors` describes why.
{ "data": { "markAsDuplicate": { "success": true, "errors": null } }}400Validation error, e.g. an unknown or malformed listing item ID. See the `errors` array (`code`, `message`, `path`).
401Unauthenticated, missing or invalid API key.
Confirma que itens específicos de listagem são duplicatas, sinalizando à Listings API que deve suprimi-los ou removê-los. Preencha listingItemIds com os valores de listingItemId retornados por Obter listagens duplicadas de um local (ou os valores de id da consolidação de toda a conta).
Caso de uso: agir sobre uma duplicata verificada
Depois que uma pessoa responsável pela verificação confirmar um grupo de duplicatas, envie os IDs dos itens duplicados em uma única chamada:
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}listingItemIds é obrigatório e aceita vários IDs, portanto, agrupe todas as duplicatas confirmadas de um local em uma única requisição, em vez de fazer uma chamada por listagem. Um 200 com success: true significa que os itens foram aceitos para supressão; um 200 com success: false (ou um 400) retorna um array errors preenchido; inspecione code e message de cada entrada antes de tentar novamente.
Caso de uso: reverter um erro
Se um item foi sinalizado por engano, desfaça a ação com Marcar listagem como não duplicada, que aceita a mesma estrutura de corpo. Esta é uma operação de escrita e conta para o limite de requisições da conta, portanto, prefira agrupar os itens em lotes a fazer requisições por item.
curl -X POST 'https://listingsapi.com/api/v4/locations/listings/mark-as-duplicate' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": [ "TGlzdGluZ0l0ZW06MjM1OTg0NTA=" ] } }'