Dodawanie niestandardowych właściwości plików

Niestandardowe właściwości pliku to pary klucz/wartość używane do przechowywania niestandardowych metadanych pliku, takich jak tagi, identyfikatory z innych magazynów danych, informacje udostępniane między aplikacjami przepływu pracy itd.

Aby dodać właściwości widoczne dla wszystkich aplikacji, użyj pola properties zasobu files. Aby dodać właściwości ograniczone do Twojej aplikacji, użyj pola appProperties w zasobie files.

Właściwości mogą być też używane w wyszukiwanych wyrażeniach.

To jest typowa właściwość właściwości, która może służyć do przechowywania identyfikatora bazy danych dla pliku na Dysku.

Interfejs API Dysku w wersji 3

"appProperties": {
  "additionalID": "8e8aceg2af2ge72e78",
}

Interfejs API Dysku w wersji 2

{
  'key':        'additionalID',
  'value':      '8e8aceg2af2ge72e78',
  'visibility': 'PRIVATE'
}

Usługi niestandardowe mają następujące limity:

  • Maksymalnie 100 właściwości niestandardowych na plik, łącznie ze wszystkich źródeł.
  • Maksymalnie 30 usług publicznych na plik, łącznie ze wszystkich źródeł.
  • Maksymalnie 30 właściwości prywatnych na plik w każdej aplikacji.
  • Maksymalnie 124 bajty na usługę (wraz z kluczem i wartością) w kodowaniu UTF-8. Na przykład usługa z kluczem o długości 10 znaków może mieć tylko 114 znaków w wartości. Usługa, która wymaga 100 znaków wartości, może użyć do 24 znaków jako wartości klucza.
  • Zapisywanie właściwości pliku ma taki sam wpływ na działanie, jak w przypadku innych operacji zapisu.

Więcej informacji znajdziesz w zasobie files.

Dostęp do właściwości pliku niestandardowego

Te właściwości można pobrać tylko z użyciem uwierzytelnionego żądania. Uwierzytelnione żądanie używa tokena dostępu uzyskanego z identyfikatorem klienta OAuth 2. Do pobierania właściwości prywatnych nie można użyć klucza interfejsu API.