Build applications to efficiently manage large or complex trafficking, reporting, and attribution workflows for Campaign Manager 360.
Service: dfareporting.googleapis.com
To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.
Discovery document
A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:
Service endpoint
A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:
https://dfareporting.googleapis.com
REST Resource: v4.accountActiveAdSummaries
Methods | |
---|---|
get |
GET / Gets the account's active ad summary by account ID. |
REST Resource: v4.accountPermissionGroups
REST Resource: v4.accountPermissions
REST Resource: v4.accountUserProfiles
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/accountUserProfiles/{id} Gets one account user profile by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/accountUserProfiles Inserts a new account user profile. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/accountUserProfiles Retrieves a list of account user profiles, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/accountUserProfiles Updates an existing account user profile. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/accountUserProfiles Updates an existing account user profile. |
REST Resource: v4.accounts
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/accounts/{id} Gets one account by ID. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/accounts Retrieves the list of accounts, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/accounts Updates an existing account. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/accounts Updates an existing account. |
REST Resource: v4.ads
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/ads/{id} Gets one ad by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/ads Inserts a new ad. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/ads Retrieves a list of ads, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/ads Updates an existing ad. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/ads Updates an existing ad. |
REST Resource: v4.advertiserGroups
Methods | |
---|---|
delete |
DELETE /dfareporting/v4/userprofiles/{profileId}/advertiserGroups/{id} Deletes an existing advertiser group. |
get |
GET /dfareporting/v4/userprofiles/{profileId}/advertiserGroups/{id} Gets one advertiser group by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/advertiserGroups Inserts a new advertiser group. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/advertiserGroups Retrieves a list of advertiser groups, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/advertiserGroups Updates an existing advertiser group. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/advertiserGroups Updates an existing advertiser group. |
REST Resource: v4.advertiserInvoices
Methods | |
---|---|
list |
GET /dfareporting/v4/userprofiles/{profileId}/advertisers/{advertiserId}/invoices Retrieves a list of invoices for a particular issue month. |
REST Resource: v4.advertiserLandingPages
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/advertiserLandingPages/{id} Gets one landing page by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/advertiserLandingPages Inserts a new landing page. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/advertiserLandingPages Retrieves a list of landing pages. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/advertiserLandingPages Updates an existing advertiser landing page. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/advertiserLandingPages Updates an existing landing page. |
REST Resource: v4.advertisers
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/advertisers/{id} Gets one advertiser by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/advertisers Inserts a new advertiser. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/advertisers Retrieves a list of advertisers, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/advertisers Updates an existing advertiser. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/advertisers Updates an existing advertiser. |
REST Resource: v4.billingAssignments
Methods | |
---|---|
insert |
POST /dfareporting/v4/userprofiles/{profileId}/billingProfiles/{billingProfileId}/billingAssignments Inserts a new billing assignment and returns the new assignment. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/billingProfiles/{billingProfileId}/billingAssignments Retrieves a list of billing assignments. |
REST Resource: v4.billingProfiles
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/billingProfiles/{id} Gets one billing profile by ID. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/billingProfiles Retrieves a list of billing profiles, possibly filtered. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/billingProfiles Updates an existing billing profile. |
REST Resource: v4.billingRates
Methods | |
---|---|
list |
GET /dfareporting/v4/userprofiles/{profileId}/billingProfiles/{billingProfileId}/billingRates Retrieves a list of billing rates. |
REST Resource: v4.browsers
Methods | |
---|---|
list |
GET /dfareporting/v4/userprofiles/{profileId}/browsers Retrieves a list of browsers. |
REST Resource: v4.campaignCreativeAssociations
Methods | |
---|---|
insert |
POST /dfareporting/v4/userprofiles/{profileId}/campaigns/{campaignId}/campaignCreativeAssociations Associates a creative with the specified campaign. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/campaigns/{campaignId}/campaignCreativeAssociations Retrieves the list of creative IDs associated with the specified campaign. |
REST Resource: v4.campaigns
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/campaigns/{id} Gets one campaign by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/campaigns Inserts a new campaign. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/campaigns Retrieves a list of campaigns, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/campaigns Updates an existing campaign. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/campaigns Updates an existing campaign. |
REST Resource: v4.changeLogs
REST Resource: v4.cities
Methods | |
---|---|
list |
GET /dfareporting/v4/userprofiles/{profileId}/cities Retrieves a list of cities, possibly filtered. |
REST Resource: v4.connectionTypes
REST Resource: v4.contentCategories
Methods | |
---|---|
delete |
DELETE /dfareporting/v4/userprofiles/{profileId}/contentCategories/{id} Deletes an existing content category. |
get |
GET /dfareporting/v4/userprofiles/{profileId}/contentCategories/{id} Gets one content category by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/contentCategories Inserts a new content category. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/contentCategories Retrieves a list of content categories, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/contentCategories Updates an existing content category. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/contentCategories Updates an existing content category. |
REST Resource: v4.conversions
Methods | |
---|---|
batchinsert |
POST /dfareporting/v4/userprofiles/{profileId}/conversions/batchinsert Inserts conversions. |
batchupdate |
POST /dfareporting/v4/userprofiles/{profileId}/conversions/batchupdate Updates existing conversions. |
REST Resource: v4.countries
REST Resource: v4.creativeAssets
Methods | |
---|---|
insert |
POST /dfareporting/v4/userprofiles/{profileId}/creativeAssets/{advertiserId}/creativeAssets POST /upload/dfareporting/v4/userprofiles/{profileId}/creativeAssets/{advertiserId}/creativeAssets Inserts a new creative asset. |
REST Resource: v4.creativeFieldValues
Methods | |
---|---|
delete |
DELETE /dfareporting/v4/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues/{id} Deletes an existing creative field value. |
get |
GET /dfareporting/v4/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues/{id} Gets one creative field value by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues Inserts a new creative field value. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues Retrieves a list of creative field values, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues Updates an existing creative field value. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues Updates an existing creative field value. |
REST Resource: v4.creativeFields
Methods | |
---|---|
delete |
DELETE /dfareporting/v4/userprofiles/{profileId}/creativeFields/{id} Deletes an existing creative field. |
get |
GET /dfareporting/v4/userprofiles/{profileId}/creativeFields/{id} Gets one creative field by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/creativeFields Inserts a new creative field. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/creativeFields Retrieves a list of creative fields, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/creativeFields Updates an existing creative field. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/creativeFields Updates an existing creative field. |
REST Resource: v4.creativeGroups
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/creativeGroups/{id} Gets one creative group by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/creativeGroups Inserts a new creative group. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/creativeGroups Retrieves a list of creative groups, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/creativeGroups Updates an existing creative group. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/creativeGroups Updates an existing creative group. |
REST Resource: v4.creatives
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/creatives/{id} Gets one creative by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/creatives Inserts a new creative. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/creatives Retrieves a list of creatives, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/creatives Updates an existing creative. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/creatives Updates an existing creative. |
REST Resource: v4.dimensionValues
Methods | |
---|---|
query |
POST /dfareporting/v4/userprofiles/{profileId}/dimensionvalues/query Retrieves list of report dimension values for a list of filters. |
REST Resource: v4.directorySites
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/directorySites/{id} Gets one directory site by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/directorySites Inserts a new directory site. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/directorySites Retrieves a list of directory sites, possibly filtered. |
REST Resource: v4.dynamicTargetingKeys
Methods | |
---|---|
delete |
DELETE /dfareporting/v4/userprofiles/{profileId}/dynamicTargetingKeys/{objectId} Deletes an existing dynamic targeting key. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/dynamicTargetingKeys Inserts a new dynamic targeting key. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/dynamicTargetingKeys Retrieves a list of dynamic targeting keys. |
REST Resource: v4.eventTags
Methods | |
---|---|
delete |
DELETE /dfareporting/v4/userprofiles/{profileId}/eventTags/{id} Deletes an existing event tag. |
get |
GET /dfareporting/v4/userprofiles/{profileId}/eventTags/{id} Gets one event tag by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/eventTags Inserts a new event tag. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/eventTags Retrieves a list of event tags, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/eventTags Updates an existing event tag. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/eventTags Updates an existing event tag. |
REST Resource: v4.files
REST Resource: v4.floodlightActivities
Methods | |
---|---|
delete |
DELETE /dfareporting/v4/userprofiles/{profileId}/floodlightActivities/{id} Deletes an existing floodlight activity. |
generatetag |
POST /dfareporting/v4/userprofiles/{profileId}/floodlightActivities/generatetag Generates a tag for a floodlight activity. |
get |
GET /dfareporting/v4/userprofiles/{profileId}/floodlightActivities/{id} Gets one floodlight activity by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/floodlightActivities Inserts a new floodlight activity. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/floodlightActivities Retrieves a list of floodlight activities, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/floodlightActivities Updates an existing floodlight activity. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/floodlightActivities Updates an existing floodlight activity. |
REST Resource: v4.floodlightActivityGroups
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/floodlightActivityGroups/{id} Gets one floodlight activity group by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/floodlightActivityGroups Inserts a new floodlight activity group. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/floodlightActivityGroups Retrieves a list of floodlight activity groups, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/floodlightActivityGroups Updates an existing floodlight activity group. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/floodlightActivityGroups Updates an existing floodlight activity group. |
REST Resource: v4.floodlightConfigurations
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/floodlightConfigurations/{id} Gets one floodlight configuration by ID. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/floodlightConfigurations Retrieves a list of floodlight configurations, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/floodlightConfigurations Updates an existing floodlight configuration. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/floodlightConfigurations Updates an existing floodlight configuration. |
REST Resource: v4.inventoryItems
REST Resource: v4.languages
Methods | |
---|---|
list |
GET /dfareporting/v4/userprofiles/{profileId}/languages Retrieves a list of languages. |
REST Resource: v4.metros
Methods | |
---|---|
list |
GET /dfareporting/v4/userprofiles/{profileId}/metros Retrieves a list of metros. |
REST Resource: v4.mobileApps
REST Resource: v4.mobileCarriers
REST Resource: v4.operatingSystemVersions
REST Resource: v4.operatingSystems
REST Resource: v4.orderDocuments
REST Resource: v4.orders
REST Resource: v4.placementGroups
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/placementGroups/{id} Gets one placement group by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/placementGroups Inserts a new placement group. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/placementGroups Retrieves a list of placement groups, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/placementGroups Updates an existing placement group. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/placementGroups Updates an existing placement group. |
REST Resource: v4.placementStrategies
Methods | |
---|---|
delete |
DELETE /dfareporting/v4/userprofiles/{profileId}/placementStrategies/{id} Deletes an existing placement strategy. |
get |
GET /dfareporting/v4/userprofiles/{profileId}/placementStrategies/{id} Gets one placement strategy by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/placementStrategies Inserts a new placement strategy. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/placementStrategies Retrieves a list of placement strategies, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/placementStrategies Updates an existing placement strategy. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/placementStrategies Updates an existing placement strategy. |
REST Resource: v4.placements
Methods | |
---|---|
generatetags |
POST /dfareporting/v4/userprofiles/{profileId}/placements/generatetags Generates tags for a placement. |
get |
GET /dfareporting/v4/userprofiles/{profileId}/placements/{id} Gets one placement by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/placements Inserts a new placement. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/placements Retrieves a list of placements, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/placements Updates an existing placement. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/placements Updates an existing placement. |
REST Resource: v4.platformTypes
REST Resource: v4.postalCodes
REST Resource: v4.projects
REST Resource: v4.regions
Methods | |
---|---|
list |
GET /dfareporting/v4/userprofiles/{profileId}/regions Retrieves a list of regions. |
REST Resource: v4.remarketingLists
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/remarketingLists/{id} Gets one remarketing list by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/remarketingLists Inserts a new remarketing list. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/remarketingLists Retrieves a list of remarketing lists, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/remarketingLists Updates an existing remarketing list. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/remarketingLists Updates an existing remarketing list. |
REST Resource: v4.reports
Methods | |
---|---|
delete |
DELETE /dfareporting/v4/userprofiles/{profileId}/reports/{reportId} Deletes a report by its ID. |
get |
GET /dfareporting/v4/userprofiles/{profileId}/reports/{reportId} Retrieves a report by its ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/reports Creates a report. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/reports Retrieves list of reports. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/reports/{reportId} Updates an existing report. |
run |
POST /dfareporting/v4/userprofiles/{profileId}/reports/{reportId}/run Runs a report. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/reports/{reportId} Updates a report. |
REST Resource: v4.reports.compatibleFields
Methods | |
---|---|
query |
POST /dfareporting/v4/userprofiles/{profileId}/reports/compatiblefields/query Returns the fields that are compatible to be selected in the respective sections of a report criteria, given the fields already selected in the input report and user permissions. |
REST Resource: v4.reports.files
REST Resource: v4.sites
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/sites/{id} Gets one site by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/sites Inserts a new site. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/sites Retrieves a list of sites, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/sites Updates an existing site. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/sites Updates an existing site. |
REST Resource: v4.sizes
REST Resource: v4.subaccounts
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/subaccounts/{id} Gets one subaccount by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/subaccounts Inserts a new subaccount. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/subaccounts Gets a list of subaccounts, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/subaccounts Updates an existing subaccount. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/subaccounts Updates an existing subaccount. |
REST Resource: v4.targetableRemarketingLists
REST Resource: v4.targetingTemplates
Methods | |
---|---|
get |
GET /dfareporting/v4/userprofiles/{profileId}/targetingTemplates/{id} Gets one targeting template by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/targetingTemplates Inserts a new targeting template. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/targetingTemplates Retrieves a list of targeting templates, optionally filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/targetingTemplates Updates an existing targeting template. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/targetingTemplates Updates an existing targeting template. |
REST Resource: v4.userProfiles
REST Resource: v4.userRolePermissionGroups
REST Resource: v4.userRolePermissions
REST Resource: v4.userRoles
Methods | |
---|---|
delete |
DELETE /dfareporting/v4/userprofiles/{profileId}/userRoles/{id} Deletes an existing user role. |
get |
GET /dfareporting/v4/userprofiles/{profileId}/userRoles/{id} Gets one user role by ID. |
insert |
POST /dfareporting/v4/userprofiles/{profileId}/userRoles Inserts a new user role. |
list |
GET /dfareporting/v4/userprofiles/{profileId}/userRoles Retrieves a list of user roles, possibly filtered. |
patch |
PATCH /dfareporting/v4/userprofiles/{profileId}/userRoles Updates an existing user role. |
update |
PUT /dfareporting/v4/userprofiles/{profileId}/userRoles Updates an existing user role. |