TypeScript typings for Discovery Engine API v1alpha

Discovery Engine API. For detailed description please check documentation.

Installing

Install typings for Discovery Engine API:

npm install @types/gapi.client.discoveryengine-v1alpha --save-dev

Usage

You need to initialize Google API client in your code:

gapi.load('client', () => {
  // now we can use gapi.client
  // ...
});

Then load api client wrapper:

gapi.client.load(
  'https://discoveryengine.googleapis.com/$discovery/rest?version=v1alpha',
  () => {
    // now we can use:
    // gapi.client.discoveryengine
  },
);

// Deprecated, use discovery document URL, see https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md#----gapiclientloadname----version----callback--
gapi.client.load('discoveryengine', 'v1alpha', () => {
  // now we can use:
  // gapi.client.discoveryengine
});

Don't forget to authenticate your client before sending any request to resources:

// declare client_id registered in Google Developers Console
var client_id = '',
  scope = [
    // Search your organization's data in the Cloud Search index
    'https://www.googleapis.com/auth/cloud_search.query',

    // See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
    'https://www.googleapis.com/auth/cloud-platform',

    // View your Agentspace chat history, including uploaded files and generated reports and visualizations, and interact with the Agentspace assistant on your behalf.
    'https://www.googleapis.com/auth/discoveryengine.assist.readwrite',

    // View, edit, create, and delete all your data associated with any Discovery Engine API product, such as Agentspace, Vertex AI Search, or NotebookLM Enterprise, including both end user data and administration or configuration data.
    'https://www.googleapis.com/auth/discoveryengine.readwrite',
  ],
  immediate = true;
// ...

gapi.auth.authorize(
  {client_id: client_id, scope: scope, immediate: immediate},
  authResult => {
    if (authResult && !authResult.error) {
      /* handle successful authorization */
    } else {
      /* handle authorization error */
    }
  },
);

After that you can use Discovery Engine API resources:

/*
Gets a Project. Returns NOT_FOUND when the project is not yet created.
*/
await gapi.client.discoveryengine.projects.get({name: 'name'});

/*
Updates the editable settings of a Discovery Engine Project.
*/
await gapi.client.discoveryengine.projects.patch({name: 'name'});

/*
Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms.
*/
await gapi.client.discoveryengine.projects.provision({name: 'name'});

/*
Updates service terms for this project. This method can be used to retroactively accept the latest terms. Terms available for update: * [Terms for data use](https://cloud.google.com/retail/data-use-terms)
*/
await gapi.client.discoveryengine.projects.reportConsentChange({
  project: 'project',
});

For provenance information see Provenance section on NPM