In diesem Dokument werden wichtige Überlegungen zum Benennen von Dateien und zum Arbeiten mit
wie indexierbarer Text und Miniaturansichten. Informationen zum Einfügen und Abrufen von Dateien finden Sie unter
Die Ressource files
.
Dateinamen und Erweiterungen angeben
Apps sollten beim Einfügen von Dateien in der Eigenschaft „title“ eine Dateiendung angeben
mit der Google Drive API. Ein Vorgang zum Einfügen einer JPEG-Datei sollte
etwa "name": "cat.jpg"
in den Metadaten angeben.
Nachfolgende GET
-Antworten können das schreibgeschützte Attribut fileExtension
enthalten
wird mit der Erweiterung gefüllt, die ursprünglich in der Eigenschaft name
angegeben wurde. Wenn ein
Google Drive-Nutzer möchte eine Datei herunterladen oder wann die Datei heruntergeladen wird
über den Synchronisierungsclient erstellt Drive einen vollständigen Dateinamen (mit
Erweiterung) basierend auf dem Titel. Falls die Erweiterung fehlt,
Drive versucht, die Erweiterung anhand der
MIME-Typ.
Indexierbaren Text speichern
Drive indexiert Dokumente für die Suche automatisch, wenn es
den Dateityp erkennt, einschließlich Textdokumenten, PDFs, Bildern mit Text und
und andere gängige Typen. Wenn Ihre App andere Dateitypen speichert, z. B. Zeichnungen,
Videos und Verknüpfungen), können Sie die Auffindbarkeit verbessern, indem Sie
Indexierbarer Text im Feld contentHints.indexableText
der Datei ein.
Indexierbarer Text wird als HTML indexiert. Wenn Sie den indexierbaren Textstring speichern
<section attribute="value1">Here's some text</section>
, dann:
Text“ ist indexiert, aber „value1“ nicht. Aus diesem Grund kann XML als
indexierbar gespeichert werden,
ist nicht so nützlich wie das Speichern von HTML.
Beachten Sie beim Festlegen von indexableText
auch Folgendes:
- Die Größenbeschränkung für
contentHints.indexableText
beträgt 128 KB. - Erfassen Sie die Schlüsselbegriffe und -konzepte, nach denen Nutzer suchen sollen.
- Versuchen Sie nicht, Text nach Wichtigkeit zu sortieren, effizient für Sie.
- Ihre Anwendung sollte den Indexierbaren Text bei jedem Speichervorgang aktualisieren.
- Achten Sie darauf, dass sich der Text auf den Inhalt oder die Metadaten der Datei bezieht.
Dieser letzte Punkt mag offensichtlich erscheinen, ist aber wichtig. Es ist keine gute Idee, Fügen Sie häufig gesuchte Begriffe hinzu, damit eine Datei in den Suchergebnissen erscheint. Dieses kann Nutzende frustrieren und sie sogar motivieren, die Datei zu löschen.
Thumbnails hochladen
Drive erstellt automatisch Miniaturansichten für viele gängige Dateien. z. B. Google Docs, Google Tabellen und Google Präsentationen. Anhand von Miniaturansichten können Nutzer Drive-Dateien besser erkennen.
Für Dateitypen, für die in Google Drive keine Standardminiaturansicht erstellt werden kann
eine von Ihrer Anwendung generierte Miniaturansicht. Währenddessen
erstellen oder aktualisieren möchten, laden Sie eine Miniaturansicht hoch, indem Sie die
Feld contentHints.thumbnail
in der Ressource files
Im Detail:
- Geben Sie für das Feld „
contentHints.thumbnail.image
“ die URL und den Dateinamen an base64-codiertes Bild (siehe RFC 4648-Abschnitt 5). - Legen Sie im Feld
contentHints.thumbnail.mimeType
den entsprechenden MIME-Typ fest für das Thumbnail auswählen.
Wenn Google Drive eine Miniaturansicht aus der Datei erstellen kann, wird die Methode automatisch generierte und ignoriert alle von Ihnen hochgeladenen Daten. Wenn nicht erstellt ein Thumbnail, es wird die von Ihnen angegebene verwendet.
Für Thumbnails gelten folgende Regeln:
- Der Upload kann im PNG-, GIF- oder JPG-Format erfolgen.
- Die empfohlene Breite beträgt 1.600 Pixel.
- Die Mindestbreite beträgt 220 Pixel.
- Die maximale Dateigröße beträgt 2 MB.
- Sie sollten von Ihrer App bei jedem Speichervorgang aktualisiert werden.
Weitere Informationen finden Sie in der Ressource files
.
Miniaturansichten abrufen
Sie können Metadaten, einschließlich Miniaturansichten, für Drive-Dateien abrufen.
Informationen zu den Thumbnails findest du im Feld thumbnailLink
der
Ressource files
.
Ein bestimmtes Thumbnail zurückgeben
Das folgende Codebeispiel zeigt eine
Methodenanfrage files.get
mit
mehrere Felder als Abfrageparameter für die Rückgabe der thumbnailLink
-Metadaten
einer bestimmten Datei. Weitere Informationen finden Sie unter Bestimmte Felder für eine
Datei.
GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink
Ersetzen Sie FILE_ID durch die fileId
der Datei, die Sie löschen möchten.
finden.
Falls verfügbar, gibt die Anfrage eine kurzlebige URL zur Miniaturansicht der Datei zurück.
In der Regel bleibt der Link mehrere Stunden bestehen. Das Feld wird nur ausgefüllt, wenn
kann die anfragende App auf den Inhalt der Datei zugreifen. Wenn die Datei nicht freigegeben ist
öffentlich ist, muss die in thumbnailLink
zurückgegebene URL mit einem
Anfrage mit Anmeldedaten.
Liste mit Miniaturansichten zurückgeben
Das folgende Codebeispiel zeigt eine
Methodenanfrage files.list
mit
mehrere Felder als Abfrageparameter für die Rückgabe der thumbnailLink
-Metadaten
eine Liste von Dateien. Weitere Informationen finden Sie unter Nach Dateien suchen und
Ordner.
GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)
Um die Suchergebnisse auf einen bestimmten Dateityp zu beschränken, wenden Sie einen Abfragestring auf MIME-Typ festlegen. Das folgende Codebeispiel zeigt, wie Sie den Traffic in Google Tabellen-Dateien umwandeln. Weitere Informationen zu MIME-Typen finden Sie unter MIME wird in Google Workspace und Google Drive unterstützt .
GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)