Küçük resimleri etkinleştir

Arama sonuçlarında 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 belirlemesini sağlar. Küçük resimler aşağıdaki özelliklere sahiptir:

• 1.024 piksel genişlikte olmalıdır.
• Google Workspace dosya küçük resimlerinin URL'si, erişim kontrol listesi (ACL) ile korunur. Diğer dosya türlerinin URL'si ACL ile korunmuyor
• 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 simge kullanılır. Bir Google Workspace öğesi için küçük resim oluşturulamazsa küçük resim URL'si "404 Not Found" (404 Bulunamadı) hatasını döndürür. Uygulamanız bu davranışı işlemelidir.

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 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ştirilmiş öğeler için döndürülür.

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

Cloud Search Platform projeniz hizmet hesabı kimlik bilgilerini 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ımına bakın.
2. API anahtarı oluşturma:
   1. Google 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'da, 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. (İsteğe bağlı) Oturum açma ekranı gösterilirse kullanılacak hesabı seçin.
9. (İsteğe bağlı) Bir 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 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ımda alınır).
    • YOUR_ACCESS_TOKEN, projenizin OAuth 2.0 erişim jetonudur (10. adımda alınmıştır).

    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 setting.datasource.update işlevini returnThumbnailUrls parametresi true olarak ayarlanmış şekilde ç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ımda alınır).
    • YOUR_ACCESS_TOKEN, projenizin OAuth 2.0 erişim jetonudur (10. adımda alınmıştı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
      }
    }
    

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

Cloud Search Platform projeniz hizmet hesabı kimlik bilgilerini 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, bu kimlik bilgilerini kullanarak bir arama uygulaması alıp güncellersiniz.

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ımı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'da, 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. (İsteğe bağlı) Oturum açma ekranı gösterilirse kullanılacak hesabı seçin.
9. (İsteğe bağlı) Bir 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 kontrollerini etkinleştirmek istediğiniz arama uygulamasını belirleyin.

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ımda alınır).
    • YOUR_ACCESS_TOKEN, projenizin OAuth 2.0 erişim jetonudur (10. adımda alınmıştı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 setting.searchapplications.update işlevini returnResultThumbnailUrls parametresi true olarak ayarlanmış şekilde ç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ımda alınır).
    • YOUR_ACCESS_TOKEN, projenizin OAuth 2.0 erişim jetonudur (10. adımda alınmıştı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

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