Miniaturansichten aktivieren

Thumbnails helfen Nutzern, relevante Suchergebnisse zu erkennen. Sie haben folgende Eigenschaften:

  • Breite: 1.024 Pixel.
  • URLs für Google Workspace-Dateiminiaturen sind durch ACLs geschützt. Andere Dateitypen nicht.
  • URLs laufen nach 5 Minuten ab.
  • Die maximale Dateigröße für die Generierung beträgt 50 MB.
  • Wenn die Generierung fehlschlägt, gibt Cloud Search ein Platzhaltersymbol zurück. Für Google Workspace-Elemente gibt die URL „404 Not Found“ zurück. Ihre Anwendung muss damit umgehen können.

In Google Drive werden automatisch Miniaturansichten für unterstützte Typen wie Dokumente, Tabellen und Präsentationen erstellt. Cloud Search generiert auch Miniaturansichten für:

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

Cloud Search gibt nur dann Vorschaubilder für Elemente zurück, wenn Sie Vorschaubilder für die Datenquelle und die Suchanwendung aktivieren.

Miniaturansichts-URLs für eine Datenquelle aktivieren

Wenn Sie Miniaturansichts-URLs aktivieren möchten, müssen Sie einen API-Schlüssel und Anmeldedaten für Webanwendungen erstellen. Mit diesen können Sie ein Zugriffstoken zum Aktualisieren Ihrer Datenquelle abrufen.

  1. Erstellen oder wählen Sie ein Projekt aus und aktivieren Sie die API. Weitere Informationen finden Sie unter Zugriff auf die Cloud Search API konfigurieren.
  2. Erstellen Sie in der Google Cloud Console einen API-Schlüssel und notieren Sie sich den Wert.
  3. Anmeldedaten für Webanwendungen erstellen Verwenden Sie https://developers.google.com/oauthplayground als Weiterleitungs-URI. Weitere Informationen finden Sie unter Anmeldedaten erstellen.
  4. Öffnen Sie im OAuth 2.0 Playground die OAuth 2.0-Konfiguration .
  5. Wählen Sie Eigene Anmeldedaten verwenden aus und geben Sie Ihre Client-ID und Ihren Clientschlüssel ein.
  6. Geben Sie https://www.googleapis.com/auth/cloud_search.settings in das Feld „Bereiche“ ein und klicken Sie auf APIs autorisieren.
  7. Tauschen Sie den Autorisierungscode gegen Tokens ein.

  8. Rufen Sie settings.datasources.get auf, um die ID Ihrer 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

  9. Rufen Sie settings.datasources.update auf, wobei returnThumbnailUrls auf true gesetzt ist:

    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

Miniaturansicht-URLs für eine Suchanwendung aktivieren

Außerdem müssen Sie Miniaturansichten in Ihrer Suchanwendung aktivieren.

  1. Rufen Sie einen API-Schlüssel und ein Zugriffstoken mit derselben Methode ab, die im vorherigen Abschnitt beschrieben wird.

  2. Rufen Sie settings.searchapplications.get auf, um Ihre Anwendungs-ID zu erhalten:

    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. Rufen Sie settings.searchapplications.update auf, wobei returnResultThumbnailUrls auf true gesetzt ist:

    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

Auf Thumbnails zugreifen

Um auf ein Miniaturbild für eine Drive-Datei zuzugreifen, müssen der Nutzer oder die Anwendung dieselben Kontoanmeldedaten verwenden, die auch für den Zugriff auf das Originalelement verwendet wurden.