Opus Growth

List Audiences

Lists the account's audiences (remarketing / rule-based / customer-match / lookalike): id, name, type, membership status, membership duration (days), Display/Search network size.

Tipo
Somente leitura
Créditos
1
Plataforma
Google Ads
Aprovação
Não precisa, nada muda

O que faz

Lists the account's audiences (remarketing / rule-based / customer-match / lookalike): id, name, type, membership status, membership duration (days), Display/Search network size.

definition=true also returns WHAT DEFINES each list, which the name alone does not tell you and which you need before attaching or — far more dangerous — EXCLUDING one: for a RULE_BASED list the URL/event rule items with their operators and lookback window; for a LOGICAL/COMBINED list the constituent lists resolved to NAMES with their ANY/ALL/NONE operator; for a SIMILAR list the seed list; for CRM_BASED the upload key and data source. Excluding a list that turns out to be "anyone who reached any thank-you page" silently suppresses real prospects, so check the rule rather than trusting the name. Google does NOT store a readable rule for every list — older ones come back with definition_available=false, and then the Google Ads interface (Tools, Audience manager) is the only place to read it. Every audience is retained: limit controls only this response page and page_token continues from cache without a new query or credit. Read-only.

A descrição está em inglês porque é o texto oficial que sua IA vê.

MCP: list_audiences

Como usar

Você não chama as ferramentas pelo nome. Escreva o que quer no ChatGPT, Claude ou outro assistente conectado ao Opus Growth; a IA escolhe esta ferramenta quando ela serve.

Parâmetros

NomeTipoObrigatórioPadrão
customer_idstringObrigatório·Google Ads customer account ID to query or change. Use the numeric ID returned by list_accounts; omit separators unless this tool explicitly says otherwise.
limitintegerOpcional0Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete.
definitionbooleanOpcionalfalseWhether to enable definition for this operation.
page_tokenstringOpcional·Continuation token returned as next_page_token by a previous call. Leave empty for the first page; pass it unchanged to retrieve the cached next page.