Vertex AI v1beta1: Major Breaking Changes, GenAI Expansion, and Feature Re-rollouts

Modified API Methods (73):

This is a substantial update for the Vertex AI v1beta1 API, featuring critical breaking changes and a broad expansion of GenAI functionalities.Developers should carefully review their integrations.

Breaking Changes:

Several parameters are now strictly required: name (for operations methods), parent (for collaborativeProjects.create and agents.tasks.create), task (for agents.tasks.deleteArtifact, downloadArtifact, listArtifacts, uploadArtifact), and collaborativeProject (for collaborativeProjects.artifacts.add).
A large number of properties across various schemas have been made read-only, including rawPromptToken and toolCallUsage in GenaiInteractionUsage, status in GoogleCloudAiplatformV1beta1Agent, and numerous fields within GoogleCloudAiplatformV1beta1BudgetConsumptionDetail, GoogleCloudAiplatformV1beta1CollaborativeProject, GoogleCloudAiplatformV1beta1Detector, GoogleCloudAiplatformV1beta1EvaluationItem, GoogleCloudAiplatformV1beta1EvaluationSet, GoogleCloudAiplatformV1beta1Goal, GoogleCloudAiplatformV1beta1LinkJsonMetadata, GoogleCloudAiplatformV1beta1Task, and GoogleCloudAiplatformV1beta1TaskArtifactFile. Existing code attempting to write to these fields will now break.
The media.upload method has been removed.
The idpNonce parameter from projects.locations.agents.create and the ids parameter from projects.locations.publishers.files.list have been removed. These were recently introduced, so developers who adopted them will need to revert their usage.

New Features & Enhancements:

GenAI Capabilities: A significant number of new schemas (GenaiInteractionUsage, GenaiAudioContent, GenaiCodeExecutionCallDelta, GenaiEnvironmentConfig, GenaiFileCitation, GenaiGoogleMapsCallDelta, GenaiGoogleSearchCallDelta, GenaiImageContent, GenaiStep, GenaiVideoContent, etc.) have been added, providing granular control and detailed information for GenAI interactions, tool calls (code execution, file search, Google Maps, Google Search, URL context), and various content types.
Agent Task Management: The projects.locations.agents.tasks resource now offers comprehensive methods for cancel, create, delete, deleteArtifact, download, downloadArtifact, get, list, listArtifacts, patch, resume, stream, suspend, upload, and uploadArtifact, enabling robust orchestration of agent workflows.
Collaborative Projects: New CRUD methods (create, delete, get, list, patch) are available for projects.locations.collaborativeProjects, along with artifact management (add, list, preview, remove) within these projects.
Operations Management: Standard long-running operation methods (cancel, delete, get, list, wait) are now available for collaborativeProjects.operations and learningSets.operations.
Detectors: New resources and methods for managing projects.locations.detectors (create, delete, disable, enable, get, list, listRevisions, patch) have been introduced.
Continuation Token Re-rollout: The continuationToken property in GenaiVertexV1beta1Interaction has been re-introduced, allowing developers to resume long-running content generation.
New OAuth2 Scopes: Two new scopes, discoveryengine.assist.readwrite and discoveryengine.serving.readwrite, enable broader integration with Discovery Engine products.