blob: 0f0461ec06d7e6c960663c86e815548030066f38 [file] [log] [blame]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="connectors_v2.html">Connectors API</a> . <a href="connectors_v2.projects.html">projects</a> . <a href="connectors_v2.projects.locations.html">locations</a> . <a href="connectors_v2.projects.locations.connections.html">connections</a> . <a href="connectors_v2.projects.locations.connections.tools.html">tools</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#execute">execute(name, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Executes a specific tool.</p>
<p class="toc_element">
<code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all available tools.</p>
<p class="toc_element">
<code><a href="#list_next">list_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="execute">execute(name, body=None, x__xgafv=None)</code>
<pre>Executes a specific tool.
Args:
name: string, Required. Resource name of the Tool. Format: projects/{project}/locations/{location}/connections/{connection}/tools/{tool} (required)
body: object, The request body.
The object takes the form of:
{ # Request message for ConnectorAgentService.ExecuteTool
&quot;parameters&quot;: { # Input parameters for the tool.
&quot;a_key&quot;: &quot;&quot;, # Properties of the object.
},
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for ConnectorAgentService.ExecuteTool
&quot;metadata&quot;: { # Metadata like service latency, etc.
&quot;a_key&quot;: {
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
},
},
&quot;result&quot;: { # Output from the tool execution.
&quot;a_key&quot;: &quot;&quot;, # Properties of the object.
},
}</pre>
</div>
<div class="method">
<code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists all available tools.
Args:
parent: string, Required. Resource name of the Connection. Format: projects/{project}/locations/{location}/connections/{connection} (required)
pageSize: integer, Page size.
pageToken: string, Page token.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for ConnectorAgentService.ListTools
&quot;metadata&quot;: { # Metadata like service latency, etc.
&quot;a_key&quot;: {
&quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
},
},
&quot;nextPageToken&quot;: &quot;A String&quot;, # Next page token.
&quot;tools&quot;: [ # List of available tools.
{ # Message representing a single tool.
&quot;annotations&quot;: { # ToolAnnotations holds annotations for a tool. # Annotations for the tool.
&quot;destructiveHint&quot;: True or False, # If true, the tool may perform destructive updates to its environment. If false, the tool performs only additive updates. (This property is meaningful only when `read_only_hint == false`)
&quot;idempotentHint&quot;: True or False, # If true, calling the tool repeatedly with the same arguments will have no additional effect on the environment. (This property is meaningful only when `read_only_hint == false`)
&quot;openWorldHint&quot;: True or False, # If true, this tool may interact with an &quot;open world&quot; of external entities. If false, the tool&#x27;s domain of interaction is closed. For example, the world of a web search tool is open, whereas that of a memory tool is not.
&quot;readOnlyHint&quot;: True or False, # If true, the tool does not modify its environment.
&quot;title&quot;: &quot;A String&quot;, # A human-readable title for the tool.
},
&quot;dependsOn&quot;: [ # List of tool names that this tool depends on.
&quot;A String&quot;,
],
&quot;description&quot;: &quot;A String&quot;, # Description of the tool.
&quot;inputSchema&quot;: { # JsonSchema representation of schema metadata # JSON schema for the input parameters of the tool.
&quot;additionalDetails&quot;: { # Additional details apart from standard json schema fields, this gives flexibility to store metadata about the schema
&quot;a_key&quot;: &quot;&quot;, # Properties of the object.
},
&quot;default&quot;: &quot;&quot;, # The default value of the field or object described by this schema.
&quot;description&quot;: &quot;A String&quot;, # A description of this schema.
&quot;enum&quot;: [ # Possible values for an enumeration. This works in conjunction with `type` to represent types with a fixed set of legal values
&quot;&quot;,
],
&quot;format&quot;: &quot;A String&quot;, # Format of the value as per https://json-schema.org/understanding-json-schema/reference/string.html#format
&quot;items&quot;: # Object with schema name: JsonSchema # Schema that applies to array values, applicable only if this is of type `array`.
&quot;jdbcType&quot;: &quot;A String&quot;, # JDBC datatype of the field.
&quot;properties&quot;: { # The child schemas, applicable only if this is of type `object`. The key is the name of the property and the value is the json schema that describes that property
&quot;a_key&quot;: # Object with schema name: JsonSchema
},
&quot;required&quot;: [ # Whether this property is required.
&quot;A String&quot;,
],
&quot;type&quot;: [ # JSON Schema Validation: A Vocabulary for Structural Validation of JSON
&quot;A String&quot;,
],
},
&quot;name&quot;: &quot;A String&quot;, # Name of the tool.
&quot;outputSchema&quot;: { # JsonSchema representation of schema metadata # JSON schema for the output of the tool.
&quot;additionalDetails&quot;: { # Additional details apart from standard json schema fields, this gives flexibility to store metadata about the schema
&quot;a_key&quot;: &quot;&quot;, # Properties of the object.
},
&quot;default&quot;: &quot;&quot;, # The default value of the field or object described by this schema.
&quot;description&quot;: &quot;A String&quot;, # A description of this schema.
&quot;enum&quot;: [ # Possible values for an enumeration. This works in conjunction with `type` to represent types with a fixed set of legal values
&quot;&quot;,
],
&quot;format&quot;: &quot;A String&quot;, # Format of the value as per https://json-schema.org/understanding-json-schema/reference/string.html#format
&quot;items&quot;: # Object with schema name: JsonSchema # Schema that applies to array values, applicable only if this is of type `array`.
&quot;jdbcType&quot;: &quot;A String&quot;, # JDBC datatype of the field.
&quot;properties&quot;: { # The child schemas, applicable only if this is of type `object`. The key is the name of the property and the value is the json schema that describes that property
&quot;a_key&quot;: # Object with schema name: JsonSchema
},
&quot;required&quot;: [ # Whether this property is required.
&quot;A String&quot;,
],
&quot;type&quot;: [ # JSON Schema Validation: A Vocabulary for Structural Validation of JSON
&quot;A String&quot;,
],
},
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="list_next">list_next()</code>
<pre>Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call &#x27;execute()&#x27; on to request the next
page. Returns None if there are no more items in the collection.
</pre>
</div>
</body></html>