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

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

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

ระบบจะสร้างภาพขนาดย่อให้โดยอัตโนมัติสำหรับไฟล์ 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)
  • ภาษามาร์กอัปไฮเปอร์เท็กซ์ (HTML)
  • Extensible Markup Language (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. คลิกรหัสการให้สิทธิ์ของ 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
  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 ไดรฟ์