Catalogo prodotti Articoli e pubblicazioni

Il segmento del catalogo prodotti Articoli e pubblicazioni ti consente di mettere in vendita e creare i singoli articoli e le singole pubblicazioni (ebook, audiolibri, riviste, giornali e altri contenuti scritti) in un catalogo prodotti.

Autorizzazioni

Per usare questa API, la tua app ha bisogno della seguente autorizzazione:

  • catalog_management

Lettura

Per mettere in vendita i singoli articoli e le singole pubblicazioni in un catalogo, invia una richiesta GET:

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

Parametri

ParametroTipoDescrizione

filter

stringa

Facoltativo. Regola del filtro WCA con codifica JSON per filtrare articoli e pubblicazioni. Ad esempio: {"publication_category":{"eq":"Book"}}. Consulta Insieme di prodotti per la lista completa degli operatori di filtro.

summary

booleano

Facoltativo. Quando true, include un oggetto summary con total_count nella risposta.

limit

intero

Facoltativo. Numero massimo di articoli da restituire per pagina.

before

stringa

Facoltativo. Cursore per la paginazione all'indietro.

after

stringa

Facoltativo. Cursore per la paginazione in avanti.

Campi

La lettura da questo segmento restituirà un risultato in formato JSON:

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

data

Una lista di nodi Articoli e pubblicazioni. Consulta il riferimento Articoli e pubblicazioni per la lista completa dei campi.

paging

Per maggiori dettagli sulla paginazione, consulta la guida all'API Graph.

summary

Informazioni aggregate sul segmento, ad esempio i conteggi. Specifica summary=true come parametro di query da includere nella risposta.

CampoTipoDescrizione

total_count

intero

Numero totale di articoli nel catalogo.

Creazione

Per creare un articolo o una pubblicazione in un catalogo, invia una richiesta 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"]
}

Parametri

I seguenti campi sono obbligatori: retailer_id, name, description, image_url, url. Tutti gli altri campi sono facoltativi.

Per la lista completa dei campi supportati, consulta il nodo Articoli e pubblicazioni - Campi.

Risposta

{
  "id": "1234567890"
}

Aggiornamento

Non puoi eseguire questa operazione su questo nodo. Per aggiornare singoli articoli o pubblicazioni, usa il nodo Articoli e pubblicazioni.

Eliminazione

Non puoi eseguire questa operazione su questo nodo. Per eliminare singoli articoli o pubblicazioni, usa il nodo Articoli e pubblicazioni.