Programy umożliwiają kontrolowanie promowania produktów i ulepszanie funkcji konta na różnych platformach Google.
Typowym przykładem jest program bezpłatnych informacji o produktach, który umożliwia bezpłatne wyświetlanie produktów z Twojego sklepu internetowego w Google.
Interfejs Programs API umożliwia pobieranie i aktualizowanie udziału we wszystkich dostępnych programach zakupowych.
Aby pobrać, włączyć i wyłączyć programy, możesz użyć tych metod:
Wyświetlanie listy wszystkich programów
Aby pobrać wszystkie programy na koncie, użyj metody accounts.programs.list.
Oto przykładowa prośba:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs
Oto przykład odpowiedzi na żądanie, które zostało wykonane:
{
"programs": [
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
]
}
Pobieranie pojedynczego programu
Aby pobrać konkretny program, użyj metody accounts.programs.get.
Oto przykładowa prośba:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings
Oto przykład odpowiedzi na żądanie, które zostało wykonane:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Włączanie programu
Aby umożliwić korzystanie z określonego programu na koncie, użyj metody accounts.programs.enable. Aby użyć tego uprawnienia, musisz mieć dostęp administracyjny.
Oto przykładowa prośba:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:enable
Oto przykładowa odpowiedź na żądanie, które zostało wykonane:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Wyłączanie programu
Aby wyłączyć udział w określonym programie na koncie, użyj metody accounts.programs.disable. Aby użyć tego uprawnienia, musisz mieć dostęp administracyjny.
Oto przykładowa prośba:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:disable
Oto przykład odpowiedzi na żądanie, które zostało wykonane:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} "
}