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.

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 về điều này là chương trình Trang thông tin miễn phí về sản phẩm, cho phép sản phẩm trong cửa hàng của người bán xuất hiện miễn phí 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 xác định 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 khu vực đó.

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

unmetRequirements[]

object (Requirement)

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

Tiểu bang

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

Enum
STATE_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
NOT_ELIGIBLE Tài khoản này 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 đã được bật cho tài khoản.

Yêu cầu

Xác định một yêu cầu cụ thể để 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 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 việc không đáp ứng yêu cầu này.

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

Phương thức

disable

Tắt tính năng tham gia chương trình được chỉ định cho tài khoản.

enable

Cho phép tài khoản tham gia chương trình đã chỉ định.

get

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

list

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