REST Resource: monetization.onetimeproducts

Tài nguyên: OneTimeProduct

Một sản phẩm tính phí một lần cho một ứng dụng.

Biểu diễn dưới dạng JSON 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
Trường
packageName

string

Bắt buộc. Không thể thay đổi. Tên gói của ứng dụng mẹ.
productId

string

Bắt buộc. Không thể thay đổi. Mã sản phẩm duy nhất của sản phẩm. Riêng biệt trong ứng dụng mẹ. Mã sản phẩm phải bắt đầu bằng một số hoặc chữ cái viết thường và có thể chứa số (0 đến 9), chữ cái viết thường (a đến z), dấu gạch dưới (_) và dấu chấm (.).
listings[]

object (OneTimeProductListing)

Bắt buộc. Tập hợp dữ liệu tiêu đề và nội dung mô tả đã bản địa hoá. Không được có các mục trùng lặp có cùng languageCode.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Thông tin chi tiết về thuế và việc tuân thủ pháp luật.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Bắt buộc. Tập hợp các lựa chọn mua cho sản phẩm mua một lần này.
restrictedPaymentCountries

object (RestrictedPaymentCountries)

Không bắt buộc. Những quốc gia mà người dùng chỉ có thể mua sản phẩm tính phí một lần này bằng các phương thức thanh toán được đăng ký ở chính quốc gia đó. Nếu trống, sẽ không có quy định hạn chế nào về địa điểm thanh toán.
offerTags[]

object (OfferTag)

Không bắt buộc. Danh sách gồm tối đa 20 thẻ tuỳ chỉnh được chỉ định cho sản phẩm tính phí một lần này và được trả về cho ứng dụng thông qua thư viện thanh toán. Các lựa chọn mua và ưu đãi cho sản phẩm này cũng sẽ nhận được những thẻ này trong thư viện thanh toán.
regionsVersion

object (RegionsVersion)

Chỉ có đầu ra. Phiên bản của cấu hình khu vực được dùng để tạo sản phẩm tính phí một lần.

OneTimeProductListing

Trang thông tin tuỳ chỉnh trên Cửa hàng Play theo khu vực cho sản phẩm tính phí một lần.

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

string

Bắt buộc. Ngôn ngữ của trang thông tin này, theo BCP-47, ví dụ: "en-US".
title

string

Bắt buộc. Tiêu đề của sản phẩm này bằng ngôn ngữ của trang thông tin này. Độ dài tối đa là 55 ký tự.
description

string

Bắt buộc. Nội dung mô tả về sản phẩm này bằng ngôn ngữ của trang thông tin này. Độ dài tối đa là 200 ký tự.

OneTimeProductTaxAndComplianceSettings

Thông tin chi tiết về thuế, chính sách của Google Play và việc tuân thủ pháp luật đối với các sản phẩm tính phí một lần.

Biểu diễn dưới dạng JSON 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
Trường
regionalTaxConfigs[]

object (RegionalTaxConfig)

Cấu hình thuế theo khu vực.
isTokenizedDigitalAsset

boolean

Sản phẩm tính phí một lần 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.

RegionalTaxConfig

Thông tin chi tiết về thuế ở một khu vực địa lý nhất định.

Biểu diễn dưới dạng JSON 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
Trường
regionCode

string

Bắt buộc. Mã vùng mà cấu hình này áp dụng, theo định nghĩa của ISO 3166-2, ví dụ: "US".
taxTier

enum (TaxTier)

Bậc thuế để chỉ định thuế suất được giảm. Các nhà phát triển bán tin tức, tạp chí, báo, sách hoặc sách nói kỹ thuật số ở nhiều khu vực có thể đủ điều kiện được giảm thuế suất.

Tìm hiểu thêm.
eligibleForStreamingServiceTaxRate

boolean

Bạn phải cho chúng tôi biết ứng dụng của bạn có chứa sản phẩm truyền trực tuyến hay không để chúng tôi có thể tính chính xác thuế bán hàng tại tiểu bang và địa phương ở Hoa Kỳ. Trường này chỉ được hỗ trợ ở Hoa Kỳ.
streamingTaxType

enum (StreamingTaxType)

