重要提示:我们不再接受 Play EMM API 的新注册。
了解详情。
Enterprises: getStoreLayout
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
返回企业的商店布局。如果商店布局
尚未设置,则返回“basic”作为商店布局类型,
首页。
请求
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”(如果未设置 primaryId 字段),设置为“custom”否则。如果设置为“基本”,布局将包含已针对用户列入白名单的所有已批准的应用。
可接受的值包括:
|
|
kind |
string |
|
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-13。
[null,null,["最后更新时间 (UTC):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` | | |"]]