透過計畫,您可以控管產品的宣傳活動,並在各項 Google 平台上提升帳戶功能。
這類服務的典型例子是免費產品資訊計畫,可讓你免費在 Google 各平台上顯示網路商店的產品。
透過 Programs API,你可以擷取及更新參與所有可用的購物計畫。
如要擷取、啟用及停用程式,您可以使用下列方法:
列出所有節目
如要擷取帳戶的所有節目,請使用 accounts.programs.list
方法。
以下是要求範例:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs
以下是成功要求的回應範例:
{
"programs": [
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
]
}
擷取單一節目
如要擷取特定節目,請使用 accounts.programs.get
方法。
以下是範例要求:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings
以下是成功要求的回應範例:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
啟用計畫
如要讓帳戶參與指定的計畫,請使用 accounts.programs.enable
方法。您必須具備管理員存取權,才能執行這項權限。
以下是範例要求:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:enable
以下是成功要求的回應範例:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
停用計畫
如要停用帳戶參與指定計畫的功能,請使用 accounts.programs.disable
方法。您必須具備管理員存取權,才能執行這項權限。
以下是要求範例:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:disable
以下是成功要求的回應範例:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} "
}