google-apis-agentregistry_v1alpha 0.4.0 → 0.5.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f2aaa05c9d0922d4fa4c7c0a19972f2b73707381d2385bb43cd3910974dfbe13
4
- data.tar.gz: 3f346a2f655de90092f650dcbe7b775857899a499c63d5aaa8cd4e560bb739f6
3
+ metadata.gz: a8930d54e6edc372ab5a80b7ae9c6676de68a40b344eea4dcfab7090290d428a
4
+ data.tar.gz: bb3dec4dd7833fed06db164279e719a59e34dea09fb0c85af8604e0066944dee
5
5
  SHA512:
6
- metadata.gz: 178586a6c3364930d600527f5dd243e9b6d66b58e321a6135353e203ada6778bc697f24c91c092cb0b66c58b30ba5c03a76ed2dcfe585302336a70fd95d0dc6d
7
- data.tar.gz: a5cc66b1688720b6407e12114269942dc39d1f5729e65979307620a3838fcf46d31429a4a5470de0c708e309220b8986a53e01cc2cb1b9f08f099170acdec956
6
+ metadata.gz: feb26b881e0f008a78a48760987ea4753a3a75e4dac4ad7090a7effb3eb71fa2194eb4b1c85fcca31d4e83603a79ad4cd37db2399330a08aae2c595be9f064e1
7
+ data.tar.gz: '0930be9bd24d96883041faf17b1a85e0305a3b326df1514892eae30a0baa2f9c622f8a1e13517256fadd76cac3f903712a0f9afda466d2bb22e1dd76be995fb6'
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-agentregistry_v1alpha
2
2
 
3
+ ### v0.5.0 (2026-07-26)
4
+
5
+ * Regenerated from discovery document revision 20260722
6
+
3
7
  ### v0.4.0 (2026-06-14)
4
8
 
5
9
  * Regenerated from discovery document revision 20260608
@@ -250,6 +250,27 @@ module Google
250
250
  end
251
251
  end
252
252
 
253
+ # Direct write-only raw archive payload upload.
254
+ class ArchiveUploadSource
255
+ include Google::Apis::Core::Hashable
256
+
257
+ # Required. Input only. Write-only raw ZIP/TAR archive payload bytes containing
258
+ # the skill package.
259
+ # Corresponds to the JSON property `archiveContent`
260
+ # NOTE: Values are automatically base64 encoded/decoded in the client library.
261
+ # @return [String]
262
+ attr_accessor :archive_content
263
+
264
+ def initialize(**args)
265
+ update!(**args)
266
+ end
267
+
268
+ # Update properties of this object
269
+ def update!(**args)
270
+ @archive_content = args[:archive_content] if args.key?(:archive_content)
271
+ end
272
+ end
273
+
253
274
  # The AuthProvider of the Binding.
254
275
  class AuthProviderBinding
255
276
  include Google::Apis::Core::Hashable
@@ -515,6 +536,77 @@ module Google
515
536
  end
516
537
  end
517
538
 
539
+ # Structured metadata attributes extracted from the package's local SKILL.md
540
+ # frontmatter.
541
+ class Frontmatter
542
+ include Google::Apis::Core::Hashable
543
+
544
+ # Optional. Environmental dependencies or local sidecars.
545
+ # Corresponds to the JSON property `compatibility`
546
+ # @return [String]
547
+ attr_accessor :compatibility
548
+
549
+ # Required. Functional description.
550
+ # Corresponds to the JSON property `description`
551
+ # @return [String]
552
+ attr_accessor :description
553
+
554
+ # Optional. License.
555
+ # Corresponds to the JSON property `license`
556
+ # @return [String]
557
+ attr_accessor :license
558
+
559
+ # Optional. Extensible flattened map mapping custom tags, authors, and version
560
+ # parameters.
561
+ # Corresponds to the JSON property `metadata`
562
+ # @return [Hash<String,String>]
563
+ attr_accessor :metadata
564
+
565
+ # Required. The name of the skill.
566
+ # Corresponds to the JSON property `name`
567
+ # @return [String]
568
+ attr_accessor :name
569
+
570
+ def initialize(**args)
571
+ update!(**args)
572
+ end
573
+
574
+ # Update properties of this object
575
+ def update!(**args)
576
+ @compatibility = args[:compatibility] if args.key?(:compatibility)
577
+ @description = args[:description] if args.key?(:description)
578
+ @license = args[:license] if args.key?(:license)
579
+ @metadata = args[:metadata] if args.key?(:metadata)
580
+ @name = args[:name] if args.key?(:name)
581
+ end
582
+ end
583
+
584
+ # Specifications for Cloud Storage objects.
585
+ class GcsSource
586
+ include Google::Apis::Core::Hashable
587
+
588
+ # Optional. Cloud Storage object generation ID. If not specified, the latest
589
+ # generation is used.
590
+ # Corresponds to the JSON property `generation`
591
+ # @return [Fixnum]
592
+ attr_accessor :generation
593
+
594
+ # Required. Cloud Storage object URI. Format: `gs://`bucket_name`/`object_name``
595
+ # Corresponds to the JSON property `uri`
596
+ # @return [String]
597
+ attr_accessor :uri
598
+
599
+ def initialize(**args)
600
+ update!(**args)
601
+ end
602
+
603
+ # Update properties of this object
604
+ def update!(**args)
605
+ @generation = args[:generation] if args.key?(:generation)
606
+ @uri = args[:uri] if args.key?(:uri)
607
+ end
608
+ end
609
+
518
610
  # Represents the connection details for an Agent or MCP Server.
519
611
  class Interface
520
612
  include Google::Apis::Core::Hashable
@@ -705,6 +797,31 @@ module Google
705
797
  end
706
798
  end
707
799
 
800
+ # Response listing Publishers.
801
+ class ListPublishersResponse
802
+ include Google::Apis::Core::Hashable
803
+
804
+ # Page offset continuation token.
805
+ # Corresponds to the JSON property `nextPageToken`
806
+ # @return [String]
807
+ attr_accessor :next_page_token
808
+
809
+ # The returned list of Publishers.
810
+ # Corresponds to the JSON property `publishers`
811
+ # @return [Array<Google::Apis::AgentregistryV1alpha::Publisher>]
812
+ attr_accessor :publishers
813
+
814
+ def initialize(**args)
815
+ update!(**args)
816
+ end
817
+
818
+ # Update properties of this object
819
+ def update!(**args)
820
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
821
+ @publishers = args[:publishers] if args.key?(:publishers)
822
+ end
823
+ end
824
+
708
825
  # Message for response to listing Services
709
826
  class ListServicesResponse
710
827
  include Google::Apis::Core::Hashable
@@ -733,6 +850,62 @@ module Google
733
850
  end
734
851
  end
735
852
 
