Skip to content

Commit ca62bb9

Browse files
feat(retail): update the api
#### retail:v2 The following keys were deleted: - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.ets (Total Keys: 3) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.prebuiltRule (Total Keys: 2) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.rawJson (Total Keys: 2) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.uri (Total Keys: 2) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.userEvent (Total Keys: 2) The following keys were added: - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.request.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2CollectUserEventRequest (Total Keys: 8) The following keys were changed: - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.httpMethod (Total Keys: 1) #### retail:v2alpha The following keys were deleted: - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.ets (Total Keys: 3) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.prebuiltRule (Total Keys: 2) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.rawJson (Total Keys: 2) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.uri (Total Keys: 2) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.userEvent (Total Keys: 2) The following keys were added: - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.request.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2alphaCollectUserEventRequest (Total Keys: 8) The following keys were changed: - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.httpMethod (Total Keys: 1) #### retail:v2beta The following keys were deleted: - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.ets (Total Keys: 3) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.prebuiltRule (Total Keys: 2) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.rawJson (Total Keys: 2) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.uri (Total Keys: 2) - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.parameters.userEvent (Total Keys: 2) The following keys were added: - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.request.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2betaCollectUserEventRequest (Total Keys: 8) The following keys were changed: - resources.projects.resources.locations.resources.catalogs.resources.userEvents.methods.collect.httpMethod (Total Keys: 1)
1 parent 1c9b5fa commit ca62bb9

6 files changed

+147
-114
lines changed

docs/dyn/retail_v2.projects.locations.catalogs.userEvents.html

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -78,8 +78,8 @@ <h2>Instance Methods</h2>
7878
<code><a href="#close">close()</a></code></p>
7979
<p class="firstline">Close httplib2 connections.</p>
8080
<p class="toc_element">
81-
<code><a href="#collect">collect(parent, ets=None, prebuiltRule=None, rawJson=None, uri=None, userEvent=None, x__xgafv=None)</a></code></p>
82-
<p class="firstline">Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.</p>
81+
<code><a href="#collect">collect(parent, body=None, x__xgafv=None)</a></code></p>
82+
<p class="firstline">Writes a single user event from the browser. For larger user event payload over 16 KB, the POST method should be used instead, otherwise a 400 Bad Request error is returned. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.</p>
8383
<p class="toc_element">
8484
<code><a href="#import_">import_(parent, body=None, x__xgafv=None)</a></code></p>
8585
<p class="firstline">Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. `Operation.response` is of type `ImportResponse`. Note that it is possible for a subset of the items to be successfully inserted. `Operation.metadata` is of type `ImportMetadata`.</p>
@@ -99,16 +99,22 @@ <h3>Method Details</h3>
9999
</div>
100100

101101
<div class="method">
102-
<code class="details" id="collect">collect(parent, ets=None, prebuiltRule=None, rawJson=None, uri=None, userEvent=None, x__xgafv=None)</code>
103-
<pre>Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.
102+
<code class="details" id="collect">collect(parent, body=None, x__xgafv=None)</code>
103+
<pre>Writes a single user event from the browser. For larger user event payload over 16 KB, the POST method should be used instead, otherwise a 400 Bad Request error is returned. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.
104104

105105
Args:
106106
parent: string, Required. The parent catalog name, such as `projects/1234/locations/global/catalogs/default_catalog`. (required)
107-
ets: string, The event timestamp in milliseconds. This prevents browser caching of otherwise identical get requests. The name is abbreviated to reduce the payload bytes.
108-
prebuiltRule: string, The prebuilt rule name that can convert a specific type of raw_json. For example: &quot;ga4_bq&quot; rule for the GA4 user event schema.
109-
rawJson: string, An arbitrary serialized JSON string that contains necessary information that can comprise a user event. When this field is specified, the user_event field will be ignored. Note: line-delimited JSON is not supported, a single JSON only.
110-
uri: string, The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for 3rd party requests.
111-
userEvent: string, Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
107+
body: object, The request body.
108+
The object takes the form of:
109+
110+
{ # Request message for CollectUserEvent method.
111+
&quot;ets&quot;: &quot;A String&quot;, # The event timestamp in milliseconds. This prevents browser caching of otherwise identical get requests. The name is abbreviated to reduce the payload bytes.
112+
&quot;prebuiltRule&quot;: &quot;A String&quot;, # The prebuilt rule name that can convert a specific type of raw_json. For example: &quot;ga4_bq&quot; rule for the GA4 user event schema.
113+
&quot;rawJson&quot;: &quot;A String&quot;, # An arbitrary serialized JSON string that contains necessary information that can comprise a user event. When this field is specified, the user_event field will be ignored. Note: line-delimited JSON is not supported, a single JSON only.
114+
&quot;uri&quot;: &quot;A String&quot;, # The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for 3rd party requests.
115+
&quot;userEvent&quot;: &quot;A String&quot;, # Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
116+
}
117+
112118
x__xgafv: string, V1 error format.
113119
Allowed values
114120
1 - v1 error format

