חיפוש של נכסי Data Studio של משתמש.
בקשה
בקשת HTTP
GET https://datastudio.googleapis.com/v1/assets:search
פרמטרים
| שם הפרמטר | סוג | תיאור |
|---|---|---|
| assetTypes | Array<AssetType> | נדרש. סוג הנכס לחיפוש. צריך לציין בדיוק סוג נכס אחד. |
| title | מחרוזת | המחרוזת לחיפוש. כברירת מחדל, המחרוזת נבדקת מול השם והתיאור של הנכס. בקטע דוגמאות מפורטות מחרוזות חיפוש מתקדמות. |
| includeTrashed | בוליאני | ברירת המחדל היא false.
|
| בעלים | מחרוזת | האימייל של בעל הנכס. |
| orderBy | מחרוזת | סדר התוצאות. אפשר למיין לפי השדות הבאים:
|
| pageSize | number | מספר התוצאות שיוצגו בכל דף. ברירת המחדל היא 1,000. |
| 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.
אפשר להשתמש בכמה סוגי חיפוש במחרוזת חיפוש אחת.
בטבלה הבאה מפורט התחביר הנתמך של מחרוזות חיפוש. אפשר לשלב כמה מחרוזות חיפוש.
| סינון | הגדרה | דוגמאות |
|---|---|---|
| יוצר | חיפוש נכסים שנוצרו על ידי משתמש ספציפי. |
|
| בעלים | חיפוש נכסים שבבעלות משתמש ספציפי. |
|
| פרויקט | חיפוש נכסים בפרויקט. |
|
| Workspace | מחפשים נכסים בסביבת עבודה או בתיקייה. |
|
| מאת | חיפוש נכסים שמשתמש שיתף איתכם. |
|
| אל | חיפוש נכסים ששיתפתם עם משתמש או קבוצה. |
|