Merchant Center conversion sources let you view conversion data from free listings, and from your website, in your merchant account. The Merchant API lets you manage conversion sources for your merchant account. For more information, see Manage conversion sources.
This page describes how you can migrate conversion sources management from Content API to Merchant API.
Requests
Here's a sample comparison of the Content API for Shopping to the Merchant Conversion Sources API for conversion sources requests:
Content API | Merchant API | |
---|---|---|
URL | GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/conversionSources/ {conversionSourceId} |
GET https://merchantapi.googleapis.com/conversions/v1beta/ {name} |
Identifiers | {merchantId}/conversionSources/ {conversionSourceId} |
{name} |
Methods
Here is what has changed for conversion sources methods in the Conversion Sources API:
Method | URL in Content API for Shopping | URL in Merchant API | Identifiers in Content API for Shopping | Identifiers in Merchant API | Description |
create |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/conversionSources |
POST https://merchantapi.googleapis.com/conversions/v1beta/accounts/ {parent}/conversionSources |
{merchantId} | {parent} | In Merchant API, propertyName is called property . |
update |
PATCH https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/conversionSources/ {conversionSourceId}
|
PATCH https://merchantapi.googleapis.com/conversions/v1beta/accounts/ {conversionSource.name}
|
{merchantId}/conversionSources/ {conversionSourceId}
|
{conversionSource.name} |
In Merchant API, destinationId is called destination .
|
delete
|
DELETE https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/conversionSources/ {conversionSourceId}
|
DELETE https://merchantapi.googleapis.com/conversions/v1beta/accounts/ {name} |
{merchantId}/conversionSources/ {conversionSourceId} |
{name} | In Merchant API, attributionLookbackWindowInDays is called attributionLookbackWindowDays .In Merchant API, includeInReporting is called report . |
undelete |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/conversionSources/ {conversionSourceId}:undelete
|
POST https://merchantapi.googleapis.com/conversions/v1beta/accounts/ {name}:undelete
|
{merchantId}/conversionSources/ {conversionSourceId} |
{name} | URL and identifiers are different in Merchant API. The Conversion Sources API returns ConversionSource instead of Empty .
|
get
|
GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/conversionSources/ {conversionSourceId}
|
GET https://merchantapi.googleapis.com/conversions/v1beta/accounts/ {name}
|
{merchantId}/conversionSources/ {conversionSourceId}
|
{name} | URL and identifiers are different in Merchant API. |
list
|
GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/conversionSources
|
GET https://merchantapi.googleapis.com/conversions/v1beta/ {parent}/conversionSources
|
{merchantId} | {parent} | URL and identifiers are different in Merchant API. |
Resources
The following table mentions the changes in conversion sources resources in the Conversion Sources API:
Content API for Shopping | Merchant API | Description |
googleAnalyticsLink: {
|
googleAnalyticsLink: {
|
In Merchant API, propertyName is called property .
|
merchantCenterDestination: {
|
merchantCenterDestination: {
|
In Merchant API, destinationId is called destination .
|
attributionSettings: {
|
attributionSettings: {
|
In Merchant API, attributionLookbackWindowInDays is called attributionLookbackWindowDays .
In Merchant API, |