Halaman ini diterjemahkan oleh Cloud Translation API.

Aktifkan thumbnail

Thumbnail ditampilkan untuk dokumen yang dikembalikan oleh hasil penelusuran. Thumbnail mengizinkan pengguna untuk mengidentifikasi relevansi dokumen yang dikembalikan dengan lebih baik. Thumbnail memiliki karakteristik berikut:

Lebar 1024 px.
URL untuk thumbnail file Google Workspace dilindungi ACL. URL untuk jenis file lain tidak dilindungi ACL
Masa berlaku URL akan habis setelah 5 menit.
Thumbnail tidak dibuat untuk file yang lebih besar dari 50 MB.
Jika thumbnail tidak dapat dibuat, ikon placeholder akan digunakan. Jika thumbnail untuk item Google Workspace tidak dapat dibuat, URL thumbnail menampilkan "404 Not Found." Aplikasi Anda harus menangani perilaku ini.

Thumbnail dibuat secara otomatis untuk file Google Drive yang secara alami mendukung thumbnail, seperti jenis dokumen Google Workspace (Dokumen, Spreadsheet, Slide, dan sebagainya). Selain itu, Cloud Search akan otomatis membuat thumbnail untuk jenis file berikut:

Microsoft Word (DOC)
Microsoft Word (DOCX)
Microsoft Excel (XLS)
Microsoft Excel (XLSX)
Microsoft Powerpoint (PPT)
Microsoft Powerpoint (PPTX)
Adobe Portable Document Format (PDF)
Format Teks Kaya (RTF)
Format Teks (TXT)
Bahasa Markup Hiperteks (HTML)
{i>Extensible Markup Language<i} (XML)

Thumbnail hanya ditampilkan untuk item yang sumber datanya dan aplikasi penelusurannya mengaktifkannya.

Mengaktifkan URL thumbnail untuk sumber data

Project platform Cloud Search Anda berisi kredensial akun layanan. Namun, untuk mengaktifkan URL thumbnail, Anda harus membuat Kunci API dan kredensial aplikasi web serta menggunakan kredensial aplikasi web untuk mendapatkan token akses. Terakhir, Anda menggunakan kredensial ini untuk mendapatkan dan memperbarui sumber data.

Jika belum melakukannya, buat atau pilih project untuk aplikasi Anda dan aktifkan API. Untuk mengetahui informasi tentang kedua langkah ini, lihat langkah 1 dan 2 dari Konfigurasikan akses ke Google Cloud Search API.
Buat kunci API:
1. Di Konsol Google Cloud, klik menu drop-down Create Credentials dan pilih Kunci API. "Kunci API dibuat" akan muncul.
2. Catat kunci API-nya.
3. Klik Tutup. Kredensial yang baru dibuat akan muncul di bagian "Kunci API".
Membuat kredensial aplikasi Web. Gunakan https://developers.google.com/oauthplayground sebagai URI pengalihan. . Untuk mengetahui langkah-langkah membuat kredensial ini, baca Membuat kredensial aplikasi Web (JavaScript sisi klien).
Di OAuth 2.0 Playground, klik OAuth 2.0 Configuration .
Centang Gunakan kredensial Anda sendiri.
Masukkan client ID dan rahasia klien yang dibuat di langkah 3.
Di kolom cakupan, ketik https://www.googleapis.com/auth/cloud_search.settings lalu klik Authorize APIs.
(opsional) Jika layar Login ditampilkan, pilih akun yang akan digunakan.
(opsional) Jika muncul layar otorisasi, klik Accept.
Klik Exchange otorisasi kode untuk token. Token ditampilkan.
Identifikasi sumber data tempat Anda ingin mengaktifkan thumbnail kontrol.

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

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

Dengan keterangan:

datasource_id adalah nama sumber data yang akan diambil.
YOUR_API_KEY adalah kunci API untuk project Anda (diperoleh dari langkah 2).
YOUR_ACCESS_TOKEN adalah token akses OAuth 2.0 untuk project Anda (diperoleh dari langkah 10).

Hasil yang berhasil dari perintah ini mirip dengan:

{
 "source": {
   "name": "datasources/datasource_id",
   "displayName": "DataSource_Display_Name",
   "itemsVisibility": [
     {
       "gsuiteDomain": true
     }
   ]
 }
}

Panggil setting.datasource.update dengan returnThumbnailUrls disetel ke true guna mengaktifkan URL thumbnail untuk data sumber:

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

