Join us live on Discord on the Google Advertising and Measurement Community server on October 16th! We will discuss the new features added in V22 of the Google Ads API.

Goal

Representation of goals.

Fields
`resource_name`	`string` Immutable. The resource name of the goal. Goal resource names have the form: `customers/{customer_id}/goals/{goal_id}`
`goal_type`	`GoalType` Output only. The type of this goal.
`optimization_eligibility`	`GoalOptimizationEligibility` Output only. Indicates if this goal is eligible for campaign optimization.
`goal_id`	`int64` Output only. The ID of this goal.
`owner_customer`	`string` Output only. The resource name of the goal owner customer.
Union field `goal_settings` `goal_settings`. The settings specific to this goal. `goal_settings` can be only one of the following:
`retention_goal_settings`	`RetentionGoal` Retention goal settings.

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-10-10 UTC.

Blog
Visit our blog for important announcements.
Forum
Interact with our community of developer experts.
Client Libraries
Use our officially supported client libraries.
YouTube
Access our video contents.
Discord
Join the Google Ads Discord server.

Goal

`resource_name`

`goal_type`

`optimization_eligibility`

`goal_id`

`owner_customer`

`goal_settings`

`retention_goal_settings`

Goal Stay organized with collections Save and categorize content based on your preferences.

resource_name

goal_type

optimization_eligibility

goal_id

owner_customer

goal_settings

retention_goal_settings

Goal

`resource_name`

`goal_type`

`optimization_eligibility`

`goal_id`

`owner_customer`

`goal_settings`

`retention_goal_settings`