工具 API

adgroup_get

Gets detailed information for one or more ad groups from `/open_api/v1.3/adgroup/get/`. You can limit returned data with `fields` and filter results by campaign ID, objective, ad group ID, ad group name, creation time, billing event, status, and other supported filters. Deleted ad groups are excluded by default; to include them, set `filtering.primary_status` to `STATUS_DELETE` or use `ADGROUP_STATUS_DELETE` / `ADGROUP_STATUS_CAMPAIGN_DELETE` in `filtering.secondary_status`. If `fields` is omitted, all fields are returned. If `filtering` is omitted, all ad groups under the advertiser are returned.

ecommerceOAuth1 积分

调用信息

工具标识: tiktok-ads.adgroup_get
服务提供方: TikTok 广告
平均响应: 0 ms
近 7 天调用: 0

输入参数

advertiser_id必填

Advertiser ID.

exclude_field_types_in_response

Field types to exclude from the response.

fields

List of ad group fields to return. If omitted, all available fields are returned by default.

filtering

Filter conditions for selecting ad groups. If omitted, all ad groups under the advertiser are returned. Example: `filtering={"campaign_automation_type":"UPGRADED_SMART_PLUS"}`.

page

Current page number. Default: `1`. Value must be greater than or equal to 1.

page_size

Page size. Default: `10`. Range: `1`-`1000`. If `filtering.buying_types` is `RESERVATION_TOP_VIEW`, the maximum allowed value is `100`.