Zarządzanie metadanymi plików

W tym dokumencie opisano ważne kwestie dotyczące nadawania nazw plikom oraz pracy z metadanymi, takimi jak miniatury czy tekst dostępny do indeksowania. Aby rozpocząć wstawianie i pobieranie plików, zobacz Pliki referencyjne.

Określ nazwy plików i rozszerzenia

Aplikacje powinny określać rozszerzenie pliku we właściwości title podczas wstawiania plików za pomocą interfejsu API. Na przykład operacja wstawienia pliku JPEG powinna określać w pliku metadane "name": "cat.jpg".

Kolejne odpowiedzi GET mogą zawierać tylko do odczytu właściwość fileExtension z rozszerzeniem podanym pierwotnie we właściwości name. Gdy użytkownik Dysku Google prosi o pobranie pliku lub pobiera go za pomocą klienta synchronizacji, Dysk tworzy pełną nazwę pliku (z rozszerzeniem) na podstawie tytułu. W przypadku braku rozszerzenia Dysk próbuje określić rozszerzenie na podstawie typu MIME pliku.

Zapisz tekst indeksowalny

Uwaga: od 31 października 2022 r. fragmenty treści, które można zindeksować, będą mogły wyświetlać się w krótkich opisach i wpłyną na wyniki wyszukiwania w wielu miejscach, w tym w Cloud Search oraz w nakładce wyszukiwania na Dysku i w Gmailu.

Dysk automatycznie indeksuje dokumenty do wyszukiwania, gdy rozpozna typ pliku, w tym dokumenty tekstowe, PDF-y, obrazy z tekstem i inne typowe typy. Jeśli aplikacja zapisuje inne typy plików (np. rysunki, filmy czy skróty), możesz zwiększyć wykrywalność, wpisując tekst w polu contentHints.indexableText pliku.

Tekst, który można zindeksować, jest indeksowany jako kod HTML. Jeśli zapiszesz ciąg tekstowy, który można zindeksować, funkcja „Oto fragment tekstu” zostanie zindeksowana, ale „wartość1” już nie. Z tego powodu zapisywanie pliku XML jako tekstu przeznaczonego do indeksowania nie jest tak przydatne jak zapisywanie kodu HTML.

Podczas określania wartości indexableText pamiętaj też, że:

• Limit rozmiaru pliku contentHints.indexableText to 128 KB.
• Zapisuj kluczowe hasła i koncepcje, których oczekujesz od użytkowników.
• Nie próbuj sortować tekstu według ważności, bo to robi za Ciebie indeksator.
• Aplikacja powinna aktualizować tekst indeksowalny z każdym zapisem.
• Upewnij się, że tekst jest związany z treścią lub metadanymi pliku.

Ta ostatnia kwestia może wydawać się oczywista, ale jest bardzo ważna. Nie zalecamy dodawania często wyszukiwanych słów, aby wymusić wyświetlenie pliku w wynikach wyszukiwania. Może to frustrować użytkowników, a nawet zmotywować ich do usunięcia pliku.

Prześlij miniatury

Dysk automatycznie generuje miniatury dla wielu popularnych typów plików. W przypadku skrótów i innych typów plików, których Dysk nie może renderować, możesz udostępnić miniaturę wygenerowaną przez aplikację. Prześlij miniaturę, ustawiając właściwość contentHints.thumbnail w zasobie Files podczas wywołania create lub update w ten sposób:

• Ustaw contentHints.thumbnail.image na bezpieczny dla adresu URL obraz zakodowany w standardzie Base64 (zobacz RFC 4648, sekcja 5).
• Ustaw contentHints.thumbnail.mimeType jako typ formatu obrazu.

Jeśli Dysk może wygenerować miniaturę z pliku, wykorzystuje wygenerowaną miniaturę i ignoruje przesłane przez Ciebie. Jeśli nie może wygenerować miniatury, zawsze używa Twojej, jeśli ją podasz. Uwagi:

• Miniatury można przesyłać w formacie PNG, GIF lub JPG.
• Zalecana szerokość to 1600 pikseli.
• Maksymalny rozmiar pliku miniatury to 2 MB.
• Minimalna szerokość miniatur to 220 pikseli.
• Aplikacja powinna aktualizować miniatury przy każdym zapisywaniu.

Ważne: miniatury są unieważniane za każdym razem, gdy zmienia się zawartość pliku. Przy przesyłaniu miniatur ważne jest, aby przesyłać nowe miniatury za każdym razem, gdy treść jest modyfikowana. Zmiany w metadanych nie powodują unieważnienia miniatur.

Więcej informacji znajdziesz w dokumentacji plików.