重要資訊:我們目前不接受新的 Play EMM API 註冊。
瞭解詳情。
Enterprises: setStoreLayout
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
設定企業的商店版面配置。根據預設,storeLayoutType 會設為「basic」,並啟用基本商店版面配置。基本
版面配置只包含經管理員核准,且
的方法是使用
setAvailableProductSet 呼叫)。頁面上的應用程式會按照
產品 ID 值如果您要建立自訂商店版面配置 (透過
storeLayoutType =「custom」以及設定首頁) 基本商店
版面配置已停用。
要求
HTTP 要求
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/storeLayout
參數
參數名稱 |
值 |
說明 |
路徑參數 |
enterpriseId |
string |
企業的 ID。
|
授權
此要求需要具有下列範圍的授權:
範圍 |
https://www.googleapis.com/auth/androidenterprise |
詳情請參閱「驗證與授權」頁面。
要求主體
在要求主體中,提供具有以下結構的資料:
{
"kind": "androidenterprise#storeLayout",
"homepageId": string,
"storeLayoutType": string
}
屬性名稱 |
值 |
說明 |
附註 |
homepageId |
string |
要當做首頁的商店頁面 ID。首頁是 Google Play 管理版商店中顯示的第一個頁面。
不指定首頁,等同於將商店版面配置類型設為「基本」。 |
|
storeLayoutType |
string |
商店版面配置類型。這個值預設為「basic」如未設定 homeId 欄位且設為「custom」反之。如果設為「基本」,版面配置會包含所有已為使用者加入許可清單的已核准應用程式。
可接受的值為:
|
|
kind |
string |
|
|
回應
如果成功的話,這個方法會傳回回應內文,其結構如下:
{
"kind": "androidenterprise#storeLayout",
"homepageId": string,
"storeLayoutType": string
}
屬性名稱 |
值 |
說明 |
附註 |
homepageId |
string |
要當做首頁的商店頁面 ID。首頁是 Google Play 管理版商店中顯示的第一個頁面。
不指定首頁,等同於將商店版面配置類型設為「基本」。 |
|
storeLayoutType |
string |
商店版面配置類型。這個值預設為「basic」如未設定 homeId 欄位且設為「custom」反之。如果設為「基本」,版面配置會包含所有已為使用者加入許可清單的已核准應用程式。
可接受的值為:
|
|
kind |
string |
|
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-12 (世界標準時間)。
[null,null,["上次更新時間:2024-09-12 (世界標準時間)。"],[[["\u003cp\u003eDefines the enterprise's store layout, defaulting to "basic" which displays admin-approved and whitelisted apps sorted by product ID.\u003c/p\u003e\n"],["\u003cp\u003eSetting a custom homepage using \u003ccode\u003ehomepageId\u003c/code\u003e changes the \u003ccode\u003estoreLayoutType\u003c/code\u003e to "custom" and overrides the basic layout.\u003c/p\u003e\n"],["\u003cp\u003eThe API request requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003estoreLayoutType\u003c/code\u003e can be either "basic" or "custom", determining the store's layout structure.\u003c/p\u003e\n"]]],[],null,["# Enterprises: setStoreLayout\n\n| **Note:** Requires [authorization](#auth).\n\nSets the store layout for the enterprise. By default, storeLayoutType\nis set to \"basic\" and the basic store layout is enabled. The basic\nlayout only contains apps approved by the admin, and that have\nbeen added to the available product set for a user (using the\n[setAvailableProductSet](/android/work/play/emm-api/v1/users/setAvailableProductSet) call). Apps on the page are sorted in order of\ntheir product ID value. If you create a custom store layout (by setting\nstoreLayoutType = \"custom\" and setting a homepage), the basic store\nlayout is disabled.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/storeLayout\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply data with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#storeLayout\",\n \"homepageId\": string,\n \"storeLayoutType\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `homepageId` | `string` | The ID of the store page to be used as the homepage. The homepage is the first page shown in the managed Google Play Store. Not specifying a homepage is equivalent to setting the store layout type to \"basic\". | |\n| `storeLayoutType` | `string` | The store layout type. By default, this value is set to \"basic\" if the homepageId field is not set, and to \"custom\" otherwise. If set to \"basic\", the layout will consist of all approved apps that have been whitelisted for the user. \u003cbr /\u003e Acceptable values are: - \"`basic`\" - \"`custom`\" | |\n| `kind` | `string` | | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#storeLayout\",\n \"homepageId\": string,\n \"storeLayoutType\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `homepageId` | `string` | The ID of the store page to be used as the homepage. The homepage is the first page shown in the managed Google Play Store. Not specifying a homepage is equivalent to setting the store layout type to \"basic\". | |\n| `storeLayoutType` | `string` | The store layout type. By default, this value is set to \"basic\" if the homepageId field is not set, and to \"custom\" otherwise. If set to \"basic\", the layout will consist of all approved apps that have been whitelisted for the user. \u003cbr /\u003e Acceptable values are: - \"`basic`\" - \"`custom`\" | |\n| `kind` | `string` | | |"]]