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

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

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