853
+ # Response listing Revisions.
854
+ class ListSkillRevisionsResponse
855
+ include Google::Apis::Core::Hashable
856
+
857
+ # Page offset continuation token.
858
+ # Corresponds to the JSON property `nextPageToken`
859
+ # @return [String]
860
+ attr_accessor :next_page_token
861
+
862
+ # Returned version snapshot list.
863
+ # Corresponds to the JSON property `skillRevisions`
864
+ # @return [Array<Google::Apis::AgentregistryV1alpha::SkillRevision>]
865
+ attr_accessor :skill_revisions
866
+
867
+ def initialize(**args)
868
+ update!(**args)
869
+ end
870
+
871
+ # Update properties of this object
872
+ def update!(**args)
873
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
874
+ @skill_revisions = args[:skill_revisions] if args.key?(:skill_revisions)
875
+ end
876
+ end
877
+
878
+ # Response structure listing logical Skills.
879
+ class ListSkillsResponse
880
+ include Google::Apis::Core::Hashable
881
+
882
+ # Page continuation continuation token.
883
+ # Corresponds to the JSON property `nextPageToken`
884
+ # @return [String]
885
+ attr_accessor :next_page_token
886
+
887
+ # Returned container list.
888
+ # Corresponds to the JSON property `skills`
889
+ # @return [Array<Google::Apis::AgentregistryV1alpha::Skill>]
890
+ attr_accessor :skills
891
+
892
+ # Unreachable locations or failures.
893
+ # Corresponds to the JSON property `unreachable`
894
+ # @return [Array<String>]
895
+ attr_accessor :unreachable
896
+
897
+ def initialize(**args)
898
+ update!(**args)
899
+ end
900
+
901
+ # Update properties of this object
902
+ def update!(**args)
903
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
904
+ @skills = args[:skills] if args.key?(:skills)
905
+ @unreachable = args[:unreachable] if args.key?(:unreachable)
906
+ end
907
+ end
908
+
736
909
  # A resource that represents a Google Cloud location.
737
910
  class Location
738
911
  include Google::Apis::Core::Hashable
@@ -1032,6 +1205,59 @@ module Google
1032
1205
  end
1033
1206
  end
1034
1207
 
1208
+ # Represents a verified Publisher of Skills. Prepopulated publishers include `
1209
+ # publishers/cloud.google.com` and `publishers/workspace.google.com`.
1210
+ class Publisher
1211
+ include Google::Apis::Core::Hashable
1212
+
1213
+ # Optional. Human readable display name of the publisher.
1214
+ # Corresponds to the JSON property `displayName`
1215
+ # @return [String]
1216
+ attr_accessor :display_name
1217
+
1218
+ # Optional. URI pointing to official publisher documentation.
1219
+ # Corresponds to the JSON property `documentationUri`
1220
+ # @return [String]
1221
+ attr_accessor :documentation_uri
1222
+
1223
+ # Identifier. Resource name of the publisher. Format: `projects/`project`/
1224
+ # locations/`location`/publishers/`publisher``
1225
+ # Corresponds to the JSON property `name`
1226
+ # @return [String]
1227
+ attr_accessor :name
1228
+
1229
+ # Output only. The curation tier of the publisher.
1230
+ # Corresponds to the JSON property `publisherTier`
1231
+ # @return [String]
1232
+ attr_accessor :publisher_tier
1233
+
1234
+ # Optional. URI pointing to the support portal or email.
1235
+ # Corresponds to the JSON property `supportUri`
1236
+ # @return [String]
1237
+ attr_accessor :support_uri
1238
+
1239
+ # Required. The verified prefix (e.g. "snowflake-", "google-") associated with
1240
+ # this publisher. The system uses this prefix to enforce name-squatting rules
1241
+ # during Skill registration. Must be globally unique across all publishers.
1242
+ # Corresponds to the JSON property `verifiedPrefix`
1243
+ # @return [String]
1244
+ attr_accessor :verified_prefix
1245
+
1246
+ def initialize(**args)
1247
+ update!(**args)
1248
+ end
1249
+
1250
+ # Update properties of this object
1251
+ def update!(**args)
1252
+ @display_name = args[:display_name] if args.key?(:display_name)
1253
+ @documentation_uri = args[:documentation_uri] if args.key?(:documentation_uri)
1254
+ @name = args[:name] if args.key?(:name)
1255
+ @publisher_tier = args[:publisher_tier] if args.key?(:publisher_tier)
1256
+ @support_uri = args[:support_uri] if args.key?(:support_uri)
1257
+ @verified_prefix = args[:verified_prefix] if args.key?(:verified_prefix)
1258
+ end
1259
+ end
1260
+
1035
1261
  # Message for searching Agents
1036
1262
  class SearchAgentsRequest
1037
1263
  include Google::Apis::Core::Hashable
@@ -1198,6 +1424,31 @@ module Google
1198
1424
  end
1199
1425
  end
1200
1426
 
1427
+ # Response listing searched Skills.
1428
+ class SearchSkillsResponse
1429
+ include Google::Apis::Core::Hashable
1430
+
1431
+ # Query page offset continuation token.
1432
+ # Corresponds to the JSON property `nextPageToken`
1433
+ # @return [String]
1434
+ attr_accessor :next_page_token
1435
+
1436
+ # Matched Skills list.
1437
+ # Corresponds to the JSON property `skills`
1438
+ # @return [Array<Google::Apis::AgentregistryV1alpha::Skill>]
1439
+ attr_accessor :skills
1440
+
1441
+ def initialize(**args)
1442
+ update!(**args)
1443
+ end
1444
+
1445
+ # Update properties of this object
1446
+ def update!(**args)
1447
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1448
+ @skills = args[:skills] if args.key?(:skills)
1449
+ end
1450
+ end
1451
+
1201
1452
  # Represents a user-defined Service.
1202
1453
  class Service
1203
1454
  include Google::Apis::Core::Hashable
@@ -1277,6 +1528,192 @@ module Google
1277
1528
  end
1278
1529
  end
1279
1530
 
