Googleapis Dfareporting
Googleapis Dfareporting is a connector for the Campaign Manager 360 reporting API, used to access digital advertising campaign reports and trafficking data.
- Base URL:
https://dfareporting.googleapis.com/dfareporting/v3.4 - Auth: OAuth 2.0 (user-delegated) — attach an InTouch
oauthcredential. Mint one withitcli.py /oauth <provider>(device-code) or/google-auth(Google); the server auto-refreshes the access token before each run, so the connector never handles or stores tokens.
Operations
dfareporting_files_get— GET /reports/{reportId}/files/{fileId} — Retrieves a report file by its report ID and file ID. This method supports mediadfareporting_userprofiles_list— GET /userprofiles — Retrieves list of user profiles for a user.dfareporting_userprofiles_get— GET /userprofiles/{profileId} — Gets one user profile by ID.dfareporting_accountactiveadsummaries_get— GET /userprofiles/{profileId}/accountActiveAdSummaries/{summaryAccountId} — Gets the account's active ad summary by account ID.dfareporting_accountpermissiongroups_list— GET /userprofiles/{profileId}/accountPermissionGroups — Retrieves the list of account permission groups.dfareporting_accountpermissiongroups_get— GET /userprofiles/{profileId}/accountPermissionGroups/{id} — Gets one account permission group by ID.
Inputs
- a linked
oauthcredential (no key inputs) — the server injects a freshAuthorization: Bearerfrom it operation— one of the operations above- path parameters when an operation's path contains
{...} query— optional JSON object of query paramsbody— JSON object for create/update ops
Example
operation: dfareporting_files_get
# (attach an 'oauth' credential to the task — no inline secrets)
Publishes
The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.
erroroperationresultstatus
Input Properties
Every property this tool accepts, from its own tool.iml.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
operation |
string | yes | — | One of: accounts_list, ads_list, cities_list, files_get, files_list, metros_list, regions_list, reports_list, sites_list, sizes_list, userprofiles_get, userprofiles_list |
fileId |
string | no | — | Path parameter fileId (required by some operations). |
profileId |
string | no | — | Path parameter profileId (required by some operations). |
reportId |
string | no | — | Path parameter reportId (required by some operations). |
query |
string | no | — | Query-string parameters as a JSON object string, e.g. {"limit": 50}. Parsed and url-encoded onto the request. |