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

Bu sayfada, gerekli SOAP XML istek başlıkları ve yanıt olarak döndürülen başlıklar hakkında bilgi verilmektedir.

Gerekli İstek Başlıkları

Tüm API SOAP çağrılarının başlığında <RequestHeader> öğesi olmalıdır; bu öğe tüm hizmet WSDL'lerinde tanımlanır. İstemci kitaplıkları size yöntemlerinden birini kullanarak bu üstbilgiyi 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 yapılırken ağ kodları gerekir.

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ğ kodu"nun yanındaki Ağ Ayarları sayfasını açın.
<applicationName> Uygulamanızı tanımlayan rastgele bir dize adı. Bu bilgiler Google'ın günlük dosyalarında gösterilecektir. Örneğin: "Envanterim Uygulama" veya "Uygulama_1".

Not: Uygulamanızın Ad Manager API'sine gönderdiği her isteğin bir OAuth2 erişim jetonu içermesi gerekir. HTTP üstbilgisindeki jetonu Authorization: Bearer YOUR_ACCESS_TOKEN olarak iletin.

Ö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/v202408">
      <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/v202408">
      <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/v202408">
      <requestId>xxxxxxxxxxxxxxxxxxxx</requestId>
      <responseTime>1063</responseTime>
    </ResponseHeader>
  </soap:Header>
  <soap:Body>
    <getAdUnitsByStatementResponse xmlns="https://www.google.com/apis/ads/publisher/v202408">
      <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>