docs/dyn/retail_v2alpha.projects.locations.catalogs.userEvents.html

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -78,8 +78,8 @@ <h2>Instance Methods</h2>
7878
<code><a href="#close">close()</a></code></p>
7979
<p class="firstline">Close httplib2 connections.</p>
8080
<p class="toc_element">
81-
<code><a href="#collect">collect(parent, ets=None, prebuiltRule=None, rawJson=None, uri=None, userEvent=None, x__xgafv=None)</a></code></p>
82-
<p class="firstline">Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.</p>
81+
<code><a href="#collect">collect(parent, body=None, x__xgafv=None)</a></code></p>
82+
<p class="firstline">Writes a single user event from the browser. For larger user event payload over 16 KB, the POST method should be used instead, otherwise a 400 Bad Request error is returned. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.</p>
8383
<p class="toc_element">
8484
<code><a href="#export">export(parent, body=None, x__xgafv=None)</a></code></p>
8585
<p class="firstline">Exports user events. `Operation.response` is of type `ExportResponse`. `Operation.metadata` is of type `ExportMetadata`.</p>
@@ -102,16 +102,22 @@ <h3>Method Details</h3>
102102
</div>
103103

104104
<div class="method">
105-
<code class="details" id="collect">collect(parent, ets=None, prebuiltRule=None, rawJson=None, uri=None, userEvent=None, x__xgafv=None)</code>
106-
<pre>Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.
105+
<code class="details" id="collect">collect(parent, body=None, x__xgafv=None)</code>
106+
<pre>Writes a single user event from the browser. For larger user event payload over 16 KB, the POST method should be used instead, otherwise a 400 Bad Request error is returned. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.
107107

108108
Args:
109109
parent: string, Required. The parent catalog name, such as `projects/1234/locations/global/catalogs/default_catalog`. (required)
110-
ets: string, The event timestamp in milliseconds. This prevents browser caching of otherwise identical get requests. The name is abbreviated to reduce the payload bytes.
111-
prebuiltRule: string, The prebuilt rule name that can convert a specific type of raw_json. For example: &quot;ga4_bq&quot; rule for the GA4 user event schema.
112-
rawJson: string, An arbitrary serialized JSON string that contains necessary information that can comprise a user event. When this field is specified, the user_event field will be ignored. Note: line-delimited JSON is not supported, a single JSON only.
113-
uri: string, The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for 3rd party requests.
114-
userEvent: string, Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
110+
body: object, The request body.
111+
The object takes the form of:
112+
113+
{ # Request message for CollectUserEvent method.
114+
&quot;ets&quot;: &quot;A String&quot;, # The event timestamp in milliseconds. This prevents browser caching of otherwise identical get requests. The name is abbreviated to reduce the payload bytes.
115+
&quot;prebuiltRule&quot;: &quot;A String&quot;, # The prebuilt rule name that can convert a specific type of raw_json. For example: &quot;ga4_bq&quot; rule for the GA4 user event schema.
116+
&quot;rawJson&quot;: &quot;A String&quot;, # An arbitrary serialized JSON string that contains necessary information that can comprise a user event. When this field is specified, the user_event field will be ignored. Note: line-delimited JSON is not supported, a single JSON only.
117+
&quot;uri&quot;: &quot;A String&quot;, # The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for 3rd party requests.
118+
&quot;userEvent&quot;: &quot;A String&quot;, # Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
119+
}
120+
115121
x__xgafv: string, V1 error format.
116122
Allowed values
117123
1 - v1 error format

