- Tài nguyên: Gói thuê bao
- BasePlan
- Trạng thái
- AutoRenewingBasePlanType
- ResubscribeState
- SubscriptionProrationMode
- PrepaidBasePlanType
- TimeExtension
- InstallmentsBasePlanType
- RenewalType
- RegionalBasePlanConfig
- OtherRegionsBasePlanConfig
- SubscriptionListing
- Phương thức
Tài nguyên: Gói thuê bao
Một gói thuê bao cho một ứng dụng.
| Biểu diễn dưới dạng JSON |
|---|
{ "packageName": string, "productId": string, "basePlans": [ { object ( |
| Trường | |
|---|---|
packageName |
Không thể thay đổi. Tên gói của ứng dụng gốc. |
productId |
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 bao gồm chữ cái viết thường (a-z), số (0-9), dấu gạch dưới (_) và dấu chấm (.). Mã sản phẩm phải bắt đầu bằng chữ cái viết thường hoặc số và có độ dài từ 1 đến 40 ký tự (bao gồm cả 1 và 40). |
basePlans[] |
Tập hợp các gói cơ bản cho gói thuê bao này. Đại diện cho giá và thời hạn của gói thuê bao nếu không có ưu đãi nào khác được áp dụng. |
listings[] |
Bắt buộc. Danh sách trang thông tin đã bản địa hoá cho gói thuê bao này. Phải chứa ít nhất một mục cho ngôn ngữ mặc định của ứng dụng mẹ. |
archived |
Chỉ có đầu ra. Không còn được dùng nữa: không hỗ trợ tính năng lưu trữ gói thuê bao. |
taxAndComplianceSettings |
Thông tin chi tiết về thuế và việc tuân thủ pháp luật. |
restrictedPaymentCountries |
Không bắt buộc. Những quốc gia mà việc mua gói thuê bao 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. |
BasePlan
Một gói cơ bản cho một gói thuê bao.
| Biểu diễn dưới dạng JSON |
|---|
{ "basePlanId": string, "state": enum ( |
| Trường | |
|---|---|
basePlanId |
Bắt buộc. Không thể thay đổi. Giá trị nhận dạng riêng biệt của gói cơ bản này. Phải là duy nhất trong gói thuê bao và tuân thủ RFC-1034. Tức là mã nhận dạng này chỉ được chứa chữ cái viết thường (a-z), chữ số (0-9) và dấu gạch nối (-), đồng thời có tối đa 63 ký tự. |
state |
Chỉ có đầu ra. Trạng thái của gói cơ bản, tức là gói đó có đang hoạt động hay không. Bạn có thể kích hoạt hoặc xoá các gói cơ bản ở trạng thái nháp và không hoạt động. Bạn có thể huỷ kích hoạt các gói cơ bản đang hoạt động. Bạn có thể huỷ các gói cơ bản không hoạt độ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. |
regionalConfigs[] |
Thông tin theo khu vực cho gói cơ bản này. |
offerTags[] |
Danh sách tối đa 20 thẻ tuỳ chỉnh được chỉ định cho gói cơ bản này và được trả về ứng dụng thông qua Thư viện Billing. Ưu đãi gói thuê bao cho gói cơ bản này cũng sẽ nhận được các thẻ ưu đãi này trong Thư viện Billing. |
otherRegionsConfig |
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, BasePlan 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. |
Trường nhóm base_plan_type. Loại gói cơ bản này. Bạn phải đặt đúng một giá trị. Bạn không thể thay đổi loại gói cơ bản sau khi tạo gói cơ bản. base_plan_type chỉ có thể là một trong những trạng thái sau: |
|
autoRenewingBasePlanType |
Đặt thời điểm gói cơ bản tự động gia hạn theo định kỳ. |
prepaidBasePlanType |
Đặt khi gói cơ bản không tự động gia hạn vào cuối kỳ thanh toán. |
installmentsBasePlanType |
Đặt cho các gói cơ bản trả góp mà người dùng cam kết thanh toán theo số lần cụ thể. |
Tiểu bang
Trạng thái hiện tại của gói cơ bản.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Trạng thái chưa xác định. |
DRAFT |
Gói cơ bản hiện đang ở trạng thái nháp và chưa được kích hoạt. Bạn có thể xoá tệp này một cách an toàn tại thời điểm này. |
ACTIVE |
Gói cơ bản đang hoạt động và người đăng ký mới có thể mua. |
INACTIVE |
Gói cơ bản này không hoạt động và chỉ dành cho người đăng ký hiện tại. |
AutoRenewingBasePlanType
Đại diện cho một gói cơ bản tự động gia hạn khi kết thúc thời gian thuê bao.
| Biểu diễn dưới dạng JSON |
|---|
{ "billingPeriodDuration": string, "gracePeriodDuration": string, "accountHoldDuration": string, "resubscribeState": enum ( |
| Trường | |
|---|---|
billingPeriodDuration |
Bắt buộc. Không thể thay đổi. Kỳ hạn của gói thuê bao được chỉ định ở định dạng ISO 8601. Để biết danh sách các kỳ thanh toán được chấp nhận, hãy tham khảo trung tâm trợ giúp. Bạn không thể thay đổi thời hạn sau khi tạo gói cơ bản. |
gracePeriodDuration |
Thời gian ân hạn của gói thuê bao, được chỉ định ở định dạng ISO 8601. Giá trị được chấp nhận phải tính theo ngày và nằm trong khoảng từ P0D đến giá trị nhỏ hơn trong số 30D và kỳ thanh toán của gói cơ bản. Nếu bạn không chỉ định, hệ thống sẽ sử dụng giá trị mặc định dựa trên kỳ thanh toán. Tổng của gracePeriodDuration và accountHoldDuration phải nằm trong khoảng từ P30D đến P60D ngày. |
accountHoldDuration |
Không bắt buộc. Khoảng thời gian tạm ngưng tài khoản tuỳ chỉnh của gói thuê bao, được chỉ định theo định dạng ISO 8601. Giá trị được chấp nhận phải tính theo ngày và nằm trong khoảng từ P0D đến P60D. Trường trống thể hiện thời gian tạm ngưng tài khoản được đề xuất, được tính bằng 60 ngày trừ đi thời gian ân hạn. Tổng của gracePeriodDuration và accountHoldDuration phải nằm trong khoảng từ P30D đến P60D ngày. |
resubscribeState |
Liệu người dùng có thể đăng ký lại gói cơ bản này trên các nền tảng của Google Play hay không. Mặc định là RESUBSCRIBE_STATE_ACTIVE nếu không được chỉ định. |
prorationMode |
Chế độ tính theo tỷ lệ cho gói cơ bản xác định điều gì sẽ xảy ra khi người dùng chuyển sang gói này từ một gói cơ bản khác. Nếu không được chỉ định, giá trị mặc định sẽ là CHARGE_ON_NEXT_BILLING_DATE. |
legacyCompatible |
Liệu gói cơ bản gia hạn có tương thích ngược hay không. Gói cơ bản tương thích ngược do phương thức querySkuDetailsAsync() trả về (phương thức này không dùng nữa trong Google Play Billing Library). Chỉ một gói cơ bản gia hạn mới có thể được đánh dấu là tương thích với phiên bản cũ cho một gói thuê bao nhất định. |
legacyCompatibleSubscriptionOfferId |
Mã ưu đãi của gói thuê bao tương thích với phiên bản cũ. Ưu đãi gói thuê bao tương thích ngược do phương thức querySkuDetailsAsync() (phương thức không dùng nữa) của Google Play Billing Library trả về. Bạn chỉ có thể đánh dấu một ưu đãi gói thuê bao là tương thích với phiên bản cũ cho một gói cơ bản gia hạn nhất định. Để không có Ưu đãi gói thuê bao nào tương thích với phiên bản cũ, hãy đặt trường này thành chuỗi trống. |
ResubscribeState
Trạng thái đăng ký lại gói cơ bản.
| Enum | |
|---|---|
RESUBSCRIBE_STATE_UNSPECIFIED |
Trạng thái chưa xác định. |
RESUBSCRIBE_STATE_ACTIVE |
Tính năng đăng ký lại đang hoạt động. |
RESUBSCRIBE_STATE_INACTIVE |
Tính năng đăng ký lại không hoạt động. |
SubscriptionProrationMode
Chế độ chia tỷ lệ dùng để gia hạn gói cơ bản.
| Enum | |
|---|---|
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED |
Chế độ không xác định. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE |
Người dùng sẽ bị tính phí cho gói cơ bản mới vào cuối kỳ thanh toán hiện tại. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY |
Người dùng sẽ bị tính phí ngay lập tức và đầy đủ cho gói cơ bản mới. Thời gian còn lại của gói thuê bao hiện tại sẽ được dùng để kéo dài thời hạn của gói thanh toán mới. |
PrepaidBasePlanType
Đại diện cho một gói cơ bản không tự động gia hạn khi kết thúc gói cơ bản và người dùng phải gia hạn theo cách thủ công.
| Biểu diễn dưới dạng JSON |
|---|
{
"billingPeriodDuration": string,
"timeExtension": enum ( |
| Trường | |
|---|---|
billingPeriodDuration |
Bắt buộc. Không thể thay đổi. Kỳ hạn của gói thuê bao được chỉ định ở định dạng ISO 8601. Để biết danh sách các kỳ thanh toán được chấp nhận, hãy tham khảo trung tâm trợ giúp. Bạn không thể thay đổi thời hạn sau khi tạo gói cơ bản. |
timeExtension |
Người dùng có thể gia hạn gói cơ bản trả trước này trên các nền tảng của Google Play hay không. Giá trị mặc định là TIME_EXTENSION_ACTIVE nếu không được chỉ định. |
TimeExtension
Gia hạn thời gian của gói cơ bản.
| Enum | |
|---|---|
TIME_EXTENSION_UNSPECIFIED |
Trạng thái chưa xác định. |
TIME_EXTENSION_ACTIVE |
Tính năng gia hạn thời gian đang hoạt động. Người dùng được phép nạp tiền hoặc gia hạn gói trả trước. |
TIME_EXTENSION_INACTIVE |
Tính năng gia hạn thời gian không hoạt động. Người dùng không thể nạp tiền hoặc gia hạn gói trả trước. |
InstallmentsBasePlanType
Đại diện cho một gói cơ bản trả góp, trong đó người dùng cam kết thanh toán theo số lần cụ thể.
| Biểu diễn dưới dạng JSON |
|---|
{ "billingPeriodDuration": string, "committedPaymentsCount": integer, "renewalType": enum ( |
| Trường | |
|---|---|
billingPeriodDuration |
Bắt buộc. Không thể thay đổi. Kỳ hạn của gói thuê bao được chỉ định ở định dạng ISO 8601. Để biết danh sách các kỳ thanh toán được chấp nhận, hãy tham khảo trung tâm trợ giúp. Bạn không thể thay đổi thời hạn sau khi tạo gói cơ bản. |
committedPaymentsCount |
Bắt buộc. Không thể thay đổi. Số lần thanh toán mà người dùng cam kết. Bạn không thể thay đổi giá trị này sau khi tạo gói cơ bản. |
renewalType |
Bắt buộc. Không thể thay đổi. Loại gia hạn gói cơ bản trả góp. Xác định hành vi khi kết thúc cam kết ban đầu. Bạn không thể thay đổi loại gia hạn sau khi tạo gói cơ bản. |
gracePeriodDuration |
Thời gian ân hạn của gói thuê bao, được chỉ định ở định dạng ISO 8601. Giá trị được chấp nhận phải tính theo ngày và nằm trong khoảng từ P0D đến giá trị nhỏ hơn trong số 30D và kỳ thanh toán của gói cơ bản. Nếu bạn không chỉ định, hệ thống sẽ sử dụng giá trị mặc định dựa trên kỳ thanh toán. Tổng của gracePeriodDuration và accountHoldDuration phải nằm trong khoảng từ P30D đến P60D ngày. |
accountHoldDuration |
Không bắt buộc. Khoảng thời gian tạm ngưng tài khoản tuỳ chỉnh của gói thuê bao, được chỉ định theo định dạng ISO 8601. Giá trị được chấp nhận phải tính theo ngày và nằm trong khoảng từ P0D đến P60D. Trường trống thể hiện thời gian tạm ngưng tài khoản được đề xuất, được tính bằng 60 ngày trừ đi thời gian ân hạn. Tổng của gracePeriodDuration và accountHoldDuration phải nằm trong khoảng từ P30D đến P60D ngày. |
resubscribeState |
Liệu người dùng có thể đăng ký lại gói cơ bản này trên các nền tảng của Google Play hay không. Mặc định là RESUBSCRIBE_STATE_ACTIVE nếu không được chỉ định. |
prorationMode |
Chế độ tính theo tỷ lệ cho gói cơ bản xác định điều gì sẽ xảy ra khi người dùng chuyển sang gói này từ một gói cơ bản khác. Nếu không được chỉ định, giá trị mặc định sẽ là CHARGE_ON_NEXT_BILLING_DATE. |
RenewalType
Loại gia hạn gói cơ bản trả góp. Xác định hành vi khi kết thúc cam kết ban đầu. Bạn không thể thay đổi loại gia hạn sau khi tạo gói cơ bản.
| Enum | |
|---|---|
RENEWAL_TYPE_UNSPECIFIED |
Trạng thái chưa xác định. |
RENEWAL_TYPE_RENEWS_WITHOUT_COMMITMENT |
Gia hạn định kỳ trong suốt kỳ thanh toán mà không cần cam kết. |
RENEWAL_TYPE_RENEWS_WITH_COMMITMENT |
Gia hạn với cam kết có cùng thời hạn như cam kết ban đầu. |
RegionalBasePlanConfig
Cấu hình cho một gói cơ bản dành riêng cho một khu vực.
| Biểu diễn dưới dạng JSON |
|---|
{
"regionCode": string,
"newSubscriberAvailability": boolean,
"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". |
newSubscriberAvailability |
Liệu gói cơ bản ở khu vực được chỉ định có được cung cấp cho người đăng ký mới hay không. Gói thuê bao của người đăng ký hiện tại sẽ không bị huỷ nếu bạn đặt giá trị này thành false. Nếu không được chỉ định, giá trị này sẽ mặc định là false. |
price |
Giá của gói cơ bản ở khu vực được chỉ định. Phải được đặt nếu gói cơ bản được cung cấp cho người đăng ký mới. Phải được đặt bằng đơn vị tiền tệ liên kết với khu vực được chỉ định. |
OtherRegionsBasePlanConfig
Thông tin về giá cho mọi địa điểm mới mà Play có thể ra mắt.
| Biểu diễn dưới dạng JSON |
|---|
{ "usdPrice": { object ( |
| Trường | |
|---|---|
usdPrice |
Bắt buộc. Giá (bằng USD) áp dụng cho mọi địa điểm 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 địa điểm mới mà Play có thể ra mắt. |
newSubscriberAvailability |
Gói cơ bản có được cung cấp cho người đăng ký mới ở bất kỳ vị trí mới nào mà Play có thể ra mắt hay không. Nếu không được chỉ định, giá trị này sẽ mặc định là false. |
SubscriptionListing
Siêu dữ liệu mà người tiêu dùng nhìn thấy của một gói thuê bao.
| Biểu diễn dưới dạng JSON |
|---|
{ "languageCode": string, "title": string, "benefits": [ string ], "description": string } |
| Trường | |
|---|---|
languageCode |
Bắt buộc. Ngôn ngữ của trang thông tin này, theo định nghĩa của BCP-47, ví dụ: "en-US". |
title |
Bắt buộc. Tiêu đề của gói thuê bao này bằng ngôn ngữ của trang thông tin này. Văn bản thuần tuý. |
benefits[] |
Danh sách các lợi ích được hiển thị cho người dùng trên các nền tảng như Cửa hàng Play và trong quy trình khôi phục bằng ngôn ngữ của trang thông tin này. Văn bản thuần tuý. Danh sách theo thứ tự gồm tối đa 4 lợi ích. |
description |
Nội dung mô tả về gói thuê bao này bằng ngôn ngữ của trang thông tin này. Độ dài tối đa là 200 ký tự. Văn bản thuần tuý. |
Phương thức |
|
|---|---|
(deprecated) |
Không còn được dùng nữa: không hỗ trợ tính năng lưu trữ gói thuê bao. |
|
Đọc một hoặc nhiều gói thuê bao. |
|
Cập nhật một loạt gói thuê bao. |
|
Tạo gói thuê bao mới. |
|
Xoá gói thuê bao. |
|
Đọc một gói thuê bao. |
|
Liệt kê tất cả gói thuê bao trong một ứng dụng nhất định. |
|
Cập nhật gói thuê bao hiện có. |
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 |
|---|