เปิดใช้ภาพขนาดย่อ

ภาพขนาดย่อจะปรากฏสำหรับเอกสารที่ผลการค้นหาแสดง อนุญาตภาพขนาดย่อ เพื่อให้ผู้ใช้ระบุความเกี่ยวข้องของเอกสารที่ส่งคืนได้ดียิ่งขึ้น ภาพปกมี ลักษณะเฉพาะต่อไปนี้

  • ความกว้าง 1024 พิกเซล
  • URL สำหรับภาพขนาดย่อของไฟล์ Google Workspace มีการป้องกันด้วย ACL URL สำหรับ ไฟล์ประเภทอื่นไม่มีการป้องกัน ACL
  • URL จะหมดอายุหลังจากผ่านไป 5 นาที
  • ภาพขนาดย่อจะไม่สร้างขึ้นสำหรับไฟล์ที่มีขนาดใหญ่กว่า 50 MB
  • หากสร้างภาพขนาดย่อไม่ได้ ระบบจะใช้ไอคอนตัวยึดตำแหน่ง หากภาพปก สำหรับรายการใน Google Workspace สร้างไม่ได้ URL ของภาพขนาดย่อจะแสดง "404 ไม่พบ" แอปพลิเคชันของคุณต้องจัดการกับการทำงานนี้

ภาพขนาดย่อจะถูกสร้างขึ้นโดยอัตโนมัติ สำหรับไฟล์ Google ไดรฟ์ รองรับภาพขนาดย่อ เช่น ประเภทเอกสารใน Google Workspace (เอกสาร ชีต สไลด์ และอื่นๆ) นอกจากนี้ 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 (HTML)
  • ภาษามาร์กอัปที่ขยายได้ (XML)

ระบบจะแสดงภาพขนาดย่อสำหรับรายการที่มีแหล่งข้อมูลและแอปพลิเคชันการค้นหาเท่านั้น ให้เปิดใช้งาน

เปิดใช้ URL ของภาพขนาดย่อสำหรับแหล่งข้อมูล

โปรเจ็กต์แพลตฟอร์ม Cloud Search มีข้อมูลเข้าสู่ระบบของบัญชีบริการ อย่างไรก็ตาม ในการเปิดใช้ URL ของภาพขนาดย่อ คุณต้องสร้าง คีย์ API และข้อมูลรับรองเว็บแอปพลิเคชัน และใช้ข้อมูลเข้าสู่ระบบเว็บแอปพลิเคชัน เพื่อรับโทเค็นเพื่อการเข้าถึง สุดท้าย คุณใช้ข้อมูลเข้าสู่ระบบเหล่านี้เพื่อรับและอัปเดต แหล่งข้อมูล

  1. สร้างหรือเลือกโปรเจ็กต์สำหรับแอปและเปิดใช้ หากยังไม่ได้ดำเนินการ API สำหรับข้อมูลเกี่ยวกับ 2 ขั้นตอนนี้ โปรดดูขั้นตอนที่ 1 และ 2 ของ กำหนดค่าการเข้าถึง Google Cloud Search API
  2. สร้างคีย์ API
    1. ในคอนโซล Google Cloud ให้คลิกรายการแบบเลื่อนลง "สร้างข้อมูลเข้าสู่ระบบ" และ เลือกคีย์ API "สร้างคีย์ API แล้ว" จะปรากฏขึ้น
    2. จดคีย์ API
    3. คลิก "ปิด" ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในส่วน "คีย์ API"
  3. สร้างข้อมูลเข้าสู่ระบบเว็บแอปพลิเคชัน ใช้ https://developers.google.com/oauthplayground เป็น URI การเปลี่ยนเส้นทาง สำหรับขั้นตอนในการสร้างข้อมูลเข้าสู่ระบบเหล่านี้ โปรดดูที่ สร้างข้อมูลเข้าสู่ระบบเว็บแอปพลิเคชัน (JavaScript ฝั่งไคลเอ็นต์)
  4. ใน OAuth 2.0 Playground คลิก OAuth 2.0 Configuration
  5. เลือกใช้ข้อมูลเข้าสู่ระบบของคุณเอง
  6. ป้อนรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ที่สร้างขึ้นในขั้นตอนที่ 3
  7. ในช่องขอบเขต ให้พิมพ์ https://www.googleapis.com/auth/cloud_search.settings แล้วคลิกให้สิทธิ์ API
  8. (ไม่บังคับ) หากมีหน้าจอลงชื่อเข้าใช้ปรากฏขึ้น ให้เลือกบัญชีที่จะใช้
  9. (ไม่บังคับ) หากหน้าจอการให้สิทธิ์ปรากฏขึ้น ให้คลิกยอมรับ
  10. คลิกรหัสการให้สิทธิ์ของ Exchange สำหรับโทเค็น แสดงโทเค็น
  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 สำหรับข้อมูลเกี่ยวกับ 2 ขั้นตอนนี้ โปรดดูขั้นตอนที่ 1 และ 2 ของ กำหนดค่าการเข้าถึง Google Cloud Search API
  2. สร้างคีย์ API
    1. ในคอนโซลระบบคลาวด์ ให้คลิกรายการแบบเลื่อนลง "สร้างข้อมูลเข้าสู่ระบบ" และ เลือกคีย์ API "สร้างคีย์ API แล้ว" จะปรากฏขึ้น
    2. จดคีย์ API
    3. คลิก "ปิด" ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในส่วน "คีย์ API"
  3. สร้างข้อมูลเข้าสู่ระบบเว็บแอปพลิเคชัน ใช้ https://developers.google.com/oauthplayground เป็น URI การเปลี่ยนเส้นทาง หากต้องการทราบขั้นตอนในการสร้างข้อมูลเข้าสู่ระบบเหล่านี้ โปรดไปที่ สร้างข้อมูลเข้าสู่ระบบเว็บแอปพลิเคชัน (JavaScript ฝั่งไคลเอ็นต์)
  4. ใน OAuth 2.0 Playground คลิก OAuth 2.0 Configuration
  5. เลือกใช้ข้อมูลเข้าสู่ระบบของคุณเอง
  6. ป้อนรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ที่สร้างขึ้นในขั้นตอนที่ 3
  7. ในช่องขอบเขต ให้พิมพ์ https://www.googleapis.com/auth/cloud_search.settings แล้วคลิกให้สิทธิ์ API
  8. (ไม่บังคับ) หากมีหน้าจอลงชื่อเข้าใช้ปรากฏขึ้น ให้เลือกบัญชีที่จะใช้
  9. (ไม่บังคับ) หากหน้าจอการให้สิทธิ์ปรากฏขึ้น ให้คลิกยอมรับ
  10. คลิกรหัสการให้สิทธิ์ของ Exchange สำหรับโทเค็น แสดงโทเค็น
  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 ในไดรฟ์ ผู้ใช้หรือ จะต้องส่งข้อมูลเข้าสู่ระบบของบัญชีเดียวกันกับที่ใช้เพื่อเข้าถึง รายการใน Google ไดรฟ์