Aktifkan thumbnail

Thumbnail membantu pengguna mengidentifikasi hasil penelusuran yang relevan. Mereka memiliki karakteristik berikut:

  • Lebar 1024 px.
  • URL untuk thumbnail file Google Workspace dilindungi dengan ACL. Jenis file lainnya tidak.
  • Masa berlaku URL akan berakhir setelah 5 menit.
  • Ukuran file maksimum untuk pembuatan adalah 50 MB.
  • Jika pembuatan gagal, Cloud Search akan menampilkan ikon placeholder. Untuk item Google Workspace, URL menampilkan "404 Not Found". Aplikasi Anda harus menanganinya.

Google Drive otomatis membuat thumbnail untuk jenis yang didukung seperti Dokumen, Spreadsheet, dan Slide. Cloud Search juga membuat thumbnail untuk:

  • Microsoft Word (DOC, DOCX)
  • Microsoft Excel (XLS, XLSX)
  • Microsoft PowerPoint (PPT, PPTX)
  • Adobe PDF
  • RTF, TXT, HTML, dan XML

Cloud Search hanya menampilkan thumbnail untuk item jika Anda mengaktifkan thumbnail untuk sumber data dan aplikasi penelusuran.

Mengaktifkan URL thumbnail untuk sumber data

Untuk mengaktifkan URL thumbnail, buat kunci API dan kredensial aplikasi web. Gunakan kredensial ini untuk mendapatkan token akses guna memperbarui sumber data Anda.

  1. Buat atau pilih project dan aktifkan API. Lihat Mengonfigurasi akses ke Cloud Search API.
  2. Buat kunci API di konsol Google Cloud dan catat nilainya.
  3. Buat kredensial aplikasi web. Gunakan https://developers.google.com/oauthplayground sebagai URI pengalihan. Lihat Buat kredensial.
  4. Di OAuth 2.0 Playground, buka Konfigurasi OAuth 2.0 .
  5. Pilih Use your own credentials, lalu masukkan ID dan rahasia klien Anda.
  6. Masukkan https://www.googleapis.com/auth/cloud_search.settings di kolom cakupan, lalu klik Otorisasi API.
  7. Tukarkan kode otorisasi dengan token.

  8. Panggil settings.datasources.get untuk mendapatkan ID sumber data Anda:

    curl 'https://cloudsearch.googleapis.com/v1/settings/DATASOURCE_ID?key=YOUR_API_KEY' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed

  9. Panggil settings.datasources.update dengan returnThumbnailUrls yang ditetapkan ke true:

    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":"DISPLAY_NAME","itemsVisibility":[{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
--compressed

Mengaktifkan URL thumbnail untuk aplikasi penelusuran

Anda juga harus mengaktifkan thumbnail di aplikasi penelusuran Anda.

  1. Dapatkan kunci API dan token akses menggunakan metode yang sama seperti yang dijelaskan di bagian sebelumnya.

  2. Panggil settings.searchapplications.get untuk mendapatkan ID aplikasi Anda:

    curl 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed

  3. Panggil settings.searchapplications.update dengan returnResultThumbnailUrls ditetapkan ke true:

    curl --request PUT \
'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"name":"searchapplications/APP_ID","displayName":"DISPLAY_NAME","dataSourceRestrictions":[{"source":{"name":"datasources/DATASOURCE_ID"}}],"returnResultThumbnailUrls":true}' \
--compressed

Mengakses thumbnail

Untuk mengakses thumbnail file Drive, pengguna atau aplikasi harus menggunakan kredensial akun yang sama dengan yang digunakan untuk mengakses item asli.