Diese Seite wurde von der Cloud Translation API übersetzt.

Miniaturansichten aktivieren

Miniaturansichten werden für Dokumente angezeigt, die von den Suchergebnissen zurückgegeben wurden. Mithilfe von Miniaturansichten können Nutzer die Relevanz der zurückgegebenen Dokumente besser erkennen. Thumbnails haben die folgenden Eigenschaften:

Breite: 1.024 Pixel.
URL für Miniaturansichten von Google Workspace-Dateien ist ACL-geschützt. Die URL für andere Dateitypen ist nicht ACL-geschützt
URLs laufen nach 5 Minuten ab.
Für Dateien, die größer als 50 MB sind, werden keine Miniaturansichten generiert.
Wenn keine Miniaturansicht generiert werden kann, wird ein Platzhaltersymbol verwendet. Wenn keine Miniaturansicht für ein Google Workspace-Element generiert werden kann, gibt die URL der Miniaturansicht „404 – nicht gefunden“ zurück. Ihre Anwendung muss dieses Verhalten verarbeiten können.

Miniaturansichten werden automatisch für Google Drive-Dateien erstellt, die Miniaturansichten unterstützen, z. B. Google Workspace-Dokumenttypen (Google Docs, Google Tabellen, Google Präsentationen usw.). Darüber hinaus erstellt Cloud Search automatisch Miniaturansichten für die folgenden Dateitypen:

Microsoft Word (DOC)
Microsoft Word (DOCX)
Microsoft Excel (XLS)
Microsoft Excel (XLSX)
Microsoft PowerPoint (PPT)
Microsoft PowerPoint (PPTX)
Adobe Portable Document Format (PDF)
Rich-Text-Format (RTF)
Textformat (TXT)
Hypertext Markup Language (HTML)
Extensible Markup Language (XML)

Miniaturansichten werden nur für Elemente zurückgegeben, in deren Datenquelle und Suchanwendung sie aktiviert sind.

Miniaturansicht-URLs für Datenquellen aktivieren

Ihr Cloud Search Platform-Projekt enthält Dienstkonto-Anmeldedaten. Wenn Sie jedoch Miniaturansicht-URLs aktivieren möchten, müssen Sie einen API-Schlüssel und Anmeldedaten für die Webanwendung erstellen und die Anmeldedaten der Webanwendung verwenden, um ein Zugriffstoken zu erhalten. Schließlich verwenden Sie diese Anmeldedaten, um eine Datenquelle abzurufen und zu aktualisieren.

Erstellen Sie ein Projekt für Ihre Anwendung oder wählen Sie eines aus und aktivieren Sie die API, falls noch nicht geschehen. Weitere Informationen zu diesen beiden Schritten finden Sie in den Schritten 1 und 2 unter Zugriff auf die Google Cloud Search API konfigurieren.
Erstellen Sie einen API-Schlüssel:
1. Klicken Sie in der Google Cloud Console auf die Drop-down-Liste „Anmeldedaten erstellen“ und wählen Sie „API-Schlüssel“ aus. Die Seite „API-Schlüssel erstellt“ wird angezeigt.
2. Notieren Sie sich den API-Schlüssel.
3. Klicken Sie auf "Schließen". Die neu erstellten Anmeldedaten werden unter „API-Schlüssel“ angezeigt.
Anmeldedaten für Webanwendung erstellen Verwenden Sie https://developers.google.com/oauthplayground als Weiterleitungs-URI. . Eine Anleitung zum Erstellen dieser Anmeldedaten finden Sie unter Anmeldedaten für Webanwendungen erstellen (clientseitiges JavaScript).
Klicken Sie im OAuth 2.0 Playground auf OAuth 2.0-Konfiguration .
Klicken Sie das Kästchen Eigene Anmeldedaten verwenden an.
Geben Sie die in Schritt 3 generierte Client-ID und den Clientschlüssel ein.
Geben Sie im Feld „Bereiche“ https://www.googleapis.com/auth/cloud_search.settings ein und klicken Sie auf APIs autorisieren.
Optional: Wenn der Anmeldebildschirm angezeigt wird, wählen Sie das Konto aus, das Sie verwenden möchten.
Optional: Wenn ein Autorisierungsbildschirm angezeigt wird, klicken Sie auf Akzeptieren.
Klicken Sie auf Autorisierungscode für Tokens austauschen. Ein Token wird zurückgegeben.
Ermitteln Sie die Datenquelle, für die Sie die Steuerelemente für Miniaturansichten aktivieren möchten.

