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 gốc.

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. Duy nhấ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 về 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 tính phí một lần này.

restrictedPaymentCountries

object (RestrictedPaymentCountries)

Không bắt buộc. Những quốc gia mà việc mua sản phẩm tính phí một lần này bị hạn chế đối với các phương thức thanh toán được đăng ký ở chính quốc gia đó. Nếu bạn để trống, thì 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 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ề ứng dụng thông qua Thư viện Billing. Các lựa chọn mua và ưu đãi cho sản phẩm này cũng sẽ nhận được các thẻ này trong Thư viện Billing.

regionsVersion

object (RegionsVersion)

Chỉ có đầu ra. Phiên bản 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 tại khu vực trên Cửa hàng Play 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 quy định của 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 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,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
Trường
regionalTaxConfigs[]

object (RegionalTaxConfig)

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

isTokenizedDigitalAsset

boolean

Liệu 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.

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ã khu vực US.

productTaxCategoryCode

string

Mã danh mục thuế của sản phẩm để chỉ định cho sản phẩm tính phí một lần. 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.

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ã khu vực áp dụng cấu hình này, theo định nghĩa của ISO 3166-1 alpha-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ể sẽ đủ điều kiện được giảm mức thuế.

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 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 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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of mutually exclusive fields.
}
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à 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 cho 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, lựa chọn mua sẽ không tự động được cung cấp ở 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 tối đa 20 thẻ tuỳ chỉnh được chỉ định cho lựa chọn mua này và được trả về ứng dụng thông qua Thư viện Billing. Ưu đãi cho lựa chọn mua này cũng sẽ nhận được các thẻ này trong Thư viện Billing.

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.

Loại lựa chọn mua. Bạn phải đặt đúng một giá trị. 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:
buyOption

object (OneTimeProductBuyPurchaseOption)

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

rentOption

object (OneTimeProductRentPurchaseOption)

Lựa chọn mua theo hình thức thuê.

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

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 Lựa chọn mua này không và chưa từng được cung cấp cho người 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 Lựa chọn mua hàng không còn được cung cấp để mua nữa, nhưng chúng tôi vẫn tiếp tục hiển thị ưu đãi của lựa chọn đó 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. Liệu 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 loại "Mua" là tương thích ngược.

multiQuantityEnabled

boolean

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

OneTimeProductRentPurchaseOption

Lựa chọn mua theo hình thức 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 truy cập. 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ã khu vực áp dụng cấu hình này, theo định nghĩa của ISO 3166-1 alpha-2, ví dụ: "US".

price

object (Money)

Giá của lựa chọn mua ở khu vực được chỉ định. Phải được đặt bằng đơn vị tiền tệ liên kết với khu vực được chỉ định.

availability

enum (Availability)

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

Phạm vi cung cấp

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

Enum
AVAILABILITY_UNSPECIFIED Tình trạng còn hàng không xác đị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 đó đã đặt tình trạng còn hàng là AVAILABLE.
AVAILABLE_IF_RELEASED Ban đầu, lựa chọn mua không có sẵn nhưng sau đó được cung cấp thông qua một ưu đãi đặt hàng trước đã phát hành.
AVAILABLE_FOR_OFFERS_ONLY Lựa chọn mua không có sẵn nhưng các ưu đãi liên kết với lựa chọn đó (tức là ưu đãi Play Points) thì có sẵn.

OneTimeProductPurchaseOptionNewRegionsConfig

Thông tin về 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á tính bằng USD để áp 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á tính bằng EUR để áp 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 còn hàng theo khu vực cho cấu hình khu vực mới. Khi bạn đặt thành CÓ, thông tin về 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

Phạm vi cung cấp của cấu hình khu vực mới.

Enum
AVAILABILITY_UNSPECIFIED Tình trạng còn hàng không xác đị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 hoạt động 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 đó đã đặt tình trạng 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 đến 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 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á 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.

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