Để thu thuế truyền thông hoặc thuế giải trí ở Hoa Kỳ, hãy chọn danh mục thuế phù hợp.

Tìm hiểu thêm.

OneTimeProductPurchaseOption

Một lựa chọn mua duy nhất cho sản phẩm tính phí một lần.

Biểu diễn dưới dạng JSON 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
Trường
purchaseOptionId

string

Bắt buộc. Không thể thay đổi. Giá trị nhận dạng riêng biệt của lựa chọn mua này. Phải là duy nhất trong sản phẩm tính phí một lần. Mã này phải bắt đầu bằng một chữ số hoặc chữ cái viết thường, đồng thời chỉ được chứa chữ cái viết thường (a-z), chữ số (0-9) và dấu gạch nối (-). Độ dài tối đa là 63 ký tự.
state

enum (State)

Chỉ có đầu ra. Trạng thái của lựa chọn mua, tức là liệu lựa chọn đó có đang hoạt động hay không. Bạn không thể thay đổi trường này bằng cách cập nhật tài nguyên. Thay vào đó, hãy sử dụng các điểm cuối chuyên dụng.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Thông tin về giá và tình trạng còn hàng theo khu vực của lựa chọn mua này.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

Thông tin về giá cho mọi vị trí mới mà Play có thể ra mắt trong tương lai. Nếu bạn bỏ qua bước này, lựa chọn mua sẽ không tự động xuất hiện ở bất kỳ vị trí mới nào mà Play có thể ra mắt trong tương lai.
offerTags[]

object (OfferTag)

Không bắt buộc. Danh sách gồm tối đa 20 thẻ tuỳ chỉnh được chỉ định cho lựa chọn mua hàng này và được trả về cho ứng dụng thông qua thư viện thanh toán. Các ưu đãi cho lựa chọn mua này cũng sẽ nhận được những thẻ này trong thư viện thanh toán.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

Không bắt buộc. Thông tin chi tiết về thuế và việc tuân thủ pháp luật.
Trường nhóm purchase_option_type. Loại lựa chọn mua này. Bạn phải đặt đúng một. purchase_option_type chỉ có thể là một trong những trạng thái sau:
buyOption

object (OneTimeProductBuyPurchaseOption)

Một lựa chọn mua có thể mua được.
rentOption

object (OneTimeProductRentPurchaseOption)

Một lựa chọn mua có thể thuê.

Tiểu bang

Trạng thái hiện tại của lựa chọn mua.

Enum
STATE_UNSPECIFIED Giá trị mặc định, không bao giờ được sử dụng.
DRAFT Người dùng không thể sử dụng lựa chọn mua này và chưa bao giờ có thể sử dụng.
ACTIVE Người dùng có thể sử dụng lựa chọn mua.
INACTIVE Người dùng không thể sử dụng lựa chọn mua này nữa.
INACTIVE_PUBLISHED Bạn không thể mua lựa chọn mua hàng này nữa, nhưng chúng tôi vẫn tiếp tục cung cấp ưu đãi của lựa chọn này thông qua Thư viện Play Billing để đảm bảo khả năng tương thích ngược. Chỉ những lựa chọn mua được di chuyển tự động mới có thể ở trạng thái này.

OneTimeProductBuyPurchaseOption

Một lựa chọn mua có thể mua được.

Biểu diễn dưới dạng JSON 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
Trường
legacyCompatible

boolean

Không bắt buộc. Lựa chọn mua này có được cung cấp trong các quy trình PBL cũ không hỗ trợ mô hình sản phẩm tính phí một lần hay không.

Bạn có thể đánh dấu tối đa một lựa chọn mua "mua" là tương thích ngược.
multiQuantityEnabled

boolean

Không bắt buộc. Tuỳ chọn mua này có cho phép mua nhiều mặt hàng hay không. Tính năng mua nhiều mặt hàng cho phép người mua mua nhiều mặt hàng trong một lần thanh toán.

OneTimeProductRentPurchaseOption

Một lựa chọn mua có thể thuê.

Biểu diễn dưới dạng JSON 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
Trường
rentalPeriod

string

Bắt buộc. Khoảng thời gian mà người dùng có quyền sử dụng. Bắt đầu khi hoàn tất quy trình mua. Được chỉ định ở định dạng ISO 8601.
expirationPeriod

