Gestione dei cataloghi
L'API contenuto è un'API RESTful che usa la risorsa Cataloghi per gestire i cataloghi nell'archivio Microsoft Merchant Center (MMC).
Di seguito è riportato l'URI di base usato per chiamare l'API Contenuto.
https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/
Ogni richiesta HTTP deve includere il token di accesso OAuth dell'utente e il token di sviluppo. Per specificare il token di accesso dell'utente, impostare l'intestazione AuthenticationToken . Per specificare il token di sviluppo, impostare l'intestazione DeveloperToken .
Se si gestiscono cataloghi per conto di altri clienti, è necessario impostare:
- L'intestazione CustomerId all'ID cliente del cliente di cui si sta gestendo il negozio.
- L'intestazione CustomerAccountId sull'ID account di uno degli account del cliente gestiti dall'utente (non importa quale account gestito).
Per impostazione predefinita, l'API Contenuto usa oggetti JSON per rappresentare i cataloghi. Per usare XML, impostare il parametro di query alt su XML.
Per informazioni dettagliate sull'uso della risorsa Cataloghi, vedere le sezioni seguenti.
- Recupero di un catalogo dallo store
- Recupero dell'elenco dei cataloghi dallo store
- Eliminazione di un catalogo dall'archivio
- Aggiunta di un catalogo all'archivio
- Aggiornamento di un catalogo nell'archivio
Per un esempio di codice che illustra come ottenere, aggiungere, aggiornare ed eliminare cataloghi, vedere Gestione di esempi di codice cataloghi.
Recupero di un catalogo dallo store
Per ottenere un catalogo dall'archivio, aggiungere il modello seguente all'URI di base.
{bmcMerchantId}/catalogs/{catalogId}
Impostare l'ID {bmcMerchantId} archivio MMC e l'ID{catalogId} del catalogo.
Inviare una richiesta HTTP GET all'URL risultante. Se il catalogo è stato trovato, la risposta contiene un oggetto Catalog che contiene i dettagli del catalogo.
Recupero di un elenco di cataloghi dallo store
Per ottenere un elenco di cataloghi dall'archivio, aggiungere il modello seguente all'URI di base.
{bmcMerchantId}/catalogs
Impostare l'ID {bmcMerchantId} archivio MMC.
Inviare una richiesta HTTP GET all'URL risultante. Se l'archivio contiene cataloghi, la risposta contiene un oggetto Catalogs che contiene l'elenco dei cataloghi.
Eliminazione di un catalogo dall'archivio
Per eliminare un catalogo dall'archivio, aggiungere il modello seguente all'URI di base.
{bmcMerchantId}/catalogs/{catalogId}
Impostare l'ID {bmcMerchantId} archivio MMC e l'ID{catalogId} del catalogo.
Inviare una richiesta HTTP DELETE all'URL risultante. Se il catalogo è stato trovato, viene eliminato.
Aggiunta di un catalogo all'archivio
I cataloghi consentono di raggruppare logicamente i prodotti. Per aggiungere un catalogo all'archivio, aggiungere il modello seguente all'URI di base.
{bmcMerchantId}/catalogs
Impostare l'ID {bmcMerchantId} archivio MMC.
Inviare una richiesta HTTP POST all'URL risultante. Se il catalogo viene aggiunto, la risposta contiene un oggetto Catalog . L'oggetto Catalog include l'ID del catalogo. Usare l'ID per ottenere ed eliminare il catalogo.
Il corpo della richiesta è un oggetto Catalog . È necessario specificare i campi seguenti.
Il nome specificato deve essere univoco all'interno dell'archivio ed è limitato a un massimo di 70 caratteri. Il mercato identifica dove vengono serviti i prodotti. Per un elenco dei mercati supportati, vedere mercato. I prodotti vengono serviti solo se isPublishingEnabled è vero. Per informazioni dettagliate su come usare isPublishingEnabled per testare l'app, vedere Test del codice in sandbox.
Aggiornamento di un catalogo nell'archivio
Per aggiornare un catalogo nell'archivio, aggiungere il modello seguente all'URI di base.
{bmcMerchantId}/catalogs/{catalogId}
Impostare l'ID {bmcMerchantId} archivio MMC e l'ID{catalogId} del catalogo.
Il corpo della richiesta è un oggetto Catalog . È necessario specificare i campi seguenti.
Inviare una richiesta PUT HTTP all'URL risultante. Se il catalogo viene aggiornato, la risposta contiene l'oggetto Catalog aggiornato.