Diese Seite wurde von der Cloud Translation API übersetzt.

Miniaturansichten aktivieren

Für Dokumente, die in den Suchergebnissen zurückgegeben werden, werden Miniaturansichten angezeigt. Mithilfe von Thumbnails können Nutzer die Relevanz der zurückgegebenen Dokumente besser einschätzen. Thumbnails haben die folgenden Eigenschaften:

Breite von 1.024 Pixel.
Die URL für Google Workspace-Dateiminiaturen ist durch ACLs geschützt. Die URL für andere Dateitypen ist nicht durch ACLs geschützt
URLs laufen nach 5 Minuten ab.
Für Dateien, die größer als 50 MB sind, werden keine Vorschaubilder generiert.
Wenn keine Miniaturansicht generiert werden kann, wird ein Platzhaltersymbol verwendet. Wenn für ein Google Workspace-Element keine Miniaturansicht generiert werden kann, gibt die Miniaturansichts-URL „404 Not Found“ zurück. Ihre Anwendung muss mit diesem Verhalten umgehen können.

Miniaturansichten werden automatisch für Google Drive-Dateien erstellt, die Miniaturansichten unterstützen, z. B. Google Workspace-Dokumenttypen (Docs, Sheets, Präsentationen usw.). Außerdem erstellt Cloud Search automatisch Thumbnails 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)

Thumbnails werden nur für Elemente zurückgegeben, für die sie in der Datenquelle und den Suchanwendungen aktiviert sind.

Miniaturansichts-URLs für eine Datenquelle aktivieren

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

Falls noch nicht geschehen, erstellen oder wählen Sie ein Projekt für Ihre App aus und aktivieren Sie die API. Informationen zu diesen beiden Schritten finden Sie in Schritt 1 und 2 unter Zugriff auf die Google Cloud Search API konfigurieren.
API-Schlüssel erstellen:
1. Klicken Sie in der Google Cloud Console auf das Drop-down-Menü „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 Webanwendungen erstellen Verwenden Sie https://developers.google.com/oauthplayground als Weiterleitungs-URI. . Eine entsprechende Anleitung 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 „Scopes“ (Bereiche) https://www.googleapis.com/auth/cloud_search.settings ein und klicken Sie auf Authorize APIs (APIs autorisieren).
Optional: Wenn ein 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 die Datenquelle, für die Sie die Miniaturansicht-Steuerelemente 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 (aus Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (aus Schritt 10).

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 mit returnThumbnailUrls auf true auf, 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 Datenquelle, die abgerufen werden soll.
YOUR_API_KEY ist der API-Schlüssel für Ihr Projekt (aus Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (aus Schritt 10).
DataSource_DisplayName ist der Anzeigename, der vom vorherigen cURL-Befehl zurückgegeben wurde.
"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

Falls noch nicht geschehen, erstellen oder wählen Sie ein Projekt für Ihre App aus und aktivieren Sie die API. Informationen zu diesen beiden Schritten finden Sie in Schritt 1 und 2 unter Zugriff auf die Google Cloud Search API konfigurieren.
API-Schlüssel erstellen:
1. Klicken Sie in der Cloud Console auf das Drop-down-Menü „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 Webanwendungen erstellen Verwenden Sie https://developers.google.com/oauthplayground als Weiterleitungs-URI. . Eine entsprechende Anleitung 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 „Scopes“ (Bereiche) https://www.googleapis.com/auth/cloud_search.settings ein und klicken Sie auf Authorize APIs (APIs autorisieren).
Optional: Wenn ein 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 die Suchanwendung, für die Sie die Miniaturansicht-Steuerelemente aktivieren möchten.

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

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 Suchanwendung, die abgerufen werden soll.
YOUR_API_KEY ist der API-Schlüssel für Ihr Projekt (aus Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (aus Schritt 10).

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 mit returnResultThumbnailUrls auf, das auf true festgelegt 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 Suchanwendung, die abgerufen werden soll.
YOUR_API_KEY ist der API-Schlüssel für Ihr Projekt (aus Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (aus Schritt 10).
SearchApp_DisplayName ist der Anzeigename, der vom vorherigen cURL-Befehl zurückgegeben wurde.
"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 Thumbnails zugreifen

Wenn ein Nutzer oder eine Anwendung auf eine Miniaturansicht einer Google Workspace-Datei in Drive zugreifen möchte, muss er oder sie dieselben Anmeldedaten angeben, die auch für den Zugriff auf das Element in Google Drive verwendet werden.

Miniaturansichten aktivieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Miniaturansichts-URLs für eine Datenquelle aktivieren

Miniaturansicht-URLs für eine Suchanwendung aktivieren

Auf Thumbnails zugreifen

Miniaturansichten aktivieren