Di chuyển hoạt động quản lý các nguồn chuyển đổi từ Content API for Shopping
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Nguồn lượt chuyển đổi của Merchant Center cho phép bạn xem dữ liệu lượt chuyển đổi từ trang thông tin miễn phí và từ trang web của bạn trong tài khoản Merchant Center. Merchant API cho phép bạn quản lý các nguồn chuyển đổi cho tài khoản Merchant Center. Để biết thêm thông tin, hãy xem bài viết Quản lý nguồn chuyển đổi.
Trang này mô tả cách bạn có thể di chuyển hoạt động quản lý nguồn chuyển đổi từ Content API sang Merchant API.
Yêu cầu
Sau đây là ví dụ so sánh Content API for Shopping với Merchant Conversion Sources API cho các yêu cầu về nguồn chuyển đổi:
|
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} |
| Giá trị nhận dạng |
{MERCHANT_ID}/conversionSources/{CONVERSIONSOURCE_ID} |
{NAME} |
Phương thức
Sau đây là những thay đổi đối với các phương thức nguồn chuyển đổi trong Conversion Sources API:
|
Phương thức
|
URL trong Content API for Shopping
|
URL trong Merchant API
|
Mã nhận dạng trong Content API for Shopping
|
Mã nhận dạng trong Merchant API
|
Nội dung mô tả
|
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} |
Trong Merchant API, propertyName được gọi là property. |
|
cập nhật
|
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}
|
Trong Merchant API, destinationId được gọi là 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} |
Trong Merchant API, attributionLookbackWindowInDays được gọi là attributionLookbackWindowDays.
Trong Merchant API, includeInReporting được gọi là 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} |
URL và giá trị nhận dạng khác nhau trong Merchant API.
Conversion Sources API trả về ConversionSource thay vì Empty.
|
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}
|
URL và giá trị nhận dạng khác nhau trong Merchant API.
|
list
|
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/conversionSources
|
GET https://merchantapi.googleapis.com/conversions/v1/{PARENT}/conversionSources
|
{MERCHANT_ID}
|
{PARENT}
|
URL và giá trị nhận dạng khác nhau trong Merchant API.
|
Tài nguyên
Bảng sau đây đề cập đến những thay đổi trong tài nguyên nguồn chuyển đổi trong Conversion Sources API:
| Content API for Shopping
|
Merchant API
|
Mô tả
|
googleAnalyticsLink: {
property_id: int64,
attributionSettings: object,
propertyName: string
}
|
googleAnalyticsLink: {
propertyId: int64,
attributionSettings: object,
property: string
}
|
Trong Merchant API, propertyName được gọi là property.
|
merchantCenterDestination: {
destinationId: string,
attributionSettings: object,
displayName: string,
currencyCode: string
}
|
merchantCenterDestination: {
destination: string,
attributionSettings: object,
displayName: string,
currencyCode: string
}
|
Trong Merchant API, destinationId được gọi là destination.
|
attributionSettings: {
attributionLookbackWindowDays: int32,
attributionModel: object,
repeated conversionType: {
name: string,
includeInReporting: bool
}
}
|
attributionSettings: {
attributionLookbackWindowDays: int32,
attributionModel: object,
repeated conversionType: {
name: string,
report: bool
}
}
|
Trong Merchant API, attributionLookbackWindowInDays được gọi là attributionLookbackWindowDays.
Trong Merchant API, includeInReporting được gọi là report.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-08 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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`. |"]]
