Ringkasan sub-API Program

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.

Sub-API program memungkinkan Anda mengambil dan memperbarui partisipasi Anda dalam semua program Shopping 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:

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

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