Mit Programmen können Sie die Werbung für Ihre Produkte steuern und die Funktionen Ihres Kontos auf verschiedenen Google-Plattformen verbessern.
Ein typisches Beispiel dafür sind Produkteinträge. Mit diesem Programm können Produkte aus Ihrem Onlineshop kostenlos auf Google präsentiert werden.
Mit der Unter-API für Programme können Sie Ihre Teilnahme an allen verfügbaren Shopping-Programmen abrufen und aktualisieren.
Sie können die folgenden Methoden verwenden, um Programme abzurufen, zu aktivieren und zu deaktivieren:
Alle Programme auflisten
Wenn Sie alle Programme für das Konto abrufen möchten, verwenden Sie die Methode accounts.programs.list.
Hier ein Beispiel für eine Anfrage:
HTTP
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs
cURL
curl \
'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed
Hier ist eine Beispielantwort auf 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/v1/accounts/{ACCOUNT_ID}/programs/free-listings
cURL
curl \
'https://merchantapi.googleapis.com/accounts/v1/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 auf 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/v1/accounts/{ACCOUNT_ID}/programs/free-listings:enable
cURL
curl --request POST \
'https://merchantapi.googleapis.com/accounts/v1/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 auf 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/v1/accounts/{ACCOUNT_ID}/programs/free-listings:disable
cURL
curl --request POST \
'https://merchantapi.googleapis.com/accounts/v1/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 auf eine erfolgreiche Anfrage:
{
"name": "accounts/{ACCOUNT_ID}/programs/free-listings",
"documentationUri": "{URI}",
"state": "{ACCOUNT_STATE}"
}