Introducción a Content API

  • Artículo

Para usar Content API, necesitará un par de cosas:

  1. Una cuenta de Microsoft
  2. Una cuenta de Microsoft Advertising
  3. Un token de desarrollador

Para obtener una cuenta de Microsoft Advertising, vaya a https://ads.microsoft.com. Si no ha iniciado sesión en su cuenta Microsoft, se le redirigirá para que inicie sesión en su cuenta o para registrarse en una. Después de iniciar sesión, tendrá la opción de registrarse para obtener una nueva cuenta de Microsoft Advertising. Seleccione la opción de registro y haga clic en Continuar.

A continuación, si aún no tiene un token de desarrollador de Microsoft Advertising para el entorno de producción, vaya al Portal para desarrolladores. Haga clic en Solicitar token y proporcione la información solicitada. Si usa la API para administrar su propia cuenta, recibirá el token inmediatamente; sin embargo, si está administrando cuentas para otros usuarios, puede tardar hasta cinco días laborables en obtener un token.

Autenticación de las credenciales

Importante

A partir del 1 de junio de 2022, requeriremos la autenticación multifactor para todos los usuarios que inicien sesión a través de una aplicación de terceros que use la API de Bing Ads, content API y las API de Hotel.

Debe actualizar la aplicación para obtener el consentimiento del usuario mediante el nuevo msads.manage ámbito. Todos los desarrolladores de aplicaciones deben realizar acciones para usar el nuevo ámbito.

Para obtener más información, consulte la guía de requisitos de autenticación multifactor .

Content API usa los mismos esquemas de autenticación que Bing Ads API. Para obtener más información sobre cómo autenticar las credenciales de la cuenta de Microsoft con OAuth, consulte Autenticación con el Plataforma de identidad de Microsoft.

Puede usar el SDK de Bing Ads para .NET, Java o Python para autenticar las credenciales de la cuenta de Microsoft. Para obtener más información sobre el uso del SDK para obtener el token de acceso, consulte C# | Java | Python. Para ver un ejemplo de Content API que usa el SDK para la autenticación, consulte Ejemplo de administración de productos.

(Tenga en cuenta que el SDK de Bing Ads no proporciona interfaces para Content API. Solo debe usar el SDK para obtener el token de acceso si también usa el SDK para campañas de Microsoft Advertising. De lo contrario, puede que no valga la pena la sobrecarga de instalar el SDK).

Si no usa el SDK de Bing Ads para la autenticación, consulte Autenticación de credenciales de cuenta microsoft en C# para ver un ejemplo que muestra cómo usar OAuth para autenticar las credenciales de la cuenta microsoft.

¿Dónde usar las credenciales y los tokens de desarrollador?

Todas las llamadas deben especificar:

  • Encabezado DeveloperToken establecido en el token de desarrollador.
  • Encabezado AuthenticationToken establecido en el token de acceso.

Si administra catálogos en nombre de otros clientes, también debe establecer los encabezados siguientes:

  • Encabezado CustomerId que se establece en el identificador de cliente del cliente cuya tienda está administrando
  • Encabezado CustomerAccountId que se establece en el identificador de cuenta de cualquiera de las cuentas del cliente que administre (no importa qué cuenta administrada).

Para obtener información sobre estos y otros encabezados que la solicitud y la respuesta pueden contener, vea Encabezados.

Configuración de Microsoft Merchant Center para usar la API

Para obtener información general sobre Microsoft Merchant Center (MMC), consulte ¿Qué es Microsoft Merchant Center? El tema incluye vínculos a todos los temas de Merchant Center y vídeos relacionados.

Si aún no lo ha hecho, debe completar los pasos siguientes.

  1. Comprobación y reclamación de la dirección URL del sitio web Para obtener las herramientas de webmaster mencionadas en Comprobar y reclamar la dirección URL de su sitio web, consulte Bing Webmaster Tools. Inicie sesión con la misma cuenta de Microsoft que usa para Microsoft Advertising. Para obtener más información sobre el uso de la herramienta, consulte Comprobación de la propiedad de su sitio web.
  2. Creación de una tienda de Microsoft Merchant Center
  3. Adición de un catálogo

Al crear un almacén MMC, el proceso crea un catálogo predeterminado automáticamente. El almacén y todos los catálogos que cree se habilitan automáticamente para API Management. El almacén contiene un catálogo predeterminado al que se aplican todas las operaciones de producto (agregar, actualizar, eliminar y obtener) de forma predeterminada. Para especificar un catálogo diferente, use el parámetro de consulta bmc-catalog-id en la dirección URL del recurso.

Para agregar y habilitar catálogos, use el recurso Catálogos . Para obtener más información, consulte Administración de los catálogos.

Nota:

En determinadas circunstancias, puede usar la API y FTP/SFTP para actualizar una fuente de catálogo. Para obtener información sobre el uso de la API con FTP/SFTP, consulte ¿Puedo usar la API y FTP/SFTP?

Pasos siguientes

Ahora que está listo para empezar a usar la API, consulte las secciones siguientes.