Skip to content

Commit 135360c

Browse files
feat(datacatalog): update the api
#### datacatalog:v1 The following keys were added: - resources.projects.resources.locations.resources.entryGroups.resources.entries.methods.modifyEntryContacts (Total Keys: 12) - resources.projects.resources.locations.resources.entryGroups.resources.entries.methods.modifyEntryOverview (Total Keys: 12) - schemas.GoogleCloudDatacatalogV1BusinessContext (Total Keys: 4) - schemas.GoogleCloudDatacatalogV1Contacts (Total Keys: 8) - schemas.GoogleCloudDatacatalogV1Entry.properties.businessContext.$ref (Total Keys: 1) - schemas.GoogleCloudDatacatalogV1EntryOverview (Total Keys: 3) - schemas.GoogleCloudDatacatalogV1ModifyEntryContactsRequest (Total Keys: 3) - schemas.GoogleCloudDatacatalogV1ModifyEntryOverviewRequest (Total Keys: 3)
1 parent 610263d commit 135360c

5 files changed

+307
-7
lines changed

docs/dyn/datacatalog_v1.entries.html

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,6 +118,19 @@ <h3>Method Details</h3>
118118
&quot;viewQuery&quot;: &quot;A String&quot;, # Output only. The query that defines the table view.
119119
},
120120
},
121+
&quot;businessContext&quot;: { # Business Context of the entry. # Business Context of the entry.
122+
&quot;contacts&quot;: { # Contact people for the entry. # Contact people for the entry.
123+
&quot;people&quot;: [ # The list of contact people for the entry.
124+
{ # A contact person for the entry.
125+
&quot;designation&quot;: &quot;A String&quot;, # Designation of the person, for example, Data Steward.
126+
&quot;email&quot;: &quot;A String&quot;, # Email of the person in the format of `john.doe@xyz`, ``, or `John Doe`.
127+
},
128+
],
129+
},
130+
&quot;entryOverview&quot;: { # Entry overview fields for rich text descriptions of entries. # Entry overview fields for rich text descriptions of entries.
131+
&quot;overview&quot;: &quot;A String&quot;, # Entry overview with support for rich text. The overview must only contain Unicode characters, and should be formatted using HTML. The maximum length is 10 MiB as this value holds HTML descriptions including encoded images. The maximum length of the text without images is 100 KiB.
132+
},
133+
},
121134
&quot;dataSource&quot;: { # Physical location of an entry. # Output only. Physical location of the entry.
122135
&quot;resource&quot;: &quot;A String&quot;, # Full name of a resource as defined by the service. For example: `//bigquery.googleapis.com/projects/{PROJECT_ID}/locations/{LOCATION}/datasets/{DATASET_ID}/tables/{TABLE_ID}`
123136
&quot;service&quot;: &quot;A String&quot;, # Service that physically stores the data.

docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.html

Lines changed: 150 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,12 @@ <h2>Instance Methods</h2>
100100
<p class="toc_element">
101101
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
102102
<p class="firstline">Retrieves the next page of results.</p>
103+
<p class="toc_element">
104+
<code><a href="#modifyEntryContacts">modifyEntryContacts(name, body=None, x__xgafv=None)</a></code></p>
105+
<p class="firstline">Modifies contacts, part of the business context of an Entry. To call this method, you must have the `datacatalog.entries.updateContacts` IAM permission on the corresponding project.</p>
106+
<p class="toc_element">
107+
<code><a href="#modifyEntryOverview">modifyEntryOverview(name, body=None, x__xgafv=None)</a></code></p>
108+
<p class="firstline">Modifies entry overview, part of the business context of an Entry. To call this method, you must have the `datacatalog.entries.updateOverview` IAM permission on the corresponding project.</p>
103109
<p class="toc_element">
104110
<code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
105111
<p class="firstline">Updates an existing entry. You must enable the Data Catalog API in the project identified by the `entry.name` parameter. For more information, see [Data Catalog resource project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).</p>
@@ -143,6 +149,19 @@ <h3>Method Details</h3>
143149
&quot;viewQuery&quot;: &quot;A String&quot;, # Output only. The query that defines the table view.
144150
},
145151
},
152+
&quot;businessContext&quot;: { # Business Context of the entry. # Business Context of the entry.
153+
&quot;contacts&quot;: { # Contact people for the entry. # Contact people for the entry.
154+
&quot;people&quot;: [ # The list of contact people for the entry.
155+
{ # A contact person for the entry.
156+
&quot;designation&quot;: &quot;A String&quot;, # Designation of the person, for example, Data Steward.
157+
&quot;email&quot;: &quot;A String&quot;, # Email of the person in the format of `john.doe@xyz`, ``, or `John Doe`.
158+
},
159+
],
160+
},
161+
&quot;entryOverview&quot;: { # Entry overview fields for rich text descriptions of entries. # Entry overview fields for rich text descriptions of entries.
162+
&quot;overview&quot;: &quot;A String&quot;, # Entry overview with support for rich text. The overview must only contain Unicode characters, and should be formatted using HTML. The maximum length is 10 MiB as this value holds HTML descriptions including encoded images. The maximum length of the text without images is 100 KiB.
163+
},
164+
},
146165
&quot;dataSource&quot;: { # Physical location of an entry. # Output only. Physical location of the entry.
147166
&quot;resource&quot;: &quot;A String&quot;, # Full name of a resource as defined by the service. For example: `//bigquery.googleapis.com/projects/{PROJECT_ID}/locations/{LOCATION}/datasets/{DATASET_ID}/tables/{TABLE_ID}`
148167
&quot;service&quot;: &quot;A String&quot;, # Service that physically stores the data.
@@ -267,6 +286,19 @@ <h3>Method Details</h3>
267286
&quot;viewQuery&quot;: &quot;A String&quot;, # Output only. The query that defines the table view.
268287
},
269288
},
289+
&quot;businessContext&quot;: { # Business Context of the entry. # Business Context of the entry.
290+
&quot;contacts&quot;: { # Contact people for the entry. # Contact people for the entry.
291+
&quot;people&quot;: [ # The list of contact people for the entry.
292+
{ # A contact person for the entry.
293+
&quot;designation&quot;: &quot;A String&quot;, # Designation of the person, for example, Data Steward.
294+
&quot;email&quot;: &quot;A String&quot;, # Email of the person in the format of `john.doe@xyz`, ``, or `John Doe`.
295+
},
296+
],
297+
},
298+
&quot;entryOverview&quot;: { # Entry overview fields for rich text descriptions of entries. # Entry overview fields for rich text descriptions of entries.
299+
&quot;overview&quot;: &quot;A String&quot;, # Entry overview with support for rich text. The overview must only contain Unicode characters, and should be formatted using HTML. The maximum length is 10 MiB as this value holds HTML descriptions including encoded images. The maximum length of the text without images is 100 KiB.
300+
},
301+
},
270302
&quot;dataSource&quot;: { # Physical location of an entry. # Output only. Physical location of the entry.
271303
&quot;resource&quot;: &quot;A String&quot;, # Full name of a resource as defined by the service. For example: `//bigquery.googleapis.com/projects/{PROJECT_ID}/locations/{LOCATION}/datasets/{DATASET_ID}/tables/{TABLE_ID}`
272304
&quot;service&quot;: &quot;A String&quot;, # Service that physically stores the data.
@@ -415,6 +447,19 @@ <h3>Method Details</h3>
415447
&quot;viewQuery&quot;: &quot;A String&quot;, # Output only. The query that defines the table view.
416448
},
417449
},
450+
&quot;businessContext&quot;: { # Business Context of the entry. # Business Context of the entry.
451+
&quot;contacts&quot;: { # Contact people for the entry. # Contact people for the entry.
452+
&quot;people&quot;: [ # The list of contact people for the entry.
453+
{ # A contact person for the entry.
454+
&quot;designation&quot;: &quot;A String&quot;, # Designation of the person, for example, Data Steward.
455+
&quot;email&quot;: &quot;A String&quot;, # Email of the person in the format of `john.doe@xyz`, ``, or `John Doe`.
456+
},
457+
],
458+
},
459+
&quot;entryOverview&quot;: { # Entry overview fields for rich text descriptions of entries. # Entry overview fields for rich text descriptions of entries.
460+
&quot;overview&quot;: &quot;A String&quot;, # Entry overview with support for rich text. The overview must only contain Unicode characters, and should be formatted using HTML. The maximum length is 10 MiB as this value holds HTML descriptions including encoded images. The maximum length of the text without images is 100 KiB.
461+
},
462+
},
418463
&quot;dataSource&quot;: { # Physical location of an entry. # Output only. Physical location of the entry.
419464
&quot;resource&quot;: &quot;A String&quot;, # Full name of a resource as defined by the service. For example: `//bigquery.googleapis.com/projects/{PROJECT_ID}/locations/{LOCATION}/datasets/{DATASET_ID}/tables/{TABLE_ID}`
420465
&quot;service&quot;: &quot;A String&quot;, # Service that physically stores the data.
@@ -593,6 +638,19 @@ <h3>Method Details</h3>
593638
&quot;viewQuery&quot;: &quot;A String&quot;, # Output only. The query that defines the table view.
594639
},
595640
},
641+
&quot;businessContext&quot;: { # Business Context of the entry. # Business Context of the entry.
642+
&quot;contacts&quot;: { # Contact people for the entry. # Contact people for the entry.
643+
&quot;people&quot;: [ # The list of contact people for the entry.
644+
{ # A contact person for the entry.
645+
&quot;designation&quot;: &quot;A String&quot;, # Designation of the person, for example, Data Steward.
646+
&quot;email&quot;: &quot;A String&quot;, # Email of the person in the format of `john.doe@xyz`, ``, or `John Doe`.
647+
},
648+
],
649+
},
650+
&quot;entryOverview&quot;: { # Entry overview fields for rich text descriptions of entries. # Entry overview fields for rich text descriptions of entries.
651+
&quot;overview&quot;: &quot;A String&quot;, # Entry overview with support for rich text. The overview must only contain Unicode characters, and should be formatted using HTML. The maximum length is 10 MiB as this value holds HTML descriptions including encoded images. The maximum length of the text without images is 100 KiB.
652+
},
653+
},
596654
&quot;dataSource&quot;: { # Physical location of an entry. # Output only. Physical location of the entry.
597655
&quot;resource&quot;: &quot;A String&quot;, # Full name of a resource as defined by the service. For example: `//bigquery.googleapis.com/projects/{PROJECT_ID}/locations/{LOCATION}/datasets/{DATASET_ID}/tables/{TABLE_ID}`
598656
&quot;service&quot;: &quot;A String&quot;, # Service that physically stores the data.
@@ -710,6 +768,72 @@ <h3>Method Details</h3>
710768
</pre>
711769
</div>
712770

771+
<div class="method">
772+
<code class="details" id="modifyEntryContacts">modifyEntryContacts(name, body=None, x__xgafv=None)</code>
773+
<pre>Modifies contacts, part of the business context of an Entry. To call this method, you must have the `datacatalog.entries.updateContacts` IAM permission on the corresponding project.
774+
775+
Args:
776+
name: string, Required. The full resource name of the entry. (required)
777+
body: object, The request body.
778+
The object takes the form of:
779+
780+
{ # Request message for ModifyEntryContacts.
781+
&quot;contacts&quot;: { # Contact people for the entry. # Required. The new value for the Contacts.
782+
&quot;people&quot;: [ # The list of contact people for the entry.
783+
{ # A contact person for the entry.
784+
&quot;designation&quot;: &quot;A String&quot;, # Designation of the person, for example, Data Steward.
785+
&quot;email&quot;: &quot;A String&quot;, # Email of the person in the format of `john.doe@xyz`, ``, or `John Doe`.
786+
},
787+
],
788+
},
789+
}
790+
791+
x__xgafv: string, V1 error format.
792+
Allowed values
793+
1 - v1 error format
794+
2 - v2 error format
795+
796+
Returns:
797+
An object of the form:
798+
799+
{ # Contact people for the entry.
800+
&quot;people&quot;: [ # The list of contact people for the entry.
801+
{ # A contact person for the entry.
802+
&quot;designation&quot;: &quot;A String&quot;, # Designation of the person, for example, Data Steward.
803+
&quot;email&quot;: &quot;A String&quot;, # Email of the person in the format of `john.doe@xyz`, ``, or `John Doe`.
804+
},
805+
],
806+
}</pre>
807+
</div>
808+
809+
<div class="method">
810+
<code class="details" id="modifyEntryOverview">modifyEntryOverview(name, body=None, x__xgafv=None)</code>
811+
<pre>Modifies entry overview, part of the business context of an Entry. To call this method, you must have the `datacatalog.entries.updateOverview` IAM permission on the corresponding project.
812+
813+
Args:
814+
name: string, Required. The full resource name of the entry. (required)
815+
body: object, The request body.
816+
The object takes the form of:
817+
818+
{ # Request message for ModifyEntryOverview.
819+
&quot;entryOverview&quot;: { # Entry overview fields for rich text descriptions of entries. # Required. The new value for the Entry Overview.
820+
&quot;overview&quot;: &quot;A String&quot;, # Entry overview with support for rich text. The overview must only contain Unicode characters, and should be formatted using HTML. The maximum length is 10 MiB as this value holds HTML descriptions including encoded images. The maximum length of the text without images is 100 KiB.
821+
},
822+
}
823+
824+
x__xgafv: string, V1 error format.
825+
Allowed values
826+
1 - v1 error format
827+
2 - v2 error format
828+
829+
Returns:
830+
An object of the form:
831+
832+
{ # Entry overview fields for rich text descriptions of entries.
833+
&quot;overview&quot;: &quot;A String&quot;, # Entry overview with support for rich text. The overview must only contain Unicode characters, and should be formatted using HTML. The maximum length is 10 MiB as this value holds HTML descriptions including encoded images. The maximum length of the text without images is 100 KiB.
834+
}</pre>
835+
</div>
836+
713837
<div class="method">
714838
<code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
715839
<pre>Updates an existing entry. You must enable the Data Catalog API in the project identified by the `entry.name` parameter. For more information, see [Data Catalog resource project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
@@ -735,6 +859,19 @@ <h3>Method Details</h3>
735859
&quot;viewQuery&quot;: &quot;A String&quot;, # Output only. The query that defines the table view.
736860
},
737861
},
862+
&quot;businessContext&quot;: { # Business Context of the entry. # Business Context of the entry.
863+
&quot;contacts&quot;: { # Contact people for the entry. # Contact people for the entry.
864+
&quot;people&quot;: [ # The list of contact people for the entry.
865+
{ # A contact person for the entry.
866+
&quot;designation&quot;: &quot;A String&quot;, # Designation of the person, for example, Data Steward.
867+
&quot;email&quot;: &quot;A String&quot;, # Email of the person in the format of `john.doe@xyz`, ``, or `John Doe`.
868+
},
869+
],
870+
},
871+
&quot;entryOverview&quot;: { # Entry overview fields for rich text descriptions of entries. # Entry overview fields for rich text descriptions of entries.
872+
&quot;overview&quot;: &quot;A String&quot;, # Entry overview with support for rich text. The overview must only contain Unicode characters, and should be formatted using HTML. The maximum length is 10 MiB as this value holds HTML descriptions including encoded images. The maximum length of the text without images is 100 KiB.
873+
},
874+
},
738875
&quot;dataSource&quot;: { # Physical location of an entry. # Output only. Physical location of the entry.
739876
&quot;resource&quot;: &quot;A String&quot;, # Full name of a resource as defined by the service. For example: `//bigquery.googleapis.com/projects/{PROJECT_ID}/locations/{LOCATION}/datasets/{DATASET_ID}/tables/{TABLE_ID}`
740877
&quot;service&quot;: &quot;A String&quot;, # Service that physically stores the data.
@@ -859,6 +996,19 @@ <h3>Method Details</h3>
859996
&quot;viewQuery&quot;: &quot;A String&quot;, # Output only. The query that defines the table view.
860997
},
861998
},
999+
&quot;businessContext&quot;: { # Business Context of the entry. # Business Context of the entry.
1000+
&quot;contacts&quot;: { # Contact people for the entry. # Contact people for the entry.
1001+
&quot;people&quot;: [ # The list of contact people for the entry.
1002+
{ # A contact person for the entry.
1003+
&quot;designation&quot;: &quot;A String&quot;, # Designation of the person, for example, Data Steward.
1004+
&quot;email&quot;: &quot;A String&quot;, # Email of the person in the format of `john.doe@xyz`, ``, or `John Doe`.
1005+
},
1006+
],
1007+
},
1008+
&quot;entryOverview&quot;: { # Entry overview fields for rich text descriptions of entries. # Entry overview fields for rich text descriptions of entries.
1009+
&quot;overview&quot;: &quot;A String&quot;, # Entry overview with support for rich text. The overview must only contain Unicode characters, and should be formatted using HTML. The maximum length is 10 MiB as this value holds HTML descriptions including encoded images. The maximum length of the text without images is 100 KiB.
1010+
},
1011+
},
8621012
&quot;dataSource&quot;: { # Physical location of an entry. # Output only. Physical location of the entry.
8631013
&quot;resource&quot;: &quot;A String&quot;, # Full name of a resource as defined by the service. For example: `//bigquery.googleapis.com/projects/{PROJECT_ID}/locations/{LOCATION}/datasets/{DATASET_ID}/tables/{TABLE_ID}`
8641014
&quot;service&quot;: &quot;A String&quot;, # Service that physically stores the data.

docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.tags.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
8585
<p class="firstline">Deletes a tag.</p>
8686
<p class="toc_element">
8787
<code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
88-
<p class="firstline">Lists tags assigned to an Entry.</p>
88+
<p class="firstline">Lists tags assigned to an Entry. The columns in the response are lowercased.</p>
8989
<p class="toc_element">
9090
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
9191
<p class="firstline">Retrieves the next page of results.</p>
@@ -178,7 +178,7 @@ <h3>Method Details</h3>
178178

179179
<div class="method">
180180
<code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
181-
<pre>Lists tags assigned to an Entry.
181+
<pre>Lists tags assigned to an Entry. The columns in the response are lowercased.
182182

183183
Args:
184184
parent: string, Required. The name of the Data Catalog resource to list the tags of. The resource can be an Entry or an EntryGroup (without `/entries/{entries}` at the end). (required)

docs/dyn/datacatalog_v1.projects.locations.entryGroups.tags.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
8585
<p class="firstline">Deletes a tag.</p>
8686
<p class="toc_element">
8787
<code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
88-
<p class="firstline">Lists tags assigned to an Entry.</p>
88+
<p class="firstline">Lists tags assigned to an Entry. The columns in the response are lowercased.</p>
8989
<p class="toc_element">
9090
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
9191
<p class="firstline">Retrieves the next page of results.</p>
@@ -178,7 +178,7 @@ <h3>Method Details</h3>
178178

179179
<div class="method">
180180
<code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
181-
<pre>Lists tags assigned to an Entry.
181+
<pre>Lists tags assigned to an Entry. The columns in the response are lowercased.
182182

183183
Args:
184184
parent: string, Required. The name of the Data Catalog resource to list the tags of. The resource can be an Entry or an EntryGroup (without `/entries/{entries}` at the end). (required)

0 commit comments

Comments
 (0)