Küçük resimleri etkinleştir

Arama sonuçları tarafından döndürülen dokümanlar için küçük resimler gösterilir. Küçük resimler, kullanıcının döndürülen belgelerin alaka düzeyini daha iyi belirlemesini sağlar. Küçük resimler şu özelliklere sahiptir:

  • 1024 piksel genişlik.
  • Google Workspace dosya küçük resimlerinin URL'si EKL ile korunuyor. Diğer dosya türlerinin URL'si
  • URL'lerin süresi 5 dakika sonra dolar.
  • 50 MB'tan büyük dosyalar için küçük resimler oluşturulmaz.
  • Küçük resim oluşturulamıyorsa yer tutucu simgesi kullanılır. Bir Google Workspace öğesinin küçük resmi oluşturulamıyorsa küçük resim URL'si "404 Bulunamadı" değerini döndürür. Uygulamanızın bu davranışı ele alması gerekir.

Google Workspace doküman türleri (Dokümanlar, E-Tablolar, Slaytlar vs.) gibi küçük resimleri doğal olarak destekleyen Google Drive dosyaları için otomatik olarak küçük resimler oluşturulur. Ayrıca Cloud Search, aşağıdaki dosya türleri için otomatik olarak küçük resimler oluşturur:

  • Microsoft Word (DOC)
  • Microsoft Word (DOCX)
  • Microsoft Excel (XLS)
  • Microsoft Excel (XLSX)
  • Microsoft PowerPoint (PPT)
  • Microsoft PowerPoint (PPTX)
  • Adobe Taşınabilir Belge Biçimi (PDF)
  • Zengin Metin Biçimi (RTF)
  • Metin Biçimi (TXT)
  • HyperText Biçimlendirme Dili (HTML)
  • Genişletilebilir Biçimlendirme Dili (XML)

Küçük resimler yalnızca veri kaynağı ve arama uygulamalarında etkinleştirilen öğeler için döndürülür.

Bir veri kaynağı için küçük resim URL'lerini etkinleştirme

Cloud Search platformu projeniz hizmet hesabı kimlik bilgileri içeriyor. Ancak küçük resim URL'lerini etkinleştirmek için API anahtarı ve web uygulaması kimlik bilgileri oluşturmanız ve erişim jetonu almak için web uygulaması kimlik bilgilerini kullanmanız gerekir. Son olarak, bu kimlik bilgilerini bir veri kaynağı almak ve güncellemek için kullanırsınız.

  1. Henüz yapmadıysanız uygulamanız için bir proje oluşturun veya seçin ve API'yi etkinleştirin. Bu iki adım hakkında bilgi için Google Cloud Search API'ye erişimi yapılandırma bölümünün 1. ve 2. adımlarına bakın.
  2. API anahtarı oluşturun:
    1. Google Cloud Console'da, Kimlik Bilgisi Oluştur açılır listesini tıklayıp API Anahtarı'nı seçin. "API Anahtarı oluşturuldu" sayfası görünür.
    2. API anahtarını not edin.
    3. Kapat'ı tıklayın. Yeni oluşturulan kimlik bilgisi "API Anahtarları" altında görünür.
  3. Web uygulaması kimlik bilgileri oluşturma. Yönlendirme URI'si olarak https://developers.google.com/oauthplayground kullanın. . Bu kimlik bilgilerini oluşturma adımları için Web uygulaması kimlik bilgileri (istemci tarafı JavaScript) oluşturma bölümüne bakın.
  4. OAuth 2.0 Playground'da OAuth 2.0 Yapılandırması'nı tıklayın.
  5. Kendi kimlik bilgilerinizi kullanın seçeneğini işaretleyin.
  6. 3. adımda oluşturulan istemci kimliğini ve istemci gizli anahtarını girin.
  7. Kapsamlar alanına https://www.googleapis.com/auth/cloud_search.settings yazın ve API'leri Yetkilendir'i tıklayın.
  8. (isteğe bağlı) Oturum açma ekranı gösterilirse kullanılacak hesabı seçin.
  9. (İsteğe bağlı) Yetkilendirme ekranı gösterilirse Kabul et'i tıklayın.
  10. Jetonlar için yetkilendirme kodu değiş tokuşu yap seçeneğini tıklayın. Bir jeton döndürülür.
  11. Küçük resim denetimlerini etkinleştirmek istediğiniz veri kaynağını belirleyin.

  12. Veri kaynağının kimliğini öğrenmek için settings.datasources.get numaralı telefonu arayın:

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

    Burada:

    • datasource_id, alınacak veri kaynağının adıdır.
    • YOUR_API_KEY, projenizin API anahtarıdır (2. adımdan alınmıştır).
    • YOUR_ACCESS_TOKEN, projeniz için OAuth 2.0 erişim jetonudur (10. adımdan alınır).

    Bu komutun başarılı sonucu şuna benzer:

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

  13. Veri kaynağının küçük resim URL'lerini etkinleştirmek için returnThumbnailUrls ayarı true olarak belirlenmiş setting.datasource.update çağırın:

    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

    Burada:

    • datasource_id, alınacak veri kaynağının kimliğidir.
    • YOUR_API_KEY, projenizin API anahtarıdır (2. adımdan alınmıştır).
    • YOUR_ACCESS_TOKEN, projeniz için OAuth 2.0 erişim jetonudur (10. adımdan alınır).
    • DataSource_DisplayName, önceki cURL komutundan döndürülen görünen addır.
    • "returnThumbnailsUrls":true küçük resimleri etkinleştirir.

    Bu komutun başarılı sonucu şuna benzer:

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

