REST Resource: inappproducts

Tài nguyên: InAppProduct

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.
}
Các 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ụ: 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 thể bằng 0, vì sản phẩm trong ứng dụng không bao giờ miễn phí. Luôn sử dụng đơn vị tiền tệ của người bán trên Checkout 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ó yếu tố nào trong số này có thể 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 quy định trong 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 gồm dữ liệu tiêu đề và nội dung mô tả đã bản địa hoá. Khoá bản đồ là ngôn ngữ của dữ liệu đã bản địa hoá, như được xác định theo 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á, như định nghĩa theo BCP-47, ví dụ: "en-US".
subscriptionPeriod

string

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

string

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

string

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

Trường nhóm TaxAndComplianceType.

TaxAndComplianceType chỉ có thể là một trong những trạng thái sau đây:
subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

Thông tin chi tiết về thuế và tình trạng 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à tình trạng tuân thủ pháp luật. Chỉ áp dụng cho các 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 chưa 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 chưa được chỉ định.
managedUser Loại sản phẩm mặc định – mua hàng một lần.
subscription Sản phẩm trong ứng dụng có chu kỳ định kỳ.

InAppProductListing

Trang thông tin trên Cửa hàng Play về một sản phẩm duy nhất trong ứng dụng.

Biểu diễn dưới dạng JSON 
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
Các 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 của quyền được bản địa hoá cho một gói thuê bao.

ManagedProductTaxAndComplianceSettings

Thông tin chi tiết về thuế và tuân thủ pháp lý đố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
}
Các trường
eeaWithdrawalRightType

enum (WithdrawalRightType)

Phân loại nội dung kỹ thuật số hoặc dịch vụ 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. 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))

Liên kết từ mã vùng đến thông tin chi tiết về thuế suất. Các khoá là mã vùng theo quy định trong "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á các 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à các 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á sản phẩm trong ứng dụng (sản phẩm được quản lý hoặc gói thuê bao).

get

 Nhận 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 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

 Bản 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 một sản phẩm trong ứng dụng (sản phẩm được quản lý hoặc một gói thuê bao).