1531
+ # Represents an Executable Agent Skill or a Composite Tool Suite (Bundle).
1532
+ # Sibling resource with Agent and McpServer under agentregistry.googleapis.com.
1533
+ class Skill
1534
+ include Google::Apis::Core::Hashable
1535
+
1536
+ # Output only. Create time.
1537
+ # Corresponds to the JSON property `createTime`
1538
+ # @return [String]
1539
+ attr_accessor :create_time
1540
+
1541
+ # Optional. The full resource name of the revision currently served by default (
1542
+ # floating track). Format: `projects/`project`/locations/`location`/skills/`
1543
+ # skill`/revisions/`revision``
1544
+ # Corresponds to the JSON property `defaultRevision`
1545
+ # @return [String]
1546
+ attr_accessor :default_revision
1547
+
1548
+ # Optional. Brief summary describing the capabilities of the skill. Maximum
1549
+ # length is 2048 characters.
1550
+ # Corresponds to the JSON property `description`
1551
+ # @return [String]
1552
+ attr_accessor :description
1553
+
1554
+ # Required. Human-readable display name of the skill. Maximum length is 128
1555
+ # characters.
1556
+ # Corresponds to the JSON property `displayName`
1557
+ # @return [String]
1558
+ attr_accessor :display_name
1559
+
1560
+ # Structured metadata attributes extracted from the package's local SKILL.md
1561
+ # frontmatter.
1562
+ # Corresponds to the JSON property `frontmatter`
1563
+ # @return [Google::Apis::AgentregistryV1alpha::Frontmatter]
1564
+ attr_accessor :frontmatter
1565
+
1566
+ # Represents an immutable, versioned snapshot of a Skill package.
1567
+ # Corresponds to the JSON property `initialRevision`
1568
+ # @return [Google::Apis::AgentregistryV1alpha::SkillRevision]
1569
+ attr_accessor :initial_revision
1570
+
1571
+ # Identifier. Resource name of the Skill. Format: `projects/`project`/locations/`
1572
+ # location`/skills/`skill`` The ``skill`` segment acts as the resource ID. If
1573
+ # the skill is associated with a Publisher, this segment typically uses a
1574
+ # hyphenated namespace prefix corresponding to the publisher (e.g., `google-
1575
+ # workspace-create-docs`).
1576
+ # Corresponds to the JSON property `name`
1577
+ # @return [String]
1578
+ attr_accessor :name
1579
+
1580
+ # Optional. The publisher resource associated with this skill. Format: `projects/
1581
+ # `project`/locations/`location`/publishers/`publisher`` The publisher dictates
1582
+ # the allowed namespace prefixes for the skill's name and logical `skill_id` (e.
1583
+ # g., Publisher `google` authorizes the `google-*` prefix).
1584
+ # Corresponds to the JSON property `publisher`
1585
+ # @return [String]
1586
+ attr_accessor :publisher
1587
+
1588
+ # Output only. A stable, globally unique logical identifier for the skill. It is
1589
+ # securely constructed by the backend by combining the associated `publisher`'s
1590
+ # verified namespace and the skill's resource ID to enforce strict ownership.
1591
+ # For example, the prefix `google-` is reserved exclusively for first-party
1592
+ # Google publishers to prevent namespace squatting. Example: `urn:skill:google-
1593
+ # workspace:create-docs`
1594
+ # Corresponds to the JSON property `skillId`
1595
+ # @return [String]
1596
+ attr_accessor :skill_id
1597
+
1598
+ # Output only. The system-managed state of the skill.
1599
+ # Corresponds to the JSON property `state`
1600
+ # @return [String]
1601
+ attr_accessor :state
1602
+
1603
+ # Required. User-managed target state of the skill.
1604
+ # Corresponds to the JSON property `targetState`
1605
+ # @return [String]
1606
+ attr_accessor :target_state
1607
+
1608
+ # Required. Structural deployment type (SIMPLE leaf vs COMPOSITE bundle).
1609
+ # Corresponds to the JSON property `type`
1610
+ # @return [String]
1611
+ attr_accessor :type
1612
+
1613
+ # Output only. Universally unique identifier (UUID4) for the logical container.
1614
+ # Corresponds to the JSON property `uid`
1615
+ # @return [String]
1616
+ attr_accessor :uid
1617
+
1618
+ # Output only. Update time.
1619
+ # Corresponds to the JSON property `updateTime`
1620
+ # @return [String]
1621
+ attr_accessor :update_time
1622
+
1623
+ def initialize(**args)
1624
+ update!(**args)
1625
+ end
1626
+
1627
+ # Update properties of this object
1628
+ def update!(**args)
1629
+ @create_time = args[:create_time] if args.key?(:create_time)
1630
+ @default_revision = args[:default_revision] if args.key?(:default_revision)
1631
+ @description = args[:description] if args.key?(:description)
1632
+ @display_name = args[:display_name] if args.key?(:display_name)
1633
+ @frontmatter = args[:frontmatter] if args.key?(:frontmatter)
1634
+ @initial_revision = args[:initial_revision] if args.key?(:initial_revision)
1635
+ @name = args[:name] if args.key?(:name)
1636
+ @publisher = args[:publisher] if args.key?(:publisher)
1637
+ @skill_id = args[:skill_id] if args.key?(:skill_id)
1638
+ @state = args[:state] if args.key?(:state)
1639
+ @target_state = args[:target_state] if args.key?(:target_state)
1640
+ @type = args[:type] if args.key?(:type)
1641
+ @uid = args[:uid] if args.key?(:uid)
1642
+ @update_time = args[:update_time] if args.key?(:update_time)
1643
+ end
1644
+ end
1645
+
1646
+ # Represents an immutable, versioned snapshot of a Skill package.
1647
+ class SkillRevision
1648
+ include Google::Apis::Core::Hashable
1649
+
1650
+ # Direct write-only raw archive payload upload.
1651
+ # Corresponds to the JSON property `archiveUploadSource`
1652
+ # @return [Google::Apis::AgentregistryV1alpha::ArchiveUploadSource]
1653
+ attr_accessor :archive_upload_source
1654
+
1655
+ # Output only. Revision creation timestamp.
1656
+ # Corresponds to the JSON property `createTime`
1657
+ # @return [String]
1658
+ attr_accessor :create_time
1659
+
1660
+ # Structured metadata attributes extracted from the package's local SKILL.md
1661
+ # frontmatter.
1662
+ # Corresponds to the JSON property `frontmatter`
1663
+ # @return [Google::Apis::AgentregistryV1alpha::Frontmatter]
1664
+ attr_accessor :frontmatter
1665
+
1666
+ # Specifications for Cloud Storage objects.
1667
+ # Corresponds to the JSON property `gcsSource`
1668
+ # @return [Google::Apis::AgentregistryV1alpha::GcsSource]
1669
+ attr_accessor :gcs_source
1670
+
1671
+ # Identifier. Resource name of the SkillRevision. Format: `projects/`project`/
1672
+ # locations/`location`/skills/`skill`/revisions/`revision``
1673
+ # Corresponds to the JSON property `name`
1674
+ # @return [String]
1675
+ attr_accessor :name
1676
+
1677
+ # Output only. Cryptographic SHA-256 integrity and deduplication digest of the
1678
+ # payload zip.
1679
+ # Corresponds to the JSON property `sha256Hash`
1680
+ # @return [String]
1681
+ attr_accessor :sha256_hash
1682
+
1683
+ # Output only. Size of the compiled zip payload in bytes (assists client
1684
+ # download progress).
1685
+ # Corresponds to the JSON property `sizeBytes`
1686
+ # @return [Fixnum]
1687
+ attr_accessor :size_bytes
1688
+
1689
+ # Output only. The system-managed lifecycle state of this revision.
1690
+ # Corresponds to the JSON property `state`
1691
+ # @return [String]
1692
+ attr_accessor :state
1693
+
1694
+ # Output only. Universally unique identifier (UUID4) for the skill revision.
1695
+ # Corresponds to the JSON property `uid`
1696
+ # @return [String]
1697
+ attr_accessor :uid
1698
+
1699
+ def initialize(**args)
1700
+ update!(**args)
1701
+ end
1702
+
1703
+ # Update properties of this object
1704
+ def update!(**args)
1705
+ @archive_upload_source = args[:archive_upload_source] if args.key?(:archive_upload_source)
1706
+ @create_time = args[:create_time] if args.key?(:create_time)
1707
+ @frontmatter = args[:frontmatter] if args.key?(:frontmatter)
1708
+ @gcs_source = args[:gcs_source] if args.key?(:gcs_source)
1709
+ @name = args[:name] if args.key?(:name)
1710
+ @sha256_hash = args[:sha256_hash] if args.key?(:sha256_hash)
1711
+ @size_bytes = args[:size_bytes] if args.key?(:size_bytes)
1712
+ @state = args[:state] if args.key?(:state)
1713
+ @uid = args[:uid] if args.key?(:uid)
1714
+ end
1715
+ end
1716
+
1280
1717
  # The source of the Binding.
