Gerenciamento de Catálogo

​

Visão geral

A Catalog API é uma solução de comércio que oferece aos anunciantes a capacidade de configurar feeds de produtos, agrupar produtos em conjuntos e gerenciar catálogos de forma integrada. A Catalog API será uma ferramenta essencial que permite o gerenciamento programático de catálogos e dá aos anunciantes mais controle sobre como seus catálogos são incorporados e atualizados.

Um catálogo reúne tudo relacionado aos produtos e conjuntos de produtos do usuário e está associado ao identificador do usuário. Atualmente, um usuário só pode criar um catálogo. 

A Catalog API oferece suporte a 2 formas de ingestão de produtos:

1. Scheduled Feed: o usuário pode adicionar uma URL de feed (CSV, TSV e XML) que será buscada periodicamente (X atualmente oferece suporte a arquivos de até 8 GB)

2. Batch Products API: o usuário pode visualizar, criar, atualizar e deletar atributos de produto com solicitações em lote (JSON)

Os comerciantes no X podem criar conjuntos de produtos com base em regras de filtro. Ao fazer isso, poderão anexar metadados adicionais aos seus produtos e criar conjuntos especiais para destacar esses produtos por meio de recursos de comércio orgânico ou anúncios dinâmicos de produtos. A Catalog API e o gerenciador de compras do X oferecem suporte a dois tipos de conjuntos de produtos. 

1. Manual: o usuário pode selecionar até 50 produtos e definir um nome e uma descrição

2. Filter: o usuário pode adicionar até 30 filtros para gerar automaticamente conjuntos com produtos que atendam a esses filtros. Tipos de filtros incluem preço, categoria de produto do Google, tipo de produto, inventário, preço promocional e campos personalizados.

A Catalog API vem com 4 endpoints para gerenciar o catálogo:

• Product Catalogs - Criação de um contêiner para informações de produtos
• Products -  Adição, atualização, visualização e remoção síncronas de produtos dos catálogos
• Product Sets -  Classificação de produtos em grupos com base nas informações dos produtos
• Schedule Feeds - Configuração da ingestão assíncrona de dados de produtos baseados em arquivo nos catálogos

​

Pré-requisitos para a Catalog API

Os endpoints da Catalog API estão disponíveis no momento apenas em acesso antecipado. Para solicitar acesso, entre em contato com seu representante na X.

É necessário aceitar os termos de serviço no X Shopping Manager.

Para obter detalhes sobre o Shopping Manager e as especificações de produto, consulte o Guia de especificações de produto.

​

Limites de requisições 

A tabela a seguir apresenta os limites de requisições para cada endpoint.

​

Catálogo de produtos

Método HTTP	Limite de taxa
GET /product_catalogs	1.000 por 15 minutos
POST /product_catalogs	20 por 15 minutos
PUT /product_catalogs/:product_catalog_id	20 por 15 minutos
DELETE /product_catalogs/:product_catalog_id	20 por 15 minutos

​

API de Produtos em Lote

Método HTTP	Limite de taxa
GET /product_catalogs/:product_catalog_id/products	1.000 por 15 minutos
PUT /product_catalogs/:product_catalog_id/products	600 por 15 minutos
DELETE /product_catalogs/:product_catalog_id/products	150 por 15 minutos

​

Conjuntos de produtos

Método HTTP	Limite de taxa
GET /product_catalogs/:product_catalog_id/product_sets	2.000 por 15 minutos
POST /product_catalogs/:product_catalog_id/product_sets	100 por 15 minutos
PUT /product_catalogs/:product_catalog_id/product_sets/:product_set_id	500 por 15 minutos
DELETE /product_catalogs/:product_catalog_id/product_sets/:product_set_id	100 por 15 minutos

​

Feeds de produtos

Método HTTP	Limite de taxa
GET /product_catalogs/:product_catalog_id/product_feeds	1.000 por 15 minutos
POST /product_catalogs/:product_catalog_id/product_feeds	20 por 15 minutos
PUT /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id	20 por 15 minutos
DELETE /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id	20 por 15 minutos