重要資訊:我們目前不接受新的 Play EMM API 註冊。
瞭解詳情。
Enterprises: getStoreLayout
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
傳回企業的商店版面配置。如果尚未設定商店版面配置,系統會傳回「基本」做為商店版面配置類型,且沒有首頁。
要求
HTTP 要求
GET 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 |
|
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-13 (世界標準時間)。
[null,null,["上次更新時間:2024-09-13 (世界標準時間)。"],[[["\u003cp\u003eRetrieves the store layout configuration for a given enterprise, which dictates the organization and presentation of apps in the managed Google Play Store.\u003c/p\u003e\n"],["\u003cp\u003eIf a custom layout hasn't been defined, the API defaults to a "basic" layout showcasing all approved and whitelisted applications for the user.\u003c/p\u003e\n"],["\u003cp\u003eThe layout can be customized by specifying a homepage ID, leading to a "custom" layout type, enabling control over the initial page displayed in the store.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope to access and retrieve the store layout information.\u003c/p\u003e\n"]]],[],null,["# Enterprises: getStoreLayout\n\n| **Note:** Requires [authorization](#auth).\n\nReturns the store layout for the enterprise. If the store layout\nhas not been set, returns \"basic\" as the store layout type and no\nhomepage.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET 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\nDo not supply a request body with this method.\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` | | |"]]