Google Play 商店結構定義參考資料
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
匯出的物件：安裝次數
匯出的物件代表：Google Play 應用程式安裝次數清單。
物件會以 JSON 格式匯出
匯出的物件包含下列欄位：
| * 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異，部分服務或動作不會產生所述的每個資料欄位。 |
| 資料欄位 * | 欄位定義 | 資料欄位類型 |
|---|
| 文件 | 已安裝應用程式的文件，內含標題和文件類型等資訊。 | json |
| deviceAttribute | 應用程式安裝所在裝置的屬性，包括型號、製造商和電信業者。 | json |
| firstInstallationTime | 應用程式在裝置上的首次安裝時間。 | 時間戳記 |
| lastUpdateTime | 裝置上一次更新應用程式的時間。 | 時間戳記 |
匯出物件：兌換記錄
匯出物件代表：您的 Google Play 促銷活動兌換記錄清單。
物件會以 JSON 格式匯出
匯出的物件包含下列欄位：
| * 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異，部分服務或動作不會產生所述的每個資料欄位。 |
| 資料欄位 * | 欄位定義 | 資料欄位類型 |
|---|
| 轉換 | 使用者兌換代碼後獲得的文件。貨幣促銷活動類型不適用。 | json |
| 裝置 | 兌換代碼的裝置相關資訊。 | json |
| userCountry | 使用者的「Play 國家/地區」，以大寫 III 國家/地區代碼指定。 | 字串 |
| ipCountry | 根據兌換使用者的 IP 位址，以大寫 III 表示的國家/地區代碼。 | 字串 |
| billingCountry | 根據兌換使用者的帳單地址，以大寫字母表示的 III 國家/地區代碼。只有在使用者有付款方式時，才會設定這項屬性。 | 字串 |
| 狀態 | 兌換狀態 (已兌換或失敗)。 | 字串 |
| redemptionChangeTime | 這項記錄上次變更的時間。 | 時間戳記 |
| formattedMoney | 使用者兌換代碼後獲得的金額 (已格式化)，例如「10.00 USD」。 | 字串 |
| moneyExpiredTime | 已預先撥付金額的到期時間戳記。 | 字串 |
匯出的物件：圖書館 匯出的物件代表：您的 Google Play 下載項目 (包括音樂、電影和應用程式) 清單。
物件會以 JSON 格式匯出
匯出的物件包含下列欄位：
| * 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異，部分服務或動作不會產生所述的每個資料欄位。 |
| 資料欄位 * | 欄位定義 | 資料欄位類型 |
|---|
| 文件 | 程式庫項目的文件。包含標題和文件類型等資訊。 | json |
| acquisitionTime | 程式庫項目的取得時間。 | 時間戳記 |
匯出物件：購買交易
匯出物件代表：Google Play 購買交易清單。
物件會以 JSON 格式匯出
匯出的物件包含下列欄位：
| * 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異，部分服務或動作不會產生所述的每個資料欄位。 |
| 資料欄位 * | 欄位定義 | 資料欄位類型 |
|---|
| 文件 | 購買商品的證明文件。包含標題和文件類型等資訊。 | json |
| invoicePrice | 商品的購買價格。 | 字串 |
| purchaseState | 購買交易的目前狀態。 | 字串 |
| purchaserName | 如果購物者是其他家庭成員，系統會顯示該家庭成員的姓名。 | 字串 |
| paymentMethodTitle | 用於購買的付款方式名稱。 | 字串 |
| purchaseTime | 發起購買交易的時間，在購買交易的生命週期內保持穩定。 | 時間戳記 |
| userLanguageCode | 使用者在購買時的語言代碼。 | 字串 |
| userCountry | 使用者在購買時所在的國家/地區。 | 字串 |
| giftInfo | 禮物購買交易的相關資訊。包括寄件者姓名、收件者電子郵件地址、禮物訊息和禮物代碼。 | json |
匯出的物件：裝置
匯出的物件代表：曾存取 Google Play 商店的裝置相關中繼資料。
物件會以 JSON 格式匯出
匯出的物件包含下列欄位：
| * 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異，部分服務或動作不會產生所述的每個資料欄位。 |
| 資料欄位 * | 欄位定義 | 資料欄位類型 |
|---|
| mostRecentData | 裝置最近回報的裝置設定。包括裝置型號資訊、電信業者屬性、Play 屬性和使用者設定。 | json |
| deviceRegistrationTime | 裝置註冊時間。 | 時間戳記 |
| userAddedOnDeviceTime | 使用者新增至裝置的時間。 | 時間戳記 |
| lastTimeDeviceActive | 裝置上次回報裝置設定的時間。 | 時間戳記 |
| dataAtTimeOfUserPlayActivity | 使用者上次與 Play 商店互動時的裝置設定。包括裝置型號資訊、電信業者屬性、Play 屬性和使用者設定。 | json |
匯出物件：訂閱項目
匯出物件代表：Google Play 訂閱項目清單。
物件會以 JSON 格式匯出
匯出的物件包含下列欄位：
| * 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異，部分服務或動作不會產生所述的每個資料欄位。 |
| 資料欄位 * | 欄位定義 | 資料欄位類型 |
|---|
| 文件 | 訂閱項目的文件。包含標題和文件類型等資訊。 | json |
| expirationDate | 訂閱到期日。 | 時間戳記 |
| renewalDate | 訂閱方案的續約日期。 | 時間戳記 |
| 定價 | 訂閱方案的定價詳細資料，包括價格和定價時間範圍。 | json |
| userChangeRecord | 使用者對訂閱項目所做的變更，例如取消、重新啟用、變更付款方式，包括變更的詳細資訊。 | json |
| 州 | 訂閱方案的目前狀態。 | 字串 |
匯出物件：Play 分組
匯出物件代表：您的 Google Play 分組標記清單。
物件會以 JSON 格式匯出
匯出的物件包含下列欄位：
| * 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異，部分服務或動作不會產生所述的每個資料欄位。 |
| 資料欄位 * | 欄位定義 | 資料欄位類型 |
|---|
| packageName | 應用程式的套件名稱。 | 字串 |
| userTags | 應用程式的使用者標記，包括標記的鍵和值，以及標記上次更新的時間戳記。 | json |
匯出物件：Play 使用者設定
匯出物件代表：Google Play 應用程式的設定。
物件會以 JSON 格式匯出
匯出的物件包含下列欄位：
| * 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異，部分服務或動作不會產生所述的每個資料欄位。 |
| 資料欄位 * | 欄位定義 | 資料欄位類型 |
|---|
| familyApproval | 家庭成員的本地/遠端升級記錄。 | json |
| testingProgramListItem | 使用者的測試計畫清單項目。 | json |
| userCountryCode | 使用者的國家/地區代碼。 | 字串 |
| familyWalletSetting | 使用者的家庭錢包設定。 | json |
| familySharingPreference | 新購買項目 (例如應用程式、書籍和電影) 的家庭群組分享偏好設定。 | json |
| marketingPreferences | 與行銷相關的使用者偏好設定。 | json |
| receiveReplyToReviewEmail | 使用者選擇是否要接收開發人員回覆通知。 | 布林值 |
| liveOpsReminderListItem | 使用者的 LiveOps 提醒清單項目。 | json |
| budgetSettings | 使用者的預算設定。 | 字串 |
| userInterest | 使用者明確選擇的興趣。 | json |
匯出物件：Play Points
匯出物件代表：您的 Play Points 相關資訊。
物件會以 JSON 格式匯出
匯出的物件包含下列欄位：
| * 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異，部分服務或動作不會產生所述的每個資料欄位。 |
| 資料欄位 * | 欄位定義 | 資料欄位類型 |
|---|
| 成員資格 | 使用者目前 Play Points 會籍的快照，包括狀態、加入時間和等級。 | json |
| pointsHistory | 使用者的 Play 點數交易資訊，包括時間、類別和點數變更。 | json |
匯出物件：促銷活動
匯出物件代表：Google Play 促銷活動清單。
物件會以 JSON 格式匯出
匯出的物件包含下列欄位：
| * 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異，部分服務或動作不會產生所述的每個資料欄位。 |
| 資料欄位 * | 欄位定義 | 資料欄位類型 |
|---|
| instanceContext | 內含促銷活動的中繼資料，例如國家/地區、到期時間和幣別。 | json |
| 國家/地區 | 使用者註冊活動時所在的國家/地區。 | 字串 |
| 文件 | 優待券文件。 | json |
| totalQuantity | 註冊時促銷活動的總數量。 | 整數 |
| expiryTime | 促銷活動的到期時間。 | 時間戳記 |
| formattedMoney | 使用者兌換促銷活動後獲得的金額。 | 字串 |
| moneyExpiredTime | 已佈建的金額價值到期時間。 | 時間戳記 |
| promotionHistory | 促銷活動狀態轉換記錄。 | json |
| promotionState | 促銷活動的狀態資訊。 | json |
| 狀態 | 促銷活動狀態。 | 字串 |
| 時間戳記 | 狀態轉換發生的時間。 | 時間戳記 |
| 裝置 | 使用者觸發動作的裝置，該動作會導致促銷活動狀態轉換。 | json |
| userCountry | 使用者的「Play 國家/地區」，以大寫 III 國家/地區代碼指定。 | 字串 |
| userLocale | 使用者前端或應用程式的語言代碼，用於註冊促銷活動。 | json |
| lastModificationTime | 促銷活動上次變更的時間。 | 時間戳記 |
代表資源群組和隨其匯出物件的表格。| 資源群組 * | 說明 | 匯出的物件 | 時間篩選器說明 |
|---|
| play.installs | |
安裝次數 | 項目安裝/更新的時間戳記。 |
| play.purchases | |
購買項目 | 購買商品的時間戳記。 |
| play.subscriptions | |
訂閱項目 | 訂閱開始時間的時間戳記。 |
| play.library | |
媒體庫 | 項目下載時間的時間戳記。 |
| play.redemptions | |
兌換 | 兌換建立/更新時間的時間戳記。 |
| play.usersettings | |
Play 使用者設定 | 不支援。 |
| play.devices | |
裝置 | 裝置註冊時間的時間戳記。 |
| play.playpoints | |
Play 點數 | Play Points 交易的時間戳記。 |
| play.promotions | |
促銷活動 | 促銷活動建立、更新或到期的時間戳記。 |
| play.grouping | |
Play 分組 | 不支援。 |
| * 如要取得特定資源群組的 OAuth 範圍名稱，請在資源群組後方附加「https://www.googleapis.com/auth/dataportability.」。舉例來說，「myactivity.search」資源群組的 OAuth 範圍名稱為「https://www.googleapis.com/auth/dataportability.myactivity.search」。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-11-25 (世界標準時間)。
[[["容易理解","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-11-25 (世界標準時間)。"],[],[]]
