Risorsa Cataloghi

La risorsa Cataloghi consente di gestire i cataloghi in Microsoft Merchant Center Store (MMC). Per informazioni sull'uso delle risorse cataloghi, vedere Gestione dei cataloghi. Per esempi che illustrano come aggiungere, eliminare e ottenere cataloghi, vedere Esempi di codice.

Base URI

Di seguito è riportato l'URI di base a cui si aggiungono i modelli.

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

Modelli

Per creare gli endpoint usati per gestire i cataloghi, aggiungere il modello appropriato all'URI di base.

Modello	Verbo HTTP	Descrizione	Risorsa
{mmcMerchantId}/catalogs	POST	Usare per aggiungere un catalogo all'archivio. Per aggiungere un catalogo, il nome deve essere univoco. È possibile aggiungere un massimo di 100 cataloghi a un archivio. Impostare sull'ID {mmcMerchantId} archivio MMC.	Richiesta: Catalogo Risposta: Catalogo
{mmcMerchantId}/catalogs/{catalogId}	PUT	Usare per aggiornare un catalogo nell'archivio. Gli unici campi che è possibile aggiornare sono i name campi e isPublishingEnabled ed è necessario specificare entrambi. Impostare sull'ID {mmcMerchantId} archivio MMC.	Richiesta: Catalogo Risposta: Catalogo
{mmcMerchantId}/catalogs/{catalogId}	ELIMINA	Usare per eliminare un catalogo dall'archivio. Impostare sull'ID {mmcMerchantId} archivio MMC. Impostare sull'ID {catalogId} del catalogo.	Richiesta: N/D Risposta: N/D
{mmcMerchantId}/catalogs/{catalogId}	GET	Usare per ottenere un catalogo dall'archivio. Impostare sull'ID {mmcMerchantId} archivio MMC. Impostare sull'ID {catalogId} del catalogo.	Richiesta: N/D Risposta: Catalogo
{mmcMerchantId}/catalogs	GET	Usare per ottenere un elenco di cataloghi dall'archivio. Impostare sull'ID {mmcMerchantId} archivio MMC.	Richiesta: N/D Risposta: cataloghi

Parametri di query

Gli endpoint possono includere i parametri di query seguenti.

Parametro	Descrizione
Alt	Facoltativo. Usare per specificare il tipo di contenuto usato nella richiesta e nella risposta. I valori possibili sono json e xml. Il valore predefinito è json.

Intestazioni

Di seguito sono riportate le intestazioni di richiesta e risposta.

Intestazione	Descrizione
AuthenticationToken	Intestazione della richiesta. Impostare questa intestazione su un token di autenticazione OAuth. Per informazioni su come ottenere un token, vedere Autenticazione delle credenziali.
Content-Location	Intestazione della risposta. URL che identifica l'archivio in cui è stato inserito il catalogo. Questa intestazione è inclusa nella risposta di una richiesta Insert.
CustomerAccountId	Intestazione della richiesta. ID account di uno degli account gestiti per conto del cliente specificato nell'intestazione CustomerId . Non importa quale account specificare. Specificare questa intestazione solo se si gestisce un account per conto del cliente.
Customerid	Intestazione della richiesta. ID cliente del cliente di cui si gestisce il negozio. Specificare questa intestazione solo se si gestisce lo store per conto del cliente. Se si imposta questa intestazione, è necessario impostare anche l'intestazione CustomerAccountId .
DeveloperToken	Intestazione della richiesta. Token di accesso per sviluppatori dell'applicazione client. Ogni richiesta deve includere questa intestazione. Per informazioni su come ottenere un token, vedere Le credenziali di Microsoft Advertising e il token per sviluppatori sono disponibili?
Posizione	Intestazione della risposta. URL che identifica l'archivio in cui è stato inserito il catalogo. Questa intestazione è inclusa nella risposta di una richiesta Insert.
WebRequestActivityId	Intestazione della risposta. ID della voce di log che contiene i dettagli sulla richiesta. È consigliabile acquisire sempre questo ID se si verifica un errore. Se non si è in grado di determinare e risolvere il problema, includere questo ID insieme alle altre informazioni fornite al team di supporto.

