建立受管理的產品

只要使用 Google Play 結帳功能,您就可以為使用者提供應用程式內產品,並收取一次性費用,也就是提供受管理的產品。受管理的產品涵蓋您在 Google Play 應用程式中的虛擬商品 (例如遊戲等級或藥水) 以及付費服務。

重要資訊:應用程式內產品 (包括受管理產品和訂閱項目) 受 Google Play《開發人員計劃政策》規範,且適用交易手續費

適用範圍

只要您位於支援商家註冊的地區,即可使用 Google Play 結帳功能。

如果您位於支援的地區,且想在您的應用程式中開始使用 Google Play 帳款服務功能,請設定付款資料,並詳閱 Google Play Billing API 說明文件

當您建立受管理的產品後,使用者就可以透過裝有最新版本 Google Play 商店的裝置購買訂閱項目。

所需權限

如要提供受管理的產品,您必須在應用程式的 APK 資訊清單檔案中宣告 com.android.vending.BILLING 權限。如果您在全球發佈應用程式,您仍可在所有國家/地區發佈使用 com.android.vending.BILLING 權限的應用程式。

建立受管理的產品

建立單一受管理產品

建立受管理的產品前,請務必先仔細規劃您的產品 ID。應用程式的產品 ID 不可重複,且建立後即無法變更或重複使用。
  • 產品 ID 必須以小寫字母或數字為開頭,且只能包含小寫字母 (a-z)、數字 (0-9)、底線 (_) 和英文句號 (.)
  • 注意:「android.test」這個產品 ID 和所有以 android.test 為開頭的產品 ID 均不開放使用。

如何建立受管理的產品:

  1. 登入 Play 管理中心
  2. 選取應用程式。
  3. 依序按一下左側選單中的 [商店發佈] > [應用程式內產品] > [受管理的產品]。
  4. 按一下 [建立要納入管理的產品]。
  5. 輸入產品詳細資料。
    • 標題:項目的簡短名稱 (長度上限為 55 個字元,但建議您將長度限縮為 25 個字元以便顯示完整標題內容),例如「沉睡藥水」。
    • 說明:項目的詳細說明 (長度上限為 80 個字元),例如「可讓各種生物立即陷入昏睡」。
    • 價格:輸入當地貨幣的價格,或選取定價範本
  6. 在「狀態」旁邊選擇 [啟用] 或 [停用]。
    • 如要販售產品,必須將產品設為啟用,且產品所屬的應用程式必須為發佈狀態。
    • 如果您使用測試帳戶建立訂閱項目,啟用的項目會在未發佈的應用程式中推出。詳情請參閱我們的 Android 開發人員網站
  7. 按一下 [儲存]。

語言與翻譯

受管理產品的預設語言設定與應用程式本身相同。如要新增特定語言的翻譯,請選取受管理的產品,然後按一下 [新增翻譯]。進一步瞭解如何翻譯您的應用程式

同時建立多個受管理產品

如要同時建立多個受管理產品,您可以上傳內含個別產品詳細資訊的 CSV 檔案。
CSV 檔案使用半形逗號 (,) 和分號 (;) 區隔資料值,逗號用來分隔主要資料值,而分號則用來分隔子值。
當您為受管理產品建立 CSV 檔案時,請在第一列指定 CSV 語法,然後在後續資料列中輸入產品資訊。
重要事項:CSV 檔案的每個項目都必須在單行中完整顯示。

上傳受管理產品的 CSV 檔案

  1. 登入 Play 管理中心
  2. 選取應用程式。
  3. 依序按一下左側選單中的 [商店發佈] > [應用程式內產品] > [受管理的產品]。
  4. 依序按一下 [匯入/匯出] > [從 CSV 檔案匯入納入管理的產品]。
    • 如要覆寫產品清單中現有的受管理產品,請選取 [覆寫現有的產品] 核取方塊。只有在 CSV 檔案的 Product ID 值與產品清單中現有受管理產品的 Product ID 相同時,這項操作才會覆寫現有的產品。覆寫產品不會導致未列入該 CSV 檔案的受管理產品遭到刪除。
  5. 按一下 [瀏覽檔案],然後選取 CSV 檔案。

匯出現有受管理產品的 CSV 檔案

如果您先前已在 Play 管理中心逐一建立受管理產品,當您要使用 CSV 檔案建立受管理產品時,可以改為使用匯出的 CSV 檔案。

  1. 登入 Play 管理中心
  2. 選取應用程式。
  3. 依序按一下左側選單中的 [商店發佈] > [應用程式內產品] > [受管理的產品]。
  4. 依序按一下 [匯入/匯出] > [將應用程式內商品匯出成 CSV 檔案]。

查看 CSV 檔案示例

以下為 CSV 語法使用方式和三種受管理產品的示例:
  • 第一個示例是定義兩種語言版本 (en_USes_ES) 的標題和說明,並以定價範本定義項目價格。
  • 第二個示例未使用定價範本,而是針對預設國家/地區 (US) 指定價格。Play 管理中心會根據目前匯率和當地的定價模式,為應用程式發佈的其他國家/地區自動設定價格。
  • 第三個示例未使用定價範本,而是針對應用程式發佈的各個國家/地區手動指定項目價格。

CSV 語法示例

Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID

受管理的產品示例

示例 1

basic_sleeping_potion,published,managed_by_android,false,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,,4637138456024710495

示例 2

