This page contains the release notes for the active versions of Google Ad Manager API. Release notes from some previous versions that are no longer available are exposed only for completeness.
v202505
What's New
- Multiple Customer Management
-
-
Added
InvitationStatus
forChildPublisher
companies.
-
Added
- Line Items
-
-
Added
repeatedCreativeServingEnabled
field toLineItems
.
-
Added
- Proposal Line Items
-
-
Added
BuyerPermissionType
toProposalLineItems
for controlling how buyers can transact on deals.
-
Added
API Changes
-
=
AdRuleService (no changes) -
≠
AdjustmentService (0 new, 1 changed, 0 removed)-
≠
enum ForecastAdjustmentError.Reason
-
-
=
AdsTxtService (no changes) -
=
AudienceSegmentService (no changes) -
=
CdnConfigurationService (no changes) -
=
CmsMetadataService (no changes) -
≠
CompanyService (1 new, 2 changed, 0 removed)-
+
enum InvitationStatus -
≠
type ChildPublisher-
+
field invitationStatus -
−
field status
-
-
≠
enum McmError.Reason
-
-
=
ContactService (no changes) -
=
ContentBundleService (no changes) -
≠
ContentService (0 new, 1 changed, 0 removed)-
≠
enum VodIngestError
-
-
≠
CreativeService (0 new, 1 changed, 0 removed)-
≠
enum CreativeError.Reason-
−
value INVALID_ADSENSE_CREATIVE_SIZE -
−
value INVALID_AD_EXCHANGE_CREATIVE_SIZE
-
-
-
≠
CreativeSetService (0 new, 1 changed, 0 removed)-
≠
enum CreativeError.Reason-
−
value INVALID_ADSENSE_CREATIVE_SIZE -
−
value INVALID_AD_EXCHANGE_CREATIVE_SIZE
-
-
-
=
CreativeTemplateService (no changes) -
=
CreativeWrapperService (no changes) -
=
CustomFieldService (no changes) -
=
CustomTargetingService (no changes) -
=
DaiAuthenticationKeyService (no changes) -
=
DaiEncodingProfileService (no changes) -
≠
ForecastService (0 new, 6 changed, 0 removed)-
≠
enum CreativeError.Reason-
−
value INVALID_ADSENSE_CREATIVE_SIZE -
−
value INVALID_AD_EXCHANGE_CREATIVE_SIZE
-
-
≠
enum LineItemError.Reason -
≠
type LineItemSummary-
+
field repeatedCreativeServingEnabled
-
-
≠
enum ProgrammaticError.Reason-
+
value INVALID_BUYER
-
-
≠
type ProposalLineItem-
+
field buyerPermissionType
-
-
≠
enum TargetingDimension-
−
value VIDEO_POSITION
-
-
-
=
InventoryService (no changes) -
=
LabelService (no changes) -
≠
LineItemCreativeAssociationService (0 new, 2 changed, 0 removed)-
≠
enum CreativeError.Reason-
−
value INVALID_ADSENSE_CREATIVE_SIZE -
−
value INVALID_AD_EXCHANGE_CREATIVE_SIZE
-
-
≠
enum LineItemError.Reason
-
-
≠
LineItemService (0 new, 4 changed, 0 removed)-
≠
enum CreativeError.Reason-
−
value INVALID_ADSENSE_CREATIVE_SIZE -
−
value INVALID_AD_EXCHANGE_CREATIVE_SIZE
-
-
≠
enum LineItemError.Reason -
≠
type LineItemSummary-
+
field repeatedCreativeServingEnabled
-
-
≠
enum ProgrammaticError.Reason-
+
value INVALID_BUYER
-
-
-
≠
LineItemTemplateService (0 new, 3 changed, 0 removed)-
≠
enum CreativeError.Reason-
−
value INVALID_ADSENSE_CREATIVE_SIZE -
−
value INVALID_AD_EXCHANGE_CREATIVE_SIZE
-
-
≠
enum LineItemError.Reason -
≠
enum ProgrammaticError.Reason-
+
value INVALID_BUYER
-
-
-
=
LiveStreamEventService (no changes) -
=
MobileApplicationService (no changes) -
=
NativeStyleService (no changes) -
≠
NetworkService (0 new, 1 changed, 0 removed)-
≠
enum McmError.Reason
-
-
≠
OrderService (0 new, 3 changed, 0 removed)-
≠
enum CreativeError.Reason-
−
value INVALID_ADSENSE_CREATIVE_SIZE -
−
value INVALID_AD_EXCHANGE_CREATIVE_SIZE
-
-
≠
enum LineItemError.Reason -
≠
enum ProgrammaticError.Reason-
+
value INVALID_BUYER
-
-
-
=
PlacementService (no changes) -
≠
ProposalLineItemService (0 new, 3 changed, 0 removed)-
≠
enum LineItemError.Reason -
≠
enum ProgrammaticError.Reason-
+
value INVALID_BUYER
-
-
≠
type ProposalLineItem-
+
field buyerPermissionType
-
-
-
≠
ProposalService (0 new, 1 changed, 0 removed)-
≠
enum ProgrammaticError.Reason-
+
value INVALID_BUYER
-
-
-
≠
PublisherQueryLanguageService (0 new, 1 changed, 0 removed)-
≠
enum CreativeError.Reason-
−
value INVALID_ADSENSE_CREATIVE_SIZE -
−
value INVALID_AD_EXCHANGE_CREATIVE_SIZE
-
-
-
=
ReportService (no changes) -
=
SegmentPopulationService (no changes) -
=
SiteService (no changes) -
=
StreamActivityMonitorService (no changes) -
=
SuggestedAdUnitService (no changes) -
=
TargetingPresetService (no changes) -
=
TeamService (no changes) -
=
UserService (no changes) -
=
UserTeamAssociationService (no changes) -
=
YieldGroupService (no changes)
v202502
What's New
- Targeting Presets
-
- Added new error code for active targeting preset limits.
API Changes
-
=
AdRuleService (no changes) -
≠
AdjustmentService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
=
AdsTxtService (no changes) -
≠
AudienceSegmentService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
=
CdnConfigurationService (no changes) -
=
CmsMetadataService (no changes) -
=
CompanyService (no changes) -
=
ContactService (no changes) -
=
ContentBundleService (no changes) -
=
ContentService (no changes) -
≠
CreativeService (0 new, 2 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason -
≠
enum LineItemCreativeAssociationError.Reason
-
-
≠
CreativeSetService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
=
CreativeTemplateService (no changes) -
=
CreativeWrapperService (no changes) -
≠
CustomFieldService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
≠
CustomTargetingService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
=
DaiAuthenticationKeyService (no changes) -
≠
DaiEncodingProfileService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
≠
ForecastService (0 new, 3 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason -
≠
enum LineItemCreativeAssociationError.Reason -
≠
enum OrderActionError.Reason
-
-
≠
InventoryService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
=
LabelService (no changes) -
≠
LineItemCreativeAssociationService (0 new, 3 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason -
≠
enum LineItemCreativeAssociationError.Reason -
≠
type LineItemCreativeAssociationStats-
−
field costInOrderCurrency
-
-
-
≠
LineItemService (0 new, 3 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason -
≠
enum LineItemCreativeAssociationError.Reason -
≠
enum OrderActionError.Reason
-
-
≠
LineItemTemplateService (0 new, 3 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason -
≠
enum LineItemCreativeAssociationError.Reason -
≠
enum OrderActionError.Reason
-
-
≠
LiveStreamEventService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
=
MobileApplicationService (no changes) -
=
NativeStyleService (no changes) -
=
NetworkService (no changes) -
≠
OrderService (0 new, 3 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason -
≠
enum LineItemCreativeAssociationError.Reason -
≠
enum OrderActionError.Reason
-
-
≠
PlacementService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
≠
ProposalLineItemService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
≠
ProposalService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
≠
PublisherQueryLanguageService (0 new, 1 changed, 0 removed)-
≠
enum OrderActionError.Reason
-
-
=
ReportService (no changes) -
=
SegmentPopulationService (no changes) -
≠
SiteService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
=
StreamActivityMonitorService (no changes) -
≠
SuggestedAdUnitService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
≠
TargetingPresetService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
≠
TeamService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
≠
UserService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
-
=
UserTeamAssociationService (no changes) -
≠
YieldGroupService (0 new, 1 changed, 0 removed)-
≠
enum EntityLimitReachedError.Reason
-
v202411
What's New
- Line Items
-
-
Removed
GOOGLE
as aGrpProvider
-
Removed
- Reporting
-
-
Added
INVENTORY_FORMAT
Dimensions.
-
Added
- Publisher Query Language
-
-
Renamed the
Line_Item
table fieldendDateTime
toservingEndTime
. In both v202411 and earlier versions, the value is inclusive of any grace period The new name differentiates the PQL field from theLineItem.endDateTime
field which is exclusive of any grace period.
-
Renamed the
API Changes
-
=
AdRuleService (no changes) -
=
AdjustmentService (no changes) -
=
AdsTxtService (no changes) -
=
AudienceSegmentService (no changes) -
=
CdnConfigurationService (no changes) -
=
CmsMetadataService (no changes) -
=
CompanyService (no changes) -
=
ContactService (no changes) -
=
ContentBundleService (no changes) -
=
ContentService (no changes) -
=
CreativeService (no changes) -
=
CreativeSetService (no changes) -
=
CreativeTemplateService (no changes) -
=
CreativeWrapperService (no changes) -
=
CustomFieldService (no changes) -
=
CustomTargetingService (no changes) -
=
DaiAuthenticationKeyService (no changes) -
=
DaiEncodingProfileService (no changes) -
≠
ForecastService (0 new, 1 changed, 0 removed)-
≠
enum GrpProvider-
−
value GOOGLE
-
-
-
=
InventoryService (no changes) -
=
LabelService (no changes) -
≠
LineItemCreativeAssociationService (0 new, 2 changed, 1 removed)-
≠
enum LineItemCreativeAssociation.Status-
−
value NOT_SERVING
-
-
≠
operation pushCreativeToDevices-
−
parameter filterStatement -
−
parameter options -
−
response rval
-
-
−
operation pushCreativeToDevices
-
-
≠
LineItemService (0 new, 1 changed, 0 removed)-
≠
enum GrpProvider-
−
value GOOGLE
-
-
-
=
LineItemTemplateService (no changes) -
=
LiveStreamEventService (no changes) -
=
MobileApplicationService (no changes) -
=
NativeStyleService (no changes) -
=
NetworkService (no changes) -
=
OrderService (no changes) -
=
PlacementService (no changes) -
≠
ProposalLineItemService (0 new, 1 changed, 0 removed)-
≠
enum GrpProvider-
−
value GOOGLE
-
-
-
=
ProposalService (no changes) -
=
PublisherQueryLanguageService (no changes) -
≠
ReportService (0 new, 1 changed, 0 removed)-
≠
enum Dimension-
+
value INVENTORY_FORMAT -
+
value INVENTORY_FORMAT_NAME
-
-
-
=
SegmentPopulationService (no changes) -
≠
SiteService (0 new, 1 changed, 0 removed)-
≠
type Site-
−
field active
-
-
-
=
StreamActivityMonitorService (no changes) -
=
SuggestedAdUnitService (no changes) -
=
TargetingPresetService (no changes) -
=
TeamService (no changes) -
=
UserService (no changes) -
=
UserTeamAssociationService (no changes) -
=
YieldGroupService (no changes)
v202408
What's New
- Line Items
-
-
Added
ContentLabelTargeting
andVerticalTargeting
to support contextual targeting. -
Added
performTargetingPresetsAction
method to theTargetingPresetService
.
-
Added
- MCM
-
-
Added
AdsTxtService
for reading MCM supply chain diaghnostic reports.
-
Added
- Reporting
-
-
Replaced
VIDEO_PLACEMENT_NAME
Dimension withVIDEO_PLCMT_NAME
which reflects the updated IAB definition.
-
Replaced
API Changes
-
+
AdsTxtService -
≠
AdRuleService (0 new, 1 changed, 0 removed)-
≠
type Targeting-
+
field contentLabelTargeting -
+
field verticalTargeting
-
-
-
≠
AdjustmentService (0 new, 1 changed, 0 removed)-
≠
type Targeting-
+
field contentLabelTargeting -
+
field verticalTargeting
-
-
-
=
AudienceSegmentService (no changes) -
=
CdnConfigurationService (no changes) -
=
CmsMetadataService (no changes) -
≠
CompanyService (0 new, 1 changed, 0 removed)-
≠
enum McmError.Reason-
+
value REVENUE_SHARE_PERCENT_OUTSIDE_RANGE -
+
value RESELLER_PARENT_REVENUE_SHARE_IS_NOT_100_PERCENT -
+
value MI_PARENT_REVENUE_SHARE_IS_NOT_100_PERCENT -
+
value CHILD_NETWORK_DISAPPROVED -
+
value MANAGE_INVENTORY_UNSUPPORTED_IN_RESELLER_NETWORK -
+
value CANNOT_SEND_INVITATION_TO_MCM_PARENT -
+
value CANNOT_SEND_INVITATION_TO_NETWORK_WITH_RESELLER_PARENT -
+
value CANNOT_SEND_INVITATION_TO_SELF -
+
value CANNOT_CLOSE_MCM_WITH_ACTIVE_CHILDREN -
+
value CANNOT_TURN_CHILD_INTO_PARENT_WITH_ACTIVE_INVITATION -
+
value MISSING_NETWORK_EXCHANGE_ACCOUNT
-
-
-
=
ContactService (no changes) -
=
ContentBundleService (no changes) -
=
ContentService (no changes) -
≠
CreativeService (0 new, 1 changed, 0 removed)-
≠
type Creative-
+
field adBadgingEnabled
-
-
-
=
CreativeSetService (no changes) -
=
CreativeTemplateService (no changes) -
=
CreativeWrapperService (no changes) -
=
CustomFieldService (no changes) -
=
CustomTargetingService (no changes) -
=
DaiAuthenticationKeyService (no changes) -
=
DaiEncodingProfileService (no changes) -
≠
ForecastService (0 new, 2 changed, 0 removed)-
≠
type ProposalLineItem-
−
field isProgrammatic -
−
field timeZoneId
-
-
≠
type Targeting-
+
field contentLabelTargeting -
+
field verticalTargeting
-
-
-
≠
InventoryService (0 new, 1 changed, 0 removed)-
≠
enum AdSenseAccountError.Reason-
+
value CANNOT_ACCESS_INVALID_ACCOUNT -
+
value ACCOUNT_ACCESS_DENIED
-
-
-
=
LabelService (no changes) -
≠
LineItemCreativeAssociationService (0 new, 1 changed, 0 removed)-
≠
enum AdSenseAccountError.Reason-
+
value CANNOT_ACCESS_INVALID_ACCOUNT -
+
value ACCOUNT_ACCESS_DENIED
-
-
-
≠
LineItemService (0 new, 1 changed, 0 removed)-
≠
type Targeting-
+
field contentLabelTargeting -
+
field verticalTargeting
-
-
-
=
LineItemTemplateService (no changes) -
≠
LiveStreamEventService (0 new, 1 changed, 0 removed)-
≠
type LiveStreamEvent-
+
field podServingSegmentDuration
-
-
-
=
MobileApplicationService (no changes) -
≠
NativeStyleService (0 new, 1 changed, 0 removed)-
≠
type Targeting-
+
field contentLabelTargeting -
+
field verticalTargeting
-
-
-
≠
NetworkService (0 new, 1 changed, 0 removed)-
≠
enum McmError.Reason-
+
value REVENUE_SHARE_PERCENT_OUTSIDE_RANGE -
+
value RESELLER_PARENT_REVENUE_SHARE_IS_NOT_100_PERCENT -
+
value MI_PARENT_REVENUE_SHARE_IS_NOT_100_PERCENT -
+
value CHILD_NETWORK_DISAPPROVED -
+
value MANAGE_INVENTORY_UNSUPPORTED_IN_RESELLER_NETWORK -
+
value CANNOT_SEND_INVITATION_TO_MCM_PARENT -
+
value CANNOT_SEND_INVITATION_TO_NETWORK_WITH_RESELLER_PARENT -
+
value CANNOT_SEND_INVITATION_TO_SELF -
+
value CANNOT_CLOSE_MCM_WITH_ACTIVE_CHILDREN -
+
value CANNOT_TURN_CHILD_INTO_PARENT_WITH_ACTIVE_INVITATION -
+
value MISSING_NETWORK_EXCHANGE_ACCOUNT
-
-
-
=
OrderService (no changes) -
=
PlacementService (no changes) -
≠
ProposalLineItemService (0 new, 2 changed, 0 removed)-
≠
type ProposalLineItem-
−
field isProgrammatic -
−
field timeZoneId
-
-
≠
type Targeting-
+
field contentLabelTargeting -
+
field verticalTargeting
-
-
-
≠
ProposalService (0 new, 1 changed, 0 removed)-
≠
type Targeting-
+
field contentLabelTargeting -
+
field verticalTargeting
-
-
-
≠
PublisherQueryLanguageService (0 new, 1 changed, 0 removed)-
≠
type Targeting-
+
field contentLabelTargeting -
+
field verticalTargeting
-
-
-
≠
ReportService (0 new, 2 changed, 0 removed)-
≠
enum Column -
≠
enum Dimension-
+
value VIDEO_PLCMT -
+
value VIDEO_PLCMT_NAME -
−
value VIDEO_METADATA_KEY_ID -
−
value VIDEO_METADATA_KEY_NAME -
−
value VIDEO_PLACEMENT_NAME
-
-
-
=
SegmentPopulationService (no changes) -
≠
SiteService (0 new, 2 changed, 0 removed)-
≠
enum AdSenseAccountError.Reason-
+
value CANNOT_ACCESS_INVALID_ACCOUNT -
+
value ACCOUNT_ACCESS_DENIED
-
-
≠
type Site-
+
field approvalStatusUpdateTime
-
-
-
=
StreamActivityMonitorService (no changes) -
=
SuggestedAdUnitService (no changes) -
≠
TargetingPresetService (1 new, 2 changed, 0 removed)-
+
operation performTargetingPresetAction -
≠
type Targeting-
+
field contentLabelTargeting -
+
field verticalTargeting
-
-
≠
operation performTargetingPresetAction-
+
parameter filterStatement -
+
response rval -
+
parameter targetingPresetAction
-
-
-
=
TeamService (no changes) -
=
UserService (no changes) -
=
UserTeamAssociationService (no changes) -
≠
YieldGroupService (0 new, 1 changed, 0 removed)-
≠
type Targeting-
+
field contentLabelTargeting -
+
field verticalTargeting
-
-