docs/dyn/retail_v2beta.projects.locations.catalogs.userEvents.html

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -78,8 +78,8 @@ <h2>Instance Methods</h2>
7878
<code><a href="#close">close()</a></code></p>
7979
<p class="firstline">Close httplib2 connections.</p>
8080
<p class="toc_element">
81-
<code><a href="#collect">collect(parent, ets=None, prebuiltRule=None, rawJson=None, uri=None, userEvent=None, x__xgafv=None)</a></code></p>
82-
<p class="firstline">Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.</p>
81+
<code><a href="#collect">collect(parent, body=None, x__xgafv=None)</a></code></p>
82+
<p class="firstline">Writes a single user event from the browser. For larger user event payload over 16 KB, the POST method should be used instead, otherwise a 400 Bad Request error is returned. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.</p>
8383
<p class="toc_element">
8484
<code><a href="#export">export(parent, body=None, x__xgafv=None)</a></code></p>
8585
<p class="firstline">Exports user events. `Operation.response` is of type `ExportResponse`. `Operation.metadata` is of type `ExportMetadata`.</p>
@@ -102,16 +102,22 @@ <h3>Method Details</h3>
102102
</div>
103103

104104
<div class="method">
105-
<code class="details" id="collect">collect(parent, ets=None, prebuiltRule=None, rawJson=None, uri=None, userEvent=None, x__xgafv=None)</code>
106-
<pre>Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.
105+
<code class="details" id="collect">collect(parent, body=None, x__xgafv=None)</code>
106+
<pre>Writes a single user event from the browser. For larger user event payload over 16 KB, the POST method should be used instead, otherwise a 400 Bad Request error is returned. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.
107107

108108
Args:
109109
parent: string, Required. The parent catalog name, such as `projects/1234/locations/global/catalogs/default_catalog`. (required)
110-
ets: string, The event timestamp in milliseconds. This prevents browser caching of otherwise identical get requests. The name is abbreviated to reduce the payload bytes.
111-
prebuiltRule: string, The prebuilt rule name that can convert a specific type of raw_json. For example: &quot;ga4_bq&quot; rule for the GA4 user event schema.
112-
rawJson: string, An arbitrary serialized JSON string that contains necessary information that can comprise a user event. When this field is specified, the user_event field will be ignored. Note: line-delimited JSON is not supported, a single JSON only.
113-
uri: string, The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for 3rd party requests.
114-
userEvent: string, Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
110+
body: object, The request body.
111+
The object takes the form of:
112+
113+
{ # Request message for CollectUserEvent method.
114+
&quot;ets&quot;: &quot;A String&quot;, # The event timestamp in milliseconds. This prevents browser caching of otherwise identical get requests. The name is abbreviated to reduce the payload bytes.
115+
&quot;prebuiltRule&quot;: &quot;A String&quot;, # The prebuilt rule name that can convert a specific type of raw_json. For example: &quot;ga4_bq&quot; rule for the GA4 user event schema.
116+
&quot;rawJson&quot;: &quot;A String&quot;, # An arbitrary serialized JSON string that contains necessary information that can comprise a user event. When this field is specified, the user_event field will be ignored. Note: line-delimited JSON is not supported, a single JSON only.
117+
&quot;uri&quot;: &quot;A String&quot;, # The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for 3rd party requests.
118+
&quot;userEvent&quot;: &quot;A String&quot;, # Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.
119+
}
120+
115121
x__xgafv: string, V1 error format.
116122
Allowed values
117123
1 - v1 error format

googleapiclient/discovery_cache/documents/retail.v2.json

