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

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

• רוחב של 1,024 פיקסלים.
• כתובת ה-URL של התמונות הממוזערות של קבצים ב-Google Workspace מוגנת על ידי ACL. כתובת ה-URL של סוגי קבצים אחרים לא מוגנת על ידי ACL
• התוקף של כתובות ה-URL יפוג אחרי 5 דקות.
• לא נוצרים תמונות ממוזערות לקבצים שגודלם גדול מ-50 MB.
• אם המערכת לא מצליחה ליצור תמונה ממוזערת, היא משתמשת בסמל של פלייס הולדר. אם אי אפשר ליצור תמונה ממוזערת של פריט ב-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 ‏ (RTF)
• פורמט טקסט (TXT)
• Hypertext Markup Language (HTML)
• שפת סימון מורחבת (XML)

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

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

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

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