Les programmes vous permettent de contrôler la promotion de vos produits et d'améliorer les fonctionnalités de votre compte sur différentes surfaces Google.
C'est le cas, par exemple, du programme de fiches produit sans frais, qui permet de présenter les produits de votre boutique en ligne sur Google sans frais.
L'API Programs vous permet de récupérer et de mettre à jour votre participation à tous les programmes Shopping disponibles.
Pour récupérer, activer et désactiver des programmes, vous pouvez utiliser les méthodes suivantes:
Répertorier tous les programmes
Pour récupérer tous les programmes du compte, utilisez la méthode accounts.programs.list.
Voici un exemple de requête:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs
Voici un exemple de réponse à une requête réussie:
{
"programs": [
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
]
}
Récupérer un seul programme
Pour récupérer un programme spécifique, utilisez la méthode accounts.programs.get.
Voici un exemple de requête:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings
Voici un exemple de réponse à une requête réussie:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Activer un programme
Pour activer la participation au programme spécifié pour le compte, utilisez la méthode accounts.programs.enable. Vous devez disposer d'un accès administrateur pour exécuter cette autorisation.
Voici un exemple de requête:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:enable
Voici un exemple de réponse à une requête réussie:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Désactiver un programme
Pour désactiver la participation au programme spécifié pour le compte, utilisez la méthode accounts.programs.disable. Vous devez disposer d'un accès administrateur pour exécuter cette autorisation.
Voici un exemple de requête:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:disable
Voici un exemple de réponse à une requête réussie:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} "
}