Programs alt API'sine genel bakış

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 alt API'si, mevcut tüm Alışveriş programlarına katılımınızı almanızı ve güncellemenizi sağlar.

Programları almak, etkinleştirmek ve devre dışı bırakmak için aşağıdaki yöntemlerden birini 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:

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

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:

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

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şiminiz olmalıdır.

Aşağıda örnek bir istek verilmiştir:

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

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}"
      ]
    }
  ]
}

Programları 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şiminiz olmalıdır.

Aşağıda örnek bir istek verilmiştir:

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

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}"
}