google-apis-agentregistry_v1alpha 0.4.0 → 0.6.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: 61f702288ebc47753cccade05c2f0e77b7b1d28a52872f9128781fbc5d9eab26
4
+ data.tar.gz: afffce2f18ce105152a7c72528aa52401c4bfd05814bf2577286a26953b9f00d
5
5
  SHA512:
6
- metadata.gz: 178586a6c3364930d600527f5dd243e9b6d66b58e321a6135353e203ada6778bc697f24c91c092cb0b66c58b30ba5c03a76ed2dcfe585302336a70fd95d0dc6d
7
- data.tar.gz: a5cc66b1688720b6407e12114269942dc39d1f5729e65979307620a3838fcf46d31429a4a5470de0c708e309220b8986a53e01cc2cb1b9f08f099170acdec956
6
+ metadata.gz: ec222e107089853785e719ed9820bc5d2ea70b2c2ed61dc74afef37d4db755f0d00c958be939d9a9e1fbdf14dacc330d0453b5d9383199227b7dd5093f59f5bd
7
+ data.tar.gz: 2269d681c2a76034b9ddc89401d12a357a85ecfe683d1ef45ec98ca278db390dc74e3dbc752a7820321bd290097c2de83484c78970892e5b37e5822a5290663a
data/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Release history for google-apis-agentregistry_v1alpha
2
2
 
3
+ ### v0.6.0 (2026-08-23)
4
+
5
+ * Regenerated from discovery document revision 20260812
6
+
7
+ ### v0.5.0 (2026-07-26)
8
+
9
+ * Regenerated from discovery document revision 20260722
10
+
3
11
  ### v0.4.0 (2026-06-14)
4
12
 
