Miniaturansichten aktivieren

Miniaturansichten helfen Nutzern, relevante Suchergebnisse zu erkennen. Sie haben folgende Merkmale:

  • Breite von 1024 Pixeln
  • URLs für Google Workspace-Dateiminiaturansichten sind durch ACLs geschützt. Bei anderen Dateitypen ist das nicht der Fall.
  • 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. Bei Google Workspace-Elementen 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 folgende Dateitypen:

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

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

Miniaturansicht-URLs für eine Datenquelle aktivieren

Wenn Sie Miniaturansicht-URLs aktivieren möchten, erstellen Sie einen API-Schlüssel und Anmeldedaten für Webanwendungen. Mit diesen können Sie ein Zugriffstoken abrufen, um Ihre Datenquelle zu aktualisieren.

  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. Erstellen Sie Anmeldedaten für Webanwendungen. 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 Einstellungen für 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 aus.

  8. Rufen Sie settings.datasources.get auf, um Ihre Datenquellen-ID 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 und setzen Sie returnThumbnailUrls auf true:

    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

Sie müssen Miniaturansichten auch in Ihrer Suchanwendung aktivieren.

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

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

    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 und setzen Sie returnResultThumbnailUrls auf true:

    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 Miniaturansichten zugreifen

Wenn ein Nutzer oder eine Anwendung auf eine Miniaturansicht für eine Drive-Datei zugreifen möchte, muss er oder sie dieselben Anmeldedaten verwenden, die für den Zugriff auf das Originalelement verwendet wurden.