Encabezados de respuesta y solicitud XML de SOAP

Esta página brinda información sobre los encabezados de solicitud SOAP XML requeridos y los encabezados que se muestran en respuesta.

Encabezados de solicitud obligatorios

Todas las llamadas SOAP a la API deben tener un elemento <RequestHeader> en el encabezado. este elemento se define en todos los WSDL del servicio. Las bibliotecas cliente proporcionan métodos para agregar este encabezado por ti, con los valores que proporciones. A continuación, se incluye una descripción de todos los elementos de <RequestHeader>:

Elemento Descripción
<networkCode>

Es el código de red de la red a la que se dirige. Los códigos de red son obligatorios cuando se realizan todas las solicitudes, excepto NetworkService.getAllNetworks() y NetworkService.makeTestNetwork().

Asegúrate de usar solo un código de red disponible para el acceso a tu cuenta. Encontrarás el código en el sitio web de Google Ad Manager de tu cuenta en Administrador > Configuración de red junto a "Código de red".
<applicationName> Es un nombre de cadena arbitrario que identifica tu aplicación. Esta información se mostrará en los archivos de registro de Google. Por ejemplo, “Mi aplicación de inventario” o “App_1”.

Nota: Cada solicitud que envía tu aplicación a la API de Ad Manager debe incluir un token de acceso de OAuth2. Pasa el token en el encabezado HTTP como: Authorization: Bearer YOUR_ACCESS_TOKEN.

Ejemplo de solicitud

El siguiente código es un ejemplo de una llamada de solicitud SOAP a getAdUnitsByStatement() que busca el AdUnit raíz.

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope
        xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header>
    <ns1:RequestHeader
         soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next"
         soapenv:mustUnderstand="0"
         xmlns:ns1="https://www.google.com/apis/ads/publisher/v202508">
      <ns1:networkCode>123456</ns1:networkCode>
      <ns1:applicationName>DfpApi-Java-2.1.0-dfp_test</ns1:applicationName>
    </ns1:RequestHeader>
  </soapenv:Header>
  <soapenv:Body>
    <getAdUnitsByStatement xmlns="https://www.google.com/apis/ads/publisher/v202508">
      <filterStatement>
        <query>WHERE parentId IS NULL LIMIT 500</query>
      </filterStatement>
    </getAdUnitsByStatement>
  </soapenv:Body>
</soapenv:Envelope>

Nota: Si tu solicitud de SOAP genera una Unmarshalling error, consulta Errores comunes y obtén sugerencias para solucionar problemas.

Encabezados de respuesta

Todas las respuestas que muestra la API incluyen los siguientes elementos de encabezado. Como práctica recomendada, te sugerimos que registres estos valores.

Elemento Descripción
<requestId> Identifica esta solicitud de forma única. Si tienes algún problema con la asistencia, envíanos este ID para que podamos encontrar tu solicitud más fácilmente.
<responseTime> Es el tiempo transcurrido entre el momento en que el servicio web recibe la solicitud y el momento en que envía la respuesta.

Respuesta de ejemplo

El siguiente código muestra un ejemplo de una respuesta SOAP para la solicitud anterior.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <ResponseHeader xmlns="https://www.google.com/apis/ads/publisher/v202508">
      <requestId>xxxxxxxxxxxxxxxxxxxx</requestId>
      <responseTime>1063</responseTime>
    </ResponseHeader>
  </soap:Header>
  <soap:Body>
    <getAdUnitsByStatementResponse xmlns="https://www.google.com/apis/ads/publisher/v202508">
      <rval>
        <totalResultSetSize>1</totalResultSetSize>
        <startIndex>0</startIndex>
        <results>
          <id>2372</id>
          <name>RootAdUnit</name>
          <description></description>
          <targetWindow>TOP</targetWindow>
          <status>ACTIVE</status>
          <adUnitCode>1002372</adUnitCode>
          <inheritedAdSenseSettings>
            <value>
              <adSenseEnabled>true</adSenseEnabled>
              <borderColor>FFFFFF</borderColor>
              <titleColor>0000FF</titleColor>
              <backgroundColor>FFFFFF</backgroundColor>
              <textColor>000000</textColor>
              <urlColor>008000</urlColor>
              <adType>TEXT_AND_IMAGE</adType>
              <borderStyle>DEFAULT</borderStyle>
              <fontFamily>DEFAULT</fontFamily>
              <fontSize>DEFAULT</fontSize>
            </value>
          </inheritedAdSenseSettings>
        </results>
      </rval>
    </getAdUnitsByStatementResponse>
  </soap:Body>
</soap:Envelope>