Looking for a REST API? The Ad Manager API (Beta) is now available.

SiteService (v202508)

AI-generated Key Takeaways

This service provides operations for creating, updating, and retrieving Site objects.
You can create new sites using createSites and update existing ones with updateSites .
Sites can be retrieved based on specific criteria using getSitesByStatement .
Actions like deactivating or submitting sites for approval can be performed using performSiteAction .

Provides operations for creating, updating, and retrieving Site objects.

Production WSDL

 https://ads.google.com/apis/ads/publisher/v202508/SiteService?wsdl

Namespace

https://www.google.com/apis/ads/publisher/v202508

Operations

createSites
getSitesByStatement
performSiteAction
updateSites

Errors

createSites

Creates new Site objects.

Parameters

Field	Type	Description
`sites`	`Site []`

Response

Field	Type	Description
`rval`	`Site []`

getSitesByStatement

Gets a SitePage of Site objects that satisfy the given Statement.query . The following fields are supported for filtering:

PQL Property	Object Property
`id`	Site.id
`url`	Site.url
`childNetworkCode`	Site.childNetworkCode
`approvalStatus`	Site.approvalStatus
`lastModifiedApprovalStatusDateTime`

Restriction: The lastModifiedApprovalStatusDateTime PQL property can only be used in a top-level expression scoping the filterStatement to Site s whose approvalStatus was modified on or after a specified date and time. (e.x.

"WHERE
        lastModifiedApprovalStatusDateTime >= '2022-01-01T00:00:00'"

).

Parameters

Field	Type	Description
`filterStatement`	`Statement`

Response

Field	Type	Description
`rval`	`SitePage`

performSiteAction

Performs actions on Site objects that match the given Statement.query .

Parameters

Field

Type

Description

siteAction

    SiteAction 
 
    DeactivateSite 
 
 
   SubmitSiteForApproval

filterStatement

  Statement

Response

Field	Type	Description
`rval`	`UpdateResult`

updateSites

Updates the specified Site objects.

The Site.childNetworkCode can be updated in order to 1) change the child network, 2) move a site from O&O to represented, or 3) move a site from represented to O&O.

Parameters

Field	Type	Description
`sites`	`Site []`

Response

Field	Type	Description
`rval`	`Site []`

Errors

Error

Reasons

AdSenseAccountError

Enumerations

ASSOCIATE_ACCOUNT_API_ERROR
CANNOT_ACCESS_INVALID_ACCOUNT
ACCOUNT_ACCESS_DENIED
GET_AD_SLOT_API_ERROR
GET_CHANNEL_API_ERROR
GET_BULK_ACCOUNT_STATUSES_API_ERROR
RESEND_VERIFICATION_EMAIL_ERROR
UNEXPECTED_API_RESPONSE_ERROR
UNKNOWN

ApiVersionError

Enumerations

UPDATE_TO_NEWER_VERSION
UNKNOWN

AuthenticationError

Enumerations

AMBIGUOUS_SOAP_REQUEST_HEADER
INVALID_EMAIL
AUTHENTICATION_FAILED
INVALID_OAUTH_SIGNATURE
INVALID_SERVICE
MISSING_SOAP_REQUEST_HEADER
MISSING_AUTHENTICATION_HTTP_HEADER
MISSING_AUTHENTICATION
NETWORK_API_ACCESS_DISABLED
NO_NETWORKS_TO_ACCESS
NETWORK_NOT_FOUND
NETWORK_CODE_REQUIRED
CONNECTION_ERROR
GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK
UNDER_INVESTIGATION
UNKNOWN

CollectionSizeError

Enumerations

TOO_LARGE
UNKNOWN

Enumerations

NOT_FOUND
ALREADY_EXISTS
NOT_APPLICABLE
DUPLICATE_OBJECT
CANNOT_UPDATE
UNSUPPORTED_OPERATION
CONCURRENT_MODIFICATION
REQUEST_TOO_LARGE
UNKNOWN

EntityLimitReachedError

Enumerations

CUSTOM_TARGETING_VALUES_LIMIT_REACHED
AD_EXCLUSION_RULES_LIMIT_REACHED
FIRST_PARTY_AUDIENCE_SEGMENTS_LIMIT_REACHED
PLACEMENTS_LIMIT_REACHED
LINE_ITEMS_LIMIT_REACHED
ACTIVE_LINE_ITEMS_LIMIT_REACHED
DAI_ENCODING_PROFILES_LIMIT_REACHED
TRAFFIC_FORECAST_SEGMENTS_LIMIT_REACHED
FORECAST_ADJUSTMENTS_LIMIT_REACHED
ACTIVE_EXPERIMENTS_LIMIT_REACHED
SITES_LIMIT_REACHED
USER_TEAMS_LIMIT_REACHED
ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
UNKNOWN

Enumerations

MISSING_FEATURE
UNKNOWN

InternalApiError

Enumerations

UNEXPECTED_INTERNAL_API_ERROR
TRANSIENT_ERROR
UNKNOWN
DOWNTIME
ERROR_GENERATING_RESPONSE

Enumerations

ARG1_NULL
ARG2_NULL
ARG3_NULL
NULL
UNKNOWN

Enumerations

NOT_NULL
UNKNOWN

Enumerations

UNPARSABLE
UNKNOWN

PermissionError

Enumerations

PERMISSION_DENIED
UNKNOWN

PublisherQueryLanguageContextError

Enumerations

UNEXECUTABLE
UNKNOWN

PublisherQueryLanguageSyntaxError

Enumerations

UNPARSABLE
UNKNOWN

Enumerations

EXCEEDED_QUOTA
UNKNOWN
REPORT_JOB_LIMIT
SEGMENT_POPULATION_LIMIT

RequiredCollectionError

Enumerations

REQUIRED
TOO_LARGE
TOO_SMALL
UNKNOWN

RequiredError

Enumerations

REQUIRED

Enumerations

SERVER_ERROR
SERVER_BUSY
UNKNOWN

Enumerations

INVALID_CHILD_NETWORK_CODE
CANNOT_ARCHIVE_SITE_WITH_SUBSITES
INVALID_URL_FOR_SITE
MULTIPLE_UPDATES_FOR_SAME_SITE
TOO_MANY_SITES_PER_REVIEW_REQUEST
TOO_MANY_REVIEW_REQUESTS_FOR_SITE
INVALID_APPROVAL_STATUS_FOR_REVIEW
UNKNOWN

StatementError

Enumerations

VARIABLE_NOT_BOUND_TO_VALUE
UNKNOWN

StringFormatError

Enumerations

UNKNOWN
ILLEGAL_CHARS
INVALID_FORMAT

StringLengthError

Enumerations

TOO_LONG
TOO_SHORT
UNKNOWN

Enumerations

CANNOT_USE_RESERVED_URL
CANNOT_USE_GOOGLE_URL
INVALID_URL
UNKNOWN

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-09-16 UTC.

Create a Mobile Website

View Site in Mobile | Classic

Share by: