Assets: recherche

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 :
  • title
  • last_viewed_by_me
  • create_time
  • last_accessed_time
  • id
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:me
  • creator:user@example.com
Propriétaire Recherchez les composants appartenant à un utilisateur spécifique.
  • owner:me
  • owner:user@example.com
Projet Recherchez des composants dans un projet.
  • projectNumber:123456789
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.
  • from:user@example.com
À Recherchez les composants que vous avez partagés avec un utilisateur ou un groupe.
  • to:user@example.com
  • to:example-group@googlegroups.com