Skip to main content

Referência da API

Esta é a referência técnica completa. Para uma visão geral de conceitos de Catalog Management, feeds de produtos e Dynamic Product Ads, consulte a Visão Geral de Catalog Management.
Estes endpoints estão atualmente disponíveis apenas por early-access. Para solicitar acesso, preencha este formulário ou entre em contato com seu representante do X.

Product Catalogs

GET product_catalogs

Recupera detalhes de alguns ou todos os catálogos de produtos associados ao usuário autenticado (padrão) ou ao usuário especificado no parâmetro user_id. URL do recurso https://ads-api.x.com/12/product_catalogs
long
Uma referência ao usuário com o qual você está operando na requisição. Use GET users/lookup para recuperar um user ID a partir de um screen name.
Exemplo de requisição
Exemplo de resposta
Exemplo de resposta

POST product_catalogs

Cria um catálogo de produtos. Um usuário só pode criar um catálogo que armazena todos os produtos. Comerciantes do X precisam criar um catálogo antes de fazer upload de produtos. URL do recurso https://ads-api.x.com/12/product_catalogs
string
required
Nome do seu catálogo de produtos.
long
Uma referência ao usuário com o qual você está operando na requisição. Use GET users/lookup para recuperar um user ID a partir de um screen name.
Exemplo de requisição
Exemplo de resposta
Esta referência técnica também cobre os endpoints PUT, DELETE para product_catalogs, todos os endpoints de Products (GET, PUT, DELETE), Product Sets (GET, POST, PUT, DELETE) e Scheduled Feeds (GET, POST, PUT, DELETE). Para todos os detalhes técnicos, tabelas de parâmetros, atributos de request body em JSON e exemplos de respostas, consulte a versão em inglês em /x-ads-api/catalog-management/reference. Todos os nomes de parâmetros, endpoints, valores enum e estruturas JSON permanecem inalterados.