diff --git a/adsenseplatform/v1alpha/adsenseplatform-api.json b/adsenseplatform/v1alpha/adsenseplatform-api.json index 61b25cd766..9c1e4bda5a 100644 --- a/adsenseplatform/v1alpha/adsenseplatform-api.json +++ b/adsenseplatform/v1alpha/adsenseplatform-api.json @@ -175,6 +175,53 @@ "https://www.googleapis.com/auth/adsense.readonly" ] } + }, + "resources": { + "childAccounts": { + "resources": { + "sites": { + "methods": { + "list": { + "description": "Lists Platform Child Sites for a specified Platform Child Account.", + "flatPath": "v1alpha/accounts/{accountsId}/platforms/{platformsId}/childAccounts/{childAccountsId}/sites", + "httpMethod": "GET", + "id": "adsenseplatform.accounts.platforms.childAccounts.sites.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of children to include in the response, used for paging. If unspecified, at most 10000 platforms will be returned. The maximum value is 10000; values above 10000 will be coerced to 10000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListPlatformChildren` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPlatformChildren` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The name of the platform to retrieve. Format: accounts/{account}/platforms/{platform}/childAccounts/{child_publisher_code}", + "location": "path", + "pattern": "^accounts/[^/]+/platforms/[^/]+/childAccounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/sites", + "response": { + "$ref": "ListPlatformChildSitesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/adsense", + "https://www.googleapis.com/auth/adsense.readonly" + ] + } + } + } + } + } } } } @@ -517,7 +564,7 @@ } } }, - "revision": "20250108", + "revision": "20250114", "rootUrl": "https://adsenseplatform.googleapis.com/", "schemas": { "Account": { @@ -699,6 +746,24 @@ }, "type": "object" }, + "ListPlatformChildSitesResponse": { + "description": "Response definition for the list platform child sites rpc.", + "id": "ListPlatformChildSitesResponse", + "properties": { + "nextPageToken": { + "description": "Continuation token used to page through platforms. To retrieve the next page of the results, set the next request's \"page_token\" value to this.", + "type": "string" + }, + "platformChildSites": { + "description": "The platform child sites returned in this list response.", + "items": { + "$ref": "PlatformChildSite" + }, + "type": "array" + } + }, + "type": "object" + }, "ListPlatformsResponse": { "description": "Response definition for the platform list rpc.", "id": "ListPlatformsResponse", @@ -766,6 +831,26 @@ }, "type": "object" }, + "PlatformChildSite": { + "description": "Representation of a Transparent Platform Child Site.", + "id": "PlatformChildSite", + "properties": { + "domain": { + "description": "Output only. Domain URL of the Platform Child Site. Part of the PlatformChildSite name.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Identifier. Format: accounts/{account}/platforms/{platform}/childAccounts/{child}/sites/{platformChildSite}", + "type": "string" + }, + "platformGroup": { + "description": "Resource name of the Platform Group of the Platform Child Site.", + "type": "string" + } + }, + "type": "object" + }, "RequestSiteReviewResponse": { "description": "Response definition for the site request review rpc.", "id": "RequestSiteReviewResponse", diff --git a/adsenseplatform/v1alpha/adsenseplatform-gen.go b/adsenseplatform/v1alpha/adsenseplatform-gen.go index a15e0ca0cc..7bab3e4f64 100644 --- a/adsenseplatform/v1alpha/adsenseplatform-gen.go +++ b/adsenseplatform/v1alpha/adsenseplatform-gen.go @@ -182,11 +182,35 @@ type AccountsService struct { func NewAccountsPlatformsService(s *Service) *AccountsPlatformsService { rs := &AccountsPlatformsService{s: s} + rs.ChildAccounts = NewAccountsPlatformsChildAccountsService(s) return rs } type AccountsPlatformsService struct { s *Service + + ChildAccounts *AccountsPlatformsChildAccountsService +} + +func NewAccountsPlatformsChildAccountsService(s *Service) *AccountsPlatformsChildAccountsService { + rs := &AccountsPlatformsChildAccountsService{s: s} + rs.Sites = NewAccountsPlatformsChildAccountsSitesService(s) + return rs +} + +type AccountsPlatformsChildAccountsService struct { + s *Service + + Sites *AccountsPlatformsChildAccountsSitesService +} + +func NewAccountsPlatformsChildAccountsSitesService(s *Service) *AccountsPlatformsChildAccountsSitesService { + rs := &AccountsPlatformsChildAccountsSitesService{s: s} + return rs +} + +type AccountsPlatformsChildAccountsSitesService struct { + s *Service } func NewPlatformsService(s *Service) *PlatformsService { @@ -445,6 +469,36 @@ func (s ListAccountsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ListPlatformChildSitesResponse: Response definition for the list platform +// child sites rpc. +type ListPlatformChildSitesResponse struct { + // NextPageToken: Continuation token used to page through platforms. To + // retrieve the next page of the results, set the next request's "page_token" + // value to this. + NextPageToken string `json:"nextPageToken,omitempty"` + // PlatformChildSites: The platform child sites returned in this list response. + PlatformChildSites []*PlatformChildSite `json:"platformChildSites,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "NextPageToken") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListPlatformChildSitesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListPlatformChildSitesResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ListPlatformsResponse: Response definition for the platform list rpc. type ListPlatformsResponse struct { // NextPageToken: Continuation token used to page through platforms. To @@ -559,6 +613,36 @@ func (s Platform) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PlatformChildSite: Representation of a Transparent Platform Child Site. +type PlatformChildSite struct { + // Domain: Output only. Domain URL of the Platform Child Site. Part of the + // PlatformChildSite name. + Domain string `json:"domain,omitempty"` + // Name: Identifier. Format: + // accounts/{account}/platforms/{platform}/childAccounts/{child}/sites/{platform + // ChildSite} + Name string `json:"name,omitempty"` + // PlatformGroup: Resource name of the Platform Group of the Platform Child + // Site. + PlatformGroup string `json:"platformGroup,omitempty"` + // ForceSendFields is a list of field names (e.g. "Domain") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Domain") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PlatformChildSite) MarshalJSON() ([]byte, error) { + type NoMethod PlatformChildSite + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RequestSiteReviewResponse: Response definition for the site request review // rpc. type RequestSiteReviewResponse struct { @@ -898,6 +982,157 @@ func (c *AccountsPlatformsListCall) Pages(ctx context.Context, f func(*ListPlatf } } +type AccountsPlatformsChildAccountsSitesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists Platform Child Sites for a specified Platform Child Account. +// +// - parent: The name of the platform to retrieve. Format: +// accounts/{account}/platforms/{platform}/childAccounts/{child_publisher_code +// }. +func (r *AccountsPlatformsChildAccountsSitesService) List(parent string) *AccountsPlatformsChildAccountsSitesListCall { + c := &AccountsPlatformsChildAccountsSitesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// children to include in the response, used for paging. If unspecified, at +// most 10000 platforms will be returned. The maximum value is 10000; values +// above 10000 will be coerced to 10000. +func (c *AccountsPlatformsChildAccountsSitesListCall) PageSize(pageSize int64) *AccountsPlatformsChildAccountsSitesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListPlatformChildren` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `ListPlatformChildren` must match the call that provided the page token. +func (c *AccountsPlatformsChildAccountsSitesListCall) PageToken(pageToken string) *AccountsPlatformsChildAccountsSitesListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountsPlatformsChildAccountsSitesListCall) Fields(s ...googleapi.Field) *AccountsPlatformsChildAccountsSitesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountsPlatformsChildAccountsSitesListCall) IfNoneMatch(entityTag string) *AccountsPlatformsChildAccountsSitesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountsPlatformsChildAccountsSitesListCall) Context(ctx context.Context) *AccountsPlatformsChildAccountsSitesListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountsPlatformsChildAccountsSitesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsPlatformsChildAccountsSitesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/sites") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "adsenseplatform.accounts.platforms.childAccounts.sites.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "adsenseplatform.accounts.platforms.childAccounts.sites.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListPlatformChildSitesResponse.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 *AccountsPlatformsChildAccountsSitesListCall) Do(opts ...googleapi.CallOption) (*ListPlatformChildSitesResponse, 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 := &ListPlatformChildSitesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "adsenseplatform.accounts.platforms.childAccounts.sites.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// 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 *AccountsPlatformsChildAccountsSitesListCall) Pages(ctx context.Context, f func(*ListPlatformChildSitesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type PlatformsAccountsCloseCall struct { s *Service name string diff --git a/aiplatform/v1/aiplatform-api.json b/aiplatform/v1/aiplatform-api.json index 7d261ba2bc..b6b88d1fe5 100644 --- a/aiplatform/v1/aiplatform-api.json +++ b/aiplatform/v1/aiplatform-api.json @@ -624,7 +624,7 @@ ], "parameters": { "name": { - "description": "Output only. Identifier. The resource name of the DatasetVersion.", + "description": "Output only. Identifier. The resource name of the DatasetVersion. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "location": "path", "pattern": "^datasets/[^/]+/datasetVersions/[^/]+$", "required": true, @@ -3093,7 +3093,7 @@ ], "parameters": { "name": { - "description": "Output only. Identifier. The resource name of the DatasetVersion.", + "description": "Output only. Identifier. The resource name of the DatasetVersion. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/datasetVersions/[^/]+$", "required": true, @@ -19327,7 +19327,7 @@ } } }, - "revision": "20241214", + "revision": "20250107", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -19644,7 +19644,7 @@ "type": "object" }, "CloudAiPlatformCommonCreatePipelineJobApiErrorDetail": { - "description": "Create API error message for Vertex Pipeline. Next Id: 3.", + "description": "Create API error message for Vertex Pipeline.", "id": "CloudAiPlatformCommonCreatePipelineJobApiErrorDetail", "properties": { "errorCause": { @@ -19695,8 +19695,8 @@ "Resolver spec is invalid.", "Runtime Parameters are invalid.", "Cloud API not enabled.", - "Invalid GCS input uri", - "Invalid GCS output uri", + "Invalid Cloud Storage input uri", + "Invalid Cloud Storage output uri", "Component spec of pipeline is invalid.", "DagOutputsSpec is invalid.", "DagSpec is invalid.", @@ -19923,7 +19923,7 @@ "type": "object" }, "GoogleCloudAiplatformV1ApiAuth": { - "description": "The generic reusable api auth config.", + "description": "The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead.", "id": "GoogleCloudAiplatformV1ApiAuth", "properties": { "apiKeyConfig": { @@ -22752,7 +22752,7 @@ "type": "string" }, "name": { - "description": "Output only. Identifier. The resource name of the DatasetVersion.", + "description": "Output only. Identifier. The resource name of the DatasetVersion. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "readOnly": true, "type": "string" }, @@ -31871,8 +31871,7 @@ "type": "string" }, "scheduleResourceName": { - "description": "Output only. The Schedule resource name if this job is triggered by one. Format: `projects/{project_id}/locations/{location}/schedules/{schedule_id}`", - "readOnly": true, + "description": "The Schedule resource name if this job is triggered by one. Format: `projects/{project_id}/locations/{location}/schedules/{schedule_id}`", "type": "string" }, "serviceAccount": { @@ -35460,6 +35459,21 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1RetrievalConfig": { + "description": "Retrieval config.", + "id": "GoogleCloudAiplatformV1RetrievalConfig", + "properties": { + "languageCode": { + "description": "The language code of the user.", + "type": "string" + }, + "latLng": { + "$ref": "GoogleTypeLatLng", + "description": "The location of the user." + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1RetrievalMetadata": { "description": "Metadata related to retrieval in the grounding flow.", "id": "GoogleCloudAiplatformV1RetrievalMetadata", @@ -42728,6 +42742,10 @@ "functionCallingConfig": { "$ref": "GoogleCloudAiplatformV1FunctionCallingConfig", "description": "Optional. Function calling config." + }, + "retrievalConfig": { + "$ref": "GoogleCloudAiplatformV1RetrievalConfig", + "description": "Optional. Retrieval config." } }, "type": "object" @@ -44735,6 +44753,23 @@ }, "type": "object" }, + "GoogleTypeLatLng": { + "description": "An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.", + "id": "GoogleTypeLatLng", + "properties": { + "latitude": { + "description": "The latitude in degrees. It must be in the range [-90.0, +90.0].", + "format": "double", + "type": "number" + }, + "longitude": { + "description": "The longitude in degrees. It must be in the range [-180.0, +180.0].", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, "GoogleTypeMoney": { "description": "Represents an amount of money with its currency type.", "id": "GoogleTypeMoney", diff --git a/aiplatform/v1/aiplatform-gen.go b/aiplatform/v1/aiplatform-gen.go index 9b2cc7adf4..8ebeffab46 100644 --- a/aiplatform/v1/aiplatform-gen.go +++ b/aiplatform/v1/aiplatform-gen.go @@ -1898,7 +1898,7 @@ func (s CloudAiLargeModelsVisionVideo) MarshalJSON() ([]byte, error) { } // CloudAiPlatformCommonCreatePipelineJobApiErrorDetail: Create API error -// message for Vertex Pipeline. Next Id: 3. +// message for Vertex Pipeline. type CloudAiPlatformCommonCreatePipelineJobApiErrorDetail struct { // ErrorCause: The error root cause returned by CreatePipelineJob API. // @@ -1922,8 +1922,8 @@ type CloudAiPlatformCommonCreatePipelineJobApiErrorDetail struct { // "INVALID_RESOLVER_SPEC" - Resolver spec is invalid. // "INVALID_RUNTIME_PARAMETERS" - Runtime Parameters are invalid. // "CLOUD_API_NOT_ENABLED" - Cloud API not enabled. - // "INVALID_GCS_INPUT_URI" - Invalid GCS input uri - // "INVALID_GCS_OUTPUT_URI" - Invalid GCS output uri + // "INVALID_GCS_INPUT_URI" - Invalid Cloud Storage input uri + // "INVALID_GCS_OUTPUT_URI" - Invalid Cloud Storage output uri // "INVALID_COMPONENT_SPEC" - Component spec of pipeline is invalid. // "INVALID_DAG_OUTPUTS_SPEC" - DagOutputsSpec is invalid. // "INVALID_DAG_SPEC" - DagSpec is invalid. @@ -2246,6 +2246,8 @@ func (s GoogleCloudAiplatformV1AnnotationSpec) MarshalJSON() ([]byte, error) { } // GoogleCloudAiplatformV1ApiAuth: The generic reusable api auth config. +// Deprecated. Please use AuthConfig +// (google/cloud/aiplatform/master/auth.proto) instead. type GoogleCloudAiplatformV1ApiAuth struct { // ApiKeyConfig: The API secret. ApiKeyConfig *GoogleCloudAiplatformV1ApiAuthApiKeyConfig `json:"apiKeyConfig,omitempty"` @@ -6356,6 +6358,9 @@ type GoogleCloudAiplatformV1DatasetVersion struct { // the dataset version. Only set for prompt dataset versions. ModelReference string `json:"modelReference,omitempty"` // Name: Output only. Identifier. The resource name of the DatasetVersion. + // Format: + // `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{ + // dataset_version}` Name string `json:"name,omitempty"` // SatisfiesPzi: Output only. Reserved for future use. SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` @@ -19267,8 +19272,8 @@ type GoogleCloudAiplatformV1NotebookExecutionJob struct { // NotebookRuntimeTemplateResourceName: The NotebookRuntimeTemplate to source // compute configuration from. NotebookRuntimeTemplateResourceName string `json:"notebookRuntimeTemplateResourceName,omitempty"` - // ScheduleResourceName: Output only. The Schedule resource name if this job is - // triggered by one. Format: + // ScheduleResourceName: The Schedule resource name if this job is triggered by + // one. Format: // `projects/{project_id}/locations/{location}/schedules/{schedule_id}` ScheduleResourceName string `json:"scheduleResourceName,omitempty"` // ServiceAccount: The service account to run the execution as. @@ -24235,6 +24240,30 @@ func (s GoogleCloudAiplatformV1Retrieval) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1RetrievalConfig: Retrieval config. +type GoogleCloudAiplatformV1RetrievalConfig struct { + // LanguageCode: The language code of the user. + LanguageCode string `json:"languageCode,omitempty"` + // LatLng: The location of the user. + LatLng *GoogleTypeLatLng `json:"latLng,omitempty"` + // ForceSendFields is a list of field names (e.g. "LanguageCode") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "LanguageCode") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1RetrievalConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1RetrievalConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1RetrievalMetadata: Metadata related to retrieval in // the grounding flow. type GoogleCloudAiplatformV1RetrievalMetadata struct { @@ -35278,6 +35307,8 @@ type GoogleCloudAiplatformV1ToolCallValidSpec struct { type GoogleCloudAiplatformV1ToolConfig struct { // FunctionCallingConfig: Optional. Function calling config. FunctionCallingConfig *GoogleCloudAiplatformV1FunctionCallingConfig `json:"functionCallingConfig,omitempty"` + // RetrievalConfig: Optional. Retrieval config. + RetrievalConfig *GoogleCloudAiplatformV1RetrievalConfig `json:"retrievalConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "FunctionCallingConfig") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -38674,6 +38705,50 @@ func (s GoogleTypeInterval) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleTypeLatLng: An object that represents a latitude/longitude pair. This +// is expressed as a pair of doubles to represent degrees latitude and degrees +// longitude. Unless specified otherwise, this object must conform to the WGS84 +// standard. Values must be within normalized ranges. +type GoogleTypeLatLng struct { + // Latitude: The latitude in degrees. It must be in the range [-90.0, +90.0]. + Latitude float64 `json:"latitude,omitempty"` + // Longitude: The longitude in degrees. It must be in the range [-180.0, + // +180.0]. + Longitude float64 `json:"longitude,omitempty"` + // ForceSendFields is a list of field names (e.g. "Latitude") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Latitude") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleTypeLatLng) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeLatLng + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleTypeLatLng) UnmarshalJSON(data []byte) error { + type NoMethod GoogleTypeLatLng + var s1 struct { + Latitude gensupport.JSONFloat64 `json:"latitude"` + Longitude gensupport.JSONFloat64 `json:"longitude"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Latitude = float64(s1.Latitude) + s.Longitude = float64(s1.Longitude) + return nil +} + // GoogleTypeMoney: Represents an amount of money with its currency type. type GoogleTypeMoney struct { // CurrencyCode: The three-letter currency code defined in ISO 4217. @@ -39815,7 +39890,10 @@ type DatasetsDatasetVersionsPatchCall struct { // Patch: Updates a DatasetVersion. // -// - name: Output only. Identifier. The resource name of the DatasetVersion. +// - name: Output only. Identifier. The resource name of the DatasetVersion. +// Format: +// `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions +// /{dataset_version}`. func (r *DatasetsDatasetVersionsService) Patch(name string, googlecloudaiplatformv1datasetversion *GoogleCloudAiplatformV1DatasetVersion) *DatasetsDatasetVersionsPatchCall { c := &DatasetsDatasetVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -48865,7 +48943,10 @@ type ProjectsLocationsDatasetsDatasetVersionsPatchCall struct { // Patch: Updates a DatasetVersion. // -// - name: Output only. Identifier. The resource name of the DatasetVersion. +// - name: Output only. Identifier. The resource name of the DatasetVersion. +// Format: +// `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions +// /{dataset_version}`. func (r *ProjectsLocationsDatasetsDatasetVersionsService) Patch(name string, googlecloudaiplatformv1datasetversion *GoogleCloudAiplatformV1DatasetVersion) *ProjectsLocationsDatasetsDatasetVersionsPatchCall { c := &ProjectsLocationsDatasetsDatasetVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/aiplatform/v1beta1/aiplatform-api.json b/aiplatform/v1beta1/aiplatform-api.json index 9e8e6e39c4..ace3caf56a 100644 --- a/aiplatform/v1beta1/aiplatform-api.json +++ b/aiplatform/v1beta1/aiplatform-api.json @@ -624,7 +624,7 @@ ], "parameters": { "name": { - "description": "Output only. Identifier. The resource name of the DatasetVersion.", + "description": "Output only. Identifier. The resource name of the DatasetVersion. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "location": "path", "pattern": "^datasets/[^/]+/datasetVersions/[^/]+$", "required": true, @@ -3432,7 +3432,7 @@ ], "parameters": { "name": { - "description": "Output only. Identifier. The resource name of the DatasetVersion.", + "description": "Output only. Identifier. The resource name of the DatasetVersion. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/datasetVersions/[^/]+$", "required": true, @@ -21964,7 +21964,7 @@ } } }, - "revision": "20241214", + "revision": "20250107", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -22281,7 +22281,7 @@ "type": "object" }, "CloudAiPlatformCommonCreatePipelineJobApiErrorDetail": { - "description": "Create API error message for Vertex Pipeline. Next Id: 3.", + "description": "Create API error message for Vertex Pipeline.", "id": "CloudAiPlatformCommonCreatePipelineJobApiErrorDetail", "properties": { "errorCause": { @@ -22332,8 +22332,8 @@ "Resolver spec is invalid.", "Runtime Parameters are invalid.", "Cloud API not enabled.", - "Invalid GCS input uri", - "Invalid GCS output uri", + "Invalid Cloud Storage input uri", + "Invalid Cloud Storage output uri", "Component spec of pipeline is invalid.", "DagOutputsSpec is invalid.", "DagSpec is invalid.", @@ -22560,7 +22560,7 @@ "type": "object" }, "GoogleCloudAiplatformV1beta1ApiAuth": { - "description": "The generic reusable api auth config.", + "description": "The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead.", "id": "GoogleCloudAiplatformV1beta1ApiAuth", "properties": { "apiKeyConfig": { @@ -25816,7 +25816,7 @@ "type": "string" }, "name": { - "description": "Output only. Identifier. The resource name of the DatasetVersion.", + "description": "Output only. Identifier. The resource name of the DatasetVersion. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "readOnly": true, "type": "string" }, @@ -26107,7 +26107,7 @@ "type": "string" }, "model": { - "description": "Required. The name of the PublisherModel resource. Format: `publishers/{publisher}/models/{publisher_model}@{version_id}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`", + "description": "Required. The name of the PublisherModel resource. Format: `publishers/{publisher}/models/{publisher_model}@{version_id}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001` or Hugging Face model ID like `google/gemma-2-2b-it`.", "type": "string" }, "modelDisplayName": { @@ -28284,6 +28284,32 @@ "properties": {}, "type": "object" }, + "GoogleCloudAiplatformV1beta1ExportPublisherModelOperationMetadata": { + "description": "Runtime operation information for ModelGardenService.ExportPublisherModel.", + "id": "GoogleCloudAiplatformV1beta1ExportPublisherModelOperationMetadata", + "properties": { + "genericMetadata": { + "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", + "description": "The operation generic information." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1ExportPublisherModelResponse": { + "description": "Response message for ModelGardenService.ExportPublisherModel.", + "id": "GoogleCloudAiplatformV1beta1ExportPublisherModelResponse", + "properties": { + "destinationUri": { + "description": "The destination uri of the model weights.", + "type": "string" + }, + "publisherModel": { + "description": "The name of the PublisherModel resource. Format: `publishers/{publisher}/models/{publisher_model}@{version_id}`", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1ExportTensorboardTimeSeriesDataRequest": { "description": "Request message for TensorboardService.ExportTensorboardTimeSeriesData.", "id": "GoogleCloudAiplatformV1beta1ExportTensorboardTimeSeriesDataRequest", @@ -36644,8 +36670,7 @@ "type": "string" }, "scheduleResourceName": { - "description": "Output only. The Schedule resource name if this job is triggered by one. Format: `projects/{project_id}/locations/{location}/schedules/{schedule_id}`", - "readOnly": true, + "description": "The Schedule resource name if this job is triggered by one. Format: `projects/{project_id}/locations/{location}/schedules/{schedule_id}`", "type": "string" }, "serviceAccount": { @@ -37347,7 +37372,8 @@ "type": "string" }, "thought": { - "description": "Optional. Indicates if the part is thought from the model.", + "description": "Output only. Indicates if the part is thought from the model.", + "readOnly": true, "type": "boolean" }, "videoMetadata": { @@ -40891,6 +40917,21 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1RetrievalConfig": { + "description": "Retrieval config.", + "id": "GoogleCloudAiplatformV1beta1RetrievalConfig", + "properties": { + "languageCode": { + "description": "The language code of the user.", + "type": "string" + }, + "latLng": { + "$ref": "GoogleTypeLatLng", + "description": "The location of the user." + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1RetrievalMetadata": { "description": "Metadata related to retrieval in the grounding flow.", "id": "GoogleCloudAiplatformV1beta1RetrievalMetadata", @@ -48530,6 +48571,10 @@ "functionCallingConfig": { "$ref": "GoogleCloudAiplatformV1beta1FunctionCallingConfig", "description": "Optional. Function calling config." + }, + "retrievalConfig": { + "$ref": "GoogleCloudAiplatformV1beta1RetrievalConfig", + "description": "Optional. Retrieval config." } }, "type": "object" @@ -50697,6 +50742,23 @@ }, "type": "object" }, + "GoogleTypeLatLng": { + "description": "An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.", + "id": "GoogleTypeLatLng", + "properties": { + "latitude": { + "description": "The latitude in degrees. It must be in the range [-90.0, +90.0].", + "format": "double", + "type": "number" + }, + "longitude": { + "description": "The longitude in degrees. It must be in the range [-180.0, +180.0].", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, "GoogleTypeMoney": { "description": "Represents an amount of money with its currency type.", "id": "GoogleTypeMoney", diff --git a/aiplatform/v1beta1/aiplatform-gen.go b/aiplatform/v1beta1/aiplatform-gen.go index cd8efb37b1..00583458f0 100644 --- a/aiplatform/v1beta1/aiplatform-gen.go +++ b/aiplatform/v1beta1/aiplatform-gen.go @@ -2162,7 +2162,7 @@ func (s CloudAiLargeModelsVisionVideo) MarshalJSON() ([]byte, error) { } // CloudAiPlatformCommonCreatePipelineJobApiErrorDetail: Create API error -// message for Vertex Pipeline. Next Id: 3. +// message for Vertex Pipeline. type CloudAiPlatformCommonCreatePipelineJobApiErrorDetail struct { // ErrorCause: The error root cause returned by CreatePipelineJob API. // @@ -2186,8 +2186,8 @@ type CloudAiPlatformCommonCreatePipelineJobApiErrorDetail struct { // "INVALID_RESOLVER_SPEC" - Resolver spec is invalid. // "INVALID_RUNTIME_PARAMETERS" - Runtime Parameters are invalid. // "CLOUD_API_NOT_ENABLED" - Cloud API not enabled. - // "INVALID_GCS_INPUT_URI" - Invalid GCS input uri - // "INVALID_GCS_OUTPUT_URI" - Invalid GCS output uri + // "INVALID_GCS_INPUT_URI" - Invalid Cloud Storage input uri + // "INVALID_GCS_OUTPUT_URI" - Invalid Cloud Storage output uri // "INVALID_COMPONENT_SPEC" - Component spec of pipeline is invalid. // "INVALID_DAG_OUTPUTS_SPEC" - DagOutputsSpec is invalid. // "INVALID_DAG_SPEC" - DagSpec is invalid. @@ -2511,6 +2511,8 @@ func (s GoogleCloudAiplatformV1beta1AnnotationSpec) MarshalJSON() ([]byte, error } // GoogleCloudAiplatformV1beta1ApiAuth: The generic reusable api auth config. +// Deprecated. Please use AuthConfig +// (google/cloud/aiplatform/master/auth.proto) instead. type GoogleCloudAiplatformV1beta1ApiAuth struct { // ApiKeyConfig: The API secret. ApiKeyConfig *GoogleCloudAiplatformV1beta1ApiAuthApiKeyConfig `json:"apiKeyConfig,omitempty"` @@ -7216,6 +7218,9 @@ type GoogleCloudAiplatformV1beta1DatasetVersion struct { // the dataset version. Only set for prompt dataset versions. ModelReference string `json:"modelReference,omitempty"` // Name: Output only. Identifier. The resource name of the DatasetVersion. + // Format: + // `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{ + // dataset_version}` Name string `json:"name,omitempty"` // SatisfiesPzi: Output only. Reserved for future use. SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` @@ -7732,6 +7737,7 @@ type GoogleCloudAiplatformV1beta1DeployPublisherModelRequest struct { // Model: Required. The name of the PublisherModel resource. Format: // `publishers/{publisher}/models/{publisher_model}@{version_id}`, or // `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001` + // or Hugging Face model ID like `google/gemma-2-2b-it`. Model string `json:"model,omitempty"` // ModelDisplayName: Optional. The user-specified display name of the uploaded // model. If not set, a default name will be used. @@ -10704,6 +10710,55 @@ func (s GoogleCloudAiplatformV1beta1ExportModelRequestOutputConfig) MarshalJSON( type GoogleCloudAiplatformV1beta1ExportModelResponse struct { } +// GoogleCloudAiplatformV1beta1ExportPublisherModelOperationMetadata: Runtime +// operation information for ModelGardenService.ExportPublisherModel. +type GoogleCloudAiplatformV1beta1ExportPublisherModelOperationMetadata struct { + // GenericMetadata: The operation generic information. + GenericMetadata *GoogleCloudAiplatformV1beta1GenericOperationMetadata `json:"genericMetadata,omitempty"` + // ForceSendFields is a list of field names (e.g. "GenericMetadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GenericMetadata") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1ExportPublisherModelOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1ExportPublisherModelOperationMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1ExportPublisherModelResponse: Response message +// for ModelGardenService.ExportPublisherModel. +type GoogleCloudAiplatformV1beta1ExportPublisherModelResponse struct { + // DestinationUri: The destination uri of the model weights. + DestinationUri string `json:"destinationUri,omitempty"` + // PublisherModel: The name of the PublisherModel resource. Format: + // `publishers/{publisher}/models/{publisher_model}@{version_id}` + PublisherModel string `json:"publisherModel,omitempty"` + // ForceSendFields is a list of field names (e.g. "DestinationUri") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DestinationUri") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1ExportPublisherModelResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1ExportPublisherModelResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1ExportTensorboardTimeSeriesDataRequest: Request // message for TensorboardService.ExportTensorboardTimeSeriesData. type GoogleCloudAiplatformV1beta1ExportTensorboardTimeSeriesDataRequest struct { @@ -22503,8 +22558,8 @@ type GoogleCloudAiplatformV1beta1NotebookExecutionJob struct { // NotebookRuntimeTemplateResourceName: The NotebookRuntimeTemplate to source // compute configuration from. NotebookRuntimeTemplateResourceName string `json:"notebookRuntimeTemplateResourceName,omitempty"` - // ScheduleResourceName: Output only. The Schedule resource name if this job is - // triggered by one. Format: + // ScheduleResourceName: The Schedule resource name if this job is triggered by + // one. Format: // `projects/{project_id}/locations/{location}/schedules/{schedule_id}` ScheduleResourceName string `json:"scheduleResourceName,omitempty"` // ServiceAccount: The service account to run the execution as. @@ -23358,7 +23413,7 @@ type GoogleCloudAiplatformV1beta1Part struct { InlineData *GoogleCloudAiplatformV1beta1Blob `json:"inlineData,omitempty"` // Text: Optional. Text part (can be code). Text string `json:"text,omitempty"` - // Thought: Optional. Indicates if the part is thought from the model. + // Thought: Output only. Indicates if the part is thought from the model. Thought bool `json:"thought,omitempty"` // VideoMetadata: Optional. Video metadata. The metadata should only be // specified while the video data is presented in inline_data or file_data. @@ -28430,6 +28485,30 @@ func (s GoogleCloudAiplatformV1beta1Retrieval) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1RetrievalConfig: Retrieval config. +type GoogleCloudAiplatformV1beta1RetrievalConfig struct { + // LanguageCode: The language code of the user. + LanguageCode string `json:"languageCode,omitempty"` + // LatLng: The location of the user. + LatLng *GoogleTypeLatLng `json:"latLng,omitempty"` + // ForceSendFields is a list of field names (e.g. "LanguageCode") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "LanguageCode") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1RetrievalConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1RetrievalConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1RetrievalMetadata: Metadata related to retrieval // in the grounding flow. type GoogleCloudAiplatformV1beta1RetrievalMetadata struct { @@ -39995,6 +40074,8 @@ type GoogleCloudAiplatformV1beta1ToolCodeExecution struct { type GoogleCloudAiplatformV1beta1ToolConfig struct { // FunctionCallingConfig: Optional. Function calling config. FunctionCallingConfig *GoogleCloudAiplatformV1beta1FunctionCallingConfig `json:"functionCallingConfig,omitempty"` + // RetrievalConfig: Optional. Retrieval config. + RetrievalConfig *GoogleCloudAiplatformV1beta1RetrievalConfig `json:"retrievalConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "FunctionCallingConfig") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -43627,6 +43708,50 @@ func (s GoogleTypeInterval) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleTypeLatLng: An object that represents a latitude/longitude pair. This +// is expressed as a pair of doubles to represent degrees latitude and degrees +// longitude. Unless specified otherwise, this object must conform to the WGS84 +// standard. Values must be within normalized ranges. +type GoogleTypeLatLng struct { + // Latitude: The latitude in degrees. It must be in the range [-90.0, +90.0]. + Latitude float64 `json:"latitude,omitempty"` + // Longitude: The longitude in degrees. It must be in the range [-180.0, + // +180.0]. + Longitude float64 `json:"longitude,omitempty"` + // ForceSendFields is a list of field names (e.g. "Latitude") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Latitude") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleTypeLatLng) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeLatLng + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleTypeLatLng) UnmarshalJSON(data []byte) error { + type NoMethod GoogleTypeLatLng + var s1 struct { + Latitude gensupport.JSONFloat64 `json:"latitude"` + Longitude gensupport.JSONFloat64 `json:"longitude"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Latitude = float64(s1.Latitude) + s.Longitude = float64(s1.Longitude) + return nil +} + // GoogleTypeMoney: Represents an amount of money with its currency type. type GoogleTypeMoney struct { // CurrencyCode: The three-letter currency code defined in ISO 4217. @@ -44768,7 +44893,10 @@ type DatasetsDatasetVersionsPatchCall struct { // Patch: Updates a DatasetVersion. // -// - name: Output only. Identifier. The resource name of the DatasetVersion. +// - name: Output only. Identifier. The resource name of the DatasetVersion. +// Format: +// `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions +// /{dataset_version}`. func (r *DatasetsDatasetVersionsService) Patch(name string, googlecloudaiplatformv1beta1datasetversion *GoogleCloudAiplatformV1beta1DatasetVersion) *DatasetsDatasetVersionsPatchCall { c := &DatasetsDatasetVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -55097,7 +55225,10 @@ type ProjectsLocationsDatasetsDatasetVersionsPatchCall struct { // Patch: Updates a DatasetVersion. // -// - name: Output only. Identifier. The resource name of the DatasetVersion. +// - name: Output only. Identifier. The resource name of the DatasetVersion. +// Format: +// `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions +// /{dataset_version}`. func (r *ProjectsLocationsDatasetsDatasetVersionsService) Patch(name string, googlecloudaiplatformv1beta1datasetversion *GoogleCloudAiplatformV1beta1DatasetVersion) *ProjectsLocationsDatasetsDatasetVersionsPatchCall { c := &ProjectsLocationsDatasetsDatasetVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json index 49f2aa6c70..bc8afbcf3a 100644 --- a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json +++ b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json @@ -1102,7 +1102,7 @@ ] }, "patch": { - "description": "Updates the proposal at the given revision number. If the revision number in the request is behind the latest one kept in the server, an error message will be returned. See FieldMask for how to use FieldMask. Only fields specified in the UpdateProposalRequest.update_mask will be updated; Fields noted as 'Immutable' or 'Output only' yet specified in the UpdateProposalRequest.update_mask will be ignored and left unchanged. Updating a private auction proposal is not allowed and will result in an error.", + "description": "Updates the proposal at the given revision number. If the revision number in the request is behind the latest one kept in the server, an error message will be returned. See FieldMask for how to use FieldMask. Only fields specified in the UpdateProposalRequest.update_mask will be updated; Fields noted as 'Immutable' or 'Output only' yet specified in the UpdateProposalRequest.update_mask will be ignored and left unchanged. Updating a private auction proposal is only allowed for buyer private data, all other fields are immutable.", "flatPath": "v1/buyers/{buyersId}/proposals/{proposalsId}", "httpMethod": "PATCH", "id": "authorizedbuyersmarketplace.buyers.proposals.patch", @@ -1367,7 +1367,7 @@ } } }, - "revision": "20250107", + "revision": "20250113", "rootUrl": "https://authorizedbuyersmarketplace.googleapis.com/", "schemas": { "AcceptProposalRequest": { @@ -2626,7 +2626,7 @@ "type": "object" }, "PrivateData": { - "description": "Buyers are allowed to store certain types of private data in a proposal or deal.", + "description": "Buyers are allowed to store certain types of private data in a proposal.", "id": "PrivateData", "properties": { "referenceId": { diff --git a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go index 7af42bf37e..3d9f91cd26 100644 --- a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go +++ b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go @@ -1766,7 +1766,7 @@ func (s PrivateAuctionTerms) MarshalJSON() ([]byte, error) { } // PrivateData: Buyers are allowed to store certain types of private data in a -// proposal or deal. +// proposal. type PrivateData struct { // ReferenceId: A buyer specified reference ID. This can be queried in the list // operations (max-length: 1024 unicode code units). @@ -6222,8 +6222,8 @@ type BuyersProposalsPatchCall struct { // fields specified in the UpdateProposalRequest.update_mask will be updated; // Fields noted as 'Immutable' or 'Output only' yet specified in the // UpdateProposalRequest.update_mask will be ignored and left unchanged. -// Updating a private auction proposal is not allowed and will result in an -// error. +// Updating a private auction proposal is only allowed for buyer private data, +// all other fields are immutable. // // - name: Immutable. The name of the proposal serving as a unique identifier. // Format: buyers/{accountId}/proposals/{proposalId}. diff --git a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json index 3ea191d8d8..cceff6b2ee 100644 --- a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json +++ b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json @@ -1285,7 +1285,7 @@ ] }, "patch": { - "description": "Updates the proposal at the given revision number. If the revision number in the request is behind the latest one kept in the server, an error message will be returned. See FieldMask for how to use FieldMask. Only fields specified in the UpdateProposalRequest.update_mask will be updated; Fields noted as 'Immutable' or 'Output only' yet specified in the UpdateProposalRequest.update_mask will be ignored and left unchanged. Updating a private auction proposal is not allowed and will result in an error.", + "description": "Updates the proposal at the given revision number. If the revision number in the request is behind the latest one kept in the server, an error message will be returned. See FieldMask for how to use FieldMask. Only fields specified in the UpdateProposalRequest.update_mask will be updated; Fields noted as 'Immutable' or 'Output only' yet specified in the UpdateProposalRequest.update_mask will be ignored and left unchanged. Updating a private auction proposal is only allowed for buyer private data, all other fields are immutable.", "flatPath": "v1alpha/buyers/{buyersId}/proposals/{proposalsId}", "httpMethod": "PATCH", "id": "authorizedbuyersmarketplace.buyers.proposals.patch", @@ -1550,7 +1550,7 @@ } } }, - "revision": "20250107", + "revision": "20250113", "rootUrl": "https://authorizedbuyersmarketplace.googleapis.com/", "schemas": { "AcceptProposalRequest": { @@ -2881,7 +2881,7 @@ "type": "object" }, "PrivateData": { - "description": "Buyers are allowed to store certain types of private data in a proposal or deal.", + "description": "Buyers are allowed to store certain types of private data in a proposal.", "id": "PrivateData", "properties": { "referenceId": { diff --git a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go index 2b52ce79ec..47a5b6150c 100644 --- a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go +++ b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go @@ -1861,7 +1861,7 @@ func (s PrivateAuctionTerms) MarshalJSON() ([]byte, error) { } // PrivateData: Buyers are allowed to store certain types of private data in a -// proposal or deal. +// proposal. type PrivateData struct { // ReferenceId: A buyer specified reference ID. This can be queried in the list // operations (max-length: 1024 unicode code units). @@ -7009,8 +7009,8 @@ type BuyersProposalsPatchCall struct { // fields specified in the UpdateProposalRequest.update_mask will be updated; // Fields noted as 'Immutable' or 'Output only' yet specified in the // UpdateProposalRequest.update_mask will be ignored and left unchanged. -// Updating a private auction proposal is not allowed and will result in an -// error. +// Updating a private auction proposal is only allowed for buyer private data, +// all other fields are immutable. // // - name: Immutable. The name of the proposal serving as a unique identifier. // Format: buyers/{accountId}/proposals/{proposalId}. diff --git a/chromemanagement/v1/chromemanagement-api.json b/chromemanagement/v1/chromemanagement-api.json index 14d4edcccc..43d2756504 100644 --- a/chromemanagement/v1/chromemanagement-api.json +++ b/chromemanagement/v1/chromemanagement-api.json @@ -1263,7 +1263,7 @@ } } }, - "revision": "20241216", + "revision": "20250111", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -1762,14 +1762,16 @@ "CANARY", "DEV", "BETA", - "STABLE" + "STABLE", + "LTS" ], "enumDescriptions": [ "No release channel specified.", "Canary release channel.", "Dev release channel.", "Beta release channel.", - "Stable release channel." + "Stable release channel.", + "Long-term support release channel." ], "readOnly": true, "type": "string" diff --git a/chromemanagement/v1/chromemanagement-gen.go b/chromemanagement/v1/chromemanagement-gen.go index 9a0e68351b..7c9d44d580 100644 --- a/chromemanagement/v1/chromemanagement-gen.go +++ b/chromemanagement/v1/chromemanagement-gen.go @@ -766,6 +766,7 @@ type GoogleChromeManagementV1BrowserVersion struct { // "DEV" - Dev release channel. // "BETA" - Beta release channel. // "STABLE" - Stable release channel. + // "LTS" - Long-term support release channel. Channel string `json:"channel,omitempty"` // Count: Output only. Count grouped by device_system and major version Count int64 `json:"count,omitempty,string"` diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index 70f4438416..143b9898ff 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -47599,7 +47599,7 @@ } } }, - "revision": "20241231", + "revision": "20250107", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -63356,7 +63356,7 @@ "type": "string" }, "namedPorts": { - "description": " Assigns a name to a port number. For example: {name: \"http\", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: \"app1\", port: 8080}, {name: \"app1\", port: 8081}, {name: \"app2\", port: 8082}] Named ports apply to all instances in this instance group. ", + "description": " Optional. Assigns a name to a port number. For example: {name: \"http\", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: \"app1\", port: 8080}, {name: \"app1\", port: 8081}, {name: \"app2\", port: 8082}] Named ports apply to all instances in this instance group. ", "items": { "$ref": "NamedPort" }, @@ -69051,6 +69051,10 @@ "description": "[Output Only] Type of the resource. Always compute#interconnectAttachment for interconnect attachments.", "type": "string" }, + "l2Forwarding": { + "$ref": "InterconnectAttachmentL2Forwarding", + "description": "L2 Interconnect Attachment related config. This field is required if the type is L2_DEDICATED. The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad) within L2 packets are mapped to the destination appliances IP addresses. The packet is then encapsulated with the appliance IP address and sent to the edge appliance." + }, "labelFingerprint": { "description": "A fingerprint for the labels being applied to this InterconnectAttachment, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InterconnectAttachment.", "format": "byte", @@ -69173,11 +69177,13 @@ "description": "The type of interconnect attachment this is, which can take one of the following values: - DEDICATED: an attachment to a Dedicated Interconnect. - PARTNER: an attachment to a Partner Interconnect, created by the customer. - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by the partner. ", "enum": [ "DEDICATED", + "L2_DEDICATED", "PARTNER", "PARTNER_PROVIDER" ], "enumDescriptions": [ "Attachment to a dedicated interconnect.", + "Attachment to a L2 interconnect, created by the customer.", "Attachment to a partner interconnect, created by the customer.", "Attachment to a partner interconnect, created by the partner." ], @@ -69866,6 +69872,88 @@ }, "type": "object" }, + "InterconnectAttachmentL2Forwarding": { + "description": "L2 Interconnect Attachment related configuration.", + "id": "InterconnectAttachmentL2Forwarding", + "properties": { + "applianceMappings": { + "additionalProperties": { + "$ref": "InterconnectAttachmentL2ForwardingApplianceMapping" + }, + "description": "Optional. A map of VLAN tags to appliances and optional inner mapping rules. If VLANs are not explicitly mapped to any appliance, the defaultApplianceIpAddress is used. Each VLAN tag can be a single number or a range of numbers in the range of 1 to 4094, e.g., \"1\" or \"4001-4094\". Non-empty and non-overlapping VLAN tag ranges are enforced, and violating operations will be rejected. The VLAN tags in the Ethernet header must use an ethertype value of 0x88A8 or 0x8100.", + "type": "object" + }, + "defaultApplianceIpAddress": { + "description": "Optional. A single IPv4 or IPv6 address used as the default destination IP when there is no VLAN mapping result found. Unset field (null-value) indicates the unmatched packet should be dropped.", + "type": "string" + }, + "geneveHeader": { + "$ref": "InterconnectAttachmentL2ForwardingGeneveHeader", + "description": "Optional. It represents the structure of a Geneve (Generic Network Virtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization environments." + }, + "network": { + "description": "Required. Resource URL of the network to which this attachment belongs.", + "type": "string" + }, + "tunnelEndpointIpAddress": { + "description": "Required. A single IPv4 or IPv6 address. This address will be used as the source IP address for packets sent to the appliances, and must be used as the destination IP address for packets that should be sent out through this attachment.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentL2ForwardingApplianceMapping": { + "description": "Two-level VLAN-to-Appliance mapping rule.", + "id": "InterconnectAttachmentL2ForwardingApplianceMapping", + "properties": { + "applianceIpAddress": { + "description": "Optional. A single IPv4 or IPv6 address used as the destination IP address for ingress packets that match on a VLAN tag, but do not match a more specific inner VLAN tag. Unset field (null-value) indicates both VLAN tags are required to be mapped. Otherwise, defaultApplianceIpAddress is used.", + "type": "string" + }, + "innerVlanToApplianceMappings": { + "description": "Optional. Used to match against the inner VLAN when the packet contains two VLAN tags. A list of mapping rules from inner VLAN tags to IP addresses. If the inner VLAN is not explicitly mapped to an IP address range, the applianceIpAddress is used.", + "items": { + "$ref": "InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping" + }, + "type": "array" + }, + "name": { + "description": "Optional. The name of this appliance mapping rule.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping": { + "description": "The inner VLAN-to-Appliance mapping.", + "id": "InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping", + "properties": { + "innerApplianceIpAddress": { + "description": "Required in this object. A single IPv4 or IPv6 address used as the destination IP address for ingress packets that match on both VLAN tags.", + "type": "string" + }, + "innerVlanTags": { + "description": "Required in this object. Used to match the inner VLAN tag on the packet. Each entry can be a single number or a range of numbers in the range of 1 to 4094, e.g., [\"1\", \"4001-4094\"] is valid. Non-empty and Non-overlapping VLAN tag ranges are enforced, and violating operations will be rejected. The inner VLAN tags must have an ethertype value of 0x8100.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "InterconnectAttachmentL2ForwardingGeneveHeader": { + "description": "GeneveHeader related configurations.", + "id": "InterconnectAttachmentL2ForwardingGeneveHeader", + "properties": { + "vni": { + "description": "Optional. VNI is a 24-bit unique virtual network identifier, from 0 to 16,777,215.", + "format": "uint32", + "type": "integer" + } + }, + "type": "object" + }, "InterconnectAttachmentList": { "description": "Response to the list request, and contains a list of interconnect attachments.", "id": "InterconnectAttachmentList", @@ -75805,11 +75893,11 @@ "additionalProperties": { "type": "string" }, - "description": "Metadata defined as annotations on the network endpoint.", + "description": "Optional metadata defined as annotations on the network endpoint.", "type": "object" }, "clientDestinationPort": { - "description": "Represents the port number to which PSC consumer sends packets. Only valid for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type.", + "description": "Represents the port number to which PSC consumer sends packets. Optional. Only valid for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type.", "format": "int32", "type": "integer" }, @@ -75818,7 +75906,7 @@ "type": "string" }, "instance": { - "description": "The name or a URL of VM instance of this network endpoint. This field is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). If the ipAddress is specified, it must belongs to the VM instance. The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance.", + "description": "The name or a URL of VM instance of this network endpoint. Optional, the field presence depends on the network endpoint type. The field is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). If the ipAddress is specified, it must belongs to the VM instance. The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance.", "type": "string" }, "ipAddress": { @@ -75849,27 +75937,27 @@ "additionalProperties": { "type": "string" }, - "description": "Metadata defined as annotations on the network endpoint group.", + "description": "Optional. Metadata defined as annotations on the network endpoint group.", "type": "object" }, "appEngine": { "$ref": "NetworkEndpointGroupAppEngine", - "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." + "description": "Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." }, "cloudFunction": { "$ref": "NetworkEndpointGroupCloudFunction", - "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." + "description": "Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." }, "cloudRun": { "$ref": "NetworkEndpointGroupCloudRun", - "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." + "description": "Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." }, "creationTimestamp": { "description": "[Output Only] Creation timestamp in RFC3339 text format.", "type": "string" }, "defaultPort": { - "description": "The default port used if the port number is not specified in the network endpoint. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified.", + "description": "The default port used if the port number is not specified in the network endpoint. Optional. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified.", "format": "int32", "type": "integer" }, @@ -75925,10 +76013,11 @@ "type": "string" }, "pscData": { - "$ref": "NetworkEndpointGroupPscData" + "$ref": "NetworkEndpointGroupPscData", + "description": "Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT." }, "pscTargetService": { - "description": "The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com", + "description": "The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com. Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT.", "type": "string" }, "region": { @@ -76785,7 +76874,7 @@ "id": "NetworkEndpointWithHealthStatus", "properties": { "healths": { - "description": "[Output only] The health status of network endpoint;", + "description": "[Output only] The health status of network endpoint. Optional. Displayed only if the network endpoint has centralized health checking configured.", "items": { "$ref": "HealthStatusForNetworkEndpoint" }, @@ -76793,7 +76882,7 @@ }, "networkEndpoint": { "$ref": "NetworkEndpoint", - "description": "[Output only] The network endpoint;" + "description": "[Output only] The network endpoint." } }, "type": "object" diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index e662cb0a36..d469a42a46 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -19990,10 +19990,10 @@ type InstanceGroup struct { // Name: The name of the instance group. The name must be 1-63 characters long, // and comply with RFC1035. Name string `json:"name,omitempty"` - // NamedPorts: Assigns a name to a port number. For example: {name: "http", - // port: 80} This allows the system to reference ports by the assigned name - // instead of a port number. Named ports can also contain multiple ports. For - // example: [{name: "app1", port: 8080}, {name: "app1", port: 8081}, {name: + // NamedPorts: Optional. Assigns a name to a port number. For example: {name: + // "http", port: 80} This allows the system to reference ports by the assigned + // name instead of a port number. Named ports can also contain multiple ports. + // For example: [{name: "app1", port: 8080}, {name: "app1", port: 8081}, {name: // "app2", port: 8082}] Named ports apply to all instances in this instance // group. NamedPorts []*NamedPort `json:"namedPorts,omitempty"` @@ -26540,6 +26540,12 @@ type InterconnectAttachment struct { // Kind: [Output Only] Type of the resource. Always // compute#interconnectAttachment for interconnect attachments. Kind string `json:"kind,omitempty"` + // L2Forwarding: L2 Interconnect Attachment related config. This field is + // required if the type is L2_DEDICATED. The configuration specifies how VLAN + // tags (like dot1q, qinq, or dot1ad) within L2 packets are mapped to the + // destination appliances IP addresses. The packet is then encapsulated with + // the appliance IP address and sent to the edge appliance. + L2Forwarding *InterconnectAttachmentL2Forwarding `json:"l2Forwarding,omitempty"` // LabelFingerprint: A fingerprint for the labels being applied to this // InterconnectAttachment, which is essentially a hash of the labels set used // for optimistic locking. The fingerprint is initially generated by Compute @@ -26682,6 +26688,7 @@ type InterconnectAttachment struct { // // Possible values: // "DEDICATED" - Attachment to a dedicated interconnect. + // "L2_DEDICATED" - Attachment to a L2 interconnect, created by the customer. // "PARTNER" - Attachment to a partner interconnect, created by the customer. // "PARTNER_PROVIDER" - Attachment to a partner interconnect, created by the // partner. @@ -27491,6 +27498,141 @@ func (s InterconnectAttachmentGroupsOperationalStatus) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InterconnectAttachmentL2Forwarding: L2 Interconnect Attachment related +// configuration. +type InterconnectAttachmentL2Forwarding struct { + // ApplianceMappings: Optional. A map of VLAN tags to appliances and optional + // inner mapping rules. If VLANs are not explicitly mapped to any appliance, + // the defaultApplianceIpAddress is used. Each VLAN tag can be a single number + // or a range of numbers in the range of 1 to 4094, e.g., "1" or "4001-4094". + // Non-empty and non-overlapping VLAN tag ranges are enforced, and violating + // operations will be rejected. The VLAN tags in the Ethernet header must use + // an ethertype value of 0x88A8 or 0x8100. + ApplianceMappings map[string]InterconnectAttachmentL2ForwardingApplianceMapping `json:"applianceMappings,omitempty"` + // DefaultApplianceIpAddress: Optional. A single IPv4 or IPv6 address used as + // the default destination IP when there is no VLAN mapping result found. Unset + // field (null-value) indicates the unmatched packet should be dropped. + DefaultApplianceIpAddress string `json:"defaultApplianceIpAddress,omitempty"` + // GeneveHeader: Optional. It represents the structure of a Geneve (Generic + // Network Virtualization Encapsulation) header, as defined in RFC8926. It + // encapsulates packets from various protocols (e.g., Ethernet, IPv4, IPv6) for + // use in network virtualization environments. + GeneveHeader *InterconnectAttachmentL2ForwardingGeneveHeader `json:"geneveHeader,omitempty"` + // Network: Required. Resource URL of the network to which this attachment + // belongs. + Network string `json:"network,omitempty"` + // TunnelEndpointIpAddress: Required. A single IPv4 or IPv6 address. This + // address will be used as the source IP address for packets sent to the + // appliances, and must be used as the destination IP address for packets that + // should be sent out through this attachment. + TunnelEndpointIpAddress string `json:"tunnelEndpointIpAddress,omitempty"` + // ForceSendFields is a list of field names (e.g. "ApplianceMappings") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ApplianceMappings") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InterconnectAttachmentL2Forwarding) MarshalJSON() ([]byte, error) { + type NoMethod InterconnectAttachmentL2Forwarding + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// InterconnectAttachmentL2ForwardingApplianceMapping: Two-level +// VLAN-to-Appliance mapping rule. +type InterconnectAttachmentL2ForwardingApplianceMapping struct { + // ApplianceIpAddress: Optional. A single IPv4 or IPv6 address used as the + // destination IP address for ingress packets that match on a VLAN tag, but do + // not match a more specific inner VLAN tag. Unset field (null-value) indicates + // both VLAN tags are required to be mapped. Otherwise, + // defaultApplianceIpAddress is used. + ApplianceIpAddress string `json:"applianceIpAddress,omitempty"` + // InnerVlanToApplianceMappings: Optional. Used to match against the inner VLAN + // when the packet contains two VLAN tags. A list of mapping rules from inner + // VLAN tags to IP addresses. If the inner VLAN is not explicitly mapped to an + // IP address range, the applianceIpAddress is used. + InnerVlanToApplianceMappings []*InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping `json:"innerVlanToApplianceMappings,omitempty"` + // Name: Optional. The name of this appliance mapping rule. + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "ApplianceIpAddress") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ApplianceIpAddress") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InterconnectAttachmentL2ForwardingApplianceMapping) MarshalJSON() ([]byte, error) { + type NoMethod InterconnectAttachmentL2ForwardingApplianceMapping + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping +// : The inner VLAN-to-Appliance mapping. +type InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping struct { + // InnerApplianceIpAddress: Required in this object. A single IPv4 or IPv6 + // address used as the destination IP address for ingress packets that match on + // both VLAN tags. + InnerApplianceIpAddress string `json:"innerApplianceIpAddress,omitempty"` + // InnerVlanTags: Required in this object. Used to match the inner VLAN tag on + // the packet. Each entry can be a single number or a range of numbers in the + // range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty and + // Non-overlapping VLAN tag ranges are enforced, and violating operations will + // be rejected. The inner VLAN tags must have an ethertype value of 0x8100. + InnerVlanTags []string `json:"innerVlanTags,omitempty"` + // ForceSendFields is a list of field names (e.g. "InnerApplianceIpAddress") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "InnerApplianceIpAddress") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping) MarshalJSON() ([]byte, error) { + type NoMethod InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// InterconnectAttachmentL2ForwardingGeneveHeader: GeneveHeader related +// configurations. +type InterconnectAttachmentL2ForwardingGeneveHeader struct { + // Vni: Optional. VNI is a 24-bit unique virtual network identifier, from 0 to + // 16,777,215. + Vni int64 `json:"vni,omitempty"` + // ForceSendFields is a list of field names (e.g. "Vni") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Vni") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InterconnectAttachmentL2ForwardingGeneveHeader) MarshalJSON() ([]byte, error) { + type NoMethod InterconnectAttachmentL2ForwardingGeneveHeader + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // InterconnectAttachmentList: Response to the list request, and contains a // list of interconnect attachments. type InterconnectAttachmentList struct { @@ -33985,23 +34127,25 @@ func (s NetworkEdgeSecurityServicesScopedListWarningData) MarshalJSON() ([]byte, // NetworkEndpoint: The network endpoint. type NetworkEndpoint struct { - // Annotations: Metadata defined as annotations on the network endpoint. + // Annotations: Optional metadata defined as annotations on the network + // endpoint. Annotations map[string]string `json:"annotations,omitempty"` // ClientDestinationPort: Represents the port number to which PSC consumer - // sends packets. Only valid for network endpoint groups created with + // sends packets. Optional. Only valid for network endpoint groups created with // GCE_VM_IP_PORTMAP endpoint type. ClientDestinationPort int64 `json:"clientDestinationPort,omitempty"` // Fqdn: Optional fully qualified domain name of network endpoint. This can // only be specified when NetworkEndpointGroup.network_endpoint_type is // NON_GCP_FQDN_PORT. Fqdn string `json:"fqdn,omitempty"` - // Instance: The name or a URL of VM instance of this network endpoint. This - // field is required for network endpoints of type GCE_VM_IP and - // GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint - // group (for zonal NEGs) or in the zone within the region of the NEG (for - // regional NEGs). If the ipAddress is specified, it must belongs to the VM - // instance. The name must be 1-63 characters long, and comply with RFC1035 or - // be a valid URL pointing to an existing instance. + // Instance: The name or a URL of VM instance of this network endpoint. + // Optional, the field presence depends on the network endpoint type. The field + // is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The + // instance must be in the same zone of network endpoint group (for zonal NEGs) + // or in the zone within the region of the NEG (for regional NEGs). If the + // ipAddress is specified, it must belongs to the VM instance. The name must be + // 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to + // an existing instance. Instance string `json:"instance,omitempty"` // IpAddress: Optional IPv4 address of network endpoint. The IP address must // belong to a VM in Compute Engine (either the primary IP or as part of an @@ -34048,22 +34192,24 @@ func (s NetworkEndpoint) MarshalJSON() ([]byte, error) { // information about using NEGs for different use cases, see Network endpoint // groups overview. type NetworkEndpointGroup struct { - // Annotations: Metadata defined as annotations on the network endpoint group. + // Annotations: Optional. Metadata defined as annotations on the network + // endpoint group. Annotations map[string]string `json:"annotations,omitempty"` - // AppEngine: Only valid when networkEndpointType is SERVERLESS. Only one of - // cloudRun, appEngine or cloudFunction may be set. + // AppEngine: Optional. Only valid when networkEndpointType is SERVERLESS. Only + // one of cloudRun, appEngine or cloudFunction may be set. AppEngine *NetworkEndpointGroupAppEngine `json:"appEngine,omitempty"` - // CloudFunction: Only valid when networkEndpointType is SERVERLESS. Only one - // of cloudRun, appEngine or cloudFunction may be set. + // CloudFunction: Optional. Only valid when networkEndpointType is SERVERLESS. + // Only one of cloudRun, appEngine or cloudFunction may be set. CloudFunction *NetworkEndpointGroupCloudFunction `json:"cloudFunction,omitempty"` - // CloudRun: Only valid when networkEndpointType is SERVERLESS. Only one of - // cloudRun, appEngine or cloudFunction may be set. + // CloudRun: Optional. Only valid when networkEndpointType is SERVERLESS. Only + // one of cloudRun, appEngine or cloudFunction may be set. CloudRun *NetworkEndpointGroupCloudRun `json:"cloudRun,omitempty"` // CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text format. CreationTimestamp string `json:"creationTimestamp,omitempty"` // DefaultPort: The default port used if the port number is not specified in - // the network endpoint. If the network endpoint type is either GCE_VM_IP, - // SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified. + // the network endpoint. Optional. If the network endpoint type is either + // GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be + // specified. DefaultPort int64 `json:"defaultPort,omitempty"` // Description: An optional description of this resource. Provide this property // when you create the resource. @@ -34111,11 +34257,14 @@ type NetworkEndpointGroup struct { // connection is set up by private service connect // "SERVERLESS" - The network endpoint is handled by specified serverless // infrastructure. - NetworkEndpointType string `json:"networkEndpointType,omitempty"` - PscData *NetworkEndpointGroupPscData `json:"pscData,omitempty"` + NetworkEndpointType string `json:"networkEndpointType,omitempty"` + // PscData: Optional. Only valid when networkEndpointType is + // PRIVATE_SERVICE_CONNECT. + PscData *NetworkEndpointGroupPscData `json:"pscData,omitempty"` // PscTargetService: The target service url used to set up private service // connection to a Google API or a PSC Producer Service Attachment. An example - // value is: asia-northeast3-cloudkms.googleapis.com + // value is: asia-northeast3-cloudkms.googleapis.com. Optional. Only valid when + // networkEndpointType is PRIVATE_SERVICE_CONNECT. PscTargetService string `json:"pscTargetService,omitempty"` // Region: [Output Only] The URL of the region where the network endpoint group // is located. @@ -35118,9 +35267,11 @@ func (s NetworkEndpointGroupsScopedListWarningData) MarshalJSON() ([]byte, error } type NetworkEndpointWithHealthStatus struct { - // Healths: [Output only] The health status of network endpoint; + // Healths: [Output only] The health status of network endpoint. Optional. + // Displayed only if the network endpoint has centralized health checking + // configured. Healths []*HealthStatusForNetworkEndpoint `json:"healths,omitempty"` - // NetworkEndpoint: [Output only] The network endpoint; + // NetworkEndpoint: [Output only] The network endpoint. NetworkEndpoint *NetworkEndpoint `json:"networkEndpoint,omitempty"` // ForceSendFields is a list of field names (e.g. "Healths") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/compute/v0.beta/compute-api.json b/compute/v0.beta/compute-api.json index 9730dd5b78..fd98677e99 100644 --- a/compute/v0.beta/compute-api.json +++ b/compute/v0.beta/compute-api.json @@ -42856,7 +42856,7 @@ } } }, - "revision": "20241231", + "revision": "20250107", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -56874,7 +56874,7 @@ "type": "string" }, "namedPorts": { - "description": " Assigns a name to a port number. For example: {name: \"http\", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: \"app1\", port: 8080}, {name: \"app1\", port: 8081}, {name: \"app2\", port: 8082}] Named ports apply to all instances in this instance group. ", + "description": " Optional. Assigns a name to a port number. For example: {name: \"http\", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: \"app1\", port: 8080}, {name: \"app1\", port: 8081}, {name: \"app2\", port: 8082}] Named ports apply to all instances in this instance group. ", "items": { "$ref": "NamedPort" }, @@ -66904,11 +66904,11 @@ "additionalProperties": { "type": "string" }, - "description": "Metadata defined as annotations on the network endpoint.", + "description": "Optional metadata defined as annotations on the network endpoint.", "type": "object" }, "clientDestinationPort": { - "description": "Represents the port number to which PSC consumer sends packets. Only valid for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type.", + "description": "Represents the port number to which PSC consumer sends packets. Optional. Only valid for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type.", "format": "int32", "type": "integer" }, @@ -66917,7 +66917,7 @@ "type": "string" }, "instance": { - "description": "The name or a URL of VM instance of this network endpoint. This field is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). If the ipAddress is specified, it must belongs to the VM instance. The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance.", + "description": "The name or a URL of VM instance of this network endpoint. Optional, the field presence depends on the network endpoint type. The field is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). If the ipAddress is specified, it must belongs to the VM instance. The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance.", "type": "string" }, "ipAddress": { @@ -66944,27 +66944,27 @@ "additionalProperties": { "type": "string" }, - "description": "Metadata defined as annotations on the network endpoint group.", + "description": "Optional. Metadata defined as annotations on the network endpoint group.", "type": "object" }, "appEngine": { "$ref": "NetworkEndpointGroupAppEngine", - "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." + "description": "Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." }, "cloudFunction": { "$ref": "NetworkEndpointGroupCloudFunction", - "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." + "description": "Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." }, "cloudRun": { "$ref": "NetworkEndpointGroupCloudRun", - "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." + "description": "Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set." }, "creationTimestamp": { "description": "[Output Only] Creation timestamp in RFC3339 text format.", "type": "string" }, "defaultPort": { - "description": "The default port used if the port number is not specified in the network endpoint. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified.", + "description": "The default port used if the port number is not specified in the network endpoint. Optional. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified.", "format": "int32", "type": "integer" }, @@ -67020,10 +67020,11 @@ "type": "string" }, "pscData": { - "$ref": "NetworkEndpointGroupPscData" + "$ref": "NetworkEndpointGroupPscData", + "description": "Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT." }, "pscTargetService": { - "description": "The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com", + "description": "The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com. Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT.", "type": "string" }, "region": { @@ -67866,7 +67867,7 @@ "id": "NetworkEndpointWithHealthStatus", "properties": { "healths": { - "description": "[Output only] The health status of network endpoint;", + "description": "[Output only] The health status of network endpoint. Optional. Displayed only if the network endpoint has centralized health checking configured.", "items": { "$ref": "HealthStatusForNetworkEndpoint" }, @@ -67874,7 +67875,7 @@ }, "networkEndpoint": { "$ref": "NetworkEndpoint", - "description": "[Output only] The network endpoint;" + "description": "[Output only] The network endpoint." } }, "type": "object" diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index dd474a6389..ffdac8681e 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -17806,10 +17806,10 @@ type InstanceGroup struct { // Name: The name of the instance group. The name must be 1-63 characters long, // and comply with RFC1035. Name string `json:"name,omitempty"` - // NamedPorts: Assigns a name to a port number. For example: {name: "http", - // port: 80} This allows the system to reference ports by the assigned name - // instead of a port number. Named ports can also contain multiple ports. For - // example: [{name: "app1", port: 8080}, {name: "app1", port: 8081}, {name: + // NamedPorts: Optional. Assigns a name to a port number. For example: {name: + // "http", port: 80} This allows the system to reference ports by the assigned + // name instead of a port number. Named ports can also contain multiple ports. + // For example: [{name: "app1", port: 8080}, {name: "app1", port: 8081}, {name: // "app2", port: 8082}] Named ports apply to all instances in this instance // group. NamedPorts []*NamedPort `json:"namedPorts,omitempty"` @@ -29089,23 +29089,25 @@ func (s NetworkEdgeSecurityServicesScopedListWarningData) MarshalJSON() ([]byte, // NetworkEndpoint: The network endpoint. type NetworkEndpoint struct { - // Annotations: Metadata defined as annotations on the network endpoint. + // Annotations: Optional metadata defined as annotations on the network + // endpoint. Annotations map[string]string `json:"annotations,omitempty"` // ClientDestinationPort: Represents the port number to which PSC consumer - // sends packets. Only valid for network endpoint groups created with + // sends packets. Optional. Only valid for network endpoint groups created with // GCE_VM_IP_PORTMAP endpoint type. ClientDestinationPort int64 `json:"clientDestinationPort,omitempty"` // Fqdn: Optional fully qualified domain name of network endpoint. This can // only be specified when NetworkEndpointGroup.network_endpoint_type is // NON_GCP_FQDN_PORT. Fqdn string `json:"fqdn,omitempty"` - // Instance: The name or a URL of VM instance of this network endpoint. This - // field is required for network endpoints of type GCE_VM_IP and - // GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint - // group (for zonal NEGs) or in the zone within the region of the NEG (for - // regional NEGs). If the ipAddress is specified, it must belongs to the VM - // instance. The name must be 1-63 characters long, and comply with RFC1035 or - // be a valid URL pointing to an existing instance. + // Instance: The name or a URL of VM instance of this network endpoint. + // Optional, the field presence depends on the network endpoint type. The field + // is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The + // instance must be in the same zone of network endpoint group (for zonal NEGs) + // or in the zone within the region of the NEG (for regional NEGs). If the + // ipAddress is specified, it must belongs to the VM instance. The name must be + // 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to + // an existing instance. Instance string `json:"instance,omitempty"` // IpAddress: Optional IPv4 address of network endpoint. The IP address must // belong to a VM in Compute Engine (either the primary IP or as part of an @@ -29147,22 +29149,24 @@ func (s NetworkEndpoint) MarshalJSON() ([]byte, error) { // information about using NEGs for different use cases, see Network endpoint // groups overview. type NetworkEndpointGroup struct { - // Annotations: Metadata defined as annotations on the network endpoint group. + // Annotations: Optional. Metadata defined as annotations on the network + // endpoint group. Annotations map[string]string `json:"annotations,omitempty"` - // AppEngine: Only valid when networkEndpointType is SERVERLESS. Only one of - // cloudRun, appEngine or cloudFunction may be set. + // AppEngine: Optional. Only valid when networkEndpointType is SERVERLESS. Only + // one of cloudRun, appEngine or cloudFunction may be set. AppEngine *NetworkEndpointGroupAppEngine `json:"appEngine,omitempty"` - // CloudFunction: Only valid when networkEndpointType is SERVERLESS. Only one - // of cloudRun, appEngine or cloudFunction may be set. + // CloudFunction: Optional. Only valid when networkEndpointType is SERVERLESS. + // Only one of cloudRun, appEngine or cloudFunction may be set. CloudFunction *NetworkEndpointGroupCloudFunction `json:"cloudFunction,omitempty"` - // CloudRun: Only valid when networkEndpointType is SERVERLESS. Only one of - // cloudRun, appEngine or cloudFunction may be set. + // CloudRun: Optional. Only valid when networkEndpointType is SERVERLESS. Only + // one of cloudRun, appEngine or cloudFunction may be set. CloudRun *NetworkEndpointGroupCloudRun `json:"cloudRun,omitempty"` // CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text format. CreationTimestamp string `json:"creationTimestamp,omitempty"` // DefaultPort: The default port used if the port number is not specified in - // the network endpoint. If the network endpoint type is either GCE_VM_IP, - // SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified. + // the network endpoint. Optional. If the network endpoint type is either + // GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be + // specified. DefaultPort int64 `json:"defaultPort,omitempty"` // Description: An optional description of this resource. Provide this property // when you create the resource. @@ -29210,11 +29214,14 @@ type NetworkEndpointGroup struct { // connection is set up by private service connect // "SERVERLESS" - The network endpoint is handled by specified serverless // infrastructure. - NetworkEndpointType string `json:"networkEndpointType,omitempty"` - PscData *NetworkEndpointGroupPscData `json:"pscData,omitempty"` + NetworkEndpointType string `json:"networkEndpointType,omitempty"` + // PscData: Optional. Only valid when networkEndpointType is + // PRIVATE_SERVICE_CONNECT. + PscData *NetworkEndpointGroupPscData `json:"pscData,omitempty"` // PscTargetService: The target service url used to set up private service // connection to a Google API or a PSC Producer Service Attachment. An example - // value is: asia-northeast3-cloudkms.googleapis.com + // value is: asia-northeast3-cloudkms.googleapis.com. Optional. Only valid when + // networkEndpointType is PRIVATE_SERVICE_CONNECT. PscTargetService string `json:"pscTargetService,omitempty"` // Region: [Output Only] The URL of the region where the network endpoint group // is located. @@ -30207,9 +30214,11 @@ func (s NetworkEndpointGroupsScopedListWarningData) MarshalJSON() ([]byte, error } type NetworkEndpointWithHealthStatus struct { - // Healths: [Output only] The health status of network endpoint; + // Healths: [Output only] The health status of network endpoint. Optional. + // Displayed only if the network endpoint has centralized health checking + // configured. Healths []*HealthStatusForNetworkEndpoint `json:"healths,omitempty"` - // NetworkEndpoint: [Output only] The network endpoint; + // NetworkEndpoint: [Output only] The network endpoint. NetworkEndpoint *NetworkEndpoint `json:"networkEndpoint,omitempty"` // ForceSendFields is a list of field names (e.g. "Healths") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index 329961f2b2..4cc7a9da6c 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -712,7 +712,7 @@ "type": "string" }, "orderBy": { - "description": "Optional. Specifies the ordering of results. Supported values are: * relevance (default) * last_modified_timestamp * last_modified_timestamp asc", + "description": "Optional. Specifies the ordering of results. Supported values are: relevance (default) last_modified_timestamp last_modified_timestamp asc", "location": "query", "type": "string" }, @@ -6244,7 +6244,7 @@ } } }, - "revision": "20241206", + "revision": "20250107", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index 67b7755276..68fbe531e6 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -9518,8 +9518,8 @@ func (r *ProjectsLocationsService) SearchEntries(name string) *ProjectsLocations } // OrderBy sets the optional parameter "orderBy": Specifies the ordering of -// results. Supported values are: * relevance (default) * -// last_modified_timestamp * last_modified_timestamp asc +// results. Supported values are: relevance (default) last_modified_timestamp +// last_modified_timestamp asc func (c *ProjectsLocationsSearchEntriesCall) OrderBy(orderBy string) *ProjectsLocationsSearchEntriesCall { c.urlParams_.Set("orderBy", orderBy) return c diff --git a/displayvideo/v2/displayvideo-api.json b/displayvideo/v2/displayvideo-api.json index 9396b92b3a..6a7eeea509 100644 --- a/displayvideo/v2/displayvideo-api.json +++ b/displayvideo/v2/displayvideo-api.json @@ -6204,192 +6204,6 @@ } } }, - "firstAndThirdPartyAudiences": { - "methods": { - "create": { - "description": "Creates a FirstAndThirdPartyAudience. Only supported for the following audience_type: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID`", - "flatPath": "v2/firstAndThirdPartyAudiences", - "httpMethod": "POST", - "id": "displayvideo.firstAndThirdPartyAudiences.create", - "parameterOrder": [], - "parameters": { - "advertiserId": { - "description": "Required. The ID of the advertiser under whom the FirstAndThirdPartyAudience will be created.", - "format": "int64", - "location": "query", - "type": "string" - } - }, - "path": "v2/firstAndThirdPartyAudiences", - "request": { - "$ref": "FirstAndThirdPartyAudience" - }, - "response": { - "$ref": "FirstAndThirdPartyAudience" - }, - "scopes": [ - "https://www.googleapis.com/auth/display-video" - ] - }, - "editCustomerMatchMembers": { - "description": "Updates the member list of a Customer Match audience. Only supported for the following audience_type: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID`", - "flatPath": "v2/firstAndThirdPartyAudiences/{firstAndThirdPartyAudiencesId}:editCustomerMatchMembers", - "httpMethod": "POST", - "id": "displayvideo.firstAndThirdPartyAudiences.editCustomerMatchMembers", - "parameterOrder": [ - "firstAndThirdPartyAudienceId" - ], - "parameters": { - "firstAndThirdPartyAudienceId": { - "description": "Required. The ID of the Customer Match FirstAndThirdPartyAudience whose members will be edited.", - "format": "int64", - "location": "path", - "pattern": "^[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v2/firstAndThirdPartyAudiences/{+firstAndThirdPartyAudienceId}:editCustomerMatchMembers", - "request": { - "$ref": "EditCustomerMatchMembersRequest" - }, - "response": { - "$ref": "EditCustomerMatchMembersResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/display-video" - ] - }, - "get": { - "description": "Gets a first and third party audience.", - "flatPath": "v2/firstAndThirdPartyAudiences/{firstAndThirdPartyAudiencesId}", - "httpMethod": "GET", - "id": "displayvideo.firstAndThirdPartyAudiences.get", - "parameterOrder": [ - "firstAndThirdPartyAudienceId" - ], - "parameters": { - "advertiserId": { - "description": "The ID of the advertiser that has access to the fetched first and third party audience.", - "format": "int64", - "location": "query", - "type": "string" - }, - "firstAndThirdPartyAudienceId": { - "description": "Required. The ID of the first and third party audience to fetch.", - "format": "int64", - "location": "path", - "pattern": "^[^/]+$", - "required": true, - "type": "string" - }, - "partnerId": { - "description": "The ID of the partner that has access to the fetched first and third party audience.", - "format": "int64", - "location": "query", - "type": "string" - } - }, - "path": "v2/firstAndThirdPartyAudiences/{+firstAndThirdPartyAudienceId}", - "response": { - "$ref": "FirstAndThirdPartyAudience" - }, - "scopes": [ - "https://www.googleapis.com/auth/display-video" - ] - }, - "list": { - "description": "Lists first and third party audiences. The order is defined by the order_by parameter.", - "flatPath": "v2/firstAndThirdPartyAudiences", - "httpMethod": "GET", - "id": "displayvideo.firstAndThirdPartyAudiences.list", - "parameterOrder": [], - "parameters": { - "advertiserId": { - "description": "The ID of the advertiser that has access to the fetched first and third party audiences.", - "format": "int64", - "location": "query", - "type": "string" - }, - "filter": { - "description": "Allows filtering by first and third party audience fields. Supported syntax: * Filter expressions for first and third party audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All first and third party audiences for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", - "location": "query", - "type": "string" - }, - "orderBy": { - "description": "Field by which to sort the list. Acceptable values are: * `firstAndThirdPartyAudienceId` (default) * `displayName` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", - "location": "query", - "type": "string" - }, - "pageSize": { - "description": "Requested page size. Must be between `1` and `5000`. If unspecified, this value defaults to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified.", - "format": "int32", - "location": "query", - "type": "integer" - }, - "pageToken": { - "description": "A token identifying a page of results the server should return. Typically, this is the value of next_page_token returned from the previous call to `ListFirstAndThirdPartyAudiences` method. If not specified, the first page of results will be returned.", - "location": "query", - "type": "string" - }, - "partnerId": { - "description": "The ID of the partner that has access to the fetched first and third party audiences.", - "format": "int64", - "location": "query", - "type": "string" - } - }, - "path": "v2/firstAndThirdPartyAudiences", - "response": { - "$ref": "ListFirstAndThirdPartyAudiencesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/display-video" - ] - }, - "patch": { - "description": "Updates an existing FirstAndThirdPartyAudience. Only supported for the following audience_type: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID`", - "flatPath": "v2/firstAndThirdPartyAudiences/{firstAndThirdPartyAudiencesId}", - "httpMethod": "PATCH", - "id": "displayvideo.firstAndThirdPartyAudiences.patch", - "parameterOrder": [ - "firstAndThirdPartyAudienceId" - ], - "parameters": { - "advertiserId": { - "description": "Required. The ID of the owner advertiser of the updated FirstAndThirdPartyAudience.", - "format": "int64", - "location": "query", - "type": "string" - }, - "firstAndThirdPartyAudienceId": { - "description": "Output only. The unique ID of the first and third party audience. Assigned by the system.", - "format": "int64", - "location": "path", - "pattern": "^[^/]+$", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "Required. The mask to control which fields to update. Updates are only supported for the following fields: * `displayName` * `description` * `membershipDurationDays`", - "format": "google-fieldmask", - "location": "query", - "type": "string" - } - }, - "path": "v2/firstAndThirdPartyAudiences/{+firstAndThirdPartyAudienceId}", - "request": { - "$ref": "FirstAndThirdPartyAudience" - }, - "response": { - "$ref": "FirstAndThirdPartyAudience" - }, - "scopes": [ - "https://www.googleapis.com/auth/display-video" - ] - } - } - }, "floodlightGroups": { "methods": { "get": { @@ -9267,7 +9081,7 @@ } } }, - "revision": "20241212", + "revision": "20250109", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -11743,99 +11557,6 @@ }, "type": "object" }, - "Consent": { - "description": "User consent status.", - "id": "Consent", - "properties": { - "adPersonalization": { - "description": "Represents consent for ad personalization.", - "enum": [ - "CONSENT_STATUS_UNSPECIFIED", - "CONSENT_STATUS_GRANTED", - "CONSENT_STATUS_DENIED" - ], - "enumDescriptions": [ - "Type value is not specified or is unknown in this version.", - "Consent is granted.", - "Consent is denied." - ], - "type": "string" - }, - "adUserData": { - "description": "Represents consent for ad user data.", - "enum": [ - "CONSENT_STATUS_UNSPECIFIED", - "CONSENT_STATUS_GRANTED", - "CONSENT_STATUS_DENIED" - ], - "enumDescriptions": [ - "Type value is not specified or is unknown in this version.", - "Consent is granted.", - "Consent is denied." - ], - "type": "string" - } - }, - "type": "object" - }, - "ContactInfo": { - "description": "Contact information defining a Customer Match audience member.", - "id": "ContactInfo", - "properties": { - "countryCode": { - "description": "Country code of the member. Must also be set with the following fields: * hashed_first_name * hashed_last_name * zip_codes", - "type": "string" - }, - "hashedEmails": { - "description": "A list of SHA256 hashed email of the member. Before hashing, remove all whitespace and make sure the string is all lowercase.", - "items": { - "type": "string" - }, - "type": "array" - }, - "hashedFirstName": { - "description": "SHA256 hashed first name of the member. Before hashing, remove all whitespace and make sure the string is all lowercase. Must also be set with the following fields: * country_code * hashed_last_name * zip_codes", - "type": "string" - }, - "hashedLastName": { - "description": "SHA256 hashed last name of the member. Before hashing, remove all whitespace and make sure the string is all lowercase. Must also be set with the following fields: * country_code * hashed_first_name * zip_codes", - "type": "string" - }, - "hashedPhoneNumbers": { - "description": "A list of SHA256 hashed phone numbers of the member. Before hashing, all phone numbers must be formatted using the [E.164 format](//en.wikipedia.org/wiki/E.164) and include the country calling code.", - "items": { - "type": "string" - }, - "type": "array" - }, - "zipCodes": { - "description": "A list of zip codes of the member. Must also be set with the following fields: * country_code * hashed_first_name * hashed_last_name", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, - "ContactInfoList": { - "description": "Wrapper message for a list of contact information defining Customer Match audience members.", - "id": "ContactInfoList", - "properties": { - "consent": { - "$ref": "Consent", - "description": "Input only. The consent setting for the users in contact_infos. Leaving this field unset indicates that consent is not specified. If ad_user_data or ad_personalization fields are set to `CONSENT_STATUS_DENIED`, the request will return an error." - }, - "contactInfos": { - "description": "A list of ContactInfo objects defining Customer Match audience members. The size of members after splitting the contact_infos mustn't be greater than 500,000.", - "items": { - "$ref": "ContactInfo" - }, - "type": "array" - } - }, - "type": "object" - }, "ContentDurationAssignedTargetingOptionDetails": { "description": "Details for content duration assigned targeting option. This will be populated in the content_duration_details field when targeting_type is `TARGETING_TYPE_CONTENT_DURATION`. Explicitly targeting all options is not supported. Remove all content duration targeting options to achieve this effect.", "id": "ContentDurationAssignedTargetingOptionDetails", @@ -13852,46 +13573,6 @@ }, "type": "object" }, - "EditCustomerMatchMembersRequest": { - "description": "Request message for FirstAndThirdPartyAudienceService.EditCustomerMatchMembers.", - "id": "EditCustomerMatchMembersRequest", - "properties": { - "addedContactInfoList": { - "$ref": "ContactInfoList", - "description": "Input only. A list of contact information to define the members to be added." - }, - "addedMobileDeviceIdList": { - "$ref": "MobileDeviceIdList", - "description": "Input only. A list of mobile device IDs to define the members to be added." - }, - "advertiserId": { - "description": "Required. The ID of the owner advertiser of the updated Customer Match FirstAndThirdPartyAudience.", - "format": "int64", - "type": "string" - }, - "removedContactInfoList": { - "$ref": "ContactInfoList", - "description": "Input only. A list of contact information to define the members to be removed." - }, - "removedMobileDeviceIdList": { - "$ref": "MobileDeviceIdList", - "description": "Input only. A list of mobile device IDs to define the members to be removed." - } - }, - "type": "object" - }, - "EditCustomerMatchMembersResponse": { - "description": "The response of FirstAndThirdPartyAudienceService.EditCustomerMatchMembers.", - "id": "EditCustomerMatchMembersResponse", - "properties": { - "firstAndThirdPartyAudienceId": { - "description": "Required. The ID of the updated Customer Match FirstAndThirdPartyAudience.", - "format": "int64", - "type": "string" - } - }, - "type": "object" - }, "EditGuaranteedOrderReadAccessorsRequest": { "description": "Request message for GuaranteedOrderService.EditGuaranteedOrderReadAccessors.", "id": "EditGuaranteedOrderReadAccessorsRequest", @@ -14857,165 +14538,6 @@ }, "type": "object" }, - "FirstAndThirdPartyAudience": { - "description": "Describes a first or third party audience list used for targeting. First party audiences are created via usage of client data. Third party audiences are provided by Third Party data providers and can only be licensed to customers.", - "id": "FirstAndThirdPartyAudience", - "properties": { - "activeDisplayAudienceSize": { - "description": "Output only. The estimated audience size for the Display network in the past month. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only returned in GET request.", - "format": "int64", - "readOnly": true, - "type": "string" - }, - "appId": { - "description": "The app_id matches with the type of the mobile_device_ids being uploaded. Only applicable to audience_type `CUSTOMER_MATCH_DEVICE_ID`", - "type": "string" - }, - "audienceSource": { - "description": "Output only. The source of the audience.", - "enum": [ - "AUDIENCE_SOURCE_UNSPECIFIED", - "DISPLAY_VIDEO_360", - "CAMPAIGN_MANAGER", - "AD_MANAGER", - "SEARCH_ADS_360", - "YOUTUBE", - "ADS_DATA_HUB" - ], - "enumDescriptions": [ - "Default value when audience source is not specified or is unknown.", - "Originated from Display \u0026 Video 360.", - "Originated from Campaign Manager 360.", - "Originated from Google Ad Manager.", - "Originated from Search Ads 360.", - "Originated from Youtube.", - "Originated from Ads Data Hub." - ], - "readOnly": true, - "type": "string" - }, - "audienceType": { - "description": "The type of the audience.", - "enum": [ - "AUDIENCE_TYPE_UNSPECIFIED", - "CUSTOMER_MATCH_CONTACT_INFO", - "CUSTOMER_MATCH_DEVICE_ID", - "CUSTOMER_MATCH_USER_ID", - "ACTIVITY_BASED", - "FREQUENCY_CAP", - "TAG_BASED", - "YOUTUBE_USERS", - "LICENSED" - ], - "enumDeprecated": [ - false, - false, - false, - false, - true, - true, - false, - false, - false - ], - "enumDescriptions": [ - "Default value when type is not specified or is unknown.", - "Audience was generated through matching customers to known contact information.", - "Audience was generated through matching customers to known Mobile device IDs.", - "Audience was generated through matching customers to known User IDs.", - "Audience was created based on campaign activity.", - "Audience was created based on excluding the number of impressions they were served.", - "Audience was created based on custom variables attached to pixel.", - "Audience was created based on past interactions with videos, YouTube ads, or YouTube channel.", - "Subtype of third party audience type." - ], - "type": "string" - }, - "contactInfoList": { - "$ref": "ContactInfoList", - "description": "Input only. A list of contact information to define the initial audience members. Only applicable to audience_type `CUSTOMER_MATCH_CONTACT_INFO`" - }, - "description": { - "description": "The user-provided description of the audience. Only applicable to first party audiences.", - "type": "string" - }, - "displayAudienceSize": { - "description": "Output only. The estimated audience size for the Display network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only returned in GET request.", - "format": "int64", - "readOnly": true, - "type": "string" - }, - "displayDesktopAudienceSize": { - "description": "Output only. The estimated desktop audience size in Display network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only applicable to first party audiences. Only returned in GET request.", - "format": "int64", - "readOnly": true, - "type": "string" - }, - "displayMobileAppAudienceSize": { - "description": "Output only. The estimated mobile app audience size in Display network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only applicable to first party audiences. Only returned in GET request.", - "format": "int64", - "readOnly": true, - "type": "string" - }, - "displayMobileWebAudienceSize": { - "description": "Output only. The estimated mobile web audience size in Display network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only applicable to first party audiences. Only returned in GET request.", - "format": "int64", - "readOnly": true, - "type": "string" - }, - "displayName": { - "description": "The display name of the first and third party audience.", - "type": "string" - }, - "firstAndThirdPartyAudienceId": { - "description": "Output only. The unique ID of the first and third party audience. Assigned by the system.", - "format": "int64", - "readOnly": true, - "type": "string" - }, - "firstAndThirdPartyAudienceType": { - "description": "Whether the audience is a first or third party audience.", - "enum": [ - "FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED", - "FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY", - "FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY" - ], - "enumDescriptions": [ - "Default value when type is not specified or is unknown.", - "Audience that is created via usage of client data.", - "Audience that is provided by Third Party data providers." - ], - "type": "string" - }, - "gmailAudienceSize": { - "description": "Output only. The estimated audience size for Gmail network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only applicable to first party audiences. Only returned in GET request.", - "format": "int64", - "readOnly": true, - "type": "string" - }, - "membershipDurationDays": { - "description": "The duration in days that an entry remains in the audience after the qualifying event. If the audience has no expiration, set the value of this field to 10000. Otherwise, the set value must be greater than 0 and less than or equal to 540. Only applicable to first party audiences. This field is required if one of the following audience_type is used: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID`", - "format": "int64", - "type": "string" - }, - "mobileDeviceIdList": { - "$ref": "MobileDeviceIdList", - "description": "Input only. A list of mobile device IDs to define the initial audience members. Only applicable to audience_type `CUSTOMER_MATCH_DEVICE_ID`" - }, - "name": { - "description": "Output only. The resource name of the first and third party audience.", - "readOnly": true, - "type": "string" - }, - "youtubeAudienceSize": { - "description": "Output only. The estimated audience size for YouTube network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only applicable to first party audiences. Only returned in GET request.", - "format": "int64", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "FirstAndThirdPartyAudienceGroup": { "description": "Details of first and third party audience group. All first and third party audience targeting settings are logically ‘OR’ of each other.", "id": "FirstAndThirdPartyAudienceGroup", @@ -16349,7 +15871,7 @@ "id": "IntegralAdScience", "properties": { "customSegmentId": { - "description": "The custom segment ID provided by Integral Ad Science. The ID must be between `1000001` and `1999999`, inclusive.", + "description": "The custom segment ID provided by Integral Ad Science. The ID must be between `1000001` and `1999999` or `3000001` and `3999999`, inclusive.", "items": { "format": "int64", "type": "string" @@ -17776,23 +17298,6 @@ }, "type": "object" }, - "ListFirstAndThirdPartyAudiencesResponse": { - "id": "ListFirstAndThirdPartyAudiencesResponse", - "properties": { - "firstAndThirdPartyAudiences": { - "description": "The list of first and third party audiences. Audience size properties will not be included. This list will be absent if empty.", - "items": { - "$ref": "FirstAndThirdPartyAudience" - }, - "type": "array" - }, - "nextPageToken": { - "description": "A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `ListFirstAndThirdPartyAudiences` method to retrieve the next page of results.", - "type": "string" - } - }, - "type": "object" - }, "ListFloodlightActivitiesResponse": { "id": "ListFloodlightActivitiesResponse", "properties": { @@ -18457,24 +17962,6 @@ }, "type": "object" }, - "MobileDeviceIdList": { - "description": "Wrapper message for a list of mobile device IDs defining Customer Match audience members.", - "id": "MobileDeviceIdList", - "properties": { - "consent": { - "$ref": "Consent", - "description": "Input only. The consent setting for the users in mobile_device_ids. Leaving this field unset indicates that consent is not specified. If ad_user_data or ad_personalization fields are set to `CONSENT_STATUS_DENIED`, the request will return an error." - }, - "mobileDeviceIds": { - "description": "A list of mobile device IDs defining Customer Match audience members. The size of mobile_device_ids mustn't be greater than 500,000.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "Money": { "description": "Represents an amount of money with its currency type.", "id": "Money", diff --git a/displayvideo/v2/displayvideo-gen.go b/displayvideo/v2/displayvideo-gen.go index 255556f0d5..b42dd80011 100644 --- a/displayvideo/v2/displayvideo-gen.go +++ b/displayvideo/v2/displayvideo-gen.go @@ -142,7 +142,6 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, err s.CombinedAudiences = NewCombinedAudiencesService(s) s.CustomBiddingAlgorithms = NewCustomBiddingAlgorithmsService(s) s.CustomLists = NewCustomListsService(s) - s.FirstAndThirdPartyAudiences = NewFirstAndThirdPartyAudiencesService(s) s.FloodlightGroups = NewFloodlightGroupsService(s) s.GoogleAudiences = NewGoogleAudiencesService(s) s.GuaranteedOrders = NewGuaranteedOrdersService(s) @@ -188,8 +187,6 @@ type Service struct { CustomLists *CustomListsService - FirstAndThirdPartyAudiences *FirstAndThirdPartyAudiencesService - FloodlightGroups *FloodlightGroupsService GoogleAudiences *GoogleAudiencesService @@ -566,15 +563,6 @@ type CustomListsService struct { s *Service } -func NewFirstAndThirdPartyAudiencesService(s *Service) *FirstAndThirdPartyAudiencesService { - rs := &FirstAndThirdPartyAudiencesService{s: s} - return rs -} - -type FirstAndThirdPartyAudiencesService struct { - s *Service -} - func NewFloodlightGroupsService(s *Service) *FloodlightGroupsService { rs := &FloodlightGroupsService{s: s} rs.FloodlightActivities = NewFloodlightGroupsFloodlightActivitiesService(s) @@ -4032,115 +4020,6 @@ func (s CommonInStreamAttribute) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Consent: User consent status. -type Consent struct { - // AdPersonalization: Represents consent for ad personalization. - // - // Possible values: - // "CONSENT_STATUS_UNSPECIFIED" - Type value is not specified or is unknown - // in this version. - // "CONSENT_STATUS_GRANTED" - Consent is granted. - // "CONSENT_STATUS_DENIED" - Consent is denied. - AdPersonalization string `json:"adPersonalization,omitempty"` - // AdUserData: Represents consent for ad user data. - // - // Possible values: - // "CONSENT_STATUS_UNSPECIFIED" - Type value is not specified or is unknown - // in this version. - // "CONSENT_STATUS_GRANTED" - Consent is granted. - // "CONSENT_STATUS_DENIED" - Consent is denied. - AdUserData string `json:"adUserData,omitempty"` - // ForceSendFields is a list of field names (e.g. "AdPersonalization") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AdPersonalization") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s Consent) MarshalJSON() ([]byte, error) { - type NoMethod Consent - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// ContactInfo: Contact information defining a Customer Match audience member. -type ContactInfo struct { - // CountryCode: Country code of the member. Must also be set with the following - // fields: * hashed_first_name * hashed_last_name * zip_codes - CountryCode string `json:"countryCode,omitempty"` - // HashedEmails: A list of SHA256 hashed email of the member. Before hashing, - // remove all whitespace and make sure the string is all lowercase. - HashedEmails []string `json:"hashedEmails,omitempty"` - // HashedFirstName: SHA256 hashed first name of the member. Before hashing, - // remove all whitespace and make sure the string is all lowercase. Must also - // be set with the following fields: * country_code * hashed_last_name * - // zip_codes - HashedFirstName string `json:"hashedFirstName,omitempty"` - // HashedLastName: SHA256 hashed last name of the member. Before hashing, - // remove all whitespace and make sure the string is all lowercase. Must also - // be set with the following fields: * country_code * hashed_first_name * - // zip_codes - HashedLastName string `json:"hashedLastName,omitempty"` - // HashedPhoneNumbers: A list of SHA256 hashed phone numbers of the member. - // Before hashing, all phone numbers must be formatted using the E.164 format - // (//en.wikipedia.org/wiki/E.164) and include the country calling code. - HashedPhoneNumbers []string `json:"hashedPhoneNumbers,omitempty"` - // ZipCodes: A list of zip codes of the member. Must also be set with the - // following fields: * country_code * hashed_first_name * hashed_last_name - ZipCodes []string `json:"zipCodes,omitempty"` - // ForceSendFields is a list of field names (e.g. "CountryCode") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CountryCode") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ContactInfo) MarshalJSON() ([]byte, error) { - type NoMethod ContactInfo - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// ContactInfoList: Wrapper message for a list of contact information defining -// Customer Match audience members. -type ContactInfoList struct { - // Consent: Input only. The consent setting for the users in contact_infos. - // Leaving this field unset indicates that consent is not specified. If - // ad_user_data or ad_personalization fields are set to - // `CONSENT_STATUS_DENIED`, the request will return an error. - Consent *Consent `json:"consent,omitempty"` - // ContactInfos: A list of ContactInfo objects defining Customer Match audience - // members. The size of members after splitting the contact_infos mustn't be - // greater than 500,000. - ContactInfos []*ContactInfo `json:"contactInfos,omitempty"` - // ForceSendFields is a list of field names (e.g. "Consent") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Consent") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ContactInfoList) MarshalJSON() ([]byte, error) { - type NoMethod ContactInfoList - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ContentDurationAssignedTargetingOptionDetails: Details for content duration // assigned targeting option. This will be populated in the // content_duration_details field when targeting_type is @@ -6496,69 +6375,6 @@ func (s DuplicateLineItemResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// EditCustomerMatchMembersRequest: Request message for -// FirstAndThirdPartyAudienceService.EditCustomerMatchMembers. -type EditCustomerMatchMembersRequest struct { - // AddedContactInfoList: Input only. A list of contact information to define - // the members to be added. - AddedContactInfoList *ContactInfoList `json:"addedContactInfoList,omitempty"` - // AddedMobileDeviceIdList: Input only. A list of mobile device IDs to define - // the members to be added. - AddedMobileDeviceIdList *MobileDeviceIdList `json:"addedMobileDeviceIdList,omitempty"` - // AdvertiserId: Required. The ID of the owner advertiser of the updated - // Customer Match FirstAndThirdPartyAudience. - AdvertiserId int64 `json:"advertiserId,omitempty,string"` - // RemovedContactInfoList: Input only. A list of contact information to define - // the members to be removed. - RemovedContactInfoList *ContactInfoList `json:"removedContactInfoList,omitempty"` - // RemovedMobileDeviceIdList: Input only. A list of mobile device IDs to define - // the members to be removed. - RemovedMobileDeviceIdList *MobileDeviceIdList `json:"removedMobileDeviceIdList,omitempty"` - // ForceSendFields is a list of field names (e.g. "AddedContactInfoList") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AddedContactInfoList") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s EditCustomerMatchMembersRequest) MarshalJSON() ([]byte, error) { - type NoMethod EditCustomerMatchMembersRequest - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// EditCustomerMatchMembersResponse: The response of -// FirstAndThirdPartyAudienceService.EditCustomerMatchMembers. -type EditCustomerMatchMembersResponse struct { - // FirstAndThirdPartyAudienceId: Required. The ID of the updated Customer Match - // FirstAndThirdPartyAudience. - FirstAndThirdPartyAudienceId int64 `json:"firstAndThirdPartyAudienceId,omitempty,string"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. - // "FirstAndThirdPartyAudienceId") to unconditionally include in API requests. - // By default, fields with empty or default values are omitted from API - // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields - // for more details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "FirstAndThirdPartyAudienceId") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s EditCustomerMatchMembersResponse) MarshalJSON() ([]byte, error) { - type NoMethod EditCustomerMatchMembersResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // EditGuaranteedOrderReadAccessorsRequest: Request message for // GuaranteedOrderService.EditGuaranteedOrderReadAccessors. type EditGuaranteedOrderReadAccessorsRequest struct { @@ -7294,144 +7110,6 @@ func (s ExitEvent) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// FirstAndThirdPartyAudience: Describes a first or third party audience list -// used for targeting. First party audiences are created via usage of client -// data. Third party audiences are provided by Third Party data providers and -// can only be licensed to customers. -type FirstAndThirdPartyAudience struct { - // ActiveDisplayAudienceSize: Output only. The estimated audience size for the - // Display network in the past month. If the size is less than 1000, the number - // will be hidden and 0 will be returned due to privacy reasons. Otherwise, the - // number will be rounded off to two significant digits. Only returned in GET - // request. - ActiveDisplayAudienceSize int64 `json:"activeDisplayAudienceSize,omitempty,string"` - // AppId: The app_id matches with the type of the mobile_device_ids being - // uploaded. Only applicable to audience_type `CUSTOMER_MATCH_DEVICE_ID` - AppId string `json:"appId,omitempty"` - // AudienceSource: Output only. The source of the audience. - // - // Possible values: - // "AUDIENCE_SOURCE_UNSPECIFIED" - Default value when audience source is not - // specified or is unknown. - // "DISPLAY_VIDEO_360" - Originated from Display & Video 360. - // "CAMPAIGN_MANAGER" - Originated from Campaign Manager 360. - // "AD_MANAGER" - Originated from Google Ad Manager. - // "SEARCH_ADS_360" - Originated from Search Ads 360. - // "YOUTUBE" - Originated from Youtube. - // "ADS_DATA_HUB" - Originated from Ads Data Hub. - AudienceSource string `json:"audienceSource,omitempty"` - // AudienceType: The type of the audience. - // - // Possible values: - // "AUDIENCE_TYPE_UNSPECIFIED" - Default value when type is not specified or - // is unknown. - // "CUSTOMER_MATCH_CONTACT_INFO" - Audience was generated through matching - // customers to known contact information. - // "CUSTOMER_MATCH_DEVICE_ID" - Audience was generated through matching - // customers to known Mobile device IDs. - // "CUSTOMER_MATCH_USER_ID" - Audience was generated through matching - // customers to known User IDs. - // "ACTIVITY_BASED" - Audience was created based on campaign activity. - // "FREQUENCY_CAP" - Audience was created based on excluding the number of - // impressions they were served. - // "TAG_BASED" - Audience was created based on custom variables attached to - // pixel. - // "YOUTUBE_USERS" - Audience was created based on past interactions with - // videos, YouTube ads, or YouTube channel. - // "LICENSED" - Subtype of third party audience type. - AudienceType string `json:"audienceType,omitempty"` - // ContactInfoList: Input only. A list of contact information to define the - // initial audience members. Only applicable to audience_type - // `CUSTOMER_MATCH_CONTACT_INFO` - ContactInfoList *ContactInfoList `json:"contactInfoList,omitempty"` - // Description: The user-provided description of the audience. Only applicable - // to first party audiences. - Description string `json:"description,omitempty"` - // DisplayAudienceSize: Output only. The estimated audience size for the - // Display network. If the size is less than 1000, the number will be hidden - // and 0 will be returned due to privacy reasons. Otherwise, the number will be - // rounded off to two significant digits. Only returned in GET request. - DisplayAudienceSize int64 `json:"displayAudienceSize,omitempty,string"` - // DisplayDesktopAudienceSize: Output only. The estimated desktop audience size - // in Display network. If the size is less than 1000, the number will be hidden - // and 0 will be returned due to privacy reasons. Otherwise, the number will be - // rounded off to two significant digits. Only applicable to first party - // audiences. Only returned in GET request. - DisplayDesktopAudienceSize int64 `json:"displayDesktopAudienceSize,omitempty,string"` - // DisplayMobileAppAudienceSize: Output only. The estimated mobile app audience - // size in Display network. If the size is less than 1000, the number will be - // hidden and 0 will be returned due to privacy reasons. Otherwise, the number - // will be rounded off to two significant digits. Only applicable to first - // party audiences. Only returned in GET request. - DisplayMobileAppAudienceSize int64 `json:"displayMobileAppAudienceSize,omitempty,string"` - // DisplayMobileWebAudienceSize: Output only. The estimated mobile web audience - // size in Display network. If the size is less than 1000, the number will be - // hidden and 0 will be returned due to privacy reasons. Otherwise, the number - // will be rounded off to two significant digits. Only applicable to first - // party audiences. Only returned in GET request. - DisplayMobileWebAudienceSize int64 `json:"displayMobileWebAudienceSize,omitempty,string"` - // DisplayName: The display name of the first and third party audience. - DisplayName string `json:"displayName,omitempty"` - // FirstAndThirdPartyAudienceId: Output only. The unique ID of the first and - // third party audience. Assigned by the system. - FirstAndThirdPartyAudienceId int64 `json:"firstAndThirdPartyAudienceId,omitempty,string"` - // FirstAndThirdPartyAudienceType: Whether the audience is a first or third - // party audience. - // - // Possible values: - // "FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED" - Default value when - // type is not specified or is unknown. - // "FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY" - Audience that is - // created via usage of client data. - // "FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY" - Audience that is - // provided by Third Party data providers. - FirstAndThirdPartyAudienceType string `json:"firstAndThirdPartyAudienceType,omitempty"` - // GmailAudienceSize: Output only. The estimated audience size for Gmail - // network. If the size is less than 1000, the number will be hidden and 0 will - // be returned due to privacy reasons. Otherwise, the number will be rounded - // off to two significant digits. Only applicable to first party audiences. - // Only returned in GET request. - GmailAudienceSize int64 `json:"gmailAudienceSize,omitempty,string"` - // MembershipDurationDays: The duration in days that an entry remains in the - // audience after the qualifying event. If the audience has no expiration, set - // the value of this field to 10000. Otherwise, the set value must be greater - // than 0 and less than or equal to 540. Only applicable to first party - // audiences. This field is required if one of the following audience_type is - // used: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID` - MembershipDurationDays int64 `json:"membershipDurationDays,omitempty,string"` - // MobileDeviceIdList: Input only. A list of mobile device IDs to define the - // initial audience members. Only applicable to audience_type - // `CUSTOMER_MATCH_DEVICE_ID` - MobileDeviceIdList *MobileDeviceIdList `json:"mobileDeviceIdList,omitempty"` - // Name: Output only. The resource name of the first and third party audience. - Name string `json:"name,omitempty"` - // YoutubeAudienceSize: Output only. The estimated audience size for YouTube - // network. If the size is less than 1000, the number will be hidden and 0 will - // be returned due to privacy reasons. Otherwise, the number will be rounded - // off to two significant digits. Only applicable to first party audiences. - // Only returned in GET request. - YoutubeAudienceSize int64 `json:"youtubeAudienceSize,omitempty,string"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "ActiveDisplayAudienceSize") - // to unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ActiveDisplayAudienceSize") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s FirstAndThirdPartyAudience) MarshalJSON() ([]byte, error) { - type NoMethod FirstAndThirdPartyAudience - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // FirstAndThirdPartyAudienceGroup: Details of first and third party audience // group. All first and third party audience targeting settings are logically // ‘OR’ of each other. @@ -8772,7 +8450,8 @@ func (s InsertionOrderBudgetSegment) MarshalJSON() ([]byte, error) { // IntegralAdScience: Details of Integral Ad Science settings. type IntegralAdScience struct { // CustomSegmentId: The custom segment ID provided by Integral Ad Science. The - // ID must be between `1000001` and `1999999`, inclusive. + // ID must be between `1000001` and `1999999` or `3000001` and `3999999`, + // inclusive. CustomSegmentId googleapi.Int64s `json:"customSegmentId,omitempty"` // DisplayViewability: Display Viewability section (applicable to display line // items only). @@ -10351,37 +10030,6 @@ func (s ListCustomListsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type ListFirstAndThirdPartyAudiencesResponse struct { - // FirstAndThirdPartyAudiences: The list of first and third party audiences. - // Audience size properties will not be included. This list will be absent if - // empty. - FirstAndThirdPartyAudiences []*FirstAndThirdPartyAudience `json:"firstAndThirdPartyAudiences,omitempty"` - // NextPageToken: A token to retrieve the next page of results. Pass this value - // in the page_token field in the subsequent call to - // `ListFirstAndThirdPartyAudiences` method to retrieve the next page of - // results. - NextPageToken string `json:"nextPageToken,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. - // "FirstAndThirdPartyAudiences") to unconditionally include in API requests. - // By default, fields with empty or default values are omitted from API - // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields - // for more details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "FirstAndThirdPartyAudiences") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ListFirstAndThirdPartyAudiencesResponse) MarshalJSON() ([]byte, error) { - type NoMethod ListFirstAndThirdPartyAudiencesResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type ListFloodlightActivitiesResponse struct { // FloodlightActivities: The list of Floodlight activities. This list will be // absent if empty. @@ -11348,36 +10996,6 @@ func (s MobileApp) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// MobileDeviceIdList: Wrapper message for a list of mobile device IDs defining -// Customer Match audience members. -type MobileDeviceIdList struct { - // Consent: Input only. The consent setting for the users in mobile_device_ids. - // Leaving this field unset indicates that consent is not specified. If - // ad_user_data or ad_personalization fields are set to - // `CONSENT_STATUS_DENIED`, the request will return an error. - Consent *Consent `json:"consent,omitempty"` - // MobileDeviceIds: A list of mobile device IDs defining Customer Match - // audience members. The size of mobile_device_ids mustn't be greater than - // 500,000. - MobileDeviceIds []string `json:"mobileDeviceIds,omitempty"` - // ForceSendFields is a list of field names (e.g. "Consent") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Consent") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s MobileDeviceIdList) MarshalJSON() ([]byte, error) { - type NoMethod MobileDeviceIdList - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Money: Represents an amount of money with its currency type. type Money struct { // CurrencyCode: The three-letter currency code defined in ISO 4217. @@ -29378,647 +28996,6 @@ func (c *CustomListsListCall) Pages(ctx context.Context, f func(*ListCustomLists } } -type FirstAndThirdPartyAudiencesCreateCall struct { - s *Service - firstandthirdpartyaudience *FirstAndThirdPartyAudience - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Create: Creates a FirstAndThirdPartyAudience. Only supported for the -// following audience_type: * `CUSTOMER_MATCH_CONTACT_INFO` * -// `CUSTOMER_MATCH_DEVICE_ID` -func (r *FirstAndThirdPartyAudiencesService) Create(firstandthirdpartyaudience *FirstAndThirdPartyAudience) *FirstAndThirdPartyAudiencesCreateCall { - c := &FirstAndThirdPartyAudiencesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.firstandthirdpartyaudience = firstandthirdpartyaudience - return c -} - -// AdvertiserId sets the optional parameter "advertiserId": Required. The ID of -// the advertiser under whom the FirstAndThirdPartyAudience will be created. -func (c *FirstAndThirdPartyAudiencesCreateCall) AdvertiserId(advertiserId int64) *FirstAndThirdPartyAudiencesCreateCall { - c.urlParams_.Set("advertiserId", fmt.Sprint(advertiserId)) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *FirstAndThirdPartyAudiencesCreateCall) Fields(s ...googleapi.Field) *FirstAndThirdPartyAudiencesCreateCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *FirstAndThirdPartyAudiencesCreateCall) Context(ctx context.Context) *FirstAndThirdPartyAudiencesCreateCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *FirstAndThirdPartyAudiencesCreateCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *FirstAndThirdPartyAudiencesCreateCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.firstandthirdpartyaudience) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2/firstAndThirdPartyAudiences") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "displayvideo.firstAndThirdPartyAudiences.create", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "displayvideo.firstAndThirdPartyAudiences.create" call. -// Any non-2xx status code is an error. Response headers are in either -// *FirstAndThirdPartyAudience.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 *FirstAndThirdPartyAudiencesCreateCall) Do(opts ...googleapi.CallOption) (*FirstAndThirdPartyAudience, 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 := &FirstAndThirdPartyAudience{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "displayvideo.firstAndThirdPartyAudiences.create", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type FirstAndThirdPartyAudiencesEditCustomerMatchMembersCall struct { - s *Service - firstAndThirdPartyAudienceId int64 - editcustomermatchmembersrequest *EditCustomerMatchMembersRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// EditCustomerMatchMembers: Updates the member list of a Customer Match -// audience. Only supported for the following audience_type: * -// `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID` -// -// - firstAndThirdPartyAudienceId: The ID of the Customer Match -// FirstAndThirdPartyAudience whose members will be edited. -func (r *FirstAndThirdPartyAudiencesService) EditCustomerMatchMembers(firstAndThirdPartyAudienceId int64, editcustomermatchmembersrequest *EditCustomerMatchMembersRequest) *FirstAndThirdPartyAudiencesEditCustomerMatchMembersCall { - c := &FirstAndThirdPartyAudiencesEditCustomerMatchMembersCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.firstAndThirdPartyAudienceId = firstAndThirdPartyAudienceId - c.editcustomermatchmembersrequest = editcustomermatchmembersrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *FirstAndThirdPartyAudiencesEditCustomerMatchMembersCall) Fields(s ...googleapi.Field) *FirstAndThirdPartyAudiencesEditCustomerMatchMembersCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *FirstAndThirdPartyAudiencesEditCustomerMatchMembersCall) Context(ctx context.Context) *FirstAndThirdPartyAudiencesEditCustomerMatchMembersCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *FirstAndThirdPartyAudiencesEditCustomerMatchMembersCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *FirstAndThirdPartyAudiencesEditCustomerMatchMembersCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.editcustomermatchmembersrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2/firstAndThirdPartyAudiences/{+firstAndThirdPartyAudienceId}:editCustomerMatchMembers") - 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{ - "firstAndThirdPartyAudienceId": strconv.FormatInt(c.firstAndThirdPartyAudienceId, 10), - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "displayvideo.firstAndThirdPartyAudiences.editCustomerMatchMembers", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "displayvideo.firstAndThirdPartyAudiences.editCustomerMatchMembers" call. -// Any non-2xx status code is an error. Response headers are in either -// *EditCustomerMatchMembersResponse.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 *FirstAndThirdPartyAudiencesEditCustomerMatchMembersCall) Do(opts ...googleapi.CallOption) (*EditCustomerMatchMembersResponse, 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 := &EditCustomerMatchMembersResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "displayvideo.firstAndThirdPartyAudiences.editCustomerMatchMembers", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type FirstAndThirdPartyAudiencesGetCall struct { - s *Service - firstAndThirdPartyAudienceId int64 - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: Gets a first and third party audience. -// -// - firstAndThirdPartyAudienceId: The ID of the first and third party audience -// to fetch. -func (r *FirstAndThirdPartyAudiencesService) Get(firstAndThirdPartyAudienceId int64) *FirstAndThirdPartyAudiencesGetCall { - c := &FirstAndThirdPartyAudiencesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.firstAndThirdPartyAudienceId = firstAndThirdPartyAudienceId - return c -} - -// AdvertiserId sets the optional parameter "advertiserId": The ID of the -// advertiser that has access to the fetched first and third party audience. -func (c *FirstAndThirdPartyAudiencesGetCall) AdvertiserId(advertiserId int64) *FirstAndThirdPartyAudiencesGetCall { - c.urlParams_.Set("advertiserId", fmt.Sprint(advertiserId)) - return c -} - -// PartnerId sets the optional parameter "partnerId": The ID of the partner -// that has access to the fetched first and third party audience. -func (c *FirstAndThirdPartyAudiencesGetCall) PartnerId(partnerId int64) *FirstAndThirdPartyAudiencesGetCall { - c.urlParams_.Set("partnerId", fmt.Sprint(partnerId)) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *FirstAndThirdPartyAudiencesGetCall) Fields(s ...googleapi.Field) *FirstAndThirdPartyAudiencesGetCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *FirstAndThirdPartyAudiencesGetCall) IfNoneMatch(entityTag string) *FirstAndThirdPartyAudiencesGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *FirstAndThirdPartyAudiencesGetCall) Context(ctx context.Context) *FirstAndThirdPartyAudiencesGetCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *FirstAndThirdPartyAudiencesGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *FirstAndThirdPartyAudiencesGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2/firstAndThirdPartyAudiences/{+firstAndThirdPartyAudienceId}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "firstAndThirdPartyAudienceId": strconv.FormatInt(c.firstAndThirdPartyAudienceId, 10), - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "displayvideo.firstAndThirdPartyAudiences.get", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "displayvideo.firstAndThirdPartyAudiences.get" call. -// Any non-2xx status code is an error. Response headers are in either -// *FirstAndThirdPartyAudience.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 *FirstAndThirdPartyAudiencesGetCall) Do(opts ...googleapi.CallOption) (*FirstAndThirdPartyAudience, 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 := &FirstAndThirdPartyAudience{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "displayvideo.firstAndThirdPartyAudiences.get", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type FirstAndThirdPartyAudiencesListCall struct { - s *Service - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Lists first and third party audiences. The order is defined by the -// order_by parameter. -func (r *FirstAndThirdPartyAudiencesService) List() *FirstAndThirdPartyAudiencesListCall { - c := &FirstAndThirdPartyAudiencesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - return c -} - -// AdvertiserId sets the optional parameter "advertiserId": The ID of the -// advertiser that has access to the fetched first and third party audiences. -func (c *FirstAndThirdPartyAudiencesListCall) AdvertiserId(advertiserId int64) *FirstAndThirdPartyAudiencesListCall { - c.urlParams_.Set("advertiserId", fmt.Sprint(advertiserId)) - return c -} - -// Filter sets the optional parameter "filter": Allows filtering by first and -// third party audience fields. Supported syntax: * Filter expressions for -// first and third party audiences can only contain at most one restriction. * -// A restriction has the form of `{field} {operator} {value}`. * All fields -// must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: -// * All first and third party audiences for which the display name contains -// "Google": `displayName:"Google". The length of this field should be no more -// than 500 characters. Reference our filter `LIST` requests -// (/display-video/api/guides/how-tos/filters) guide for more information. -func (c *FirstAndThirdPartyAudiencesListCall) Filter(filter string) *FirstAndThirdPartyAudiencesListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// OrderBy sets the optional parameter "orderBy": Field by which to sort the -// list. Acceptable values are: * `firstAndThirdPartyAudienceId` (default) * -// `displayName` The default sorting order is ascending. To specify descending -// order for a field, a suffix "desc" should be added to the field name. -// Example: `displayName desc`. -func (c *FirstAndThirdPartyAudiencesListCall) OrderBy(orderBy string) *FirstAndThirdPartyAudiencesListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageSize sets the optional parameter "pageSize": Requested page size. Must -// be between `1` and `5000`. If unspecified, this value defaults to `100`. -// Returns error code `INVALID_ARGUMENT` if an invalid value is specified. -func (c *FirstAndThirdPartyAudiencesListCall) PageSize(pageSize int64) *FirstAndThirdPartyAudiencesListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": A token identifying a -// page of results the server should return. Typically, this is the value of -// next_page_token returned from the previous call to -// `ListFirstAndThirdPartyAudiences` method. If not specified, the first page -// of results will be returned. -func (c *FirstAndThirdPartyAudiencesListCall) PageToken(pageToken string) *FirstAndThirdPartyAudiencesListCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// PartnerId sets the optional parameter "partnerId": The ID of the partner -// that has access to the fetched first and third party audiences. -func (c *FirstAndThirdPartyAudiencesListCall) PartnerId(partnerId int64) *FirstAndThirdPartyAudiencesListCall { - c.urlParams_.Set("partnerId", fmt.Sprint(partnerId)) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *FirstAndThirdPartyAudiencesListCall) Fields(s ...googleapi.Field) *FirstAndThirdPartyAudiencesListCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *FirstAndThirdPartyAudiencesListCall) IfNoneMatch(entityTag string) *FirstAndThirdPartyAudiencesListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *FirstAndThirdPartyAudiencesListCall) Context(ctx context.Context) *FirstAndThirdPartyAudiencesListCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *FirstAndThirdPartyAudiencesListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *FirstAndThirdPartyAudiencesListCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2/firstAndThirdPartyAudiences") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "displayvideo.firstAndThirdPartyAudiences.list", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "displayvideo.firstAndThirdPartyAudiences.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *ListFirstAndThirdPartyAudiencesResponse.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 *FirstAndThirdPartyAudiencesListCall) Do(opts ...googleapi.CallOption) (*ListFirstAndThirdPartyAudiencesResponse, 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 := &ListFirstAndThirdPartyAudiencesResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "displayvideo.firstAndThirdPartyAudiences.list", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -// 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 *FirstAndThirdPartyAudiencesListCall) Pages(ctx context.Context, f func(*ListFirstAndThirdPartyAudiencesResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type FirstAndThirdPartyAudiencesPatchCall struct { - s *Service - firstAndThirdPartyAudienceId int64 - firstandthirdpartyaudience *FirstAndThirdPartyAudience - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Patch: Updates an existing FirstAndThirdPartyAudience. Only supported for -// the following audience_type: * `CUSTOMER_MATCH_CONTACT_INFO` * -// `CUSTOMER_MATCH_DEVICE_ID` -// -// - firstAndThirdPartyAudienceId: Output only. The unique ID of the first and -// third party audience. Assigned by the system. -func (r *FirstAndThirdPartyAudiencesService) Patch(firstAndThirdPartyAudienceId int64, firstandthirdpartyaudience *FirstAndThirdPartyAudience) *FirstAndThirdPartyAudiencesPatchCall { - c := &FirstAndThirdPartyAudiencesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.firstAndThirdPartyAudienceId = firstAndThirdPartyAudienceId - c.firstandthirdpartyaudience = firstandthirdpartyaudience - return c -} - -// AdvertiserId sets the optional parameter "advertiserId": Required. The ID of -// the owner advertiser of the updated FirstAndThirdPartyAudience. -func (c *FirstAndThirdPartyAudiencesPatchCall) AdvertiserId(advertiserId int64) *FirstAndThirdPartyAudiencesPatchCall { - c.urlParams_.Set("advertiserId", fmt.Sprint(advertiserId)) - return c -} - -// UpdateMask sets the optional parameter "updateMask": Required. The mask to -// control which fields to update. Updates are only supported for the following -// fields: * `displayName` * `description` * `membershipDurationDays` -func (c *FirstAndThirdPartyAudiencesPatchCall) UpdateMask(updateMask string) *FirstAndThirdPartyAudiencesPatchCall { - c.urlParams_.Set("updateMask", updateMask) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *FirstAndThirdPartyAudiencesPatchCall) Fields(s ...googleapi.Field) *FirstAndThirdPartyAudiencesPatchCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *FirstAndThirdPartyAudiencesPatchCall) Context(ctx context.Context) *FirstAndThirdPartyAudiencesPatchCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *FirstAndThirdPartyAudiencesPatchCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *FirstAndThirdPartyAudiencesPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.firstandthirdpartyaudience) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2/firstAndThirdPartyAudiences/{+firstAndThirdPartyAudienceId}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "firstAndThirdPartyAudienceId": strconv.FormatInt(c.firstAndThirdPartyAudienceId, 10), - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "displayvideo.firstAndThirdPartyAudiences.patch", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "displayvideo.firstAndThirdPartyAudiences.patch" call. -// Any non-2xx status code is an error. Response headers are in either -// *FirstAndThirdPartyAudience.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 *FirstAndThirdPartyAudiencesPatchCall) Do(opts ...googleapi.CallOption) (*FirstAndThirdPartyAudience, 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 := &FirstAndThirdPartyAudience{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "displayvideo.firstAndThirdPartyAudiences.patch", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type FloodlightGroupsGetCall struct { s *Service floodlightGroupId int64 diff --git a/displayvideo/v3/displayvideo-api.json b/displayvideo/v3/displayvideo-api.json index 81511993e0..ab23353b40 100644 --- a/displayvideo/v3/displayvideo-api.json +++ b/displayvideo/v3/displayvideo-api.json @@ -9222,7 +9222,7 @@ } } }, - "revision": "20241212", + "revision": "20250109", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -17354,7 +17354,7 @@ "id": "IntegralAdScience", "properties": { "customSegmentId": { - "description": "The custom segment ID provided by Integral Ad Science. The ID must be between `1000001` and `1999999`, inclusive.", + "description": "The custom segment ID provided by Integral Ad Science. The ID must be between `1000001` and `1999999` or `3000001` and `3999999`, inclusive.", "items": { "format": "int64", "type": "string" diff --git a/displayvideo/v3/displayvideo-gen.go b/displayvideo/v3/displayvideo-gen.go index 70ad72ed0d..d47d22861b 100644 --- a/displayvideo/v3/displayvideo-gen.go +++ b/displayvideo/v3/displayvideo-gen.go @@ -9755,7 +9755,8 @@ func (s InsertionOrderBudgetSegment) MarshalJSON() ([]byte, error) { // IntegralAdScience: Details of Integral Ad Science settings. type IntegralAdScience struct { // CustomSegmentId: The custom segment ID provided by Integral Ad Science. The - // ID must be between `1000001` and `1999999`, inclusive. + // ID must be between `1000001` and `1999999` or `3000001` and `3999999`, + // inclusive. CustomSegmentId googleapi.Int64s `json:"customSegmentId,omitempty"` // DisplayViewability: Display Viewability section (applicable to display line // items only). diff --git a/healthcare/v1/healthcare-api.json b/healthcare/v1/healthcare-api.json index ccf9a3c699..e7054ca533 100644 --- a/healthcare/v1/healthcare-api.json +++ b/healthcare/v1/healthcare-api.json @@ -3704,7 +3704,7 @@ "type": "string" }, "profile": { - "description": "Required. The canonical URL of a profile that this resource should be validated against. For example, to validate a Patient resource against the US Core Patient profile this parameter would be `http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient`. A StructureDefinition with this canonical URL must exist in the FHIR store.", + "description": "Optional. The canonical URL of a profile that this resource should be validated against. For example, to validate a Patient resource against the US Core Patient profile this parameter would be `http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient`. A StructureDefinition with this canonical URL must exist in the FHIR store.", "location": "query", "type": "string" }, @@ -4103,7 +4103,7 @@ "type": "string" }, "resourceType": { - "description": "Required. The FHIR resource type to search, such as Patient or Observation. For a complete list, see the FHIR Resource Index ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html), [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)).", + "description": "Optional. The FHIR resource type to search, such as Patient or Observation. For a complete list, see the FHIR Resource Index ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html), [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)).", "location": "path", "required": true, "type": "string" @@ -4935,7 +4935,7 @@ } } }, - "revision": "20241205", + "revision": "20241226", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "AccessDeterminationLogConfig": { @@ -8240,7 +8240,7 @@ "id": "SearchResourcesRequest", "properties": { "resourceType": { - "description": "Required. The FHIR resource type to search, such as Patient or Observation. For a complete list, see the FHIR Resource Index ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html), [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)).", + "description": "Optional. The FHIR resource type to search, such as Patient or Observation. For a complete list, see the FHIR Resource Index ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html), [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)).", "type": "string" } }, diff --git a/healthcare/v1/healthcare-gen.go b/healthcare/v1/healthcare-gen.go index cfac5e6ed0..c0f310ba46 100644 --- a/healthcare/v1/healthcare-gen.go +++ b/healthcare/v1/healthcare-gen.go @@ -5654,7 +5654,7 @@ func (s SchematizedData) MarshalJSON() ([]byte, error) { // SearchResourcesRequest: Request to search the resources in the specified // FHIR store. type SearchResourcesRequest struct { - // ResourceType: Required. The FHIR resource type to search, such as Patient or + // ResourceType: Optional. The FHIR resource type to search, such as Patient or // Observation. For a complete list, see the FHIR Resource Index (DSTU2 // (http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), STU3 // (http://hl7.org/implement/standards/fhir/STU3/resourcelist.html), R4 @@ -18991,8 +18991,8 @@ func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ResourceValidate(parent return c } -// Profile sets the optional parameter "profile": Required. The canonical URL -// of a profile that this resource should be validated against. For example, to +// Profile sets the optional parameter "profile": The canonical URL of a +// profile that this resource should be validated against. For example, to // validate a Patient resource against the US Core Patient profile this // parameter would be // `http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient`. A @@ -20260,8 +20260,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchTypeCall struct { // (https://cloud.google.com/healthcare/docs/how-tos/fhir-advanced-search). // // - parent: Name of the FHIR store to retrieve resources from. -// - resourceType: The FHIR resource type to search, such as Patient or -// Observation. For a complete list, see the FHIR Resource Index (DSTU2 +// - resourceType: Optional. The FHIR resource type to search, such as Patient +// or Observation. For a complete list, see the FHIR Resource Index (DSTU2 // (http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), STU3 // (http://hl7.org/implement/standards/fhir/STU3/resourcelist.html), R4 // (http://hl7.org/implement/standards/fhir/R4/resourcelist.html)). diff --git a/healthcare/v1beta1/healthcare-api.json b/healthcare/v1beta1/healthcare-api.json index 52812ea4df..be8f0e1ec5 100644 --- a/healthcare/v1beta1/healthcare-api.json +++ b/healthcare/v1beta1/healthcare-api.json @@ -4574,7 +4574,7 @@ "type": "string" }, "profile": { - "description": "Required. The canonical URL of a profile that this resource should be validated against. For example, to validate a Patient resource against the US Core Patient profile this parameter would be `http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient`. A StructureDefinition with this canonical URL must exist in the FHIR store.", + "description": "Optional. The canonical URL of a profile that this resource should be validated against. For example, to validate a Patient resource against the US Core Patient profile this parameter would be `http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient`. A StructureDefinition with this canonical URL must exist in the FHIR store.", "location": "query", "type": "string" }, @@ -4973,7 +4973,7 @@ "type": "string" }, "resourceType": { - "description": "Required. The FHIR resource type to search, such as Patient or Observation. For a complete list, see the FHIR Resource Index ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), [STU3](https://hl7.org/implement/standards/fhir/STU3/resourcelist.html), [R4](https://hl7.org/implement/standards/fhir/R4/resourcelist.html)).", + "description": "Optional. The FHIR resource type to search, such as Patient or Observation. For a complete list, see the FHIR Resource Index ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), [STU3](https://hl7.org/implement/standards/fhir/STU3/resourcelist.html), [R4](https://hl7.org/implement/standards/fhir/R4/resourcelist.html)).", "location": "path", "required": true, "type": "string" @@ -5858,7 +5858,7 @@ } } }, - "revision": "20241205", + "revision": "20241226", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "AccessDeterminationLogConfig": { @@ -10083,7 +10083,7 @@ "id": "SearchResourcesRequest", "properties": { "resourceType": { - "description": "Required. The FHIR resource type to search, such as Patient or Observation. For a complete list, see the FHIR Resource Index ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), [STU3](https://hl7.org/implement/standards/fhir/STU3/resourcelist.html), [R4](https://hl7.org/implement/standards/fhir/R4/resourcelist.html)).", + "description": "Optional. The FHIR resource type to search, such as Patient or Observation. For a complete list, see the FHIR Resource Index ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), [STU3](https://hl7.org/implement/standards/fhir/STU3/resourcelist.html), [R4](https://hl7.org/implement/standards/fhir/R4/resourcelist.html)).", "type": "string" } }, diff --git a/healthcare/v1beta1/healthcare-gen.go b/healthcare/v1beta1/healthcare-gen.go index f339ad79b4..4283d1eca1 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -7054,7 +7054,7 @@ func (s SearchParameter) MarshalJSON() ([]byte, error) { // SearchResourcesRequest: Request to search the resources in the specified // FHIR store. type SearchResourcesRequest struct { - // ResourceType: Required. The FHIR resource type to search, such as Patient or + // ResourceType: Optional. The FHIR resource type to search, such as Patient or // Observation. For a complete list, see the FHIR Resource Index (DSTU2 // (https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), STU3 // (https://hl7.org/implement/standards/fhir/STU3/resourcelist.html), R4 @@ -23439,8 +23439,8 @@ func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ResourceValidate(parent return c } -// Profile sets the optional parameter "profile": Required. The canonical URL -// of a profile that this resource should be validated against. For example, to +// Profile sets the optional parameter "profile": The canonical URL of a +// profile that this resource should be validated against. For example, to // validate a Patient resource against the US Core Patient profile this // parameter would be // `http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient`. A @@ -24722,8 +24722,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchTypeCall struct { // (https://cloud.google.com/healthcare/docs/how-tos/fhir-advanced-search). // // - parent: Name of the FHIR store to retrieve resources from. -// - resourceType: The FHIR resource type to search, such as Patient or -// Observation. For a complete list, see the FHIR Resource Index (DSTU2 +// - resourceType: Optional. The FHIR resource type to search, such as Patient +// or Observation. For a complete list, see the FHIR Resource Index (DSTU2 // (https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html), STU3 // (https://hl7.org/implement/standards/fhir/STU3/resourcelist.html), R4 // (https://hl7.org/implement/standards/fhir/R4/resourcelist.html)). diff --git a/logging/v2/logging-api.json b/logging/v2/logging-api.json index 8e89c954de..542481ce61 100644 --- a/logging/v2/logging-api.json +++ b/logging/v2/logging-api.json @@ -8922,7 +8922,7 @@ } } }, - "revision": "20241018", + "revision": "20250110", "rootUrl": "https://logging.googleapis.com/", "schemas": { "AuditConfig": { @@ -9201,7 +9201,7 @@ "id": "CopyLogEntriesRequest", "properties": { "destination": { - "description": "Required. Destination to which to copy log entries.", + "description": "Required. Destination to which to copy log entries. For example: \"storage.googleapis.com/GCS_BUCKET\"", "type": "string" }, "filter": { diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go index 65ca76cecf..de30874dfb 100644 --- a/logging/v2/logging-gen.go +++ b/logging/v2/logging-gen.go @@ -1381,7 +1381,8 @@ func (s CopyLogEntriesMetadata) MarshalJSON() ([]byte, error) { // CopyLogEntriesRequest: The parameters to CopyLogEntries. type CopyLogEntriesRequest struct { - // Destination: Required. Destination to which to copy log entries. + // Destination: Required. Destination to which to copy log entries. For + // example: "storage.googleapis.com/GCS_BUCKET" Destination string `json:"destination,omitempty"` // Filter: Optional. A filter specifying which log entries to copy. The filter // must be no more than 20k characters. An empty filter matches all log diff --git a/secretmanager/v1/secretmanager-api.json b/secretmanager/v1/secretmanager-api.json index f52641ac64..fd05558f04 100644 --- a/secretmanager/v1/secretmanager-api.json +++ b/secretmanager/v1/secretmanager-api.json @@ -95,6 +95,16 @@ "description": "Regional Endpoint", "endpointUrl": "https://secretmanager.europe-west6.rep.googleapis.com/", "location": "europe-west6" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://secretmanager.europe-west1.rep.googleapis.com/", + "location": "europe-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://secretmanager.europe-west4.rep.googleapis.com/", + "location": "europe-west4" } ], "fullyEncodeReservedExpansion": true, @@ -1190,7 +1200,7 @@ } } }, - "revision": "20241114", + "revision": "20250111", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { diff --git a/secretmanager/v1beta1/secretmanager-api.json b/secretmanager/v1beta1/secretmanager-api.json index 3028bf715b..50f8c37969 100644 --- a/secretmanager/v1beta1/secretmanager-api.json +++ b/secretmanager/v1beta1/secretmanager-api.json @@ -95,6 +95,16 @@ "description": "Regional Endpoint", "endpointUrl": "https://secretmanager.europe-west6.rep.googleapis.com/", "location": "europe-west6" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://secretmanager.europe-west1.rep.googleapis.com/", + "location": "europe-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://secretmanager.europe-west4.rep.googleapis.com/", + "location": "europe-west4" } ], "fullyEncodeReservedExpansion": true, @@ -710,7 +720,7 @@ } } }, - "revision": "20241209", + "revision": "20250111", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { diff --git a/secretmanager/v1beta2/secretmanager-api.json b/secretmanager/v1beta2/secretmanager-api.json index 5e42f990d9..5840451802 100644 --- a/secretmanager/v1beta2/secretmanager-api.json +++ b/secretmanager/v1beta2/secretmanager-api.json @@ -95,6 +95,16 @@ "description": "Regional Endpoint", "endpointUrl": "https://secretmanager.europe-west6.rep.googleapis.com/", "location": "europe-west6" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://secretmanager.europe-west1.rep.googleapis.com/", + "location": "europe-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://secretmanager.europe-west4.rep.googleapis.com/", + "location": "europe-west4" } ], "fullyEncodeReservedExpansion": true, @@ -1190,7 +1200,7 @@ } } }, - "revision": "20241114", + "revision": "20250111", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { diff --git a/spanner/v1/spanner-api.json b/spanner/v1/spanner-api.json index 753f8f1f93..e47876f524 100644 --- a/spanner/v1/spanner-api.json +++ b/spanner/v1/spanner-api.json @@ -2515,7 +2515,7 @@ ] }, "executeSql": { - "description": "Executes an SQL statement, returning all results in a single reply. This method cannot be used to return a result set larger than 10 MiB; if the query yields more data than that, the query fails with a `FAILED_PRECONDITION` error. Operations inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See Transaction for more details. Larger result sets can be fetched in streaming fashion by calling ExecuteStreamingSql instead.", + "description": "Executes an SQL statement, returning all results in a single reply. This method cannot be used to return a result set larger than 10 MiB; if the query yields more data than that, the query fails with a `FAILED_PRECONDITION` error. Operations inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See Transaction for more details. Larger result sets can be fetched in streaming fashion by calling ExecuteStreamingSql instead. The query string can be SQL or [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}:executeSql", "httpMethod": "POST", "id": "spanner.projects.instances.databases.sessions.executeSql", @@ -2544,7 +2544,7 @@ ] }, "executeStreamingSql": { - "description": "Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql, there is no limit on the size of the returned result set. However, no individual row in the result set can exceed 100 MiB, and no column value can exceed 10 MiB.", + "description": "Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql, there is no limit on the size of the returned result set. However, no individual row in the result set can exceed 100 MiB, and no column value can exceed 10 MiB. The query string can be SQL or [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}:executeStreamingSql", "httpMethod": "POST", "id": "spanner.projects.instances.databases.sessions.executeStreamingSql", @@ -3319,7 +3319,7 @@ } } }, - "revision": "20241218", + "revision": "20241220", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "AsymmetricAutoscalingOption": { @@ -4262,7 +4262,7 @@ "type": "string" }, "text": { - "description": "Required. Textual representation of the crontab. User can customize the backup frequency and the backup version time using the cron expression. The version time must be in UTC timzeone. The backup will contain an externally consistent copy of the database at the version time. Allowed frequencies are 12 hour, 1 day, 1 week and 1 month. Examples of valid cron specifications: * `0 2/12 * * * ` : every 12 hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * * ` : every 12 hours at (2,14) hours past midnight in UTC. * `0 2 * * * ` : once a day at 2 past midnight in UTC. * `0 2 * * 0 ` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * * ` : once a month on 8th day at 2 past midnight in UTC.", + "description": "Required. Textual representation of the crontab. User can customize the backup frequency and the backup version time using the cron expression. The version time must be in UTC timezone. The backup will contain an externally consistent copy of the database at the version time. Full backups must be scheduled a minimum of 12 hours apart and incremental backups must be scheduled a minimum of 4 hours apart. Examples of valid cron specifications: * `0 2/12 * * *` : every 12 hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * *` : every 12 hours at (2,14) hours past midnight in UTC. * `0 */4 * * *` : (incremental backups only) every 4 hours at (0, 4, 8, 12, 16, 20) hours past midnight in UTC. * `0 2 * * *` : once a day at 2 past midnight in UTC. * `0 2 * * 0` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * *` : once a month on 8th day at 2 past midnight in UTC.", "type": "string" }, "timeZone": { @@ -4569,6 +4569,10 @@ "description": "The request for ExecuteBatchDml.", "id": "ExecuteBatchDmlRequest", "properties": { + "lastStatements": { + "description": "Optional. If set to true, this request marks the end of the transaction. The transaction should be committed or aborted after these statements execute, and attempts to execute any other requests against this transaction (including reads and queries) will be rejected. Setting this option may cause some error reporting to be deferred until commit time (e.g. validation of unique constraints). Given this, successful execution of statements should not be assumed until a subsequent Commit call completes successfully.", + "type": "boolean" + }, "requestOptions": { "$ref": "RequestOptions", "description": "Common options for this request." @@ -4626,6 +4630,10 @@ "$ref": "DirectedReadOptions", "description": "Directed read options for this request." }, + "lastStatement": { + "description": "Optional. If set to true, this statement marks the end of the transaction. The transaction should be committed or aborted after this statement executes, and attempts to execute any other requests against this transaction (including reads and queries) will be rejected. For DML statements, setting this option may cause some error reporting to be deferred until commit time (e.g. validation of unique constraints). Given this, successful execution of a DML statement should not be assumed until a subsequent Commit call completes successfully.", + "type": "boolean" + }, "paramTypes": { "additionalProperties": { "$ref": "Type" @@ -4903,7 +4911,7 @@ "type": "string" }, "defaultBackupScheduleType": { - "description": "Optional. Controls the default backup behavior for new databases within the instance. Note that `AUTOMATIC` is not permitted for free instances, as backups and backup schedules are not allowed for free instances. In the `GetInstance` or `ListInstances` response, if the value of default_backup_schedule_type is unset or NONE, no default backup schedule will be created for new databases within the instance.", + "description": "Optional. Controls the default backup schedule behavior for new databases within the instance. By default, a backup schedule is created automatically when a new database is created in a new instance. Note that the `AUTOMATIC` value isn't permitted for free instances, as backups and backup schedules aren't supported for free instances. In the `GetInstance` or `ListInstances` response, if the value of `default_backup_schedule_type` isn't set, or set to `NONE`, Spanner doesn't create a default backup schedule for new databases in the instance.", "enum": [ "DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED", "NONE", @@ -4911,8 +4919,8 @@ ], "enumDescriptions": [ "Not specified.", - "No default backup schedule will be created automatically on creation of a database within the instance.", - "A default backup schedule will be created automatically on creation of a database within the instance. Once created, the default backup schedule can be edited or deleted just like any other backup schedule. Currently, the default backup schedule creates a full backup every 24 hours and retains the backup for a period of 7 days." + "A default backup schedule isn't created automatically when a new database is created in the instance.", + "A default backup schedule is created automatically when a new database is created in the instance. The default backup schedule creates a full backup every 24 hours. These full backups are retained for 7 days. You can edit or delete the default backup schedule once it's created." ], "type": "string" }, @@ -7103,12 +7111,14 @@ "enum": [ "TYPE_ANNOTATION_CODE_UNSPECIFIED", "PG_NUMERIC", - "PG_JSONB" + "PG_JSONB", + "PG_OID" ], "enumDescriptions": [ "Not specified.", "PostgreSQL compatible NUMERIC type. This annotation needs to be applied to Type instances having NUMERIC type code to specify that values of this type should be treated as PostgreSQL NUMERIC values. Currently this annotation is always needed for NUMERIC when a client interacts with PostgreSQL-enabled Spanner databases.", - "PostgreSQL compatible JSONB type. This annotation needs to be applied to Type instances having JSON type code to specify that values of this type should be treated as PostgreSQL JSONB values. Currently this annotation is always needed for JSON when a client interacts with PostgreSQL-enabled Spanner databases." + "PostgreSQL compatible JSONB type. This annotation needs to be applied to Type instances having JSON type code to specify that values of this type should be treated as PostgreSQL JSONB values. Currently this annotation is always needed for JSON when a client interacts with PostgreSQL-enabled Spanner databases.", + "PostgreSQL compatible OID type. This annotation can be used by a client interacting with PostgreSQL-enabled Spanner database to specify that a value should be treated using the semantics of the OID type." ], "type": "string" } @@ -7169,7 +7179,7 @@ "type": "string" }, "protoDescriptors": { - "description": "Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements. Contains a protobuf-serialized [google.protobufFileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). To generate it, [install](https://grpc.io/docs/protoc-installation/) and run `protoc` with --include_imports and --descriptor_set_out. For example, to generate for moon/shot/app.proto, run ``` $protoc --proto_path=/app_path --proto_path=/lib_path \\ --include_imports \\ --descriptor_set_out=descriptors.data \\ moon/shot/app.proto ``` For more details, see protobuffer [self description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).", + "description": "Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements. Contains a protobuf-serialized [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). To generate it, [install](https://grpc.io/docs/protoc-installation/) and run `protoc` with --include_imports and --descriptor_set_out. For example, to generate for moon/shot/app.proto, run ``` $protoc --proto_path=/app_path --proto_path=/lib_path \\ --include_imports \\ --descriptor_set_out=descriptors.data \\ moon/shot/app.proto ``` For more details, see protobuffer [self description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).", "format": "byte", "type": "string" }, diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index 70e375e054..b703a246b1 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -1852,14 +1852,17 @@ type CrontabSpec struct { CreationWindow string `json:"creationWindow,omitempty"` // Text: Required. Textual representation of the crontab. User can customize // the backup frequency and the backup version time using the cron expression. - // The version time must be in UTC timzeone. The backup will contain an - // externally consistent copy of the database at the version time. Allowed - // frequencies are 12 hour, 1 day, 1 week and 1 month. Examples of valid cron - // specifications: * `0 2/12 * * * ` : every 12 hours at (2, 14) hours past - // midnight in UTC. * `0 2,14 * * * ` : every 12 hours at (2,14) hours past - // midnight in UTC. * `0 2 * * * ` : once a day at 2 past midnight in UTC. * `0 - // 2 * * 0 ` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * * - // ` : once a month on 8th day at 2 past midnight in UTC. + // The version time must be in UTC timezone. The backup will contain an + // externally consistent copy of the database at the version time. Full backups + // must be scheduled a minimum of 12 hours apart and incremental backups must + // be scheduled a minimum of 4 hours apart. Examples of valid cron + // specifications: * `0 2/12 * * *` : every 12 hours at (2, 14) hours past + // midnight in UTC. * `0 2,14 * * *` : every 12 hours at (2,14) hours past + // midnight in UTC. * `0 */4 * * *` : (incremental backups only) every 4 hours + // at (0, 4, 8, 12, 16, 20) hours past midnight in UTC. * `0 2 * * *` : once a + // day at 2 past midnight in UTC. * `0 2 * * 0` : once a week every Sunday at 2 + // past midnight in UTC. * `0 2 8 * *` : once a month on 8th day at 2 past + // midnight in UTC. Text string `json:"text,omitempty"` // TimeZone: Output only. The time zone of the times in `CrontabSpec.text`. // Currently only UTC is supported. @@ -2283,6 +2286,15 @@ func (s ExcludeReplicas) MarshalJSON() ([]byte, error) { // ExecuteBatchDmlRequest: The request for ExecuteBatchDml. type ExecuteBatchDmlRequest struct { + // LastStatements: Optional. If set to true, this request marks the end of the + // transaction. The transaction should be committed or aborted after these + // statements execute, and attempts to execute any other requests against this + // transaction (including reads and queries) will be rejected. Setting this + // option may cause some error reporting to be deferred until commit time (e.g. + // validation of unique constraints). Given this, successful execution of + // statements should not be assumed until a subsequent Commit call completes + // successfully. + LastStatements bool `json:"lastStatements,omitempty"` // RequestOptions: Common options for this request. RequestOptions *RequestOptions `json:"requestOptions,omitempty"` // Seqno: Required. A per-transaction sequence number used to identify this @@ -2304,13 +2316,13 @@ type ExecuteBatchDmlRequest struct { // supported. The caller must either supply an existing transaction ID or begin // a new transaction. Transaction *TransactionSelector `json:"transaction,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequestOptions") to + // ForceSendFields is a list of field names (e.g. "LastStatements") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RequestOptions") to include in + // NullFields is a list of field names (e.g. "LastStatements") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -2383,6 +2395,15 @@ type ExecuteSqlRequest struct { DataBoostEnabled bool `json:"dataBoostEnabled,omitempty"` // DirectedReadOptions: Directed read options for this request. DirectedReadOptions *DirectedReadOptions `json:"directedReadOptions,omitempty"` + // LastStatement: Optional. If set to true, this statement marks the end of the + // transaction. The transaction should be committed or aborted after this + // statement executes, and attempts to execute any other requests against this + // transaction (including reads and queries) will be rejected. For DML + // statements, setting this option may cause some error reporting to be + // deferred until commit time (e.g. validation of unique constraints). Given + // this, successful execution of a DML statement should not be assumed until a + // subsequent Commit call completes successfully. + LastStatement bool `json:"lastStatement,omitempty"` // ParamTypes: It is not always possible for Cloud Spanner to infer the right // SQL type from a JSON value. For example, values of type `BYTES` and values // of type `STRING` both appear in params as JSON strings. In these cases, @@ -2821,23 +2842,23 @@ type Instance struct { Config string `json:"config,omitempty"` // CreateTime: Output only. The time at which the instance was created. CreateTime string `json:"createTime,omitempty"` - // DefaultBackupScheduleType: Optional. Controls the default backup behavior - // for new databases within the instance. Note that `AUTOMATIC` is not - // permitted for free instances, as backups and backup schedules are not - // allowed for free instances. In the `GetInstance` or `ListInstances` - // response, if the value of default_backup_schedule_type is unset or NONE, no - // default backup schedule will be created for new databases within the - // instance. + // DefaultBackupScheduleType: Optional. Controls the default backup schedule + // behavior for new databases within the instance. By default, a backup + // schedule is created automatically when a new database is created in a new + // instance. Note that the `AUTOMATIC` value isn't permitted for free + // instances, as backups and backup schedules aren't supported for free + // instances. In the `GetInstance` or `ListInstances` response, if the value of + // `default_backup_schedule_type` isn't set, or set to `NONE`, Spanner doesn't + // create a default backup schedule for new databases in the instance. // // Possible values: // "DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED" - Not specified. - // "NONE" - No default backup schedule will be created automatically on - // creation of a database within the instance. - // "AUTOMATIC" - A default backup schedule will be created automatically on - // creation of a database within the instance. Once created, the default backup - // schedule can be edited or deleted just like any other backup schedule. - // Currently, the default backup schedule creates a full backup every 24 hours - // and retains the backup for a period of 7 days. + // "NONE" - A default backup schedule isn't created automatically when a new + // database is created in the instance. + // "AUTOMATIC" - A default backup schedule is created automatically when a + // new database is created in the instance. The default backup schedule creates + // a full backup every 24 hours. These full backups are retained for 7 days. + // You can edit or delete the default backup schedule once it's created. DefaultBackupScheduleType string `json:"defaultBackupScheduleType,omitempty"` // DisplayName: Required. The descriptive name for this instance as it appears // in UIs. Must be unique per project and between 4 and 30 characters in @@ -6235,6 +6256,9 @@ type Type struct { // this type should be treated as PostgreSQL JSONB values. Currently this // annotation is always needed for JSON when a client interacts with // PostgreSQL-enabled Spanner databases. + // "PG_OID" - PostgreSQL compatible OID type. This annotation can be used by + // a client interacting with PostgreSQL-enabled Spanner database to specify + // that a value should be treated using the semantics of the OID type. TypeAnnotation string `json:"typeAnnotation,omitempty"` // ForceSendFields is a list of field names (e.g. "ArrayElementType") to // unconditionally include in API requests. By default, fields with empty or @@ -6323,7 +6347,7 @@ type UpdateDatabaseDdlRequest struct { OperationId string `json:"operationId,omitempty"` // ProtoDescriptors: Optional. Proto descriptors used by CREATE/ALTER PROTO // BUNDLE statements. Contains a protobuf-serialized - // google.protobufFileDescriptorSet + // google.protobuf.FileDescriptorSet // (https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). // To generate it, install (https://grpc.io/docs/protoc-installation/) and run // `protoc` with --include_imports and --descriptor_set_out. For example, to @@ -15476,7 +15500,9 @@ type ProjectsInstancesDatabasesSessionsExecuteSqlCall struct { // return `ABORTED`. If this occurs, the application should restart the // transaction from the beginning. See Transaction for more details. Larger // result sets can be fetched in streaming fashion by calling -// ExecuteStreamingSql instead. +// ExecuteStreamingSql instead. The query string can be SQL or Graph Query +// Language (GQL) +// (https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro). // // - session: The session in which the SQL query should be performed. func (r *ProjectsInstancesDatabasesSessionsService) ExecuteSql(session string, executesqlrequest *ExecuteSqlRequest) *ProjectsInstancesDatabasesSessionsExecuteSqlCall { @@ -15582,7 +15608,9 @@ type ProjectsInstancesDatabasesSessionsExecuteStreamingSqlCall struct { // ExecuteStreamingSql: Like ExecuteSql, except returns the result set as a // stream. Unlike ExecuteSql, there is no limit on the size of the returned // result set. However, no individual row in the result set can exceed 100 MiB, -// and no column value can exceed 10 MiB. +// and no column value can exceed 10 MiB. The query string can be SQL or Graph +// Query Language (GQL) +// (https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro). // // - session: The session in which the SQL query should be performed. func (r *ProjectsInstancesDatabasesSessionsService) ExecuteStreamingSql(session string, executesqlrequest *ExecuteSqlRequest) *ProjectsInstancesDatabasesSessionsExecuteStreamingSqlCall {