REST Resource: inappproducts

Tài nguyên: InAppProduct

Một sản phẩm trong ứng dụng. Tài nguyên cho InappproductsService.

Biểu diễn dưới dạng JSON
{
  "packageName": string,
  "sku": string,
  "status": enum (Status),
  "purchaseType": enum (PurchaseType),
  "defaultPrice": {
    object (Price)
  },
  "prices": {
    string: {
      object (Price)
    },
    ...
  },
  "listings": {
    string: {
      object (InAppProductListing)
    },
    ...
  },
  "defaultLanguage": string,
  "subscriptionPeriod": string,
  "trialPeriod": string,
  "gracePeriod": string,

  // Union field TaxAndComplianceType can be only one of the following:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of list of possible types for union field TaxAndComplianceType.
}
Trường
packageName

string

Tên gói của ứng dụng mẹ.

sku

string

Đơn vị lưu kho (SKU) của sản phẩm, duy nhất trong một ứng dụng.

status

enum (Status)

Trạng thái của sản phẩm, ví dụ: liệu sản phẩm có đang hoạt động hay không.

purchaseType

enum (PurchaseType)

Loại sản phẩm, ví dụ: gói thuê bao định kỳ.

defaultPrice

object (Price)

Giá mặc định. Không được bằng 0 vì sản phẩm trong ứng dụng không bao giờ miễn phí. Luôn bằng đơn vị tiền tệ của người bán trong quy trình thanh toán của nhà phát triển.

prices

map (key: string, value: object (Price))

Giá theo khu vực của người mua. Không có giá trị nào trong số này được phép bằng 0 vì sản phẩm trong ứng dụng không bao giờ miễn phí. Khoá bản đồ là mã vùng, theo định nghĩa của ISO 3166-2.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

listings

map (key: string, value: object (InAppProductListing))

inappproducts.list của dữ liệu tiêu đề và nội dung mô tả đã bản địa hoá. Khoá ánh xạ là ngôn ngữ của dữ liệu được bản địa hoá, theo định nghĩa của BCP-47, ví dụ: "en-US".

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

defaultLanguage

string

Ngôn ngữ mặc định của dữ liệu đã bản địa hoá, theo định nghĩa của BCP-47. Ví dụ: "en-US".

subscriptionPeriod

string

Kỳ hạn của gói thuê bao, được chỉ định ở định dạng ISO 8601. Các giá trị được chấp nhận là P1W (một tuần), P1M (một tháng), P3M (ba tháng), P6M (sáu tháng) và P1Y (một năm).

trialPeriod

string

Thời gian dùng thử, được chỉ định ở định dạng ISO 8601. Giá trị được chấp nhận là bất kỳ giá trị nào từ P7D (7 ngày) đến P999D (999 ngày).

gracePeriod

string

Thời gian gia hạn của gói thuê bao, được chỉ định ở định dạng ISO 8601. Cho phép nhà phát triển cung cấp thời gian ân hạn cho người đăng ký khi khoản thanh toán cho kỳ thanh toán định kỳ mới bị từ chối. Các giá trị được chấp nhận là P0D (0 ngày), P3D (3 ngày), P7D (7 ngày), P14D (14 ngày) và P30D (30 ngày).

Trường hợp hợp nhất TaxAndComplianceType.

TaxAndComplianceType chỉ có thể là một trong những loại sau:

subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

Thông tin chi tiết về thuế và việc tuân thủ pháp luật. Chỉ áp dụng cho các sản phẩm thuê bao.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Thông tin chi tiết về thuế và việc tuân thủ pháp luật. Chỉ áp dụng cho sản phẩm được quản lý.

Trạng thái

Trạng thái của một sản phẩm trong ứng dụng.

Enum
statusUnspecified Trạng thái không xác định.
active Sản phẩm đã được phát hành và đang hoạt động trong cửa hàng.
inactive Sản phẩm chưa được xuất bản nên không hoạt động trong cửa hàng.

PurchaseType

Loại sản phẩm.

Enum
purchaseTypeUnspecified Loại giao dịch mua không xác định.
managedUser Loại sản phẩm mặc định – giao dịch mua một lần.
subscription Sản phẩm trong ứng dụng có kỳ hạn định kỳ.

InAppProductListing

Trang thông tin trên Cửa hàng Play của một sản phẩm trong ứng dụng.

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

string

Tiêu đề cho trang thông tin trên Cửa hàng Play.

description

string

Nội dung mô tả cho trang thông tin trên Cửa hàng Play.

benefits[]

string

Lợi ích kèm theo quyền đã bản địa hoá cho một gói thuê bao.

ManagedProductTaxAndComplianceSettings

Thông tin chi tiết về việc nộp thuế và tuân thủ pháp luật đối với sản phẩm được quản lý.

Biểu diễn dưới dạng JSON
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean
}
Trường
eeaWithdrawalRightType

enum (WithdrawalRightType)

Phân loại dịch vụ hoặc nội dung kỹ thuật số cho các sản phẩm được phân phối cho người dùng ở Khu vực kinh tế Châu Âu (EEA). Chế độ rút lui theo luật bảo vệ người tiêu dùng của Khu vực kinh tế Châu Âu (EEA) phụ thuộc vào cách phân loại này. Hãy tham khảo bài viết này trong Trung tâm trợ giúp để biết thêm thông tin.

taxRateInfoByRegionCode

map (key: string, value: object (RegionalTaxRateInfo))

Thông tin liên kết từ mã khu vực đến thông tin chi tiết về thuế suất. Các khoá là mã vùng theo định nghĩa của "CLDR" của Unicode.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

isTokenizedDigitalAsset

boolean

Liệu sản phẩm trong ứng dụng này có được khai báo là sản phẩm đại diện cho một tài sản kỹ thuật số được mã hoá hay không.

Phương thức

batchDelete

Xoá sản phẩm trong ứng dụng (sản phẩm được quản lý hoặc gói thuê bao).

batchGet

Đọc nhiều sản phẩm trong ứng dụng, có thể là sản phẩm được quản lý hoặc gói thuê bao.

batchUpdate

Cập nhật hoặc chèn một hoặc nhiều sản phẩm trong ứng dụng (sản phẩm được quản lý hoặc gói thuê bao).

delete

Xoá một sản phẩm trong ứng dụng (sản phẩm được quản lý hoặc gói thuê bao).

get

Lấy một sản phẩm trong ứng dụng, có thể là sản phẩm được quản lý hoặc gói thuê bao.

insert

Tạo một sản phẩm trong ứng dụng (sản phẩm được quản lý hoặc gói thuê bao).

list

Liệt kê tất cả sản phẩm trong ứng dụng – cả sản phẩm được quản lý và gói thuê bao.

patch

Vá một sản phẩm trong ứng dụng (sản phẩm được quản lý hoặc gói thuê bao).

update

Cập nhật sản phẩm trong ứng dụng (sản phẩm được quản lý hoặc gói thuê bao).