@googleapis/agentregistry 3.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -340,6 +340,27 @@ export declare namespace agentregistry_v1alpha {
340
340
  */
341
341
  type?: string | null;
342
342
  }
343
+ /**
344
+ * Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.
345
+ */
346
+ export interface Schema$Expr {
347
+ /**
348
+ * Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
349
+ */
350
+ description?: string | null;
351
+ /**
352
+ * Textual representation of an expression in Common Expression Language syntax.
353
+ */
354
+ expression?: string | null;
355
+ /**
356
+ * Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
357
+ */
358
+ location?: string | null;
359
+ /**
360
+ * Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
361
+ */
362
+ title?: string | null;
363
+ }
343
364
  /**
344
365
  * Message for response to fetching available Bindings.
345
366
  */
@@ -393,6 +414,101 @@ export declare namespace agentregistry_v1alpha {
393
414
  */
394
415
  uri?: string | null;
395
416
  }
417
+ /**
418
+ * Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] \}, { "log_type": "DATA_WRITE" \}, { "log_type": "ADMIN_READ" \} ] \}, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" \}, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] \} ] \} ] \} For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.
419
+ */
420
+ export interface Schema$GoogleIamV1AuditConfig {
421
+ /**
422
+ * The configuration for logging of each type of permission.
423
+ */
424
+ auditLogConfigs?: Schema$GoogleIamV1AuditLogConfig[];
425
+ /**
426
+ * Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
427
+ */
428
+ service?: string | null;
429
+ }
430
+ /**
431
+ * Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] \}, { "log_type": "DATA_WRITE" \} ] \} This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
432
+ */
433
+ export interface Schema$GoogleIamV1AuditLogConfig {
434
+ /**
435
+ * Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
436
+ */
437
+ exemptedMembers?: string[] | null;
438
+ /**
439
+ * The log type that this config enables.
440
+ */
441
+ logType?: string | null;
442
+ }
443
+ /**
444
+ * Associates `members`, or principals, with a `role`.
445
+ */
446
+ export interface Schema$GoogleIamV1Binding {
447
+ /**
448
+ * The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
449
+ */
450
+ condition?: Schema$Expr;
451
+ /**
452
+ * Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid\}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid\}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid\}.svc.id.goog[{namespace\}/{kubernetes-sa\}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid\}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain\}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id\}/subject/{subject_attribute_value\}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id\}/group/{group_id\}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id\}/attribute.{attribute_name\}/{attribute_value\}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id\}/x`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number\}/locations/global/workloadIdentityPools/{pool_id\}/subject/{subject_attribute_value\}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number\}/locations/global/workloadIdentityPools/{pool_id\}/group/{group_id\}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number\}/locations/global/workloadIdentityPools/{pool_id\}/attribute.{attribute_name\}/{attribute_value\}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number\}/locations/global/workloadIdentityPools/{pool_id\}/x`: All identities in a workload identity pool. * `deleted:user:{emailid\}?uid={uniqueid\}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid\}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid\}?uid={uniqueid\}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid\}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid\}?uid={uniqueid\}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid\}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id\}/subject/{subject_attribute_value\}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
453
+ */
454
+ members?: string[] | null;
455
+ /**
456
+ * Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
457
+ */
458
+ role?: string | null;
459
+ }
460
+ /**
461
+ * An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] \}, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", \} \} ], "etag": "BwWWja0YfJA=", "version": 3 \} ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
462
+ */
463
+ export interface Schema$GoogleIamV1Policy {
464
+ /**
465
+ * Specifies cloud audit logging configuration for this policy.
466
+ */
467
+ auditConfigs?: Schema$GoogleIamV1AuditConfig[];
468
+ /**
469
+ * Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
470
+ */
471
+ bindings?: Schema$GoogleIamV1Binding[];
472
+ /**
473
+ * `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
474
+ */
475
+ etag?: string | null;
476
+ /**
477
+ * Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
478
+ */
479
+ version?: number | null;
480
+ }
481
+ /**
482
+ * Request message for `SetIamPolicy` method.
483
+ */
484
+ export interface Schema$GoogleIamV1SetIamPolicyRequest {
485
+ /**
486
+ * REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them.
487
+ */
488
+ policy?: Schema$GoogleIamV1Policy;
489
+ /**
490
+ * OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: "bindings, etag"`
491
+ */
492
+ updateMask?: string | null;
493
+ }
494
+ /**
495
+ * Request message for `TestIamPermissions` method.
496
+ */
497
+ export interface Schema$GoogleIamV1TestIamPermissionsRequest {
498
+ /**
499
+ * The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
500
+ */
501
+ permissions?: string[] | null;
502
+ }
503
+ /**
504
+ * Response message for `TestIamPermissions` method.
505
+ */
506
+ export interface Schema$GoogleIamV1TestIamPermissionsResponse {
507
+ /**
508
+ * A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
509
+ */
510
+ permissions?: string[] | null;
511
+ }
396
512
  /**
397
513
  * Represents the connection details for an Agent or MCP Server.
398
514
  */
