REST Resource: operators.planStatuses
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:PlanStatus
PlanStatus 包含使用者購買的所有頂層行動服務套裝組合詳細資料。
JSON 表示法 |
{
"name": string,
"plans": [
{
object (Plan )
}
],
"languageCode": string,
"expireTime": string,
"updateTime": string,
"title": string,
"subscriberId": string,
"accountInfo": {
object (AccountInfo )
},
"uiCompatibility": enum (UiCompatibility ),
"notifications": [
enum (NotificationType )
],
"planInfoPerClient": {
object (PlanInfoPerClient )
}
} |
欄位 |
name |
string
PlanStatus 的資源名稱,格式如下:operators/{asn_id}/planStatuses/{userKey} 。建立 PlanStatus 項目時,系統會忽略名稱。
|
plans[] |
object (Plan )
這個使用者擁有的方案清單。
|
languageCode |
string
必要欄位。BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。
|
expireTime |
string (Timestamp format)
必要欄位。共用方案群組資訊過時的時間。屆時應用程式將無法再收到 PlanStatus。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位。範例:"2014-10-02T15:01:23.045123456Z" 。
|
updateTime |
string (Timestamp format)
必要欄位。資料方案代理程式 (DPA) 從後端系統擷取方案狀態資訊的時間。可用於判斷方案狀態資訊的更新時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位。範例:"2014-10-02T15:01:23.045123456Z" 。
|
title |
string
使用者與電信業者簽訂的合約名稱。這會顯示在 UI 標題中。
|
subscriberId |
string
電信系統中的專屬固定 ID,用於識別使用者。
|
accountInfo |
object (AccountInfo )
預付型使用者必須提供。使用者帳戶餘額相關資訊。
|
uiCompatibility |
enum (UiCompatibility )
決定是否要在使用者介面中向使用者顯示 PlanStatus。如果設為 UI_INCOMPATIBLE,PlanStatus 可用於傳送通知給使用者,但不會用於向使用者顯示方案資訊。
|
notifications[] |
enum (NotificationType )
已傳送給使用者的通知類型。
|
planInfoPerClient |
object (PlanInfoPerClient )
|
方法 |
|
行動網路業者 (以專屬自治系統編號 (ASN) 識別) 可新增 PlanStatus 項目。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-26 (世界標準時間)。"],[[["PlanStatus provides details of all top-level mobile service packages purchased by a user, including plan information, account balance (for prepaid users), and notification types."],["It includes fields like `name`, `plans`, `languageCode`, `expireTime`, `updateTime`, `title`, `subscriberId`, `accountInfo`, `uiCompatibility`, `notifications`, and `planInfoPerClient`, providing comprehensive data about the user's mobile service package."],["PlanStatus resources are identified by a unique name in the format `operators/{asn_id}/planStatuses/{userKey}` and have a JSON representation for data exchange."],["Mobile operators can create new PlanStatus entries using the `create` method, allowing them to manage and update user plan information."]]],["PlanStatus details mobile service packages purchased by a user. Key data includes the user's `name`, associated `plans`, `languageCode`, and `subscriberId`. It specifies `expireTime` and `updateTime` for the data's validity. `accountInfo` is required for prepaid users. `uiCompatibility` determines display status, and `notifications` lists sent alerts. A mobile operator can use the `create` method to add new PlanStatus entries, as identified by their unique Autonomous System Number.\n"]]