جستجوی داراییهای استودیوی داده یک کاربر.
درخواست
درخواست HTTP
GET https://datastudio.googleapis.com/v1/assets:search
پارامترها
| نام پارامتر | نوع | توضیحات |
|---|---|---|
| انواع دارایی | آرایه < نوع دارایی > | الزامی . نوع دارایی مورد جستجو. دقیقاً یک نوع دارایی باید مشخص شود. |
| عنوان | رشته | رشته جستجو. به طور پیشفرض، رشته با عنوان و توضیحات دارایی مقایسه میشود. برای رشتههای جستجوی پیشرفته به بخش مثالها مراجعه کنید. |
| شاملحذفشدهها | بولی | پیشفرض روی false است.
|
| مالک | رشته | ایمیل صاحب دارایی. |
| سفارش توسط | رشته | ترتیب نتایج. میتوانید نتایج را بر اساس فیلدهای زیر مرتب کنید:
|
| اندازه صفحه | شماره | تعداد نتایجی که در هر صفحه نمایش داده میشود. پیشفرض ۱۰۰۰ است. |
| توکن صفحه | رشته | یک توکن که صفحهای از نتایج را برای برگرداندن مشخص میکند. برای صفحهبندی نتایج، از مقدار nextPageToken یا مقدار previousPageToken از یک درخواست دیگر استفاده کنید. |
مجوز
این درخواست نیاز به مجوز با حداقل یکی از حوزههای زیر دارد:
| محدوده |
|---|
https://www.googleapis.com/auth/datastudio.readonly |
https://www.googleapis.com/auth/datastudio |
درخواست بدنه
با این روش، بدنه درخواست (request body) ارائه ندهید.
پاسخ
در صورت موفقیت، این متد یک بدنه پاسخ با ساختار زیر برمیگرداند:
{
"assets": [Asset],
"nextPageToken": string
}
| نام ملک | نوع | توضیحات |
|---|---|---|
| داراییها | آرایه< دارایی > | فهرست داراییها. |
| توکن صفحه بعدی | رشته | یک توکن برای بازیابی صفحه بعدی نتایج. این ویژگی فقط زمانی وجود دارد که تعداد نتایج بیشتر از pageSize درخواستی باشد. یک nextPageToken خالی نشان میدهد که هیچ نتیجه دیگری برای برگرداندن وجود ندارد. |
| قبلیصفحهتوکن | رشته | یک توکن برای بازیابی صفحه قبلی نتایج. یک previousPageToken خالی، ابتدای مجموعه نتایج را نشان میدهد. |
مثالها
شما میتوانید رشتههای جستجوی پیشرفته را در فیلد title وارد کنید. میتوانید از چندین نوع جستجو در یک رشته جستجو استفاده کنید. برای مشاهده سینتکس رشته جستجوی پشتیبانی شده، به جدول زیر مراجعه کنید. میتوانید چندین رشته جستجو را با هم ترکیب کنید.
| فیلتر | تعریف | مثالها |
|---|---|---|
| خالق | جستجوی داراییهای ایجاد شده توسط یک کاربر خاص. |
|
| مالک | جستجوی داراییهای متعلق به یک کاربر خاص. |
|
| پروژه | جستجوی داراییها در یک پروژه |
|
| فضای کاری | جستجوی داراییها در یک فضای کاری یا پوشه. |
|
| از | به دنبال داراییهایی بگردید که کاربر با شما به اشتراک گذاشته است. |
|
| به | به دنبال داراییهایی بگردید که با یک کاربر یا گروه به اشتراک گذاشتهاید. |
|