1281
1718
  class Source
1282
1719
  include Google::Apis::Core::Hashable
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module AgentregistryV1alpha
18
18
  # Version of the google-apis-agentregistry_v1alpha gem
19
- GEM_VERSION = "0.4.0"
19
+ GEM_VERSION = "0.5.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.19.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20260608"
25
+ REVISION = "20260722"
26
26
  end
27
27
  end
28
28
  end
@@ -46,6 +46,12 @@ module Google
46
46
  include Google::Apis::Core::JsonObjectSupport
47
47
  end
48
48
 
49
+ class ArchiveUploadSource
50
+ class Representation < Google::Apis::Core::JsonRepresentation; end
51
+
52
+ include Google::Apis::Core::JsonObjectSupport
53
+ end
54
+
49
55
  class AuthProviderBinding
50
56
  class Representation < Google::Apis::Core::JsonRepresentation; end
51
57
 
@@ -94,6 +100,18 @@ module Google
94
100
  include Google::Apis::Core::JsonObjectSupport
95
101
  end
96
102
 
103
+ class Frontmatter
104
+ class Representation < Google::Apis::Core::JsonRepresentation; end
105
+
106
+ include Google::Apis::Core::JsonObjectSupport
107
+ end
108
+
109
+ class GcsSource
110
+ class Representation < Google::Apis::Core::JsonRepresentation; end
111
+
112
+ include Google::Apis::Core::JsonObjectSupport
113
+ end
114
+
97
115
  class Interface
98
116
  class Representation < Google::Apis::Core::JsonRepresentation; end
99
117
 
@@ -136,12 +154,30 @@ module Google
136
154
  include Google::Apis::Core::JsonObjectSupport
137
155
  end
138
156
 
157
+ class ListPublishersResponse
158
+ class Representation < Google::Apis::Core::JsonRepresentation; end
159
+
160
+ include Google::Apis::Core::JsonObjectSupport
161
+ end
162
+
139
163
  class ListServicesResponse
140
164
  class Representation < Google::Apis::Core::JsonRepresentation; end
141
165
 
142
166
  include Google::Apis::Core::JsonObjectSupport
143
167
  end
144
168
 
169
+ class ListSkillRevisionsResponse
170
+ class Representation < Google::Apis::Core::JsonRepresentation; end
171
+
172
+ include Google::Apis::Core::JsonObjectSupport
173
+ end
174
+
175
+ class ListSkillsResponse
176
+ class Representation < Google::Apis::Core::JsonRepresentation; end
177
+
178
+ include Google::Apis::Core::JsonObjectSupport
179
+ end
180
+
145
181
  class Location
146
182
  class Representation < Google::Apis::Core::JsonRepresentation; end
147
183
 
@@ -178,6 +214,12 @@ module Google
178
214
  include Google::Apis::Core::JsonObjectSupport
179
215
  end
180
216
 
217
+ class Publisher
218
+ class Representation < Google::Apis::Core::JsonRepresentation; end
219
+
220
+ include Google::Apis::Core::JsonObjectSupport
221
+ end
222
+
181
223
  class SearchAgentsRequest
182
224
  class Representation < Google::Apis::Core::JsonRepresentation; end
183
225
 
@@ -202,12 +244,30 @@ module Google
202
244
  include Google::Apis::Core::JsonObjectSupport
203
245
  end
204
246
 
247
+ class SearchSkillsResponse
248
+ class Representation < Google::Apis::Core::JsonRepresentation; end
249
+
250
+ include Google::Apis::Core::JsonObjectSupport
251
+ end
252
+
205
253
  class Service
206
254
  class Representation < Google::Apis::Core::JsonRepresentation; end
207
255
 
208
256
  include Google::Apis::Core::JsonObjectSupport
209
257
  end
210
258
 
259
+ class Skill
260
+ class Representation < Google::Apis::Core::JsonRepresentation; end
261
+
262
+ include Google::Apis::Core::JsonObjectSupport
263
+ end
264
+
265
+ class SkillRevision
266
+ class Representation < Google::Apis::Core::JsonRepresentation; end
267
+
268
+ include Google::Apis::Core::JsonObjectSupport
269
+ end
270
+
211
271
  class Source
212
272
  class Representation < Google::Apis::Core::JsonRepresentation; end
213
273
 
@@ -284,6 +344,13 @@ module Google
284
344
  end
285
345
  end
286
346
 
347
+ class ArchiveUploadSource
348
+ # @private
349
+ class Representation < Google::Apis::Core::JsonRepresentation
350
+ property :archive_content, :base64 => true, as: 'archiveContent'
351
+ end
352
+ end
353
+
287
354
  class AuthProviderBinding
288
355
  # @private
289
356
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -362,6 +429,25 @@ module Google
362
429
  end
363
430
  end
364
431
 
432
+ class Frontmatter
433
+ # @private
434
+ class Representation < Google::Apis::Core::JsonRepresentation
435
+ property :compatibility, as: 'compatibility'
436
+ property :description, as: 'description'
437
+ property :license, as: 'license'
438
+ hash :metadata, as: 'metadata'
439
+ property :name, as: 'name'
440
+ end
441
+ end
442
+
443
+ class GcsSource
444
+ # @private
445
+ class Representation < Google::Apis::Core::JsonRepresentation
446
+ property :generation, :numeric_string => true, as: 'generation'
447
+ property :uri, as: 'uri'
448
+ end
449
+ end
450
+
365
451
  class Interface
366
452
  # @private
367
453
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -425,6 +511,15 @@ module Google
425
511
  end
426
512
  end
427
513
 
514
+ class ListPublishersResponse
515
+ # @private
516
+ class Representation < Google::Apis::Core::JsonRepresentation
517
+ property :next_page_token, as: 'nextPageToken'
518
+ collection :publishers, as: 'publishers', class: Google::Apis::AgentregistryV1alpha::Publisher, decorator: Google::Apis::AgentregistryV1alpha::Publisher::Representation
519
+
520
+ end
521
+ end
522
+
428
523
  class ListServicesResponse
429
524
  # @private
430
525
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -434,6 +529,25 @@ module Google
434
529
  end
435
530
  end
436
531
 
532
+ class ListSkillRevisionsResponse
533
+ # @private
534
+ class Representation < Google::Apis::Core::JsonRepresentation
535
+ property :next_page_token, as: 'nextPageToken'
536
+ collection :skill_revisions, as: 'skillRevisions', class: Google::Apis::AgentregistryV1alpha::SkillRevision, decorator: Google::Apis::AgentregistryV1alpha::SkillRevision::Representation
537
+
538
+ end
539
+ end
540
+
541
+ class ListSkillsResponse
542
+ # @private
543
+ class Representation < Google::Apis::Core::JsonRepresentation
544
+ property :next_page_token, as: 'nextPageToken'
545
+ collection :skills, as: 'skills', class: Google::Apis::AgentregistryV1alpha::Skill, decorator: Google::Apis::AgentregistryV1alpha::Skill::Representation
546
+
547
+ collection :unreachable, as: 'unreachable'
548
+ end
549
+ end
550
+
437
551
  class Location