standard_sleeping_potion, published,managed_by_android,false,en_US; Standard Sleeping Potion; Puts all creatures to sleep for 2 minutes.,true, 1990000,

示例 3

invisibility_potion,published, managed_by_android,false,en_US; Invisibility Potion; Invisible to all enemies for 5 minutes.,false, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

CSV 檔案資料值

在受管理產品的 CSV 檔案中,每個資料列可包含以下的值,不過每列至少需有一個值是未定義的:  
Product ID

在 CSV 檔案中設定這個值,效果相當於在建立新的受管理產品時輸入產品 ID。

如果您指定將某個 Product ID 指派給產品清單中現有的受管理產品,而且您已勾選「匯入應用程式內產品」對話方塊中的 [覆寫現有的產品] 核取方塊,則您在 CSV 檔案中指定的值將會覆寫現有受管理產品的資料。

Publish State 這個值必須設定為 publishedunpublished,效果相當於將受管理的產品設定為 [啟用] 或 [停用]。
Purchase Type

這個值必須設定為 managed_by_android

Auto Translate

這個值必須設定為 false,因為自動翻譯功能不支援受管理產品的詳細資料。

如果您想為受管理產品提供標題和說明的翻譯,請在 Locale 的值中明確指定這些翻譯內容。

LocaleTitle Description

如果您只為某個項目指定單一語言代碼,則您必須指定應用程式的預設語言代碼以及該項目的預設標題和說明:

app_default_locale; item_default_title; item_default_description;

設定 Locale 的值時,您可以使用新增商店資訊頁面翻譯時系統顯示的任何語言代碼。

注意:指定 TitleDescription 的值時,請使用反斜線溢出分號 (\;) 和反斜線 (\\) 字元。

如果您想納入項目標題和說明的翻譯版本,您必須列出預設的語言代碼、標題和說明,後面再加上各個翻譯版本的語言代碼、標題和說明。在以下示例中,受管理的產品是使用 en_US (美國,英文) 做為預設的語言代碼,翻譯版本則是 es_ES (西班牙,西班牙文):

en_US; Invisibility Cloak; Makes you invisible.; es_ES; Capote Invisible; Se vuelven invisible.

注意:應用程式只有一個預設語言,不過每個受管理產品都有自己的翻譯清單。雖然 CSV 檔案中每個項目 Locale 值的第一個語言代碼必須相同,但其他語言代碼可以不同。

Auto Fill PricesCountry Price

Auto Fill Prices 可設定為 truefalse。如果受管理的產品使用定價範本,您必須將 Auto Fill Prices 設為 false,且不要為 Price 設定值。

注意:當您在 CSV 檔案中指定項目價格時,請以「微量單位」來指定價格,1,000,000 微量單位等於 1 單位的實際貨幣。

使用自動填入的價格

以下部分說明 Auto Fill Prices 的值會如何影響 CountryPrice 這兩個值的語法和意義。

如果您將 Auto Fill Prices 設定為 true,表示您只指定該項目的預設價格,而沒有加入 Country 值。

就以下情況舉例說明:

  • 您應用程式的預設語言代碼是 en_US
  • 某個受管理產品的預設未稅價格為 $1.99 美元。
  • 您想讓系統自動填入其他國家/地區的價格。

您必須在 CSV 檔案的資料列末尾,將 Auto Fill PricesPrice 設定如下:true,1990000,

根據國家/地區自行設定價格  

如果您是將 Auto Fill Prices 設定為 false,您可以根據應用程式發佈的所有國家/地區指定一系列 CountryPrice 值 (包括應用程式預設語言代碼對應的國家/地區)。每個 Country 值都是由兩個大寫字母組成的 ISO 國家/地區代碼,代表應用程式所發佈的國家/地區。

注意:您必須針對應用程式發佈的每個國家/地區,分別提供國家/地區代碼以及價格。如要查看及編輯應用程式的發佈國家/地區清單,請開啟應用程式的「定價與發佈」頁面。

每個 Price 值分別代表在對應的國家/地區以當地貨幣購買該項目所需的微量單位數量。

舉例來說,如果您在其他國家/地區採用下列價格 (均為含稅價格) 銷售應用程式:

  • 巴西:R$6.99 巴西里爾
  • 俄羅斯:129 ₽ 俄羅斯盧布
  • 印度:₹130 印度盧比
  • 印尼:27,000 印尼盾
  • 墨西哥:$37 墨西哥披索

您可以在 CSV 檔案的資料列末尾,將 Auto Fill PricesCountryPrice 設定如下:

false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;

Pricing Template ID

如果該項目已連結至定價範本,您必須將 Auto Fill Prices 設為 false,且不要為 Price 欄設定值。如果該項目尚未連結至定價範本,請不要為 Pricing Template ID 設定值;而是根據受管理產品要採用的定價方式來設定 Auto Fill PricesCountryPrice

如果您匯入 CSV 檔案,而且已勾選「匯入應用程式內產品」對話方塊中的 [覆寫現有的產品] 核取方塊,則您可以更新受管理產品和定價範本之間的連結。如要將產品連結至特定的定價範本,請將 Pricing Template ID 的值設定為定價範本的 ID。如要將受管理產品與所有定價範本取消連結,請不要為該產品的 Pricing Template ID 設定值。

您最多可將單一定價範本與 1000 個應用程式價格或受管理產品價格建立連結。因此,在單一 CSV 檔案中,請不要為超過 1000 個資料列指定相同的 Pricing Template ID 值。

這對您有幫助嗎?
我們應如何改進呢?