Introduzione all'API Contenuto

  • Articolo

Per usare l'API Contenuto, sono necessari alcuni elementi:

  1. Un account Microsoft
  2. Un account Microsoft Advertising
  3. Un token per sviluppatori

Per ottenere un account Microsoft Advertising, passare a https://ads.microsoft.com. Se non si è connessi all'account Microsoft, si viene reindirizzati all'accesso all'account o all'iscrizione. Dopo l'accesso, sarà possibile iscriversi per un nuovo account Microsoft Advertising. Selezionare l'opzione di iscrizione e fare clic su Continua.

Quindi, se non si dispone già di un token per sviluppatori Microsoft Advertising per l'ambiente di produzione, passare al portale per sviluppatori. Fare clic su Richiedi token e specificare le informazioni richieste. Se si usa l'API per gestire il proprio account, si riceverà immediatamente il token. tuttavia, se si gestiscono account per altri utenti, potrebbero essere necessari fino a cinque giorni lavorativi per ottenere un token.

Autenticazione delle credenziali

Importante

A partire dal 1° giugno 2022 sarà necessaria l'autenticazione a più fattori per tutti gli utenti che accedono tramite un'applicazione di terze parti che usa l'API Bing Ads, l'API Contenuto e le API Hotel.

È necessario aggiornare l'applicazione per ottenere il consenso dell'utente usando il nuovo msads.manage ambito. Tutti gli sviluppatori di applicazioni devono intervenire per usare il nuovo ambito.

Per altre informazioni, vedere la guida ai requisiti per l'autenticazione a più fattori .

L'API contenuto usa gli stessi schemi di autenticazione dell'API Bing Ads. Per informazioni dettagliate sull'autenticazione delle credenziali dell'account Microsoft con OAuth, vedere Autenticazione con il Microsoft Identity Platform.

È possibile usare Bing Ads SDK per .NET, Java o Python per autenticare le credenziali dell'account Microsoft. Per informazioni dettagliate sull'uso dell'SDK per ottenere il token di accesso, vedere Python Java C# | | . Per un esempio di API Contenuto che usa l'SDK per l'autenticazione, vedere Esempio di gestione dei prodotti.

Si noti che Bing Ads SDK non fornisce interfacce per l'API Contenuto. È consigliabile usare l'SDK per ottenere il token di accesso solo se si usa l'SDK anche per le campagne di Microsoft Advertising. In caso contrario, potrebbe non valere la pena di installare l'SDK.

Se non si usa Bing Ads SDK per l'autenticazione, vedere Autenticazione delle credenziali dell'account Microsoft in C# per un esempio che illustra come usare OAuth per autenticare le credenziali dell'account Microsoft.

Dove usare le credenziali e i token per sviluppatori?

Tutte le chiamate devono specificare:

  • Intestazione DeveloperToken impostata sul token di sviluppo.
  • Intestazione AuthenticationToken impostata sul token di accesso.

Se si gestiscono cataloghi per conto di altri clienti, è necessario impostare anche le intestazioni seguenti:

  • Intestazione CustomerId impostata sull'ID cliente del cliente di cui si sta gestendo il negozio
  • Intestazione CustomerAccountId impostata sull'ID account di uno degli account del cliente gestiti (non importa quale account gestito).

Per informazioni su queste e altre intestazioni che la richiesta e la risposta possono contenere, vedere Intestazioni.

Configurazione di Microsoft Merchant Center per l'uso dell'API

Per una panoramica di Microsoft Merchant Center (MMC), vedere Che cos'è Microsoft Merchant Center? L'argomento include collegamenti a tutti gli argomenti di Merchant Center e ai video correlati.

Se non è già stato fatto, è necessario completare i passaggi seguenti.

  1. Verificare e richiedere l'URL del sito Web Per ottenere gli strumenti webmaster indicati in Verificare e richiedere l'URL del sito Web, vedere Strumenti Webmaster Bing. Accedere con lo stesso account Microsoft usato per Microsoft Advertising. Per altre informazioni sull'uso dello strumento, vedere Verificare la proprietà del sito Web.
  2. Creare un archivio Microsoft Merchant Center
  3. Aggiungere un catalogo

Quando si crea un archivio MMC, il processo crea automaticamente un catalogo predefinito. L'archivio e tutti i cataloghi creati vengono abilitati automaticamente per la gestione delle API. L'archivio contiene un catalogo predefinito a cui tutte le operazioni del prodotto (aggiunta, aggiornamento, eliminazione e recupero) si applicano per impostazione predefinita. Per specificare un catalogo diverso, usare il parametro di query bmc-catalog-id nell'URL della risorsa.

Per aggiungere e abilitare i cataloghi, usare la risorsa Cataloghi . Per altre informazioni, vedere Gestione dei cataloghi.

Nota

In determinate circostanze, è possibile usare l'API e FTP/SFTP per aggiornare un feed di catalogo. Per informazioni sull'uso dell'API con FTP/SFTP, vedere È possibile usare l'API e FTP/SFTP?

Operazioni successive

Ora che si è pronti per iniziare a usare l'API, vedere le sezioni seguenti.