Certifique-se de [Atualizar a versão do FastAPI](../deployment/versions.md#upgrading-the-fastapi-versions) para pelo menos 0.95.1 antes de usar `Annotated`.

///

## Declare metadados { #declare-metadata }

Você pode declarar todos os mesmos parâmetros que em `Query`.

Por exemplo, para declarar um valor de metadado `title` para o parâmetro de path `item_id` você pode digitar:

///

## `Annotated` im Typ für den `q`-Parameter verwenden { #use-annotated-in-the-type-for-the-q-parameter }

Erinnern Sie sich, dass ich Ihnen zuvor in [Python-Typen-Intro](../python-types.md#type-hints-with-metadata-annotations) gesagt habe, dass `Annotated` verwendet werden kann, um Metadaten zu Ihren Parametern hinzuzufügen?

Jetzt ist es soweit, dies mit FastAPI zu verwenden. 🚀

Wir hatten diese Typannotation:

```Python

Lembra que eu disse antes que `Annotated` pode ser usado para adicionar metadados aos seus parâmetros na [Introdução aos tipos do Python](../python-types.md#type-hints-with-metadata-annotations)?

Agora é a hora de usá-lo com FastAPI. 🚀

Tínhamos esta anotação de tipo:

```Python
q: str | None = None
```

O que faremos é envolver isso com `Annotated`, para que fique assim:

標準の型アノテーションを使い、デフォルト値を `None` に設定することで、ファイルを任意にできます:

{* ../../docs_src/request_files/tutorial001_02_an_py310.py hl[9,17] *}

## 追加メタデータつきの `UploadFile` { #uploadfile-with-additional-metadata }

例えば追加のメタデータを設定するために、`UploadFile` と併せて `File()` を使うこともできます:

{* ../../docs_src/request_files/tutorial001_03_an_py310.py hl[9,15] *}

## 複数ファイルのアップロード { #multiple-file-uploads }

同時に複数のファイルをアップロードできます。

///

## 在 `q` 參數的型別中使用 `Annotated` { #use-annotated-in-the-type-for-the-q-parameter }

還記得先前在 [Python 型別介紹](../python-types.md#type-hints-with-metadata-annotations) 提到可以用 `Annotated` 為參數加入中繼資料嗎？

現在就用在 FastAPI 上吧。🚀

我們原本的型別註記是：

```Python
q: str | None = None
```

接著把它用 `Annotated` 包起來，變成：

```Python
q: Annotated[str | None] = None
```

///

## Declarar metadatos { #declare-metadata }

Puedes declarar todos los mismos parámetros que para `Query`.

Por ejemplo, para declarar un valor de metadato `title` para el parámetro de path `item_id` puedes escribir:

{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[10] *}

/// note | Nota

	object := gcs.client.Bucket(gcs.Bucket).Object(gcs.getDest(key))
	w := object.NewWriter(ctx)
	if gcs.StorageClass != "" {
		w.StorageClass = gcs.StorageClass
	}
	w.Metadata = meta
	if _, err := xioutil.Copy(w, data); err != nil {
		return "", gcsToObjectError(err, gcs.Bucket, key)
	}

	if _, err := xioutil.Copy(w, data); err != nil {
		return "", gcsToObjectError(err, gcs.Bucket, key)

- Zero-value `metadata.creationTimestamp` values are now omitted and no longer serialize an explicit `null` in JSON, YAML, and CBOR output ([#130989](https://github.com/kubernetes/kubernetes/pull/130989), [@liggitt](https://github.com/liggitt)) [SIG API Machinery, Apps,...

&‡“;Qü-³í"¢ƒ‚ cå+ ¼ cËÿÌ_¾”ÈÂ"'tªhÊyÐ53€šÂƒ³ ‘„p “ ’ý؃nŠºUYëí&§¸Ý©j ‹å Ý$? rítÔ}‘<OÍvà}Šc‹CÙÃ* †§ô’çï¥ Ó×ûùhkd ë°&¾ x|Ž Xlë %‡ ¡šíG Ü *>NJ? D êM¬« ª’êà%˜ YÁë1ÍÒð=\(\ «r–y ‘Ÿ í_Â9œðàÂ=u †¬ ‘S­ multisitea/data/disterasure/xl3/.minio.sys/buckets/bucket/.metadata.bin/xl.meta XL2 Æ } Ä$•Ä Ó É Ñ©XÈÄ Í#| Å Qƒ¤Type ¥V2ObjÞ ¢IDÄ ¤DDirÄ ­„ï P L;»ô5,éº ¡¦EcAlgo £EcM £EcN §EcBSizeÒ §EcIndex ¦EcDistœ ¨CSumAlgo ¨PartNums‘ ©PartETagsÀ©PartSizes‘Ñ iªPartASizes‘Ñ i¤SizeÑ i¥MTimeÓ É Ñ©XȧMetaSys ¼x-minio-internal-inline-dataÄ...

¿Recuerdas que te dije antes que `Annotated` puede usarse para agregar metadatos a tus parámetros en la [Introducción a Tipos de Python](../python-types.md#type-hints-with-metadata-annotations)?

Ahora es el momento de usarlo con FastAPI. 🚀

Teníamos esta anotación de tipo:

```Python
q: str | None = None
```