Zasoby: sieć wyszukiwania

Wyszukiwanie zasobów Studia danych użytkownika.

Żądanie

Żądanie HTTP

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

Parametry

Nazwa parametru Typ Opis
assetTypes Array<AssetType> Wymagany. Typ zasobu do wyszukania. Musisz podać dokładnie 1 typ komponentu.
tytuł ciąg znaków Ciąg wyszukiwania. Domyślnie ciąg tekstowy jest sprawdzany pod kątem tytułu i opisu komponentu. Zaawansowane ciągi wyszukiwania znajdziesz w sekcji Przykłady.
includeTrashed Wartość logiczna Domyślna wartość to false.
  • Gdy ten parametr ma wartość true, uwzględniane są tylko zasoby z kosza.
  • Jeśli ten parametr ma wartość false, uwzględniane są tylko zasoby, które nie znajdują się w koszu.
właściciel ciąg znaków Adres e-mail właściciela zasobu.
orderBy ciąg znaków Kolejność wyników. Możesz sortować według tych pól:
  • title
  • last_viewed_by_me
  • create_time
  • last_accessed_time
  • id
pageSize liczba Liczba wyników do uwzględnienia na stronie. Domyślna wartość to 1000.
pageToken ciąg znaków Token identyfikujący stronę wyników do zwrócenia. Aby podzielić wyniki na strony, użyj wartości nextPageToken lub previousPageToken z innego żądania.

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów:

Zakres
https://www.googleapis.com/auth/datastudio.readonly
https://www.googleapis.com/auth/datastudio

Treść żądania

W przypadku tej metody nie podawaj treści żądania.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w poniższym formacie:

{
  "assets": [Asset],
  "nextPageToken": string
}
Nazwa usługi Typ Opis
zasoby Array<Asset> Lista zasobów.
nextPageToken ciąg znaków Token do pobierania następnej strony wyników. Ta właściwość występuje tylko wtedy, gdy liczba wyników jest większa niż wartość parametru pageSize w żądaniu. Pusty ciąg nextPageToken oznacza, że nie ma już więcej wyników do zwrócenia.
previousPageToken ciąg znaków Token do pobrania poprzedniej strony wyników. Pusty znak previousPageToken oznacza początek zestawu wyników.

Przykłady

Zaawansowane ciągi wyszukiwania możesz przekazywać w polu title. W jednym ciągu wyszukiwania możesz używać kilku typów wyszukiwania. Obsługiwana składnia ciągów wyszukiwania znajduje się w tabeli poniżej. Możesz połączyć kilka ciągów wyszukiwania.

Filtruj Definicja Przykłady
Twórca Wyszukiwać zasoby utworzone przez określonego użytkownika.
  • creator:me
  • creator:user@example.com
Właściciel Wyszukiwać zasoby należące do określonego użytkownika.
  • owner:me
  • owner:user@example.com
Projekt Wyszukiwanie komponentów w projekcie.
  • projectNumber:123456789
Obszar roboczy Wyszukuj komponenty w przestrzeni roboczej lub folderze.
  • parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9
Od Wyszukiwać zasoby, które użytkownik Ci udostępnił.
  • from:user@example.com
Do Wyszukiwanie zasobów udostępnionych przez Ciebie użytkownikowi lub grupie.
  • to:user@example.com
  • to:example-group@googlegroups.com