مواد العرض: البحث
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
البحث عن مواد عرض مستخدم في Looker Studio
طلب
طلب HTTP
GET https://datastudio.googleapis.com/v1/assets:search
المعلمات
| اسم المعلَمة |
النوع |
الوصف |
| assetTypes |
Array<AssetType> |
مَعلمة مطلوبة. نوع مادة العرض المطلوب البحث عنها. يجب تحديد نوع مادة عرض واحد بالضبط. |
| title |
سلسلة |
سلسلة البحث يتم تلقائيًا التحقّق من السلسلة مقارنةً بعنوان مادة العرض ووصفها. راجِع قسم الأمثلة للاطّلاع على سلاسل البحث المتقدّم. |
| includeTrashed |
قيمة منطقية |
القيمة التلقائية هي false.
- عند ضبط هذه المَعلمة على
true، يتم تضمين مواد العرض من المهملات فقط. - عند ضبط هذه المَعلمة على
false، يتم تضمين مواد العرض غير الموجودة في المهملات فقط.
|
| المالك |
سلسلة |
البريد الإلكتروني لمالك مادة العرض |
| orderBy |
سلسلة |
ترتيب النتائج يمكنك الترتيب حسب الحقول التالية:
titlelast_viewed_by_mecreate_timelast_accessed_timeid
|
| pageSize |
الرقم |
عدد النتائج المطلوب تضمينها في كل صفحة. القيمة التلقائية هي 1000. |
| pageToken |
سلسلة |
تمثّل هذه السمة رمزًا مميزًا يحدّد صفحة من النتائج المطلوب عرضها. لتقسيم النتائج إلى صفحات، استخدِم القيمة nextPageToken أو القيمة previousPageToken من طلب آخر. |
التفويض
يتطلّب هذا الطلب الحصول على تفويض باستخدام نطاق واحد على الأقل من النطاقات التالية:
| النطاق |
https://www.googleapis.com/auth/datastudio.readonly |
https://www.googleapis.com/auth/datastudio |
نص الطلب
لا تقدّم نص طلب مع هذه الطريقة.
الردّ
في حال نجاح العملية، تعرض هذه الطريقة نص استجابة بالبنية التالية:
{
"assets": [Asset],
"nextPageToken": string
}
| اسم السمة |
النوع |
الوصف |
| الأصول |
Array<Asset> |
قائمة مواد العرض |
| nextPageToken |
سلسلة |
رمز مميّز لاسترداد الصفحة التالية من النتائج. لا تظهر هذه السمة إلا عندما يكون عدد النتائج أكبر من الطلب pageSize. يشير nextPageToken فارغ إلى عدم توفّر المزيد من النتائج لعرضها. |
| previousPageToken |
سلسلة |
رمز مميز لاسترداد الصفحة السابقة من النتائج. يشير previousPageToken الفارغ إلى بداية مجموعة النتائج. |
أمثلة
يمكنك إدخال سلاسل البحث المتقدّم في الحقل title.
يمكنك استخدام أنواع بحث متعددة في سلسلة بحث واحدة.
اطّلِع على الجدول التالي لمعرفة بنية سلاسل البحث المتوافقة. يمكنك دمج
سلاسل بحث متعددة.
| تصفية |
التعريف |
أمثلة |
| صانع المحتوى |
البحث عن مواد عرض أنشأها مستخدم معيّن |
creator:mecreator:user@example.com
|
| المالك |
البحث عن مواد عرض يملكها مستخدم معيّن |
owner:meowner:user@example.com
|
| المشروع |
البحث عن مواد عرض في مشروع |
|
| Workspace |
ابحث عن مواد عرض في مساحة عمل أو مجلد. |
parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9
|
| من |
البحث عن مواد عرض شاركها معك مستخدم |
|
| إلى |
البحث عن مواد عرض شاركتها مع مستخدم أو مجموعة |
to:user@example.comto:example-group@googlegroups.com
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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` |"]]
