Mit Programmen können Sie die Werbung für Ihre Produkte steuern und die Funktionen Ihres Kontos auf verschiedenen Google-Plattformen optimieren.
Ein typisches Beispiel hierfür ist das Programm für Produkteinträge, mit dem Produkte aus Ihrem Onlineshop kostenlos auf Google präsentiert werden können.
Mit der Programs API können Sie Ihre Teilnahme an allen verfügbaren Shopping-Programmen abrufen und aktualisieren.
Sie haben folgende Möglichkeiten, Programme abzurufen, zu aktivieren und zu deaktivieren:
Alle Programme auflisten
Mit der Methode accounts.programs.list können Sie alle Programme für das Konto abrufen.
Hier ein Beispiel für eine Anfrage:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs
Hier ist eine Beispielantwort für eine erfolgreiche Anfrage:
{
"programs": [
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
]
}
Einzelnes Programm abrufen
Wenn Sie ein bestimmtes Programm abrufen möchten, verwenden Sie die Methode accounts.programs.get.
Hier ein Beispiel für eine Anfrage:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings
Hier ist eine Beispielantwort für eine erfolgreiche Anfrage:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Programm aktivieren
Verwenden Sie die Methode accounts.programs.enable, um die Teilnahme am angegebenen Programm für das Konto zu aktivieren. Sie benötigen Administratorzugriff, um diese Berechtigung auszuführen.
Hier ein Beispiel für eine Anfrage:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:enable
Hier ist eine Beispielantwort für eine erfolgreiche Anfrage:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Programm deaktivieren
Wenn Sie die Teilnahme am angegebenen Programm für das Konto deaktivieren möchten, verwenden Sie die Methode accounts.programs.disable. Sie benötigen Administratorzugriff, um diese Berechtigung auszuführen.
Hier ein Beispiel für eine Anfrage:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:disable
Hier ist eine Beispielantwort für eine erfolgreiche Anfrage:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} "
}