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 dokümanların alaka düzeyini daha iyi belirlemesine olanak tanır. Küçük resimler aşağıdaki özelliklere sahiptir:

  • 1024 piksel genişlik.
  • Google Workspace dosya küçük resimlerinin URL'si ACL ile korunuyor. Diğer dosya türlerinin URL'si ACL korumalı değil
  • URL'lerin süresi 5 dakika sonra dolar.
  • 50 MB'tan büyük dosyalar için küçük resim oluşturulmaz.
  • Küçük resim oluşturulamazsa yer tutucu simgesi kullanılır. Bir Google Workspace öğesi için küçük resim oluşturulamazsa küçük resim URL'sinde "404 Bulunamadı" mesajı döndürülür. Uygulamanız bu davranışı ele almalıdır.

Küçük resimler, Google Workspace doküman türleri (Dokümanlar, E-Tablolar, Slaytlar vb.) gibi küçük resimleri doğal olarak destekleyen Google Drive dosyaları için otomatik olarak 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)
  • Hiper Metin 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 Platform projeniz hizmet hesabı kimlik bilgileri içeriyor. Ancak küçük resim URL'lerini etkinleştirmek için bir 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, bir veri kaynağını almak ve güncellemek için bu kimlik bilgilerini 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ımla ilgili bilgi için Google Cloud Search API'ye erişimi yapılandırma başlıklı makalenin 1. ve 2. adımlarına bakın.
  2. API anahtarı oluşturma:
    1. Google Cloud Console'da Kimlik Bilgileri Oluştur açılır menüsünü 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ı" bölümünde görünür.
  3. Web uygulaması kimlik bilgileri oluşturun. Yönlendirme URI'si olarak https://developers.google.com/oauthplayground adresini kullanın. . Bu kimlik bilgilerini oluşturma adımları için Web uygulaması kimlik bilgileri oluşturma (istemci tarafı JavaScript) başlıklı makaleyi inceleyin.
  4. OAuth 2.0 Playground'ta OAuth 2.0 Yapılandırması'nı tıklayın.
  5. Kendi kimlik bilgilerinizi kullanın'ı 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. (isteğe bağlı) Yetkilendirme ekranı gösterilirse Kabul et'i tıklayın.
  10. Jetonlar için yetkilendirme kodu değiş tokuşu yap'ı tıklayın. Bir jeton döndürülür.
  11. Küçük resim kontrollerini etkinleştirmek istediğiniz veri kaynağını belirleyin.

  12. Veri kaynağının kimliğini almak için settings.datasources.get işlevini çağırı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 elde edilir).
    • YOUR_ACCESS_TOKEN, projenizin OAuth 2.0 erişim jetonudur (10. adımdan elde edilir).

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

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

  13. Veri kaynağı için küçük resim URL'lerini etkinleştirmek üzere returnThumbnailUrls true olarak ayarlanmışken setting.datasource.update çağrısı yapı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 elde edilir).
    • YOUR_ACCESS_TOKEN, projenizin OAuth 2.0 erişim jetonudur (10. adımdan elde edilir).
    • 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
  }
}

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

Cloud Search Platform projeniz hizmet hesabı kimlik bilgileri içeriyor. Ancak küçük resim URL'lerini etkinleştirmek için bir 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, arama başvurusu almak ve güncellemek için bu kimlik bilgilerini 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ımla ilgili bilgi için Google Cloud Search API'ye erişimi yapılandırma başlıklı makalenin 1. ve 2. adımlarına bakın.
  2. API anahtarı oluşturma:
    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ı" bölümünde görünür.
  3. Web uygulaması kimlik bilgileri oluşturun. Yönlendirme URI'si olarak https://developers.google.com/oauthplayground adresini kullanın. . Bu kimlik bilgilerini oluşturma adımları için Web uygulaması kimlik bilgileri oluşturma (istemci tarafı JavaScript) başlıklı makaleyi inceleyin.
  4. OAuth 2.0 Playground'ta OAuth 2.0 Yapılandırması'nı tıklayın.
  5. Kendi kimlik bilgilerinizi kullanın'ı 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. (isteğe bağlı) Yetkilendirme ekranı gösterilirse Kabul et'i tıklayın.
  10. Jetonlar için yetkilendirme kodu değiş tokuşu yap'ı 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 almak için settings.searchapplications.get işlevini çağırı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 elde edilir).
    • YOUR_ACCESS_TOKEN, projenizin OAuth 2.0 erişim jetonudur (10. adımdan elde edilir).

    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 true olarak ayarlanmışken setting.searchapplications.update işlevini ç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 elde edilir).
    • YOUR_ACCESS_TOKEN, projenizin OAuth 2.0 erişim jetonudur (10. adımdan elde edilir).
    • 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

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