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

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

• רוחב של 1,024 פיקסלים.
• כתובות ה-URL של התמונות הממוזערות של קבצים ב-Google Workspace מוגנות באמצעות ACL. אין תמיכה בסוגים אחרים של קבצים.
• התוקף של כתובות ה-URL יפוג אחרי 5 דקות.
• גודל הקובץ המקסימלי ליצירה הוא 50MB.
• אם היצירה נכשלת, Cloud Search מחזיר סמל placeholder. לגבי פריטים ב-Google Workspace, כתובת ה-URL מחזירה את השגיאה '404 לא נמצא'. האפליקציה צריכה לטפל בזה.

‫Google Drive יוצר באופן אוטומטי תמונות ממוזערות לסוגים נתמכים כמו Docs,‏ Sheets ו-Slides. ‫Cloud Search גם יוצר תמונות ממוזערות עבור:

• ‫Microsoft Word‏ (DOC, ‏ DOCX)
• Microsoft Excel (XLS, XLSX)‎
• Microsoft PowerPoint (PPT, PPTX)
• Adobe PDF
• ‫RTF,‏ TXT,‏ HTML ו-XML

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

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

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

1. יוצרים או בוחרים פרויקט ומפעילים את ה-API. הגדרת גישה ל-Cloud Search API
2. יוצרים מפתח API במסוף Google Cloud ורושמים את הערך.
3. יוצרים פרטי כניסה לאפליקציית אינטרנט. משתמשים ב-https://developers.google.com/oauthplayground כ-URI של ההפניה. איך יוצרים פרטי כניסה
4. ב-OAuth 2.0 Playground, פותחים את OAuth 2.0 Configuration .
5. בוחרים באפשרות שימוש בפרטים משלכם ומזינים את מספר הלקוח והסוד.
6. מזינים https://www.googleapis.com/auth/cloud_search.settings בשדה scopes (היקפי הרשאות) ולוחצים על Authorize APIs (מתן הרשאה לממשקי API).
7. מחליפים את קוד ההרשאה באסימונים.

8. מתקשרים אל 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
   

9. שיחה אל settings.datasources.update עם הגדרת returnThumbnailUrls לערך true:

   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":"DISPLAY_NAME","itemsVisibility":[{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
   --compressed
   

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

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

1. מקבלים מפתח API ואסימון גישה באותה שיטה שמתוארת בקטע הקודם.

2. מתקשרים אל settings.searchapplications.get כדי לקבל את מזהה האפליקציה:

   curl 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed
   

3. שיחה עם settings.searchapplications.update באמצעות returnResultThumbnailUrls הוגדרה לערך true:

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

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

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