Tổng quan về API Chương trình

Chương trình cho phép bạn kiểm soát việc quảng bá sản phẩm và nâng cao các tính năng của tài khoản trên nhiều nền tảng của Google.

Một ví dụ điển hình về điều này là chương trình trang thông tin sản phẩm miễn phí. Chương trình này cho phép sản phẩm trong cửa hàng trực tuyến của bạn xuất hiện trên Google mà không tính phí.

API chương trình cho phép bạn truy xuất và cập nhật trạng thái tham gia của mình trong tất cả các chương trình mua sắm hiện có.

Để truy xuất, bật và tắt các chương trình, bạn có thể sử dụng các phương thức sau:

Liệt kê tất cả chương trình

Để truy xuất tất cả chương trình cho tài khoản, hãy sử dụng phương thức accounts.programs.list.

Sau đây là một yêu cầu mẫu:

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

Dưới đây là phản hồi mẫu từ một yêu cầu thành công:

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

Truy xuất một chương trình

Để truy xuất một chương trình cụ thể, hãy sử dụng phương thức accounts.programs.get.

Sau đây là một yêu cầu mẫu:

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

Dưới đây là phản hồi mẫu từ một yêu cầu thành công:

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

Bật một chương trình

Để cho phép tham gia chương trình đã chỉ định cho tài khoản, hãy sử dụng phương thức accounts.programs.enable. Bạn phải có quyền quản trị để chạy quyền này.

Sau đây là một yêu cầu mẫu:

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

Dưới đây là phản hồi mẫu từ một yêu cầu thành công:

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

Tắt một chương trình

Để tắt tính năng tham gia chương trình đã chỉ định cho tài khoản, hãy sử dụng phương thức accounts.programs.disable. Bạn phải có quyền quản trị để chạy quyền này.

Sau đây là một yêu cầu mẫu:

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

Dưới đây là phản hồi mẫu từ một yêu cầu thành công:

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