Bu sayfa, gerekli SOAP XML istek başlıkları ve yanıt olarak döndürülen başlıklar hakkında bilgi sağlar.
Gerekli İstek Başlıkları
Tüm API SOAP çağrılarının başlığında bir <RequestHeader>
öğesi olmalıdır; bu öğe tüm hizmet WSDL'lerinde tanımlanır. İstemci kitaplıkları, sağladığınız değerleri kullanarak bu üst bilgiyi sizin için ekleme yöntemleri sunar. <RequestHeader>
öğesinin tüm öğelerinin açıklamasını burada bulabilirsiniz:
Öğe | Açıklama |
---|---|
<networkCode> |
Ele alınan ağın ağ kodu. Yalnızca hesap girişinizde kullanılabilen bir ağ kodu 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 ad, Google'ın günlük dosyalarında gösterilir. Örneğin: "Envanter Uygulamam" veya "Uygulama_1". |
Not: Uygulamanızın Ad Manager API'ye gönderdiği her istek bir OAuth2 erişim jetonu içermelidir. Jetonu HTTP üst bilgisinde Authorization: Bearer YOUR_ACCESS_TOKEN
olarak iletin.
Aşağıdaki kod, AdUnit
kökünü arayan getAdUnitsByStatement()
için yapılan bir SOAP isteği çağrısına örnektir.
<?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/v202405"> <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/v202405"> <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 Genel Hatalar'a bakın.
Yanıt Başlıkları
API'den döndürülen tüm yanıtlar aşağıdaki başlık öğelerini içerir. En iyi uygulama olarak bu değerleri günlüğe kaydetmenizi öneririz.
Öğe | Açıklama |
---|---|
<requestId> |
Bu isteği benzersiz olarak tanımlar. Destekle ilgili herhangi bir sorununuz olursa bu kimliği bize göndererek isteğinizi daha kolay bulabiliriz. |
<responseTime> |
Web hizmetinin isteği alması ve yanıtı göndermesi arasında geçen süre. |
Örnek Yanıt
Aşağıdaki kod, önceki isteğe ilişkin bir SOAP yanıtı örneğini gösterir.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header> <ResponseHeader xmlns="https://www.google.com/apis/ads/publisher/v202405"> <requestId>xxxxxxxxxxxxxxxxxxxx</requestId> <responseTime>1063</responseTime> </ResponseHeader> </soap:Header> <soap:Body> <getAdUnitsByStatementResponse xmlns="https://www.google.com/apis/ads/publisher/v202405"> <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>