Protocolo de servicios de API de Bing Ads

Puede escribir la aplicación de API de Bing Ads en cualquier idioma que admita servicios web. Se define un documento de lenguaje de descripción de servicios web (WSDL) para cada servicio web. WSDL define las operaciones que ofrece un servicio web y el formato de los mensajes de solicitud y respuesta que el cliente envía y recibe de las operaciones. Los mensajes de solicitud y respuesta definen los nombres y tipos de los datos que el cliente intercambia con la operación. Para obtener más información sobre los WSDLs, consulte la especificación WSDL de W3C.

SOAP para Bing Ads API

Bing Ads API admite el protocolo simple de acceso a objetos (SOAP). Algunos lenguajes, como C# y Java, proporcionan herramientas que generan clases de proxy a partir del WSDL. Si el idioma que prefiera no proporciona una herramienta para generar clases de proxy, deberá generar sus propias clases de proxy o sobres SOAP. Para generar las clases de proxy, necesita la dirección web del documento WSDL del servicio que desea usar. El espacio aislado de Microsoft Advertising y los entornos de producción tienen una dirección única. Las direcciones también incluyen el número de versión del WSDL que es específico de una versión principal de la API de Bing Ads. Para ver las direcciones WSDL del servicio de producción y espacio aislado de la versión más reciente de Bing Ads API, consulte Direcciones del servicio web de la API de Bing Ads.

Orden del elemento XML DE SOAP

Cuando se crea un mensaje de solicitud SOAP, el orden de los elementos dentro del cuerpo soap es crítico. Los elementos deben estar en el mismo orden que se define en el lenguaje de descripción de servicios web (WSDL). Si los elementos necesarios están fuera de orden, se producirá un error en la llamada. Si los elementos opcionales están fuera de orden, se puede producir un error en la llamada o se omitirán los elementos. La sintaxis WSDL, que muestra el orden correcto de los elementos, se incluye con cada mensaje de solicitud, mensaje de respuesta y objeto de datos documentados en el contenido de referencia. Además, cada mensaje de solicitud y respuesta muestra un sobre SOAP de ejemplo.

Nota:

XML distingue mayúsculas de minúsculas. Debe usar el caso correcto para los nombres de valor. Los lenguajes de programación fuertemente tipados, como C#, garantizan que tiene el caso correcto antes de poder compilar. Es posible que otros lenguajes no le den un error de compilación si no se usa el caso correcto; sin embargo, se produce un error en el código en tiempo de ejecución.

Éxito parcial

Bing Ads API admite finalizaciones parciales para operaciones de adición, actualización y eliminación; Si se produce un error en uno de los objetos de la lista de objetos que va a agregar, actualizar o eliminar, la operación puede realizarse correctamente para otros usuarios de la colección. Cuando se llama a una operación Get que toma una lista de identificadores, por ejemplo, la operación GetKeywordsByIds y uno de los identificadores de la lista no es válido, la operación se realizará correctamente y el elemento de respuesta correspondiente al identificador de solicitud no válido será nulo.

Actualización parcial

Actualización parcial de Administración de campañas

La actualización parcial se admite para la mayoría de los objetos de datos de administración de campañas, pero no para todos. Por ejemplo, al actualizar la propiedad Text de expandedTextAd , solo necesita especificar los elementos Id y Text . Los elementos de solo lectura, como el estado editorial del anuncio, deben dejarse nulos o vacíos. A menos que se documente explícitamente de otro modo, los elementos opcionales pueden dejarse vacíos y su configuración existente no cambia.

No se admite la actualización parcial para las extensiones de anuncio. Los elementos opcionales que no se envíen con la solicitud de actualización se eliminarán de la extensión de anuncio correspondiente.

Actualización parcial de administración de clientes

El servicio de administración de clientes realiza una actualización completa de las entidades, por lo que, además de las propiedades necesarias documentadas, debe proporcionar valores para todas las propiedades opcionales que no desea que sean nulas o vacías.

Nota:

Una excepción a esta regla es el elemento ForwardCompatibilityMap de cualquier objeto. Por ejemplo, si no proporciona el elemento ForwardCompatibilityMap de AdvertiserAccount, el servicio no actualizará ni anulará ninguna propiedad que, de lo contrario, se habría representado mediante pares de clave y valor.

Almacenar los identificadores de entidad localmente

Debes mantener una tienda local de tu cuenta y entidades de campaña. En concreto, debes almacenar localmente los identificadores de tus cuentas, clientes, campañas, grupos de anuncios y palabras clave. La mayoría de las llamadas requieren el identificador de la entidad. Si almacena el identificador, elimina la llamada necesaria para obtener el identificador.

Por ejemplo, muchas de las llamadas de administración de campañas requieren un identificador de cuenta. Para obtener el identificador de cuenta, puede usar el servicio de administración de clientes. Sin embargo, en lugar de llamar al servicio repetidamente, almacene el identificador de cuenta localmente, para que pueda usarlo en llamadas posteriores.

