Asset: ricerca

Cerca le risorse di Data Studio di un utente.

Richiesta

Richiesta HTTP

GET https://datastudio.googleapis.com/v1/assets:search

Parametri

Nome parametro Tipo Descrizione
assetTypes Array<AssetType> Obbligatorio. Il tipo di risorsa da cercare. È necessario specificare esattamente un tipo di risorsa.
title 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 avanzate.
includeTrashed booleano Il valore predefinito è false.
  • Se questo parametro è impostato su true, vengono incluse solo le risorse nel cestino.
  • Se questo parametro è impostato su false, vengono incluse solo le risorse non presenti nel cestino.
owner stringa L'indirizzo email del proprietario della risorsa.
orderBy stringa L'ordine dei risultati. Puoi ordinare in base ai seguenti campi:
  • title
  • last_viewed_by_me
  • create_time
  • last_accessed_time
  • id
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
assets Array<Asset> L'elenco delle risorse.
nextPageToken stringa Un token per recuperare la pagina successiva dei risultati. Questa proprietà è presente solo quando il numero di risultati è maggiore di pageSize della richiesta. 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 dell'insieme di risultati.

Esempi

Puoi passare stringhe di ricerca avanzate nel campo title. Puoi utilizzare più tipi di ricerca in una singola stringa di ricerca. Consulta la seguente tabella per la sintassi delle stringhe di ricerca supportata. Puoi combinare più stringhe di ricerca.

Filtro Definizione Esempi
Autore Cerca le risorse create da un utente specifico.
  • creator:me
  • creator:user@example.com
Proprietario Cerca le risorse di proprietà di un utente specifico.
  • owner:me
  • owner:user@example.com
Progetto Cerca le risorse in un progetto.
  • projectNumber:123456789
Workspace Cerca le risorse in una workspace o in una cartella.
  • parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9
Da Cerca le risorse che un utente ha condiviso con te.
  • from:user@example.com
A Cerca le risorse che hai condiviso con un utente o un gruppo.
  • to:user@example.com
  • to:example-group@googlegroups.com