438
552
  # @private
439
553
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -505,6 +619,18 @@ module Google
505
619
  end
506
620
  end
507
621
 
622
+ class Publisher
623
+ # @private
624
+ class Representation < Google::Apis::Core::JsonRepresentation
625
+ property :display_name, as: 'displayName'
626
+ property :documentation_uri, as: 'documentationUri'
627
+ property :name, as: 'name'
628
+ property :publisher_tier, as: 'publisherTier'
629
+ property :support_uri, as: 'supportUri'
630
+ property :verified_prefix, as: 'verifiedPrefix'
631
+ end
632
+ end
633
+
508
634
  class SearchAgentsRequest
509
635
  # @private
510
636
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -541,6 +667,15 @@ module Google
541
667
  end
542
668
  end
543
669
 
670
+ class SearchSkillsResponse
671
+ # @private
672
+ class Representation < Google::Apis::Core::JsonRepresentation
673
+ property :next_page_token, as: 'nextPageToken'
674
+ collection :skills, as: 'skills', class: Google::Apis::AgentregistryV1alpha::Skill, decorator: Google::Apis::AgentregistryV1alpha::Skill::Representation
675
+
676
+ end
677
+ end
678
+
544
679
  class Service
545
680
  # @private
546
681
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -561,6 +696,46 @@ module Google
561
696
  end
562
697
  end
563
698
 
699
+ class Skill
700
+ # @private
701
+ class Representation < Google::Apis::Core::JsonRepresentation
702
+ property :create_time, as: 'createTime'
703
+ property :default_revision, as: 'defaultRevision'
704
+ property :description, as: 'description'
705
+ property :display_name, as: 'displayName'
706
+ property :frontmatter, as: 'frontmatter', class: Google::Apis::AgentregistryV1alpha::Frontmatter, decorator: Google::Apis::AgentregistryV1alpha::Frontmatter::Representation
707
+
708
+ property :initial_revision, as: 'initialRevision', class: Google::Apis::AgentregistryV1alpha::SkillRevision, decorator: Google::Apis::AgentregistryV1alpha::SkillRevision::Representation
709
+
710
+ property :name, as: 'name'
711
+ property :publisher, as: 'publisher'
712
+ property :skill_id, as: 'skillId'
713
+ property :state, as: 'state'
714
+ property :target_state, as: 'targetState'
715
+ property :type, as: 'type'
716
+ property :uid, as: 'uid'
717
+ property :update_time, as: 'updateTime'
718
+ end
719
+ end
720
+
721
+ class SkillRevision
722
+ # @private
723
+ class Representation < Google::Apis::Core::JsonRepresentation
724
+ property :archive_upload_source, as: 'archiveUploadSource', class: Google::Apis::AgentregistryV1alpha::ArchiveUploadSource, decorator: Google::Apis::AgentregistryV1alpha::ArchiveUploadSource::Representation
725
+
726
+ property :create_time, as: 'createTime'
727
+ property :frontmatter, as: 'frontmatter', class: Google::Apis::AgentregistryV1alpha::Frontmatter, decorator: Google::Apis::AgentregistryV1alpha::Frontmatter::Representation
728
+
729
+ property :gcs_source, as: 'gcsSource', class: Google::Apis::AgentregistryV1alpha::GcsSource, decorator: Google::Apis::AgentregistryV1alpha::GcsSource::Representation
730
+
731
+ property :name, as: 'name'
732
+ property :sha256_hash, as: 'sha256Hash'
733
+ property :size_bytes, :numeric_string => true, as: 'sizeBytes'
734
+ property :state, as: 'state'
735
+ property :uid, as: 'uid'
736
+ end
737
+ end
738
+
564
739
  class Source
565
740
  # @private
566
741
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -856,6 +856,74 @@ module Google
856
856
  execute_or_queue_command(command, &block)
857
857
  end
858
858
 
