SOAP XML İsteği ve Yanıt Başlıkları

Bu sayfada, gerekli SOAP XML istek üstbilgileri ve yanıt olarak döndürülen üstbilgiler hakkında bilgi verilmektedir.

Gerekli İstek Başlıkları

Tüm API SOAP çağrılarında başlıkta bir <RequestHeader> öğesi bulunmalıdır. Bu öğe tüm hizmet WSDL'lerinde tanımlanır. İstemci kitaplıkları size yöntemlerinden birini kullanarak sizin yerinize bu başlığı sizin için ekleyebilir. <RequestHeader> ile ilgili tüm öğelerin açıklamasını burada bulabilirsiniz:

Öğe Açıklama
<networkCode>

Gönderilmekte olan ağın ağ kodu. NetworkService.getAllNetworks() ve NetworkService.makeTestNetwork() dışındaki tüm istekler için ağ kodları gereklidir.

Yalnızca hesap girişiniz için kullanılabilir olan ağ kodunu kullandığınızdan emin olun. Kodu, hesabınızın Google Ad Manager web sitesinde, Yönetici > Ağ Ayarları sayfasında "Ağ kodu"nun yanında bulabilirsiniz.
<applicationName> Uygulamanızı tanımlayan rastgele bir dize adı. Bu durum Google'ın günlük dosyalarında gösterilir. Örneğin: "Envanterim Uygulama" veya "Uygulama_1".

Not: Uygulamanızın Ad Manager API'sine gönderdiği her istek bir OAuth2 erişim jetonu içermelidir. Jetonu HTTP üstbilgisinde şu şekilde iletin: Authorization: Bearer YOUR_ACCESS_TOKEN.

Örnek İstek

Aşağıdaki kod, kök AdUnit adresini arayan getAdUnitsByStatement() işlevine yönelik bir SOAP istek çağrısı örneğidir.

<?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>

Not: SOAP isteğiniz Unmarshalling error hatasına neden oluyorsa sorun giderme ipuçları için Yaygın Hatalar başlıklı makaleyi inceleyin.

Yanıt Başlıkları

API'nin döndürdüğü tüm yanıtlar aşağıdaki başlık öğelerini içerir. Farklı en iyi uygulama olarak bu değerleri günlüğe kaydetmenizi öneririz.

Öğe Açıklama
<requestId> Bu isteği benzersiz bir şekilde tanımlar. Destekle ilgili bir sorununuz varsa bu kimliği kullanmanız, isteğinizi daha kolay bulmamızı sağlar.
<responseTime> Web hizmetinin isteği alması ile isteği göndermesi arasında geçen süre tıklayın.

Örnek Yanıt

Aşağıdaki kodda, önceki istek için bir SOAP yanıtı örneği gösterilmektedir.

<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>