Assets: recherche
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Recherchez les composants Looker Studio d'un utilisateur.
Requête
Requête HTTP
GET https://datastudio.googleapis.com/v1/assets:search
Paramètres
| Nom du paramètre |
Type |
Description |
| assetTypes |
Array<AssetType> |
Obligatoire. Type d'asset à rechercher. Vous ne devez spécifier qu'un seul type de composant. |
| titre |
chaîne |
Chaîne de recherche. Par défaut, la chaîne est comparée au titre et à la description du composant. Pour obtenir des chaînes de recherche avancée, consultez la section Exemples. |
| includeTrashed |
booléen |
La valeur par défaut est false.
- Lorsque ce paramètre est défini sur
true, seuls les composants supprimés sont inclus. - Lorsque ce paramètre est défini sur
false, seuls les composants qui ne sont pas dans la corbeille sont inclus.
|
| owner |
chaîne |
Adresse e-mail du propriétaire de l'élément. |
| orderBy |
chaîne |
Ordre des résultats. Vous pouvez trier les données selon les champs suivants :
titlelast_viewed_by_mecreate_timelast_accessed_timeid
|
| pageSize |
Total |
Nombre de résultats à inclure par page. La valeur par défaut est 1 000. |
| pageToken |
chaîne |
Jeton identifiant une page de résultats à renvoyer. Pour paginer les résultats, utilisez une valeur nextPageToken ou previousPageToken provenant d'une autre requête. |
Autorisation
Cette requête nécessite une autorisation ayant au moins l'une des portées suivantes :
| Champ d'application |
https://www.googleapis.com/auth/datastudio.readonly |
https://www.googleapis.com/auth/datastudio |
Corps de la requête
Ne spécifiez pas de corps de requête pour cette méthode.
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{
"assets": [Asset],
"nextPageToken": string
}
| Nom de propriété |
Type |
Description |
| éléments |
Array<Asset> |
Liste des composants. |
| nextPageToken |
chaîne |
Jeton permettant de récupérer la page de résultats suivante. Cette propriété n'est présente que lorsque le nombre de résultats est supérieur à la pageSize de la requête. Un nextPageToken vide indique qu'il n'y a plus de résultats à renvoyer. |
| previousPageToken |
chaîne |
Jeton permettant de récupérer la page de résultats précédente. Un previousPageToken vide indique le début de l'ensemble de résultats. |
Exemples
Vous pouvez transmettre des chaînes de recherche avancée dans le champ title.
Vous pouvez utiliser plusieurs types de recherche dans une même chaîne de recherche.
Consultez le tableau suivant pour connaître la syntaxe des chaînes de recherche acceptée. Vous pouvez combiner plusieurs chaînes de recherche.
| Filtre |
Définition |
Exemples |
| Créateur |
Recherchez les composants créés par un utilisateur spécifique. |
creator:mecreator:user@example.com
|
| Propriétaire |
Recherchez les composants appartenant à un utilisateur spécifique. |
owner:meowner:user@example.com
|
| Projet |
Recherchez des composants dans un projet. |
|
| Espace de travail |
Rechercher des composants dans un espace de travail ou un dossier |
parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9
|
| De |
Recherchez les composants qu'un utilisateur a partagés avec vous. |
|
| À |
Recherchez les composants que vous avez partagés avec un utilisateur ou un groupe. |
to:user@example.comto:example-group@googlegroups.com
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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` |"]]
