Enviar atualizações de itens

Para enviar atualizações de itens, use o ponto de extremidade /{catalog_id}/batch.

Para criar, atualizar ou excluir itens do catálogo, faça uma chamada HTTP POST para:

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/batch?requests=<REQUESTS>

Parâmetros

Os nomes dos parâmetros para /{catalog_id}/batch e /{catalog_id}/items_batch podem parecer semelhantes, mas são distintamente diferentes.

Nós recomendamos usar a API /{catalog_id}/items_batch, que aceita mais casos de uso e é mantida atualizada.

Parâmetro	Tipo	Descrição
`allow_upsert`	booliano	Quando `allow_upsert` for `false`, as solicitações de atualização de itens que não aparecem no catálogo não serão concluídas. Caso contrário, novos itens serão criados.
`requests`	objeto	Um objeto JSON que contém todas as solicitações.
`requests.data`	objeto	Um objeto JSON que contém campos e valores de um item. Quando o método for `CREATE`, o objeto deverá conter todos os campos obrigatórios. Quando for `UPDATE`, qualquer campo será aceito. Observação: veja os campos compatíveis que podem ser enviados.
`requests.method`	string	`CREATE`, `UPDATE` ou `DELETE`.
`requests.retailer_id`	string	O `id` de um item fornecido pelo anunciante; não é o número de identificação do Facebook (FBID, pelas iniciais em inglês).

O método UPDATE também pode ser usado para criar itens que ainda não existem.

Para obter mais detalhes, consulte a Referência da API.

O parâmetro requests pode conter até 5.000 atualizações.
O limite de número de chamadas por hora é definido conforme o caso de uso da empresa proprietária do lote de catálogo. Se o limite de volume não for suficiente, entre em contato conosco.
O limite de tamanho do lote é 5.000.
O código de erro 1 com a mensagem "Please reduce the amount of data you're asking for, then retry your request" indica que o tamanho dos dados (em bytes) recebidos na solicitação de API é muito grande. Para corrigir esse problema, reduza o número de itens no lote e tente novamente. Dessa forma, você garantirá que a solicitação esteja dentro dos limites de tamanho aceitáveis e possa ser processada com sucesso.

Veja a lista de campos aceitos para o ponto de extremidade /{catalog_id}/batch.