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

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

• רוחב של 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, המשתמש או האפליקציה צריכים להשתמש באותם פרטי כניסה ששימשו לגישה לפריט המקורי.