Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Para usar la API de contenido, necesitará un par de cosas:
- Una cuenta de Microsoft
- Una cuenta de Microsoft Advertising
- Un token de desarrollador
Para obtener una cuenta de Microsoft Advertising, ve a https://ads.microsoft.com. Si no has iniciado sesión en tu cuenta de Microsoft, se te redirigirá para que inicies sesión en tu cuenta o para que te registres para obtener una. Después de iniciar sesión, tendrás la opción de registrarte 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 tienes un token de desarrollador de Microsoft Advertising para el entorno de producción, ve al Portal para desarrolladores. Haga clic en Request Token y proporcione la información solicitada. Si usa la API para administrar su propia cuenta, recibirá su token de inmediato; Sin embargo, si administra cuentas de otros usuarios, la obtención de un token puede tardar hasta cinco días laborables.
Autenticando sus 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, la API de contenido y las API de hotel.
Debe actualizar la aplicación para obtener el consentimiento del usuario con el nuevo msads.manage ámbito. Todos los desarrolladores de aplicaciones deben tomar medidas para usar el nuevo ámbito.
Para obtener más información, consulte la guía de requisitos de autenticación multifactor .
La API de contenido utiliza los mismos esquemas de autenticación que la API de Bing Ads. Para obtener más información sobre cómo autenticar las credenciales de la cuenta de Microsoft con OAuth, consulte Autenticación con la Plataforma de identidad de Microsoft.
Puedes 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 cómo usar el SDK para obtener el token de acceso, consulte C# | Java | Python. Para ver un ejemplo de API de contenido que usa el SDK para la autenticación, consulte Ejemplo de administración de productos.
(Ten en cuenta que el SDK de Bing Ads no proporciona interfaces para la API de contenido. Solo debes usar el SDK para obtener el token de acceso si también usas el SDK para las campañas de Microsoft Advertising. De lo contrario, puede que no merezca la pena la sobrecarga de instalar el SDK).
Si no usa el SDK de Bing Ads para la autenticación, consulte Autenticar las credenciales de la cuenta de Microsoft en C# para ver un ejemplo que muestra cómo usar OAuth para autenticar las credenciales de la cuenta de Microsoft.
¿Dónde usar las credenciales y los tokens de desarrollador?
Todas las llamadas deben especificar:
- El encabezado DeveloperToken que está establecido en su token de desarrollador.
- El encabezado AuthenticationToken que está establecido en el token de acceso.
Si administra catálogos en nombre de otros clientes, también debe establecer los encabezados siguientes:
- El encabezado CustomerId que está establecido en el id. de cliente del cliente cuya tienda está administrando
- El encabezado CustomerAccountId que se establece en el id. de cuenta de cualquiera de las cuentas de cliente que administras (no importa qué cuenta administrada).
Para obtener información sobre estos y otros encabezados que pueden contener la solicitud y la respuesta, consulte Encabezados.
Configuración de Centro de comerciantes de Microsoft para usar la API
Para obtener información general sobre Centro de comerciantes de Microsoft (MMC), consulte ¿Qué es Centro de comerciantes de Microsoft? El tema incluye vínculos a todos los temas de Merchant Center y vídeos relacionados.
Debes completar los pasos siguientes si aún no lo has hecho.
- Verifica y reclama la URL de tu sitio web Para obtener las herramientas de administrador web mencionadas en Comprobar y reclamar la dirección URL de su sitio web, consulte Herramientas para administradores web de Bing. Inicia sesión con la misma cuenta de Microsoft que usas para Microsoft Advertising. Para obtener más información sobre el uso de la herramienta, consulte Verificar la propiedad de su sitio web.
- Crear una tienda de Centro de comerciantes de Microsoft
- Agregar un catálogo
Al crear una tienda 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 la administración de API. El almacén contiene un catálogo predeterminado al que se aplican todas las operaciones de productos (agregar, actualizar, eliminar y obtener) de forma predeterminada. Para especificar un catálogo diferente, utilice el parámetro de consulta bmc-catalog-id en la URL del recurso.
Para agregar y habilitar catálogos, utilice el recurso Catálogos . Para obtener más información, consulte Administración de los catálogos.
Nota:
En determinadas circunstancias, puedes 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 siguientes secciones.