編輯

您可以利用 Google Play Developer Publishing API 編輯方法 準備 Google Play 應用程式的多項變更，然後一次部署所有變更。方法是建立「編輯」，保留您要對應用程式進行的所有變更。編輯內容存放的資訊如下：

• 與應用程式相關聯的 APK，以及每個 APK 的「測試群組」。

  每個項目都與一個「軌跡」相關聯，可判斷哪些使用者會看到該內容。這讓您可以對測試人員提供應用程式的 Alpha 和 Beta 版本。此外，您也可以提供限量推出的「階段推出」應用程式版本。這個應用程式會自動提供給少數應用程式的使用者 (取決於您設定的推出百分比)，以便逐步部署新的正式版應用程式。

• 應用程式 Google Play 商店資訊的語言及特定語言代碼版本

  每個語言代碼專屬的商店資訊版本都可以包含螢幕截圖和其他宣傳圖片、本地化說明文字等等。

注意： Google Play Developer API 提供的方法不一定都使用新的交易式「編輯」功能。應用程式內產品、產品和訂閱資源的方法會立即生效，不論是否已對應用程式進行公開編輯。每個資源的 API 參考資料頁面都會明確註記該資源的方法是否使用「編輯」模式。

首次建立編輯內容時，編輯內容是應用程式目前部署狀態的副本。接著，您可以呼叫「Edits」(編輯) 方法來修改編輯內容。準備好編輯時 即提交編輯，讓變更生效您也可以隨時捨棄編輯作業，捨棄變更並保留應用程式。

這個 API 只能用於變更「現有」應用程式 (至少上傳一個 APK)，因此您必須先透過 Play 管理中心上傳至少一個 APK，才能使用這個 API。此外，您無法使用這個 API 將應用程式狀態從「已發布」變更為「未發布」，或是填寫發布所需的法律同意聲明。如要發布應用程式，您必須使用 Play 管理中心。

注意： 如有人透過 Google Play 管理中心對應用程式進行任何變更，則您的編輯內容會遭到捨棄，Play 管理中心的變更也會生效。

工作流程

本節說明您通常使用 Google Play Developer Publishing API 編輯方法修改應用程式的方法。

1. 建立新編輯內容，呼叫 Edits: Insert，並指定您要修改的應用程式。

   這樣做會針對特定應用程式建立新編輯內容。應用程式的初始設定 (如 APK、商店資訊、擴充檔案等) 全都會從已部署的應用程式版本複製。

2. 視需要修改編輯內容。

   您可以透過 Google Play 管理中心完成大部分變更。要達到這個目的，請呼叫適當的 Google Play Developer API 方法，然後傳遞您要修改的應用程式 ID。詳細說明：

   • 您可以呼叫 Edits.apks: upload 上傳新的 APK。這項操作會將 APK 放入儲存區，以便指派給此或後續編輯作業中的測試群組。
   • 您可以呼叫 Edits.tracks: update，將 APK 指派給測試群組。您也可以呼叫 Edits.tracks: patch，藉此變更現有 APK 的測試群組指派作業。
   • 您可以呼叫 Edits.listings: update，建立新的本地化商店資訊。您可以呼叫 Edits.listings: patch 以修改現有的商店資訊。
   • 您可以呼叫 Edits.expansionfiles 資源方法，以新增或修改擴充檔案。

   這些方法會變更正在進行的編輯作業，但「不會」修改應用程式的上線版本。您可以在不影響使用者體驗的情況下，進一步變更或捨棄進行中的編輯作業。

   注意： 每位使用者一次只能開啟一則編輯項目。如果建立新的編輯內容，您所做的任何現有修改都會失效。此外，如果有人透過 Play 管理中心提交編輯或變更應用程式的設定，則「所有」應用程式 (由其他使用者擁有) 的編輯都會失效。如果嘗試修訂無效的編輯作業，作業會擲回例外狀況，且不會產生任何作用。

3. 修訂編輯作業。

   如果您呼叫 Edits: Commit，但沒有驗證錯誤，則編輯資源中指定的所有變更都會「上線」，取代應用程式的目前狀態。這些變更可能需要數小時才會生效，就像透過 Play 管理中心進行變更一樣。