GOgoogle
advertisers

POST /v4/advertisers/{advertisersId}/adGroupAds

Creates an ad group ad.

Request

  • Base URL
    https://displayvideo.googleapis.com
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/display-video
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/display-video
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

advertisersIdstring required

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.

entityStatus'ENTITY_STATUS_UNSPECIFIED' | 'ENTITY_STATUS_ACTIVE' | 'ENTITY_STATUS_ARCHIVED' | 'ENTITY_STATUS_DRAFT' | 'ENTITY_STATUS_PAUSED' | 'ENTITY_STATUS_SCHEDULED_FOR_DELETION'

Required. The entity status of the ad.

namestring

Output only. The resource name of the ad.

Response

Successful response

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.

entityStatus'ENTITY_STATUS_UNSPECIFIED' | 'ENTITY_STATUS_ACTIVE' | 'ENTITY_STATUS_ARCHIVED' | 'ENTITY_STATUS_DRAFT' | 'ENTITY_STATUS_PAUSED' | 'ENTITY_STATUS_SCHEDULED_FOR_DELETION'

Required. The entity status of the ad.

namestring

Output only. The resource name of the ad.

Changes

No recorded changes to this operation across all 7 revisions of this API.