Dengan keterangan:

datasource_id adalah ID sumber data yang akan diambil.
YOUR_API_KEY adalah kunci API untuk project Anda (diperoleh dari langkah 2).
YOUR_ACCESS_TOKEN adalah token akses OAuth 2.0 untuk project Anda (diperoleh dari langkah 10).
DataSource_DisplayName adalah nama tampilan yang ditampilkan dari perintah cURL.
"returnThumbnailsUrls":true mengaktifkan thumbnail.

Hasil yang berhasil dari perintah ini mirip dengan:

{
  "source": {
    "name": "datasources/datasource_id",
    "displayName": "DataSource_Display_Name",
    "itemsVisibility": [
      {
        "gsuiteDomain": true
      }
    ],
    "returnThumbnailUrls": true
  }
}

Mengaktifkan URL thumbnail untuk aplikasi penelusuran

Jika belum melakukannya, buat atau pilih project untuk aplikasi Anda dan aktifkan API. Untuk mengetahui informasi tentang kedua langkah ini, lihat langkah 1 dan 2 dari Konfigurasikan akses ke Google Cloud Search API.
Buat kunci API:
1. Di konsol {i>cloud<i}, klik daftar {i> Create Credentials<i} dan pilih Kunci API. "Kunci API dibuat" akan muncul.
2. Catat kunci API-nya.
3. Klik Tutup. Kredensial yang baru dibuat akan muncul di bagian "Kunci API".
Membuat kredensial aplikasi Web. Gunakan https://developers.google.com/oauthplayground sebagai URI pengalihan. . Untuk mengetahui langkah-langkah membuat kredensial ini, baca Membuat kredensial aplikasi Web (JavaScript sisi klien).
Di OAuth 2.0 Playground, klik OAuth 2.0 Configuration .
Centang Gunakan kredensial Anda sendiri.
Masukkan client ID dan rahasia klien yang dibuat di langkah 3.
Di kolom cakupan, ketik https://www.googleapis.com/auth/cloud_search.settings lalu klik Authorize APIs.
(opsional) Jika layar Login ditampilkan, pilih akun yang akan digunakan.
(opsional) Jika muncul layar otorisasi, klik Accept.
Klik Exchange otorisasi kode untuk token. Token ditampilkan.
Identifikasi aplikasi penelusuran yang kontrol thumbnail-nya ingin Anda aktifkan.

Panggil settings.searchapplications.get untuk mendapatkan ID aplikasi penelusuran:

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

Dengan keterangan:

adalah ID aplikasi penelusuran yang akan diambil.
YOUR_API_KEY adalah kunci API untuk project Anda (diperoleh dari langkah 2).
YOUR_ACCESS_TOKEN adalah token akses OAuth 2.0 untuk project Anda (diperoleh dari langkah 10).

Hasil yang berhasil dari perintah ini mirip dengan:

{
 "name": "searchapplications/search_application_id",
 "displayName": "SearchApp_Display_Name",
 "dataSourceRestrictions": [
   {
     "source": {
       "name": "datasources/datasource_id"
     }
   }
 ]
}

Panggil setting.searchapplications.update dengan returnResultThumbnailUrls disetel ke true guna mengaktifkan URL thumbnail untuk aplikasi penelusuran:

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

Dengan keterangan:

adalah ID aplikasi penelusuran yang akan diambil.
YOUR_API_KEY adalah kunci API untuk project Anda (diperoleh dari langkah 2).
YOUR_ACCESS_TOKEN adalah token akses OAuth 2.0 untuk project Anda (diperoleh dari langkah 10).
SearchApp_DisplayName adalah nama tampilan yang ditampilkan dari perintah cURL.
"returnResultThumbnailUrls":true mengaktifkan thumbnail.

Hasil yang berhasil dari perintah ini mirip dengan:

{
  "name": "searchapplications/search_application_id",
  "displayName": "SearchApp_Display_Name",
  "dataSourceRestrictions": [
    {
      "source": {
        "name": "datasources/datasource_id"
      }
    }
  ],
  "returnResultThumbnailUrls": true
}

Mengakses thumbnail

Untuk mengakses thumbnail file Google Workspace di Drive, pengguna atau aplikasi harus meneruskan kredensial akun yang sama dengan yang mereka gunakan untuk mengakses item di Google Drive.