859
+ # Fetches details of a specific Publisher.
860
+ # @param [String] name
861
+ # Required. Target publisher resource name. Format: `projects/`project`/
862
+ # locations/`location`/publishers/`publisher``
863
+ # @param [String] fields
864
+ # Selector specifying which fields to include in a partial response.
865
+ # @param [String] quota_user
866
+ # Available to use for quota purposes for server-side applications. Can be any
867
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
868
+ # @param [Google::Apis::RequestOptions] options
869
+ # Request-specific options
870
+ #
871
+ # @yield [result, err] Result & error if block supplied
872
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Publisher] parsed result object
873
+ # @yieldparam err [StandardError] error object if request failed
874
+ #
875
+ # @return [Google::Apis::AgentregistryV1alpha::Publisher]
876
+ #
877
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
878
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
879
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
880
+ def get_project_location_publisher(name, fields: nil, quota_user: nil, options: nil, &block)
881
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
882
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Publisher::Representation
883
+ command.response_class = Google::Apis::AgentregistryV1alpha::Publisher
884
+ command.params['name'] = name unless name.nil?
885
+ command.query['fields'] = fields unless fields.nil?
886
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
887
+ execute_or_queue_command(command, &block)
888
+ end
889
+
890
+ # Lists all Publishers in a location.
891
+ # @param [String] parent
892
+ # Required. Parent location to query. Format: `projects/`project`/locations/`
893
+ # location``
894
+ # @param [Fixnum] page_size
895
+ # Optional. Page limit size.
896
+ # @param [String] page_token
897
+ # Optional. Page offset token.
898
+ # @param [String] fields
899
+ # Selector specifying which fields to include in a partial response.
900
+ # @param [String] quota_user
901
+ # Available to use for quota purposes for server-side applications. Can be any
902
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
903
+ # @param [Google::Apis::RequestOptions] options
904
+ # Request-specific options
905
+ #
906
+ # @yield [result, err] Result & error if block supplied
907
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::ListPublishersResponse] parsed result object
908
+ # @yieldparam err [StandardError] error object if request failed
909
+ #
910
+ # @return [Google::Apis::AgentregistryV1alpha::ListPublishersResponse]
911
+ #
912
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
913
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
914
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
915
+ def list_project_location_publishers(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
916
+ command = make_simple_command(:get, 'v1alpha/{+parent}/publishers', options)
917
+ command.response_representation = Google::Apis::AgentregistryV1alpha::ListPublishersResponse::Representation
918
+ command.response_class = Google::Apis::AgentregistryV1alpha::ListPublishersResponse
919
+ command.params['parent'] = parent unless parent.nil?
920
+ command.query['pageSize'] = page_size unless page_size.nil?
921
+ command.query['pageToken'] = page_token unless page_token.nil?
922
+ command.query['fields'] = fields unless fields.nil?
923
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
924
+ execute_or_queue_command(command, &block)
925
+ end
926
+
859
927
  # Creates a new Service in a given project and location.
860
928
  # @param [String] parent
861
929
  # Required. The project and location to create the Service in. Expected format: `
@@ -1078,6 +1146,436 @@ module Google
1078
1146
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1079
1147
  execute_or_queue_command(command, &block)
1080
1148
  end
1149
+
1150
+ # ========================================================================= #
1151
+ # Skills Collection APIs Creates a Skill resource container, optionally
1152
+ # publishing the initial SkillRevision inline in a single, atomic CRUD roundtrip.
1153
+ # @param [String] parent
1154
+ # Required. The project and location location to bootstrap.
1155
+ # @param [Google::Apis::AgentregistryV1alpha::Skill] skill_object
1156
+ # @param [String] request_id
1157
+ # Optional. Signed UUID request idempotency token.
1158
+ # @param [String] skill_id
1159
+ # Required. Custom, user-defined unique container identifier. Must be unique
1160
+ # within the parent project and location. This value should be 4-63 characters,
1161
+ # and valid characters are `/a-z-/`.
1162
+ # @param [String] fields
1163
+ # Selector specifying which fields to include in a partial response.
1164
+ # @param [String] quota_user
1165
+ # Available to use for quota purposes for server-side applications. Can be any
1166
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1167
+ # @param [Google::Apis::RequestOptions] options
1168
+ # Request-specific options
1169
+ #
1170
+ # @yield [result, err] Result & error if block supplied
1171
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Operation] parsed result object
1172
+ # @yieldparam err [StandardError] error object if request failed
1173
+ #
1174
+ # @return [Google::Apis::AgentregistryV1alpha::Operation]
1175
+ #
1176
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1177
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1178
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1179
+ def create_project_location_skill(parent, skill_object = nil, request_id: nil, skill_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1180
+ command = make_simple_command(:post, 'v1alpha/{+parent}/skills', options)
1181
+ command.request_representation = Google::Apis::AgentregistryV1alpha::Skill::Representation
1182
+ command.request_object = skill_object
1183
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Operation::Representation
1184
+ command.response_class = Google::Apis::AgentregistryV1alpha::Operation
1185
+ command.params['parent'] = parent unless parent.nil?
1186
+ command.query['requestId'] = request_id unless request_id.nil?
1187
+ command.query['skillId'] = skill_id unless skill_id.nil?
1188
+ command.query['fields'] = fields unless fields.nil?
1189
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1190
+ execute_or_queue_command(command, &block)
1191
+ end
1192
+
1193
+ # Deletes a Skill container along with all its revisions.
1194
+ # @param [String] name
1195
+ # Required. Target Skill container name to remove.
1196
+ # @param [Boolean] force
1197
+ # Optional. If set to true, any child SkillRevisions under this Skill will also
1198
+ # be deleted. Otherwise, the request will only succeed if the Skill has no child
1199
+ # SkillRevisions.
1200
+ # @param [String] request_id
1201
+ # Optional. Signed UUID request idempotency token.
1202
+ # @param [String] fields
1203
+ # Selector specifying which fields to include in a partial response.
1204
+ # @param [String] quota_user
1205
+ # Available to use for quota purposes for server-side applications. Can be any
1206
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1207
+ # @param [Google::Apis::RequestOptions] options
1208
+ # Request-specific options
1209
+ #
1210
+ # @yield [result, err] Result & error if block supplied
1211
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Operation] parsed result object
1212
+ # @yieldparam err [StandardError] error object if request failed
1213
+ #
1214
+ # @return [Google::Apis::AgentregistryV1alpha::Operation]
1215
+ #
1216
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1217
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1218
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1219
+ def delete_project_location_skill(name, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1220
+ command = make_simple_command(:delete, 'v1alpha/{+name}', options)
1221
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Operation::Representation
1222
+ command.response_class = Google::Apis::AgentregistryV1alpha::Operation
1223
+ command.params['name'] = name unless name.nil?
1224
+ command.query['force'] = force unless force.nil?
1225
+ command.query['requestId'] = request_id unless request_id.nil?
1226
+ command.query['fields'] = fields unless fields.nil?
1227
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1228
+ execute_or_queue_command(command, &block)
1229
+ end
1230
+
1231
+ # Fetches the active configuration and metadata of a Skill.
1232
+ # @param [String] name
1233
+ # Required. Target resource container name.
1234
+ # @param [String] fields
1235
+ # Selector specifying which fields to include in a partial response.
1236
+ # @param [String] quota_user
1237
+ # Available to use for quota purposes for server-side applications. Can be any
1238
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1239
+ # @param [Google::Apis::RequestOptions] options
1240
+ # Request-specific options
1241
+ #
1242
+ # @yield [result, err] Result & error if block supplied
1243
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Skill] parsed result object
1244
+ # @yieldparam err [StandardError] error object if request failed
1245
+ #
1246
+ # @return [Google::Apis::AgentregistryV1alpha::Skill]
1247
+ #
1248
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1249
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1250
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1251
+ def get_project_location_skill(name, fields: nil, quota_user: nil, options: nil, &block)
1252
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
1253
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Skill::Representation
1254
+ command.response_class = Google::Apis::AgentregistryV1alpha::Skill
1255
+ command.params['name'] = name unless name.nil?
1256
+ command.query['fields'] = fields unless fields.nil?
1257
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1258
+ execute_or_queue_command(command, &block)
1259
+ end
1260
+
1261
+ # Lists logical Skills available in a project.
1262
+ # @param [String] parent
1263
+ # Required. Parent value for ListSkillsRequest
1264
+ # @param [String] filter
1265
+ # Optional. Use this field to specify filter criteria on list results. Filter
1266
+ # expressions can be used to restrict results based upon filterable fields,
1267
+ # where equality operators can be used. See [instructions](https://docs.cloud.
1268
+ # google.com/agent-registry/search-agents-and-tools) for more details. Allowed
1269
+ # operators: `=`, `<`, `>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `>
1270
+ # ` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes
1271
+ # | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `
1272
+ # state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
1273
+ # @param [String] order_by
1274
+ # Optional. Hint for how to order the results
1275
+ # @param [Fixnum] page_size
1276
+ # Optional. Requested page size. Server may return fewer items than requested.
1277
+ # If unspecified, server will pick an appropriate default.
1278
+ # @param [String] page_token
1279
+ # Optional. A token identifying a page of results the server should return.
1280
+ # @param [String] fields
1281
+ # Selector specifying which fields to include in a partial response.
1282
+ # @param [String] quota_user
1283
+ # Available to use for quota purposes for server-side applications. Can be any
1284
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1285
+ # @param [Google::Apis::RequestOptions] options
1286
+ # Request-specific options
1287
+ #
1288
+ # @yield [result, err] Result & error if block supplied
1289
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::ListSkillsResponse] parsed result object
1290
+ # @yieldparam err [StandardError] error object if request failed
1291
+ #
1292
+ # @return [Google::Apis::AgentregistryV1alpha::ListSkillsResponse]
1293
+ #
1294
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1295
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1296
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1297
+ def list_project_location_skills(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1298
+ command = make_simple_command(:get, 'v1alpha/{+parent}/skills', options)
1299
+ command.response_representation = Google::Apis::AgentregistryV1alpha::ListSkillsResponse::Representation
1300
+ command.response_class = Google::Apis::AgentregistryV1alpha::ListSkillsResponse
1301
+ command.params['parent'] = parent unless parent.nil?
1302
+ command.query['filter'] = filter unless filter.nil?
1303
+ command.query['orderBy'] = order_by unless order_by.nil?
1304
+ command.query['pageSize'] = page_size unless page_size.nil?
1305
+ command.query['pageToken'] = page_token unless page_token.nil?
1306
+ command.query['fields'] = fields unless fields.nil?
1307
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1308
+ execute_or_queue_command(command, &block)
1309
+ end
1310
+
1311
+ # Updates Skill metadata or overrides active pointers/state using REST standard
1312
+ # PATCH.
1313
+ # @param [String] name
1314
+ # Identifier. Resource name of the Skill. Format: `projects/`project`/locations/`
1315
+ # location`/skills/`skill`` The ``skill`` segment acts as the resource ID. If
1316
+ # the skill is associated with a Publisher, this segment typically uses a
1317
+ # hyphenated namespace prefix corresponding to the publisher (e.g., `google-
1318
+ # workspace-create-docs`).
1319
+ # @param [Google::Apis::AgentregistryV1alpha::Skill] skill_object
1320
+ # @param [String] request_id
1321
+ # Optional. Signed UUID request idempotency token.
1322
+ # @param [String] update_mask
1323
+ # Optional. Standard update target mask mapping relative fields.
1324
+ # @param [String] fields
1325
+ # Selector specifying which fields to include in a partial response.
1326
+ # @param [String] quota_user
1327
+ # Available to use for quota purposes for server-side applications. Can be any
1328
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1329
+ # @param [Google::Apis::RequestOptions] options
1330
+ # Request-specific options
1331
+ #
1332
+ # @yield [result, err] Result & error if block supplied
1333
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Operation] parsed result object
1334
+ # @yieldparam err [StandardError] error object if request failed
1335
+ #
1336
+ # @return [Google::Apis::AgentregistryV1alpha::Operation]
1337
+ #
1338
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1339
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1340
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1341
+ def patch_project_location_skill(name, skill_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1342
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
1343
+ command.request_representation = Google::Apis::AgentregistryV1alpha::Skill::Representation
1344
+ command.request_object = skill_object
1345
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Operation::Representation
1346
+ command.response_class = Google::Apis::AgentregistryV1alpha::Operation
1347
+ command.params['name'] = name unless name.nil?
1348
+ command.query['requestId'] = request_id unless request_id.nil?
1349
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1350
+ command.query['fields'] = fields unless fields.nil?
1351
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1352
+ execute_or_queue_command(command, &block)
1353
+ end
1354
+
1355
+ # Custom deep-search method to filter by frontmatter or query SKILL.md text
1356
+ # blobs.
1357
+ # @param [String] parent
1358
+ # Required. Parent value for SearchSkillsRequest. Format: `projects/`project`/
1359
+ # locations/`location``.
1360
+ # @param [String] filter
1361
+ # Optional. Use this field to specify additional filter criteria on search
1362
+ # results. Filter expressions can be used to restrict results based upon
1363
+ # filterable fields, where equality operators can be used. See [instructions](
1364
+ # https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more
1365
+ # details. Allowed operators: `=`, `<`, `>`, `NOT`, `AND`, `OR`, and `()`. |
1366
+ # Field | `=` | `<`, `>` | |--------------|-----|----------| | state | Yes | No |
1367
+ # | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes |
1368
+ # Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE`
1369
+ # state.
1370
+ # @param [Fixnum] page_size
1371
+ # Optional. The maximum number of search results to return per page. The page
1372
+ # size is capped at `100`, even if a larger value is specified. A negative value
1373
+ # will result in an `INVALID_ARGUMENT` error. If unspecified or set to `0`, a
1374
+ # default value of `20` will be used. The server may return fewer results than
1375
+ # requested.
1376
+ # @param [String] page_token
1377
+ # Optional. If present, retrieve the next batch of results from the preceding
1378
+ # call to this method. `page_token` must be the value of `next_page_token` from
1379
+ # the previous response. The values of all other method parameters, must be
1380
+ # identical to those in the previous call.
1381
+ # @param [String] search_string
1382
+ # Optional. Search criteria used to select the Skills to return. If no search
1383
+ # criteria is specified then all accessible Skills will be returned. Search
1384
+ # expressions can be used to restrict results based upon searchable fields,
1385
+ # where the operators can be used along with the suffix wildcard symbol `*`. See
1386
+ # [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-
1387
+ # tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `
1388
+ # ()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |---------
1389
+ # ------------------|-----|-----|-----|----------------| | skillId | Yes | Yes |
1390
+ # Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes
1391
+ # | Yes | Included | | description | No | Yes | No | Included | | frontmatter.
1392
+ # name | No | Yes | No | Included | | frontmatter.description | No | Yes | No |
1393
+ # Included | | frontmatter.compatibility | No | Yes | No | Included | |
1394
+ # frontmatter.license | No | Yes | No | Included | Examples: * `skillId="urn:
1395
+ # skill:projects-1234:locations:global:private-important-skill"` to find the
1396
+ # skill with the specified skill ID. * `name:important` to find skills whose
1397
+ # name contains `important` as a word. * `displayName:works*` to find skills
1398
+ # whose display name contains words that start with `works`.
1399
+ # @param [String] search_type
1400
+ # Optional. The type of search.
1401
+ # @param [String] fields
1402
+ # Selector specifying which fields to include in a partial response.
1403
+ # @param [String] quota_user
1404
+ # Available to use for quota purposes for server-side applications. Can be any
1405
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1406
+ # @param [Google::Apis::RequestOptions] options
1407
+ # Request-specific options
1408
+ #
1409
+ # @yield [result, err] Result & error if block supplied
1410
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::SearchSkillsResponse] parsed result object
1411
+ # @yieldparam err [StandardError] error object if request failed
1412
+ #
1413
+ # @return [Google::Apis::AgentregistryV1alpha::SearchSkillsResponse]
1414
+ #
1415
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1416
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1417
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1418
+ def search_project_location_skills(parent, filter: nil, page_size: nil, page_token: nil, search_string: nil, search_type: nil, fields: nil, quota_user: nil, options: nil, &block)
1419
+ command = make_simple_command(:get, 'v1alpha/{+parent}/skills:search', options)
1420
+ command.response_representation = Google::Apis::AgentregistryV1alpha::SearchSkillsResponse::Representation
1421
+ command.response_class = Google::Apis::AgentregistryV1alpha::SearchSkillsResponse
1422
+ command.params['parent'] = parent unless parent.nil?
1423
+ command.query['filter'] = filter unless filter.nil?
1424
+ command.query['pageSize'] = page_size unless page_size.nil?
1425
+ command.query['pageToken'] = page_token unless page_token.nil?
1426
+ command.query['searchString'] = search_string unless search_string.nil?
1427
+ command.query['searchType'] = search_type unless search_type.nil?
1428
+ command.query['fields'] = fields unless fields.nil?
1429
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1430
+ execute_or_queue_command(command, &block)
1431
+ end
1432
+
1433
+ # Creates a new immutable revision and triggers validation pipelines.
1434
+ # @param [String] parent
1435
+ # Required. Parent logical container name.
1436
+ # @param [Google::Apis::AgentregistryV1alpha::SkillRevision] skill_revision_object
1437
+ # @param [String] request_id
1438
+ # Optional. Signed UUID request idempotency token.
1439
+ # @param [String] skill_revision_id
1440
+ # Optional. Custom, user-defined unique revision identifier. Format: 4-63
1441
+ # characters, matching regex `^[a-z]([a-z0-9-]`0,61`[a-z0-9])?$`
1442
+ # @param [String] fields
1443
+ # Selector specifying which fields to include in a partial response.
1444
+ # @param [String] quota_user
1445
+ # Available to use for quota purposes for server-side applications. Can be any
1446
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1447
+ # @param [Google::Apis::RequestOptions] options
1448
+ # Request-specific options
1449
+ #
1450
+ # @yield [result, err] Result & error if block supplied
1451
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Operation] parsed result object
1452
+ # @yieldparam err [StandardError] error object if request failed
1453
+ #
1454
+ # @return [Google::Apis::AgentregistryV1alpha::Operation]
1455
+ #
1456
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1457
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1458
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1459
+ def create_project_location_skill_revision(parent, skill_revision_object = nil, request_id: nil, skill_revision_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1460
+ command = make_simple_command(:post, 'v1alpha/{+parent}/revisions', options)
1461
+ command.request_representation = Google::Apis::AgentregistryV1alpha::SkillRevision::Representation
1462
+ command.request_object = skill_revision_object
1463
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Operation::Representation
1464
+ command.response_class = Google::Apis::AgentregistryV1alpha::Operation
1465
+ command.params['parent'] = parent unless parent.nil?
1466
+ command.query['requestId'] = request_id unless request_id.nil?
1467
+ command.query['skillRevisionId'] = skill_revision_id unless skill_revision_id.nil?
1468
+ command.query['fields'] = fields unless fields.nil?
1469
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1470
+ execute_or_queue_command(command, &block)
1471
+ end
1472
+
1473
+ # Deletes a specific revision (restricted to admins to purge accidentally
1474
+ # committed secrets).
1475
+ # @param [String] name
1476
+ # Required. Target revision name to remove.
1477
+ # @param [String] request_id
1478
+ # Optional. Signed UUID request idempotency token.
1479
+ # @param [String] fields
1480
+ # Selector specifying which fields to include in a partial response.
1481
+ # @param [String] quota_user
1482
+ # Available to use for quota purposes for server-side applications. Can be any
1483
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1484
+ # @param [Google::Apis::RequestOptions] options
1485
+ # Request-specific options
1486
+ #
1487
+ # @yield [result, err] Result & error if block supplied
1488
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Operation] parsed result object
1489
+ # @yieldparam err [StandardError] error object if request failed
1490
+ #
1491
+ # @return [Google::Apis::AgentregistryV1alpha::Operation]
1492
+ #
1493
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1494
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1495
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1496
+ def delete_project_location_skill_revision(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1497
+ command = make_simple_command(:delete, 'v1alpha/{+name}', options)
1498
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Operation::Representation
1499
+ command.response_class = Google::Apis::AgentregistryV1alpha::Operation
1500
+ command.params['name'] = name unless name.nil?
1501
+ command.query['requestId'] = request_id unless request_id.nil?
1502
+ command.query['fields'] = fields unless fields.nil?
1503
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1504
+ execute_or_queue_command(command, &block)
1505
+ end
1506
+
1507
+ # Gets details of a single immutable Revision.
1508
+ # @param [String] name
1509
+ # Required. Target revision name.
1510
+ # @param [String] fields
1511
+ # Selector specifying which fields to include in a partial response.
1512
+ # @param [String] quota_user
1513
+ # Available to use for quota purposes for server-side applications. Can be any
1514
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1515
+ # @param [IO, String] download_dest
1516
+ # IO stream or filename to receive content download
1517
+ # @param [Google::Apis::RequestOptions] options
1518
+ # Request-specific options
1519
+ #
1520
+ # @yield [result, err] Result & error if block supplied
1521
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::SkillRevision] parsed result object
1522
+ # @yieldparam err [StandardError] error object if request failed
1523
+ #
1524
+ # @return [Google::Apis::AgentregistryV1alpha::SkillRevision]
1525
+ #
1526
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1527
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1528
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1529
+ def get_project_location_skill_revision(name, fields: nil, quota_user: nil, download_dest: nil, options: nil, &block)
1530
+ if download_dest.nil?
1531
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
1532
+ else
1533
+ command = make_download_command(:get, 'v1alpha/{+name}', options)
1534
+ command.download_dest = download_dest
1535
+ end
1536
+ command.response_representation = Google::Apis::AgentregistryV1alpha::SkillRevision::Representation
1537
+ command.response_class = Google::Apis::AgentregistryV1alpha::SkillRevision
1538
+ command.params['name'] = name unless name.nil?
1539
+ command.query['fields'] = fields unless fields.nil?
1540
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1541
+ execute_or_queue_command(command, &block)
1542
+ end
1543
+
1544
+ # Lists all revisions belonging to a parent Skill.
1545
+ # @param [String] parent
1546
+ # Required. Parent logical container name to query.
1547
+ # @param [Fixnum] page_size
1548
+ # Optional. Page limit size.
1549
+ # @param [String] page_token
1550
+ # Optional. Page offset token.
1551
+ # @param [String] fields
1552
+ # Selector specifying which fields to include in a partial response.
1553
+ # @param [String] quota_user
1554
+ # Available to use for quota purposes for server-side applications. Can be any
1555
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1556
+ # @param [Google::Apis::RequestOptions] options
1557
+ # Request-specific options
1558
+ #
1559
+ # @yield [result, err] Result & error if block supplied
1560
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::ListSkillRevisionsResponse] parsed result object
1561
+ # @yieldparam err [StandardError] error object if request failed
1562
+ #
1563
+ # @return [Google::Apis::AgentregistryV1alpha::ListSkillRevisionsResponse]
1564
+ #
1565
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1566
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1567
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1568
+ def list_project_location_skill_revisions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1569
+ command = make_simple_command(:get, 'v1alpha/{+parent}/revisions', options)
1570
+ command.response_representation = Google::Apis::AgentregistryV1alpha::ListSkillRevisionsResponse::Representation
1571
+ command.response_class = Google::Apis::AgentregistryV1alpha::ListSkillRevisionsResponse
1572
+ command.params['parent'] = parent unless parent.nil?
1573
+ command.query['pageSize'] = page_size unless page_size.nil?
1574
+ command.query['pageToken'] = page_token unless page_token.nil?
1575
+ command.query['fields'] = fields unless fields.nil?
1576
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1577
+ execute_or_queue_command(command, &block)
1578
+ end
1081
1579
 
1082
1580
  protected
1083
1581
 
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-agentregistry_v1alpha
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.0
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-agentregistry_v1alpha/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-agentregistry_v1alpha/v0.4.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-agentregistry_v1alpha/v0.5.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-agentregistry_v1alpha
62
62
  rdoc_options: []
63
63
  require_paths: