I programmi ti consentono di controllare la promozione dei tuoi prodotti e di migliorare le funzionalità del tuo account su varie piattaforme Google.
Un esempio tipico è il programma delle schede di prodotto senza costi, che consente di mostrare i prodotti del tuo negozio online su Google senza costi.
L'API Programs ti consente di recuperare e aggiornare la tua partecipazione a tutti i programmi di shopping disponibili.
Per recuperare, attivare e disattivare i programmi, puoi utilizzare i seguenti metodi:
Elenca tutti i programmi
Per recuperare tutti i programmi per l'account, utilizza il metodo accounts.programs.list.
Ecco una richiesta di esempio:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs
Ecco un esempio di risposta di una richiesta andata a buon fine:
{
"programs": [
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
]
}
Recuperare un singolo programma
Per recuperare un programma specifico, utilizza il metodo accounts.programs.get.
Ecco una richiesta di esempio:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings
Ecco un esempio di risposta di una richiesta andata a buon fine:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Attivare un programma
Per attivare la partecipazione al programma specificato per l'account, utilizza il metodo accounts.programs.enable. Per eseguire questa autorizzazione, devi disporre dell'accesso amministrativo.
Ecco una richiesta di esempio:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:enable
Ecco un esempio di risposta di una richiesta andata a buon fine:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Disattivare un programma
Per disattivare la partecipazione al programma specificato per l'account, utilizza il metodo accounts.programs.disable. Per eseguire questa autorizzazione, devi disporre dell'accesso amministrativo.
Ecco una richiesta di esempio:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:disable
Ecco un esempio di risposta di una richiesta andata a buon fine:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} "
}