Lines changed: 34 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1930,49 +1930,26 @@
19301930
"userEvents": {
19311931
"methods": {
19321932
"collect": {
1933-
"description": "Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.",
1933+
"description": "Writes a single user event from the browser. For larger user event payload over 16 KB, the POST method should be used instead, otherwise a 400 Bad Request error is returned. This method is used only by the Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.",
19341934
"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/userEvents:collect",
1935-
"httpMethod": "GET",
1935+
"httpMethod": "POST",
19361936
"id": "retail.projects.locations.catalogs.userEvents.collect",
19371937
"parameterOrder": [
19381938
"parent"
19391939
],
19401940
"parameters": {
1941-
"ets": {
1942-
"description": "The event timestamp in milliseconds. This prevents browser caching of otherwise identical get requests. The name is abbreviated to reduce the payload bytes.",
1943-
"format": "int64",
1944-
"location": "query",
1945-
"type": "string"
1946-
},
19471941
"parent": {
19481942
"description": "Required. The parent catalog name, such as `projects/1234/locations/global/catalogs/default_catalog`.",
19491943
"location": "path",
19501944
"pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$",
19511945
"required": true,
19521946
"type": "string"
1953-
},
1954-
"prebuiltRule": {
1955-
"description": "The prebuilt rule name that can convert a specific type of raw_json. For example: \"ga4_bq\" rule for the GA4 user event schema.",
1956-
"location": "query",
1957-
"type": "string"
1958-
},
1959-
"rawJson": {
1960-
"description": "An arbitrary serialized JSON string that contains necessary information that can comprise a user event. When this field is specified, the user_event field will be ignored. Note: line-delimited JSON is not supported, a single JSON only.",
1961-
"location": "query",
1962-
"type": "string"
1963-
},
1964-
"uri": {
1965-
"description": "The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for 3rd party requests.",
1966-
"location": "query",
1967-
"type": "string"
1968-
},
1969-
"userEvent": {
1970-
"description": "Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.",
1971-
"location": "query",
1972-
"type": "string"
19731947
}
19741948
},
19751949
"path": "v2/{+parent}/userEvents:collect",
1950+
"request": {
1951+
"$ref": "GoogleCloudRetailV2CollectUserEventRequest"
1952+
},
19761953
"response": {
19771954
"$ref": "GoogleApiHttpBody"
19781955
},
@@ -2246,7 +2223,7 @@
22462223
}
22472224
}
22482225
},
2249-
"revision": "20241205",
2226+
"revision": "20241220",
22502227
"rootUrl": "https://retail.googleapis.com/",
22512228
"schemas": {
22522229
"GoogleApiHttpBody": {
@@ -2859,6 +2836,34 @@
28592836
},
28602837
"type": "object"
28612838
},
2839+
"GoogleCloudRetailV2CollectUserEventRequest": {
2840+
"description": "Request message for CollectUserEvent method.",
2841+
"id": "GoogleCloudRetailV2CollectUserEventRequest",
2842+
"properties": {
2843+
"ets": {
2844+
"description": "The event timestamp in milliseconds. This prevents browser caching of otherwise identical get requests. The name is abbreviated to reduce the payload bytes.",
2845+
"format": "int64",
2846+
"type": "string"
2847+
},
2848+
"prebuiltRule": {
2849+
"description": "The prebuilt rule name that can convert a specific type of raw_json. For example: \"ga4_bq\" rule for the GA4 user event schema.",
2850+
"type": "string"
2851+
},
2852+
"rawJson": {
2853+
"description": "An arbitrary serialized JSON string that contains necessary information that can comprise a user event. When this field is specified, the user_event field will be ignored. Note: line-delimited JSON is not supported, a single JSON only.",
2854+
"type": "string"
2855+
},
2856+
"uri": {
2857+
"description": "The URL including cgi-parameters but excluding the hash fragment with a length limit of 5,000 characters. This is often more useful than the referer URL, because many browsers only send the domain for 3rd party requests.",
2858+
"type": "string"
2859+
},
2860+
"userEvent": {
2861+
"description": "Required. URL encoded UserEvent proto with a length limit of 2,000,000 characters.",
2862+
"type": "string"
2863+
}
2864+
},
2865+
"type": "object"
2866+
},
28622867
"GoogleCloudRetailV2ColorInfo": {
28632868
"description": "The color information of a Product.",
28642869
"id": "GoogleCloudRetailV2ColorInfo",

0 commit comments

Comments
 (0)