From df0b7304e8e684ce8d908c6e4c4119f2833fcbd8 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 11 Oct 2023 00:22:13 -0700 Subject: [PATCH] feat(all): auto-regenerate discovery clients (#2211) --- aiplatform/v1/aiplatform-api.json | 29 +- aiplatform/v1/aiplatform-gen.go | 63 +--- aiplatform/v1beta1/aiplatform-api.json | 33 +- aiplatform/v1beta1/aiplatform-gen.go | 70 +--- androidpublisher/v3/androidpublisher-api.json | 17 +- androidpublisher/v3/androidpublisher-gen.go | 6 +- cloudasset/v1/cloudasset-api.json | 4 +- cloudasset/v1/cloudasset-gen.go | 37 +- contentwarehouse/v1/contentwarehouse-api.json | 180 ++++++++-- contentwarehouse/v1/contentwarehouse-gen.go | 177 +++++++-- dataplex/v1/dataplex-api.json | 76 +++- dataplex/v1/dataplex-gen.go | 91 +++++ .../v1alpha/discoveryengine-api.json | 67 +++- .../v1alpha/discoveryengine-gen.go | 336 ++++++++++++++++++ .../v1beta/discoveryengine-api.json | 62 +++- discoveryengine/v1beta/discoveryengine-gen.go | 330 +++++++++++++++++ displayvideo/v1/displayvideo-api.json | 73 ++-- displayvideo/v1/displayvideo-gen.go | 126 +++---- displayvideo/v2/displayvideo-api.json | 91 +++-- displayvideo/v2/displayvideo-gen.go | 153 ++++---- displayvideo/v3/displayvideo-api.json | 154 ++++---- displayvideo/v3/displayvideo-gen.go | 266 +++++++------- 22 files changed, 1730 insertions(+), 711 deletions(-) diff --git a/aiplatform/v1/aiplatform-api.json b/aiplatform/v1/aiplatform-api.json index a43b15e99ae..11e1656e555 100644 --- a/aiplatform/v1/aiplatform-api.json +++ b/aiplatform/v1/aiplatform-api.json @@ -12997,7 +12997,7 @@ } } }, - "revision": "20230929", + "revision": "20231002", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -16466,10 +16466,6 @@ "description": "An expression for filtering what part of the Dataset is to be exported. Only Annotations that match this filter will be exported. The filter syntax is the same as in ListAnnotations.", "type": "string" }, - "filterSplit": { - "$ref": "GoogleCloudAiplatformV1ExportFilterSplit", - "description": "Split based on the provided filters for each set." - }, "fractionSplit": { "$ref": "GoogleCloudAiplatformV1ExportFractionSplit", "description": "Split based on fractions defining the size of each set." @@ -16602,25 +16598,6 @@ "properties": {}, "type": "object" }, - "GoogleCloudAiplatformV1ExportFilterSplit": { - "description": "Assigns input data to training, validation, and test sets based on the given filters, data pieces not matched by any filter are ignored. Currently only supported for Datasets containing DataItems. If any of the filters in this message are to match nothing, then they can be set as '-' (the minus sign). Supported only for unstructured Datasets.", - "id": "GoogleCloudAiplatformV1ExportFilterSplit", - "properties": { - "testFilter": { - "description": "Required. A filter on DataItems of the Dataset. DataItems that match this filter are used to test the Model. A filter with same syntax as the one used in DatasetService.ListDataItems may be used. If a single DataItem is matched by more than one of the FilterSplit filters, then it is assigned to the first set that applies to it in the training, validation, test order.", - "type": "string" - }, - "trainingFilter": { - "description": "Required. A filter on DataItems of the Dataset. DataItems that match this filter are used to train the Model. A filter with same syntax as the one used in DatasetService.ListDataItems may be used. If a single DataItem is matched by more than one of the FilterSplit filters, then it is assigned to the first set that applies to it in the training, validation, test order.", - "type": "string" - }, - "validationFilter": { - "description": "Required. A filter on DataItems of the Dataset. DataItems that match this filter are used to validate the Model. A filter with same syntax as the one used in DatasetService.ListDataItems may be used. If a single DataItem is matched by more than one of the FilterSplit filters, then it is assigned to the first set that applies to it in the training, validation, test order.", - "type": "string" - } - }, - "type": "object" - }, "GoogleCloudAiplatformV1ExportFractionSplit": { "description": "Assigns the input data to training, validation, and test sets as per the given fractions. Any of `training_fraction`, `validation_fraction` and `test_fraction` may optionally be provided, they must sum to up to 1. If the provided ones sum to less than 1, the remainder is assigned to sets as decided by Vertex AI. If none of the fractions are set, by default roughly 80% of data is used for training, 10% for validation, and 10% for test.", "id": "GoogleCloudAiplatformV1ExportFractionSplit", @@ -18934,6 +18911,10 @@ "machineType": { "description": "Immutable. The type of the machine. See the [list of machine types supported for prediction](https://cloud.google.com/vertex-ai/docs/predictions/configure-compute#machine-types) See the [list of machine types supported for custom training](https://cloud.google.com/vertex-ai/docs/training/configure-compute#machine-types). For DeployedModel this field is optional, and the default value is `n1-standard-2`. For BatchPredictionJob or as part of WorkerPoolSpec this field is required.", "type": "string" + }, + "tpuTopology": { + "description": "Immutable. The topology of the TPUs. Corresponds to the TPU topologies available from GKE. (Example: tpu_topology: \"2x2x1\").", + "type": "string" } }, "type": "object" diff --git a/aiplatform/v1/aiplatform-gen.go b/aiplatform/v1/aiplatform-gen.go index 78e0f6fecb5..d2b1107cbb0 100644 --- a/aiplatform/v1/aiplatform-gen.go +++ b/aiplatform/v1/aiplatform-gen.go @@ -7561,9 +7561,6 @@ type GoogleCloudAiplatformV1ExportDataConfig struct { // ListAnnotations. AnnotationsFilter string `json:"annotationsFilter,omitempty"` - // FilterSplit: Split based on the provided filters for each set. - FilterSplit *GoogleCloudAiplatformV1ExportFilterSplit `json:"filterSplit,omitempty"` - // FractionSplit: Split based on fractions defining the size of each // set. FractionSplit *GoogleCloudAiplatformV1ExportFractionSplit `json:"fractionSplit,omitempty"` @@ -7851,62 +7848,6 @@ func (s *GoogleCloudAiplatformV1ExportFeatureValuesRequestSnapshotExport) Marsha type GoogleCloudAiplatformV1ExportFeatureValuesResponse struct { } -// GoogleCloudAiplatformV1ExportFilterSplit: Assigns input data to -// training, validation, and test sets based on the given filters, data -// pieces not matched by any filter are ignored. Currently only -// supported for Datasets containing DataItems. If any of the filters in -// this message are to match nothing, then they can be set as '-' (the -// minus sign). Supported only for unstructured Datasets. -type GoogleCloudAiplatformV1ExportFilterSplit struct { - // TestFilter: Required. A filter on DataItems of the Dataset. DataItems - // that match this filter are used to test the Model. A filter with same - // syntax as the one used in DatasetService.ListDataItems may be used. - // If a single DataItem is matched by more than one of the FilterSplit - // filters, then it is assigned to the first set that applies to it in - // the training, validation, test order. - TestFilter string `json:"testFilter,omitempty"` - - // TrainingFilter: Required. A filter on DataItems of the Dataset. - // DataItems that match this filter are used to train the Model. A - // filter with same syntax as the one used in - // DatasetService.ListDataItems may be used. If a single DataItem is - // matched by more than one of the FilterSplit filters, then it is - // assigned to the first set that applies to it in the training, - // validation, test order. - TrainingFilter string `json:"trainingFilter,omitempty"` - - // ValidationFilter: Required. A filter on DataItems of the Dataset. - // DataItems that match this filter are used to validate the Model. A - // filter with same syntax as the one used in - // DatasetService.ListDataItems may be used. If a single DataItem is - // matched by more than one of the FilterSplit filters, then it is - // assigned to the first set that applies to it in the training, - // validation, test order. - ValidationFilter string `json:"validationFilter,omitempty"` - - // ForceSendFields is a list of field names (e.g. "TestFilter") 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. "TestFilter") 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 *GoogleCloudAiplatformV1ExportFilterSplit) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudAiplatformV1ExportFilterSplit - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudAiplatformV1ExportFractionSplit: Assigns the input data to // training, validation, and test sets as per the given fractions. Any // of `training_fraction`, `validation_fraction` and `test_fraction` may @@ -12373,6 +12314,10 @@ type GoogleCloudAiplatformV1MachineSpec struct { // this field is required. MachineType string `json:"machineType,omitempty"` + // TpuTopology: Immutable. The topology of the TPUs. Corresponds to the + // TPU topologies available from GKE. (Example: tpu_topology: "2x2x1"). + TpuTopology string `json:"tpuTopology,omitempty"` + // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/aiplatform/v1beta1/aiplatform-api.json b/aiplatform/v1beta1/aiplatform-api.json index c1457f8e35e..181c0e84e60 100644 --- a/aiplatform/v1beta1/aiplatform-api.json +++ b/aiplatform/v1beta1/aiplatform-api.json @@ -16092,7 +16092,7 @@ } } }, - "revision": "20230929", + "revision": "20231002", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -19770,10 +19770,6 @@ "description": "An expression for filtering what part of the Dataset is to be exported. Only Annotations that match this filter will be exported. The filter syntax is the same as in ListAnnotations.", "type": "string" }, - "filterSplit": { - "$ref": "GoogleCloudAiplatformV1beta1ExportFilterSplit", - "description": "Split based on the provided filters for each set." - }, "fractionSplit": { "$ref": "GoogleCloudAiplatformV1beta1ExportFractionSplit", "description": "Split based on fractions defining the size of each set." @@ -19939,25 +19935,6 @@ "properties": {}, "type": "object" }, - "GoogleCloudAiplatformV1beta1ExportFilterSplit": { - "description": "Assigns input data to training, validation, and test sets based on the given filters, data pieces not matched by any filter are ignored. Currently only supported for Datasets containing DataItems. If any of the filters in this message are to match nothing, then they can be set as '-' (the minus sign). Supported only for unstructured Datasets.", - "id": "GoogleCloudAiplatformV1beta1ExportFilterSplit", - "properties": { - "testFilter": { - "description": "Required. A filter on DataItems of the Dataset. DataItems that match this filter are used to test the Model. A filter with same syntax as the one used in DatasetService.ListDataItems may be used. If a single DataItem is matched by more than one of the FilterSplit filters, then it is assigned to the first set that applies to it in the training, validation, test order.", - "type": "string" - }, - "trainingFilter": { - "description": "Required. A filter on DataItems of the Dataset. DataItems that match this filter are used to train the Model. A filter with same syntax as the one used in DatasetService.ListDataItems may be used. If a single DataItem is matched by more than one of the FilterSplit filters, then it is assigned to the first set that applies to it in the training, validation, test order.", - "type": "string" - }, - "validationFilter": { - "description": "Required. A filter on DataItems of the Dataset. DataItems that match this filter are used to validate the Model. A filter with same syntax as the one used in DatasetService.ListDataItems may be used. If a single DataItem is matched by more than one of the FilterSplit filters, then it is assigned to the first set that applies to it in the training, validation, test order.", - "type": "string" - } - }, - "type": "object" - }, "GoogleCloudAiplatformV1beta1ExportFractionSplit": { "description": "Assigns the input data to training, validation, and test sets as per the given fractions. Any of `training_fraction`, `validation_fraction` and `test_fraction` may optionally be provided, they must sum to up to 1. If the provided ones sum to less than 1, the remainder is assigned to sets as decided by Vertex AI. If none of the fractions are set, by default roughly 80% of data is used for training, 10% for validation, and 10% for test.", "id": "GoogleCloudAiplatformV1beta1ExportFractionSplit", @@ -20188,7 +20165,7 @@ "properties": { "bigQuery": { "$ref": "GoogleCloudAiplatformV1beta1FeatureGroupBigQuery", - "description": "Indicates that features for this group come from BigQuery." + "description": "Indicates that features for this group come from BigQuery Table/View. By default treats the source as a sparse time series source, which is required to have an entity_id and a feature_timestamp column in the source." }, "createTime": { "description": "Output only. Timestamp when this FeatureGroup was created.", @@ -20624,7 +20601,7 @@ "type": "array" }, "uri": { - "description": "Required. The Bigquery View URI that will be materialized on each sync trigger based on FeatureView.SyncConfig.", + "description": "Required. The BigQuery view URI that will be materialized on each sync trigger based on FeatureView.SyncConfig.", "type": "string" } }, @@ -22931,6 +22908,10 @@ "machineType": { "description": "Immutable. The type of the machine. See the [list of machine types supported for prediction](https://cloud.google.com/vertex-ai/docs/predictions/configure-compute#machine-types) See the [list of machine types supported for custom training](https://cloud.google.com/vertex-ai/docs/training/configure-compute#machine-types). For DeployedModel this field is optional, and the default value is `n1-standard-2`. For BatchPredictionJob or as part of WorkerPoolSpec this field is required.", "type": "string" + }, + "tpuTopology": { + "description": "Immutable. The topology of the TPUs. Corresponds to the TPU topologies available from GKE. (Example: tpu_topology: \"2x2x1\").", + "type": "string" } }, "type": "object" diff --git a/aiplatform/v1beta1/aiplatform-gen.go b/aiplatform/v1beta1/aiplatform-gen.go index 97166229a22..e8c08e9dac4 100644 --- a/aiplatform/v1beta1/aiplatform-gen.go +++ b/aiplatform/v1beta1/aiplatform-gen.go @@ -8354,9 +8354,6 @@ type GoogleCloudAiplatformV1beta1ExportDataConfig struct { // ListAnnotations. AnnotationsFilter string `json:"annotationsFilter,omitempty"` - // FilterSplit: Split based on the provided filters for each set. - FilterSplit *GoogleCloudAiplatformV1beta1ExportFilterSplit `json:"filterSplit,omitempty"` - // FractionSplit: Split based on fractions defining the size of each // set. FractionSplit *GoogleCloudAiplatformV1beta1ExportFractionSplit `json:"fractionSplit,omitempty"` @@ -8735,62 +8732,6 @@ func (s *GoogleCloudAiplatformV1beta1ExportFeatureValuesRequestSnapshotExport) M type GoogleCloudAiplatformV1beta1ExportFeatureValuesResponse struct { } -// GoogleCloudAiplatformV1beta1ExportFilterSplit: Assigns input data to -// training, validation, and test sets based on the given filters, data -// pieces not matched by any filter are ignored. Currently only -// supported for Datasets containing DataItems. If any of the filters in -// this message are to match nothing, then they can be set as '-' (the -// minus sign). Supported only for unstructured Datasets. -type GoogleCloudAiplatformV1beta1ExportFilterSplit struct { - // TestFilter: Required. A filter on DataItems of the Dataset. DataItems - // that match this filter are used to test the Model. A filter with same - // syntax as the one used in DatasetService.ListDataItems may be used. - // If a single DataItem is matched by more than one of the FilterSplit - // filters, then it is assigned to the first set that applies to it in - // the training, validation, test order. - TestFilter string `json:"testFilter,omitempty"` - - // TrainingFilter: Required. A filter on DataItems of the Dataset. - // DataItems that match this filter are used to train the Model. A - // filter with same syntax as the one used in - // DatasetService.ListDataItems may be used. If a single DataItem is - // matched by more than one of the FilterSplit filters, then it is - // assigned to the first set that applies to it in the training, - // validation, test order. - TrainingFilter string `json:"trainingFilter,omitempty"` - - // ValidationFilter: Required. A filter on DataItems of the Dataset. - // DataItems that match this filter are used to validate the Model. A - // filter with same syntax as the one used in - // DatasetService.ListDataItems may be used. If a single DataItem is - // matched by more than one of the FilterSplit filters, then it is - // assigned to the first set that applies to it in the training, - // validation, test order. - ValidationFilter string `json:"validationFilter,omitempty"` - - // ForceSendFields is a list of field names (e.g. "TestFilter") 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. "TestFilter") 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 *GoogleCloudAiplatformV1beta1ExportFilterSplit) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudAiplatformV1beta1ExportFilterSplit - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudAiplatformV1beta1ExportFractionSplit: Assigns the input // data to training, validation, and test sets as per the given // fractions. Any of `training_fraction`, `validation_fraction` and @@ -9206,7 +9147,10 @@ func (s *GoogleCloudAiplatformV1beta1Feature) MarshalJSON() ([]byte, error) { // GoogleCloudAiplatformV1beta1FeatureGroup: Vertex AI Feature Group. type GoogleCloudAiplatformV1beta1FeatureGroup struct { - // BigQuery: Indicates that features for this group come from BigQuery. + // BigQuery: Indicates that features for this group come from BigQuery + // Table/View. By default treats the source as a sparse time series + // source, which is required to have an entity_id and a + // feature_timestamp column in the source. BigQuery *GoogleCloudAiplatformV1beta1FeatureGroupBigQuery `json:"bigQuery,omitempty"` // CreateTime: Output only. Timestamp when this FeatureGroup was @@ -10041,7 +9985,7 @@ type GoogleCloudAiplatformV1beta1FeatureViewBigQuerySource struct { // Start by supporting 1 only. EntityIdColumns []string `json:"entityIdColumns,omitempty"` - // Uri: Required. The Bigquery View URI that will be materialized on + // Uri: Required. The BigQuery view URI that will be materialized on // each sync trigger based on FeatureView.SyncConfig. Uri string `json:"uri,omitempty"` @@ -14521,6 +14465,10 @@ type GoogleCloudAiplatformV1beta1MachineSpec struct { // this field is required. MachineType string `json:"machineType,omitempty"` + // TpuTopology: Immutable. The topology of the TPUs. Corresponds to the + // TPU topologies available from GKE. (Example: tpu_topology: "2x2x1"). + TpuTopology string `json:"tpuTopology,omitempty"` + // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index e71245bb40b..ff598251589 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -4047,7 +4047,7 @@ } } }, - "revision": "20231003", + "revision": "20231010", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -5413,7 +5413,8 @@ "CAN_MANAGE_ORDERS", "CAN_MANAGE_APP_CONTENT", "CAN_VIEW_NON_FINANCIAL_DATA", - "CAN_VIEW_APP_QUALITY" + "CAN_VIEW_APP_QUALITY", + "CAN_MANAGE_DEEPLINKS" ], "enumDeprecated": [ false, @@ -5429,6 +5430,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -5445,7 +5447,8 @@ "Manage orders and subscriptions.", "Manage policy related pages.", "View app information (read-only).", - "View app quality data such as Vitals, Crashes etc." + "View app quality data such as Vitals, Crashes etc.", + "Manage the deep links setup of an app." ], "type": "string" }, @@ -6854,7 +6857,7 @@ "id": "SubscriptionItemPriceChangeDetails", "properties": { "expectedNewPriceChargeTime": { - "description": "The renewal time at which the price change will become effective for the user. This is subject to change(to a future time) due to cases where the renewal time shifts like pause.", + "description": "The renewal time at which the price change will become effective for the user. This is subject to change(to a future time) due to cases where the renewal time shifts like pause. This field is only populated if the price change has not taken effect.", "format": "google-datetime", "type": "string" }, @@ -7759,7 +7762,8 @@ "CAN_MANAGE_ORDERS_GLOBAL", "CAN_MANAGE_APP_CONTENT_GLOBAL", "CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL", - "CAN_VIEW_APP_QUALITY_GLOBAL" + "CAN_VIEW_APP_QUALITY_GLOBAL", + "CAN_MANAGE_DEEPLINKS_GLOBAL" ], "enumDescriptions": [ "Unknown or unspecified permission.", @@ -7779,7 +7783,8 @@ "Manage orders and subscriptions.", "Manage policy related pages on all apps for the developer.", "View app information and download bulk reports (read-only).", - "View app quality information for all apps for the developer." + "View app quality information for all apps for the developer.", + "Manage the deep links setup for all apps for the developer." ], "type": "string" }, diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 57512d96118..246ad599e6d 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -2829,6 +2829,7 @@ type Grant struct { // "CAN_VIEW_NON_FINANCIAL_DATA" - View app information (read-only). // "CAN_VIEW_APP_QUALITY" - View app quality data such as Vitals, // Crashes etc. + // "CAN_MANAGE_DEEPLINKS" - Manage the deep links setup of an app. AppLevelPermissions []string `json:"appLevelPermissions,omitempty"` // Name: Required. Resource name for this grant, following the pattern @@ -5457,7 +5458,8 @@ type SubscriptionItemPriceChangeDetails struct { // ExpectedNewPriceChargeTime: The renewal time at which the price // change will become effective for the user. This is subject to // change(to a future time) due to cases where the renewal time shifts - // like pause. + // like pause. This field is only populated if the price change has not + // taken effect. ExpectedNewPriceChargeTime string `json:"expectedNewPriceChargeTime,omitempty"` // NewPrice: New recurring price for the subscription item. @@ -6952,6 +6954,8 @@ type User struct { // download bulk reports (read-only). // "CAN_VIEW_APP_QUALITY_GLOBAL" - View app quality information for // all apps for the developer. + // "CAN_MANAGE_DEEPLINKS_GLOBAL" - Manage the deep links setup for all + // apps for the developer. DeveloperAccountPermissions []string `json:"developerAccountPermissions,omitempty"` // Email: Immutable. The user's email address. diff --git a/cloudasset/v1/cloudasset-api.json b/cloudasset/v1/cloudasset-api.json index 9d8a4ee2ee4..5470da26e1d 100644 --- a/cloudasset/v1/cloudasset-api.json +++ b/cloudasset/v1/cloudasset-api.json @@ -1066,7 +1066,7 @@ "type": "string" }, "query": { - "description": "Optional. The query statement. See [how to construct a query](https://cloud.google.com/asset-inventory/docs/searching-resources#how_to_construct_a_query) for more information. If not specified or empty, it will search all the resources within the specified `scope`. Examples: * `name:Important` to find Google Cloud resources whose name contains `Important` as a word. * `name=Important` to find the Google Cloud resource whose name is exactly `Important`. * `displayName:Impor*` to find Google Cloud resources whose display name contains `Impor` as a prefix of any word in the field. * `location:us-west*` to find Google Cloud resources whose location contains both `us` and `west` as prefixes. * `labels:prod` to find Google Cloud resources whose labels contain `prod` as a key or value. * `labels.env:prod` to find Google Cloud resources that have a label `env` and its value is `prod`. * `labels.env:*` to find Google Cloud resources that have a label `env`. * `tagKeys:env` to find Google Cloud resources that have directly attached tags where the [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey) .`namespacedName` contains `env`. * `tagValues:prod*` to find Google Cloud resources that have directly attached tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`namespacedName` contains a word prefixed by `prod`. * `tagValueIds=tagValues/123` to find Google Cloud resources that have directly attached tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`name` is exactly `tagValues/123`. * `effectiveTagKeys:env` to find Google Cloud resources that have directly attached or inherited tags where the [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey) .`namespacedName` contains `env`. * `effectiveTagValues:prod*` to find Google Cloud resources that have directly attached or inherited tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`namespacedName` contains a word prefixed by `prod`. * `effectiveTagValueIds=tagValues/123` to find Google Cloud resources that have directly attached or inherited tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`name` is exactly `tagValues/123`. * `kmsKey:key` to find Google Cloud resources encrypted with a customer-managed encryption key whose name contains `key` as a word. This field is deprecated. Please use the `kmsKeys` field to retrieve Cloud KMS key information. * `kmsKeys:key` to find Google Cloud resources encrypted with customer-managed encryption keys whose name contains the word `key`. * `relationships:instance-group-1` to find Google Cloud resources that have relationships with `instance-group-1` in the related resource name. * `relationships:INSTANCE_TO_INSTANCEGROUP` to find Compute Engine instances that have relationships of type `INSTANCE_TO_INSTANCEGROUP`. * `relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1` to find Compute Engine instances that have relationships with `instance-group-1` in the Compute Engine instance group resource name, for relationship type `INSTANCE_TO_INSTANCEGROUP`. * `state:ACTIVE` to find Google Cloud resources whose state contains `ACTIVE` as a word. * `NOT state:ACTIVE` to find Google Cloud resources whose state doesn't contain `ACTIVE` as a word. * `createTime\u003c1609459200` to find Google Cloud resources that were created before `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of `2021-01-01 00:00:00 UTC` in seconds. * `updateTime\u003e1609459200` to find Google Cloud resources that were updated after `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of `2021-01-01 00:00:00 UTC` in seconds. * `Important` to find Google Cloud resources that contain `Important` as a word in any of the searchable fields. * `Impor*` to find Google Cloud resources that contain `Impor` as a prefix of any word in any of the searchable fields. * `Important location:(us-west1 OR global)` to find Google Cloud resources that contain `Important` as a word in any of the searchable fields and are also located in the `us-west1` region or the `global` location.", + "description": "Optional. The query statement. See [how to construct a query](https://cloud.google.com/asset-inventory/docs/searching-resources#how_to_construct_a_query) for more information. If not specified or empty, it will search all the resources within the specified `scope`. Examples: * `name:Important` to find Google Cloud resources whose name contains `Important` as a word. * `name=Important` to find the Google Cloud resource whose name is exactly `Important`. * `displayName:Impor*` to find Google Cloud resources whose display name contains `Impor` as a prefix of any word in the field. * `location:us-west*` to find Google Cloud resources whose location contains both `us` and `west` as prefixes. * `labels:prod` to find Google Cloud resources whose labels contain `prod` as a key or value. * `labels.env:prod` to find Google Cloud resources that have a label `env` and its value is `prod`. * `labels.env:*` to find Google Cloud resources that have a label `env`. * `tagKeys:env` to find Google Cloud resources that have directly attached tags where the [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey) .`namespacedName` contains `env`. * `tagValues:prod*` to find Google Cloud resources that have directly attached tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`namespacedName` contains a word prefixed by `prod`. * `tagValueIds=tagValues/123` to find Google Cloud resources that have directly attached tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`name` is exactly `tagValues/123`. * `effectiveTagKeys:env` to find Google Cloud resources that have directly attached or inherited tags where the [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey) .`namespacedName` contains `env`. * `effectiveTagValues:prod*` to find Google Cloud resources that have directly attached or inherited tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`namespacedName` contains a word prefixed by `prod`. * `effectiveTagValueIds=tagValues/123` to find Google Cloud resources that have directly attached or inherited tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`name` is exactly `tagValues/123`. * `kmsKey:key` to find Google Cloud resources encrypted with a customer-managed encryption key whose name contains `key` as a word. This field is deprecated. Please use the `kmsKeys` field to retrieve Cloud KMS key information. * `kmsKeys:key` to find Google Cloud resources encrypted with customer-managed encryption keys whose name contains the word `key`. * `relationships:instance-group-1` to find Google Cloud resources that have relationships with `instance-group-1` in the related resource name. * `relationships:INSTANCE_TO_INSTANCEGROUP` to find Compute Engine instances that have relationships of type `INSTANCE_TO_INSTANCEGROUP`. * `relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1` to find Compute Engine instances that have relationships with `instance-group-1` in the Compute Engine instance group resource name, for relationship type `INSTANCE_TO_INSTANCEGROUP`. * `sccSecurityMarks.key=value` to find Cloud resources that are attached with security marks whose key is `key` and value is `value'. * `sccSecurityMarks.key:*` to find Cloud resources that are attached with security marks whose key is `key`. * `state:ACTIVE` to find Google Cloud resources whose state contains `ACTIVE` as a word. * `NOT state:ACTIVE` to find Google Cloud resources whose state doesn't contain `ACTIVE` as a word. * `createTime\u003c1609459200` to find Google Cloud resources that were created before `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of `2021-01-01 00:00:00 UTC` in seconds. * `updateTime\u003e1609459200` to find Google Cloud resources that were updated after `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of `2021-01-01 00:00:00 UTC` in seconds. * `Important` to find Google Cloud resources that contain `Important` as a word in any of the searchable fields. * `Impor*` to find Google Cloud resources that contain `Impor` as a prefix of any word in any of the searchable fields. * `Important location:(us-west1 OR global)` to find Google Cloud resources that contain `Important` as a word in any of the searchable fields and are also located in the `us-west1` region or the `global` location.", "location": "query", "type": "string" }, @@ -1095,7 +1095,7 @@ } } }, - "revision": "20230922", + "revision": "20231006", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index 39db94716ff..ff1a1dc542f 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -11797,22 +11797,25 @@ func (c *V1SearchAllResourcesCall) PageToken(pageToken string) *V1SearchAllResou // Compute Engine instances that have relationships with // `instance-group-1` in the Compute Engine instance group resource // name, for relationship type `INSTANCE_TO_INSTANCEGROUP`. * -// `state:ACTIVE` to find Google Cloud resources whose state contains -// `ACTIVE` as a word. * `NOT state:ACTIVE` to find Google Cloud -// resources whose state doesn't contain `ACTIVE` as a word. * -// `createTime<1609459200` to find Google Cloud resources that were -// created before `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch -// timestamp of `2021-01-01 00:00:00 UTC` in seconds. * -// `updateTime>1609459200` to find Google Cloud resources that were -// updated after `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch -// timestamp of `2021-01-01 00:00:00 UTC` in seconds. * `Important` to -// find Google Cloud resources that contain `Important` as a word in any -// of the searchable fields. * `Impor*` to find Google Cloud resources -// that contain `Impor` as a prefix of any word in any of the searchable -// fields. * `Important location:(us-west1 OR global)` to find Google -// Cloud resources that contain `Important` as a word in any of the -// searchable fields and are also located in the `us-west1` region or -// the `global` location. +// `sccSecurityMarks.key=value` to find Cloud resources that are +// attached with security marks whose key is `key` and value is `value'. +// * `sccSecurityMarks.key:*` to find Cloud resources that are attached +// with security marks whose key is `key`. * `state:ACTIVE` to find +// Google Cloud resources whose state contains `ACTIVE` as a word. * +// `NOT state:ACTIVE` to find Google Cloud resources whose state doesn't +// contain `ACTIVE` as a word. * `createTime<1609459200` to find Google +// Cloud resources that were created before `2021-01-01 00:00:00 UTC`. +// `1609459200` is the epoch timestamp of `2021-01-01 00:00:00 UTC` in +// seconds. * `updateTime>1609459200` to find Google Cloud resources +// that were updated after `2021-01-01 00:00:00 UTC`. `1609459200` is +// the epoch timestamp of `2021-01-01 00:00:00 UTC` in seconds. * +// `Important` to find Google Cloud resources that contain `Important` +// as a word in any of the searchable fields. * `Impor*` to find Google +// Cloud resources that contain `Impor` as a prefix of any word in any +// of the searchable fields. * `Important location:(us-west1 OR global)` +// to find Google Cloud resources that contain `Important` as a word in +// any of the searchable fields and are also located in the `us-west1` +// region or the `global` location. func (c *V1SearchAllResourcesCall) Query(query string) *V1SearchAllResourcesCall { c.urlParams_.Set("query", query) return c @@ -11968,7 +11971,7 @@ func (c *V1SearchAllResourcesCall) Do(opts ...googleapi.CallOption) (*SearchAllR // "type": "string" // }, // "query": { - // "description": "Optional. The query statement. See [how to construct a query](https://cloud.google.com/asset-inventory/docs/searching-resources#how_to_construct_a_query) for more information. If not specified or empty, it will search all the resources within the specified `scope`. Examples: * `name:Important` to find Google Cloud resources whose name contains `Important` as a word. * `name=Important` to find the Google Cloud resource whose name is exactly `Important`. * `displayName:Impor*` to find Google Cloud resources whose display name contains `Impor` as a prefix of any word in the field. * `location:us-west*` to find Google Cloud resources whose location contains both `us` and `west` as prefixes. * `labels:prod` to find Google Cloud resources whose labels contain `prod` as a key or value. * `labels.env:prod` to find Google Cloud resources that have a label `env` and its value is `prod`. * `labels.env:*` to find Google Cloud resources that have a label `env`. * `tagKeys:env` to find Google Cloud resources that have directly attached tags where the [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey) .`namespacedName` contains `env`. * `tagValues:prod*` to find Google Cloud resources that have directly attached tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`namespacedName` contains a word prefixed by `prod`. * `tagValueIds=tagValues/123` to find Google Cloud resources that have directly attached tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`name` is exactly `tagValues/123`. * `effectiveTagKeys:env` to find Google Cloud resources that have directly attached or inherited tags where the [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey) .`namespacedName` contains `env`. * `effectiveTagValues:prod*` to find Google Cloud resources that have directly attached or inherited tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`namespacedName` contains a word prefixed by `prod`. * `effectiveTagValueIds=tagValues/123` to find Google Cloud resources that have directly attached or inherited tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`name` is exactly `tagValues/123`. * `kmsKey:key` to find Google Cloud resources encrypted with a customer-managed encryption key whose name contains `key` as a word. This field is deprecated. Please use the `kmsKeys` field to retrieve Cloud KMS key information. * `kmsKeys:key` to find Google Cloud resources encrypted with customer-managed encryption keys whose name contains the word `key`. * `relationships:instance-group-1` to find Google Cloud resources that have relationships with `instance-group-1` in the related resource name. * `relationships:INSTANCE_TO_INSTANCEGROUP` to find Compute Engine instances that have relationships of type `INSTANCE_TO_INSTANCEGROUP`. * `relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1` to find Compute Engine instances that have relationships with `instance-group-1` in the Compute Engine instance group resource name, for relationship type `INSTANCE_TO_INSTANCEGROUP`. * `state:ACTIVE` to find Google Cloud resources whose state contains `ACTIVE` as a word. * `NOT state:ACTIVE` to find Google Cloud resources whose state doesn't contain `ACTIVE` as a word. * `createTime\u003c1609459200` to find Google Cloud resources that were created before `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of `2021-01-01 00:00:00 UTC` in seconds. * `updateTime\u003e1609459200` to find Google Cloud resources that were updated after `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of `2021-01-01 00:00:00 UTC` in seconds. * `Important` to find Google Cloud resources that contain `Important` as a word in any of the searchable fields. * `Impor*` to find Google Cloud resources that contain `Impor` as a prefix of any word in any of the searchable fields. * `Important location:(us-west1 OR global)` to find Google Cloud resources that contain `Important` as a word in any of the searchable fields and are also located in the `us-west1` region or the `global` location.", + // "description": "Optional. The query statement. See [how to construct a query](https://cloud.google.com/asset-inventory/docs/searching-resources#how_to_construct_a_query) for more information. If not specified or empty, it will search all the resources within the specified `scope`. Examples: * `name:Important` to find Google Cloud resources whose name contains `Important` as a word. * `name=Important` to find the Google Cloud resource whose name is exactly `Important`. * `displayName:Impor*` to find Google Cloud resources whose display name contains `Impor` as a prefix of any word in the field. * `location:us-west*` to find Google Cloud resources whose location contains both `us` and `west` as prefixes. * `labels:prod` to find Google Cloud resources whose labels contain `prod` as a key or value. * `labels.env:prod` to find Google Cloud resources that have a label `env` and its value is `prod`. * `labels.env:*` to find Google Cloud resources that have a label `env`. * `tagKeys:env` to find Google Cloud resources that have directly attached tags where the [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey) .`namespacedName` contains `env`. * `tagValues:prod*` to find Google Cloud resources that have directly attached tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`namespacedName` contains a word prefixed by `prod`. * `tagValueIds=tagValues/123` to find Google Cloud resources that have directly attached tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`name` is exactly `tagValues/123`. * `effectiveTagKeys:env` to find Google Cloud resources that have directly attached or inherited tags where the [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey) .`namespacedName` contains `env`. * `effectiveTagValues:prod*` to find Google Cloud resources that have directly attached or inherited tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`namespacedName` contains a word prefixed by `prod`. * `effectiveTagValueIds=tagValues/123` to find Google Cloud resources that have directly attached or inherited tags where the [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue) .`name` is exactly `tagValues/123`. * `kmsKey:key` to find Google Cloud resources encrypted with a customer-managed encryption key whose name contains `key` as a word. This field is deprecated. Please use the `kmsKeys` field to retrieve Cloud KMS key information. * `kmsKeys:key` to find Google Cloud resources encrypted with customer-managed encryption keys whose name contains the word `key`. * `relationships:instance-group-1` to find Google Cloud resources that have relationships with `instance-group-1` in the related resource name. * `relationships:INSTANCE_TO_INSTANCEGROUP` to find Compute Engine instances that have relationships of type `INSTANCE_TO_INSTANCEGROUP`. * `relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1` to find Compute Engine instances that have relationships with `instance-group-1` in the Compute Engine instance group resource name, for relationship type `INSTANCE_TO_INSTANCEGROUP`. * `sccSecurityMarks.key=value` to find Cloud resources that are attached with security marks whose key is `key` and value is `value'. * `sccSecurityMarks.key:*` to find Cloud resources that are attached with security marks whose key is `key`. * `state:ACTIVE` to find Google Cloud resources whose state contains `ACTIVE` as a word. * `NOT state:ACTIVE` to find Google Cloud resources whose state doesn't contain `ACTIVE` as a word. * `createTime\u003c1609459200` to find Google Cloud resources that were created before `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of `2021-01-01 00:00:00 UTC` in seconds. * `updateTime\u003e1609459200` to find Google Cloud resources that were updated after `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of `2021-01-01 00:00:00 UTC` in seconds. * `Important` to find Google Cloud resources that contain `Important` as a word in any of the searchable fields. * `Impor*` to find Google Cloud resources that contain `Impor` as a prefix of any word in any of the searchable fields. * `Important location:(us-west1 OR global)` to find Google Cloud resources that contain `Important` as a word in any of the searchable fields and are also located in the `us-west1` region or the `global` location.", // "location": "query", // "type": "string" // }, diff --git a/contentwarehouse/v1/contentwarehouse-api.json b/contentwarehouse/v1/contentwarehouse-api.json index 6b2715dcf66..2b9c957e940 100644 --- a/contentwarehouse/v1/contentwarehouse-api.json +++ b/contentwarehouse/v1/contentwarehouse-api.json @@ -1156,7 +1156,7 @@ } } }, - "revision": "20230929", + "revision": "20231006", "rootUrl": "https://contentwarehouse.googleapis.com/", "schemas": { "AbuseiamAbuseType": { @@ -3729,7 +3729,10 @@ "PERSONAL_AGENT_AFFINITY", "MOBILE_HARNESS_AFFINITY", "LOOKER_STUDIO_PRO_AFFINITY", - "SUPPORT_CLASSIFICATION_UI_AFFINITY" + "SUPPORT_CLASSIFICATION_UI_AFFINITY", + "NOTEBOOKLM_AFFINITY", + "PLAYSPACE_LABS_AFFINITY", + "ZOMBIE_CLOUD_AFFINITY" ], "enumDeprecated": [ false, @@ -3999,6 +4002,9 @@ false, false, false, + false, + false, + false, false ], "enumDescriptions": [ @@ -4269,6 +4275,9 @@ "", "", "", + "", + "", + "", "" ], "type": "string" @@ -7087,12 +7096,14 @@ "type": "array" }, "contactCreateContextInfo": { + "description": "ContactCreateContextInfo has a timestamp timestamp and additional metadata (e.g. the source of the creation) for when the contact was created. See also `ContactEditContextInfo`.", "items": { "$ref": "AppsPeopleOzExternalMergedpeopleapiContactCreateContextInfo" }, "type": "array" }, "contactEditContextInfo": { + "description": "ContactEditContextInfo is a timestamp and additional metadata (e.g. the source of the edit) for the last 'human initiated edit'. See also `ContactCreateContextInfo`.", "items": { "$ref": "AppsPeopleOzExternalMergedpeopleapiContactEditContextInfo" }, @@ -14692,6 +14703,7 @@ "type": "boolean" }, "isOnDeviceArbitrationSupported": { + "deprecated": true, "description": "Capabilities related to on-device arbitration(go/arbitration-on-device).", "type": "boolean" }, @@ -14700,6 +14712,7 @@ "type": "boolean" }, "isOnDeviceUnderstandingSupported": { + "deprecated": true, "description": "This may be used by NGA. E.g. if understanding happens on device, we can have more aggressive logic when fulfilling some features on the server side, like teleport.", "type": "boolean" } @@ -15617,6 +15630,7 @@ }, "marketplaceDisclosure": { "$ref": "AssistantApiSettingsMarketplaceDisclosure", + "deprecated": true, "description": "See go/marketplace-disclosure for more info." }, "masqueradeMode": { @@ -24089,21 +24103,6 @@ ], "type": "string" }, - "csaiRegexpHighConfidenceClassification": { - "deprecated": true, - "description": "DO NOT USE: This field is temporary and should be used only for the CSAI Onebox. This field is the result of the regular expression classifier alone as opposed to a combination with Seti classifier as in csai_classification field.", - "enum": [ - "NOT_PROTECTED", - "PROTECTED", - "STRONGLY_PROTECTED" - ], - "enumDescriptions": [ - "Contract: (STRONGLY_PROTECTED \u0026 PROTECTED) == PROTECTED", - "", - "" - ], - "type": "string" - }, "debug": { "description": "Human-readable debug information about the classification. This field is only set if output_debug is set in the classification input.", "type": "string" @@ -32667,15 +32666,15 @@ "type": "number" }, "translate": { - "$ref": "GeostoreCityJsonProtoTransformXyzVector", + "$ref": "GeostoreCityJsonProtoTransformTranslate", "description": "Offset of each vertex in the new coordinate system relative to the old coordinate system." } }, "type": "object" }, - "GeostoreCityJsonProtoTransformXyzVector": { - "description": "Vector of length three whose values respectively correspond to the x, y, and z axes.", - "id": "GeostoreCityJsonProtoTransformXyzVector", + "GeostoreCityJsonProtoTransformTranslate": { + "description": "How the object will be moved along the x, y, and z axes, respectively.", + "id": "GeostoreCityJsonProtoTransformTranslate", "properties": { "x": { "format": "double", @@ -52300,7 +52299,7 @@ "type": "object" }, "GoogleAssistantAccessoryV1DeviceState": { - "description": "Information about the state of the device. This contains any state that Assistant may need to know about in order to fulfill requests, for example which timers and alarms are set. Next ID: 11", + "description": "Information about the state of the device. This contains any state that Assistant may need to know about in order to fulfill requests, for example which timers and alarms are set. Next ID: 13", "id": "GoogleAssistantAccessoryV1DeviceState", "properties": { "alarmState": { @@ -52329,6 +52328,15 @@ "$ref": "GoogleAssistantEmbeddedV1FitnessActivities", "description": "Information about on-device fitness activities. For devices that support fitness activities, all on-device fitness activities must be sent up with the DeviceState in order for Assistant Server to be able to perform operations on them." }, + "installedApps": { + "$ref": "GoogleAssistantAccessoryV1DeviceStateInstalledAppsState", + "description": "Information about apps currently installed on device." + }, + "installedAppsZlib": { + "description": "This contains a zlib-compressed binary-encoded `InstalledAppsState` proto message.", + "format": "byte", + "type": "string" + }, "timerState": { "$ref": "GoogleAssistantEmbeddedV1Timers", "description": "*Optional* Information about on-device timers. For devices that support timers, all on-device timers must be sent up with the DeviceState in order for Assistant Server to be able to perform operations on them." @@ -53324,6 +53332,20 @@ }, "type": "object" }, + "GoogleAssistantAccessoryV1DeviceStateInstalledAppsState": { + "description": "State of the apps currently installed on the device.", + "id": "GoogleAssistantAccessoryV1DeviceStateInstalledAppsState", + "properties": { + "apps": { + "description": "List of apps currently installed on the device.", + "items": { + "$ref": "AssistantApiCoreTypesProvider" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleAssistantAccessoryV1ResponseConfig": { "description": "Configuration for the response. Next Id: 11", "id": "GoogleAssistantAccessoryV1ResponseConfig", @@ -90803,6 +90825,8 @@ "MOBILE_HARNESS", "LOOKER_STUDIO_PRO", "SUPPORT_CLASSIFICATION_UI", + "NOTEBOOKLM", + "ZOMBIE_CLOUD", "DEPRECATED_QUICKSTART_FLUME", "DUO_CLIENT", "ALBERT", @@ -91456,6 +91480,8 @@ false, false, false, + false, + false, true, false, false, @@ -92109,6 +92135,8 @@ "Mobile Harness Team contact: omnilab-lmp@google.com", "Looker Studio Pro Team contact: da-cloudbi-india-ls-adminexp@google.com", "Support Classification Ui Team contact: support-classification-eng@google.com", + "Notebooklm Team contact: labs-tailwind-eng-team@google.com", + "Zombie Cloud Team contact: zombie-cloud-eng@google.com", "", "Duo Client Team contact: duo-eng@google.com", "Project albert (go/albert-frontend) Team contact: albert-eng@google.com", @@ -110380,6 +110408,30 @@ }, "type": "object" }, + "RepositoryWebrefMetaTagIndices": { + "description": "Identifies the source of the Meta Content Tag segment in the Cdoc https://www.w3schools.com/tags/tag_meta.asp", + "id": "RepositoryWebrefMetaTagIndices", + "properties": { + "index": { + "format": "int32", + "type": "integer" + }, + "metaName": { + "enum": [ + "OTHER", + "DESCRIPTION", + "KEYWORDS" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "RepositoryWebrefNameDebugInfo": { "description": "Collects signals from one query used for prior learning.", "id": "RepositoryWebrefNameDebugInfo", @@ -111866,6 +111918,10 @@ "$ref": "RepositoryWebrefJuggernautIndices", "description": "Pointer to the proto in the cdoc and index within the proto for Spore." }, + "metaTagIndex": { + "$ref": "RepositoryWebrefMetaTagIndices", + "description": "Informs about the 'name' attribute of the referenced tag." + }, "queryIndex": { "$ref": "RepositoryWebrefQueryIndices", "description": "Pointer to the exact set of queries in the cdoc." @@ -121019,6 +121075,22 @@ "description": "Affinity score for the cloud contact.", "format": "double", "type": "number" + }, + "suggestionConfidence": { + "description": "Indicator of the confidence in suggestion relevance.", + "enum": [ + "CONFIDENCE_UNSPECIFIED", + "CONFIDENCE_LOW", + "CONFIDENCE_MEDIUM", + "CONFIDENCE_HIGH" + ], + "enumDescriptions": [ + "", + "", + "", + "" + ], + "type": "string" } }, "type": "object" @@ -121193,7 +121265,7 @@ "type": "object" }, "SocialGraphWireProtoPeopleapiExtensionPeopleStackPersonExtendedData": { - "description": "NEXT_ID: 5", + "description": "NEXT_ID: 6", "id": "SocialGraphWireProtoPeopleapiExtensionPeopleStackPersonExtendedData", "properties": { "birthdayStatus": { @@ -121238,6 +121310,21 @@ "" ], "type": "string" + }, + "suggestionConfidence": { + "enum": [ + "CONFIDENCE_UNSPECIFIED", + "CONFIDENCE_LOW", + "CONFIDENCE_MEDIUM", + "CONFIDENCE_HIGH" + ], + "enumDescriptions": [ + "", + "", + "", + "" + ], + "type": "string" } }, "type": "object" @@ -126263,6 +126350,7 @@ "GEARHEAD_FRX_SENSITIVE_PERMISSION_SCREEN_SEEN", "POST_PURCHASE_ITEM_UPSELL_SESSION_LEVEL", "POST_PURCHASE_ITEM_UPSELL_WAVE_2_SESSION_LEVEL", + "POST_PURCHASE_ITEM_UPSELL_WAVE_2_SESSION_LEVEL_2", "PLAY_PASS_SIGNUP_INTERSTITIAL_SHOWN_SESSION_LEVEL", "FETCH_PROMOTION_BANNER_FROM_P3_SESSION_LEVEL", "AVP_SWOOP_10P_OFF_SESSION_LEVEL", @@ -126760,6 +126848,8 @@ "BECAUSE_YOU_PLAYED_FIRST_3_ROWS_SESSION_LEVEL", "BECAUSE_YOU_INSTALLED_FIRST_3_ROWS_SESSION_LEVEL", "LOYALTY_WEEKLY_REWARDS_ICC_FORMAT_NOW_HOME_SESSION_LEVEL", + "MULTILINE_SUBSCRIPTION_ADDON_TITLE_SESSION_LEVEL", + "PAYTM_WALLET_FAILURE_SESSION_LEVEL", "SESSION_LEVEL_TEST_CODE_LIMIT", "CART_ABANDONMENT_USER_LEVEL", "IN_APP_PRODUCTS_IN_DETAILS_PAGE_USER_LEVEL", @@ -126876,6 +126966,7 @@ "GEARHEAD_VISUAL_PREVIEW_UNCHAINED_ELIGIBLE", "POST_PURCHASE_ITEM_UPSELL_USER_LEVEL", "POST_PURCHASE_ITEM_UPSELL_WAVE_2_USER_LEVEL", + "POST_PURCHASE_ITEM_UPSELL_WAVE_2_USER_LEVEL_2", "PLAY_PASS_SIGNUP_INTERSTITIAL_SHOWN_USER_LEVEL", "DISABLE_TOPUP_EXPERIMENT_CONTROL_GROUP_USER_LEVEL", "DISABLE_TOPUP_EXPERIMENT_TREATMENT_GROUP_USER_LEVEL", @@ -127098,14 +127189,25 @@ "ELIGIBLE_FOR_COMICS_CLUSTER_AH_USER_LEVEL", "HIGH_COMIC_APP_USAGE_USER_LEVEL", "MODERATE_COMIC_APP_USAGE_USER_LEVEL", + "COMIC_SAMPLING_PICCOMA_INSTALLED_USER_LEVEL", + "COMIC_SAMPLING_MANGA_ONE_INSTALLED_USER_LEVEL", + "COMIC_SAMPLING_MAGAPOKE_INSTALLED_USER_LEVEL", + "COMIC_SAMPLING_JUMP_INSTALLED_USER_LEVEL", + "COMIC_SAMPLING_LINE_MANGA_INSTALLED_USER_LEVEL", + "COMIC_SAMPLING_ANY_INSTALLED_USER_LEVEL", "REDEEM_SAVE_BUYER_SPEND_MODEL_USER_LEVEL", "PURCHASE_ADD_FOP_OPTIONS_SCREEN_USER_LEVEL", "CART_ABANDONMENT_ITEM_RECOMMENDATION_USER_LEVEL", + "CART_ABANDONMENT_ITEM_RECOMMENDATION_LOWER_PRICED_USER_LEVEL", "HAS_INSUFFICIENT_STORED_VALUE_BALANCE_BEFORE_RENEWAL_USER_LEVEL", "IS_ELIGIBLE_FOR_ONE_CLICK_BAKCUP_FOP_IN_FIX_FLOW_USER_LEVEL", "WEBSKY_DISPLAY_SUBSCRIPTION_ENTITLEMENT_BENEFITS_USER_LEVEL", "HAS_INSUFFICIENT_STORED_VALUE_BALANCE_BEFORE_RENEWAL_V2_USER_LEVEL", "LOYALTY_WEEKLY_REWARDS_ICC_FORMAT_NOW_HOME_USER_LEVEL", + "PREREGISTRATION_SHOULD_SEE_NOTIFICATION_DIALOG_USER_LEVEL", + "MULTILINE_SUBSCRIPTION_ADDON_TITLE_USER_LEVEL", + "UNIFIED_ITEM_RECOMMENDATION_USER_LEVEL", + "UNIFIED_ITEM_RECOMMENDATION_LOWER_PRICED_USER_LEVEL", "USER_LEVEL_TEST_CODE_LIMIT" ], "enumDeprecated": [ @@ -127635,6 +127737,7 @@ false, false, false, + false, true, false, false, @@ -128308,6 +128411,9 @@ false, false, false, + false, + false, + false, true, false, false, @@ -128466,6 +128572,17 @@ false, false, false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, false ], "enumDescriptions": [ @@ -128983,6 +129100,7 @@ "", "", "", + "", "Test code logged on client side for users who see the Play Pass signup interstitial.", "", "User eligible for 10% off for next renewal", @@ -129480,6 +129598,8 @@ "Session-level test code for Because You Played experiments.", "Session-level test code for Because You Played experiments.", "Session-level test code for loyalty weekly rewards in Now! home.", + "Session-level test code for multiline addon title.", + "Session-level test code for Paytm wallet failures.", "", "Cart abandonment flow for purchase flow.", "User saw/would have seen the in app products section in App", @@ -129596,6 +129716,7 @@ "Test code for when a user was eligible for visual preview while in motion. E.g. received a notification and had visual preview setting enabled.", "", "", + "", "Test code logged on client side for users who see the Play Pass signup interstitial.", "Test codes for seeing the effects of disabling topup in select countries.", "", @@ -129818,14 +129939,25 @@ "User-level test code for users eligible for the Comics cluster on AH.", "User-level test code for users with high Comics app usage (e.g. \u003e=15 in last 28d ays).", "User-level test code for users with high Comics app usage (e.g. \u003e=10 in last 28d ays).", + "User-level test code for users who had Piccoma installed for the Comics Sampling Cluster Experiment.", + "User-level test code for users who had Manga One installed for the Comics Sampling Cluster Experiment.", + "User-level test code for users who had Magapoke installed for the Comics Sampling Cluster Experiment.", + "User-level test code for users who had Jump+ installed for the Comics Sampling Cluster Experiment.", + "User-level test code for users who had Line Manga installed for the Comics Sampling Cluster Experiment.", + "User-level test code for users who had any of the 5 manga apps listed above installed for the Comics Sampling Cluster Experiment.", "User level test code for Redeem Save buyer offer study, tracking users who actually get different experience between control and treatment.", "User-level test code marking users who have seen the add new fop option screen during purchase flow. This will be used for ranking of add fop options experiments.", - "User level test code for SKU Recommendation in Cart Abandonment.", + "User level test code for SKU Recommendation in Cart Abandonment, currently used for popular after abandon candidates.", + "User level test code for SKU Recommendation in Cart Abandonment, specifically for lower-priced candidates.", "User level test code for stored value top-up email reminder.", "User level test code for users who are eligible for one-click backup fop in fix flow", "User level test code for displaying sub-entitlement benefits on websky.", "User level test code for stored value top-up email reminder (V2).", "User level test code for loyalty weekly rewards in Now! home.", + "User level test code for users who should have seen preregistration notification dialog.", + "User level test code for multiline addon title.", + "User level test code for unified SKU Recommendations. Used when user is eligible for any SKU Recommendation, currently either cart-abandonment or post-success upsell.", + "", "" ], "type": "string" diff --git a/contentwarehouse/v1/contentwarehouse-gen.go b/contentwarehouse/v1/contentwarehouse-gen.go index fd8ef87cadc..fbf4c66fba2 100644 --- a/contentwarehouse/v1/contentwarehouse-gen.go +++ b/contentwarehouse/v1/contentwarehouse-gen.go @@ -3247,6 +3247,9 @@ type AppsPeopleOzExternalMergedpeopleapiAffinity struct { // "MOBILE_HARNESS_AFFINITY" // "LOOKER_STUDIO_PRO_AFFINITY" // "SUPPORT_CLASSIFICATION_UI_AFFINITY" + // "NOTEBOOKLM_AFFINITY" + // "PLAYSPACE_LABS_AFFINITY" + // "ZOMBIE_CLOUD_AFFINITY" AffinityType string `json:"affinityType,omitempty"` // ContainerId: The ID of the container @@ -7456,8 +7459,14 @@ type AppsPeopleOzExternalMergedpeopleapiPerson struct { // container. ConnectionReminder []*AppsPeopleOzExternalMergedpeopleapiConnectionReminder `json:"connectionReminder,omitempty"` + // ContactCreateContextInfo: ContactCreateContextInfo has a timestamp + // timestamp and additional metadata (e.g. the source of the creation) + // for when the contact was created. See also `ContactEditContextInfo`. ContactCreateContextInfo []*AppsPeopleOzExternalMergedpeopleapiContactCreateContextInfo `json:"contactCreateContextInfo,omitempty"` + // ContactEditContextInfo: ContactEditContextInfo is a timestamp and + // additional metadata (e.g. the source of the edit) for the last 'human + // initiated edit'. See also `ContactCreateContextInfo`. ContactEditContextInfo []*AppsPeopleOzExternalMergedpeopleapiContactEditContextInfo `json:"contactEditContextInfo,omitempty"` // ContactGroupMembership: Contact groups that this person is a member @@ -29699,18 +29708,6 @@ type ClassifierPornQueryClassifierOutput struct { // "STRONGLY_PROTECTED" CsaiClassification string `json:"csaiClassification,omitempty"` - // CsaiRegexpHighConfidenceClassification: DO NOT USE: This field is - // temporary and should be used only for the CSAI Onebox. This field is - // the result of the regular expression classifier alone as opposed to a - // combination with Seti classifier as in csai_classification field. - // - // Possible values: - // "NOT_PROTECTED" - Contract: (STRONGLY_PROTECTED & PROTECTED) == - // PROTECTED - // "PROTECTED" - // "STRONGLY_PROTECTED" - CsaiRegexpHighConfidenceClassification string `json:"csaiRegexpHighConfidenceClassification,omitempty"` - // Debug: Human-readable debug information about the classification. // This field is only set if output_debug is set in the classification // input. @@ -39950,7 +39947,7 @@ type GeostoreCityJsonProtoTransform struct { // Translate: Offset of each vertex in the new coordinate system // relative to the old coordinate system. - Translate *GeostoreCityJsonProtoTransformXyzVector `json:"translate,omitempty"` + Translate *GeostoreCityJsonProtoTransformTranslate `json:"translate,omitempty"` // ForceSendFields is a list of field names (e.g. "Scale") to // unconditionally include in API requests. By default, fields with @@ -39989,9 +39986,9 @@ func (s *GeostoreCityJsonProtoTransform) UnmarshalJSON(data []byte) error { return nil } -// GeostoreCityJsonProtoTransformXyzVector: Vector of length three whose -// values respectively correspond to the x, y, and z axes. -type GeostoreCityJsonProtoTransformXyzVector struct { +// GeostoreCityJsonProtoTransformTranslate: How the object will be moved +// along the x, y, and z axes, respectively. +type GeostoreCityJsonProtoTransformTranslate struct { X float64 `json:"x,omitempty"` Y float64 `json:"y,omitempty"` @@ -40015,14 +40012,14 @@ type GeostoreCityJsonProtoTransformXyzVector struct { NullFields []string `json:"-"` } -func (s *GeostoreCityJsonProtoTransformXyzVector) MarshalJSON() ([]byte, error) { - type NoMethod GeostoreCityJsonProtoTransformXyzVector +func (s *GeostoreCityJsonProtoTransformTranslate) MarshalJSON() ([]byte, error) { + type NoMethod GeostoreCityJsonProtoTransformTranslate raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -func (s *GeostoreCityJsonProtoTransformXyzVector) UnmarshalJSON(data []byte) error { - type NoMethod GeostoreCityJsonProtoTransformXyzVector +func (s *GeostoreCityJsonProtoTransformTranslate) UnmarshalJSON(data []byte) error { + type NoMethod GeostoreCityJsonProtoTransformTranslate var s1 struct { X gensupport.JSONFloat64 `json:"x"` Y gensupport.JSONFloat64 `json:"y"` @@ -57356,7 +57353,7 @@ func (s *GoogleAssistantAccessoryV1DeviceConfig) MarshalJSON() ([]byte, error) { // GoogleAssistantAccessoryV1DeviceState: Information about the state of // the device. This contains any state that Assistant may need to know // about in order to fulfill requests, for example which timers and -// alarms are set. Next ID: 11 +// alarms are set. Next ID: 13 type GoogleAssistantAccessoryV1DeviceState struct { // AlarmState: *Optional* Information about on-device alarms. For // devices that support alarms, all on-device alarms must be sent up @@ -57398,6 +57395,13 @@ type GoogleAssistantAccessoryV1DeviceState struct { // order for Assistant Server to be able to perform operations on them. FitnessActivitiesState *GoogleAssistantEmbeddedV1FitnessActivities `json:"fitnessActivitiesState,omitempty"` + // InstalledApps: Information about apps currently installed on device. + InstalledApps *GoogleAssistantAccessoryV1DeviceStateInstalledAppsState `json:"installedApps,omitempty"` + + // InstalledAppsZlib: This contains a zlib-compressed binary-encoded + // `InstalledAppsState` proto message. + InstalledAppsZlib string `json:"installedAppsZlib,omitempty"` + // TimerState: *Optional* Information about on-device timers. For // devices that support timers, all on-device timers must be sent up // with the DeviceState in order for Assistant Server to be able to @@ -57803,6 +57807,35 @@ func (s *GoogleAssistantAccessoryV1DeviceState) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleAssistantAccessoryV1DeviceStateInstalledAppsState: State of the +// apps currently installed on the device. +type GoogleAssistantAccessoryV1DeviceStateInstalledAppsState struct { + // Apps: List of apps currently installed on the device. + Apps []*AssistantApiCoreTypesProvider `json:"apps,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Apps") 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. "Apps") 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 *GoogleAssistantAccessoryV1DeviceStateInstalledAppsState) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAssistantAccessoryV1DeviceStateInstalledAppsState + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleAssistantAccessoryV1ResponseConfig: Configuration for the // response. Next Id: 11 type GoogleAssistantAccessoryV1ResponseConfig struct { @@ -106530,6 +106563,10 @@ type PeoplestackFlexorgsProtoInternalExternal struct { // da-cloudbi-india-ls-adminexp@google.com // "SUPPORT_CLASSIFICATION_UI" - Support Classification Ui Team // contact: support-classification-eng@google.com + // "NOTEBOOKLM" - Notebooklm Team contact: + // labs-tailwind-eng-team@google.com + // "ZOMBIE_CLOUD" - Zombie Cloud Team contact: + // zombie-cloud-eng@google.com // "DEPRECATED_QUICKSTART_FLUME" // "DUO_CLIENT" - Duo Client Team contact: duo-eng@google.com // "ALBERT" - Project albert (go/albert-frontend) Team contact: @@ -126568,6 +126605,41 @@ func (s *RepositoryWebrefMentionRatingsSingleMentionRating) MarshalJSON() ([]byt return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// RepositoryWebrefMetaTagIndices: Identifies the source of the Meta +// Content Tag segment in the Cdoc +// https://www.w3schools.com/tags/tag_meta.asp +type RepositoryWebrefMetaTagIndices struct { + Index int64 `json:"index,omitempty"` + + // Possible values: + // "OTHER" + // "DESCRIPTION" + // "KEYWORDS" + MetaName string `json:"metaName,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Index") 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. "Index") 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 *RepositoryWebrefMetaTagIndices) MarshalJSON() ([]byte, error) { + type NoMethod RepositoryWebrefMetaTagIndices + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // RepositoryWebrefNameDebugInfo: Collects signals from one query used // for prior learning. type RepositoryWebrefNameDebugInfo struct { @@ -128730,6 +128802,10 @@ type RepositoryWebrefSubSegmentIndex struct { // for Spore. JgnIndex *RepositoryWebrefJuggernautIndices `json:"jgnIndex,omitempty"` + // MetaTagIndex: Informs about the 'name' attribute of the referenced + // tag. + MetaTagIndex *RepositoryWebrefMetaTagIndices `json:"metaTagIndex,omitempty"` + // QueryIndex: Pointer to the exact set of queries in the cdoc. QueryIndex *RepositoryWebrefQueryIndices `json:"queryIndex,omitempty"` @@ -140938,6 +141014,16 @@ type SocialGraphWireProtoPeopleapiAffinityMetadata struct { // CloudScore: Affinity score for the cloud contact. CloudScore float64 `json:"cloudScore,omitempty"` + // SuggestionConfidence: Indicator of the confidence in suggestion + // relevance. + // + // Possible values: + // "CONFIDENCE_UNSPECIFIED" + // "CONFIDENCE_LOW" + // "CONFIDENCE_MEDIUM" + // "CONFIDENCE_HIGH" + SuggestionConfidence string `json:"suggestionConfidence,omitempty"` + // ForceSendFields is a list of field names (e.g. // "ClientInteractionInfo") to unconditionally include in API requests. // By default, fields with empty or default values are omitted from API @@ -141248,7 +141334,7 @@ func (s *SocialGraphWireProtoPeopleapiExtensionPeopleStackExtendedData) MarshalJ } // SocialGraphWireProtoPeopleapiExtensionPeopleStackPersonExtendedData: -// NEXT_ID: 5 +// NEXT_ID: 6 type SocialGraphWireProtoPeopleapiExtensionPeopleStackPersonExtendedData struct { // BirthdayStatus: Whether the person has birthday field populated. // @@ -141282,6 +141368,13 @@ type SocialGraphWireProtoPeopleapiExtensionPeopleStackPersonExtendedData struct // "HIDDEN" HideType string `json:"hideType,omitempty"` + // Possible values: + // "CONFIDENCE_UNSPECIFIED" + // "CONFIDENCE_LOW" + // "CONFIDENCE_MEDIUM" + // "CONFIDENCE_HIGH" + SuggestionConfidence string `json:"suggestionConfidence,omitempty"` + // ForceSendFields is a list of field names (e.g. "BirthdayStatus") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -147648,6 +147741,7 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "GEARHEAD_FRX_SENSITIVE_PERMISSION_SCREEN_SEEN" // "POST_PURCHASE_ITEM_UPSELL_SESSION_LEVEL" // "POST_PURCHASE_ITEM_UPSELL_WAVE_2_SESSION_LEVEL" + // "POST_PURCHASE_ITEM_UPSELL_WAVE_2_SESSION_LEVEL_2" // "PLAY_PASS_SIGNUP_INTERSTITIAL_SHOWN_SESSION_LEVEL" - Test code // logged on client side for users who see the Play Pass signup // interstitial. @@ -148560,6 +148654,10 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // test code for Because You Played experiments. // "LOYALTY_WEEKLY_REWARDS_ICC_FORMAT_NOW_HOME_SESSION_LEVEL" - // Session-level test code for loyalty weekly rewards in Now! home. + // "MULTILINE_SUBSCRIPTION_ADDON_TITLE_SESSION_LEVEL" - Session-level + // test code for multiline addon title. + // "PAYTM_WALLET_FAILURE_SESSION_LEVEL" - Session-level test code for + // Paytm wallet failures. // "SESSION_LEVEL_TEST_CODE_LIMIT" // "CART_ABANDONMENT_USER_LEVEL" - Cart abandonment flow for purchase // flow. @@ -148712,6 +148810,7 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // notification and had visual preview setting enabled. // "POST_PURCHASE_ITEM_UPSELL_USER_LEVEL" // "POST_PURCHASE_ITEM_UPSELL_WAVE_2_USER_LEVEL" + // "POST_PURCHASE_ITEM_UPSELL_WAVE_2_USER_LEVEL_2" // "PLAY_PASS_SIGNUP_INTERSTITIAL_SHOWN_USER_LEVEL" - Test code logged // on client side for users who see the Play Pass signup interstitial. // "DISABLE_TOPUP_EXPERIMENT_CONTROL_GROUP_USER_LEVEL" - Test codes @@ -149171,6 +149270,24 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // with high Comics app usage (e.g. >=15 in last 28d ays). // "MODERATE_COMIC_APP_USAGE_USER_LEVEL" - User-level test code for // users with high Comics app usage (e.g. >=10 in last 28d ays). + // "COMIC_SAMPLING_PICCOMA_INSTALLED_USER_LEVEL" - User-level test + // code for users who had Piccoma installed for the Comics Sampling + // Cluster Experiment. + // "COMIC_SAMPLING_MANGA_ONE_INSTALLED_USER_LEVEL" - User-level test + // code for users who had Manga One installed for the Comics Sampling + // Cluster Experiment. + // "COMIC_SAMPLING_MAGAPOKE_INSTALLED_USER_LEVEL" - User-level test + // code for users who had Magapoke installed for the Comics Sampling + // Cluster Experiment. + // "COMIC_SAMPLING_JUMP_INSTALLED_USER_LEVEL" - User-level test code + // for users who had Jump+ installed for the Comics Sampling Cluster + // Experiment. + // "COMIC_SAMPLING_LINE_MANGA_INSTALLED_USER_LEVEL" - User-level test + // code for users who had Line Manga installed for the Comics Sampling + // Cluster Experiment. + // "COMIC_SAMPLING_ANY_INSTALLED_USER_LEVEL" - User-level test code + // for users who had any of the 5 manga apps listed above installed for + // the Comics Sampling Cluster Experiment. // "REDEEM_SAVE_BUYER_SPEND_MODEL_USER_LEVEL" - User level test code // for Redeem Save buyer offer study, tracking users who actually get // different experience between control and treatment. @@ -149179,7 +149296,11 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // purchase flow. This will be used for ranking of add fop options // experiments. // "CART_ABANDONMENT_ITEM_RECOMMENDATION_USER_LEVEL" - User level test - // code for SKU Recommendation in Cart Abandonment. + // code for SKU Recommendation in Cart Abandonment, currently used for + // popular after abandon candidates. + // "CART_ABANDONMENT_ITEM_RECOMMENDATION_LOWER_PRICED_USER_LEVEL" - + // User level test code for SKU Recommendation in Cart Abandonment, + // specifically for lower-priced candidates. // "HAS_INSUFFICIENT_STORED_VALUE_BALANCE_BEFORE_RENEWAL_USER_LEVEL" - // User level test code for stored value top-up email reminder. // "IS_ELIGIBLE_FOR_ONE_CLICK_BAKCUP_FOP_IN_FIX_FLOW_USER_LEVEL" - @@ -149193,6 +149314,16 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // - User level test code for stored value top-up email reminder (V2). // "LOYALTY_WEEKLY_REWARDS_ICC_FORMAT_NOW_HOME_USER_LEVEL" - User // level test code for loyalty weekly rewards in Now! home. + // "PREREGISTRATION_SHOULD_SEE_NOTIFICATION_DIALOG_USER_LEVEL" - User + // level test code for users who should have seen preregistration + // notification dialog. + // "MULTILINE_SUBSCRIPTION_ADDON_TITLE_USER_LEVEL" - User level test + // code for multiline addon title. + // "UNIFIED_ITEM_RECOMMENDATION_USER_LEVEL" - User level test code for + // unified SKU Recommendations. Used when user is eligible for any SKU + // Recommendation, currently either cart-abandonment or post-success + // upsell. + // "UNIFIED_ITEM_RECOMMENDATION_LOWER_PRICED_USER_LEVEL" // "USER_LEVEL_TEST_CODE_LIMIT" TestCode []string `json:"testCode,omitempty"` diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index 2b305112011..10163368aa5 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -4360,7 +4360,7 @@ } } }, - "revision": "20230922", + "revision": "20231007", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -7031,6 +7031,80 @@ }, "type": "object" }, + "GoogleCloudDataplexV1GovernanceEvent": { + "description": "Payload associated with Governance related log events.", + "id": "GoogleCloudDataplexV1GovernanceEvent", + "properties": { + "entity": { + "$ref": "GoogleCloudDataplexV1GovernanceEventEntity", + "description": "Entity resource information if the log event is associated with a specific entity." + }, + "eventType": { + "description": "The type of the event.", + "enum": [ + "EVENT_TYPE_UNSPECIFIED", + "RESOURCE_IAM_POLICY_UPDATE", + "BIGQUERY_TABLE_CREATE", + "BIGQUERY_TABLE_UPDATE", + "BIGQUERY_TABLE_DELETE", + "BIGQUERY_CONNECTION_CREATE", + "BIGQUERY_CONNECTION_UPDATE", + "BIGQUERY_CONNECTION_DELETE", + "BIGQUERY_TAXONOMY_CREATE", + "BIGQUERY_POLICY_TAG_CREATE", + "BIGQUERY_POLICY_TAG_DELETE", + "BIGQUERY_POLICY_TAG_SET_IAM_POLICY", + "ACCESS_POLICY_UPDATE" + ], + "enumDescriptions": [ + "An unspecified event type.", + "Resource IAM policy update event.", + "BigQuery table create event.", + "BigQuery table update event.", + "BigQuery table delete event.", + "BigQuery connection create event.", + "BigQuery connection update event.", + "BigQuery connection delete event.", + "BigQuery taxonomy created.", + "BigQuery policy tag created.", + "BigQuery policy tag deleted.", + "BigQuery set iam policy for policy tag.", + "Access policy update event." + ], + "type": "string" + }, + "message": { + "description": "The log message.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1GovernanceEventEntity": { + "description": "Information about Entity resource that the log event is associated with.", + "id": "GoogleCloudDataplexV1GovernanceEventEntity", + "properties": { + "entity": { + "description": "The Entity resource the log event is associated with. Format: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}", + "type": "string" + }, + "entityType": { + "description": "Type of entity.", + "enum": [ + "ENTITY_TYPE_UNSPECIFIED", + "TABLE", + "FILESET" + ], + "enumDescriptions": [ + "An unspecified Entity type.", + "Table entity type.", + "Fileset entity type." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDataplexV1Job": { "description": "A job represents an instance of a task.", "id": "GoogleCloudDataplexV1Job", diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index b2671a01e6d..09805133461 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -4553,6 +4553,97 @@ func (s *GoogleCloudDataplexV1EnvironmentSessionStatus) MarshalJSON() ([]byte, e return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDataplexV1GovernanceEvent: Payload associated with +// Governance related log events. +type GoogleCloudDataplexV1GovernanceEvent struct { + // Entity: Entity resource information if the log event is associated + // with a specific entity. + Entity *GoogleCloudDataplexV1GovernanceEventEntity `json:"entity,omitempty"` + + // EventType: The type of the event. + // + // Possible values: + // "EVENT_TYPE_UNSPECIFIED" - An unspecified event type. + // "RESOURCE_IAM_POLICY_UPDATE" - Resource IAM policy update event. + // "BIGQUERY_TABLE_CREATE" - BigQuery table create event. + // "BIGQUERY_TABLE_UPDATE" - BigQuery table update event. + // "BIGQUERY_TABLE_DELETE" - BigQuery table delete event. + // "BIGQUERY_CONNECTION_CREATE" - BigQuery connection create event. + // "BIGQUERY_CONNECTION_UPDATE" - BigQuery connection update event. + // "BIGQUERY_CONNECTION_DELETE" - BigQuery connection delete event. + // "BIGQUERY_TAXONOMY_CREATE" - BigQuery taxonomy created. + // "BIGQUERY_POLICY_TAG_CREATE" - BigQuery policy tag created. + // "BIGQUERY_POLICY_TAG_DELETE" - BigQuery policy tag deleted. + // "BIGQUERY_POLICY_TAG_SET_IAM_POLICY" - BigQuery set iam policy for + // policy tag. + // "ACCESS_POLICY_UPDATE" - Access policy update event. + EventType string `json:"eventType,omitempty"` + + // Message: The log message. + Message string `json:"message,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Entity") 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. "Entity") 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 *GoogleCloudDataplexV1GovernanceEvent) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1GovernanceEvent + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDataplexV1GovernanceEventEntity: Information about Entity +// resource that the log event is associated with. +type GoogleCloudDataplexV1GovernanceEventEntity struct { + // Entity: The Entity resource the log event is associated with. Format: + // projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zone + // s/{zone_id}/entities/{entity_id} + Entity string `json:"entity,omitempty"` + + // EntityType: Type of entity. + // + // Possible values: + // "ENTITY_TYPE_UNSPECIFIED" - An unspecified Entity type. + // "TABLE" - Table entity type. + // "FILESET" - Fileset entity type. + EntityType string `json:"entityType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Entity") 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. "Entity") 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 *GoogleCloudDataplexV1GovernanceEventEntity) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1GovernanceEventEntity + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDataplexV1Job: A job represents an instance of a task. type GoogleCloudDataplexV1Job struct { // EndTime: Output only. The time when the job ended. diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index 80e930f1444..37dc9f51815 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -1564,6 +1564,66 @@ ] } } + }, + "servingConfigs": { + "methods": { + "recommend": { + "description": "Makes a recommendation, which requires a contextual user event.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:recommend", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.recommend", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. Full resource name of the format: `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` Before you can request recommendations from your model, you must create at least one serving config for it.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+servingConfig}:recommend", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaRecommendRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaRecommendResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "search": { + "description": "Performs a search.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:search", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.search", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+servingConfig}:search", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } }, @@ -2832,7 +2892,7 @@ } } }, - "revision": "20230928", + "revision": "20231003", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -5702,6 +5762,11 @@ "readOnly": true, "type": "boolean" }, + "minimumDataTermAccepted": { + "description": "Output only. Whether the customer accepted data use terms.", + "readOnly": true, + "type": "boolean" + }, "name": { "description": "Immutable. The full resource name of the widget config. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/widgetConfigs/{widget_config_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.", "type": "string" diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index 6d46ae7f3f6..3b4390b399e 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -406,6 +406,7 @@ type ProjectsLocationsCollectionsDataStoresUserEventsService struct { func NewProjectsLocationsCollectionsEnginesService(s *Service) *ProjectsLocationsCollectionsEnginesService { rs := &ProjectsLocationsCollectionsEnginesService{s: s} rs.Operations = NewProjectsLocationsCollectionsEnginesOperationsService(s) + rs.ServingConfigs = NewProjectsLocationsCollectionsEnginesServingConfigsService(s) return rs } @@ -413,6 +414,8 @@ type ProjectsLocationsCollectionsEnginesService struct { s *Service Operations *ProjectsLocationsCollectionsEnginesOperationsService + + ServingConfigs *ProjectsLocationsCollectionsEnginesServingConfigsService } func NewProjectsLocationsCollectionsEnginesOperationsService(s *Service) *ProjectsLocationsCollectionsEnginesOperationsService { @@ -424,6 +427,15 @@ type ProjectsLocationsCollectionsEnginesOperationsService struct { s *Service } +func NewProjectsLocationsCollectionsEnginesServingConfigsService(s *Service) *ProjectsLocationsCollectionsEnginesServingConfigsService { + rs := &ProjectsLocationsCollectionsEnginesServingConfigsService{s: s} + return rs +} + +type ProjectsLocationsCollectionsEnginesServingConfigsService struct { + s *Service +} + func NewProjectsLocationsCollectionsOperationsService(s *Service) *ProjectsLocationsCollectionsOperationsService { rs := &ProjectsLocationsCollectionsOperationsService{s: s} return rs @@ -5908,6 +5920,10 @@ type GoogleCloudDiscoveryengineV1alphaWidgetConfig struct { // data store. LlmEnabled bool `json:"llmEnabled,omitempty"` + // MinimumDataTermAccepted: Output only. Whether the customer accepted + // data use terms. + MinimumDataTermAccepted bool `json:"minimumDataTermAccepted,omitempty"` + // Name: Immutable. The full resource name of the widget config. Format: // `projects/{project}/locations/{location}/collections/{collection_id}/d // ataStores/{data_store_id}/widgetConfigs/{widget_config_id}`. This @@ -14111,6 +14127,326 @@ func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) Pages(ctx contex } } +// method id "discoveryengine.projects.locations.collections.engines.servingConfigs.recommend": + +type ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1alpharecommendrequest *GoogleCloudDiscoveryengineV1alphaRecommendRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Recommend: Makes a recommendation, which requires a contextual user +// event. +// +// - servingConfig: Full resource name of the format: +// `projects/*/locations/global/collections/*/dataStores/*/servingConfi +// gs/*` Before you can request recommendations from your model, you +// must create at least one serving config for it. +func (r *ProjectsLocationsCollectionsEnginesServingConfigsService) Recommend(servingConfig string, googleclouddiscoveryenginev1alpharecommendrequest *GoogleCloudDiscoveryengineV1alphaRecommendRequest) *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall { + c := &ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1alpharecommendrequest = googleclouddiscoveryenginev1alpharecommendrequest + 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 *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall) 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.googleclouddiscoveryenginev1alpharecommendrequest) + 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, "v1alpha/{+servingConfig}:recommend") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.servingConfigs.recommend" call. +// Exactly one of *GoogleCloudDiscoveryengineV1alphaRecommendResponse or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudDiscoveryengineV1alphaRecommendResponse.ServerResponse.Hea +// der 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 *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaRecommendResponse, 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, gensupport.WrapError(&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, gensupport.WrapError(err) + } + ret := &GoogleCloudDiscoveryengineV1alphaRecommendResponse{ + 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": "Makes a recommendation, which requires a contextual user event.", + // "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:recommend", + // "httpMethod": "POST", + // "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.recommend", + // "parameterOrder": [ + // "servingConfig" + // ], + // "parameters": { + // "servingConfig": { + // "description": "Required. Full resource name of the format: `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` Before you can request recommendations from your model, you must create at least one serving config for it.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+servingConfig}:recommend", + // "request": { + // "$ref": "GoogleCloudDiscoveryengineV1alphaRecommendRequest" + // }, + // "response": { + // "$ref": "GoogleCloudDiscoveryengineV1alphaRecommendResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "discoveryengine.projects.locations.collections.engines.servingConfigs.search": + +type ProjectsLocationsCollectionsEnginesServingConfigsSearchCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1alphasearchrequest *GoogleCloudDiscoveryengineV1alphaSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Search: Performs a search. +// +// - servingConfig: The resource name of the Search serving config, such +// as +// `projects/*/locations/global/collections/default_collection/dataStor +// es/default_data_store/servingConfigs/default_serving_config`. This +// field is used to identify the serving configuration name, set of +// models used to make the search. +func (r *ProjectsLocationsCollectionsEnginesServingConfigsService) Search(servingConfig string, googleclouddiscoveryenginev1alphasearchrequest *GoogleCloudDiscoveryengineV1alphaSearchRequest) *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall { + c := &ProjectsLocationsCollectionsEnginesServingConfigsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1alphasearchrequest = googleclouddiscoveryenginev1alphasearchrequest + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) 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.googleclouddiscoveryenginev1alphasearchrequest) + 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, "v1alpha/{+servingConfig}:search") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.servingConfigs.search" call. +// Exactly one of *GoogleCloudDiscoveryengineV1alphaSearchResponse or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudDiscoveryengineV1alphaSearchResponse.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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaSearchResponse, 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, gensupport.WrapError(&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, gensupport.WrapError(err) + } + ret := &GoogleCloudDiscoveryengineV1alphaSearchResponse{ + 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": "Performs a search.", + // "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:search", + // "httpMethod": "POST", + // "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.search", + // "parameterOrder": [ + // "servingConfig" + // ], + // "parameters": { + // "servingConfig": { + // "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+servingConfig}:search", + // "request": { + // "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequest" + // }, + // "response": { + // "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1alphaSearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1alphasearchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1alphasearchrequest.PageToken) // reset paging to original point + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.googleclouddiscoveryenginev1alphasearchrequest.PageToken = x.NextPageToken + } +} + // method id "discoveryengine.projects.locations.collections.operations.get": type ProjectsLocationsCollectionsOperationsGetCall struct { diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index 0381e76464d..f97249c400e 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -1390,6 +1390,66 @@ ] } } + }, + "servingConfigs": { + "methods": { + "recommend": { + "description": "Makes a recommendation, which requires a contextual user event.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:recommend", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.recommend", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. Full resource name of the format: `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` Before you can request recommendations from your model, you must create at least one serving config for it.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+servingConfig}:recommend", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaRecommendRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaRecommendResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "search": { + "description": "Performs a search.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:search", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.search", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+servingConfig}:search", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } }, @@ -2598,7 +2658,7 @@ } } }, - "revision": "20230928", + "revision": "20231003", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index 720c7073ba3..e3d86c57209 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -394,6 +394,7 @@ type ProjectsLocationsCollectionsDataStoresUserEventsService struct { func NewProjectsLocationsCollectionsEnginesService(s *Service) *ProjectsLocationsCollectionsEnginesService { rs := &ProjectsLocationsCollectionsEnginesService{s: s} rs.Operations = NewProjectsLocationsCollectionsEnginesOperationsService(s) + rs.ServingConfigs = NewProjectsLocationsCollectionsEnginesServingConfigsService(s) return rs } @@ -401,6 +402,8 @@ type ProjectsLocationsCollectionsEnginesService struct { s *Service Operations *ProjectsLocationsCollectionsEnginesOperationsService + + ServingConfigs *ProjectsLocationsCollectionsEnginesServingConfigsService } func NewProjectsLocationsCollectionsEnginesOperationsService(s *Service) *ProjectsLocationsCollectionsEnginesOperationsService { @@ -412,6 +415,15 @@ type ProjectsLocationsCollectionsEnginesOperationsService struct { s *Service } +func NewProjectsLocationsCollectionsEnginesServingConfigsService(s *Service) *ProjectsLocationsCollectionsEnginesServingConfigsService { + rs := &ProjectsLocationsCollectionsEnginesServingConfigsService{s: s} + return rs +} + +type ProjectsLocationsCollectionsEnginesServingConfigsService struct { + s *Service +} + func NewProjectsLocationsCollectionsOperationsService(s *Service) *ProjectsLocationsCollectionsOperationsService { rs := &ProjectsLocationsCollectionsOperationsService{s: s} return rs @@ -12458,6 +12470,324 @@ func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) Pages(ctx contex } } +// method id "discoveryengine.projects.locations.collections.engines.servingConfigs.recommend": + +type ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1betarecommendrequest *GoogleCloudDiscoveryengineV1betaRecommendRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Recommend: Makes a recommendation, which requires a contextual user +// event. +// +// - servingConfig: Full resource name of the format: +// `projects/*/locations/global/collections/*/dataStores/*/servingConfi +// gs/*` Before you can request recommendations from your model, you +// must create at least one serving config for it. +func (r *ProjectsLocationsCollectionsEnginesServingConfigsService) Recommend(servingConfig string, googleclouddiscoveryenginev1betarecommendrequest *GoogleCloudDiscoveryengineV1betaRecommendRequest) *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall { + c := &ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1betarecommendrequest = googleclouddiscoveryenginev1betarecommendrequest + 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 *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall) 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.googleclouddiscoveryenginev1betarecommendrequest) + 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, "v1beta/{+servingConfig}:recommend") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.servingConfigs.recommend" call. +// Exactly one of *GoogleCloudDiscoveryengineV1betaRecommendResponse or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudDiscoveryengineV1betaRecommendResponse.ServerResponse.Head +// er 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 *ProjectsLocationsCollectionsEnginesServingConfigsRecommendCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1betaRecommendResponse, 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, gensupport.WrapError(&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, gensupport.WrapError(err) + } + ret := &GoogleCloudDiscoveryengineV1betaRecommendResponse{ + 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": "Makes a recommendation, which requires a contextual user event.", + // "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:recommend", + // "httpMethod": "POST", + // "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.recommend", + // "parameterOrder": [ + // "servingConfig" + // ], + // "parameters": { + // "servingConfig": { + // "description": "Required. Full resource name of the format: `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` Before you can request recommendations from your model, you must create at least one serving config for it.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta/{+servingConfig}:recommend", + // "request": { + // "$ref": "GoogleCloudDiscoveryengineV1betaRecommendRequest" + // }, + // "response": { + // "$ref": "GoogleCloudDiscoveryengineV1betaRecommendResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "discoveryengine.projects.locations.collections.engines.servingConfigs.search": + +type ProjectsLocationsCollectionsEnginesServingConfigsSearchCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1betasearchrequest *GoogleCloudDiscoveryengineV1betaSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Search: Performs a search. +// +// - servingConfig: The resource name of the Search serving config, such +// as +// `projects/*/locations/global/collections/default_collection/dataStor +// es/default_data_store/servingConfigs/default_serving_config`. This +// field is used to identify the serving configuration name, set of +// models used to make the search. +func (r *ProjectsLocationsCollectionsEnginesServingConfigsService) Search(servingConfig string, googleclouddiscoveryenginev1betasearchrequest *GoogleCloudDiscoveryengineV1betaSearchRequest) *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall { + c := &ProjectsLocationsCollectionsEnginesServingConfigsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1betasearchrequest = googleclouddiscoveryenginev1betasearchrequest + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) 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.googleclouddiscoveryenginev1betasearchrequest) + 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, "v1beta/{+servingConfig}:search") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.servingConfigs.search" call. +// Exactly one of *GoogleCloudDiscoveryengineV1betaSearchResponse or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudDiscoveryengineV1betaSearchResponse.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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1betaSearchResponse, 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, gensupport.WrapError(&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, gensupport.WrapError(err) + } + ret := &GoogleCloudDiscoveryengineV1betaSearchResponse{ + 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": "Performs a search.", + // "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:search", + // "httpMethod": "POST", + // "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.search", + // "parameterOrder": [ + // "servingConfig" + // ], + // "parameters": { + // "servingConfig": { + // "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta/{+servingConfig}:search", + // "request": { + // "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequest" + // }, + // "response": { + // "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1betaSearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1betasearchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1betasearchrequest.PageToken) // reset paging to original point + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.googleclouddiscoveryenginev1betasearchrequest.PageToken = x.NextPageToken + } +} + // method id "discoveryengine.projects.locations.collections.operations.get": type ProjectsLocationsCollectionsOperationsGetCall struct { diff --git a/displayvideo/v1/displayvideo-api.json b/displayvideo/v1/displayvideo-api.json index 2ddad15149f..c558560f54b 100644 --- a/displayvideo/v1/displayvideo-api.json +++ b/displayvideo/v1/displayvideo-api.json @@ -3345,7 +3345,7 @@ "assignedLocations": { "methods": { "bulkEdit": { - "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in BulkEditAssignedLocationsRequest.deleted_assigned_locations and then create the assigned locations provided in BulkEditAssignedLocationsRequest.created_assigned_locations.", + "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in deletedAssignedLocations and then create the assigned locations provided in createdAssignedLocations.", "flatPath": "v1/advertisers/{advertiserId}/locationLists/{locationListsId}/assignedLocations:bulkEdit", "httpMethod": "POST", "id": "displayvideo.advertisers.locationLists.assignedLocations.bulkEdit", @@ -8146,7 +8146,7 @@ } } }, - "revision": "20230914", + "revision": "20231009", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -8488,7 +8488,7 @@ "id": "AgeRangeAssignedTargetingOptionDetails", "properties": { "ageRange": { - "description": "The age range of an audience. We only support targeting a continuous age range of an audience. Thus, the age range represented in this field can be 1) targeted solely, or, 2) part of a larger continuous age range. The reach of a continuous age range targeting can be expanded by also targeting an audience of an unknown age. Output only in v1. Required in v2.", + "description": "Required. The age range of an audience. We only support targeting a continuous age range of an audience. Thus, the age range represented in this field can be 1) targeted solely, or, 2) part of a larger continuous age range. The reach of a continuous age range targeting can be expanded by also targeting an audience of an unknown age.", "enum": [ "AGE_RANGE_UNSPECIFIED", "AGE_RANGE_18_24", @@ -8724,7 +8724,7 @@ "type": "object" }, "AssignedLocation": { - "description": "An assignment between a location list and a relevant targeting option. Currently, geo region targeting options are the only supported option for assignment.", + "description": "An assignment between a location list and a relevant targeting option.", "id": "AssignedLocation", "properties": { "assignedLocationId": { @@ -8739,7 +8739,7 @@ "type": "string" }, "targetingOptionId": { - "description": "Required. The ID of the targeting option assigned to the location list. Assigned locations can only be modified in TARGETING_LOCATION_TYPE_REGIONAL location lists. When creating or deleting assigned locations, this value must be of type TARGETING_TYPE_GEO_REGION.", + "description": "Required. The ID of the targeting option assigned to the location list.", "type": "string" } }, @@ -9153,7 +9153,7 @@ "id": "AudioContentTypeAssignedTargetingOptionDetails", "properties": { "audioContentType": { - "description": "The audio content type. Output only in v1. Required in v2.", + "description": "Required. The audio content type.", "enum": [ "AUDIO_CONTENT_TYPE_UNSPECIFIED", "AUDIO_CONTENT_TYPE_UNKNOWN", @@ -9481,14 +9481,14 @@ "id": "BulkEditAssignedLocationsRequest", "properties": { "createdAssignedLocations": { - "description": "The assigned locations to create in bulk, specified as a list of AssignedLocations.", + "description": "The assigned locations to create in bulk, specified as a list of AssignedLocation resources.", "items": { "$ref": "AssignedLocation" }, "type": "array" }, "deletedAssignedLocations": { - "description": "The IDs of the assigned locations to delete in bulk, specified as a list of assigned_location_ids.", + "description": "The IDs of the assigned locations to delete in bulk, specified as a list of assignedLocationId values.", "items": { "format": "int64", "type": "string" @@ -9499,7 +9499,6 @@ "type": "object" }, "BulkEditAssignedLocationsResponse": { - "description": "Response message for AssignedLocationService.BulkEditAssignedLocations.", "id": "BulkEditAssignedLocationsResponse", "properties": { "assignedLocations": { @@ -10502,7 +10501,7 @@ "type": "string" }, "contentInstreamPosition": { - "description": "The content instream position for video or audio ads. Output only in v1. Required in v2.", + "description": "Required. The content instream position for video or audio ads.", "enum": [ "CONTENT_INSTREAM_POSITION_UNSPECIFIED", "CONTENT_INSTREAM_POSITION_PRE_ROLL", @@ -10574,7 +10573,7 @@ "type": "string" }, "contentOutstreamPosition": { - "description": "The content outstream position. Output only in v1. Required in v2.", + "description": "Required. The content outstream position.", "enum": [ "CONTENT_OUTSTREAM_POSITION_UNSPECIFIED", "CONTENT_OUTSTREAM_POSITION_UNKNOWN", @@ -11491,7 +11490,7 @@ "type": "string" }, "errors": { - "description": "Output only. Error details of a rejected custom bidding script. This field will only be populated when Script.state is REJECTED.", + "description": "Output only. Error details of a rejected custom bidding script. This field will only be populated when state is REJECTED.", "items": { "$ref": "ScriptError" }, @@ -11836,7 +11835,7 @@ "id": "DeviceTypeAssignedTargetingOptionDetails", "properties": { "deviceType": { - "description": "The display name of the device type. Output only in v1. Required in v2.", + "description": "Required. The display name of the device type.", "enum": [ "DEVICE_TYPE_UNSPECIFIED", "DEVICE_TYPE_COMPUTER", @@ -11846,10 +11845,10 @@ ], "enumDescriptions": [ "Default value when device type is not specified in this version. This enum is a placeholder for default value and does not represent a real device type option.", - "The device type is computer.", - "The device type is connected TV.", - "The device type is smart phone..", - "The device type is tablet." + "Computer.", + "Connected TV.", + "Smart phone.", + "Tablet." ], "type": "string" }, @@ -11875,10 +11874,10 @@ ], "enumDescriptions": [ "Default value when device type is not specified in this version. This enum is a placeholder for default value and does not represent a real device type option.", - "The device type is computer.", - "The device type is connected TV.", - "The device type is smart phone..", - "The device type is tablet." + "Computer.", + "Connected TV.", + "Smart phone.", + "Tablet." ], "readOnly": true, "type": "string" @@ -12445,7 +12444,7 @@ "id": "EnvironmentAssignedTargetingOptionDetails", "properties": { "environment": { - "description": "The serving environment. Output only in v1. Required in v2.", + "description": "Required. The serving environment.", "enum": [ "ENVIRONMENT_UNSPECIFIED", "ENVIRONMENT_WEB_OPTIMIZED", @@ -13443,7 +13442,7 @@ "id": "GenderAssignedTargetingOptionDetails", "properties": { "gender": { - "description": "The gender of the audience. Output only in v1. Required in v2.", + "description": "Required. The gender of the audience.", "enum": [ "GENDER_UNSPECIFIED", "GENDER_MALE", @@ -13527,8 +13526,8 @@ "Video ads served on mobile app inventory. Line items of this type and their targeting cannot be created or updated using the API.", "RTB Audio ads sold for a variety of environments.", "Over-the-top ads present in OTT insertion orders. This type is only applicable to line items with an insertion order of insertion_order_type `OVER_THE_TOP`.", - "Digital display out of home. Line items of this type and their targeting cannot be created or updated using the API.", - "Digital video out of home. Line items of this type and their targeting cannot be created or updated using the API." + "Display ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API.", + "Video ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API." ], "type": "string" }, @@ -14090,7 +14089,7 @@ "id": "HouseholdIncomeAssignedTargetingOptionDetails", "properties": { "householdIncome": { - "description": "The household income of the audience. Output only in v1. Required in v2.", + "description": "Required. The household income of the audience.", "enum": [ "HOUSEHOLD_INCOME_UNSPECIFIED", "HOUSEHOLD_INCOME_UNKNOWN", @@ -14364,9 +14363,9 @@ ], "enumDescriptions": [ "Insertion order automation option is not specified or is unknown in this version.", - "Automatic budget allocation. Allow the system to automatically shift budget to owning line items to optimize performance defined by performance_goal. No automation on bid settings.", + "Automatic budget allocation. Allow the system to automatically shift budget to owning line items to optimize performance defined by kpi. No automation on bid settings.", "No automation of bid or budget on insertion order level. Bid and budget must be manually configured at the line item level.", - "Allow the system to automatically adjust bids and shift budget to owning line items to optimize performance defined by performance_goal." + "Allow the system to automatically adjust bids and shift budget to owning line items to optimize performance defined by kpi." ], "type": "string" }, @@ -15421,8 +15420,8 @@ "Video ads served on mobile app inventory. Line items of this type and their targeting cannot be created or updated using the API.", "RTB Audio ads sold for a variety of environments.", "Over-the-top ads present in OTT insertion orders. This type is only applicable to line items with an insertion order of insertion_order_type `OVER_THE_TOP`.", - "Digital display out of home. Line items of this type and their targeting cannot be created or updated using the API.", - "Digital video out of home. Line items of this type and their targeting cannot be created or updated using the API." + "Display ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API.", + "Video ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API." ], "type": "string" }, @@ -16399,7 +16398,7 @@ "id": "NativeContentPositionAssignedTargetingOptionDetails", "properties": { "contentPosition": { - "description": "The content position. Output only in v1. Required in v2.", + "description": "Required. The content position.", "enum": [ "NATIVE_CONTENT_POSITION_UNSPECIFIED", "NATIVE_CONTENT_POSITION_UNKNOWN", @@ -16573,7 +16572,7 @@ "id": "OmidAssignedTargetingOptionDetails", "properties": { "omid": { - "description": "The type of Open Measurement enabled inventory. Output only in v1. Required in v2.", + "description": "Required. The type of Open Measurement enabled inventory.", "enum": [ "OMID_UNSPECIFIED", "OMID_FOR_MOBILE_DISPLAY_ADS" @@ -16762,7 +16761,7 @@ "type": "string" }, "pacingPeriod": { - "description": "Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via auto_budget_allocation, this field is output only and defaults to `PACING_PERIOD_FLIGHT`.", + "description": "Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via automationType, this field is output only and defaults to `PACING_PERIOD_FLIGHT`.", "enum": [ "PACING_PERIOD_UNSPECIFIED", "PACING_PERIOD_DAILY", @@ -16861,7 +16860,7 @@ "id": "ParentalStatusAssignedTargetingOptionDetails", "properties": { "parentalStatus": { - "description": "The parental status of the audience. Output only in v1. Required in v2.", + "description": "Required. The parental status of the audience.", "enum": [ "PARENTAL_STATUS_UNSPECIFIED", "PARENTAL_STATUS_PARENT", @@ -17159,7 +17158,7 @@ "type": "object" }, "PerformanceGoal": { - "description": "Settings that control the performance goal of a campaign or insertion order.", + "description": "Settings that control the performance goal of a campaign.", "id": "PerformanceGoal", "properties": { "performanceGoalAmountMicros": { @@ -18653,7 +18652,7 @@ "type": "string" }, "videoPlayerSize": { - "description": "The video player size. Output only in v1. Required in v2.", + "description": "Required. The video player size.", "enum": [ "VIDEO_PLAYER_SIZE_UNSPECIFIED", "VIDEO_PLAYER_SIZE_SMALL", @@ -18708,7 +18707,7 @@ "type": "string" }, "viewability": { - "description": "The predicted viewability percentage. Output only in v1. Required in v2.", + "description": "Required. The predicted viewability percentage.", "enum": [ "VIEWABILITY_UNSPECIFIED", "VIEWABILITY_10_PERCENT_OR_MORE", diff --git a/displayvideo/v1/displayvideo-gen.go b/displayvideo/v1/displayvideo-gen.go index 9abcd5ce3c8..e0853667c01 100644 --- a/displayvideo/v1/displayvideo-gen.go +++ b/displayvideo/v1/displayvideo-gen.go @@ -1199,12 +1199,12 @@ func (s *AdvertiserTargetingConfig) MarshalJSON() ([]byte, error) { // AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_AGE_RANGE`. type AgeRangeAssignedTargetingOptionDetails struct { - // AgeRange: The age range of an audience. We only support targeting a - // continuous age range of an audience. Thus, the age range represented - // in this field can be 1) targeted solely, or, 2) part of a larger - // continuous age range. The reach of a continuous age range targeting - // can be expanded by also targeting an audience of an unknown age. - // Output only in v1. Required in v2. + // AgeRange: Required. The age range of an audience. We only support + // targeting a continuous age range of an audience. Thus, the age range + // represented in this field can be 1) targeted solely, or, 2) part of a + // larger continuous age range. The reach of a continuous age range + // targeting can be expanded by also targeting an audience of an unknown + // age. // // Possible values: // "AGE_RANGE_UNSPECIFIED" - Default value when age range is not @@ -1606,8 +1606,7 @@ func (s *AssignedInventorySource) MarshalJSON() ([]byte, error) { } // AssignedLocation: An assignment between a location list and a -// relevant targeting option. Currently, geo region targeting options -// are the only supported option for assignment. +// relevant targeting option. type AssignedLocation struct { // AssignedLocationId: Output only. The unique ID of the assigned // location. The ID is only unique within a location list. It may be @@ -1618,10 +1617,7 @@ type AssignedLocation struct { Name string `json:"name,omitempty"` // TargetingOptionId: Required. The ID of the targeting option assigned - // to the location list. Assigned locations can only be modified in - // TARGETING_LOCATION_TYPE_REGIONAL location lists. When creating or - // deleting assigned locations, this value must be of type - // TARGETING_TYPE_GEO_REGION. + // to the location list. TargetingOptionId string `json:"targetingOptionId,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2202,8 +2198,7 @@ func (s *AudienceGroupAssignedTargetingOptionDetails) MarshalJSON() ([]byte, err // is not supported. Remove all audio content type targeting options to // achieve this effect. type AudioContentTypeAssignedTargetingOptionDetails struct { - // AudioContentType: The audio content type. Output only in v1. Required - // in v2. + // AudioContentType: Required. The audio content type. // // Possible values: // "AUDIO_CONTENT_TYPE_UNSPECIFIED" - Audio content type is not @@ -2841,11 +2836,11 @@ func (s *BulkEditAssignedInventorySourcesResponse) MarshalJSON() ([]byte, error) // AssignedLocationService.BulkEditAssignedLocations. type BulkEditAssignedLocationsRequest struct { // CreatedAssignedLocations: The assigned locations to create in bulk, - // specified as a list of AssignedLocations. + // specified as a list of AssignedLocation resources. CreatedAssignedLocations []*AssignedLocation `json:"createdAssignedLocations,omitempty"` // DeletedAssignedLocations: The IDs of the assigned locations to delete - // in bulk, specified as a list of assigned_location_ids. + // in bulk, specified as a list of assignedLocationId values. DeletedAssignedLocations googleapi.Int64s `json:"deletedAssignedLocations,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2873,8 +2868,6 @@ func (s *BulkEditAssignedLocationsRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// BulkEditAssignedLocationsResponse: Response message for -// AssignedLocationService.BulkEditAssignedLocations. type BulkEditAssignedLocationsResponse struct { // AssignedLocations: The list of assigned locations that have been // successfully created. This list will be absent if empty. @@ -4597,8 +4590,8 @@ type ContentInstreamPositionAssignedTargetingOptionDetails struct { // audio content. AdType string `json:"adType,omitempty"` - // ContentInstreamPosition: The content instream position for video or - // audio ads. Output only in v1. Required in v2. + // ContentInstreamPosition: Required. The content instream position for + // video or audio ads. // // Possible values: // "CONTENT_INSTREAM_POSITION_UNSPECIFIED" - Content instream position @@ -4711,8 +4704,7 @@ type ContentOutstreamPositionAssignedTargetingOptionDetails struct { // audio content. AdType string `json:"adType,omitempty"` - // ContentOutstreamPosition: The content outstream position. Output only - // in v1. Required in v2. + // ContentOutstreamPosition: Required. The content outstream position. // // Possible values: // "CONTENT_OUTSTREAM_POSITION_UNSPECIFIED" - Content outstream @@ -5949,8 +5941,7 @@ type CustomBiddingScript struct { CustomBiddingScriptId int64 `json:"customBiddingScriptId,omitempty,string"` // Errors: Output only. Error details of a rejected custom bidding - // script. This field will only be populated when Script.state is - // REJECTED. + // script. This field will only be populated when state is REJECTED. Errors []*ScriptError `json:"errors,omitempty"` // Name: Output only. The resource name of the custom bidding script. @@ -6494,17 +6485,16 @@ func (s *DeviceMakeModelTargetingOptionDetails) MarshalJSON() ([]byte, error) { // AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_DEVICE_TYPE`. type DeviceTypeAssignedTargetingOptionDetails struct { - // DeviceType: The display name of the device type. Output only in v1. - // Required in v2. + // DeviceType: Required. The display name of the device type. // // Possible values: // "DEVICE_TYPE_UNSPECIFIED" - Default value when device type is not // specified in this version. This enum is a placeholder for default // value and does not represent a real device type option. - // "DEVICE_TYPE_COMPUTER" - The device type is computer. - // "DEVICE_TYPE_CONNECTED_TV" - The device type is connected TV. - // "DEVICE_TYPE_SMART_PHONE" - The device type is smart phone.. - // "DEVICE_TYPE_TABLET" - The device type is tablet. + // "DEVICE_TYPE_COMPUTER" - Computer. + // "DEVICE_TYPE_CONNECTED_TV" - Connected TV. + // "DEVICE_TYPE_SMART_PHONE" - Smart phone. + // "DEVICE_TYPE_TABLET" - Tablet. DeviceType string `json:"deviceType,omitempty"` // TargetingOptionId: Required. ID of the device type. @@ -6543,10 +6533,10 @@ type DeviceTypeTargetingOptionDetails struct { // "DEVICE_TYPE_UNSPECIFIED" - Default value when device type is not // specified in this version. This enum is a placeholder for default // value and does not represent a real device type option. - // "DEVICE_TYPE_COMPUTER" - The device type is computer. - // "DEVICE_TYPE_CONNECTED_TV" - The device type is connected TV. - // "DEVICE_TYPE_SMART_PHONE" - The device type is smart phone.. - // "DEVICE_TYPE_TABLET" - The device type is tablet. + // "DEVICE_TYPE_COMPUTER" - Computer. + // "DEVICE_TYPE_CONNECTED_TV" - Connected TV. + // "DEVICE_TYPE_SMART_PHONE" - Smart phone. + // "DEVICE_TYPE_TABLET" - Tablet. DeviceType string `json:"deviceType,omitempty"` // ForceSendFields is a list of field names (e.g. "DeviceType") to @@ -7338,8 +7328,7 @@ type Empty struct { // of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_ENVIRONMENT`. type EnvironmentAssignedTargetingOptionDetails struct { - // Environment: The serving environment. Output only in v1. Required in - // v2. + // Environment: Required. The serving environment. // // Possible values: // "ENVIRONMENT_UNSPECIFIED" - Default value when environment is not @@ -8349,8 +8338,7 @@ func (s *FrequencyCap) MarshalJSON() ([]byte, error) { // AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_GENDER`. type GenderAssignedTargetingOptionDetails struct { - // Gender: The gender of the audience. Output only in v1. Required in - // v2. + // Gender: Required. The gender of the audience. // // Possible values: // "GENDER_UNSPECIFIED" - Default value when gender is not specified @@ -8462,12 +8450,12 @@ type GenerateDefaultLineItemRequest struct { // "LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP" - Over-the-top ads present in // OTT insertion orders. This type is only applicable to line items with // an insertion order of insertion_order_type `OVER_THE_TOP`. - // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Digital display out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. - // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Digital video out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. + // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Display ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. + // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Video ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. LineItemType string `json:"lineItemType,omitempty"` // MobileApp: The mobile app promoted by the line item. This is @@ -9094,8 +9082,7 @@ func (s *GuaranteedOrderStatus) MarshalJSON() ([]byte, error) { // details field of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_HOUSEHOLD_INCOME`. type HouseholdIncomeAssignedTargetingOptionDetails struct { - // HouseholdIncome: The household income of the audience. Output only in - // v1. Required in v2. + // HouseholdIncome: Required. The household income of the audience. // // Possible values: // "HOUSEHOLD_INCOME_UNSPECIFIED" - Default value when household @@ -9405,14 +9392,14 @@ type InsertionOrderBudget struct { // automation option is not specified or is unknown in this version. // "INSERTION_ORDER_AUTOMATION_TYPE_BUDGET" - Automatic budget // allocation. Allow the system to automatically shift budget to owning - // line items to optimize performance defined by performance_goal. No - // automation on bid settings. + // line items to optimize performance defined by kpi. No automation on + // bid settings. // "INSERTION_ORDER_AUTOMATION_TYPE_NONE" - No automation of bid or // budget on insertion order level. Bid and budget must be manually // configured at the line item level. // "INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET" - Allow the system to // automatically adjust bids and shift budget to owning line items to - // optimize performance defined by performance_goal. + // optimize performance defined by kpi. AutomationType string `json:"automationType,omitempty"` // BudgetSegments: Required. The list of budget segments. Use a budget @@ -10672,12 +10659,12 @@ type LineItem struct { // "LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP" - Over-the-top ads present in // OTT insertion orders. This type is only applicable to line items with // an insertion order of insertion_order_type `OVER_THE_TOP`. - // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Digital display out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. - // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Digital video out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. + // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Display ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. + // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Video ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. LineItemType string `json:"lineItemType,omitempty"` // MobileApp: The mobile app promoted by the line item. This is @@ -12564,8 +12551,7 @@ func (s *Money) MarshalJSON() ([]byte, error) { // Explicitly targeting all options is not supported. Remove all native // content position targeting options to achieve this effect. type NativeContentPositionAssignedTargetingOptionDetails struct { - // ContentPosition: The content position. Output only in v1. Required in - // v2. + // ContentPosition: Required. The content position. // // Possible values: // "NATIVE_CONTENT_POSITION_UNSPECIFIED" - Native content position is @@ -12863,8 +12849,7 @@ func (s *ObaIcon) MarshalJSON() ([]byte, error) { // details field of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_OMID`. type OmidAssignedTargetingOptionDetails struct { - // Omid: The type of Open Measurement enabled inventory. Output only in - // v1. Required in v2. + // Omid: Required. The type of Open Measurement enabled inventory. // // Possible values: // "OMID_UNSPECIFIED" - Default value when omid targeting is not @@ -13197,8 +13182,8 @@ type Pacing struct { // PacingPeriod: Required. The time period in which the pacing budget // will be spent. When automatic budget allocation is enabled at the - // insertion order via auto_budget_allocation, this field is output only - // and defaults to `PACING_PERIOD_FLIGHT`. + // insertion order via automationType, this field is output only and + // defaults to `PACING_PERIOD_FLIGHT`. // // Possible values: // "PACING_PERIOD_UNSPECIFIED" - Period value is not specified or is @@ -13327,8 +13312,7 @@ func (s *ParentEntityFilter) MarshalJSON() ([]byte, error) { // details field of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_PARENTAL_STATUS`. type ParentalStatusAssignedTargetingOptionDetails struct { - // ParentalStatus: The parental status of the audience. Output only in - // v1. Required in v2. + // ParentalStatus: Required. The parental status of the audience. // // Possible values: // "PARENTAL_STATUS_UNSPECIFIED" - Default value when parental status @@ -13776,7 +13760,7 @@ func (s *PartnerRevenueModel) MarshalJSON() ([]byte, error) { } // PerformanceGoal: Settings that control the performance goal of a -// campaign or insertion order. +// campaign. type PerformanceGoal struct { // PerformanceGoalAmountMicros: The goal amount, in micros of the // advertiser's currency. Applicable when performance_goal_type is one @@ -16041,8 +16025,7 @@ type VideoPlayerSizeAssignedTargetingOptionDetails struct { // targeting_type is `TARGETING_TYPE_VIDEO_PLAYER_SIZE`. TargetingOptionId string `json:"targetingOptionId,omitempty"` - // VideoPlayerSize: The video player size. Output only in v1. Required - // in v2. + // VideoPlayerSize: Required. The video player size. // // Possible values: // "VIDEO_PLAYER_SIZE_UNSPECIFIED" - Video player size is not @@ -16142,8 +16125,7 @@ type ViewabilityAssignedTargetingOptionDetails struct { // for targeting the `VIEWABILITY_10_PERCENT_OR_MORE` option). TargetingOptionId string `json:"targetingOptionId,omitempty"` - // Viewability: The predicted viewability percentage. Output only in v1. - // Required in v2. + // Viewability: Required. The predicted viewability percentage. // // Possible values: // "VIEWABILITY_UNSPECIFIED" - Default value when viewability is not @@ -27982,10 +27964,8 @@ type AdvertisersLocationListsAssignedLocationsBulkEditCall struct { // BulkEdit: Bulk edits multiple assignments between locations and a // single location list. The operation will delete the assigned -// locations provided in -// BulkEditAssignedLocationsRequest.deleted_assigned_locations and then -// create the assigned locations provided in -// BulkEditAssignedLocationsRequest.created_assigned_locations. +// locations provided in deletedAssignedLocations and then create the +// assigned locations provided in createdAssignedLocations. // // - advertiserId: The ID of the DV360 advertiser to which the location // list belongs. @@ -28092,7 +28072,7 @@ func (c *AdvertisersLocationListsAssignedLocationsBulkEditCall) Do(opts ...googl } return ret, nil // { - // "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in BulkEditAssignedLocationsRequest.deleted_assigned_locations and then create the assigned locations provided in BulkEditAssignedLocationsRequest.created_assigned_locations.", + // "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in deletedAssignedLocations and then create the assigned locations provided in createdAssignedLocations.", // "flatPath": "v1/advertisers/{advertiserId}/locationLists/{locationListsId}/assignedLocations:bulkEdit", // "httpMethod": "POST", // "id": "displayvideo.advertisers.locationLists.assignedLocations.bulkEdit", diff --git a/displayvideo/v2/displayvideo-api.json b/displayvideo/v2/displayvideo-api.json index 41ed926126a..ccd4bb2aadf 100644 --- a/displayvideo/v2/displayvideo-api.json +++ b/displayvideo/v2/displayvideo-api.json @@ -3750,7 +3750,7 @@ "assignedLocations": { "methods": { "bulkEdit": { - "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in BulkEditAssignedLocationsRequest.deleted_assigned_locations and then create the assigned locations provided in BulkEditAssignedLocationsRequest.created_assigned_locations.", + "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in deletedAssignedLocations and then create the assigned locations provided in createdAssignedLocations.", "flatPath": "v2/advertisers/{advertiserId}/locationLists/{locationListsId}/assignedLocations:bulkEdit", "httpMethod": "POST", "id": "displayvideo.advertisers.locationLists.assignedLocations.bulkEdit", @@ -5236,7 +5236,7 @@ "youtubeAdGroups": { "methods": { "bulkListAdGroupAssignedTargetingOptions": { - "description": "Lists assigned targeting options for multiple YouTube ad groups across targeting types. Inherieted assigned targeting options are not included.", + "description": "Lists assigned targeting options for multiple YouTube ad groups across targeting types. Inherited assigned targeting options are not included.", "flatPath": "v2/advertisers/{advertisersId}/youtubeAdGroups:bulkListAdGroupAssignedTargetingOptions", "httpMethod": "GET", "id": "displayvideo.advertisers.youtubeAdGroups.bulkListAdGroupAssignedTargetingOptions", @@ -5258,7 +5258,7 @@ "type": "string" }, "orderBy": { - "description": "Optional. Field by which to sort the list. Acceptable values are: * `youtubeAdGroupId` (acceptable in v2) * `adGroupId` (acceptable in v3) * `assignedTargetingOption.targetingType` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `targetingType desc`.", + "description": "Optional. Field by which to sort the list. Acceptable values are: * `adGroupId` (default) * `assignedTargetingOption.targetingType` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `targetingType desc`.", "location": "query", "type": "string" }, @@ -9172,7 +9172,7 @@ } } }, - "revision": "20230921", + "revision": "20231009", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -9377,7 +9377,7 @@ }, "billingConfig": { "$ref": "AdvertiserBillingConfig", - "description": "Billing related settings of the advertiser." + "description": "Required. Billing related settings of the advertiser." }, "creativeConfig": { "$ref": "AdvertiserCreativeConfig", @@ -9466,7 +9466,7 @@ "id": "AdvertiserBillingConfig", "properties": { "billingProfileId": { - "description": "The ID of a billing profile assigned to the advertiser. This field will default to the default billing profile ID of the advertiser's parent partner if a value is not provided.", + "description": "The ID of a billing profile assigned to the advertiser.", "format": "int64", "type": "string" } @@ -9559,7 +9559,7 @@ "id": "AgeRangeAssignedTargetingOptionDetails", "properties": { "ageRange": { - "description": "The age range of an audience. We only support targeting a continuous age range of an audience. Thus, the age range represented in this field can be 1) targeted solely, or, 2) part of a larger continuous age range. The reach of a continuous age range targeting can be expanded by also targeting an audience of an unknown age. Output only in v1. Required in v2.", + "description": "Required. The age range of an audience. We only support targeting a continuous age range of an audience. Thus, the age range represented in this field can be 1) targeted solely, or, 2) part of a larger continuous age range. The reach of a continuous age range targeting can be expanded by also targeting an audience of an unknown age.", "enum": [ "AGE_RANGE_UNSPECIFIED", "AGE_RANGE_18_24", @@ -9831,7 +9831,7 @@ "type": "object" }, "AssignedLocation": { - "description": "An assignment between a location list and a relevant targeting option. Currently, geo region targeting options are the only supported option for assignment.", + "description": "An assignment between a location list and a relevant targeting option.", "id": "AssignedLocation", "properties": { "assignedLocationId": { @@ -9846,7 +9846,7 @@ "type": "string" }, "targetingOptionId": { - "description": "Required. The ID of the targeting option assigned to the location list. Assigned locations can only be modified in TARGETING_LOCATION_TYPE_REGIONAL location lists. When creating or deleting assigned locations, this value must be of type TARGETING_TYPE_GEO_REGION.", + "description": "Required. The ID of the targeting option assigned to the location list.", "type": "string" } }, @@ -10306,7 +10306,7 @@ "id": "AudioContentTypeAssignedTargetingOptionDetails", "properties": { "audioContentType": { - "description": "The audio content type. Output only in v1. Required in v2.", + "description": "Required. The audio content type.", "enum": [ "AUDIO_CONTENT_TYPE_UNSPECIFIED", "AUDIO_CONTENT_TYPE_UNKNOWN", @@ -10630,14 +10630,14 @@ "id": "BulkEditAssignedLocationsRequest", "properties": { "createdAssignedLocations": { - "description": "The assigned locations to create in bulk, specified as a list of AssignedLocations.", + "description": "The assigned locations to create in bulk, specified as a list of AssignedLocation resources.", "items": { "$ref": "AssignedLocation" }, "type": "array" }, "deletedAssignedLocations": { - "description": "The IDs of the assigned locations to delete in bulk, specified as a list of assigned_location_ids.", + "description": "The IDs of the assigned locations to delete in bulk, specified as a list of assignedLocationId values.", "items": { "format": "int64", "type": "string" @@ -10648,7 +10648,6 @@ "type": "object" }, "BulkEditAssignedLocationsResponse": { - "description": "Response message for AssignedLocationService.BulkEditAssignedLocations.", "id": "BulkEditAssignedLocationsResponse", "properties": { "assignedLocations": { @@ -10873,7 +10872,7 @@ "id": "BulkListAdGroupAssignedTargetingOptionsResponse", "properties": { "nextPageToken": { - "description": "A token identifying the next page of results. This value should be specified as the pageToken in a subsequent call to `BulkListAdGroupAssignedTargetingOptions` to fetch the next page of results. This token will be absent if there are no more youtube_ad_group_assigned_targeting_options or ad_group_assigned_targeting_options to return.", + "description": "A token identifying the next page of results. This value should be specified as the pageToken in a subsequent call to `BulkListAdGroupAssignedTargetingOptions` to fetch the next page of results. This token will be absent if there are no more AdGroupAssignedTargetingOption resources to return.", "type": "string" }, "youtubeAdGroupAssignedTargetingOptions": { @@ -11802,7 +11801,7 @@ "type": "string" }, "contentInstreamPosition": { - "description": "The content instream position for video or audio ads. Output only in v1. Required in v2.", + "description": "Required. The content instream position for video or audio ads.", "enum": [ "CONTENT_INSTREAM_POSITION_UNSPECIFIED", "CONTENT_INSTREAM_POSITION_PRE_ROLL", @@ -11870,7 +11869,7 @@ "type": "string" }, "contentOutstreamPosition": { - "description": "The content outstream position. Output only in v1. Required in v2.", + "description": "Required. The content outstream position.", "enum": [ "CONTENT_OUTSTREAM_POSITION_UNSPECIFIED", "CONTENT_OUTSTREAM_POSITION_UNKNOWN", @@ -12789,7 +12788,7 @@ "type": "string" }, "errors": { - "description": "Output only. Error details of a rejected custom bidding script. This field will only be populated when Script.state is REJECTED.", + "description": "Output only. Error details of a rejected custom bidding script. This field will only be populated when state is REJECTED.", "items": { "$ref": "ScriptError" }, @@ -13171,7 +13170,7 @@ "id": "DeviceTypeAssignedTargetingOptionDetails", "properties": { "deviceType": { - "description": "The display name of the device type. Output only in v1. Required in v2.", + "description": "Required. The display name of the device type.", "enum": [ "DEVICE_TYPE_UNSPECIFIED", "DEVICE_TYPE_COMPUTER", @@ -13181,10 +13180,10 @@ ], "enumDescriptions": [ "Default value when device type is not specified in this version. This enum is a placeholder for default value and does not represent a real device type option.", - "The device type is computer.", - "The device type is connected TV.", - "The device type is smart phone..", - "The device type is tablet." + "Computer.", + "Connected TV.", + "Smart phone.", + "Tablet." ], "type": "string" }, @@ -13212,10 +13211,10 @@ ], "enumDescriptions": [ "Default value when device type is not specified in this version. This enum is a placeholder for default value and does not represent a real device type option.", - "The device type is computer.", - "The device type is connected TV.", - "The device type is smart phone..", - "The device type is tablet." + "Computer.", + "Connected TV.", + "Smart phone.", + "Tablet." ], "readOnly": true, "type": "string" @@ -13815,7 +13814,7 @@ "id": "EnvironmentAssignedTargetingOptionDetails", "properties": { "environment": { - "description": "The serving environment. Output only in v1. Required in v2.", + "description": "Required. The serving environment.", "enum": [ "ENVIRONMENT_UNSPECIFIED", "ENVIRONMENT_WEB_OPTIMIZED", @@ -14968,7 +14967,7 @@ "id": "GenderAssignedTargetingOptionDetails", "properties": { "gender": { - "description": "The gender of the audience. Output only in v1. Required in v2.", + "description": "Required. The gender of the audience.", "enum": [ "GENDER_UNSPECIFIED", "GENDER_MALE", @@ -15070,8 +15069,8 @@ "Connected TV default YouTube video ads. Only include in-stream ad-format. Line items of this type and their targeting cannot be created or updated using the API.", "The goal of this line item type is to show the YouTube ads target number of times to the same person in a certain period of time. Line items of this type and their targeting cannot be created or updated using the API.", "YouTube video ads that aim to get more views with a variety of ad formats. Line items of this type and their targeting cannot be created or updated using the API.", - "Digital display out of home. Line items of this type and their targeting cannot be created or updated using the API.", - "Digital video out of home. Line items of this type and their targeting cannot be created or updated using the API." + "Display ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API.", + "Video ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API." ], "type": "string" }, @@ -15633,7 +15632,7 @@ "id": "HouseholdIncomeAssignedTargetingOptionDetails", "properties": { "householdIncome": { - "description": "The household income of the audience. Output only in v1. Required in v2.", + "description": "Required. The household income of the audience.", "enum": [ "HOUSEHOLD_INCOME_UNSPECIFIED", "HOUSEHOLD_INCOME_UNKNOWN", @@ -15945,9 +15944,9 @@ ], "enumDescriptions": [ "Insertion order automation option is not specified or is unknown in this version.", - "Automatic budget allocation. Allow the system to automatically shift budget to owning line items to optimize performance defined by performance_goal. No automation on bid settings.", + "Automatic budget allocation. Allow the system to automatically shift budget to owning line items to optimize performance defined by kpi. No automation on bid settings.", "No automation of bid or budget on insertion order level. Bid and budget must be manually configured at the line item level.", - "Allow the system to automatically adjust bids and shift budget to owning line items to optimize performance defined by performance_goal." + "Allow the system to automatically adjust bids and shift budget to owning line items to optimize performance defined by kpi." ], "type": "string" }, @@ -17016,8 +17015,8 @@ "Connected TV default YouTube video ads. Only include in-stream ad-format. Line items of this type and their targeting cannot be created or updated using the API.", "The goal of this line item type is to show the YouTube ads target number of times to the same person in a certain period of time. Line items of this type and their targeting cannot be created or updated using the API.", "YouTube video ads that aim to get more views with a variety of ad formats. Line items of this type and their targeting cannot be created or updated using the API.", - "Digital display out of home. Line items of this type and their targeting cannot be created or updated using the API.", - "Digital video out of home. Line items of this type and their targeting cannot be created or updated using the API." + "Display ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API.", + "Video ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API." ], "type": "string" }, @@ -18116,7 +18115,7 @@ "id": "NativeContentPositionAssignedTargetingOptionDetails", "properties": { "contentPosition": { - "description": "The content position. Output only in v1. Required in v2.", + "description": "Required. The content position.", "enum": [ "NATIVE_CONTENT_POSITION_UNSPECIFIED", "NATIVE_CONTENT_POSITION_UNKNOWN", @@ -18304,7 +18303,7 @@ "id": "OmidAssignedTargetingOptionDetails", "properties": { "omid": { - "description": "The type of Open Measurement enabled inventory. Output only in v1. Required in v2.", + "description": "Required. The type of Open Measurement enabled inventory.", "enum": [ "OMID_UNSPECIFIED", "OMID_FOR_MOBILE_DISPLAY_ADS" @@ -18489,7 +18488,7 @@ "type": "string" }, "pacingPeriod": { - "description": "Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via auto_budget_allocation, this field is output only and defaults to `PACING_PERIOD_FLIGHT`.", + "description": "Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via automationType, this field is output only and defaults to `PACING_PERIOD_FLIGHT`.", "enum": [ "PACING_PERIOD_UNSPECIFIED", "PACING_PERIOD_DAILY", @@ -18588,7 +18587,7 @@ "id": "ParentalStatusAssignedTargetingOptionDetails", "properties": { "parentalStatus": { - "description": "The parental status of the audience. Output only in v1. Required in v2.", + "description": "Required. The parental status of the audience.", "enum": [ "PARENTAL_STATUS_UNSPECIFIED", "PARENTAL_STATUS_PARENT", @@ -18882,7 +18881,7 @@ "type": "object" }, "PerformanceGoal": { - "description": "Settings that control the performance goal of a campaign or insertion order.", + "description": "Settings that control the performance goal of a campaign.", "id": "PerformanceGoal", "properties": { "performanceGoalAmountMicros": { @@ -20717,7 +20716,7 @@ "id": "VideoPlayerSizeAssignedTargetingOptionDetails", "properties": { "videoPlayerSize": { - "description": "The video player size. Output only in v1. Required in v2.", + "description": "Required. The video player size.", "enum": [ "VIDEO_PLAYER_SIZE_UNSPECIFIED", "VIDEO_PLAYER_SIZE_SMALL", @@ -20768,7 +20767,7 @@ "id": "ViewabilityAssignedTargetingOptionDetails", "properties": { "viewability": { - "description": "The predicted viewability percentage. Output only in v1. Required in v2.", + "description": "Required. The predicted viewability percentage.", "enum": [ "VIEWABILITY_UNSPECIFIED", "VIEWABILITY_10_PERCENT_OR_MORE", @@ -21020,7 +21019,7 @@ "type": "object" }, "YoutubeAdGroupAssignedTargetingOption": { - "description": "Wrapper object associating an assigned_targeting_option resource and the youtube ad group it is assigned to.", + "description": "Wrapper object associating an AssignedTargetingOption resource and the youtube ad group it is assigned to.", "id": "YoutubeAdGroupAssignedTargetingOption", "properties": { "assignedTargetingOption": { @@ -21040,7 +21039,7 @@ "id": "YoutubeAndPartnersBiddingStrategy", "properties": { "adGroupEffectiveTargetCpaSource": { - "description": "Output only. Source of the effective targetCpa value for AdGroup.", + "description": "Output only. Source of the effective target CPA value for ad group.", "enum": [ "BIDDING_SOURCE_UNSPECIFIED", "BIDDING_SOURCE_LINE_ITEM", @@ -21049,13 +21048,13 @@ "enumDescriptions": [ "Bidding source is not specified or unknown.", "Bidding value is inherited from the line item.", - "Bidding value is defined on the ad group." + "Bidding value is defined in the ad group." ], "readOnly": true, "type": "string" }, "adGroupEffectiveTargetCpaValue": { - "description": "Output only. The effective targetCpa for AdGroup, in micros of advertiser's currency.", + "description": "Output only. The effective target CPA for ad group, in micros of advertiser's currency.", "format": "int64", "readOnly": true, "type": "string" diff --git a/displayvideo/v2/displayvideo-gen.go b/displayvideo/v2/displayvideo-gen.go index 81cf29d502b..4faf3344c3e 100644 --- a/displayvideo/v2/displayvideo-gen.go +++ b/displayvideo/v2/displayvideo-gen.go @@ -943,7 +943,7 @@ type Advertiser struct { // by the system. AdvertiserId int64 `json:"advertiserId,omitempty,string"` - // BillingConfig: Billing related settings of the advertiser. + // BillingConfig: Required. Billing related settings of the advertiser. BillingConfig *AdvertiserBillingConfig `json:"billingConfig,omitempty"` // CreativeConfig: Required. Creative related settings of the @@ -1079,8 +1079,7 @@ func (s *AdvertiserAdServerConfig) MarshalJSON() ([]byte, error) { // AdvertiserBillingConfig: Billing related settings of an advertiser. type AdvertiserBillingConfig struct { // BillingProfileId: The ID of a billing profile assigned to the - // advertiser. This field will default to the default billing profile ID - // of the advertiser's parent partner if a value is not provided. + // advertiser. BillingProfileId int64 `json:"billingProfileId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "BillingProfileId") to @@ -1324,12 +1323,12 @@ func (s *AdvertiserTargetingConfig) MarshalJSON() ([]byte, error) { // AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_AGE_RANGE`. type AgeRangeAssignedTargetingOptionDetails struct { - // AgeRange: The age range of an audience. We only support targeting a - // continuous age range of an audience. Thus, the age range represented - // in this field can be 1) targeted solely, or, 2) part of a larger - // continuous age range. The reach of a continuous age range targeting - // can be expanded by also targeting an audience of an unknown age. - // Output only in v1. Required in v2. + // AgeRange: Required. The age range of an audience. We only support + // targeting a continuous age range of an audience. Thus, the age range + // represented in this field can be 1) targeted solely, or, 2) part of a + // larger continuous age range. The reach of a continuous age range + // targeting can be expanded by also targeting an audience of an unknown + // age. // // Possible values: // "AGE_RANGE_UNSPECIFIED" - Default value when age range is not @@ -1787,8 +1786,7 @@ func (s *AssignedInventorySource) MarshalJSON() ([]byte, error) { } // AssignedLocation: An assignment between a location list and a -// relevant targeting option. Currently, geo region targeting options -// are the only supported option for assignment. +// relevant targeting option. type AssignedLocation struct { // AssignedLocationId: Output only. The unique ID of the assigned // location. The ID is only unique within a location list. It may be @@ -1799,10 +1797,7 @@ type AssignedLocation struct { Name string `json:"name,omitempty"` // TargetingOptionId: Required. The ID of the targeting option assigned - // to the location list. Assigned locations can only be modified in - // TARGETING_LOCATION_TYPE_REGIONAL location lists. When creating or - // deleting assigned locations, this value must be of type - // TARGETING_TYPE_GEO_REGION. + // to the location list. TargetingOptionId string `json:"targetingOptionId,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2467,8 +2462,7 @@ func (s *AudioAd) MarshalJSON() ([]byte, error) { // is not supported. Remove all audio content type targeting options to // achieve this effect. type AudioContentTypeAssignedTargetingOptionDetails struct { - // AudioContentType: The audio content type. Output only in v1. Required - // in v2. + // AudioContentType: Required. The audio content type. // // Possible values: // "AUDIO_CONTENT_TYPE_UNSPECIFIED" - Audio content type is not @@ -3102,11 +3096,11 @@ func (s *BulkEditAssignedInventorySourcesResponse) MarshalJSON() ([]byte, error) // AssignedLocationService.BulkEditAssignedLocations. type BulkEditAssignedLocationsRequest struct { // CreatedAssignedLocations: The assigned locations to create in bulk, - // specified as a list of AssignedLocations. + // specified as a list of AssignedLocation resources. CreatedAssignedLocations []*AssignedLocation `json:"createdAssignedLocations,omitempty"` // DeletedAssignedLocations: The IDs of the assigned locations to delete - // in bulk, specified as a list of assigned_location_ids. + // in bulk, specified as a list of assignedLocationId values. DeletedAssignedLocations googleapi.Int64s `json:"deletedAssignedLocations,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -3134,8 +3128,6 @@ func (s *BulkEditAssignedLocationsRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// BulkEditAssignedLocationsResponse: Response message for -// AssignedLocationService.BulkEditAssignedLocations. type BulkEditAssignedLocationsResponse struct { // AssignedLocations: The list of assigned locations that have been // successfully created. This list will be absent if empty. @@ -3597,8 +3589,7 @@ type BulkListAdGroupAssignedTargetingOptionsResponse struct { // value should be specified as the pageToken in a subsequent call to // `BulkListAdGroupAssignedTargetingOptions` to fetch the next page of // results. This token will be absent if there are no more - // youtube_ad_group_assigned_targeting_options or - // ad_group_assigned_targeting_options to return. + // AdGroupAssignedTargetingOption resources to return. NextPageToken string `json:"nextPageToken,omitempty"` // YoutubeAdGroupAssignedTargetingOptions: The list of wrapper objects, @@ -5129,8 +5120,8 @@ type ContentInstreamPositionAssignedTargetingOptionDetails struct { // audio content. AdType string `json:"adType,omitempty"` - // ContentInstreamPosition: The content instream position for video or - // audio ads. Output only in v1. Required in v2. + // ContentInstreamPosition: Required. The content instream position for + // video or audio ads. // // Possible values: // "CONTENT_INSTREAM_POSITION_UNSPECIFIED" - Content instream position @@ -5239,8 +5230,7 @@ type ContentOutstreamPositionAssignedTargetingOptionDetails struct { // audio content. AdType string `json:"adType,omitempty"` - // ContentOutstreamPosition: The content outstream position. Output only - // in v1. Required in v2. + // ContentOutstreamPosition: Required. The content outstream position. // // Possible values: // "CONTENT_OUTSTREAM_POSITION_UNSPECIFIED" - Content outstream @@ -6486,8 +6476,7 @@ type CustomBiddingScript struct { CustomBiddingScriptId int64 `json:"customBiddingScriptId,omitempty,string"` // Errors: Output only. Error details of a rejected custom bidding - // script. This field will only be populated when Script.state is - // REJECTED. + // script. This field will only be populated when state is REJECTED. Errors []*ScriptError `json:"errors,omitempty"` // Name: Output only. The resource name of the custom bidding script. @@ -7082,17 +7071,16 @@ func (s *DeviceMakeModelTargetingOptionDetails) MarshalJSON() ([]byte, error) { // AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_DEVICE_TYPE`. type DeviceTypeAssignedTargetingOptionDetails struct { - // DeviceType: The display name of the device type. Output only in v1. - // Required in v2. + // DeviceType: Required. The display name of the device type. // // Possible values: // "DEVICE_TYPE_UNSPECIFIED" - Default value when device type is not // specified in this version. This enum is a placeholder for default // value and does not represent a real device type option. - // "DEVICE_TYPE_COMPUTER" - The device type is computer. - // "DEVICE_TYPE_CONNECTED_TV" - The device type is connected TV. - // "DEVICE_TYPE_SMART_PHONE" - The device type is smart phone.. - // "DEVICE_TYPE_TABLET" - The device type is tablet. + // "DEVICE_TYPE_COMPUTER" - Computer. + // "DEVICE_TYPE_CONNECTED_TV" - Connected TV. + // "DEVICE_TYPE_SMART_PHONE" - Smart phone. + // "DEVICE_TYPE_TABLET" - Tablet. DeviceType string `json:"deviceType,omitempty"` // YoutubeAndPartnersBidMultiplier: Output only. Bid multiplier allows @@ -7152,10 +7140,10 @@ type DeviceTypeTargetingOptionDetails struct { // "DEVICE_TYPE_UNSPECIFIED" - Default value when device type is not // specified in this version. This enum is a placeholder for default // value and does not represent a real device type option. - // "DEVICE_TYPE_COMPUTER" - The device type is computer. - // "DEVICE_TYPE_CONNECTED_TV" - The device type is connected TV. - // "DEVICE_TYPE_SMART_PHONE" - The device type is smart phone.. - // "DEVICE_TYPE_TABLET" - The device type is tablet. + // "DEVICE_TYPE_COMPUTER" - Computer. + // "DEVICE_TYPE_CONNECTED_TV" - Connected TV. + // "DEVICE_TYPE_SMART_PHONE" - Smart phone. + // "DEVICE_TYPE_TABLET" - Tablet. DeviceType string `json:"deviceType,omitempty"` // ForceSendFields is a list of field names (e.g. "DeviceType") to @@ -8041,8 +8029,7 @@ type Empty struct { // of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_ENVIRONMENT`. type EnvironmentAssignedTargetingOptionDetails struct { - // Environment: The serving environment. Output only in v1. Required in - // v2. + // Environment: Required. The serving environment. // // Possible values: // "ENVIRONMENT_UNSPECIFIED" - Default value when environment is not @@ -9131,8 +9118,7 @@ func (s *FrequencyCap) MarshalJSON() ([]byte, error) { // AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_GENDER`. type GenderAssignedTargetingOptionDetails struct { - // Gender: The gender of the audience. Output only in v1. Required in - // v2. + // Gender: Required. The gender of the audience. // // Possible values: // "GENDER_UNSPECIFIED" - Default value when gender is not specified @@ -9283,12 +9269,12 @@ type GenerateDefaultLineItemRequest struct { // aim to get more views with a variety of ad formats. Line items of // this type and their targeting cannot be created or updated using the // API. - // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Digital display out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. - // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Digital video out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. + // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Display ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. + // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Video ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. LineItemType string `json:"lineItemType,omitempty"` // MobileApp: The mobile app promoted by the line item. This is @@ -9915,8 +9901,7 @@ func (s *GuaranteedOrderStatus) MarshalJSON() ([]byte, error) { // details field of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_HOUSEHOLD_INCOME`. type HouseholdIncomeAssignedTargetingOptionDetails struct { - // HouseholdIncome: The household income of the audience. Output only in - // v1. Required in v2. + // HouseholdIncome: Required. The household income of the audience. // // Possible values: // "HOUSEHOLD_INCOME_UNSPECIFIED" - Default value when household @@ -10294,14 +10279,14 @@ type InsertionOrderBudget struct { // automation option is not specified or is unknown in this version. // "INSERTION_ORDER_AUTOMATION_TYPE_BUDGET" - Automatic budget // allocation. Allow the system to automatically shift budget to owning - // line items to optimize performance defined by performance_goal. No - // automation on bid settings. + // line items to optimize performance defined by kpi. No automation on + // bid settings. // "INSERTION_ORDER_AUTOMATION_TYPE_NONE" - No automation of bid or // budget on insertion order level. Bid and budget must be manually // configured at the line item level. // "INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET" - Allow the system to // automatically adjust bids and shift budget to owning line items to - // optimize performance defined by performance_goal. + // optimize performance defined by kpi. AutomationType string `json:"automationType,omitempty"` // BudgetSegments: Required. The list of budget segments. Use a budget @@ -11600,12 +11585,12 @@ type LineItem struct { // aim to get more views with a variety of ad formats. Line items of // this type and their targeting cannot be created or updated using the // API. - // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Digital display out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. - // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Digital video out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. + // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Display ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. + // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Video ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. LineItemType string `json:"lineItemType,omitempty"` // MobileApp: The mobile app promoted by the line item. This is @@ -13689,8 +13674,7 @@ func (s *Money) MarshalJSON() ([]byte, error) { // Explicitly targeting all options is not supported. Remove all native // content position targeting options to achieve this effect. type NativeContentPositionAssignedTargetingOptionDetails struct { - // ContentPosition: The content position. Output only in v1. Required in - // v2. + // ContentPosition: Required. The content position. // // Possible values: // "NATIVE_CONTENT_POSITION_UNSPECIFIED" - Native content position is @@ -14018,8 +14002,7 @@ func (s *ObaIcon) MarshalJSON() ([]byte, error) { // details field of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_OMID`. type OmidAssignedTargetingOptionDetails struct { - // Omid: The type of Open Measurement enabled inventory. Output only in - // v1. Required in v2. + // Omid: Required. The type of Open Measurement enabled inventory. // // Possible values: // "OMID_UNSPECIFIED" - Default value when omid targeting is not @@ -14348,8 +14331,8 @@ type Pacing struct { // PacingPeriod: Required. The time period in which the pacing budget // will be spent. When automatic budget allocation is enabled at the - // insertion order via auto_budget_allocation, this field is output only - // and defaults to `PACING_PERIOD_FLIGHT`. + // insertion order via automationType, this field is output only and + // defaults to `PACING_PERIOD_FLIGHT`. // // Possible values: // "PACING_PERIOD_UNSPECIFIED" - Period value is not specified or is @@ -14478,8 +14461,7 @@ func (s *ParentEntityFilter) MarshalJSON() ([]byte, error) { // details field of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_PARENTAL_STATUS`. type ParentalStatusAssignedTargetingOptionDetails struct { - // ParentalStatus: The parental status of the audience. Output only in - // v1. Required in v2. + // ParentalStatus: Required. The parental status of the audience. // // Possible values: // "PARENTAL_STATUS_UNSPECIFIED" - Default value when parental status @@ -14923,7 +14905,7 @@ func (s *PartnerRevenueModel) MarshalJSON() ([]byte, error) { } // PerformanceGoal: Settings that control the performance goal of a -// campaign or insertion order. +// campaign. type PerformanceGoal struct { // PerformanceGoalAmountMicros: The goal amount, in micros of the // advertiser's currency. Applicable when performance_goal_type is one @@ -17639,8 +17621,7 @@ func (s *VideoPerformanceAd) MarshalJSON() ([]byte, error) { // is not supported. Remove all video player size targeting options to // achieve this effect. type VideoPlayerSizeAssignedTargetingOptionDetails struct { - // VideoPlayerSize: The video player size. Output only in v1. Required - // in v2. + // VideoPlayerSize: Required. The video player size. // // Possible values: // "VIDEO_PLAYER_SIZE_UNSPECIFIED" - Video player size is not @@ -17735,8 +17716,7 @@ func (s *VideoPlayerSizeTargetingOptionDetails) MarshalJSON() ([]byte, error) { // viewability_details field of an AssignedTargetingOption when // targeting_type is `TARGETING_TYPE_VIEWABILITY`. type ViewabilityAssignedTargetingOptionDetails struct { - // Viewability: The predicted viewability percentage. Output only in v1. - // Required in v2. + // Viewability: Required. The predicted viewability percentage. // // Possible values: // "VIEWABILITY_UNSPECIFIED" - Default value when viewability is not @@ -18052,7 +18032,7 @@ func (s *YoutubeAdGroupAd) MarshalJSON() ([]byte, error) { } // YoutubeAdGroupAssignedTargetingOption: Wrapper object associating an -// assigned_targeting_option resource and the youtube ad group it is +// AssignedTargetingOption resource and the youtube ad group it is // assigned to. type YoutubeAdGroupAssignedTargetingOption struct { // AssignedTargetingOption: The assigned targeting option resource. @@ -18091,19 +18071,19 @@ func (s *YoutubeAdGroupAssignedTargetingOption) MarshalJSON() ([]byte, error) { // strategy for YouTube and Partners resources. type YoutubeAndPartnersBiddingStrategy struct { // AdGroupEffectiveTargetCpaSource: Output only. Source of the effective - // targetCpa value for AdGroup. + // target CPA value for ad group. // // Possible values: // "BIDDING_SOURCE_UNSPECIFIED" - Bidding source is not specified or // unknown. // "BIDDING_SOURCE_LINE_ITEM" - Bidding value is inherited from the // line item. - // "BIDDING_SOURCE_AD_GROUP" - Bidding value is defined on the ad + // "BIDDING_SOURCE_AD_GROUP" - Bidding value is defined in the ad // group. AdGroupEffectiveTargetCpaSource string `json:"adGroupEffectiveTargetCpaSource,omitempty"` - // AdGroupEffectiveTargetCpaValue: Output only. The effective targetCpa - // for AdGroup, in micros of advertiser's currency. + // AdGroupEffectiveTargetCpaValue: Output only. The effective target CPA + // for ad group, in micros of advertiser's currency. AdGroupEffectiveTargetCpaValue int64 `json:"adGroupEffectiveTargetCpaValue,omitempty,string"` // Type: The type of the bidding strategy. @@ -31144,10 +31124,8 @@ type AdvertisersLocationListsAssignedLocationsBulkEditCall struct { // BulkEdit: Bulk edits multiple assignments between locations and a // single location list. The operation will delete the assigned -// locations provided in -// BulkEditAssignedLocationsRequest.deleted_assigned_locations and then -// create the assigned locations provided in -// BulkEditAssignedLocationsRequest.created_assigned_locations. +// locations provided in deletedAssignedLocations and then create the +// assigned locations provided in createdAssignedLocations. // // - advertiserId: The ID of the DV360 advertiser to which the location // list belongs. @@ -31254,7 +31232,7 @@ func (c *AdvertisersLocationListsAssignedLocationsBulkEditCall) Do(opts ...googl } return ret, nil // { - // "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in BulkEditAssignedLocationsRequest.deleted_assigned_locations and then create the assigned locations provided in BulkEditAssignedLocationsRequest.created_assigned_locations.", + // "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in deletedAssignedLocations and then create the assigned locations provided in createdAssignedLocations.", // "flatPath": "v2/advertisers/{advertiserId}/locationLists/{locationListsId}/assignedLocations:bulkEdit", // "httpMethod": "POST", // "id": "displayvideo.advertisers.locationLists.assignedLocations.bulkEdit", @@ -36195,7 +36173,7 @@ type AdvertisersYoutubeAdGroupsBulkListAdGroupAssignedTargetingOptionsCall struc // BulkListAdGroupAssignedTargetingOptions: Lists assigned targeting // options for multiple YouTube ad groups across targeting types. -// Inherieted assigned targeting options are not included. +// Inherited assigned targeting options are not included. // // - advertiserId: The ID of the advertiser the line items belongs to. func (r *AdvertisersYoutubeAdGroupsService) BulkListAdGroupAssignedTargetingOptions(advertiserId int64) *AdvertisersYoutubeAdGroupsBulkListAdGroupAssignedTargetingOptionsCall { @@ -36223,8 +36201,7 @@ func (c *AdvertisersYoutubeAdGroupsBulkListAdGroupAssignedTargetingOptionsCall) } // OrderBy sets the optional parameter "orderBy": Field by which to sort -// the list. Acceptable values are: * `youtubeAdGroupId` (acceptable in -// v2) * `adGroupId` (acceptable in v3) * +// the list. Acceptable values are: * `adGroupId` (default) * // `assignedTargetingOption.targetingType` The default sorting order is // ascending. To specify descending order for a field, a suffix "desc" // should be added to the field name. Example: `targetingType desc`. @@ -36367,7 +36344,7 @@ func (c *AdvertisersYoutubeAdGroupsBulkListAdGroupAssignedTargetingOptionsCall) } return ret, nil // { - // "description": "Lists assigned targeting options for multiple YouTube ad groups across targeting types. Inherieted assigned targeting options are not included.", + // "description": "Lists assigned targeting options for multiple YouTube ad groups across targeting types. Inherited assigned targeting options are not included.", // "flatPath": "v2/advertisers/{advertisersId}/youtubeAdGroups:bulkListAdGroupAssignedTargetingOptions", // "httpMethod": "GET", // "id": "displayvideo.advertisers.youtubeAdGroups.bulkListAdGroupAssignedTargetingOptions", @@ -36389,7 +36366,7 @@ func (c *AdvertisersYoutubeAdGroupsBulkListAdGroupAssignedTargetingOptionsCall) // "type": "string" // }, // "orderBy": { - // "description": "Optional. Field by which to sort the list. Acceptable values are: * `youtubeAdGroupId` (acceptable in v2) * `adGroupId` (acceptable in v3) * `assignedTargetingOption.targetingType` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `targetingType desc`.", + // "description": "Optional. Field by which to sort the list. Acceptable values are: * `adGroupId` (default) * `assignedTargetingOption.targetingType` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `targetingType desc`.", // "location": "query", // "type": "string" // }, diff --git a/displayvideo/v3/displayvideo-api.json b/displayvideo/v3/displayvideo-api.json index cfe664a7a73..c5a9cb50a40 100644 --- a/displayvideo/v3/displayvideo-api.json +++ b/displayvideo/v3/displayvideo-api.json @@ -463,7 +463,7 @@ "adGroups": { "methods": { "bulkListAdGroupAssignedTargetingOptions": { - "description": "Lists assigned targeting options for multiple ad groups across targeting types. Inherieted assigned targeting options are not included.", + "description": "Lists assigned targeting options for multiple ad groups across targeting types. Inherited assigned targeting options are not included.", "flatPath": "v3/advertisers/{advertisersId}/adGroups:bulkListAdGroupAssignedTargetingOptions", "httpMethod": "GET", "id": "displayvideo.advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions", @@ -492,7 +492,7 @@ "type": "string" }, "orderBy": { - "description": "Optional. Field by which to sort the list. Acceptable values are: * `youtubeAdGroupId` (acceptable in v2) * `adGroupId` (acceptable in v3) * `assignedTargetingOption.targetingType` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `targetingType desc`.", + "description": "Optional. Field by which to sort the list. Acceptable values are: * `adGroupId` (default) * `assignedTargetingOption.targetingType` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `targetingType desc`.", "location": "query", "type": "string" }, @@ -4305,7 +4305,7 @@ "assignedLocations": { "methods": { "bulkEdit": { - "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in BulkEditAssignedLocationsRequest.deleted_assigned_locations and then create the assigned locations provided in BulkEditAssignedLocationsRequest.created_assigned_locations.", + "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in deletedAssignedLocations and then create the assigned locations provided in createdAssignedLocations.", "flatPath": "v3/advertisers/{advertiserId}/locationLists/{locationListsId}/assignedLocations:bulkEdit", "httpMethod": "POST", "id": "displayvideo.advertisers.locationLists.assignedLocations.bulkEdit", @@ -5703,7 +5703,7 @@ ] }, "uploadRules": { - "description": "Creates a rules reference object. The resulting reference object provides a resource path where the rules file should be uploaded. This reference object should be included when creating a new rules resource.", + "description": "Creates a rules reference object for an AlgorithmRules file. The resulting reference object provides a resource path where the AlgorithmRules file should be uploaded. This reference object should be included when creating a new CustomBiddingAlgorithmRules resource.", "flatPath": "v3/customBiddingAlgorithms/{customBiddingAlgorithmsId}:uploadRules", "httpMethod": "GET", "id": "displayvideo.customBiddingAlgorithms.uploadRules", @@ -9127,7 +9127,7 @@ } } }, - "revision": "20230928", + "revision": "20231009", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -9287,7 +9287,7 @@ }, "bidStrategy": { "$ref": "BiddingStrategy", - "description": "The bidding strategy used by the ad group. Only BiddingStrategy.youtube_and_partners_bid can be used here." + "description": "The bidding strategy used by the ad group. Only the youtubeAndPartnersBid field can be used in the bidding strategy." }, "displayName": { "description": "The display name of the ad group. Must be UTF-8 encoded with a maximum size of 255 bytes.", @@ -9328,7 +9328,7 @@ }, "targetingExpansion": { "$ref": "TargetingExpansionConfig", - "description": "The [targeting expansion](https://support.google.com/displayvideo/answer/10191558) settings of the ad group. This config is only applicable when eligible audience list targeting is assigned to the ad group." + "description": "The [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the ad group." } }, "type": "object" @@ -9423,7 +9423,7 @@ "type": "object" }, "AdGroupAssignedTargetingOption": { - "description": "Wrapper object associating an assigned_targeting_option resource and the ad group it is assigned to.", + "description": "Wrapper object associating an AssignedTargetingOption resource and the ad group it is assigned to.", "id": "AdGroupAssignedTargetingOption", "properties": { "adGroupId": { @@ -9519,7 +9519,7 @@ }, "billingConfig": { "$ref": "AdvertiserBillingConfig", - "description": "Billing related settings of the advertiser." + "description": "Required. Billing related settings of the advertiser." }, "creativeConfig": { "$ref": "AdvertiserCreativeConfig", @@ -9608,7 +9608,7 @@ "id": "AdvertiserBillingConfig", "properties": { "billingProfileId": { - "description": "The ID of a billing profile assigned to the advertiser. This field will default to the default billing profile ID of the advertiser's parent partner if a value is not provided.", + "description": "The ID of a billing profile assigned to the advertiser.", "format": "int64", "type": "string" } @@ -9701,7 +9701,7 @@ "id": "AgeRangeAssignedTargetingOptionDetails", "properties": { "ageRange": { - "description": "The age range of an audience. We only support targeting a continuous age range of an audience. Thus, the age range represented in this field can be 1) targeted solely, or, 2) part of a larger continuous age range. The reach of a continuous age range targeting can be expanded by also targeting an audience of an unknown age. Output only in v1. Required in v2.", + "description": "Required. The age range of an audience. We only support targeting a continuous age range of an audience. Thus, the age range represented in this field can be 1) targeted solely, or, 2) part of a larger continuous age range. The reach of a continuous age range targeting can be expanded by also targeting an audience of an unknown age.", "enum": [ "AGE_RANGE_UNSPECIFIED", "AGE_RANGE_18_24", @@ -9839,12 +9839,12 @@ ], "enumDescriptions": [ "Default value when device type is not specified in this version. This enum is a placeholder for default value and does not represent a real device type option.", - "The device type is computer.", - "The device type is connected TV.", - "The device type is smart phone.", - "The device type is tablet.", - "The device type is connected device.", - "The device type is set top box." + "Computer.", + "Connected TV.", + "Smart phone.", + "Tablet.", + "Connected device.", + "Set top box." ], "type": "string" }, @@ -10148,17 +10148,17 @@ ], "enumDescriptions": [ "Unknown signal.", - "The day of the week and hour of day the impression was made using browser's local time zone. Value is stored in day_and_time_value field of `AlgorithmComparisonValue`.", - "Device type. Value is stored in device_type_value field of `AlgorithmComparisonValue`.", - "Ad position. Value is stored in on_screen_position_value field of `AlgorithmComparisonValue`.", - "The operating system identifier. Value is stored in int64_value field of `AlgorithmComparisonValue`.", - "The mobile model identifier. Value is stored in int64_value field of `AlgorithmComparisonValue`.", - "The exchange identifier. Value is stored in int64_value field of `AlgorithmComparisonValue`.", - "Serving environment. Value is stored in environment_value field of `AlgorithmComparisonValue`.", - "The country or region identifier. Value is stored in int64_value field of `AlgorithmComparisonValue`.", - "The city identifier. Value is stored in int64_value field of `AlgorithmComparisonValue`.", - "The browser identifier. Value is stored in int64_value field of `AlgorithmComparisonValue`.", - "Creative height and width in pixels. Value is stored in creative_dimension_value field of `AlgorithmComparisonValue`." + "The day of the week and hour of day the impression was made using browser's local time zone. Value is stored in the dayAndTimeValue field of the comparison value.", + "Device type. Value is stored in the deviceTypeValue field of the comparison value.", + "Ad position. Value is stored in the onScreenPositionValue field of the comparison value.", + "The operating system identifier. Value is stored in the int64Value field of the comparison value.", + "The mobile model identifier. Value is stored in the int64Value field of the comparison value.", + "The exchange identifier. Value is stored in the int64Value field of the comparison value.", + "Serving environment. Value is stored in the environmentValue field of the comparison value.", + "The country or region identifier. Value is stored in the int64Value field of the comparison value.", + "The city identifier. Value is stored in the int64Value field of the comparison value.", + "The browser identifier. Value is stored in the int64Value field of the comparison value.", + "Creative height and width in pixels. Value is stored in the creativeDimensionValue field of the comparison value." ], "type": "string" } @@ -10386,7 +10386,7 @@ "type": "object" }, "AssignedLocation": { - "description": "An assignment between a location list and a relevant targeting option. Currently, geo region targeting options are the only supported option for assignment.", + "description": "An assignment between a location list and a relevant targeting option.", "id": "AssignedLocation", "properties": { "assignedLocationId": { @@ -10401,7 +10401,7 @@ "type": "string" }, "targetingOptionId": { - "description": "Required. The ID of the targeting option assigned to the location list. Assigned locations can only be modified in TARGETING_LOCATION_TYPE_REGIONAL location lists. When creating or deleting assigned locations, this value must be of type TARGETING_TYPE_GEO_REGION.", + "description": "Required. The ID of the targeting option assigned to the location list.", "type": "string" } }, @@ -10861,7 +10861,7 @@ "id": "AudioContentTypeAssignedTargetingOptionDetails", "properties": { "audioContentType": { - "description": "The audio content type. Output only in v1. Required in v2.", + "description": "Required. The audio content type.", "enum": [ "AUDIO_CONTENT_TYPE_UNSPECIFIED", "AUDIO_CONTENT_TYPE_UNKNOWN", @@ -11037,7 +11037,7 @@ }, "youtubeAndPartnersBid": { "$ref": "YoutubeAndPartnersBiddingStrategy", - "description": "A bid strategy used by YouTube and Partners resources. It can only be used for a YouTube and Partners line item and ad group entity." + "description": "A bid strategy used by YouTube and Partners resources. It can only be used for a YouTube and Partners line item or ad group entity." } }, "type": "object" @@ -11189,14 +11189,14 @@ "id": "BulkEditAssignedLocationsRequest", "properties": { "createdAssignedLocations": { - "description": "The assigned locations to create in bulk, specified as a list of AssignedLocations.", + "description": "The assigned locations to create in bulk, specified as a list of AssignedLocation resources.", "items": { "$ref": "AssignedLocation" }, "type": "array" }, "deletedAssignedLocations": { - "description": "The IDs of the assigned locations to delete in bulk, specified as a list of assigned_location_ids.", + "description": "The IDs of the assigned locations to delete in bulk, specified as a list of assignedLocationId values.", "items": { "format": "int64", "type": "string" @@ -11207,7 +11207,6 @@ "type": "object" }, "BulkEditAssignedLocationsResponse": { - "description": "Response message for AssignedLocationService.BulkEditAssignedLocations.", "id": "BulkEditAssignedLocationsResponse", "properties": { "assignedLocations": { @@ -11439,7 +11438,7 @@ "type": "array" }, "nextPageToken": { - "description": "A token identifying the next page of results. This value should be specified as the pageToken in a subsequent call to `BulkListAdGroupAssignedTargetingOptions` to fetch the next page of results. This token will be absent if there are no more youtube_ad_group_assigned_targeting_options or ad_group_assigned_targeting_options to return.", + "description": "A token identifying the next page of results. This value should be specified as the pageToken in a subsequent call to `BulkListAdGroupAssignedTargetingOptions` to fetch the next page of results. This token will be absent if there are no more AdGroupAssignedTargetingOption resources to return.", "type": "string" } }, @@ -12361,7 +12360,7 @@ "type": "string" }, "contentInstreamPosition": { - "description": "The content instream position for video or audio ads. Output only in v1. Required in v2.", + "description": "Required. The content instream position for video or audio ads.", "enum": [ "CONTENT_INSTREAM_POSITION_UNSPECIFIED", "CONTENT_INSTREAM_POSITION_PRE_ROLL", @@ -12429,7 +12428,7 @@ "type": "string" }, "contentOutstreamPosition": { - "description": "The content outstream position. Output only in v1. Required in v2.", + "description": "Required. The content outstream position.", "enum": [ "CONTENT_OUTSTREAM_POSITION_UNSPECIFIED", "CONTENT_OUTSTREAM_POSITION_UNKNOWN", @@ -13218,7 +13217,7 @@ "Algorithm generated through customer-uploaded custom bidding script files.", "Algorithm created through Ads Data Hub product.", "Algorithm created through goal builder in DV3 UI.", - "Rule based algorithm." + "Algorithm based in defined rules. These rules are defined in the API using the AlgorithmRules object. This algorithm type is only available to allowlisted customers. Other customers attempting to use this type will receive an error." ], "type": "string" }, @@ -13358,7 +13357,7 @@ "type": "object" }, "CustomBiddingAlgorithmRulesRef": { - "description": "The reference to the uploaded AlgorithmRules file. Retrieve the location to upload new AlgorithmRules file to using customBiddingAlgoirhtms.uploadRules", + "description": "The reference to the uploaded AlgorithmRules file. Retrieve the location to upload new AlgorithmRules file to using customBiddingAlgorithms.uploadRules.", "id": "CustomBiddingAlgorithmRulesRef", "properties": { "resourceName": { @@ -13393,7 +13392,7 @@ "There is not enough data to train the serving model.", "The model is training and not ready for serving.", "A valid custom bidding script has not been provided with which to train the model. This state will only be applied to algorithms whose `custom_bidding_algorithm_type` is `SCRIPT_BASED`.", - "Valid script was provided but evaluation have failed. Currently this is only applicable for scripts that could not be evaluated in alloted time." + "A valid script was provided but failed evaluation. This is applicable for scripts that could not be evaluated in the alloted time." ], "type": "string" }, @@ -13445,7 +13444,7 @@ "type": "string" }, "errors": { - "description": "Output only. Error details of a rejected custom bidding script. This field will only be populated when Script.state is REJECTED.", + "description": "Output only. Error details of a rejected custom bidding script. This field will only be populated when state is REJECTED.", "items": { "$ref": "ScriptError" }, @@ -13871,7 +13870,7 @@ "id": "DeviceTypeAssignedTargetingOptionDetails", "properties": { "deviceType": { - "description": "The display name of the device type. Output only in v1. Required in v2.", + "description": "Required. The display name of the device type.", "enum": [ "DEVICE_TYPE_UNSPECIFIED", "DEVICE_TYPE_COMPUTER", @@ -13881,10 +13880,10 @@ ], "enumDescriptions": [ "Default value when device type is not specified in this version. This enum is a placeholder for default value and does not represent a real device type option.", - "The device type is computer.", - "The device type is connected TV.", - "The device type is smart phone..", - "The device type is tablet." + "Computer.", + "Connected TV.", + "Smart phone.", + "Tablet." ], "type": "string" }, @@ -13912,10 +13911,10 @@ ], "enumDescriptions": [ "Default value when device type is not specified in this version. This enum is a placeholder for default value and does not represent a real device type option.", - "The device type is computer.", - "The device type is connected TV.", - "The device type is smart phone..", - "The device type is tablet." + "Computer.", + "Connected TV.", + "Smart phone.", + "Tablet." ], "readOnly": true, "type": "string" @@ -14515,7 +14514,7 @@ "id": "EnvironmentAssignedTargetingOptionDetails", "properties": { "environment": { - "description": "The serving environment. Output only in v1. Required in v2.", + "description": "Required. The serving environment.", "enum": [ "ENVIRONMENT_UNSPECIFIED", "ENVIRONMENT_WEB_OPTIMIZED", @@ -15668,7 +15667,7 @@ "id": "GenderAssignedTargetingOptionDetails", "properties": { "gender": { - "description": "The gender of the audience. Output only in v1. Required in v2.", + "description": "Required. The gender of the audience.", "enum": [ "GENDER_UNSPECIFIED", "GENDER_MALE", @@ -15770,8 +15769,8 @@ "Connected TV default YouTube video ads. Only include in-stream ad-format. Line items of this type and their targeting cannot be created or updated using the API.", "The goal of this line item type is to show the YouTube ads target number of times to the same person in a certain period of time. Line items of this type and their targeting cannot be created or updated using the API.", "YouTube video ads that aim to get more views with a variety of ad formats. Line items of this type and their targeting cannot be created or updated using the API.", - "Digital display out of home. Line items of this type and their targeting cannot be created or updated using the API.", - "Digital video out of home. Line items of this type and their targeting cannot be created or updated using the API." + "Display ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API.", + "Video ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API." ], "type": "string" }, @@ -16333,7 +16332,7 @@ "id": "HouseholdIncomeAssignedTargetingOptionDetails", "properties": { "householdIncome": { - "description": "The household income of the audience. Output only in v1. Required in v2.", + "description": "Required. The household income of the audience.", "enum": [ "HOUSEHOLD_INCOME_UNSPECIFIED", "HOUSEHOLD_INCOME_UNKNOWN", @@ -16561,7 +16560,7 @@ }, "kpi": { "$ref": "Kpi", - "description": "Required. The key performance indicator (KPI) of the insertion order." + "description": "Required. The key performance indicator (KPI) of the insertion order. This is represented as referred to as the \"Goal\" in the Display \u0026 Video 360 interface." }, "name": { "description": "Output only. The resource name of the insertion order.", @@ -16623,9 +16622,9 @@ ], "enumDescriptions": [ "Insertion order automation option is not specified or is unknown in this version.", - "Automatic budget allocation. Allow the system to automatically shift budget to owning line items to optimize performance defined by performance_goal. No automation on bid settings.", + "Automatic budget allocation. Allow the system to automatically shift budget to owning line items to optimize performance defined by kpi. No automation on bid settings.", "No automation of bid or budget on insertion order level. Bid and budget must be manually configured at the line item level.", - "Allow the system to automatically adjust bids and shift budget to owning line items to optimize performance defined by performance_goal." + "Allow the system to automatically adjust bids and shift budget to owning line items to optimize performance defined by kpi." ], "type": "string" }, @@ -17543,7 +17542,7 @@ "type": "string" }, "kpiString": { - "description": "A KPI string, which can be empty. Must be UTF-8 encoded with a length of no more than 100 characters. Applicable when kpi_type][Kpi.kpi_type] is `KPI_TYPE_OTHER`.", + "description": "A KPI string, which can be empty. Must be UTF-8 encoded with a length of no more than 100 characters. Applicable when kpi_type is `KPI_TYPE_OTHER`.", "type": "string" }, "kpiType": { @@ -17753,8 +17752,8 @@ "Connected TV default YouTube video ads. Only include in-stream ad-format. Line items of this type and their targeting cannot be created or updated using the API.", "The goal of this line item type is to show the YouTube ads target number of times to the same person in a certain period of time. Line items of this type and their targeting cannot be created or updated using the API.", "YouTube video ads that aim to get more views with a variety of ad formats. Line items of this type and their targeting cannot be created or updated using the API.", - "Digital display out of home. Line items of this type and their targeting cannot be created or updated using the API.", - "Digital video out of home. Line items of this type and their targeting cannot be created or updated using the API." + "Display ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API.", + "Video ads served on digital-out-of-home inventory. Line items of this type and their targeting cannot be created or updated using the API." ], "type": "string" }, @@ -17968,7 +17967,7 @@ "type": "array" }, "nextPageToken": { - "description": "A token identifying the next page of results. This value should be specified as the pageToken in a subsequent ListAdGroupAssignedTargetingOptionsRequest to fetch the next page of results. This token will be absent if there are no more assigned_targeting_options to return.", + "description": "A token identifying the next page of results. This value should be specified as the pageToken in a subsequent ListAdGroupAssignedTargetingOptionsRequest to fetch the next page of results. This token will be absent if there are no more AssignedTargetingOption resources to return.", "type": "string" } }, @@ -18149,7 +18148,6 @@ "type": "object" }, "ListCustomBiddingAlgorithmRulesResponse": { - "description": "Response message for CustomBiddingAlgorithmRulesService.ListCustomBiddingAlgorithmRules.", "id": "ListCustomBiddingAlgorithmRulesResponse", "properties": { "customBiddingRules": { @@ -18799,7 +18797,7 @@ "id": "NativeContentPositionAssignedTargetingOptionDetails", "properties": { "contentPosition": { - "description": "The content position. Output only in v1. Required in v2.", + "description": "Required. The content position.", "enum": [ "NATIVE_CONTENT_POSITION_UNSPECIFIED", "NATIVE_CONTENT_POSITION_UNKNOWN", @@ -18987,7 +18985,7 @@ "id": "OmidAssignedTargetingOptionDetails", "properties": { "omid": { - "description": "The type of Open Measurement enabled inventory. Output only in v1. Required in v2.", + "description": "Required. The type of Open Measurement enabled inventory.", "enum": [ "OMID_UNSPECIFIED", "OMID_FOR_MOBILE_DISPLAY_ADS" @@ -19172,7 +19170,7 @@ "type": "string" }, "pacingPeriod": { - "description": "Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via auto_budget_allocation, this field is output only and defaults to `PACING_PERIOD_FLIGHT`.", + "description": "Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via automationType, this field is output only and defaults to `PACING_PERIOD_FLIGHT`.", "enum": [ "PACING_PERIOD_UNSPECIFIED", "PACING_PERIOD_DAILY", @@ -19271,7 +19269,7 @@ "id": "ParentalStatusAssignedTargetingOptionDetails", "properties": { "parentalStatus": { - "description": "The parental status of the audience. Output only in v1. Required in v2.", + "description": "Required. The parental status of the audience.", "enum": [ "PARENTAL_STATUS_UNSPECIFIED", "PARENTAL_STATUS_PARENT", @@ -19581,7 +19579,7 @@ "type": "object" }, "PerformanceGoal": { - "description": "Settings that control the performance goal of a campaign or insertion order.", + "description": "Settings that control the performance goal of a campaign.", "id": "PerformanceGoal", "properties": { "performanceGoalAmountMicros": { @@ -20581,7 +20579,7 @@ "id": "TargetingExpansionConfig", "properties": { "audienceExpansionLevel": { - "description": "Magnitude of expansion for eligible 1p user list under this ad group.", + "description": "Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources.", "enum": [ "UNKNOWN", "NO_REACH", @@ -20596,10 +20594,12 @@ "Moderate audience expansion.", "Aggressive audience expansion." ], + "readOnly": true, "type": "string" }, "audienceExpansionSeedListExcluded": { - "description": "Whether to exclude seed list for audience expansion.", + "description": "Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources.", + "readOnly": true, "type": "boolean" }, "enableOptimizedTargeting": { @@ -21441,7 +21441,7 @@ "id": "VideoPlayerSizeAssignedTargetingOptionDetails", "properties": { "videoPlayerSize": { - "description": "The video player size. Output only in v1. Required in v2.", + "description": "Required. The video player size.", "enum": [ "VIDEO_PLAYER_SIZE_UNSPECIFIED", "VIDEO_PLAYER_SIZE_SMALL", @@ -21492,7 +21492,7 @@ "id": "ViewabilityAssignedTargetingOptionDetails", "properties": { "viewability": { - "description": "The predicted viewability percentage. Output only in v1. Required in v2.", + "description": "Required. The predicted viewability percentage.", "enum": [ "VIEWABILITY_UNSPECIFIED", "VIEWABILITY_10_PERCENT_OR_MORE", @@ -21563,7 +21563,7 @@ "id": "YoutubeAndPartnersBiddingStrategy", "properties": { "adGroupEffectiveTargetCpaSource": { - "description": "Output only. Source of the effective targetCpa value for AdGroup.", + "description": "Output only. Source of the effective target CPA value for ad group.", "enum": [ "BIDDING_SOURCE_UNSPECIFIED", "BIDDING_SOURCE_LINE_ITEM", @@ -21572,13 +21572,13 @@ "enumDescriptions": [ "Bidding source is not specified or unknown.", "Bidding value is inherited from the line item.", - "Bidding value is defined on the ad group." + "Bidding value is defined in the ad group." ], "readOnly": true, "type": "string" }, "adGroupEffectiveTargetCpaValue": { - "description": "Output only. The effective targetCpa for AdGroup, in micros of advertiser's currency.", + "description": "Output only. The effective target CPA for ad group, in micros of advertiser's currency.", "format": "int64", "readOnly": true, "type": "string" @@ -21624,7 +21624,7 @@ "id": "YoutubeAndPartnersInventorySourceConfig", "properties": { "includeYoutube": { - "description": "Whether to target inventory on YouTube. This is a consolidation of the search and video networks - see go/dv3-yt-oyn-dd for more details.", + "description": "Whether to target inventory on YouTube. This includes both search, channels and videos.", "type": "boolean" }, "includeYoutubeVideoPartners": { diff --git a/displayvideo/v3/displayvideo-gen.go b/displayvideo/v3/displayvideo-gen.go index c7dc170652c..d3e93ee1f52 100644 --- a/displayvideo/v3/displayvideo-gen.go +++ b/displayvideo/v3/displayvideo-gen.go @@ -872,8 +872,8 @@ type AdGroup struct { // to. AdvertiserId int64 `json:"advertiserId,omitempty,string"` - // BidStrategy: The bidding strategy used by the ad group. Only - // BiddingStrategy.youtube_and_partners_bid can be used here. + // BidStrategy: The bidding strategy used by the ad group. Only the + // youtubeAndPartnersBid field can be used in the bidding strategy. BidStrategy *BiddingStrategy `json:"bidStrategy,omitempty"` // DisplayName: The display name of the ad group. Must be UTF-8 encoded @@ -911,10 +911,9 @@ type AdGroup struct { // ProductFeedData: The settings of the product feed in this ad group. ProductFeedData *ProductFeedData `json:"productFeedData,omitempty"` - // TargetingExpansion: The targeting expansion - // (https://support.google.com/displayvideo/answer/10191558) settings of - // the ad group. This config is only applicable when eligible audience - // list targeting is assigned to the ad group. + // TargetingExpansion: The optimized targeting + // (//support.google.com/displayvideo/answer/12060859) settings of the + // ad group. TargetingExpansion *TargetingExpansionConfig `json:"targetingExpansion,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1049,8 +1048,7 @@ func (s *AdGroupAd) MarshalJSON() ([]byte, error) { } // AdGroupAssignedTargetingOption: Wrapper object associating an -// assigned_targeting_option resource and the ad group it is assigned -// to. +// AssignedTargetingOption resource and the ad group it is assigned to. type AdGroupAssignedTargetingOption struct { // AdGroupId: The ID of the ad group the assigned targeting option is // assigned to. @@ -1177,7 +1175,7 @@ type Advertiser struct { // by the system. AdvertiserId int64 `json:"advertiserId,omitempty,string"` - // BillingConfig: Billing related settings of the advertiser. + // BillingConfig: Required. Billing related settings of the advertiser. BillingConfig *AdvertiserBillingConfig `json:"billingConfig,omitempty"` // CreativeConfig: Required. Creative related settings of the @@ -1313,8 +1311,7 @@ func (s *AdvertiserAdServerConfig) MarshalJSON() ([]byte, error) { // AdvertiserBillingConfig: Billing related settings of an advertiser. type AdvertiserBillingConfig struct { // BillingProfileId: The ID of a billing profile assigned to the - // advertiser. This field will default to the default billing profile ID - // of the advertiser's parent partner if a value is not provided. + // advertiser. BillingProfileId int64 `json:"billingProfileId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "BillingProfileId") to @@ -1558,12 +1555,12 @@ func (s *AdvertiserTargetingConfig) MarshalJSON() ([]byte, error) { // AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_AGE_RANGE`. type AgeRangeAssignedTargetingOptionDetails struct { - // AgeRange: The age range of an audience. We only support targeting a - // continuous age range of an audience. Thus, the age range represented - // in this field can be 1) targeted solely, or, 2) part of a larger - // continuous age range. The reach of a continuous age range targeting - // can be expanded by also targeting an audience of an unknown age. - // Output only in v1. Required in v2. + // AgeRange: Required. The age range of an audience. We only support + // targeting a continuous age range of an audience. Thus, the age range + // represented in this field can be 1) targeted solely, or, 2) part of a + // larger continuous age range. The reach of a continuous age range + // targeting can be expanded by also targeting an audience of an unknown + // age. // // Possible values: // "AGE_RANGE_UNSPECIFIED" - Default value when age range is not @@ -1751,13 +1748,12 @@ type AlgorithmRulesComparisonValue struct { // "RULE_DEVICE_TYPE_UNSPECIFIED" - Default value when device type is // not specified in this version. This enum is a placeholder for default // value and does not represent a real device type option. - // "RULE_DEVICE_TYPE_COMPUTER" - The device type is computer. - // "RULE_DEVICE_TYPE_CONNECTED_TV" - The device type is connected TV. - // "RULE_DEVICE_TYPE_SMART_PHONE" - The device type is smart phone. - // "RULE_DEVICE_TYPE_TABLET" - The device type is tablet. - // "RULE_DEVICE_TYPE_CONNECTED_DEVICE" - The device type is connected - // device. - // "RULE_DEVICE_TYPE_SET_TOP_BOX" - The device type is set top box. + // "RULE_DEVICE_TYPE_COMPUTER" - Computer. + // "RULE_DEVICE_TYPE_CONNECTED_TV" - Connected TV. + // "RULE_DEVICE_TYPE_SMART_PHONE" - Smart phone. + // "RULE_DEVICE_TYPE_TABLET" - Tablet. + // "RULE_DEVICE_TYPE_CONNECTED_DEVICE" - Connected device. + // "RULE_DEVICE_TYPE_SET_TOP_BOX" - Set top box. DeviceTypeValue string `json:"deviceTypeValue,omitempty"` // DoubleValue: Double value. @@ -2054,29 +2050,29 @@ type AlgorithmRulesSignal struct { // Possible values: // "IMPRESSION_SIGNAL_UNSPECIFIED" - Unknown signal. // "DAY_AND_TIME" - The day of the week and hour of day the impression - // was made using browser's local time zone. Value is stored in - // day_and_time_value field of `AlgorithmComparisonValue`. - // "DEVICE_TYPE" - Device type. Value is stored in device_type_value - // field of `AlgorithmComparisonValue`. - // "AD_POSITION" - Ad position. Value is stored in - // on_screen_position_value field of `AlgorithmComparisonValue`. + // was made using browser's local time zone. Value is stored in the + // dayAndTimeValue field of the comparison value. + // "DEVICE_TYPE" - Device type. Value is stored in the deviceTypeValue + // field of the comparison value. + // "AD_POSITION" - Ad position. Value is stored in the + // onScreenPositionValue field of the comparison value. // "OPERATING_SYSTEM_ID" - The operating system identifier. Value is - // stored in int64_value field of `AlgorithmComparisonValue`. + // stored in the int64Value field of the comparison value. // "MOBILE_MODEL_ID" - The mobile model identifier. Value is stored in - // int64_value field of `AlgorithmComparisonValue`. - // "EXCHANGE_ID" - The exchange identifier. Value is stored in - // int64_value field of `AlgorithmComparisonValue`. - // "ENVIRONMENT" - Serving environment. Value is stored in - // environment_value field of `AlgorithmComparisonValue`. + // the int64Value field of the comparison value. + // "EXCHANGE_ID" - The exchange identifier. Value is stored in the + // int64Value field of the comparison value. + // "ENVIRONMENT" - Serving environment. Value is stored in the + // environmentValue field of the comparison value. // "COUNTRY_ID" - The country or region identifier. Value is stored in - // int64_value field of `AlgorithmComparisonValue`. - // "CITY_ID" - The city identifier. Value is stored in int64_value - // field of `AlgorithmComparisonValue`. - // "BROWSER_ID" - The browser identifier. Value is stored in - // int64_value field of `AlgorithmComparisonValue`. + // the int64Value field of the comparison value. + // "CITY_ID" - The city identifier. Value is stored in the int64Value + // field of the comparison value. + // "BROWSER_ID" - The browser identifier. Value is stored in the + // int64Value field of the comparison value. // "CREATIVE_DIMENSION" - Creative height and width in pixels. Value - // is stored in creative_dimension_value field of - // `AlgorithmComparisonValue`. + // is stored in the creativeDimensionValue field of the comparison + // value. ImpressionSignal string `json:"impressionSignal,omitempty"` // ForceSendFields is a list of field names (e.g. "ImpressionSignal") to @@ -2516,8 +2512,7 @@ func (s *AssignedInventorySource) MarshalJSON() ([]byte, error) { } // AssignedLocation: An assignment between a location list and a -// relevant targeting option. Currently, geo region targeting options -// are the only supported option for assignment. +// relevant targeting option. type AssignedLocation struct { // AssignedLocationId: Output only. The unique ID of the assigned // location. The ID is only unique within a location list. It may be @@ -2528,10 +2523,7 @@ type AssignedLocation struct { Name string `json:"name,omitempty"` // TargetingOptionId: Required. The ID of the targeting option assigned - // to the location list. Assigned locations can only be modified in - // TARGETING_LOCATION_TYPE_REGIONAL location lists. When creating or - // deleting assigned locations, this value must be of type - // TARGETING_TYPE_GEO_REGION. + // to the location list. TargetingOptionId string `json:"targetingOptionId,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -3196,8 +3188,7 @@ func (s *AudioAd) MarshalJSON() ([]byte, error) { // is not supported. Remove all audio content type targeting options to // achieve this effect. type AudioContentTypeAssignedTargetingOptionDetails struct { - // AudioContentType: The audio content type. Output only in v1. Required - // in v2. + // AudioContentType: Required. The audio content type. // // Possible values: // "AUDIO_CONTENT_TYPE_UNSPECIFIED" - Audio content type is not @@ -3527,7 +3518,7 @@ type BiddingStrategy struct { // YoutubeAndPartnersBid: A bid strategy used by YouTube and Partners // resources. It can only be used for a YouTube and Partners line item - // and ad group entity. + // or ad group entity. YoutubeAndPartnersBid *YoutubeAndPartnersBiddingStrategy `json:"youtubeAndPartnersBid,omitempty"` // ForceSendFields is a list of field names (e.g. "FixedBid") to @@ -3836,11 +3827,11 @@ func (s *BulkEditAssignedInventorySourcesResponse) MarshalJSON() ([]byte, error) // AssignedLocationService.BulkEditAssignedLocations. type BulkEditAssignedLocationsRequest struct { // CreatedAssignedLocations: The assigned locations to create in bulk, - // specified as a list of AssignedLocations. + // specified as a list of AssignedLocation resources. CreatedAssignedLocations []*AssignedLocation `json:"createdAssignedLocations,omitempty"` // DeletedAssignedLocations: The IDs of the assigned locations to delete - // in bulk, specified as a list of assigned_location_ids. + // in bulk, specified as a list of assignedLocationId values. DeletedAssignedLocations googleapi.Int64s `json:"deletedAssignedLocations,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -3868,8 +3859,6 @@ func (s *BulkEditAssignedLocationsRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// BulkEditAssignedLocationsResponse: Response message for -// AssignedLocationService.BulkEditAssignedLocations. type BulkEditAssignedLocationsResponse struct { // AssignedLocations: The list of assigned locations that have been // successfully created. This list will be absent if empty. @@ -4336,8 +4325,7 @@ type BulkListAdGroupAssignedTargetingOptionsResponse struct { // value should be specified as the pageToken in a subsequent call to // `BulkListAdGroupAssignedTargetingOptions` to fetch the next page of // results. This token will be absent if there are no more - // youtube_ad_group_assigned_targeting_options or - // ad_group_assigned_targeting_options to return. + // AdGroupAssignedTargetingOption resources to return. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -5865,8 +5853,8 @@ type ContentInstreamPositionAssignedTargetingOptionDetails struct { // audio content. AdType string `json:"adType,omitempty"` - // ContentInstreamPosition: The content instream position for video or - // audio ads. Output only in v1. Required in v2. + // ContentInstreamPosition: Required. The content instream position for + // video or audio ads. // // Possible values: // "CONTENT_INSTREAM_POSITION_UNSPECIFIED" - Content instream position @@ -5975,8 +5963,7 @@ type ContentOutstreamPositionAssignedTargetingOptionDetails struct { // audio content. AdType string `json:"adType,omitempty"` - // ContentOutstreamPosition: The content outstream position. Output only - // in v1. Required in v2. + // ContentOutstreamPosition: Required. The content outstream position. // // Possible values: // "CONTENT_OUTSTREAM_POSITION_UNSPECIFIED" - Content outstream @@ -7059,7 +7046,10 @@ type CustomBiddingAlgorithm struct { // product. // "GOAL_BUILDER_BASED" - Algorithm created through goal builder in // DV3 UI. - // "RULE_BASED" - Rule based algorithm. + // "RULE_BASED" - Algorithm based in defined rules. These rules are + // defined in the API using the AlgorithmRules object. This algorithm + // type is only available to allowlisted customers. Other customers + // attempting to use this type will receive an error. CustomBiddingAlgorithmType string `json:"customBiddingAlgorithmType,omitempty"` // DisplayName: Required. The display name of the custom bidding @@ -7246,7 +7236,7 @@ func (s *CustomBiddingAlgorithmRulesError) MarshalJSON() ([]byte, error) { // CustomBiddingAlgorithmRulesRef: The reference to the uploaded // AlgorithmRules file. Retrieve the location to upload new -// AlgorithmRules file to using customBiddingAlgoirhtms.uploadRules +// AlgorithmRules file to using customBiddingAlgorithms.uploadRules. type CustomBiddingAlgorithmRulesRef struct { // ResourceName: A resource name to be used in media.download to // download the rules files. Or media.upload to upload the rules files. @@ -7303,9 +7293,9 @@ type CustomBiddingModelDetails struct { // has not been provided with which to train the model. This state will // only be applied to algorithms whose `custom_bidding_algorithm_type` // is `SCRIPT_BASED`. - // "READINESS_STATE_EVALUATION_FAILURE" - Valid script was provided - // but evaluation have failed. Currently this is only applicable for - // scripts that could not be evaluated in alloted time. + // "READINESS_STATE_EVALUATION_FAILURE" - A valid script was provided + // but failed evaluation. This is applicable for scripts that could not + // be evaluated in the alloted time. ReadinessState string `json:"readinessState,omitempty"` // SuspensionState: Output only. The suspension state of custom bidding @@ -7368,8 +7358,7 @@ type CustomBiddingScript struct { CustomBiddingScriptId int64 `json:"customBiddingScriptId,omitempty,string"` // Errors: Output only. Error details of a rejected custom bidding - // script. This field will only be populated when Script.state is - // REJECTED. + // script. This field will only be populated when state is REJECTED. Errors []*ScriptError `json:"errors,omitempty"` // Name: Output only. The resource name of the custom bidding script. @@ -8013,17 +8002,16 @@ func (s *DeviceMakeModelTargetingOptionDetails) MarshalJSON() ([]byte, error) { // AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_DEVICE_TYPE`. type DeviceTypeAssignedTargetingOptionDetails struct { - // DeviceType: The display name of the device type. Output only in v1. - // Required in v2. + // DeviceType: Required. The display name of the device type. // // Possible values: // "DEVICE_TYPE_UNSPECIFIED" - Default value when device type is not // specified in this version. This enum is a placeholder for default // value and does not represent a real device type option. - // "DEVICE_TYPE_COMPUTER" - The device type is computer. - // "DEVICE_TYPE_CONNECTED_TV" - The device type is connected TV. - // "DEVICE_TYPE_SMART_PHONE" - The device type is smart phone.. - // "DEVICE_TYPE_TABLET" - The device type is tablet. + // "DEVICE_TYPE_COMPUTER" - Computer. + // "DEVICE_TYPE_CONNECTED_TV" - Connected TV. + // "DEVICE_TYPE_SMART_PHONE" - Smart phone. + // "DEVICE_TYPE_TABLET" - Tablet. DeviceType string `json:"deviceType,omitempty"` // YoutubeAndPartnersBidMultiplier: Output only. Bid multiplier allows @@ -8083,10 +8071,10 @@ type DeviceTypeTargetingOptionDetails struct { // "DEVICE_TYPE_UNSPECIFIED" - Default value when device type is not // specified in this version. This enum is a placeholder for default // value and does not represent a real device type option. - // "DEVICE_TYPE_COMPUTER" - The device type is computer. - // "DEVICE_TYPE_CONNECTED_TV" - The device type is connected TV. - // "DEVICE_TYPE_SMART_PHONE" - The device type is smart phone.. - // "DEVICE_TYPE_TABLET" - The device type is tablet. + // "DEVICE_TYPE_COMPUTER" - Computer. + // "DEVICE_TYPE_CONNECTED_TV" - Connected TV. + // "DEVICE_TYPE_SMART_PHONE" - Smart phone. + // "DEVICE_TYPE_TABLET" - Tablet. DeviceType string `json:"deviceType,omitempty"` // ForceSendFields is a list of field names (e.g. "DeviceType") to @@ -8972,8 +8960,7 @@ type Empty struct { // of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_ENVIRONMENT`. type EnvironmentAssignedTargetingOptionDetails struct { - // Environment: The serving environment. Output only in v1. Required in - // v2. + // Environment: Required. The serving environment. // // Possible values: // "ENVIRONMENT_UNSPECIFIED" - Default value when environment is not @@ -10062,8 +10049,7 @@ func (s *FrequencyCap) MarshalJSON() ([]byte, error) { // AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_GENDER`. type GenderAssignedTargetingOptionDetails struct { - // Gender: The gender of the audience. Output only in v1. Required in - // v2. + // Gender: Required. The gender of the audience. // // Possible values: // "GENDER_UNSPECIFIED" - Default value when gender is not specified @@ -10214,12 +10200,12 @@ type GenerateDefaultLineItemRequest struct { // aim to get more views with a variety of ad formats. Line items of // this type and their targeting cannot be created or updated using the // API. - // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Digital display out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. - // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Digital video out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. + // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Display ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. + // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Video ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. LineItemType string `json:"lineItemType,omitempty"` // MobileApp: The mobile app promoted by the line item. This is @@ -10846,8 +10832,7 @@ func (s *GuaranteedOrderStatus) MarshalJSON() ([]byte, error) { // details field of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_HOUSEHOLD_INCOME`. type HouseholdIncomeAssignedTargetingOptionDetails struct { - // HouseholdIncome: The household income of the audience. Output only in - // v1. Required in v2. + // HouseholdIncome: Required. The household income of the audience. // // Possible values: // "HOUSEHOLD_INCOME_UNSPECIFIED" - Default value when household @@ -11138,7 +11123,8 @@ type InsertionOrder struct { IntegrationDetails *IntegrationDetails `json:"integrationDetails,omitempty"` // Kpi: Required. The key performance indicator (KPI) of the insertion - // order. + // order. This is represented as referred to as the "Goal" in the + // Display & Video 360 interface. Kpi *Kpi `json:"kpi,omitempty"` // Name: Output only. The resource name of the insertion order. @@ -11214,14 +11200,14 @@ type InsertionOrderBudget struct { // automation option is not specified or is unknown in this version. // "INSERTION_ORDER_AUTOMATION_TYPE_BUDGET" - Automatic budget // allocation. Allow the system to automatically shift budget to owning - // line items to optimize performance defined by performance_goal. No - // automation on bid settings. + // line items to optimize performance defined by kpi. No automation on + // bid settings. // "INSERTION_ORDER_AUTOMATION_TYPE_NONE" - No automation of bid or // budget on insertion order level. Bid and budget must be manually // configured at the line item level. // "INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET" - Allow the system to // automatically adjust bids and shift budget to owning line items to - // optimize performance defined by performance_goal. + // optimize performance defined by kpi. AutomationType string `json:"automationType,omitempty"` // BudgetSegments: Required. The list of budget segments. Use a budget @@ -12324,7 +12310,7 @@ type Kpi struct { // KpiString: A KPI string, which can be empty. Must be UTF-8 encoded // with a length of no more than 100 characters. Applicable when - // kpi_type][Kpi.kpi_type] is `KPI_TYPE_OTHER`. + // kpi_type is `KPI_TYPE_OTHER`. KpiString string `json:"kpiString,omitempty"` // KpiType: Required. The type of KPI. @@ -12594,12 +12580,12 @@ type LineItem struct { // aim to get more views with a variety of ad formats. Line items of // this type and their targeting cannot be created or updated using the // API. - // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Digital display out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. - // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Digital video out of home. - // Line items of this type and their targeting cannot be created or - // updated using the API. + // "LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME" - Display ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. + // "LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME" - Video ads served on + // digital-out-of-home inventory. Line items of this type and their + // targeting cannot be created or updated using the API. LineItemType string `json:"lineItemType,omitempty"` // MobileApp: The mobile app promoted by the line item. This is @@ -12911,7 +12897,7 @@ type ListAdGroupAssignedTargetingOptionsResponse struct { // value should be specified as the pageToken in a subsequent // ListAdGroupAssignedTargetingOptionsRequest to fetch the next page of // results. This token will be absent if there are no more - // assigned_targeting_options to return. + // AssignedTargetingOption resources to return. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -13331,8 +13317,6 @@ func (s *ListCreativesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ListCustomBiddingAlgorithmRulesResponse: Response message for -// CustomBiddingAlgorithmRulesService.ListCustomBiddingAlgorithmRules. type ListCustomBiddingAlgorithmRulesResponse struct { // CustomBiddingRules: The list of CustomBiddingAlgorithmRules // resources. This list will be absent if empty. @@ -14610,8 +14594,7 @@ func (s *Money) MarshalJSON() ([]byte, error) { // Explicitly targeting all options is not supported. Remove all native // content position targeting options to achieve this effect. type NativeContentPositionAssignedTargetingOptionDetails struct { - // ContentPosition: The content position. Output only in v1. Required in - // v2. + // ContentPosition: Required. The content position. // // Possible values: // "NATIVE_CONTENT_POSITION_UNSPECIFIED" - Native content position is @@ -14939,8 +14922,7 @@ func (s *ObaIcon) MarshalJSON() ([]byte, error) { // details field of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_OMID`. type OmidAssignedTargetingOptionDetails struct { - // Omid: The type of Open Measurement enabled inventory. Output only in - // v1. Required in v2. + // Omid: Required. The type of Open Measurement enabled inventory. // // Possible values: // "OMID_UNSPECIFIED" - Default value when omid targeting is not @@ -15269,8 +15251,8 @@ type Pacing struct { // PacingPeriod: Required. The time period in which the pacing budget // will be spent. When automatic budget allocation is enabled at the - // insertion order via auto_budget_allocation, this field is output only - // and defaults to `PACING_PERIOD_FLIGHT`. + // insertion order via automationType, this field is output only and + // defaults to `PACING_PERIOD_FLIGHT`. // // Possible values: // "PACING_PERIOD_UNSPECIFIED" - Period value is not specified or is @@ -15399,8 +15381,7 @@ func (s *ParentEntityFilter) MarshalJSON() ([]byte, error) { // details field of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_PARENTAL_STATUS`. type ParentalStatusAssignedTargetingOptionDetails struct { - // ParentalStatus: The parental status of the audience. Output only in - // v1. Required in v2. + // ParentalStatus: Required. The parental status of the audience. // // Possible values: // "PARENTAL_STATUS_UNSPECIFIED" - Default value when parental status @@ -15876,7 +15857,7 @@ func (s *PartnerRevenueModel) MarshalJSON() ([]byte, error) { } // PerformanceGoal: Settings that control the performance goal of a -// campaign or insertion order. +// campaign. type PerformanceGoal struct { // PerformanceGoalAmountMicros: The goal amount, in micros of the // advertiser's currency. Applicable when performance_goal_type is one @@ -17483,8 +17464,9 @@ func (s *TargetFrequency) MarshalJSON() ([]byte, error) { // targeting (//support.google.com/displayvideo/answer/12060859) // settings of the line item. type TargetingExpansionConfig struct { - // AudienceExpansionLevel: Magnitude of expansion for eligible 1p user - // list under this ad group. + // AudienceExpansionLevel: Output only. Magnitude of expansion for + // eligible first-party user lists under this ad group. This field only + // applies to YouTube and Partners line item and ad group resources. // // Possible values: // "UNKNOWN" - Audience expansion level is not specified or is unknown @@ -17495,8 +17477,9 @@ type TargetingExpansionConfig struct { // "MOST_REACH" - Aggressive audience expansion. AudienceExpansionLevel string `json:"audienceExpansionLevel,omitempty"` - // AudienceExpansionSeedListExcluded: Whether to exclude seed list for - // audience expansion. + // AudienceExpansionSeedListExcluded: Output only. Whether to exclude + // seed list for audience expansion. This field only applies to YouTube + // and Partners line item and ad group resources. AudienceExpansionSeedListExcluded bool `json:"audienceExpansionSeedListExcluded,omitempty"` // EnableOptimizedTargeting: Required. Whether to enable Optimized @@ -18632,8 +18615,7 @@ func (s *VideoPerformanceAd) MarshalJSON() ([]byte, error) { // is not supported. Remove all video player size targeting options to // achieve this effect. type VideoPlayerSizeAssignedTargetingOptionDetails struct { - // VideoPlayerSize: The video player size. Output only in v1. Required - // in v2. + // VideoPlayerSize: Required. The video player size. // // Possible values: // "VIDEO_PLAYER_SIZE_UNSPECIFIED" - Video player size is not @@ -18728,8 +18710,7 @@ func (s *VideoPlayerSizeTargetingOptionDetails) MarshalJSON() ([]byte, error) { // viewability_details field of an AssignedTargetingOption when // targeting_type is `TARGETING_TYPE_VIEWABILITY`. type ViewabilityAssignedTargetingOptionDetails struct { - // Viewability: The predicted viewability percentage. Output only in v1. - // Required in v2. + // Viewability: Required. The predicted viewability percentage. // // Possible values: // "VIEWABILITY_UNSPECIFIED" - Default value when viewability is not @@ -18836,19 +18817,19 @@ func (s *ViewabilityTargetingOptionDetails) MarshalJSON() ([]byte, error) { // strategy for YouTube and Partners resources. type YoutubeAndPartnersBiddingStrategy struct { // AdGroupEffectiveTargetCpaSource: Output only. Source of the effective - // targetCpa value for AdGroup. + // target CPA value for ad group. // // Possible values: // "BIDDING_SOURCE_UNSPECIFIED" - Bidding source is not specified or // unknown. // "BIDDING_SOURCE_LINE_ITEM" - Bidding value is inherited from the // line item. - // "BIDDING_SOURCE_AD_GROUP" - Bidding value is defined on the ad + // "BIDDING_SOURCE_AD_GROUP" - Bidding value is defined in the ad // group. AdGroupEffectiveTargetCpaSource string `json:"adGroupEffectiveTargetCpaSource,omitempty"` - // AdGroupEffectiveTargetCpaValue: Output only. The effective targetCpa - // for AdGroup, in micros of advertiser's currency. + // AdGroupEffectiveTargetCpaValue: Output only. The effective target CPA + // for ad group, in micros of advertiser's currency. AdGroupEffectiveTargetCpaValue int64 `json:"adGroupEffectiveTargetCpaValue,omitempty,string"` // Type: The type of the bidding strategy. @@ -18924,9 +18905,8 @@ func (s *YoutubeAndPartnersBiddingStrategy) MarshalJSON() ([]byte, error) { // YouTube related inventories the YouTube and Partners line item will // target. type YoutubeAndPartnersInventorySourceConfig struct { - // IncludeYoutube: Whether to target inventory on YouTube. This is a - // consolidation of the search and video networks - see go/dv3-yt-oyn-dd - // for more details. + // IncludeYoutube: Whether to target inventory on YouTube. This includes + // both search, channels and videos. IncludeYoutube bool `json:"includeYoutube,omitempty"` // IncludeYoutubeVideoPartners: Whether to target inventory on a @@ -20931,7 +20911,7 @@ type AdvertisersAdGroupsBulkListAdGroupAssignedTargetingOptionsCall struct { } // BulkListAdGroupAssignedTargetingOptions: Lists assigned targeting -// options for multiple ad groups across targeting types. Inherieted +// options for multiple ad groups across targeting types. Inherited // assigned targeting options are not included. // // - advertiserId: The ID of the advertiser the line items belongs to. @@ -20971,8 +20951,7 @@ func (c *AdvertisersAdGroupsBulkListAdGroupAssignedTargetingOptionsCall) Filter( } // OrderBy sets the optional parameter "orderBy": Field by which to sort -// the list. Acceptable values are: * `youtubeAdGroupId` (acceptable in -// v2) * `adGroupId` (acceptable in v3) * +// the list. Acceptable values are: * `adGroupId` (default) * // `assignedTargetingOption.targetingType` The default sorting order is // ascending. To specify descending order for a field, a suffix "desc" // should be added to the field name. Example: `targetingType desc`. @@ -21103,7 +21082,7 @@ func (c *AdvertisersAdGroupsBulkListAdGroupAssignedTargetingOptionsCall) Do(opts } return ret, nil // { - // "description": "Lists assigned targeting options for multiple ad groups across targeting types. Inherieted assigned targeting options are not included.", + // "description": "Lists assigned targeting options for multiple ad groups across targeting types. Inherited assigned targeting options are not included.", // "flatPath": "v3/advertisers/{advertisersId}/adGroups:bulkListAdGroupAssignedTargetingOptions", // "httpMethod": "GET", // "id": "displayvideo.advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions", @@ -21132,7 +21111,7 @@ func (c *AdvertisersAdGroupsBulkListAdGroupAssignedTargetingOptionsCall) Do(opts // "type": "string" // }, // "orderBy": { - // "description": "Optional. Field by which to sort the list. Acceptable values are: * `youtubeAdGroupId` (acceptable in v2) * `adGroupId` (acceptable in v3) * `assignedTargetingOption.targetingType` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `targetingType desc`.", + // "description": "Optional. Field by which to sort the list. Acceptable values are: * `adGroupId` (default) * `assignedTargetingOption.targetingType` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `targetingType desc`.", // "location": "query", // "type": "string" // }, @@ -33558,10 +33537,8 @@ type AdvertisersLocationListsAssignedLocationsBulkEditCall struct { // BulkEdit: Bulk edits multiple assignments between locations and a // single location list. The operation will delete the assigned -// locations provided in -// BulkEditAssignedLocationsRequest.deleted_assigned_locations and then -// create the assigned locations provided in -// BulkEditAssignedLocationsRequest.created_assigned_locations. +// locations provided in deletedAssignedLocations and then create the +// assigned locations provided in createdAssignedLocations. // // - advertiserId: The ID of the DV360 advertiser to which the location // list belongs. @@ -33668,7 +33645,7 @@ func (c *AdvertisersLocationListsAssignedLocationsBulkEditCall) Do(opts ...googl } return ret, nil // { - // "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in BulkEditAssignedLocationsRequest.deleted_assigned_locations and then create the assigned locations provided in BulkEditAssignedLocationsRequest.created_assigned_locations.", + // "description": "Bulk edits multiple assignments between locations and a single location list. The operation will delete the assigned locations provided in deletedAssignedLocations and then create the assigned locations provided in createdAssignedLocations.", // "flatPath": "v3/advertisers/{advertiserId}/locationLists/{locationListsId}/assignedLocations:bulkEdit", // "httpMethod": "POST", // "id": "displayvideo.advertisers.locationLists.assignedLocations.bulkEdit", @@ -38278,10 +38255,11 @@ type CustomBiddingAlgorithmsUploadRulesCall struct { header_ http.Header } -// UploadRules: Creates a rules reference object. The resulting -// reference object provides a resource path where the rules file should -// be uploaded. This reference object should be included when creating a -// new rules resource. +// UploadRules: Creates a rules reference object for an AlgorithmRules +// file. The resulting reference object provides a resource path where +// the AlgorithmRules file should be uploaded. This reference object +// should be included when creating a new CustomBiddingAlgorithmRules +// resource. // // - customBiddingAlgorithmId: The ID of the custom bidding algorithm // that owns the rules resource. @@ -38404,7 +38382,7 @@ func (c *CustomBiddingAlgorithmsUploadRulesCall) Do(opts ...googleapi.CallOption } return ret, nil // { - // "description": "Creates a rules reference object. The resulting reference object provides a resource path where the rules file should be uploaded. This reference object should be included when creating a new rules resource.", + // "description": "Creates a rules reference object for an AlgorithmRules file. The resulting reference object provides a resource path where the AlgorithmRules file should be uploaded. This reference object should be included when creating a new CustomBiddingAlgorithmRules resource.", // "flatPath": "v3/customBiddingAlgorithms/{customBiddingAlgorithmsId}:uploadRules", // "httpMethod": "GET", // "id": "displayvideo.customBiddingAlgorithms.uploadRules",