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 Unter-API „Programme“ kannst du deine 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:
HTTP
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs
cURL
curl \
'https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed
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:
HTTP
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listings
cURL
curl \
'https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listing?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed
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:
HTTP
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listings:enable
cURL
curl --request POST \
'https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listing:enable?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{}' \
--compressed
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:
HTTP
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listings:disable
cURL
curl --request POST \
'https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listing:disable?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{}' \
--compressed
Hier ist eine Beispielantwort für eine erfolgreiche Anfrage:
{
"name": "accounts/{ACCOUNT_ID}/programs/free-listings",
"documentationUri": "{URI}",
"state": "{ACCOUNT_STATE}"
}