Oggetti richiesta e risposta

Di seguito sono riportati gli oggetti richiesta e risposta usati dall'API.

Ogni oggetto definisce il nome della chiave JSON e il nome dell'elemento XML usati a seconda del tipo di contenuto specificato per la richiesta.

Oggetto	Descrizione
Catalogo	Definisce un catalogo.
Cataloghi	Definisce l'elenco dei cataloghi.

Catalogo

Definisce un catalogo.

Name	Valore	Tipo	Nome elemento XML
Id	ID che identifica in modo univoco il catalogo nell'archivio. Questo campo è di sola lettura; non impostare questo campo.	Long senza segno	<Id>
Isdefault	Valore booleano che determina se il catalogo è il catalogo predefinito dell'archivio. È true se il catalogo è il catalogo predefinito dell'archivio; in caso contrario, false. Quando si crea un negozio, si ottiene un catalogo predefinito in cui vengono scritti i prodotti se non si specifica un altro catalogo. Questo campo è di sola lettura; non impostare questo campo.	Booleano	<is_default>
isPublishingEnabled	Valore booleano che determina se Microsoft può pubblicare prodotti dal catalogo. Impostare su true se Microsoft può pubblicare prodotti dal catalogo; in caso contrario, impostarlo su false. È possibile aggiornare questo campo. È anche possibile usare questo campo per testare l'applicazione prima di distribuirla nell'ambiente di produzione. Impostando questo campo su false, è possibile effettuare chiamate a Products Resource senza modificare o pubblicare i dati di produzione.	Booleano	<is_publishing_enabled>
Mercato	Il mercato in cui vengono pubblicati i prodotti nel catalogo. NOTA: Non tutti hanno ancora questa funzionalità. Se non lo fai, non preoccuparti, è presto disponibile!. Di seguito sono riportati i possibili mercati che è possibile specificare. Albania, albanese (sq-AL) Andorra, francese (fr-AD) Argentina, spagnolo (es-AR) Aruba, inglese (en-AW) Australia, inglese (en-AU) Austria, tedesco (de-AT) Bahamas, inglese (en-BS) Bangladesh, inglese (en-BD) Belgio, Olandese (nl-BE) Belgio, Francese (fr-BE) Bolivia, spagnolo (es-BO) Bosnia ed Erzegovina, bosniaco (bs-BA) Brasile, portoghese (pt-BR) Brunei, inglese (en-BN) Bulgaria, bulgaro (bg-BG) Canada, inglese (en-CA) Canada, francese (fr-CA) Isole Cayman, inglese (en-KY) Cile, spagnolo (es-CL) Colombia, spagnolo (es-CO) Costa Rica, spagnolo (es-CR) Croazia, Croato (hr-HR) Cipro, inglese (en-CY) Cipro, greco (el-CY) Repubblica Ceca, Ceco (cs-CZ) Danimarca, Danese (da-DK) Dominica, inglese (en-DM) Repubblica Dominicana, Spagnolo (es-DO) Ecuador, spagnolo (es-EC) El Salvador, spagnolo (es-SV) Estonia, estone (et-EE) Figi, Inglese(en-FJ) Finlandia, Finlandese (fi-FI) Francia, inglese (en-FR) Francia, Francese (fr-FR) Guyana francese, francese (fr-GF) Polinesia francese, francese (fr-PF) Germania, inglese (en-DE) Germania, tedesco (de-DE) Grecia, inglese (en-GR) Grecia, greco (el-GR) Guam, inglese (en-GU) Guatemala, spagnolo (es-GT) Guyana, inglese (en-GY) Haiti, francese (fr-HT) Honduras, spagnolo (es-HN) Hong Kong SAR, Cinese tradizionale (zh-HK) Ungheria, inglese (en-HU) Ungheria, ungherese (hu-HU) Islanda, Islandese (is-IS) India, inglese (en-IN) Indonesia, inglese (en-ID) Irlanda, inglese (en-IE) Italia, inglese (en-IT) Italia, italiano (it-IT) Giappone, giapponese (ja-JP) Lettonia, Lettone (lv-LV) Liechtenstein, tedesco (de-LI) Lituania, Lituano (lt-LT) Lussemburgo, francese (fr-LU) Lussemburgo, tedesco (de-LU) Malaysia, inglese (en-MY) Maldive, inglese (en-MV) Malta, Malta (mt-MT) Martinica, francese (fr-MQ) Messico, spagnolo (es-MX) Monaco, francese (fr-MC) Mongolia, inglese (en-MN) Montenegro, inglese (en-ME) Montenegro, Serbo (sr-ME) Montserrat, inglese (en-MS) Nepal, inglese (en-NP) Paesi Bassi, Olandese (nl-NL) Paesi Bassi, inglese (el-NL) Nuova Caledonia, francese (fr-NC) Nuova Zelanda, inglese (en-NZ) Macedonia del Nord, macedone (mk-MK) Norvegia, norvegese (nb-NO) Panama, spagnolo (es-PA) Papua Nuova Guinea, inglese (en-PG) Paraguay, spagnolo (es-PY) Perù, spagnolo (es-PE) Phillippines, inglese (en-PH) Polonia, Polacco (pl-PL) Portogallo, portoghese (pt-PT) Portorico, spagnolo (es-PR) Romania, romeno (ro-RO) San Marino, inglese (en-SM) San Marino, italiano (it-SM) Serbia, inglese (en-RS) Serbia, Serbo (sr-RS) Singapore, inglese (en-SG) Slovacchia, inglese (en-SK) Slovacchia, Slovacco (sk-SK) Slovenia, sloveno (sl-SI) Sudafrica, inglese (en-ZA) Spagna, inglese (en-ES) Spagna, spagnolo (es-ES) Sri Lanka, inglese (en-LK) Svezia, inglese (en-SE) Svezia, Svedese (sv-SE) Svizzera, tedesco (de-CH) Svizzera, francese (fr-CH) Taiwan, Cinese tradizionale (zh-TW) Thailandia, inglese (en-TH) Trinidad e Tobago, inglese (en-TT) Türkiye, Turco (tr-TR) Regno Unito, inglese (en-GB) Stati Uniti, inglese (en-US) Stati Uniti, spagnolo (es-US) Uruguay, spagnolo (es-UY) Città del Vaticano, italiano (it-VA) Venezuela, spagnolo (es-VE) Vietnam, inglese (en-VN) Tutti i prodotti aggiunti al catalogo devono specificare lo stesso mercato (vedere contentLanguage e targetCountry). Non è possibile aggiornare questo campo dopo aver aggiunto il catalogo all'archivio. Nell'elenco precedente de-DE è il valore di mercato specificato; non includere (Tedesco-Germania) nella stringa di mercato.	Stringa	<Mercato>
Nome	Nome del catalogo. Il nome può contenere un massimo di 70 caratteri. È possibile aggiornare questo campo.	Stringa	<Nome>

Cataloghi

Definisce un elenco di cataloghi.

Name	Valore	Tipo	Nome elemento XML
Cataloghi	Elenco di cataloghi nell'archivio.	Catalog[]	<Cataloghi>

Codici di stato HTTP

Le richieste possono restituire i codici di stato HTTP seguenti.

Codice di stato	Descrizione
200	Completato.
201	Aggiunta del catalogo completata.
204	Il catalogo è stato eliminato correttamente.
400	Richiesta non valida. Un valore del parametro di query non è valido o un elemento nel corpo della richiesta non è valido.
401	Non autorizzato. Le credenziali dell'utente non sono valide.
404	Non trovato.
500	Errore del server.