Los programas te permiten controlar la promoción de tus productos y mejorar las funciones de tu cuenta en varias plataformas de Google.
Un ejemplo típico de esto es el programa de fichas de productos gratuitas, que permite que los productos de tu tienda en línea se muestren en Google sin cargo.
La API de Programs te permite recuperar y actualizar tu participación en todos los programas de compras disponibles.
Para recuperar, habilitar y deshabilitar programas, puedes usar los siguientes métodos:
Muestra una lista de todos los programas
Para recuperar todos los programas de la cuenta, usa el método accounts.programs.list.
Esta es una solicitud de ejemplo:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs
Esta es una respuesta de ejemplo de una solicitud correcta:
{
"programs": [
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
]
}
Cómo recuperar un solo programa
Para recuperar un programa específico, usa el método accounts.programs.get.
Esta es una solicitud de ejemplo:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings
Esta es una respuesta de ejemplo de una solicitud correcta:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Cómo habilitar un programa
Para habilitar la participación en el programa especificado para la cuenta, usa el método accounts.programs.enable. Debes tener acceso de administrador para ejecutar este permiso.
Esta es una solicitud de ejemplo:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:enable
Esta es una respuesta de ejemplo de una solicitud correcta:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Cómo inhabilitar un programa
Para inhabilitar la participación en el programa especificado para la cuenta, usa el método accounts.programs.disable. Debes tener acceso de administrador para ejecutar este permiso.
Esta es una solicitud de ejemplo:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:disable
Esta es una respuesta de ejemplo de una solicitud correcta:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} "
}