Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Per utilizzare l'API dei contenuti, sono necessarie un paio di cose:
- Un account Microsoft
- Un account Microsoft Advertising
- Un token sviluppatore
Per ottenere un account Microsoft Advertising, vai a https://ads.microsoft.com. Se non hai effettuato l'accesso al tuo account Microsoft, verrai reindirizzato ad accedere al tuo account o a registrarti per uno. Dopo l'accesso, avrai la possibilità di iscriverti per un nuovo account Microsoft Advertising. Seleziona l'opzione di iscrizione e fai clic su Continua.
Se non si dispone già di un token sviluppatore di Microsoft Advertising per l'ambiente di produzione, passare al portale per sviluppatori. Fare clic su Richiedi token e fornire le informazioni richieste. Se usi l'API per gestire il tuo account, riceverai immediatamente il token; Tuttavia, se gestisci 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 utilizza l'API Bing Ads, l'API contenuti 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 dell'autenticazione a più fattori .
L'API dei contenuti utilizza gli stessi schemi di autenticazione dell'API di Bing Ads. Per informazioni dettagliate sull'autenticazione delle credenziali dell'account Microsoft con OAuth, vedere Autenticazione con 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 C# | Java | Python. Per un esempio di API di contenuti che utilizza l'SDK per l'autenticazione, consulta 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 Microsoft Advertising. In caso contrario, potrebbe non valere il sovraccarico dell'installazione dell'SDK.)
Se non si utilizza Bing Ads SDK per l'autenticazione, vedere Autenticazione delle credenziali dell'account Microsoft in C# per un esempio che illustra come utilizzare OAuth per autenticare le credenziali dell'account Microsoft.
Dove usare le credenziali e i token sviluppatore?
Tutte le chiamate devono specificare:
- L'intestazione DeveloperToken impostata sul token sviluppatore.
- L'intestazione AuthenticationToken impostata sul token di accesso.
Se si gestiscono cataloghi per conto di altri clienti, è inoltre necessario impostare le intestazioni seguenti:
- L'intestazione CustomerId impostata sull'ID cliente del cliente di cui si sta gestendo il negozio
- L'intestazione CustomerAccountId impostata sull'ID account di qualsiasi account del cliente gestito (indipendentemente dall'account gestito).
Per informazioni su queste e altre intestazioni eventualmente contenute nella richiesta e nella risposta, vedere Intestazioni.
Configurazione di Microsoft Merchant Center per l'utilizzo 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 lo hai già fatto, devi completare i passaggi seguenti.
- Verificare e richiedere l'URL del tuo sito Web Per ottenere gli strumenti webmaster menzionati in Verificare e richiedere l'URL del sito Web, vedere Strumenti Webmaster di Bing. Accedi con lo stesso account Microsoft che usi per Microsoft Advertising. Per ulteriori informazioni sull'utilizzo dello strumento, vedere Verificare la proprietà del sito Web.
- Creare un negozio di Microsoft Merchant Center
- Aggiungere un catalogo
Quando si crea un negozio MMC, il processo crea automaticamente un catalogo predefinito. Il negozio e tutti i cataloghi creati vengono abilitati automaticamente per la gestione delle API. L'archivio contiene un catalogo predefinito a cui tutte le operazioni di prodotto (add, update, delete e get) vengono applicate per impostazione predefinita. Per specificare un catalogo diverso, usare il parametro di query bmc-catalog-id nell'URL della risorsa.
Per aggiungere e abilitare cataloghi, utilizzare la risorsa Cataloghi . Per ulteriori informazioni, consulta Gestione dei cataloghi.
Nota
In determinate circostanze, è possibile utilizzare l'API e FTP/SFTP per aggiornare un feed del catalogo. Per informazioni sull'utilizzo dell'API con FTP/SFTP, vedere È possibile utilizzare l'API e FTP/SFTP?
Operazioni successive
Ora che sei pronto per iniziare a usare l'API, vedi le sezioni seguenti.