Campaign Manager 360 API API

by googleapis.com

Overview

Build applications to efficiently manage large or complex trafficking, reporting, and attribution workflows for Campaign Manager 360.

Campaign Manager 360 API is an analytics API from googleapis.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 205 endpoints.

At a glance

Authentication: OAuth
HTTPS: Yes
CORS: Unknown
Category: Analytics
Base URL: https://dfareporting.googleapis.com/dfareporting/v3.4
Version: v3.4
Endpoints: 205
OpenAPI: Specification ↗
Spec updated: 2023-02-28

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://dfareporting.googleapis.com/dfareporting/v3.4/userprofiles" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

JavaScript

const response = await fetch("https://dfareporting.googleapis.com/dfareporting/v3.4/userprofiles", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://dfareporting.googleapis.com/dfareporting/v3.4/userprofiles",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
GET	`/reports/{reportId}/files/{fileId}`	Retrieves a report file by its report ID and file ID. This method supports media download.
GET	`/userprofiles`	Retrieves list of user profiles for a user.
GET	`/userprofiles/{profileId}`	Gets one user profile by ID.
GET	`/userprofiles/{profileId}/accountActiveAdSummaries/{summaryAccountId}`	Gets the account's active ad summary by account ID.
GET	`/userprofiles/{profileId}/accountPermissionGroups`	Retrieves the list of account permission groups.
GET	`/userprofiles/{profileId}/accountPermissionGroups/{id}`	Gets one account permission group by ID.
GET	`/userprofiles/{profileId}/accountPermissions`	Retrieves the list of account permissions.
GET	`/userprofiles/{profileId}/accountPermissions/{id}`	Gets one account permission by ID.
GET	`/userprofiles/{profileId}/accountUserProfiles`	Retrieves a list of account user profiles, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/accountUserProfiles`	Inserts a new account user profile.
PUT	`/userprofiles/{profileId}/accountUserProfiles`	Updates an existing account user profile.
PATCH	`/userprofiles/{profileId}/accountUserProfiles`	Updates an existing account user profile. This method supports patch semantics.
GET	`/userprofiles/{profileId}/accountUserProfiles/{id}`	Gets one account user profile by ID.
GET	`/userprofiles/{profileId}/accounts`	Retrieves the list of accounts, possibly filtered. This method supports paging.
PUT	`/userprofiles/{profileId}/accounts`	Updates an existing account.
PATCH	`/userprofiles/{profileId}/accounts`	Updates an existing account. This method supports patch semantics.
GET	`/userprofiles/{profileId}/accounts/{id}`	Gets one account by ID.
GET	`/userprofiles/{profileId}/ads`	Retrieves a list of ads, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/ads`	Inserts a new ad.
PUT	`/userprofiles/{profileId}/ads`	Updates an existing ad.
PATCH	`/userprofiles/{profileId}/ads`	Updates an existing ad. This method supports patch semantics.
GET	`/userprofiles/{profileId}/ads/{id}`	Gets one ad by ID.
GET	`/userprofiles/{profileId}/advertiserGroups`	Retrieves a list of advertiser groups, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/advertiserGroups`	Inserts a new advertiser group.
PUT	`/userprofiles/{profileId}/advertiserGroups`	Updates an existing advertiser group.
PATCH	`/userprofiles/{profileId}/advertiserGroups`	Updates an existing advertiser group. This method supports patch semantics.
GET	`/userprofiles/{profileId}/advertiserGroups/{id}`	Gets one advertiser group by ID.
DELETE	`/userprofiles/{profileId}/advertiserGroups/{id}`	Deletes an existing advertiser group.
GET	`/userprofiles/{profileId}/advertiserLandingPages`	Retrieves a list of landing pages.
POST	`/userprofiles/{profileId}/advertiserLandingPages`	Inserts a new landing page.
PUT	`/userprofiles/{profileId}/advertiserLandingPages`	Updates an existing landing page.
PATCH	`/userprofiles/{profileId}/advertiserLandingPages`	Updates an existing advertiser landing page. This method supports patch semantics.
GET	`/userprofiles/{profileId}/advertiserLandingPages/{id}`	Gets one landing page by ID.
GET	`/userprofiles/{profileId}/advertisers`	Retrieves a list of advertisers, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/advertisers`	Inserts a new advertiser.
PUT	`/userprofiles/{profileId}/advertisers`	Updates an existing advertiser.
PATCH	`/userprofiles/{profileId}/advertisers`	Updates an existing advertiser. This method supports patch semantics.
GET	`/userprofiles/{profileId}/advertisers/{id}`	Gets one advertiser by ID.
GET	`/userprofiles/{profileId}/browsers`	Retrieves a list of browsers.
GET	`/userprofiles/{profileId}/campaigns`	Retrieves a list of campaigns, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/campaigns`	Inserts a new campaign.
PUT	`/userprofiles/{profileId}/campaigns`	Updates an existing campaign.
PATCH	`/userprofiles/{profileId}/campaigns`	Updates an existing campaign. This method supports patch semantics.
GET	`/userprofiles/{profileId}/campaigns/{campaignId}/campaignCreativeAssociations`	Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.
POST	`/userprofiles/{profileId}/campaigns/{campaignId}/campaignCreativeAssociations`	Associates a creative with the specified campaign. This method creates a default ad with dimensions matching the creative in the campaign if such a default ad d
GET	`/userprofiles/{profileId}/campaigns/{id}`	Gets one campaign by ID.
GET	`/userprofiles/{profileId}/changeLogs`	Retrieves a list of change logs. This method supports paging.
GET	`/userprofiles/{profileId}/changeLogs/{id}`	Gets one change log by ID.
GET	`/userprofiles/{profileId}/cities`	Retrieves a list of cities, possibly filtered.
GET	`/userprofiles/{profileId}/connectionTypes`	Retrieves a list of connection types.
GET	`/userprofiles/{profileId}/connectionTypes/{id}`	Gets one connection type by ID.
GET	`/userprofiles/{profileId}/contentCategories`	Retrieves a list of content categories, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/contentCategories`	Inserts a new content category.
PUT	`/userprofiles/{profileId}/contentCategories`	Updates an existing content category.
PATCH	`/userprofiles/{profileId}/contentCategories`	Updates an existing content category. This method supports patch semantics.
GET	`/userprofiles/{profileId}/contentCategories/{id}`	Gets one content category by ID.
DELETE	`/userprofiles/{profileId}/contentCategories/{id}`	Deletes an existing content category.
POST	`/userprofiles/{profileId}/conversions/batchinsert`	Inserts conversions.
POST	`/userprofiles/{profileId}/conversions/batchupdate`	Updates existing conversions.
GET	`/userprofiles/{profileId}/countries`	Retrieves a list of countries.
GET	`/userprofiles/{profileId}/countries/{dartId}`	Gets one country by ID.
POST	`/userprofiles/{profileId}/creativeAssets/{advertiserId}/creativeAssets`	Inserts a new creative asset.
GET	`/userprofiles/{profileId}/creativeFields`	Retrieves a list of creative fields, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/creativeFields`	Inserts a new creative field.
PUT	`/userprofiles/{profileId}/creativeFields`	Updates an existing creative field.
PATCH	`/userprofiles/{profileId}/creativeFields`	Updates an existing creative field. This method supports patch semantics.
GET	`/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues`	Retrieves a list of creative field values, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues`	Inserts a new creative field value.
PUT	`/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues`	Updates an existing creative field value.
PATCH	`/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues`	Updates an existing creative field value. This method supports patch semantics.
GET	`/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues/{id}`	Gets one creative field value by ID.
DELETE	`/userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues/{id}`	Deletes an existing creative field value.
GET	`/userprofiles/{profileId}/creativeFields/{id}`	Gets one creative field by ID.
DELETE	`/userprofiles/{profileId}/creativeFields/{id}`	Deletes an existing creative field.
GET	`/userprofiles/{profileId}/creativeGroups`	Retrieves a list of creative groups, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/creativeGroups`	Inserts a new creative group.
PUT	`/userprofiles/{profileId}/creativeGroups`	Updates an existing creative group.
PATCH	`/userprofiles/{profileId}/creativeGroups`	Updates an existing creative group. This method supports patch semantics.
GET	`/userprofiles/{profileId}/creativeGroups/{id}`	Gets one creative group by ID.
GET	`/userprofiles/{profileId}/creatives`	Retrieves a list of creatives, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/creatives`	Inserts a new creative.
PUT	`/userprofiles/{profileId}/creatives`	Updates an existing creative.
PATCH	`/userprofiles/{profileId}/creatives`	Updates an existing creative. This method supports patch semantics.
GET	`/userprofiles/{profileId}/creatives/{id}`	Gets one creative by ID.
POST	`/userprofiles/{profileId}/customEvents/batchinsert`	Inserts custom events.
POST	`/userprofiles/{profileId}/dimensionvalues/query`	Retrieves list of report dimension values for a list of filters.
GET	`/userprofiles/{profileId}/directorySites`	Retrieves a list of directory sites, possibly filtered. This method supports paging.
POST	`/userprofiles/{profileId}/directorySites`	Inserts a new directory site.
GET	`/userprofiles/{profileId}/directorySites/{id}`	Gets one directory site by ID.
GET	`/userprofiles/{profileId}/dynamicTargetingKeys`	Retrieves a list of dynamic targeting keys.
POST	`/userprofiles/{profileId}/dynamicTargetingKeys`	Inserts a new dynamic targeting key. Keys must be created at the advertiser level before being assigned to the advertiser's ads, creatives, or placements. There
DELETE	`/userprofiles/{profileId}/dynamicTargetingKeys/{objectId}`	Deletes an existing dynamic targeting key.
GET	`/userprofiles/{profileId}/eventTags`	Retrieves a list of event tags, possibly filtered.
POST	`/userprofiles/{profileId}/eventTags`	Inserts a new event tag.
PUT	`/userprofiles/{profileId}/eventTags`	Updates an existing event tag.
PATCH	`/userprofiles/{profileId}/eventTags`	Updates an existing event tag. This method supports patch semantics.
GET	`/userprofiles/{profileId}/eventTags/{id}`	Gets one event tag by ID.
DELETE	`/userprofiles/{profileId}/eventTags/{id}`	Deletes an existing event tag.
GET	`/userprofiles/{profileId}/files`	Lists files for a user profile.
GET	`/userprofiles/{profileId}/floodlightActivities`	Retrieves a list of floodlight activities, possibly filtered. This method supports paging.

Showing the first 100 of 205 endpoints; the full list is in the documentation.

Questions

Does the Campaign Manager 360 API API need an API key?

Yes. The Campaign Manager 360 API API uses OAuth authentication; the documentation explains how to get credentials.

Does the Campaign Manager 360 API API support HTTPS?

Yes, the Campaign Manager 360 API API is served over HTTPS.

How many endpoints does the Campaign Manager 360 API API have?

Its OpenAPI description lists 205 endpoints in version v3.4. The first 100 are shown on this page.

What are alternatives to the Campaign Manager 360 API API?

Other Analytics APIs include Google Play Integrity API, versionhistory.googleapis.com API, Doc Converter, Perspective Comment Analyzer API, Safe Browsing API.

Compare alternatives →

Google Play Integrity API

Analytics

The Play Integrity API helps you check that you're interacting with your genuine app on a genuine Android device powered by Google Play services. The Play Integrity API has replaced SafetyNet Attestation and Android Device Verification.

OAuth1 endpoints

versionhistory.googleapis.com API

Analytics

Version History API - Prod

No auth4 endpoints

Doc Converter

Analytics

This api converts file formats of OpenXml and OpenOffice documents formats to vector files (e.g., svg)

No auth1 endpoints

Perspective Comment Analyzer API

Analytics

The Perspective Comment Analyzer API provides information about the potential impact of a comment on a conversation (e.g. it can provide a score for the "toxicity" of a comment). Users can leverage the "SuggestCommentScore" method to submit corrections to improve Perspective over time. Users can set the "doNotStore" flag to ensure that all submitted comments are automatically deleted after scores are returned.

OAuth2 endpoints

Safe Browsing API

Analytics

Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes – meaning “for sale or revenue-generating purposes” – please refer to the Web Risk API.

No auth7 endpoints

Web Fonts Developer API

Analytics

The Google Web Fonts Developer API lets you retrieve information about web fonts served by Google.

No auth1 endpoints

Listed from APIs.guru (CC0).

Overview

At a glance

Make a first request

Endpoints

Questions

Similar analytics APIs

Google Play Integrity API

versionhistory.googleapis.com API

Doc Converter

Perspective Comment Analyzer API

Safe Browsing API

Web Fonts Developer API