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.
}
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, chỉ có trong ứng dụng.

status

enum (Status)

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

purchaseType

enum (PurchaseType)

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

defaultPrice

object (Price)

Giá mặc định. Không thể là 0 vì sản phẩm trong ứng dụng không bao giờ được miễn phí. Luôn bằ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ó giá trị 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 định nghĩa 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 của 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ụ: "vi-VN".

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 quy định của BCP-47. ví dụ: "vi-VN".

subscriptionPeriod

string

Kỳ hạn của gói thuê bao, được chỉ định ở đị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 ở định dạng ISO 8601. Giá trị được chấp nhận là bất cứ lúc nào từ P7D (bảy ngày) đến P999D (999 ngày).

gracePeriod

string

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

Trường kết hợp 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à 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 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 không xác định.
active Sản phẩm đã được đăng 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 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ả về trang thông tin trên Cửa hàng Play.

benefits[]

string

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

ManagedProductTaxAndComplianceSettings

Thông tin chi tiết về việc đánh thuế và tuân thủ pháp luật đối với các 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 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. Khoá là mã vùng theo xác định theo "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à 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á 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

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 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

Bản vá cho 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 gói thuê bao).