Administración de la sobrecarga asociada a la realización de llamadas a servicios web

A continuación se muestran los costos generales, en tiempo de procesamiento, asociados a cada llamada de servicio web.

• Establecer una conexión HTTPS al servicio web.
• Autenticación del nombre de usuario y la contraseña.
• Validación del token de desarrollador.

Estos costos se producen tanto si se procesa un solo elemento o un conjunto de posiciones. Para minimizar la sobrecarga, en general, debe intentar procesar tantos elementos en una sola llamada como sea posible. Por ejemplo, en lugar de llamar a UpdateCampaigns para cada campaña que quiera actualizar, llámala solo una vez para varias campañas que quieras actualizar. Para administrar datos a gran escala, especialmente si necesita agregar o actualizar anuncios y palabras clave en varios grupos de anuncios o campañas de una cuenta, debe usar el servicio masivo. El servicio masivo le permite descargar datos como un archivo TSV o CSV, modificarlos según sea necesario y, a continuación, cargar los cambios. Para obtener más información sobre el uso del servicio bulk, consulte Descarga y carga masivas.

Debido a los costos asociados con el establecimiento de una conexión a un servicio web, debe mantener la conexión durante el tiempo que sea necesario. Por ejemplo, si necesita solicitar varios informes, use el mismo objeto de cliente del servicio de informes para todas las llamadas a operaciones del servicio de informes. Cierre explícitamente la conexión cuando ya no necesite el servicio.

Controlar limitación

La limitación del uso de gran volumen mantiene un uso justo para todos los clientes de Microsoft Advertising.

Ad Insight API

Para el servicio Ad Insight, la limitación limita el número de llamadas a la API que cualquier usuario puede realizar en un minuto.

En el nivel de cliente, el número de llamadas que un cliente puede realizar a los datos del cliente está restringido mediante un protocolo deslizante con una ventana de 60 segundos.

Si supera el límite de llamadas de servicio, verá el siguiente error:

• Código de error numérico: 117
• Código de error simbólico: CallRateExceeded
• Mensaje: Ha superado el número de llamadas que puede realizar en un minuto. Reduzca el número de llamadas que realiza por minuto.

Cuando observe este error, puede volver a enviar la solicitud bajo el límite después de esperar 60 segundos.

API masiva

El servicio masivo limita el número de solicitudes que puede realizar a DownloadCampaignsByAccountIds, DownloadCampaignsByCampaignIds y GetBulkUploadUrl. Los detalles de los límites de servicio son internos y están sujetos a cambios.

Si alcanza el límite de llamadas de servicio, verá el siguiente error:

• Código de error numérico: 4204
• Código de error simbólico: BulkServiceNoMoreCallsPermittedForTheTimePeriod
• Mensaje: No se permitirán más llamadas de carga o descarga masivas para esta cuenta durante el período de tiempo actual. Si ha alcanzado el límite de carga masiva, es posible que las operaciones de descarga masiva sigan estando disponibles o viceversa.

Si observa este error, puede volver a enviar la solicitud después de esperar hasta 15 minutos. Para obtener más información, consulte Procedimientos recomendados de descarga masiva y procedimientos recomendados de carga masiva.

Tenga en cuenta también que el límite de tamaño por archivo para la carga masiva en producción es de 100 MB y hasta 4 millones de filas. En espacio aislado , el límite es de 20 000 filas.

API de administración de campañas

Para el servicio Campaign Management, la limitación limita el número de llamadas a la API que cualquier usuario puede realizar en un minuto.

En el nivel de cliente, el número de llamadas que un cliente puede realizar a los datos del cliente está restringido mediante un protocolo deslizante con una ventana de 60 segundos.

Si alcanza el límite de llamadas de servicio, verá el siguiente error:

• Código de error numérico: 117
• Código de error simbólico: CallRateExceeded
• Mensaje: Ha superado el número de llamadas que puede realizar en un minuto. Reduzca el número de llamadas que realiza por minuto.

Cuando observe este error, puede volver a enviar la solicitud bajo el límite después de esperar 60 segundos.

API de informes

El servicio reporting limita el número de solicitudes que puede realizar a SubmitGenerateReportRequest. Los detalles de los límites de servicio son internos y están sujetos a cambios.

Si alcanza el límite de llamadas de servicio, verá el siguiente error:

• Código de error numérico: 207
• Código de error simbólico: ConcurrentRequestOverLimit
• Mensaje: Ya ha alcanzado el número máximo de solicitudes de informe simultáneas. Espere hasta que se completen los informes anteriores e intente enviar una nueva solicitud.

Si observa este error, espere hasta que se completen los informes anteriores e intente enviar una nueva solicitud.

Consulta también

Direcciones del servicio web de la API de Bing Ads
Introducción a la API de Bing Ads