Lưu ý quan trọng: Chúng tôi không còn chấp nhận các lượt đăng ký mới cho Play EMM API.
Tìm hiểu thêm.
Enterprises: setStoreLayout
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Thiết lập bố cục cửa hàng cho doanh nghiệp. Theo mặc định, storeLayoutType
được đặt thành "cơ bản" và bố cục cửa hàng cơ bản được bật. Cơ bản
bố cục chỉ chứa các ứng dụng được quản trị viên phê duyệt và có
được thêm vào bộ sản phẩm có sẵn cho người dùng (bằng cách sử dụng
lệnh gọi setAvailableProductSet). Các ứng dụng trên trang được sắp xếp theo thứ tự
giá trị mã sản phẩm của họ. Nếu bạn tạo bố cục cửa hàng tuỳ chỉnh (bằng cách đặt
storeLayoutType = "tuỳ chỉnh" và đặt một trang chủ), cửa hàng cơ bản
bố cục bị vô hiệu hoá.
Yêu cầu
Yêu cầu HTTP
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/storeLayout
Thông số
| Tên thông số |
Giá trị |
Mô tả |
| Tham số đường dẫn |
enterpriseId |
string |
Mã nhận dạng của doanh nghiệp.
|
Ủy quyền
Yêu cầu này cần được cho phép có phạm vi sau:
| Phạm vi |
|---|
https://www.googleapis.com/auth/androidenterprise |
Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.
Nội dung yêu cầu
Trong phần nội dung yêu cầu, hãy cung cấp dữ liệu có cấu trúc sau:
{
"kind": "androidenterprise#storeLayout",
"homepageId": string,
"storeLayoutType": string
}
| Tên tài sản |
Giá trị |
Mô tả |
Ghi chú |
homepageId |
string |
Mã của trang cửa hàng được dùng làm trang chủ. Trang chủ là trang đầu tiên xuất hiện trên Cửa hàng Managed Google Play.
Việc không chỉ định trang chủ tương đương với việc đặt loại bố cục cửa hàng thành "cơ bản". |
|
storeLayoutType |
string |
Loại bố cục cửa hàng. Theo mặc định, giá trị này được đặt thành "cơ bản" nếu bạn không đặt trường homepageId và thành "tuỳ chỉnh" nếu bạn đặt trường này. Nếu bạn đặt chính sách này thành "cơ bản", bố cục sẽ bao gồm mọi ứng dụng được phê duyệt và có trong danh sách cho phép cho người dùng.
Các giá trị được chấp nhận là:
|
|
kind |
string |
|
|
Phản hồi
Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:
{
"kind": "androidenterprise#storeLayout",
"homepageId": string,
"storeLayoutType": string
}
| Tên tài sản |
Giá trị |
Mô tả |
Ghi chú |
homepageId |
string |
Mã của trang cửa hàng được dùng làm trang chủ. Trang chủ là trang đầu tiên xuất hiện trên Cửa hàng Managed Google Play.
Việc không chỉ định trang chủ tương đương với việc đặt loại bố cục cửa hàng thành "cơ bản". |
|
storeLayoutType |
string |
Loại bố cục cửa hàng. Theo mặc định, giá trị này được đặt thành "cơ bản" nếu bạn không đặt trường homepageId và thành "tuỳ chỉnh" nếu bạn đặt trường này. Nếu bạn đặt chính sách này thành "cơ bản", bố cục sẽ bao gồm mọi ứng dụng được phê duyệt và có trong danh sách cho phép cho người dùng.
Các giá trị được chấp nhận là:
|
|
kind |
string |
|
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-09-12 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-09-12 UTC."],[[["\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` | | |"]]
