The Google Ads API consists of resources and services. A resource represents a Google Ads entity.
Examples of resources:
Each resource is uniquely identified by a
resource_name string, that
concatenates the resource and its parents into a path. For instance, campaign
resource names have the form:
So for a campaign with ID
987654 in the Google Ads account with customer ID
resource_name would be:
Services retrieve and manipulate Google Ads entities. There are three types:
Modify (mutate) objects
These services modify instances of an associated resource type via a mutate request. They also supply a get request that retrieves a single resource instance, which can be useful for examining the structure of a resource.
Examples of services:
Get objects and performance stats
is the single, unified service for retrieving objects and performance
All Search and SearchStream requests for
GoogleAdsService require a query
that specifies the resource to query, the resource attributes and performance
metrics to retrieve, the predicates to use for filtering the request, and the
segments to use to further break down your performance statistics. For more
information about the format of the query, check out the
Google Ads Query Language guide.
retrieves metadata about resources in the Google Ads API, such as the
available attributes for a resource and its data type.
This service provides information you'll need in constructing a query
GoogleAdsService. For convenience, the information returned
GoogleAdsFieldService is also available in the
fields reference documentation.