Content API for Shopping에서 전환 소스 관리 이전하기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
판매자 센터 전환 소스를 사용하면 판매자 센터 계정에서 무료 등록정보 및 웹사이트의 전환 데이터를 확인할 수 있습니다. Merchant API를 사용하면 판매자 센터 계정의 전환 소스를 관리할 수 있습니다. 자세한 내용은 전환 소스 관리를 참고하세요.
이 페이지에서는 전환 소스 관리를 Content API에서 Merchant API로 이전하는 방법을 설명합니다.
요청
다음은 전환 소스 요청을 위한 Content API for Shopping과 판매자 전환 소스 API를 비교한 샘플입니다.
|
Content API |
Merchant API |
| URL |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID} |
GET https://merchantapi.googleapis.com/conversions/v1/{NAME} |
| 식별자 |
{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID} |
{NAME} |
메서드
Conversion Sources API의 전환 소스 메서드에서 변경된 사항은 다음과 같습니다.
|
메서드
|
Content API for Shopping의 URL
|
Merchant API의 URL
|
Content API for Shopping의 식별자
|
Merchant API의 식별자
|
설명
|
create |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/conversionSources |
POST https://merchantapi.googleapis.com/conversions/v1/accounts/{PARENT}/conversionSources |
{MERCHANT_ID} |
{PARENT} |
Merchant API에서 propertyName는 property이라고 합니다. |
|
update
|
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID}
|
PATCH https://merchantapi.googleapis.com/conversions/v1/accounts/{CONVERSIONSOURCE_NAME}
|
{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID}
|
{CONVERSIONSOURCE_NAME}
|
Merchant API에서 destinationId는 destination이라고 합니다.
|
delete
|
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID}
|
DELETE https://merchantapi.googleapis.com/conversions/v1/accounts/{NAME} |
{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID} |
{NAME} |
Merchant API에서 attributionLookbackWindowInDays은 attributionLookbackWindowDays이라고 합니다.
Merchant API에서 includeInReporting은 report이라고 합니다. |
undelete |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID}:undelete
|
POST https://merchantapi.googleapis.com/conversions/v1/accounts/{name}:undelete
|
{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID} |
{NAME} |
판매자 API에서 URL과 식별자가 다릅니다.
전환 소스 API가 Empty 대신 ConversionSource를 반환합니다.
|
get
|
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID}
|
GET https://merchantapi.googleapis.com/conversions/v1/accounts/{NAME}
|
{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID}
|
{NAME}
|
판매자 API에서 URL과 식별자가 다릅니다.
|
list
|
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/conversionSources
|
GET https://merchantapi.googleapis.com/conversions/v1/{PARENT}/conversionSources
|
{MERCHANT_ID}
|
{PARENT}
|
판매자 API에서 URL과 식별자가 다릅니다.
|
리소스
다음 표에는 전환 소스 API의 전환 소스 리소스 변경사항이 나와 있습니다.
| Content API for Shopping
|
Merchant API
|
설명
|
googleAnalyticsLink: {
property_id: int64,
attributionSettings: object,
propertyName: string
}
|
googleAnalyticsLink: {
propertyId: int64,
attributionSettings: object,
property: string
}
|
Merchant API에서 propertyName는 property이라고 합니다.
|
merchantCenterDestination: {
destinationId: string,
attributionSettings: object,
displayName: string,
currencyCode: string
}
|
merchantCenterDestination: {
destination: string,
attributionSettings: object,
displayName: string,
currencyCode: string
}
|
Merchant API에서 destinationId는 destination이라고 합니다.
|
attributionSettings: {
attributionLookbackWindowDays: int32,
attributionModel: object,
repeated conversionType: {
name: string,
includeInReporting: bool
}
}
|
attributionSettings: {
attributionLookbackWindowDays: int32,
attributionModel: object,
repeated conversionType: {
name: string,
report: bool
}
}
|
Merchant API에서 attributionLookbackWindowInDays는 attributionLookbackWindowDays이라고 합니다.
Merchant API에서 includeInReporting는 report이라고 합니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-08(UTC)
[null,null,["최종 업데이트: 2025-08-08(UTC)"],[[["\u003cp\u003eMerchant Center conversion sources provide insights into conversions from free listings and your website within your merchant account.\u003c/p\u003e\n"],["\u003cp\u003eThe Merchant API enables management of these conversion sources, offering a more streamlined approach compared to the Content API.\u003c/p\u003e\n"],["\u003cp\u003eThis migration guide details key changes in requests, methods, and resources when transitioning from the Content API to the Merchant API for conversion source management.\u003c/p\u003e\n"],["\u003cp\u003eNotable changes include URL and identifier structures, method functionalities, and resource attribute naming conventions.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided tables for a comprehensive comparison of the Content API and the Merchant API functionalities for conversion source management.\u003c/p\u003e\n"]]],["The content details migrating conversion source management from Content API to Merchant API. Key changes include new URLs and identifiers for requests like `GET`, `POST`, `PATCH`, `DELETE`. Methods like `create`, `update`, `delete`, `undelete`, `get`, and `list` now use different URLs and identifiers. Resource names like `propertyName` are renamed to `property`, `destinationId` to `destination`, and `includeInReporting` to `report`.`attributionLookbackWindowInDays` is renamed to `attributionLookbackWindowDays`.\n"],null,["# Migrate conversion sources management from the Content API for Shopping\n\nMerchant Center conversion sources let you view conversion data from [free\nlistings](//support.google.com/merchants/answer/12046446), and from [your\nwebsite](//support.google.com/merchants/answer/13071753), in your Merchant\nCenter account. The Merchant API lets you manage conversion sources for your\nMerchant Center account. For more information, see [Manage conversion\nsources](/merchant/api/guides/conversion-sources/overview).\n\nThis page describes how you can migrate conversion sources management from\nContent API to Merchant API.\n\nRequests\n--------\n\nHere's a sample comparison of the Content API for Shopping to the Merchant\nConversion Sources API for conversion sources requests:\n\n| | Content API | Merchant API |\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------|\n| URL | `GET https://shoppingcontent.googleapis.com/content/v2.1/`\u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_ID}\u003c/var\u003e | `GET https://merchantapi.googleapis.com/conversions/v1/`\u003cvar translate=\"no\"\u003e{NAME}\u003c/var\u003e |\n| Identifiers | \u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_ID}\u003c/var\u003e | \u003cvar translate=\"no\"\u003e{NAME}\u003c/var\u003e |\n\nMethods\n-------\n\nHere is what has changed for conversion sources methods in the Conversion\nSources API:\n\n|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------|---------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Method** | **URL in Content API for Shopping** | **URL in Merchant API** | **Identifiers in Content API for Shopping** | **Identifiers in Merchant API** | **Description** |\n| `create` | `POST https://shoppingcontent.googleapis.com/content/v2.1/`\u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources` | `POST https://merchantapi.googleapis.com/conversions/v1/accounts/`\u003cvar translate=\"no\"\u003e{PARENT}\u003c/var\u003e`/conversionSources` | \u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e | \u003cvar translate=\"no\"\u003e{PARENT}\u003c/var\u003e | In Merchant API, `propertyName` is called `property`. |\n| update | `PATCH https://shoppingcontent.googleapis.com/content/v2.1/`\u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_ID}\u003c/var\u003e | `PATCH https://merchantapi.googleapis.com/conversions/v1/accounts/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_NAME}\u003c/var\u003e | \u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_ID}\u003c/var\u003e | \u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_NAME}\u003c/var\u003e | In Merchant API, `destinationId` is called `destination`. |\n| `delete` | `DELETE https://shoppingcontent.googleapis.com/content/v2.1/`\u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_ID}\u003c/var\u003e | `DELETE https://merchantapi.googleapis.com/conversions/v1/accounts/`\u003cvar translate=\"no\"\u003e{NAME}\u003c/var\u003e | \u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_ID}\u003c/var\u003e | \u003cvar translate=\"no\"\u003e{NAME}\u003c/var\u003e | In Merchant API, `attributionLookbackWindowInDays` is called `attributionLookbackWindowDays`. In Merchant API, `includeInReporting` is called `report`. |\n| `undelete` | `POST https://shoppingcontent.googleapis.com/content/v2.1/`\u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_ID}\u003c/var\u003e`:undelete` | `POST https://merchantapi.googleapis.com/conversions/v1/accounts/`\u003cvar translate=\"no\"\u003e{name}\u003c/var\u003e`:undelete` | \u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_ID}\u003c/var\u003e | \u003cvar translate=\"no\"\u003e{NAME}\u003c/var\u003e | URL and identifiers are different in Merchant API. The Conversion Sources API returns `ConversionSource` instead of `Empty`. |\n| `get` | `GET https://shoppingcontent.googleapis.com/content/v2.1/`\u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_ID}\u003c/var\u003e | `GET https://merchantapi.googleapis.com/conversions/v1/accounts/`\u003cvar translate=\"no\"\u003e{NAME}\u003c/var\u003e | \u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources/`\u003cvar translate=\"no\"\u003e{CONVERSIONSOURCE_ID}\u003c/var\u003e | \u003cvar translate=\"no\"\u003e{NAME}\u003c/var\u003e | URL and identifiers are different in Merchant API. |\n| `list` | `GET https://shoppingcontent.googleapis.com/content/v2.1/`\u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e`/conversionSources` | `GET https://merchantapi.googleapis.com/conversions/v1/`\u003cvar translate=\"no\"\u003e{PARENT}\u003c/var\u003e`/conversionSources` | \u003cvar translate=\"no\"\u003e{MERCHANT_ID}\u003c/var\u003e | \u003cvar translate=\"no\"\u003e{PARENT}\u003c/var\u003e | URL and identifiers are different in Merchant API. |\n\nResources\n---------\n\nThe following table mentions the changes in conversion sources resources in the\nConversion Sources API:\n\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Content API for Shopping | Merchant API | Description |\n| `googleAnalyticsLink: { ` property_id: int64, ` ` attributionSettings: object, ` ` propertyName: string ` ` } ` ` | `googleAnalyticsLink: { ` propertyId: int64, ` ` attributionSettings: object, ` ` property: string ` ` ` } ` | In Merchant API, `propertyName` is called `property`. |\n| `merchantCenterDestination: { ` destinationId: string, ` ` attributionSettings: object, ` ` displayName: string, ` ` currencyCode: string ` ` ` } ` | `merchantCenterDestination: { ` \u003cbr /\u003e ` ` destination: string, ` ` attributionSettings: object, ` ` displayName: string, ` ` currencyCode: string ` ` ` } ` | In Merchant API, `destinationId` is called `destination`. |\n| `attributionSettings: { ` \u003cbr /\u003e ` ` attributionLookbackWindowDays: int32, ` ` attributionModel: object, ` ` repeated conversionType: { ` ` name: string, ` ` includeInReporting: bool ` ` } ` ` ` } ` | `attributionSettings: { ` \u003cbr /\u003e ` ` attributionLookbackWindowDays: int32, ` ` attributionModel: object, ` ` repeated conversionType: { ` ` name: string, ` ` report: bool ` ` } ` ` ` } ` | In Merchant API, `attributionLookbackWindowInDays` is called `attributionLookbackWindowDays`. In Merchant API, `includeInReporting` is called `report`. |"]]
