Zarządzanie metadanymi plików

W tym dokumencie znajdziesz ważne informacje na temat nazewnictwa plików i pracy z takich jak tekst, który można indeksować i miniatury. Aby wstawić i pobrać pliki, zobacz w zasobie files.

Określanie nazw i rozszerzeń plików

Podczas wstawiania plików aplikacje powinny mieć określone rozszerzenie pliku we właściwości tytułu. za pomocą interfejsu Google Drive API. Na przykład operacja wstawienia pliku JPEG powinna określ w metadanych coś w rodzaju "name": "cat.jpg".

Kolejne GET odpowiedzi mogą zawierać właściwość fileExtension tylko do odczytu zawiera rozszerzenie określone pierwotnie we właściwości name. Gdy Użytkownik Dysku Google prosi o pobranie pliku lub gdy plik jest pobierany za pośrednictwem klienta synchronizacji Dysk tworzy pełną nazwę pliku (z rozszerzenie) na podstawie tytułu. Jeśli brakuje rozszerzenia, Dysk próbuje określić rozszerzenie na podstawie Typ MIME.

Zapisz tekst, który można zindeksować

Dysk automatycznie indeksuje dokumenty na potrzeby wyszukiwania, gdy rozpoznaje typ plików, w tym dokumenty tekstowe, pliki PDF, obrazy z tekstem oraz innych popularnych typów. Jeśli Twoja aplikacja zapisuje inne typy plików (np. rysunki, wideo i skróty), możesz zwiększyć wykrywalność, dodając tekst możliwy do zindeksowania w polu contentHints.indexableText pliku.

Indeksowalny tekst jest indeksowany jako HTML. Jeśli zapiszesz ciąg tekstowy możliwy do indeksowania <section attribute="value1">Here's some text</section>, a potem „Oto kilka tekst jest indeksowana, ale wartość „value1” nie jest. Z tego powodu zapisanie pliku XML jako możliwego do indeksowania nie jest tak przydatny jak zapisywanie kodu HTML.

Określając atrybut indexableText, pamiętaj też o tych kwestiach:

  • Limit rozmiaru pliku contentHints.indexableText wynosi 128 KB.
  • Rejestruj kluczowe hasła i koncepcje, które może wyszukiwać użytkownik.
  • Nie próbuj sortować tekstu według ważności, ponieważ robi to robot indeksujący dla Twojej firmy.
  • Aplikacja powinna aktualizować możliwy do indeksowania tekst przy każdym zapisie.
  • Upewnij się, że tekst odnosi się do treści lub metadanych pliku.

Ostatnia kwestia może wydawać się oczywista, ale jest ważna. Nie jest dobrym pomysłem dodać często wyszukiwane hasła, aby wymusić wyświetlanie pliku w wynikach wyszukiwania. Ten może frustrować użytkowników, a nawet skłonić ich do usunięcia pliku.

Prześlij miniatury

Dysk automatycznie generuje miniatury wielu popularnych plików takich jak Dokumenty, Arkusze i Prezentacje Google. Miniatury pomagają użytkownikom identyfikować pliki na Dysku.

w przypadku typów plików, których Dysk nie może wygenerować standardowej miniatury; , możesz dostarczyć obraz miniatury wygenerowany przez aplikację. W trakcie tworzenia lub aktualizacji pliku, prześlij miniaturę, ustawiając contentHints.thumbnail w zasobie files.

Oto najważniejsze kwestie:

  • W polu contentHints.thumbnail.image ustaw bezpieczny adres URL i nazwę pliku obraz zakodowany w base64 (patrz sekcja RFC 4648 5).
  • W polu contentHints.thumbnail.mimeType ustaw odpowiedni typ MIME. dla miniatury.

Jeśli Dysk może wygenerować miniaturę z pliku, to użyje generowany automatycznie i ignoruje te przesłane przez Ciebie. Jeśli nie korzysta z miniatury, którą podasz.

Miniatury powinny być zgodne z tymi zasadami:

  • mogą być przesyłane w formacie PNG, GIF lub JPG;
  • Zalecana szerokość to 1600 pikseli.
  • Minimalna szerokość to 220 pikseli.
  • Maksymalny rozmiar pliku to 2 MB.
  • Powinny one być aktualizowane przez aplikację przy każdym zapisie.
.

Więcej informacji znajdziesz w artykule files.

Pobierz miniatury

Możesz pobierać metadane plików z Dysku, w tym miniatury. Informacje o miniaturze znajdują się w polu thumbnailLink sekcji files.

Zwracanie określonej miniatury

Poniższa próbka kodu przedstawia Żądanie metody files.get z wartością wielu pól jako parametru zapytania, dla których będą zwracane metadane thumbnailLink konkretnego pliku. Więcej informacji znajdziesz w artykule Zwracanie określonych pól dla .

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink

Zastąp FILE_ID wartością fileId pliku, który chcesz znaleźć.

Jeśli to możliwe, żądanie zwraca skrócony adres URL jako miniaturę pliku. Zwykle link działa przez kilka godzin. To pole jest wypełniane tylko wtedy, gdy aplikacja żądająca dostępu może uzyskać dostęp do treści pliku. Jeśli plik nie jest udostępniony publicznie, adres URL zwrócony w metodzie thumbnailLink musi zostać pobrany za pomocą żądanie danych uwierzytelniających.

Zwraca listę miniatur

Poniższa próbka kodu przedstawia Żądanie metody files.list z wartością wielu pól jako parametru zapytania, dla których będą zwracane metadane thumbnailLink listę plików. Więcej informacji znajdziesz w artykule Wyszukiwanie plików i .

GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)

Aby ograniczyć wyniki wyszukiwania do określonego typu pliku, zastosuj ciąg zapytania do ustawić typ MIME. Z przykładowego kodu poniżej dowiesz się, jak ograniczyć do plików Arkuszy Google. Więcej informacji na temat typów MIME znajdziesz w sekcji Zgodność ze standardem MIME w Google Workspace i na Dysku Google .

GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)