Bir arama uygulaması için küçük resim URL'lerini etkinleştirme

Cloud Search platformu projeniz hizmet hesabı kimlik bilgileri içeriyor. Ancak küçük resim URL'lerini etkinleştirmek için API anahtarı ve web uygulaması kimlik bilgileri oluşturmanız ve erişim jetonu almak için web uygulaması kimlik bilgilerini kullanmanız gerekir. Son olarak, bu kimlik bilgilerini bir arama uygulamasını edinmek ve güncellemek için kullanırsınız.

  1. Henüz yapmadıysanız uygulamanız için bir proje oluşturun veya seçin ve API'yi etkinleştirin. Bu iki adım hakkında bilgi için Google Cloud Search API'ye erişimi yapılandırma bölümünün 1. ve 2. adımlarına bakın.
  2. API anahtarı oluşturun:
    1. Cloud Console'da, Kimlik Bilgileri Oluştur açılır listesini tıklayın ve API Anahtarı'nı seçin. "API Anahtarı oluşturuldu" sayfası görünür.
    2. API anahtarını not edin.
    3. Kapat'ı tıklayın. Yeni oluşturulan kimlik bilgisi "API Anahtarları" altında görünür.
  3. Web uygulaması kimlik bilgileri oluşturma. Yönlendirme URI'si olarak https://developers.google.com/oauthplayground kullanın. . Bu kimlik bilgilerini oluşturma adımları için Web uygulaması kimlik bilgileri (istemci tarafı JavaScript) oluşturma bölümüne bakın.
  4. OAuth 2.0 Playground'da OAuth 2.0 Yapılandırması'nı tıklayın.
  5. Kendi kimlik bilgilerinizi kullanın seçeneğini işaretleyin.
  6. 3. adımda oluşturulan istemci kimliğini ve istemci gizli anahtarını girin.
  7. Kapsamlar alanına https://www.googleapis.com/auth/cloud_search.settings yazın ve API'leri Yetkilendir'i tıklayın.
  8. (isteğe bağlı) Oturum açma ekranı gösterilirse kullanılacak hesabı seçin.
  9. (İsteğe bağlı) Yetkilendirme ekranı gösterilirse Kabul et'i tıklayın.
  10. Jetonlar için yetkilendirme kodu değiş tokuşu yap seçeneğini tıklayın. Bir jeton döndürülür.
  11. Küçük resim denetimlerini etkinleştirmek istediğiniz arama uygulamasını tanımlayın.

  12. Arama uygulamasının kimliğini öğrenmek için settings.searchapplications.get numaralı telefonu arayın:

    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

    Burada:

    • , alınacak arama uygulamasının kimliğidir.
    • YOUR_API_KEY, projenizin API anahtarıdır (2. adımdan alınmıştır).
    • YOUR_ACCESS_TOKEN, projeniz için OAuth 2.0 erişim jetonudur (10. adımdan alınır).

    Bu komutun başarılı sonucu şuna benzer:

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

  13. Arama uygulaması için küçük resim URL'lerini etkinleştirmek üzere returnResultThumbnailUrls ayarı true olarak belirlenmiş setting.searchapplications.update çağırın:

    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

    Burada:

    • , alınacak arama uygulamasının kimliğidir.
    • YOUR_API_KEY, projenizin API anahtarıdır (2. adımdan alınmıştır).
    • YOUR_ACCESS_TOKEN, projeniz için OAuth 2.0 erişim jetonudur (10. adımdan alınır).
    • SearchApp_DisplayName, önceki cURL komutundan döndürülen görünen addır.
    • "returnResultThumbnailUrls":true küçük resimleri etkinleştirir.

    Bu komutun başarılı sonucu şuna benzer:

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

Küçük resimlere erişme

Kullanıcı veya uygulamanın Drive'daki bir Google Workspace dosyasının küçük resmine erişmek için, Google Drive'daki öğeye erişmek üzere kullandığı hesap kimlik bilgilerini aynı şekilde aktarması gerekir.