- [Resource: SampleQuery](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#SampleQuery)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#SampleQuery.SCHEMA_REPRESENTATION)
- [QueryEntry](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#QueryEntry)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#QueryEntry.SCHEMA_REPRESENTATION)
- [Target](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#Target)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#Target.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#METHODS_SUMMARY)

## Resource: SampleQuery

Sample Query captures metadata to be used for evaluation.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "queryEntry": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#QueryEntry`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The full resource name of the sample query, in the format of `projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet}/sampleQueries/{sampleQuery}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Timestamp the `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#SampleQuery` was created at. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| The content of the sample query. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `queryEntry` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#QueryEntry`)`` The query entry. |
| End of mutually exclusive fields. ||

## QueryEntry

Query Entry captures metadata to be used for search evaluation.

| JSON representation |
|---|
| ``` { "query": string, "targets": [ { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#Target`) } ] } ``` |

| Fields ||
|---|---|
| `query` | `string` Required. The query. |
| `targets[]` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#Target`)`` List of targets for the query. |

## Target

Defines the parameters of the query's expected outcome.

| JSON representation |
|---|
| ``` { "uri": string, "pageNumbers": [ integer ], "score": number } ``` |

| Fields ||
|---|---|
| `uri` | `string` Expected uri of the target. This field must be a UTF-8 encoded string with a length limit of 2048 characters. Example of valid uris: `https://example.com/abc`, `gcs://example/example.pdf`. |
| `pageNumbers[]` | `integer` Expected page numbers of the target. Each page number must be non negative. |
| `score` | `number` Relevance score of the target. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries/create` | Creates a `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#SampleQuery` |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries/delete` | Deletes a `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#SampleQuery`. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries/get` | Gets a `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#SampleQuery`. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries/import` | Bulk import of multiple `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#SampleQuery`s. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries/list` | Gets a list of `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#SampleQuery`s. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries/patch` | Updates a `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.sampleQuerySets.sampleQueries#SampleQuery`. |