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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of mutually exclusive fields.
}
Trường
packageName

string

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

sku

string

Mã đơ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 được bằng 0 vì sản phẩm trong ứng dụng không bao giờ miễn phí. Luôn theo đơn vị tiền tệ của người bán trong 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ã khu vực, 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á bản đồ là ngôn ngữ của dữ liệu đã 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 quy định của BCP-47, ví dụ: "en-US".

subscriptionPeriod
(deprecated)

string

Không dùng nữa: Gói thuê bao không còn được hỗ trợ trong InAppProducts API. Thay vào đó, hãy sử dụng Subscriptions API.

trialPeriod
(deprecated)

string

Không dùng nữa: Gói thuê bao không còn được hỗ trợ trong InAppProducts API. Thay vào đó, hãy sử dụng Subscriptions API.

gracePeriod
(deprecated)

string

Không dùng nữa: Gói thuê bao không còn được hỗ trợ trong InAppProducts API. Thay vào đó, hãy sử dụng Subscriptions API.

Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
subscriptionTaxesAndComplianceSettings
(deprecated)

object (SubscriptionTaxAndComplianceSettings)

Không dùng nữa: Gói thuê bao không còn được hỗ trợ trong InAppProducts API. Thay vào đó, hãy sử dụng Subscriptions API.

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

Kết thúc các trường loại trừ lẫn nhau.

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 xuất bản và đang hoạt động trong cửa hàng.
inactive Sản phẩm này 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 – mua hàng một lần.
subscription

Không dùng nữa: Gói thuê bao không còn được hỗ trợ trong InAppProducts API. Thay vào đó, hãy sử dụng Subscriptions API.

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[]
(deprecated)

string

Không dùng nữa: Gói thuê bao không còn được hỗ trợ trong InAppProducts API. Thay vào đó, hãy sử dụng Subscriptions API.

ManagedProductTaxAndComplianceSettings

Thông tin chi tiết về thuế và việc 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,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
Trường
eeaWithdrawalRightType

enum (WithdrawalRightType)

Phân loại nội dung hoặc dịch vụ 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 ở 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 trên Trung tâm trợ giúp để biết thêm thông tin.

taxRateInfoByRegionCode

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

Ánh xạ từ mã khu vực đến thông tin chi tiết về thuế suất. 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.

regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

Thông tin về mức phân loại theo độ tuổi theo khu vực. Hiện tại, trường này chỉ được hỗ trợ cho mã vùng US.

productTaxCategoryCode

string

Mã danh mục thuế sản phẩm để chỉ định cho sản phẩm trong ứng dụng. Danh mục thuế cho sản phẩm xác định mức thuế suất giao dịch áp dụng cho sản phẩm. Hãy tham khảo bài viết trên Trung tâm trợ giúp để biết thêm thông tin.

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, bao gồm 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).

Mã lỗi

Các thao tác của tài nguyên này trả về các mã lỗi HTTP sau:

Mã lỗi Lý do Mô tả Độ phân giải