The Google Ads API supports linking Google Ads accounts to other product accounts.
This guide explains how to use version v16 of the API to link your accounts.
Ways to link accounts
When linking a Google Ads account to another product account, there are two
different ways in which the linking can happen.
Invitation flow
Invitation flow is used when you have administrator access to the Google Ads
account, but not the product account. This flow works in two scenarios:
- You want to link the two accounts and create an invitation for an
administrator of the product account. The product account administrator
accepts the invitation to complete the account linking process.
- The product account administrator wants to link the two accounts, but
doesn't have access to the Google Ads account. The product account
administrator creates an invitation, and you accept the invitation and
complete the linking process.
The following methods are used in this scenario:
The following common errors can be thrown in this workflow:
Direct linking flow
Direct linking flow is used when you have administrator access to both the
Google Ads account and the product account. In this case, you directly link the
Google Ads account to the product account instead of sending an invitation.
The following methods are used in this scenario:
The following common errors may be thrown in this workflow:
Changes to AccountLinkService and MerchantCenterLinkService
If you used MerchantCenterLinkService or AccountLinkService in the past to link
a Google Ads account to another product account, then you need to migrate your
existing application to one of the workflows listed earlier. The following table
shows the migration status:
Link type
|
Supported in new services?
|
Support available as of
|
Remarks
|
DataPartnerIdentifier
|
Yes
|
v15
|
Migrate off MerchantCenterLinkService
|
GoogleAdsIdentifier
|
Yes
|
v16
|
Migrate off AccountLinkService
|
MerchantCenterIdentifier
|
Yes
|
v16
|
Migrate off AccountLinkService
|
AdvertisingPartnerIdentifier
|
Yes
|
v16
|
Migrate off AccountLinkService
|
ThirdPartyAppAnalyticsLinkIdentifier
|
No
|
?
|
Continue using AccountLinkService
|