Risorsa Cataloghi

  • Articolo

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} CANCELLARE 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.