Publishers may not wish to display certain ads, such as their
competitors' ads, on their website. SiteFilterService lets
you specify site filters to identify such sites. Ads that link
to sites on the filter list will not appear on the publishers'
content pages.
Note that by entering a top level domain such as
www.example.com, publishers will block all ads that link to
subdirectories below that domain. The following rules apply to the
competitive ad filter:
example.com will block ads to
example.com and example.com/sub
example.com will also block ads to
www.example.com and forums.example.com
www.example.com will block ads to
www.example.com but not to forums.example.com or
example.com
example.com/sub will not block ads to
example.com/products or
example.com/sub/index.html
The version 2 WSDL for this service is at https://www.google.com/api/adsense/v2/SiteFilterService?wsdl.
The version 3 WSDL for this service is at https://www.google.com/api/adsense/v3/SiteFilterService?wsdl.
Requests
Adds a collection of site filters for a syndication service.
| Parameter name | Parameter type | Parameter description |
|---|---|---|
| synServiceId | string |
the syndication service ID |
| siteFilters | string[] |
a collection of URLs that should be filtered |
| Response type | Response description |
|---|---|
(none) |
| Error number | Error description |
|---|---|
| 201 | if synServiceId is not valid |
| 601 | before adding any site filters if an element of siteFilters is malformed |
| 602 | if siteFilters is empty |
| 603 | before adding any site filters if there are duplicate filters in siteFilters |
| 605 | before adding any site filters if a filter in siteFilters is already active |
| 606 | before adding any site filters if adding all the specified filters would exceed the site filter limit |
Gets the site filters for a syndication service.
| Parameter name | Parameter type | Parameter description |
|---|---|---|
| synServiceId | string |
the ID of the syndication service |
| Response type | Response description |
|---|---|
string[] |
the collection of site filters associated with the service ID |
| Error number | Error description |
|---|---|
| 201 | if synServiceId is not valid |
Removes a collection of site filters from a syndication service.
| Parameter name | Parameter type | Parameter description |
|---|---|---|
| synServiceId | string |
the syndication service ID |
| siteFilters | string[] |
a collection of URLs that should no longer be filtered |
| Response type | Response description |
|---|---|
(none) |
| Error number | Error description |
|---|---|
| 201 | if synServiceId is not valid |
| 601 | before deleting any site filters if an element of siteFilters is malformed |
| 602 | if siteFilters is empty |
| 603 | before deleting any site filters if there are duplicate filters in siteFilters |
| 604 | before deleting any site filters if a filter in siteFilters is not a current site filter |
Sets the site filters for a syndication service.
| Parameter name | Parameter type | Parameter description |
|---|---|---|
| synServiceId | string |
the ID of the syndication service |
| siteFilters | string[] |
a collection of URLs that should be filtered |
| Response type | Response description |
|---|---|
(none) |
| Error number | Error description |
|---|---|
| 201 | if synServiceId is not valid |
| 601 | before setting any site filters if an element of siteFilters is malformed |
| 603 | before setting any site filters if there are duplicate filters in siteFilters |
| 606 | before setting any site filters if setting all the specified filters would exceed the site filter limit |