Artigos e publicações do catálogo de produtos

A borda de Artigos e publicações do catálogo de produtos permite que você liste e crie itens de artigos e publicações (ebooks, audiolivros, revistas, jornais e outros conteúdos escritos) em um catálogo de produtos.

Permissões

Para usar esta API, o app precisa da seguinte permissão:

  • catalog_management

Leitura

Para listar itens de artigos e publicações em um catálogo, envie uma solicitação GET:

GET /v25.0/{product-catalog-id}/articles_and_publications HTTP/1.1
Host: graph.facebook.com

Parâmetros

ParâmetroTipoDescrição

filter

string

Opcional. Regra de filtro WCA codificada em JSON para filtrar artigos e publicações. Por exemplo: {"publication_category":{"eq":"Book"}}. Confira Conjunto de produtos para ver a lista completa de operadores de filtro.

summary

booliano

Opcional. Quando true, inclui um objeto summary com total_count na resposta.

limit

número inteiro

Opcional. Número máximo de itens que serão retornados por página.

before

string

Opcional. Cursor para paginação inversa.

after

string

Opcional. Cursor para paginação encaminhada.

Campos

A leitura a partir dessa borda retornará um resultado no formato JSON:

{
  "data": [],
  "paging": {},
  "summary": {}
}

data

Uma lista de nós de Artigos e publicações. Confira a referência de artigos e publicações para ver a lista completa de campos.

paging

Para obter mais detalhes sobre paginação, consulte o guia da Graph API.

summary

Informações agregadas sobre a borda, como contagens. Especifique summary=true como um parâmetro de consulta para incluir isso na resposta.

CampoTipoDescrição

total_count

número inteiro

Número total de itens no catálogo.

Criação

Para criar um item de artigo ou publicação em um catálogo, envie uma solicitação POST:

POST /v25.0/{product-catalog-id}/articles_and_publications HTTP/1.1
Host: graph.facebook.com
Content-Type: application/json

{
  "retailer_id": "pub-001",
  "name": "The Art of Modern Architecture",
  "description": "An insightful guide exploring contemporary architectural design",
  "image_url": "https://example.com/book-cover.jpg",
  "url": "https://example.com/art-of-modern-architecture",
  "publication_category": "Book",
  "author": ["Jane Smith"],
  "genre": ["Architecture", "Design"]
}

Parâmetros

Estes campos são obrigatórios: retailer_id, name, description, image_url, url. Todos os outros campos são opcionais.

Para ver a lista completa de campos compatíveis, veja o nó Artigos e publicações – Campos.

Resposta

{
  "id": "1234567890"
}

Atualização

Não é possível executar essa operação nesse nó. Para atualizar itens individuais de artigos ou publicações, use o nó Artigos e publicações.

Exclusão

Não é possível executar essa operação nesse nó. Para excluir artigos ou itens de publicação específicos, use o nó Artigos e publicações.