From 4b4693b7ea9034f9e4e61b86da535c5322185725 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Mon, 11 Jul 2022 06:24:51 -0700 Subject: [PATCH] feat(all): auto-regenerate discovery clients (#1613) --- api-list.json | 15 + .../v1beta1/bigqueryconnection-api.json | 7 +- .../v1beta1/bigqueryconnection-gen.go | 7 + datastream/v1/datastream-api.json | 4 +- datastream/v1/datastream-gen.go | 1 - dialogflow/v3/dialogflow-api.json | 4 +- dialogflow/v3/dialogflow-gen.go | 8 +- dialogflow/v3beta1/dialogflow-api.json | 4 +- dialogflow/v3beta1/dialogflow-gen.go | 8 +- monitoring/v1/monitoring-api.json | 111 ++++- monitoring/v1/monitoring-gen.go | 411 ++++++++++++++++++ monitoring/v3/monitoring-api.json | 6 +- monitoring/v3/monitoring-gen.go | 6 +- retail/v2/retail-api.json | 62 +-- retail/v2/retail-gen.go | 168 +++---- retail/v2alpha/retail-api.json | 70 +-- retail/v2alpha/retail-gen.go | 194 +++++---- retail/v2beta/retail-api.json | 68 +-- retail/v2beta/retail-gen.go | 183 ++++---- 19 files changed, 965 insertions(+), 372 deletions(-) diff --git a/api-list.json b/api-list.json index a3402545c61..702daf04cd6 100644 --- a/api-list.json +++ b/api-list.json @@ -991,6 +991,21 @@ "documentationLink": "https://cloud.google.com/asset-inventory/docs/quickstart", "preferred": false }, + { + "kind": "discovery#directoryItem", + "id": "cloudasset:v1p4beta1", + "name": "cloudasset", + "version": "v1p4beta1", + "title": "Cloud Asset API", + "description": "The cloud asset API manages the history and inventory of cloud resources.", + "discoveryRestUrl": "https://cloudasset.googleapis.com/$discovery/rest?version=v1p4beta1", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "documentationLink": "https://cloud.google.com/asset-inventory/docs/quickstart", + "preferred": false + }, { "kind": "discovery#directoryItem", "id": "cloudasset:v1p5beta1", diff --git a/bigqueryconnection/v1beta1/bigqueryconnection-api.json b/bigqueryconnection/v1beta1/bigqueryconnection-api.json index 161a785e97a..9b966f50ef4 100644 --- a/bigqueryconnection/v1beta1/bigqueryconnection-api.json +++ b/bigqueryconnection/v1beta1/bigqueryconnection-api.json @@ -395,7 +395,7 @@ } } }, - "revision": "20220506", + "revision": "20220701", "rootUrl": "https://bigqueryconnection.googleapis.com/", "schemas": { "AuditConfig": { @@ -499,6 +499,11 @@ "description": "Cloud SQL instance ID in the form `project:location:instance`.", "type": "string" }, + "serviceAccountId": { + "description": "Output only. The account ID of the service used for the purpose of this connection. When the connection is used in the context of an operation in BigQuery, this service account will serve as identity being used for connecting to the CloudSQL instance specified in this connection.", + "readOnly": true, + "type": "string" + }, "type": { "description": "Type of the Cloud SQL database.", "enum": [ diff --git a/bigqueryconnection/v1beta1/bigqueryconnection-gen.go b/bigqueryconnection/v1beta1/bigqueryconnection-gen.go index 30c6eb31db0..8aaac45ed29 100644 --- a/bigqueryconnection/v1beta1/bigqueryconnection-gen.go +++ b/bigqueryconnection/v1beta1/bigqueryconnection-gen.go @@ -392,6 +392,13 @@ type CloudSqlProperties struct { // `project:location:instance`. InstanceId string `json:"instanceId,omitempty"` + // ServiceAccountId: Output only. The account ID of the service used for + // the purpose of this connection. When the connection is used in the + // context of an operation in BigQuery, this service account will serve + // as identity being used for connecting to the CloudSQL instance + // specified in this connection. + ServiceAccountId string `json:"serviceAccountId,omitempty"` + // Type: Type of the Cloud SQL database. // // Possible values: diff --git a/datastream/v1/datastream-api.json b/datastream/v1/datastream-api.json index d04a90ffd6b..489f5ab240d 100644 --- a/datastream/v1/datastream-api.json +++ b/datastream/v1/datastream-api.json @@ -1217,7 +1217,7 @@ } } }, - "revision": "20220405", + "revision": "20220629", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AvroFileFormat": { @@ -2682,7 +2682,7 @@ "id": "VpcPeeringConfig", "properties": { "subnet": { - "description": "Required. A free subnet for peering. (CIDR of /29) TODO(b/172995841) add validators.", + "description": "Required. A free subnet for peering. (CIDR of /29)", "type": "string" }, "vpc": { diff --git a/datastream/v1/datastream-gen.go b/datastream/v1/datastream-gen.go index 79fb54864fc..2f7a05795ed 100644 --- a/datastream/v1/datastream-gen.go +++ b/datastream/v1/datastream-gen.go @@ -2393,7 +2393,6 @@ func (s *ValidationResult) MarshalJSON() ([]byte, error) { // peering between Datastream and the consumer's VPC. type VpcPeeringConfig struct { // Subnet: Required. A free subnet for peering. (CIDR of /29) - // TODO(b/172995841) add validators. Subnet string `json:"subnet,omitempty"` // Vpc: Required. Fully qualified name of the VPC that Datastream will diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index 7c36072a26f..ff6d9e04186 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -3820,11 +3820,11 @@ } } }, - "revision": "20220616", + "revision": "20220706", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { - "description": "Hierarchical advanced settings for agent/flow/page/fulfillment/parameter. Settings exposed at lower level overrides the settings exposed at higher level. Hierarchy: Agent-\u003eFlow-\u003ePage-\u003eFulfillment/Parameter.", + "description": "Hierarchical advanced settings for agent/flow/page/fulfillment/parameter. Settings exposed at lower level overrides the settings exposed at higher level. Overriding occurs at the sub-setting level. For example, the playback_interruption_settings at fulfillment level only overrides the playback_interruption_settings at the agent level, leaving other settings at the agent level unchanged. DTMF settings does not override each other. DTMF settings set at different levels define DTMF detections running in parallel. Hierarchy: Agent-\u003eFlow-\u003ePage-\u003eFulfillment/Parameter.", "id": "GoogleCloudDialogflowCxV3AdvancedSettings", "properties": { "loggingSettings": { diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 91c88d11a1f..54c94caa12f 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -435,7 +435,13 @@ type ProjectsOperationsService struct { // GoogleCloudDialogflowCxV3AdvancedSettings: Hierarchical advanced // settings for agent/flow/page/fulfillment/parameter. Settings exposed // at lower level overrides the settings exposed at higher level. -// Hierarchy: Agent->Flow->Page->Fulfillment/Parameter. +// Overriding occurs at the sub-setting level. For example, the +// playback_interruption_settings at fulfillment level only overrides +// the playback_interruption_settings at the agent level, leaving other +// settings at the agent level unchanged. DTMF settings does not +// override each other. DTMF settings set at different levels define +// DTMF detections running in parallel. Hierarchy: +// Agent->Flow->Page->Fulfillment/Parameter. type GoogleCloudDialogflowCxV3AdvancedSettings struct { // LoggingSettings: Settings for logging. Settings for Dialogflow // History, Contact Center messages, StackDriver logs, and speech diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index 7fc04a1592a..b38b4283fd8 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -3820,7 +3820,7 @@ } } }, - "revision": "20220616", + "revision": "20220706", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -5615,7 +5615,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1AdvancedSettings": { - "description": "Hierarchical advanced settings for agent/flow/page/fulfillment/parameter. Settings exposed at lower level overrides the settings exposed at higher level. Hierarchy: Agent-\u003eFlow-\u003ePage-\u003eFulfillment/Parameter.", + "description": "Hierarchical advanced settings for agent/flow/page/fulfillment/parameter. Settings exposed at lower level overrides the settings exposed at higher level. Overriding occurs at the sub-setting level. For example, the playback_interruption_settings at fulfillment level only overrides the playback_interruption_settings at the agent level, leaving other settings at the agent level unchanged. DTMF settings does not override each other. DTMF settings set at different levels define DTMF detections running in parallel. Hierarchy: Agent-\u003eFlow-\u003ePage-\u003eFulfillment/Parameter.", "id": "GoogleCloudDialogflowCxV3beta1AdvancedSettings", "properties": { "loggingSettings": { diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index 9a05efb9496..b95c19ffb03 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -3843,7 +3843,13 @@ func (s *GoogleCloudDialogflowCxV3WebhookServiceDirectoryConfig) MarshalJSON() ( // GoogleCloudDialogflowCxV3beta1AdvancedSettings: Hierarchical advanced // settings for agent/flow/page/fulfillment/parameter. Settings exposed // at lower level overrides the settings exposed at higher level. -// Hierarchy: Agent->Flow->Page->Fulfillment/Parameter. +// Overriding occurs at the sub-setting level. For example, the +// playback_interruption_settings at fulfillment level only overrides +// the playback_interruption_settings at the agent level, leaving other +// settings at the agent level unchanged. DTMF settings does not +// override each other. DTMF settings set at different levels define +// DTMF detections running in parallel. Hierarchy: +// Agent->Flow->Page->Fulfillment/Parameter. type GoogleCloudDialogflowCxV3beta1AdvancedSettings struct { // LoggingSettings: Settings for logging. Settings for Dialogflow // History, Contact Center messages, StackDriver logs, and speech diff --git a/monitoring/v1/monitoring-api.json b/monitoring/v1/monitoring-api.json index 353f16fddde..aa0f81d58cf 100644 --- a/monitoring/v1/monitoring-api.json +++ b/monitoring/v1/monitoring-api.json @@ -446,6 +446,43 @@ "resources": { "v1": { "methods": { + "labels": { + "description": "Lists labels for metrics.", + "flatPath": "v1/projects/{projectsId}/location/{location}/prometheus/api/v1/labels", + "httpMethod": "POST", + "id": "monitoring.projects.location.prometheus.api.v1.labels", + "parameterOrder": [ + "name", + "location" + ], + "parameters": { + "location": { + "description": "Location of the resource information. Has to be \"global\" now.", + "location": "path", + "required": true, + "type": "string" + }, + "name": { + "description": "The workspace on which to execute the request. It is not part of the open source API but used as a request path prefix to distinguish different virtual Prometheus instances of Google Prometheus Engine. The format is: projects/PROJECT_ID_OR_NUMBER.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}/location/{location}/prometheus/api/v1/labels", + "request": { + "$ref": "ListLabelsRequest" + }, + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/monitoring", + "https://www.googleapis.com/auth/monitoring.read" + ] + }, "query": { "description": "Evaluate a PromQL query at a single point in time.", "flatPath": "v1/projects/{projectsId}/location/{location}/prometheus/api/v1/query", @@ -619,6 +656,59 @@ } } }, + "labels": { + "methods": { + "list": { + "description": "Lists labels for metrics.", + "flatPath": "v1/projects/{projectsId}/location/{location}/prometheus/api/v1/labels", + "httpMethod": "GET", + "id": "monitoring.projects.location.prometheus.api.v1.labels.list", + "parameterOrder": [ + "name", + "location" + ], + "parameters": { + "end": { + "description": "The end time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.", + "location": "query", + "type": "string" + }, + "location": { + "description": "Location of the resource information. Has to be \"global\" now.", + "location": "path", + "required": true, + "type": "string" + }, + "match": { + "description": "A list of matchers encoded in the Prometheus label matcher format to constrain the values to series that satisfy them.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The workspace on which to execute the request. It is not part of the open source API but used as a request path prefix to distinguish different virtual Prometheus instances of Google Prometheus Engine. The format is: projects/PROJECT_ID_OR_NUMBER.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + }, + "start": { + "description": "The start time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/location/{location}/prometheus/api/v1/labels", + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/monitoring", + "https://www.googleapis.com/auth/monitoring.read" + ] + } + } + }, "metadata": { "methods": { "list": { @@ -679,7 +769,7 @@ } } }, - "revision": "20220418", + "revision": "20220704", "rootUrl": "https://monitoring.googleapis.com/", "schemas": { "Aggregation": { @@ -1233,6 +1323,25 @@ }, "type": "object" }, + "ListLabelsRequest": { + "description": "ListLabelsRequest holds all parameters of the Prometheus upstream API for returning a list of label names.", + "id": "ListLabelsRequest", + "properties": { + "end": { + "description": "The end time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.", + "type": "string" + }, + "match": { + "description": "A list of matchers encoded in the Prometheus label matcher format to constrain the values to series that satisfy them.", + "type": "string" + }, + "start": { + "description": "The start time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.", + "type": "string" + } + }, + "type": "object" + }, "ListMetricsScopesByMonitoredProjectResponse": { "description": "Response for the ListMetricsScopesByMonitoredProject method.", "id": "ListMetricsScopesByMonitoredProjectResponse", diff --git a/monitoring/v1/monitoring-gen.go b/monitoring/v1/monitoring-gen.go index 7ed211450ea..7b65d6c46d0 100644 --- a/monitoring/v1/monitoring-gen.go +++ b/monitoring/v1/monitoring-gen.go @@ -278,6 +278,7 @@ type ProjectsLocationPrometheusApiService struct { func NewProjectsLocationPrometheusApiV1Service(s *Service) *ProjectsLocationPrometheusApiV1Service { rs := &ProjectsLocationPrometheusApiV1Service{s: s} rs.Label = NewProjectsLocationPrometheusApiV1LabelService(s) + rs.Labels_ = NewProjectsLocationPrometheusApiV1LabelsService(s) rs.Metadata = NewProjectsLocationPrometheusApiV1MetadataService(s) return rs } @@ -287,6 +288,8 @@ type ProjectsLocationPrometheusApiV1Service struct { Label *ProjectsLocationPrometheusApiV1LabelService + Labels_ *ProjectsLocationPrometheusApiV1LabelsService + Metadata *ProjectsLocationPrometheusApiV1MetadataService } @@ -299,6 +302,15 @@ type ProjectsLocationPrometheusApiV1LabelService struct { s *Service } +func NewProjectsLocationPrometheusApiV1LabelsService(s *Service) *ProjectsLocationPrometheusApiV1LabelsService { + rs := &ProjectsLocationPrometheusApiV1LabelsService{s: s} + return rs +} + +type ProjectsLocationPrometheusApiV1LabelsService struct { + s *Service +} + func NewProjectsLocationPrometheusApiV1MetadataService(s *Service) *ProjectsLocationPrometheusApiV1MetadataService { rs := &ProjectsLocationPrometheusApiV1MetadataService{s: s} return rs @@ -1293,6 +1305,44 @@ func (s *ListDashboardsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListLabelsRequest: ListLabelsRequest holds all parameters of the +// Prometheus upstream API for returning a list of label names. +type ListLabelsRequest struct { + // End: The end time to evaluate the query for. Either floating point + // UNIX seconds or RFC3339 formatted timestamp. + End string `json:"end,omitempty"` + + // Match: A list of matchers encoded in the Prometheus label matcher + // format to constrain the values to series that satisfy them. + Match string `json:"match,omitempty"` + + // Start: The start time to evaluate the query for. Either floating + // point UNIX seconds or RFC3339 formatted timestamp. + Start string `json:"start,omitempty"` + + // ForceSendFields is a list of field names (e.g. "End") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "End") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListLabelsRequest) MarshalJSON() ([]byte, error) { + type NoMethod ListLabelsRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListMetricsScopesByMonitoredProjectResponse: Response for the // ListMetricsScopesByMonitoredProject method. type ListMetricsScopesByMonitoredProjectResponse struct { @@ -4290,6 +4340,165 @@ func (c *ProjectsDashboardsPatchCall) Do(opts ...googleapi.CallOption) (*Dashboa } +// method id "monitoring.projects.location.prometheus.api.v1.labels": + +type ProjectsLocationPrometheusApiV1LabelsCall struct { + s *Service + name string + location string + listlabelsrequest *ListLabelsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Labels: Lists labels for metrics. +// +// - location: Location of the resource information. Has to be "global" +// now. +// - name: The workspace on which to execute the request. It is not part +// of the open source API but used as a request path prefix to +// distinguish different virtual Prometheus instances of Google +// Prometheus Engine. The format is: projects/PROJECT_ID_OR_NUMBER. +func (r *ProjectsLocationPrometheusApiV1Service) Labels(name string, location string, listlabelsrequest *ListLabelsRequest) *ProjectsLocationPrometheusApiV1LabelsCall { + c := &ProjectsLocationPrometheusApiV1LabelsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.location = location + c.listlabelsrequest = listlabelsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationPrometheusApiV1LabelsCall) Fields(s ...googleapi.Field) *ProjectsLocationPrometheusApiV1LabelsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationPrometheusApiV1LabelsCall) Context(ctx context.Context) *ProjectsLocationPrometheusApiV1LabelsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationPrometheusApiV1LabelsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationPrometheusApiV1LabelsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.listlabelsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/location/{location}/prometheus/api/v1/labels") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + "location": c.location, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "monitoring.projects.location.prometheus.api.v1.labels" call. +// Exactly one of *HttpBody or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *HttpBody.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationPrometheusApiV1LabelsCall) Do(opts ...googleapi.CallOption) (*HttpBody, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &HttpBody{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists labels for metrics.", + // "flatPath": "v1/projects/{projectsId}/location/{location}/prometheus/api/v1/labels", + // "httpMethod": "POST", + // "id": "monitoring.projects.location.prometheus.api.v1.labels", + // "parameterOrder": [ + // "name", + // "location" + // ], + // "parameters": { + // "location": { + // "description": "Location of the resource information. Has to be \"global\" now.", + // "location": "path", + // "required": true, + // "type": "string" + // }, + // "name": { + // "description": "The workspace on which to execute the request. It is not part of the open source API but used as a request path prefix to distinguish different virtual Prometheus instances of Google Prometheus Engine. The format is: projects/PROJECT_ID_OR_NUMBER.", + // "location": "path", + // "pattern": "^projects/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}/location/{location}/prometheus/api/v1/labels", + // "request": { + // "$ref": "ListLabelsRequest" + // }, + // "response": { + // "$ref": "HttpBody" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/monitoring", + // "https://www.googleapis.com/auth/monitoring.read" + // ] + // } + +} + // method id "monitoring.projects.location.prometheus.api.v1.query": type ProjectsLocationPrometheusApiV1QueryCall struct { @@ -4982,6 +5191,208 @@ func (c *ProjectsLocationPrometheusApiV1LabelValuesCall) Do(opts ...googleapi.Ca } +// method id "monitoring.projects.location.prometheus.api.v1.labels.list": + +type ProjectsLocationPrometheusApiV1LabelsListCall struct { + s *Service + name string + location string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists labels for metrics. +// +// - location: Location of the resource information. Has to be "global" +// now. +// - name: The workspace on which to execute the request. It is not part +// of the open source API but used as a request path prefix to +// distinguish different virtual Prometheus instances of Google +// Prometheus Engine. The format is: projects/PROJECT_ID_OR_NUMBER. +func (r *ProjectsLocationPrometheusApiV1LabelsService) List(name string, location string) *ProjectsLocationPrometheusApiV1LabelsListCall { + c := &ProjectsLocationPrometheusApiV1LabelsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.location = location + return c +} + +// End sets the optional parameter "end": The end time to evaluate the +// query for. Either floating point UNIX seconds or RFC3339 formatted +// timestamp. +func (c *ProjectsLocationPrometheusApiV1LabelsListCall) End(end string) *ProjectsLocationPrometheusApiV1LabelsListCall { + c.urlParams_.Set("end", end) + return c +} + +// Match sets the optional parameter "match": A list of matchers encoded +// in the Prometheus label matcher format to constrain the values to +// series that satisfy them. +func (c *ProjectsLocationPrometheusApiV1LabelsListCall) Match(match string) *ProjectsLocationPrometheusApiV1LabelsListCall { + c.urlParams_.Set("match", match) + return c +} + +// Start sets the optional parameter "start": The start time to evaluate +// the query for. Either floating point UNIX seconds or RFC3339 +// formatted timestamp. +func (c *ProjectsLocationPrometheusApiV1LabelsListCall) Start(start string) *ProjectsLocationPrometheusApiV1LabelsListCall { + c.urlParams_.Set("start", start) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationPrometheusApiV1LabelsListCall) Fields(s ...googleapi.Field) *ProjectsLocationPrometheusApiV1LabelsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationPrometheusApiV1LabelsListCall) IfNoneMatch(entityTag string) *ProjectsLocationPrometheusApiV1LabelsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationPrometheusApiV1LabelsListCall) Context(ctx context.Context) *ProjectsLocationPrometheusApiV1LabelsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationPrometheusApiV1LabelsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationPrometheusApiV1LabelsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/location/{location}/prometheus/api/v1/labels") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + "location": c.location, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "monitoring.projects.location.prometheus.api.v1.labels.list" call. +// Exactly one of *HttpBody or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *HttpBody.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationPrometheusApiV1LabelsListCall) Do(opts ...googleapi.CallOption) (*HttpBody, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &HttpBody{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists labels for metrics.", + // "flatPath": "v1/projects/{projectsId}/location/{location}/prometheus/api/v1/labels", + // "httpMethod": "GET", + // "id": "monitoring.projects.location.prometheus.api.v1.labels.list", + // "parameterOrder": [ + // "name", + // "location" + // ], + // "parameters": { + // "end": { + // "description": "The end time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.", + // "location": "query", + // "type": "string" + // }, + // "location": { + // "description": "Location of the resource information. Has to be \"global\" now.", + // "location": "path", + // "required": true, + // "type": "string" + // }, + // "match": { + // "description": "A list of matchers encoded in the Prometheus label matcher format to constrain the values to series that satisfy them.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "The workspace on which to execute the request. It is not part of the open source API but used as a request path prefix to distinguish different virtual Prometheus instances of Google Prometheus Engine. The format is: projects/PROJECT_ID_OR_NUMBER.", + // "location": "path", + // "pattern": "^projects/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "start": { + // "description": "The start time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/location/{location}/prometheus/api/v1/labels", + // "response": { + // "$ref": "HttpBody" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/monitoring", + // "https://www.googleapis.com/auth/monitoring.read" + // ] + // } + +} + // method id "monitoring.projects.location.prometheus.api.v1.metadata.list": type ProjectsLocationPrometheusApiV1MetadataListCall struct { diff --git a/monitoring/v3/monitoring-api.json b/monitoring/v3/monitoring-api.json index b789dd55fa8..0eff39aa8a1 100644 --- a/monitoring/v3/monitoring-api.json +++ b/monitoring/v3/monitoring-api.json @@ -2571,7 +2571,7 @@ } } }, - "revision": "20220525", + "revision": "20220704", "rootUrl": "https://monitoring.googleapis.com/", "schemas": { "Aggregation": { @@ -4402,7 +4402,7 @@ "enumDescriptions": [ "An unspecified evaluation missing data option. Equivalent to EVALUATION_MISSING_DATA_NO_OP.", "If there is no data to evaluate the condition, then evaluate the condition as false.", - "If there is no data to evaluate the condition, then evaluate the condition as true. The default for conditions with a duration value.", + "If there is no data to evaluate the condition, then evaluate the condition as true.", "Do not evaluate the condition to any value if there is no data." ], "type": "string" @@ -4537,7 +4537,7 @@ "enumDescriptions": [ "An unspecified evaluation missing data option. Equivalent to EVALUATION_MISSING_DATA_NO_OP.", "If there is no data to evaluate the condition, then evaluate the condition as false.", - "If there is no data to evaluate the condition, then evaluate the condition as true. The default for conditions with a duration value.", + "If there is no data to evaluate the condition, then evaluate the condition as true.", "Do not evaluate the condition to any value if there is no data." ], "type": "string" diff --git a/monitoring/v3/monitoring-gen.go b/monitoring/v3/monitoring-gen.go index f7ac4e90c7e..af26ee8f849 100644 --- a/monitoring/v3/monitoring-gen.go +++ b/monitoring/v3/monitoring-gen.go @@ -3905,8 +3905,7 @@ type MetricThreshold struct { // "EVALUATION_MISSING_DATA_INACTIVE" - If there is no data to // evaluate the condition, then evaluate the condition as false. // "EVALUATION_MISSING_DATA_ACTIVE" - If there is no data to evaluate - // the condition, then evaluate the condition as true. The default for - // conditions with a duration value. + // the condition, then evaluate the condition as true. // "EVALUATION_MISSING_DATA_NO_OP" - Do not evaluate the condition to // any value if there is no data. EvaluationMissingData string `json:"evaluationMissingData,omitempty"` @@ -4193,8 +4192,7 @@ type MonitoringQueryLanguageCondition struct { // "EVALUATION_MISSING_DATA_INACTIVE" - If there is no data to // evaluate the condition, then evaluate the condition as false. // "EVALUATION_MISSING_DATA_ACTIVE" - If there is no data to evaluate - // the condition, then evaluate the condition as true. The default for - // conditions with a duration value. + // the condition, then evaluate the condition as true. // "EVALUATION_MISSING_DATA_NO_OP" - Do not evaluate the condition to // any value if there is no data. EvaluationMissingData string `json:"evaluationMissingData,omitempty"` diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index bcf7df6537a..cd6d969dac8 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -138,7 +138,7 @@ "type": "string" }, "languageCodes": { - "description": "The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", + "description": "Note that this field applies for `user-data` dataset only. For requests with `cloud-retail` dataset, setting this field has no effect. The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", "location": "query", "repeated": true, "type": "string" @@ -327,7 +327,7 @@ "products": { "methods": { "addFulfillmentPlaces": { - "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -355,7 +355,7 @@ ] }, "addLocalInventories": { - "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", @@ -580,7 +580,7 @@ ] }, "removeFulfillmentPlaces": { - "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -608,7 +608,7 @@ ] }, "removeLocalInventories": { - "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", @@ -636,7 +636,7 @@ ] }, "setInventory": { - "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, ProductService.AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.setInventory", @@ -1193,7 +1193,7 @@ } } }, - "revision": "20220617", + "revision": "20220630", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2532,13 +2532,13 @@ "type": "object" }, "GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata": { - "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the RemoveFulfillmentPlaces method.", + "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2RemoveFulfillmentPlacesRequest": { - "description": "Request message for RemoveFulfillmentPlaces method.", + "description": "Request message for ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2RemoveFulfillmentPlacesRequest", "properties": { "allowMissing": { @@ -2565,19 +2565,19 @@ "type": "object" }, "GoogleCloudRetailV2RemoveFulfillmentPlacesResponse": { - "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the RemoveFulfillmentPlaces method.", + "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2RemoveFulfillmentPlacesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2RemoveLocalInventoriesMetadata": { - "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2RemoveLocalInventoriesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2RemoveLocalInventoriesRequest": { - "description": "Request message for RemoveLocalInventories method.", + "description": "Request message for ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2RemoveLocalInventoriesRequest", "properties": { "allowMissing": { @@ -2600,7 +2600,7 @@ "type": "object" }, "GoogleCloudRetailV2RemoveLocalInventoriesResponse": { - "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "description": "Response of the ProductService.RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2RemoveLocalInventoriesResponse", "properties": {}, "type": "object" @@ -2825,7 +2825,7 @@ "type": "string" }, "orderBy": { - "description": "The order in which Facet.values are returned. Allowed values are: * \"count desc\", which means order by Facet.FacetValue.count descending. * \"value desc\", which means order by Facet.FacetValue.value descending. Only applies to textual facets. If not set, textual values are sorted in [natural order](https://en.wikipedia.org/wiki/Natural_sort_order); numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.", + "description": "The order in which SearchResponse.Facet.values are returned. Allowed values are: * \"count desc\", which means order by SearchResponse.Facet.values.count descending. * \"value desc\", which means order by SearchResponse.Facet.values.value descending. Only applies to textual facets. If not set, textual values are sorted in [natural order](https://en.wikipedia.org/wiki/Natural_sort_order); numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.", "type": "string" }, "prefixes": { @@ -2836,7 +2836,7 @@ "type": "array" }, "query": { - "description": "The query that is used to compute facet for the given facet key. When provided, it will override the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, FacetValue.value will be always \"1\" and FacetValue.count will be the number of results that matches the query. For example, you can set a customized facet for \"shipToStore\", where FacetKey.key is \"customizedShipToStore\", and FacetKey.query is \"availability: ANY(\\\"IN_STOCK\\\") AND shipToStore: ANY(\\\"123\\\")\". Then the facet will count the products that are both in stock and ship to store \"123\".", + "description": "The query that is used to compute facet for the given facet key. When provided, it will override the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, SearchResponse.Facet.values.value will be always \"1\" and SearchResponse.Facet.values.count will be the number of results that match the query. For example, you can set a customized facet for \"shipToStore\", where FacetKey.key is \"customizedShipToStore\", and FacetKey.query is \"availability: ANY(\\\"IN_STOCK\\\") AND shipToStore: ANY(\\\"123\\\")\". Then the facet will count the products that are both in stock and ship to store \"123\".", "type": "string" }, "restrictedValues": { @@ -3089,13 +3089,13 @@ "type": "object" }, "GoogleCloudRetailV2SetInventoryMetadata": { - "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", + "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2SetInventoryMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2SetInventoryRequest": { - "description": "Request message for SetInventory method.", + "description": "Request message for ProductService.SetInventory method.", "id": "GoogleCloudRetailV2SetInventoryRequest", "properties": { "allowMissing": { @@ -3104,7 +3104,7 @@ }, "inventory": { "$ref": "GoogleCloudRetailV2Product", - "description": "Required. The inventory information to update. The allowable fields to update are: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info The updated inventory fields must be specified in SetInventoryRequest.set_mask. If SetInventoryRequest.inventory.name is empty or invalid, an INVALID_ARGUMENT error is returned. If the caller does not have permission to update the Product named in Product.name, regardless of whether or not it exists, a PERMISSION_DENIED error is returned. If the Product to update does not have existing inventory information, the provided inventory information will be inserted. If the Product to update has existing inventory information, the provided inventory information will be merged while respecting the last update time for each inventory field, using the provided or default value for SetInventoryRequest.set_time. The caller can replace place IDs for a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types and corresponding place IDs to update in SetInventoryRequest.inventory.fulfillment_info The caller can clear all place IDs from a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types to clear in SetInventoryRequest.inventory.fulfillment_info * Checks that only the desired fulfillment info types have empty SetInventoryRequest.inventory.fulfillment_info.place_ids The last update time is recorded for the following inventory fields: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info If a full overwrite of inventory information while ignoring timestamps is needed, UpdateProduct should be invoked instead." + "description": "Required. The inventory information to update. The allowable fields to update are: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info The updated inventory fields must be specified in SetInventoryRequest.set_mask. If SetInventoryRequest.inventory.name is empty or invalid, an INVALID_ARGUMENT error is returned. If the caller does not have permission to update the Product named in Product.name, regardless of whether or not it exists, a PERMISSION_DENIED error is returned. If the Product to update does not have existing inventory information, the provided inventory information will be inserted. If the Product to update has existing inventory information, the provided inventory information will be merged while respecting the last update time for each inventory field, using the provided or default value for SetInventoryRequest.set_time. The caller can replace place IDs for a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types and corresponding place IDs to update in SetInventoryRequest.inventory.fulfillment_info The caller can clear all place IDs from a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types to clear in SetInventoryRequest.inventory.fulfillment_info * Checks that only the desired fulfillment info types have empty SetInventoryRequest.inventory.fulfillment_info.place_ids The last update time is recorded for the following inventory fields: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info If a full overwrite of inventory information while ignoring timestamps is needed, ProductService.UpdateProduct should be invoked instead." }, "setMask": { "description": "Indicates which inventory fields in the provided Product to update. At least one field must be provided. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned and the entire update will be ignored.", @@ -3120,7 +3120,7 @@ "type": "object" }, "GoogleCloudRetailV2SetInventoryResponse": { - "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the SetInventory method.", + "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2SetInventoryResponse", "properties": {}, "type": "object" @@ -3570,37 +3570,37 @@ "type": "object" }, "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata": { - "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the RemoveFulfillmentPlaces method.", + "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse": { - "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the RemoveFulfillmentPlaces method.", + "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata": { - "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse": { - "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "description": "Response of the ProductService.RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaSetInventoryMetadata": { - "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", + "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2alphaSetInventoryMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaSetInventoryResponse": { - "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the SetInventory method.", + "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2alphaSetInventoryResponse", "properties": {}, "type": "object" @@ -3847,37 +3847,37 @@ "type": "object" }, "GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata": { - "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the RemoveFulfillmentPlaces method.", + "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse": { - "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the RemoveFulfillmentPlaces method.", + "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata": { - "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse": { - "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "description": "Response of the ProductService.RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaSetInventoryMetadata": { - "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", + "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2betaSetInventoryMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaSetInventoryResponse": { - "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the SetInventory method.", + "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2betaSetInventoryResponse", "properties": {}, "type": "object" diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index 68b9c1fa91a..29034e52b4b 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -3051,12 +3051,12 @@ func (s *GoogleCloudRetailV2RejoinUserEventsResponse) MarshalJSON() ([]byte, err // GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata: Metadata related // to the progress of the RemoveFulfillmentPlaces operation. Currently // empty because there is no meaningful metadata populated from the -// RemoveFulfillmentPlaces method. +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata struct { } // GoogleCloudRetailV2RemoveFulfillmentPlacesRequest: Request message -// for RemoveFulfillmentPlaces method. +// for ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2RemoveFulfillmentPlacesRequest struct { // AllowMissing: If set to true, and the Product is not found, the // fulfillment information will still be processed and retained for at @@ -3113,20 +3113,20 @@ func (s *GoogleCloudRetailV2RemoveFulfillmentPlacesRequest) MarshalJSON() ([]byt // GoogleCloudRetailV2RemoveFulfillmentPlacesResponse: Response of the // RemoveFulfillmentPlacesRequest. Currently empty because there is no -// meaningful response populated from the RemoveFulfillmentPlaces -// method. +// meaningful response populated from the +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2RemoveFulfillmentPlacesResponse struct { } // GoogleCloudRetailV2RemoveLocalInventoriesMetadata: Metadata related // to the progress of the RemoveLocalInventories operation. Currently // empty because there is no meaningful metadata populated from the -// RemoveLocalInventories method. +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2RemoveLocalInventoriesMetadata struct { } // GoogleCloudRetailV2RemoveLocalInventoriesRequest: Request message for -// RemoveLocalInventories method. +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2RemoveLocalInventoriesRequest struct { // AllowMissing: If set to true, and the Product is not found, the local // inventory removal request will still be processed and retained for at @@ -3167,8 +3167,9 @@ func (s *GoogleCloudRetailV2RemoveLocalInventoriesRequest) MarshalJSON() ([]byte } // GoogleCloudRetailV2RemoveLocalInventoriesResponse: Response of the -// RemoveLocalInventories API. Currently empty because there is no -// meaningful response populated from the RemoveLocalInventories method. +// ProductService.RemoveLocalInventories API. Currently empty because +// there is no meaningful response populated from the +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2RemoveLocalInventoriesResponse struct { } @@ -3636,13 +3637,13 @@ type GoogleCloudRetailV2SearchRequestFacetSpecFacetKey struct { // "inventory(place_id,attributes.key)" Key string `json:"key,omitempty"` - // OrderBy: The order in which Facet.values are returned. Allowed values - // are: * "count desc", which means order by Facet.FacetValue.count - // descending. * "value desc", which means order by - // Facet.FacetValue.value descending. Only applies to textual facets. If - // not set, textual values are sorted in natural order - // (https://en.wikipedia.org/wiki/Natural_sort_order); numerical - // intervals are sorted in the order given by + // OrderBy: The order in which SearchResponse.Facet.values are returned. + // Allowed values are: * "count desc", which means order by + // SearchResponse.Facet.values.count descending. * "value desc", which + // means order by SearchResponse.Facet.values.value descending. Only + // applies to textual facets. If not set, textual values are sorted in + // natural order (https://en.wikipedia.org/wiki/Natural_sort_order); + // numerical intervals are sorted in the order given by // FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in // the order given by FacetSpec.FacetKey.restricted_values. OrderBy string `json:"orderBy,omitempty"` @@ -3659,13 +3660,13 @@ type GoogleCloudRetailV2SearchRequestFacetSpecFacetKey struct { // computation. The query syntax is the same as a filter expression. See // SearchRequest.filter for detail syntax and limitations. Notice that // there is no limitation on FacetKey.key when query is specified. In - // the response, FacetValue.value will be always "1" and - // FacetValue.count will be the number of results that matches the - // query. For example, you can set a customized facet for "shipToStore", - // where FacetKey.key is "customizedShipToStore", and FacetKey.query is - // "availability: ANY(\"IN_STOCK\") AND shipToStore: ANY(\"123\")". Then - // the facet will count the products that are both in stock and ship to - // store "123". + // the response, SearchResponse.Facet.values.value will be always "1" + // and SearchResponse.Facet.values.count will be the number of results + // that match the query. For example, you can set a customized facet for + // "shipToStore", where FacetKey.key is "customizedShipToStore", and + // FacetKey.query is "availability: ANY(\"IN_STOCK\") AND shipToStore: + // ANY(\"123\")". Then the facet will count the products that are both + // in stock and ship to store "123". Query string `json:"query,omitempty"` // RestrictedValues: Only get facet for the given restricted values. For @@ -4118,12 +4119,13 @@ func (s *GoogleCloudRetailV2SetDefaultBranchRequest) MarshalJSON() ([]byte, erro // GoogleCloudRetailV2SetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there -// is no meaningful metadata populated from the SetInventory method. +// is no meaningful metadata populated from the +// ProductService.SetInventory method. type GoogleCloudRetailV2SetInventoryMetadata struct { } // GoogleCloudRetailV2SetInventoryRequest: Request message for -// SetInventory method. +// ProductService.SetInventory method. type GoogleCloudRetailV2SetInventoryRequest struct { // AllowMissing: If set to true, and the Product with name Product.name // is not found, the inventory update will still be processed and @@ -4160,7 +4162,7 @@ type GoogleCloudRetailV2SetInventoryRequest struct { // Product.price_info * Product.availability * // Product.available_quantity * Product.fulfillment_info If a full // overwrite of inventory information while ignoring timestamps is - // needed, UpdateProduct should be invoked instead. + // needed, ProductService.UpdateProduct should be invoked instead. Inventory *GoogleCloudRetailV2Product `json:"inventory,omitempty"` // SetMask: Indicates which inventory fields in the provided Product to @@ -4199,7 +4201,7 @@ func (s *GoogleCloudRetailV2SetInventoryRequest) MarshalJSON() ([]byte, error) { // GoogleCloudRetailV2SetInventoryResponse: Response of the // SetInventoryRequest. Currently empty because there is no meaningful -// response populated from the SetInventory method. +// response populated from the ProductService.SetInventory method. type GoogleCloudRetailV2SetInventoryResponse struct { } @@ -5087,39 +5089,41 @@ func (s *GoogleCloudRetailV2alphaRejoinUserEventsResponse) MarshalJSON() ([]byte // GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata: Metadata // related to the progress of the RemoveFulfillmentPlaces operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveFulfillmentPlaces method. +// from the ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata struct { } // GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse: Response of // the RemoveFulfillmentPlacesRequest. Currently empty because there is -// no meaningful response populated from the RemoveFulfillmentPlaces -// method. +// no meaningful response populated from the +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse struct { } // GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata: Metadata // related to the progress of the RemoveLocalInventories operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveLocalInventories method. +// from the ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata struct { } // GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse: Response of -// the RemoveLocalInventories API. Currently empty because there is no -// meaningful response populated from the RemoveLocalInventories method. +// the ProductService.RemoveLocalInventories API. Currently empty +// because there is no meaningful response populated from the +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse struct { } // GoogleCloudRetailV2alphaSetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there -// is no meaningful metadata populated from the SetInventory method. +// is no meaningful metadata populated from the +// ProductService.SetInventory method. type GoogleCloudRetailV2alphaSetInventoryMetadata struct { } // GoogleCloudRetailV2alphaSetInventoryResponse: Response of the // SetInventoryRequest. Currently empty because there is no meaningful -// response populated from the SetInventory method. +// response populated from the ProductService.SetInventory method. type GoogleCloudRetailV2alphaSetInventoryResponse struct { } @@ -5597,39 +5601,41 @@ func (s *GoogleCloudRetailV2betaRejoinUserEventsResponse) MarshalJSON() ([]byte, // GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata: Metadata // related to the progress of the RemoveFulfillmentPlaces operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveFulfillmentPlaces method. +// from the ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata struct { } // GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse: Response of // the RemoveFulfillmentPlacesRequest. Currently empty because there is -// no meaningful response populated from the RemoveFulfillmentPlaces -// method. +// no meaningful response populated from the +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse struct { } // GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata: Metadata // related to the progress of the RemoveLocalInventories operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveLocalInventories method. +// from the ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata struct { } // GoogleCloudRetailV2betaRemoveLocalInventoriesResponse: Response of -// the RemoveLocalInventories API. Currently empty because there is no -// meaningful response populated from the RemoveLocalInventories method. +// the ProductService.RemoveLocalInventories API. Currently empty +// because there is no meaningful response populated from the +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2betaRemoveLocalInventoriesResponse struct { } // GoogleCloudRetailV2betaSetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there -// is no meaningful metadata populated from the SetInventory method. +// is no meaningful metadata populated from the +// ProductService.SetInventory method. type GoogleCloudRetailV2betaSetInventoryMetadata struct { } // GoogleCloudRetailV2betaSetInventoryResponse: Response of the // SetInventoryRequest. Currently empty because there is no meaningful -// response populated from the SetInventory method. +// response populated from the ProductService.SetInventory method. type GoogleCloudRetailV2betaSetInventoryResponse struct { } @@ -5919,7 +5925,9 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) DeviceType(deviceType strin return c } -// LanguageCodes sets the optional parameter "languageCodes": The +// LanguageCodes sets the optional parameter "languageCodes": Note that +// this field applies for `user-data` dataset only. For requests with +// `cloud-retail` dataset, setting this field has no effect. The // language filters applied to the output suggestions. If set, it should // contain the language of the query. If not set, suggestions are // returned without considering language restrictions. This is the @@ -6089,7 +6097,7 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Do(opts ...googleapi.CallOp // "type": "string" // }, // "languageCodes": { - // "description": "The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", + // "description": "Note that this field applies for `user-data` dataset only. For requests with `cloud-retail` dataset, setting this field has no effect. The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", // "location": "query", // "repeated": true, // "type": "string" @@ -6959,9 +6967,10 @@ type ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall struct { // information. If the request is valid, the update will be enqueued and // processed downstream. As a consequence, when a response is returned, // the added place IDs are not immediately manifested in the Product -// queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please enable Retail Search -// on Cloud Console before using this feature. +// queried by ProductService.GetProduct or ProductService.ListProducts. +// This feature is only available for users who have Retail Search +// enabled. Please enable Retail Search on Cloud Console before using +// this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -7066,7 +7075,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o } return ret, nil // { - // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -7114,8 +7123,9 @@ type ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall struct { // information. If the request is valid, the update will be enqueued and // processed downstream. As a consequence, when a response is returned, // updates are not immediately manifested in the Product queried by -// GetProduct or ListProducts. Local inventory information can only be -// modified using this method. CreateProduct and UpdateProduct has no +// ProductService.GetProduct or ProductService.ListProducts. Local +// inventory information can only be modified using this method. +// ProductService.CreateProduct and ProductService.UpdateProduct has no // effect on local inventories. This feature is only available for users // who have Retail Search enabled. Please enable Retail Search on Cloud // Console before using this feature. @@ -7223,7 +7233,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Do(op } return ret, nil // { - // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", @@ -8294,9 +8304,10 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct // information. If the request is valid, the update will be enqueued and // processed downstream. As a consequence, when a response is returned, // the removed place IDs are not immediately manifested in the Product -// queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please enable Retail Search -// on Cloud Console before using this feature. +// queried by ProductService.GetProduct or ProductService.ListProducts. +// This feature is only available for users who have Retail Search +// enabled. Please enable Retail Search on Cloud Console before using +// this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -8401,7 +8412,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D } return ret, nil // { - // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -8447,11 +8458,12 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall struct // asynchronous. If the request is valid, the removal will be enqueued // and processed downstream. As a consequence, when a response is // returned, removals are not immediately manifested in the Product -// queried by GetProduct or ListProducts. Local inventory information -// can only be removed using this method. CreateProduct and -// UpdateProduct has no effect on local inventories. This feature is -// only available for users who have Retail Search enabled. Please -// enable Retail Search on Cloud Console before using this feature. +// queried by ProductService.GetProduct or ProductService.ListProducts. +// Local inventory information can only be removed using this method. +// ProductService.CreateProduct and ProductService.UpdateProduct has no +// effect on local inventories. This feature is only available for users +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -8556,7 +8568,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Do } return ret, nil // { - // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", @@ -8603,21 +8615,23 @@ type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct { // before updating fulfillment information. If the request is valid, the // update will be enqueued and processed downstream. As a consequence, // when a response is returned, updates are not immediately manifested -// in the Product queried by GetProduct or ListProducts. When inventory -// is updated with CreateProduct and UpdateProduct, the specified -// inventory field value(s) will overwrite any existing value(s) while -// ignoring the last update time for this field. Furthermore, the last -// update time for the specified inventory fields will be overwritten to -// the time of the CreateProduct or UpdateProduct request. If no -// inventory fields are set in CreateProductRequest.product, then any -// pre-existing inventory information for this product will be used. If -// no inventory fields are set in SetInventoryRequest.set_mask, then any -// existing inventory information will be preserved. Pre-existing -// inventory information can only be updated with SetInventory, -// ProductService.AddFulfillmentPlaces, and RemoveFulfillmentPlaces. -// This feature is only available for users who have Retail Search -// enabled. Please enable Retail Search on Cloud Console before using -// this feature. +// in the Product queried by ProductService.GetProduct or +// ProductService.ListProducts. When inventory is updated with +// ProductService.CreateProduct and ProductService.UpdateProduct, the +// specified inventory field value(s) will overwrite any existing +// value(s) while ignoring the last update time for this field. +// Furthermore, the last update time for the specified inventory fields +// will be overwritten to the time of the ProductService.CreateProduct +// or ProductService.UpdateProduct request. If no inventory fields are +// set in CreateProductRequest.product, then any pre-existing inventory +// information for this product will be used. If no inventory fields are +// set in SetInventoryRequest.set_mask, then any existing inventory +// information will be preserved. Pre-existing inventory information can +// only be updated with ProductService.SetInventory, +// ProductService.AddFulfillmentPlaces, and +// ProductService.RemoveFulfillmentPlaces. This feature is only +// available for users who have Retail Search enabled. Please enable +// Retail Search on Cloud Console before using this feature. // // - name: Immutable. Full resource name of the product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -8720,7 +8734,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall) Do(opts ...g } return ret, nil // { - // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, ProductService.AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.setInventory", diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index 94f81721f36..6862c98495e 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -138,7 +138,7 @@ "type": "string" }, "languageCodes": { - "description": "The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", + "description": "Note that this field applies for `user-data` dataset only. For requests with `cloud-retail` dataset, setting this field has no effect. The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", "location": "query", "repeated": true, "type": "string" @@ -533,7 +533,7 @@ "products": { "methods": { "addFulfillmentPlaces": { - "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -561,7 +561,7 @@ ] }, "addLocalInventories": { - "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", @@ -791,7 +791,7 @@ ] }, "purge": { - "description": "Permanently deletes all selected Products under a branch. This process is asynchronous. If the request is valid, the removal will be enqueued and processed offline. Depending on the number of Products, this operation could take hours to complete. Before the operation completes, some Products may still be returned by GetProduct or ListProducts. Depending on the number of Products, this operation could take hours to complete. To get a sample of Products that would be deleted, set PurgeProductsRequest.force to false.", + "description": "Permanently deletes all selected Products under a branch. This process is asynchronous. If the request is valid, the removal will be enqueued and processed offline. Depending on the number of Products, this operation could take hours to complete. Before the operation completes, some Products may still be returned by ProductService.GetProduct or ProductService.ListProducts. Depending on the number of Products, this operation could take hours to complete. To get a sample of Products that would be deleted, set PurgeProductsRequest.force to false.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products:purge", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.purge", @@ -819,7 +819,7 @@ ] }, "removeFulfillmentPlaces": { - "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -847,7 +847,7 @@ ] }, "removeLocalInventories": { - "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", @@ -875,7 +875,7 @@ ] }, "setInventory": { - "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, ProductService.AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.setInventory", @@ -1803,7 +1803,7 @@ } } }, - "revision": "20220623", + "revision": "20220630", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2117,37 +2117,37 @@ "type": "object" }, "GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata": { - "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the RemoveFulfillmentPlaces method.", + "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2RemoveFulfillmentPlacesResponse": { - "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the RemoveFulfillmentPlaces method.", + "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2RemoveFulfillmentPlacesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2RemoveLocalInventoriesMetadata": { - "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2RemoveLocalInventoriesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2RemoveLocalInventoriesResponse": { - "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "description": "Response of the ProductService.RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2RemoveLocalInventoriesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2SetInventoryMetadata": { - "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", + "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2SetInventoryMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2SetInventoryResponse": { - "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the SetInventory method.", + "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2SetInventoryResponse", "properties": {}, "type": "object" @@ -2546,7 +2546,7 @@ "properties": { "allowlistInputConfig": { "$ref": "GoogleCloudRetailV2alphaCompletionDataInputConfig", - "description": "Output only. The input config for the import of the source data that contains the autocomplete allowlist phrases uploaded by the customer.", + "description": "Output only. The source data for the latest import of the autocomplete allowlist phrases.", "readOnly": true }, "autoLearning": { @@ -2555,7 +2555,7 @@ }, "denylistInputConfig": { "$ref": "GoogleCloudRetailV2alphaCompletionDataInputConfig", - "description": "Output only. The input config for the import of the source data that contains the / autocomplete denylist phrases uploaded by the customer.", + "description": "Output only. The source data for the latest import of the autocomplete denylist phrases.", "readOnly": true }, "lastAllowlistImportOperation": { @@ -2593,7 +2593,7 @@ }, "suggestionsInputConfig": { "$ref": "GoogleCloudRetailV2alphaCompletionDataInputConfig", - "description": "Output only. The input config for the import of the source data that contains the autocomplete phrases uploaded by the customer.", + "description": "Output only. The source data for the latest import of the autocomplete suggestion phrases.", "readOnly": true } }, @@ -3898,13 +3898,13 @@ "type": "object" }, "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata": { - "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the RemoveFulfillmentPlaces method.", + "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesRequest": { - "description": "Request message for RemoveFulfillmentPlaces method.", + "description": "Request message for ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesRequest", "properties": { "allowMissing": { @@ -3931,19 +3931,19 @@ "type": "object" }, "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse": { - "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the RemoveFulfillmentPlaces method.", + "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata": { - "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaRemoveLocalInventoriesRequest": { - "description": "Request message for RemoveLocalInventories method.", + "description": "Request message for ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2alphaRemoveLocalInventoriesRequest", "properties": { "allowMissing": { @@ -3966,7 +3966,7 @@ "type": "object" }, "GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse": { - "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "description": "Response of the ProductService.RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse", "properties": {}, "type": "object" @@ -4412,7 +4412,7 @@ "type": "string" }, "orderBy": { - "description": "The order in which Facet.values are returned. Allowed values are: * \"count desc\", which means order by Facet.FacetValue.count descending. * \"value desc\", which means order by Facet.FacetValue.value descending. Only applies to textual facets. If not set, textual values are sorted in [natural order](https://en.wikipedia.org/wiki/Natural_sort_order); numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.", + "description": "The order in which SearchResponse.Facet.values are returned. Allowed values are: * \"count desc\", which means order by SearchResponse.Facet.values.count descending. * \"value desc\", which means order by SearchResponse.Facet.values.value descending. Only applies to textual facets. If not set, textual values are sorted in [natural order](https://en.wikipedia.org/wiki/Natural_sort_order); numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.", "type": "string" }, "prefixes": { @@ -4423,7 +4423,7 @@ "type": "array" }, "query": { - "description": "The query that is used to compute facet for the given facet key. When provided, it will override the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, FacetValue.value will be always \"1\" and FacetValue.count will be the number of results that matches the query. For example, you can set a customized facet for \"shipToStore\", where FacetKey.key is \"customizedShipToStore\", and FacetKey.query is \"availability: ANY(\\\"IN_STOCK\\\") AND shipToStore: ANY(\\\"123\\\")\". Then the facet will count the products that are both in stock and ship to store \"123\".", + "description": "The query that is used to compute facet for the given facet key. When provided, it will override the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, SearchResponse.Facet.values.value will be always \"1\" and SearchResponse.Facet.values.count will be the number of results that match the query. For example, you can set a customized facet for \"shipToStore\", where FacetKey.key is \"customizedShipToStore\", and FacetKey.query is \"availability: ANY(\\\"IN_STOCK\\\") AND shipToStore: ANY(\\\"123\\\")\". Then the facet will count the products that are both in stock and ship to store \"123\".", "type": "string" }, "restrictedValues": { @@ -4791,13 +4791,13 @@ "type": "object" }, "GoogleCloudRetailV2alphaSetInventoryMetadata": { - "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", + "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2alphaSetInventoryMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaSetInventoryRequest": { - "description": "Request message for SetInventory method.", + "description": "Request message for ProductService.SetInventory method.", "id": "GoogleCloudRetailV2alphaSetInventoryRequest", "properties": { "allowMissing": { @@ -4806,7 +4806,7 @@ }, "inventory": { "$ref": "GoogleCloudRetailV2alphaProduct", - "description": "Required. The inventory information to update. The allowable fields to update are: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info The updated inventory fields must be specified in SetInventoryRequest.set_mask. If SetInventoryRequest.inventory.name is empty or invalid, an INVALID_ARGUMENT error is returned. If the caller does not have permission to update the Product named in Product.name, regardless of whether or not it exists, a PERMISSION_DENIED error is returned. If the Product to update does not have existing inventory information, the provided inventory information will be inserted. If the Product to update has existing inventory information, the provided inventory information will be merged while respecting the last update time for each inventory field, using the provided or default value for SetInventoryRequest.set_time. The caller can replace place IDs for a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types and corresponding place IDs to update in SetInventoryRequest.inventory.fulfillment_info The caller can clear all place IDs from a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types to clear in SetInventoryRequest.inventory.fulfillment_info * Checks that only the desired fulfillment info types have empty SetInventoryRequest.inventory.fulfillment_info.place_ids The last update time is recorded for the following inventory fields: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info If a full overwrite of inventory information while ignoring timestamps is needed, UpdateProduct should be invoked instead." + "description": "Required. The inventory information to update. The allowable fields to update are: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info The updated inventory fields must be specified in SetInventoryRequest.set_mask. If SetInventoryRequest.inventory.name is empty or invalid, an INVALID_ARGUMENT error is returned. If the caller does not have permission to update the Product named in Product.name, regardless of whether or not it exists, a PERMISSION_DENIED error is returned. If the Product to update does not have existing inventory information, the provided inventory information will be inserted. If the Product to update has existing inventory information, the provided inventory information will be merged while respecting the last update time for each inventory field, using the provided or default value for SetInventoryRequest.set_time. The caller can replace place IDs for a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types and corresponding place IDs to update in SetInventoryRequest.inventory.fulfillment_info The caller can clear all place IDs from a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types to clear in SetInventoryRequest.inventory.fulfillment_info * Checks that only the desired fulfillment info types have empty SetInventoryRequest.inventory.fulfillment_info.place_ids The last update time is recorded for the following inventory fields: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info If a full overwrite of inventory information while ignoring timestamps is needed, ProductService.UpdateProduct should be invoked instead." }, "setMask": { "description": "Indicates which inventory fields in the provided Product to update. At least one field must be provided. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned and the entire update will be ignored.", @@ -4822,7 +4822,7 @@ "type": "object" }, "GoogleCloudRetailV2alphaSetInventoryResponse": { - "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the SetInventory method.", + "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2alphaSetInventoryResponse", "properties": {}, "type": "object" @@ -5226,37 +5226,37 @@ "type": "object" }, "GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata": { - "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the RemoveFulfillmentPlaces method.", + "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse": { - "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the RemoveFulfillmentPlaces method.", + "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata": { - "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse": { - "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "description": "Response of the ProductService.RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaSetInventoryMetadata": { - "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", + "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2betaSetInventoryMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaSetInventoryResponse": { - "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the SetInventory method.", + "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2betaSetInventoryResponse", "properties": {}, "type": "object" diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index 926911d77a7..7fcdcb70990 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -906,39 +906,41 @@ func (s *GoogleCloudRetailV2RejoinUserEventsResponse) MarshalJSON() ([]byte, err // GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata: Metadata related // to the progress of the RemoveFulfillmentPlaces operation. Currently // empty because there is no meaningful metadata populated from the -// RemoveFulfillmentPlaces method. +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata struct { } // GoogleCloudRetailV2RemoveFulfillmentPlacesResponse: Response of the // RemoveFulfillmentPlacesRequest. Currently empty because there is no -// meaningful response populated from the RemoveFulfillmentPlaces -// method. +// meaningful response populated from the +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2RemoveFulfillmentPlacesResponse struct { } // GoogleCloudRetailV2RemoveLocalInventoriesMetadata: Metadata related // to the progress of the RemoveLocalInventories operation. Currently // empty because there is no meaningful metadata populated from the -// RemoveLocalInventories method. +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2RemoveLocalInventoriesMetadata struct { } // GoogleCloudRetailV2RemoveLocalInventoriesResponse: Response of the -// RemoveLocalInventories API. Currently empty because there is no -// meaningful response populated from the RemoveLocalInventories method. +// ProductService.RemoveLocalInventories API. Currently empty because +// there is no meaningful response populated from the +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2RemoveLocalInventoriesResponse struct { } // GoogleCloudRetailV2SetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there -// is no meaningful metadata populated from the SetInventory method. +// is no meaningful metadata populated from the +// ProductService.SetInventory method. type GoogleCloudRetailV2SetInventoryMetadata struct { } // GoogleCloudRetailV2SetInventoryResponse: Response of the // SetInventoryRequest. Currently empty because there is no meaningful -// response populated from the SetInventory method. +// response populated from the ProductService.SetInventory method. type GoogleCloudRetailV2SetInventoryResponse struct { } @@ -1692,9 +1694,8 @@ func (s *GoogleCloudRetailV2alphaCompleteQueryResponseRecentSearchResult) Marsha // GoogleCloudRetailV2alphaCompletionConfig: Catalog level autocomplete // config for customers to customize autocomplete feature's settings. type GoogleCloudRetailV2alphaCompletionConfig struct { - // AllowlistInputConfig: Output only. The input config for the import of - // the source data that contains the autocomplete allowlist phrases - // uploaded by the customer. + // AllowlistInputConfig: Output only. The source data for the latest + // import of the autocomplete allowlist phrases. AllowlistInputConfig *GoogleCloudRetailV2alphaCompletionDataInputConfig `json:"allowlistInputConfig,omitempty"` // AutoLearning: If set to true, the auto learning function is enabled. @@ -1703,9 +1704,8 @@ type GoogleCloudRetailV2alphaCompletionConfig struct { // can users use `cloud-retail` data in CompleteQueryRequest. AutoLearning bool `json:"autoLearning,omitempty"` - // DenylistInputConfig: Output only. The input config for the import of - // the source data that contains the / autocomplete denylist phrases - // uploaded by the customer. + // DenylistInputConfig: Output only. The source data for the latest + // import of the autocomplete denylist phrases. DenylistInputConfig *GoogleCloudRetailV2alphaCompletionDataInputConfig `json:"denylistInputConfig,omitempty"` // LastAllowlistImportOperation: Output only. Name of the LRO @@ -1747,9 +1747,8 @@ type GoogleCloudRetailV2alphaCompletionConfig struct { // `projects/*/locations/*/catalogs/*/completionConfig` Name string `json:"name,omitempty"` - // SuggestionsInputConfig: Output only. The input config for the import - // of the source data that contains the autocomplete phrases uploaded by - // the customer. + // SuggestionsInputConfig: Output only. The source data for the latest + // import of the autocomplete suggestion phrases. SuggestionsInputConfig *GoogleCloudRetailV2alphaCompletionDataInputConfig `json:"suggestionsInputConfig,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4474,12 +4473,12 @@ func (s *GoogleCloudRetailV2alphaRemoveControlRequest) MarshalJSON() ([]byte, er // GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata: Metadata // related to the progress of the RemoveFulfillmentPlaces operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveFulfillmentPlaces method. +// from the ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata struct { } // GoogleCloudRetailV2alphaRemoveFulfillmentPlacesRequest: Request -// message for RemoveFulfillmentPlaces method. +// message for ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2alphaRemoveFulfillmentPlacesRequest struct { // AllowMissing: If set to true, and the Product is not found, the // fulfillment information will still be processed and retained for at @@ -4536,20 +4535,20 @@ func (s *GoogleCloudRetailV2alphaRemoveFulfillmentPlacesRequest) MarshalJSON() ( // GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse: Response of // the RemoveFulfillmentPlacesRequest. Currently empty because there is -// no meaningful response populated from the RemoveFulfillmentPlaces -// method. +// no meaningful response populated from the +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse struct { } // GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata: Metadata // related to the progress of the RemoveLocalInventories operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveLocalInventories method. +// from the ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata struct { } // GoogleCloudRetailV2alphaRemoveLocalInventoriesRequest: Request -// message for RemoveLocalInventories method. +// message for ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2alphaRemoveLocalInventoriesRequest struct { // AllowMissing: If set to true, and the Product is not found, the local // inventory removal request will still be processed and retained for at @@ -4590,8 +4589,9 @@ func (s *GoogleCloudRetailV2alphaRemoveLocalInventoriesRequest) MarshalJSON() ([ } // GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse: Response of -// the RemoveLocalInventories API. Currently empty because there is no -// meaningful response populated from the RemoveLocalInventories method. +// the ProductService.RemoveLocalInventories API. Currently empty +// because there is no meaningful response populated from the +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse struct { } @@ -5485,13 +5485,13 @@ type GoogleCloudRetailV2alphaSearchRequestFacetSpecFacetKey struct { // "inventory(place_id,attributes.key)" Key string `json:"key,omitempty"` - // OrderBy: The order in which Facet.values are returned. Allowed values - // are: * "count desc", which means order by Facet.FacetValue.count - // descending. * "value desc", which means order by - // Facet.FacetValue.value descending. Only applies to textual facets. If - // not set, textual values are sorted in natural order - // (https://en.wikipedia.org/wiki/Natural_sort_order); numerical - // intervals are sorted in the order given by + // OrderBy: The order in which SearchResponse.Facet.values are returned. + // Allowed values are: * "count desc", which means order by + // SearchResponse.Facet.values.count descending. * "value desc", which + // means order by SearchResponse.Facet.values.value descending. Only + // applies to textual facets. If not set, textual values are sorted in + // natural order (https://en.wikipedia.org/wiki/Natural_sort_order); + // numerical intervals are sorted in the order given by // FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in // the order given by FacetSpec.FacetKey.restricted_values. OrderBy string `json:"orderBy,omitempty"` @@ -5508,13 +5508,13 @@ type GoogleCloudRetailV2alphaSearchRequestFacetSpecFacetKey struct { // computation. The query syntax is the same as a filter expression. See // SearchRequest.filter for detail syntax and limitations. Notice that // there is no limitation on FacetKey.key when query is specified. In - // the response, FacetValue.value will be always "1" and - // FacetValue.count will be the number of results that matches the - // query. For example, you can set a customized facet for "shipToStore", - // where FacetKey.key is "customizedShipToStore", and FacetKey.query is - // "availability: ANY(\"IN_STOCK\") AND shipToStore: ANY(\"123\")". Then - // the facet will count the products that are both in stock and ship to - // store "123". + // the response, SearchResponse.Facet.values.value will be always "1" + // and SearchResponse.Facet.values.count will be the number of results + // that match the query. For example, you can set a customized facet for + // "shipToStore", where FacetKey.key is "customizedShipToStore", and + // FacetKey.query is "availability: ANY(\"IN_STOCK\") AND shipToStore: + // ANY(\"123\")". Then the facet will count the products that are both + // in stock and ship to store "123". Query string `json:"query,omitempty"` // RestrictedValues: Only get facet for the given restricted values. For @@ -6134,12 +6134,13 @@ func (s *GoogleCloudRetailV2alphaSetDefaultBranchRequest) MarshalJSON() ([]byte, // GoogleCloudRetailV2alphaSetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there -// is no meaningful metadata populated from the SetInventory method. +// is no meaningful metadata populated from the +// ProductService.SetInventory method. type GoogleCloudRetailV2alphaSetInventoryMetadata struct { } // GoogleCloudRetailV2alphaSetInventoryRequest: Request message for -// SetInventory method. +// ProductService.SetInventory method. type GoogleCloudRetailV2alphaSetInventoryRequest struct { // AllowMissing: If set to true, and the Product with name Product.name // is not found, the inventory update will still be processed and @@ -6176,7 +6177,7 @@ type GoogleCloudRetailV2alphaSetInventoryRequest struct { // Product.price_info * Product.availability * // Product.available_quantity * Product.fulfillment_info If a full // overwrite of inventory information while ignoring timestamps is - // needed, UpdateProduct should be invoked instead. + // needed, ProductService.UpdateProduct should be invoked instead. Inventory *GoogleCloudRetailV2alphaProduct `json:"inventory,omitempty"` // SetMask: Indicates which inventory fields in the provided Product to @@ -6215,7 +6216,7 @@ func (s *GoogleCloudRetailV2alphaSetInventoryRequest) MarshalJSON() ([]byte, err // GoogleCloudRetailV2alphaSetInventoryResponse: Response of the // SetInventoryRequest. Currently empty because there is no meaningful -// response populated from the SetInventory method. +// response populated from the ProductService.SetInventory method. type GoogleCloudRetailV2alphaSetInventoryResponse struct { } @@ -7025,39 +7026,41 @@ func (s *GoogleCloudRetailV2betaRejoinUserEventsResponse) MarshalJSON() ([]byte, // GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata: Metadata // related to the progress of the RemoveFulfillmentPlaces operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveFulfillmentPlaces method. +// from the ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata struct { } // GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse: Response of // the RemoveFulfillmentPlacesRequest. Currently empty because there is -// no meaningful response populated from the RemoveFulfillmentPlaces -// method. +// no meaningful response populated from the +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse struct { } // GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata: Metadata // related to the progress of the RemoveLocalInventories operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveLocalInventories method. +// from the ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata struct { } // GoogleCloudRetailV2betaRemoveLocalInventoriesResponse: Response of -// the RemoveLocalInventories API. Currently empty because there is no -// meaningful response populated from the RemoveLocalInventories method. +// the ProductService.RemoveLocalInventories API. Currently empty +// because there is no meaningful response populated from the +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2betaRemoveLocalInventoriesResponse struct { } // GoogleCloudRetailV2betaSetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there -// is no meaningful metadata populated from the SetInventory method. +// is no meaningful metadata populated from the +// ProductService.SetInventory method. type GoogleCloudRetailV2betaSetInventoryMetadata struct { } // GoogleCloudRetailV2betaSetInventoryResponse: Response of the // SetInventoryRequest. Currently empty because there is no meaningful -// response populated from the SetInventory method. +// response populated from the ProductService.SetInventory method. type GoogleCloudRetailV2betaSetInventoryResponse struct { } @@ -7347,7 +7350,9 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) DeviceType(deviceType strin return c } -// LanguageCodes sets the optional parameter "languageCodes": The +// LanguageCodes sets the optional parameter "languageCodes": Note that +// this field applies for `user-data` dataset only. For requests with +// `cloud-retail` dataset, setting this field has no effect. The // language filters applied to the output suggestions. If set, it should // contain the language of the query. If not set, suggestions are // returned without considering language restrictions. This is the @@ -7517,7 +7522,7 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Do(opts ...googleapi.CallOp // "type": "string" // }, // "languageCodes": { - // "description": "The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", + // "description": "Note that this field applies for `user-data` dataset only. For requests with `cloud-retail` dataset, setting this field has no effect. The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", // "location": "query", // "repeated": true, // "type": "string" @@ -9463,9 +9468,10 @@ type ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall struct { // information. If the request is valid, the update will be enqueued and // processed downstream. As a consequence, when a response is returned, // the added place IDs are not immediately manifested in the Product -// queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please enable Retail Search -// on Cloud Console before using this feature. +// queried by ProductService.GetProduct or ProductService.ListProducts. +// This feature is only available for users who have Retail Search +// enabled. Please enable Retail Search on Cloud Console before using +// this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -9570,7 +9576,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o } return ret, nil // { - // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -9618,8 +9624,9 @@ type ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall struct { // information. If the request is valid, the update will be enqueued and // processed downstream. As a consequence, when a response is returned, // updates are not immediately manifested in the Product queried by -// GetProduct or ListProducts. Local inventory information can only be -// modified using this method. CreateProduct and UpdateProduct has no +// ProductService.GetProduct or ProductService.ListProducts. Local +// inventory information can only be modified using this method. +// ProductService.CreateProduct and ProductService.UpdateProduct has no // effect on local inventories. This feature is only available for users // who have Retail Search enabled. Please enable Retail Search on Cloud // Console before using this feature. @@ -9727,7 +9734,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Do(op } return ret, nil // { - // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", @@ -10811,10 +10818,11 @@ type ProjectsLocationsCatalogsBranchesProductsPurgeCall struct { // process is asynchronous. If the request is valid, the removal will be // enqueued and processed offline. Depending on the number of Products, // this operation could take hours to complete. Before the operation -// completes, some Products may still be returned by GetProduct or -// ListProducts. Depending on the number of Products, this operation -// could take hours to complete. To get a sample of Products that would -// be deleted, set PurgeProductsRequest.force to false. +// completes, some Products may still be returned by +// ProductService.GetProduct or ProductService.ListProducts. Depending +// on the number of Products, this operation could take hours to +// complete. To get a sample of Products that would be deleted, set +// PurgeProductsRequest.force to false. // // - parent: The resource name of the branch under which the products // are created. The format is @@ -10918,7 +10926,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsPurgeCall) Do(opts ...googleap } return ret, nil // { - // "description": "Permanently deletes all selected Products under a branch. This process is asynchronous. If the request is valid, the removal will be enqueued and processed offline. Depending on the number of Products, this operation could take hours to complete. Before the operation completes, some Products may still be returned by GetProduct or ListProducts. Depending on the number of Products, this operation could take hours to complete. To get a sample of Products that would be deleted, set PurgeProductsRequest.force to false.", + // "description": "Permanently deletes all selected Products under a branch. This process is asynchronous. If the request is valid, the removal will be enqueued and processed offline. Depending on the number of Products, this operation could take hours to complete. Before the operation completes, some Products may still be returned by ProductService.GetProduct or ProductService.ListProducts. Depending on the number of Products, this operation could take hours to complete. To get a sample of Products that would be deleted, set PurgeProductsRequest.force to false.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products:purge", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.purge", @@ -10965,9 +10973,10 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct // information. If the request is valid, the update will be enqueued and // processed downstream. As a consequence, when a response is returned, // the removed place IDs are not immediately manifested in the Product -// queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please enable Retail Search -// on Cloud Console before using this feature. +// queried by ProductService.GetProduct or ProductService.ListProducts. +// This feature is only available for users who have Retail Search +// enabled. Please enable Retail Search on Cloud Console before using +// this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -11072,7 +11081,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D } return ret, nil // { - // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -11118,11 +11127,12 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall struct // asynchronous. If the request is valid, the removal will be enqueued // and processed downstream. As a consequence, when a response is // returned, removals are not immediately manifested in the Product -// queried by GetProduct or ListProducts. Local inventory information -// can only be removed using this method. CreateProduct and -// UpdateProduct has no effect on local inventories. This feature is -// only available for users who have Retail Search enabled. Please -// enable Retail Search on Cloud Console before using this feature. +// queried by ProductService.GetProduct or ProductService.ListProducts. +// Local inventory information can only be removed using this method. +// ProductService.CreateProduct and ProductService.UpdateProduct has no +// effect on local inventories. This feature is only available for users +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -11227,7 +11237,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Do } return ret, nil // { - // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", @@ -11274,21 +11284,23 @@ type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct { // before updating fulfillment information. If the request is valid, the // update will be enqueued and processed downstream. As a consequence, // when a response is returned, updates are not immediately manifested -// in the Product queried by GetProduct or ListProducts. When inventory -// is updated with CreateProduct and UpdateProduct, the specified -// inventory field value(s) will overwrite any existing value(s) while -// ignoring the last update time for this field. Furthermore, the last -// update time for the specified inventory fields will be overwritten to -// the time of the CreateProduct or UpdateProduct request. If no -// inventory fields are set in CreateProductRequest.product, then any -// pre-existing inventory information for this product will be used. If -// no inventory fields are set in SetInventoryRequest.set_mask, then any -// existing inventory information will be preserved. Pre-existing -// inventory information can only be updated with SetInventory, -// ProductService.AddFulfillmentPlaces, and RemoveFulfillmentPlaces. -// This feature is only available for users who have Retail Search -// enabled. Please enable Retail Search on Cloud Console before using -// this feature. +// in the Product queried by ProductService.GetProduct or +// ProductService.ListProducts. When inventory is updated with +// ProductService.CreateProduct and ProductService.UpdateProduct, the +// specified inventory field value(s) will overwrite any existing +// value(s) while ignoring the last update time for this field. +// Furthermore, the last update time for the specified inventory fields +// will be overwritten to the time of the ProductService.CreateProduct +// or ProductService.UpdateProduct request. If no inventory fields are +// set in CreateProductRequest.product, then any pre-existing inventory +// information for this product will be used. If no inventory fields are +// set in SetInventoryRequest.set_mask, then any existing inventory +// information will be preserved. Pre-existing inventory information can +// only be updated with ProductService.SetInventory, +// ProductService.AddFulfillmentPlaces, and +// ProductService.RemoveFulfillmentPlaces. This feature is only +// available for users who have Retail Search enabled. Please enable +// Retail Search on Cloud Console before using this feature. // // - name: Immutable. Full resource name of the product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -11391,7 +11403,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall) Do(opts ...g } return ret, nil // { - // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, ProductService.AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.setInventory", diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index f34cc34c838..3d7cda40131 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -138,7 +138,7 @@ "type": "string" }, "languageCodes": { - "description": "The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", + "description": "Note that this field applies for `user-data` dataset only. For requests with `cloud-retail` dataset, setting this field has no effect. The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", "location": "query", "repeated": true, "type": "string" @@ -533,7 +533,7 @@ "products": { "methods": { "addFulfillmentPlaces": { - "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -561,7 +561,7 @@ ] }, "addLocalInventories": { - "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", @@ -786,7 +786,7 @@ ] }, "removeFulfillmentPlaces": { - "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -814,7 +814,7 @@ ] }, "removeLocalInventories": { - "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", @@ -842,7 +842,7 @@ ] }, "setInventory": { - "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, ProductService.AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.setInventory", @@ -1770,7 +1770,7 @@ } } }, - "revision": "20220623", + "revision": "20220630", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2084,37 +2084,37 @@ "type": "object" }, "GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata": { - "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the RemoveFulfillmentPlaces method.", + "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2RemoveFulfillmentPlacesResponse": { - "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the RemoveFulfillmentPlaces method.", + "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2RemoveFulfillmentPlacesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2RemoveLocalInventoriesMetadata": { - "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2RemoveLocalInventoriesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2RemoveLocalInventoriesResponse": { - "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "description": "Response of the ProductService.RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2RemoveLocalInventoriesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2SetInventoryMetadata": { - "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", + "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2SetInventoryMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2SetInventoryResponse": { - "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the SetInventory method.", + "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2SetInventoryResponse", "properties": {}, "type": "object" @@ -2407,37 +2407,37 @@ "type": "object" }, "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata": { - "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the RemoveFulfillmentPlaces method.", + "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse": { - "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the RemoveFulfillmentPlaces method.", + "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata": { - "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse": { - "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "description": "Response of the ProductService.RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaSetInventoryMetadata": { - "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", + "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2alphaSetInventoryMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2alphaSetInventoryResponse": { - "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the SetInventory method.", + "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2alphaSetInventoryResponse", "properties": {}, "type": "object" @@ -2836,7 +2836,7 @@ "properties": { "allowlistInputConfig": { "$ref": "GoogleCloudRetailV2betaCompletionDataInputConfig", - "description": "Output only. The input config for the import of the source data that contains the autocomplete allowlist phrases uploaded by the customer.", + "description": "Output only. The source data for the latest import of the autocomplete allowlist phrases.", "readOnly": true }, "autoLearning": { @@ -2845,7 +2845,7 @@ }, "denylistInputConfig": { "$ref": "GoogleCloudRetailV2betaCompletionDataInputConfig", - "description": "Output only. The input config for the import of the source data that contains the / autocomplete denylist phrases uploaded by the customer.", + "description": "Output only. The source data for the latest import of the autocomplete denylist phrases.", "readOnly": true }, "lastAllowlistImportOperation": { @@ -2883,7 +2883,7 @@ }, "suggestionsInputConfig": { "$ref": "GoogleCloudRetailV2betaCompletionDataInputConfig", - "description": "Output only. The input config for the import of the source data that contains the autocomplete phrases uploaded by the customer.", + "description": "Output only. The source data for the latest import of the autocomplete suggestion phrases.", "readOnly": true } }, @@ -4118,13 +4118,13 @@ "type": "object" }, "GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata": { - "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the RemoveFulfillmentPlaces method.", + "description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaRemoveFulfillmentPlacesRequest": { - "description": "Request message for RemoveFulfillmentPlaces method.", + "description": "Request message for ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2betaRemoveFulfillmentPlacesRequest", "properties": { "allowMissing": { @@ -4151,19 +4151,19 @@ "type": "object" }, "GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse": { - "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the RemoveFulfillmentPlaces method.", + "description": "Response of the RemoveFulfillmentPlacesRequest. Currently empty because there is no meaningful response populated from the ProductService.RemoveFulfillmentPlaces method.", "id": "GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata": { - "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaRemoveLocalInventoriesRequest": { - "description": "Request message for RemoveLocalInventories method.", + "description": "Request message for ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesRequest", "properties": { "allowMissing": { @@ -4186,7 +4186,7 @@ "type": "object" }, "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse": { - "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "description": "Response of the ProductService.RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the ProductService.RemoveLocalInventories method.", "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse", "properties": {}, "type": "object" @@ -4614,7 +4614,7 @@ "type": "string" }, "orderBy": { - "description": "The order in which Facet.values are returned. Allowed values are: * \"count desc\", which means order by Facet.FacetValue.count descending. * \"value desc\", which means order by Facet.FacetValue.value descending. Only applies to textual facets. If not set, textual values are sorted in [natural order](https://en.wikipedia.org/wiki/Natural_sort_order); numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.", + "description": "The order in which SearchResponse.Facet.values are returned. Allowed values are: * \"count desc\", which means order by SearchResponse.Facet.values.count descending. * \"value desc\", which means order by SearchResponse.Facet.values.value descending. Only applies to textual facets. If not set, textual values are sorted in [natural order](https://en.wikipedia.org/wiki/Natural_sort_order); numerical intervals are sorted in the order given by FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in the order given by FacetSpec.FacetKey.restricted_values.", "type": "string" }, "prefixes": { @@ -4625,7 +4625,7 @@ "type": "array" }, "query": { - "description": "The query that is used to compute facet for the given facet key. When provided, it will override the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, FacetValue.value will be always \"1\" and FacetValue.count will be the number of results that matches the query. For example, you can set a customized facet for \"shipToStore\", where FacetKey.key is \"customizedShipToStore\", and FacetKey.query is \"availability: ANY(\\\"IN_STOCK\\\") AND shipToStore: ANY(\\\"123\\\")\". Then the facet will count the products that are both in stock and ship to store \"123\".", + "description": "The query that is used to compute facet for the given facet key. When provided, it will override the default behavior of facet computation. The query syntax is the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Notice that there is no limitation on FacetKey.key when query is specified. In the response, SearchResponse.Facet.values.value will be always \"1\" and SearchResponse.Facet.values.count will be the number of results that match the query. For example, you can set a customized facet for \"shipToStore\", where FacetKey.key is \"customizedShipToStore\", and FacetKey.query is \"availability: ANY(\\\"IN_STOCK\\\") AND shipToStore: ANY(\\\"123\\\")\". Then the facet will count the products that are both in stock and ship to store \"123\".", "type": "string" }, "restrictedValues": { @@ -4993,13 +4993,13 @@ "type": "object" }, "GoogleCloudRetailV2betaSetInventoryMetadata": { - "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", + "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2betaSetInventoryMetadata", "properties": {}, "type": "object" }, "GoogleCloudRetailV2betaSetInventoryRequest": { - "description": "Request message for SetInventory method.", + "description": "Request message for ProductService.SetInventory method.", "id": "GoogleCloudRetailV2betaSetInventoryRequest", "properties": { "allowMissing": { @@ -5008,7 +5008,7 @@ }, "inventory": { "$ref": "GoogleCloudRetailV2betaProduct", - "description": "Required. The inventory information to update. The allowable fields to update are: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info The updated inventory fields must be specified in SetInventoryRequest.set_mask. If SetInventoryRequest.inventory.name is empty or invalid, an INVALID_ARGUMENT error is returned. If the caller does not have permission to update the Product named in Product.name, regardless of whether or not it exists, a PERMISSION_DENIED error is returned. If the Product to update does not have existing inventory information, the provided inventory information will be inserted. If the Product to update has existing inventory information, the provided inventory information will be merged while respecting the last update time for each inventory field, using the provided or default value for SetInventoryRequest.set_time. The caller can replace place IDs for a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types and corresponding place IDs to update in SetInventoryRequest.inventory.fulfillment_info The caller can clear all place IDs from a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types to clear in SetInventoryRequest.inventory.fulfillment_info * Checks that only the desired fulfillment info types have empty SetInventoryRequest.inventory.fulfillment_info.place_ids The last update time is recorded for the following inventory fields: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info If a full overwrite of inventory information while ignoring timestamps is needed, UpdateProduct should be invoked instead." + "description": "Required. The inventory information to update. The allowable fields to update are: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info The updated inventory fields must be specified in SetInventoryRequest.set_mask. If SetInventoryRequest.inventory.name is empty or invalid, an INVALID_ARGUMENT error is returned. If the caller does not have permission to update the Product named in Product.name, regardless of whether or not it exists, a PERMISSION_DENIED error is returned. If the Product to update does not have existing inventory information, the provided inventory information will be inserted. If the Product to update has existing inventory information, the provided inventory information will be merged while respecting the last update time for each inventory field, using the provided or default value for SetInventoryRequest.set_time. The caller can replace place IDs for a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types and corresponding place IDs to update in SetInventoryRequest.inventory.fulfillment_info The caller can clear all place IDs from a subset of fulfillment types in the following ways: * Adds \"fulfillment_info\" in SetInventoryRequest.set_mask * Specifies only the desired fulfillment types to clear in SetInventoryRequest.inventory.fulfillment_info * Checks that only the desired fulfillment info types have empty SetInventoryRequest.inventory.fulfillment_info.place_ids The last update time is recorded for the following inventory fields: * Product.price_info * Product.availability * Product.available_quantity * Product.fulfillment_info If a full overwrite of inventory information while ignoring timestamps is needed, ProductService.UpdateProduct should be invoked instead." }, "setMask": { "description": "Indicates which inventory fields in the provided Product to update. At least one field must be provided. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned and the entire update will be ignored.", @@ -5024,7 +5024,7 @@ "type": "object" }, "GoogleCloudRetailV2betaSetInventoryResponse": { - "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the SetInventory method.", + "description": "Response of the SetInventoryRequest. Currently empty because there is no meaningful response populated from the ProductService.SetInventory method.", "id": "GoogleCloudRetailV2betaSetInventoryResponse", "properties": {}, "type": "object" diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index 4a57f28a6f0..4fa1997f91d 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -906,39 +906,41 @@ func (s *GoogleCloudRetailV2RejoinUserEventsResponse) MarshalJSON() ([]byte, err // GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata: Metadata related // to the progress of the RemoveFulfillmentPlaces operation. Currently // empty because there is no meaningful metadata populated from the -// RemoveFulfillmentPlaces method. +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata struct { } // GoogleCloudRetailV2RemoveFulfillmentPlacesResponse: Response of the // RemoveFulfillmentPlacesRequest. Currently empty because there is no -// meaningful response populated from the RemoveFulfillmentPlaces -// method. +// meaningful response populated from the +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2RemoveFulfillmentPlacesResponse struct { } // GoogleCloudRetailV2RemoveLocalInventoriesMetadata: Metadata related // to the progress of the RemoveLocalInventories operation. Currently // empty because there is no meaningful metadata populated from the -// RemoveLocalInventories method. +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2RemoveLocalInventoriesMetadata struct { } // GoogleCloudRetailV2RemoveLocalInventoriesResponse: Response of the -// RemoveLocalInventories API. Currently empty because there is no -// meaningful response populated from the RemoveLocalInventories method. +// ProductService.RemoveLocalInventories API. Currently empty because +// there is no meaningful response populated from the +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2RemoveLocalInventoriesResponse struct { } // GoogleCloudRetailV2SetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there -// is no meaningful metadata populated from the SetInventory method. +// is no meaningful metadata populated from the +// ProductService.SetInventory method. type GoogleCloudRetailV2SetInventoryMetadata struct { } // GoogleCloudRetailV2SetInventoryResponse: Response of the // SetInventoryRequest. Currently empty because there is no meaningful -// response populated from the SetInventory method. +// response populated from the ProductService.SetInventory method. type GoogleCloudRetailV2SetInventoryResponse struct { } @@ -1494,39 +1496,41 @@ func (s *GoogleCloudRetailV2alphaRejoinUserEventsResponse) MarshalJSON() ([]byte // GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata: Metadata // related to the progress of the RemoveFulfillmentPlaces operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveFulfillmentPlaces method. +// from the ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2alphaRemoveFulfillmentPlacesMetadata struct { } // GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse: Response of // the RemoveFulfillmentPlacesRequest. Currently empty because there is -// no meaningful response populated from the RemoveFulfillmentPlaces -// method. +// no meaningful response populated from the +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2alphaRemoveFulfillmentPlacesResponse struct { } // GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata: Metadata // related to the progress of the RemoveLocalInventories operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveLocalInventories method. +// from the ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2alphaRemoveLocalInventoriesMetadata struct { } // GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse: Response of -// the RemoveLocalInventories API. Currently empty because there is no -// meaningful response populated from the RemoveLocalInventories method. +// the ProductService.RemoveLocalInventories API. Currently empty +// because there is no meaningful response populated from the +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2alphaRemoveLocalInventoriesResponse struct { } // GoogleCloudRetailV2alphaSetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there -// is no meaningful metadata populated from the SetInventory method. +// is no meaningful metadata populated from the +// ProductService.SetInventory method. type GoogleCloudRetailV2alphaSetInventoryMetadata struct { } // GoogleCloudRetailV2alphaSetInventoryResponse: Response of the // SetInventoryRequest. Currently empty because there is no meaningful -// response populated from the SetInventory method. +// response populated from the ProductService.SetInventory method. type GoogleCloudRetailV2alphaSetInventoryResponse struct { } @@ -2279,9 +2283,8 @@ func (s *GoogleCloudRetailV2betaCompleteQueryResponseRecentSearchResult) Marshal // GoogleCloudRetailV2betaCompletionConfig: Catalog level autocomplete // config for customers to customize autocomplete feature's settings. type GoogleCloudRetailV2betaCompletionConfig struct { - // AllowlistInputConfig: Output only. The input config for the import of - // the source data that contains the autocomplete allowlist phrases - // uploaded by the customer. + // AllowlistInputConfig: Output only. The source data for the latest + // import of the autocomplete allowlist phrases. AllowlistInputConfig *GoogleCloudRetailV2betaCompletionDataInputConfig `json:"allowlistInputConfig,omitempty"` // AutoLearning: If set to true, the auto learning function is enabled. @@ -2290,9 +2293,8 @@ type GoogleCloudRetailV2betaCompletionConfig struct { // can users use `cloud-retail` data in CompleteQueryRequest. AutoLearning bool `json:"autoLearning,omitempty"` - // DenylistInputConfig: Output only. The input config for the import of - // the source data that contains the / autocomplete denylist phrases - // uploaded by the customer. + // DenylistInputConfig: Output only. The source data for the latest + // import of the autocomplete denylist phrases. DenylistInputConfig *GoogleCloudRetailV2betaCompletionDataInputConfig `json:"denylistInputConfig,omitempty"` // LastAllowlistImportOperation: Output only. Name of the LRO @@ -2334,9 +2336,8 @@ type GoogleCloudRetailV2betaCompletionConfig struct { // `projects/*/locations/*/catalogs/*/completionConfig` Name string `json:"name,omitempty"` - // SuggestionsInputConfig: Output only. The input config for the import - // of the source data that contains the autocomplete phrases uploaded by - // the customer. + // SuggestionsInputConfig: Output only. The source data for the latest + // import of the autocomplete suggestion phrases. SuggestionsInputConfig *GoogleCloudRetailV2betaCompletionDataInputConfig `json:"suggestionsInputConfig,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4918,12 +4919,12 @@ func (s *GoogleCloudRetailV2betaRemoveControlRequest) MarshalJSON() ([]byte, err // GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata: Metadata // related to the progress of the RemoveFulfillmentPlaces operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveFulfillmentPlaces method. +// from the ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata struct { } // GoogleCloudRetailV2betaRemoveFulfillmentPlacesRequest: Request -// message for RemoveFulfillmentPlaces method. +// message for ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2betaRemoveFulfillmentPlacesRequest struct { // AllowMissing: If set to true, and the Product is not found, the // fulfillment information will still be processed and retained for at @@ -4980,20 +4981,20 @@ func (s *GoogleCloudRetailV2betaRemoveFulfillmentPlacesRequest) MarshalJSON() ([ // GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse: Response of // the RemoveFulfillmentPlacesRequest. Currently empty because there is -// no meaningful response populated from the RemoveFulfillmentPlaces -// method. +// no meaningful response populated from the +// ProductService.RemoveFulfillmentPlaces method. type GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse struct { } // GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata: Metadata // related to the progress of the RemoveLocalInventories operation. // Currently empty because there is no meaningful metadata populated -// from the RemoveLocalInventories method. +// from the ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata struct { } // GoogleCloudRetailV2betaRemoveLocalInventoriesRequest: Request message -// for RemoveLocalInventories method. +// for ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2betaRemoveLocalInventoriesRequest struct { // AllowMissing: If set to true, and the Product is not found, the local // inventory removal request will still be processed and retained for at @@ -5034,8 +5035,9 @@ func (s *GoogleCloudRetailV2betaRemoveLocalInventoriesRequest) MarshalJSON() ([] } // GoogleCloudRetailV2betaRemoveLocalInventoriesResponse: Response of -// the RemoveLocalInventories API. Currently empty because there is no -// meaningful response populated from the RemoveLocalInventories method. +// the ProductService.RemoveLocalInventories API. Currently empty +// because there is no meaningful response populated from the +// ProductService.RemoveLocalInventories method. type GoogleCloudRetailV2betaRemoveLocalInventoriesResponse struct { } @@ -5914,13 +5916,13 @@ type GoogleCloudRetailV2betaSearchRequestFacetSpecFacetKey struct { // "inventory(place_id,attributes.key)" Key string `json:"key,omitempty"` - // OrderBy: The order in which Facet.values are returned. Allowed values - // are: * "count desc", which means order by Facet.FacetValue.count - // descending. * "value desc", which means order by - // Facet.FacetValue.value descending. Only applies to textual facets. If - // not set, textual values are sorted in natural order - // (https://en.wikipedia.org/wiki/Natural_sort_order); numerical - // intervals are sorted in the order given by + // OrderBy: The order in which SearchResponse.Facet.values are returned. + // Allowed values are: * "count desc", which means order by + // SearchResponse.Facet.values.count descending. * "value desc", which + // means order by SearchResponse.Facet.values.value descending. Only + // applies to textual facets. If not set, textual values are sorted in + // natural order (https://en.wikipedia.org/wiki/Natural_sort_order); + // numerical intervals are sorted in the order given by // FacetSpec.FacetKey.intervals; FulfillmentInfo.place_ids are sorted in // the order given by FacetSpec.FacetKey.restricted_values. OrderBy string `json:"orderBy,omitempty"` @@ -5937,13 +5939,13 @@ type GoogleCloudRetailV2betaSearchRequestFacetSpecFacetKey struct { // computation. The query syntax is the same as a filter expression. See // SearchRequest.filter for detail syntax and limitations. Notice that // there is no limitation on FacetKey.key when query is specified. In - // the response, FacetValue.value will be always "1" and - // FacetValue.count will be the number of results that matches the - // query. For example, you can set a customized facet for "shipToStore", - // where FacetKey.key is "customizedShipToStore", and FacetKey.query is - // "availability: ANY(\"IN_STOCK\") AND shipToStore: ANY(\"123\")". Then - // the facet will count the products that are both in stock and ship to - // store "123". + // the response, SearchResponse.Facet.values.value will be always "1" + // and SearchResponse.Facet.values.count will be the number of results + // that match the query. For example, you can set a customized facet for + // "shipToStore", where FacetKey.key is "customizedShipToStore", and + // FacetKey.query is "availability: ANY(\"IN_STOCK\") AND shipToStore: + // ANY(\"123\")". Then the facet will count the products that are both + // in stock and ship to store "123". Query string `json:"query,omitempty"` // RestrictedValues: Only get facet for the given restricted values. For @@ -6562,12 +6564,13 @@ func (s *GoogleCloudRetailV2betaSetDefaultBranchRequest) MarshalJSON() ([]byte, // GoogleCloudRetailV2betaSetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there -// is no meaningful metadata populated from the SetInventory method. +// is no meaningful metadata populated from the +// ProductService.SetInventory method. type GoogleCloudRetailV2betaSetInventoryMetadata struct { } // GoogleCloudRetailV2betaSetInventoryRequest: Request message for -// SetInventory method. +// ProductService.SetInventory method. type GoogleCloudRetailV2betaSetInventoryRequest struct { // AllowMissing: If set to true, and the Product with name Product.name // is not found, the inventory update will still be processed and @@ -6604,7 +6607,7 @@ type GoogleCloudRetailV2betaSetInventoryRequest struct { // Product.price_info * Product.availability * // Product.available_quantity * Product.fulfillment_info If a full // overwrite of inventory information while ignoring timestamps is - // needed, UpdateProduct should be invoked instead. + // needed, ProductService.UpdateProduct should be invoked instead. Inventory *GoogleCloudRetailV2betaProduct `json:"inventory,omitempty"` // SetMask: Indicates which inventory fields in the provided Product to @@ -6643,7 +6646,7 @@ func (s *GoogleCloudRetailV2betaSetInventoryRequest) MarshalJSON() ([]byte, erro // GoogleCloudRetailV2betaSetInventoryResponse: Response of the // SetInventoryRequest. Currently empty because there is no meaningful -// response populated from the SetInventory method. +// response populated from the ProductService.SetInventory method. type GoogleCloudRetailV2betaSetInventoryResponse struct { } @@ -7265,7 +7268,9 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) DeviceType(deviceType strin return c } -// LanguageCodes sets the optional parameter "languageCodes": The +// LanguageCodes sets the optional parameter "languageCodes": Note that +// this field applies for `user-data` dataset only. For requests with +// `cloud-retail` dataset, setting this field has no effect. The // language filters applied to the output suggestions. If set, it should // contain the language of the query. If not set, suggestions are // returned without considering language restrictions. This is the @@ -7435,7 +7440,7 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Do(opts ...googleapi.CallOp // "type": "string" // }, // "languageCodes": { - // "description": "The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", + // "description": "Note that this field applies for `user-data` dataset only. For requests with `cloud-retail` dataset, setting this field has no effect. The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.", // "location": "query", // "repeated": true, // "type": "string" @@ -9374,9 +9379,10 @@ type ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall struct { // information. If the request is valid, the update will be enqueued and // processed downstream. As a consequence, when a response is returned, // the added place IDs are not immediately manifested in the Product -// queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please enable Retail Search -// on Cloud Console before using this feature. +// queried by ProductService.GetProduct or ProductService.ListProducts. +// This feature is only available for users who have Retail Search +// enabled. Please enable Retail Search on Cloud Console before using +// this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -9481,7 +9487,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o } return ret, nil // { - // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -9529,8 +9535,9 @@ type ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall struct { // information. If the request is valid, the update will be enqueued and // processed downstream. As a consequence, when a response is returned, // updates are not immediately manifested in the Product queried by -// GetProduct or ListProducts. Local inventory information can only be -// modified using this method. CreateProduct and UpdateProduct has no +// ProductService.GetProduct or ProductService.ListProducts. Local +// inventory information can only be modified using this method. +// ProductService.CreateProduct and ProductService.UpdateProduct has no // effect on local inventories. This feature is only available for users // who have Retail Search enabled. Please enable Retail Search on Cloud // Console before using this feature. @@ -9638,7 +9645,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Do(op } return ret, nil // { - // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", @@ -10710,9 +10717,10 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct // information. If the request is valid, the update will be enqueued and // processed downstream. As a consequence, when a response is returned, // the removed place IDs are not immediately manifested in the Product -// queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please enable Retail Search -// on Cloud Console before using this feature. +// queried by ProductService.GetProduct or ProductService.ListProducts. +// This feature is only available for users who have Retail Search +// enabled. Please enable Retail Search on Cloud Console before using +// this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -10817,7 +10825,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D } return ret, nil // { - // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -10863,11 +10871,12 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall struct // asynchronous. If the request is valid, the removal will be enqueued // and processed downstream. As a consequence, when a response is // returned, removals are not immediately manifested in the Product -// queried by GetProduct or ListProducts. Local inventory information -// can only be removed using this method. CreateProduct and -// UpdateProduct has no effect on local inventories. This feature is -// only available for users who have Retail Search enabled. Please -// enable Retail Search on Cloud Console before using this feature. +// queried by ProductService.GetProduct or ProductService.ListProducts. +// Local inventory information can only be removed using this method. +// ProductService.CreateProduct and ProductService.UpdateProduct has no +// effect on local inventories. This feature is only available for users +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -10972,7 +10981,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Do } return ret, nil // { - // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", @@ -11019,21 +11028,23 @@ type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct { // before updating fulfillment information. If the request is valid, the // update will be enqueued and processed downstream. As a consequence, // when a response is returned, updates are not immediately manifested -// in the Product queried by GetProduct or ListProducts. When inventory -// is updated with CreateProduct and UpdateProduct, the specified -// inventory field value(s) will overwrite any existing value(s) while -// ignoring the last update time for this field. Furthermore, the last -// update time for the specified inventory fields will be overwritten to -// the time of the CreateProduct or UpdateProduct request. If no -// inventory fields are set in CreateProductRequest.product, then any -// pre-existing inventory information for this product will be used. If -// no inventory fields are set in SetInventoryRequest.set_mask, then any -// existing inventory information will be preserved. Pre-existing -// inventory information can only be updated with SetInventory, -// ProductService.AddFulfillmentPlaces, and RemoveFulfillmentPlaces. -// This feature is only available for users who have Retail Search -// enabled. Please enable Retail Search on Cloud Console before using -// this feature. +// in the Product queried by ProductService.GetProduct or +// ProductService.ListProducts. When inventory is updated with +// ProductService.CreateProduct and ProductService.UpdateProduct, the +// specified inventory field value(s) will overwrite any existing +// value(s) while ignoring the last update time for this field. +// Furthermore, the last update time for the specified inventory fields +// will be overwritten to the time of the ProductService.CreateProduct +// or ProductService.UpdateProduct request. If no inventory fields are +// set in CreateProductRequest.product, then any pre-existing inventory +// information for this product will be used. If no inventory fields are +// set in SetInventoryRequest.set_mask, then any existing inventory +// information will be preserved. Pre-existing inventory information can +// only be updated with ProductService.SetInventory, +// ProductService.AddFulfillmentPlaces, and +// ProductService.RemoveFulfillmentPlaces. This feature is only +// available for users who have Retail Search enabled. Please enable +// Retail Search on Cloud Console before using this feature. // // - name: Immutable. Full resource name of the product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -11136,7 +11147,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall) Do(opts ...g } return ret, nil // { - // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, ProductService.AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.setInventory",