Rufen Sie settings.datasources.get auf, um die ID der Datenquelle abzurufen:

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

Wobei:

„datasource_id“ ist der Name der abzurufenden Datenquelle.
YOUR_API_KEY ist der API-Schlüssel für Ihr Projekt (ermittelt in Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (in Schritt 10 erhalten).

Das erfolgreiche Ergebnis dieses Befehls sieht in etwa so aus:

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

Rufen Sie setting.datasource.update auf, wobei returnThumbnailUrls auf true gesetzt ist, um Miniaturansicht-URLs für die Datenquelle zu aktivieren:

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

Wobei:

„datasource_id“ ist die ID der abzurufenden Datenquelle.
YOUR_API_KEY ist der API-Schlüssel für Ihr Projekt (ermittelt in Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (in Schritt 10 erhalten).
DataSource_DisplayName ist der vom vorherigen cURL-Befehl zurückgegebene Anzeigename.
"returnThumbnailsUrls":true aktiviert Miniaturansichten.

Das erfolgreiche Ergebnis dieses Befehls sieht in etwa so aus:

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

Miniaturansicht-URLs für eine Suchanwendung aktivieren

Erstellen Sie ein Projekt für Ihre Anwendung oder wählen Sie eines aus und aktivieren Sie die API, falls noch nicht geschehen. Weitere Informationen zu diesen beiden Schritten finden Sie in den Schritten 1 und 2 unter Zugriff auf die Google Cloud Search API konfigurieren.
Erstellen Sie einen API-Schlüssel:
1. Klicken Sie in der Cloud Console auf die Drop-down-Liste „Anmeldedaten erstellen“ und wählen Sie „API-Schlüssel“ aus. Die Seite „API-Schlüssel erstellt“ wird angezeigt.
2. Notieren Sie sich den API-Schlüssel.
3. Klicken Sie auf "Schließen". Die neu erstellten Anmeldedaten werden unter „API-Schlüssel“ angezeigt.
Anmeldedaten für Webanwendung erstellen Verwenden Sie https://developers.google.com/oauthplayground als Weiterleitungs-URI. . Eine Anleitung zum Erstellen dieser Anmeldedaten finden Sie unter Anmeldedaten für Webanwendungen erstellen (clientseitiges JavaScript).
Klicken Sie im OAuth 2.0 Playground auf OAuth 2.0-Konfiguration .
Klicken Sie das Kästchen Eigene Anmeldedaten verwenden an.
Geben Sie die in Schritt 3 generierte Client-ID und den Clientschlüssel ein.
Geben Sie im Feld „Bereiche“ https://www.googleapis.com/auth/cloud_search.settings ein und klicken Sie auf APIs autorisieren.
Optional: Wenn der Anmeldebildschirm angezeigt wird, wählen Sie das Konto aus, das Sie verwenden möchten.
Optional: Wenn ein Autorisierungsbildschirm angezeigt wird, klicken Sie auf Akzeptieren.
Klicken Sie auf Autorisierungscode für Tokens austauschen. Ein Token wird zurückgegeben.
Suchen Sie nach der Suchanwendung, für die Sie die Steuerelemente für Miniaturansichten aktivieren möchten.

Rufen Sie settings.searchapplications.get auf, um die ID der Suchanwendung zu erhalten:

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

Wobei:

ist die ID der abzurufenden Suchanwendung.
YOUR_API_KEY ist der API-Schlüssel für Ihr Projekt (ermittelt in Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (in Schritt 10 erhalten).

Das erfolgreiche Ergebnis dieses Befehls sieht in etwa so aus:

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

Rufen Sie setting.searchapplications.update auf, wobei returnResultThumbnailUrls auf true gesetzt ist, um Miniaturansicht-URLs für die Suchanwendung zu aktivieren:

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

Wobei:

ist die ID der abzurufenden Suchanwendung.
YOUR_API_KEY ist der API-Schlüssel für Ihr Projekt (ermittelt in Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (in Schritt 10 erhalten).
SearchApp_DisplayName ist der vom vorherigen cURL-Befehl zurückgegebene Anzeigename.
"returnResultThumbnailUrls":true aktiviert Miniaturansichten.

Das erfolgreiche Ergebnis dieses Befehls sieht in etwa so aus:

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

Auf Miniaturansichten zugreifen

Für den Zugriff auf die Miniaturansicht einer Google Workspace-Datei in Drive muss der Nutzer oder die Anwendung dieselben Anmeldedaten übergeben, mit denen er auf das Element in Google Drive zugreift.