REST Resource: accounts.programs

Tài nguyên: Chương trình

Xác định việc tham gia một chương trình nhất định cho tài khoản được chỉ định.

Các chương trình cung cấp cơ chế để thêm chức năng vào tài khoản người bán. Một ví dụ điển hình là chương trình Trang thông tin miễn phí về sản phẩm. Chương trình này cho phép giới thiệu miễn phí sản phẩm tại cửa hàng của người bán trên Google.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "documentationUri": string,
  "state": enum (State),
  "activeRegionCodes": [
    string
  ],
  "unmetRequirements": [
    {
      object (Requirement)
    }
  ]
}
Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của chương trình. Định dạng accounts/{account}/programs/{program}

documentationUri

string

Chỉ có đầu ra. URL của trang trợ giúp Merchant Center mô tả chương trình.

state

enum (State)

Chỉ có đầu ra. Trạng thái tham gia của tài khoản trong chương trình.

activeRegionCodes[]

string

Chỉ có đầu ra. Các khu vực mà tài khoản đang tích cực tham gia chương trình. Khu vực đang hoạt động được định nghĩa là những khu vực đã đáp ứng tất cả các yêu cầu của chương trình ảnh hưởng đến các khu vực đó.

Mã vùng do CLDR xác định. Đây là quốc gia nơi chương trình được áp dụng riêng cho quốc gia đó hoặc 001 khi chương trình được áp dụng trên toàn cầu.

unmetRequirements[]

object (Requirement)

Chỉ có đầu ra. Các yêu cầu mà tài khoản chưa đáp ứng đang ảnh hưởng đến việc tham gia chương trình.

Tiểu bang

Các trạng thái tài khoản có thể tham gia chương trình.

Enum
STATE_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
NOT_ELIGIBLE Tài khoản đó không đủ điều kiện tham gia chương trình.
ELIGIBLE Tài khoản đó đủ điều kiện tham gia chương trình.
ENABLED Chương trình này đã được bật cho tài khoản này.

Yêu cầu

Xác định một yêu cầu được chỉ định để tham gia chương trình.

Biểu diễn dưới dạng JSON
{
  "title": string,
  "documentationUri": string,
  "affectedRegionCodes": [
    string
  ]
}
Trường
title

string

Chỉ có đầu ra. Tên yêu cầu.

documentationUri

string

Chỉ có đầu ra. URL của một trang trợ giúp mô tả yêu cầu.

affectedRegionCodes[]

string

Chỉ có đầu ra. Những khu vực hiện đang chịu ảnh hưởng của yêu cầu này chưa được đáp ứng.

Mã vùng do CLDR xác định. Đây là quốc gia nơi chương trình được áp dụng riêng cho quốc gia đó hoặc 001 khi chương trình được áp dụng trên toàn cầu.

Phương thức

disable

Vô hiệu hóa khả năng tham gia vào chương trình đã chỉ định cho tài khoản.

enable

Cho phép tham gia vào chương trình được chỉ định cho tài khoản.

get

Truy xuất chương trình được chỉ định cho tài khoản.

list

Truy xuất tất cả chương trình cho tài khoản.