- Tài nguyên: OneTimeProduct
- OneTimeProductListing
- OneTimeProductTaxAndComplianceSettings
- RegionalTaxConfig
- OneTimeProductPurchaseOption
- Trạng thái
- OneTimeProductBuyPurchaseOption
- OneTimeProductRentPurchaseOption
- RegionalPricingAndAvailabilityConfig
- Phạm vi cung cấp
- OneTimeProductPurchaseOptionNewRegionsConfig
- Phạm vi cung cấp
- PurchaseOptionTaxAndComplianceSettings
- Phương thức
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 ( |
| Trường | |
|---|---|
packageName |
Bắt buộc. Không thể thay đổi. Tên gói của ứng dụng gốc. |
productId |
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[] |
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 |
Thông tin chi tiết về thuế và việc tuân thủ pháp luật. |
purchaseOptions[] |
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 |
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[] |
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 |
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 |
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 |
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 |
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 ( |
| Trường | |
|---|---|
regionalTaxConfigs[] |
Cấu hình thuế theo khu vực. |
isTokenizedDigitalAsset |
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[] |
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 |
productTaxCategoryCode |
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 ( |
| Trường | |
|---|---|
regionCode |
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 |
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ế. |
eligibleForStreamingServiceTaxRate |
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 |
Để 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. |
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 ( |
| Trường | |
|---|---|
purchaseOptionId |
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 |
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[] |
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 |
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[] |
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 |
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 |
Một lựa chọn mua có thể mua được. |
rentOption |
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 |
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 |
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 |
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 |
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 ( |
| Trường | |
|---|---|
regionCode |
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 |
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 |
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 ( |
| Trường | |
|---|---|
usdPrice |
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 |
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 |
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 ( |
| Trường | |
|---|---|
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à 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 |
|
|---|---|
|
Xoá một hoặc nhiều sản phẩm tính phí một lần. |
|
Đọc một hoặc nhiều sản phẩm tính phí một lần. |
|
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. |
|
Xoá sản phẩm tính phí một lần. |
|
Đọc một sản phẩm tính phí một lần. |
|
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. |
|
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 |
|---|