--- title: "POST /v23/customers/{customersId}:generateAudienceCompositionInsights" method: POST path: "/v23/customers/{customersId}:generateAudienceCompositionInsights" tags: ["customers"] --- # POST /v23/customers/{customersId}:generateAudienceCompositionInsights `POST /v23/customers/{customersId}:generateAudienceCompositionInsights` ## Request - Base URL: `https://searchads360.googleapis.com` - URL: `https://searchads360.googleapis.com/v23/customers/{customersId}:generateAudienceCompositionInsights` - Auth: OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/doubleclicksearch` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/doubleclicksearch` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns a collection of attributes that are represented in an audience of interest, with metrics that compare each attribute's share of the audience with its share of a baseline audience. List of thrown errors: [AudienceInsightsError]() [AuthenticationError]() [AuthorizationError]() [FieldError]() [HeaderError]() [InternalError]() [QuotaError]() [RangeError]() [RequestError]() ## Path parameters - `customersId` string, required ## Request body - GoogleAdsSearchads360V23ServicesGenerateAudienceCompositionInsightsRequest: Request message for AudienceInsightsService.GenerateAudienceCompositionInsights. - `audience` GoogleAdsSearchads360V23ServicesInsightsAudience: A set of users, defined by various characteristics, for which insights can be requested in AudienceInsightsService. - `ageRanges` GoogleAdsSearchads360V23CommonAgeRangeInfo[]: Age ranges for the audience. If absent, the audience represents all people over 18 that match the other attributes. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED': Type of the age range. - `countryLocations` GoogleAdsSearchads360V23CommonLocationInfo[]: Required. The countries for the audience. - `geoTargetConstant` string: The geo target constant resource name. - `gender` GoogleAdsSearchads360V23CommonGenderInfo: A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED': Type of the gender. - `incomeRanges` GoogleAdsSearchads360V23CommonIncomeRangeInfo[]: Household income percentile ranges for the audience. If absent, the audience does not restrict by household income range. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED': Type of the income range. - `lineups` GoogleAdsSearchads360V23CommonAudienceInsightsLineup[]: Lineups representing the YouTube content viewed by the audience. - `lineupId` string: Required. The numeric ID of the lineup. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo: A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED': Type of the parental status. - `subCountryLocations` GoogleAdsSearchads360V23CommonLocationInfo[]: Sub-country geographic location attributes. If present, each of these must be contained in one of the countries in this audience. If absent, the audience is geographically to the country_locations and no further. - `geoTargetConstant` string: The geo target constant resource name. - `topicAudienceCombinations` GoogleAdsSearchads360V23ServicesInsightsAudienceAttributeGroup[]: A combination of entity, category and user interest attributes defining the audience. The combination has a logical AND-of-ORs structure: Attributes within each InsightsAudienceAttributeGroup are combined with OR, and the combinations themselves are combined together with AND. For example, the expression (Entity OR Affinity) AND (In-Market OR Category) can be formed using two InsightsAudienceAttributeGroups with two Attributes each. - `attributes` GoogleAdsSearchads360V23CommonAudienceInsightsAttribute[]: Required. A collection of audience attributes to be combined with logical OR. Attributes need not all be the same dimension. Only Knowledge Graph entities, Product & Service Categories, and Affinity and In-Market audiences are supported in this context. - `ageRange` GoogleAdsSearchads360V23CommonAgeRangeInfo: An age range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED': Type of the age range. - `category` GoogleAdsSearchads360V23CommonAudienceInsightsCategory: A Product and Service category. - `categoryId` string: Required. The criterion ID of the category. - `device` GoogleAdsSearchads360V23CommonDeviceInfo: A device criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER': Type of the device. - `entity` GoogleAdsSearchads360V23CommonAudienceInsightsEntity: A Knowledge Graph entity, represented by its machine id. - `knowledgeGraphMachineId` string: Required. The machine ID (mid) of the Knowledge Graph entity. - `gender` GoogleAdsSearchads360V23CommonGenderInfo: A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED': Type of the gender. - `incomeRange` GoogleAdsSearchads360V23CommonIncomeRangeInfo: An income range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED': Type of the income range. - `lineup` GoogleAdsSearchads360V23CommonAudienceInsightsLineup: A YouTube Lineup. - `lineupId` string: Required. The numeric ID of the lineup. - `location` GoogleAdsSearchads360V23CommonLocationInfo: A location criterion. - `geoTargetConstant` string: The geo target constant resource name. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo: A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED': Type of the parental status. - `userInterest` GoogleAdsSearchads360V23CommonUserInterestInfo: Represents a particular interest-based topic to be targeted. - `userInterestCategory` string: The UserInterest resource name. - `userList` GoogleAdsSearchads360V23CommonUserListInfo: A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string: The User List resource name. - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo: A YouTube Channel criterion. - `channelId` string: The YouTube uploader channel id or the channel code of a YouTube channel. - `youtubeVideo` GoogleAdsSearchads360V23CommonYouTubeVideoInfo: A YouTube Video criterion. - `videoId` string: YouTube video id as it appears on the YouTube watch page. - `userList` GoogleAdsSearchads360V23CommonUserListInfo: A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string: The User List resource name. - `baselineAudience` GoogleAdsSearchads360V23ServicesInsightsAudience: A set of users, defined by various characteristics, for which insights can be requested in AudienceInsightsService. - `ageRanges` GoogleAdsSearchads360V23CommonAgeRangeInfo[]: Age ranges for the audience. If absent, the audience represents all people over 18 that match the other attributes. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED': Type of the age range. - `countryLocations` GoogleAdsSearchads360V23CommonLocationInfo[]: Required. The countries for the audience. - `geoTargetConstant` string: The geo target constant resource name. - `gender` GoogleAdsSearchads360V23CommonGenderInfo: A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED': Type of the gender. - `incomeRanges` GoogleAdsSearchads360V23CommonIncomeRangeInfo[]: Household income percentile ranges for the audience. If absent, the audience does not restrict by household income range. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED': Type of the income range. - `lineups` GoogleAdsSearchads360V23CommonAudienceInsightsLineup[]: Lineups representing the YouTube content viewed by the audience. - `lineupId` string: Required. The numeric ID of the lineup. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo: A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED': Type of the parental status. - `subCountryLocations` GoogleAdsSearchads360V23CommonLocationInfo[]: Sub-country geographic location attributes. If present, each of these must be contained in one of the countries in this audience. If absent, the audience is geographically to the country_locations and no further. - `geoTargetConstant` string: The geo target constant resource name. - `topicAudienceCombinations` GoogleAdsSearchads360V23ServicesInsightsAudienceAttributeGroup[]: A combination of entity, category and user interest attributes defining the audience. The combination has a logical AND-of-ORs structure: Attributes within each InsightsAudienceAttributeGroup are combined with OR, and the combinations themselves are combined together with AND. For example, the expression (Entity OR Affinity) AND (In-Market OR Category) can be formed using two InsightsAudienceAttributeGroups with two Attributes each. - `attributes` GoogleAdsSearchads360V23CommonAudienceInsightsAttribute[]: Required. A collection of audience attributes to be combined with logical OR. Attributes need not all be the same dimension. Only Knowledge Graph entities, Product & Service Categories, and Affinity and In-Market audiences are supported in this context. - `ageRange` GoogleAdsSearchads360V23CommonAgeRangeInfo: An age range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED': Type of the age range. - `category` GoogleAdsSearchads360V23CommonAudienceInsightsCategory: A Product and Service category. - `categoryId` string: Required. The criterion ID of the category. - `device` GoogleAdsSearchads360V23CommonDeviceInfo: A device criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER': Type of the device. - `entity` GoogleAdsSearchads360V23CommonAudienceInsightsEntity: A Knowledge Graph entity, represented by its machine id. - `knowledgeGraphMachineId` string: Required. The machine ID (mid) of the Knowledge Graph entity. - `gender` GoogleAdsSearchads360V23CommonGenderInfo: A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED': Type of the gender. - `incomeRange` GoogleAdsSearchads360V23CommonIncomeRangeInfo: An income range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED': Type of the income range. - `lineup` GoogleAdsSearchads360V23CommonAudienceInsightsLineup: A YouTube Lineup. - `lineupId` string: Required. The numeric ID of the lineup. - `location` GoogleAdsSearchads360V23CommonLocationInfo: A location criterion. - `geoTargetConstant` string: The geo target constant resource name. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo: A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED': Type of the parental status. - `userInterest` GoogleAdsSearchads360V23CommonUserInterestInfo: Represents a particular interest-based topic to be targeted. - `userInterestCategory` string: The UserInterest resource name. - `userList` GoogleAdsSearchads360V23CommonUserListInfo: A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string: The User List resource name. - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo: A YouTube Channel criterion. - `channelId` string: The YouTube uploader channel id or the channel code of a YouTube channel. - `youtubeVideo` GoogleAdsSearchads360V23CommonYouTubeVideoInfo: A YouTube Video criterion. - `videoId` string: YouTube video id as it appears on the YouTube watch page. - `userList` GoogleAdsSearchads360V23CommonUserListInfo: A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string: The User List resource name. - `customerInsightsGroup` string: The name of the customer being planned for. This is a user-defined value. - `dataMonth` string: The one-month range of historical data to use for insights, in the format "yyyy-mm". If unset, insights will be returned for the last thirty days of data. - `dimensions` string[]: Required. The audience dimensions for which composition insights should be returned. Supported dimensions are KNOWLEDGE_GRAPH, GEO_TARGET_COUNTRY, SUB_COUNTRY_LOCATION, YOUTUBE_CHANNEL, YOUTUBE_LINEUP, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, . - `insightsApplicationInfo` GoogleAdsSearchads360V23CommonAdditionalApplicationInfo: Additional information about the application/tool issuing the request. This field is only used by ContentCreatorInsightsService, AudienceInsightsService, and ReachPlanService APIs. - `applicationId` string: The unique identifier of the agency proprietary application. This identifier is generated by Google. Reach out to your Google representative to request an application_id for each new application being integrated. - `applicationInstance` 'UNSPECIFIED' | 'UNKNOWN' | 'DEVELOPMENT_AND_TESTING' | 'PRODUCTION': The instance type of the application sending the request. ## Response `200` Successful response - GoogleAdsSearchads360V23ServicesGenerateAudienceCompositionInsightsResponse: Response message for AudienceInsightsService.GenerateAudienceCompositionInsights. - `sections` GoogleAdsSearchads360V23ServicesAudienceCompositionSection[]: The contents of the insights report, organized into sections. Each section is associated with one of the AudienceInsightsDimension values in the request. There may be more than one section per dimension. - `clusteredAttributes` GoogleAdsSearchads360V23ServicesAudienceCompositionAttributeCluster[]: Additional attributes for this audience, grouped into clusters. Only populated if dimension is YOUTUBE_CHANNEL. - `attributes` GoogleAdsSearchads360V23ServicesAudienceCompositionAttribute[]: The individual attributes that make up this cluster, with metadata and metrics. - `attributeMetadata` GoogleAdsSearchads360V23CommonAudienceInsightsAttributeMetadata: An audience attribute, with metadata about it, returned in response to a search. - `attribute` GoogleAdsSearchads360V23CommonAudienceInsightsAttribute: An audience attribute that can be used to request insights about the audience. - `ageRange` GoogleAdsSearchads360V23CommonAgeRangeInfo: An age range criterion. - … - `category` GoogleAdsSearchads360V23CommonAudienceInsightsCategory: A Product and Service category. - … - `device` GoogleAdsSearchads360V23CommonDeviceInfo: A device criterion. - … - `entity` GoogleAdsSearchads360V23CommonAudienceInsightsEntity: A Knowledge Graph entity, represented by its machine id. - … - `gender` GoogleAdsSearchads360V23CommonGenderInfo: A gender criterion. - … - `incomeRange` GoogleAdsSearchads360V23CommonIncomeRangeInfo: An income range criterion. - … - `lineup` GoogleAdsSearchads360V23CommonAudienceInsightsLineup: A YouTube Lineup. - … - `location` GoogleAdsSearchads360V23CommonLocationInfo: A location criterion. - … - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo: A parental status criterion. - … - `userInterest` GoogleAdsSearchads360V23CommonUserInterestInfo: Represents a particular interest-based topic to be targeted. - … - `userList` GoogleAdsSearchads360V23CommonUserListInfo: A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - … - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo: A YouTube Channel criterion. - … - `youtubeVideo` GoogleAdsSearchads360V23CommonYouTubeVideoInfo: A YouTube Video criterion. - … - `dimension` 'UNSPECIFIED' | 'UNKNOWN' | 'CATEGORY' | 'KNOWLEDGE_GRAPH' | 'GEO_TARGET_COUNTRY' | 'SUB_COUNTRY_LOCATION' | 'YOUTUBE_CHANNEL' | 'AFFINITY_USER_INTEREST' | 'IN_MARKET_USER_INTEREST' | 'PARENTAL_STATUS' | 'INCOME_RANGE' | 'AGE_RANGE' | 'GENDER' | 'YOUTUBE_VIDEO' | 'DEVICE' | 'YOUTUBE_LINEUP' | 'USER_LIST' | 'LIFE_EVENT_USER_INTEREST': The type of the attribute. - `displayInfo` string: A string that supplements the display_name to identify the attribute. If the dimension is TOPIC, this is a brief description of the Knowledge Graph entity, such as "American singer-songwriter". If the dimension is CATEGORY, this is the complete path to the category in The Product & Service taxonomy, for example "/Apparel/Clothing/Outerwear". - `displayName` string: The human-readable name of the attribute. - `knowledgeGraphAttributeMetadata` GoogleAdsSearchads360V23CommonKnowledgeGraphAttributeMetadata: Metadata associated with a Knowledge Graph Entity attribute. - `entityCapabilities` string[]: The capabilities of the entity used in ContentCreatorInsightsService. - `relatedCategories` GoogleAdsSearchads360V23CommonAudienceInsightsAttributeMetadata[]: A list of CATEGORY attributes related to this entity. - `lineupAttributeMetadata` GoogleAdsSearchads360V23CommonLineupAttributeMetadata: Metadata associated with a Lineup attribute. - `channelCountLowerBound` string, int64: The lower end of a range containing the number of channels in the lineup. - `channelCountUpperBound` string, int64: The upper end of a range containing the number of channels in the lineup. - `inventoryCountry` GoogleAdsSearchads360V23CommonLocationInfo: A location criterion. - … - `medianMonthlyInventory` string, int64: The median number of impressions per month on this lineup. - `sampleChannels` GoogleAdsSearchads360V23CommonLineupAttributeMetadataSampleChannel[]: Examples of channels that are included in the lineup. - … - `locationAttributeMetadata` GoogleAdsSearchads360V23CommonLocationAttributeMetadata: Metadata associated with a Location attribute. - `countryLocation` GoogleAdsSearchads360V23CommonLocationInfo: A location criterion. - … - `potentialYoutubeReach` string, int64: An estimate of the number of reachable YouTube users matching this attribute in the requested location, or zero if that information is not available for this attribute. This field is not populated in every response. - `subscriberShare` number, double: The share of subscribers within this attribute, between and including 0 and 1. This field is not populated in every response. - `userInterestAttributeMetadata` GoogleAdsSearchads360V23CommonUserInterestAttributeMetadata: Metadata associated with a User Interest attribute. - `userInterestDescription` string: English language text description of the user interest category (200 characters max). - `userListAttributeMetadata` GoogleAdsSearchads360V23CommonUserListAttributeMetadata: Metadata associated with a User List attribute. - `userListType` 'UNSPECIFIED' | 'UNKNOWN' | 'REMARKETING' | 'LOGICAL' | 'EXTERNAL_REMARKETING' | 'RULE_BASED' | 'SIMILAR' | 'CRM_BASED' | 'LOOKALIKE': The user list type. - `viewerShare` number, double: The share of viewers within this attribute, between and including 0 and 1. This field is not populated in every response. - `youtubeChannelMetadata` GoogleAdsSearchads360V23CommonYouTubeChannelAttributeMetadata: Metadata associated with a YouTube channel attribute. - `subscriberCount` string, int64: The approximate number of subscribers to the YouTube channel. - `youtubeVideoMetadata` GoogleAdsSearchads360V23CommonYouTubeVideoAttributeMetadata: Metadata for a YouTube video attribute. - `commentsCount` string, int64: The total number of comments. - `likesCount` string, int64: The total number of likes. - `publishDate` string: The date that the video was created. Formatted as "yyyy-mm-dd". - `thumbnailUrl` string: The URL of the video thumbnail, prefixed by "https://img.youtube.com/". - `videoProperties` string[]: The properties of this video (such as shorts, live stream). - `videoUrl` string: The URL of the video, prefixed by "https://www.youtube.com/". - `viewsCount` string, int64: The total number of views. - `metrics` GoogleAdsSearchads360V23ServicesAudienceCompositionMetrics: The share and index metrics associated with an attribute in an audience composition insights report. - `audienceShare` number, double: The fraction (from 0 to 1 inclusive) of the specific audience that match the attribute. - `baselineAudienceShare` number, double: The fraction (from 0 to 1 inclusive) of the baseline audience that match the attribute. - `index` number, double: The ratio of audience_share to baseline_audience_share, or zero if this ratio is undefined or is not meaningful. - `score` number, double: A relevance score from 0 to 1 inclusive. - `clusterDisplayName` string: The name of this cluster of attributes - `clusterMetrics` GoogleAdsSearchads360V23ServicesAudienceCompositionMetrics: The share and index metrics associated with an attribute in an audience composition insights report. - `audienceShare` number, double: The fraction (from 0 to 1 inclusive) of the specific audience that match the attribute. - `baselineAudienceShare` number, double: The fraction (from 0 to 1 inclusive) of the baseline audience that match the attribute. - `index` number, double: The ratio of audience_share to baseline_audience_share, or zero if this ratio is undefined or is not meaningful. - `score` number, double: A relevance score from 0 to 1 inclusive. - `dimension` 'UNSPECIFIED' | 'UNKNOWN' | 'CATEGORY' | 'KNOWLEDGE_GRAPH' | 'GEO_TARGET_COUNTRY' | 'SUB_COUNTRY_LOCATION' | 'YOUTUBE_CHANNEL' | 'AFFINITY_USER_INTEREST' | 'IN_MARKET_USER_INTEREST' | 'PARENTAL_STATUS' | 'INCOME_RANGE' | 'AGE_RANGE' | 'GENDER' | 'YOUTUBE_VIDEO' | 'DEVICE' | 'YOUTUBE_LINEUP' | 'USER_LIST' | 'LIFE_EVENT_USER_INTEREST': The type of the attributes in this section. - `topAttributes` GoogleAdsSearchads360V23ServicesAudienceCompositionAttribute[]: The most relevant segments for this audience. If dimension is GENDER, AGE_RANGE or PARENTAL_STATUS, then this list of attributes is exhaustive. - `attributeMetadata` GoogleAdsSearchads360V23CommonAudienceInsightsAttributeMetadata: An audience attribute, with metadata about it, returned in response to a search. - `attribute` GoogleAdsSearchads360V23CommonAudienceInsightsAttribute: An audience attribute that can be used to request insights about the audience. - `ageRange` GoogleAdsSearchads360V23CommonAgeRangeInfo: An age range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED': Type of the age range. - `category` GoogleAdsSearchads360V23CommonAudienceInsightsCategory: A Product and Service category. - `categoryId` string: Required. The criterion ID of the category. - `device` GoogleAdsSearchads360V23CommonDeviceInfo: A device criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER': Type of the device. - `entity` GoogleAdsSearchads360V23CommonAudienceInsightsEntity: A Knowledge Graph entity, represented by its machine id. - `knowledgeGraphMachineId` string: Required. The machine ID (mid) of the Knowledge Graph entity. - `gender` GoogleAdsSearchads360V23CommonGenderInfo: A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED': Type of the gender. - `incomeRange` GoogleAdsSearchads360V23CommonIncomeRangeInfo: An income range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED': Type of the income range. - `lineup` GoogleAdsSearchads360V23CommonAudienceInsightsLineup: A YouTube Lineup. - `lineupId` string: Required. The numeric ID of the lineup. - `location` GoogleAdsSearchads360V23CommonLocationInfo: A location criterion. - `geoTargetConstant` string: The geo target constant resource name. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo: A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED': Type of the parental status. - `userInterest` GoogleAdsSearchads360V23CommonUserInterestInfo: Represents a particular interest-based topic to be targeted. - `userInterestCategory` string: The UserInterest resource name. - `userList` GoogleAdsSearchads360V23CommonUserListInfo: A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string: The User List resource name. - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo: A YouTube Channel criterion. - `channelId` string: The YouTube uploader channel id or the channel code of a YouTube channel. - `youtubeVideo` GoogleAdsSearchads360V23CommonYouTubeVideoInfo: A YouTube Video criterion. - `videoId` string: YouTube video id as it appears on the YouTube watch page. - `dimension` 'UNSPECIFIED' | 'UNKNOWN' | 'CATEGORY' | 'KNOWLEDGE_GRAPH' | 'GEO_TARGET_COUNTRY' | 'SUB_COUNTRY_LOCATION' | 'YOUTUBE_CHANNEL' | 'AFFINITY_USER_INTEREST' | 'IN_MARKET_USER_INTEREST' | 'PARENTAL_STATUS' | 'INCOME_RANGE' | 'AGE_RANGE' | 'GENDER' | 'YOUTUBE_VIDEO' | 'DEVICE' | 'YOUTUBE_LINEUP' | 'USER_LIST' | 'LIFE_EVENT_USER_INTEREST': The type of the attribute. - `displayInfo` string: A string that supplements the display_name to identify the attribute. If the dimension is TOPIC, this is a brief description of the Knowledge Graph entity, such as "American singer-songwriter". If the dimension is CATEGORY, this is the complete path to the category in The Product & Service taxonomy, for example "/Apparel/Clothing/Outerwear". - `displayName` string: The human-readable name of the attribute. - `knowledgeGraphAttributeMetadata` GoogleAdsSearchads360V23CommonKnowledgeGraphAttributeMetadata: Metadata associated with a Knowledge Graph Entity attribute. - `entityCapabilities` string[]: The capabilities of the entity used in ContentCreatorInsightsService. - `relatedCategories` GoogleAdsSearchads360V23CommonAudienceInsightsAttributeMetadata[]: A list of CATEGORY attributes related to this entity. - `lineupAttributeMetadata` GoogleAdsSearchads360V23CommonLineupAttributeMetadata: Metadata associated with a Lineup attribute. - `channelCountLowerBound` string, int64: The lower end of a range containing the number of channels in the lineup. - `channelCountUpperBound` string, int64: The upper end of a range containing the number of channels in the lineup. - `inventoryCountry` GoogleAdsSearchads360V23CommonLocationInfo: A location criterion. - `geoTargetConstant` string: The geo target constant resource name. - `medianMonthlyInventory` string, int64: The median number of impressions per month on this lineup. - `sampleChannels` GoogleAdsSearchads360V23CommonLineupAttributeMetadataSampleChannel[]: Examples of channels that are included in the lineup. - `displayName` string: The name of the sample channel. - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo: A YouTube Channel criterion. - … - `youtubeChannelMetadata` GoogleAdsSearchads360V23CommonYouTubeChannelAttributeMetadata: Metadata associated with a YouTube channel attribute. - … - `locationAttributeMetadata` GoogleAdsSearchads360V23CommonLocationAttributeMetadata: Metadata associated with a Location attribute. - `countryLocation` GoogleAdsSearchads360V23CommonLocationInfo: A location criterion. - `geoTargetConstant` string: The geo target constant resource name. - `potentialYoutubeReach` string, int64: An estimate of the number of reachable YouTube users matching this attribute in the requested location, or zero if that information is not available for this attribute. This field is not populated in every response. - `subscriberShare` number, double: The share of subscribers within this attribute, between and including 0 and 1. This field is not populated in every response. - `userInterestAttributeMetadata` GoogleAdsSearchads360V23CommonUserInterestAttributeMetadata: Metadata associated with a User Interest attribute. - `userInterestDescription` string: English language text description of the user interest category (200 characters max). - `userListAttributeMetadata` GoogleAdsSearchads360V23CommonUserListAttributeMetadata: Metadata associated with a User List attribute. - `userListType` 'UNSPECIFIED' | 'UNKNOWN' | 'REMARKETING' | 'LOGICAL' | 'EXTERNAL_REMARKETING' | 'RULE_BASED' | 'SIMILAR' | 'CRM_BASED' | 'LOOKALIKE': The user list type. - `viewerShare` number, double: The share of viewers within this attribute, between and including 0 and 1. This field is not populated in every response. - `youtubeChannelMetadata` GoogleAdsSearchads360V23CommonYouTubeChannelAttributeMetadata: Metadata associated with a YouTube channel attribute. - `subscriberCount` string, int64: The approximate number of subscribers to the YouTube channel. - `youtubeVideoMetadata` GoogleAdsSearchads360V23CommonYouTubeVideoAttributeMetadata: Metadata for a YouTube video attribute. - `commentsCount` string, int64: The total number of comments. - `likesCount` string, int64: The total number of likes. - `publishDate` string: The date that the video was created. Formatted as "yyyy-mm-dd". - `thumbnailUrl` string: The URL of the video thumbnail, prefixed by "https://img.youtube.com/". - `videoProperties` string[]: The properties of this video (such as shorts, live stream). - `videoUrl` string: The URL of the video, prefixed by "https://www.youtube.com/". - `viewsCount` string, int64: The total number of views. - `metrics` GoogleAdsSearchads360V23ServicesAudienceCompositionMetrics: The share and index metrics associated with an attribute in an audience composition insights report. - `audienceShare` number, double: The fraction (from 0 to 1 inclusive) of the specific audience that match the attribute. - `baselineAudienceShare` number, double: The fraction (from 0 to 1 inclusive) of the baseline audience that match the attribute. - `index` number, double: The ratio of audience_share to baseline_audience_share, or zero if this ratio is undefined or is not meaningful. - `score` number, double: A relevance score from 0 to 1 inclusive. --- [API](https://skmtc.dev/google/apis/searchads360.md) - [All operations](https://skmtc.dev/google/apis/searchads360/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/searchads360/revisions/4a4511f84b18?raw)