POST /v4/advertisers/{+advertiserId}/adGroupAds – Google Display & Video 360 API

advertisers

Changed on Oct 10, 2026

Creates an ad group ad.

post/v4/advertisers/{+advertiserId}/adGroupAds

Request

Base URL: https://displayvideo.googleapis.com
URL: https://displayvideo.googleapis.com/v4/advertisers/{+advertiserId}/adGroupAds
Auth: OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/display-video) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/display-video)

Path parameters

advertiserIdstring required

Output only. The unique ID of the advertiser the ad belongs to.

Request body

adGroupAdIdstring int64

Output only. The unique ID of the ad. Assigned by the system.

adGroupIdstring int64

Required. Immutable. The unique ID of the ad group that the ad belongs to.

advertiserIdstring int64

Output only. The unique ID of the advertiser the ad belongs to.

displayNamestring

Required. The display name of the ad. Must be UTF-8 encoded with a maximum size of 255 bytes.

Required. The entity status of the ad.

namestring

Output only. The resource name of the ad.

Response

Successful response

Changes

Oct 10, 202652cdb4885336 Revision changes
- breaking
  removed the request body
- breaking
  removed the media type */* for the response with the status
Oct 10, 20260f73dc785c76 Revision changes
- info
  the request optional property // became read-only
- info
  the request optional property // became read-only
- info
  the request optional property /// became read-only
- info
  the request optional property /// became read-only
- info
  the request optional property // became read-only
- info
  the request optional property /// became read-only
- info
  the request optional property /// became read-only
- info
  the request optional property // became read-only
- info
  the request optional property // became read-only
- info
  the request optional property /// became read-only
- info
  the request optional property // became read-only
- info
  the request optional property / became read-only
- info
  the request optional property / became read-only
- info
  the request optional property /// became read-only
- info
  the response optional property // became read-only for the status
- info
  the response optional property // became read-only for the status
- info
  the response optional property /// became read-only for the status
- info
  the response optional property /// became read-only for the status
- info
  the response optional property // became read-only for the status
- info
  the response optional property /// became read-only for the status
- info
  the response optional property /// became read-only for the status
- info
  the response optional property // became read-only for the status
- info
  the response optional property // became read-only for the status
- info
  the response optional property /// became read-only for the status
- info
  the response optional property // became read-only for the status
- info
  the response optional property / became read-only for the status
- info
  the response optional property / became read-only for the status
- info
  the response optional property /// became read-only for the status

Operation history