Asset: ricerca
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Cerca gli asset di Looker Studio di un utente.
Richiesta
Richiesta HTTP
GET https://datastudio.googleapis.com/v1/assets:search
Parametri
| Nome parametro |
Tipo |
Descrizione |
| assetTypes |
Array<AssetType> |
Required. Il tipo di asset da cercare. Deve essere specificato esattamente un tipo di asset. |
| titolo |
stringa |
La stringa di ricerca. Per impostazione predefinita, la stringa viene confrontata con il titolo e la descrizione della risorsa. Consulta la sezione Esempi per le stringhe di ricerca avanzata. |
| includeTrashed |
booleano |
Il valore predefinito è false.
- Quando questo parametro è impostato su
true, vengono incluse solo le risorse del cestino. - Quando questo parametro è impostato su
false, vengono inclusi solo gli asset non presenti nel cestino.
|
| proprietario |
stringa |
L'email del proprietario della risorsa. |
| orderBy |
stringa |
L'ordine dei risultati. Puoi ordinare in base ai seguenti campi:
titlelast_viewed_by_mecreate_timelast_accessed_timeid
|
| pageSize |
numero |
Il numero di risultati da includere per pagina. Il valore predefinito è 1000. |
| pageToken |
stringa |
Un token che identifica una pagina di risultati da restituire. Per paginare i risultati, utilizza un valore nextPageToken o previousPageToken di un'altra richiesta. |
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti:
| Ambito |
https://www.googleapis.com/auth/datastudio.readonly |
https://www.googleapis.com/auth/datastudio |
Corpo della richiesta
Non fornire un corpo della richiesta con questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{
"assets": [Asset],
"nextPageToken": string
}
| Nome proprietà |
Tipo |
Descrizione |
| asset |
Array<Asset> |
L'elenco degli asset. |
| nextPageToken |
stringa |
Un token per recuperare la pagina successiva dei risultati. Questa proprietà è presente solo quando il numero di risultati è maggiore della richiesta pageSize. Un nextPageToken vuoto indica che non ci sono altri risultati da restituire. |
| previousPageToken |
stringa |
Un token per recuperare la pagina precedente dei risultati. Un previousPageToken vuoto indica l'inizio del set di risultati. |
Esempi
Puoi trasmettere stringhe di ricerca avanzata nel campo title.
Puoi utilizzare più tipi di ricerca in una singola stringa di ricerca.
Consulta la tabella seguente per la sintassi delle stringhe di ricerca supportate. Puoi combinare
più stringhe di ricerca.
| Filtro |
Definizione |
Esempi |
| Autore |
Cercare asset creati da un utente specifico. |
creator:mecreator:user@example.com
|
| Proprietario |
Cerca gli asset di proprietà di un utente specifico. |
owner:meowner:user@example.com
|
| Progetto |
Cerca asset in un progetto. |
|
| Workspace |
Cerca asset in uno spazio di lavoro o in una cartella. |
parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9
|
| Da |
Cerca gli asset che un utente ha condiviso con te. |
|
| A |
Cerca gli asset che hai condiviso con un utente o un gruppo. |
to:user@example.comto:example-group@googlegroups.com
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eSearch for specific Looker Studio assets using parameters like asset type, title, owner, and more.\u003c/p\u003e\n"],["\u003cp\u003eFilter search results to include or exclude trashed assets.\u003c/p\u003e\n"],["\u003cp\u003eOrder results by title and control the number of results per page using pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific scopes for data access.\u003c/p\u003e\n"],["\u003cp\u003eThe API response includes a list of matching assets and a token for retrieving subsequent pages.\u003c/p\u003e\n"]]],[],null,["# Assets: search\n\nSearch a user's Looker Studio assets.\n\nRequest\n-------\n\n### HTTP request\n\n GET https://datastudio.googleapis.com/v1/assets:search\n\n### Parameters\n\n| Parameter name | Type | Description |\n|----------------|------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| assetTypes | Array\\\u003c[AssetType](/looker-studio/integrate/api/reference/types#AssetType)\\\u003e | **Required**. The asset type to search. Exactly one asset type must be specified. |\n| title | string | The search string. By default, the string is checked against the title and description of the asset. See the [Examples](#examples) section for advanced search strings. |\n| includeTrashed | boolean | Defaults to `false`. - When this parameter is set to `true`, only assets from the trash are included. - When this parameter is set to `false`, only assets not in the trash are included. |\n| owner | string | The asset owner's email. |\n| orderBy | string | The order of the results. You can sort by the following fields: - `title` - `last_viewed_by_me` - `create_time` - `last_accessed_time` - `id` |\n| pageSize | number | The number of results to include per page. Defaults to 1000. |\n| pageToken | string | A token identifying a page of results to return. To paginate results, use a `nextPageToken` value or `previousPageToken` value from another request. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|-------------------------------------------------------|\n| `https://www.googleapis.com/auth/datastudio.readonly` |\n| `https://www.googleapis.com/auth/datastudio` |\n\n### Request body\n\nDon't 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 {\n \"assets\": [Asset],\n \"nextPageToken\": string\n }\n\n| Property name | Type | Description |\n|-------------------|----------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| assets | Array\\\u003c[Asset](/looker-studio/integrate/api/reference/types#Asset)\\\u003e | The list of assets. |\n| nextPageToken | string | A token to retrieve the next page of results. This property is only present when the number of results is greater than the request `pageSize`. An empty `nextPageToken` indicates that there are no more results to return. |\n| previousPageToken | string | A token to retrieve the previous page of results. An empty `previousPageToken` indicates the beginning of the result set. |\n\nExamples\n--------\n\nYou can pass advanced search strings in the `title` field.\nYou can use multiple search types in a single search string.\nSee the following table for supported search string syntax. You can combine\nmultiple search strings.\n\n| Filter | Definition | Examples |\n|-----------|--------------------------------------------------------------|---------------------------------------------------------------|\n| Creator | Search for assets created by a specific user. | - `creator:me` - `creator:user@example.com` |\n| Owner | Search for assets owned by a specific user. | - `owner:me` - `owner:user@example.com` |\n| Project | Search for assets in a project. | - `projectNumber:123456789` |\n| Workspace | Search for assets in a workspace or folder. | - `parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9` |\n| From | Search for assets that a user has shared with you. | - `from:user@example.com` |\n| To | Search for assets that you have shared with a user or group. | - `to:user@example.com` - `to:example-group@googlegroups.com` |"]]
