Diese Seite wurde von der Cloud Translation API übersetzt.

Miniaturansichten aktivieren

Miniaturansichten werden für Dokumente angezeigt, die in den Suchergebnissen zurückgegeben werden. Thumbnails erlauben damit der Nutzer die Relevanz zurückgegebener Dokumente besser erkennen kann. Thumbnails haben die folgenden Merkmale haben:

Breite: 1.024 Pixel.
Die URL für die Miniaturansichten von Google Workspace-Dateien ist ACL-geschützt. Die URL für andere Dateitypen nicht durch 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 ein Thumbnail für ein Google Workspace-Element nicht generiert werden kann, wird die URL der Miniaturansicht zurückgegeben „404 Nicht gefunden.“ Ihre Anwendung muss mit diesem Verhalten umgehen können.

Miniaturansichten werden automatisch für Google Drive-Dateien erstellt, unterstützen Miniaturansichten wie Google Workspace-Dokumenttypen (Docs, Tabellen, Präsentationen usw.). Außerdem werden in 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)
Erweiterbare Auszeichnungssprache (XML)

Miniaturansichten werden nur für Elemente zurückgegeben, deren Datenquelle und Suchanwendungen Sie verwenden. aktiviert lassen.

Miniaturansicht-URLs für eine Datenquelle aktivieren

Ihr Projekt für die Cloud Search-Plattform enthält Anmeldedaten für ein Dienstkonto. Zum Aktivieren von Miniaturansicht-URLs müssen Sie jedoch ein API-Schlüssel und Anmeldedaten für Webanwendung und verwenden Sie die Anmeldedaten für die Webanwendung um ein Zugriffstoken zu erhalten. Mit diesen Anmeldedaten rufen Sie schließlich Datenquelle verwendet werden.

Erstellen Sie ein Projekt für Ihre App oder wählen Sie eines aus und aktivieren Sie es, falls Sie dies noch nicht getan haben. die API verwenden. Weitere Informationen zu diesen beiden Schritten finden Sie in den Schritten 1 und 2 der Konfigurieren Sie den Zugriff auf die Google Cloud Search API.
Erstellen Sie einen API-Schlüssel: <ph type="x-smartling-placeholder">
1. Klicken Sie in der Google Cloud Console auf die Drop-down-Liste „Anmeldedaten erstellen“ und und wählen Sie „API-Schlüssel“ aus. „API-Schlüssel erstellt“ 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 https://developers.google.com/oauthplayground verwenden als Weiterleitungs-URI. . Die Schritte zum Erstellen dieser Anmeldedaten finden Sie unter Anmeldedaten für Webanwendung erstellen (clientseitiges JavaScript)
Im OAuth 2.0 Playground: Klicken Sie auf OAuth 2.0-Konfiguration .
Klicken Sie das Kästchen Use your own credentials (Eigene Anmeldedaten verwenden) an.
Geben Sie die in Schritt 3 generierte Client-ID und den Clientschlüssel ein.
Geben Sie im Feld mit den Bereichen 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 verwendet werden soll.
Optional: Wenn ein Autorisierungsbildschirm angezeigt wird, klicken Sie auf Akzeptieren.
Klicken Sie auf Autorisierungscode für Tokens austauschen. Ein Token wird zurückgegeben.
Wählen Sie die Datenquelle aus, für die Sie die Miniaturansicht aktivieren möchten. Steuerelementen.

settings.datasources.get anrufen um die ID der Datenquelle zu erhalten:

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 (siehe Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (erhalten). wie in Schritt 10 beschrieben).

Das erfolgreiche Ergebnis dieses Befehls sieht in etwa so aus:

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

setting.datasource.update anrufen wobei returnThumbnailUrls auf true gesetzt ist, um Miniaturansicht-URLs für die Daten zu aktivieren Quelle:

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 (siehe Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (erhalten). wie in Schritt 10 beschrieben).
DataSource_DisplayName ist der vom vorherigen zurückgegebene Anzeigename. cURL-Befehl.
"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 App oder wählen Sie eines aus und aktivieren Sie es, falls Sie dies noch nicht getan haben. die API verwenden. Weitere Informationen zu diesen beiden Schritten finden Sie in den Schritten 1 und 2 der Konfigurieren Sie den Zugriff auf die Google Cloud Search API.
Erstellen Sie einen API-Schlüssel: <ph type="x-smartling-placeholder">
1. Klicken Sie in der Cloud Console auf die Drop-down-Liste „Anmeldedaten erstellen“ und und wählen Sie „API-Schlüssel“ aus. „API-Schlüssel erstellt“ 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 https://developers.google.com/oauthplayground verwenden als Weiterleitungs-URI. . Die Schritte zum Erstellen dieser Anmeldedaten finden Sie unter Anmeldedaten für Webanwendung erstellen (clientseitiges JavaScript)
Im OAuth 2.0 Playground: Klicken Sie auf OAuth 2.0-Konfiguration .
Klicken Sie das Kästchen Use your own credentials (Eigene Anmeldedaten verwenden) an.
Geben Sie die in Schritt 3 generierte Client-ID und den Clientschlüssel ein.
Geben Sie im Feld mit den Bereichen 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 verwendet werden soll.
Optional: Wenn ein Autorisierungsbildschirm angezeigt wird, klicken Sie auf Akzeptieren.
Klicken Sie auf Autorisierungscode für Tokens austauschen. Ein Token wird zurückgegeben.
Identifizieren Sie die Suchanwendung, für die Sie die Miniaturansichten aktivieren möchten.

settings.searchapplications.get anrufen 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 (siehe Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (erhalten). wie in Schritt 10 beschrieben).

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"
     }
   }
 ]
}

setting.searchapplications.update anrufen wobei returnResultThumbnailUrls auf true gesetzt ist, um Miniaturansichts-URLs für die Suchanwendung:

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 (siehe Schritt 2).
YOUR_ACCESS_TOKEN ist das OAuth 2.0-Zugriffstoken für Ihr Projekt (erhalten). wie in Schritt 10 beschrieben).
SearchApp_DisplayName ist der vom vorherigen zurückgegebene Anzeigename. cURL-Befehl.
"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

Um auf eine Miniaturansicht einer Google Workspace-Datei in Drive zuzugreifen, muss der Nutzer oder müssen dieselben Anmeldedaten übergeben, mit denen sie auch auf den in Google Drive hochladen.