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

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

• רוחב של 1,024 פיקסלים.
• כתובת ה-URL של התמונות הממוזערות של הקבצים ב-Google Workspace מוגנת באמצעות ACL. כתובת האתר לסוגי קבצים אחרים אינה מוגנת על ידי 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 ופרטי כניסה לאפליקציית אינטרנט, ולהשתמש בפרטי הכניסה של אפליקציית האינטרנט כדי לקבל אסימון גישה. לבסוף, משתמשים בפרטי הכניסה האלה כדי לקבל ולעדכן מקור נתונים.

1. אם עדיין לא עשיתם זאת, עליכם ליצור או לבחור פרויקט לאפליקציה ולהפעיל את ה-API. למידע על שני השלבים האלה, קראו את שלבים 1 ו-2 בקטע הגדרת הגישה ל-Google Cloud Search API.
2. יוצרים מפתח API:
   1. במסוף Google Cloud, לוחצים על הרשימה הנפתחת Create Credentials (יצירת פרטי כניסה) ובוחרים באפשרות 'מפתח API'. יופיע הדף 'מפתח API נוצר'.
   2. שימו לב למפתח ה-API.
   3. לחצו על 'סגור'. פרטי הכניסה החדשים שיצרתם מופיעים בקטע 'מפתחות API'.
3. יצירת פרטי כניסה לאפליקציית אינטרנט. משתמשים ב-https://developers.google.com/oauthplayground כ-URI להפניה אוטומטית. . להוראות ליצירת פרטי הכניסה האלה, קראו את המאמר יצירת פרטי כניסה לאפליקציית אינטרנט (JavaScript בצד הלקוח).
4. במגרש המשחקים של OAuth 2.0, לוחצים על תצורת OAuth 2.0 .
5. מסמנים את האפשרות שימוש בפרטי הכניסה שלך.
6. מזינים את מזהה הלקוח ואת סוד הלקוח שנוצרו בשלב 3.
7. בשדה ההיקפים, מקלידים https://www.googleapis.com/auth/cloud_search.settings ולוחצים על Authorize APIs.
8. (אופציונלי) אם מופיע מסך כניסה, בוחרים את החשבון שבו רוצים להשתמש.
9. (אופציונלי) אם מוצג מסך הרשאה, לוחצים על אישור.
10. לוחצים על החלפת קוד הרשאה לאסימונים. האסימון מוחזר.
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. קריאה ל-setting.datasource.update כאשר returnThumbnailUrls מוגדרת ל-true כדי להפעיל כתובות URL של תמונות ממוזערות עבור מקור הנתונים:

    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'. יופיע הדף 'מפתח API נוצר'.
   2. שימו לב למפתח ה-API.
   3. לחצו על 'סגור'. פרטי הכניסה החדשים שיצרתם מופיעים בקטע 'מפתחות API'.
3. יצירת פרטי כניסה לאפליקציית אינטרנט. משתמשים ב-https://developers.google.com/oauthplayground כ-URI להפניה אוטומטית. . להוראות ליצירת פרטי הכניסה האלה, קראו את המאמר יצירת פרטי כניסה לאפליקציית אינטרנט (JavaScript בצד הלקוח).
4. במגרש המשחקים של OAuth 2.0, לוחצים על תצורת OAuth 2.0 .
5. מסמנים את האפשרות שימוש בפרטי הכניסה שלך.
6. מזינים את מזהה הלקוח ואת סוד הלקוח שנוצרו בשלב 3.
7. בשדה ההיקפים, מקלידים https://www.googleapis.com/auth/cloud_search.settings ולוחצים על Authorize APIs.
8. (אופציונלי) אם מופיע מסך כניסה, בוחרים את החשבון שבו רוצים להשתמש.
9. (אופציונלי) אם מוצג מסך הרשאה, לוחצים על אישור.
10. לוחצים על החלפת קוד הרשאה לאסימונים. האסימון מוחזר.
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. אפשר להפעיל את 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.