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

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

• רוחב של 1,024 פיקסלים.
• כתובת ה-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)
• Rich Text Format ‏ (RTF)
• פורמט טקסט (TXT)
• Hypertext Markup Language‏ (HTML)
• Extensible Markup Language‏ (XML)

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

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

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

1. אם עדיין לא עשיתם זאת, יוצרים או בוחרים פרויקט לאפליקציה ומפעילים את ה-API. מידע על שני השלבים האלה זמין בשלבים 1 ו-2 במאמר הגדרת גישה ל-Google Cloud Search API.
2. יוצרים מפתח API:
   1. במסוף Google Cloud, לוחצים על התפריט הנפתח Create Credentials ובוחרים באפשרות API Key. יופיע הדף 'מפתח ה-API נוצר'.
   2. שימו לב למפתח ה-API.
   3. לחצו על 'סגור'. פרטי הכניסה החדשים שיצרתם יופיעו בקטע 'מפתחות API'.
3. יוצרים פרטי כניסה לאפליקציית אינטרנט. משתמשים ב-https://developers.google.com/oauthplayground ככתובת ה-URI להפניה אוטומטית. . כדי לקבל הוראות ליצירת פרטי הכניסה האלה, אפשר לעיין במאמר יצירת פרטי כניסה לאפליקציית אינטרנט (JavaScript בצד הלקוח).
4. ב-OAuth 2.0 Playground, לוחצים על OAuth 2.0 Configuration .
5. מסמנים את התיבה Use your own credentials (שימוש בפרטי הכניסה שלך).
6. מזינים את מזהה הלקוח ואת סוד הלקוח שנוצרו בשלב 3.
7. בשדה ההיקפים, מקלידים https://www.googleapis.com/auth/cloud_search.settings ולוחצים על Authorize APIs.
8. (אופציונלי) אם מוצג מסך כניסה, בוחרים את החשבון שבו רוצים להשתמש.
9. (אופציונלי) אם מופיעה מסך הרשאה, לוחצים על אישור.
10. לוחצים על Exchange authorization code for tokens. הטוקן מוחזר.
11. מזהים את מקור הנתונים שרוצים להפעיל בו את אמצעי הבקרה של התמונות הממוזערות.

12. קוראים לפונקציה 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
         }
       ]
     }
    }
    

13. כדי להפעיל את כתובות ה-URL של התמונות הממוזערות של מקור הנתונים, צריך להפעיל את setting.datasource.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":"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 של תמונות ממוזערות באפליקציית חיפוש

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

1. אם עדיין לא עשיתם זאת, יוצרים או בוחרים פרויקט לאפליקציה ומפעילים את ה-API. מידע על שני השלבים האלה זמין בשלבים 1 ו-2 במאמר הגדרת גישה ל-Google Cloud Search API.
2. יוצרים מפתח API:
   1. במסוף Cloud, לוחצים על הרשימה הנפתחת Create Credentials ובוחרים באפשרות API Key. יופיע הדף 'API Key created'.
   2. שימו לב למפתח ה-API.
   3. לחצו על 'סגור'. פרטי הכניסה החדשים שיצרתם יופיעו בקטע 'מפתחות API'.
3. יוצרים פרטי כניסה לאפליקציית אינטרנט. משתמשים ב-https://developers.google.com/oauthplayground ככתובת ה-URI להפניה אוטומטית. . כדי לקבל הוראות ליצירת פרטי הכניסה האלה, אפשר לעיין במאמר יצירת פרטי כניסה לאפליקציית אינטרנט (JavaScript בצד הלקוח).
4. ב-OAuth 2.0 Playground, לוחצים על OAuth 2.0 Configuration .
5. מסמנים את התיבה Use your own credentials (שימוש בפרטי הכניסה שלך).
6. מזינים את מזהה הלקוח ואת סוד הלקוח שנוצרו בשלב 3.
7. בשדה ההיקפים, מקלידים https://www.googleapis.com/auth/cloud_search.settings ולוחצים על Authorize APIs.
8. (אופציונלי) אם מוצג מסך כניסה, בוחרים את החשבון שבו רוצים להשתמש.
9. (אופציונלי) אם מופיעה מסך הרשאה, לוחצים על אישור.
10. לוחצים על Exchange authorization code for tokens. הטוקן מוחזר.
11. מאתרים את אפליקציית החיפוש שבה רוצים להפעיל את אמצעי הבקרה של התמונות הממוזערות.

12. קוראים לפונקציה 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"
         }
       }
     ]
    }
    

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

    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.