Küçük resimleri etkinleştir

Küçük resimler, kullanıcıların alakalı arama sonuçlarını belirlemesine yardımcı olur. Bu türler şu özelliklere sahiptir:

  • 1.024 piksel genişliğinde olmalıdır.
  • Google Workspace dosya küçük resimlerinin URL'leri, erişim kontrol listesi (ACL) ile korunur. Diğer dosya türleri desteklenmez.
  • URL'lerin süresi 5 dakika sonra dolar.
  • Üretim için maksimum dosya boyutu 50 MB'tır.
  • Üretim başarısız olursa Cloud Search, yer tutucu simge döndürür. Google Workspace öğeleri için URL, "404 Bulunamadı" hatasını döndürüyor. Uygulamanız bunu işlemelidir.

Google Drive, Dokümanlar, E-Tablolar ve Slaytlar gibi desteklenen türler için otomatik olarak küçük resimler oluşturur. Cloud Search ayrıca aşağıdaki öğeler için küçük resimler oluşturur:

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

Cloud Search, yalnızca veri kaynağı ve arama uygulaması için küçük resimleri etkinleştirdiğinizde öğelerin küçük resimlerini döndürür.

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

Küçük resim URL'lerini etkinleştirmek için bir API anahtarı ve web uygulaması kimlik bilgileri oluşturun. Veri kaynağınızı güncellemek için erişim jetonu almak üzere bunları kullanın.

  1. Proje oluşturun veya seçin ve API'yi etkinleştirin. Cloud Search API'ye erişimi yapılandırma başlıklı makaleyi inceleyin.
  2. Google Cloud Console'da bir API anahtarı oluşturun ve değeri not edin.
  3. Web uygulaması kimlik bilgileri oluşturun. Yönlendirme URI'si olarak https://developers.google.com/oauthplayground adresini kullanın. Kimlik bilgisi oluşturma başlıklı makaleyi inceleyin.
  4. OAuth 2.0 Playground'da OAuth 2.0 Yapılandırması'nı açın.
  5. Kendi kimlik bilgilerinizi kullanın'ı seçin ve istemci kimliğinizi ve gizli anahtarınızı girin.
  6. Kapsamlar alanına https://www.googleapis.com/auth/cloud_search.settings girin ve API'leri yetkilendir'i tıklayın.
  7. Yetkilendirme kodunu jetonlarla değiştirin.
  8. Veri kaynağı kimliğinizi 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
    
  9. returnThumbnailUrls ayarı true olarak belirlenmişken settings.datasources.update ile görüşme:

    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
    

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

Arama uygulamanızda küçük resimleri de etkinleştirmeniz gerekir.

  1. Önceki bölümde açıklanan yöntemi kullanarak bir API anahtarı ve erişim jetonu alın.
  2. Uygulama kimliğinizi almak için settings.searchapplications.get numaralı telefonu arayın:

    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. returnResultThumbnailUrls ile settings.searchapplications.update numaralı telefonu arama true olarak ayarlandı:

    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
    

Küçük resimlere erişme

Bir Drive dosyasının küçük resmine erişmek için kullanıcının veya uygulamanın, orijinal öğeye erişmek için kullanılan hesap kimlik bilgilerini kullanması gerekir.