Ringkasan sub-API Program

Program memungkinkan Anda mengontrol promosi produk dan meningkatkan fitur akun di berbagai platform Google.

Contoh umumnya adalah program listingan produk gratis, yang memungkinkan produk dari toko online Anda ditampilkan di Google tanpa biaya.

Sub-API program memungkinkan Anda mengambil dan memperbarui partisipasi dalam semua program belanja yang tersedia.

Untuk mengambil, mengaktifkan, dan menonaktifkan program, Anda dapat menggunakan metode berikut:

Membuat daftar semua program

Untuk mengambil semua program untuk akun, gunakan accounts.programs.list metode.

Berikut adalah contoh permintaan:

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

Berikut adalah contoh respons dari permintaan yang berhasil:

{
  "programs": [
    {
      "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
      "documentationUri": "{URI}",
      "state": "{ACCOUNT_STATE}",
      "unmetRequirements": [
        {
          "title": "{TITLE}",
          "documentationUri": "{URI}",
          "affectedRegionCodes": [
            "{REGION_CODE}"
          ]
        }
      ]
    }
  ]
}

Mengambil satu program

Untuk mengambil program tertentu, gunakan accounts.programs.get metode.

Berikut adalah contoh permintaan:

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

Berikut adalah contoh respons dari permintaan yang berhasil:

{
  "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
  "documentationUri": "{URI}",
  "state": "{ACCOUNT_STATE}",
  "unmetRequirements": [
    {
      "title": "{TITLE}",
      "documentationUri": "{URI}",
      "affectedRegionCodes": [
        "{REGION_CODE}"
      ]
    }
  ]
}

Mengaktifkan program

Untuk mengaktifkan partisipasi dalam program yang ditentukan untuk akun, gunakan metode accounts.programs.enable. Anda harus memiliki akses administrator untuk menjalankan izin ini.

Berikut adalah contoh permintaan:

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

Berikut adalah contoh respons dari permintaan yang berhasil:

{
  "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
  "documentationUri": "{URI}",
  "state": "{ACCOUNT_STATE}",
  "unmetRequirements": [
    {
      "title": "{TITLE}",
      "documentationUri": "{URI}",
      "affectedRegionCodes": [
        "{REGION_CODE}"
      ]
    }
  ]
}

Menonaktifkan program

Untuk menonaktifkan partisipasi dalam program yang ditentukan untuk akun, gunakan metode accounts.programs.disable. Anda harus memiliki akses administrator untuk menjalankan izin ini.

Berikut adalah contoh permintaan:

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

Berikut adalah contoh respons dari permintaan yang berhasil:

{
  "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
  "documentationUri": "{URI}",
  "state": "{ACCOUNT_STATE}"
}