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ụ: 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 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ó 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 of localized title and description data. Khoá bản đồ là ngôn ngữ của dữ liệu được bản địa hoá, theo quy định 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 được bản địa hoá, theo quy định 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ó thể 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 ở đị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 nhóm TaxAndComplianceType.

TaxAndComplianceType chỉ có thể là một trong những trạng thá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 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 chưa 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 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 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 đề của 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 được bản địa hoá cho gói thuê bao.

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
}
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 trên Trung tâm trợ giúp để biết thêm thông tin.
taxRateInfoByRegionCode

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

Một mối liên kết từ mã khu vực đến thông tin chi tiết về thuế suất. Khoá là mã khu vực theo định nghĩa của "CLDR" trong 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

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à một sản phẩm được quản lý hoặc một 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 mộ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 sẽ trả về các mã lỗi HTTP sau:

Mã lỗi Lý do Độ phân giải
5xx Lỗi chung trong máy chủ Google Play. Hãy thử gửi lại yêu cầu.

Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với người quản lý tài khoản Google Play hoặc gửi yêu cầu hỗ trợ. Hãy cân nhắc kiểm tra Trang tổng quan về trạng thái của Play để xem có sự cố ngừng hoạt động nào đã biết hay không.
409 Lỗi cập nhật đồng thời.

Đã có một nỗ lực cập nhật một đối tượng đang được cập nhật. Ví dụ: giao dịch mua được xác nhận bằng cách gọi phương thức acknowledgePurchase() của Thư viện Play Billing và gọi purchases.products.acknowledge của API Nhà phát triển Play cùng một lúc.

 Hãy thử gửi lại yêu cầu.