​
Setup Guide

You can find your Google app credentials by visiting your Google Cloud Console dashboard. You’ll need the following information to set up your Google App with Paragon Connect:
  • Client ID
  • Client Secret
  • Scopes Requested
Google Applications using scopes that permit access to certain user data must complete a verification process. Read more about Google’s various API scopes and procceses to verify your usage.

​
Add the Redirect URL to your Google app

Paragon provides a redirect URL to send information to your Google app. To add the redirect URL to your Google app:
  1. Copy the link under “Redirect URL” in your integration settings in Paragon. The Redirect URL is:
https://passport.useparagon.com/oauth
  1. In your Google Cloud Console dashboard, navigate to APIs & Services > Credentials in the sidebar.
  2. Press ”+ Create Credentials”, then select OAuth client ID.
  3. Select “Web application” from the Application type drop-down menu.
Note: You’ll need to configure Google’s consent screen for access to Client ID and Client Secret if you haven’t already.
  1. Under Authorized redirect URIs, press the ”+ Add URI” button.
  2. Paste-in the redirect URL from Paragon.
  3. Press the blue “Create” button.
Google provides you with the Client ID and Client Secret needed for the next steps after adding the redirect URL to your project.

​
Enable Google Campaign Manager 360 API in Google Cloud Console Dashboard

  1. In your Google Cloud Console dashboard, navigate to APIs & Services > Library in the sidebar.
  2. Search for “Google Campaign Manager 360” from the API Library.
  3. Select the “Google Campaign Manager 360 API”.
  4. Press the blue “Enable” button to enable the API for your application.

​
Add your Google app to Paragon

  1. Select Google Campaign Manager 360 from the Integrations Catalog.
  2. Under Integrations > Connected Integrations > Google Campaign Manager 360 > App Configuration > Configure, fill out your credentials from the end of Step 1 in their respective sections:
  • Client ID: Found at the end of Step 1.
  • Client Secret: Found at the end of Step 1.
  • Permissions: Select the scopes you’ve requested for your application. For a list of recommended scopes, please view this integration within your Paragon dashboard. View dashboard. They should begin with sheets.
Press the purple “Save Changes” button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.

​
Connecting to Google Campaign Manager 360

Once your users have connected their Google Campaign Manager 360 account, you can use the Paragon SDK to access the Google Campaign Manager 360 API on behalf of connected users. See the Google Campaign Manager 360 REST API documentation for their full API reference. Any Google Campaign Manager 360 API endpoints can be accessed with the Paragon SDK as shown in this example. 
// You can find your project ID in the Overview tab of any Integration

// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
            
// List accounts 
await paragon.request("googlecampaignmanager", "/userprofiles/{profileId}/accounts", { 
  method: "GET"
});
  
  
// Create ad
await paragon.request("googlecampaignmanager", "/userprofiles/{profileId}/ads", { 
  method: "POST",
  body: { 
    "accountId": <some-account-id>,
    "active": false,
    "advertiserId":  <some-advertiser-id>,
    "campaignId":  <some-campaign-id>,
    "endTime": new Date("2021-01-02").toISOString(),
    "startTime": new Date("2021-01-02").toISOString(),
    "name": "Ad name"
  } 
});

​
Building Google Campaign Manager 360 workflows

Once your Google Campaign Manager 360 account is connected, you can add steps to perform the following actions:
  • Create Ad
  • Update Ad
  • Get Ads
  • Get Ad by ID
  • Get Advertisers
  • Get Advertiser by ID
  • Create Campaign
  • Update Campaign
  • Get Creatives
  • Get Creative by ID
  • Create Creative Asset
  • Create Campaign Creative Association
  • Get Campaign Creative Association
  • Create Creative Group
  • Update Creative Group
  • Get Creative Groups
  • Get Creative Group by ID
  • Create Placement
  • Update Placement
  • Get Placements
  • Get Placement by ID
When creating or getting ads in Google Campaign Manager 360, you can reference data from previous steps by typing {{ to invoke the variable menu.

​
Publishing your Google Campaign Manager 360 application

​
Setting up a Redirect Page in your app

Your Google Campaign Manager 360 integration requires a Redirect Page hosted in your application to support verification of your application by Google. The Redirect Page should be implemented as follows:
  • Receives a GET request with a number of query parameters.
  • Redirect to https://passport.useparagon.com/oauth with the same query parameters.
paragon.connect("googlecampaignmanager", {
  overrideRedirectUrl: "https://your-app.url/google-campaign-manager-redirect"
});

​
Updating the allowed Redirect URL

If you were previously testing with https://passport.useparagon.com/oauth as your Google Campaign Manager 360 Redirect URL, you will need to update this value after implementing a Redirect Page:
  1. Log into your Google Cloud Console dashboard and select your application.
  2. Navigate to APIs & Services > Credentials and select the credentials you use with Paragon.
  3. Under Authorized redirect URIs, provide the URL of your Redirect Page.