gads_get_metadata: Get metada of object, RESOURCE, ATTRIBUTE, METRIC or SEGMENT

In rgoogleads: Loading Data from 'Google Ads API'

Get metada of object, RESOURCE, ATTRIBUTE, METRIC or SEGMENT

Description

Get metada of object, RESOURCE, ATTRIBUTE, METRIC or SEGMENT

Usage

gads_get_metadata(
  category = c("RESOURCE", "ATTRIBUTE", "METRIC", "SEGMENT", "ALL"),
  fields = c("name", "category", "data_type", "selectable", "filterable", "sortable",
    "selectable_with", "metrics", "segments", "is_repeated", "type_url", "enum_values",
    "attribute_resources")
)

Arguments

category	Object category
fields	Metadata fields

Value

tibble with object metadata important arrays in result:

attributeResources

Resources that can be using in resource argument in gads_get_report.

metrics

Metrics that are available to be selected with the resource in the field argument in gads_get_report. Only populated for fields where the category is RESOURCE.

segments

Segment keys that can be selected with the resource in the field argument in gads_get_report. These segment the metrics specified in the query. Only populated for fields where the category is RESOURCE.

selectableWith

Fields that can be selected alongside a given field, when not in the FROM clause. This attribute is only relevant when identifying resources or segments that are able to be selected in a query where they are not included by the resource in the FROM clause. As an example, if we are selecting ad_group.id and segments.date from ad_group, and we want to include attributes from campaign, we would need to check that segments.date is in the selectableWith attribute for campaign, since it's being selected alongside the existing segments.date field.

See Also

The Query Builder Blog Series: Part 3 - Creating a Resource Schema and Resource Metadata API documentation

Examples

## Not run: 
# get resource list
resources <- gads_get_metadata("RESOURCE")

# get list of all objects
metadata <- gads_get_metadata("ALL")


## End(Not run)

rgoogleads documentation built on April 4, 2025, 5:01 a.m.