- [Resource: QaScorecardRevision](https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions#QaScorecardRevision)
  - [JSON representation](https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions#QaScorecardRevision.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions#State)
- [Methods](https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions#METHODS_SUMMARY)

## Resource: QaScorecardRevision

A revision of a QaScorecard.

Modifying published scorecard fields would invalidate existing scorecard results --- the questions may have changed, or the score weighting will make existing scores impossible to understand. So changes must create a new revision, rather than modifying the existing resource.

| JSON representation |
|---|
| ``` { "name": string, "snapshot": { object (`https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards#QaScorecard`) }, "createTime": string, "alternateIds": [ string ], "state": enum (`https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions#State`) } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The name of the scorecard revision. Format: projects/{project}/locations/{location}/qaScorecards/{qaScorecard}/revisions/{revision} |
| `snapshot` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards#QaScorecard`)`` The snapshot of the scorecard at the time of this revision's creation. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp that the revision was created. Uses RFC 3339, where generated output will always be Z-normalized and uses 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"`. |
| `alternateIds[]` | `string` Output only. Alternative IDs for this revision of the scorecard, e.g., `latest`. |
| `state` | ``enum (`https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions#State`)`` Output only. State of the scorecard revision, indicating whether it's ready to be used in analysis. |

## State

Enum representing the set of states a scorecard revision may be in.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Unspecified. |
| `EDITABLE` | The scorecard revision can be edited. |
| `TRAINING` | Scorecard model training is in progress. |
| `TRAINING_FAILED` | Scorecard revision model training failed. |
| `READY` | The revision can be used in analysis. |
| `DELETING` | Scorecard is being deleted. |
| `TRAINING_CANCELLED` | Scorecard model training was explicitly cancelled by the user. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions/create` | Creates a QaScorecardRevision. |
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions/delete` | Deletes a QaScorecardRevision. |
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions/deploy` | Deploy a QaScorecardRevision. |
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions/get` | Gets a QaScorecardRevision. |
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions/list` | Lists all revisions under the parent QaScorecard. |
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions/tuneQaScorecardRevision` | Fine tune one or more QaModels. |
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/insights/reference/rest/v1/projects.locations.qaScorecards.revisions/undeploy` | Undeploy a QaScorecardRevision. |