@@ -1023,6 +1139,7 @@ export declare namespace agentregistry_v1alpha {
1023
1139
  export class Resource$Projects$Locations {
1024
1140
  context: APIRequestContext;
1025
1141
  agents: Resource$Projects$Locations$Agents;
1142
+ aiApplications: Resource$Projects$Locations$Aiapplications;
1026
1143
  bindings: Resource$Projects$Locations$Bindings;
1027
1144
  endpoints: Resource$Projects$Locations$Endpoints;
1028
1145
  mcpServers: Resource$Projects$Locations$Mcpservers;
@@ -1472,6 +1589,264 @@ export declare namespace agentregistry_v1alpha {
1472
1589
  */
1473
1590
  requestBody?: Schema$SearchAgentsRequest;
1474
1591
  }
1592
+ export class Resource$Projects$Locations$Aiapplications {
1593
+ context: APIRequestContext;
1594
+ constructor(context: APIRequestContext);
1595
+ /**
1596
+ * Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
1597
+ * @example
1598
+ * ```js
1599
+ * // Before running the sample:
1600
+ * // - Enable the API at:
1601
+ * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com
1602
+ * // - Login into gcloud by running:
1603
+ * // ```sh
1604
+ * // $ gcloud auth application-default login
1605
+ * // ```
1606
+ * // - Install the npm module by running:
1607
+ * // ```sh
1608
+ * // $ npm install googleapis
1609
+ * // ```
1610
+ *
1611
+ * const {google} = require('googleapis');
1612
+ * const agentregistry = google.agentregistry('v1alpha');
1613
+ *
1614
+ * async function main() {
1615
+ * const auth = new google.auth.GoogleAuth({
1616
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1617
+ * scopes: [
1618
+ * 'https://www.googleapis.com/auth/agentregistry.read-only',
1619
+ * 'https://www.googleapis.com/auth/agentregistry.read-write',
1620
+ * 'https://www.googleapis.com/auth/cloud-platform',
1621
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1622
+ * ],
1623
+ * });
1624
+ *
1625
+ * // Acquire an auth client, and bind it to all future calls
1626
+ * const authClient = await auth.getClient();
1627
+ * google.options({auth: authClient});
1628
+ *
1629
+ * // Do the magic
1630
+ * const res =
1631
+ * await agentregistry.projects.locations.aiApplications.getIamPolicy({
1632
+ * // Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
1633
+ * 'options.requestedPolicyVersion': 'placeholder-value',
1634
+ * // REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
1635
+ * resource:
1636
+ * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication',
1637
+ * });
1638
+ * console.log(res.data);
1639
+ *
1640
+ * // Example response
1641
+ * // {
1642
+ * // "auditConfigs": [],
1643
+ * // "bindings": [],
1644
+ * // "etag": "my_etag",
1645
+ * // "version": 0
1646
+ * // }
1647
+ * }
1648
+ *
1649
+ * main().catch(e => {
1650
+ * console.error(e);
1651
+ * throw e;
1652
+ * });
1653
+ *
1654
+ * ```
1655
+ *
1656
+ * @param params - Parameters for request
1657
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
1658
+ * @param callback - Optional callback that handles the response.
1659
+ * @returns A promise if used with async/await, or void if used with a callback.
1660
+ */
1661
+ getIamPolicy(params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
1662
+ getIamPolicy(params?: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
1663
+ getIamPolicy(params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1664
+ getIamPolicy(params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
1665
+ getIamPolicy(params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
1666
+ getIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
1667
+ /**
1668
+ * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
1669
+ * @example
1670
+ * ```js
1671
+ * // Before running the sample:
1672
+ * // - Enable the API at:
1673
+ * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com
1674
+ * // - Login into gcloud by running:
1675
+ * // ```sh
1676
+ * // $ gcloud auth application-default login
1677
+ * // ```
1678
+ * // - Install the npm module by running:
1679
+ * // ```sh
1680
+ * // $ npm install googleapis
1681
+ * // ```
1682
+ *
1683
+ * const {google} = require('googleapis');
1684
+ * const agentregistry = google.agentregistry('v1alpha');
1685
+ *
1686
+ * async function main() {
1687
+ * const auth = new google.auth.GoogleAuth({
1688
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1689
+ * scopes: [
1690
+ * 'https://www.googleapis.com/auth/agentregistry.read-write',
1691
+ * 'https://www.googleapis.com/auth/cloud-platform',
1692
+ * ],
1693
+ * });
1694
+ *
1695
+ * // Acquire an auth client, and bind it to all future calls
1696
+ * const authClient = await auth.getClient();
1697
+ * google.options({auth: authClient});
1698
+ *
1699
+ * // Do the magic
1700
+ * const res =
1701
+ * await agentregistry.projects.locations.aiApplications.setIamPolicy({
1702
+ * // REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
1703
+ * resource:
1704
+ * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication',
1705
+ *
1706
+ * // Request body metadata
1707
+ * requestBody: {
1708
+ * // request body parameters
1709
+ * // {
1710
+ * // "policy": {},
1711
+ * // "updateMask": "my_updateMask"
1712
+ * // }
1713
+ * },
1714
+ * });
1715
+ * console.log(res.data);
1716
+ *
1717
+ * // Example response
1718
+ * // {
1719
+ * // "auditConfigs": [],
1720
+ * // "bindings": [],
1721
+ * // "etag": "my_etag",
1722
+ * // "version": 0
1723
+ * // }
1724
+ * }
1725
+ *
1726
+ * main().catch(e => {
1727
+ * console.error(e);
1728
+ * throw e;
1729
+ * });
1730
+ *
1731
+ * ```
1732
+ *
1733
+ * @param params - Parameters for request
1734
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
1735
+ * @param callback - Optional callback that handles the response.
1736
+ * @returns A promise if used with async/await, or void if used with a callback.
1737
+ */
1738
+ setIamPolicy(params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
1739
+ setIamPolicy(params?: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
1740
+ setIamPolicy(params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1741
+ setIamPolicy(params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
1742
+ setIamPolicy(params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
1743
+ setIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
1744
+ /**
1745
+ * Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.
1746
+ * @example
1747
+ * ```js
1748
+ * // Before running the sample:
1749
+ * // - Enable the API at:
1750
+ * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com
1751
+ * // - Login into gcloud by running:
1752
+ * // ```sh
1753
+ * // $ gcloud auth application-default login
1754
+ * // ```
1755
+ * // - Install the npm module by running:
1756
+ * // ```sh
1757
+ * // $ npm install googleapis
1758
+ * // ```
1759
+ *
1760
+ * const {google} = require('googleapis');
1761
+ * const agentregistry = google.agentregistry('v1alpha');
1762
+ *
1763
+ * async function main() {
1764
+ * const auth = new google.auth.GoogleAuth({
1765
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1766
+ * scopes: [
1767
+ * 'https://www.googleapis.com/auth/agentregistry.read-only',
1768
+ * 'https://www.googleapis.com/auth/agentregistry.read-write',
1769
+ * 'https://www.googleapis.com/auth/cloud-platform',
1770
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1771
+ * ],
1772
+ * });
1773
+ *
1774
+ * // Acquire an auth client, and bind it to all future calls
1775
+ * const authClient = await auth.getClient();
1776
+ * google.options({auth: authClient});
1777
+ *
1778
+ * // Do the magic
1779
+ * const res =
1780
+ * await agentregistry.projects.locations.aiApplications.testIamPermissions({
1781
+ * // REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
1782
+ * resource:
1783
+ * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication',
1784
+ *
1785
+ * // Request body metadata
1786
+ * requestBody: {
1787
+ * // request body parameters
1788
+ * // {
1789
+ * // "permissions": []
1790
+ * // }
1791
+ * },
1792
+ * });
1793
+ * console.log(res.data);
1794
+ *
1795
+ * // Example response
1796
+ * // {
1797
+ * // "permissions": []
1798
+ * // }
1799
+ * }
1800
+ *
1801
+ * main().catch(e => {
1802
+ * console.error(e);
1803
+ * throw e;
1804
+ * });
1805
+ *
1806
+ * ```
1807
+ *
1808
+ * @param params - Parameters for request
1809
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
1810
+ * @param callback - Optional callback that handles the response.
1811
+ * @returns A promise if used with async/await, or void if used with a callback.
1812
+ */
1813
+ testIamPermissions(params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
1814
+ testIamPermissions(params?: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1TestIamPermissionsResponse>>;
1815
+ testIamPermissions(params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1816
+ testIamPermissions(params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1TestIamPermissionsResponse>, callback: BodyResponseCallback<Schema$GoogleIamV1TestIamPermissionsResponse>): void;
1817
+ testIamPermissions(params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, callback: BodyResponseCallback<Schema$GoogleIamV1TestIamPermissionsResponse>): void;
1818
+ testIamPermissions(callback: BodyResponseCallback<Schema$GoogleIamV1TestIamPermissionsResponse>): void;
1819
+ }
1820
+ export interface Params$Resource$Projects$Locations$Aiapplications$Getiampolicy extends StandardParameters {
1821
+ /**
1822
+ * Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
1823
+ */
1824
+ 'options.requestedPolicyVersion'?: number;
1825
+ /**
1826
+ * REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
1827
+ */
1828
+ resource?: string;
1829
+ }
1830
+ export interface Params$Resource$Projects$Locations$Aiapplications$Setiampolicy extends StandardParameters {
1831
+ /**
1832
+ * REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
1833
+ */
1834
+ resource?: string;
1835
+ /**
1836
+ * Request body metadata
1837
+ */
1838
+ requestBody?: Schema$GoogleIamV1SetIamPolicyRequest;
1839
+ }
1840
+ export interface Params$Resource$Projects$Locations$Aiapplications$Testiampermissions extends StandardParameters {
1841
+ /**
1842
+ * REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
1843
+ */
1844
+ resource?: string;
1845
+ /**
1846
+ * Request body metadata
1847
+ */
1848
+ requestBody?: Schema$GoogleIamV1TestIamPermissionsRequest;
1849
+ }
1475
1850
  export class Resource$Projects$Locations$Bindings {
1476
1851
  context: APIRequestContext;
1477
1852
  constructor(context: APIRequestContext);
@@ -3680,6 +4055,76 @@ export declare namespace agentregistry_v1alpha {
3680
4055
  get(params: Params$Resource$Projects$Locations$Skills$Get, options: MethodOptions | BodyResponseCallback<Schema$Skill>, callback: BodyResponseCallback<Schema$Skill>): void;
3681
4056
  get(params: Params$Resource$Projects$Locations$Skills$Get, callback: BodyResponseCallback<Schema$Skill>): void;
3682
4057
  get(callback: BodyResponseCallback<Schema$Skill>): void;
4058
+ /**
4059
+ * Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
4060
+ * @example
4061
+ * ```js
4062
+ * // Before running the sample:
4063
+ * // - Enable the API at:
4064
+ * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com
4065
+ * // - Login into gcloud by running:
4066
+ * // ```sh
4067
+ * // $ gcloud auth application-default login
4068
+ * // ```
4069
+ * // - Install the npm module by running:
4070
+ * // ```sh
4071
+ * // $ npm install googleapis
4072
+ * // ```
4073
+ *
4074
+ * const {google} = require('googleapis');
4075
+ * const agentregistry = google.agentregistry('v1alpha');
4076
+ *
4077
+ * async function main() {
4078
+ * const auth = new google.auth.GoogleAuth({
4079
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4080
+ * scopes: [
4081
+ * 'https://www.googleapis.com/auth/agentregistry.read-only',
4082
+ * 'https://www.googleapis.com/auth/agentregistry.read-write',
4083
+ * 'https://www.googleapis.com/auth/cloud-platform',
4084
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
4085
+ * ],
4086
+ * });
4087
+ *
4088
+ * // Acquire an auth client, and bind it to all future calls
4089
+ * const authClient = await auth.getClient();
4090
+ * google.options({auth: authClient});
4091
+ *
4092
+ * // Do the magic
4093
+ * const res = await agentregistry.projects.locations.skills.getIamPolicy({
4094
+ * // Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
4095
+ * 'options.requestedPolicyVersion': 'placeholder-value',
4096
+ * // REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
4097
+ * resource: 'projects/my-project/locations/my-location/skills/my-skill',
4098
+ * });
4099
+ * console.log(res.data);
4100
+ *
4101
+ * // Example response
4102
+ * // {
4103
+ * // "auditConfigs": [],
4104
+ * // "bindings": [],
4105
+ * // "etag": "my_etag",
4106
+ * // "version": 0
4107
+ * // }
4108
+ * }
4109
+ *
4110
+ * main().catch(e => {
4111
+ * console.error(e);
4112
+ * throw e;
4113
+ * });
4114
+ *
4115
+ * ```
4116
+ *
4117
+ * @param params - Parameters for request
4118
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
4119
+ * @param callback - Optional callback that handles the response.
4120
+ * @returns A promise if used with async/await, or void if used with a callback.
4121
+ */
4122
+ getIamPolicy(params: Params$Resource$Projects$Locations$Skills$Getiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
4123
+ getIamPolicy(params?: Params$Resource$Projects$Locations$Skills$Getiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
4124
+ getIamPolicy(params: Params$Resource$Projects$Locations$Skills$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
4125
+ getIamPolicy(params: Params$Resource$Projects$Locations$Skills$Getiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
4126
+ getIamPolicy(params: Params$Resource$Projects$Locations$Skills$Getiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
4127
+ getIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
3683
4128
  /**
3684
4129
  * Lists logical Skills available in a project.
3685
4130
  * @example
@@ -3716,7 +4161,7 @@ export declare namespace agentregistry_v1alpha {
3716
4161
  *
3717
4162
  * // Do the magic
3718
4163
  * const res = await agentregistry.projects.locations.skills.list({
3719
- * // Optional. Use this field to specify filter criteria on list results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |----------------------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | | publisher | Yes | No | | frontmatter.metadata. | Yes | No | | attributes.. | Yes | No | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state. * `frontmatter.metadata.version=10` to restrict results to skills with a frontmatter metadata `version` equal to `10`.
4164
+ * // Optional. Use this field to specify filter criteria on list results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
3720
4165
  * filter: 'placeholder-value',
3721
4166
  * // Optional. Hint for how to order the results
3722
4167
  * orderBy: 'placeholder-value',
@@ -3885,7 +4330,7 @@ export declare namespace agentregistry_v1alpha {
3885
4330
  *
3886
4331
  * // Do the magic
3887
4332
  * const res = await agentregistry.projects.locations.skills.search({
3888
- * // Optional. Use this field to specify additional filter criteria on search results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |----------------------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | | publisher | Yes | No | | frontmatter.metadata. | Yes | No | | attributes.. | Yes | No | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state. * `frontmatter.metadata.version=10` to restrict results to skills with a frontmatter metadata `version` equal to `10`.
4333
+ * // Optional. Use this field to specify additional filter criteria on search results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
3889
4334
  * filter: 'placeholder-value',
3890
4335
  * // Optional. The maximum number of search results to return per page. The page size is capped at `100`, even if a larger value is specified. A negative value will result in an `INVALID_ARGUMENT` error. If unspecified or set to `0`, a default value of `20` will be used. The server may return fewer results than requested.
3891
4336
  * pageSize: 'placeholder-value',
@@ -3893,7 +4338,7 @@ export declare namespace agentregistry_v1alpha {
3893
4338
  * pageToken: 'placeholder-value',
3894
4339
  * // Required. Parent value for SearchSkillsRequest. Format: `projects/{project\}/locations/{location\}`.
3895
4340
  * parent: 'projects/my-project/locations/my-location',
3896
- * // Optional. Search criteria used to select the Skills to return. If no search criteria is specified then all accessible Skills will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |----------------------------|-----|-----|-----|----------------| | skillId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | publisher | No | Yes | Yes | Excluded | | frontmatter.name | No | Yes | No | Included | | frontmatter.description | No | Yes | No | Included | | frontmatter.compatibility | No | Yes | No | Included | | frontmatter.license | No | Yes | No | Included | | frontmatter.metadata. | No | Yes | No | Excluded | | attributes.. | No | Yes | No | Excluded | Examples: * `skillId="urn:skill:projects-1234:locations:global:private-important-skill"` to find the skill with the specified skill ID. * `name:important` to find skills whose name contains `important` as a word. * `displayName:works*` to find skills whose display name contains words that start with `works`. * `frontmatter.metadata.author:alice` to find skills whose frontmatter metadata `author` contains words that start with `alice`.
4341
+ * // Optional. Search criteria used to select the Skills to return. If no search criteria is specified then all accessible Skills will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |---------------------------|-----|-----|-----|----------------| | skillId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | frontmatter.name | No | Yes | No | Included | | frontmatter.description | No | Yes | No | Included | | frontmatter.compatibility | No | Yes | No | Included | | frontmatter.license | No | Yes | No | Included | Examples: * `skillId="urn:skill:projects-1234:locations:global:private-important-skill"` to find the skill with the specified skill ID. * `name:important` to find skills whose name contains `important` as a word. * `displayName:works*` to find skills whose display name contains words that start with `works`.
3897
4342
  * searchString: 'placeholder-value',
3898
4343
  * // Optional. The type of search.
3899
4344
  * searchType: 'placeholder-value',
@@ -3925,6 +4370,154 @@ export declare namespace agentregistry_v1alpha {
3925
4370
  search(params: Params$Resource$Projects$Locations$Skills$Search, options: MethodOptions | BodyResponseCallback<Schema$SearchSkillsResponse>, callback: BodyResponseCallback<Schema$SearchSkillsResponse>): void;
3926
4371
  search(params: Params$Resource$Projects$Locations$Skills$Search, callback: BodyResponseCallback<Schema$SearchSkillsResponse>): void;
3927
4372
  search(callback: BodyResponseCallback<Schema$SearchSkillsResponse>): void;
4373
+ /**
4374
+ * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
4375
+ * @example
4376
+ * ```js
4377
+ * // Before running the sample:
4378
+ * // - Enable the API at:
4379
+ * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com
4380
+ * // - Login into gcloud by running:
4381
+ * // ```sh
4382
+ * // $ gcloud auth application-default login
4383
+ * // ```
4384
+ * // - Install the npm module by running:
4385
+ * // ```sh
4386
+ * // $ npm install googleapis
4387
+ * // ```
4388
+ *
4389
+ * const {google} = require('googleapis');
4390
+ * const agentregistry = google.agentregistry('v1alpha');
4391
+ *
4392
+ * async function main() {
4393
+ * const auth = new google.auth.GoogleAuth({
4394
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4395
+ * scopes: [
4396
+ * 'https://www.googleapis.com/auth/agentregistry.read-write',
4397
+ * 'https://www.googleapis.com/auth/cloud-platform',
4398
+ * ],
4399
+ * });
4400
+ *
4401
+ * // Acquire an auth client, and bind it to all future calls
4402
+ * const authClient = await auth.getClient();
4403
+ * google.options({auth: authClient});
4404
+ *
4405
+ * // Do the magic
4406
+ * const res = await agentregistry.projects.locations.skills.setIamPolicy({
4407
+ * // REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
4408
+ * resource: 'projects/my-project/locations/my-location/skills/my-skill',
4409
+ *
4410
+ * // Request body metadata
4411
+ * requestBody: {
4412
+ * // request body parameters
4413
+ * // {
4414
+ * // "policy": {},
4415
+ * // "updateMask": "my_updateMask"
4416
+ * // }
4417
+ * },
4418
+ * });
4419
+ * console.log(res.data);
4420
+ *
4421
+ * // Example response
4422
+ * // {
4423
+ * // "auditConfigs": [],
4424
+ * // "bindings": [],
4425
+ * // "etag": "my_etag",
4426
+ * // "version": 0
4427
+ * // }
4428
+ * }
4429
+ *
4430
+ * main().catch(e => {
4431
+ * console.error(e);
4432
+ * throw e;
4433
+ * });
4434
+ *
4435
+ * ```
4436
+ *
4437
+ * @param params - Parameters for request
4438
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
4439
+ * @param callback - Optional callback that handles the response.
4440
+ * @returns A promise if used with async/await, or void if used with a callback.
4441
+ */
4442
+ setIamPolicy(params: Params$Resource$Projects$Locations$Skills$Setiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
4443
+ setIamPolicy(params?: Params$Resource$Projects$Locations$Skills$Setiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1Policy>>;
4444
+ setIamPolicy(params: Params$Resource$Projects$Locations$Skills$Setiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
4445
+ setIamPolicy(params: Params$Resource$Projects$Locations$Skills$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1Policy>, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
4446
+ setIamPolicy(params: Params$Resource$Projects$Locations$Skills$Setiampolicy, callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
4447
+ setIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
4448
+ /**
4449
+ * Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.
4450
+ * @example
4451
+ * ```js
4452
+ * // Before running the sample:
4453
+ * // - Enable the API at:
4454
+ * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com
4455
+ * // - Login into gcloud by running:
4456
+ * // ```sh
4457
+ * // $ gcloud auth application-default login
4458
+ * // ```
4459
+ * // - Install the npm module by running:
4460
+ * // ```sh
4461
+ * // $ npm install googleapis
4462
+ * // ```
4463
+ *
4464
+ * const {google} = require('googleapis');
4465
+ * const agentregistry = google.agentregistry('v1alpha');
4466
+ *
4467
+ * async function main() {
4468
+ * const auth = new google.auth.GoogleAuth({
4469
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4470
+ * scopes: [
4471
+ * 'https://www.googleapis.com/auth/agentregistry.read-only',
4472
+ * 'https://www.googleapis.com/auth/agentregistry.read-write',
4473
+ * 'https://www.googleapis.com/auth/cloud-platform',
4474
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
4475
+ * ],
4476
+ * });
4477
+ *
4478
+ * // Acquire an auth client, and bind it to all future calls
4479
+ * const authClient = await auth.getClient();
4480
+ * google.options({auth: authClient});
4481
+ *
4482
+ * // Do the magic
4483
+ * const res = await agentregistry.projects.locations.skills.testIamPermissions({
4484
+ * // REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
4485
+ * resource: 'projects/my-project/locations/my-location/skills/my-skill',
4486
+ *
4487
+ * // Request body metadata
4488
+ * requestBody: {
4489
+ * // request body parameters
4490
+ * // {
4491
+ * // "permissions": []
4492
+ * // }
4493
+ * },
4494
+ * });
4495
+ * console.log(res.data);
4496
+ *
4497
+ * // Example response
4498
+ * // {
4499
+ * // "permissions": []
4500
+ * // }
4501
+ * }
4502
+ *
4503
+ * main().catch(e => {
4504
+ * console.error(e);
4505
+ * throw e;
4506
+ * });
4507
+ *
4508
+ * ```
4509
+ *
4510
+ * @param params - Parameters for request
4511
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
4512
+ * @param callback - Optional callback that handles the response.
4513
+ * @returns A promise if used with async/await, or void if used with a callback.
4514
+ */
4515
+ testIamPermissions(params: Params$Resource$Projects$Locations$Skills$Testiampermissions, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
4516
+ testIamPermissions(params?: Params$Resource$Projects$Locations$Skills$Testiampermissions, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleIamV1TestIamPermissionsResponse>>;
4517
+ testIamPermissions(params: Params$Resource$Projects$Locations$Skills$Testiampermissions, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
4518
+ testIamPermissions(params: Params$Resource$Projects$Locations$Skills$Testiampermissions, options: MethodOptions | BodyResponseCallback<Schema$GoogleIamV1TestIamPermissionsResponse>, callback: BodyResponseCallback<Schema$GoogleIamV1TestIamPermissionsResponse>): void;
4519
+ testIamPermissions(params: Params$Resource$Projects$Locations$Skills$Testiampermissions, callback: BodyResponseCallback<Schema$GoogleIamV1TestIamPermissionsResponse>): void;
4520
+ testIamPermissions(callback: BodyResponseCallback<Schema$GoogleIamV1TestIamPermissionsResponse>): void;
3928
4521
  }
3929
4522
  export interface Params$Resource$Projects$Locations$Skills$Create extends StandardParameters {
3930
4523
  /**
@@ -3964,9 +4557,19 @@ export declare namespace agentregistry_v1alpha {
3964
4557
  */
3965
4558
  name?: string;
3966
4559
  }
4560
+ export interface Params$Resource$Projects$Locations$Skills$Getiampolicy extends StandardParameters {
4561
+ /**
4562
+ * Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
4563
+ */
4564
+ 'options.requestedPolicyVersion'?: number;
4565
+ /**
4566
+ * REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
4567
+ */
4568
+ resource?: string;
4569
+ }
3967
4570
  export interface Params$Resource$Projects$Locations$Skills$List extends StandardParameters {
3968
4571
  /**
3969
- * Optional. Use this field to specify filter criteria on list results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |----------------------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | | publisher | Yes | No | | frontmatter.metadata. | Yes | No | | attributes.. | Yes | No | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state. * `frontmatter.metadata.version=10` to restrict results to skills with a frontmatter metadata `version` equal to `10`.
4572
+ * Optional. Use this field to specify filter criteria on list results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
3970
4573
  */
3971
4574
  filter?: string;
3972
4575
  /**
@@ -4006,7 +4609,7 @@ export declare namespace agentregistry_v1alpha {
4006
4609
  }
4007
4610
  export interface Params$Resource$Projects$Locations$Skills$Search extends StandardParameters {
4008
4611
  /**
4009
- * Optional. Use this field to specify additional filter criteria on search results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |----------------------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | | publisher | Yes | No | | frontmatter.metadata. | Yes | No | | attributes.. | Yes | No | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state. * `frontmatter.metadata.version=10` to restrict results to skills with a frontmatter metadata `version` equal to `10`.
4612
+ * Optional. Use this field to specify additional filter criteria on search results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
4010
4613
  */
4011
4614
  filter?: string;
4012
4615
  /**
@@ -4022,7 +4625,7 @@ export declare namespace agentregistry_v1alpha {
4022
4625
  */
4023
4626
  parent?: string;
4024
4627
  /**
4025
- * Optional. Search criteria used to select the Skills to return. If no search criteria is specified then all accessible Skills will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |----------------------------|-----|-----|-----|----------------| | skillId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | publisher | No | Yes | Yes | Excluded | | frontmatter.name | No | Yes | No | Included | | frontmatter.description | No | Yes | No | Included | | frontmatter.compatibility | No | Yes | No | Included | | frontmatter.license | No | Yes | No | Included | | frontmatter.metadata. | No | Yes | No | Excluded | | attributes.. | No | Yes | No | Excluded | Examples: * `skillId="urn:skill:projects-1234:locations:global:private-important-skill"` to find the skill with the specified skill ID. * `name:important` to find skills whose name contains `important` as a word. * `displayName:works*` to find skills whose display name contains words that start with `works`. * `frontmatter.metadata.author:alice` to find skills whose frontmatter metadata `author` contains words that start with `alice`.
4628
+ * Optional. Search criteria used to select the Skills to return. If no search criteria is specified then all accessible Skills will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |---------------------------|-----|-----|-----|----------------| | skillId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | frontmatter.name | No | Yes | No | Included | | frontmatter.description | No | Yes | No | Included | | frontmatter.compatibility | No | Yes | No | Included | | frontmatter.license | No | Yes | No | Included | Examples: * `skillId="urn:skill:projects-1234:locations:global:private-important-skill"` to find the skill with the specified skill ID. * `name:important` to find skills whose name contains `important` as a word. * `displayName:works*` to find skills whose display name contains words that start with `works`.
4026
4629
  */
4027
4630
  searchString?: string;
4028
4631
  /**
@@ -4030,6 +4633,26 @@ export declare namespace agentregistry_v1alpha {
4030
4633
  */
4031
4634
  searchType?: string;
4032
4635
  }
4636
+ export interface Params$Resource$Projects$Locations$Skills$Setiampolicy extends StandardParameters {
4637
+ /**
4638
+ * REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
4639
+ */
4640
+ resource?: string;
4641
+ /**
4642
+ * Request body metadata
4643
+ */
4644
+ requestBody?: Schema$GoogleIamV1SetIamPolicyRequest;
4645
+ }
4646
+ export interface Params$Resource$Projects$Locations$Skills$Testiampermissions extends StandardParameters {
4647
+ /**
4648
+ * REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
4649
+ */
4650
+ resource?: string;
4651
+ /**
4652
+ * Request body metadata
4653
+ */
4654
+ requestBody?: Schema$GoogleIamV1TestIamPermissionsRequest;
4655
+ }
4033
4656
  export class Resource$Projects$Locations$Skills$Revisions {
4034
4657
  context: APIRequestContext;
4035
4658
  constructor(context: APIRequestContext);