5
13
  * 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.6.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 = "20260812"
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,443 @@ 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-64 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 [IO, String] download_dest
1240
+ # IO stream or filename to receive content download
1241
+ # @param [Google::Apis::RequestOptions] options
1242
+ # Request-specific options
1243
+ #
1244
+ # @yield [result, err] Result & error if block supplied
1245
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Skill] parsed result object
1246
+ # @yieldparam err [StandardError] error object if request failed
1247
+ #
1248
+ # @return [Google::Apis::AgentregistryV1alpha::Skill]
1249
+ #
1250
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1251
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1252
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1253
+ def get_project_location_skill(name, fields: nil, quota_user: nil, download_dest: nil, options: nil, &block)
1254
+ if download_dest.nil?
1255
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
1256
+ else
1257
+ command = make_download_command(:get, 'v1alpha/{+name}', options)
1258
+ command.download_dest = download_dest
1259
+ end
1260
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Skill::Representation
1261
+ command.response_class = Google::Apis::AgentregistryV1alpha::Skill
1262
+ command.params['name'] = name unless name.nil?
1263
+ command.query['fields'] = fields unless fields.nil?
1264
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1265
+ execute_or_queue_command(command, &block)
1266
+ end
1267
+
1268
+ # Lists logical Skills available in a project.
1269
+ # @param [String] parent
1270
+ # Required. Parent value for ListSkillsRequest
1271
+ # @param [String] filter
1272
+ # Optional. Use this field to specify filter criteria on list results. Filter
1273
+ # expressions can be used to restrict results based upon filterable fields,
1274
+ # where equality operators can be used. See [instructions](https://docs.cloud.
1275
+ # google.com/agent-registry/search-agents-and-tools) for more details. Allowed
1276
+ # operators: `=`, `<`, `>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `>
1277
+ # ` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes
1278
+ # | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `
1279
+ # state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
1280
+ # @param [String] order_by
1281
+ # Optional. Hint for how to order the results
1282
+ # @param [Fixnum] page_size
1283
+ # Optional. Requested page size. Server may return fewer items than requested.
1284
+ # If unspecified, server will pick an appropriate default.
1285
+ # @param [String] page_token
1286
+ # Optional. A token identifying a page of results the server should return.
1287
+ # @param [String] fields
1288
+ # Selector specifying which fields to include in a partial response.
1289
+ # @param [String] quota_user
1290
+ # Available to use for quota purposes for server-side applications. Can be any
1291
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1292
+ # @param [Google::Apis::RequestOptions] options
1293
+ # Request-specific options
1294
+ #
1295
+ # @yield [result, err] Result & error if block supplied
1296
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::ListSkillsResponse] parsed result object
1297
+ # @yieldparam err [StandardError] error object if request failed
1298
+ #
1299
+ # @return [Google::Apis::AgentregistryV1alpha::ListSkillsResponse]
1300
+ #
1301
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1302
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1303
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1304
+ 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)
1305
+ command = make_simple_command(:get, 'v1alpha/{+parent}/skills', options)
1306
+ command.response_representation = Google::Apis::AgentregistryV1alpha::ListSkillsResponse::Representation
1307
+ command.response_class = Google::Apis::AgentregistryV1alpha::ListSkillsResponse
1308
+ command.params['parent'] = parent unless parent.nil?
1309
+ command.query['filter'] = filter unless filter.nil?
1310
+ command.query['orderBy'] = order_by unless order_by.nil?
1311
+ command.query['pageSize'] = page_size unless page_size.nil?
1312
+ command.query['pageToken'] = page_token unless page_token.nil?
1313
+ command.query['fields'] = fields unless fields.nil?
1314
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1315
+ execute_or_queue_command(command, &block)
1316
+ end
1317
+
1318
+ # Updates Skill metadata or overrides active pointers/state using REST standard
1319
+ # PATCH.
1320
+ # @param [String] name
1321
+ # Identifier. Resource name of the Skill. Format: `projects/`project`/locations/`
1322
+ # location`/skills/`skill`` The ``skill`` segment acts as the resource ID. If
1323
+ # the skill is associated with a Publisher, this segment typically uses a
1324
+ # hyphenated namespace prefix corresponding to the publisher (e.g., `google-
1325
+ # workspace-create-docs`).
1326
+ # @param [Google::Apis::AgentregistryV1alpha::Skill] skill_object
1327
+ # @param [String] request_id
1328
+ # Optional. Signed UUID request idempotency token.
1329
+ # @param [String] update_mask
1330
+ # Optional. Standard update target mask mapping relative fields.
1331
+ # @param [String] fields
1332
+ # Selector specifying which fields to include in a partial response.
1333
+ # @param [String] quota_user
1334
+ # Available to use for quota purposes for server-side applications. Can be any
1335
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1336
+ # @param [Google::Apis::RequestOptions] options
1337
+ # Request-specific options
1338
+ #
1339
+ # @yield [result, err] Result & error if block supplied
1340
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Operation] parsed result object
1341
+ # @yieldparam err [StandardError] error object if request failed
1342
+ #
1343
+ # @return [Google::Apis::AgentregistryV1alpha::Operation]
1344
+ #
1345
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1346
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1347
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1348
+ def patch_project_location_skill(name, skill_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1349
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
1350
+ command.request_representation = Google::Apis::AgentregistryV1alpha::Skill::Representation
1351
+ command.request_object = skill_object
1352
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Operation::Representation
1353
+ command.response_class = Google::Apis::AgentregistryV1alpha::Operation
1354
+ command.params['name'] = name unless name.nil?
1355
+ command.query['requestId'] = request_id unless request_id.nil?
1356
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1357
+ command.query['fields'] = fields unless fields.nil?
1358
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1359
+ execute_or_queue_command(command, &block)
1360
+ end
1361
+
1362
+ # Custom deep-search method to filter by frontmatter or query SKILL.md text
1363
+ # blobs.
1364
+ # @param [String] parent
1365
+ # Required. Parent value for SearchSkillsRequest. Format: `projects/`project`/
1366
+ # locations/`location``.
1367
+ # @param [String] filter
1368
+ # Optional. Use this field to specify additional filter criteria on search
1369
+ # results. Filter expressions can be used to restrict results based upon
1370
+ # filterable fields, where equality operators can be used. See [instructions](
1371
+ # https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more
1372
+ # details. Allowed operators: `=`, `<`, `>`, `NOT`, `AND`, `OR`, and `()`. |
1373
+ # Field | `=` | `<`, `>` | |--------------|-----|----------| | state | Yes | No |
1374
+ # | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes |
1375
+ # Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE`
1376
+ # state.
1377
+ # @param [Fixnum] page_size
1378
+ # Optional. The maximum number of search results to return per page. The page
1379
+ # size is capped at `100`, even if a larger value is specified. A negative value
1380
+ # will result in an `INVALID_ARGUMENT` error. If unspecified or set to `0`, a
1381
+ # default value of `20` will be used. The server may return fewer results than
1382
+ # requested.
1383
+ # @param [String] page_token
1384
+ # Optional. If present, retrieve the next batch of results from the preceding
1385
+ # call to this method. `page_token` must be the value of `next_page_token` from
1386
+ # the previous response. The values of all other method parameters, must be
1387
+ # identical to those in the previous call.
1388
+ # @param [String] search_string
1389
+ # Optional. Search criteria used to select the Skills to return. If no search
1390
+ # criteria is specified then all accessible Skills will be returned. Search
1391
+ # expressions can be used to restrict results based upon searchable fields,
1392
+ # where the operators can be used along with the suffix wildcard symbol `*`. See
1393
+ # [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-
1394
+ # tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `
1395
+ # ()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |---------
1396
+ # ------------------|-----|-----|-----|----------------| | skillId | Yes | Yes |
1397
+ # Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes
1398
+ # | Yes | Included | | description | No | Yes | No | Included | | frontmatter.
1399
+ # name | No | Yes | No | Included | | frontmatter.description | No | Yes | No |
1400
+ # Included | | frontmatter.compatibility | No | Yes | No | Included | |
1401
+ # frontmatter.license | No | Yes | No | Included | Examples: * `skillId="urn:
1402
+ # skill:projects-1234:locations:global:private-important-skill"` to find the
1403
+ # skill with the specified skill ID. * `name:important` to find skills whose
1404
+ # name contains `important` as a word. * `displayName:works*` to find skills
1405
+ # whose display name contains words that start with `works`.
1406
+ # @param [String] search_type
1407
+ # Optional. The type of search.
1408
+ # @param [String] fields
1409
+ # Selector specifying which fields to include in a partial response.
1410
+ # @param [String] quota_user
1411
+ # Available to use for quota purposes for server-side applications. Can be any
1412
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1413
+ # @param [Google::Apis::RequestOptions] options
1414
+ # Request-specific options
1415
+ #
1416
+ # @yield [result, err] Result & error if block supplied
1417
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::SearchSkillsResponse] parsed result object
1418
+ # @yieldparam err [StandardError] error object if request failed
1419
+ #
1420
+ # @return [Google::Apis::AgentregistryV1alpha::SearchSkillsResponse]
1421
+ #
1422
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1423
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1424
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1425
+ 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)
1426
+ command = make_simple_command(:get, 'v1alpha/{+parent}/skills:search', options)
1427
+ command.response_representation = Google::Apis::AgentregistryV1alpha::SearchSkillsResponse::Representation
1428
+ command.response_class = Google::Apis::AgentregistryV1alpha::SearchSkillsResponse
1429
+ command.params['parent'] = parent unless parent.nil?
1430
+ command.query['filter'] = filter unless filter.nil?
1431
+ command.query['pageSize'] = page_size unless page_size.nil?
1432
+ command.query['pageToken'] = page_token unless page_token.nil?
1433
+ command.query['searchString'] = search_string unless search_string.nil?
1434
+ command.query['searchType'] = search_type unless search_type.nil?
1435
+ command.query['fields'] = fields unless fields.nil?
1436
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1437
+ execute_or_queue_command(command, &block)
1438
+ end
1439
+
1440
+ # Creates a new immutable revision and triggers validation pipelines.
1441
+ # @param [String] parent
1442
+ # Required. Parent logical container name.
1443
+ # @param [Google::Apis::AgentregistryV1alpha::SkillRevision] skill_revision_object
1444
+ # @param [String] request_id
1445
+ # Optional. Signed UUID request idempotency token.
1446
+ # @param [String] skill_revision_id
1447
+ # Optional. Custom, user-defined unique revision identifier. Format: 4-63
1448
+ # characters, matching regex `^[a-z]([a-z0-9-]`0,61`[a-z0-9])?$`
1449
+ # @param [String] fields
1450
+ # Selector specifying which fields to include in a partial response.
1451
+ # @param [String] quota_user
1452
+ # Available to use for quota purposes for server-side applications. Can be any
1453
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1454
+ # @param [Google::Apis::RequestOptions] options
1455
+ # Request-specific options
1456
+ #
1457
+ # @yield [result, err] Result & error if block supplied
1458
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Operation] parsed result object
1459
+ # @yieldparam err [StandardError] error object if request failed
1460
+ #
1461
+ # @return [Google::Apis::AgentregistryV1alpha::Operation]
1462
+ #
1463
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1464
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1465
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1466
+ 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)
1467
+ command = make_simple_command(:post, 'v1alpha/{+parent}/revisions', options)
1468
+ command.request_representation = Google::Apis::AgentregistryV1alpha::SkillRevision::Representation
1469
+ command.request_object = skill_revision_object
1470
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Operation::Representation
1471
+ command.response_class = Google::Apis::AgentregistryV1alpha::Operation
1472
+ command.params['parent'] = parent unless parent.nil?
1473
+ command.query['requestId'] = request_id unless request_id.nil?
1474
+ command.query['skillRevisionId'] = skill_revision_id unless skill_revision_id.nil?
1475
+ command.query['fields'] = fields unless fields.nil?
1476
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1477
+ execute_or_queue_command(command, &block)
1478
+ end
1479
+
1480
+ # Deletes a specific revision (restricted to admins to purge accidentally
1481
+ # committed secrets).
1482
+ # @param [String] name
1483
+ # Required. Target revision name to remove.
1484
+ # @param [String] request_id
1485
+ # Optional. Signed UUID request idempotency token.
1486
+ # @param [String] fields
1487
+ # Selector specifying which fields to include in a partial response.
1488
+ # @param [String] quota_user
1489
+ # Available to use for quota purposes for server-side applications. Can be any
1490
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1491
+ # @param [Google::Apis::RequestOptions] options
1492
+ # Request-specific options
1493
+ #
1494
+ # @yield [result, err] Result & error if block supplied
1495
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::Operation] parsed result object
1496
+ # @yieldparam err [StandardError] error object if request failed
1497
+ #
1498
+ # @return [Google::Apis::AgentregistryV1alpha::Operation]
1499
+ #
1500
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1501
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1502
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1503
+ def delete_project_location_skill_revision(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1504
+ command = make_simple_command(:delete, 'v1alpha/{+name}', options)
1505
+ command.response_representation = Google::Apis::AgentregistryV1alpha::Operation::Representation
1506
+ command.response_class = Google::Apis::AgentregistryV1alpha::Operation
1507
+ command.params['name'] = name unless name.nil?
1508
+ command.query['requestId'] = request_id unless request_id.nil?
1509
+ command.query['fields'] = fields unless fields.nil?
1510
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1511
+ execute_or_queue_command(command, &block)
1512
+ end
1513
+
1514
+ # Gets details of a single immutable Revision.
1515
+ # @param [String] name
1516
+ # Required. Target revision name.
1517
+ # @param [String] fields
1518
+ # Selector specifying which fields to include in a partial response.
1519
+ # @param [String] quota_user
1520
+ # Available to use for quota purposes for server-side applications. Can be any
1521
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1522
+ # @param [IO, String] download_dest
1523
+ # IO stream or filename to receive content download
1524
+ # @param [Google::Apis::RequestOptions] options
1525
+ # Request-specific options
1526
+ #
1527
+ # @yield [result, err] Result & error if block supplied
1528
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::SkillRevision] parsed result object
1529
+ # @yieldparam err [StandardError] error object if request failed
1530
+ #
1531
+ # @return [Google::Apis::AgentregistryV1alpha::SkillRevision]
1532
+ #
1533
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1534
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1535
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1536
+ def get_project_location_skill_revision(name, fields: nil, quota_user: nil, download_dest: nil, options: nil, &block)
1537
+ if download_dest.nil?
1538
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
1539
+ else
1540
+ command = make_download_command(:get, 'v1alpha/{+name}', options)
1541
+ command.download_dest = download_dest
1542
+ end
1543
+ command.response_representation = Google::Apis::AgentregistryV1alpha::SkillRevision::Representation
1544
+ command.response_class = Google::Apis::AgentregistryV1alpha::SkillRevision
1545
+ command.params['name'] = name unless name.nil?
1546
+ command.query['fields'] = fields unless fields.nil?
1547
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1548
+ execute_or_queue_command(command, &block)
1549
+ end
1550
+
1551
+ # Lists all revisions belonging to a parent Skill.
1552
+ # @param [String] parent
1553
+ # Required. Parent logical container name to query.
1554
+ # @param [Fixnum] page_size
1555
+ # Optional. Page limit size.
1556
+ # @param [String] page_token
1557
+ # Optional. Page offset token.
1558
+ # @param [String] fields
1559
+ # Selector specifying which fields to include in a partial response.
1560
+ # @param [String] quota_user
1561
+ # Available to use for quota purposes for server-side applications. Can be any
1562
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1563
+ # @param [Google::Apis::RequestOptions] options
1564
+ # Request-specific options
1565
+ #
1566
+ # @yield [result, err] Result & error if block supplied
1567
+ # @yieldparam result [Google::Apis::AgentregistryV1alpha::ListSkillRevisionsResponse] parsed result object
1568
+ # @yieldparam err [StandardError] error object if request failed
1569
+ #
1570
+ # @return [Google::Apis::AgentregistryV1alpha::ListSkillRevisionsResponse]
1571
+ #
1572
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1573
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1574
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1575
+ def list_project_location_skill_revisions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1576
+ command = make_simple_command(:get, 'v1alpha/{+parent}/revisions', options)
1577
+ command.response_representation = Google::Apis::AgentregistryV1alpha::ListSkillRevisionsResponse::Representation
1578
+ command.response_class = Google::Apis::AgentregistryV1alpha::ListSkillRevisionsResponse
1579
+ command.params['parent'] = parent unless parent.nil?
1580
+ command.query['pageSize'] = page_size unless page_size.nil?
1581
+ command.query['pageToken'] = page_token unless page_token.nil?
1582
+ command.query['fields'] = fields unless fields.nil?
1583
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1584
+ execute_or_queue_command(command, &block)
1585
+ end
1081
1586
 
1082
1587
  protected
1083
1588
 
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.6.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.6.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: