דף זה תורגם על ידי Cloud Translation API.

הפעלת תמונות ממוזערות

תמונות ממוזערות מוצגות עבור מסמכים שהוחזרו על ידי תוצאות חיפוש. ניתן להשתמש בתמונות ממוזערות את המשתמש כדי לזהות טוב יותר את הרלוונטיות של המסמכים שהוחזרו. לתמונות ממוזערות יש את המאפיינים הבאים:

רוחב של 1024 פיקסלים.
כתובת ה-URL לתמונות ממוזערות של קובצי Google Workspace מוגנת באמצעות ACL. כתובת ה-URL של סוגי קבצים אחרים לא מוגנים באמצעות ACL
התוקף של כתובות URL פג אחרי 5 דקות.
תמונות ממוזערות לא נוצרות לקבצים שגודלם עולה על 50MB.
אם אי אפשר ליצור תמונה ממוזערת, המערכת תשתמש בסמל placeholder. אם תמונה ממוזערת אי אפשר ליצור פריט ב-Google Workspace, כתובת ה-URL של התמונה הממוזערת תחזיר "404 לא נמצא" האפליקציה צריכה לטפל בהתנהגות הזו.

תמונות ממוזערות נוצרות באופן אוטומטי עבור קובצי Google Drive, שבאופן טבעי לתמוך בתמונות ממוזערות, כמו סוגי מסמכים של Google Workspace (Docs, Sheets, Slides וכו'). בנוסף, Cloud Search יוצר תמונות ממוזערות באופן אוטומטי לסוגי הקבצים הבאים:

Microsoft Word (DOC)
Microsoft Word (DOCX)
Microsoft Excel (XLS)
Microsoft Excel (XLSX)
Microsoft PowerPoint (PPT)
Microsoft PowerPoint (PPTX)
Adobe Portable Document Format (PDF)
פורמט טקסט עשיר (RTF)
פורמט טקסט (TXT)
שפת סימון של היפר-טקסט (HTML)
שפת סימון ניתנת להרחבה (XML)

תמונות ממוזערות מוחזרות רק עבור פריטים שמקור הנתונים ואפליקציות החיפוש שלהם להפעיל אותן.

הפעלת כתובות URL של תמונות ממוזערות למקור נתונים

הפרויקט בפלטפורמת Cloud Search מכיל פרטי כניסה של חשבון שירות. עם זאת, כדי להפעיל כתובות URL של תמונות ממוזערות, צריך ליצור מפתח API ופרטי כניסה של אפליקציית אינטרנט ושימוש בפרטי הכניסה של אפליקציית האינטרנט כדי לקבל אסימון גישה. לבסוף, משתמשים בפרטי הכניסה האלה כדי לקבל מקור נתונים.

אם עדיין לא עשית זאת, עליך ליצור או לבחור פרויקט לאפליקציה שלך ולהפעיל אותו ממשק ה-API. למידע על שני השלבים האלה, קראו את השלבים 1 ו-2 של הגדרת גישה ל-Google Cloud Search API
יוצרים מפתח API:
1. במסוף Google Cloud, לוחצים על הרשימה הנפתחת Create Credentials ואז בוחרים מפתח API. 'מפתח ה-API נוצר' מופיעה.
2. רושמים או זוכרים את מפתח ה-API.
3. לחצו על 'סגור'. פרטי הכניסה החדשים שנוצרו יופיעו בקטע 'מפתחות API'.
יצירת פרטי כניסה לאפליקציית אינטרנט. שימוש בפורמט https://developers.google.com/oauthplayground בתור ה-URI להפניה אוטומטית. . השלבים ליצירת פרטי הכניסה האלה זמינים במאמר יצירת פרטי כניסה לאפליקציית אינטרנט (JavaScript בצד הלקוח).
במגרש המשחקים של OAuth 2.0, לוחצים על הגדרת OAuth 2.0 .
מסמנים את האפשרות שימוש בפרטי הכניסה שלך.
מזינים את מזהה הלקוח ואת סוד הלקוח שנוצרו בשלב 3.
בשדה 'היקפים', מקלידים https://www.googleapis.com/auth/cloud_search.settings ולוחצים על Authorize APIs.
(אופציונלי) אם מוצג מסך כניסה, בוחרים את החשבון שבו רוצים להשתמש.
(אופציונלי) אם מוצג מסך הרשאה, לוחצים על אישור.
לוחצים על החלפת קוד הרשאה לאסימונים. מוחזר אסימון.
מזהים את מקור הנתונים שעבורו רוצים להפעיל את התמונה הממוזערת הפקדים בנגן.
חיוג אל settings.datasources.get כדי לקבל את המזהה של מקור הנתונים:
```
curl
'https://cloudsearch.googleapis.com/v1/settings/datasource_id?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]'\
--header 'Accept: application/json'  \
--compressed
```
כאשר:
- datasource_id הוא השם של מקור הנתונים שצריך לאחזר.
- YOUR_API_KEY הוא מפתח ה-API של הפרויקט (שמתקבל משלב 2).
- YOUR_ACCESS_TOKEN הוא אסימון גישה מסוג OAuth 2.0 בשביל הפרויקט שלך (התקבל משלב 10).
התוצאה המוצלחת של הפקודה הזו דומה לתוצאה הבאה:
```
{
 "source": {
   "name": "datasources/datasource_id",
   "displayName": "DataSource_Display_Name",
   "itemsVisibility": [
     {
       "gsuiteDomain": true
     }
   ]
 }
}
```
חיוג אל setting.datasource.update עם returnThumbnailUrls מוגדר ל-true כדי להפעיל כתובות URL של תמונות ממוזערות עבור הנתונים source:
```
curl --request PUT \  'https://cloudsearch.googleapis.com/v1/settings/datasources/datasource_id?key=[YOUR_API_KEY]' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"source":{"name":"datasources/datasource_id","displayName":"DataSource_Display_Name","itemsVisibility":
    [{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
  --compressed
```
כאשר:
- datasource_id הוא המזהה של מקור הנתונים שצריך לאחזר.
- YOUR_API_KEY הוא מפתח ה-API של הפרויקט (שמתקבל משלב 2).
- YOUR_ACCESS_TOKEN הוא אסימון גישה מסוג OAuth 2.0 בשביל הפרויקט שלך (התקבל משלב 10).
- DataSource_DisplayName הוא השם המוצג שהוחזר מהשם הקודם בפקודת cURL.
- "returnThumbnailsUrls":true מאפשר שימוש בתמונות ממוזערות.
התוצאה המוצלחת של הפקודה הזו דומה לתוצאה הבאה:
```
{
  "source": {
    "name": "datasources/datasource_id",
    "displayName": "DataSource_Display_Name",
    "itemsVisibility": [
      {
        "gsuiteDomain": true
      }
    ],
    "returnThumbnailUrls": true
  }
}
```

הפעלת כתובות URL של תמונות ממוזערות באפליקציית חיפוש

אם עדיין לא עשית זאת, עליך ליצור או לבחור פרויקט לאפליקציה שלך ולהפעיל אותו ממשק ה-API. למידע על שני השלבים האלה, קראו את השלבים 1 ו-2 של הגדרת גישה ל-Google Cloud Search API
יוצרים מפתח API:
1. במסוף Cloud, לוחצים על הרשימה הנפתחת Create Credentials ואז בוחרים מפתח API. 'מפתח ה-API נוצר' מופיעה.
2. רושמים או זוכרים את מפתח ה-API.
3. לחצו על 'סגור'. פרטי הכניסה החדשים שנוצרו יופיעו בקטע 'מפתחות API'.
יצירת פרטי כניסה לאפליקציית אינטרנט. שימוש בפורמט https://developers.google.com/oauthplayground בתור ה-URI להפניה אוטומטית. . השלבים ליצירת פרטי הכניסה האלה זמינים במאמר יצירת פרטי כניסה לאפליקציית אינטרנט (JavaScript בצד הלקוח).
במגרש המשחקים של OAuth 2.0, לוחצים על הגדרת OAuth 2.0 .
מסמנים את האפשרות שימוש בפרטי הכניסה שלך.
מזינים את מזהה הלקוח ואת סוד הלקוח שנוצרו בשלב 3.
בשדה 'היקפים', מקלידים https://www.googleapis.com/auth/cloud_search.settings ולוחצים על Authorize APIs.
(אופציונלי) אם מוצג מסך כניסה, בוחרים את החשבון שבו רוצים להשתמש.
(אופציונלי) אם מוצג מסך הרשאה, לוחצים על אישור.
לוחצים על החלפת קוד הרשאה לאסימונים. מוחזר אסימון.
מזהים את אפליקציית החיפוש שעבורה רוצים להפעיל את פקדי התמונות הממוזערות.
חיוג אל settings.searchapplications.get כדי לקבל את המזהה של אפליקציית החיפוש:
```
curl \ 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/search_application_id?key=[YOUR_API_KEY]' \
 --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
 --header 'Accept: application/json' \
 --compressed
```
כאשר:
- הוא המזהה של אפליקציית החיפוש שצריך לאחזר.
- YOUR_API_KEY הוא מפתח ה-API של הפרויקט (שמתקבל משלב 2).
- YOUR_ACCESS_TOKEN הוא אסימון גישה מסוג OAuth 2.0 בשביל הפרויקט שלך (התקבל משלב 10).
התוצאה המוצלחת של הפקודה הזו דומה לתוצאה הבאה:
```
{
 "name": "searchapplications/search_application_id",
 "displayName": "SearchApp_Display_Name",
 "dataSourceRestrictions": [
   {
     "source": {
       "name": "datasources/datasource_id"
     }
   }
 ]
}
```

חיוג אל setting.searchapplications.update עם returnResultThumbnailUrls מוגדר ל-true כדי לאפשר כתובות URL של תמונות ממוזערות עבור אפליקציית חיפוש:

curl --request PUT \  'https://cloudsearch.googleapis.com/v1/settings/searchapplications/search_application_id?key=[YOUR_API_KEY]' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"name":"searchapplications/search_application_id","displayName":"SearchApp_Display_Name","dataSourceRestrictions":[{"source":
    {"name":"datasources/datasource_id"}}],"returnResultThumbnailUrls":true}' \
  --compressed

כאשר:

הוא המזהה של אפליקציית החיפוש שצריך לאחזר.
YOUR_API_KEY הוא מפתח ה-API של הפרויקט (שמתקבל משלב 2).
YOUR_ACCESS_TOKEN הוא אסימון גישה מסוג OAuth 2.0 עבור הפרויקט שלך (התקבל משלב 10).
SearchApp_DisplayName הוא השם המוצג שהוחזר מהשם הקודם בפקודת cURL.
"returnResultThumbnailUrls":true מאפשר שימוש בתמונות ממוזערות.

התוצאה המוצלחת של הפקודה הזו דומה לתוצאה הבאה:

{
  "name": "searchapplications/search_application_id",
  "displayName": "SearchApp_Display_Name",
  "dataSourceRestrictions": [
    {
      "source": {
        "name": "datasources/datasource_id"
      }
    }
  ],
  "returnResultThumbnailUrls": true
}

גישה לתמונות ממוזערות

כדי לגשת לתמונה ממוזערת של קובץ Google Workspace ב-Drive, המשתמש או חייבים להעביר את אותם פרטי כניסה של החשבון שבהם הם משתמשים כדי לגשת ספציפי ב-Google Drive.