دارایی: جستجو
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
دارایی‌های Looker Studio کاربر را جستجو کنید.
درخواست کنید
درخواست HTTP
GET https://datastudio.googleapis.com/v1/assets:search
پارامترها
| نام پارامتر | تایپ کنید | توضیحات |
|---|
| انواع دارایی | آرایه< AssetType > | مورد نیاز . نوع دارایی برای جستجو دقیقاً یک نوع دارایی باید مشخص شود. |
| عنوان | رشته | رشته جستجو به طور پیش فرض، رشته در برابر عنوان و توضیحات دارایی بررسی می شود. برای رشته های جستجوی پیشرفته به بخش مثال ها مراجعه کنید. |
| شامل سطل زباله | بولی | پیش فرض ها به false .- وقتی این پارامتر روی
true تنظیم شود، فقط دارایی های سطل زباله گنجانده می شود. - وقتی این پارامتر روی
false تنظیم شود، فقط دارایی‌هایی که در سطل زباله نیستند گنجانده می‌شوند.
|
| مالک | رشته | ایمیل مالک دارایی. |
| سفارش توسط | رشته | ترتیب نتایج. می توانید بر اساس فیلدهای زیر مرتب کنید:-
title -
last_viewed_by_me -
create_time -
last_accessed_time -
id
|
| اندازه صفحه | شماره | تعداد نتایجی که باید در هر صفحه درج شود. پیش فرض 1000 است. |
| pageToken | رشته | نشانه ای که صفحه ای از نتایج را برای بازگشت مشخص می کند. برای صفحه بندی نتایج، از یک مقدار nextPageToken یا مقدار previousPageToken از یک درخواست دیگر استفاده کنید. |
مجوز
این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد:
| دامنه |
|---|
https://www.googleapis.com/auth/datastudio.readonly |
https://www.googleapis.com/auth/datastudio |
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
پاسخ
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{
"assets": [Asset],
"nextPageToken": string
}
| نام ملک | تایپ کنید | توضیحات |
|---|
| دارایی ها | آرایه< دارایی > | لیست دارایی ها. |
| nextPageToken | رشته | نشانه ای برای بازیابی صفحه بعدی نتایج. این ویژگی فقط زمانی وجود دارد که تعداد نتایج بیشتر از pageSize درخواست باشد. یک nextPageToken خالی نشان می دهد که هیچ نتیجه دیگری برای بازگشت وجود ندارد. |
| previousPageToken | رشته | نشانه ای برای بازیابی صفحه قبلی نتایج. یک previousPageToken خالی شروع مجموعه نتایج را نشان می دهد. |
نمونه ها
می توانید رشته های جستجوی پیشرفته را در قسمت title ارسال کنید. می توانید از چندین نوع جستجو در یک رشته جستجو استفاده کنید. جدول زیر را برای نحو رشته جستجوی پشتیبانی شده ببینید. می توانید چندین رشته جستجو را ترکیب کنید.
| فیلتر کنید | تعریف | نمونه ها |
|---|
| خالق | جستجو برای دارایی های ایجاد شده توسط یک کاربر خاص. | -
creator:me -
creator:user@example.com
|
| مالک | جستجو برای دارایی های متعلق به یک کاربر خاص. | -
owner:me -
owner:user@example.com
|
| پروژه | جستجوی دارایی ها در یک پروژه | |
| فضای کار | دارایی ها را در یک فضای کاری یا پوشه جستجو کنید. | -
parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9
|
| از | دارایی هایی را که یک کاربر با شما به اشتراک گذاشته است جستجو کنید. | |
| به | دارایی هایی را که با یک کاربر یا گروه به اشتراک گذاشته اید جستجو کنید. | -
to:user@example.com -
to:example-group@googlegroups.com
|
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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` |"]]
