重要資訊:我們目前不接受新的 Play EMM API 註冊。
瞭解詳情。
Storelayoutclusters
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
Storelayoutclusters 資源代表在 Google Play for Work 商店頁面上以群組形式顯示的產品清單。每個頁面最多可有 30 個叢集,每個叢集最多可包含 100 項產品。
每個叢集的顯示資訊包括叢集的本地化名稱、應用程式清單,以及叢集在其上層頁面中的位置 (orderInPage
)。
如要瞭解如何設計商店版面配置,包括如何建立商店叢集,請參閱商店版面配置設計指南。
如需本資源的方法清單,請見本頁結尾。
資源表示法
Google Play 管理版商店叢集的定義,即在商店頁面中顯示的產品清單。
{
"kind": "androidenterprise#storeCluster",
"id": string,
"name": [
{
"locale": string,
"text": string
}
],
"productId": [
string
],
"orderInPage": string
}
資源名稱 |
值 |
說明 |
附註 |
id |
string |
這個叢集的專屬 ID。由伺服器指派。指派後即無法變更。 |
|
kind |
string |
|
|
name[] |
list |
列出網頁名稱的本地化字串排序清單。會顯示與使用者語言代碼最相符的文字;如果沒有相符的結果,則顯示第一個項目。至少須選取一個項目。 |
|
name[].locale |
string |
語言代碼的 BCP47 標記。(例如「en-US」、「de」)。 |
|
name[].text |
string |
相關語言代碼的本地化文字。 |
|
orderInPage |
string |
用於決定這個叢集在上層頁面元素中順序的字串 (僅限 US-ASCII)。頁面元素會按照這個欄位的字母順序排序。值可以重複,但順序重複的元素並未定義。
這個欄位的值僅供定義排序之用,使用者一律不會看到這個值。長度上限為 256 個半形字元。 |
|
productId[] |
list |
按照產品在叢集中顯示的順序列出的產品。叢集內不得有重複項目。 |
|
方法
- 刪除
- 刪除叢集。
- 取得
- 擷取叢集的詳細資料。
- 插入
- 在頁面中插入新叢集。
- list
- 擷取指定頁面中所有叢集的詳細資料。
- 更新
- 更新叢集。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-06-19 (世界標準時間)。
[null,null,["上次更新時間:2024-06-19 (世界標準時間)。"],[[["\u003cp\u003eStorelayoutclusters represent groups of products (up to 100) displayed on Google Play for Work store pages.\u003c/p\u003e\n"],["\u003cp\u003eEach store page can contain up to 30 clusters, organized by \u003ccode\u003eorderInPage\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eClusters are defined by a localized name, a list of products (\u003ccode\u003eproductId\u003c/code\u003e), and their placement on the page.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage clusters using methods like insert, delete, update, get, and list to customize store layouts.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the Store Layout Design guide for creating effective store layouts and clusters.\u003c/p\u003e\n"]]],[],null,["# Storelayoutclusters\n\n\u003cbr /\u003e\n\nA Storelayoutclusters resource represents a list of products displayed together as a group on a [Google Play for Work store](/android/work/play/emm-api/v1/storelayoutpages) page. Each page can have up to 30 clusters, and each cluster can have up to 100 products.\n\nThe display information provided for each cluster includes the cluster's localized name, a list of apps, and the placement of the cluster within its parent page (`orderInPage`).\n\nThe [Store Layout Design](/android/work/play/emm-api/store-layout) guide has information on how to design a store layout, including how to create a store cluster.\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\nDefinition of a managed Google Play store cluster, a list of products displayed as part of a store page.\n\n```text\n{\n \"kind\": \"androidenterprise#storeCluster\",\n \"id\": string,\n \"name\": [\n {\n \"locale\": string,\n \"text\": string\n }\n ],\n \"productId\": [\n string\n ],\n \"orderInPage\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `id` | `string` | Unique ID of this cluster. Assigned by the server. Immutable once assigned. | |\n| `kind` | `string` | | |\n| `name[]` | `list` | Ordered list of localized strings giving the name of this page. The text displayed is the one that best matches the user locale, or the first entry if there is no good match. There needs to be at least one entry. | |\n| name[].`locale` | `string` | The BCP47 tag for a locale. (e.g. \"en-US\", \"de\"). | |\n| name[].`text` | `string` | The text localized in the associated locale. | |\n| `orderInPage` | `string` | String (US-ASCII only) used to determine order of this cluster within the parent page's elements. Page elements are sorted in lexicographic order of this field. Duplicated values are allowed, but ordering between elements with duplicate order is undefined. The value of this field is never visible to a user, it is used solely for the purpose of defining an ordering. Maximum length is 256 characters. | |\n| `productId[]` | `list` | List of products in the order they are displayed in the cluster. There should not be duplicates within a cluster. | |\n\nMethods\n-------\n\n[delete](/android/work/play/emm-api/v1/storelayoutclusters/delete)\n: Deletes a cluster.\n\n[get](/android/work/play/emm-api/v1/storelayoutclusters/get)\n: Retrieves details of a cluster.\n\n[insert](/android/work/play/emm-api/v1/storelayoutclusters/insert)\n: Inserts a new cluster in a page.\n\n[list](/android/work/play/emm-api/v1/storelayoutclusters/list)\n: Retrieves the details of all clusters on the specified page.\n\n[update](/android/work/play/emm-api/v1/storelayoutclusters/update)\n: Updates a cluster."]]