MB SuiteMB Suite
Menu

Referência da API · Reports

Fontes de dados

reports · data_sources · 1 operação

GET/v1/reports/data-sources
GET/v1/reports/data-sources

List the data sources a report can read

reports.data_sources.list

LeituraIdempotenteDesde 2026-11-01

Lists the platform connections of the organization, or of one of its accounts (target_org_id), with the data_source_id that goes in a data_source_mapping or in a block's data_source_id (e.g. google_ads:1234567890), the display name, the external id, the account currency and whether it is inherited from the workspace. Filter by platforms. Use it before reports.instances.generate or reports.templates.deploy to map each slot of the template. Requires view access to Reports. With Google Ads, Google Business Profile, LinkedIn, TikTok or YouTube, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their records are left out of the response (the permissions guide lists what each platform allows).

Escopo
reports:read
Permissão
Ver o módulo
Tool do MCP
reports_data_sources_listNa superfície completa; na compacta, mb_execute_operation com id: "reports.data_sources.list".

Custo declarado: até 2 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

target_org_idstringqueryopcional

The connections of this account of the workspace (to map a report made for it); without it, this organization's.

platformsarray<enum>queryopcional

Only these platforms (google_ads, meta_ads, google_analytics, google_search_console, google_business_profile, facebook_page, instagram, tiktok_ads, tiktok, linkedin_ads, linkedin_page, youtube).

Valores: google_ads, meta_ads, google_analytics, google_search_console, google_business_profile, facebook_page, instagram, tiktok_ads, tiktok, linkedin_ads, linkedin_page, youtube

Resposta

dataarray<object>
has_morefalse

Erros

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Exemplo

curl "https://api.mb-suite.com/v1/reports/data-sources" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

curl "https://api.mb-suite.com/v1/reports/data-sources" \
  -H "Authorization: Bearer $MB_TEST_KEY"