Programlar, ürünlerinizin tanıtımını kontrol etmenize ve çeşitli Google platformlarında hesabınızın özelliklerini geliştirmenize olanak tanır.
Bunun tipik bir örneği, online mağazanızdaki ürünlerin Google'da ücretsiz olarak gösterilmesini sağlayan ücretsiz ürün listelemeleri programıdır.
Programlar API'si, mevcut tüm alışveriş programlarına katılımınızı alıp güncellemenizi sağlar.
Programları almak, etkinleştirmek ve devre dışı bırakmak için aşağıdaki yöntemleri kullanabilirsiniz:
Tüm programları listeleme
Hesabın tüm programlarını almak için accounts.programs.list yöntemini kullanın.
Aşağıda örnek bir istek verilmiştir:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs
Başarılı bir istek için örnek yanıtı aşağıda bulabilirsiniz:
{
"programs": [
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
]
}
Tek bir programı alma
Belirli bir programı almak için accounts.programs.get yöntemini kullanın.
Aşağıda örnek bir istek verilmiştir:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings
Başarılı bir istek için örnek yanıtı aşağıda bulabilirsiniz:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Bir programı etkinleştirme
Hesap için belirtilen programa katılımı etkinleştirmek üzere accounts.programs.enable yöntemini kullanın. Bu izni çalıştırmak için yönetici erişimine sahip olmanız gerekir.
Aşağıda örnek bir istek verilmiştir:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:enable
Başarılı bir istek için örnek yanıtı aşağıda bulabilirsiniz:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} ",
"unmetRequirements": [
{
"title": "{TITLE} ",
"documentationUri": "{URI} ",
"affectedRegionCodes": [
"{REGION_CODE} "
]
}
]
}
Bir programı devre dışı bırakma
Hesap için belirtilen programa katılımı devre dışı bırakmak üzere accounts.programs.disable yöntemini kullanın. Bu izni çalıştırmak için yönetici erişimine sahip olmanız gerekir.
Aşağıda örnek bir istek verilmiştir:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID} /programs/free-listings:disable
Başarılı bir istek için örnek yanıtı aşağıda bulabilirsiniz:
{
"name": "accounts/{ACCOUNT_ID} /programs/free-listings",
"documentationUri": "{URI} ",
"state": "{ACCOUNT_STATE} "
}