--- title: "Retrieve a group" method: GET path: "/ads/{connection_id}/group/{id}" tags: ["ads", "group"] --- # Retrieve a group `GET /ads/{connection_id}/group/{id}` ## Path parameters - `connection_id` string, required - `id` string, required ## Query parameters - `fields` string[] - `raw` string ## Response `200` Successful - AdsGroup - `id` string - `created_at` string, date-time - `updated_at` string, date-time - `name` string - `parent_id` string - `campaign_id` string - `organization_id` string - `insertionorder_id` string - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED' - `effective_status` 'UNSPECIFIED' | 'SERVING' | 'LIMITED' | 'LEARNING' | 'PAUSED' | 'PENDING' | 'ENDED' | 'MISCONFIGURED' | 'NOT_ELIGIBLE' | 'ARCHIVED' | 'REMOVED' - `targeting` PropertyAdsGroupTargeting - `geographic` PropertyAdsGroupTargetingGeographic - `countries` TargetRef[] - `id` string - `name` string - `regions` TargetRef[] - `id` string - `name` string - `cities` CityTarget[] - `id` string, required - `name` string - `radius` number - `radius_unit` 'MILES' | 'KILOMETERS' - `postal_codes` TargetRef[] - `id` string - `name` string - `us_dmas` TargetRef[] - `id` string - `name` string - `excluded_countries` TargetRef[] - `id` string - `name` string - `excluded_regions` TargetRef[] - `id` string - `name` string - `excluded_cities` CityTarget[] - `id` string, required - `name` string - `radius` number - `radius_unit` 'MILES' | 'KILOMETERS' - `excluded_postal_codes` TargetRef[] - `id` string - `name` string - `excluded_us_dmas` TargetRef[] - `id` string - `name` string - `location_types` string[] - `presence_type` 'PRESENCE' | 'PRESENCE_OR_INTEREST' - `demographic` PropertyAdsGroupTargetingDemographic — Demographic targeting (Meta: age_min, age_max, genders) - `age_min` number - `age_max` number - `male` boolean - `female` boolean - `audience` PropertyAdsGroupTargetingAudience - `custom_audiences` TargetRef[] - `id` string - `name` string - `excluded_custom_audiences` TargetRef[] - `id` string - `name` string - `lookalike_audiences` LookalikeAudience[] - `id` string, required - `name` string - `similarity` number - `source_audience_id` string - `interests` TargetRef[] - `id` string - `name` string - `excluded_interests` TargetRef[] - `id` string - `name` string - `behaviors` TargetRef[] - `id` string - `name` string - `excluded_behaviors` TargetRef[] - `id` string - `name` string - `combination_spec` AudienceCombination[] - `interests` TargetRef[] - `id` string - `name` string - `behaviors` TargetRef[] - `id` string - `name` string - `references` TargetRef[] - `id` string - `name` string - `life_events` TargetRef[] - `id` string - `name` string - `placement` PropertyAdsGroupTargetingPlacement - `platforms` string[] - `facebook_positions` string[] - `instagram_positions` string[] - `messenger_positions` string[] - `audience_network_positions` string[] - `device` PropertyAdsGroupTargetingDevice - `types` TargetRef[] - `id` string - `name` string - `user_device` TargetRef[] - `id` string - `name` string - `user_os` TargetRef[] - `id` string - `name` string - `carriers` TargetRef[] - `id` string - `name` string - `language` TargetRef[] - `id` string - `name` string - `content` PropertyAdsGroupTargetingContent - `keywords` AdsKeyword[] - `text` string, required - `match_type` 'BROAD' | 'PHRASE' | 'EXACT' - `excluded_keywords` AdsKeyword[] - `text` string, required - `match_type` 'BROAD' | 'PHRASE' | 'EXACT' - `topics` TargetRef[] - `id` string - `name` string - `excluded_topics` TargetRef[] - `id` string - `name` string - `urls` string[] - `excluded_urls` string[] - `video` PropertyAdsGroupTargetingContentVideo - `youtube_videos` string[] - `excluded_youtube_videos` string[] - `youtube_channels` string[] - `excluded_youtube_channels` string[] - `positions` string[] - `player_sizes` string[] - `durations` string[] - `brand_safety` PropertyAdsGroupTargetingBrandSafety — Brand safety (Meta: excluded_publisher_categories, etc.; Google - `excluded_publisher_categories` string[] - `excluded_content_labels` string[] — Google Ads ContentLabelType - `brand_safety_content_filter_levels` string[] - `publisher_visibility_categories` string[] - `block_list_ids` string[] - `schedule` AdSchedule[] - `day_of_week` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required - `start_hour` number, required - `start_minute` number - `end_hour` number, required - `end_minute` number - `bid_modifier` number - `optimization` PropertyAdsGroupTargetingOptimization — Optimization (Meta: targeting_automation; Google: observation vs targeting mode) - `mode` 'TARGETING' | 'OBSERVATION' - `advantage_audience` boolean - `advantage_placements` boolean - `targeting_optimization_expansion_all` boolean - `bid_amount` number - `bid_strategy` PropertyAdsGroupBidStrategy — YOUTUBE_AND_PARTNERS - `type` 'FIXED_BID' | 'MAXIMIZE_SPEND' | 'PERFORMANCE_GOAL' | 'YOUTUBE_AND_PARTNERS', required - `fixed_bid_amount` number - `performance_goal_type` 'UNSPECIFIED' | 'CPA' | 'CPC' | 'VIEWABLE_CPM' | 'CUSTOM_ALGO' | 'CIVA' | 'IVO_TEN' | 'AV_VIEWED' | 'REACH' - `performance_goal_amount` number - `max_average_cpm_bid_amount` number - `custom_bidding_algorithm_id` string - `raise_bid_for_deals` boolean - `youtube_and_partners_type` 'UNSPECIFIED' | 'MANUAL_CPV' | 'MANUAL_CPM' | 'TARGET_CPA' | 'TARGET_CPM' | 'RESERVE_CPM' | 'MAXIMIZE_LIFT' | 'MAXIMIZE_CONVERSIONS' | 'TARGET_CPV' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSION_VALUE' - `youtube_and_partners_value` string - `target_roas` number - `budget_amount` number - `budget_period` 'DAILY' | 'MONTHLY' | 'TOTAL' | 'LIFETIME' - `budget_allocation_type` 'UNSPECIFIED' | 'AUTOMATIC' | 'FIXED' | 'UNLIMITED' - `start_at` string, date-time - `end_at` string, date-time - `budget_unit` 'UNSPECIFIED' | 'CURRENCY' | 'IMPRESSIONS' - `budget_max_amount` number - `type` 'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH' - `has_eu_political_ads` boolean - `pacing` PropertyAdsGroupPacing - `period` 'UNSPECIFIED' | 'DAILY' | 'FLIGHT' - `type` string - `daily_max_amount` number - `daily_max_impressions` number - `frequency_cap` PropertyAdsGroupFrequencyCap - `is_unlimited` boolean - `time_unit` 'UNSPECIFIED' | 'LIFETIME' | 'MONTHS' | 'WEEKS' | 'DAYS' | 'HOURS' | 'MINUTES' - `time_unit_count` number - `max_impressions` number - `max_views` number - `creative_ids` string[] - `optimization_goal` 'REACH' | 'IMPRESSIONS' | 'LINK_CLICKS' | 'LANDING_PAGE_VIEWS' | 'CONVERSIONS' | 'LEAD_GENERATION' | 'APP_INSTALLS' | 'APP_ENGAGEMENT' | 'VIDEO_VIEWS' | 'ENGAGEMENT' | 'PAGE_LIKES' | 'MESSAGES' - `billing_event` 'IMPRESSIONS' | 'LINK_CLICKS' | 'VIDEO_VIEWS' | 'APP_INSTALLS' | 'ENGAGEMENT' | 'PAGE_LIKES' | 'MESSAGES' | 'POST_ENGAGEMENT' | 'PURCHASE' | 'NONE' - `currency` string - `promoted` AdsPromoted[] - `id` string, required - `name` string - `type` 'PAGE_ID' | 'APP_ID' | 'STORE_URL' | 'PIXEL_ID' | 'CUSTOM_CONVERSION_ID' | 'CATALOG_ID' | 'PRODUCT_SET_ID' | 'PRIORITIZED_SET_ID' | 'EVENT_ID' | 'OFFER_ID' | 'LEAD_FORM_ID' | 'MESSAGING_CHANNEL_ID' | 'PRODUCT_ID' | 'TWEET_ID' | 'AD_GROUP_TYPE', required - `raw` object - `language_locale` string - `creative_selection` 'OPTIMIZED' | 'ROUND_ROBIN' - `raw` object --- [API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/versions/1f72720916e4/schema)