SystemWebService.GetAdvertisingSettings Method 

Returns the advertising settings for a specified user and language.

[C#]
public AdvertisingSettingsValue GetAdvertisingSettings(
   string ownerId,
   string languageCode
);

Parameters

ownerId
The user account ID.
languageCode
The language code.

Return Value

Retrieved advertising settings.

Remarks

The advertising settings supports the inheritance of the language codes. For example: if the user account doesn't have the advertising settings for the language code "de-DE", but have for "de", then "de" advertising settings will be returned. If the advertising settings doesn't exists for "de" too, then the default (with the language code specified as the empty string) advertising settings will be used.

Also supports inheritance through the user accounts tree. If the user doesn't have the advertising settings for specified language code, then the parent account settings will be searched and so on. The top (and last) settings to search are the system-wide advertising settings. To retrieve these settings directly, you should specify the empty or null string as ownerId value.

SOAP fault detail System.ArgumentException will be returned, if invalid or null language code specified.

Access

No restrictions.

Example SOAP 1.1

Request
POST /sbw_trunk/ServiceFacade/4.5/SystemWebService.asmx HTTP/1.1
Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://swsoft.com/webservices/sb/4.5/SystemService/GetAdvertisingSettings"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <CredentialsSoapHeader xmlns="http://swsoft.com/webservices/sb/4.5/SystemService">
      <Login>string</Login>
      <Password>string</Password>
    </CredentialsSoapHeader>
  </soap:Header>
  <soap:Body>
    <GetAdvertisingSettings xmlns="http://swsoft.com/webservices/sb/4.5/SystemService">
      <ownerId>string</ownerId>
      <languageCode>string</languageCode>
    </GetAdvertisingSettings>
  </soap:Body>
</soap:Envelope>
Response
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetAdvertisingSettingsResponse xmlns="http://swsoft.com/webservices/sb/4.5/SystemService">
      <GetAdvertisingSettingsResult>
        <HostingBannerMsg>string</HostingBannerMsg>
        <PublishStepMsg>string</PublishStepMsg>
      </GetAdvertisingSettingsResult>
    </GetAdvertisingSettingsResponse>
  </soap:Body>
</soap:Envelope>

See Also

SystemWebService Web Service | Web services