Ringkasan Programs API

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

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

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

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

Mencantumkan semua program

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

Berikut adalah contoh permintaan:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs

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 metode accounts.programs.get.

Berikut adalah contoh permintaan:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listings

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:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listings:enable

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:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listings:disable

Berikut adalah contoh respons dari permintaan yang berhasil:

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