string

Không bắt buộc. Khoảng thời gian mà người dùng có sau khi bắt đầu sử dụng quyền trước khi quyền đó bị thu hồi. Được chỉ định ở định dạng ISO 8601.

RegionalPricingAndAvailabilityConfig

Cấu hình giá và tình trạng còn hàng theo khu vực cho một lựa chọn mua.

Biểu diễn dưới dạng JSON 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
Trường
regionCode

string

Bắt buộc. Mã vùng mà cấu hình này áp dụng, theo định nghĩa của ISO 3166-2, ví dụ: "US".
price

object (Money)

Giá của lựa chọn mua ở khu vực được chỉ định. Bạn phải đặt đơn vị tiền tệ được liên kết với khu vực đã chỉ định.
availability

enum (Availability)

Phạm vi cung cấp của lựa chọn mua.

Phạm vi cung cấp

Phạm vi cung cấp của lựa chọn mua.

Enum
AVAILABILITY_UNSPECIFIED Tình trạng còn hàng không được chỉ định. Không được sử dụng.
AVAILABLE Người dùng có thể sử dụng lựa chọn mua.
NO_LONGER_AVAILABLE Người dùng không thể sử dụng lựa chọn mua này nữa. Bạn chỉ có thể sử dụng giá trị này nếu trước đó bạn đặt trạng thái còn hàng là AVAILABLE.
AVAILABLE_IF_RELEASED Ban đầu, lựa chọn mua không có sẵn, nhưng sẽ có sẵn thông qua ưu đãi đặt hàng trước đã phát hành.

OneTimeProductPurchaseOptionNewRegionsConfig

Thông tin định giá cho mọi khu vực mới mà Play có thể ra mắt trong tương lai.

Biểu diễn dưới dạng JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
Trường
usdPrice

object (Money)

Bắt buộc. Giá bằng USD để sử dụng cho mọi khu vực mới mà Play có thể ra mắt.
eurPrice

object (Money)

Bắt buộc. Giá bằng EUR để sử dụng cho mọi khu vực mới mà Play có thể ra mắt.
availability

enum (Availability)

Bắt buộc. Tình trạng cung cấp theo khu vực cho cấu hình khu vực mới. Khi bạn đặt thành CÓ SẴN, thông tin định giá sẽ được dùng cho mọi khu vực mới mà Play có thể ra mắt trong tương lai.

Phạm vi cung cấp

Tình trạng cung cấp cấu hình khu vực mới.

Enum
AVAILABILITY_UNSPECIFIED Tình trạng còn hàng không được chỉ định. Không được sử dụng.
AVAILABLE Cấu hình này sẽ được dùng cho mọi khu vực mới mà Play có thể ra mắt trong tương lai.
NO_LONGER_AVAILABLE Cấu hình này không còn được cung cấp và sẽ không được dùng cho bất kỳ khu vực mới nào mà Play có thể ra mắt trong tương lai. Bạn chỉ có thể sử dụng giá trị này nếu trước đó bạn đặt trạng thái còn hàng là AVAILABLE.

PurchaseOptionTaxAndComplianceSettings

Thông tin chi tiết về thuế, chính sách của Google Play và việc tuân thủ pháp luật đối với các lựa chọn mua sản phẩm tính phí một lần.

Biểu diễn dưới dạng JSON 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
Trường
withdrawalRightType

enum (WithdrawalRightType)

Không bắt buộc. 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 ở những khu vực đủ điều kiện.

Nếu bạn không đặt, giá trị mặc định sẽ là WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

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.

Phương thức

batchDelete

 Xoá một hoặc nhiều sản phẩm tính phí một lần.

batchGet

 Đọc một hoặc nhiều sản phẩm tính phí một lần.

batchUpdate

 Tạo hoặc cập nhật một hoặc nhiều sản phẩm tính phí một lần.

delete

 Xoá một sản phẩm tính phí một lần.

get

 Đọc một sản phẩm tính phí một lần.

list

 Liệt kê tất cả sản phẩm tính phí một lần trong một ứng dụng nhất định.

patch

 Tạo hoặc cập nhật sản phẩm tính phí một lần.