重要提示:我们不再接受 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”(如果未设置 primaryId 字段),设置为“custom”否则。如果设置为“基本”,布局将包含已针对用户列入白名单的所有已批准的应用。
可接受的值包括:
|
|
kind |
string |
|
|
响应
如果成功,此方法将返回采用以下结构的响应正文:
{
"kind": "androidenterprise#storeLayout",
"homepageId": string,
"storeLayoutType": string
}
属性名称 |
值 |
说明 |
备注 |
homepageId |
string |
将用作首页的商店页面的 ID。首页是 Google Play 企业版商店中显示的第一个页面。
不指定首页相当于将商店布局类型设置为“基本”。 |
|
storeLayoutType |
string |
商店布局类型。默认情况下,此值设为“basic”(如果未设置 primaryId 字段),设置为“custom”否则。如果设置为“基本”,布局将包含已针对用户列入白名单的所有已批准的应用。
可接受的值包括:
|
|
kind |
string |
|
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-12。
[null,null,["最后更新时间 (UTC):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` | | |"]]