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

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

  • ความกว้าง 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 (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. ในคอนโซลระบบคลาวด์ ให้คลิกรายการแบบเลื่อนลงสร้างข้อมูลเข้าสู่ระบบ แล้วเลือกคีย์ 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 ไดรฟ์