From 3cd820cc07a4f8953c14b11efa9481d5bf11c017 Mon Sep 17 00:00:00 2001 From: Cody Oss Date: Fri, 11 Dec 2020 12:47:20 -0700 Subject: [PATCH 1/4] fix: remove markdown links Fixes: #712 --- .../v1/abusiveexperiencereport-gen.go | 14 +- .../v1/acceleratedmobilepageurl-gen.go | 11 +- .../v1/accesscontextmanager-gen.go | 12 +- .../v1beta/accesscontextmanager-gen.go | 9 +- .../v2beta1/adexchangebuyer2-gen.go | 32 +- .../v1/adexperiencereport-gen.go | 16 +- admin/directory/v1/admin-gen.go | 288 ++---- admin/reports/v1/admin-gen.go | 4 +- alertcenter/v1beta1/alertcenter-gen.go | 38 +- analyticsdata/v1alpha/analyticsdata-gen.go | 67 +- .../v4/analyticsreporting-gen.go | 153 ++- .../v1/androiddeviceprovisioning-gen.go | 68 +- androidpublisher/v3/androidpublisher-gen.go | 17 +- apigateway/v1beta/apigateway-gen.go | 42 +- apigee/v1/apigee-gen.go | 153 +-- appengine/v1beta4/appengine-gen.go | 43 +- appengine/v1beta5/appengine-gen.go | 43 +- .../v1beta1/artifactregistry-gen.go | 34 +- .../v1beta2/artifactregistry-gen.go | 34 +- assuredworkloads/v1/assuredworkloads-gen.go | 9 +- bigquery/v2/bigquery-gen.go | 25 +- .../v1beta1/bigqueryconnection-gen.go | 25 +- .../v1/bigquerydatatransfer-gen.go | 9 +- .../v1/bigqueryreservation-gen.go | 9 +- .../v1beta1/bigqueryreservation-gen.go | 12 +- bigtableadmin/v2/bigtableadmin-gen.go | 40 +- billingbudgets/v1/billingbudgets-gen.go | 11 +- billingbudgets/v1beta1/billingbudgets-gen.go | 6 +- .../v1/binaryauthorization-gen.go | 29 +- .../v1beta1/binaryauthorization-gen.go | 29 +- chat/v1/chat-gen.go | 7 +- classroom/v1/classroom-gen.go | 117 +-- cloudasset/v1/cloudasset-gen.go | 272 ++--- cloudasset/v1beta1/cloudasset-gen.go | 111 +- cloudasset/v1p1beta1/cloudasset-gen.go | 37 +- cloudasset/v1p4beta1/cloudasset-gen.go | 77 +- cloudasset/v1p5beta1/cloudasset-gen.go | 105 +- cloudbilling/v1/cloudbilling-gen.go | 112 +- cloudbuild/v1/cloudbuild-gen.go | 46 +- cloudbuild/v1alpha1/cloudbuild-gen.go | 46 +- cloudbuild/v1alpha2/cloudbuild-gen.go | 46 +- .../v1beta1/clouderrorreporting-gen.go | 49 +- cloudfunctions/v1/cloudfunctions-gen.go | 55 +- cloudidentity/v1/cloudidentity-gen.go | 268 +++-- cloudidentity/v1beta1/cloudidentity-gen.go | 257 ++--- cloudiot/v1/cloudiot-gen.go | 34 +- cloudkms/v1/cloudkms-gen.go | 83 +- cloudprofiler/v2/cloudprofiler-gen.go | 20 +- .../v1/cloudresourcemanager-gen.go | 65 +- .../v1beta1/cloudresourcemanager-gen.go | 27 +- .../v2/cloudresourcemanager-gen.go | 34 +- .../v2beta1/cloudresourcemanager-gen.go | 34 +- cloudscheduler/v1/cloudscheduler-gen.go | 145 ++- cloudscheduler/v1beta1/cloudscheduler-gen.go | 145 ++- cloudsearch/v1/cloudsearch-gen.go | 75 +- cloudshell/v1/cloudshell-gen.go | 9 +- cloudshell/v1alpha1/cloudshell-gen.go | 9 +- cloudtasks/v2/cloudtasks-gen.go | 375 +++---- cloudtasks/v2beta2/cloudtasks-gen.go | 321 +++--- cloudtasks/v2beta3/cloudtasks-gen.go | 395 +++----- cloudtrace/v2/cloudtrace-gen.go | 12 +- cloudtrace/v2beta1/cloudtrace-gen.go | 11 +- composer/v1/composer-gen.go | 118 +-- composer/v1beta1/composer-gen.go | 126 +-- compute/v0.alpha/compute-gen.go | 100 +- compute/v0.beta/compute-gen.go | 100 +- compute/v1/compute-gen.go | 97 +- container/v1/container-gen.go | 641 +++++------- container/v1beta1/container-gen.go | 568 ++++------- .../v1alpha1/containeranalysis-gen.go | 44 +- .../v1beta1/containeranalysis-gen.go | 51 +- content/v2.1/content-gen.go | 12 +- customsearch/v1/customsearch-gen.go | 410 +++----- datacatalog/v1beta1/datacatalog-gen.go | 95 +- dataflow/v1b3/dataflow-gen.go | 37 +- datafusion/v1/datafusion-gen.go | 34 +- datafusion/v1beta1/datafusion-gen.go | 34 +- datalabeling/v1beta1/datalabeling-gen.go | 90 +- datamigration/v1beta1/datamigration-gen.go | 47 +- datastore/v1/datastore-gen.go | 75 +- datastore/v1beta1/datastore-gen.go | 22 +- datastore/v1beta3/datastore-gen.go | 34 +- .../v0.alpha/deploymentmanager-gen.go | 64 +- deploymentmanager/v2/deploymentmanager-gen.go | 47 +- .../v2beta/deploymentmanager-gen.go | 64 +- dialogflow/v2/dialogflow-gen.go | 307 ++---- dialogflow/v2beta1/dialogflow-gen.go | 407 +++----- dialogflow/v3/dialogflow-gen.go | 360 +++---- dialogflow/v3beta1/dialogflow-gen.go | 360 +++---- digitalassetlinks/v1/digitalassetlinks-gen.go | 51 +- displayvideo/v1/displayvideo-gen.go | 22 +- dlp/v2/dlp-gen.go | 125 +-- docs/v1/docs-gen.go | 24 +- documentai/v1beta2/documentai-gen.go | 33 +- documentai/v1beta3/documentai-gen.go | 41 +- domains/v1alpha2/domains-gen.go | 64 +- domains/v1beta1/domains-gen.go | 64 +- domainsrdap/v1/domainsrdap-gen.go | 18 +- .../v1.1/doubleclickbidmanager-gen.go | 8 +- doubleclicksearch/v2/doubleclicksearch-gen.go | 5 +- eventarc/v1beta1/eventarc-gen.go | 62 +- fcm/v1/fcm-gen.go | 152 +-- file/v1/file-gen.go | 26 +- file/v1beta1/file-gen.go | 25 +- firebase/v1beta1/firebase-gen.go | 442 ++++---- .../v1/firebasedynamiclinks-gen.go | 53 +- firebasehosting/v1/firebasehosting-gen.go | 9 +- .../v1beta1/firebasehosting-gen.go | 122 +-- firebaseml/v1/firebaseml-gen.go | 9 +- firebaseml/v1beta2/firebaseml-gen.go | 9 +- firestore/v1/firestore-gen.go | 69 +- firestore/v1beta1/firestore-gen.go | 51 +- firestore/v1beta2/firestore-gen.go | 9 +- gameservices/v1/gameservices-gen.go | 34 +- gameservices/v1beta/gameservices-gen.go | 34 +- genomics/v1/genomics-gen.go | 26 +- genomics/v1alpha2/genomics-gen.go | 32 +- genomics/v2alpha1/genomics-gen.go | 46 +- gmail/v1/gmail-gen.go | 5 +- .../v1beta1/gmailpostmastertools-gen.go | 38 +- google-api-go-generator/gen.go | 28 +- google-api-go-generator/gen_test.go | 27 + healthcare/v1/healthcare-gen.go | 678 +++++-------- healthcare/v1beta1/healthcare-gen.go | 956 +++++++----------- homegraph/v1/homegraph-gen.go | 94 +- iam/v1/iam-gen.go | 169 ++-- iap/v1/iap-gen.go | 25 +- iap/v1beta1/iap-gen.go | 25 +- jobs/v3/jobs-gen.go | 39 +- jobs/v3p1beta1/jobs-gen.go | 48 +- jobs/v4/jobs-gen.go | 39 +- language/v1/language-gen.go | 25 +- language/v1beta1/language-gen.go | 22 +- language/v1beta2/language-gen.go | 28 +- lifesciences/v2beta/lifesciences-gen.go | 43 +- localservices/v1/localservices-gen.go | 4 +- managedidentities/v1/managedidentities-gen.go | 47 +- .../v1alpha1/managedidentities-gen.go | 44 +- .../v1beta1/managedidentities-gen.go | 47 +- memcache/v1beta2/memcache-gen.go | 16 +- ml/v1/ml-gen.go | 676 +++++-------- monitoring/v3/monitoring-gen.go | 9 +- networkmanagement/v1/networkmanagement-gen.go | 37 +- .../v1beta1/networkmanagement-gen.go | 45 +- notebooks/v1/notebooks-gen.go | 68 +- osconfig/v1/osconfig-gen.go | 42 +- osconfig/v1beta/osconfig-gen.go | 38 +- people/v1/people-gen.go | 68 +- playablelocations/v3/playablelocations-gen.go | 11 +- .../v1/policytroubleshooter-gen.go | 18 +- .../v1beta/policytroubleshooter-gen.go | 18 +- poly/v1/poly-gen.go | 28 +- privateca/v1beta1/privateca-gen.go | 125 +-- .../v1alpha1/prod_tt_sasportal-gen.go | 9 +- pubsub/v1/pubsub-gen.go | 106 +- pubsub/v1beta2/pubsub-gen.go | 42 +- realtimebidding/v1/realtimebidding-gen.go | 44 +- .../v1beta1/recommendationengine-gen.go | 20 +- redis/v1/redis-gen.go | 36 +- redis/v1beta1/redis-gen.go | 36 +- .../v1/remotebuildexecution-gen.go | 20 +- .../v1alpha/remotebuildexecution-gen.go | 20 +- .../v2/remotebuildexecution-gen.go | 20 +- run/v1/run-gen.go | 28 +- run/v1alpha1/run-gen.go | 28 +- runtimeconfig/v1/runtimeconfig-gen.go | 9 +- runtimeconfig/v1beta1/runtimeconfig-gen.go | 55 +- sasportal/v1alpha1/sasportal-gen.go | 9 +- script/v1/script-gen.go | 33 +- searchconsole/v1/searchconsole-gen.go | 18 +- secretmanager/v1/secretmanager-gen.go | 25 +- secretmanager/v1beta1/secretmanager-gen.go | 25 +- securitycenter/v1/securitycenter-gen.go | 34 +- securitycenter/v1beta1/securitycenter-gen.go | 34 +- .../v1/serviceconsumermanagement-gen.go | 237 ++--- .../v1beta1/serviceconsumermanagement-gen.go | 237 ++--- servicecontrol/v1/servicecontrol-gen.go | 37 +- servicecontrol/v2/servicecontrol-gen.go | 42 +- servicedirectory/v1/servicedirectory-gen.go | 25 +- .../v1beta1/servicedirectory-gen.go | 25 +- servicemanagement/v1/servicemanagement-gen.go | 279 +++-- servicenetworking/v1/servicenetworking-gen.go | 246 ++--- .../v1beta/servicenetworking-gen.go | 246 ++--- serviceusage/v1/serviceusage-gen.go | 242 ++--- serviceusage/v1beta1/serviceusage-gen.go | 237 ++--- sheets/v4/sheets-gen.go | 22 +- slides/v1/slides-gen.go | 13 +- sourcerepo/v1/sourcerepo-gen.go | 34 +- spanner/v1/spanner-gen.go | 186 ++-- speech/v1/speech-gen.go | 43 +- speech/v1p1beta1/speech-gen.go | 105 +- speech/v2beta1/speech-gen.go | 16 +- storagetransfer/v1/storagetransfer-gen.go | 93 +- streetviewpublish/v1/streetviewpublish-gen.go | 14 +- sts/v1beta/sts-gen.go | 31 +- texttospeech/v1/texttospeech-gen.go | 29 +- texttospeech/v1beta1/texttospeech-gen.go | 29 +- toolresults/v1beta3/toolresults-gen.go | 16 +- tpu/v1/tpu-gen.go | 9 +- tpu/v1alpha1/tpu-gen.go | 9 +- translate/v3/translate-gen.go | 12 +- translate/v3beta1/translate-gen.go | 13 +- vault/v1/vault-gen.go | 9 +- videointelligence/v1/videointelligence-gen.go | 139 +-- .../v1beta2/videointelligence-gen.go | 139 +-- .../v1p1beta1/videointelligence-gen.go | 139 +-- .../v1p2beta1/videointelligence-gen.go | 139 +-- .../v1p3beta1/videointelligence-gen.go | 139 +-- vision/v1/vision-gen.go | 55 +- vision/v1p1beta1/vision-gen.go | 55 +- vision/v1p2beta1/vision-gen.go | 55 +- .../v1beta/workflowexecutions-gen.go | 4 +- workflows/v1beta/workflows-gen.go | 29 +- youtubeanalytics/v2/youtubeanalytics-gen.go | 28 +- 214 files changed, 7300 insertions(+), 11128 deletions(-) diff --git a/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go b/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go index d5a2c9ffe86..18cb3cf5324 100644 --- a/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go +++ b/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go @@ -155,14 +155,11 @@ type SiteSummaryResponse struct { // "FAILING" - Failing. AbusiveStatus string `json:"abusiveStatus,omitempty"` - // EnforcementTime: The time at which - // [enforcement](https://support.google.com/webtools/answer/7538608) - // against the site began or will begin. Not set when the filter_status - // is OFF. + // EnforcementTime: The time at which enforcement against the site began + // or will begin. Not set when the filter_status is OFF. EnforcementTime string `json:"enforcementTime,omitempty"` - // FilterStatus: The site's [enforcement - // status](https://support.google.com/webtools/answer/7538608). + // FilterStatus: The site's enforcement status. // // Possible values: // "UNKNOWN" - N/A. @@ -177,9 +174,8 @@ type SiteSummaryResponse struct { // ReportUrl: A link to the full Abusive Experience Report for the site. // Not set in ViolatingSitesResponse. Note that you must complete the - // [Search Console verification - // process](https://support.google.com/webmasters/answer/9008080) for - // the site before you can access the full report. + // Search Console verification process for the site before you can + // access the full report. ReportUrl string `json:"reportUrl,omitempty"` // ReviewedSite: The name of the reviewed site, e.g. `google.com`. diff --git a/acceleratedmobilepageurl/v1/acceleratedmobilepageurl-gen.go b/acceleratedmobilepageurl/v1/acceleratedmobilepageurl-gen.go index c04e979ac7c..abb392f34b0 100644 --- a/acceleratedmobilepageurl/v1/acceleratedmobilepageurl-gen.go +++ b/acceleratedmobilepageurl/v1/acceleratedmobilepageurl-gen.go @@ -138,9 +138,8 @@ type AmpUrl struct { // AmpUrl: The AMP URL pointing to the publisher's web server. AmpUrl string `json:"ampUrl,omitempty"` - // CdnAmpUrl: The [AMP Cache - // URL](/amp/cache/overview#amp-cache-url-format) pointing to the cached - // document in the Google AMP Cache. + // CdnAmpUrl: The AMP Cache URL pointing to the cached document in the + // Google AMP Cache. CdnAmpUrl string `json:"cdnAmpUrl,omitempty"` // OriginalUrl: The original non-AMP URL. @@ -238,8 +237,7 @@ type BatchGetAmpUrlsRequest struct { LookupStrategy string `json:"lookupStrategy,omitempty"` // Urls: List of URLs to look up for the paired AMP URLs. The URLs are - // case-sensitive. Up to 50 URLs per lookup (see [Usage - // Limits](/amp/cache/reference/limits)). + // case-sensitive. Up to 50 URLs per lookup (see Usage Limits). Urls []string `json:"urls,omitempty"` // ForceSendFields is a list of field names (e.g. "LookupStrategy") to @@ -314,8 +312,7 @@ type AmpUrlsBatchGetCall struct { header_ http.Header } -// BatchGet: Returns AMP URL(s) and equivalent [AMP Cache -// URL(s)](/amp/cache/overview#amp-cache-url-format). +// BatchGet: Returns AMP URL(s) and equivalent AMP Cache URL(s). func (r *AmpUrlsService) BatchGet(batchgetampurlsrequest *BatchGetAmpUrlsRequest) *AmpUrlsBatchGetCall { c := &AmpUrlsBatchGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.batchgetampurlsrequest = batchgetampurlsrequest diff --git a/accesscontextmanager/v1/accesscontextmanager-gen.go b/accesscontextmanager/v1/accesscontextmanager-gen.go index d19a0a9336f..07f97ff7479 100644 --- a/accesscontextmanager/v1/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1/accesscontextmanager-gen.go @@ -694,8 +694,7 @@ type GcpUserAccessBinding struct { // Name: Immutable. Assigned by the server during creation. The last // segment has an arbitrary length and has only URI unreserved - // characters (as defined by [RFC 3986 Section - // 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be + // characters (as defined by RFC 3986 Section 2.3). Should not be // specified by the client during creation. Example: // "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N" Name string `json:"name,omitempty"` @@ -1311,11 +1310,10 @@ func (s *ServicePerimeterConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/accesscontextmanager/v1beta/accesscontextmanager-gen.go b/accesscontextmanager/v1beta/accesscontextmanager-gen.go index 67eb7621b52..bcddd257605 100644 --- a/accesscontextmanager/v1beta/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1beta/accesscontextmanager-gen.go @@ -914,11 +914,10 @@ func (s *ServicePerimeterConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go index fc93fefc8a6..c324304e244 100644 --- a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go +++ b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go @@ -977,8 +977,7 @@ func (s *Buyer) MarshalJSON() ([]byte, error) { // was not successful, as described by the specified callout status. type CalloutStatusRow struct { // CalloutStatusId: The ID of the callout status. See - // [callout-status-codes](https://developers.google.com/authorized-buyers - // /rtb/downloads/callout-status-codes). + // callout-status-codes. CalloutStatusId int64 `json:"calloutStatusId,omitempty"` // ImpressionCount: The number of impressions for which there was a bid @@ -1039,14 +1038,10 @@ type Client struct { // among all the entities with the same type. The value of this field is // ignored if the entity type is not provided. A list of all known // advertisers with their identifiers is available in the - // [advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/ - // advertisers.txt) file. A list of all known brands with their - // identifiers is available in the - // [brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brand - // s.txt) file. A list of all known agencies with their identifiers is - // available in the - // [agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/age - // ncies.txt) file. + // advertisers.txt file. A list of all known brands with their + // identifiers is available in the brands.txt file. A list of all known + // agencies with their identifiers is available in the agencies.txt + // file. EntityId int64 `json:"entityId,omitempty,string"` // EntityName: The name of the entity. This field is automatically @@ -1798,8 +1793,7 @@ type CreativeStatusRow struct { BidCount *MetricValue `json:"bidCount,omitempty"` // CreativeStatusId: The ID of the creative status. See - // [creative-status-codes](https://developers.google.com/authorized-buyer - // s/rtb/downloads/creative-status-codes). + // creative-status-codes. CreativeStatusId int64 `json:"creativeStatusId,omitempty"` // RowDimensions: The values of all dimensions associated with metric @@ -2691,9 +2685,7 @@ type FilterSet struct { // seller (publisher) networks on which to filter; may be empty. The // filters represented by multiple seller network IDs are ORed together // (i.e., if non-empty, results must match any one of the publisher - // networks). See - // [seller-network-ids](https://developers.google.com/authorized-buyers/r - // tb/downloads/seller-network-ids) file for the set of existing seller + // networks). See seller-network-ids file for the set of existing seller // network IDs. SellerNetworkIds []int64 `json:"sellerNetworkIds,omitempty"` @@ -3890,9 +3882,8 @@ func (s *ListPublisherProfilesResponse) MarshalJSON() ([]byte, error) { // applies to. type LocationContext struct { // GeoCriteriaIds: IDs representing the geo location for this context. - // Please refer to the - // [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/ge - // o-table.csv) file for different geo criteria IDs. + // Please refer to the geo-table.csv file for different geo criteria + // IDs. GeoCriteriaIds []int64 `json:"geoCriteriaIds,omitempty"` // ForceSendFields is a list of field names (e.g. "GeoCriteriaIds") to @@ -5081,10 +5072,7 @@ type ResumeProposalRequest struct { // for a given row. type RowDimensions struct { // PublisherIdentifier: The publisher identifier for this row, if a - // breakdown by - // [BreakdownDimension.PUBLISHER_IDENTIFIER](https://developers.google.co - // m/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filte - // rSets#FilterSet.BreakdownDimension) was requested. + // breakdown by BreakdownDimension.PUBLISHER_IDENTIFIER was requested. PublisherIdentifier string `json:"publisherIdentifier,omitempty"` // TimeInterval: The time interval that this row represents. diff --git a/adexperiencereport/v1/adexperiencereport-gen.go b/adexperiencereport/v1/adexperiencereport-gen.go index 7eed3b8a0df..9255a19be29 100644 --- a/adexperiencereport/v1/adexperiencereport-gen.go +++ b/adexperiencereport/v1/adexperiencereport-gen.go @@ -158,15 +158,12 @@ type PlatformSummary struct { // "FAILING" - Failing. BetterAdsStatus string `json:"betterAdsStatus,omitempty"` - // EnforcementTime: The time at which - // [enforcement](https://support.google.com/webtools/answer/7308033) - // against the site began or will begin on this platform. Not set when - // the filter_status is OFF. + // EnforcementTime: The time at which enforcement against the site began + // or will begin on this platform. Not set when the filter_status is + // OFF. EnforcementTime string `json:"enforcementTime,omitempty"` - // FilterStatus: The site's [enforcement - // status](https://support.google.com/webtools/answer/7308033) on this - // platform. + // FilterStatus: The site's enforcement status on this platform. // // Possible values: // "UNKNOWN" - N/A. @@ -193,9 +190,8 @@ type PlatformSummary struct { // ReportUrl: A link to the full Ad Experience Report for the site on // this platform.. Not set in ViolatingSitesResponse. Note that you must - // complete the [Search Console verification - // process](https://support.google.com/webmasters/answer/9008080) for - // the site before you can access the full report. + // complete the Search Console verification process for the site before + // you can access the full report. ReportUrl string `json:"reportUrl,omitempty"` // UnderReview: Whether the site is currently under review on this diff --git a/admin/directory/v1/admin-gen.go b/admin/directory/v1/admin-gen.go index d34e4c1a6c2..73ee51fa0db 100644 --- a/admin/directory/v1/admin-gen.go +++ b/admin/directory/v1/admin-gen.go @@ -667,15 +667,13 @@ func (s *Aliases) MarshalJSON() ([]byte, error) { // application on certain devices. The ASP access code is used instead // of the login and password you commonly use when accessing an // application through a browser. For more information about ASPs and -// how to create one, see the [help -// center](//http://support.google.com/a/bin/answer.py?amp;answer=1032419 -// ). +// how to create one, see the help center. type Asp struct { // CodeId: The unique ID of the ASP. CodeId int64 `json:"codeId,omitempty"` - // CreationTime: The time when the ASP was created. Expressed in [Unix - // time](http://en.wikipedia.org/wiki/Epoch_time) format. + // CreationTime: The time when the ASP was created. Expressed in Unix + // time format. CreationTime int64 `json:"creationTime,omitempty,string"` // Etag: ETag of the ASP. @@ -685,8 +683,8 @@ type Asp struct { // `admin#directory#asp`. Kind string `json:"kind,omitempty"` - // LastTimeUsed: The time when the ASP was last used. Expressed in [Unix - // time](http://en.wikipedia.org/wiki/Epoch_time) format. + // LastTimeUsed: The time when the ASP was last used. Expressed in Unix + // time format. LastTimeUsed int64 `json:"lastTimeUsed,omitempty,string"` // Name: The name of the application that the user, represented by their @@ -763,8 +761,7 @@ func (s *Asps) MarshalJSON() ([]byte, error) { // Building: Public API: Resources.buildings type Building struct { - // Address: The postal address of the building. See - // [`PostalAddress`](/my-business/reference/rest/v4/PostalAddress) for + // Address: The postal address of the building. See `PostalAddress` for // details. Note that only a single address line and region code are // required. Address *BuildingAddress `json:"address,omitempty"` @@ -1163,10 +1160,8 @@ func (s *Channel) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ChromeOsDevice: Google Chrome devices run on the [Chrome -// OS](http://support.google.com/chromeos). For more information about -// common API tasks, see the [Developer's -// Guide](/admin-sdk/directory/v1/guides/manage-chrome-devices). +// ChromeOsDevice: Google Chrome devices run on the Chrome OS. For more +// information about common API tasks, see the Developer's Guide. type ChromeOsDevice struct { // ActiveTimeRanges: List of active time ranges (Read-only). ActiveTimeRanges []*ChromeOsDeviceActiveTimeRanges `json:"activeTimeRanges,omitempty"` @@ -1192,10 +1187,7 @@ type ChromeOsDevice struct { // `Verified`: The device is running a valid version of the Chrome OS. * // `Dev`: The devices's developer hardware switch is enabled. When // booted, the device has a command line shell. For an example of a - // developer switch, see the [Chromebook developer - // information](http://www.chromium.org/chromium-os/developer-information - // -for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switc - // h). + // developer switch, see the Chromebook developer information. BootMode string `json:"bootMode,omitempty"` // CpuStatusReports: Reports of CPU utilization and temperature @@ -1267,9 +1259,7 @@ type ChromeOsDevice struct { // wireless carrier's post-pay service plan. If the device does not have // this information, this property is not included in the response. For // more information on how to export a MEID/IMEI list, see the - // [Developer's - // Guide](/admin-sdk/directory/v1/guides/manage-chrome-devices.html#expor - // t_meid). + // Developer's Guide. Meid string `json:"meid,omitempty"` // Model: The device's model information. If the device does not have @@ -1277,12 +1267,8 @@ type ChromeOsDevice struct { Model string `json:"model,omitempty"` // Notes: Notes about this device added by the administrator. This - // property can be - // [searched](http://support.google.com/chromeos/a/bin/answer.py?answer=1 - // 698333) with the - // [list](/admin-sdk/directory/v1/reference/chromeosdevices/list) - // method's `query` parameter. Maximum length is 500 characters. Empty - // values are allowed. + // property can be searched with the list method's `query` parameter. + // Maximum length is 500 characters. Empty values are allowed. Notes string `json:"notes,omitempty"` // OrderNumber: The device's order number. Only devices directly @@ -1292,12 +1278,10 @@ type ChromeOsDevice struct { // OrgUnitPath: The full parent path with the organizational unit's name // associated with the device. Path names are case insensitive. If the // parent organizational unit is the top-level organization, it is - // represented as a forward slash, `/`. This property can be - // [updated](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_ - // chrome_device) using the API. For more information about how to - // create an organizational structure for your device, see the - // [administration help - // center](http://support.google.com/a/bin/answer.py?answer=182433). + // represented as a forward slash, `/`. This property can be updated + // using the API. For more information about how to create an + // organizational structure for your device, see the administration help + // center. OrgUnitPath string `json:"orgUnitPath,omitempty"` // OsVersion: The Chrome device's operating system version. @@ -1783,15 +1767,13 @@ type Customer struct { // `admin#directory#customer` Kind string `json:"kind,omitempty"` - // Language: The customer's ISO 639-2 language code. See the [Language - // Codes](/admin-sdk/directory/v1/languages) page for the list of - // supported codes. Valid language codes outside the supported set will - // be accepted by the API but may lead to unexpected behavior. The - // default value is `en`. + // Language: The customer's ISO 639-2 language code. See the Language + // Codes page for the list of supported codes. Valid language codes + // outside the supported set will be accepted by the API but may lead to + // unexpected behavior. The default value is `en`. Language string `json:"language,omitempty"` - // PhoneNumber: The customer's contact phone number in - // [E.164](http://en.wikipedia.org/wiki/E.164) format. + // PhoneNumber: The customer's contact phone number in E.164 format. PhoneNumber string `json:"phoneNumber,omitempty"` // PostalAddress: The customer's postal address information. @@ -1840,8 +1822,7 @@ type CustomerPostalAddress struct { ContactName string `json:"contactName,omitempty"` // CountryCode: This is a required property. For `countryCode` - // information see the [ISO 3166 country code - // elements](http://www.iso.org/iso/country_codes.htm). + // information see the ISO 3166 country code elements. CountryCode string `json:"countryCode,omitempty"` // Locality: Name of the locality. An example of a locality value is the @@ -2185,8 +2166,8 @@ func (s *DomainAliases) MarshalJSON() ([]byte, error) { } type Domains struct { - // CreationTime: Creation time of the domain. Expressed in [Unix - // time](http://en.wikipedia.org/wiki/Epoch_time) format. (Read-only). + // CreationTime: Creation time of the domain. Expressed in Unix time + // format. (Read-only). CreationTime int64 `json:"creationTime,omitempty,string"` // DomainAliases: List of domain alias objects. (Read-only) @@ -2410,8 +2391,7 @@ func (s *Features) MarshalJSON() ([]byte, error) { // Group: Google Groups provide your users the ability to send messages // to groups of people using the group's email address. For more -// information about common tasks, see the [Developer's -// Guide](/admin-sdk/directory/v1/guides/manage-groups). +// information about common tasks, see the Developer's Guide. type Group struct { // AdminCreated: Value is `true` if this group was created by an // administrator rather than a user. @@ -2437,9 +2417,8 @@ type Group struct { // domains, select the appropriate domain for the email address. The // `email` must be unique. This property is required when creating a // group. Group email addresses are subject to the same character usage - // rules as usernames, see the [administration help - // center](http://support.google.com/a/bin/answer.py?answer=33386) for - // the details. + // rules as usernames, see the administration help center for the + // details. Email string `json:"email,omitempty"` // Etag: ETag of the resource. @@ -2533,8 +2512,8 @@ func (s *Groups) MarshalJSON() ([]byte, error) { // Member: A Google Groups member can be a user or another group. This // member can be inside or outside of your account's domains. For more -// information about common group member tasks, see the [Developer's -// Guide](/admin-sdk/directory/v1/guides/manage-group-members). +// information about common group member tasks, see the Developer's +// Guide. type Member struct { // DeliverySettings: Defines mail delivery preferences of member. This // is only supported by create/update/get. @@ -2561,8 +2540,8 @@ type Member struct { // Role: The member's role in a group. The API returns an error for // cycles in group memberships. For example, if `group1` is a member of // `group2`, `group2` cannot be a member of `group1`. For more - // information about a member's role, see the [administration help - // center](http://support.google.com/a/bin/answer.py?answer=167094). + // information about a member's role, see the administration help + // center. Role string `json:"role,omitempty"` // Status: Status of member (Immutable) @@ -2673,11 +2652,9 @@ func (s *MembersHasMember) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// MobileDevice: G Suite Mobile Management includes Android, [Google -// Sync](http://support.google.com/a/bin/answer.py?answer=135937), and -// iOS devices. For more information about common group mobile device -// API tasks, see the [Developer's -// Guide](/admin-sdk/directory/v1/guides/manage-mobile-devices.html). +// MobileDevice: G Suite Mobile Management includes Android, Google +// Sync, and iOS devices. For more information about common group mobile +// device API tasks, see the Developer's Guide. type MobileDevice struct { // AdbStatus: Adb (USB debugging) enabled or disabled on device // (Read-only) @@ -2723,10 +2700,8 @@ type MobileDevice struct { DevicePasswordStatus string `json:"devicePasswordStatus,omitempty"` // Email: List of owner's email addresses. If your application needs the - // current list of user emails, use the - // [get](/admin-sdk/directory/v1/reference/mobiledevices/get.html) - // method. For additional information, see the [retrieve a - // user](/admin-sdk/directory/v1/guides/manage-users#get_user) method. + // current list of user emails, use the get method. For additional + // information, see the retrieve a user method. Email []string `json:"email,omitempty"` // EncryptionStatus: Mobile Device Encryption Status (Read-only) @@ -2775,19 +2750,14 @@ type MobileDevice struct { Meid string `json:"meid,omitempty"` // Model: The mobile device's model name, for example Nexus S. This - // property can be - // [updated](/admin-sdk/directory/v1/reference/mobiledevices/update.html) - // . For more information, see the [Developer's - // Guide](/admin-sdk/directory/v1/guides/manage-mobile=devices#update_mob - // ile_device). + // property can be updated. For more information, see the Developer's + // Guide. Model string `json:"model,omitempty"` // Name: List of the owner's user names. If your application needs the - // current list of device owner names, use the - // [get](/admin-sdk/directory/v1/reference/mobiledevices/get.html) - // method. For more information about retrieving mobile device user - // information, see the [Developer's - // Guide](/admin-sdk/directory/v1/guides/manage-users#get_user). + // current list of device owner names, use the get method. For more + // information about retrieving mobile device user information, see the + // Developer's Guide. Name []string `json:"name,omitempty"` // NetworkOperator: Mobile Device mobile or network operator (if @@ -2795,11 +2765,8 @@ type MobileDevice struct { NetworkOperator string `json:"networkOperator,omitempty"` // Os: The mobile device's operating system, for example IOS 4.3 or - // Android 2.3.5. This property can be - // [updated](/admin-sdk/directory/v1/reference/mobiledevices/update.html) - // . For more information, see the [Developer's - // Guide](/admin-sdk/directory/v1/guides/manage-mobile-devices#update_mob - // ile_device). + // Android 2.3.5. This property can be updated. For more information, + // see the Developer's Guide. Os string `json:"os,omitempty"` // OtherAccountsInfo: List of accounts added on device (Read-only) @@ -2835,11 +2802,8 @@ type MobileDevice struct { UnknownSourcesStatus bool `json:"unknownSourcesStatus,omitempty"` // UserAgent: Gives information about the device such as `os` version. - // This property can be - // [updated](/admin-sdk/directory/v1/reference/mobiledevices/update.html) - // . For more information, see the [Developer's - // Guide](/admin-sdk/directory/v1/guides/manage-mobile-devices#update_mob - // ile_device). + // This property can be updated. For more information, see the + // Developer's Guide. UserAgent string `json:"userAgent,omitempty"` // WifiMacAddress: The device's MAC address on Wi-Fi networks. @@ -2882,10 +2846,9 @@ type MobileDeviceApplications struct { // Permission: The list of permissions of this application. These can be // either a standard Android permission or one defined by the - // application, and are found in an application's [Android - // manifest](http://developer.android.com/guide/topics/manifest/uses-perm - // ission-element.html). Examples of a Calendar application's - // permissions are `READ_CALENDAR`, or `MANAGE_ACCOUNTS`. + // application, and are found in an application's Android manifest. + // Examples of a Calendar application's permissions are `READ_CALENDAR`, + // or `MANAGE_ACCOUNTS`. Permission []string `json:"permission,omitempty"` // VersionCode: The application's version code. An example is `13`. @@ -2988,17 +2951,14 @@ func (s *MobileDevices) MarshalJSON() ([]byte, error) { // OrgUnit: Managing your account's organizational units allows you to // configure your users' access to services and custom settings. For // more information about common organizational unit tasks, see the -// [Developer's -// Guide](/admin-sdk/directory/v1/guides/manage-org-units.html). +// Developer's Guide. type OrgUnit struct { // BlockInheritance: Determines if a sub-organizational unit can inherit // the settings of the parent organization. The default value is // `false`, meaning a sub-organizational unit inherits the settings of // the nearest parent organizational unit. For more information on // inheritance and users in an organization structure, see the - // [administration help - // center](http://support.google.com/a/bin/answer.py?answer=182442&topic= - // 1227584&ctx=topic). + // administration help center. BlockInheritance bool `json:"blockInheritance,omitempty"` // Description: Description of the organizational unit. @@ -3028,12 +2988,9 @@ type OrgUnit struct { // the `parentOrgunitPath`. A user's organizational unit determines // which G Suite services the user has access to. If the user is moved // to a new organization, the user's access changes. For more - // information about organization structures, see the [administration - // help - // center](http://support.google.com/a/bin/answer.py?answer=182433&topic= - // 1227584&ctx=topic). For more information about moving a user to a - // different organization, see [Update a - // user](/admin-sdk/directory/v1/guides/manage-users.html#update_user). + // information about organization structures, see the administration + // help center. For more information about moving a user to a different + // organization, see Update a user. OrgUnitPath string `json:"orgUnitPath,omitempty"` // ParentOrgUnitId: The unique ID of the parent organizational unit. @@ -3132,9 +3089,7 @@ type Privilege struct { PrivilegeName string `json:"privilegeName,omitempty"` // ServiceId: The obfuscated ID of the service this privilege is for. - // This value is returned with - // [`Privileges.list()`](/admin-sdk/directory/v1/reference/privileges/lis - // t). + // This value is returned with `Privileges.list()`. ServiceId string `json:"serviceId,omitempty"` // ServiceName: The name of the service this privilege is for. @@ -3293,9 +3248,7 @@ type RoleRolePrivileges struct { PrivilegeName string `json:"privilegeName,omitempty"` // ServiceId: The obfuscated ID of the service this privilege is for. - // This value is returned with - // [`Privileges.list()`](/admin-sdk/directory/v1/reference/privileges/lis - // t). + // This value is returned with `Privileges.list()`. ServiceId string `json:"serviceId,omitempty"` // ForceSendFields is a list of field names (e.g. "PrivilegeName") to @@ -3505,8 +3458,7 @@ func (s *Schema) MarshalJSON() ([]byte, error) { // profiles. You can use these fields to store information such as the // projects your users work on, their physical locations, their hire // dates, or whatever else fits your business needs. For more -// information, see [Custom User -// Fields](/admin-sdk/directory/v1/guides/manage-schemas). +// information, see Custom User Fields. type SchemaFieldSpec struct { // DisplayName: Display Name of the field. DisplayName string `json:"displayName,omitempty"` @@ -3544,10 +3496,8 @@ type SchemaFieldSpec struct { NumericIndexingSpec *SchemaFieldSpecNumericIndexingSpec `json:"numericIndexingSpec,omitempty"` // ReadAccessType: Specifies who can view values of this field. See - // [Retrieve users as a - // non-administrator](/admin-sdk/directory/v1/guides/manage-users#retriev - // e_users_non_admin) for more information. Note: It may take up to 24 - // hours for changes to this field to be reflected. + // Retrieve users as a non-administrator for more information. Note: It + // may take up to 24 hours for changes to this field to be reflected. ReadAccessType string `json:"readAccessType,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -3766,10 +3716,8 @@ func (s *Tokens) MarshalJSON() ([]byte, error) { // User: The Directory API allows you to create and manage your // account's users, user aliases, and user Gmail chat profile photos. -// For more information about common tasks, see the [User Accounts -// Developer's Guide](/admin-sdk/directory/v1/guides/manage-users.html) -// and the [User Aliases Developer's -// Guide](/admin-sdk/directory/v1/guides/manage-user-aliases.html). +// For more information about common tasks, see the User Accounts +// Developer's Guide and the User Aliases Developer's Guide. type User struct { // Addresses: A list of the user's addresses. The maximum allowed data // size for this field is 10Kb. @@ -3787,9 +3735,8 @@ type User struct { Archived bool `json:"archived,omitempty"` // ChangePasswordAtNextLogin: Indicates if the user is forced to change - // their password at next login. This setting doesn't apply when [the - // user signs in via a third-party identity - // provider](https://support.google.com/a/answer/60224). + // their password at next login. This setting doesn't apply when the + // user signs in via a third-party identity provider. ChangePasswordAtNextLogin bool `json:"changePasswordAtNextLogin,omitempty"` // CreationTime: User's G Suite account creation time. (Read-only) @@ -3798,13 +3745,12 @@ type User struct { // CustomSchemas: Custom fields of the user. CustomSchemas map[string]googleapi.RawMessage `json:"customSchemas,omitempty"` - // CustomerId: Output only. The customer ID to [retrieve all account - // users](/admin-sdk/directory/v1/guides/manage-users.html#get_all_users) - // . You can use the alias `my_customer` to represent your account's - // `customerId`. As a reseller administrator, you can use the resold - // customer account's `customerId`. To get a `customerId`, use the - // account's primary domain in the `domain` parameter of a - // [users.list](/admin-sdk/directory/v1/reference/users/list) request. + // CustomerId: Output only. The customer ID to retrieve all account + // users. You can use the alias `my_customer` to represent your + // account's `customerId`. As a reseller administrator, you can use the + // resold customer account's `customerId`. To get a `customerId`, use + // the account's primary domain in the `domain` parameter of a + // users.list request. CustomerId string `json:"customerId,omitempty"` DeletionTime string `json:"deletionTime,omitempty"` @@ -3827,9 +3773,7 @@ type User struct { // HashFunction: Stores the hash format of the password property. We // recommend sending the `password` property value as a base 16 bit // hexadecimal-encoded hash value. Set the `hashFunction` values as - // either the [SHA-1](http://wikipedia.org/wiki/SHA-1), - // [MD5](http://wikipedia.org/wiki/MD5), or - // [crypt](https://en.wikipedia.org/wiki/Crypt_(C)) hash format. + // either the SHA-1, MD5, or crypt) hash format. HashFunction string `json:"hashFunction,omitempty"` // Id: The unique ID for the user. A user `id` can be used as a user @@ -3845,32 +3789,24 @@ type User struct { // IncludeInGlobalAddressList: Indicates if the user's profile is // visible in the G Suite global address list when the contact sharing // feature is enabled for the domain. For more information about - // excluding user profiles, see the [administration help - // center](http://support.google.com/a/bin/answer.py?answer=1285988). + // excluding user profiles, see the administration help center. IncludeInGlobalAddressList bool `json:"includeInGlobalAddressList,omitempty"` - // IpWhitelisted: If `true`, the user's IP address is [white - // listed](http://support.google.com/a/bin/answer.py?answer=60752). + // IpWhitelisted: If `true`, the user's IP address is white listed. IpWhitelisted bool `json:"ipWhitelisted,omitempty"` // IsAdmin: Output only. Indicates a user with super admininistrator - // privileges. The `isAdmin` property can only be edited in the [Make a - // user an - // administrator](/admin-sdk/directory/v1/guides/manage-users.html#make_a - // dmin) operation ( - // [makeAdmin](/admin-sdk/directory/v1/reference/users/makeAdmin.html) - // method). If edited in the user - // [insert](/admin-sdk/directory/v1/reference/users/insert.html) or - // [update](/admin-sdk/directory/v1/reference/users/update.html) - // methods, the edit is ignored by the API service. + // privileges. The `isAdmin` property can only be edited in the Make a + // user an administrator operation ( makeAdmin method). If edited in the + // user insert or update methods, the edit is ignored by the API + // service. IsAdmin bool `json:"isAdmin,omitempty"` // IsDelegatedAdmin: Output only. Indicates if the user is a delegated // administrator. Delegated administrators are supported by the API but // cannot create or undelete users, or make users administrators. These // requests are ignored by the API service. Roles and privileges for - // administrators are assigned using the [Admin - // console](http://support.google.com/a/bin/answer.py?answer=33325). + // administrators are assigned using the Admin console. IsDelegatedAdmin bool `json:"isDelegatedAdmin,omitempty"` // IsEnforcedIn2Sv: Output only. Is 2-step verification enforced @@ -3911,9 +3847,8 @@ type User struct { // support unicode/UTF-8 characters, and can contain spaces, letters // (a-z), numbers (0-9), dashes (-), forward slashes (/), and periods // (.). For more information about character usage rules, see the - // [administration help - // center](http://support.google.com/a/bin/answer.py?answer=33386). - // Maximum allowed data size for this field is 1Kb. + // administration help center. Maximum allowed data size for this field + // is 1Kb. Name *UserName `json:"name,omitempty"` // NonEditableAliases: Output only. List of the user's non-editable @@ -3940,9 +3875,7 @@ type User struct { // size for this field is 1Kb. Phones interface{} `json:"phones,omitempty"` - // PosixAccounts: A list of - // [POSIX](http://www.opengroup.org/austin/papers/posix_faq.html) - // account information for the user. + // PosixAccounts: A list of POSIX account information for the user. PosixAccounts interface{} `json:"posixAccounts,omitempty"` // PrimaryEmail: The user's primary email address. This property is @@ -4595,16 +4528,15 @@ type UserPhoto struct { // `PNG`, `GIF`, `BMP`, `TIFF`, and web-safe base64 encoding. MimeType string `json:"mimeType,omitempty"` - // PhotoData: The user photo's upload data in [web-safe - // Base64](https://code.google.com/p/stringencoders/wiki/WebSafeBase64) - // format in bytes. This means: * The slash (/) character is replaced - // with the underscore (_) character. * The plus sign (+) character is - // replaced with the hyphen (-) character. * The equals sign (=) - // character is replaced with the asterisk (*). * For padding, the - // period (.) character is used instead of the RFC-4648 baseURL - // definition which uses the equals sign (=) for padding. This is done - // to simplify URL-parsing. * Whatever the size of the photo being - // uploaded, the API downsizes it to 96x96 pixels. + // PhotoData: The user photo's upload data in web-safe Base64 format in + // bytes. This means: * The slash (/) character is replaced with the + // underscore (_) character. * The plus sign (+) character is replaced + // with the hyphen (-) character. * The equals sign (=) character is + // replaced with the asterisk (*). * For padding, the period (.) + // character is used instead of the RFC-4648 baseURL definition which + // uses the equals sign (=) for padding. This is done to simplify + // URL-parsing. * Whatever the size of the photo being uploaded, the API + // downsizes it to 96x96 pixels. PhotoData string `json:"photoData,omitempty"` // PrimaryEmail: The user's primary email address. @@ -5490,8 +5422,7 @@ type ChromeosdevicesActionCall struct { // consume a device license. If you do not have sufficient licenses // available when completing the re-enable action, you will receive an // error. For more information about deprovisioning and disabling -// devices, visit the [help -// center](https://support.google.com/chrome/a/answer/3523633). +// devices, visit the help center. func (r *ChromeosdevicesService) Action(customerId string, resourceId string, chromeosdeviceaction *ChromeOsDeviceAction) *ChromeosdevicesActionCall { c := &ChromeosdevicesActionCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.customerId = customerId @@ -6241,8 +6172,7 @@ type ChromeosdevicesPatchCall struct { // Patch: Updates a device's updatable properties, such as // `annotatedUser`, `annotatedLocation`, `notes`, `orgUnitPath`, or -// `annotatedAssetId`. This method supports [patch -// semantics](/admin-sdk/directory/v1/guides/performance#patch). +// `annotatedAssetId`. This method supports patch semantics. func (r *ChromeosdevicesService) Patch(customerId string, deviceId string, chromeosdevice *ChromeOsDevice) *ChromeosdevicesPatchCall { c := &ChromeosdevicesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.customerId = customerId @@ -8824,8 +8754,7 @@ func (r *GroupsService) List() *GroupsListCall { // fetch all groups for a customer, fill this field instead of domain. // As an account administrator, you can also use the `my_customer` alias // to represent your account's `customerId`. The `customerId` is also -// returned as part of the -// [Users](/admin-sdk/directory/v1/reference/users) +// returned as part of the Users func (c *GroupsListCall) Customer(customer string) *GroupsListCall { c.urlParams_.Set("customer", customer) return c @@ -9102,8 +9031,8 @@ type GroupsPatchCall struct { header_ http.Header } -// Patch: Updates a group's properties. This method supports [patch -// semantics](/admin-sdk/directory/v1/guides/performance#patch). +// Patch: Updates a group's properties. This method supports patch +// semantics. func (r *GroupsService) Patch(groupKey string, group *Group) *GroupsPatchCall { c := &GroupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.groupKey = groupKey @@ -10562,8 +10491,7 @@ type MembersPatchCall struct { } // Patch: Updates the membership properties of a user in the specified -// group. This method supports [patch -// semantics](/admin-sdk/directory/v1/guides/performance#patch). +// group. This method supports patch semantics. func (r *MembersService) Patch(groupKey string, memberKey string, member *Member) *MembersPatchCall { c := &MembersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.groupKey = groupKey @@ -12181,8 +12109,8 @@ type OrgunitsPatchCall struct { header_ http.Header } -// Patch: Updates an organizational unit. This method supports [patch -// semantics](/admin-sdk/directory/v1/guides/performance#patch) +// Patch: Updates an organizational unit. This method supports patch +// semantics func (r *OrgunitsService) Patch(customerId string, orgUnitPath string, orgunit *OrgUnit) *OrgunitsPatchCall { c := &OrgunitsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.customerId = customerId @@ -18578,9 +18506,7 @@ func (c *UsersGetCall) Projection(projection string) *UsersGetCall { // ViewType sets the optional parameter "viewType": Whether to fetch the // administrator-only or domain-wide public view of the user. For more -// information, see [Retrieve a user as a -// non-administrator](/admin-sdk/directory/v1/guides/manage-users#retriev -// e_users_non_admin). +// information, see Retrieve a user as a non-administrator. // // Possible values: // "view_type_undefined" @@ -18912,9 +18838,9 @@ func (c *UsersListCall) CustomFieldMask(customFieldMask string) *UsersListCall { // the customer's G Suite account. In case of a multi-domain account, to // fetch all groups for a customer, fill this field instead of domain. // You can also use the `my_customer` alias to represent your account's -// `customerId`. The `customerId` is also returned as part of the [Users -// resource](/admin-sdk/directory/v1/reference/users). Either the -// `customer` or the `domain` parameter must be provided. +// `customerId`. The `customerId` is also returned as part of the Users +// resource. Either the `customer` or the `domain` parameter must be +// provided. func (c *UsersListCall) Customer(customer string) *UsersListCall { c.urlParams_.Set("customer", customer) return c @@ -18972,7 +18898,7 @@ func (c *UsersListCall) Projection(projection string) *UsersListCall { // Query sets the optional parameter "query": Query string for searching // user fields. For more information on constructing user queries, see -// [Search for Users](/admin-sdk/directory/v1/guides/search-users). +// Search for Users. func (c *UsersListCall) Query(query string) *UsersListCall { c.urlParams_.Set("query", query) return c @@ -18999,9 +18925,7 @@ func (c *UsersListCall) SortOrder(sortOrder string) *UsersListCall { // ViewType sets the optional parameter "viewType": Whether to fetch the // administrator-only or domain-wide public view of the user. For more -// information, see [Retrieve a user as a -// non-administrator](/admin-sdk/directory/v1/guides/manage-users#retriev -// e_users_non_admin). +// information, see Retrieve a user as a non-administrator. // // Possible values: // "view_type_undefined" @@ -19991,9 +19915,7 @@ func (c *UsersWatchCall) SortOrder(sortOrder string) *UsersWatchCall { // ViewType sets the optional parameter "viewType": Whether to fetch the // administrator-only or domain-wide public view of the user. For more -// information, see [Retrieve a user as a -// non-administrator](/admin-sdk/directory/v1/guides/manage-users#retriev -// e_users_non_admin). +// information, see Retrieve a user as a non-administrator. // // Possible values: // "admin_view" (default) - Results include both administrator-only @@ -21062,8 +20984,8 @@ type UsersPhotosPatchCall struct { header_ http.Header } -// Patch: Adds a photo for the user. This method supports [patch -// semantics](/admin-sdk/directory/v1/guides/performance#patch). +// Patch: Adds a photo for the user. This method supports patch +// semantics. func (r *UsersPhotosService) Patch(userKey string, userphoto *UserPhoto) *UsersPhotosPatchCall { c := &UsersPhotosPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.userKey = userKey diff --git a/admin/reports/v1/admin-gen.go b/admin/reports/v1/admin-gen.go index d32ce450919..6512a6a5bc6 100644 --- a/admin/reports/v1/admin-gen.go +++ b/admin/reports/v1/admin-gen.go @@ -671,9 +671,7 @@ type UsageReport struct { // Parameters: Output only. Parameter value pairs for various // applications. For the Entity Usage Report parameters and values, see - // [the Entity Usage parameters - // reference](/admin-sdk/reports/v1/reference/usage-ref-appendix-a/entiti - // es). + // the Entity Usage parameters reference. Parameters []*UsageReportParameters `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "Date") to diff --git a/alertcenter/v1beta1/alertcenter-gen.go b/alertcenter/v1beta1/alertcenter-gen.go index ac64274d563..77494613b73 100644 --- a/alertcenter/v1beta1/alertcenter-gen.go +++ b/alertcenter/v1beta1/alertcenter-gen.go @@ -309,9 +309,8 @@ type Alert struct { // Metadata: Output only. The metadata associated with this alert. Metadata *AlertMetadata `json:"metadata,omitempty"` - // SecurityInvestigationToolLink: Output only. An optional [Security - // Investigation Tool](https://support.google.com/a/answer/7575955) - // query for this alert. + // SecurityInvestigationToolLink: Output only. An optional Security + // Investigation Tool query for this alert. SecurityInvestigationToolLink string `json:"securityInvestigationToolLink,omitempty"` // Source: Required. A unique identifier for the system that reported @@ -326,8 +325,8 @@ type Alert struct { StartTime string `json:"startTime,omitempty"` // Type: Required. The type of the alert. This is output only after - // alert is created. For a list of available alert types see [G Suite - // Alert types](/admin-sdk/alertcenter/reference/alert-types). + // alert is created. For a list of available alert types see G Suite + // Alert types. Type string `json:"type,omitempty"` // UpdateTime: Output only. The time this alert was last updated. @@ -1335,8 +1334,7 @@ func (s *MatchInfo) MarshalJSON() ([]byte, error) { } // Notification: Settings for callback notifications. For more details -// see [G Suite Alert -// Notification](/admin-sdk/alertcenter/guides/notifications). +// see G Suite Alert Notification. type Notification struct { // CloudPubsubTopic: A Google Cloud Pub/sub topic destination. CloudPubsubTopic *CloudPubsubTopic `json:"cloudPubsubTopic,omitempty"` @@ -1366,9 +1364,7 @@ func (s *Notification) MarshalJSON() ([]byte, error) { } // PhishingSpike: Alert for a spike in user reported phishing. -// *Warning*: This type has been deprecated. Use -// [MailPhishing](/admin-sdk/alertcenter/reference/rest/v1beta1/MailPhish -// ing) instead. +// *Warning*: This type has been deprecated. Use MailPhishing instead. type PhishingSpike struct { // DomainId: The domain ID. DomainId *DomainId `json:"domainId,omitempty"` @@ -1687,11 +1683,10 @@ func (s *StateSponsoredAttack) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2646,10 +2641,8 @@ func (c *AlertsListCall) CustomerId(customerId string) *AlertsListCall { } // Filter sets the optional parameter "filter": A query string for -// filtering alert results. For more details, see [Query -// filters](/admin-sdk/alertcenter/guides/query-filters) and [Supported -// query filter -// fields](/admin-sdk/alertcenter/reference/filter-fields#alerts.list). +// filtering alert results. For more details, see Query filters and +// Supported query filter fields. func (c *AlertsListCall) Filter(filter string) *AlertsListCall { c.urlParams_.Set("filter", filter) return c @@ -3173,11 +3166,8 @@ func (c *AlertsFeedbackListCall) CustomerId(customerId string) *AlertsFeedbackLi } // Filter sets the optional parameter "filter": A query string for -// filtering alert feedback results. For more details, see [Query -// filters](/admin-sdk/alertcenter/guides/query-filters) and [Supported -// query filter -// fields](/admin-sdk/alertcenter/reference/filter-fields#alerts.feedback -// .list). +// filtering alert feedback results. For more details, see Query filters +// and Supported query filter fields. func (c *AlertsFeedbackListCall) Filter(filter string) *AlertsFeedbackListCall { c.urlParams_.Set("filter", filter) return c diff --git a/analyticsdata/v1alpha/analyticsdata-gen.go b/analyticsdata/v1alpha/analyticsdata-gen.go index 669c4ec7a63..15dcf8e1af8 100644 --- a/analyticsdata/v1alpha/analyticsdata-gen.go +++ b/analyticsdata/v1alpha/analyticsdata-gen.go @@ -661,14 +661,13 @@ type Dimension struct { // concatenate(country, ", ", city). DimensionExpression *DimensionExpression `json:"dimensionExpression,omitempty"` - // Name: The name of the dimension. See the [API - // Dimensions](https://developers.google.com/analytics/devguides/reportin - // g/data/v1/api-schema#dimensions) for the list of dimension names. If - // `dimensionExpression` is specified, `name` can be any string that you - // would like. For example if a `dimensionExpression` concatenates - // `country` and `city`, you could call that dimension `countryAndCity`. - // Dimensions are referenced by `name` in `dimensionFilter`, `orderBys`, - // `dimensionExpression`, and `pivots`. + // Name: The name of the dimension. See the API Dimensions for the list + // of dimension names. If `dimensionExpression` is specified, `name` can + // be any string that you would like. For example if a + // `dimensionExpression` concatenates `country` and `city`, you could + // call that dimension `countryAndCity`. Dimensions are referenced by + // `name` in `dimensionFilter`, `orderBys`, `dimensionExpression`, and + // `pivots`. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "DimensionExpression") @@ -767,8 +766,8 @@ func (s *DimensionHeader) MarshalJSON() ([]byte, error) { // DimensionMetadata: Explains a dimension. type DimensionMetadata struct { - // ApiName: This dimension's name. Useable in [Dimension](#Dimension)'s - // `name`. For example, `eventName`. + // ApiName: This dimension's name. Useable in Dimension's `name`. For + // example, `eventName`. ApiName string `json:"apiName,omitempty"` // CustomDefinition: True if the dimension is a custom dimension for @@ -888,9 +887,7 @@ func (s *DimensionValue) MarshalJSON() ([]byte, error) { // tracked. type Entity struct { // PropertyId: A Google Analytics GA4 property id. To learn more, see - // [where to find your Property - // ID](https://developers.google.com/analytics/devguides/reporting/data/v - // 1/property-id). + // where to find your Property ID. PropertyId string `json:"propertyId,omitempty"` // ForceSendFields is a list of field names (e.g. "PropertyId") to @@ -1116,14 +1113,12 @@ type Metric struct { // `expression`. Invisible bool `json:"invisible,omitempty"` - // Name: The name of the metric. See the [API - // Metrics](https://developers.google.com/analytics/devguides/reporting/d - // ata/v1/api-schema#metrics) for the list of metric names. If - // `expression` is specified, `name` can be any string that you would - // like. For example if `expression` is `screenPageViews/sessions`, you - // could call that metric's name = `viewsPerSession`. Metrics are - // referenced by `name` in `metricFilter`, `orderBys`, and metric - // `expression`. + // Name: The name of the metric. See the API Metrics for the list of + // metric names. If `expression` is specified, `name` can be any string + // that you would like. For example if `expression` is + // `screenPageViews/sessions`, you could call that metric's name = + // `viewsPerSession`. Metrics are referenced by `name` in + // `metricFilter`, `orderBys`, and metric `expression`. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Expression") to @@ -1207,8 +1202,8 @@ func (s *MetricHeader) MarshalJSON() ([]byte, error) { // MetricMetadata: Explains a metric. type MetricMetadata struct { - // ApiName: A metric name. Useable in [Metric](#Metric)'s `name`. For - // example, `eventCount`. + // ApiName: A metric name. Useable in Metric's `name`. For example, + // `eventCount`. ApiName string `json:"apiName,omitempty"` // CustomDefinition: True if the metric is a custom metric for this @@ -1225,9 +1220,9 @@ type MetricMetadata struct { Description string `json:"description,omitempty"` // Expression: The mathematical expression for this derived metric. Can - // be used in [Metric](#Metric)'s `expression` field for equivalent - // reports. Most metrics are not expressions, and for non-expressions, - // this field is empty. + // be used in Metric's `expression` field for equivalent reports. Most + // metrics are not expressions, and for non-expressions, this field is + // empty. Expression string `json:"expression,omitempty"` // Type: The type of this metric. @@ -1873,8 +1868,7 @@ type RunPivotReportRequest struct { Pivots []*Pivot `json:"pivots,omitempty"` // ReturnPropertyQuota: Toggles whether to return the current state of - // this Analytics Property's quota. Quota is returned in - // [PropertyQuota](#PropertyQuota). + // this Analytics Property's quota. Quota is returned in PropertyQuota. ReturnPropertyQuota bool `json:"returnPropertyQuota,omitempty"` // ForceSendFields is a list of field names (e.g. "CohortSpec") to @@ -2009,7 +2003,7 @@ type RunRealtimeReportRequest struct { // ReturnPropertyQuota: Toggles whether to return the current state of // this Analytics Property's Realtime quota. Quota is returned in - // [PropertyQuota](#PropertyQuota). + // PropertyQuota. ReturnPropertyQuota bool `json:"returnPropertyQuota,omitempty"` // ForceSendFields is a list of field names (e.g. "DimensionFilter") to @@ -2137,9 +2131,7 @@ type RunReportRequest struct { // Limit: The number of rows to return. If unspecified, 10 rows are // returned. If -1, all rows are returned. To learn more about this - // pagination parameter, see - // [Pagination](https://developers.google.com/analytics/devguides/reporti - // ng/data/v1/basics#pagination). + // pagination parameter, see Pagination. Limit int64 `json:"limit,omitempty,string"` // MetricAggregations: Aggregation of metrics. Aggregated metric values @@ -2164,17 +2156,14 @@ type RunReportRequest struct { Metrics []*Metric `json:"metrics,omitempty"` // Offset: The row count of the start row. The first row is counted as - // row 0. To learn more about this pagination parameter, see - // [Pagination](https://developers.google.com/analytics/devguides/reporti - // ng/data/v1/basics#pagination). + // row 0. To learn more about this pagination parameter, see Pagination. Offset int64 `json:"offset,omitempty,string"` // OrderBys: Specifies how rows are ordered in the response. OrderBys []*OrderBy `json:"orderBys,omitempty"` // ReturnPropertyQuota: Toggles whether to return the current state of - // this Analytics Property's quota. Quota is returned in - // [PropertyQuota](#PropertyQuota). + // this Analytics Property's quota. Quota is returned in PropertyQuota. ReturnPropertyQuota bool `json:"returnPropertyQuota,omitempty"` // ForceSendFields is a list of field names (e.g. "CohortSpec") to @@ -2229,9 +2218,7 @@ type RunReportResponse struct { // the number of rows returned in the response. For example if a query // returns 175 rows and includes limit = 50 in the API request, the // response will contain row_count = 175 but only 50 rows. To learn more - // about this pagination parameter, see - // [Pagination](https://developers.google.com/analytics/devguides/reporti - // ng/data/v1/basics#pagination). + // about this pagination parameter, see Pagination. RowCount int64 `json:"rowCount,omitempty"` // Rows: Rows of dimension value combinations and metric values in the diff --git a/analyticsreporting/v4/analyticsreporting-gen.go b/analyticsreporting/v4/analyticsreporting-gen.go index 66c8a266270..4fcf350612f 100644 --- a/analyticsreporting/v4/analyticsreporting-gen.go +++ b/analyticsreporting/v4/analyticsreporting-gen.go @@ -351,27 +351,22 @@ type CohortGroup struct { // LifetimeValue: Enable Life Time Value (LTV). LTV measures lifetime // value for users acquired through different channels. Please see: - // [Cohort - // Analysis](https://support.google.com/analytics/answer/6074676) and - // [Lifetime Value](https://support.google.com/analytics/answer/6182550) - // If the value of lifetimeValue is false: - The metric values are - // similar to the values in the web interface cohort report. - The - // cohort definition date ranges must be aligned to the calendar week - // and month. i.e. while requesting `ga:cohortNthWeek` the `startDate` - // in the cohort definition should be a Sunday and the `endDate` should - // be the following Saturday, and for `ga:cohortNthMonth`, the - // `startDate` should be the 1st of the month and `endDate` should be - // the last day of the month. When the lifetimeValue is true: - The - // metric values will correspond to the values in the web interface - // LifeTime value report. - The Lifetime Value report shows you how user - // value (Revenue) and engagement (Appviews, Goal Completions, Sessions, - // and Session Duration) grow during the 90 days after a user is - // acquired. - The metrics are calculated as a cumulative average per - // user per the time increment. - The cohort definition date ranges need - // not be aligned to the calendar week and month boundaries. - The - // `viewId` must be an [app view - // ID](https://support.google.com/analytics/answer/2649553#WebVersusAppVi - // ews) + // Cohort Analysis and Lifetime Value If the value of lifetimeValue is + // false: - The metric values are similar to the values in the web + // interface cohort report. - The cohort definition date ranges must be + // aligned to the calendar week and month. i.e. while requesting + // `ga:cohortNthWeek` the `startDate` in the cohort definition should be + // a Sunday and the `endDate` should be the following Saturday, and for + // `ga:cohortNthMonth`, the `startDate` should be the 1st of the month + // and `endDate` should be the last day of the month. When the + // lifetimeValue is true: - The metric values will correspond to the + // values in the web interface LifeTime value report. - The Lifetime + // Value report shows you how user value (Revenue) and engagement + // (Appviews, Goal Completions, Sessions, and Session Duration) grow + // during the 90 days after a user is acquired. - The metrics are + // calculated as a cumulative average per user per the time increment. - + // The cohort definition date ranges need not be aligned to the calendar + // week and month boundaries. - The `viewId` must be an app view ID LifetimeValue bool `json:"lifetimeValue,omitempty"` // ForceSendFields is a list of field names (e.g. "Cohorts") to @@ -462,9 +457,8 @@ func (s *CustomDimension) MarshalJSON() ([]byte, error) { } // DateRange: A contiguous set of days: startDate, startDate + 1 day, -// ..., endDate. The start and end dates are specified in -// [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) date format -// `YYYY-MM-DD`. +// ..., endDate. The start and end dates are specified in ISO8601 date +// format `YYYY-MM-DD`. type DateRange struct { // EndDate: The end date for the query in the format `YYYY-MM-DD`. EndDate string `json:"endDate,omitempty"` @@ -528,11 +522,9 @@ func (s *DateRangeValues) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Dimension: -// [Dimensions](https://support.google.com/analytics/answer/1033861) are -// attributes of your data. For example, the dimension `ga:city` -// indicates the city, for example, "Paris" or "New York", from which a -// session originates. +// Dimension: Dimensions are attributes of your data. For example, the +// dimension `ga:city` indicates the city, for example, "Paris" or "New +// York", from which a session originates. type Dimension struct { // HistogramBuckets: If non-empty, we place dimension values into // buckets after string to int64. Dimension values that are not the @@ -845,15 +837,12 @@ type GetReportsRequest struct { // `cohortGroup`. ReportRequests []*ReportRequest `json:"reportRequests,omitempty"` - // UseResourceQuotas: Enables [resource based - // quotas](/analytics/devguides/reporting/core/v4/limits-quotas#analytics - // _reporting_api_v4), (defaults to `False`). If this field is set to - // `True` the per view (profile) quotas are governed by the - // computational cost of the request. Note that using cost based quotas - // will higher enable sampling rates. (10 Million for `SMALL`, 100M for - // `LARGE`. See the [limits and quotas - // documentation](/analytics/devguides/reporting/core/v4/limits-quotas#an - // alytics_reporting_api_v4) for details. + // UseResourceQuotas: Enables resource based quotas, (defaults to + // `False`). If this field is set to `True` the per view (profile) + // quotas are governed by the computational cost of the request. Note + // that using cost based quotas will higher enable sampling rates. (10 + // Million for `SMALL`, 100M for `LARGE`. See the limits and quotas + // documentation for details. UseResourceQuotas bool `json:"useResourceQuotas,omitempty"` // ForceSendFields is a list of field names (e.g. "ReportRequests") to @@ -1019,10 +1008,9 @@ func (s *GoalSetData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Metric: -// [Metrics](https://support.google.com/analytics/answer/1033861) are -// the quantitative measurements. For example, the metric `ga:users` -// indicates the total number of users for the requested time period. +// Metric: Metrics are the quantitative measurements. For example, the +// metric `ga:users` indicates the total number of users for the +// requested time period. type Metric struct { // Alias: An alias for the metric expression is an alternate name for // the expression. The alias can be used for filtering and sorting. This @@ -1652,22 +1640,16 @@ type ReportData struct { // dimensions. Rows []*ReportRow `json:"rows,omitempty"` - // SamplesReadCounts: If the results are - // [sampled](https://support.google.com/analytics/answer/2637192), this - // returns the total number of samples read, one entry per date range. - // If the results are not sampled this field will not be defined. See - // [developer - // guide](/analytics/devguides/reporting/core/v4/basics#sampling) for + // SamplesReadCounts: If the results are sampled, this returns the total + // number of samples read, one entry per date range. If the results are + // not sampled this field will not be defined. See developer guide for // details. SamplesReadCounts googleapi.Int64s `json:"samplesReadCounts,omitempty"` - // SamplingSpaceSizes: If the results are - // [sampled](https://support.google.com/analytics/answer/2637192), this - // returns the total number of samples present, one entry per date - // range. If the results are not sampled this field will not be defined. - // See [developer - // guide](/analytics/devguides/reporting/core/v4/basics#sampling) for - // details. + // SamplingSpaceSizes: If the results are sampled, this returns the + // total number of samples present, one entry per date range. If the + // results are not sampled this field will not be defined. See developer + // guide for details. SamplingSpaceSizes googleapi.Int64s `json:"samplingSpaceSizes,omitempty"` // Totals: For each requested date range, for the set of all rows that @@ -1708,8 +1690,8 @@ func (s *ReportData) MarshalJSON() ([]byte, error) { type ReportRequest struct { // CohortGroup: Cohort group associated with this request. If there is a // cohort group in the request the `ga:cohort` dimension must be - // present. Every [ReportRequest](#ReportRequest) within a `batchGet` - // method must contain the same `cohortGroup` definition. + // present. Every ReportRequest within a `batchGet` method must contain + // the same `cohortGroup` definition. CohortGroup *CohortGroup `json:"cohortGroup,omitempty"` // DateRanges: Date ranges in the request. The request can have a @@ -1720,9 +1702,8 @@ type ReportRequest struct { // second date range. The `reportRequest.dateRanges` field should not be // specified for cohorts or Lifetime value requests. If a date range is // not provided, the default date range is (startDate: current date - 7 - // days, endDate: current date - 1 day). Every - // [ReportRequest](#ReportRequest) within a `batchGet` method must - // contain the same `dateRanges` definition. + // days, endDate: current date - 1 day). Every ReportRequest within a + // `batchGet` method must contain the same `dateRanges` definition. DateRanges []*DateRange `json:"dateRanges,omitempty"` // DimensionFilterClauses: The dimension filter clauses for filtering @@ -1742,9 +1723,7 @@ type ReportRequest struct { // expression. For example, the following expression selects // `ga:browser` dimension which starts with Firefox; // `ga:browser=~^Firefox`. For more information on dimensions and metric - // filters, see [Filters - // reference](https://developers.google.com/analytics/devguides/reporting - // /core/v3/reference#filters). + // filters, see Filters reference. FiltersExpression string `json:"filtersExpression,omitempty"` // HideTotals: If set to true, hides the total of all metrics for all @@ -1798,14 +1777,10 @@ type ReportRequest struct { // pivots. Pivots []*Pivot `json:"pivots,omitempty"` - // SamplingLevel: The desired report - // [sample](https://support.google.com/analytics/answer/2637192) size. - // If the the `samplingLevel` field is unspecified the `DEFAULT` - // sampling level is used. Every [ReportRequest](#ReportRequest) within - // a `batchGet` method must contain the same `samplingLevel` definition. - // See [developer - // guide](/analytics/devguides/reporting/core/v4/basics#sampling) for - // details. + // SamplingLevel: The desired report sample size. If the the + // `samplingLevel` field is unspecified the `DEFAULT` sampling level is + // used. Every ReportRequest within a `batchGet` method must contain the + // same `samplingLevel` definition. See developer guide for details. // // Possible values: // "SAMPLING_UNSPECIFIED" - If the `samplingLevel` field is @@ -1819,16 +1794,14 @@ type ReportRequest struct { // Segments: Segment the data returned for the request. A segment // definition helps look at a subset of the segment request. A request - // can contain up to four segments. Every - // [ReportRequest](#ReportRequest) within a `batchGet` method must - // contain the same `segments` definition. Requests with segments must - // have the `ga:segment` dimension. + // can contain up to four segments. Every ReportRequest within a + // `batchGet` method must contain the same `segments` definition. + // Requests with segments must have the `ga:segment` dimension. Segments []*Segment `json:"segments,omitempty"` - // ViewId: The Analytics [view - // ID](https://support.google.com/analytics/answer/1009618) from which - // to retrieve data. Every [ReportRequest](#ReportRequest) within a - // `batchGet` method must contain the same `viewId`. + // ViewId: The Analytics view ID from which to retrieve data. Every + // ReportRequest within a `batchGet` method must contain the same + // `viewId`. ViewId string `json:"viewId,omitempty"` // ForceSendFields is a list of field names (e.g. "CohortGroup") to @@ -1991,20 +1964,15 @@ type SearchUserActivityRequest struct { // PageToken: A continuation token to get the next page of the results. // Adding this to the request will return the rows after the pageToken. // The pageToken should be the value returned in the nextPageToken - // parameter in the response to the - // [SearchUserActivityRequest](#SearchUserActivityRequest) request. + // parameter in the response to the SearchUserActivityRequest request. PageToken string `json:"pageToken,omitempty"` // User: Required. Unique user Id to query for. Every - // [SearchUserActivityRequest](#SearchUserActivityRequest) must contain - // this field. + // SearchUserActivityRequest must contain this field. User *User `json:"user,omitempty"` - // ViewId: Required. The Analytics [view - // ID](https://support.google.com/analytics/answer/1009618) from which - // to retrieve data. Every - // [SearchUserActivityRequest](#SearchUserActivityRequest) must contain - // the `viewId`. + // ViewId: Required. The Analytics view ID from which to retrieve data. + // Every SearchUserActivityRequest must contain the `viewId`. ViewId string `json:"viewId,omitempty"` // ForceSendFields is a list of field names (e.g. "ActivityTypes") to @@ -2034,14 +2002,11 @@ func (s *SearchUserActivityRequest) MarshalJSON() ([]byte, error) { // call. type SearchUserActivityResponse struct { // NextPageToken: This token should be passed to - // [SearchUserActivityRequest](#SearchUserActivityRequest) to retrieve - // the next page. + // SearchUserActivityRequest to retrieve the next page. NextPageToken string `json:"nextPageToken,omitempty"` - // SampleRate: This field represents the [sampling - // rate](https://support.google.com/analytics/answer/2637192) for the - // given request and is a number between 0.0 to 1.0. See [developer - // guide](/analytics/devguides/reporting/core/v4/basics#sampling) for + // SampleRate: This field represents the sampling rate for the given + // request and is a number between 0.0 to 1.0. See developer guide for // details. SampleRate float64 `json:"sampleRate,omitempty"` diff --git a/androiddeviceprovisioning/v1/androiddeviceprovisioning-gen.go b/androiddeviceprovisioning/v1/androiddeviceprovisioning-gen.go index dde4bd1025d..f4e6f2b31b3 100644 --- a/androiddeviceprovisioning/v1/androiddeviceprovisioning-gen.go +++ b/androiddeviceprovisioning/v1/androiddeviceprovisioning-gen.go @@ -798,14 +798,11 @@ type Device struct { DeviceId int64 `json:"deviceId,omitempty,string"` // DeviceIdentifier: The hardware IDs that identify a manufactured - // device. To learn more, read - // [Identifiers](https://developers.google.com/zero-touch/guides/identifi - // ers). + // device. To learn more, read Identifiers. DeviceIdentifier *DeviceIdentifier `json:"deviceIdentifier,omitempty"` // DeviceMetadata: The metadata attached to the device. Structured as - // key-value pairs. To learn more, read [Device - // metadata](https://developers.google.com/zero-touch/guides/metadata). + // key-value pairs. To learn more, read Device metadata. DeviceMetadata *DeviceMetadata `json:"deviceMetadata,omitempty"` // Name: Output only. The API resource name in the format @@ -841,8 +838,8 @@ func (s *Device) MarshalJSON() ([]byte, error) { // DeviceClaim: A record of a device claimed by a reseller for a // customer. Devices claimed for zero-touch enrollment have a claim with -// the type `SECTION_TYPE_ZERO_TOUCH`. To learn more, read [Claim -// devices for customers](/zero-touch/guides/how-it-works#claim). +// the type `SECTION_TYPE_ZERO_TOUCH`. To learn more, read Claim devices +// for customers. type DeviceClaim struct { // OwnerCompanyId: The ID of the Customer that purchased the device. OwnerCompanyId int64 `json:"ownerCompanyId,omitempty,string"` @@ -894,18 +891,14 @@ func (s *DeviceClaim) MarshalJSON() ([]byte, error) { // DeviceIdentifier: Encapsulates hardware and product IDs to identify a // manufactured device. To understand requirements on identifier sets, -// read -// [Identifiers](https://developers.google.com/zero-touch/guides/identifi -// ers). +// read Identifiers. type DeviceIdentifier struct { // Imei: The device’s IMEI number. Validated on input. Imei string `json:"imei,omitempty"` // Manufacturer: The device manufacturer’s name. Matches the device's // built-in value returned from `android.os.Build.MANUFACTURER`. Allowed - // values are listed in - // [manufacturers](/zero-touch/resources/manufacturer-names#manufacturers - // -names). + // values are listed in manufacturers. Manufacturer string `json:"manufacturer,omitempty"` // Meid: The device’s MEID number. @@ -913,7 +906,7 @@ type DeviceIdentifier struct { // Model: The device model's name. Matches the device's built-in value // returned from `android.os.Build.MODEL`. Allowed values are listed in - // [models](/zero-touch/resources/manufacturer-names#model-names). + // models. Model string `json:"model,omitempty"` // SerialNumber: The manufacturer's serial number for the device. This @@ -944,8 +937,7 @@ func (s *DeviceIdentifier) MarshalJSON() ([]byte, error) { } // DeviceMetadata: Metadata entries that can be attached to a `Device`. -// To learn more, read [Device -// metadata](https://developers.google.com/zero-touch/guides/metadata). +// To learn more, read Device metadata. type DeviceMetadata struct { // Entries: Metadata entries recorded as key-value pairs. Entries map[string]string `json:"entries,omitempty"` @@ -983,9 +975,7 @@ func (s *DeviceMetadata) MarshalJSON() ([]byte, error) { // IDs, such as IMEI number, belonging to the manufactured device. // Methods that operate on devices take a `DeviceReference` as a // parameter type because it's more flexible for the caller. To learn -// more about device identifiers, read -// [Identifiers](https://developers.google.com/zero-touch/guides/identifi -// ers). +// more about device identifiers, read Identifiers. type DeviceReference struct { // DeviceId: The ID of the device. DeviceId int64 `json:"deviceId,omitempty,string"` @@ -1018,8 +1008,8 @@ func (s *DeviceReference) MarshalJSON() ([]byte, error) { // DevicesLongRunningOperationMetadata: Tracks the status of a // long-running operation to asynchronously update a batch of reseller -// metadata attached to devices. To learn more, read [Long‑running -// batch operations](/zero-touch/guides/how-it-works#operations). +// metadata attached to devices. To learn more, read Long‑running +// batch operations. type DevicesLongRunningOperationMetadata struct { // DevicesCount: The number of metadata updates in the operation. This // might be different from the number of updates in the request if the @@ -1068,8 +1058,7 @@ func (s *DevicesLongRunningOperationMetadata) MarshalJSON() ([]byte, error) { // DevicesLongRunningOperationResponse: Tracks the status of a // long-running operation to claim, unclaim, or attach metadata to -// devices. To learn more, read [Long‑running batch -// operations](/zero-touch/guides/how-it-works#operations). +// devices. To learn more, read Long‑running batch operations. type DevicesLongRunningOperationResponse struct { // PerDeviceStatus: The processing status for each device in the // operation. One `PerDeviceStatus` per device. The list order matches @@ -1104,12 +1093,10 @@ func (s *DevicesLongRunningOperationResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Dpc: An EMM's DPC ([device policy -// controller](http://developer.android.com/work/dpc/build-dpc.html)). -// Zero-touch enrollment installs a DPC (listed in the `Configuration`) -// on a device to maintain the customer's mobile policies. All the DPCs -// listed by the API support zero-touch enrollment and are available in -// Google Play. +// Dpc: An EMM's DPC (device policy controller). Zero-touch enrollment +// installs a DPC (listed in the `Configuration`) on a device to +// maintain the customer's mobile policies. All the DPCs listed by the +// API support zero-touch enrollment and are available in Google Play. type Dpc struct { // DpcName: Output only. The title of the DPC app in Google Play. For // example, _Google Apps Device Policy_. Useful in an application's user @@ -1696,11 +1683,10 @@ func (s *PerDeviceStatusInBatch) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2651,9 +2637,8 @@ func (r *CustomersConfigurationsService) Patch(name string, configuration *Confi // UpdateMask sets the optional parameter "updateMask": Required. The // field mask applied to the target `Configuration` before updating the -// fields. To learn more about using field masks, read -// [FieldMask](/protocol-buffers/docs/reference/google.protobuf#fieldmask -// ) in the Protocol Buffers documentation. +// fields. To learn more about using field masks, read FieldMask in the +// Protocol Buffers documentation. func (c *CustomersConfigurationsPatchCall) UpdateMask(updateMask string) *CustomersConfigurationsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -4300,8 +4285,7 @@ type PartnersDevicesClaimAsyncCall struct { // ClaimAsync: Claims a batch of devices for a customer asynchronously. // Adds the devices to zero-touch enrollment. To learn more, read -// [Long‑running batch -// operations](/zero-touch/guides/how-it-works#operations). +// Long‑running batch operations. func (r *PartnersDevicesService) ClaimAsync(partnerId int64, claimdevicesrequest *ClaimDevicesRequest) *PartnersDevicesClaimAsyncCall { c := &PartnersDevicesClaimAsyncCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.partnerId = partnerId @@ -5194,8 +5178,7 @@ type PartnersDevicesUnclaimAsyncCall struct { // UnclaimAsync: Unclaims a batch of devices for a customer // asynchronously. Removes the devices from zero-touch enrollment. To -// learn more, read [Long‑running batch -// operations](/zero-touch/guides/how-it-works#operations). +// learn more, read Long‑running batch operations. func (r *PartnersDevicesService) UnclaimAsync(partnerId int64, unclaimdevicesrequest *UnclaimDevicesRequest) *PartnersDevicesUnclaimAsyncCall { c := &PartnersDevicesUnclaimAsyncCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.partnerId = partnerId @@ -5336,8 +5319,7 @@ type PartnersDevicesUpdateMetadataAsyncCall struct { // UpdateMetadataAsync: Updates the reseller metadata attached to a // batch of devices. This method updates devices asynchronously and // returns an `Operation` that can be used to track progress. Read -// [Long‑running batch -// operations](/zero-touch/guides/how-it-works#operations). +// Long‑running batch operations. func (r *PartnersDevicesService) UpdateMetadataAsync(partnerId int64, updatedevicemetadatainbatchrequest *UpdateDeviceMetadataInBatchRequest) *PartnersDevicesUpdateMetadataAsyncCall { c := &PartnersDevicesUpdateMetadataAsyncCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.partnerId = partnerId diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 0da35e3cb6b..cb6e8e7e7d8 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -734,9 +734,7 @@ func (s *Comment) MarshalJSON() ([]byte, error) { // CountryTargeting: Country targeting specification. type CountryTargeting struct { - // Countries: Countries to target, specified as two letter [CLDR - // codes](https://unicode.org/cldr/charts/latest/supplemental/territory_c - // ontainment_un_m_49.html). + // Countries: Countries to target, specified as two letter CLDR codes. Countries []string `json:"countries,omitempty"` // IncludeRestOfWorld: Include "rest of world" as well as explicitly @@ -4313,9 +4311,7 @@ type EditsBundlesUploadCall struct { // Upload: Uploads a new Android App Bundle to this edit. If you are // using the Google API client libraries, please increase the timeout of // the http request before calling this endpoint (a timeout of 2 minutes -// is recommended). See [Timeouts and -// Errors](https://developers.google.com/api-client-library/java/google-a -// pi-java-client/errors) for an example in java. +// is recommended). See Timeouts and Errors for an example in java. func (r *EditsBundlesService) Upload(packageName string, editId string) *EditsBundlesUploadCall { c := &EditsBundlesUploadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.packageName = packageName @@ -9787,9 +9783,7 @@ type InternalappsharingartifactsUploadapkCall struct { // Uploadapk: Uploads an APK to internal app sharing. If you are using // the Google API client libraries, please increase the timeout of the // http request before calling this endpoint (a timeout of 2 minutes is -// recommended). See [Timeouts and -// Errors](https://developers.google.com/api-client-library/java/google-a -// pi-java-client/errors) for an example in java. +// recommended). See Timeouts and Errors for an example in java. func (r *InternalappsharingartifactsService) Uploadapk(packageName string) *InternalappsharingartifactsUploadapkCall { c := &InternalappsharingartifactsUploadapkCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.packageName = packageName @@ -10007,9 +10001,8 @@ type InternalappsharingartifactsUploadbundleCall struct { // Uploadbundle: Uploads an app bundle to internal app sharing. If you // are using the Google API client libraries, please increase the // timeout of the http request before calling this endpoint (a timeout -// of 2 minutes is recommended). See [Timeouts and -// Errors](https://developers.google.com/api-client-library/java/google-a -// pi-java-client/errors) for an example in java. +// of 2 minutes is recommended). See Timeouts and Errors for an example +// in java. func (r *InternalappsharingartifactsService) Uploadbundle(packageName string) *InternalappsharingartifactsUploadbundleCall { c := &InternalappsharingartifactsUploadbundleCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.packageName = packageName diff --git a/apigateway/v1beta/apigateway-gen.go b/apigateway/v1beta/apigateway-gen.go index 0862b37fb67..5f5989ecb37 100644 --- a/apigateway/v1beta/apigateway-gen.go +++ b/apigateway/v1beta/apigateway-gen.go @@ -612,9 +612,7 @@ type ApigatewayBinding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *ApigatewayExpr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1245,9 +1243,8 @@ func (s *ApigatewayOperationMetadataDiagnostic) MarshalJSON() ([]byte, error) { // logical expression that allows access to a resource only if the // expression evaluates to `true`. A condition can add constraints based // on attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1265,8 +1262,8 @@ func (s *ApigatewayOperationMetadataDiagnostic) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type ApigatewayPolicy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1305,9 +1302,8 @@ type ApigatewayPolicy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1377,11 +1373,10 @@ func (s *ApigatewaySetIamPolicyRequest) MarshalJSON() ([]byte, error) { // ApigatewayStatus: The `Status` type defines a logical error model // that is suitable for different programming environments, including -// REST APIs and RPC APIs. It is used by -// [gRPC](https://github.com/grpc). Each `Status` message contains three -// pieces of data: error code, error message, and error details. You can -// find out more about this error model and how to work with it in the -// [API Design Guide](https://cloud.google.com/apis/design/errors). +// REST APIs and RPC APIs. It is used by gRPC. Each `Status` message +// contains three pieces of data: error code, error message, and error +// details. You can find out more about this error model and how to work +// with it in the API Design Guide. type ApigatewayStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1424,8 +1419,7 @@ func (s *ApigatewayStatus) MarshalJSON() ([]byte, error) { type ApigatewayTestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2298,9 +2292,7 @@ func (r *ProjectsLocationsApisService) GetIamPolicy(resource string) *ProjectsLo // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsApisGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsApisGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -3575,9 +3567,7 @@ func (r *ProjectsLocationsApisConfigsService) GetIamPolicy(resource string) *Pro // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsApisConfigsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsApisConfigsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -4824,9 +4814,7 @@ func (r *ProjectsLocationsGatewaysService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsGatewaysGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGatewaysGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/apigee/v1/apigee-gen.go b/apigee/v1/apigee-gen.go index d86a460e760..e2a6be0b08d 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -5442,19 +5442,15 @@ func (s *GoogleCloudApigeeV1OptimizedStatsResponse) MarshalJSON() ([]byte, error type GoogleCloudApigeeV1Organization struct { // AnalyticsRegion: Required. Primary GCP region for analytics data - // storage. For valid values, see [Create an Apigee - // organization](https://cloud.google.com/apigee/docs/api-platform/get-st - // arted/create-org). + // storage. For valid values, see Create an Apigee organization. AnalyticsRegion string `json:"analyticsRegion,omitempty"` // Attributes: Not used by Apigee. Attributes []string `json:"attributes,omitempty"` // AuthorizedNetwork: Compute Engine network used for Service Networking - // to be peered with Apigee runtime instances. See [Getting started with - // the Service Networking - // API](https://cloud.google.com/service-infrastructure/docs/service-netw - // orking/getting-started). Valid only when [RuntimeType] is set to + // to be peered with Apigee runtime instances. See Getting started with + // the Service Networking API. Valid only when [RuntimeType] is set to // CLOUD. The value can be updated only when there are no runtime // instances. For example: "default". **Note:** Not supported for Apigee // hybrid. @@ -5515,8 +5511,7 @@ type GoogleCloudApigeeV1Organization struct { // SubscriptionType: Output only. Subscription type of the Apigee // organization. Valid values include trial (free, limited, and for // evaluation purposes only) or paid (full subscription has been - // purchased). See [Apigee - // pricing](https://cloud.google.com/apigee/pricing/). + // purchased). See Apigee pricing. // // Possible values: // "SUBSCRIPTION_TYPE_UNSPECIFIED" - Subscription type not specified. @@ -5761,9 +5756,8 @@ func (s *GoogleCloudApigeeV1Property) MarshalJSON() ([]byte, error) { // ProvisionOrganization. type GoogleCloudApigeeV1ProvisionOrganizationRequest struct { // AnalyticsRegion: Primary Cloud Platform region for analytics data - // storage. For valid values, see [Create an - // organization](https://docs.apigee.com/hybrid/latest/precog-provision). - // Defaults to us-west1. + // storage. For valid values, see Create an organization. Defaults to + // us-west1. AnalyticsRegion string `json:"analyticsRegion,omitempty"` // AuthorizedNetwork: Name of the customer project's VPC network. If @@ -7125,15 +7119,13 @@ func (s *GoogleCloudApigeeV1Subscription) MarshalJSON() ([]byte, error) { type GoogleCloudApigeeV1SyncAuthorization struct { // Etag: Entity tag (ETag) used for optimistic concurrency control as a // way to help prevent simultaneous updates from overwriting each other. - // For example, when you call - // [getSyncAuthorization](organizations/getSyncAuthorization) an ETag is - // returned in the response. Pass that ETag when calling the - // [setSyncAuthorization](organizations/setSyncAuthorization) to ensure - // that you are updating the correct version. If you don't pass the ETag - // in the call to `setSyncAuthorization`, then the existing - // authorization is overwritten indiscriminately. **Note**: We strongly - // recommend that you use the ETag in the read-modify-write cycle to - // avoid race conditions. + // For example, when you call getSyncAuthorization an ETag is returned + // in the response. Pass that ETag when calling the setSyncAuthorization + // to ensure that you are updating the correct version. If you don't + // pass the ETag in the call to `setSyncAuthorization`, then the + // existing authorization is overwritten indiscriminately. **Note**: We + // strongly recommend that you use the ETag in the read-modify-write + // cycle to avoid race conditions. Etag string `json:"etag,omitempty"` // Identities: Required. Array of service accounts to grant access to @@ -7144,9 +7136,7 @@ type GoogleCloudApigeeV1SyncAuthorization struct { // ount.com` You might specify multiple service accounts, for example, // if you have multiple environments and wish to assign a unique service // account to each one. The service accounts must have **Apigee - // Synchronizer Manager** role. See also [Create service - // accounts](https://cloud.google.com/apigee/docs/hybrid/latest/sa-about# - // create-the-service-accounts). + // Synchronizer Manager** role. See also Create service accounts. Identities []string `json:"identities,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -7702,9 +7692,7 @@ type GoogleIamV1Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *GoogleTypeExpr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -7779,9 +7767,8 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // logical expression that allows access to a resource only if the // expression evaluates to `true`. A condition can add constraints based // on attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -7799,8 +7786,8 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type GoogleIamV1Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -7839,9 +7826,8 @@ type GoogleIamV1Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -7914,8 +7900,7 @@ func (s *GoogleIamV1SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type GoogleIamV1TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -8161,11 +8146,10 @@ func (s *GoogleRpcPreconditionFailureViolation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -8422,9 +8406,8 @@ type OrganizationsCreateCall struct { header_ http.Header } -// Create: Creates an Apigee organization. See [Create an Apigee -// organization](https://cloud.google.com/apigee/docs/api-platform/get-st -// arted/create-org). +// Create: Creates an Apigee organization. See Create an Apigee +// organization. func (r *OrganizationsService) Create(googlecloudapigeev1organization *GoogleCloudApigeeV1Organization) *OrganizationsCreateCall { c := &OrganizationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.googlecloudapigeev1organization = googlecloudapigeev1organization @@ -8696,9 +8679,8 @@ type OrganizationsGetCall struct { header_ http.Header } -// Get: Gets the profile for an Apigee organization. See [Understanding -// organizations](https://cloud.google.com/apigee/docs/api-platform/funda -// mentals/organization-structure). +// Get: Gets the profile for an Apigee organization. See Understanding +// organizations. func (r *OrganizationsService) Get(name string) *OrganizationsGetCall { c := &OrganizationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9024,13 +9006,11 @@ type OrganizationsGetSyncAuthorizationCall struct { // required to allow the Synchronizer to download environment data from // the control plane. An ETag is returned in the response to // `getSyncAuthorization`. Pass that ETag when calling -// [setSyncAuthorization](setSyncAuthorization) to ensure that you are -// updating the correct version. If you don't pass the ETag in the call -// to `setSyncAuthorization`, then the existing authorization is -// overwritten indiscriminately. For more information, see [Configure -// the -// Synchronizer](https://cloud.google.com/apigee/docs/hybrid/latest/synch -// ronizer-access). **Note**: Available to Apigee hybrid only. +// setSyncAuthorization to ensure that you are updating the correct +// version. If you don't pass the ETag in the call to +// `setSyncAuthorization`, then the existing authorization is +// overwritten indiscriminately. For more information, see Configure the +// Synchronizer. **Note**: Available to Apigee hybrid only. func (r *OrganizationsService) GetSyncAuthorization(name string, googlecloudapigeev1getsyncauthorizationrequest *GoogleCloudApigeeV1GetSyncAuthorizationRequest) *OrganizationsGetSyncAuthorizationCall { c := &OrganizationsGetSyncAuthorizationCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9172,9 +9152,7 @@ type OrganizationsListCall struct { } // List: Lists the Apigee organizations and associated GCP projects that -// you have permission to access. See [Understanding -// organizations](https://cloud.google.com/apigee/docs/api-platform/funda -// mentals/organization-structure). +// you have permission to access. See Understanding organizations. func (r *OrganizationsService) List(parent string) *OrganizationsListCall { c := &OrganizationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9325,12 +9303,10 @@ type OrganizationsSetSyncAuthorizationCall struct { // must call this API to enable proper functioning of hybrid. Pass the // ETag when calling `setSyncAuthorization` to ensure that you are // updating the correct version. To get an ETag, call -// [getSyncAuthorization](getSyncAuthorization). If you don't pass the -// ETag in the call to `setSyncAuthorization`, then the existing -// authorization is overwritten indiscriminately. For more information, -// see [Configure the -// Synchronizer](https://cloud.google.com/apigee/docs/hybrid/latest/synch -// ronizer-access). **Note**: Available to Apigee hybrid only. +// getSyncAuthorization. If you don't pass the ETag in the call to +// `setSyncAuthorization`, then the existing authorization is +// overwritten indiscriminately. For more information, see Configure the +// Synchronizer. **Note**: Available to Apigee hybrid only. func (r *OrganizationsService) SetSyncAuthorization(name string, googlecloudapigeev1syncauthorization *GoogleCloudApigeeV1SyncAuthorization) *OrganizationsSetSyncAuthorizationCall { c := &OrganizationsSetSyncAuthorizationCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -13190,7 +13166,7 @@ type OrganizationsApisRevisionsGetCall struct { // `-o filename.zip` to save the output to a file; otherwise, it // displays to `stdout`. Then, develop the API proxy configuration // locally and upload the updated API proxy configuration revision, as -// described in [updateApiProxyRevision](updateApiProxyRevision). +// described in updateApiProxyRevision. func (r *OrganizationsApisRevisionsService) Get(name string) *OrganizationsApisRevisionsGetCall { c := &OrganizationsApisRevisionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -21648,10 +21624,9 @@ type OrganizationsEnvironmentsGetIamPolicyCall struct { } // GetIamPolicy: Gets the IAM policy on an environment. For more -// information, see [Manage users, roles, and permissions using the -// API](https://cloud.google.com/apigee/docs/api-platform/system-administ -// ration/manage-users-roles). You must have the -// `apigee.environments.getIamPolicy` permission to call this API. +// information, see Manage users, roles, and permissions using the API. +// You must have the `apigee.environments.getIamPolicy` permission to +// call this API. func (r *OrganizationsEnvironmentsService) GetIamPolicy(resource string) *OrganizationsEnvironmentsGetIamPolicyCall { c := &OrganizationsEnvironmentsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -21665,9 +21640,7 @@ func (r *OrganizationsEnvironmentsService) GetIamPolicy(resource string) *Organi // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *OrganizationsEnvironmentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *OrganizationsEnvironmentsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -21817,10 +21790,8 @@ type OrganizationsEnvironmentsSetIamPolicyCall struct { } // SetIamPolicy: Sets the IAM policy on an environment, if the policy -// already exists it will be replaced. For more information, see [Manage -// users, roles, and permissions using the -// API](https://cloud.google.com/apigee/docs/api-platform/system-administ -// ration/manage-users-roles). You must have the +// already exists it will be replaced. For more information, see Manage +// users, roles, and permissions using the API. You must have the // `apigee.environments.setIamPolicy` permission to call this API. func (r *OrganizationsEnvironmentsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsEnvironmentsSetIamPolicyCall { c := &OrganizationsEnvironmentsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -22382,7 +22353,7 @@ type OrganizationsEnvironmentsUpdateCall struct { // you must pass all existing properties to the API, even if they are // not being changed. If you omit properties from the payload, the // properties are removed. To get the current list of properties for the -// environment, use the [Get Environment API](get). +// environment, use the Get Environment API. func (r *OrganizationsEnvironmentsService) Update(name string, googlecloudapigeev1environment *GoogleCloudApigeeV1Environment) *OrganizationsEnvironmentsUpdateCall { c := &OrganizationsEnvironmentsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -22695,7 +22666,7 @@ type OrganizationsEnvironmentsUpdateEnvironmentCall struct { // properties, you must pass all existing properties to the API, even if // they are not being changed. If you omit properties from the payload, // the properties are removed. To get the current list of properties for -// the environment, use the [Get Environment API](get). +// the environment, use the Get Environment API. func (r *OrganizationsEnvironmentsService) UpdateEnvironment(name string, googlecloudapigeev1environment *GoogleCloudApigeeV1Environment) *OrganizationsEnvironmentsUpdateEnvironmentCall { c := &OrganizationsEnvironmentsUpdateEnvironmentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -29053,9 +29024,7 @@ type OrganizationsEnvironmentsResourcefilesCreateCall struct { // Create: Creates a resource file. Specify the `Content-Type` as // `application/octet-stream` or `multipart/form-data`. For more -// information about resource files, see [Resource -// files](https://cloud.google.com/apigee/docs/api-platform/develop/resou -// rce-files). +// information about resource files, see Resource files. func (r *OrganizationsEnvironmentsResourcefilesService) Create(parent string, googleapihttpbody *GoogleApiHttpBody) *OrganizationsEnvironmentsResourcefilesCreateCall { c := &OrganizationsEnvironmentsResourcefilesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29065,7 +29034,7 @@ func (r *OrganizationsEnvironmentsResourcefilesService) Create(parent string, go // Name sets the optional parameter "name": Required. Name of the // resource file. Must match the regular expression: -// [a-zA-Z0-9:/\\!@#$%^&{}\[\]()+\-=,.~'` ]{1,255} +// [a-zA-Z0-9:/\\!@#$%^&{}\\+\-=,.~'` ]{1,255} func (c *OrganizationsEnvironmentsResourcefilesCreateCall) Name(name string) *OrganizationsEnvironmentsResourcefilesCreateCall { c.urlParams_.Set("name", name) return c @@ -29222,9 +29191,7 @@ type OrganizationsEnvironmentsResourcefilesDeleteCall struct { } // Delete: Deletes a resource file. For more information about resource -// files, see [Resource -// files](https://cloud.google.com/apigee/docs/api-platform/develop/resou -// rce-files). +// files, see Resource files. func (r *OrganizationsEnvironmentsResourcefilesService) Delete(parent string, type_ string, name string) *OrganizationsEnvironmentsResourcefilesDeleteCall { c := &OrganizationsEnvironmentsResourcefilesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29376,9 +29343,7 @@ type OrganizationsEnvironmentsResourcefilesGetCall struct { } // Get: Gets the contents of a resource file. For more information about -// resource files, see [Resource -// files](https://cloud.google.com/apigee/docs/api-platform/develop/resou -// rce-files). +// resource files, see Resource files. func (r *OrganizationsEnvironmentsResourcefilesService) Get(parent string, type_ string, name string) *OrganizationsEnvironmentsResourcefilesGetCall { c := &OrganizationsEnvironmentsResourcefilesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29541,9 +29506,7 @@ type OrganizationsEnvironmentsResourcefilesListCall struct { } // List: Lists all resource files, optionally filtering by type. For -// more information about resource files, see [Resource -// files](https://cloud.google.com/apigee/docs/api-platform/develop/resou -// rce-files). +// more information about resource files, see Resource files. func (r *OrganizationsEnvironmentsResourcefilesService) List(parent string) *OrganizationsEnvironmentsResourcefilesListCall { c := &OrganizationsEnvironmentsResourcefilesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29704,9 +29667,7 @@ type OrganizationsEnvironmentsResourcefilesListEnvironmentResourcesCall struct { // ListEnvironmentResources: Lists all resource files, optionally // filtering by type. For more information about resource files, see -// [Resource -// files](https://cloud.google.com/apigee/docs/api-platform/develop/resou -// rce-files). +// Resource files. func (r *OrganizationsEnvironmentsResourcefilesService) ListEnvironmentResources(parent string, type_ string) *OrganizationsEnvironmentsResourcefilesListEnvironmentResourcesCall { c := &OrganizationsEnvironmentsResourcefilesListEnvironmentResourcesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29865,9 +29826,7 @@ type OrganizationsEnvironmentsResourcefilesUpdateCall struct { // Update: Updates a resource file. Specify the `Content-Type` as // `application/octet-stream` or `multipart/form-data`. For more -// information about resource files, see [Resource -// files](https://cloud.google.com/apigee/docs/api-platform/develop/resou -// rce-files). +// information about resource files, see Resource files. func (r *OrganizationsEnvironmentsResourcefilesService) Update(parent string, type_ string, name string, googleapihttpbody *GoogleApiHttpBody) *OrganizationsEnvironmentsResourcefilesUpdateCall { c := &OrganizationsEnvironmentsResourcefilesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/appengine/v1beta4/appengine-gen.go b/appengine/v1beta4/appengine-gen.go index a78d88c1293..17b91327526 100644 --- a/appengine/v1beta4/appengine-gen.go +++ b/appengine/v1beta4/appengine-gen.go @@ -56,6 +56,7 @@ import ( googleapi "google.golang.org/api/googleapi" gensupport "google.golang.org/api/internal/gensupport" option "google.golang.org/api/option" + internaloption "google.golang.org/api/option/internaloption" htransport "google.golang.org/api/transport/http" ) @@ -72,6 +73,7 @@ var _ = googleapi.Version var _ = errors.New var _ = strings.Replace var _ = context.Canceled +var _ = internaloption.WithDefaultEndpoint const apiId = "appengine:v1beta4" const apiName = "appengine" @@ -99,6 +101,7 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*APIService, ) // NOTE: prepend, so we don't override user-specified scopes. opts = append([]option.ClientOption{scopesOption}, opts...) + opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) client, endpoint, err := htransport.NewClient(ctx, opts...) if err != nil { return nil, err @@ -2765,7 +2768,7 @@ func (c *AppsCreateCall) Header() http.Header { func (c *AppsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2913,7 +2916,7 @@ func (c *AppsGetCall) Header() http.Header { func (c *AppsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3066,7 +3069,7 @@ func (c *AppsPatchCall) Header() http.Header { func (c *AppsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3222,7 +3225,7 @@ func (c *AppsLocationsGetCall) Header() http.Header { func (c *AppsLocationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3397,7 +3400,7 @@ func (c *AppsLocationsListCall) Header() http.Header { func (c *AppsLocationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3570,7 +3573,7 @@ func (c *AppsModulesDeleteCall) Header() http.Header { func (c *AppsModulesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3720,7 +3723,7 @@ func (c *AppsModulesGetCall) Header() http.Header { func (c *AppsModulesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3887,7 +3890,7 @@ func (c *AppsModulesListCall) Header() http.Header { func (c *AppsModulesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4085,7 +4088,7 @@ func (c *AppsModulesPatchCall) Header() http.Header { func (c *AppsModulesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4245,7 +4248,7 @@ func (c *AppsModulesVersionsCreateCall) Header() http.Header { func (c *AppsModulesVersionsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4394,7 +4397,7 @@ func (c *AppsModulesVersionsDeleteCall) Header() http.Header { func (c *AppsModulesVersionsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4567,7 +4570,7 @@ func (c *AppsModulesVersionsGetCall) Header() http.Header { func (c *AppsModulesVersionsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4764,7 +4767,7 @@ func (c *AppsModulesVersionsListCall) Header() http.Header { func (c *AppsModulesVersionsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4982,7 +4985,7 @@ func (c *AppsModulesVersionsPatchCall) Header() http.Header { func (c *AppsModulesVersionsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5155,7 +5158,7 @@ func (c *AppsModulesVersionsInstancesDebugCall) Header() http.Header { func (c *AppsModulesVersionsInstancesDebugCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5322,7 +5325,7 @@ func (c *AppsModulesVersionsInstancesDeleteCall) Header() http.Header { func (c *AppsModulesVersionsInstancesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5492,7 +5495,7 @@ func (c *AppsModulesVersionsInstancesGetCall) Header() http.Header { func (c *AppsModulesVersionsInstancesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5682,7 +5685,7 @@ func (c *AppsModulesVersionsInstancesListCall) Header() http.Header { func (c *AppsModulesVersionsInstancesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5879,7 +5882,7 @@ func (c *AppsOperationsGetCall) Header() http.Header { func (c *AppsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6062,7 +6065,7 @@ func (c *AppsOperationsListCall) Header() http.Header { func (c *AppsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/appengine/v1beta5/appengine-gen.go b/appengine/v1beta5/appengine-gen.go index 39e66dcf7a8..eab2ba211e9 100644 --- a/appengine/v1beta5/appengine-gen.go +++ b/appengine/v1beta5/appengine-gen.go @@ -56,6 +56,7 @@ import ( googleapi "google.golang.org/api/googleapi" gensupport "google.golang.org/api/internal/gensupport" option "google.golang.org/api/option" + internaloption "google.golang.org/api/option/internaloption" htransport "google.golang.org/api/transport/http" ) @@ -72,6 +73,7 @@ var _ = googleapi.Version var _ = errors.New var _ = strings.Replace var _ = context.Canceled +var _ = internaloption.WithDefaultEndpoint const apiId = "appengine:v1beta5" const apiName = "appengine" @@ -99,6 +101,7 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*APIService, ) // NOTE: prepend, so we don't override user-specified scopes. opts = append([]option.ClientOption{scopesOption}, opts...) + opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) client, endpoint, err := htransport.NewClient(ctx, opts...) if err != nil { return nil, err @@ -2724,7 +2727,7 @@ func (c *AppsCreateCall) Header() http.Header { func (c *AppsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2873,7 +2876,7 @@ func (c *AppsGetCall) Header() http.Header { func (c *AppsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3026,7 +3029,7 @@ func (c *AppsPatchCall) Header() http.Header { func (c *AppsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3182,7 +3185,7 @@ func (c *AppsLocationsGetCall) Header() http.Header { func (c *AppsLocationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3357,7 +3360,7 @@ func (c *AppsLocationsListCall) Header() http.Header { func (c *AppsLocationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3543,7 +3546,7 @@ func (c *AppsOperationsGetCall) Header() http.Header { func (c *AppsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3726,7 +3729,7 @@ func (c *AppsOperationsListCall) Header() http.Header { func (c *AppsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3899,7 +3902,7 @@ func (c *AppsServicesDeleteCall) Header() http.Header { func (c *AppsServicesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4049,7 +4052,7 @@ func (c *AppsServicesGetCall) Header() http.Header { func (c *AppsServicesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4216,7 +4219,7 @@ func (c *AppsServicesListCall) Header() http.Header { func (c *AppsServicesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4414,7 +4417,7 @@ func (c *AppsServicesPatchCall) Header() http.Header { func (c *AppsServicesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4574,7 +4577,7 @@ func (c *AppsServicesVersionsCreateCall) Header() http.Header { func (c *AppsServicesVersionsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4723,7 +4726,7 @@ func (c *AppsServicesVersionsDeleteCall) Header() http.Header { func (c *AppsServicesVersionsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4896,7 +4899,7 @@ func (c *AppsServicesVersionsGetCall) Header() http.Header { func (c *AppsServicesVersionsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5093,7 +5096,7 @@ func (c *AppsServicesVersionsListCall) Header() http.Header { func (c *AppsServicesVersionsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5311,7 +5314,7 @@ func (c *AppsServicesVersionsPatchCall) Header() http.Header { func (c *AppsServicesVersionsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5484,7 +5487,7 @@ func (c *AppsServicesVersionsInstancesDebugCall) Header() http.Header { func (c *AppsServicesVersionsInstancesDebugCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5651,7 +5654,7 @@ func (c *AppsServicesVersionsInstancesDeleteCall) Header() http.Header { func (c *AppsServicesVersionsInstancesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5821,7 +5824,7 @@ func (c *AppsServicesVersionsInstancesGetCall) Header() http.Header { func (c *AppsServicesVersionsInstancesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6011,7 +6014,7 @@ func (c *AppsServicesVersionsInstancesListCall) Header() http.Header { func (c *AppsServicesVersionsInstancesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/1.13.7 gdcl/20200203") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/artifactregistry/v1beta1/artifactregistry-gen.go b/artifactregistry/v1beta1/artifactregistry-gen.go index 676ba718523..b09d6536194 100644 --- a/artifactregistry/v1beta1/artifactregistry-gen.go +++ b/artifactregistry/v1beta1/artifactregistry-gen.go @@ -244,9 +244,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1025,9 +1023,8 @@ func (s *Package) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1045,8 +1042,8 @@ func (s *Package) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1081,9 +1078,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1211,11 +1207,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1298,8 +1293,7 @@ func (s *Tag) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2574,9 +2568,7 @@ func (r *ProjectsLocationsRepositoriesService) GetIamPolicy(resource string) *Pr // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsRepositoriesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRepositoriesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/artifactregistry/v1beta2/artifactregistry-gen.go b/artifactregistry/v1beta2/artifactregistry-gen.go index cd554f770f1..1e0ae0ce5a1 100644 --- a/artifactregistry/v1beta2/artifactregistry-gen.go +++ b/artifactregistry/v1beta2/artifactregistry-gen.go @@ -244,9 +244,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1025,9 +1023,8 @@ func (s *Package) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1045,8 +1042,8 @@ func (s *Package) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1081,9 +1078,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1211,11 +1207,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1298,8 +1293,7 @@ func (s *Tag) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2574,9 +2568,7 @@ func (r *ProjectsLocationsRepositoriesService) GetIamPolicy(resource string) *Pr // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsRepositoriesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRepositoriesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/assuredworkloads/v1/assuredworkloads-gen.go b/assuredworkloads/v1/assuredworkloads-gen.go index d1604c15897..766a2b4709b 100644 --- a/assuredworkloads/v1/assuredworkloads-gen.go +++ b/assuredworkloads/v1/assuredworkloads-gen.go @@ -896,11 +896,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 4827fa784e7..12028b6bf40 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -1186,9 +1186,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -2849,9 +2847,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -4887,9 +4883,8 @@ func (s *MultiClassClassificationMetrics) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -4907,8 +4902,8 @@ func (s *MultiClassClassificationMetrics) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -4947,9 +4942,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -7026,8 +7020,7 @@ func (s *TableSchema) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/bigqueryconnection/v1beta1/bigqueryconnection-gen.go b/bigqueryconnection/v1beta1/bigqueryconnection-gen.go index f7058ae48a7..abc17c58cfe 100644 --- a/bigqueryconnection/v1beta1/bigqueryconnection-gen.go +++ b/bigqueryconnection/v1beta1/bigqueryconnection-gen.go @@ -283,9 +283,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -615,9 +613,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -692,9 +688,8 @@ func (s *ListConnectionsResponse) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -712,8 +707,8 @@ func (s *ListConnectionsResponse) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -752,9 +747,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -826,8 +820,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go index 2496253f8d5..248b459718b 100644 --- a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go +++ b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go @@ -1021,11 +1021,10 @@ func (s *StartManualTransferRunsResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index 5b487146946..320a110d64f 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -947,11 +947,10 @@ func (s *SplitCapacityCommitmentResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/bigqueryreservation/v1beta1/bigqueryreservation-gen.go b/bigqueryreservation/v1beta1/bigqueryreservation-gen.go index 5d629efbf54..e14c6f5e3df 100644 --- a/bigqueryreservation/v1beta1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1beta1/bigqueryreservation-gen.go @@ -803,11 +803,10 @@ func (s *SplitCapacityCommitmentResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2892,8 +2891,7 @@ func (r *ProjectsLocationsReservationsService) List(parent string) *ProjectsLoca // Filter sets the optional parameter "filter": Can be used to filter // out reservations based on names, capacity, etc, e.g.: // filter="reservation.slot_capacity > 200" filter="reservation.name = -// \"*dev/*\"" Advanced filtering syntax can be -// [here](https://cloud.google.com/logging/docs/view/advanced-filters). +// \"*dev/*\"" Advanced filtering syntax can be here. func (c *ProjectsLocationsReservationsListCall) Filter(filter string) *ProjectsLocationsReservationsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/bigtableadmin/v2/bigtableadmin-gen.go b/bigtableadmin/v2/bigtableadmin-gen.go index 97124c3e454..f3ad8ccfc7a 100644 --- a/bigtableadmin/v2/bigtableadmin-gen.go +++ b/bigtableadmin/v2/bigtableadmin-gen.go @@ -299,10 +299,8 @@ type AppProfile struct { // Preserve the value returned from `GetAppProfile` when calling // `UpdateAppProfile` to fail the request if there has been a // modification in the mean time. The `update_mask` of the request need - // not include `etag` for this protection to apply. See - // [Wikipedia](https://en.wikipedia.org/wiki/HTTP_ETag) and [RFC - // 7232](https://tools.ietf.org/html/rfc7232#section-2.3) for more - // details. + // not include `etag` for this protection to apply. See Wikipedia and + // RFC 7232 for more details. Etag string `json:"etag,omitempty"` // MultiClusterRoutingUseAny: Use a multi-cluster routing policy. @@ -561,9 +559,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1390,9 +1386,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2116,9 +2110,8 @@ func (s *PartialUpdateInstanceRequest) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2136,8 +2129,8 @@ func (s *PartialUpdateInstanceRequest) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2176,9 +2169,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2435,11 +2427,10 @@ func (s *Split) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2592,8 +2583,7 @@ func (s *TableProgress) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/billingbudgets/v1/billingbudgets-gen.go b/billingbudgets/v1/billingbudgets-gen.go index 48dd14fea28..be8c92a2ae6 100644 --- a/billingbudgets/v1/billingbudgets-gen.go +++ b/billingbudgets/v1/billingbudgets-gen.go @@ -271,10 +271,8 @@ type GoogleCloudBillingBudgetsV1Filter struct { // INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be // subtracted from gross cost to determine the spend for threshold // calculations. If Filter.credit_types_treatment is **not** - // INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list of - // acceptable credit type - // values](https://cloud.google.com/billing/docs/how-to/export-data-bigqu - // ery-tables#credits-type). + // INCLUDE_SPECIFIED_CREDITS, this field must be empty. See a list of + // acceptable credit type values. CreditTypes []string `json:"creditTypes,omitempty"` // CreditTypesTreatment: Optional. If not set, default behavior is @@ -578,9 +576,8 @@ type BillingAccountsBudgetsCreateCall struct { header_ http.Header } -// Create: Creates a new budget. See [Quotas and -// limits](https://cloud.google.com/billing/quotas) for more information -// on the limits of the number of budgets you can create. +// Create: Creates a new budget. See Quotas and limits for more +// information on the limits of the number of budgets you can create. func (r *BillingAccountsBudgetsService) Create(parent string, googlecloudbillingbudgetsv1budget *GoogleCloudBillingBudgetsV1Budget) *BillingAccountsBudgetsCreateCall { c := &BillingAccountsBudgetsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/billingbudgets/v1beta1/billingbudgets-gen.go b/billingbudgets/v1beta1/billingbudgets-gen.go index 188786044c1..871a8ed1364 100644 --- a/billingbudgets/v1beta1/billingbudgets-gen.go +++ b/billingbudgets/v1beta1/billingbudgets-gen.go @@ -361,10 +361,8 @@ type GoogleCloudBillingBudgetsV1beta1Filter struct { // INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be // subtracted from gross cost to determine the spend for threshold // calculations. If Filter.credit_types_treatment is **not** - // INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list of - // acceptable credit type - // values](https://cloud.google.com/billing/docs/how-to/export-data-bigqu - // ery-tables#credits-type). + // INCLUDE_SPECIFIED_CREDITS, this field must be empty. See a list of + // acceptable credit type values. CreditTypes []string `json:"creditTypes,omitempty"` // CreditTypesTreatment: Optional. If not set, default behavior is diff --git a/binaryauthorization/v1/binaryauthorization-gen.go b/binaryauthorization/v1/binaryauthorization-gen.go index d842b978efc..96e77450f0c 100644 --- a/binaryauthorization/v1/binaryauthorization-gen.go +++ b/binaryauthorization/v1/binaryauthorization-gen.go @@ -425,9 +425,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -574,9 +572,8 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -594,8 +591,8 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type IamPolicy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -630,9 +627,8 @@ type IamPolicy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -976,8 +972,7 @@ func (s *Signature) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1925,9 +1920,7 @@ func (r *ProjectsAttestorsService) GetIamPolicy(resource string) *ProjectsAttest // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsAttestorsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsAttestorsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -2856,9 +2849,7 @@ func (r *ProjectsPolicyService) GetIamPolicy(resource string) *ProjectsPolicyGet // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsPolicyGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsPolicyGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/binaryauthorization/v1beta1/binaryauthorization-gen.go b/binaryauthorization/v1beta1/binaryauthorization-gen.go index 75018982187..9274c5be585 100644 --- a/binaryauthorization/v1beta1/binaryauthorization-gen.go +++ b/binaryauthorization/v1beta1/binaryauthorization-gen.go @@ -427,9 +427,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -576,9 +574,8 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -596,8 +593,8 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type IamPolicy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -632,9 +629,8 @@ type IamPolicy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -978,8 +974,7 @@ func (s *Signature) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1927,9 +1922,7 @@ func (r *ProjectsAttestorsService) GetIamPolicy(resource string) *ProjectsAttest // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsAttestorsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsAttestorsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -2858,9 +2851,7 @@ func (r *ProjectsPolicyService) GetIamPolicy(resource string) *ProjectsPolicyGet // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsPolicyGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsPolicyGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 490c600987e..dd65b8bbf98 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -605,14 +605,13 @@ func (s *CardHeader) MarshalJSON() ([]byte, error) { type DeprecatedEvent struct { // Action: The form action data associated with an interactive card that // was clicked. Only populated for CARD_CLICKED events. See the - // [Interactive Cards guide](/hangouts/chat/how-tos/cards-onclick) for - // more information. + // Interactive Cards guide for more information. Action *FormAction `json:"action,omitempty"` // ConfigCompleteRedirectUrl: The URL the bot should redirect the user // to after they have completed an authorization or configuration flow - // outside of Google Chat. See the [Authorizing access to 3p services - // guide](/hangouts/chat/how-tos/auth-3p) for more information. + // outside of Google Chat. See the Authorizing access to 3p services + // guide for more information. ConfigCompleteRedirectUrl string `json:"configCompleteRedirectUrl,omitempty"` // EventTime: The timestamp indicating when the event was dispatched. diff --git a/classroom/v1/classroom-gen.go b/classroom/v1/classroom-gen.go index 61f1b5ed625..0beaab0f585 100644 --- a/classroom/v1/classroom-gen.go +++ b/classroom/v1/classroom-gen.go @@ -601,9 +601,7 @@ func (s *Attachment) MarshalJSON() ([]byte, error) { // `classroom-notifications@system.gserviceaccount.com` the // `projects.topics.publish` permission. type CloudPubsubTopic struct { - // TopicName: The `name` field of a Cloud Pub/Sub - // [Topic](https://cloud.google.com/pubsub/docs/reference/rest/v1/project - // s.topics#Topic). + // TopicName: The `name` field of a Cloud Pub/Sub Topic. TopicName string `json:"topicName,omitempty"` // ForceSendFields is a list of field names (e.g. "TopicName") to @@ -4747,13 +4745,12 @@ type CoursesAnnouncementsDeleteCall struct { } // Delete: Deletes an announcement. This request must be made by the -// Developer Console project of the [OAuth client -// ID](https://support.google.com/cloud/answer/6158849) used to create -// the corresponding announcement item. This method returns the -// following error codes: * `PERMISSION_DENIED` if the requesting -// developer project did not create the corresponding announcement, if -// the requesting user is not permitted to delete the requested course -// or for access errors. * `FAILED_PRECONDITION` if the requested +// Developer Console project of the OAuth client ID used to create the +// corresponding announcement item. This method returns the following +// error codes: * `PERMISSION_DENIED` if the requesting developer +// project did not create the corresponding announcement, if the +// requesting user is not permitted to delete the requested course or +// for access errors. * `FAILED_PRECONDITION` if the requested // announcement has already been deleted. * `NOT_FOUND` if no course // exists with the requested ID. func (r *CoursesAnnouncementsService) Delete(courseId string, id string) *CoursesAnnouncementsDeleteCall { @@ -5639,17 +5636,16 @@ type CoursesCourseWorkCreateCall struct { // Create: Creates course work. The resulting course work (and // corresponding student submissions) are associated with the Developer -// Console project of the [OAuth client -// ID](https://support.google.com/cloud/answer/6158849) used to make the -// request. Classroom API requests to modify course work and student -// submissions must be made with an OAuth client ID from the associated -// Developer Console project. This method returns the following error -// codes: * `PERMISSION_DENIED` if the requesting user is not permitted -// to access the requested course, create course work in the requested -// course, share a Drive attachment, or for access errors. * -// `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the -// requested course does not exist. * `FAILED_PRECONDITION` for the -// following request error: * AttachmentNotVisible +// Console project of the OAuth client ID used to make the request. +// Classroom API requests to modify course work and student submissions +// must be made with an OAuth client ID from the associated Developer +// Console project. This method returns the following error codes: * +// `PERMISSION_DENIED` if the requesting user is not permitted to access +// the requested course, create course work in the requested course, +// share a Drive attachment, or for access errors. * `INVALID_ARGUMENT` +// if the request is malformed. * `NOT_FOUND` if the requested course +// does not exist. * `FAILED_PRECONDITION` for the following request +// error: * AttachmentNotVisible func (r *CoursesCourseWorkService) Create(courseId string, coursework *CourseWork) *CoursesCourseWorkCreateCall { c := &CoursesCourseWorkCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -5789,9 +5785,8 @@ type CoursesCourseWorkDeleteCall struct { } // Delete: Deletes a course work. This request must be made by the -// Developer Console project of the [OAuth client -// ID](https://support.google.com/cloud/answer/6158849) used to create -// the corresponding course work item. This method returns the following +// Developer Console project of the OAuth client ID used to create the +// corresponding course work item. This method returns the following // error codes: * `PERMISSION_DENIED` if the requesting developer // project did not create the corresponding course work, if the // requesting user is not permitted to delete the requested course or @@ -6511,9 +6506,8 @@ type CoursesCourseWorkPatchCall struct { // Patch: Updates one or more fields of a course work. See // google.classroom.v1.CourseWork for details of which fields may be // updated and who may change them. This request must be made by the -// Developer Console project of the [OAuth client -// ID](https://support.google.com/cloud/answer/6158849) used to create -// the corresponding course work item. This method returns the following +// Developer Console project of the OAuth client ID used to create the +// corresponding course work item. This method returns the following // error codes: * `PERMISSION_DENIED` if the requesting developer // project did not create the corresponding course work, if the user is // not permitted to make the requested modification to the student @@ -7170,15 +7164,14 @@ type CoursesCourseWorkStudentSubmissionsModifyAttachmentsCall struct { // ModifyAttachments: Modifies attachments of student submission. // Attachments may only be added to student submissions belonging to // course work objects with a `workType` of `ASSIGNMENT`. This request -// must be made by the Developer Console project of the [OAuth client -// ID](https://support.google.com/cloud/answer/6158849) used to create -// the corresponding course work item. This method returns the following -// error codes: * `PERMISSION_DENIED` if the requesting user is not -// permitted to access the requested course or course work, if the user -// is not permitted to modify attachments on the requested student -// submission, or for access errors. * `INVALID_ARGUMENT` if the request -// is malformed. * `NOT_FOUND` if the requested course, course work, or -// student submission does not exist. +// must be made by the Developer Console project of the OAuth client ID +// used to create the corresponding course work item. This method +// returns the following error codes: * `PERMISSION_DENIED` if the +// requesting user is not permitted to access the requested course or +// course work, if the user is not permitted to modify attachments on +// the requested student submission, or for access errors. * +// `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the +// requested course, course work, or student submission does not exist. func (r *CoursesCourseWorkStudentSubmissionsService) ModifyAttachments(courseId string, courseWorkId string, id string, modifyattachmentsrequest *ModifyAttachmentsRequest) *CoursesCourseWorkStudentSubmissionsModifyAttachmentsCall { c := &CoursesCourseWorkStudentSubmissionsModifyAttachmentsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -7341,9 +7334,8 @@ type CoursesCourseWorkStudentSubmissionsPatchCall struct { // Patch: Updates one or more fields of a student submission. See // google.classroom.v1.StudentSubmission for details of which fields may // be updated and who may change them. This request must be made by the -// Developer Console project of the [OAuth client -// ID](https://support.google.com/cloud/answer/6158849) used to create -// the corresponding course work item. This method returns the following +// Developer Console project of the OAuth client ID used to create the +// corresponding course work item. This method returns the following // error codes: * `PERMISSION_DENIED` if the requesting developer // project did not create the corresponding course work, if the user is // not permitted to make the requested modification to the student @@ -7531,15 +7523,14 @@ type CoursesCourseWorkStudentSubmissionsReclaimCall struct { // Only the student that owns the requested student submission may call // this method, and only for a student submission that has been turned // in. This request must be made by the Developer Console project of the -// [OAuth client ID](https://support.google.com/cloud/answer/6158849) -// used to create the corresponding course work item. This method -// returns the following error codes: * `PERMISSION_DENIED` if the -// requesting user is not permitted to access the requested course or -// course work, unsubmit the requested student submission, or for access -// errors. * `FAILED_PRECONDITION` if the student submission has not -// been turned in. * `INVALID_ARGUMENT` if the request is malformed. * -// `NOT_FOUND` if the requested course, course work, or student -// submission does not exist. +// OAuth client ID used to create the corresponding course work item. +// This method returns the following error codes: * `PERMISSION_DENIED` +// if the requesting user is not permitted to access the requested +// course or course work, unsubmit the requested student submission, or +// for access errors. * `FAILED_PRECONDITION` if the student submission +// has not been turned in. * `INVALID_ARGUMENT` if the request is +// malformed. * `NOT_FOUND` if the requested course, course work, or +// student submission does not exist. func (r *CoursesCourseWorkStudentSubmissionsService) Reclaim(courseId string, courseWorkId string, id string, reclaimstudentsubmissionrequest *ReclaimStudentSubmissionRequest) *CoursesCourseWorkStudentSubmissionsReclaimCall { c := &CoursesCourseWorkStudentSubmissionsReclaimCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -7704,12 +7695,11 @@ type CoursesCourseWorkStudentSubmissionsReturnCall struct { // returning a student submission does not set assignedGrade to the // draftGrade value. Only a teacher of the course that contains the // requested student submission may call this method. This request must -// be made by the Developer Console project of the [OAuth client -// ID](https://support.google.com/cloud/answer/6158849) used to create -// the corresponding course work item. This method returns the following -// error codes: * `PERMISSION_DENIED` if the requesting user is not -// permitted to access the requested course or course work, return the -// requested student submission, or for access errors. * +// be made by the Developer Console project of the OAuth client ID used +// to create the corresponding course work item. This method returns the +// following error codes: * `PERMISSION_DENIED` if the requesting user +// is not permitted to access the requested course or course work, +// return the requested student submission, or for access errors. * // `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the // requested course, course work, or student submission does not exist. func (r *CoursesCourseWorkStudentSubmissionsService) Return(courseId string, courseWorkId string, id string, returnstudentsubmissionrequest *ReturnStudentSubmissionRequest) *CoursesCourseWorkStudentSubmissionsReturnCall { @@ -7874,14 +7864,14 @@ type CoursesCourseWorkStudentSubmissionsTurnInCall struct { // submission transfers ownership of attached Drive files to the teacher // and may also update the submission state. This may only be called by // the student that owns the specified student submission. This request -// must be made by the Developer Console project of the [OAuth client -// ID](https://support.google.com/cloud/answer/6158849) used to create -// the corresponding course work item. This method returns the following -// error codes: * `PERMISSION_DENIED` if the requesting user is not -// permitted to access the requested course or course work, turn in the -// requested student submission, or for access errors. * -// `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the -// requested course, course work, or student submission does not exist. +// must be made by the Developer Console project of the OAuth client ID +// used to create the corresponding course work item. This method +// returns the following error codes: * `PERMISSION_DENIED` if the +// requesting user is not permitted to access the requested course or +// course work, turn in the requested student submission, or for access +// errors. * `INVALID_ARGUMENT` if the request is malformed. * +// `NOT_FOUND` if the requested course, course work, or student +// submission does not exist. func (r *CoursesCourseWorkStudentSubmissionsService) TurnIn(courseId string, courseWorkId string, id string, turninstudentsubmissionrequest *TurnInStudentSubmissionRequest) *CoursesCourseWorkStudentSubmissionsTurnInCall { c := &CoursesCourseWorkStudentSubmissionsTurnInCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -8185,8 +8175,7 @@ type CoursesCourseWorkMaterialsDeleteCall struct { } // Delete: Deletes a course work material. This request must be made by -// the Developer Console project of the [OAuth client -// ID](https://support.google.com/cloud/answer/6158849) used to create +// the Developer Console project of the OAuth client ID used to create // the corresponding course work material item. This method returns the // following error codes: * `PERMISSION_DENIED` if the requesting // developer project did not create the corresponding course work diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index 3354a0efdf3..debebf02a88 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -281,38 +281,28 @@ func (s *AnalyzeIamPolicyResponse) MarshalJSON() ([]byte, error) { } // Asset: An asset in Google Cloud. An asset can be any resource in the -// Google Cloud [resource -// hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platfo -// rm-resource-hierarchy), a resource outside the Google Cloud resource -// hierarchy (such as Google Kubernetes Engine clusters and objects), or -// a policy (e.g. Cloud IAM policy). See [Supported asset -// types](https://cloud.google.com/asset-inventory/docs/supported-asset-t -// ypes) for more information. +// Google Cloud resource hierarchy, a resource outside the Google Cloud +// resource hierarchy (such as Google Kubernetes Engine clusters and +// objects), or a policy (e.g. Cloud IAM policy). See Supported asset +// types for more information. type Asset struct { - // AccessLevel: Please also refer to the [access level user - // guide](https://cloud.google.com/access-context-manager/docs/overview#a - // ccess-levels). + // AccessLevel: Please also refer to the access level user guide. AccessLevel *GoogleIdentityAccesscontextmanagerV1AccessLevel `json:"accessLevel,omitempty"` - // AccessPolicy: Please also refer to the [access policy user - // guide](https://cloud.google.com/access-context-manager/docs/overview#a - // ccess-policies). + // AccessPolicy: Please also refer to the access policy user guide. AccessPolicy *GoogleIdentityAccesscontextmanagerV1AccessPolicy `json:"accessPolicy,omitempty"` - // Ancestors: The ancestry path of an asset in Google Cloud [resource - // hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platfo - // rm-resource-hierarchy), represented as a list of relative resource - // names. An ancestry path starts with the closest ancestor in the - // hierarchy and ends at root. If the asset is a project, folder, or - // organization, the ancestry path starts from the asset itself. - // Example: `["projects/123456789", "folders/5432", - // "organizations/1234"]` + // Ancestors: The ancestry path of an asset in Google Cloud resource + // hierarchy, represented as a list of relative resource names. An + // ancestry path starts with the closest ancestor in the hierarchy and + // ends at root. If the asset is a project, folder, or organization, the + // ancestry path starts from the asset itself. Example: + // `["projects/123456789", "folders/5432", "organizations/1234"]` Ancestors []string `json:"ancestors,omitempty"` // AssetType: The type of the asset. Example: - // `compute.googleapis.com/Disk` See [Supported asset - // types](https://cloud.google.com/asset-inventory/docs/supported-asset-t - // ypes) for more information. + // `compute.googleapis.com/Disk` See Supported asset types for more + // information. AssetType string `json:"assetType,omitempty"` // IamPolicy: A representation of the Cloud IAM policy set on a Google @@ -321,36 +311,29 @@ type Asset struct { // granted access scope from any policies set on parent resources in the // resource hierarchy. Therefore, the effectively policy is the union of // both the policy set on this resource and each policy set on all of - // the resource's ancestry resource levels in the hierarchy. See [this - // topic](https://cloud.google.com/iam/docs/policies#inheritance) for - // more information. + // the resource's ancestry resource levels in the hierarchy. See this + // topic for more information. IamPolicy *Policy `json:"iamPolicy,omitempty"` // Name: The full name of the asset. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1` See [Resource - // names](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. + // s/instance1` See Resource names for more information. Name string `json:"name,omitempty"` - // OrgPolicy: A representation of an [organization - // policy](https://cloud.google.com/resource-manager/docs/organization-po - // licy/overview#organization_policy). There can be more than one - // organization policy with different constraints set on a given - // resource. + // OrgPolicy: A representation of an organization policy. There can be + // more than one organization policy with different constraints set on a + // given resource. OrgPolicy []*GoogleCloudOrgpolicyV1Policy `json:"orgPolicy,omitempty"` // OsInventory: A representation of runtime OS Inventory information. - // See [this - // topic](https://cloud.google.com/compute/docs/instances/os-inventory-ma - // nagement) for more information. + // See this topic for more information. OsInventory *Inventory `json:"osInventory,omitempty"` // Resource: A representation of the resource. Resource *Resource `json:"resource,omitempty"` - // ServicePerimeter: Please also refer to the [service perimeter user - // guide](https://cloud.google.com/vpc-service-controls/docs/overview). + // ServicePerimeter: Please also refer to the service perimeter user + // guide. ServicePerimeter *GoogleIdentityAccesscontextmanagerV1ServicePerimeter `json:"servicePerimeter,omitempty"` // UpdateTime: The last update timestamp of an asset. update_time is @@ -603,9 +586,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -762,14 +743,12 @@ type ExportAssetsRequest struct { // resources whose asset type starts with "compute.googleapis.com". * // ".*Instance" snapshots resources whose asset type ends with // "Instance". * ".*Instance.*" snapshots resources whose asset type - // contains "Instance". See - // [RE2](https://github.com/google/re2/wiki/Syntax) for all supported - // regular expression syntax. If the regular expression does not match - // any supported asset type, an INVALID_ARGUMENT error will be returned. - // If specified, only matching assets will be returned, otherwise, it - // will snapshot all asset types. See [Introduction to Cloud Asset - // Inventory](https://cloud.google.com/asset-inventory/docs/overview) - // for all supported asset types. + // contains "Instance". See RE2 for all supported regular expression + // syntax. If the regular expression does not match any supported asset + // type, an INVALID_ARGUMENT error will be returned. If specified, only + // matching assets will be returned, otherwise, it will snapshot all + // asset types. See Introduction to Cloud Asset Inventory for all + // supported asset types. AssetTypes []string `json:"assetTypes,omitempty"` // ContentType: Asset content type. If not specified, no content but the @@ -890,18 +869,14 @@ type Feed struct { // asset_types. Only asset updates matching specified asset_names or // asset_types are exported to the feed. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1`. See [Resource - // Names](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more info. + // s/instance1`. See Resource Names for more info. AssetNames []string `json:"assetNames,omitempty"` // AssetTypes: A list of types of the assets to receive updates. You // must specify either or both of asset_names and asset_types. Only // asset updates matching specified asset_names or asset_types are // exported to the feed. Example: "compute.googleapis.com/Disk" See - // [this - // topic](https://cloud.google.com/asset-inventory/docs/supported-asset-t - // ypes) for a list of all supported asset types. + // this topic for a list of all supported asset types. AssetTypes []string `json:"assetTypes,omitempty"` // Condition: A condition which determines whether an asset update @@ -911,9 +886,8 @@ type Feed struct { // (https://github.com/google/cel-spec) on a TemporalAsset with name // `temporal_asset`. Example: a Feed with expression // ("temporal_asset.deleted == true") will only publish Asset deletions. - // Other fields of `Expr` are optional. See our [user - // guide](https://cloud.google.com/asset-inventory/docs/monitoring-asset- - // changes#feed_with_condition) for detailed instructions. + // Other fields of `Expr` are optional. See our user guide for detailed + // instructions. Condition *Expr `json:"condition,omitempty"` // ContentType: Asset content type. If not specified, no content but the @@ -1000,10 +974,8 @@ func (s *FeedOutputConfig) MarshalJSON() ([]byte, error) { // GcsDestination: A Cloud Storage location. type GcsDestination struct { // Uri: The uri of the Cloud Storage object. It's the same uri that is - // used by gsutil. Example: "gs://bucket_name/object_name". See [Viewing - // and Editing Object - // Metadata](https://cloud.google.com/storage/docs/viewing-editing-metada - // ta) for more information. + // used by gsutil. Example: "gs://bucket_name/object_name". See Viewing + // and Editing Object Metadata for more information. Uri string `json:"uri,omitempty"` // UriPrefix: The uri prefix of all generated Cloud Storage objects. @@ -1260,9 +1232,8 @@ type GoogleCloudAssetV1Identity struct { // AnalysisState: The analysis state of this identity. AnalysisState *IamPolicyAnalysisState `json:"analysisState,omitempty"` - // Name: The identity name in any form of members appear in [IAM policy - // binding](https://cloud.google.com/iam/reference/rest/v1/Binding), - // such as: - user:foo@google.com - group:group1@google.com - + // Name: The identity name in any form of members appear in IAM policy + // binding, such as: - user:foo@google.com - group:group1@google.com - // serviceAccount:s1@prj1.iam.gserviceaccount.com - // projectOwner:some_project_id - domain:google.com - allUsers - etc. Name string `json:"name,omitempty"` @@ -1334,9 +1305,7 @@ type GoogleCloudAssetV1Resource struct { // AnalysisState: The analysis state of this resource. AnalysisState *IamPolicyAnalysisState `json:"analysisState,omitempty"` - // FullResourceName: The [full resource - // name](https://cloud.google.com/asset-inventory/docs/resource-name-form - // at) + // FullResourceName: The full resource name FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "AnalysisState") to @@ -1560,9 +1529,8 @@ type GoogleCloudOrgpolicyV1Policy struct { BooleanPolicy *GoogleCloudOrgpolicyV1BooleanPolicy `json:"booleanPolicy,omitempty"` // Constraint: The name of the `Constraint` the `Policy` is configuring, - // for example, `constraints/serviceuser.services`. A [list of available - // constraints](/resource-manager/docs/organization-policy/org-policy-con - // straints) is available. Immutable after creation. + // for example, `constraints/serviceuser.services`. A list of available + // constraints is available. Immutable after creation. Constraint string `json:"constraint,omitempty"` // Etag: An opaque tag indicating the current version of the `Policy`, @@ -2275,12 +2243,8 @@ type IamPolicyAnalysisQuery struct { // an organization number (such as "organizations/123"), a folder number // (such as "folders/123"), a project ID (such as // "projects/my-project-id"), or a project number (such as - // "projects/12345"). To know how to get organization id, visit [here - // ](https://cloud.google.com/resource-manager/docs/creating-managing-org - // anization#retrieving_your_organization_id). To know how to get folder - // or project id, visit [here - // ](https://cloud.google.com/resource-manager/docs/creating-managing-fol - // ders#viewing_or_listing_folders_and_projects). + // "projects/12345"). To know how to get organization id, visit here . + // To know how to get folder or project id, visit here . Scope string `json:"scope,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessSelector") to @@ -2315,9 +2279,8 @@ type IamPolicyAnalysisResult struct { // selectors specified in the request. AccessControlLists []*GoogleCloudAssetV1AccessControlList `json:"accessControlLists,omitempty"` - // AttachedResourceFullName: The [full resource - // name](https://cloud.google.com/asset-inventory/docs/resource-name-form - // at) of the resource to which the iam_binding policy attaches. + // AttachedResourceFullName: The full resource name of the resource to + // which the iam_binding policy attaches. AttachedResourceFullName string `json:"attachedResourceFullName,omitempty"` // FullyExplored: Represents whether all analyses on the iam_binding @@ -2513,10 +2476,9 @@ type IamPolicySearchResult struct { // Resource: The full resource name of the resource associated with this // IAM policy. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1`. See [Cloud Asset Inventory Resource Name - // Format](https://cloud.google.com/asset-inventory/docs/resource-name-fo - // rmat) for more information. To search against the `resource`: * use a - // field query. Example: `resource:organizations/123` + // s/instance1`. See Cloud Asset Inventory Resource Name Format for more + // information. To search against the `resource`: * use a field query. + // Example: `resource:organizations/123` Resource string `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "Explanation") to @@ -2546,11 +2508,10 @@ func (s *IamPolicySearchResult) MarshalJSON() ([]byte, error) { // resource access, based on roles assigned either directly to them or // to the groups they belong to, directly or indirectly. type IdentitySelector struct { - // Identity: Required. The identity appear in the form of members in - // [IAM policy - // binding](https://cloud.google.com/iam/reference/rest/v1/Binding). The - // examples of supported forms are: "user:mike@example.com", - // "group:admins@example.com", "domain:google.com", + // Identity: Required. The identity appear in the form of members in IAM + // policy binding. The examples of supported forms are: + // "user:mike@example.com", "group:admins@example.com", + // "domain:google.com", // "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice // that wildcard characters (such as * and ?) are not supported. You // must give a specific identity. @@ -3028,9 +2989,8 @@ func (s *Permissions) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -3048,8 +3008,8 @@ func (s *Permissions) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -3088,9 +3048,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to @@ -3170,12 +3129,9 @@ type Resource struct { Location string `json:"location,omitempty"` // Parent: The full name of the immediate parent of this resource. See - // [Resource - // Names](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. For Google Cloud assets, this value is - // the parent resource defined in the [Cloud IAM policy - // hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy - // ). Example: + // Resource Names for more information. For Google Cloud assets, this + // value is the parent resource defined in the Cloud IAM policy + // hierarchy. Example: // `//cloudresourcemanager.googleapis.com/projects/my_project_123` For // third-party assets, this field may be set differently. Parent string `json:"parent,omitempty"` @@ -3220,15 +3176,13 @@ type ResourceSearchResult struct { // Examples: `projectId` for Project, `dnsName` for DNS ManagedZone. // This field contains a subset of the resource metadata fields that are // returned by the List or Get APIs provided by the corresponding GCP - // service (e.g., Compute Engine). see [API references and supported - // searchable - // attributes](https://cloud.google.com/asset-inventory/docs/supported-as - // set-types#searchable_asset_types) for more information. You can - // search values of these fields through free text search. However, you - // should not consume the field programically as the field names and - // values may change as the GCP service updates to a new incompatible - // API version. To search against the `additional_attributes`: * use a - // free text query to match the attributes values. Example: to search + // service (e.g., Compute Engine). see API references and supported + // searchable attributes for more information. You can search values of + // these fields through free text search. However, you should not + // consume the field programically as the field names and values may + // change as the GCP service updates to a new incompatible API version. + // To search against the `additional_attributes`: * use a free text + // query to match the attributes values. Example: to search // `additional_attributes = { dnsName: "foobar" }`, you can issue a // query `foobar`. AdditionalAttributes googleapi.RawMessage `json:"additionalAttributes,omitempty"` @@ -3250,15 +3204,12 @@ type ResourceSearchResult struct { // Instance" * use a free text query. Example: "My Instance" DisplayName string `json:"displayName,omitempty"` - // Labels: Labels associated with this resource. See [Labelling and - // grouping GCP - // resources](https://cloud.google.com/blog/products/gcp/labelling-and-gr - // ouping-your-google-cloud-platform-resources) for more information. To - // search against the `labels`: * use a field query: - query on any - // label's key or value. Example: `labels:prod` - query by a given - // label. Example: `labels.env:prod` - query by a given label's - // existence. Example: `labels.env:*` * use a free text query. Example: - // `prod` + // Labels: Labels associated with this resource. See Labelling and + // grouping GCP resources for more information. To search against the + // `labels`: * use a field query: - query on any label's key or value. + // Example: `labels:prod` - query by a given label. Example: + // `labels.env:prod` - query by a given label's existence. Example: + // `labels.env:*` * use a free text query. Example: `prod` Labels map[string]string `json:"labels,omitempty"` // Location: Location can be `global`, regional like `us-east1`, or @@ -3269,19 +3220,16 @@ type ResourceSearchResult struct { // Name: The full resource name of this resource. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1`. See [Cloud Asset Inventory Resource Name - // Format](https://cloud.google.com/asset-inventory/docs/resource-name-fo - // rmat) for more information. To search against the `name`: * use a - // field query. Example: `name:instance1` * use a free text query. - // Example: `instance1` + // s/instance1`. See Cloud Asset Inventory Resource Name Format for more + // information. To search against the `name`: * use a field query. + // Example: `name:instance1` * use a free text query. Example: + // `instance1` Name string `json:"name,omitempty"` // NetworkTags: Network tags associated with this resource. Like labels, // network tags are a type of annotations used to group GCP resources. - // See [Labelling GCP - // resources](https://cloud.google.com/blog/products/gcp/labelling-and-gr - // ouping-your-google-cloud-platform-resources) for more information. To - // search against the `network_tags`: * use a field query. Example: + // See Labelling GCP resources for more information. To search against + // the `network_tags`: * use a field query. Example: // `networkTags:internal` * use a free text query. Example: `internal` NetworkTags []string `json:"networkTags,omitempty"` @@ -3321,9 +3269,7 @@ func (s *ResourceSearchResult) MarshalJSON() ([]byte, error) { type ResourceSelector struct { // FullResourceName: Required. The [full resource name] // (https://cloud.google.com/asset-inventory/docs/resource-name-format) - // of a resource of [supported resource - // types](https://cloud.google.com/asset-inventory/docs/supported-asset-t - // ypes#analyzable_asset_types). + // of a resource of supported resource types. FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "FullResourceName") to @@ -3491,11 +3437,10 @@ func (s *SoftwarePackage) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4743,9 +4688,8 @@ func (c *V1AnalyzeIamPolicyCall) AnalysisQueryAccessSelectorRoles(analysisQueryA // AnalysisQueryIdentitySelectorIdentity sets the optional parameter // "analysisQuery.identitySelector.identity": Required. The identity -// appear in the form of members in [IAM policy -// binding](https://cloud.google.com/iam/reference/rest/v1/Binding). The -// examples of supported forms are: "user:mike@example.com", +// appear in the form of members in IAM policy binding. The examples of +// supported forms are: "user:mike@example.com", // "group:admins@example.com", "domain:google.com", // "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice // that wildcard characters (such as * and ?) are not supported. You @@ -4849,9 +4793,7 @@ func (c *V1AnalyzeIamPolicyCall) AnalysisQueryOptionsOutputResourceEdges(analysi // parameter "analysisQuery.resourceSelector.fullResourceName": // Required. The [full resource name] // (https://cloud.google.com/asset-inventory/docs/resource-name-format) -// of a resource of [supported resource -// types](https://cloud.google.com/asset-inventory/docs/supported-asset-t -// ypes#analyzable_asset_types). +// of a resource of supported resource types. func (c *V1AnalyzeIamPolicyCall) AnalysisQueryResourceSelectorFullResourceName(analysisQueryResourceSelectorFullResourceName string) *V1AnalyzeIamPolicyCall { c.urlParams_.Set("analysisQuery.resourceSelector.fullResourceName", analysisQueryResourceSelectorFullResourceName) return c @@ -4859,11 +4801,10 @@ func (c *V1AnalyzeIamPolicyCall) AnalysisQueryResourceSelectorFullResourceName(a // ExecutionTimeout sets the optional parameter "executionTimeout": // Amount of time executable has to complete. See JSON representation of -// [Duration](https://developers.google.com/protocol-buffers/docs/proto3# -// json). If this field is set with a value less than the RPC deadline, -// and the execution of your query hasn't finished in the specified -// execution timeout, you will get a response with partial result. -// Otherwise, your query's execution will continue until the RPC +// Duration. If this field is set with a value less than the RPC +// deadline, and the execution of your query hasn't finished in the +// specified execution timeout, you will get a response with partial +// result. Otherwise, your query's execution will continue until the RPC // deadline. If it's not finished until then, you will get a // DEADLINE_EXCEEDED error. Default is empty. func (c *V1AnalyzeIamPolicyCall) ExecutionTimeout(executionTimeout string) *V1AnalyzeIamPolicyCall { @@ -5630,12 +5571,10 @@ func (c *V1SearchAllIamPoliciesCall) PageToken(pageToken string) *V1SearchAllIam } // Query sets the optional parameter "query": The query statement. See -// [how to construct a -// query](https://cloud.google.com/asset-inventory/docs/searching-iam-pol -// icies#how_to_construct_a_query) for more information. If not -// specified or empty, it will search all the IAM policies within the -// specified `scope`. Examples: * `policy:amy@gmail.com` to find IAM -// policy bindings that specify user "amy@gmail.com". * +// how to construct a query for more information. If not specified or +// empty, it will search all the IAM policies within the specified +// `scope`. Examples: * `policy:amy@gmail.com` to find IAM policy +// bindings that specify user "amy@gmail.com". * // `policy:roles/compute.admin` to find IAM policy bindings that specify // the Compute Admin role. * // `policy.role.permissions:storage.buckets.update` to find IAM policy @@ -5843,9 +5782,7 @@ func (r *V1Service) SearchAllResources(scope string) *V1SearchAllResourcesCall { // AssetTypes sets the optional parameter "assetTypes": A list of asset // types that this request searches for. If empty, it will search all -// the [searchable asset -// types](https://cloud.google.com/asset-inventory/docs/supported-asset-t -// ypes#searchable_asset_types). +// the searchable asset types. func (c *V1SearchAllResourcesCall) AssetTypes(assetTypes ...string) *V1SearchAllResourcesCall { c.urlParams_.SetMulti("assetTypes", append([]string{}, assetTypes...)) return c @@ -5887,19 +5824,16 @@ func (c *V1SearchAllResourcesCall) PageToken(pageToken string) *V1SearchAllResou } // Query sets the optional parameter "query": The query statement. See -// [how to construct a -// query](http://cloud.google.com/asset-inventory/docs/searching-resource -// s#how_to_construct_a_query) for more information. If not specified or +// how to construct a query for more information. If not specified or // empty, it will search all the resources within the specified `scope`. // Note that the query string is compared against each Cloud IAM policy // binding, including its members, roles, and Cloud IAM conditions. The // returned Cloud IAM policies will only contain the bindings that match -// your query. To learn more about the IAM policy structure, see [IAM -// policy doc](https://cloud.google.com/iam/docs/policies#structure). -// Examples: * `name:Important` to find Cloud resources whose name -// contains "Important" as a word. * `displayName:Impor*` to find Cloud -// resources whose display name contains "Impor" as a prefix. * -// `description:*por*` to find Cloud resources whose description +// your query. To learn more about the IAM policy structure, see IAM +// policy doc. Examples: * `name:Important` to find Cloud resources +// whose name contains "Important" as a word. * `displayName:Impor*` to +// find Cloud resources whose display name contains "Impor" as a prefix. +// * `description:*por*` to find Cloud resources whose description // contains "por" as a substring. * `location:us-west*` to find Cloud // resources whose location is prefixed with "us-west". * `labels:prod` // to find Cloud resources whose labels contain "prod" as a key or diff --git a/cloudasset/v1beta1/cloudasset-gen.go b/cloudasset/v1beta1/cloudasset-gen.go index 1485ec4e382..6cea0e2e9c7 100644 --- a/cloudasset/v1beta1/cloudasset-gen.go +++ b/cloudasset/v1beta1/cloudasset-gen.go @@ -205,28 +205,20 @@ type ProjectsOperationsService struct { } // Asset: An asset in Google Cloud. An asset can be any resource in the -// Google Cloud [resource -// hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platfo -// rm-resource-hierarchy), a resource outside the Google Cloud resource -// hierarchy (such as Google Kubernetes Engine clusters and objects), or -// a policy (e.g. Cloud IAM policy). See [Supported asset -// types](https://cloud.google.com/asset-inventory/docs/supported-asset-t -// ypes) for more information. +// Google Cloud resource hierarchy, a resource outside the Google Cloud +// resource hierarchy (such as Google Kubernetes Engine clusters and +// objects), or a policy (e.g. Cloud IAM policy). See Supported asset +// types for more information. type Asset struct { - // AccessLevel: Please also refer to the [access level user - // guide](https://cloud.google.com/access-context-manager/docs/overview#a - // ccess-levels). + // AccessLevel: Please also refer to the access level user guide. AccessLevel *GoogleIdentityAccesscontextmanagerV1AccessLevel `json:"accessLevel,omitempty"` - // AccessPolicy: Please also refer to the [access policy user - // guide](https://cloud.google.com/access-context-manager/docs/overview#a - // ccess-policies). + // AccessPolicy: Please also refer to the access policy user guide. AccessPolicy *GoogleIdentityAccesscontextmanagerV1AccessPolicy `json:"accessPolicy,omitempty"` // AssetType: The type of the asset. Example: - // `compute.googleapis.com/Disk` See [Supported asset - // types](https://cloud.google.com/asset-inventory/docs/supported-asset-t - // ypes) for more information. + // `compute.googleapis.com/Disk` See Supported asset types for more + // information. AssetType string `json:"assetType,omitempty"` // IamPolicy: A representation of the Cloud IAM policy set on a Google @@ -235,30 +227,25 @@ type Asset struct { // granted access scope from any policies set on parent resources in the // resource hierarchy. Therefore, the effectively policy is the union of // both the policy set on this resource and each policy set on all of - // the resource's ancestry resource levels in the hierarchy. See [this - // topic](https://cloud.google.com/iam/docs/policies#inheritance) for - // more information. + // the resource's ancestry resource levels in the hierarchy. See this + // topic for more information. IamPolicy *Policy `json:"iamPolicy,omitempty"` // Name: The full name of the asset. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1` See [Resource - // names](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. + // s/instance1` See Resource names for more information. Name string `json:"name,omitempty"` - // OrgPolicy: A representation of an [organization - // policy](https://cloud.google.com/resource-manager/docs/organization-po - // licy/overview#organization_policy). There can be more than one - // organization policy with different constraints set on a given - // resource. + // OrgPolicy: A representation of an organization policy. There can be + // more than one organization policy with different constraints set on a + // given resource. OrgPolicy []*GoogleCloudOrgpolicyV1Policy `json:"orgPolicy,omitempty"` // Resource: A representation of the resource. Resource *Resource `json:"resource,omitempty"` - // ServicePerimeter: Please also refer to the [service perimeter user - // guide](https://cloud.google.com/vpc-service-controls/docs/overview). + // ServicePerimeter: Please also refer to the service perimeter user + // guide. ServicePerimeter *GoogleIdentityAccesscontextmanagerV1ServicePerimeter `json:"servicePerimeter,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to @@ -421,9 +408,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -491,9 +476,8 @@ func (s *Binding) MarshalJSON() ([]byte, error) { type ExportAssetsRequest struct { // AssetTypes: A list of asset types of which to take a snapshot for. // For example: "google.compute.Disk". If specified, only matching - // assets will be returned. See [Introduction to Cloud Asset - // Inventory](https://cloud.google.com/resource-manager/docs/cloud-asset- - // inventory/overview) for all supported asset types. + // assets will be returned. See Introduction to Cloud Asset Inventory + // for all supported asset types. AssetTypes []string `json:"assetTypes,omitempty"` // ContentType: Asset content type. If not specified, no content but the @@ -604,9 +588,7 @@ func (s *Expr) MarshalJSON() ([]byte, error) { type GcsDestination struct { // Uri: The uri of the Cloud Storage object. It's the same uri that is // used by gsutil. For example: "gs://bucket_name/object_name". See - // [Viewing and Editing Object - // Metadata](https://cloud.google.com/storage/docs/viewing-editing-metada - // ta) for more information. + // Viewing and Editing Object Metadata for more information. Uri string `json:"uri,omitempty"` // UriPrefix: The uri prefix of all generated Cloud Storage objects. For @@ -840,9 +822,8 @@ type GoogleCloudOrgpolicyV1Policy struct { BooleanPolicy *GoogleCloudOrgpolicyV1BooleanPolicy `json:"booleanPolicy,omitempty"` // Constraint: The name of the `Constraint` the `Policy` is configuring, - // for example, `constraints/serviceuser.services`. A [list of available - // constraints](/resource-manager/docs/organization-policy/org-policy-con - // straints) is available. Immutable after creation. + // for example, `constraints/serviceuser.services`. A list of available + // constraints is available. Immutable after creation. Constraint string `json:"constraint,omitempty"` // Etag: An opaque tag indicating the current version of the `Policy`, @@ -1561,9 +1542,8 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1581,8 +1561,8 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1621,9 +1601,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to @@ -1669,12 +1648,9 @@ type Resource struct { DiscoveryName string `json:"discoveryName,omitempty"` // Parent: The full name of the immediate parent of this resource. See - // [Resource - // Names](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. For Google Cloud assets, this value is - // the parent resource defined in the [Cloud IAM policy - // hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy - // ). Example: + // Resource Names for more information. For Google Cloud assets, this + // value is the parent resource defined in the Cloud IAM policy + // hierarchy. Example: // `//cloudresourcemanager.googleapis.com/projects/my_project_123` For // third-party assets, this field may be set differently. Parent string `json:"parent,omitempty"` @@ -1713,11 +1689,10 @@ func (s *Resource) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2143,11 +2118,9 @@ func (r *OrganizationsService) BatchGetAssetsHistory(parent string) *Organizatio // AssetNames sets the optional parameter "assetNames": A list of the // full names of the assets. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance -// s/instance1`. See [Resource -// Names](https://cloud.google.com/apis/design/resource_names#full_resour -// ce_name) for more info. The request becomes a no-op if the asset name -// list is empty, and the max size of the asset name list is 100 in one -// request. +// s/instance1`. See Resource Names for more info. The request becomes a +// no-op if the asset name list is empty, and the max size of the asset +// name list is 100 in one request. func (c *OrganizationsBatchGetAssetsHistoryCall) AssetNames(assetNames ...string) *OrganizationsBatchGetAssetsHistoryCall { c.urlParams_.SetMulti("assetNames", append([]string{}, assetNames...)) return c @@ -2659,11 +2632,9 @@ func (r *ProjectsService) BatchGetAssetsHistory(parent string) *ProjectsBatchGet // AssetNames sets the optional parameter "assetNames": A list of the // full names of the assets. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance -// s/instance1`. See [Resource -// Names](https://cloud.google.com/apis/design/resource_names#full_resour -// ce_name) for more info. The request becomes a no-op if the asset name -// list is empty, and the max size of the asset name list is 100 in one -// request. +// s/instance1`. See Resource Names for more info. The request becomes a +// no-op if the asset name list is empty, and the max size of the asset +// name list is 100 in one request. func (c *ProjectsBatchGetAssetsHistoryCall) AssetNames(assetNames ...string) *ProjectsBatchGetAssetsHistoryCall { c.urlParams_.SetMulti("assetNames", append([]string{}, assetNames...)) return c diff --git a/cloudasset/v1p1beta1/cloudasset-gen.go b/cloudasset/v1p1beta1/cloudasset-gen.go index 6dd0edfe411..9aff2b24620 100644 --- a/cloudasset/v1p1beta1/cloudasset-gen.go +++ b/cloudasset/v1p1beta1/cloudasset-gen.go @@ -261,9 +261,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -443,9 +441,8 @@ type IamPolicySearchResult struct { // empty. Project string `json:"project,omitempty"` - // Resource: The [full resource - // name](https://cloud.google.com/apis/design/resource_names#full_resourc - // e_name) of the resource associated with this IAM policy. + // Resource: The full resource name of the resource associated with this + // IAM policy. Resource string `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "Explanation") to @@ -511,9 +508,8 @@ func (s *Permissions) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -531,8 +527,8 @@ func (s *Permissions) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -571,9 +567,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to @@ -694,10 +689,8 @@ type StandardResourceMetadata struct { // DisplayName: The display name of this resource. DisplayName string `json:"displayName,omitempty"` - // Labels: Labels associated with this resource. See [Labelling and - // grouping GCP - // resources](https://cloud.google.com/blog/products/gcp/labelling-and-gr - // ouping-your-google-cloud-platform-resources) for more information. + // Labels: Labels associated with this resource. See Labelling and + // grouping GCP resources for more information. Labels map[string]string `json:"labels,omitempty"` // Location: Location can be "global", regional like "us-east1", or @@ -706,16 +699,12 @@ type StandardResourceMetadata struct { // Name: The full resource name. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1`. See [Resource - // Names](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. + // s/instance1`. See Resource Names for more information. Name string `json:"name,omitempty"` // NetworkTags: Network tags associated with this resource. Like labels, // network tags are a type of annotations used to group GCP resources. - // See [Labelling GCP - // resources](lhttps://cloud.google.com/blog/products/gcp/labelling-and-g - // rouping-your-google-cloud-platform-resources) for more information. + // See Labelling GCP resources for more information. NetworkTags []string `json:"networkTags,omitempty"` // Project: The project that this resource belongs to, in the form of diff --git a/cloudasset/v1p4beta1/cloudasset-gen.go b/cloudasset/v1p4beta1/cloudasset-gen.go index dd7b64d8fa8..12b4070cc58 100644 --- a/cloudasset/v1p4beta1/cloudasset-gen.go +++ b/cloudasset/v1p4beta1/cloudasset-gen.go @@ -236,9 +236,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -680,9 +678,8 @@ type GoogleCloudAssetV1p4beta1Identity struct { // AnalysisState: The analysis state of this identity. AnalysisState *GoogleCloudAssetV1p4beta1AnalysisState `json:"analysisState,omitempty"` - // Name: The identity name in any form of members appear in [IAM policy - // binding](https://cloud.google.com/iam/reference/rest/v1/Binding), - // such as: - user:foo@google.com - group:group1@google.com - + // Name: The identity name in any form of members appear in IAM policy + // binding, such as: - user:foo@google.com - group:group1@google.com - // serviceAccount:s1@prj1.iam.gserviceaccount.com - // projectOwner:some_project_id - domain:google.com - allUsers - etc. Name string `json:"name,omitempty"` @@ -754,9 +751,7 @@ type GoogleCloudAssetV1p4beta1Resource struct { // AnalysisState: The analysis state of this resource. AnalysisState *GoogleCloudAssetV1p4beta1AnalysisState `json:"analysisState,omitempty"` - // FullResourceName: The [full resource - // name](https://cloud.google.com/asset-inventory/docs/resource-name-form - // at) + // FullResourceName: The full resource name FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "AnalysisState") to @@ -863,12 +858,8 @@ type IamPolicyAnalysisQuery struct { // an organization number (such as "organizations/123"), a folder number // (such as "folders/123"), a project ID (such as // "projects/my-project-id"), or a project number (such as - // "projects/12345"). To know how to get organization id, visit [here - // ](https://cloud.google.com/resource-manager/docs/creating-managing-org - // anization#retrieving_your_organization_id). To know how to get folder - // or project id, visit [here - // ](https://cloud.google.com/resource-manager/docs/creating-managing-fol - // ders#viewing_or_listing_folders_and_projects). + // "projects/12345"). To know how to get organization id, visit here . + // To know how to get folder or project id, visit here . Parent string `json:"parent,omitempty"` // ResourceSelector: Optional. Specifies a resource for analysis. @@ -906,9 +897,8 @@ type IamPolicyAnalysisResult struct { // selectors specified in the request. AccessControlLists []*GoogleCloudAssetV1p4beta1AccessControlList `json:"accessControlLists,omitempty"` - // AttachedResourceFullName: The [full resource - // name](https://cloud.google.com/asset-inventory/docs/resource-name-form - // at) of the resource to which the iam_binding policy attaches. + // AttachedResourceFullName: The full resource name of the resource to + // which the iam_binding policy attaches. AttachedResourceFullName string `json:"attachedResourceFullName,omitempty"` // FullyExplored: Represents whether all analyses on the iam_binding @@ -951,11 +941,10 @@ func (s *IamPolicyAnalysisResult) MarshalJSON() ([]byte, error) { // resource access, based on roles assigned either directly to them or // to the groups they belong to, directly or indirectly. type IdentitySelector struct { - // Identity: Required. The identity appear in the form of members in - // [IAM policy - // binding](https://cloud.google.com/iam/reference/rest/v1/Binding). The - // examples of supported forms are: "user:mike@example.com", - // "group:admins@example.com", "domain:google.com", + // Identity: Required. The identity appear in the form of members in IAM + // policy binding. The examples of supported forms are: + // "user:mike@example.com", "group:admins@example.com", + // "domain:google.com", // "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice // that wildcard characters (such as * and ?) are not supported. You // must give a specific identity. @@ -1133,11 +1122,8 @@ func (s *Options) MarshalJSON() ([]byte, error) { // policies, which may be set directly on the resource, or on ancestors // such as organizations, folders or projects. type ResourceSelector struct { - // FullResourceName: Required. The [full resource - // name](https://cloud.google.com/asset-inventory/docs/resource-name-form - // at) of a resource of [supported resource - // types](https://cloud.google.com/asset-inventory/docs/supported-asset-t - // ypes#analyzable_asset_types). + // FullResourceName: Required. The full resource name of a resource of + // supported resource types. FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "FullResourceName") to @@ -1166,11 +1152,10 @@ func (s *ResourceSelector) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1244,9 +1229,8 @@ func (c *V1p4beta1AnalyzeIamPolicyCall) AnalysisQueryAccessSelectorRoles(analysi // AnalysisQueryIdentitySelectorIdentity sets the optional parameter // "analysisQuery.identitySelector.identity": Required. The identity -// appear in the form of members in [IAM policy -// binding](https://cloud.google.com/iam/reference/rest/v1/Binding). The -// examples of supported forms are: "user:mike@example.com", +// appear in the form of members in IAM policy binding. The examples of +// supported forms are: "user:mike@example.com", // "group:admins@example.com", "domain:google.com", // "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice // that wildcard characters (such as * and ?) are not supported. You @@ -1258,11 +1242,8 @@ func (c *V1p4beta1AnalyzeIamPolicyCall) AnalysisQueryIdentitySelectorIdentity(an // AnalysisQueryResourceSelectorFullResourceName sets the optional // parameter "analysisQuery.resourceSelector.fullResourceName": -// Required. The [full resource -// name](https://cloud.google.com/asset-inventory/docs/resource-name-form -// at) of a resource of [supported resource -// types](https://cloud.google.com/asset-inventory/docs/supported-asset-t -// ypes#analyzable_asset_types). +// Required. The full resource name of a resource of supported resource +// types. func (c *V1p4beta1AnalyzeIamPolicyCall) AnalysisQueryResourceSelectorFullResourceName(analysisQueryResourceSelectorFullResourceName string) *V1p4beta1AnalyzeIamPolicyCall { c.urlParams_.Set("analysisQuery.resourceSelector.fullResourceName", analysisQueryResourceSelectorFullResourceName) return c @@ -1297,14 +1278,12 @@ func (c *V1p4beta1AnalyzeIamPolicyCall) OptionsAnalyzeServiceAccountImpersonatio // OptionsExecutionTimeout sets the optional parameter // "options.executionTimeout": Amount of time executable has to -// complete. See JSON representation of -// [Duration](https://developers.google.com/protocol-buffers/docs/proto3# -// json). If this field is set with a value less than the RPC deadline, -// and the execution of your query hasn't finished in the specified -// execution timeout, you will get a response with partial result. -// Otherwise, your query's execution will continue until the RPC -// deadline. If it's not finished until then, you will get a -// DEADLINE_EXCEEDED error. Default is empty. +// complete. See JSON representation of Duration. If this field is set +// with a value less than the RPC deadline, and the execution of your +// query hasn't finished in the specified execution timeout, you will +// get a response with partial result. Otherwise, your query's execution +// will continue until the RPC deadline. If it's not finished until +// then, you will get a DEADLINE_EXCEEDED error. Default is empty. func (c *V1p4beta1AnalyzeIamPolicyCall) OptionsExecutionTimeout(optionsExecutionTimeout string) *V1p4beta1AnalyzeIamPolicyCall { c.urlParams_.Set("options.executionTimeout", optionsExecutionTimeout) return c diff --git a/cloudasset/v1p5beta1/cloudasset-gen.go b/cloudasset/v1p5beta1/cloudasset-gen.go index 2dc6c22dc6d..571589433af 100644 --- a/cloudasset/v1p5beta1/cloudasset-gen.go +++ b/cloudasset/v1p5beta1/cloudasset-gen.go @@ -145,38 +145,28 @@ type AssetsService struct { } // Asset: An asset in Google Cloud. An asset can be any resource in the -// Google Cloud [resource -// hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platfo -// rm-resource-hierarchy), a resource outside the Google Cloud resource -// hierarchy (such as Google Kubernetes Engine clusters and objects), or -// a policy (e.g. Cloud IAM policy). See [Supported asset -// types](https://cloud.google.com/asset-inventory/docs/supported-asset-t -// ypes) for more information. +// Google Cloud resource hierarchy, a resource outside the Google Cloud +// resource hierarchy (such as Google Kubernetes Engine clusters and +// objects), or a policy (e.g. Cloud IAM policy). See Supported asset +// types for more information. type Asset struct { - // AccessLevel: Please also refer to the [access level user - // guide](https://cloud.google.com/access-context-manager/docs/overview#a - // ccess-levels). + // AccessLevel: Please also refer to the access level user guide. AccessLevel *GoogleIdentityAccesscontextmanagerV1AccessLevel `json:"accessLevel,omitempty"` - // AccessPolicy: Please also refer to the [access policy user - // guide](https://cloud.google.com/access-context-manager/docs/overview#a - // ccess-policies). + // AccessPolicy: Please also refer to the access policy user guide. AccessPolicy *GoogleIdentityAccesscontextmanagerV1AccessPolicy `json:"accessPolicy,omitempty"` - // Ancestors: The ancestry path of an asset in Google Cloud [resource - // hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platfo - // rm-resource-hierarchy), represented as a list of relative resource - // names. An ancestry path starts with the closest ancestor in the - // hierarchy and ends at root. If the asset is a project, folder, or - // organization, the ancestry path starts from the asset itself. - // Example: `["projects/123456789", "folders/5432", - // "organizations/1234"]` + // Ancestors: The ancestry path of an asset in Google Cloud resource + // hierarchy, represented as a list of relative resource names. An + // ancestry path starts with the closest ancestor in the hierarchy and + // ends at root. If the asset is a project, folder, or organization, the + // ancestry path starts from the asset itself. Example: + // `["projects/123456789", "folders/5432", "organizations/1234"]` Ancestors []string `json:"ancestors,omitempty"` // AssetType: The type of the asset. Example: - // `compute.googleapis.com/Disk` See [Supported asset - // types](https://cloud.google.com/asset-inventory/docs/supported-asset-t - // ypes) for more information. + // `compute.googleapis.com/Disk` See Supported asset types for more + // information. AssetType string `json:"assetType,omitempty"` // IamPolicy: A representation of the Cloud IAM policy set on a Google @@ -185,30 +175,25 @@ type Asset struct { // granted access scope from any policies set on parent resources in the // resource hierarchy. Therefore, the effectively policy is the union of // both the policy set on this resource and each policy set on all of - // the resource's ancestry resource levels in the hierarchy. See [this - // topic](https://cloud.google.com/iam/docs/policies#inheritance) for - // more information. + // the resource's ancestry resource levels in the hierarchy. See this + // topic for more information. IamPolicy *Policy `json:"iamPolicy,omitempty"` // Name: The full name of the asset. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1` See [Resource - // names](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. + // s/instance1` See Resource names for more information. Name string `json:"name,omitempty"` - // OrgPolicy: A representation of an [organization - // policy](https://cloud.google.com/resource-manager/docs/organization-po - // licy/overview#organization_policy). There can be more than one - // organization policy with different constraints set on a given - // resource. + // OrgPolicy: A representation of an organization policy. There can be + // more than one organization policy with different constraints set on a + // given resource. OrgPolicy []*GoogleCloudOrgpolicyV1Policy `json:"orgPolicy,omitempty"` // Resource: A representation of the resource. Resource *Resource `json:"resource,omitempty"` - // ServicePerimeter: Please also refer to the [service perimeter user - // guide](https://cloud.google.com/vpc-service-controls/docs/overview). + // ServicePerimeter: Please also refer to the service perimeter user + // guide. ServicePerimeter *GoogleIdentityAccesscontextmanagerV1ServicePerimeter `json:"servicePerimeter,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to @@ -339,9 +324,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -663,9 +646,8 @@ type GoogleCloudOrgpolicyV1Policy struct { BooleanPolicy *GoogleCloudOrgpolicyV1BooleanPolicy `json:"booleanPolicy,omitempty"` // Constraint: The name of the `Constraint` the `Policy` is configuring, - // for example, `constraints/serviceuser.services`. A [list of available - // constraints](/resource-manager/docs/organization-policy/org-policy-con - // straints) is available. Immutable after creation. + // for example, `constraints/serviceuser.services`. A list of available + // constraints is available. Immutable after creation. Constraint string `json:"constraint,omitempty"` // Etag: An opaque tag indicating the current version of the `Policy`, @@ -1332,9 +1314,8 @@ func (s *ListAssetsResponse) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1352,8 +1333,8 @@ func (s *ListAssetsResponse) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1392,9 +1373,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to @@ -1440,12 +1420,9 @@ type Resource struct { DiscoveryName string `json:"discoveryName,omitempty"` // Parent: The full name of the immediate parent of this resource. See - // [Resource - // Names](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. For Google Cloud assets, this value is - // the parent resource defined in the [Cloud IAM policy - // hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy - // ). Example: + // Resource Names for more information. For Google Cloud assets, this + // value is the parent resource defined in the Cloud IAM policy + // hierarchy. Example: // `//cloudresourcemanager.googleapis.com/projects/my_project_123` For // third-party assets, this field may be set differently. Parent string `json:"parent,omitempty"` @@ -1508,14 +1485,12 @@ func (r *AssetsService) List(parent string) *AssetsListCall { // asset type starts with "compute.googleapis.com". * ".*Instance" // snapshots resources whose asset type ends with "Instance". * // ".*Instance.*" snapshots resources whose asset type contains -// "Instance". See [RE2](https://github.com/google/re2/wiki/Syntax) for -// all supported regular expression syntax. If the regular expression -// does not match any supported asset type, an INVALID_ARGUMENT error -// will be returned. If specified, only matching assets will be -// returned, otherwise, it will snapshot all asset types. See -// [Introduction to Cloud Asset -// Inventory](https://cloud.google.com/asset-inventory/docs/overview) -// for all supported asset types. +// "Instance". See RE2 for all supported regular expression syntax. If +// the regular expression does not match any supported asset type, an +// INVALID_ARGUMENT error will be returned. If specified, only matching +// assets will be returned, otherwise, it will snapshot all asset types. +// See Introduction to Cloud Asset Inventory for all supported asset +// types. func (c *AssetsListCall) AssetTypes(assetTypes ...string) *AssetsListCall { c.urlParams_.SetMulti("assetTypes", append([]string{}, assetTypes...)) return c diff --git a/cloudbilling/v1/cloudbilling-gen.go b/cloudbilling/v1/cloudbilling-gen.go index dfe029bb6c8..9e73a6b2508 100644 --- a/cloudbilling/v1/cloudbilling-gen.go +++ b/cloudbilling/v1/cloudbilling-gen.go @@ -345,19 +345,17 @@ func (s *AuditLogConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// BillingAccount: A billing account in the [Google Cloud -// Console](https://console.cloud.google.com/). You can assign a billing -// account to one or more projects. +// BillingAccount: A billing account in the Google Cloud Console. You +// can assign a billing account to one or more projects. type BillingAccount struct { // DisplayName: The display name given to the billing account, such as // `My Billing Account`. This name is displayed in the Google Cloud // Console. DisplayName string `json:"displayName,omitempty"` - // MasterBillingAccount: If this account is a - // [subaccount](https://cloud.google.com/billing/docs/concepts), then - // this will be the resource name of the master billing account that it - // is being resold through. Otherwise this will be empty. + // MasterBillingAccount: If this account is a subaccount, then this will + // be the resource name of the master billing account that it is being + // resold through. Otherwise this will be empty. MasterBillingAccount string `json:"masterBillingAccount,omitempty"` // Name: Output only. The resource name of the billing account. The @@ -407,9 +405,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -823,9 +819,8 @@ func (s *Money) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -843,8 +838,8 @@ func (s *Money) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -883,9 +878,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1263,8 +1257,7 @@ func (s *Sku) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1385,15 +1378,12 @@ type BillingAccountsCreateCall struct { } // Create: Creates a billing account. This method can only be used to -// create [billing -// subaccounts](https://cloud.google.com/billing/docs/concepts) by -// Google Cloud resellers. When creating a subaccount, the current -// authenticated user must have the `billing.accounts.update` IAM -// permission on the master account, which is typically given to billing -// account -// [administrators](https://cloud.google.com/billing/docs/how-to/billing- -// access). This method will return an error if the master account has -// not been provisioned as a reseller account. +// create billing subaccounts by Google Cloud resellers. When creating a +// subaccount, the current authenticated user must have the +// `billing.accounts.update` IAM permission on the master account, which +// is typically given to billing account administrators. This method +// will return an error if the master account has not been provisioned +// as a reseller account. func (r *BillingAccountsService) Create(billingaccount *BillingAccount) *BillingAccountsCreateCall { c := &BillingAccountsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.billingaccount = billingaccount @@ -1521,8 +1511,7 @@ type BillingAccountsGetCall struct { } // Get: Gets information about a billing account. The current -// authenticated user must be a [viewer of the billing -// account](https://cloud.google.com/billing/docs/how-to/billing-access). +// authenticated user must be a viewer of the billing account. func (r *BillingAccountsService) Get(name string) *BillingAccountsGetCall { c := &BillingAccountsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -1670,9 +1659,7 @@ type BillingAccountsGetIamPolicyCall struct { // GetIamPolicy: Gets the access control policy for a billing account. // The caller must have the `billing.accounts.getIamPolicy` permission -// on the account, which is often given to billing account -// [viewers](https://cloud.google.com/billing/docs/how-to/billing-access) -// . +// on the account, which is often given to billing account viewers. func (r *BillingAccountsService) GetIamPolicy(resource string) *BillingAccountsGetIamPolicyCall { c := &BillingAccountsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -1686,9 +1673,7 @@ func (r *BillingAccountsService) GetIamPolicy(resource string) *BillingAccountsG // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *BillingAccountsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *BillingAccountsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -1839,8 +1824,7 @@ type BillingAccountsListCall struct { } // List: Lists the billing accounts that the current authenticated user -// has permission to -// [view](https://cloud.google.com/billing/docs/how-to/billing-access). +// has permission to view. func (r *BillingAccountsService) List() *BillingAccountsListCall { c := &BillingAccountsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -1848,9 +1832,8 @@ func (r *BillingAccountsService) List() *BillingAccountsListCall { // Filter sets the optional parameter "filter": Options for how to // filter the returned billing accounts. Currently this only supports -// filtering for -// [subaccounts](https://cloud.google.com/billing/docs/concepts) under a -// single provided reseller billing account. (e.g. +// filtering for subaccounts under a single provided reseller billing +// account. (e.g. // "master_billing_account=billingAccounts/012345-678901-ABCDEF"). // Boolean algebra and other fields are not currently supported. func (c *BillingAccountsListCall) Filter(filter string) *BillingAccountsListCall { @@ -2042,9 +2025,7 @@ type BillingAccountsPatchCall struct { // Patch: Updates a billing account's fields. Currently the only field // that can be edited is `display_name`. The current authenticated user // must have the `billing.accounts.update` IAM permission, which is -// typically given to the -// [administrator](https://cloud.google.com/billing/docs/how-to/billing-a -// ccess) of the billing account. +// typically given to the administrator of the billing account. func (r *BillingAccountsService) Patch(name string, billingaccount *BillingAccount) *BillingAccountsPatchCall { c := &BillingAccountsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2201,9 +2182,7 @@ type BillingAccountsSetIamPolicyCall struct { // SetIamPolicy: Sets the access control policy for a billing account. // Replaces any existing policy. The caller must have the // `billing.accounts.setIamPolicy` permission on the account, which is -// often given to billing account -// [administrators](https://cloud.google.com/billing/docs/how-to/billing- -// access). +// often given to billing account administrators. func (r *BillingAccountsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *BillingAccountsSetIamPolicyCall { c := &BillingAccountsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -2492,9 +2471,7 @@ type BillingAccountsProjectsListCall struct { // List: Lists the projects associated with a billing account. The // current authenticated user must have the // `billing.resourceAssociations.list` IAM permission, which is often -// given to billing account -// [viewers](https://cloud.google.com/billing/docs/how-to/billing-access) -// . +// given to billing account viewers. func (r *BillingAccountsProjectsService) List(name string) *BillingAccountsProjectsListCall { c := &BillingAccountsProjectsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2690,9 +2667,7 @@ type ProjectsGetBillingInfoCall struct { } // GetBillingInfo: Gets the billing information for a project. The -// current authenticated user must have [permission to view the -// project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxof -// vnoo ). +// current authenticated user must have permission to view the project. func (r *ProjectsService) GetBillingInfo(name string) *ProjectsGetBillingInfoCall { c := &ProjectsGetBillingInfoCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2850,22 +2825,19 @@ type ProjectsUpdateBillingInfoCall struct { // be billed to the new billing account, even if the charge occurred // before the new billing account was assigned to the project. The // current authenticated user must have ownership privileges for both -// the -// [project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxo -// fvnoo ) and the [billing -// account](https://cloud.google.com/billing/docs/how-to/billing-access). -// You can disable billing on the project by setting the -// `billing_account_name` field to empty. This action disassociates the -// current billing account from the project. Any billable activity of -// your in-use services will stop, and your application could stop -// functioning as expected. Any unbilled charges to date will be billed -// to the previously associated account. The current authenticated user -// must be either an owner of the project or an owner of the billing -// account for the project. Note that associating a project with a -// *closed* billing account will have much the same effect as disabling -// billing on the project: any paid resources used by the project will -// be shut down. Thus, unless you wish to disable billing, you should -// always call this method with the name of an *open* billing account. +// the project and the billing account. You can disable billing on the +// project by setting the `billing_account_name` field to empty. This +// action disassociates the current billing account from the project. +// Any billable activity of your in-use services will stop, and your +// application could stop functioning as expected. Any unbilled charges +// to date will be billed to the previously associated account. The +// current authenticated user must be either an owner of the project or +// an owner of the billing account for the project. Note that +// associating a project with a *closed* billing account will have much +// the same effect as disabling billing on the project: any paid +// resources used by the project will be shut down. Thus, unless you +// wish to disable billing, you should always call this method with the +// name of an *open* billing account. func (r *ProjectsService) UpdateBillingInfo(name string, projectbillinginfo *ProjectBillingInfo) *ProjectsUpdateBillingInfoCall { c := &ProjectsUpdateBillingInfoCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/cloudbuild/v1/cloudbuild-gen.go b/cloudbuild/v1/cloudbuild-gen.go index 3f0c26bec82..973712b7564 100644 --- a/cloudbuild/v1/cloudbuild-gen.go +++ b/cloudbuild/v1/cloudbuild-gen.go @@ -220,10 +220,9 @@ type ProjectsTriggersService struct { // upon successful completion of all build steps. type ArtifactObjects struct { // Location: Cloud Storage bucket and optional object path, in the form - // "gs://bucket/path/to/somewhere/". (see [Bucket Name - // Requirements](https://cloud.google.com/storage/docs/bucket-naming#requ - // irements)). Files in the workspace matching any path pattern will be - // uploaded to Cloud Storage with this location as a prefix. + // "gs://bucket/path/to/somewhere/". (see Bucket Name Requirements). + // Files in the workspace matching any path pattern will be uploaded to + // Cloud Storage with this location as a prefix. Location string `json:"location,omitempty"` // Paths: Path globs used to match files in the build's workspace. @@ -377,9 +376,7 @@ type Build struct { LogUrl string `json:"logUrl,omitempty"` // LogsBucket: Google Cloud Storage bucket where logs should be written - // (see [Bucket Name - // Requirements](https://cloud.google.com/storage/docs/bucket-naming#requ - // irements)). Logs file names will be of the format + // (see Bucket Name Requirements). Logs file names will be of the format // `${logs_bucket}/log-${build_id}.txt`. LogsBucket string `json:"logsBucket,omitempty"` @@ -691,13 +688,12 @@ type BuildStep struct { // attempt to pull the image first, using the builder service account's // credentials if necessary. The Docker daemon's cache will already have // the latest versions of all of the officially supported build steps - // ([https://github.com/GoogleCloudPlatform/cloud-builders](https://githu - // b.com/GoogleCloudPlatform/cloud-builders)). The Docker daemon will - // also have cached many of the layers for some popular images, like - // "ubuntu", "debian", but they will be refreshed at the time you - // attempt to use them. If you built an image in a previous build step, - // it will be stored in the host's Docker daemon's cache and is - // available to use as the name for a later build step. + // (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker + // daemon will also have cached many of the layers for some popular + // images, like "ubuntu", "debian", but they will be refreshed at the + // time you attempt to use them. If you built an image in a previous + // build step, it will be stored in the host's Docker daemon's cache and + // is available to use as the name for a later build step. Name string `json:"name,omitempty"` // PullTiming: Output only. Stores timing information for pulling this @@ -1612,10 +1608,9 @@ type Results struct { BuildStepImages []string `json:"buildStepImages,omitempty"` // BuildStepOutputs: List of build step outputs, produced by builder - // images, in the order corresponding to build step indices. [Cloud - // Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) - // can produce this output by writing to `$BUILDER_OUTPUT/output`. Only - // the first 4KB of data is stored. + // images, in the order corresponding to build step indices. Cloud + // Builders can produce this output by writing to + // `$BUILDER_OUTPUT/output`. Only the first 4KB of data is stored. BuildStepOutputs []string `json:"buildStepOutputs,omitempty"` // Images: Container images that were built as a part of the build. @@ -1877,11 +1872,10 @@ func (s *SourceProvenance) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1922,10 +1916,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { // StorageSource: Location of the source in an archive file in Google // Cloud Storage. type StorageSource struct { - // Bucket: Google Cloud Storage bucket containing the source (see - // [Bucket Name - // Requirements](https://cloud.google.com/storage/docs/bucket-naming#requ - // irements)). + // Bucket: Google Cloud Storage bucket containing the source (see Bucket + // Name Requirements). Bucket string `json:"bucket,omitempty"` // Generation: Google Cloud Storage generation for the object. If the diff --git a/cloudbuild/v1alpha1/cloudbuild-gen.go b/cloudbuild/v1alpha1/cloudbuild-gen.go index efaba1a815f..c56ed7352cd 100644 --- a/cloudbuild/v1alpha1/cloudbuild-gen.go +++ b/cloudbuild/v1alpha1/cloudbuild-gen.go @@ -184,10 +184,9 @@ type ProjectsWorkerPoolsService struct { // upon successful completion of all build steps. type ArtifactObjects struct { // Location: Cloud Storage bucket and optional object path, in the form - // "gs://bucket/path/to/somewhere/". (see [Bucket Name - // Requirements](https://cloud.google.com/storage/docs/bucket-naming#requ - // irements)). Files in the workspace matching any path pattern will be - // uploaded to Cloud Storage with this location as a prefix. + // "gs://bucket/path/to/somewhere/". (see Bucket Name Requirements). + // Files in the workspace matching any path pattern will be uploaded to + // Cloud Storage with this location as a prefix. Location string `json:"location,omitempty"` // Paths: Path globs used to match files in the build's workspace. @@ -341,9 +340,7 @@ type Build struct { LogUrl string `json:"logUrl,omitempty"` // LogsBucket: Google Cloud Storage bucket where logs should be written - // (see [Bucket Name - // Requirements](https://cloud.google.com/storage/docs/bucket-naming#requ - // irements)). Logs file names will be of the format + // (see Bucket Name Requirements). Logs file names will be of the format // `${logs_bucket}/log-${build_id}.txt`. LogsBucket string `json:"logsBucket,omitempty"` @@ -651,13 +648,12 @@ type BuildStep struct { // attempt to pull the image first, using the builder service account's // credentials if necessary. The Docker daemon's cache will already have // the latest versions of all of the officially supported build steps - // ([https://github.com/GoogleCloudPlatform/cloud-builders](https://githu - // b.com/GoogleCloudPlatform/cloud-builders)). The Docker daemon will - // also have cached many of the layers for some popular images, like - // "ubuntu", "debian", but they will be refreshed at the time you - // attempt to use them. If you built an image in a previous build step, - // it will be stored in the host's Docker daemon's cache and is - // available to use as the name for a later build step. + // (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker + // daemon will also have cached many of the layers for some popular + // images, like "ubuntu", "debian", but they will be refreshed at the + // time you attempt to use them. If you built an image in a previous + // build step, it will be stored in the host's Docker daemon's cache and + // is available to use as the name for a later build step. Name string `json:"name,omitempty"` // PullTiming: Output only. Stores timing information for pulling this @@ -1306,10 +1302,9 @@ type Results struct { BuildStepImages []string `json:"buildStepImages,omitempty"` // BuildStepOutputs: List of build step outputs, produced by builder - // images, in the order corresponding to build step indices. [Cloud - // Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) - // can produce this output by writing to `$BUILDER_OUTPUT/output`. Only - // the first 4KB of data is stored. + // images, in the order corresponding to build step indices. Cloud + // Builders can produce this output by writing to + // `$BUILDER_OUTPUT/output`. Only the first 4KB of data is stored. BuildStepOutputs []string `json:"buildStepOutputs,omitempty"` // Images: Container images that were built as a part of the build. @@ -1536,11 +1531,10 @@ func (s *SourceProvenance) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1581,10 +1575,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { // StorageSource: Location of the source in an archive file in Google // Cloud Storage. type StorageSource struct { - // Bucket: Google Cloud Storage bucket containing the source (see - // [Bucket Name - // Requirements](https://cloud.google.com/storage/docs/bucket-naming#requ - // irements)). + // Bucket: Google Cloud Storage bucket containing the source (see Bucket + // Name Requirements). Bucket string `json:"bucket,omitempty"` // Generation: Google Cloud Storage generation for the object. If the diff --git a/cloudbuild/v1alpha2/cloudbuild-gen.go b/cloudbuild/v1alpha2/cloudbuild-gen.go index 470d827f702..66cc32cec8b 100644 --- a/cloudbuild/v1alpha2/cloudbuild-gen.go +++ b/cloudbuild/v1alpha2/cloudbuild-gen.go @@ -184,10 +184,9 @@ type ProjectsWorkerPoolsService struct { // upon successful completion of all build steps. type ArtifactObjects struct { // Location: Cloud Storage bucket and optional object path, in the form - // "gs://bucket/path/to/somewhere/". (see [Bucket Name - // Requirements](https://cloud.google.com/storage/docs/bucket-naming#requ - // irements)). Files in the workspace matching any path pattern will be - // uploaded to Cloud Storage with this location as a prefix. + // "gs://bucket/path/to/somewhere/". (see Bucket Name Requirements). + // Files in the workspace matching any path pattern will be uploaded to + // Cloud Storage with this location as a prefix. Location string `json:"location,omitempty"` // Paths: Path globs used to match files in the build's workspace. @@ -341,9 +340,7 @@ type Build struct { LogUrl string `json:"logUrl,omitempty"` // LogsBucket: Google Cloud Storage bucket where logs should be written - // (see [Bucket Name - // Requirements](https://cloud.google.com/storage/docs/bucket-naming#requ - // irements)). Logs file names will be of the format + // (see Bucket Name Requirements). Logs file names will be of the format // `${logs_bucket}/log-${build_id}.txt`. LogsBucket string `json:"logsBucket,omitempty"` @@ -651,13 +648,12 @@ type BuildStep struct { // attempt to pull the image first, using the builder service account's // credentials if necessary. The Docker daemon's cache will already have // the latest versions of all of the officially supported build steps - // ([https://github.com/GoogleCloudPlatform/cloud-builders](https://githu - // b.com/GoogleCloudPlatform/cloud-builders)). The Docker daemon will - // also have cached many of the layers for some popular images, like - // "ubuntu", "debian", but they will be refreshed at the time you - // attempt to use them. If you built an image in a previous build step, - // it will be stored in the host's Docker daemon's cache and is - // available to use as the name for a later build step. + // (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker + // daemon will also have cached many of the layers for some popular + // images, like "ubuntu", "debian", but they will be refreshed at the + // time you attempt to use them. If you built an image in a previous + // build step, it will be stored in the host's Docker daemon's cache and + // is available to use as the name for a later build step. Name string `json:"name,omitempty"` // PullTiming: Output only. Stores timing information for pulling this @@ -1299,10 +1295,9 @@ type Results struct { BuildStepImages []string `json:"buildStepImages,omitempty"` // BuildStepOutputs: List of build step outputs, produced by builder - // images, in the order corresponding to build step indices. [Cloud - // Builders](https://cloud.google.com/cloud-build/docs/cloud-builders) - // can produce this output by writing to `$BUILDER_OUTPUT/output`. Only - // the first 4KB of data is stored. + // images, in the order corresponding to build step indices. Cloud + // Builders can produce this output by writing to + // `$BUILDER_OUTPUT/output`. Only the first 4KB of data is stored. BuildStepOutputs []string `json:"buildStepOutputs,omitempty"` // Images: Container images that were built as a part of the build. @@ -1529,11 +1524,10 @@ func (s *SourceProvenance) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1574,10 +1568,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { // StorageSource: Location of the source in an archive file in Google // Cloud Storage. type StorageSource struct { - // Bucket: Google Cloud Storage bucket containing the source (see - // [Bucket Name - // Requirements](https://cloud.google.com/storage/docs/bucket-naming#requ - // irements)). + // Bucket: Google Cloud Storage bucket containing the source (see Bucket + // Name Requirements). Bucket string `json:"bucket,omitempty"` // Generation: Google Cloud Storage generation for the object. If the diff --git a/clouderrorreporting/v1beta1/clouderrorreporting-gen.go b/clouderrorreporting/v1beta1/clouderrorreporting-gen.go index f03b315b7be..bcdaedc84e6 100644 --- a/clouderrorreporting/v1beta1/clouderrorreporting-gen.go +++ b/clouderrorreporting/v1beta1/clouderrorreporting-gen.go @@ -576,22 +576,14 @@ type ReportedErrorEvent struct { // stack trace in one of the supported programming languages and // formats. Supported languages are Java, Python, JavaScript, Ruby, C#, // PHP, and Go. Supported stack trace formats are: * **Java**: Must be - // the return value of - // [`Throwable.printStackTrace()`](https://docs.oracle.com/javase/7/docs/ - // api/java/lang/Throwable.html#printStackTrace%28%29). * **Python**: - // Must be the return value of - // [`traceback.format_exc()`](https://docs.python.org/2/library/traceback - // .html#traceback.format_exc). * **JavaScript**: Must be the value of - // [`error.stack`](https://github.com/v8/v8/wiki/Stack-Trace-API) as - // returned by V8. * **Ruby**: Must contain frames returned by - // [`Exception.backtrace`](https://ruby-doc.org/core-2.2.0/Exception.html - // #method-i-backtrace). * **C#**: Must be the return value of - // [`Exception.ToString()`](https://msdn.microsoft.com/en-us/library/syst - // em.exception.tostring.aspx). * **PHP**: Must start with `PHP - // (Notice|Parse error|Fatal error|Warning)` and contain the result of - // [`(string)$exception`](http://php.net/manual/en/exception.tostring.php - // ). * **Go**: Must be the return value of - // [`runtime.Stack()`](https://golang.org/pkg/runtime/debug/#Stack). + // the return value of `Throwable.printStackTrace()`. * **Python**: Must + // be the return value of `traceback.format_exc()`. * **JavaScript**: + // Must be the value of `error.stack` as returned by V8. * **Ruby**: + // Must contain frames returned by `Exception.backtrace`. * **C#**: Must + // be the return value of `Exception.ToString()`. * **PHP**: Must start + // with `PHP (Notice|Parse error|Fatal error|Warning)` and contain the + // result of `(string)$exception`. * **Go**: Must be the return value of + // `runtime.Stack()`. Message string `json:"message,omitempty"` // ServiceContext: Required. The service context in which this error has @@ -981,8 +973,7 @@ func (c *ProjectsEventsListCall) PageToken(pageToken string) *ProjectsEventsList // ServiceFilterResourceType sets the optional parameter // "serviceFilter.resourceType": The exact value to match against -// [`ServiceContext.resource_type`](/error-reporting/reference/rest/v1bet -// a1/ServiceContext#FIELDS.resource_type). +// `ServiceContext.resource_type`. func (c *ProjectsEventsListCall) ServiceFilterResourceType(serviceFilterResourceType string) *ProjectsEventsListCall { c.urlParams_.Set("serviceFilter.resourceType", serviceFilterResourceType) return c @@ -990,8 +981,7 @@ func (c *ProjectsEventsListCall) ServiceFilterResourceType(serviceFilterResource // ServiceFilterService sets the optional parameter // "serviceFilter.service": The exact value to match against -// [`ServiceContext.service`](/error-reporting/reference/rest/v1beta1/Ser -// viceContext#FIELDS.service). +// `ServiceContext.service`. func (c *ProjectsEventsListCall) ServiceFilterService(serviceFilterService string) *ProjectsEventsListCall { c.urlParams_.Set("serviceFilter.service", serviceFilterService) return c @@ -999,8 +989,7 @@ func (c *ProjectsEventsListCall) ServiceFilterService(serviceFilterService strin // ServiceFilterVersion sets the optional parameter // "serviceFilter.version": The exact value to match against -// [`ServiceContext.version`](/error-reporting/reference/rest/v1beta1/Ser -// viceContext#FIELDS.version). +// `ServiceContext.version`. func (c *ProjectsEventsListCall) ServiceFilterVersion(serviceFilterVersion string) *ProjectsEventsListCall { c.urlParams_.Set("serviceFilter.version", serviceFilterVersion) return c @@ -1237,10 +1226,9 @@ type ProjectsEventsReportCall struct { } // Report: Report an individual error event. This endpoint accepts -// **either** an OAuth token, **or** an [API -// key](https://support.google.com/cloud/answer/6158862) for -// authentication. To use an API key, append it to the URL as the value -// of a `key` parameter. For example: `POST +// **either** an OAuth token, **or** an API key for authentication. To +// use an API key, append it to the URL as the value of a `key` +// parameter. For example: `POST // https://clouderrorreporting.googleapis.com/v1beta1/{projectName}/events:report?key=123ABC456` func (r *ProjectsEventsService) Report(projectName string, reportederrorevent *ReportedErrorEvent) *ProjectsEventsReportCall { c := &ProjectsEventsReportCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -1460,8 +1448,7 @@ func (c *ProjectsGroupStatsListCall) PageToken(pageToken string) *ProjectsGroupS // ServiceFilterResourceType sets the optional parameter // "serviceFilter.resourceType": The exact value to match against -// [`ServiceContext.resource_type`](/error-reporting/reference/rest/v1bet -// a1/ServiceContext#FIELDS.resource_type). +// `ServiceContext.resource_type`. func (c *ProjectsGroupStatsListCall) ServiceFilterResourceType(serviceFilterResourceType string) *ProjectsGroupStatsListCall { c.urlParams_.Set("serviceFilter.resourceType", serviceFilterResourceType) return c @@ -1469,8 +1456,7 @@ func (c *ProjectsGroupStatsListCall) ServiceFilterResourceType(serviceFilterReso // ServiceFilterService sets the optional parameter // "serviceFilter.service": The exact value to match against -// [`ServiceContext.service`](/error-reporting/reference/rest/v1beta1/Ser -// viceContext#FIELDS.service). +// `ServiceContext.service`. func (c *ProjectsGroupStatsListCall) ServiceFilterService(serviceFilterService string) *ProjectsGroupStatsListCall { c.urlParams_.Set("serviceFilter.service", serviceFilterService) return c @@ -1478,8 +1464,7 @@ func (c *ProjectsGroupStatsListCall) ServiceFilterService(serviceFilterService s // ServiceFilterVersion sets the optional parameter // "serviceFilter.version": The exact value to match against -// [`ServiceContext.version`](/error-reporting/reference/rest/v1beta1/Ser -// viceContext#FIELDS.version). +// `ServiceContext.version`. func (c *ProjectsGroupStatsListCall) ServiceFilterVersion(serviceFilterVersion string) *ProjectsGroupStatsListCall { c.urlParams_.Set("serviceFilter.version", serviceFilterVersion) return c diff --git a/cloudfunctions/v1/cloudfunctions-gen.go b/cloudfunctions/v1/cloudfunctions-gen.go index d77c18cf625..ca0d5ec96e6 100644 --- a/cloudfunctions/v1/cloudfunctions-gen.go +++ b/cloudfunctions/v1/cloudfunctions-gen.go @@ -285,9 +285,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -480,9 +478,8 @@ type CloudFunction struct { // create more instances than the specified max instances limit. If your // function cannot tolerate this temporary behavior, you may want to // factor in a safety margin and set a lower max instances value than - // your function can tolerate. See the [Max - // Instances](https://cloud.google.com/functions/docs/max-instances) - // Guide for more details. + // your function can tolerate. See the Max Instances Guide for more + // details. MaxInstances int64 `json:"maxInstances,omitempty"` // Name: A user-defined name of the function. Function names must be @@ -498,15 +495,14 @@ type CloudFunction struct { // `projects/{project}/global/networks/{network}` or `{network}`, where // {project} is a project id where the network is defined, and {network} // is the short name of the network. This field is mutually exclusive - // with `vpc_connector` and will be replaced by it. See [the VPC - // documentation](https://cloud.google.com/compute/docs/vpc) for more - // information on connecting Cloud projects. + // with `vpc_connector` and will be replaced by it. See the VPC + // documentation for more information on connecting Cloud projects. Network string `json:"network,omitempty"` // Runtime: The runtime in which to run the function. Required when // deploying a new function, optional when updating an existing - // function. For a complete list of possible choices, see the [`gcloud` - // command reference](/sdk/gcloud/reference/functions/deploy#--runtime). + // function. For a complete list of possible choices, see the `gcloud` + // command reference. Runtime string `json:"runtime,omitempty"` // ServiceAccountEmail: The email of the function's service account. If @@ -558,8 +554,8 @@ type CloudFunction struct { // name of the network connector resource. The format of this field is // `projects/*/locations/*/connectors/*` This field is mutually // exclusive with `network` field and will eventually replace it. See - // [the VPC documentation](https://cloud.google.com/compute/docs/vpc) - // for more information on connecting Cloud projects. + // the VPC documentation for more information on connecting Cloud + // projects. VpcConnector string `json:"vpcConnector,omitempty"` // VpcConnectorEgressSettings: The egress settings for the connector, @@ -1177,9 +1173,8 @@ func (s *OperationMetadataV1) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1197,8 +1192,8 @@ func (s *OperationMetadataV1) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1237,9 +1232,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1360,11 +1354,10 @@ func (s *SourceRepository) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1407,8 +1400,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2045,8 +2037,7 @@ type ProjectsLocationsFunctionsCallCall struct { // Call: Synchronously invokes a deployed Cloud Function. To be used for // testing purposes as very limited traffic is allowed. For more -// information on the actual limits, refer to [Rate -// Limits](https://cloud.google.com/functions/quotas#rate_limits). +// information on the actual limits, refer to Rate Limits. func (r *ProjectsLocationsFunctionsService) Call(name string, callfunctionrequest *CallFunctionRequest) *ProjectsLocationsFunctionsCallCall { c := &ProjectsLocationsFunctionsCallCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2920,9 +2911,7 @@ func (r *ProjectsLocationsFunctionsService) GetIamPolicy(resource string) *Proje // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsFunctionsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsFunctionsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/cloudidentity/v1/cloudidentity-gen.go b/cloudidentity/v1/cloudidentity-gen.go index 633a2470409..c8193f92fd0 100644 --- a/cloudidentity/v1/cloudidentity-gen.go +++ b/cloudidentity/v1/cloudidentity-gen.go @@ -382,12 +382,11 @@ func (s *GoogleAppsCloudidentityDevicesV1AndroidAttributes) MarshalJSON() ([]byt // GoogleAppsCloudidentityDevicesV1ApproveDeviceUserRequest: Request // message for approving the device to access user data. type GoogleAppsCloudidentityDevicesV1ApproveDeviceUserRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -445,12 +444,11 @@ func (s *GoogleAppsCloudidentityDevicesV1ApproveDeviceUserResponse) MarshalJSON( // GoogleAppsCloudidentityDevicesV1BlockDeviceUserRequest: Request // message for blocking account on device. type GoogleAppsCloudidentityDevicesV1BlockDeviceUserRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -508,12 +506,11 @@ func (s *GoogleAppsCloudidentityDevicesV1BlockDeviceUserResponse) MarshalJSON() // GoogleAppsCloudidentityDevicesV1CancelWipeDeviceRequest: Request // message for cancelling an unfinished device wipe. type GoogleAppsCloudidentityDevicesV1CancelWipeDeviceRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -572,12 +569,11 @@ func (s *GoogleAppsCloudidentityDevicesV1CancelWipeDeviceResponse) MarshalJSON() // GoogleAppsCloudidentityDevicesV1CancelWipeDeviceUserRequest: Request // message for cancelling an unfinished user account wipe. type GoogleAppsCloudidentityDevicesV1CancelWipeDeviceUserRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -697,9 +693,7 @@ type GoogleAppsCloudidentityDevicesV1ClientState struct { // "UNMANAGED" - The resource is not managed. Managed string `json:"managed,omitempty"` - // Name: Output only. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // ClientState in format: + // Name: Output only. Resource name of the ClientState in format: // `devices/{device_id}/deviceUsers/{device_user_id}/clientState/{partner // _id}`, where partner_id corresponds to the partner storing the data. // For partners belonging to the "BeyondCorp Alliance", this is the @@ -908,10 +902,9 @@ type GoogleAppsCloudidentityDevicesV1Device struct { // Model: Output only. Model name of device. Example: Pixel 3. Model string `json:"model,omitempty"` - // Name: Output only. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // Device in format: `devices/{device_id}`, where device_id is the - // unique id assigned to the Device. + // Name: Output only. Resource name of the Device in format: + // `devices/{device_id}`, where device_id is the unique id assigned to + // the Device. Name string `json:"name,omitempty"` // NetworkOperator: Output only. Mobile or network operator of device, @@ -1025,10 +1018,9 @@ type GoogleAppsCloudidentityDevicesV1DeviceUser struct { // but the Windows account is still intact. ManagementState string `json:"managementState,omitempty"` - // Name: Output only. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // DeviceUser in format: `devices/{device_id}/deviceUsers/{user_id}`, - // where user_id is the ID of the user associated with the user session. + // Name: Output only. Resource name of the DeviceUser in format: + // `devices/{device_id}/deviceUsers/{user_id}`, where user_id is the ID + // of the user associated with the user session. Name string `json:"name,omitempty"` // PasswordState: Password state of the DeviceUser object @@ -1193,9 +1185,7 @@ type GoogleAppsCloudidentityDevicesV1LookupSelfDeviceUsersResponse struct { // Devices API methods such as List, Get, etc. Customer string `json:"customer,omitempty"` - // Names: [Resource - // names](https://cloud.google.com/apis/design/resource_names) of the - // DeviceUsers in the format: + // Names: Resource names of the DeviceUsers in the format: // `devices/{device_id}/deviceUsers/{user_resource_id}`, where device_id // is the unique ID assigned to a Device and user_resource_id is the // unique user ID @@ -1235,12 +1225,11 @@ func (s *GoogleAppsCloudidentityDevicesV1LookupSelfDeviceUsersResponse) MarshalJ // GoogleAppsCloudidentityDevicesV1WipeDeviceRequest: Request message // for wiping all data on the device. type GoogleAppsCloudidentityDevicesV1WipeDeviceRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -1299,12 +1288,11 @@ func (s *GoogleAppsCloudidentityDevicesV1WipeDeviceResponse) MarshalJSON() ([]by // GoogleAppsCloudidentityDevicesV1WipeDeviceUserRequest: Request // message for starting an account wipe on device. type GoogleAppsCloudidentityDevicesV1WipeDeviceUserRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -1391,9 +1379,8 @@ type Group struct { // {"system/groups/external": ""}. Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. The [resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // `Group`. Shall be of the form `groups/{group_id}`. + // Name: Output only. The resource name of the `Group`. Shall be of the + // form `groups/{group_id}`. Name string `json:"name,omitempty"` // Parent: Required. Immutable. The resource name of the entity under @@ -1566,9 +1553,7 @@ func (s *ListMembershipsResponse) MarshalJSON() ([]byte, error) { // LookupGroupNameResponse: The response message for // GroupsService.LookupGroupName. type LookupGroupNameResponse struct { - // Name: The [resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // looked-up `Group`. + // Name: The resource name of the looked-up `Group`. Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1601,10 +1586,8 @@ func (s *LookupGroupNameResponse) MarshalJSON() ([]byte, error) { // LookupMembershipNameResponse: The response message for // MembershipsService.LookupMembershipName. type LookupMembershipNameResponse struct { - // Name: The [resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // looked-up `Membership`. Must be of the form - // `groups/{group_id}/memberships/{membership_id}`. + // Name: The resource name of the looked-up `Membership`. Must be of the + // form `groups/{group_id}/memberships/{membership_id}`. Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1694,10 +1677,8 @@ type Membership struct { // CreateTime: Output only. The time when the `Membership` was created. CreateTime string `json:"createTime,omitempty"` - // Name: Output only. The [resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // `Membership`. Shall be of the form - // `groups/{group_id}/memberships/{membership_id}`. + // Name: Output only. The resource name of the `Membership`. Shall be of + // the form `groups/{group_id}/memberships/{membership_id}`. Name string `json:"name,omitempty"` // PreferredMemberKey: Required. Immutable. The `EntityKey` of the @@ -2065,11 +2046,10 @@ func (s *SearchTransitiveMembershipsResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2300,12 +2280,11 @@ func (r *DevicesService) Create(googleappscloudidentitydevicesv1device *GoogleAp return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesCreateCall) Customer(customer string) *DevicesCreateCall { c.urlParams_.Set("customer", customer) return c @@ -2439,12 +2418,11 @@ func (r *DevicesService) Delete(name string) *DevicesDeleteCall { return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeleteCall) Customer(customer string) *DevicesDeleteCall { c.urlParams_.Set("customer", customer) return c @@ -2583,14 +2561,13 @@ func (r *DevicesService) Get(name string) *DevicesGetCall { return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// Customer in the format: `customers/{customer_id}`, where customer_id -// is the customer to whom the device belongs. If you're using this API -// for your own organization, use `customers/my_customer`. If you're -// using this API to manage another organization, use -// `customers/{customer_id}`, where customer_id is the customer to whom -// the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the Customer in the format: `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. If you're +// using this API for your own organization, use +// `customers/my_customer`. If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesGetCall) Customer(customer string) *DevicesGetCall { c.urlParams_.Set("customer", customer) return c @@ -2741,14 +2718,13 @@ func (r *DevicesService) List() *DevicesListCall { return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer in the format: `customers/{customer_id}`, where customer_id -// is the customer to whom the device belongs. If you're using this API -// for your own organization, use `customers/my_customer`. If you're -// using this API to manage another organization, use -// `customers/{customer_id}`, where customer_id is the customer to whom -// the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer in the format: `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. If you're +// using this API for your own organization, use +// `customers/my_customer`. If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesListCall) Customer(customer string) *DevicesListCall { c.urlParams_.Set("customer", customer) return c @@ -2756,10 +2732,8 @@ func (c *DevicesListCall) Customer(customer string) *DevicesListCall { // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to -// [Mobile device search -// fields](https://developers.google.com/admin-sdk/directory/v1/search-op -// erators). Multiple search fields are separated by the space -// character. +// Mobile device search fields. Multiple search fields are separated by +// the space character. func (c *DevicesListCall) Filter(filter string) *DevicesListCall { c.urlParams_.Set("filter", filter) return c @@ -3555,12 +3529,11 @@ func (r *DevicesDeviceUsersService) Delete(name string) *DevicesDeviceUsersDelet return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersDeleteCall) Customer(customer string) *DevicesDeviceUsersDeleteCall { c.urlParams_.Set("customer", customer) return c @@ -3699,12 +3672,11 @@ func (r *DevicesDeviceUsersService) Get(name string) *DevicesDeviceUsersGetCall return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersGetCall) Customer(customer string) *DevicesDeviceUsersGetCall { c.urlParams_.Set("customer", customer) return c @@ -3858,12 +3830,11 @@ func (r *DevicesDeviceUsersService) List(parent string) *DevicesDeviceUsersListC return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersListCall) Customer(customer string) *DevicesDeviceUsersListCall { c.urlParams_.Set("customer", customer) return c @@ -3871,10 +3842,8 @@ func (c *DevicesDeviceUsersListCall) Customer(customer string) *DevicesDeviceUse // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to -// [Mobile device search -// fields](https://developers.google.com/admin-sdk/directory/v1/search-op -// erators). Multiple search fields are separated by the space -// character. +// Mobile device search fields. Multiple search fields are separated by +// the space character. func (c *DevicesDeviceUsersListCall) Filter(filter string) *DevicesDeviceUsersListCall { c.urlParams_.Set("filter", filter) return c @@ -4110,9 +4079,7 @@ func (r *DevicesDeviceUsersService) Lookup(parent string) *DevicesDeviceUsersLoo } // AndroidId sets the optional parameter "androidId": Android Id -// returned by -// [Settings.Secure#ANDROID_ID](https://developer.android.com/reference/a -// ndroid/provider/Settings.Secure.html#ANDROID_ID). +// returned by Settings.Secure#ANDROID_ID. func (c *DevicesDeviceUsersLookupCall) AndroidId(androidId string) *DevicesDeviceUsersLookupCall { c.urlParams_.Set("androidId", androidId) return c @@ -4494,12 +4461,11 @@ func (r *DevicesDeviceUsersClientStatesService) Get(name string) *DevicesDeviceU return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersClientStatesGetCall) Customer(customer string) *DevicesDeviceUsersClientStatesGetCall { c.urlParams_.Set("customer", customer) return c @@ -4653,12 +4619,11 @@ func (r *DevicesDeviceUsersClientStatesService) List(parent string) *DevicesDevi return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersClientStatesListCall) Customer(customer string) *DevicesDeviceUsersClientStatesListCall { c.urlParams_.Set("customer", customer) return c @@ -4877,12 +4842,11 @@ func (r *DevicesDeviceUsersClientStatesService) Patch(name string, googleappsclo return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersClientStatesPatchCall) Customer(customer string) *DevicesDeviceUsersClientStatesPatchCall { c.urlParams_.Set("customer", customer) return c @@ -5694,9 +5658,7 @@ type GroupsLookupCall struct { header_ http.Header } -// Lookup: Looks up the [resource -// name](https://cloud.google.com/apis/design/resource_names) of a -// `Group` by its `EntityKey`. +// Lookup: Looks up the resource name of a `Group` by its `EntityKey`. func (r *GroupsService) Lookup() *GroupsLookupCall { c := &GroupsLookupCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -6043,10 +6005,9 @@ func (c *GroupsSearchCall) PageToken(pageToken string) *GroupsSearchCall { } // Query sets the optional parameter "query": Required. The search -// query. Must be specified in [Common Expression -// Language](https://opensource.google/projects/cel). May only contain -// equality operators on the parent and inclusion operators on labels -// (e.g., `parent == 'customers/{customer_id}' && +// query. Must be specified in Common Expression Language. May only +// contain equality operators on the parent and inclusion operators on +// labels (e.g., `parent == 'customers/{customer_id}' && // 'cloudidentity.googleapis.com/groups.discussion_forum' in labels`). func (c *GroupsSearchCall) Query(query string) *GroupsSearchCall { c.urlParams_.Set("query", query) @@ -7229,9 +7190,8 @@ type GroupsMembershipsLookupCall struct { header_ http.Header } -// Lookup: Looks up the [resource -// name](https://cloud.google.com/apis/design/resource_names) of a -// `Membership` by its `EntityKey`. +// Lookup: Looks up the resource name of a `Membership` by its +// `EntityKey`. func (r *GroupsMembershipsService) Lookup(parent string) *GroupsMembershipsLookupCall { c := &GroupsMembershipsLookupCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/cloudidentity/v1beta1/cloudidentity-gen.go b/cloudidentity/v1beta1/cloudidentity-gen.go index fcd07b99ff5..30a729629b0 100644 --- a/cloudidentity/v1beta1/cloudidentity-gen.go +++ b/cloudidentity/v1beta1/cloudidentity-gen.go @@ -266,12 +266,11 @@ func (s *AndroidAttributes) MarshalJSON() ([]byte, error) { // ApproveDeviceUserRequest: Request message for approving the device to // access user data. type ApproveDeviceUserRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -329,12 +328,11 @@ func (s *ApproveDeviceUserResponse) MarshalJSON() ([]byte, error) { // BlockDeviceUserRequest: Request message for blocking account on // device. type BlockDeviceUserRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -392,12 +390,11 @@ func (s *BlockDeviceUserResponse) MarshalJSON() ([]byte, error) { // CancelWipeDeviceRequest: Request message for cancelling an unfinished // device wipe. type CancelWipeDeviceRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -456,12 +453,11 @@ func (s *CancelWipeDeviceResponse) MarshalJSON() ([]byte, error) { // CancelWipeDeviceUserRequest: Request message for cancelling an // unfinished user account wipe. type CancelWipeDeviceUserRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -614,9 +610,7 @@ type ClientState struct { // "UNMANAGED" - The resource is not managed. Managed string `json:"managed,omitempty"` - // Name: Output only. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // ClientState in format: + // Name: Output only. Resource name of the ClientState in format: // `devices/{device_id}/deviceUsers/{device_user_id}/clientState/{partner // _id}`, where partner_id corresponds to the partner storing the data. Name string `json:"name,omitempty"` @@ -662,12 +656,11 @@ func (s *ClientState) MarshalJSON() ([]byte, error) { // CreateDeviceRequest: Request message for creating a Company Owned // device. type CreateDeviceRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // Device: Required. The device to be created. The name field within @@ -853,10 +846,9 @@ type Device struct { // Model: Output only. Model name of device. Example: Pixel 3. Model string `json:"model,omitempty"` - // Name: Output only. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // Device in format: `devices/{device_id}`, where device_id is the - // unique id assigned to the Device. + // Name: Output only. Resource name of the Device in format: + // `devices/{device_id}`, where device_id is the unique id assigned to + // the Device. Name string `json:"name,omitempty"` // NetworkOperator: Output only. Mobile or network operator of device, @@ -970,10 +962,9 @@ type DeviceUser struct { // but the Windows account is still intact. ManagementState string `json:"managementState,omitempty"` - // Name: Output only. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // DeviceUser in format: `devices/{device_id}/deviceUsers/{user_id}`, - // where user_id is the ID of the user associated with the user session. + // Name: Output only. Resource name of the DeviceUser in format: + // `devices/{device_id}/deviceUsers/{user_id}`, where user_id is the ID + // of the user associated with the user session. Name string `json:"name,omitempty"` // PasswordState: Password state of the DeviceUser object @@ -1474,9 +1465,7 @@ type GoogleAppsCloudidentityDevicesV1ClientState struct { // "UNMANAGED" - The resource is not managed. Managed string `json:"managed,omitempty"` - // Name: Output only. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // ClientState in format: + // Name: Output only. Resource name of the ClientState in format: // `devices/{device_id}/deviceUsers/{device_user_id}/clientState/{partner // _id}`, where partner_id corresponds to the partner storing the data. // For partners belonging to the "BeyondCorp Alliance", this is the @@ -1681,10 +1670,9 @@ type GoogleAppsCloudidentityDevicesV1Device struct { // Model: Output only. Model name of device. Example: Pixel 3. Model string `json:"model,omitempty"` - // Name: Output only. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // Device in format: `devices/{device_id}`, where device_id is the - // unique id assigned to the Device. + // Name: Output only. Resource name of the Device in format: + // `devices/{device_id}`, where device_id is the unique id assigned to + // the Device. Name string `json:"name,omitempty"` // NetworkOperator: Output only. Mobile or network operator of device, @@ -1794,10 +1782,9 @@ type GoogleAppsCloudidentityDevicesV1DeviceUser struct { // but the Windows account is still intact. ManagementState string `json:"managementState,omitempty"` - // Name: Output only. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // DeviceUser in format: `devices/{device_id}/deviceUsers/{user_id}`, - // where user_id is the ID of the user associated with the user session. + // Name: Output only. Resource name of the DeviceUser in format: + // `devices/{device_id}/deviceUsers/{user_id}`, where user_id is the ID + // of the user associated with the user session. Name string `json:"name,omitempty"` // PasswordState: Password state of the DeviceUser object @@ -1937,9 +1924,8 @@ type Group struct { // {"system/groups/external": ""}. Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. The [resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // `Group`. Shall be of the form `groups/{group_id}`. + // Name: Output only. The resource name of the `Group`. Shall be of the + // form `groups/{group_id}`. Name string `json:"name,omitempty"` // Parent: Required. Immutable. The resource name of the entity under @@ -2220,9 +2206,7 @@ func (s *ListMembershipsResponse) MarshalJSON() ([]byte, error) { // LookupGroupNameResponse: The response message for // GroupsService.LookupGroupName. type LookupGroupNameResponse struct { - // Name: Output only. The [resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // looked-up `Group`. + // Name: Output only. The resource name of the looked-up `Group`. Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2255,10 +2239,8 @@ func (s *LookupGroupNameResponse) MarshalJSON() ([]byte, error) { // LookupMembershipNameResponse: The response message for // MembershipsService.LookupMembershipName. type LookupMembershipNameResponse struct { - // Name: The [resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // looked-up `Membership`. Must be of the form - // `groups/{group_id}/memberships/{membership_id}`. + // Name: The resource name of the looked-up `Membership`. Must be of the + // form `groups/{group_id}/memberships/{membership_id}`. Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2295,9 +2277,7 @@ type LookupSelfDeviceUsersResponse struct { // Devices API methods such as List, Get, etc. Customer string `json:"customer,omitempty"` - // Names: [Resource - // names](https://cloud.google.com/apis/design/resource_names) of the - // DeviceUsers in the format: + // Names: Resource names of the DeviceUsers in the format: // `devices/{device_id}/deviceUsers/{user_resource_id}`, where device_id // is the unique ID assigned to a Device and user_resource_id is the // unique user ID @@ -2400,10 +2380,8 @@ type Membership struct { // when returned. MemberKey *EntityKey `json:"memberKey,omitempty"` - // Name: Output only. The [resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // `Membership`. Shall be of the form - // `groups/{group_id}/memberships/{membership_id}`. + // Name: Output only. The resource name of the `Membership`. Shall be of + // the form `groups/{group_id}/memberships/{membership_id}`. Name string `json:"name,omitempty"` // PreferredMemberKey: Required. Immutable. The `EntityKey` of the @@ -2784,11 +2762,10 @@ func (s *SearchTransitiveMembershipsResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2893,12 +2870,11 @@ func (s *UpdateMembershipRolesParams) MarshalJSON() ([]byte, error) { // WipeDeviceRequest: Request message for wiping all data on the device. type WipeDeviceRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -2957,12 +2933,11 @@ func (s *WipeDeviceResponse) MarshalJSON() ([]byte, error) { // WipeDeviceUserRequest: Request message for starting an account wipe // on device. type WipeDeviceUserRequest struct { - // Customer: Required. [Resource - // name](https://cloud.google.com/apis/design/resource_names) of the - // customer. If you're using this API for your own organization, use - // `customers/my_customer` If you're using this API to manage another - // organization, use `customers/{customer_id}`, where customer_id is the - // customer to whom the device belongs. + // Customer: Required. Resource name of the customer. If you're using + // this API for your own organization, use `customers/my_customer` If + // you're using this API to manage another organization, use + // `customers/{customer_id}`, where customer_id is the customer to whom + // the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -3298,12 +3273,11 @@ func (r *DevicesService) Delete(name string) *DevicesDeleteCall { return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeleteCall) Customer(customer string) *DevicesDeleteCall { c.urlParams_.Set("customer", customer) return c @@ -3442,10 +3416,9 @@ func (r *DevicesService) Get(name string) *DevicesGetCall { return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// Customer in format: `customers/{customer_id}`, where customer_id is -// the customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the Customer in format: `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesGetCall) Customer(customer string) *DevicesGetCall { c.urlParams_.Set("customer", customer) return c @@ -3595,9 +3568,8 @@ func (r *DevicesService) List() *DevicesListCall { return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. func (c *DevicesListCall) Customer(customer string) *DevicesListCall { c.urlParams_.Set("customer", customer) return c @@ -3605,10 +3577,8 @@ func (c *DevicesListCall) Customer(customer string) *DevicesListCall { // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to -// [Mobile device search -// fields](https://developers.google.com/admin-sdk/directory/v1/search-op -// erators). Multiple search fields are separated by the space -// character. +// Mobile device search fields. Multiple search fields are separated by +// the space character. func (c *DevicesListCall) Filter(filter string) *DevicesListCall { c.urlParams_.Set("filter", filter) return c @@ -4401,12 +4371,11 @@ func (r *DevicesDeviceUsersService) Delete(name string) *DevicesDeviceUsersDelet return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersDeleteCall) Customer(customer string) *DevicesDeviceUsersDeleteCall { c.urlParams_.Set("customer", customer) return c @@ -4545,12 +4514,11 @@ func (r *DevicesDeviceUsersService) Get(name string) *DevicesDeviceUsersGetCall return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersGetCall) Customer(customer string) *DevicesDeviceUsersGetCall { c.urlParams_.Set("customer", customer) return c @@ -4702,12 +4670,11 @@ func (r *DevicesDeviceUsersService) List(parent string) *DevicesDeviceUsersListC return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersListCall) Customer(customer string) *DevicesDeviceUsersListCall { c.urlParams_.Set("customer", customer) return c @@ -4715,10 +4682,8 @@ func (c *DevicesDeviceUsersListCall) Customer(customer string) *DevicesDeviceUse // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to -// [Mobile device search -// fields](https://developers.google.com/admin-sdk/directory/v1/search-op -// erators). Multiple search fields are separated by the space -// character. +// Mobile device search fields. Multiple search fields are separated by +// the space character. func (c *DevicesDeviceUsersListCall) Filter(filter string) *DevicesDeviceUsersListCall { c.urlParams_.Set("filter", filter) return c @@ -4951,9 +4916,7 @@ func (r *DevicesDeviceUsersService) Lookup(parent string) *DevicesDeviceUsersLoo } // AndroidId sets the optional parameter "androidId": Android Id -// returned by -// [Settings.Secure#ANDROID_ID](https://developer.android.com/reference/a -// ndroid/provider/Settings.Secure.html#ANDROID_ID). +// returned by Settings.Secure#ANDROID_ID. func (c *DevicesDeviceUsersLookupCall) AndroidId(androidId string) *DevicesDeviceUsersLookupCall { c.urlParams_.Set("androidId", androidId) return c @@ -5326,12 +5289,11 @@ func (r *DevicesDeviceUsersClientStatesService) Get(name string) *DevicesDeviceU return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersClientStatesGetCall) Customer(customer string) *DevicesDeviceUsersClientStatesGetCall { c.urlParams_.Set("customer", customer) return c @@ -5487,12 +5449,11 @@ func (r *DevicesDeviceUsersClientStatesService) Patch(name string, clientstate * return c } -// Customer sets the optional parameter "customer": Required. [Resource -// name](https://cloud.google.com/apis/design/resource_names) of the -// customer. If you're using this API for your own organization, use -// `customers/my_customer` If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// Customer sets the optional parameter "customer": Required. Resource +// name of the customer. If you're using this API for your own +// organization, use `customers/my_customer` If you're using this API to +// manage another organization, use `customers/{customer_id}`, where +// customer_id is the customer to whom the device belongs. func (c *DevicesDeviceUsersClientStatesPatchCall) Customer(customer string) *DevicesDeviceUsersClientStatesPatchCall { c.urlParams_.Set("customer", customer) return c @@ -6304,9 +6265,7 @@ type GroupsLookupCall struct { header_ http.Header } -// Lookup: Looks up the [resource -// name](https://cloud.google.com/apis/design/resource_names) of a -// `Group` by its `EntityKey`. +// Lookup: Looks up the resource name of a `Group` by its `EntityKey`. func (r *GroupsService) Lookup() *GroupsLookupCall { c := &GroupsLookupCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -6653,10 +6612,9 @@ func (c *GroupsSearchCall) PageToken(pageToken string) *GroupsSearchCall { } // Query sets the optional parameter "query": Required. The search -// query. Must be specified in [Common Expression -// Language](https://opensource.google/projects/cel). May only contain -// equality operators on the parent and inclusion operators on labels -// (e.g., `parent == 'customers/{customer_id}' && +// query. Must be specified in Common Expression Language. May only +// contain equality operators on the parent and inclusion operators on +// labels (e.g., `parent == 'customers/{customer_id}' && // 'cloudidentity.googleapis.com/groups.discussion_forum' in labels`). func (c *GroupsSearchCall) Query(query string) *GroupsSearchCall { c.urlParams_.Set("query", query) @@ -7830,9 +7788,8 @@ type GroupsMembershipsLookupCall struct { header_ http.Header } -// Lookup: Looks up the [resource -// name](https://cloud.google.com/apis/design/resource_names) of a -// `Membership` by its `EntityKey`. +// Lookup: Looks up the resource name of a `Membership` by its +// `EntityKey`. func (r *GroupsMembershipsService) Lookup(parent string) *GroupsMembershipsLookupCall { c := &GroupsMembershipsLookupCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/cloudiot/v1/cloudiot-gen.go b/cloudiot/v1/cloudiot-gen.go index 1dac8ed2856..5655cc5c454 100644 --- a/cloudiot/v1/cloudiot-gen.go +++ b/cloudiot/v1/cloudiot-gen.go @@ -285,9 +285,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -921,9 +919,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1219,9 +1215,8 @@ func (s *MqttConfig) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1239,8 +1234,8 @@ func (s *MqttConfig) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1275,9 +1270,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1545,11 +1539,10 @@ func (s *StateNotificationConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1592,8 +1585,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/cloudkms/v1/cloudkms-gen.go b/cloudkms/v1/cloudkms-gen.go index 29ca1ad51b6..83d1ca87c20 100644 --- a/cloudkms/v1/cloudkms-gen.go +++ b/cloudkms/v1/cloudkms-gen.go @@ -534,9 +534,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -649,7 +647,7 @@ type CryptoKey struct { CreateTime string `json:"createTime,omitempty"` // Labels: Labels with user-defined metadata. For more information, see - // [Labeling Keys](https://cloud.google.com/kms/docs/labeling-keys). + // Labeling Keys. Labels map[string]string `json:"labels,omitempty"` // Name: Output only. The resource name for this CryptoKey in the format @@ -1460,8 +1458,8 @@ func (s *ImportCryptoKeyVersionRequest) MarshalJSON() ([]byte, error) { // material. Only Cloud KMS has access to the private key. An ImportJob // expires 3 days after it is created. Once expired, Cloud KMS will no // longer be able to import or unwrap any key material that was wrapped -// with the ImportJob's public key. For more information, see [Importing -// a key](https://cloud.google.com/kms/docs/importing-a-key). +// with the ImportJob's public key. For more information, see Importing +// a key. type ImportJob struct { // Attestation: Output only. Statement that was generated and signed by // the key creator (for example, an HSM) at key creation time. Use this @@ -1950,9 +1948,8 @@ func (s *LocationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1970,8 +1967,8 @@ func (s *LocationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2010,9 +2007,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2087,10 +2083,8 @@ type PublicKey struct { Name string `json:"name,omitempty"` // Pem: The public key, encoded in PEM format. For more information, see - // the [RFC 7468](https://tools.ietf.org/html/rfc7468) sections for - // [General - // Considerations](https://tools.ietf.org/html/rfc7468#section-2) and - // [Textual Encoding of Subject Public Key Info] + // the RFC 7468 sections for General Considerations and [Textual + // Encoding of Subject Public Key Info] // (https://tools.ietf.org/html/rfc7468#section-13). Pem string `json:"pem,omitempty"` @@ -2181,8 +2175,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2278,10 +2271,8 @@ func (s *UpdateCryptoKeyPrimaryVersionRequest) MarshalJSON() ([]byte, error) { // ImportMethod. type WrappingPublicKey struct { // Pem: The public key, encoded in PEM format. For more information, see - // the [RFC 7468](https://tools.ietf.org/html/rfc7468) sections for - // [General - // Considerations](https://tools.ietf.org/html/rfc7468#section-2) and - // [Textual Encoding of Subject Public Key Info] + // the RFC 7468 sections for General Considerations and [Textual + // Encoding of Subject Public Key Info] // (https://tools.ietf.org/html/rfc7468#section-13). Pem string `json:"pem,omitempty"` @@ -2983,9 +2974,7 @@ func (r *ProjectsLocationsKeyRingsService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsKeyRingsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsKeyRingsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -3144,8 +3133,7 @@ func (r *ProjectsLocationsKeyRingsService) List(parent string) *ProjectsLocation // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For more information, see -// [Sorting and filtering list -// results](https://cloud.google.com/kms/docs/sorting-and-filtering). +// Sorting and filtering list results. func (c *ProjectsLocationsKeyRingsListCall) Filter(filter string) *ProjectsLocationsKeyRingsListCall { c.urlParams_.Set("filter", filter) return c @@ -3153,9 +3141,8 @@ func (c *ProjectsLocationsKeyRingsListCall) Filter(filter string) *ProjectsLocat // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. If not specified, the results will be -// sorted in the default order. For more information, see [Sorting and -// filtering list -// results](https://cloud.google.com/kms/docs/sorting-and-filtering). +// sorted in the default order. For more information, see Sorting and +// filtering list results. func (c *ProjectsLocationsKeyRingsListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -4264,9 +4251,7 @@ func (r *ProjectsLocationsKeyRingsCryptoKeysService) GetIamPolicy(resource strin // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsKeyRingsCryptoKeysGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsKeyRingsCryptoKeysGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -4425,8 +4410,7 @@ func (r *ProjectsLocationsKeyRingsCryptoKeysService) List(parent string) *Projec // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For more information, see -// [Sorting and filtering list -// results](https://cloud.google.com/kms/docs/sorting-and-filtering). +// Sorting and filtering list results. func (c *ProjectsLocationsKeyRingsCryptoKeysListCall) Filter(filter string) *ProjectsLocationsKeyRingsCryptoKeysListCall { c.urlParams_.Set("filter", filter) return c @@ -4434,9 +4418,8 @@ func (c *ProjectsLocationsKeyRingsCryptoKeysListCall) Filter(filter string) *Pro // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. If not specified, the results will be -// sorted in the default order. For more information, see [Sorting and -// filtering list -// results](https://cloud.google.com/kms/docs/sorting-and-filtering). +// sorted in the default order. For more information, see Sorting and +// filtering list results. func (c *ProjectsLocationsKeyRingsCryptoKeysListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsCryptoKeysListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -6270,8 +6253,7 @@ func (r *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsService) List(paren // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For more information, see -// [Sorting and filtering list -// results](https://cloud.google.com/kms/docs/sorting-and-filtering). +// Sorting and filtering list results. func (c *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall) Filter(filter string) *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall { c.urlParams_.Set("filter", filter) return c @@ -6279,9 +6261,8 @@ func (c *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall) Filter(fi // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. If not specified, the results will be -// sorted in the default order. For more information, see [Sorting and -// filtering list -// results](https://cloud.google.com/kms/docs/sorting-and-filtering). +// sorted in the default order. For more information, see Sorting and +// filtering list results. func (c *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -7127,9 +7108,7 @@ func (r *ProjectsLocationsKeyRingsImportJobsService) GetIamPolicy(resource strin // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsKeyRingsImportJobsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsKeyRingsImportJobsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -7288,8 +7267,7 @@ func (r *ProjectsLocationsKeyRingsImportJobsService) List(parent string) *Projec // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For more information, see -// [Sorting and filtering list -// results](https://cloud.google.com/kms/docs/sorting-and-filtering). +// Sorting and filtering list results. func (c *ProjectsLocationsKeyRingsImportJobsListCall) Filter(filter string) *ProjectsLocationsKeyRingsImportJobsListCall { c.urlParams_.Set("filter", filter) return c @@ -7297,9 +7275,8 @@ func (c *ProjectsLocationsKeyRingsImportJobsListCall) Filter(filter string) *Pro // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. If not specified, the results will be -// sorted in the default order. For more information, see [Sorting and -// filtering list -// results](https://cloud.google.com/kms/docs/sorting-and-filtering). +// sorted in the default order. For more information, see Sorting and +// filtering list results. func (c *ProjectsLocationsKeyRingsImportJobsListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsImportJobsListCall { c.urlParams_.Set("orderBy", orderBy) return c diff --git a/cloudprofiler/v2/cloudprofiler-gen.go b/cloudprofiler/v2/cloudprofiler-gen.go index 12cd9250815..69c61490dad 100644 --- a/cloudprofiler/v2/cloudprofiler-gen.go +++ b/cloudprofiler/v2/cloudprofiler-gen.go @@ -227,15 +227,14 @@ func (s *CreateProfileRequest) MarshalJSON() ([]byte, error) { // information. type Deployment struct { // Labels: Labels identify the deployment within the user universe and - // same target. Validation regex for label names: - // `^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$`. Value for an individual label - // must be <= 512 bytes, the total size of all label names and values - // must be <= 1024 bytes. Label named "language" can be used to record - // the programming language of the profiled deployment. The standard - // choices for the value include "java", "go", "python", "ruby", - // "nodejs", "php", "dotnet". For deployments running on Google Cloud - // Platform, "zone" or "region" label should be present describing the - // deployment location. An example of a zone is "us-central1-a", an + // same target. Validation regex for label names: `^a-z0-9?$`. Value for + // an individual label must be <= 512 bytes, the total size of all label + // names and values must be <= 1024 bytes. Label named "language" can be + // used to record the programming language of the profiled deployment. + // The standard choices for the value include "java", "go", "python", + // "ruby", "nodejs", "php", "dotnet". For deployments running on Google + // Cloud Platform, "zone" or "region" label should be present describing + // the deployment location. An example of a zone is "us-central1-a", an // example of a region is "us-central1" or "us-central". Labels map[string]string `json:"labels,omitempty"` @@ -246,8 +245,7 @@ type Deployment struct { // Target: Target is the service name used to group related deployments: // * Service name for GAE Flex / Standard. * Cluster and container name // for GKE. * User-specified string for direct GCE profiling (e.g. - // Java). * Job name for Dataflow. Validation regex: - // `^[a-z]([-a-z0-9_.]{0,253}[a-z0-9])?$`. + // Java). * Job name for Dataflow. Validation regex: `^a-z?$`. Target string `json:"target,omitempty"` // ForceSendFields is a list of field names (e.g. "Labels") to diff --git a/cloudresourcemanager/v1/cloudresourcemanager-gen.go b/cloudresourcemanager/v1/cloudresourcemanager-gen.go index dc3b7d5ab03..00f09def889 100644 --- a/cloudresourcemanager/v1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v1/cloudresourcemanager-gen.go @@ -333,9 +333,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -594,8 +592,7 @@ func (s *CloudresourcemanagerGoogleCloudResourcemanagerV2beta1FolderOperation) M // for `Constraints` at different locations in the organization's // resource hierarchy. Policies are inherited down the resource // hierarchy from higher levels, but can also be overridden. For details -// about the inheritance rules please read about -// [Policies](/resource-manager/reference/rest/v1/Policy). `Constraints` +// about the inheritance rules please read about Policies. `Constraints` // have a default behavior determined by the `constraint_default` field, // which is the enforcement behavior that is used in the absence of a // `Policy` being defined or inherited for the resource in question. @@ -1066,9 +1063,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1673,9 +1668,8 @@ type OrgPolicy struct { BooleanPolicy *BooleanPolicy `json:"booleanPolicy,omitempty"` // Constraint: The name of the `Constraint` the `Policy` is configuring, - // for example, `constraints/serviceuser.services`. A [list of available - // constraints](/resource-manager/docs/organization-policy/org-policy-con - // straints) is available. Immutable after creation. + // for example, `constraints/serviceuser.services`. A list of available + // constraints is available. Immutable after creation. Constraint string `json:"constraint,omitempty"` // Etag: An opaque tag indicating the current version of the `Policy`, @@ -1838,9 +1832,8 @@ func (s *OrganizationOwner) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1858,8 +1851,8 @@ func (s *OrganizationOwner) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1898,9 +1891,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2258,11 +2250,10 @@ func (s *SetOrgPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2305,8 +2296,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -6562,8 +6552,7 @@ type ProjectsGetIamPolicyCall struct { // exist. Authorization requires the Google IAM permission // `resourcemanager.projects.getIamPolicy` on the project. For // additional information about `resource` (e.g. my-project-id) -// structure and identification, see [Resource -// Names](https://cloud.google.com/apis/design/resource_names). +// structure and identification, see Resource Names. func (r *ProjectsService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsGetIamPolicyCall { c := &ProjectsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -7411,14 +7400,13 @@ type ProjectsSetIamPolicyCall struct { // services completely inoperable. It is important to understand how the // service account is being used before removing or updating its roles. // For additional information about `resource` (e.g. my-project-id) -// structure and identification, see [Resource -// Names](https://cloud.google.com/apis/design/resource_names). The -// following constraints apply when using `setIamPolicy()`: + Project -// does not support `allUsers` and `allAuthenticatedUsers` as `members` -// in a `Binding` of a `Policy`. + The owner role can be granted to a -// `user`, `serviceAccount`, or a group that is part of an organization. -// For example, group@myownpersonaldomain.com could be added as an owner -// to a project in the myownpersonaldomain.com organization, but not the +// structure and identification, see Resource Names. The following +// constraints apply when using `setIamPolicy()`: + Project does not +// support `allUsers` and `allAuthenticatedUsers` as `members` in a +// `Binding` of a `Policy`. + The owner role can be granted to a `user`, +// `serviceAccount`, or a group that is part of an organization. For +// example, group@myownpersonaldomain.com could be added as an owner to +// a project in the myownpersonaldomain.com organization, but not the // examplepetstore.com organization. + Service accounts can be made // owners of a project directly without any restrictions. However, to be // added as an owner, a user must be invited via Cloud Platform console @@ -7724,9 +7712,8 @@ type ProjectsTestIamPermissionsCall struct { // TestIamPermissions: Returns permissions that a caller has on the // specified Project. For additional information about `resource` (e.g. -// my-project-id) structure and identification, see [Resource -// Names](https://cloud.google.com/apis/design/resource_names). There -// are no permissions required for making this API call. +// my-project-id) structure and identification, see Resource Names. +// There are no permissions required for making this API call. func (r *ProjectsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsTestIamPermissionsCall { c := &ProjectsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource diff --git a/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go b/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go index df9d5401e2f..5afec419a27 100644 --- a/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go @@ -297,9 +297,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -807,9 +805,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1074,9 +1070,8 @@ func (s *OrganizationOwner) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1094,8 +1089,8 @@ func (s *OrganizationOwner) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1134,9 +1129,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1369,8 +1363,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2989,7 +2982,7 @@ type ProjectsGetIamPolicyCall struct { // GetIamPolicy: Returns the IAM access control policy for the specified // Project. Permission is denied if the policy or the resource does not // exist. For additional information about resource structure and -// identification, see [Resource Names](/apis/design/resource_names). +// identification, see Resource Names. func (r *ProjectsService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsGetIamPolicyCall { c := &ProjectsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource diff --git a/cloudresourcemanager/v2/cloudresourcemanager-gen.go b/cloudresourcemanager/v2/cloudresourcemanager-gen.go index 4462be336bb..a597ae52903 100644 --- a/cloudresourcemanager/v2/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v2/cloudresourcemanager-gen.go @@ -269,9 +269,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -789,9 +787,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1001,9 +997,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1021,8 +1016,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1061,9 +1056,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1260,11 +1254,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1307,8 +1300,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go b/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go index 6610a0bf16a..d6025f60c56 100644 --- a/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go @@ -269,9 +269,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -789,9 +787,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1001,9 +997,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1021,8 +1016,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1061,9 +1056,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1260,11 +1254,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1307,8 +1300,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/cloudscheduler/v1/cloudscheduler-gen.go b/cloudscheduler/v1/cloudscheduler-gen.go index 018ec8561b1..8a08d32897c 100644 --- a/cloudscheduler/v1/cloudscheduler-gen.go +++ b/cloudscheduler/v1/cloudscheduler-gen.go @@ -255,22 +255,14 @@ func (s *AppEngineHttpTarget) MarshalJSON() ([]byte, error) { } // AppEngineRouting: App Engine Routing. For more information about -// services, versions, and instances see [An Overview of App -// Engine](https://cloud.google.com/appengine/docs/python/an-overview-of- -// app-engine), [Microservices Architecture on Google App -// Engine](https://cloud.google.com/appengine/docs/python/microservices-o -// n-app-engine), [App Engine Standard request -// routing](https://cloud.google.com/appengine/docs/standard/python/how-r -// equests-are-routed), and [App Engine Flex request -// routing](https://cloud.google.com/appengine/docs/flexible/python/how-r -// equests-are-routed). +// services, versions, and instances see An Overview of App Engine, +// Microservices Architecture on Google App Engine, App Engine Standard +// request routing, and App Engine Flex request routing. type AppEngineRouting struct { // Host: Output only. The host that the job is sent to. For more - // information about how App Engine requests are routed, see - // [here](https://cloud.google.com/appengine/docs/standard/python/how-req - // uests-are-routed). The host is constructed as: * `host = - // [application_domain_name]` `| [service] + '.' + - // [application_domain_name]` `| [version] + '.' + + // information about how App Engine requests are routed, see here. The + // host is constructed as: * `host = [application_domain_name]` `| + // [service] + '.' + [application_domain_name]` `| [version] + '.' + // [application_domain_name]` `| [version_dot_service]+ '.' + // [application_domain_name]` `| [instance] + '.' + // [application_domain_name]` `| [instance_dot_service] + '.' + @@ -295,15 +287,10 @@ type AppEngineRouting struct { // Instance: App instance. By default, the job is sent to an instance // which is available when the job is attempted. Requests can only be - // sent to a specific instance if [manual scaling is used in App Engine - // Standard](https://cloud.google.com/appengine/docs/python/an-overview-o - // f-app-engine?hl=en_US#scaling_types_and_instance_classes). App Engine - // Flex does not support instances. For more information, see [App - // Engine Standard request - // routing](https://cloud.google.com/appengine/docs/standard/python/how-r - // equests-are-routed) and [App Engine Flex request - // routing](https://cloud.google.com/appengine/docs/flexible/python/how-r - // equests-are-routed). + // sent to a specific instance if manual scaling is used in App Engine + // Standard. App Engine Flex does not support instances. For more + // information, see App Engine Standard request routing and App Engine + // Flex request routing. Instance string `json:"instance,omitempty"` // Service: App service. By default, the job is sent to the service @@ -389,19 +376,16 @@ type HttpTarget struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` - // OauthToken: If specified, an [OAuth - // token](https://developers.google.com/identity/protocols/OAuth2) will - // be generated and attached as an `Authorization` header in the HTTP - // request. This type of authorization should generally only be used - // when calling Google APIs hosted on *.googleapis.com. + // OauthToken: If specified, an OAuth token will be generated and + // attached as an `Authorization` header in the HTTP request. This type + // of authorization should generally only be used when calling Google + // APIs hosted on *.googleapis.com. OauthToken *OAuthToken `json:"oauthToken,omitempty"` - // OidcToken: If specified, an - // [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) - // token will be generated and attached as an `Authorization` header in - // the HTTP request. This type of authorization can be used for many - // scenarios, including calling Cloud Run, or endpoints where you intend - // to validate the token yourself. + // OidcToken: If specified, an OIDC token will be generated and attached + // as an `Authorization` header in the HTTP request. This type of + // authorization can be used for many scenarios, including calling Cloud + // Run, or endpoints where you intend to validate the token yourself. OidcToken *OidcToken `json:"oidcToken,omitempty"` // Uri: Required. The full URI path that the request will be sent to. @@ -467,11 +451,9 @@ type Job struct { // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. * // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see - // [Identifying - // projects](https://cloud.google.com/resource-manager/docs/creating-mana - // ging-projects#identifying_projects) * `LOCATION_ID` is the canonical - // ID for the job's location. The list of available locations can be - // obtained by calling ListLocations. For more information, see + // Identifying projects * `LOCATION_ID` is the canonical ID for the + // job's location. The list of available locations can be obtained by + // calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `JOB_ID` can contain // only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores // (_). The maximum length is 500 characters. @@ -485,17 +467,15 @@ type Job struct { // Schedule: Required, except when used with UpdateJob. Describes the // schedule on which the job will be executed. The schedule can be - // either of the following types: * - // [Crontab](http://en.wikipedia.org/wiki/Cron#Overview) * English-like - // [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-jo - // b-schedules) As a general rule, execution `n + 1` of a job will not - // begin until execution `n` has finished. Cloud Scheduler will never - // allow two simultaneously outstanding executions. For example, this - // implies that if the `n+1`th execution is scheduled to run at 16:00 - // but the `n`th execution takes until 16:15, the `n+1`th execution will - // not start until `16:15`. A scheduled start time will be delayed if - // the previous execution has not ended when its scheduled time occurs. - // If retry_count > 0 and a job attempt fails, the job will be tried a + // either of the following types: * Crontab * English-like schedule As a + // general rule, execution `n + 1` of a job will not begin until + // execution `n` has finished. Cloud Scheduler will never allow two + // simultaneously outstanding executions. For example, this implies that + // if the `n+1`th execution is scheduled to run at 16:00 but the `n`th + // execution takes until 16:15, the `n+1`th execution will not start + // until `16:15`. A scheduled start time will be delayed if the previous + // execution has not ended when its scheduled time occurs. If + // retry_count > 0 and a job attempt fails, the job will be tried a // total of retry_count times, with exponential backoff, until the next // scheduled start time. Schedule string `json:"schedule,omitempty"` @@ -526,11 +506,11 @@ type Job struct { // TimeZone: Specifies the time zone to be used in interpreting // schedule. The value of this field must be a time zone name from the - // [tz database](http://en.wikipedia.org/wiki/Tz_database). Note that - // some time zones include a provision for daylight savings time. The - // rules for daylight saving time are determined by the chosen tz. For - // UTC use the string "utc". If a time zone is not specified, the - // default will be in UTC (also known as GMT). + // tz database. Note that some time zones include a provision for + // daylight savings time. The rules for daylight saving time are + // determined by the chosen tz. For UTC use the string "utc". If a time + // zone is not specified, the default will be in UTC (also known as + // GMT). TimeZone string `json:"timeZone,omitempty"` // UserUpdateTime: Output only. The creation time of the job. @@ -690,21 +670,19 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OAuthToken: Contains information needed for generating an [OAuth -// token](https://developers.google.com/identity/protocols/OAuth2). This -// type of authorization should generally only be used when calling -// Google APIs hosted on *.googleapis.com. +// OAuthToken: Contains information needed for generating an OAuth +// token. This type of authorization should generally only be used when +// calling Google APIs hosted on *.googleapis.com. type OAuthToken struct { // Scope: OAuth scope to be used for generating OAuth access token. If // not specified, "https://www.googleapis.com/auth/cloud-platform" will // be used. Scope string `json:"scope,omitempty"` - // ServiceAccountEmail: [Service account - // email](https://cloud.google.com/iam/docs/service-accounts) to be used - // for generating OAuth token. The service account must be within the - // same project as the job. The caller must have - // iam.serviceAccounts.actAs permission for the service account. + // ServiceAccountEmail: Service account email to be used for generating + // OAuth token. The service account must be within the same project as + // the job. The caller must have iam.serviceAccounts.actAs permission + // for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Scope") to @@ -730,22 +708,19 @@ func (s *OAuthToken) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OidcToken: Contains information needed for generating an [OpenID -// Connect -// token](https://developers.google.com/identity/protocols/OpenIDConnect) -// . This type of authorization can be used for many scenarios, -// including calling Cloud Run, or endpoints where you intend to -// validate the token yourself. +// OidcToken: Contains information needed for generating an OpenID +// Connect token. This type of authorization can be used for many +// scenarios, including calling Cloud Run, or endpoints where you intend +// to validate the token yourself. type OidcToken struct { // Audience: Audience to be used when generating OIDC token. If not // specified, the URI specified in target will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: [Service account - // email](https://cloud.google.com/iam/docs/service-accounts) to be used - // for generating OIDC token. The service account must be within the - // same project as the job. The caller must have - // iam.serviceAccounts.actAs permission for the service account. + // ServiceAccountEmail: Service account email to be used for generating + // OIDC token. The service account must be within the same project as + // the job. The caller must have iam.serviceAccounts.actAs permission + // for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Audience") to @@ -779,11 +754,9 @@ type PauseJobRequest struct { // by subscribers. The message must contain either a non-empty data // field or at least one attribute. Note that client libraries represent // this object differently depending on the language. See the -// corresponding [client library -// documentation](https://cloud.google.com/pubsub/docs/reference/librarie -// s) for more information. See [quotas and limits] -// (https://cloud.google.com/pubsub/quotas) for more information about -// message limits. +// corresponding client library documentation for more information. See +// [quotas and limits] (https://cloud.google.com/pubsub/quotas) for more +// information about message limits. type PubsubMessage struct { // Attributes: Attributes for this message. If this field is empty, the // message must contain non-empty data. This can be used to filter @@ -852,8 +825,7 @@ type PubsubTarget struct { // TopicName: Required. The name of the Cloud Pub/Sub topic to which // messages will be published when a job is delivered. The topic name // must be in the same format as required by PubSub's - // [PublishRequest.name](https://cloud.google.com/pubsub/docs/reference/r - // pc/google.pubsub.v1#publishrequest), for example + // PublishRequest.name, for example // `projects/PROJECT_ID/topics/TOPIC_ID`. The topic must be in the same // project as the Cloud Scheduler job. TopicName string `json:"topicName,omitempty"` @@ -964,11 +936,10 @@ type RunJobRequest struct { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/cloudscheduler/v1beta1/cloudscheduler-gen.go b/cloudscheduler/v1beta1/cloudscheduler-gen.go index 9716eed4632..190f83abd4e 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-gen.go +++ b/cloudscheduler/v1beta1/cloudscheduler-gen.go @@ -255,22 +255,14 @@ func (s *AppEngineHttpTarget) MarshalJSON() ([]byte, error) { } // AppEngineRouting: App Engine Routing. For more information about -// services, versions, and instances see [An Overview of App -// Engine](https://cloud.google.com/appengine/docs/python/an-overview-of- -// app-engine), [Microservices Architecture on Google App -// Engine](https://cloud.google.com/appengine/docs/python/microservices-o -// n-app-engine), [App Engine Standard request -// routing](https://cloud.google.com/appengine/docs/standard/python/how-r -// equests-are-routed), and [App Engine Flex request -// routing](https://cloud.google.com/appengine/docs/flexible/python/how-r -// equests-are-routed). +// services, versions, and instances see An Overview of App Engine, +// Microservices Architecture on Google App Engine, App Engine Standard +// request routing, and App Engine Flex request routing. type AppEngineRouting struct { // Host: Output only. The host that the job is sent to. For more - // information about how App Engine requests are routed, see - // [here](https://cloud.google.com/appengine/docs/standard/python/how-req - // uests-are-routed). The host is constructed as: * `host = - // [application_domain_name]` `| [service] + '.' + - // [application_domain_name]` `| [version] + '.' + + // information about how App Engine requests are routed, see here. The + // host is constructed as: * `host = [application_domain_name]` `| + // [service] + '.' + [application_domain_name]` `| [version] + '.' + // [application_domain_name]` `| [version_dot_service]+ '.' + // [application_domain_name]` `| [instance] + '.' + // [application_domain_name]` `| [instance_dot_service] + '.' + @@ -295,15 +287,10 @@ type AppEngineRouting struct { // Instance: App instance. By default, the job is sent to an instance // which is available when the job is attempted. Requests can only be - // sent to a specific instance if [manual scaling is used in App Engine - // Standard](https://cloud.google.com/appengine/docs/python/an-overview-o - // f-app-engine?hl=en_US#scaling_types_and_instance_classes). App Engine - // Flex does not support instances. For more information, see [App - // Engine Standard request - // routing](https://cloud.google.com/appengine/docs/standard/python/how-r - // equests-are-routed) and [App Engine Flex request - // routing](https://cloud.google.com/appengine/docs/flexible/python/how-r - // equests-are-routed). + // sent to a specific instance if manual scaling is used in App Engine + // Standard. App Engine Flex does not support instances. For more + // information, see App Engine Standard request routing and App Engine + // Flex request routing. Instance string `json:"instance,omitempty"` // Service: App service. By default, the job is sent to the service @@ -389,19 +376,16 @@ type HttpTarget struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` - // OauthToken: If specified, an [OAuth - // token](https://developers.google.com/identity/protocols/OAuth2) will - // be generated and attached as an `Authorization` header in the HTTP - // request. This type of authorization should generally only be used - // when calling Google APIs hosted on *.googleapis.com. + // OauthToken: If specified, an OAuth token will be generated and + // attached as an `Authorization` header in the HTTP request. This type + // of authorization should generally only be used when calling Google + // APIs hosted on *.googleapis.com. OauthToken *OAuthToken `json:"oauthToken,omitempty"` - // OidcToken: If specified, an - // [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) - // token will be generated and attached as an `Authorization` header in - // the HTTP request. This type of authorization can be used for many - // scenarios, including calling Cloud Run, or endpoints where you intend - // to validate the token yourself. + // OidcToken: If specified, an OIDC token will be generated and attached + // as an `Authorization` header in the HTTP request. This type of + // authorization can be used for many scenarios, including calling Cloud + // Run, or endpoints where you intend to validate the token yourself. OidcToken *OidcToken `json:"oidcToken,omitempty"` // Uri: Required. The full URI path that the request will be sent to. @@ -474,11 +458,9 @@ type Job struct { // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. * // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see - // [Identifying - // projects](https://cloud.google.com/resource-manager/docs/creating-mana - // ging-projects#identifying_projects) * `LOCATION_ID` is the canonical - // ID for the job's location. The list of available locations can be - // obtained by calling ListLocations. For more information, see + // Identifying projects * `LOCATION_ID` is the canonical ID for the + // job's location. The list of available locations can be obtained by + // calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `JOB_ID` can contain // only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores // (_). The maximum length is 500 characters. @@ -492,17 +474,15 @@ type Job struct { // Schedule: Required, except when used with UpdateJob. Describes the // schedule on which the job will be executed. The schedule can be - // either of the following types: * - // [Crontab](http://en.wikipedia.org/wiki/Cron#Overview) * English-like - // [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-jo - // b-schedules) As a general rule, execution `n + 1` of a job will not - // begin until execution `n` has finished. Cloud Scheduler will never - // allow two simultaneously outstanding executions. For example, this - // implies that if the `n+1`th execution is scheduled to run at 16:00 - // but the `n`th execution takes until 16:15, the `n+1`th execution will - // not start until `16:15`. A scheduled start time will be delayed if - // the previous execution has not ended when its scheduled time occurs. - // If retry_count > 0 and a job attempt fails, the job will be tried a + // either of the following types: * Crontab * English-like schedule As a + // general rule, execution `n + 1` of a job will not begin until + // execution `n` has finished. Cloud Scheduler will never allow two + // simultaneously outstanding executions. For example, this implies that + // if the `n+1`th execution is scheduled to run at 16:00 but the `n`th + // execution takes until 16:15, the `n+1`th execution will not start + // until `16:15`. A scheduled start time will be delayed if the previous + // execution has not ended when its scheduled time occurs. If + // retry_count > 0 and a job attempt fails, the job will be tried a // total of retry_count times, with exponential backoff, until the next // scheduled start time. Schedule string `json:"schedule,omitempty"` @@ -533,11 +513,11 @@ type Job struct { // TimeZone: Specifies the time zone to be used in interpreting // schedule. The value of this field must be a time zone name from the - // [tz database](http://en.wikipedia.org/wiki/Tz_database). Note that - // some time zones include a provision for daylight savings time. The - // rules for daylight saving time are determined by the chosen tz. For - // UTC use the string "utc". If a time zone is not specified, the - // default will be in UTC (also known as GMT). + // tz database. Note that some time zones include a provision for + // daylight savings time. The rules for daylight saving time are + // determined by the chosen tz. For UTC use the string "utc". If a time + // zone is not specified, the default will be in UTC (also known as + // GMT). TimeZone string `json:"timeZone,omitempty"` // UserUpdateTime: Output only. The creation time of the job. @@ -697,21 +677,19 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OAuthToken: Contains information needed for generating an [OAuth -// token](https://developers.google.com/identity/protocols/OAuth2). This -// type of authorization should generally only be used when calling -// Google APIs hosted on *.googleapis.com. +// OAuthToken: Contains information needed for generating an OAuth +// token. This type of authorization should generally only be used when +// calling Google APIs hosted on *.googleapis.com. type OAuthToken struct { // Scope: OAuth scope to be used for generating OAuth access token. If // not specified, "https://www.googleapis.com/auth/cloud-platform" will // be used. Scope string `json:"scope,omitempty"` - // ServiceAccountEmail: [Service account - // email](https://cloud.google.com/iam/docs/service-accounts) to be used - // for generating OAuth token. The service account must be within the - // same project as the job. The caller must have - // iam.serviceAccounts.actAs permission for the service account. + // ServiceAccountEmail: Service account email to be used for generating + // OAuth token. The service account must be within the same project as + // the job. The caller must have iam.serviceAccounts.actAs permission + // for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Scope") to @@ -737,22 +715,19 @@ func (s *OAuthToken) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OidcToken: Contains information needed for generating an [OpenID -// Connect -// token](https://developers.google.com/identity/protocols/OpenIDConnect) -// . This type of authorization can be used for many scenarios, -// including calling Cloud Run, or endpoints where you intend to -// validate the token yourself. +// OidcToken: Contains information needed for generating an OpenID +// Connect token. This type of authorization can be used for many +// scenarios, including calling Cloud Run, or endpoints where you intend +// to validate the token yourself. type OidcToken struct { // Audience: Audience to be used when generating OIDC token. If not // specified, the URI specified in target will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: [Service account - // email](https://cloud.google.com/iam/docs/service-accounts) to be used - // for generating OIDC token. The service account must be within the - // same project as the job. The caller must have - // iam.serviceAccounts.actAs permission for the service account. + // ServiceAccountEmail: Service account email to be used for generating + // OIDC token. The service account must be within the same project as + // the job. The caller must have iam.serviceAccounts.actAs permission + // for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Audience") to @@ -786,11 +761,9 @@ type PauseJobRequest struct { // by subscribers. The message must contain either a non-empty data // field or at least one attribute. Note that client libraries represent // this object differently depending on the language. See the -// corresponding [client library -// documentation](https://cloud.google.com/pubsub/docs/reference/librarie -// s) for more information. See [quotas and limits] -// (https://cloud.google.com/pubsub/quotas) for more information about -// message limits. +// corresponding client library documentation for more information. See +// [quotas and limits] (https://cloud.google.com/pubsub/quotas) for more +// information about message limits. type PubsubMessage struct { // Attributes: Attributes for this message. If this field is empty, the // message must contain non-empty data. This can be used to filter @@ -859,8 +832,7 @@ type PubsubTarget struct { // TopicName: Required. The name of the Cloud Pub/Sub topic to which // messages will be published when a job is delivered. The topic name // must be in the same format as required by PubSub's - // [PublishRequest.name](https://cloud.google.com/pubsub/docs/reference/r - // pc/google.pubsub.v1#publishrequest), for example + // PublishRequest.name, for example // `projects/PROJECT_ID/topics/TOPIC_ID`. The topic must be in the same // project as the Cloud Scheduler job. TopicName string `json:"topicName,omitempty"` @@ -999,11 +971,10 @@ func (s *RunJobRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/cloudsearch/v1/cloudsearch-gen.go b/cloudsearch/v1/cloudsearch-gen.go index 35a56830358..0f927cf8095 100644 --- a/cloudsearch/v1/cloudsearch-gen.go +++ b/cloudsearch/v1/cloudsearch-gen.go @@ -915,9 +915,9 @@ func (s *DataSourceRestriction) MarshalJSON() ([]byte, error) { // Date: Represents a whole calendar date, for example a date of birth. // The time of day and time zone are either specified elsewhere or are -// not significant. The date is relative to the [Proleptic Gregorian -// Calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar). -// The date must be a valid calendar date between the year 1 and 9999. +// not significant. The date is relative to the Proleptic Gregorian +// Calendar. The date must be a valid calendar date between the year 1 +// and 9999. type Date struct { // Day: Day of month. Must be from 1 to 31 and valid for the year and // month. @@ -2670,7 +2670,7 @@ func (s *Item) MarshalJSON() ([]byte, error) { } // ItemAcl: Access control list information for the item. For more -// information see [Map ACLs](/cloud-search/docs/guides/acls). +// information see Map ACLs. type ItemAcl struct { // AclInheritanceType: Sets the type of access rules to apply when an // item inherits its ACL from a parent. This should always be set in @@ -4586,16 +4586,13 @@ type RequestOptions struct { LanguageCode string `json:"languageCode,omitempty"` // SearchApplicationId: The ID generated when you create a search - // application using the [admin - // console](https://support.google.com/a/answer/9043922). + // application using the admin console. SearchApplicationId string `json:"searchApplicationId,omitempty"` // TimeZone: Current user's time zone id, such as "America/Los_Angeles" - // or "Australia/Sydney". These IDs are defined by [Unicode Common - // Locale Data Repository (CLDR)](http://cldr.unicode.org/) project, and - // currently available in the file - // [timezone.xml](http://unicode.org/repos/cldr/trunk/common/bcp47/timezo - // ne.xml). This field is used to correctly interpret date and time + // or "Australia/Sydney". These IDs are defined by Unicode Common Locale + // Data Repository (CLDR) project, and currently available in the file + // timezone.xml. This field is used to correctly interpret date and time // queries. If this field is not specified, the default time zone (UTC) // is used. TimeZone string `json:"timeZone,omitempty"` @@ -5280,8 +5277,7 @@ type SearchRequest struct { PageSize int64 `json:"pageSize,omitempty"` // Query: The raw query string. See supported search operators in the - // [Cloud search Cheat - // Sheet](https://support.google.com/a/users/answer/9299929) + // Cloud search Cheat Sheet Query string `json:"query,omitempty"` // QueryInterpretationOptions: Options to interpret the user query. @@ -5763,11 +5759,10 @@ func (s *StartUploadItemRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -9435,21 +9430,15 @@ type MediaUploadCall struct { // Upload: Uploads media for indexing. The upload endpoint supports // direct and resumable upload protocols and is intended for large items -// that can not be [inlined during index -// requests](https://developers.google.com/cloud-search/docs/reference/re -// st/v1/indexing.datasources.items#itemcontent). To index large +// that can not be inlined during index requests. To index large // content: 1. Call indexing.datasources.items.upload with the item name // to begin an upload session and retrieve the UploadItemRef. 1. Call // media.upload to upload the content, as a streaming request, using the // same resource name from the UploadItemRef from step 1. 1. Call // indexing.datasources.items.index to index the item. Populate the -// [ItemContent](/cloud-search/docs/reference/rest/v1/indexing.datasource -// s.items#ItemContent) with the UploadItemRef from step 1. For -// additional information, see [Create a content connector using the -// REST -// API](https://developers.google.com/cloud-search/docs/guides/content-co -// nnector#rest). **Note:** This API requires a service account to -// execute. +// ItemContent with the UploadItemRef from step 1. For additional +// information, see Create a content connector using the REST API. +// **Note:** This API requires a service account to execute. func (r *MediaService) Upload(resourceName string, media *Media) *MediaUploadCall { c := &MediaUploadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resourceName = resourceName @@ -10041,9 +10030,8 @@ type QuerySearchCall struct { // come from data that you have indexed from a third party. **Note:** // This API requires a standard end user account to execute. A service // account can't perform Query API requests directly; to use a service -// account to perform queries, set up [G Suite domain-wide delegation of -// authority](https://developers.google.com/cloud-search/docs/guides/dele -// gation/). +// account to perform queries, set up G Suite domain-wide delegation of +// authority. func (r *QueryService) Search(searchrequest *SearchRequest) *QuerySearchCall { c := &QuerySearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.searchrequest = searchrequest @@ -10172,9 +10160,8 @@ type QuerySuggestCall struct { // Suggest: Provides suggestions for autocompleting the query. **Note:** // This API requires a standard end user account to execute. A service // account can't perform Query API requests directly; to use a service -// account to perform queries, set up [G Suite domain-wide delegation of -// authority](https://developers.google.com/cloud-search/docs/guides/dele -// gation/). +// account to perform queries, set up G Suite domain-wide delegation of +// authority. func (r *QueryService) Suggest(suggestrequest *SuggestRequest) *QuerySuggestCall { c := &QuerySuggestCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.suggestrequest = suggestrequest @@ -10303,10 +10290,8 @@ type QuerySourcesListCall struct { // List: Returns list of sources that user can use for Search and // Suggest APIs. **Note:** This API requires a standard end user account // to execute. A service account can't perform Query API requests -// directly; to use a service account to perform queries, set up [G -// Suite domain-wide delegation of -// authority](https://developers.google.com/cloud-search/docs/guides/dele -// gation/). +// directly; to use a service account to perform queries, set up G Suite +// domain-wide delegation of authority. func (r *QuerySourcesService) List() *QuerySourcesListCall { c := &QuerySourcesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -10345,8 +10330,7 @@ func (c *QuerySourcesListCall) RequestOptionsLanguageCode(requestOptionsLanguage // RequestOptionsSearchApplicationId sets the optional parameter // "requestOptions.searchApplicationId": The ID generated when you -// create a search application using the [admin -// console](https://support.google.com/a/answer/9043922). +// create a search application using the admin console. func (c *QuerySourcesListCall) RequestOptionsSearchApplicationId(requestOptionsSearchApplicationId string) *QuerySourcesListCall { c.urlParams_.Set("requestOptions.searchApplicationId", requestOptionsSearchApplicationId) return c @@ -10355,13 +10339,10 @@ func (c *QuerySourcesListCall) RequestOptionsSearchApplicationId(requestOptionsS // RequestOptionsTimeZone sets the optional parameter // "requestOptions.timeZone": Current user's time zone id, such as // "America/Los_Angeles" or "Australia/Sydney". These IDs are defined by -// [Unicode Common Locale Data Repository -// (CLDR)](http://cldr.unicode.org/) project, and currently available in -// the file -// [timezone.xml](http://unicode.org/repos/cldr/trunk/common/bcp47/timezo -// ne.xml). This field is used to correctly interpret date and time -// queries. If this field is not specified, the default time zone (UTC) -// is used. +// Unicode Common Locale Data Repository (CLDR) project, and currently +// available in the file timezone.xml. This field is used to correctly +// interpret date and time queries. If this field is not specified, the +// default time zone (UTC) is used. func (c *QuerySourcesListCall) RequestOptionsTimeZone(requestOptionsTimeZone string) *QuerySourcesListCall { c.urlParams_.Set("requestOptions.timeZone", requestOptionsTimeZone) return c diff --git a/cloudshell/v1/cloudshell-gen.go b/cloudshell/v1/cloudshell-gen.go index 3634ab16795..704c8f3aa3b 100644 --- a/cloudshell/v1/cloudshell-gen.go +++ b/cloudshell/v1/cloudshell-gen.go @@ -643,11 +643,10 @@ func (s *StartEnvironmentResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/cloudshell/v1alpha1/cloudshell-gen.go b/cloudshell/v1alpha1/cloudshell-gen.go index 86e201b3705..0562df2cddf 100644 --- a/cloudshell/v1alpha1/cloudshell-gen.go +++ b/cloudshell/v1alpha1/cloudshell-gen.go @@ -586,11 +586,10 @@ func (s *StartEnvironmentResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/cloudtasks/v2/cloudtasks-gen.go b/cloudtasks/v2/cloudtasks-gen.go index 0c88aaf1b81..4de1a522f6e 100644 --- a/cloudtasks/v2/cloudtasks-gen.go +++ b/cloudtasks/v2/cloudtasks-gen.go @@ -185,43 +185,36 @@ type ProjectsLocationsQueuesTasksService struct { // AppEngineHttpRequest: App Engine HTTP request. The message defines // the HTTP request that is sent to an App Engine app when the task is // dispatched. Using AppEngineHttpRequest requires -// [`appengine.applications.get`](https://cloud.google.com/appengine/docs -// /admin-api/access-control) Google IAM permission for the project and -// the following scope: `https://www.googleapis.com/auth/cloud-platform` -// The task will be delivered to the App Engine app which belongs to the -// same project as the queue. For more information, see [How Requests -// are -// Routed](https://cloud.google.com/appengine/docs/standard/python/how-re -// quests-are-routed) and how routing is affected by [dispatch -// files](https://cloud.google.com/appengine/docs/python/config/dispatchr -// ef). Traffic is encrypted during transport and never leaves Google -// datacenters. Because this traffic is carried over a communication -// mechanism internal to Google, you cannot explicitly set the protocol -// (for example, HTTP or HTTPS). The request to the handler, however, -// will appear to have used the HTTP protocol. The AppEngineRouting used -// to construct the URL that the task is delivered to can be set at the -// queue-level or task-level: * If app_engine_routing_override is set on -// the queue, this value is used for all tasks in the queue, no matter -// what the setting is for the task-level app_engine_routing. The `url` -// that the task will be sent to is: * `url =` host `+` relative_uri -// Tasks can be dispatched to secure app handlers, unsecure app -// handlers, and URIs restricted with [`login: -// admin`](https://cloud.google.com/appengine/docs/standard/python/config -// /appref). Because tasks are not run as any user, they cannot be -// dispatched to URIs restricted with [`login: -// required`](https://cloud.google.com/appengine/docs/standard/python/con -// fig/appref) Task dispatches also do not follow redirects. The task -// attempt has succeeded if the app's request handler returns an HTTP -// response code in the range [`200` - `299`]. The task attempt has -// failed if the app's handler returns a non-2xx response code or Cloud -// Tasks does not receive response before the deadline. Failed tasks -// will be retried according to the retry configuration. `503` (Service -// Unavailable) is considered an App Engine system error instead of an -// application error and will cause Cloud Tasks' traffic congestion -// control to temporarily throttle the queue's dispatches. Unlike other -// types of task targets, a `429` (Too Many Requests) response from an -// app handler does not cause traffic congestion control to throttle the -// queue. +// `appengine.applications.get` Google IAM permission for the project +// and the following scope: +// `https://www.googleapis.com/auth/cloud-platform` The task will be +// delivered to the App Engine app which belongs to the same project as +// the queue. For more information, see How Requests are Routed and how +// routing is affected by dispatch files. Traffic is encrypted during +// transport and never leaves Google datacenters. Because this traffic +// is carried over a communication mechanism internal to Google, you +// cannot explicitly set the protocol (for example, HTTP or HTTPS). The +// request to the handler, however, will appear to have used the HTTP +// protocol. The AppEngineRouting used to construct the URL that the +// task is delivered to can be set at the queue-level or task-level: * +// If app_engine_routing_override is set on the queue, this value is +// used for all tasks in the queue, no matter what the setting is for +// the task-level app_engine_routing. The `url` that the task will be +// sent to is: * `url =` host `+` relative_uri Tasks can be dispatched +// to secure app handlers, unsecure app handlers, and URIs restricted +// with `login: admin`. Because tasks are not run as any user, they +// cannot be dispatched to URIs restricted with `login: required` Task +// dispatches also do not follow redirects. The task attempt has +// succeeded if the app's request handler returns an HTTP response code +// in the range [`200` - `299`]. The task attempt has failed if the +// app's handler returns a non-2xx response code or Cloud Tasks does not +// receive response before the deadline. Failed tasks will be retried +// according to the retry configuration. `503` (Service Unavailable) is +// considered an App Engine system error instead of an application error +// and will cause Cloud Tasks' traffic congestion control to temporarily +// throttle the queue's dispatches. Unlike other types of task targets, +// a `429` (Too Many Requests) response from an app handler does not +// cause traffic congestion control to throttle the queue. type AppEngineHttpRequest struct { // AppEngineRouting: Task-level setting for App Engine routing. * If // app_engine_routing_override is set on the queue, this value is used @@ -252,9 +245,7 @@ type AppEngineHttpRequest struct { // below cannot be set or overridden: * `Host` * `X-Google-*` * // `X-AppEngine-*` In addition, Cloud Tasks sets some headers when the // task is dispatched, such as headers containing information about the - // task; see [request - // headers](https://cloud.google.com/tasks/docs/creating-appengine-handle - // rs#reading_request_headers). These headers are set only when the task + // task; see request headers. These headers are set only when the task // is dispatched, so they are not visible when the task is returned in a // Cloud Tasks response. Although there is no specific limit for the // maximum number of headers or the size, there is a limit on the @@ -266,12 +257,8 @@ type AppEngineHttpRequest struct { // POST. The app's request handler for the task's target URL must be // able to handle HTTP requests with this http_method, otherwise the // task attempt fails with error code 405 (Method Not Allowed). See - // [Writing a push task request - // handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/c - // reating-handlers#writing_a_push_task_request_handler) and the App - // Engine documentation for your runtime on [How Requests are - // Handled](https://cloud.google.com/appengine/docs/standard/python3/how- - // requests-are-handled). + // Writing a push task request handler and the App Engine documentation + // for your runtime on How Requests are Handled. // // Possible values: // "HTTP_METHOD_UNSPECIFIED" - HTTP method unspecified @@ -317,41 +304,27 @@ func (s *AppEngineHttpRequest) MarshalJSON() ([]byte, error) { // AppEngineRouting: App Engine Routing. Defines routing characteristics // specific to App Engine - service, version, and instance. For more -// information about services, versions, and instances see [An Overview -// of App -// Engine](https://cloud.google.com/appengine/docs/python/an-overview-of- -// app-engine), [Microservices Architecture on Google App -// Engine](https://cloud.google.com/appengine/docs/python/microservices-o -// n-app-engine), [App Engine Standard request -// routing](https://cloud.google.com/appengine/docs/standard/python/how-r -// equests-are-routed), and [App Engine Flex request -// routing](https://cloud.google.com/appengine/docs/flexible/python/how-r -// equests-are-routed). Using AppEngineRouting requires -// [`appengine.applications.get`](https://cloud.google.com/appengine/docs -// /admin-api/access-control) Google IAM permission for the project and -// the following scope: `https://www.googleapis.com/auth/cloud-platform` +// information about services, versions, and instances see An Overview +// of App Engine, Microservices Architecture on Google App Engine, App +// Engine Standard request routing, and App Engine Flex request routing. +// Using AppEngineRouting requires `appengine.applications.get` Google +// IAM permission for the project and the following scope: +// `https://www.googleapis.com/auth/cloud-platform` type AppEngineRouting struct { // Host: Output only. The host that the task is sent to. The host is // constructed from the domain name of the app associated with the // queue's project ID (for example .appspot.com), and the service, // version, and instance. Tasks which were created using the App Engine - // SDK might have a custom domain name. For more information, see [How - // Requests are - // Routed](https://cloud.google.com/appengine/docs/standard/python/how-re - // quests-are-routed). + // SDK might have a custom domain name. For more information, see How + // Requests are Routed. Host string `json:"host,omitempty"` // Instance: App instance. By default, the task is sent to an instance // which is available when the task is attempted. Requests can only be - // sent to a specific instance if [manual scaling is used in App Engine - // Standard](https://cloud.google.com/appengine/docs/python/an-overview-o - // f-app-engine?hl=en_US#scaling_types_and_instance_classes). App Engine - // Flex does not support instances. For more information, see [App - // Engine Standard request - // routing](https://cloud.google.com/appengine/docs/standard/python/how-r - // equests-are-routed) and [App Engine Flex request - // routing](https://cloud.google.com/appengine/docs/flexible/python/how-r - // equests-are-routed). + // sent to a specific instance if manual scaling is used in App Engine + // Standard. App Engine Flex does not support instances. For more + // information, see App Engine Standard request routing and App Engine + // Flex request routing. Instance string `json:"instance,omitempty"` // Service: App service. By default, the task is sent to the service @@ -449,9 +422,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -523,8 +494,7 @@ type CreateTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // [Google IAM](https://cloud.google.com/iam/) permission on the Task - // resource. + // Google IAM permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -696,9 +666,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -783,19 +751,16 @@ type HttpRequest struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` - // OauthToken: If specified, an [OAuth - // token](https://developers.google.com/identity/protocols/OAuth2) will - // be generated and attached as an `Authorization` header in the HTTP - // request. This type of authorization should generally only be used - // when calling Google APIs hosted on *.googleapis.com. + // OauthToken: If specified, an OAuth token will be generated and + // attached as an `Authorization` header in the HTTP request. This type + // of authorization should generally only be used when calling Google + // APIs hosted on *.googleapis.com. OauthToken *OAuthToken `json:"oauthToken,omitempty"` - // OidcToken: If specified, an - // [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) - // token will be generated and attached as an `Authorization` header in - // the HTTP request. This type of authorization can be used for many - // scenarios, including calling Cloud Run, or endpoints where you intend - // to validate the token yourself. + // OidcToken: If specified, an OIDC token will be generated and attached + // as an `Authorization` header in the HTTP request. This type of + // authorization can be used for many scenarios, including calling Cloud + // Run, or endpoints where you intend to validate the token yourself. OidcToken *OidcToken `json:"oidcToken,omitempty"` // Url: Required. The full url path that the request will be sent to. @@ -994,21 +959,19 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OAuthToken: Contains information needed for generating an [OAuth -// token](https://developers.google.com/identity/protocols/OAuth2). This -// type of authorization should generally only be used when calling -// Google APIs hosted on *.googleapis.com. +// OAuthToken: Contains information needed for generating an OAuth +// token. This type of authorization should generally only be used when +// calling Google APIs hosted on *.googleapis.com. type OAuthToken struct { // Scope: OAuth scope to be used for generating OAuth access token. If // not specified, "https://www.googleapis.com/auth/cloud-platform" will // be used. Scope string `json:"scope,omitempty"` - // ServiceAccountEmail: [Service account - // email](https://cloud.google.com/iam/docs/service-accounts) to be used - // for generating OAuth token. The service account must be within the - // same project as the queue. The caller must have - // iam.serviceAccounts.actAs permission for the service account. + // ServiceAccountEmail: Service account email to be used for generating + // OAuth token. The service account must be within the same project as + // the queue. The caller must have iam.serviceAccounts.actAs permission + // for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Scope") to @@ -1034,22 +997,19 @@ func (s *OAuthToken) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OidcToken: Contains information needed for generating an [OpenID -// Connect -// token](https://developers.google.com/identity/protocols/OpenIDConnect) -// . This type of authorization can be used for many scenarios, -// including calling Cloud Run, or endpoints where you intend to -// validate the token yourself. +// OidcToken: Contains information needed for generating an OpenID +// Connect token. This type of authorization can be used for many +// scenarios, including calling Cloud Run, or endpoints where you intend +// to validate the token yourself. type OidcToken struct { // Audience: Audience to be used when generating OIDC token. If not // specified, the URI specified in target will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: [Service account - // email](https://cloud.google.com/iam/docs/service-accounts) to be used - // for generating OIDC token. The service account must be within the - // same project as the queue. The caller must have - // iam.serviceAccounts.actAs permission for the service account. + // ServiceAccountEmail: Service account email to be used for generating + // OIDC token. The service account must be within the same project as + // the queue. The caller must have iam.serviceAccounts.actAs permission + // for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Audience") to @@ -1090,9 +1050,8 @@ type PauseQueueRequest struct { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1110,8 +1069,8 @@ type PauseQueueRequest struct { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1146,9 +1105,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1200,11 +1158,9 @@ type Queue struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` * // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see - // [Identifying - // projects](https://cloud.google.com/resource-manager/docs/creating-mana - // ging-projects#identifying_projects) * `LOCATION_ID` is the canonical - // ID for the queue's location. The list of available locations can be - // obtained by calling ListLocations. For more information, see + // Identifying projects * `LOCATION_ID` is the canonical ID for the + // queue's location. The list of available locations can be obtained by + // calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. @@ -1212,11 +1168,9 @@ type Queue struct { // PurgeTime: Output only. The last time this queue was purged. All // tasks that were created before this time were purged. A queue can be - // purged using PurgeQueue, the [App Engine Task Queue SDK, or the Cloud - // Console](https://cloud.google.com/appengine/docs/standard/python/taskq - // ueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). - // Purge time will be truncated to the nearest microsecond. Purge time - // will be unset if the queue has never been purged. + // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud + // Console. Purge time will be truncated to the nearest microsecond. + // Purge time will be unset if the queue has never been purged. PurgeTime string `json:"purgeTime,omitempty"` // RateLimits: Rate limits for task dispatches. rate_limits and @@ -1241,20 +1195,18 @@ type Queue struct { // settings cannot be set on individual tasks. * For tasks created using // the App Engine SDK: the queue-level retry settings apply to all tasks // in the queue which do not have retry settings explicitly set on the - // task and were created by the App Engine SDK. See [App Engine - // documentation](https://cloud.google.com/appengine/docs/standard/python - // /taskqueue/push/retrying-tasks). + // task and were created by the App Engine SDK. See App Engine + // documentation. RetryConfig *RetryConfig `json:"retryConfig,omitempty"` // StackdriverLoggingConfig: Configuration options for writing logs to - // [Stackdriver Logging](https://cloud.google.com/logging/docs/). If - // this field is unset, then no logs are written. + // Stackdriver Logging. If this field is unset, then no logs are + // written. StackdriverLoggingConfig *StackdriverLoggingConfig `json:"stackdriverLoggingConfig,omitempty"` // State: Output only. The state of the queue. `state` can only be // changed by called PauseQueue, ResumeQueue, or uploading - // [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config - // /queueref). UpdateQueue cannot be used to change `state`. + // queue.yaml/xml. UpdateQueue cannot be used to change `state`. // // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -1317,22 +1269,19 @@ type RateLimits struct { // queue and the rate is high. This field allows the queue to have a // high rate so processing starts shortly after a task is enqueued, but // still limits resource usage when many tasks are enqueued in a short - // period of time. The [token - // bucket](https://wikipedia.org/wiki/Token_Bucket) algorithm is used to - // control the rate of task dispatches. Each queue has a token bucket - // that holds tokens, up to the maximum specified by `max_burst_size`. - // Each time a task is dispatched, a token is removed from the bucket. - // Tasks will be dispatched until the queue's bucket runs out of tokens. - // The bucket will be continuously refilled with new tokens based on + // period of time. The token bucket algorithm is used to control the + // rate of task dispatches. Each queue has a token bucket that holds + // tokens, up to the maximum specified by `max_burst_size`. Each time a + // task is dispatched, a token is removed from the bucket. Tasks will be + // dispatched until the queue's bucket runs out of tokens. The bucket + // will be continuously refilled with new tokens based on // max_dispatches_per_second. Cloud Tasks will pick the value of // `max_burst_size` based on the value of max_dispatches_per_second. For // queues that were created or updated using `queue.yaml/xml`, - // `max_burst_size` is equal to - // [bucket_size](https://cloud.google.com/appengine/docs/standard/python/ - // config/queueref#bucket_size). Since `max_burst_size` is output only, - // if UpdateQueue is called on a queue created by `queue.yaml/xml`, - // `max_burst_size` will be reset based on the value of - // max_dispatches_per_second, regardless of whether + // `max_burst_size` is equal to bucket_size. Since `max_burst_size` is + // output only, if UpdateQueue is called on a queue created by + // `queue.yaml/xml`, `max_burst_size` will be reset based on the value + // of max_dispatches_per_second, regardless of whether // max_dispatches_per_second is updated. MaxBurstSize int64 `json:"maxBurstSize,omitempty"` @@ -1342,17 +1291,13 @@ type RateLimits struct { // the number of concurrent requests decreases. If unspecified when the // queue is created, Cloud Tasks will pick the default. The maximum // allowed value is 5,000. This field has the same meaning as - // [max_concurrent_requests in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#max_concurrent_requests). + // max_concurrent_requests in queue.yaml/xml. MaxConcurrentDispatches int64 `json:"maxConcurrentDispatches,omitempty"` // MaxDispatchesPerSecond: The maximum rate at which tasks are // dispatched from this queue. If unspecified when the queue is created, // Cloud Tasks will pick the default. * The maximum allowed value is - // 500. This field has the same meaning as [rate in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#rate). + // 500. This field has the same meaning as rate in queue.yaml/xml. MaxDispatchesPerSecond float64 `json:"maxDispatchesPerSecond,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxBurstSize") to @@ -1404,9 +1349,7 @@ type RetryConfig struct { // then there will be `max_attempts - 1` retries). Must be >= -1. If // unspecified when the queue is created, Cloud Tasks will pick the // default. -1 indicates unlimited attempts. This field has the same - // meaning as [task_retry_limit in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // meaning as task_retry_limit in queue.yaml/xml. MaxAttempts int64 `json:"maxAttempts,omitempty"` // MaxBackoff: A task will be scheduled for retry between min_backoff @@ -1414,9 +1357,7 @@ type RetryConfig struct { // specifies that the task should be retried. If unspecified when the // queue is created, Cloud Tasks will pick the default. `max_backoff` // will be truncated to the nearest second. This field has the same - // meaning as [max_backoff_seconds in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // meaning as max_backoff_seconds in queue.yaml/xml. MaxBackoff string `json:"maxBackoff,omitempty"` // MaxDoublings: The time between retries will double `max_doublings` @@ -1430,9 +1371,7 @@ type RetryConfig struct { // been attempted max_attempts times. Thus, the requests will retry at // 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, .... If unspecified when // the queue is created, Cloud Tasks will pick the default. This field - // has the same meaning as [max_doublings in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // has the same meaning as max_doublings in queue.yaml/xml. MaxDoublings int64 `json:"maxDoublings,omitempty"` // MaxRetryDuration: If positive, `max_retry_duration` specifies the @@ -1442,9 +1381,8 @@ type RetryConfig struct { // will be made and the task will be deleted. If zero, then the task age // is unlimited. If unspecified when the queue is created, Cloud Tasks // will pick the default. `max_retry_duration` will be truncated to the - // nearest second. This field has the same meaning as [task_age_limit in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // nearest second. This field has the same meaning as task_age_limit in + // queue.yaml/xml. MaxRetryDuration string `json:"maxRetryDuration,omitempty"` // MinBackoff: A task will be scheduled for retry between min_backoff @@ -1452,9 +1390,7 @@ type RetryConfig struct { // specifies that the task should be retried. If unspecified when the // queue is created, Cloud Tasks will pick the default. `min_backoff` // will be truncated to the nearest second. This field has the same - // meaning as [min_backoff_seconds in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // meaning as min_backoff_seconds in queue.yaml/xml. MinBackoff string `json:"minBackoff,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxAttempts") to @@ -1489,8 +1425,7 @@ type RunTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // [Google IAM](https://cloud.google.com/iam/) permission on the Task - // resource. + // Google IAM permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -1559,12 +1494,12 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { } // StackdriverLoggingConfig: Configuration options for writing logs to -// [Stackdriver Logging](https://cloud.google.com/logging/docs/). +// Stackdriver Logging. type StackdriverLoggingConfig struct { // SamplingRatio: Specifies the fraction of operations to write to - // [Stackdriver Logging](https://cloud.google.com/logging/docs/). This - // field may contain any value between 0.0 and 1.0, inclusive. 0.0 is - // the default and means that no operations are logged. + // Stackdriver Logging. This field may contain any value between 0.0 and + // 1.0, inclusive. 0.0 is the default and means that no operations are + // logged. SamplingRatio float64 `json:"samplingRatio,omitempty"` // ForceSendFields is a list of field names (e.g. "SamplingRatio") to @@ -1606,11 +1541,10 @@ func (s *StackdriverLoggingConfig) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1675,19 +1609,17 @@ type Task struct { // of request: * For HTTP tasks, the default is 10 minutes. The deadline // must be in the interval [15 seconds, 30 minutes]. * For App Engine // tasks, 0 indicates that the request has the default deadline. The - // default deadline depends on the [scaling - // type](https://cloud.google.com/appengine/docs/standard/go/how-instance - // s-are-managed#instance_scaling) of the service: 10 minutes for - // standard apps with automatic scaling, 24 hours for standard apps with - // manual and basic scaling, and 60 minutes for flex apps. If the - // request deadline is set, it must be in the interval [15 seconds, 24 - // hours 15 seconds]. Regardless of the task's `dispatch_deadline`, the - // app handler will not run for longer than than the service's timeout. - // We recommend setting the `dispatch_deadline` to at most a few seconds - // more than the app handler's timeout. For more information see - // [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-hand - // lers#timeouts). `dispatch_deadline` will be truncated to the nearest - // millisecond. The deadline is an approximate deadline. + // default deadline depends on the scaling type of the service: 10 + // minutes for standard apps with automatic scaling, 24 hours for + // standard apps with manual and basic scaling, and 60 minutes for flex + // apps. If the request deadline is set, it must be in the interval [15 + // seconds, 24 hours 15 seconds]. Regardless of the task's + // `dispatch_deadline`, the app handler will not run for longer than + // than the service's timeout. We recommend setting the + // `dispatch_deadline` to at most a few seconds more than the app + // handler's timeout. For more information see Timeouts. + // `dispatch_deadline` will be truncated to the nearest millisecond. The + // deadline is an approximate deadline. DispatchDeadline string `json:"dispatchDeadline,omitempty"` // FirstAttempt: Output only. The status of the task's first attempt. @@ -1707,11 +1639,9 @@ type Task struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ // ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), // hyphens (-), colons (:), or periods (.). For more information, see - // [Identifying - // projects](https://cloud.google.com/resource-manager/docs/creating-mana - // ging-projects#identifying_projects) * `LOCATION_ID` is the canonical - // ID for the task's location. The list of available locations can be - // obtained by calling ListLocations. For more information, see + // Identifying projects * `LOCATION_ID` is the canonical ID for the + // task's location. The list of available locations can be obtained by + // calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. * `TASK_ID` can contain only letters @@ -1777,8 +1707,7 @@ func (s *Task) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2201,8 +2130,7 @@ type ProjectsLocationsQueuesCreateCall struct { // task will be deleted regardless of whether it was dispatched or not. // WARNING: Using this method may have unintended side effects if you // are using an App Engine `queue.yaml` or `queue.xml` file to manage -// your queues. Read [Overview of Queue Management and -// queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before +// your queues. Read Overview of Queue Management and queue.yaml before // using this method. func (r *ProjectsLocationsQueuesService) Create(parent string, queue *Queue) *ProjectsLocationsQueuesCreateCall { c := &ProjectsLocationsQueuesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -2346,10 +2274,8 @@ type ProjectsLocationsQueuesDeleteCall struct { // it has tasks in it. Note: If you delete a queue, a queue with the // same name can't be created for 7 days. WARNING: Using this method may // have unintended side effects if you are using an App Engine -// `queue.yaml` or `queue.xml` file to manage your queues. Read -// [Overview of Queue Management and -// queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before -// using this method. +// `queue.yaml` or `queue.xml` file to manage your queues. Read Overview +// of Queue Management and queue.yaml before using this method. func (r *ProjectsLocationsQueuesService) Delete(name string) *ProjectsLocationsQueuesDeleteCall { c := &ProjectsLocationsQueuesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2626,9 +2552,8 @@ type ProjectsLocationsQueuesGetIamPolicyCall struct { // GetIamPolicy: Gets the access control policy for a Queue. Returns an // empty policy if the resource exists and does not have a policy set. -// Authorization requires the following [Google -// IAM](https://cloud.google.com/iam) permission on the specified -// resource parent: * `cloudtasks.queues.getIamPolicy` +// Authorization requires the following Google IAM permission on the +// specified resource parent: * `cloudtasks.queues.getIamPolicy` func (r *ProjectsLocationsQueuesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsQueuesGetIamPolicyCall { c := &ProjectsLocationsQueuesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -2778,11 +2703,10 @@ func (r *ProjectsLocationsQueuesService) List(parent string) *ProjectsLocationsQ // Filter sets the optional parameter "filter": `filter` can be used to // specify a subset of queues. Any Queue field can be used as a filter // and several operators as supported. For example: `<=, <, >=, >, !=, -// =, :`. The filter syntax is the same as described in [Stackdriver's -// Advanced Logs -// Filters](https://cloud.google.com/logging/docs/view/advanced_filters). -// Sample filter "state: PAUSED". Note that using filters might cause -// fewer queues than the requested page_size to be returned. +// =, :`. The filter syntax is the same as described in Stackdriver's +// Advanced Logs Filters. Sample filter "state: PAUSED". Note that using +// filters might cause fewer queues than the requested page_size to be +// returned. func (c *ProjectsLocationsQueuesListCall) Filter(filter string) *ProjectsLocationsQueuesListCall { c.urlParams_.Set("filter", filter) return c @@ -2989,10 +2913,8 @@ type ProjectsLocationsQueuesPatchCall struct { // task is 31 days old, the task will be deleted regardless of whether // it was dispatched or not. WARNING: Using this method may have // unintended side effects if you are using an App Engine `queue.yaml` -// or `queue.xml` file to manage your queues. Read [Overview of Queue -// Management and -// queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before -// using this method. +// or `queue.xml` file to manage your queues. Read Overview of Queue +// Management and queue.yaml before using this method. func (r *ProjectsLocationsQueuesService) Patch(name string, queue *Queue) *ProjectsLocationsQueuesPatchCall { c := &ProjectsLocationsQueuesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3437,8 +3359,7 @@ type ProjectsLocationsQueuesResumeCall struct { // state; after calling this method it will be set to RUNNING. WARNING: // Resuming many high-QPS queues at the same time can lead to target // overloading. If you are resuming high-QPS queues, follow the 500/50/5 -// pattern described in [Managing Cloud Tasks Scaling -// Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). +// pattern described in Managing Cloud Tasks Scaling Risks. func (r *ProjectsLocationsQueuesService) Resume(name string, resumequeuerequest *ResumeQueueRequest) *ProjectsLocationsQueuesResumeCall { c := &ProjectsLocationsQueuesResumeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3582,8 +3503,8 @@ type ProjectsLocationsQueuesSetIamPolicyCall struct { // any existing policy. Note: The Cloud Console does not check // queue-level IAM permissions yet. Project-level permissions are // required to use the Cloud Console. Authorization requires the -// following [Google IAM](https://cloud.google.com/iam) permission on -// the specified resource parent: * `cloudtasks.queues.setIamPolicy` +// following Google IAM permission on the specified resource parent: * +// `cloudtasks.queues.setIamPolicy` func (r *ProjectsLocationsQueuesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsQueuesSetIamPolicyCall { c := &ProjectsLocationsQueuesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -4155,8 +4076,8 @@ func (r *ProjectsLocationsQueuesTasksService) Get(name string) *ProjectsLocation // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` [Google -// IAM](https://cloud.google.com/iam/) permission on the Task resource. +// `cloudtasks.tasks.fullView` Google IAM permission on the Task +// resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -4362,8 +4283,8 @@ func (c *ProjectsLocationsQueuesTasksListCall) PageToken(pageToken string) *Proj // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` [Google -// IAM](https://cloud.google.com/iam/) permission on the Task resource. +// `cloudtasks.tasks.fullView` Google IAM permission on the Task +// resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. diff --git a/cloudtasks/v2beta2/cloudtasks-gen.go b/cloudtasks/v2beta2/cloudtasks-gen.go index 13865525a26..e5446328b5c 100644 --- a/cloudtasks/v2beta2/cloudtasks-gen.go +++ b/cloudtasks/v2beta2/cloudtasks-gen.go @@ -218,43 +218,36 @@ func (s *AcknowledgeTaskRequest) MarshalJSON() ([]byte, error) { // the HTTP request that is sent to an App Engine app when the task is // dispatched. This proto can only be used for tasks in a queue which // has app_engine_http_target set. Using AppEngineHttpRequest requires -// [`appengine.applications.get`](https://cloud.google.com/appengine/docs -// /admin-api/access-control) Google IAM permission for the project and -// the following scope: `https://www.googleapis.com/auth/cloud-platform` -// The task will be delivered to the App Engine app which belongs to the -// same project as the queue. For more information, see [How Requests -// are -// Routed](https://cloud.google.com/appengine/docs/standard/python/how-re -// quests-are-routed) and how routing is affected by [dispatch -// files](https://cloud.google.com/appengine/docs/python/config/dispatchr -// ef). Traffic is encrypted during transport and never leaves Google -// datacenters. Because this traffic is carried over a communication -// mechanism internal to Google, you cannot explicitly set the protocol -// (for example, HTTP or HTTPS). The request to the handler, however, -// will appear to have used the HTTP protocol. The AppEngineRouting used -// to construct the URL that the task is delivered to can be set at the -// queue-level or task-level: * If set, app_engine_routing_override is -// used for all tasks in the queue, no matter what the setting is for -// the task-level app_engine_routing. The `url` that the task will be -// sent to is: * `url =` host `+` relative_url Tasks can be dispatched -// to secure app handlers, unsecure app handlers, and URIs restricted -// with [`login: -// admin`](https://cloud.google.com/appengine/docs/standard/python/config -// /appref). Because tasks are not run as any user, they cannot be -// dispatched to URIs restricted with [`login: -// required`](https://cloud.google.com/appengine/docs/standard/python/con -// fig/appref) Task dispatches also do not follow redirects. The task -// attempt has succeeded if the app's request handler returns an HTTP -// response code in the range [`200` - `299`]. The task attempt has -// failed if the app's handler returns a non-2xx response code or Cloud -// Tasks does not receive response before the deadline. Failed tasks -// will be retried according to the retry configuration. `503` (Service -// Unavailable) is considered an App Engine system error instead of an -// application error and will cause Cloud Tasks' traffic congestion -// control to temporarily throttle the queue's dispatches. Unlike other -// types of task targets, a `429` (Too Many Requests) response from an -// app handler does not cause traffic congestion control to throttle the -// queue. +// `appengine.applications.get` Google IAM permission for the project +// and the following scope: +// `https://www.googleapis.com/auth/cloud-platform` The task will be +// delivered to the App Engine app which belongs to the same project as +// the queue. For more information, see How Requests are Routed and how +// routing is affected by dispatch files. Traffic is encrypted during +// transport and never leaves Google datacenters. Because this traffic +// is carried over a communication mechanism internal to Google, you +// cannot explicitly set the protocol (for example, HTTP or HTTPS). The +// request to the handler, however, will appear to have used the HTTP +// protocol. The AppEngineRouting used to construct the URL that the +// task is delivered to can be set at the queue-level or task-level: * +// If set, app_engine_routing_override is used for all tasks in the +// queue, no matter what the setting is for the task-level +// app_engine_routing. The `url` that the task will be sent to is: * +// `url =` host `+` relative_url Tasks can be dispatched to secure app +// handlers, unsecure app handlers, and URIs restricted with `login: +// admin`. Because tasks are not run as any user, they cannot be +// dispatched to URIs restricted with `login: required` Task dispatches +// also do not follow redirects. The task attempt has succeeded if the +// app's request handler returns an HTTP response code in the range +// [`200` - `299`]. The task attempt has failed if the app's handler +// returns a non-2xx response code or Cloud Tasks does not receive +// response before the deadline. Failed tasks will be retried according +// to the retry configuration. `503` (Service Unavailable) is considered +// an App Engine system error instead of an application error and will +// cause Cloud Tasks' traffic congestion control to temporarily throttle +// the queue's dispatches. Unlike other types of task targets, a `429` +// (Too Many Requests) response from an app handler does not cause +// traffic congestion control to throttle the queue. type AppEngineHttpRequest struct { // AppEngineRouting: Task-level setting for App Engine routing. If set, // app_engine_routing_override is used for all tasks in the queue, no @@ -279,26 +272,20 @@ type AppEngineHttpRequest struct { // below cannot be set or overridden: * `Host` * `X-Google-*` * // `X-AppEngine-*` In addition, Cloud Tasks sets some headers when the // task is dispatched, such as headers containing information about the - // task; see [request - // headers](https://cloud.google.com/appengine/docs/python/taskqueue/push - // /creating-handlers#reading_request_headers). These headers are set - // only when the task is dispatched, so they are not visible when the - // task is returned in a Cloud Tasks response. Although there is no - // specific limit for the maximum number of headers or the size, there - // is a limit on the maximum size of the Task. For more information, see - // the CreateTask documentation. + // task; see request headers. These headers are set only when the task + // is dispatched, so they are not visible when the task is returned in a + // Cloud Tasks response. Although there is no specific limit for the + // maximum number of headers or the size, there is a limit on the + // maximum size of the Task. For more information, see the CreateTask + // documentation. Headers map[string]string `json:"headers,omitempty"` // HttpMethod: The HTTP method to use for the request. The default is // POST. The app's request handler for the task's target URL must be // able to handle HTTP requests with this http_method, otherwise the // task attempt fails with error code 405 (Method Not Allowed). See - // [Writing a push task request - // handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/c - // reating-handlers#writing_a_push_task_request_handler) and the App - // Engine documentation for your runtime on [How Requests are - // Handled](https://cloud.google.com/appengine/docs/standard/python3/how- - // requests-are-handled). + // Writing a push task request handler and the App Engine documentation + // for your runtime on How Requests are Handled. // // Possible values: // "HTTP_METHOD_UNSPECIFIED" - HTTP method unspecified @@ -350,10 +337,9 @@ func (s *AppEngineHttpRequest) MarshalJSON() ([]byte, error) { // delivered to the App Engine application hostname specified by its // AppEngineHttpTarget and AppEngineHttpRequest. The documentation for // AppEngineHttpRequest explains how the task's host URL is constructed. -// Using AppEngineHttpTarget requires -// [`appengine.applications.get`](https://cloud.google.com/appengine/docs -// /admin-api/access-control) Google IAM permission for the project and -// the following scope: `https://www.googleapis.com/auth/cloud-platform` +// Using AppEngineHttpTarget requires `appengine.applications.get` +// Google IAM permission for the project and the following scope: +// `https://www.googleapis.com/auth/cloud-platform` type AppEngineHttpTarget struct { // AppEngineRoutingOverride: Overrides for the task-level // app_engine_routing. If set, `app_engine_routing_override` is used for @@ -388,22 +374,13 @@ func (s *AppEngineHttpTarget) MarshalJSON() ([]byte, error) { // AppEngineRouting: App Engine Routing. Defines routing characteristics // specific to App Engine - service, version, and instance. For more -// information about services, versions, and instances see [An Overview -// of App -// Engine](https://cloud.google.com/appengine/docs/python/an-overview-of- -// app-engine), [Microservices Architecture on Google App -// Engine](https://cloud.google.com/appengine/docs/python/microservices-o -// n-app-engine), [App Engine Standard request -// routing](https://cloud.google.com/appengine/docs/standard/python/how-r -// equests-are-routed), and [App Engine Flex request -// routing](https://cloud.google.com/appengine/docs/flexible/python/how-r -// equests-are-routed). +// information about services, versions, and instances see An Overview +// of App Engine, Microservices Architecture on Google App Engine, App +// Engine Standard request routing, and App Engine Flex request routing. type AppEngineRouting struct { // Host: Output only. The host that the task is sent to. For more - // information, see [How Requests are - // Routed](https://cloud.google.com/appengine/docs/standard/python/how-re - // quests-are-routed). The host is constructed as: * `host = - // [application_domain_name]` `| [service] + '.' + + // information, see How Requests are Routed. The host is constructed as: + // * `host = [application_domain_name]` `| [service] + '.' + // [application_domain_name]` `| [version] + '.' + // [application_domain_name]` `| [version_dot_service]+ '.' + // [application_domain_name]` `| [instance] + '.' + @@ -430,15 +407,10 @@ type AppEngineRouting struct { // Instance: App instance. By default, the task is sent to an instance // which is available when the task is attempted. Requests can only be - // sent to a specific instance if [manual scaling is used in App Engine - // Standard](https://cloud.google.com/appengine/docs/python/an-overview-o - // f-app-engine?hl=en_US#scaling_types_and_instance_classes). App Engine - // Flex does not support instances. For more information, see [App - // Engine Standard request - // routing](https://cloud.google.com/appengine/docs/standard/python/how-r - // equests-are-routed) and [App Engine Flex request - // routing](https://cloud.google.com/appengine/docs/flexible/python/how-r - // equests-are-routed). + // sent to a specific instance if manual scaling is used in App Engine + // Standard. App Engine Flex does not support instances. For more + // information, see App Engine Standard request routing and App Engine + // Flex request routing. Instance string `json:"instance,omitempty"` // Service: App service. By default, the task is sent to the service @@ -535,9 +507,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -610,8 +580,7 @@ type CancelLeaseRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // [Google IAM](https://cloud.google.com/iam/) permission on the Task - // resource. + // Google IAM permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -663,8 +632,7 @@ type CreateTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // [Google IAM](https://cloud.google.com/iam/) permission on the Task - // resource. + // Google IAM permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -837,9 +805,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -879,12 +845,10 @@ type LeaseTasksRequest struct { // function` * `tag = string` * `function = "oldest_tag()" The // `oldest_tag()` function returns tasks which have the same tag as the // oldest task (ordered by schedule time). SDK compatibility: Although - // the SDK allows tags to be either string or - // [bytes](https://cloud.google.com/appengine/docs/standard/java/javadoc/ - // com/google/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), - // only UTF-8 encoded tags can be used in Cloud Tasks. Tag which aren't - // UTF-8 encoded can't be used in the filter and the task's tag will be - // displayed as empty in Cloud Tasks. + // the SDK allows tags to be either string or bytes, only UTF-8 encoded + // tags can be used in Cloud Tasks. Tag which aren't UTF-8 encoded can't + // be used in the filter and the task's tag will be displayed as empty + // in Cloud Tasks. Filter string `json:"filter,omitempty"` // LeaseDuration: Required. The duration of the lease. Each task @@ -912,8 +876,7 @@ type LeaseTasksRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // [Google IAM](https://cloud.google.com/iam/) permission on the Task - // resource. + // Google IAM permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -1163,9 +1126,8 @@ type PauseQueueRequest struct { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1183,8 +1145,8 @@ type PauseQueueRequest struct { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1219,9 +1181,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1265,11 +1226,9 @@ type PullMessage struct { // tasks with the user ID. The task's tag can only be set when the task // is created. The tag must be less than 500 characters. SDK // compatibility: Although the SDK allows tags to be either string or - // [bytes](https://cloud.google.com/appengine/docs/standard/java/javadoc/ - // com/google/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), - // only UTF-8 encoded tags can be used in Cloud Tasks. If a tag isn't - // UTF-8 encoded, the tag will be empty when the task is returned by - // Cloud Tasks. + // bytes, only UTF-8 encoded tags can be used in Cloud Tasks. If a tag + // isn't UTF-8 encoded, the tag will be empty when the task is returned + // by Cloud Tasks. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Payload") to @@ -1317,11 +1276,9 @@ type Queue struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` * // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see - // [Identifying - // projects](https://cloud.google.com/resource-manager/docs/creating-mana - // ging-projects#identifying_projects) * `LOCATION_ID` is the canonical - // ID for the queue's location. The list of available locations can be - // obtained by calling ListLocations. For more information, see + // Identifying projects * `LOCATION_ID` is the canonical ID for the + // queue's location. The list of available locations can be obtained by + // calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. @@ -1333,11 +1290,9 @@ type Queue struct { // PurgeTime: Output only. The last time this queue was purged. All // tasks that were created before this time were purged. A queue can be - // purged using PurgeQueue, the [App Engine Task Queue SDK, or the Cloud - // Console](https://cloud.google.com/appengine/docs/standard/python/taskq - // ueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). - // Purge time will be truncated to the nearest microsecond. Purge time - // will be unset if the queue has never been purged. + // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud + // Console. Purge time will be truncated to the nearest microsecond. + // Purge time will be unset if the queue has never been purged. PurgeTime string `json:"purgeTime,omitempty"` // RateLimits: Rate limits for task dispatches. rate_limits and @@ -1357,15 +1312,13 @@ type Queue struct { // settings cannot be set on individual tasks. * For tasks created using // the App Engine SDK: the queue-level retry settings apply to all tasks // in the queue which do not have retry settings explicitly set on the - // task and were created by the App Engine SDK. See [App Engine - // documentation](https://cloud.google.com/appengine/docs/standard/python - // /taskqueue/push/retrying-tasks). + // task and were created by the App Engine SDK. See App Engine + // documentation. RetryConfig *RetryConfig `json:"retryConfig,omitempty"` // State: Output only. The state of the queue. `state` can only be // changed by called PauseQueue, ResumeQueue, or uploading - // [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config - // /queueref). UpdateQueue cannot be used to change `state`. + // queue.yaml/xml. UpdateQueue cannot be used to change `state`. // // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -1503,22 +1456,20 @@ type RateLimits struct { // rate is high. This field allows the queue to have a high rate so // processing starts shortly after a task is enqueued, but still limits // resource usage when many tasks are enqueued in a short period of - // time. The [token bucket](https://wikipedia.org/wiki/Token_Bucket) - // algorithm is used to control the rate of task dispatches. Each queue - // has a token bucket that holds tokens, up to the maximum specified by - // `max_burst_size`. Each time a task is dispatched, a token is removed - // from the bucket. Tasks will be dispatched until the queue's bucket - // runs out of tokens. The bucket will be continuously refilled with new - // tokens based on max_dispatches_per_second. The default value of - // `max_burst_size` is picked by Cloud Tasks based on the value of + // time. The token bucket algorithm is used to control the rate of task + // dispatches. Each queue has a token bucket that holds tokens, up to + // the maximum specified by `max_burst_size`. Each time a task is + // dispatched, a token is removed from the bucket. Tasks will be + // dispatched until the queue's bucket runs out of tokens. The bucket + // will be continuously refilled with new tokens based on + // max_dispatches_per_second. The default value of `max_burst_size` is + // picked by Cloud Tasks based on the value of // max_dispatches_per_second. The maximum value of `max_burst_size` is // 500. For App Engine queues that were created or updated using - // `queue.yaml/xml`, `max_burst_size` is equal to - // [bucket_size](https://cloud.google.com/appengine/docs/standard/python/ - // config/queueref#bucket_size). If UpdateQueue is called on a queue - // without explicitly setting a value for `max_burst_size`, - // `max_burst_size` value will get updated if UpdateQueue is updating - // max_dispatches_per_second. + // `queue.yaml/xml`, `max_burst_size` is equal to bucket_size. If + // UpdateQueue is called on a queue without explicitly setting a value + // for `max_burst_size`, `max_burst_size` value will get updated if + // UpdateQueue is updating max_dispatches_per_second. MaxBurstSize int64 `json:"maxBurstSize,omitempty"` // MaxConcurrentTasks: The maximum number of concurrent tasks that Cloud @@ -1529,9 +1480,7 @@ type RateLimits struct { // allowed value is 5,000. This field is output only for pull queues and // always -1, which indicates no limit. No other queue types can have // `max_concurrent_tasks` set to -1. This field has the same meaning as - // [max_concurrent_requests in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#max_concurrent_requests). + // max_concurrent_requests in queue.yaml/xml. MaxConcurrentTasks int64 `json:"maxConcurrentTasks,omitempty"` // MaxTasksDispatchedPerSecond: The maximum rate at which tasks are @@ -1540,9 +1489,7 @@ type RateLimits struct { // maximum allowed value is 500. * This field is output only for pull // queues. In addition to the `max_tasks_dispatched_per_second` limit, a // maximum of 10 QPS of LeaseTasks requests are allowed per pull queue. - // This field has the same meaning as [rate in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#rate). + // This field has the same meaning as rate in queue.yaml/xml. MaxTasksDispatchedPerSecond float64 `json:"maxTasksDispatchedPerSecond,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxBurstSize") to @@ -1596,8 +1543,7 @@ type RenewLeaseRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // [Google IAM](https://cloud.google.com/iam/) permission on the Task - // resource. + // Google IAM permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -1660,9 +1606,7 @@ type RetryConfig struct { // queue is created, Cloud Tasks will pick the default. This field is // output only for pull queues. `max_backoff` will be truncated to the // nearest second. This field has the same meaning as - // [max_backoff_seconds in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // max_backoff_seconds in queue.yaml/xml. MaxBackoff string `json:"maxBackoff,omitempty"` // MaxDoublings: The time between retries will double `max_doublings` @@ -1677,9 +1621,7 @@ type RetryConfig struct { // 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, .... If unspecified when // the queue is created, Cloud Tasks will pick the default. This field // is output only for pull queues. This field has the same meaning as - // [max_doublings in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // max_doublings in queue.yaml/xml. MaxDoublings int64 `json:"maxDoublings,omitempty"` // MaxRetryDuration: If positive, `max_retry_duration` specifies the @@ -1690,9 +1632,7 @@ type RetryConfig struct { // is unlimited. If unspecified when the queue is created, Cloud Tasks // will pick the default. This field is output only for pull queues. // `max_retry_duration` will be truncated to the nearest second. This - // field has the same meaning as [task_age_limit in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // field has the same meaning as task_age_limit in queue.yaml/xml. MaxRetryDuration string `json:"maxRetryDuration,omitempty"` // MinBackoff: A task will be scheduled for retry between min_backoff @@ -1701,9 +1641,7 @@ type RetryConfig struct { // queue is created, Cloud Tasks will pick the default. This field is // output only for pull queues. `min_backoff` will be truncated to the // nearest second. This field has the same meaning as - // [min_backoff_seconds in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // min_backoff_seconds in queue.yaml/xml. MinBackoff string `json:"minBackoff,omitempty"` // UnlimitedAttempts: If true, then the number of attempts is unlimited. @@ -1741,8 +1679,7 @@ type RunTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // [Google IAM](https://cloud.google.com/iam/) permission on the Task - // resource. + // Google IAM permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -1813,11 +1750,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1872,11 +1808,9 @@ type Task struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ // ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), // hyphens (-), colons (:), or periods (.). For more information, see - // [Identifying - // projects](https://cloud.google.com/resource-manager/docs/creating-mana - // ging-projects#identifying_projects) * `LOCATION_ID` is the canonical - // ID for the task's location. The list of available locations can be - // obtained by calling ListLocations. For more information, see + // Identifying projects * `LOCATION_ID` is the canonical ID for the + // task's location. The list of available locations can be obtained by + // calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. * `TASK_ID` can contain only letters @@ -1997,8 +1931,7 @@ func (s *TaskStatus) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2421,8 +2354,7 @@ type ProjectsLocationsQueuesCreateCall struct { // task will be deleted regardless of whether it was dispatched or not. // WARNING: Using this method may have unintended side effects if you // are using an App Engine `queue.yaml` or `queue.xml` file to manage -// your queues. Read [Overview of Queue Management and -// queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before +// your queues. Read Overview of Queue Management and queue.yaml before // using this method. func (r *ProjectsLocationsQueuesService) Create(parent string, queue *Queue) *ProjectsLocationsQueuesCreateCall { c := &ProjectsLocationsQueuesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -2566,10 +2498,8 @@ type ProjectsLocationsQueuesDeleteCall struct { // it has tasks in it. Note: If you delete a queue, a queue with the // same name can't be created for 7 days. WARNING: Using this method may // have unintended side effects if you are using an App Engine -// `queue.yaml` or `queue.xml` file to manage your queues. Read -// [Overview of Queue Management and -// queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before -// using this method. +// `queue.yaml` or `queue.xml` file to manage your queues. Read Overview +// of Queue Management and queue.yaml before using this method. func (r *ProjectsLocationsQueuesService) Delete(name string) *ProjectsLocationsQueuesDeleteCall { c := &ProjectsLocationsQueuesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2863,9 +2793,8 @@ type ProjectsLocationsQueuesGetIamPolicyCall struct { // GetIamPolicy: Gets the access control policy for a Queue. Returns an // empty policy if the resource exists and does not have a policy set. -// Authorization requires the following [Google -// IAM](https://cloud.google.com/iam) permission on the specified -// resource parent: * `cloudtasks.queues.getIamPolicy` +// Authorization requires the following Google IAM permission on the +// specified resource parent: * `cloudtasks.queues.getIamPolicy` func (r *ProjectsLocationsQueuesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsQueuesGetIamPolicyCall { c := &ProjectsLocationsQueuesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -3015,11 +2944,10 @@ func (r *ProjectsLocationsQueuesService) List(parent string) *ProjectsLocationsQ // Filter sets the optional parameter "filter": `filter` can be used to // specify a subset of queues. Any Queue field can be used as a filter // and several operators as supported. For example: `<=, <, >=, >, !=, -// =, :`. The filter syntax is the same as described in [Stackdriver's -// Advanced Logs -// Filters](https://cloud.google.com/logging/docs/view/advanced_filters). -// Sample filter "app_engine_http_target: *". Note that using filters -// might cause fewer queues than the requested_page size to be returned. +// =, :`. The filter syntax is the same as described in Stackdriver's +// Advanced Logs Filters. Sample filter "app_engine_http_target: *". +// Note that using filters might cause fewer queues than the +// requested_page size to be returned. func (c *ProjectsLocationsQueuesListCall) Filter(filter string) *ProjectsLocationsQueuesListCall { c.urlParams_.Set("filter", filter) return c @@ -3243,10 +3171,8 @@ type ProjectsLocationsQueuesPatchCall struct { // task is 31 days old, the task will be deleted regardless of whether // it was dispatched or not. WARNING: Using this method may have // unintended side effects if you are using an App Engine `queue.yaml` -// or `queue.xml` file to manage your queues. Read [Overview of Queue -// Management and -// queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before -// using this method. +// or `queue.xml` file to manage your queues. Read Overview of Queue +// Management and queue.yaml before using this method. func (r *ProjectsLocationsQueuesService) Patch(name string, queue *Queue) *ProjectsLocationsQueuesPatchCall { c := &ProjectsLocationsQueuesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3691,8 +3617,7 @@ type ProjectsLocationsQueuesResumeCall struct { // state; after calling this method it will be set to RUNNING. WARNING: // Resuming many high-QPS queues at the same time can lead to target // overloading. If you are resuming high-QPS queues, follow the 500/50/5 -// pattern described in [Managing Cloud Tasks Scaling -// Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). +// pattern described in Managing Cloud Tasks Scaling Risks. func (r *ProjectsLocationsQueuesService) Resume(name string, resumequeuerequest *ResumeQueueRequest) *ProjectsLocationsQueuesResumeCall { c := &ProjectsLocationsQueuesResumeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3836,8 +3761,8 @@ type ProjectsLocationsQueuesSetIamPolicyCall struct { // any existing policy. Note: The Cloud Console does not check // queue-level IAM permissions yet. Project-level permissions are // required to use the Cloud Console. Authorization requires the -// following [Google IAM](https://cloud.google.com/iam) permission on -// the specified resource parent: * `cloudtasks.queues.setIamPolicy` +// following Google IAM permission on the specified resource parent: * +// `cloudtasks.queues.setIamPolicy` func (r *ProjectsLocationsQueuesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsQueuesSetIamPolicyCall { c := &ProjectsLocationsQueuesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -4699,8 +4624,8 @@ func (r *ProjectsLocationsQueuesTasksService) Get(name string) *ProjectsLocation // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` [Google -// IAM](https://cloud.google.com/iam/) permission on the Task resource. +// `cloudtasks.tasks.fullView` Google IAM permission on the Task +// resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -5056,8 +4981,8 @@ func (c *ProjectsLocationsQueuesTasksListCall) PageToken(pageToken string) *Proj // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` [Google -// IAM](https://cloud.google.com/iam/) permission on the Task resource. +// `cloudtasks.tasks.fullView` Google IAM permission on the Task +// resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. diff --git a/cloudtasks/v2beta3/cloudtasks-gen.go b/cloudtasks/v2beta3/cloudtasks-gen.go index 49e56e33c7b..40f91adb312 100644 --- a/cloudtasks/v2beta3/cloudtasks-gen.go +++ b/cloudtasks/v2beta3/cloudtasks-gen.go @@ -186,10 +186,9 @@ type ProjectsLocationsQueuesTasksService struct { // to the App Engine application hostname specified by its // AppEngineHttpQueue and AppEngineHttpRequest. The documentation for // AppEngineHttpRequest explains how the task's host URL is constructed. -// Using AppEngineHttpQueue requires -// [`appengine.applications.get`](https://cloud.google.com/appengine/docs -// /admin-api/access-control) Google IAM permission for the project and -// the following scope: `https://www.googleapis.com/auth/cloud-platform` +// Using AppEngineHttpQueue requires `appengine.applications.get` Google +// IAM permission for the project and the following scope: +// `https://www.googleapis.com/auth/cloud-platform` type AppEngineHttpQueue struct { // AppEngineRoutingOverride: Overrides for the task-level // app_engine_routing. If set, `app_engine_routing_override` is used for @@ -225,43 +224,36 @@ func (s *AppEngineHttpQueue) MarshalJSON() ([]byte, error) { // AppEngineHttpRequest: App Engine HTTP request. The message defines // the HTTP request that is sent to an App Engine app when the task is // dispatched. Using AppEngineHttpRequest requires -// [`appengine.applications.get`](https://cloud.google.com/appengine/docs -// /admin-api/access-control) Google IAM permission for the project and -// the following scope: `https://www.googleapis.com/auth/cloud-platform` -// The task will be delivered to the App Engine app which belongs to the -// same project as the queue. For more information, see [How Requests -// are -// Routed](https://cloud.google.com/appengine/docs/standard/python/how-re -// quests-are-routed) and how routing is affected by [dispatch -// files](https://cloud.google.com/appengine/docs/python/config/dispatchr -// ef). Traffic is encrypted during transport and never leaves Google -// datacenters. Because this traffic is carried over a communication -// mechanism internal to Google, you cannot explicitly set the protocol -// (for example, HTTP or HTTPS). The request to the handler, however, -// will appear to have used the HTTP protocol. The AppEngineRouting used -// to construct the URL that the task is delivered to can be set at the -// queue-level or task-level: * If set, app_engine_routing_override is -// used for all tasks in the queue, no matter what the setting is for -// the task-level app_engine_routing. The `url` that the task will be -// sent to is: * `url =` host `+` relative_uri Tasks can be dispatched -// to secure app handlers, unsecure app handlers, and URIs restricted -// with [`login: -// admin`](https://cloud.google.com/appengine/docs/standard/python/config -// /appref). Because tasks are not run as any user, they cannot be -// dispatched to URIs restricted with [`login: -// required`](https://cloud.google.com/appengine/docs/standard/python/con -// fig/appref) Task dispatches also do not follow redirects. The task -// attempt has succeeded if the app's request handler returns an HTTP -// response code in the range [`200` - `299`]. The task attempt has -// failed if the app's handler returns a non-2xx response code or Cloud -// Tasks does not receive response before the deadline. Failed tasks -// will be retried according to the retry configuration. `503` (Service -// Unavailable) is considered an App Engine system error instead of an -// application error and will cause Cloud Tasks' traffic congestion -// control to temporarily throttle the queue's dispatches. Unlike other -// types of task targets, a `429` (Too Many Requests) response from an -// app handler does not cause traffic congestion control to throttle the -// queue. +// `appengine.applications.get` Google IAM permission for the project +// and the following scope: +// `https://www.googleapis.com/auth/cloud-platform` The task will be +// delivered to the App Engine app which belongs to the same project as +// the queue. For more information, see How Requests are Routed and how +// routing is affected by dispatch files. Traffic is encrypted during +// transport and never leaves Google datacenters. Because this traffic +// is carried over a communication mechanism internal to Google, you +// cannot explicitly set the protocol (for example, HTTP or HTTPS). The +// request to the handler, however, will appear to have used the HTTP +// protocol. The AppEngineRouting used to construct the URL that the +// task is delivered to can be set at the queue-level or task-level: * +// If set, app_engine_routing_override is used for all tasks in the +// queue, no matter what the setting is for the task-level +// app_engine_routing. The `url` that the task will be sent to is: * +// `url =` host `+` relative_uri Tasks can be dispatched to secure app +// handlers, unsecure app handlers, and URIs restricted with `login: +// admin`. Because tasks are not run as any user, they cannot be +// dispatched to URIs restricted with `login: required` Task dispatches +// also do not follow redirects. The task attempt has succeeded if the +// app's request handler returns an HTTP response code in the range +// [`200` - `299`]. The task attempt has failed if the app's handler +// returns a non-2xx response code or Cloud Tasks does not receive +// response before the deadline. Failed tasks will be retried according +// to the retry configuration. `503` (Service Unavailable) is considered +// an App Engine system error instead of an application error and will +// cause Cloud Tasks' traffic congestion control to temporarily throttle +// the queue's dispatches. Unlike other types of task targets, a `429` +// (Too Many Requests) response from an app handler does not cause +// traffic congestion control to throttle the queue. type AppEngineHttpRequest struct { // AppEngineRouting: Task-level setting for App Engine routing. If set, // app_engine_routing_override is used for all tasks in the queue, no @@ -291,9 +283,7 @@ type AppEngineHttpRequest struct { // below cannot be set or overridden: * `Host` * `X-Google-*` * // `X-AppEngine-*` In addition, Cloud Tasks sets some headers when the // task is dispatched, such as headers containing information about the - // task; see [request - // headers](https://cloud.google.com/tasks/docs/creating-appengine-handle - // rs#reading_request_headers). These headers are set only when the task + // task; see request headers. These headers are set only when the task // is dispatched, so they are not visible when the task is returned in a // Cloud Tasks response. Although there is no specific limit for the // maximum number of headers or the size, there is a limit on the @@ -305,12 +295,8 @@ type AppEngineHttpRequest struct { // POST. The app's request handler for the task's target URL must be // able to handle HTTP requests with this http_method, otherwise the // task attempt fails with error code 405 (Method Not Allowed). See - // [Writing a push task request - // handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/c - // reating-handlers#writing_a_push_task_request_handler) and the App - // Engine documentation for your runtime on [How Requests are - // Handled](https://cloud.google.com/appengine/docs/standard/python3/how- - // requests-are-handled). + // Writing a push task request handler and the App Engine documentation + // for your runtime on How Requests are Handled. // // Possible values: // "HTTP_METHOD_UNSPECIFIED" - HTTP method unspecified @@ -356,38 +342,24 @@ func (s *AppEngineHttpRequest) MarshalJSON() ([]byte, error) { // AppEngineRouting: App Engine Routing. Defines routing characteristics // specific to App Engine - service, version, and instance. For more -// information about services, versions, and instances see [An Overview -// of App -// Engine](https://cloud.google.com/appengine/docs/python/an-overview-of- -// app-engine), [Microservices Architecture on Google App -// Engine](https://cloud.google.com/appengine/docs/python/microservices-o -// n-app-engine), [App Engine Standard request -// routing](https://cloud.google.com/appengine/docs/standard/python/how-r -// equests-are-routed), and [App Engine Flex request -// routing](https://cloud.google.com/appengine/docs/flexible/python/how-r -// equests-are-routed). +// information about services, versions, and instances see An Overview +// of App Engine, Microservices Architecture on Google App Engine, App +// Engine Standard request routing, and App Engine Flex request routing. type AppEngineRouting struct { // Host: Output only. The host that the task is sent to. The host is // constructed from the domain name of the app associated with the // queue's project ID (for example .appspot.com), and the service, // version, and instance. Tasks which were created using the App Engine - // SDK might have a custom domain name. For more information, see [How - // Requests are - // Routed](https://cloud.google.com/appengine/docs/standard/python/how-re - // quests-are-routed). + // SDK might have a custom domain name. For more information, see How + // Requests are Routed. Host string `json:"host,omitempty"` // Instance: App instance. By default, the task is sent to an instance // which is available when the task is attempted. Requests can only be - // sent to a specific instance if [manual scaling is used in App Engine - // Standard](https://cloud.google.com/appengine/docs/python/an-overview-o - // f-app-engine?hl=en_US#scaling_types_and_instance_classes). App Engine - // Flex does not support instances. For more information, see [App - // Engine Standard request - // routing](https://cloud.google.com/appengine/docs/standard/python/how-r - // equests-are-routed) and [App Engine Flex request - // routing](https://cloud.google.com/appengine/docs/flexible/python/how-r - // equests-are-routed). + // sent to a specific instance if manual scaling is used in App Engine + // Standard. App Engine Flex does not support instances. For more + // information, see App Engine Standard request routing and App Engine + // Flex request routing. Instance string `json:"instance,omitempty"` // Service: App service. By default, the task is sent to the service @@ -485,9 +457,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -559,8 +529,7 @@ type CreateTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // [Google IAM](https://cloud.google.com/iam/) permission on the Task - // resource. + // Google IAM permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -732,9 +701,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -819,19 +786,16 @@ type HttpRequest struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` - // OauthToken: If specified, an [OAuth - // token](https://developers.google.com/identity/protocols/OAuth2) will - // be generated and attached as an `Authorization` header in the HTTP - // request. This type of authorization should generally only be used - // when calling Google APIs hosted on *.googleapis.com. + // OauthToken: If specified, an OAuth token will be generated and + // attached as an `Authorization` header in the HTTP request. This type + // of authorization should generally only be used when calling Google + // APIs hosted on *.googleapis.com. OauthToken *OAuthToken `json:"oauthToken,omitempty"` - // OidcToken: If specified, an - // [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) - // token will be generated and attached as an `Authorization` header in - // the HTTP request. This type of authorization can be used for many - // scenarios, including calling Cloud Run, or endpoints where you intend - // to validate the token yourself. + // OidcToken: If specified, an OIDC token will be generated and attached + // as an `Authorization` header in the HTTP request. This type of + // authorization can be used for many scenarios, including calling Cloud + // Run, or endpoints where you intend to validate the token yourself. OidcToken *OidcToken `json:"oidcToken,omitempty"` // Url: Required. The full url path that the request will be sent to. @@ -1030,21 +994,19 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OAuthToken: Contains information needed for generating an [OAuth -// token](https://developers.google.com/identity/protocols/OAuth2). This -// type of authorization should generally only be used when calling -// Google APIs hosted on *.googleapis.com. +// OAuthToken: Contains information needed for generating an OAuth +// token. This type of authorization should generally only be used when +// calling Google APIs hosted on *.googleapis.com. type OAuthToken struct { // Scope: OAuth scope to be used for generating OAuth access token. If // not specified, "https://www.googleapis.com/auth/cloud-platform" will // be used. Scope string `json:"scope,omitempty"` - // ServiceAccountEmail: [Service account - // email](https://cloud.google.com/iam/docs/service-accounts) to be used - // for generating OAuth token. The service account must be within the - // same project as the queue. The caller must have - // iam.serviceAccounts.actAs permission for the service account. + // ServiceAccountEmail: Service account email to be used for generating + // OAuth token. The service account must be within the same project as + // the queue. The caller must have iam.serviceAccounts.actAs permission + // for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Scope") to @@ -1070,22 +1032,19 @@ func (s *OAuthToken) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OidcToken: Contains information needed for generating an [OpenID -// Connect -// token](https://developers.google.com/identity/protocols/OpenIDConnect) -// . This type of authorization can be used for many scenarios, -// including calling Cloud Run, or endpoints where you intend to -// validate the token yourself. +// OidcToken: Contains information needed for generating an OpenID +// Connect token. This type of authorization can be used for many +// scenarios, including calling Cloud Run, or endpoints where you intend +// to validate the token yourself. type OidcToken struct { // Audience: Audience to be used when generating OIDC token. If not // specified, the URI specified in target will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: [Service account - // email](https://cloud.google.com/iam/docs/service-accounts) to be used - // for generating OIDC token. The service account must be within the - // same project as the queue. The caller must have - // iam.serviceAccounts.actAs permission for the service account. + // ServiceAccountEmail: Service account email to be used for generating + // OIDC token. The service account must be within the same project as + // the queue. The caller must have iam.serviceAccounts.actAs permission + // for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Audience") to @@ -1126,9 +1085,8 @@ type PauseQueueRequest struct { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1146,8 +1104,8 @@ type PauseQueueRequest struct { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1182,9 +1140,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1225,11 +1182,9 @@ type PullMessage struct { // Tag: The tasks's tag. The tag is less than 500 characters. SDK // compatibility: Although the SDK allows tags to be either string or - // [bytes](https://cloud.google.com/appengine/docs/standard/java/javadoc/ - // com/google/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), - // only UTF-8 encoded tags can be used in Cloud Tasks. If a tag isn't - // UTF-8 encoded, the tag will be empty when the task is returned by - // Cloud Tasks. + // bytes, only UTF-8 encoded tags can be used in Cloud Tasks. If a tag + // isn't UTF-8 encoded, the tag will be empty when the task is returned + // by Cloud Tasks. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Payload") to @@ -1274,11 +1229,9 @@ type Queue struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` * // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see - // [Identifying - // projects](https://cloud.google.com/resource-manager/docs/creating-mana - // ging-projects#identifying_projects) * `LOCATION_ID` is the canonical - // ID for the queue's location. The list of available locations can be - // obtained by calling ListLocations. For more information, see + // Identifying projects * `LOCATION_ID` is the canonical ID for the + // queue's location. The list of available locations can be obtained by + // calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. @@ -1286,11 +1239,9 @@ type Queue struct { // PurgeTime: Output only. The last time this queue was purged. All // tasks that were created before this time were purged. A queue can be - // purged using PurgeQueue, the [App Engine Task Queue SDK, or the Cloud - // Console](https://cloud.google.com/appengine/docs/standard/python/taskq - // ueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). - // Purge time will be truncated to the nearest microsecond. Purge time - // will be unset if the queue has never been purged. + // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud + // Console. Purge time will be truncated to the nearest microsecond. + // Purge time will be unset if the queue has never been purged. PurgeTime string `json:"purgeTime,omitempty"` // RateLimits: Rate limits for task dispatches. rate_limits and @@ -1315,20 +1266,18 @@ type Queue struct { // settings cannot be set on individual tasks. * For tasks created using // the App Engine SDK: the queue-level retry settings apply to all tasks // in the queue which do not have retry settings explicitly set on the - // task and were created by the App Engine SDK. See [App Engine - // documentation](https://cloud.google.com/appengine/docs/standard/python - // /taskqueue/push/retrying-tasks). + // task and were created by the App Engine SDK. See App Engine + // documentation. RetryConfig *RetryConfig `json:"retryConfig,omitempty"` // StackdriverLoggingConfig: Configuration options for writing logs to - // [Stackdriver Logging](https://cloud.google.com/logging/docs/). If - // this field is unset, then no logs are written. + // Stackdriver Logging. If this field is unset, then no logs are + // written. StackdriverLoggingConfig *StackdriverLoggingConfig `json:"stackdriverLoggingConfig,omitempty"` // State: Output only. The state of the queue. `state` can only be // changed by called PauseQueue, ResumeQueue, or uploading - // [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config - // /queueref). UpdateQueue cannot be used to change `state`. + // queue.yaml/xml. UpdateQueue cannot be used to change `state`. // // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -1474,22 +1423,20 @@ type RateLimits struct { // rate is high. This field allows the queue to have a high rate so // processing starts shortly after a task is enqueued, but still limits // resource usage when many tasks are enqueued in a short period of - // time. The [token bucket](https://wikipedia.org/wiki/Token_Bucket) - // algorithm is used to control the rate of task dispatches. Each queue - // has a token bucket that holds tokens, up to the maximum specified by - // `max_burst_size`. Each time a task is dispatched, a token is removed - // from the bucket. Tasks will be dispatched until the queue's bucket - // runs out of tokens. The bucket will be continuously refilled with new - // tokens based on max_dispatches_per_second. The default value of - // `max_burst_size` is picked by Cloud Tasks based on the value of + // time. The token bucket algorithm is used to control the rate of task + // dispatches. Each queue has a token bucket that holds tokens, up to + // the maximum specified by `max_burst_size`. Each time a task is + // dispatched, a token is removed from the bucket. Tasks will be + // dispatched until the queue's bucket runs out of tokens. The bucket + // will be continuously refilled with new tokens based on + // max_dispatches_per_second. The default value of `max_burst_size` is + // picked by Cloud Tasks based on the value of // max_dispatches_per_second. The maximum value of `max_burst_size` is // 500. For App Engine queues that were created or updated using - // `queue.yaml/xml`, `max_burst_size` is equal to - // [bucket_size](https://cloud.google.com/appengine/docs/standard/python/ - // config/queueref#bucket_size). If UpdateQueue is called on a queue - // without explicitly setting a value for `max_burst_size`, - // `max_burst_size` value will get updated if UpdateQueue is updating - // max_dispatches_per_second. + // `queue.yaml/xml`, `max_burst_size` is equal to bucket_size. If + // UpdateQueue is called on a queue without explicitly setting a value + // for `max_burst_size`, `max_burst_size` value will get updated if + // UpdateQueue is updating max_dispatches_per_second. MaxBurstSize int64 `json:"maxBurstSize,omitempty"` // MaxConcurrentDispatches: The maximum number of concurrent tasks that @@ -1498,18 +1445,14 @@ type RateLimits struct { // the number of concurrent requests decreases. If unspecified when the // queue is created, Cloud Tasks will pick the default. The maximum // allowed value is 5,000. This field has the same meaning as - // [max_concurrent_requests in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#max_concurrent_requests). + // max_concurrent_requests in queue.yaml/xml. MaxConcurrentDispatches int64 `json:"maxConcurrentDispatches,omitempty"` // MaxDispatchesPerSecond: The maximum rate at which tasks are // dispatched from this queue. If unspecified when the queue is created, // Cloud Tasks will pick the default. * For App Engine queues, the - // maximum allowed value is 500. This field has the same meaning as - // [rate in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#rate). + // maximum allowed value is 500. This field has the same meaning as rate + // in queue.yaml/xml. MaxDispatchesPerSecond float64 `json:"maxDispatchesPerSecond,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxBurstSize") to @@ -1561,9 +1504,7 @@ type RetryConfig struct { // then there will be `max_attempts - 1` retries). Must be >= -1. If // unspecified when the queue is created, Cloud Tasks will pick the // default. -1 indicates unlimited attempts. This field has the same - // meaning as [task_retry_limit in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // meaning as task_retry_limit in queue.yaml/xml. MaxAttempts int64 `json:"maxAttempts,omitempty"` // MaxBackoff: A task will be scheduled for retry between min_backoff @@ -1571,9 +1512,7 @@ type RetryConfig struct { // specifies that the task should be retried. If unspecified when the // queue is created, Cloud Tasks will pick the default. `max_backoff` // will be truncated to the nearest second. This field has the same - // meaning as [max_backoff_seconds in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // meaning as max_backoff_seconds in queue.yaml/xml. MaxBackoff string `json:"maxBackoff,omitempty"` // MaxDoublings: The time between retries will double `max_doublings` @@ -1587,9 +1526,7 @@ type RetryConfig struct { // been attempted max_attempts times. Thus, the requests will retry at // 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, .... If unspecified when // the queue is created, Cloud Tasks will pick the default. This field - // has the same meaning as [max_doublings in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // has the same meaning as max_doublings in queue.yaml/xml. MaxDoublings int64 `json:"maxDoublings,omitempty"` // MaxRetryDuration: If positive, `max_retry_duration` specifies the @@ -1599,9 +1536,8 @@ type RetryConfig struct { // will be made and the task will be deleted. If zero, then the task age // is unlimited. If unspecified when the queue is created, Cloud Tasks // will pick the default. `max_retry_duration` will be truncated to the - // nearest second. This field has the same meaning as [task_age_limit in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // nearest second. This field has the same meaning as task_age_limit in + // queue.yaml/xml. MaxRetryDuration string `json:"maxRetryDuration,omitempty"` // MinBackoff: A task will be scheduled for retry between min_backoff @@ -1609,9 +1545,7 @@ type RetryConfig struct { // specifies that the task should be retried. If unspecified when the // queue is created, Cloud Tasks will pick the default. `min_backoff` // will be truncated to the nearest second. This field has the same - // meaning as [min_backoff_seconds in - // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/pytho - // n/config/queueref#retry_parameters). + // meaning as min_backoff_seconds in queue.yaml/xml. MinBackoff string `json:"minBackoff,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxAttempts") to @@ -1646,8 +1580,7 @@ type RunTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // [Google IAM](https://cloud.google.com/iam/) permission on the Task - // resource. + // Google IAM permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -1716,12 +1649,12 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { } // StackdriverLoggingConfig: Configuration options for writing logs to -// [Stackdriver Logging](https://cloud.google.com/logging/docs/). +// Stackdriver Logging. type StackdriverLoggingConfig struct { // SamplingRatio: Specifies the fraction of operations to write to - // [Stackdriver Logging](https://cloud.google.com/logging/docs/). This - // field may contain any value between 0.0 and 1.0, inclusive. 0.0 is - // the default and means that no operations are logged. + // Stackdriver Logging. This field may contain any value between 0.0 and + // 1.0, inclusive. 0.0 is the default and means that no operations are + // logged. SamplingRatio float64 `json:"samplingRatio,omitempty"` // ForceSendFields is a list of field names (e.g. "SamplingRatio") to @@ -1763,11 +1696,10 @@ func (s *StackdriverLoggingConfig) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1832,19 +1764,17 @@ type Task struct { // of request: * For HTTP tasks, the default is 10 minutes. The deadline // must be in the interval [15 seconds, 30 minutes]. * For App Engine // tasks, 0 indicates that the request has the default deadline. The - // default deadline depends on the [scaling - // type](https://cloud.google.com/appengine/docs/standard/go/how-instance - // s-are-managed#instance_scaling) of the service: 10 minutes for - // standard apps with automatic scaling, 24 hours for standard apps with - // manual and basic scaling, and 60 minutes for flex apps. If the - // request deadline is set, it must be in the interval [15 seconds, 24 - // hours 15 seconds]. Regardless of the task's `dispatch_deadline`, the - // app handler will not run for longer than than the service's timeout. - // We recommend setting the `dispatch_deadline` to at most a few seconds - // more than the app handler's timeout. For more information see - // [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-hand - // lers#timeouts). `dispatch_deadline` will be truncated to the nearest - // millisecond. The deadline is an approximate deadline. + // default deadline depends on the scaling type of the service: 10 + // minutes for standard apps with automatic scaling, 24 hours for + // standard apps with manual and basic scaling, and 60 minutes for flex + // apps. If the request deadline is set, it must be in the interval [15 + // seconds, 24 hours 15 seconds]. Regardless of the task's + // `dispatch_deadline`, the app handler will not run for longer than + // than the service's timeout. We recommend setting the + // `dispatch_deadline` to at most a few seconds more than the app + // handler's timeout. For more information see Timeouts. + // `dispatch_deadline` will be truncated to the nearest millisecond. The + // deadline is an approximate deadline. DispatchDeadline string `json:"dispatchDeadline,omitempty"` // FirstAttempt: Output only. The status of the task's first attempt. @@ -1864,11 +1794,9 @@ type Task struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ // ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), // hyphens (-), colons (:), or periods (.). For more information, see - // [Identifying - // projects](https://cloud.google.com/resource-manager/docs/creating-mana - // ging-projects#identifying_projects) * `LOCATION_ID` is the canonical - // ID for the task's location. The list of available locations can be - // obtained by calling ListLocations. For more information, see + // Identifying projects * `LOCATION_ID` is the canonical ID for the + // task's location. The list of available locations can be obtained by + // calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. * `TASK_ID` can contain only letters @@ -1879,10 +1807,8 @@ type Task struct { // PullMessage: Pull Message contained in a task in a PULL queue type. // This payload type cannot be explicitly set through Cloud Tasks API. // Its purpose, currently is to provide backward compatibility with App - // Engine Task Queue - // [pull](https://cloud.google.com/appengine/docs/standard/java/taskqueue - // /pull/) queues to provide a way to inspect contents of pull tasks - // through the CloudTasks. + // Engine Task Queue pull queues to provide a way to inspect contents of + // pull tasks through the CloudTasks. PullMessage *PullMessage `json:"pullMessage,omitempty"` // ResponseCount: Output only. The number of attempts which have @@ -1944,8 +1870,7 @@ func (s *Task) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2368,8 +2293,7 @@ type ProjectsLocationsQueuesCreateCall struct { // task will be deleted regardless of whether it was dispatched or not. // WARNING: Using this method may have unintended side effects if you // are using an App Engine `queue.yaml` or `queue.xml` file to manage -// your queues. Read [Overview of Queue Management and -// queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before +// your queues. Read Overview of Queue Management and queue.yaml before // using this method. func (r *ProjectsLocationsQueuesService) Create(parent string, queue *Queue) *ProjectsLocationsQueuesCreateCall { c := &ProjectsLocationsQueuesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -2513,10 +2437,8 @@ type ProjectsLocationsQueuesDeleteCall struct { // it has tasks in it. Note: If you delete a queue, a queue with the // same name can't be created for 7 days. WARNING: Using this method may // have unintended side effects if you are using an App Engine -// `queue.yaml` or `queue.xml` file to manage your queues. Read -// [Overview of Queue Management and -// queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before -// using this method. +// `queue.yaml` or `queue.xml` file to manage your queues. Read Overview +// of Queue Management and queue.yaml before using this method. func (r *ProjectsLocationsQueuesService) Delete(name string) *ProjectsLocationsQueuesDeleteCall { c := &ProjectsLocationsQueuesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2810,9 +2732,8 @@ type ProjectsLocationsQueuesGetIamPolicyCall struct { // GetIamPolicy: Gets the access control policy for a Queue. Returns an // empty policy if the resource exists and does not have a policy set. -// Authorization requires the following [Google -// IAM](https://cloud.google.com/iam) permission on the specified -// resource parent: * `cloudtasks.queues.getIamPolicy` +// Authorization requires the following Google IAM permission on the +// specified resource parent: * `cloudtasks.queues.getIamPolicy` func (r *ProjectsLocationsQueuesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsQueuesGetIamPolicyCall { c := &ProjectsLocationsQueuesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -2962,11 +2883,10 @@ func (r *ProjectsLocationsQueuesService) List(parent string) *ProjectsLocationsQ // Filter sets the optional parameter "filter": `filter` can be used to // specify a subset of queues. Any Queue field can be used as a filter // and several operators as supported. For example: `<=, <, >=, >, !=, -// =, :`. The filter syntax is the same as described in [Stackdriver's -// Advanced Logs -// Filters](https://cloud.google.com/logging/docs/view/advanced_filters). -// Sample filter "state: PAUSED". Note that using filters might cause -// fewer queues than the requested page_size to be returned. +// =, :`. The filter syntax is the same as described in Stackdriver's +// Advanced Logs Filters. Sample filter "state: PAUSED". Note that using +// filters might cause fewer queues than the requested page_size to be +// returned. func (c *ProjectsLocationsQueuesListCall) Filter(filter string) *ProjectsLocationsQueuesListCall { c.urlParams_.Set("filter", filter) return c @@ -3190,10 +3110,8 @@ type ProjectsLocationsQueuesPatchCall struct { // task is 31 days old, the task will be deleted regardless of whether // it was dispatched or not. WARNING: Using this method may have // unintended side effects if you are using an App Engine `queue.yaml` -// or `queue.xml` file to manage your queues. Read [Overview of Queue -// Management and -// queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before -// using this method. +// or `queue.xml` file to manage your queues. Read Overview of Queue +// Management and queue.yaml before using this method. func (r *ProjectsLocationsQueuesService) Patch(name string, queue *Queue) *ProjectsLocationsQueuesPatchCall { c := &ProjectsLocationsQueuesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3638,8 +3556,7 @@ type ProjectsLocationsQueuesResumeCall struct { // state; after calling this method it will be set to RUNNING. WARNING: // Resuming many high-QPS queues at the same time can lead to target // overloading. If you are resuming high-QPS queues, follow the 500/50/5 -// pattern described in [Managing Cloud Tasks Scaling -// Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). +// pattern described in Managing Cloud Tasks Scaling Risks. func (r *ProjectsLocationsQueuesService) Resume(name string, resumequeuerequest *ResumeQueueRequest) *ProjectsLocationsQueuesResumeCall { c := &ProjectsLocationsQueuesResumeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3783,8 +3700,8 @@ type ProjectsLocationsQueuesSetIamPolicyCall struct { // any existing policy. Note: The Cloud Console does not check // queue-level IAM permissions yet. Project-level permissions are // required to use the Cloud Console. Authorization requires the -// following [Google IAM](https://cloud.google.com/iam) permission on -// the specified resource parent: * `cloudtasks.queues.setIamPolicy` +// following Google IAM permission on the specified resource parent: * +// `cloudtasks.queues.setIamPolicy` func (r *ProjectsLocationsQueuesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsQueuesSetIamPolicyCall { c := &ProjectsLocationsQueuesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -4356,8 +4273,8 @@ func (r *ProjectsLocationsQueuesTasksService) Get(name string) *ProjectsLocation // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` [Google -// IAM](https://cloud.google.com/iam/) permission on the Task resource. +// `cloudtasks.tasks.fullView` Google IAM permission on the Task +// resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -4563,8 +4480,8 @@ func (c *ProjectsLocationsQueuesTasksListCall) PageToken(pageToken string) *Proj // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` [Google -// IAM](https://cloud.google.com/iam/) permission on the Task resource. +// `cloudtasks.tasks.fullView` Google IAM permission on the Task +// resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. diff --git a/cloudtrace/v2/cloudtrace-gen.go b/cloudtrace/v2/cloudtrace-gen.go index fcf3f593e07..e9dc0778586 100644 --- a/cloudtrace/v2/cloudtrace-gen.go +++ b/cloudtrace/v2/cloudtrace-gen.go @@ -637,8 +637,7 @@ type StackFrame struct { LoadModule *Module `json:"loadModule,omitempty"` // OriginalFunctionName: An un-mangled function name, if `function_name` - // is [mangled](http://www.avabodh.com/cxxin/namemangling.html). The - // name can be fully-qualified (up to 1024 bytes). + // is mangled. The name can be fully-qualified (up to 1024 bytes). OriginalFunctionName *TruncatableString `json:"originalFunctionName,omitempty"` // SourceVersion: The version of the deployed source code (up to 128 @@ -741,11 +740,10 @@ func (s *StackTrace) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/cloudtrace/v2beta1/cloudtrace-gen.go b/cloudtrace/v2beta1/cloudtrace-gen.go index 32d654abb6b..7c77d137b70 100644 --- a/cloudtrace/v2beta1/cloudtrace-gen.go +++ b/cloudtrace/v2beta1/cloudtrace-gen.go @@ -267,13 +267,10 @@ type TraceSink struct { // WriterIdentity: Output only. A service account name for exporting the // data. This field is set by sinks.create and sinks.update. The service // account will need to be granted write access to the destination - // specified in the output configuration, see [Granting access for a - // resource](/iam/docs/granting-roles-to-service-accounts#granting_access - // _to_a_service_account_for_a_resource). To create tables and write - // data this account will need the dataEditor role. Read more about - // roles in the [BigQuery - // documentation](https://cloud.google.com/bigquery/docs/access-control). - // E.g.: "service-00000001@00000002.iam.gserviceaccount.com" + // specified in the output configuration, see Granting access for a + // resource. To create tables and write data this account will need the + // dataEditor role. Read more about roles in the BigQuery documentation. + // E.g.: "service-00000001@00000002.iam.gserviceaccount.com" WriterIdentity string `json:"writerIdentity,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/composer/v1/composer-gen.go b/composer/v1/composer-gen.go index f4ec205f189..8351f6edcd5 100644 --- a/composer/v1/composer-gen.go +++ b/composer/v1/composer-gen.go @@ -367,8 +367,7 @@ func (s *Environment) MarshalJSON() ([]byte, error) { // EnvironmentConfig: Configuration information for an environment. type EnvironmentConfig struct { // AirflowUri: Output only. The URI of the Apache Airflow Web UI hosted - // within this environment (see [Airflow web - // interface](/composer/docs/how-to/accessing/airflow-web-interface)). + // within this environment (see Airflow web interface). AirflowUri string `json:"airflowUri,omitempty"` // DagGcsPrefix: Output only. The Cloud Storage prefix of the DAGs for @@ -432,11 +431,10 @@ type IPAllocationPolicy struct { // IP addresses to pods in the GKE cluster. This field is applicable // only when `use_ip_aliases` is true. Set to blank to have GKE choose a // range with the default size. Set to /netmask (e.g. `/14`) to have GKE - // choose a range with a specific netmask. Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. + // choose a range with a specific netmask. Set to a CIDR notation (e.g. + // `10.96.0.0/14`) from the RFC-1918 private networks (e.g. + // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific + // range to use. ClusterIpv4CidrBlock string `json:"clusterIpv4CidrBlock,omitempty"` // ClusterSecondaryRangeName: Optional. The name of the GKE cluster's @@ -448,11 +446,10 @@ type IPAllocationPolicy struct { // IP addresses in this GKE cluster. This field is applicable only when // `use_ip_aliases` is true. Set to blank to have GKE choose a range // with the default size. Set to /netmask (e.g. `/14`) to have GKE - // choose a range with a specific netmask. Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. + // choose a range with a specific netmask. Set to a CIDR notation (e.g. + // `10.96.0.0/14`) from the RFC-1918 private networks (e.g. + // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific + // range to use. ServicesIpv4CidrBlock string `json:"servicesIpv4CidrBlock,omitempty"` // ServicesSecondaryRangeName: Optional. The name of the services' @@ -659,25 +656,21 @@ type NodeConfig struct { // IPs are allocated in the GKE cluster. IpAllocationPolicy *IPAllocationPolicy `json:"ipAllocationPolicy,omitempty"` - // Location: Optional. The Compute Engine - // [zone](/compute/docs/regions-zones) in which to deploy the VMs used - // to run the Apache Airflow software, specified as a [relative resource - // name](/apis/design/resource_names#relative_resource_name). For - // example: "projects/{projectId}/zones/{zoneId}". This `location` must - // belong to the enclosing environment's project and location. If both - // this field and `nodeConfig.machineType` are specified, - // `nodeConfig.machineType` must belong to this `location`; if both are - // unspecified, the service will pick a zone in the Compute Engine - // region corresponding to the Cloud Composer location, and propagate - // that choice to both fields. If only one field (`location` or - // `nodeConfig.machineType`) is specified, the location information from - // the specified field will be propagated to the unspecified field. + // Location: Optional. The Compute Engine zone in which to deploy the + // VMs used to run the Apache Airflow software, specified as a relative + // resource name. For example: "projects/{projectId}/zones/{zoneId}". + // This `location` must belong to the enclosing environment's project + // and location. If both this field and `nodeConfig.machineType` are + // specified, `nodeConfig.machineType` must belong to this `location`; + // if both are unspecified, the service will pick a zone in the Compute + // Engine region corresponding to the Cloud Composer location, and + // propagate that choice to both fields. If only one field (`location` + // or `nodeConfig.machineType`) is specified, the location information + // from the specified field will be propagated to the unspecified field. Location string `json:"location,omitempty"` - // MachineType: Optional. The Compute Engine [machine - // type](/compute/docs/machine-types) used for cluster instances, - // specified as a [relative resource - // name](/apis/design/resource_names#relative_resource_name). For + // MachineType: Optional. The Compute Engine machine type used for + // cluster instances, specified as a relative resource name. For // example: // "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}". // The `machineType` must belong to the enclosing environment's project @@ -688,19 +681,17 @@ type NodeConfig struct { // Composer location, and propagate that choice to both fields. If // exactly one of this field and `nodeConfig.location` is specified, the // location information from the specified field will be propagated to - // the unspecified field. The `machineTypeId` must not be a [shared-core - // machine type](/compute/docs/machine-types#sharedcore). If this field - // is unspecified, the `machineTypeId` defaults to "n1-standard-1". + // the unspecified field. The `machineTypeId` must not be a shared-core + // machine type. If this field is unspecified, the `machineTypeId` + // defaults to "n1-standard-1". MachineType string `json:"machineType,omitempty"` // Network: Optional. The Compute Engine network to be used for machine - // communications, specified as a [relative resource - // name](/apis/design/resource_names#relative_resource_name). For - // example: "projects/{projectId}/global/networks/{networkId}". [Shared - // VPC](/vpc/docs/shared-vpc) is not currently supported. The network - // must belong to the environment's project. If unspecified, the - // "default" network ID in the environment's project is used. If a - // [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets) is + // communications, specified as a relative resource name. For example: + // "projects/{projectId}/global/networks/{networkId}". Shared VPC is not + // currently supported. The network must belong to the environment's + // project. If unspecified, the "default" network ID in the + // environment's project is used. If a Custom Subnet Network is // provided, `nodeConfig.subnetwork` must also be provided. Network string `json:"network,omitempty"` @@ -717,8 +708,7 @@ type NodeConfig struct { ServiceAccount string `json:"serviceAccount,omitempty"` // Subnetwork: Optional. The Compute Engine subnetwork to be used for - // machine communications, specified as a [relative resource - // name](/apis/design/resource_names#relative_resource_name). For + // machine communications, specified as a relative resource name. For // example: // "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}" // If a subnetwork is provided, `nodeConfig.network` must also be @@ -728,8 +718,8 @@ type NodeConfig struct { // Tags: Optional. The list of instance tags applied to all node VMs. // Tags are used to identify valid sources or targets for network - // firewalls. Each tag within the list must comply with - // [RFC1035](https://www.ietf.org/rfc/rfc1035.txt). Cannot be updated. + // firewalls. Each tag within the list must comply with RFC1035. Cannot + // be updated. Tags []string `json:"tags,omitempty"` // ForceSendFields is a list of field names (e.g. "DiskSizeGb") to @@ -837,8 +827,8 @@ type OperationMetadata struct { // "UPDATE" - A resource update operation. OperationType string `json:"operationType,omitempty"` - // Resource: Output only. The resource being operated on, as a [relative - // resource name]( /apis/design/resource_names#relative_resource_name). + // Resource: Output only. The resource being operated on, as a relative + // resource name. Resource string `json:"resource,omitempty"` // ResourceUuid: Output only. The UUID of the resource being operated @@ -987,13 +977,10 @@ type SoftwareConfig struct { // brackets ("]"). The property name must not be empty and must not // contain an equals sign ("=") or semicolon (";"). Section and property // names must not contain a period ("."). Apache Airflow configuration - // property names must be written in - // [snake_case](https://en.wikipedia.org/wiki/Snake_case). Property - // values can contain any character, and can be written in any - // lower/upper case format. Certain Apache Airflow configuration - // property values are - // [blocked](/composer/docs/concepts/airflow-configurations), and cannot - // be overridden. + // property names must be written in snake_case. Property values can + // contain any character, and can be written in any lower/upper case + // format. Certain Apache Airflow configuration property values are + // blocked, and cannot be overridden. AirflowConfigOverrides map[string]string `json:"airflowConfigOverrides,omitempty"` // EnvVariables: Optional. Additional environment variables to provide @@ -1015,16 +1002,14 @@ type SoftwareConfig struct { // `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0- // 9]+.*)?`. When used as input, the server also checks if the provided // version is supported and denies the request for an unsupported - // version. The Cloud Composer portion of the version is a [semantic - // version](https://semver.org) or `latest`. When the patch version is - // omitted, the current Cloud Composer patch version is selected. When - // `latest` is provided instead of an explicit version number, the - // server replaces `latest` with the current Cloud Composer version and - // stores that version number in the same field. The portion of the - // image version that follows *airflow-* is an official Apache Airflow - // repository [release - // name](https://github.com/apache/incubator-airflow/releases). See also - // [Version List](/composer/docs/concepts/versioning/composer-versions). + // version. The Cloud Composer portion of the version is a semantic + // version or `latest`. When the patch version is omitted, the current + // Cloud Composer patch version is selected. When `latest` is provided + // instead of an explicit version number, the server replaces `latest` + // with the current Cloud Composer version and stores that version + // number in the same field. The portion of the image version that + // follows *airflow-* is an official Apache Airflow repository release + // name. See also Version List. ImageVersion string `json:"imageVersion,omitempty"` // PypiPackages: Optional. Custom Python Package Index (PyPI) packages @@ -1068,11 +1053,10 @@ func (s *SoftwareConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/composer/v1beta1/composer-gen.go b/composer/v1beta1/composer-gen.go index 77d39c11eb1..5344fb9d9c7 100644 --- a/composer/v1beta1/composer-gen.go +++ b/composer/v1beta1/composer-gen.go @@ -430,8 +430,7 @@ func (s *Environment) MarshalJSON() ([]byte, error) { // EnvironmentConfig: Configuration information for an environment. type EnvironmentConfig struct { // AirflowUri: Output only. The URI of the Apache Airflow Web UI hosted - // within this environment (see [Airflow web - // interface](/composer/docs/how-to/accessing/airflow-web-interface)). + // within this environment (see Airflow web interface). AirflowUri string `json:"airflowUri,omitempty"` // DagGcsPrefix: Output only. The Cloud Storage prefix of the DAGs for @@ -519,11 +518,10 @@ type IPAllocationPolicy struct { // IP addresses to pods in the cluster. This field is applicable only // when `use_ip_aliases` is true. Set to blank to have GKE choose a // range with the default size. Set to /netmask (e.g. `/14`) to have GKE - // choose a range with a specific netmask. Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. Specify `cluster_secondary_range_name` or + // choose a range with a specific netmask. Set to a CIDR notation (e.g. + // `10.96.0.0/14`) from the RFC-1918 private networks (e.g. + // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific + // range to use. Specify `cluster_secondary_range_name` or // `cluster_ipv4_cidr_block` but not both. ClusterIpv4CidrBlock string `json:"clusterIpv4CidrBlock,omitempty"` @@ -537,11 +535,10 @@ type IPAllocationPolicy struct { // IP addresses in this cluster. This field is applicable only when // `use_ip_aliases` is true. Set to blank to have GKE choose a range // with the default size. Set to /netmask (e.g. `/14`) to have GKE - // choose a range with a specific netmask. Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. Specify `services_secondary_range_name` or + // choose a range with a specific netmask. Set to a CIDR notation (e.g. + // `10.96.0.0/14`) from the RFC-1918 private networks (e.g. + // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific + // range to use. Specify `services_secondary_range_name` or // `services_ipv4_cidr_block` but not both. ServicesIpv4CidrBlock string `json:"servicesIpv4CidrBlock,omitempty"` @@ -752,10 +749,9 @@ type MaintenanceWindow struct { EndTime string `json:"endTime,omitempty"` // Recurrence: Required. Maintenance window recurrence. Format is a - // subset of [RFC-5545](https://tools.ietf.org/html/rfc5545) `RRULE`. - // The only allowed values for `FREQ` field are `FREQ=DAILY` and - // `FREQ=WEEKLY;BYDAY=...` Example values: `FREQ=WEEKLY;BYDAY=TU,WE`, - // `FREQ=DAILY`. + // subset of RFC-5545 `RRULE`. The only allowed values for `FREQ` field + // are `FREQ=DAILY` and `FREQ=WEEKLY;BYDAY=...` Example values: + // `FREQ=WEEKLY;BYDAY=TU,WE`, `FREQ=DAILY`. Recurrence string `json:"recurrence,omitempty"` // StartTime: Required. Start time of the first recurrence of the @@ -796,25 +792,21 @@ type NodeConfig struct { // GKE cluster. IpAllocationPolicy *IPAllocationPolicy `json:"ipAllocationPolicy,omitempty"` - // Location: Optional. The Compute Engine - // [zone](/compute/docs/regions-zones) in which to deploy the VMs used - // to run the Apache Airflow software, specified as a [relative resource - // name](/apis/design/resource_names#relative_resource_name). For - // example: "projects/{projectId}/zones/{zoneId}". This `location` must - // belong to the enclosing environment's project and location. If both - // this field and `nodeConfig.machineType` are specified, - // `nodeConfig.machineType` must belong to this `location`; if both are - // unspecified, the service will pick a zone in the Compute Engine - // region corresponding to the Cloud Composer location, and propagate - // that choice to both fields. If only one field (`location` or - // `nodeConfig.machineType`) is specified, the location information from - // the specified field will be propagated to the unspecified field. + // Location: Optional. The Compute Engine zone in which to deploy the + // VMs used to run the Apache Airflow software, specified as a relative + // resource name. For example: "projects/{projectId}/zones/{zoneId}". + // This `location` must belong to the enclosing environment's project + // and location. If both this field and `nodeConfig.machineType` are + // specified, `nodeConfig.machineType` must belong to this `location`; + // if both are unspecified, the service will pick a zone in the Compute + // Engine region corresponding to the Cloud Composer location, and + // propagate that choice to both fields. If only one field (`location` + // or `nodeConfig.machineType`) is specified, the location information + // from the specified field will be propagated to the unspecified field. Location string `json:"location,omitempty"` - // MachineType: Optional. The Compute Engine [machine - // type](/compute/docs/machine-types) used for cluster instances, - // specified as a [relative resource - // name](/apis/design/resource_names#relative_resource_name). For + // MachineType: Optional. The Compute Engine machine type used for + // cluster instances, specified as a relative resource name. For // example: // "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}". // The `machineType` must belong to the enclosing environment's project @@ -825,9 +817,9 @@ type NodeConfig struct { // Composer location, and propagate that choice to both fields. If // exactly one of this field and `nodeConfig.location` is specified, the // location information from the specified field will be propagated to - // the unspecified field. The `machineTypeId` must not be a [shared-core - // machine type](/compute/docs/machine-types#sharedcore). If this field - // is unspecified, the `machineTypeId` defaults to "n1-standard-1". + // the unspecified field. The `machineTypeId` must not be a shared-core + // machine type. If this field is unspecified, the `machineTypeId` + // defaults to "n1-standard-1". MachineType string `json:"machineType,omitempty"` // MaxPodsPerNode: Optional. The maximum number of pods per node in the @@ -844,14 +836,11 @@ type NodeConfig struct { MaxPodsPerNode int64 `json:"maxPodsPerNode,omitempty"` // Network: Optional. The Compute Engine network to be used for machine - // communications, specified as a [relative resource - // name](/apis/design/resource_names#relative_resource_name). For - // example: "projects/{projectId}/global/networks/{networkId}". If - // unspecified, the default network in the environment's project is - // used. If a [Custom Subnet - // Network](/vpc/docs/vpc#vpc_networks_and_subnets) is provided, - // `nodeConfig.subnetwork` must also be provided. For [Shared - // VPC](/vpc/docs/shared-vpc) subnetwork requirements, see + // communications, specified as a relative resource name. For example: + // "projects/{projectId}/global/networks/{networkId}". If unspecified, + // the default network in the environment's project is used. If a Custom + // Subnet Network is provided, `nodeConfig.subnetwork` must also be + // provided. For Shared VPC subnetwork requirements, see // `nodeConfig.subnetwork`. Network string `json:"network,omitempty"` @@ -868,8 +857,7 @@ type NodeConfig struct { ServiceAccount string `json:"serviceAccount,omitempty"` // Subnetwork: Optional. The Compute Engine subnetwork to be used for - // machine communications, specified as a [relative resource - // name](/apis/design/resource_names#relative_resource_name). For + // machine communications, specified as a relative resource name. For // example: // "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}" // If a subnetwork is provided, `nodeConfig.network` must also be @@ -879,8 +867,8 @@ type NodeConfig struct { // Tags: Optional. The list of instance tags applied to all node VMs. // Tags are used to identify valid sources or targets for network - // firewalls. Each tag within the list must comply with - // [RFC1035](https://www.ietf.org/rfc/rfc1035.txt). Cannot be updated. + // firewalls. Each tag within the list must comply with RFC1035. Cannot + // be updated. Tags []string `json:"tags,omitempty"` // ForceSendFields is a list of field names (e.g. "DiskSizeGb") to @@ -988,8 +976,8 @@ type OperationMetadata struct { // "UPDATE" - A resource update operation. OperationType string `json:"operationType,omitempty"` - // Resource: Output only. The resource being operated on, as a [relative - // resource name]( /apis/design/resource_names#relative_resource_name). + // Resource: Output only. The resource being operated on, as a relative + // resource name. Resource string `json:"resource,omitempty"` // ResourceUuid: Output only. The UUID of the resource being operated @@ -1141,13 +1129,10 @@ type SoftwareConfig struct { // brackets ("]"). The property name must not be empty and must not // contain an equals sign ("=") or semicolon (";"). Section and property // names must not contain a period ("."). Apache Airflow configuration - // property names must be written in - // [snake_case](https://en.wikipedia.org/wiki/Snake_case). Property - // values can contain any character, and can be written in any - // lower/upper case format. Certain Apache Airflow configuration - // property values are - // [blocked](/composer/docs/concepts/airflow-configurations), and cannot - // be overridden. + // property names must be written in snake_case. Property values can + // contain any character, and can be written in any lower/upper case + // format. Certain Apache Airflow configuration property values are + // blocked, and cannot be overridden. AirflowConfigOverrides map[string]string `json:"airflowConfigOverrides,omitempty"` // EnvVariables: Optional. Additional environment variables to provide @@ -1169,16 +1154,14 @@ type SoftwareConfig struct { // `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0- // 9]+.*)?`. When used as input, the server also checks if the provided // version is supported and denies the request for an unsupported - // version. The Cloud Composer portion of the version is a [semantic - // version](https://semver.org) or `latest`. When the patch version is - // omitted, the current Cloud Composer patch version is selected. When - // `latest` is provided instead of an explicit version number, the - // server replaces `latest` with the current Cloud Composer version and - // stores that version number in the same field. The portion of the - // image version that follows *airflow-* is an official Apache Airflow - // repository [release - // name](https://github.com/apache/incubator-airflow/releases). See also - // [Version List](/composer/docs/concepts/versioning/composer-versions). + // version. The Cloud Composer portion of the version is a semantic + // version or `latest`. When the patch version is omitted, the current + // Cloud Composer patch version is selected. When `latest` is provided + // instead of an explicit version number, the server replaces `latest` + // with the current Cloud Composer version and stores that version + // number in the same field. The portion of the image version that + // follows *airflow-* is an official Apache Airflow repository release + // name. See also Version List. ImageVersion string `json:"imageVersion,omitempty"` // PypiPackages: Optional. Custom Python Package Index (PyPI) packages @@ -1222,11 +1205,10 @@ func (s *SoftwareConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index 5e012c92cd3..b447e674a75 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -3347,9 +3347,7 @@ func (s *AuthorizationLoggingOptions) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Autoscaler resources: // -// * [Zonal](/compute/docs/reference/rest/{$api_version}/autoscalers) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionAutoscale -// rs) +// * Zonal * Regional // // Use autoscalers to automatically add or delete instances from a // managed instance group according to your defined autoscaling policy. @@ -5187,11 +5185,7 @@ func (s *BackendBucketListWarningData) MarshalJSON() ([]byte, error) { // Backend services in Google Compute Engine can be either regionally or // globally scoped. // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/backendServices) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionBackendSe -// rvices) +// * Global * Regional // // For more information, see Backend Services. // @@ -6832,9 +6826,7 @@ type Binding struct { // binding. // // To learn which resources support conditions in their IAM policies, - // see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -8297,11 +8289,9 @@ func (s *DeprecationStatus) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk resources: // -// * [Zonal](/compute/docs/reference/rest/{$api_version}/disks) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionDisks) +// * Zonal * Regional // -// P -// ersistent disks are required for running your VM instances. Create +// Persistent disks are required for running your VM instances. Create // both boot and non-boot (data) persistent disks. For more information, // read Persistent Disks. For more storage options, read Storage // options. @@ -9082,10 +9072,7 @@ func (s *DiskMoveRequest) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk Type resources: // -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionDiskTypes -// ) * -// [Zonal](/compute/docs/reference/rest/{$api_version}/diskTypes) +// * Regional * Zonal // // You can choose from a variety of disk types based on your needs. For // more information, read Storage options. @@ -11572,11 +11559,7 @@ func (s *FixedOrPercent) MarshalJSON() ([]byte, error) { // Forwarding rule resources in GCP can be either regional or global in // scope: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/globalForwardingR -// ules) * -// [Regional](/compute/docs/reference/rest/{$api_version}/forwardingRules -// ) +// * Global * Regional // // A forwarding rule and its corresponding IP address represent the // frontend configuration of a Google Cloud Platform load balancer. @@ -11606,9 +11589,7 @@ type ForwardingRule struct { // // The loadBalancingScheme and the forwarding rule's target determine // the type of IP address that you can use. For detailed information, - // refer to [IP address - // specifications](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_specifications). + // refer to IP address specifications. // // Must be set to `0.0.0.0` when the target is targetGrpcProxy that has // validateForProxyless field set to true. @@ -11853,9 +11834,7 @@ type ForwardingRule struct { // For Internal TCP/UDP Load Balancing, if you specify allPorts, you // should not specify ports. // - // For more information, see [Port - // specifications](/load-balancing/docs/forwarding-rule-concepts#port_spe - // cifications). + // For more information, see Port specifications. Ports []string `json:"ports,omitempty"` // Region: [Output Only] URL of the region where the regional forwarding @@ -11915,9 +11894,7 @@ type ForwardingRule struct { // same region as the forwarding rule. For global forwarding rules, this // target must be a global load balancing resource. The forwarded // traffic must be of a type appropriate to the target object. For more - // information, see the "Target" column in [Port - // specifications](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_specifications). + // information, see the "Target" column in Port specifications. // // For Private Service Connect forwarding rules that forward traffic to // Google APIs, provide the name of a supported Google API bundle. @@ -13130,10 +13107,7 @@ func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Health Check resources: // -// * [Global](/compute/docs/reference/rest/{$api_version}/healthChecks) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionHealthChe -// cks) +// * Global * Regional // // Internal HTTP(S) load balancers must use regional health checks // (`compute.v1.regionHealthChecks`). @@ -30229,16 +30203,11 @@ func (s *NotificationEndpointListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has three Operation resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionOperation -// s) * -// [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) +// * Global * Regional * Zonal // -// Y -// ou can use an operation resource to manage asynchronous API requests. -// For more information, read Handling API responses. +// You can use an operation resource to manage asynchronous API +// requests. For more information, read Handling API +// responses. // // Operations can be global, regional or zonal. // - For global operations, use the `globalOperations` resource. @@ -32366,9 +32335,7 @@ func (s *PermissionConstraint) MarshalJSON() ([]byte, error) { // access to a resource only if the expression evaluates to `true`. A // condition can add constraints based on attributes of the request, the // resource, or both. To learn which resources support conditions in -// their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// their IAM policies, see the IAM documentation. // // **JSON example:** // @@ -32394,8 +32361,7 @@ func (s *PermissionConstraint) MarshalJSON() ([]byte, error) { // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 // -// For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// For a description of IAM and its features, see the IAM documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -32456,9 +32422,7 @@ type Policy struct { // policy may specify any valid version or leave the field unset. // // To learn which resources support conditions in their IAM policies, - // see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // see the IAM documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -42598,11 +42562,7 @@ func (s *SourceInstanceProperties) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two SSL Certificate resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/sslCertificates) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionSslCertif -// icates) +// * Global * Regional // // // @@ -45256,11 +45216,7 @@ func (s *TargetHttpProxiesScopedListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Target HTTP Proxy resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/targetHttpProxies -// ) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionTargetHtt -// pProxies) +// * Global * Regional // // A target HTTP proxy is a component of GCP HTTP load balancers. // @@ -45924,11 +45880,7 @@ func (s *TargetHttpsProxiesSetSslCertificatesRequest) MarshalJSON() ([]byte, err // // Google Compute Engine has two Target HTTPS Proxy resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/targetHttpsProxie -// s) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionTargetHtt -// psProxies) +// * Global * Regional // // A target HTTPS proxy is a component of GCP HTTPS load balancers. // @@ -49373,9 +49325,7 @@ func (s *UpcomingMaintenance) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two URL Map resources: // -// * [Global](/compute/docs/reference/rest/{$api_version}/urlMaps) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionUrlMaps) -// +// * Global * Regional // // A URL map resource is a component of certain types of GCP load // balancers and Traffic Director. @@ -152886,8 +152836,7 @@ type RegionUrlMapsInvalidateCacheCall struct { // InvalidateCache: Initiates a cache invalidation operation, // invalidating the specified path, scoped to the specified UrlMap. // -// For more information, see [Invalidating cached -// content](/cdn/docs/invalidating-cached-content). +// For more information, see Invalidating cached content. func (r *RegionUrlMapsService) InvalidateCache(project string, region string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *RegionUrlMapsInvalidateCacheCall { c := &RegionUrlMapsInvalidateCacheCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project @@ -184612,8 +184561,7 @@ type UrlMapsInvalidateCacheCall struct { // InvalidateCache: Initiates a cache invalidation operation, // invalidating the specified path, scoped to the specified UrlMap. // -// For more information, see [Invalidating cached -// content](/cdn/docs/invalidating-cached-content). +// For more information, see Invalidating cached content. func (r *UrlMapsService) InvalidateCache(project string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *UrlMapsInvalidateCacheCall { c := &UrlMapsInvalidateCacheCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index 8b06a4b1e92..6d579fd4f4c 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -3010,9 +3010,7 @@ func (s *AuthorizationLoggingOptions) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Autoscaler resources: // -// * [Zonal](/compute/docs/reference/rest/{$api_version}/autoscalers) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionAutoscale -// rs) +// * Zonal * Regional // // Use autoscalers to automatically add or delete instances from a // managed instance group according to your defined autoscaling policy. @@ -4832,11 +4830,7 @@ func (s *BackendBucketListWarningData) MarshalJSON() ([]byte, error) { // Backend services in Google Compute Engine can be either regionally or // globally scoped. // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/backendServices) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionBackendSe -// rvices) +// * Global * Regional // // For more information, see Backend Services. // @@ -6405,9 +6399,7 @@ type Binding struct { // binding. // // To learn which resources support conditions in their IAM policies, - // see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -7648,11 +7640,9 @@ func (s *DeprecationStatus) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk resources: // -// * [Zonal](/compute/docs/reference/rest/{$api_version}/disks) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionDisks) +// * Zonal * Regional // -// P -// ersistent disks are required for running your VM instances. Create +// Persistent disks are required for running your VM instances. Create // both boot and non-boot (data) persistent disks. For more information, // read Persistent Disks. For more storage options, read Storage // options. @@ -8377,10 +8367,7 @@ func (s *DiskMoveRequest) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk Type resources: // -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionDiskTypes -// ) * -// [Zonal](/compute/docs/reference/rest/{$api_version}/diskTypes) +// * Regional * Zonal // // You can choose from a variety of disk types based on your needs. For // more information, read Storage options. @@ -10562,11 +10549,7 @@ func (s *FixedOrPercent) MarshalJSON() ([]byte, error) { // Forwarding rule resources in GCP can be either regional or global in // scope: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/globalForwardingR -// ules) * -// [Regional](/compute/docs/reference/rest/{$api_version}/forwardingRules -// ) +// * Global * Regional // // A forwarding rule and its corresponding IP address represent the // frontend configuration of a Google Cloud Platform load balancer. @@ -10596,9 +10579,7 @@ type ForwardingRule struct { // // The loadBalancingScheme and the forwarding rule's target determine // the type of IP address that you can use. For detailed information, - // refer to [IP address - // specifications](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_specifications). + // refer to IP address specifications. // // Must be set to `0.0.0.0` when the target is targetGrpcProxy that has // validateForProxyless field set to true. @@ -10838,9 +10819,7 @@ type ForwardingRule struct { // For Internal TCP/UDP Load Balancing, if you specify allPorts, you // should not specify ports. // - // For more information, see [Port - // specifications](/load-balancing/docs/forwarding-rule-concepts#port_spe - // cifications). + // For more information, see Port specifications. Ports []string `json:"ports,omitempty"` // Region: [Output Only] URL of the region where the regional forwarding @@ -10896,9 +10875,7 @@ type ForwardingRule struct { // same region as the forwarding rule. For global forwarding rules, this // target must be a global load balancing resource. The forwarded // traffic must be of a type appropriate to the target object. For more - // information, see the "Target" column in [Port - // specifications](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_specifications). + // information, see the "Target" column in Port specifications. // // For Private Service Connect forwarding rules that forward traffic to // Google APIs, provide the name of a supported Google API bundle. @@ -12043,10 +12020,7 @@ func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Health Check resources: // -// * [Global](/compute/docs/reference/rest/{$api_version}/healthChecks) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionHealthChe -// cks) +// * Global * Regional // // Internal HTTP(S) load balancers must use regional health checks // (`compute.v1.regionHealthChecks`). @@ -27522,16 +27496,11 @@ func (s *NotificationEndpointListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has three Operation resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionOperation -// s) * -// [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) +// * Global * Regional * Zonal // -// Y -// ou can use an operation resource to manage asynchronous API requests. -// For more information, read Handling API responses. +// You can use an operation resource to manage asynchronous API +// requests. For more information, read Handling API +// responses. // // Operations can be global, regional or zonal. // - For global operations, use the `globalOperations` resource. @@ -29503,9 +29472,7 @@ func (s *PerInstanceConfig) MarshalJSON() ([]byte, error) { // access to a resource only if the expression evaluates to `true`. A // condition can add constraints based on attributes of the request, the // resource, or both. To learn which resources support conditions in -// their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// their IAM policies, see the IAM documentation. // // **JSON example:** // @@ -29531,8 +29498,7 @@ func (s *PerInstanceConfig) MarshalJSON() ([]byte, error) { // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 // -// For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// For a description of IAM and its features, see the IAM documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -29593,9 +29559,7 @@ type Policy struct { // policy may specify any valid version or leave the field unset. // // To learn which resources support conditions in their IAM policies, - // see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // see the IAM documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -37571,11 +37535,7 @@ func (s *SourceInstanceProperties) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two SSL Certificate resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/sslCertificates) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionSslCertif -// icates) +// * Global * Regional // // // @@ -40086,11 +40046,7 @@ func (s *TargetHttpProxiesScopedListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Target HTTP Proxy resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/targetHttpProxies -// ) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionTargetHtt -// pProxies) +// * Global * Regional // // A target HTTP proxy is a component of GCP HTTP load balancers. // @@ -40721,11 +40677,7 @@ func (s *TargetHttpsProxiesSetSslCertificatesRequest) MarshalJSON() ([]byte, err // // Google Compute Engine has two Target HTTPS Proxy resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/targetHttpsProxie -// s) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionTargetHtt -// psProxies) +// * Global * Regional // // A target HTTPS proxy is a component of GCP HTTPS load balancers. // @@ -43839,9 +43791,7 @@ func (s *TestPermissionsResponse) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two URL Map resources: // -// * [Global](/compute/docs/reference/rest/{$api_version}/urlMaps) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionUrlMaps) -// +// * Global * Regional // // A URL map resource is a component of certain types of GCP load // balancers and Traffic Director. @@ -133134,8 +133084,7 @@ type RegionUrlMapsInvalidateCacheCall struct { // InvalidateCache: Initiates a cache invalidation operation, // invalidating the specified path, scoped to the specified UrlMap. // -// For more information, see [Invalidating cached -// content](/cdn/docs/invalidating-cached-content). +// For more information, see Invalidating cached content. func (r *RegionUrlMapsService) InvalidateCache(project string, region string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *RegionUrlMapsInvalidateCacheCall { c := &RegionUrlMapsInvalidateCacheCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project @@ -162557,8 +162506,7 @@ type UrlMapsInvalidateCacheCall struct { // InvalidateCache: Initiates a cache invalidation operation, // invalidating the specified path, scoped to the specified UrlMap. // -// For more information, see [Invalidating cached -// content](/cdn/docs/invalidating-cached-content). +// For more information, see Invalidating cached content. func (r *UrlMapsService) InvalidateCache(project string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *UrlMapsInvalidateCacheCall { c := &UrlMapsInvalidateCacheCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index 5c828b793e1..552ce8c7c13 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -2920,9 +2920,7 @@ func (s *AuthorizationLoggingOptions) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Autoscaler resources: // -// * [Zonal](/compute/docs/reference/rest/{$api_version}/autoscalers) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionAutoscale -// rs) +// * Zonal * Regional // // Use autoscalers to automatically add or delete instances from a // managed instance group according to your defined autoscaling policy. @@ -4492,11 +4490,7 @@ func (s *BackendBucketListWarningData) MarshalJSON() ([]byte, error) { // Backend services in Google Compute Engine can be either regionally or // globally scoped. // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/backendServices) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionBackendSe -// rvices) +// * Global * Regional // // For more information, see Backend Services. // @@ -5648,9 +5642,7 @@ type Binding struct { // binding. // // To learn which resources support conditions in their IAM policies, - // see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -6856,11 +6848,9 @@ func (s *DeprecationStatus) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk resources: // -// * [Zonal](/compute/docs/reference/rest/{$api_version}/disks) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionDisks) +// * Zonal * Regional // -// P -// ersistent disks are required for running your VM instances. Create +// Persistent disks are required for running your VM instances. Create // both boot and non-boot (data) persistent disks. For more information, // read Persistent Disks. For more storage options, read Storage // options. @@ -7555,10 +7545,7 @@ func (s *DiskMoveRequest) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk Type resources: // -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionDiskTypes -// ) * -// [Zonal](/compute/docs/reference/rest/{$api_version}/diskTypes) +// * Regional * Zonal // // You can choose from a variety of disk types based on your needs. For // more information, read Storage options. @@ -9551,11 +9538,7 @@ func (s *FixedOrPercent) MarshalJSON() ([]byte, error) { // Forwarding rule resources in GCP can be either regional or global in // scope: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/globalForwardingR -// ules) * -// [Regional](/compute/docs/reference/rest/{$api_version}/forwardingRules -// ) +// * Global * Regional // // A forwarding rule and its corresponding IP address represent the // frontend configuration of a Google Cloud Platform load balancer. @@ -9585,9 +9568,7 @@ type ForwardingRule struct { // // The loadBalancingScheme and the forwarding rule's target determine // the type of IP address that you can use. For detailed information, - // refer to [IP address - // specifications](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_specifications). + // refer to IP address specifications. // // Must be set to `0.0.0.0` when the target is targetGrpcProxy that has // validateForProxyless field set to true. @@ -9810,9 +9791,7 @@ type ForwardingRule struct { // For Internal TCP/UDP Load Balancing, if you specify allPorts, you // should not specify ports. // - // For more information, see [Port - // specifications](/load-balancing/docs/forwarding-rule-concepts#port_spe - // cifications). + // For more information, see Port specifications. Ports []string `json:"ports,omitempty"` // Region: [Output Only] URL of the region where the regional forwarding @@ -9860,9 +9839,7 @@ type ForwardingRule struct { // same region as the forwarding rule. For global forwarding rules, this // target must be a global load balancing resource. The forwarded // traffic must be of a type appropriate to the target object. For more - // information, see the "Target" column in [Port - // specifications](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_specifications). + // information, see the "Target" column in Port specifications. // // For Private Service Connect forwarding rules that forward traffic to // Google APIs, provide the name of a supported Google API bundle. @@ -10971,10 +10948,7 @@ func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Health Check resources: // -// * [Global](/compute/docs/reference/rest/{$api_version}/healthChecks) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionHealthChe -// cks) +// * Global * Regional // // Internal HTTP(S) load balancers must use regional health checks // (`compute.v1.regionHealthChecks`). @@ -25553,16 +25527,11 @@ func (s *NotificationEndpointListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has three Operation resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionOperation -// s) * -// [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) +// * Global * Regional * Zonal // -// Y -// ou can use an operation resource to manage asynchronous API requests. -// For more information, read Handling API responses. +// You can use an operation resource to manage asynchronous API +// requests. For more information, read Handling API +// responses. // // Operations can be global, regional or zonal. // - For global operations, use the `globalOperations` resource. @@ -27440,9 +27409,7 @@ func (s *PerInstanceConfig) MarshalJSON() ([]byte, error) { // access to a resource only if the expression evaluates to `true`. A // condition can add constraints based on attributes of the request, the // resource, or both. To learn which resources support conditions in -// their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// their IAM policies, see the IAM documentation. // // **JSON example:** // @@ -27468,8 +27435,7 @@ func (s *PerInstanceConfig) MarshalJSON() ([]byte, error) { // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 // -// For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// For a description of IAM and its features, see the IAM documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -27530,9 +27496,7 @@ type Policy struct { // policy may specify any valid version or leave the field unset. // // To learn which resources support conditions in their IAM policies, - // see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // see the IAM documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -34657,11 +34621,7 @@ func (s *SourceInstanceParams) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two SSL Certificate resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/sslCertificates) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionSslCertif -// icates) +// * Global * Regional // // // @@ -37154,11 +37114,7 @@ func (s *TargetHttpProxiesScopedListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Target HTTP Proxy resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/targetHttpProxies -// ) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionTargetHtt -// pProxies) +// * Global * Regional // // A target HTTP proxy is a component of GCP HTTP load balancers. // @@ -37675,11 +37631,7 @@ func (s *TargetHttpsProxiesSetSslCertificatesRequest) MarshalJSON() ([]byte, err // // Google Compute Engine has two Target HTTPS Proxy resources: // -// * -// [Global](/compute/docs/reference/rest/{$api_version}/targetHttpsProxie -// s) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionTargetHtt -// psProxies) +// * Global * Regional // // A target HTTPS proxy is a component of GCP HTTPS load balancers. // @@ -40744,9 +40696,7 @@ func (s *TestPermissionsResponse) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two URL Map resources: // -// * [Global](/compute/docs/reference/rest/{$api_version}/urlMaps) * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionUrlMaps) -// +// * Global * Regional // // A URL map resource is a component of certain types of GCP load // balancers and Traffic Director. @@ -146870,8 +146820,7 @@ type UrlMapsInvalidateCacheCall struct { // InvalidateCache: Initiates a cache invalidation operation, // invalidating the specified path, scoped to the specified UrlMap. // -// For more information, see [Invalidating cached -// content](/cdn/docs/invalidating-cached-content). +// For more information, see Invalidating cached content. func (r *UrlMapsService) InvalidateCache(project string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *UrlMapsInvalidateCacheCall { c := &UrlMapsInvalidateCacheCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project diff --git a/container/v1/container-gen.go b/container/v1/container-gen.go index 7f6ffaa4950..b8800818156 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -284,8 +284,7 @@ type AcceleratorConfig struct { AcceleratorCount int64 `json:"acceleratorCount,omitempty,string"` // AcceleratorType: The accelerator type resource name. List of - // supported accelerators - // [here](https://cloud.google.com/compute/docs/gpus) + // supported accelerators here AcceleratorType string `json:"acceleratorType,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to @@ -414,8 +413,7 @@ func (s *AuthenticatorGroupsConfig) MarshalJSON() ([]byte, error) { type AutoUpgradeOptions struct { // AutoUpgradeStartTime: [Output only] This field is set when upgrades // are about to commence with the approximate start time for the - // upgrades, in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text - // format. + // upgrades, in RFC3339 text format. AutoUpgradeStartTime string `json:"autoUpgradeStartTime,omitempty"` // Description: [Output only] This field is set when upgrades are about @@ -476,10 +474,8 @@ type AutoprovisioningNodePoolDefaults struct { // pools. The instance may be scheduled on the specified or newer CPU // platform. Applicable values are the friendly names of CPU platforms, // such as minCpuPlatform: Intel Haswell or minCpuPlatform: Intel Sandy - // Bridge. For more information, read [how to specify min CPU - // platform](https://cloud.google.com/compute/docs/instances/specify-min- - // cpu-platform) To unset the min cpu platform field pass "automatic" as - // field value. + // Bridge. For more information, read how to specify min CPU platform To + // unset the min cpu platform field pass "automatic" as field value. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // OauthScopes: Scopes that are used by NAP when creating node pools. @@ -590,15 +586,14 @@ type CancelOperationRequest struct { // This field has been deprecated and replaced by the name field. OperationId string `json:"operationId,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the operation resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the operation resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -744,17 +739,15 @@ type Cluster struct { BinaryAuthorization *BinaryAuthorization `json:"binaryAuthorization,omitempty"` // ClusterIpv4Cidr: The IP address range of the container pods in this - // cluster, in - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically - // chosen or specify a `/14` block in `10.0.0.0/8`. + // cluster, in CIDR notation (e.g. `10.96.0.0/14`). Leave blank to have + // one automatically chosen or specify a `/14` block in `10.0.0.0/8`. ClusterIpv4Cidr string `json:"clusterIpv4Cidr,omitempty"` // Conditions: Which conditions caused the current cluster state. Conditions []*StatusCondition `json:"conditions,omitempty"` // CreateTime: [Output only] The time the cluster was created, in - // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. + // RFC3339 text format. CreateTime string `json:"createTime,omitempty"` // CurrentMasterVersion: [Output only] The current software version of @@ -766,11 +759,9 @@ type Cluster struct { // information. CurrentNodeCount int64 `json:"currentNodeCount,omitempty"` - // CurrentNodeVersion: [Output only] Deprecated, use - // [NodePools.version](https://cloud.google.com/kubernetes-engine/docs/re - // ference/rest/v1/projects.locations.clusters.nodePools) instead. The - // current version of the node software components. If they are - // currently at multiple versions because they're in the process of + // CurrentNodeVersion: [Output only] Deprecated, use NodePools.version + // instead. The current version of the node software components. If they + // are currently at multiple versions because they're in the process of // being upgraded, this reflects the minimum version of all nodes. CurrentNodeVersion string `json:"currentNodeVersion,omitempty"` @@ -804,8 +795,7 @@ type Cluster struct { Endpoint string `json:"endpoint,omitempty"` // ExpireTime: [Output only] The time the cluster will be automatically - // deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text - // format. + // deleted in RFC3339 text format. ExpireTime string `json:"expireTime,omitempty"` // InitialClusterVersion: The initial Kubernetes version for this @@ -822,8 +812,7 @@ type Cluster struct { InitialClusterVersion string `json:"initialClusterVersion,omitempty"` // InitialNodeCount: The number of nodes to create in this cluster. You - // must ensure that your Compute Engine [resource - // quota](https://cloud.google.com/compute/quotas) is sufficient for + // must ensure that your Compute Engine resource quota is sufficient for // this number of instances. You must also have available firewall and // routes quota. For requests, this field should only be used in lieu of // a "node_pool" object, since this configuration (along with the @@ -846,25 +835,16 @@ type Cluster struct { // LegacyAbac: Configuration for the legacy ABAC authorization mode. LegacyAbac *LegacyAbac `json:"legacyAbac,omitempty"` - // Location: [Output only] The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zon - // es#available) or - // [region](https://cloud.google.com/compute/docs/regions-zones/regions-z - // ones#available) in which the cluster resides. + // Location: [Output only] The name of the Google Compute Engine zone or + // region in which the cluster resides. Location string `json:"location,omitempty"` - // Locations: The list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster's nodes should be located. This field provides a - // default value if - // [NodePool.Locations](https://cloud.google.com/kubernetes-engine/docs/r - // eference/rest/v1/projects.locations.clusters.nodePools#NodePool.FIELDS - // .locations) are not specified during node pool creation. Warning: - // changing cluster locations will update the - // [NodePool.Locations](https://cloud.google.com/kubernetes-engine/docs/r - // eference/rest/v1/projects.locations.clusters.nodePools#NodePool.FIELDS - // .locations) of all node pools and will result in nodes being added - // and/or removed. + // Locations: The list of Google Compute Engine zones in which the + // cluster's nodes should be located. This field provides a default + // value if NodePool.Locations are not specified during node pool + // creation. Warning: changing cluster locations will update the + // NodePool.Locations of all node pools and will result in nodes being + // added and/or removed. Locations []string `json:"locations,omitempty"` // LoggingService: The logging service the cluster should use to write @@ -909,10 +889,9 @@ type Cluster struct { // with a number or a letter. Name string `json:"name,omitempty"` - // Network: The name of the Google Compute Engine - // [network](https://cloud.google.com/compute/docs/networks-and-firewalls - // #networks) to which the cluster is connected. If left unspecified, - // the `default` network will be used. + // Network: The name of the Google Compute Engine network to which the + // cluster is connected. If left unspecified, the `default` network will + // be used. Network string `json:"network,omitempty"` // NetworkConfig: Configuration for cluster networking. @@ -962,10 +941,9 @@ type Cluster struct { SelfLink string `json:"selfLink,omitempty"` // ServicesIpv4Cidr: [Output only] The IP address range of the - // Kubernetes services in this cluster, in - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `1.2.3.4/29`). Service addresses are typically put in - // the last `/16` from the container CIDR. + // Kubernetes services in this cluster, in CIDR notation (e.g. + // `1.2.3.4/29`). Service addresses are typically put in the last `/16` + // from the container CIDR. ServicesIpv4Cidr string `json:"servicesIpv4Cidr,omitempty"` // ShieldedNodes: Shielded Nodes configuration. @@ -996,15 +974,12 @@ type Cluster struct { // status of this cluster, if available. StatusMessage string `json:"statusMessage,omitempty"` - // Subnetwork: The name of the Google Compute Engine - // [subnetwork](https://cloud.google.com/compute/docs/subnetworks) to - // which the cluster is connected. + // Subnetwork: The name of the Google Compute Engine subnetwork to which + // the cluster is connected. Subnetwork string `json:"subnetwork,omitempty"` // TpuIpv4CidrBlock: [Output only] The IP address range of the Cloud - // TPUs in this cluster, in - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `1.2.3.4/29`). + // TPUs in this cluster, in CIDR notation (e.g. `1.2.3.4/29`). TpuIpv4CidrBlock string `json:"tpuIpv4CidrBlock,omitempty"` // VerticalPodAutoscaling: Cluster-level Vertical Pod Autoscaling @@ -1015,8 +990,7 @@ type Cluster struct { // Service Accounts in GCP IAM policies. WorkloadIdentityConfig *WorkloadIdentityConfig `json:"workloadIdentityConfig,omitempty"` - // Zone: [Output only] The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in + // Zone: [Output only] The name of the Google Compute Engine zone in // which the cluster resides. This field is deprecated, use location // instead. Zone string `json:"zone,omitempty"` @@ -1053,8 +1027,7 @@ func (s *Cluster) MarshalJSON() ([]byte, error) { // the size of the cluster and create/delete node pools based on the // current needs. type ClusterAutoscaling struct { - // AutoprovisioningLocations: The list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in + // AutoprovisioningLocations: The list of Google Compute Engine zones in // which the NodePool's nodes can be created by NAP. AutoprovisioningLocations []string `json:"autoprovisioningLocations,omitempty"` @@ -1125,8 +1098,7 @@ type ClusterUpdate struct { // visibility. DesiredIntraNodeVisibilityConfig *IntraNodeVisibilityConfig `json:"desiredIntraNodeVisibilityConfig,omitempty"` - // DesiredLocations: The desired list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in + // DesiredLocations: The desired list of Google Compute Engine zones in // which the cluster's nodes should be located. This list must always // include the cluster's primary zone. Warning: changing cluster // locations will update the locations of all node pools and will result @@ -1247,16 +1219,14 @@ type CompleteIPRotationRequest struct { // `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project - // number](https://developers.google.com/console/help/new/#projectnumber) - // . This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -1344,24 +1314,21 @@ func (s *ConsumptionMeteringConfig) MarshalJSON() ([]byte, error) { // CreateClusterRequest: CreateClusterRequest creates a cluster. type CreateClusterRequest struct { - // Cluster: Required. A [cluster - // resource](https://cloud.google.com/container-engine/reference/rest/v1/ - // projects.locations.clusters) + // Cluster: Required. A cluster resource Cluster *Cluster `json:"cluster,omitempty"` // Parent: The parent (project and location) where the cluster will be // created. Specified in the format `projects/*/locations/*`. Parent string `json:"parent,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the parent field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // parent field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the parent field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the parent field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Cluster") to @@ -1402,16 +1369,14 @@ type CreateNodePoolRequest struct { // `projects/*/locations/*/clusters/*`. Parent string `json:"parent,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project - // number](https://developers.google.com/console/help/new/#projectnumber) - // . This field has been deprecated and replaced by the parent field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // parent field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the parent field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the parent field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -1442,14 +1407,12 @@ func (s *CreateNodePoolRequest) MarshalJSON() ([]byte, error) { type DailyMaintenanceWindow struct { // Duration: [Output only] Duration of the time window, automatically // chosen to be smallest possible in the given scenario. Duration will - // be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format - // "PTnHnMnS". + // be in RFC3339 format "PTnHnMnS". Duration string `json:"duration,omitempty"` // StartTime: Time within the maintenance window to start the - // maintenance operations. Time format should be in - // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format "HH:MM", where - // HH : [00-23] and MM : [00-59] GMT. + // maintenance operations. Time format should be in RFC3339 format + // "HH:MM", where HH : [00-23] and MM : [00-59] GMT. StartTime string `json:"startTime,omitempty"` // ForceSendFields is a list of field names (e.g. "Duration") to @@ -1792,11 +1755,9 @@ type IPAllocationPolicy struct { // blank. This field is only applicable when `use_ip_aliases` is true. // Set to blank to have a range chosen with the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. + // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 + // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, + // `192.168.0.0/16`) to pick a specific range to use. ClusterIpv4CidrBlock string `json:"clusterIpv4CidrBlock,omitempty"` // ClusterSecondaryRangeName: The name of the secondary range to be used @@ -1818,11 +1779,9 @@ type IPAllocationPolicy struct { // cluster. This is applicable only if `create_subnetwork` is true. Set // to blank to have a range chosen with the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. + // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 + // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, + // `192.168.0.0/16`) to pick a specific range to use. NodeIpv4CidrBlock string `json:"nodeIpv4CidrBlock,omitempty"` // ServicesIpv4Cidr: This field is deprecated, use @@ -1834,11 +1793,9 @@ type IPAllocationPolicy struct { // default size. This field is only applicable when `use_ip_aliases` is // true. Set to blank to have a range chosen with the default size. Set // to /netmask (e.g. `/14`) to have a range chosen with a specific - // netmask. Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. + // netmask. Set to a CIDR notation (e.g. `10.96.0.0/14`) from the + // RFC-1918 private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, + // `192.168.0.0/16`) to pick a specific range to use. ServicesIpv4CidrBlock string `json:"servicesIpv4CidrBlock,omitempty"` // ServicesSecondaryRangeName: The name of the secondary range to be @@ -1858,11 +1815,9 @@ type IPAllocationPolicy struct { // the default size. This field is only applicable when `use_ip_aliases` // is true. If unspecified, the range will use the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. + // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 + // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, + // `192.168.0.0/16`) to pick a specific range to use. TpuIpv4CidrBlock string `json:"tpuIpv4CidrBlock,omitempty"` // UseIpAliases: Whether alias IPs will be used for pod IPs in the @@ -2477,8 +2432,7 @@ type NetworkConfig struct { Network string `json:"network,omitempty"` // Subnetwork: Output only. The relative name of the Google Compute - // Engine [subnetwork](https://cloud.google.com/compute/docs/vpc) to - // which the cluster is connected. Example: + // Engine subnetwork to which the cluster is connected. Example: // projects/my-project/regions/us-central1/subnetworks/my-subnet Subnetwork string `json:"subnetwork,omitempty"` @@ -2618,8 +2572,7 @@ type NodeConfig struct { // information. LocalSsdCount int64 `json:"localSsdCount,omitempty"` - // MachineType: The name of a Google Compute Engine [machine - // type](https://cloud.google.com/compute/docs/machine-types) If + // MachineType: The name of a Google Compute Engine machine type If // unspecified, the default machine type is `e2-medium`. MachineType string `json:"machineType,omitempty"` @@ -2646,15 +2599,12 @@ type NodeConfig struct { // instance may be scheduled on the specified or newer CPU platform. // Applicable values are the friendly names of CPU platforms, such as // `minCpuPlatform: "Intel Haswell" or `minCpuPlatform: "Intel Sandy - // Bridge". For more information, read [how to specify min CPU - // platform](https://cloud.google.com/compute/docs/instances/specify-min- - // cpu-platform) + // Bridge". For more information, read how to specify min CPU platform MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NodeGroup: Setting this field will assign instances of this pool to // run on the specified node group. This is useful for running workloads - // on [sole tenant - // nodes](https://cloud.google.com/compute/docs/nodes/sole-tenant-nodes). + // on sole tenant nodes. NodeGroup string `json:"nodeGroup,omitempty"` // OauthScopes: The set of Google API scopes to be made available on all @@ -2663,8 +2613,7 @@ type NodeConfig struct { // included: * `https://www.googleapis.com/auth/compute` is required for // mounting persistent storage on your nodes. * // `https://www.googleapis.com/auth/devstorage.read_only` is required - // for communicating with **gcr.io** (the [Google Container - // Registry](https://cloud.google.com/container-registry/)). If + // for communicating with **gcr.io** (the Google Container Registry). If // unspecified, no scopes are added, unless Cloud Logging or Cloud // Monitoring are enabled, in which case their required scopes will be // added. @@ -2677,9 +2626,8 @@ type NodeConfig struct { Preemptible bool `json:"preemptible,omitempty"` // ReservationAffinity: The optional reservation affinity. Setting this - // field will apply the specified [Zonal Compute - // Reservation](https://cloud.google.com/compute/docs/instances/reserving - // -zonal-resources) to this node pool. + // field will apply the specified Zonal Compute Reservation to this node + // pool. ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` // SandboxConfig: Sandbox configuration for this node. @@ -2791,26 +2739,20 @@ type NodePool struct { Config *NodeConfig `json:"config,omitempty"` // InitialNodeCount: The initial node count for the pool. You must - // ensure that your Compute Engine [resource - // quota](https://cloud.google.com/compute/quotas) is sufficient for - // this number of instances. You must also have available firewall and - // routes quota. + // ensure that your Compute Engine resource quota is sufficient for this + // number of instances. You must also have available firewall and routes + // quota. InitialNodeCount int64 `json:"initialNodeCount,omitempty"` - // InstanceGroupUrls: [Output only] The resource URLs of the [managed - // instance - // groups](https://cloud.google.com/compute/docs/instance-groups/creating - // -groups-of-managed-instances) associated with this node pool. + // InstanceGroupUrls: [Output only] The resource URLs of the managed + // instance groups associated with this node pool. InstanceGroupUrls []string `json:"instanceGroupUrls,omitempty"` - // Locations: The list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in - // which the NodePool's nodes should be located. If this value is - // unspecified during node pool creation, the - // [Cluster.Locations](https://cloud.google.com/kubernetes-engine/docs/re - // ference/rest/v1/projects.locations.clusters#Cluster.FIELDS.locations) - // value will be used, instead. Warning: changing node pool locations - // will result in nodes being added and/or removed. + // Locations: The list of Google Compute Engine zones in which the + // NodePool's nodes should be located. If this value is unspecified + // during node pool creation, the Cluster.Locations value will be used, + // instead. Warning: changing node pool locations will result in nodes + // being added and/or removed. Locations []string `json:"locations,omitempty"` // Management: NodeManagement configuration for this NodePool. @@ -2933,9 +2875,8 @@ func (s *NodePoolAutoscaling) MarshalJSON() ([]byte, error) { // NodeTaint: Kubernetes taint is comprised of three fields: key, value, // and effect. Effect can only be one of three types: NoSchedule, -// PreferNoSchedule or NoExecute. See -// [here](https://kubernetes.io/docs/concepts/configuration/taint-and-tol -// eration) for more information, including usage and the valid values. +// PreferNoSchedule or NoExecute. See here for more information, +// including usage and the valid values. type NodeTaint struct { // Effect: Effect for taint. // @@ -2985,15 +2926,12 @@ type Operation struct { // Detail: Detailed operation progress, if available. Detail string `json:"detail,omitempty"` - // EndTime: [Output only] The time the operation completed, in - // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. + // EndTime: [Output only] The time the operation completed, in RFC3339 + // text format. EndTime string `json:"endTime,omitempty"` - // Location: [Output only] The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zon - // es#available) or - // [region](https://cloud.google.com/compute/docs/regions-zones/regions-z - // ones#available) in which the cluster resides. + // Location: [Output only] The name of the Google Compute Engine zone or + // region in which the cluster resides. Location string `json:"location,omitempty"` // Name: The server-assigned ID for the operation. @@ -3032,8 +2970,8 @@ type Operation struct { // SelfLink: Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` - // StartTime: [Output only] The time the operation started, in - // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. + // StartTime: [Output only] The time the operation started, in RFC3339 + // text format. StartTime string `json:"startTime,omitempty"` // Status: The current status of the operation. @@ -3053,10 +2991,9 @@ type Operation struct { // TargetLink: Server-defined URL for the target of the operation. TargetLink string `json:"targetLink,omitempty"` - // Zone: The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the operation is taking place. This field is deprecated, use - // location instead. + // Zone: The name of the Google Compute Engine zone in which the + // operation is taking place. This field is deprecated, use location + // instead. Zone string `json:"zone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -3367,10 +3304,8 @@ func (s *ReleaseChannelConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ReservationAffinity: -// [ReservationAffinity](https://cloud.google.com/compute/docs/instances/ -// reserving-zonal-resources) is the configuration of desired -// reservation which instances could take capacity from. +// ReservationAffinity: ReservationAffinity is the configuration of +// desired reservation which instances could take capacity from. type ReservationAffinity struct { // ConsumeReservationType: Corresponds to the type of reservation // consumption. @@ -3509,15 +3444,14 @@ type RollbackNodePoolUpgradeRequest struct { // field has been deprecated and replaced by the name field. NodePoolId string `json:"nodePoolId,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3641,15 +3575,14 @@ type SetAddonsConfigRequest struct { // addons. Specified in the format `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "AddonsConfig") to @@ -3695,19 +3628,17 @@ type SetLabelsRequest struct { // labels. Specified in the format `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project - // number](https://developers.google.com/console/help/new/#projectnumber) - // . This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` // ResourceLabels: Required. The labels to set for that cluster. ResourceLabels map[string]string `json:"resourceLabels,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3749,15 +3680,14 @@ type SetLegacyAbacRequest struct { // `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3790,12 +3720,12 @@ type SetLocationsRequest struct { // has been deprecated and replaced by the name field. ClusterId string `json:"clusterId,omitempty"` - // Locations: Required. The desired list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster's nodes should be located. Changing the locations a - // cluster is in will result in nodes being either created or removed - // from the cluster, depending on whether locations are being added or - // removed. This list must always include the cluster's primary zone. + // Locations: Required. The desired list of Google Compute Engine zones + // in which the cluster's nodes should be located. Changing the + // locations a cluster is in will result in nodes being either created + // or removed from the cluster, depending on whether locations are being + // added or removed. This list must always include the cluster's primary + // zone. Locations []string `json:"locations,omitempty"` // Name: The name (project, location, cluster) of the cluster to set @@ -3803,15 +3733,14 @@ type SetLocationsRequest struct { // `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3858,15 +3787,14 @@ type SetLoggingServiceRequest struct { // logging. Specified in the format `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3907,13 +3835,12 @@ type SetMaintenancePolicyRequest struct { // `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Required. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). + // ProjectId: Required. The Google Developers Console project ID or + // project number. ProjectId string `json:"projectId,omitempty"` - // Zone: Required. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. + // Zone: Required. The name of the Google Compute Engine zone in which + // the cluster resides. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3963,18 +3890,17 @@ type SetMasterAuthRequest struct { // auth. Specified in the format `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` // Update: Required. A description of the update. Update *MasterAuth `json:"update,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to @@ -4023,15 +3949,14 @@ type SetMonitoringServiceRequest struct { // `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4073,16 +3998,14 @@ type SetNetworkPolicyRequest struct { // feature. NetworkPolicy *NetworkPolicy `json:"networkPolicy,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project - // number](https://developers.google.com/console/help/new/#projectnumber) - // . This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4127,15 +4050,14 @@ type SetNodePoolAutoscalingRequest struct { // field has been deprecated and replaced by the name field. NodePoolId string `json:"nodePoolId,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Autoscaling") to @@ -4180,15 +4102,14 @@ type SetNodePoolManagementRequest struct { // field has been deprecated and replaced by the name field. NodePoolId string `json:"nodePoolId,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4233,15 +4154,14 @@ type SetNodePoolSizeRequest struct { // field has been deprecated and replaced by the name field. NodePoolId string `json:"nodePoolId,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4349,19 +4269,17 @@ type StartIPRotationRequest struct { // `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project - // number](https://developers.google.com/console/help/new/#projectnumber) - // . This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` // RotateCredentials: Whether to rotate credentials during IP rotation. RotateCredentials bool `json:"rotateCredentials,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4475,18 +4393,17 @@ type UpdateClusterRequest struct { // Specified in the format `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` // Update: Required. A description of the update. Update *ClusterUpdate `json:"update,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4533,15 +4450,14 @@ type UpdateMasterRequest struct { // Specified in the format `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4577,11 +4493,10 @@ type UpdateNodePoolRequest struct { // ImageType: Required. The desired image type for the node pool. ImageType string `json:"imageType,omitempty"` - // Locations: The desired list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in - // which the node pool's nodes should be located. Changing the locations - // for a node pool will result in nodes being either created or removed - // from the node pool, depending on whether locations are being added or + // Locations: The desired list of Google Compute Engine zones in which + // the node pool's nodes should be located. Changing the locations for a + // node pool will result in nodes being either created or removed from + // the node pool, depending on whether locations are being added or // removed. Locations []string `json:"locations,omitempty"` @@ -4604,9 +4519,9 @@ type UpdateNodePoolRequest struct { // picks the Kubernetes master version NodeVersion string `json:"nodeVersion,omitempty"` - // ProjectId: Deprecated. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). - // This field has been deprecated and replaced by the name field. + // ProjectId: Deprecated. The Google Developers Console project ID or + // project number. This field has been deprecated and replaced by the + // name field. ProjectId string `json:"projectId,omitempty"` // UpgradeSettings: Upgrade settings control disruption and speed of the @@ -4617,10 +4532,9 @@ type UpdateNodePoolRequest struct { // node pool. WorkloadMetadataConfig *WorkloadMetadataConfig `json:"workloadMetadataConfig,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and - // replaced by the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -5180,8 +5094,7 @@ func (r *ProjectsLocationsService) GetServerConfig(name string) *ProjectsLocatio } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field +// Google Developers Console project ID or project number. This field // has been deprecated and replaced by the name field. func (c *ProjectsLocationsGetServerConfigCall) ProjectId(projectId string) *ProjectsLocationsGetServerConfigCall { c.urlParams_.Set("projectId", projectId) @@ -5189,10 +5102,8 @@ func (c *ProjectsLocationsGetServerConfigCall) ProjectId(projectId string) *Proj } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) to -// return operations for. This field has been deprecated and replaced by -// the name field. +// Google Compute Engine zone to return operations for. This field has +// been deprecated and replaced by the name field. func (c *ProjectsLocationsGetServerConfigCall) Zone(zone string) *ProjectsLocationsGetServerConfigCall { c.urlParams_.Set("zone", zone) return c @@ -5487,13 +5398,12 @@ type ProjectsLocationsClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is -// created in the project's [default -// network](https://cloud.google.com/compute/docs/networks-and-firewalls# -// networks). One firewall is added for the cluster. After cluster -// creation, the Kubelet creates routes for each node to allow the -// containers on that node to communicate with all other instances in -// the cluster. Finally, an entry is added to the project's global -// metadata indicating which CIDR range the cluster is using. +// created in the project's default network. One firewall is added for +// the cluster. After cluster creation, the Kubelet creates routes for +// each node to allow the containers on that node to communicate with +// all other instances in the cluster. Finally, an entry is added to the +// project's global metadata indicating which CIDR range the cluster is +// using. func (r *ProjectsLocationsClustersService) Create(parent string, createclusterrequest *CreateClusterRequest) *ProjectsLocationsClustersCreateCall { c := &ProjectsLocationsClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5653,8 +5563,7 @@ func (c *ProjectsLocationsClustersDeleteCall) ClusterId(clusterId string) *Proje } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field +// Google Developers Console project ID or project number. This field // has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersDeleteCall) ProjectId(projectId string) *ProjectsLocationsClustersDeleteCall { c.urlParams_.Set("projectId", projectId) @@ -5662,10 +5571,8 @@ func (c *ProjectsLocationsClustersDeleteCall) ProjectId(projectId string) *Proje } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the name field. +// Google Compute Engine zone in which the cluster resides. This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersDeleteCall) Zone(zone string) *ProjectsLocationsClustersDeleteCall { c.urlParams_.Set("zone", zone) return c @@ -5826,8 +5733,7 @@ func (c *ProjectsLocationsClustersGetCall) ClusterId(clusterId string) *Projects } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field +// Google Developers Console project ID or project number. This field // has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersGetCall) ProjectId(projectId string) *ProjectsLocationsClustersGetCall { c.urlParams_.Set("projectId", projectId) @@ -5835,10 +5741,8 @@ func (c *ProjectsLocationsClustersGetCall) ProjectId(projectId string) *Projects } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the name field. +// Google Compute Engine zone in which the cluster resides. This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersGetCall) Zone(zone string) *ProjectsLocationsClustersGetCall { c.urlParams_.Set("zone", zone) return c @@ -6148,8 +6052,7 @@ func (r *ProjectsLocationsClustersService) List(parent string) *ProjectsLocation } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field +// Google Developers Console project ID or project number. This field // has been deprecated and replaced by the parent field. func (c *ProjectsLocationsClustersListCall) ProjectId(projectId string) *ProjectsLocationsClustersListCall { c.urlParams_.Set("projectId", projectId) @@ -6157,10 +6060,9 @@ func (c *ProjectsLocationsClustersListCall) ProjectId(projectId string) *Project } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides, or "-" for all zones. This field has been -// deprecated and replaced by the parent field. +// Google Compute Engine zone in which the cluster resides, or "-" for +// all zones. This field has been deprecated and replaced by the parent +// field. func (c *ProjectsLocationsClustersListCall) Zone(zone string) *ProjectsLocationsClustersListCall { c.urlParams_.Set("zone", zone) return c @@ -6595,10 +6497,7 @@ type ProjectsLocationsClustersSetLocationsCall struct { } // SetLocations: Sets the locations for a specific cluster. Deprecated. -// Use -// [projects.locations.clusters.update](https://cloud.google.com/kubernet -// es-engine/docs/reference/rest/v1/projects.locations.clusters/update) -// instead. +// Use projects.locations.clusters.update instead. func (r *ProjectsLocationsClustersService) SetLocations(name string, setlocationsrequest *SetLocationsRequest) *ProjectsLocationsClustersSetLocationsCall { c := &ProjectsLocationsClustersSetLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8163,19 +8062,16 @@ func (c *ProjectsLocationsClustersNodePoolsDeleteCall) NodePoolId(nodePoolId str } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console [project ID or project -// number](https://developers.google.com/console/help/new/#projectnumber) -// . This field has been deprecated and replaced by the name field. +// Google Developers Console project ID or project number. This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersNodePoolsDeleteCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsDeleteCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the name field. +// Google Compute Engine zone in which the cluster resides. This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersNodePoolsDeleteCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsDeleteCall { c.urlParams_.Set("zone", zone) return c @@ -8349,19 +8245,16 @@ func (c *ProjectsLocationsClustersNodePoolsGetCall) NodePoolId(nodePoolId string } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console [project ID or project -// number](https://developers.google.com/console/help/new/#projectnumber) -// . This field has been deprecated and replaced by the name field. +// Google Developers Console project ID or project number. This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersNodePoolsGetCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsGetCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the name field. +// Google Compute Engine zone in which the cluster resides. This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersNodePoolsGetCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsGetCall { c.urlParams_.Set("zone", zone) return c @@ -8540,19 +8433,16 @@ func (c *ProjectsLocationsClustersNodePoolsListCall) ClusterId(clusterId string) } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console [project ID or project -// number](https://developers.google.com/console/help/new/#projectnumber) -// . This field has been deprecated and replaced by the parent field. +// Google Developers Console project ID or project number. This field +// has been deprecated and replaced by the parent field. func (c *ProjectsLocationsClustersNodePoolsListCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsListCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the parent field. +// Google Compute Engine zone in which the cluster resides. This field +// has been deprecated and replaced by the parent field. func (c *ProjectsLocationsClustersNodePoolsListCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsListCall { c.urlParams_.Set("zone", zone) return c @@ -9414,10 +9304,9 @@ type ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall struct { } // GetOpenidConfiguration: Gets the OIDC discovery document for the -// cluster. See the [OpenID Connect Discovery 1.0 -// specification](https://openid.net/specs/openid-connect-discovery-1_0.h -// tml) for details. This API is not yet intended for general use, and -// is not available for all clusters. +// cluster. See the OpenID Connect Discovery 1.0 specification for +// details. This API is not yet intended for general use, and is not +// available for all clusters. func (r *ProjectsLocationsClustersWellKnownService) GetOpenidConfiguration(parent string) *ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall { c := &ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9714,8 +9603,7 @@ func (c *ProjectsLocationsOperationsGetCall) OperationId(operationId string) *Pr } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field +// Google Developers Console project ID or project number. This field // has been deprecated and replaced by the name field. func (c *ProjectsLocationsOperationsGetCall) ProjectId(projectId string) *ProjectsLocationsOperationsGetCall { c.urlParams_.Set("projectId", projectId) @@ -9723,10 +9611,8 @@ func (c *ProjectsLocationsOperationsGetCall) ProjectId(projectId string) *Projec } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the name field. +// Google Compute Engine zone in which the cluster resides. This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsOperationsGetCall) Zone(zone string) *ProjectsLocationsOperationsGetCall { c.urlParams_.Set("zone", zone) return c @@ -9893,8 +9779,7 @@ func (r *ProjectsLocationsOperationsService) List(parent string) *ProjectsLocati } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field +// Google Developers Console project ID or project number. This field // has been deprecated and replaced by the parent field. func (c *ProjectsLocationsOperationsListCall) ProjectId(projectId string) *ProjectsLocationsOperationsListCall { c.urlParams_.Set("projectId", projectId) @@ -9902,10 +9787,9 @@ func (c *ProjectsLocationsOperationsListCall) ProjectId(projectId string) *Proje } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) to -// return operations for, or `-` for all zones. This field has been -// deprecated and replaced by the parent field. +// Google Compute Engine zone to return operations for, or `-` for all +// zones. This field has been deprecated and replaced by the parent +// field. func (c *ProjectsLocationsOperationsListCall) Zone(zone string) *ProjectsLocationsOperationsListCall { c.urlParams_.Set("zone", zone) return c @@ -10546,13 +10430,12 @@ type ProjectsZonesClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is -// created in the project's [default -// network](https://cloud.google.com/compute/docs/networks-and-firewalls# -// networks). One firewall is added for the cluster. After cluster -// creation, the Kubelet creates routes for each node to allow the -// containers on that node to communicate with all other instances in -// the cluster. Finally, an entry is added to the project's global -// metadata indicating which CIDR range the cluster is using. +// created in the project's default network. One firewall is added for +// the cluster. After cluster creation, the Kubelet creates routes for +// each node to allow the containers on that node to communicate with +// all other instances in the cluster. Finally, an entry is added to the +// project's global metadata indicating which CIDR range the cluster is +// using. func (r *ProjectsZonesClustersService) Create(projectId string, zone string, createclusterrequest *CreateClusterRequest) *ProjectsZonesClustersCreateCall { c := &ProjectsZonesClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -11374,9 +11257,7 @@ type ProjectsZonesClustersLocationsCall struct { } // Locations: Sets the locations for a specific cluster. Deprecated. Use -// [projects.locations.clusters.update](https://cloud.google.com/kubernet -// es-engine/docs/reference/rest/v1/projects.locations.clusters/update) -// instead. +// projects.locations.clusters.update instead. func (r *ProjectsZonesClustersService) Locations(projectId string, zone string, clusterId string, setlocationsrequest *SetLocationsRequest) *ProjectsZonesClustersLocationsCall { c := &ProjectsZonesClustersLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId diff --git a/container/v1beta1/container-gen.go b/container/v1beta1/container-gen.go index 499e559f8ee..39aa1198d84 100644 --- a/container/v1beta1/container-gen.go +++ b/container/v1beta1/container-gen.go @@ -284,8 +284,7 @@ type AcceleratorConfig struct { AcceleratorCount int64 `json:"acceleratorCount,omitempty,string"` // AcceleratorType: The accelerator type resource name. List of - // supported accelerators - // [here](https://cloud.google.com/compute/docs/gpus) + // supported accelerators here AcceleratorType string `json:"acceleratorType,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to @@ -427,8 +426,7 @@ func (s *AuthenticatorGroupsConfig) MarshalJSON() ([]byte, error) { type AutoUpgradeOptions struct { // AutoUpgradeStartTime: [Output only] This field is set when upgrades // are about to commence with the approximate start time for the - // upgrades, in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text - // format. + // upgrades, in RFC3339 text format. AutoUpgradeStartTime string `json:"autoUpgradeStartTime,omitempty"` // Description: [Output only] This field is set when upgrades are about @@ -488,10 +486,8 @@ type AutoprovisioningNodePoolDefaults struct { // instance may be scheduled on the specified or newer CPU platform. // Applicable values are the friendly names of CPU platforms, such as // `minCpuPlatform: "Intel Haswell" or `minCpuPlatform: "Intel Sandy - // Bridge". For more information, read [how to specify min CPU - // platform](https://cloud.google.com/compute/docs/instances/specify-min- - // cpu-platform) To unset the min cpu platform field pass "automatic" as - // field value. + // Bridge". For more information, read how to specify min CPU platform + // To unset the min cpu platform field pass "automatic" as field value. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // OauthScopes: The set of Google API scopes to be made available on all @@ -500,8 +496,7 @@ type AutoprovisioningNodePoolDefaults struct { // included: * `https://www.googleapis.com/auth/compute` is required for // mounting persistent storage on your nodes. * // `https://www.googleapis.com/auth/devstorage.read_only` is required - // for communicating with **gcr.io** (the [Google Container - // Registry](https://cloud.google.com/container-registry/)). If + // for communicating with **gcr.io** (the Google Container Registry). If // unspecified, no scopes are added, unless Cloud Logging or Cloud // Monitoring are enabled, in which case their required scopes will be // added. @@ -647,15 +642,13 @@ type CancelOperationRequest struct { OperationId string `json:"operationId,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the operation resides. This field has been deprecated and - // replaced by the name field. + // zone in which the operation resides. This field has been deprecated + // and replaced by the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -801,10 +794,8 @@ type Cluster struct { BinaryAuthorization *BinaryAuthorization `json:"binaryAuthorization,omitempty"` // ClusterIpv4Cidr: The IP address range of the container pods in this - // cluster, in - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically - // chosen or specify a `/14` block in `10.0.0.0/8`. + // cluster, in CIDR notation (e.g. `10.96.0.0/14`). Leave blank to have + // one automatically chosen or specify a `/14` block in `10.0.0.0/8`. ClusterIpv4Cidr string `json:"clusterIpv4Cidr,omitempty"` // ClusterTelemetry: Telemetry integration for the cluster. @@ -817,7 +808,7 @@ type Cluster struct { ConfidentialNodes *ConfidentialNodes `json:"confidentialNodes,omitempty"` // CreateTime: [Output only] The time the cluster was created, in - // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. + // RFC3339 text format. CreateTime string `json:"createTime,omitempty"` // CurrentMasterVersion: [Output only] The current software version of @@ -829,11 +820,9 @@ type Cluster struct { // information. CurrentNodeCount int64 `json:"currentNodeCount,omitempty"` - // CurrentNodeVersion: [Output only] Deprecated, use - // [NodePool.version](https://cloud.google.com/kubernetes-engine/docs/ref - // erence/rest/v1beta1/projects.locations.clusters.nodePools) instead. - // The current version of the node software components. If they are - // currently at multiple versions because they're in the process of + // CurrentNodeVersion: [Output only] Deprecated, use NodePool.version + // instead. The current version of the node software components. If they + // are currently at multiple versions because they're in the process of // being upgraded, this reflects the minimum version of all nodes. CurrentNodeVersion string `json:"currentNodeVersion,omitempty"` @@ -868,8 +857,7 @@ type Cluster struct { Endpoint string `json:"endpoint,omitempty"` // ExpireTime: [Output only] The time the cluster will be automatically - // deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text - // format. + // deleted in RFC3339 text format. ExpireTime string `json:"expireTime,omitempty"` // InitialClusterVersion: The initial Kubernetes version for this @@ -886,8 +874,7 @@ type Cluster struct { InitialClusterVersion string `json:"initialClusterVersion,omitempty"` // InitialNodeCount: The number of nodes to create in this cluster. You - // must ensure that your Compute Engine [resource - // quota](https://cloud.google.com/compute/quotas) is sufficient for + // must ensure that your Compute Engine resource quota is sufficient for // this number of instances. You must also have available firewall and // routes quota. For requests, this field should only be used in lieu of // a "node_pool" object, since this configuration (along with the @@ -910,25 +897,16 @@ type Cluster struct { // LegacyAbac: Configuration for the legacy ABAC authorization mode. LegacyAbac *LegacyAbac `json:"legacyAbac,omitempty"` - // Location: [Output only] The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zon - // es#available) or - // [region](https://cloud.google.com/compute/docs/regions-zones/regions-z - // ones#available) in which the cluster resides. + // Location: [Output only] The name of the Google Compute Engine zone or + // region in which the cluster resides. Location string `json:"location,omitempty"` - // Locations: The list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster's nodes should be located. This field provides a - // default value if - // [NodePool.Locations](https://cloud.google.com/kubernetes-engine/docs/r - // eference/rest/v1/projects.locations.clusters.nodePools#NodePool.FIELDS - // .locations) are not specified during node pool creation. Warning: - // changing cluster locations will update the - // [NodePool.Locations](https://cloud.google.com/kubernetes-engine/docs/r - // eference/rest/v1/projects.locations.clusters.nodePools#NodePool.FIELDS - // .locations) of all node pools and will result in nodes being added - // and/or removed. + // Locations: The list of Google Compute Engine zones in which the + // cluster's nodes should be located. This field provides a default + // value if NodePool.Locations are not specified during node pool + // creation. Warning: changing cluster locations will update the + // NodePool.Locations of all node pools and will result in nodes being + // added and/or removed. Locations []string `json:"locations,omitempty"` // LoggingService: The logging service the cluster should use to write @@ -983,11 +961,9 @@ type Cluster struct { // with a number or a letter. Name string `json:"name,omitempty"` - // Network: The name of the Google Compute Engine - // [network](https://cloud.google.com/compute/docs/networks-and-firewalls - // #networks) to which the cluster is connected. If left unspecified, - // the `default` network will be used. On output this shows the network - // ID instead of the name. + // Network: The name of the Google Compute Engine network to which the + // cluster is connected. If left unspecified, the `default` network will + // be used. On output this shows the network ID instead of the name. Network string `json:"network,omitempty"` // NetworkConfig: Configuration for cluster networking. @@ -1051,10 +1027,9 @@ type Cluster struct { SelfLink string `json:"selfLink,omitempty"` // ServicesIpv4Cidr: [Output only] The IP address range of the - // Kubernetes services in this cluster, in - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `1.2.3.4/29`). Service addresses are typically put in - // the last `/16` from the container CIDR. + // Kubernetes services in this cluster, in CIDR notation (e.g. + // `1.2.3.4/29`). Service addresses are typically put in the last `/16` + // from the container CIDR. ServicesIpv4Cidr string `json:"servicesIpv4Cidr,omitempty"` // ShieldedNodes: Shielded Nodes configuration. @@ -1084,19 +1059,16 @@ type Cluster struct { // status of this cluster, if available. StatusMessage string `json:"statusMessage,omitempty"` - // Subnetwork: The name of the Google Compute Engine - // [subnetwork](https://cloud.google.com/compute/docs/subnetworks) to - // which the cluster is connected. On output this shows the subnetwork - // ID instead of the name. + // Subnetwork: The name of the Google Compute Engine subnetwork to which + // the cluster is connected. On output this shows the subnetwork ID + // instead of the name. Subnetwork string `json:"subnetwork,omitempty"` // TpuConfig: Configuration for Cloud TPU support; TpuConfig *TpuConfig `json:"tpuConfig,omitempty"` // TpuIpv4CidrBlock: [Output only] The IP address range of the Cloud - // TPUs in this cluster, in - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `1.2.3.4/29`). + // TPUs in this cluster, in CIDR notation (e.g. `1.2.3.4/29`). TpuIpv4CidrBlock string `json:"tpuIpv4CidrBlock,omitempty"` // VerticalPodAutoscaling: Cluster-level Vertical Pod Autoscaling @@ -1107,8 +1079,7 @@ type Cluster struct { // Service Accounts in GCP IAM policies. WorkloadIdentityConfig *WorkloadIdentityConfig `json:"workloadIdentityConfig,omitempty"` - // Zone: [Output only] The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in + // Zone: [Output only] The name of the Google Compute Engine zone in // which the cluster resides. This field is deprecated, use location // instead. Zone string `json:"zone,omitempty"` @@ -1145,8 +1116,7 @@ func (s *Cluster) MarshalJSON() ([]byte, error) { // the size of the cluster and create/delete node pools based on the // current needs. type ClusterAutoscaling struct { - // AutoprovisioningLocations: The list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in + // AutoprovisioningLocations: The list of Google Compute Engine zones in // which the NodePool's nodes can be created by NAP. AutoprovisioningLocations []string `json:"autoprovisioningLocations,omitempty"` @@ -1277,8 +1247,7 @@ type ClusterUpdate struct { // visibility. DesiredIntraNodeVisibilityConfig *IntraNodeVisibilityConfig `json:"desiredIntraNodeVisibilityConfig,omitempty"` - // DesiredLocations: The desired list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in + // DesiredLocations: The desired list of Google Compute Engine zones in // which the cluster's nodes should be located. This list must always // include the cluster's primary zone. Warning: changing cluster // locations will update the locations of all node pools and will result @@ -1415,14 +1384,12 @@ type CompleteIPRotationRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://developers.google.com/console/help/new/#projectnumber) - // . This field has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -1542,9 +1509,7 @@ func (s *ConsumptionMeteringConfig) MarshalJSON() ([]byte, error) { // CreateClusterRequest: CreateClusterRequest creates a cluster. type CreateClusterRequest struct { - // Cluster: Required. A [cluster - // resource](https://cloud.google.com/container-engine/reference/rest/v1b - // eta1/projects.locations.clusters) + // Cluster: Required. A cluster resource Cluster *Cluster `json:"cluster,omitempty"` // Parent: The parent (project and location) where the cluster will be @@ -1552,14 +1517,12 @@ type CreateClusterRequest struct { Parent string `json:"parent,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the parent field. + // project ID or project number. This field has been deprecated and + // replaced by the parent field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the parent field. Zone string `json:"zone,omitempty"` @@ -1602,14 +1565,12 @@ type CreateNodePoolRequest struct { Parent string `json:"parent,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://developers.google.com/console/help/new/#projectnumber) - // . This field has been deprecated and replaced by the parent field. + // project ID or project number. This field has been deprecated and + // replaced by the parent field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the parent field. Zone string `json:"zone,omitempty"` @@ -2063,11 +2024,9 @@ type IPAllocationPolicy struct { // blank. This field is only applicable when `use_ip_aliases` is true. // Set to blank to have a range chosen with the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. + // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 + // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, + // `192.168.0.0/16`) to pick a specific range to use. ClusterIpv4CidrBlock string `json:"clusterIpv4CidrBlock,omitempty"` // ClusterSecondaryRangeName: The name of the secondary range to be used @@ -2089,11 +2048,9 @@ type IPAllocationPolicy struct { // cluster. This is applicable only if `create_subnetwork` is true. Set // to blank to have a range chosen with the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. + // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 + // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, + // `192.168.0.0/16`) to pick a specific range to use. NodeIpv4CidrBlock string `json:"nodeIpv4CidrBlock,omitempty"` // ServicesIpv4Cidr: This field is deprecated, use @@ -2105,11 +2062,9 @@ type IPAllocationPolicy struct { // default size. This field is only applicable when `use_ip_aliases` is // true. Set to blank to have a range chosen with the default size. Set // to /netmask (e.g. `/14`) to have a range chosen with a specific - // netmask. Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. + // netmask. Set to a CIDR notation (e.g. `10.96.0.0/14`) from the + // RFC-1918 private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, + // `192.168.0.0/16`) to pick a specific range to use. ServicesIpv4CidrBlock string `json:"servicesIpv4CidrBlock,omitempty"` // ServicesSecondaryRangeName: The name of the secondary range to be @@ -2129,12 +2084,10 @@ type IPAllocationPolicy struct { // the default size. This field is only applicable when `use_ip_aliases` // is true. If unspecified, the range will use the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a - // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks - // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a - // specific range to use. This field is deprecated, use - // cluster.tpu_config.ipv4_cidr_block instead. + // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 + // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, + // `192.168.0.0/16`) to pick a specific range to use. This field is + // deprecated, use cluster.tpu_config.ipv4_cidr_block instead. TpuIpv4CidrBlock string `json:"tpuIpv4CidrBlock,omitempty"` // UseIpAliases: Whether alias IPs will be used for pod IPs in the @@ -2944,8 +2897,7 @@ type NetworkConfig struct { Network string `json:"network,omitempty"` // Subnetwork: Output only. The relative name of the Google Compute - // Engine [subnetwork](https://cloud.google.com/compute/docs/vpc) to - // which the cluster is connected. Example: + // Engine subnetwork to which the cluster is connected. Example: // projects/my-project/regions/us-central1/subnetworks/my-subnet Subnetwork string `json:"subnetwork,omitempty"` @@ -3096,8 +3048,7 @@ type NodeConfig struct { // information. LocalSsdCount int64 `json:"localSsdCount,omitempty"` - // MachineType: The name of a Google Compute Engine [machine - // type](https://cloud.google.com/compute/docs/machine-types). If + // MachineType: The name of a Google Compute Engine machine type. If // unspecified, the default machine type is `e2-medium`. MachineType string `json:"machineType,omitempty"` @@ -3124,15 +3075,12 @@ type NodeConfig struct { // instance may be scheduled on the specified or newer CPU platform. // Applicable values are the friendly names of CPU platforms, such as // `minCpuPlatform: "Intel Haswell" or `minCpuPlatform: "Intel Sandy - // Bridge". For more information, read [how to specify min CPU - // platform](https://cloud.google.com/compute/docs/instances/specify-min- - // cpu-platform) + // Bridge". For more information, read how to specify min CPU platform MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NodeGroup: Setting this field will assign instances of this pool to // run on the specified node group. This is useful for running workloads - // on [sole tenant - // nodes](https://cloud.google.com/compute/docs/nodes/sole-tenant-nodes). + // on sole tenant nodes. NodeGroup string `json:"nodeGroup,omitempty"` // OauthScopes: The set of Google API scopes to be made available on all @@ -3141,8 +3089,7 @@ type NodeConfig struct { // included: * `https://www.googleapis.com/auth/compute` is required for // mounting persistent storage on your nodes. * // `https://www.googleapis.com/auth/devstorage.read_only` is required - // for communicating with **gcr.io** (the [Google Container - // Registry](https://cloud.google.com/container-registry/)). If + // for communicating with **gcr.io** (the Google Container Registry). If // unspecified, no scopes are added, unless Cloud Logging or Cloud // Monitoring are enabled, in which case their required scopes will be // added. @@ -3155,9 +3102,8 @@ type NodeConfig struct { Preemptible bool `json:"preemptible,omitempty"` // ReservationAffinity: The optional reservation affinity. Setting this - // field will apply the specified [Zonal Compute - // Reservation](https://cloud.google.com/compute/docs/instances/reserving - // -zonal-resources) to this node pool. + // field will apply the specified Zonal Compute Reservation to this node + // pool. ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` // SandboxConfig: Sandbox configuration for this node. @@ -3311,26 +3257,20 @@ type NodePool struct { Config *NodeConfig `json:"config,omitempty"` // InitialNodeCount: The initial node count for the pool. You must - // ensure that your Compute Engine [resource - // quota](https://cloud.google.com/compute/quotas) is sufficient for - // this number of instances. You must also have available firewall and - // routes quota. + // ensure that your Compute Engine resource quota is sufficient for this + // number of instances. You must also have available firewall and routes + // quota. InitialNodeCount int64 `json:"initialNodeCount,omitempty"` - // InstanceGroupUrls: [Output only] The resource URLs of the [managed - // instance - // groups](https://cloud.google.com/compute/docs/instance-groups/creating - // -groups-of-managed-instances) associated with this node pool. + // InstanceGroupUrls: [Output only] The resource URLs of the managed + // instance groups associated with this node pool. InstanceGroupUrls []string `json:"instanceGroupUrls,omitempty"` - // Locations: The list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in - // which the NodePool's nodes should be located. If this value is - // unspecified during node pool creation, the - // [Cluster.Locations](https://cloud.google.com/kubernetes-engine/docs/re - // ference/rest/v1/projects.locations.clusters#Cluster.FIELDS.locations) - // value will be used, instead. Warning: changing node pool locations - // will result in nodes being added and/or removed. + // Locations: The list of Google Compute Engine zones in which the + // NodePool's nodes should be located. If this value is unspecified + // during node pool creation, the Cluster.Locations value will be used, + // instead. Warning: changing node pool locations will result in nodes + // being added and/or removed. Locations []string `json:"locations,omitempty"` // Management: NodeManagement configuration for this NodePool. @@ -3453,9 +3393,8 @@ func (s *NodePoolAutoscaling) MarshalJSON() ([]byte, error) { // NodeTaint: Kubernetes taint is comprised of three fields: key, value, // and effect. Effect can only be one of three types: NoSchedule, -// PreferNoSchedule or NoExecute. See -// [here](https://kubernetes.io/docs/concepts/configuration/taint-and-tol -// eration) for more information, including usage and the valid values. +// PreferNoSchedule or NoExecute. See here for more information, +// including usage and the valid values. type NodeTaint struct { // Effect: Effect for taint. // @@ -3535,18 +3474,15 @@ type Operation struct { // Detail: Detailed operation progress, if available. Detail string `json:"detail,omitempty"` - // EndTime: [Output only] The time the operation completed, in - // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. + // EndTime: [Output only] The time the operation completed, in RFC3339 + // text format. EndTime string `json:"endTime,omitempty"` // Error: The error result of the operation in case of failure. Error *Status `json:"error,omitempty"` - // Location: [Output only] The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zon - // es#available) or - // [region](https://cloud.google.com/compute/docs/regions-zones/regions-z - // ones#available) in which the cluster resides. + // Location: [Output only] The name of the Google Compute Engine zone or + // region in which the cluster resides. Location string `json:"location,omitempty"` // Name: The server-assigned ID for the operation. @@ -3585,8 +3521,8 @@ type Operation struct { // SelfLink: Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` - // StartTime: [Output only] The time the operation started, in - // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. + // StartTime: [Output only] The time the operation started, in RFC3339 + // text format. StartTime string `json:"startTime,omitempty"` // Status: The current status of the operation. @@ -3606,10 +3542,9 @@ type Operation struct { // TargetLink: Server-defined URL for the target of the operation. TargetLink string `json:"targetLink,omitempty"` - // Zone: The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the operation is taking place. This field is deprecated, use - // location instead. + // Zone: The name of the Google Compute Engine zone in which the + // operation is taking place. This field is deprecated, use location + // instead. Zone string `json:"zone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -3987,10 +3922,8 @@ func (s *ReleaseChannelConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ReservationAffinity: -// [ReservationAffinity](https://cloud.google.com/compute/docs/instances/ -// reserving-zonal-resources) is the configuration of desired -// reservation which instances could take capacity from. +// ReservationAffinity: ReservationAffinity is the configuration of +// desired reservation which instances could take capacity from. type ReservationAffinity struct { // ConsumeReservationType: Corresponds to the type of reservation // consumption. @@ -4131,14 +4064,12 @@ type RollbackNodePoolUpgradeRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4267,14 +4198,12 @@ type SetAddonsConfigRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4322,17 +4251,15 @@ type SetLabelsRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://developers.google.com/console/help/new/#projectnumber) - // . This field has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // ResourceLabels: Required. The labels to set for that cluster. ResourceLabels map[string]string `json:"resourceLabels,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4376,14 +4303,12 @@ type SetLegacyAbacRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4417,12 +4342,12 @@ type SetLocationsRequest struct { // This field has been deprecated and replaced by the name field. ClusterId string `json:"clusterId,omitempty"` - // Locations: Required. The desired list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster's nodes should be located. Changing the locations a - // cluster is in will result in nodes being either created or removed - // from the cluster, depending on whether locations are being added or - // removed. This list must always include the cluster's primary zone. + // Locations: Required. The desired list of Google Compute Engine zones + // in which the cluster's nodes should be located. Changing the + // locations a cluster is in will result in nodes being either created + // or removed from the cluster, depending on whether locations are being + // added or removed. This list must always include the cluster's primary + // zone. Locations []string `json:"locations,omitempty"` // Name: The name (project, location, cluster) of the cluster to set @@ -4431,14 +4356,12 @@ type SetLocationsRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4487,14 +4410,12 @@ type SetLoggingServiceRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4536,13 +4457,12 @@ type SetMaintenancePolicyRequest struct { // `projects/*/locations/*/clusters/*`. Name string `json:"name,omitempty"` - // ProjectId: Required. The Google Developers Console [project ID or - // project number](https://support.google.com/cloud/answer/6158840). + // ProjectId: Required. The Google Developers Console project ID or + // project number. ProjectId string `json:"projectId,omitempty"` - // Zone: Required. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. + // Zone: Required. The name of the Google Compute Engine zone in which + // the cluster resides. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4593,17 +4513,15 @@ type SetMasterAuthRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Update: Required. A description of the update. Update *MasterAuth `json:"update,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4654,14 +4572,12 @@ type SetMonitoringServiceRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4705,14 +4621,12 @@ type SetNetworkPolicyRequest struct { NetworkPolicy *NetworkPolicy `json:"networkPolicy,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://developers.google.com/console/help/new/#projectnumber) - // . This field has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4760,14 +4674,12 @@ type SetNodePoolAutoscalingRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4815,14 +4727,12 @@ type SetNodePoolManagementRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4870,14 +4780,12 @@ type SetNodePoolSizeRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -4987,17 +4895,15 @@ type StartIPRotationRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://developers.google.com/console/help/new/#projectnumber) - // . This field has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // RotateCredentials: Whether to rotate credentials during IP rotation. RotateCredentials bool `json:"rotateCredentials,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -5026,11 +4932,10 @@ func (s *StartIPRotationRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -5285,17 +5190,15 @@ type UpdateClusterRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Update: Required. A description of the update. Update *ClusterUpdate `json:"update,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -5344,14 +5247,12 @@ type UpdateMasterRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -5394,11 +5295,10 @@ type UpdateNodePoolRequest struct { // LinuxNodeConfig: Parameters that can be configured on Linux nodes. LinuxNodeConfig *LinuxNodeConfig `json:"linuxNodeConfig,omitempty"` - // Locations: The desired list of Google Compute Engine - // [zones](https://cloud.google.com/compute/docs/zones#available) in - // which the node pool's nodes should be located. Changing the locations - // for a node pool will result in nodes being either created or removed - // from the node pool, depending on whether locations are being added or + // Locations: The desired list of Google Compute Engine zones in which + // the node pool's nodes should be located. Changing the locations for a + // node pool will result in nodes being either created or removed from + // the node pool, depending on whether locations are being added or // removed. Locations []string `json:"locations,omitempty"` @@ -5423,9 +5323,8 @@ type UpdateNodePoolRequest struct { NodeVersion string `json:"nodeVersion,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // [project ID or project - // number](https://support.google.com/cloud/answer/6158840). This field - // has been deprecated and replaced by the name field. + // project ID or project number. This field has been deprecated and + // replaced by the name field. ProjectId string `json:"projectId,omitempty"` // UpgradeSettings: Upgrade settings control disruption and speed of the @@ -5437,8 +5336,7 @@ type UpdateNodePoolRequest struct { WorkloadMetadataConfig *WorkloadMetadataConfig `json:"workloadMetadataConfig,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // [zone](https://cloud.google.com/compute/docs/zones#available) in - // which the cluster resides. This field has been deprecated and + // zone in which the cluster resides. This field has been deprecated and // replaced by the name field. Zone string `json:"zone,omitempty"` @@ -6028,19 +5926,17 @@ func (r *ProjectsLocationsService) GetServerConfig(name string) *ProjectsLocatio } // ProjectId sets the optional parameter "projectId": Required. -// Deprecated. The Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field -// has been deprecated and replaced by the name field. +// Deprecated. The Google Developers Console project ID or project +// number. This field has been deprecated and replaced by the name +// field. func (c *ProjectsLocationsGetServerConfigCall) ProjectId(projectId string) *ProjectsLocationsGetServerConfigCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) to -// return operations for. This field has been deprecated and replaced by -// the name field. +// name of the Google Compute Engine zone to return operations for. This +// field has been deprecated and replaced by the name field. func (c *ProjectsLocationsGetServerConfigCall) Zone(zone string) *ProjectsLocationsGetServerConfigCall { c.urlParams_.Set("zone", zone) return c @@ -6479,13 +6375,12 @@ type ProjectsLocationsClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is -// created in the project's [default -// network](https://cloud.google.com/compute/docs/networks-and-firewalls# -// networks). One firewall is added for the cluster. After cluster -// creation, the Kubelet creates routes for each node to allow the -// containers on that node to communicate with all other instances in -// the cluster. Finally, an entry is added to the project's global -// metadata indicating which CIDR range the cluster is using. +// created in the project's default network. One firewall is added for +// the cluster. After cluster creation, the Kubelet creates routes for +// each node to allow the containers on that node to communicate with +// all other instances in the cluster. Finally, an entry is added to the +// project's global metadata indicating which CIDR range the cluster is +// using. func (r *ProjectsLocationsClustersService) Create(parent string, createclusterrequest *CreateClusterRequest) *ProjectsLocationsClustersCreateCall { c := &ProjectsLocationsClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6645,19 +6540,17 @@ func (c *ProjectsLocationsClustersDeleteCall) ClusterId(clusterId string) *Proje } // ProjectId sets the optional parameter "projectId": Required. -// Deprecated. The Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field -// has been deprecated and replaced by the name field. +// Deprecated. The Google Developers Console project ID or project +// number. This field has been deprecated and replaced by the name +// field. func (c *ProjectsLocationsClustersDeleteCall) ProjectId(projectId string) *ProjectsLocationsClustersDeleteCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the name field. +// name of the Google Compute Engine zone in which the cluster resides. +// This field has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersDeleteCall) Zone(zone string) *ProjectsLocationsClustersDeleteCall { c.urlParams_.Set("zone", zone) return c @@ -6818,19 +6711,17 @@ func (c *ProjectsLocationsClustersGetCall) ClusterId(clusterId string) *Projects } // ProjectId sets the optional parameter "projectId": Required. -// Deprecated. The Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field -// has been deprecated and replaced by the name field. +// Deprecated. The Google Developers Console project ID or project +// number. This field has been deprecated and replaced by the name +// field. func (c *ProjectsLocationsClustersGetCall) ProjectId(projectId string) *ProjectsLocationsClustersGetCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the name field. +// name of the Google Compute Engine zone in which the cluster resides. +// This field has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersGetCall) Zone(zone string) *ProjectsLocationsClustersGetCall { c.urlParams_.Set("zone", zone) return c @@ -7140,19 +7031,18 @@ func (r *ProjectsLocationsClustersService) List(parent string) *ProjectsLocation } // ProjectId sets the optional parameter "projectId": Required. -// Deprecated. The Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field -// has been deprecated and replaced by the parent field. +// Deprecated. The Google Developers Console project ID or project +// number. This field has been deprecated and replaced by the parent +// field. func (c *ProjectsLocationsClustersListCall) ProjectId(projectId string) *ProjectsLocationsClustersListCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides, or "-" for all zones. This field has been -// deprecated and replaced by the parent field. +// name of the Google Compute Engine zone in which the cluster resides, +// or "-" for all zones. This field has been deprecated and replaced by +// the parent field. func (c *ProjectsLocationsClustersListCall) Zone(zone string) *ProjectsLocationsClustersListCall { c.urlParams_.Set("zone", zone) return c @@ -7587,10 +7477,7 @@ type ProjectsLocationsClustersSetLocationsCall struct { } // SetLocations: Sets the locations for a specific cluster. Deprecated. -// Use -// [projects.locations.clusters.update](https://cloud.google.com/kubernet -// es-engine/docs/reference/rest/v1beta1/projects.locations.clusters/upda -// te) instead. +// Use projects.locations.clusters.update instead. func (r *ProjectsLocationsClustersService) SetLocations(name string, setlocationsrequest *SetLocationsRequest) *ProjectsLocationsClustersSetLocationsCall { c := &ProjectsLocationsClustersSetLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9155,19 +9042,17 @@ func (c *ProjectsLocationsClustersNodePoolsDeleteCall) NodePoolId(nodePoolId str } // ProjectId sets the optional parameter "projectId": Required. -// Deprecated. The Google Developers Console [project ID or project -// number](https://developers.google.com/console/help/new/#projectnumber) -// . This field has been deprecated and replaced by the name field. +// Deprecated. The Google Developers Console project ID or project +// number. This field has been deprecated and replaced by the name +// field. func (c *ProjectsLocationsClustersNodePoolsDeleteCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsDeleteCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the name field. +// name of the Google Compute Engine zone in which the cluster resides. +// This field has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersNodePoolsDeleteCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsDeleteCall { c.urlParams_.Set("zone", zone) return c @@ -9341,19 +9226,17 @@ func (c *ProjectsLocationsClustersNodePoolsGetCall) NodePoolId(nodePoolId string } // ProjectId sets the optional parameter "projectId": Required. -// Deprecated. The Google Developers Console [project ID or project -// number](https://developers.google.com/console/help/new/#projectnumber) -// . This field has been deprecated and replaced by the name field. +// Deprecated. The Google Developers Console project ID or project +// number. This field has been deprecated and replaced by the name +// field. func (c *ProjectsLocationsClustersNodePoolsGetCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsGetCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the name field. +// name of the Google Compute Engine zone in which the cluster resides. +// This field has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersNodePoolsGetCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsGetCall { c.urlParams_.Set("zone", zone) return c @@ -9532,19 +9415,17 @@ func (c *ProjectsLocationsClustersNodePoolsListCall) ClusterId(clusterId string) } // ProjectId sets the optional parameter "projectId": Required. -// Deprecated. The Google Developers Console [project ID or project -// number](https://developers.google.com/console/help/new/#projectnumber) -// . This field has been deprecated and replaced by the parent field. +// Deprecated. The Google Developers Console project ID or project +// number. This field has been deprecated and replaced by the parent +// field. func (c *ProjectsLocationsClustersNodePoolsListCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsListCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the parent field. +// name of the Google Compute Engine zone in which the cluster resides. +// This field has been deprecated and replaced by the parent field. func (c *ProjectsLocationsClustersNodePoolsListCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsListCall { c.urlParams_.Set("zone", zone) return c @@ -10406,10 +10287,9 @@ type ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall struct { } // GetOpenidConfiguration: Gets the OIDC discovery document for the -// cluster. See the [OpenID Connect Discovery 1.0 -// specification](https://openid.net/specs/openid-connect-discovery-1_0.h -// tml) for details. This API is not yet intended for general use, and -// is not available for all clusters. +// cluster. See the OpenID Connect Discovery 1.0 specification for +// details. This API is not yet intended for general use, and is not +// available for all clusters. func (r *ProjectsLocationsClustersWellKnownService) GetOpenidConfiguration(parent string) *ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall { c := &ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -10706,19 +10586,17 @@ func (c *ProjectsLocationsOperationsGetCall) OperationId(operationId string) *Pr } // ProjectId sets the optional parameter "projectId": Required. -// Deprecated. The Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field -// has been deprecated and replaced by the name field. +// Deprecated. The Google Developers Console project ID or project +// number. This field has been deprecated and replaced by the name +// field. func (c *ProjectsLocationsOperationsGetCall) ProjectId(projectId string) *ProjectsLocationsOperationsGetCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) in -// which the cluster resides. This field has been deprecated and -// replaced by the name field. +// name of the Google Compute Engine zone in which the cluster resides. +// This field has been deprecated and replaced by the name field. func (c *ProjectsLocationsOperationsGetCall) Zone(zone string) *ProjectsLocationsOperationsGetCall { c.urlParams_.Set("zone", zone) return c @@ -10885,19 +10763,18 @@ func (r *ProjectsLocationsOperationsService) List(parent string) *ProjectsLocati } // ProjectId sets the optional parameter "projectId": Required. -// Deprecated. The Google Developers Console [project ID or project -// number](https://support.google.com/cloud/answer/6158840). This field -// has been deprecated and replaced by the parent field. +// Deprecated. The Google Developers Console project ID or project +// number. This field has been deprecated and replaced by the parent +// field. func (c *ProjectsLocationsOperationsListCall) ProjectId(projectId string) *ProjectsLocationsOperationsListCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine -// [zone](https://cloud.google.com/compute/docs/zones#available) to -// return operations for, or `-` for all zones. This field has been -// deprecated and replaced by the parent field. +// name of the Google Compute Engine zone to return operations for, or +// `-` for all zones. This field has been deprecated and replaced by the +// parent field. func (c *ProjectsLocationsOperationsListCall) Zone(zone string) *ProjectsLocationsOperationsListCall { c.urlParams_.Set("zone", zone) return c @@ -11538,13 +11415,12 @@ type ProjectsZonesClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is -// created in the project's [default -// network](https://cloud.google.com/compute/docs/networks-and-firewalls# -// networks). One firewall is added for the cluster. After cluster -// creation, the Kubelet creates routes for each node to allow the -// containers on that node to communicate with all other instances in -// the cluster. Finally, an entry is added to the project's global -// metadata indicating which CIDR range the cluster is using. +// created in the project's default network. One firewall is added for +// the cluster. After cluster creation, the Kubelet creates routes for +// each node to allow the containers on that node to communicate with +// all other instances in the cluster. Finally, an entry is added to the +// project's global metadata indicating which CIDR range the cluster is +// using. func (r *ProjectsZonesClustersService) Create(projectId string, zone string, createclusterrequest *CreateClusterRequest) *ProjectsZonesClustersCreateCall { c := &ProjectsZonesClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -12366,9 +12242,7 @@ type ProjectsZonesClustersLocationsCall struct { } // Locations: Sets the locations for a specific cluster. Deprecated. Use -// [projects.locations.clusters.update](https://cloud.google.com/kubernet -// es-engine/docs/reference/rest/v1beta1/projects.locations.clusters/upda -// te) instead. +// projects.locations.clusters.update instead. func (r *ProjectsZonesClustersService) Locations(projectId string, zone string, clusterId string, setlocationsrequest *SetLocationsRequest) *ProjectsZonesClustersLocationsCall { c := &ProjectsZonesClustersLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId diff --git a/containeranalysis/v1alpha1/containeranalysis-gen.go b/containeranalysis/v1alpha1/containeranalysis-gen.go index a8511b2ba9f..e5c383c4f17 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -442,9 +442,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1099,9 +1097,8 @@ type Distribution struct { // "X64" - X64 architecture Architecture string `json:"architecture,omitempty"` - // CpeUri: The cpe_uri in [cpe - // format](https://cpe.mitre.org/specification/) denoting the package - // manager version distributing a package. + // CpeUri: The cpe_uri in cpe format denoting the package manager + // version distributing a package. CpeUri string `json:"cpeUri,omitempty"` // Description: The distribution channel-specific description of this @@ -1320,9 +1317,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1944,9 +1939,8 @@ func (s *ListScanConfigsResponse) MarshalJSON() ([]byte, error) { // within a system's filesystem. e.g. glibc was found in // /var/lib/dpkg/status type Location struct { - // CpeUri: The cpe_uri in [cpe - // format](https://cpe.mitre.org/specification/) denoting the package - // manager version distributing a package. + // CpeUri: The cpe_uri in cpe format denoting the package manager + // version distributing a package. CpeUri string `json:"cpeUri,omitempty"` // Path: The path from which we gathered that this package/version is @@ -2391,9 +2385,8 @@ func (s *PgpSignedAttestation) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2411,8 +2404,8 @@ func (s *PgpSignedAttestation) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -2447,9 +2440,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2766,11 +2758,10 @@ func (s *Source) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2850,8 +2841,7 @@ func (s *StorageSource) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/containeranalysis/v1beta1/containeranalysis-gen.go b/containeranalysis/v1beta1/containeranalysis-gen.go index 93a3ac54108..95bd2af4786 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -567,9 +567,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1151,8 +1149,7 @@ func (s *Derived) MarshalJSON() ([]byte, error) { // package for a specific distro/location. For example: glibc in // cpe:/o:debian:debian_linux:8 for versions 2.1 - 2.2 type Detail struct { - // CpeUri: Required. The CPE URI in [cpe - // format](https://cpe.mitre.org/specification/) in which the + // CpeUri: Required. The CPE URI in cpe format in which the // vulnerability manifests. Examples include distro or storage location // for vulnerable jar. CpeUri string `json:"cpeUri,omitempty"` @@ -1358,8 +1355,7 @@ type Distribution struct { // "X64" - X64 architecture. Architecture string `json:"architecture,omitempty"` - // CpeUri: Required. The cpe_uri in [CPE - // format](https://cpe.mitre.org/specification/) denoting the package + // CpeUri: Required. The cpe_uri in CPE format denoting the package // manager version distributing a package. CpeUri string `json:"cpeUri,omitempty"` @@ -1750,9 +1746,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2626,8 +2620,7 @@ func (s *ListScanConfigsResponse) MarshalJSON() ([]byte, error) { // within a system's filesystem. E.g., glibc was found in // `/var/lib/dpkg/status`. type Location struct { - // CpeUri: Required. The CPE URI in [CPE - // format](https://cpe.mitre.org/specification/) denoting the package + // CpeUri: Required. The CPE URI in CPE format denoting the package // manager version distributing a package. CpeUri string `json:"cpeUri,omitempty"` @@ -3011,9 +3004,8 @@ func (s *PgpSignedAttestation) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -3031,8 +3023,8 @@ func (s *PgpSignedAttestation) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -3067,9 +3059,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -3517,11 +3508,10 @@ func (s *SourceContext) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3564,8 +3554,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3747,9 +3736,8 @@ func (s *Vulnerability) UnmarshalJSON(data []byte) error { // VulnerabilityLocation: The location of the vulnerability. type VulnerabilityLocation struct { - // CpeUri: Required. The CPE URI in [cpe - // format](https://cpe.mitre.org/specification/) format. Examples - // include distro or storage location for vulnerable jar. + // CpeUri: Required. The CPE URI in cpe format format. Examples include + // distro or storage location for vulnerable jar. CpeUri string `json:"cpeUri,omitempty"` // Package: Required. The package being described. @@ -3816,8 +3804,7 @@ func (s *VulnerabilityOccurrencesSummary) MarshalJSON() ([]byte, error) { } type WindowsDetail struct { - // CpeUri: Required. The CPE URI in [cpe - // format](https://cpe.mitre.org/specification/) in which the + // CpeUri: Required. The CPE URI in cpe format in which the // vulnerability manifests. Examples include distro or storage location // for vulnerable jar. CpeUri string `json:"cpeUri,omitempty"` diff --git a/content/v2.1/content-gen.go b/content/v2.1/content-gen.go index 455b780cd82..ef25e6d09b0 100644 --- a/content/v2.1/content-gen.go +++ b/content/v2.1/content-gen.go @@ -6438,8 +6438,8 @@ type OrderTrackingSignal struct { // MerchantId: The Google merchant ID of this order tracking signal. // This value is optional. If left unset, the caller's merchant ID is // used. You must request access in order to provide data on behalf of - // another merchant. For more information, see [Submitting Order - // Tracking Signals](/shopping-content/guides/order-tracking-signals). + // another merchant. For more information, see Submitting Order Tracking + // Signals. MerchantId int64 `json:"merchantId,omitempty,string"` // OrderCreatedTime: Required. The time when the order was created on @@ -11285,9 +11285,8 @@ func (s *Region) MarshalJSON() ([]byte, error) { // RegionGeoTargetArea: A list of geotargets that defines the region // area. type RegionGeoTargetArea struct { - // GeotargetCriteriaIds: Required. A non-empty list of [location - // IDs](https://developers.google.com/adwords/api/docs/appendix/geotarget - // ing). They must all be of the same location type (e.g., state). + // GeotargetCriteriaIds: Required. A non-empty list of location IDs. + // They must all be of the same location type (e.g., state). GeotargetCriteriaIds googleapi.Int64s `json:"geotargetCriteriaIds,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -13900,8 +13899,7 @@ func (s *TestOrderPickupDetailsPickupPerson) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// TimeZone: Represents a time zone from the [IANA Time Zone -// Database](https://www.iana.org/time-zones). +// TimeZone: Represents a time zone from the IANA Time Zone Database. type TimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` diff --git a/customsearch/v1/customsearch-gen.go b/customsearch/v1/customsearch-gen.go index c9dc22e5a7d..6a6a5db2ee6 100644 --- a/customsearch/v1/customsearch-gen.go +++ b/customsearch/v1/customsearch-gen.go @@ -147,10 +147,8 @@ type CseSiterestrictService struct { // Promotion: Promotion result. type Promotion struct { - // BodyLines: An array of block objects for this promotion. See [Google - // WebSearch Protocol - // reference](https://developers.google.com/custom-search/docs/xml_result - // s) for more information. + // BodyLines: An array of block objects for this promotion. See Google + // WebSearch Protocol reference for more information. BodyLines []*PromotionBodyLines `json:"bodyLines,omitempty"` // DisplayLink: An abridged version of this search's result URL, e.g. @@ -297,8 +295,7 @@ type Result struct { // API, it is `customsearch#result.` Kind string `json:"kind,omitempty"` - // Labels: Encapsulates all information about [refinement - // labels](https://developers.google.com/custom-search/docs/xml_results). + // Labels: Encapsulates all information about refinement labels. Labels []*ResultLabels `json:"labels,omitempty"` // Link: The full URL to which the search result is pointing, e.g. @@ -308,9 +305,7 @@ type Result struct { // Mime: The MIME type of the search result. Mime string `json:"mime,omitempty"` - // Pagemap: Contains - // [PageMap](https://developers.google.com/custom-search/docs/structured_ - // data#pagemaps) information for this search result. + // Pagemap: Contains PageMap information for this search result. Pagemap googleapi.RawMessage `json:"pagemap,omitempty"` // Snippet: The snippet of the search result, in plain text. @@ -431,9 +426,8 @@ func (s *ResultLabels) MarshalJSON() ([]byte, error) { type Search struct { // Context: Metadata and refinements associated with the given search // engine, including: * The name of the search engine that was used for - // the query. * A set of [facet - // objects](https://developers.google.com/custom-search/docs/refinements# - // create) (refinements) you can use for refining a search. + // the query. * A set of facet objects (refinements) you can use for + // refining a search. Context googleapi.RawMessage `json:"context,omitempty"` // Items: The current set of custom search results. @@ -443,10 +437,9 @@ type Search struct { // it is customsearch#search. Kind string `json:"kind,omitempty"` - // Promotions: The set of - // [promotions](https://developers.google.com/custom-search/docs/promotio - // ns). Present only if the custom search engine's configuration files - // define any promotions for the given query. + // Promotions: The set of promotions. Present only if the custom search + // engine's configuration files define any promotions for the given + // query. Promotions []*Promotion `json:"promotions,omitempty"` // Queries: Query metadata for the previous, current, and next pages of @@ -532,20 +525,16 @@ type SearchQueriesNextPage struct { Count int64 `json:"count,omitempty"` // Cr: Restricts search results to documents originating in a particular - // country. You may use [Boolean - // operators](https://developers.google.com/custom-search/docs/xml_result - // s#booleanOperators) in the `cr` parameter's value. Google WebSearch - // determines the country of a document by analyzing the following: * - // The top-level domain (TLD) of the document's URL. * The geographic - // location of the web server's IP address. See [Country (cr) Parameter - // Values](https://developers.google.com/custom-search/docs/xml_results#c - // ountryCollections) for a list of valid values for this parameter. + // country. You may use Boolean operators in the `cr` parameter's value. + // Google WebSearch determines the country of a document by analyzing + // the following: * The top-level domain (TLD) of the document's URL. * + // The geographic location of the web server's IP address. See Country + // (cr) Parameter Values for a list of valid values for this parameter. Cr string `json:"cr,omitempty"` // Cx: The identifier of an engine created using the Programmable Search - // Engine [Control Panel](https://programmablesearchengine.google.com/). - // This is a custom property not defined in the OpenSearch spec. This - // parameter is **required**. + // Engine Control Panel. This is a custom property not defined in the + // OpenSearch spec. This parameter is **required**. Cx string `json:"cx,omitempty"` // DateRestrict: Restricts results to URLs based on date. Supported @@ -556,11 +545,9 @@ type SearchQueriesNextPage struct { // from the specified number of past years. DateRestrict string `json:"dateRestrict,omitempty"` - // DisableCnTwTranslation: Enables or disables the [Simplified and - // Traditional Chinese - // Search](https://developers.google.com/custom-search/docs/xml_results#c - // hineseSearch) feature. Supported values are: * `0`: enabled (default) - // * `1`: disabled + // DisableCnTwTranslation: Enables or disables the Simplified and + // Traditional Chinese Search feature. Supported values are: * `0`: + // enabled (default) * `1`: disabled DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"` // ExactTerms: Identifies a phrase that all documents in the search @@ -580,28 +567,23 @@ type SearchQueriesNextPage struct { // `wdb`) * Microsoft Write (`wri`) * Rich Text Format (`rtf`) * // Shockwave Flash (`swf`) * Text (`ans`, `txt`). Additional filetypes // may be added in the future. An up-to-date list can always be found in - // Google's [file type - // FAQ](https://support.google.com/webmasters/answer/35287). + // Google's file type FAQ. FileType string `json:"fileType,omitempty"` // Filter: Activates or deactivates the automatic filtering of Google - // search results. See [Automatic - // Filtering](https://developers.google.com/custom-search/docs/xml_result - // s#automaticFiltering) for more information about Google's search - // results filters. Valid values for this parameter are: * `0`: Disabled - // * `1`: Enabled (default) **Note**: By default, Google applies - // filtering to all search results to improve the quality of those - // results. + // search results. See Automatic Filtering for more information about + // Google's search results filters. Valid values for this parameter are: + // * `0`: Disabled * `1`: Enabled (default) **Note**: By default, Google + // applies filtering to all search results to improve the quality of + // those results. Filter string `json:"filter,omitempty"` // Gl: Boosts search results whose country of origin matches the - // parameter value. See [Country - // Codes](https://developers.google.com/custom-search/docs/xml_results#co - // untryCodes) for a list of valid values. Specifying a `gl` parameter - // value in WebSearch requests should improve the relevance of results. - // This is particularly true for international customers and, even more - // specifically, for customers in English-speaking countries other than - // the United States. + // parameter value. See Country Codes for a list of valid values. + // Specifying a `gl` parameter value in WebSearch requests should + // improve the relevance of results. This is particularly true for + // international customers and, even more specifically, for customers in + // English-speaking countries other than the United States. Gl string `json:"gl,omitempty"` // GoogleHost: Specifies the Google domain (for example, google.com, @@ -615,15 +597,10 @@ type SearchQueriesNextPage struct { // Hl: Specifies the interface language (host language) of your user // interface. Explicitly setting this parameter improves the performance - // and the quality of your search results. See the [Interface - // Languages](https://developers.google.com/custom-search/docs/xml_result - // s#wsInterfaceLanguages) section of [Internationalizing Queries and - // Results - // Presentation](https://developers.google.com/custom-search/docs/xml_res - // ults#wsInternationalizing) for more information, and [Supported - // Interface - // Languages](https://developers.google.com/custom-search/docs/xml_result - // s_appendices#interfaceLanguages) for a list of supported languages. + // and the quality of your search results. See the Interface Languages + // section of Internationalizing Queries and Results Presentation for + // more information, and Supported Interface Languages for a list of + // supported languages. Hl string `json:"hl,omitempty"` // Hq: Appends the specified query terms to the query, as if they were @@ -668,9 +645,8 @@ type SearchQueriesNextPage struct { // OrTerms: Provides additional search terms to check for in a document, // where each document in the search results must contain at least one - // of the additional search terms. You can also use the [Boolean - // OR](https://developers.google.com/custom-search/docs/xml_results#Boole - // anOrqt) query term for this type of query. + // of the additional search terms. You can also use the Boolean OR query + // term for this type of query. OrTerms string `json:"orTerms,omitempty"` // OutputEncoding: The character encoding supported for search results. @@ -686,12 +662,10 @@ type SearchQueriesNextPage struct { // `cc_noncommercial` * `cc_nonderived` Rights string `json:"rights,omitempty"` - // Safe: Specifies the [SafeSearch - // level](https://developers.google.com/custom-search/docs/xml_results#sa - // feSearchLevels) used for filtering out adult results. This is a - // custom property not defined in the OpenSearch spec. Valid parameter - // values are: * "off": Disable SafeSearch * "active": Enable - // SafeSearch + // Safe: Specifies the SafeSearch level used for filtering out adult + // results. This is a custom property not defined in the OpenSearch + // spec. Valid parameter values are: * "off": Disable SafeSearch * + // "active": Enable SafeSearch Safe string `json:"safe,omitempty"` // SearchTerms: The search terms entered by the user. @@ -758,20 +732,16 @@ type SearchQueriesPreviousPage struct { Count int64 `json:"count,omitempty"` // Cr: Restricts search results to documents originating in a particular - // country. You may use [Boolean - // operators](https://developers.google.com/custom-search/docs/xml_result - // s#booleanOperators) in the `cr` parameter's value. Google WebSearch - // determines the country of a document by analyzing the following: * - // The top-level domain (TLD) of the document's URL. * The geographic - // location of the web server's IP address. See [Country (cr) Parameter - // Values](https://developers.google.com/custom-search/docs/xml_results#c - // ountryCollections) for a list of valid values for this parameter. + // country. You may use Boolean operators in the `cr` parameter's value. + // Google WebSearch determines the country of a document by analyzing + // the following: * The top-level domain (TLD) of the document's URL. * + // The geographic location of the web server's IP address. See Country + // (cr) Parameter Values for a list of valid values for this parameter. Cr string `json:"cr,omitempty"` // Cx: The identifier of an engine created using the Programmable Search - // Engine [Control Panel](https://programmablesearchengine.google.com/). - // This is a custom property not defined in the OpenSearch spec. This - // parameter is **required**. + // Engine Control Panel. This is a custom property not defined in the + // OpenSearch spec. This parameter is **required**. Cx string `json:"cx,omitempty"` // DateRestrict: Restricts results to URLs based on date. Supported @@ -782,11 +752,9 @@ type SearchQueriesPreviousPage struct { // from the specified number of past years. DateRestrict string `json:"dateRestrict,omitempty"` - // DisableCnTwTranslation: Enables or disables the [Simplified and - // Traditional Chinese - // Search](https://developers.google.com/custom-search/docs/xml_results#c - // hineseSearch) feature. Supported values are: * `0`: enabled (default) - // * `1`: disabled + // DisableCnTwTranslation: Enables or disables the Simplified and + // Traditional Chinese Search feature. Supported values are: * `0`: + // enabled (default) * `1`: disabled DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"` // ExactTerms: Identifies a phrase that all documents in the search @@ -806,28 +774,23 @@ type SearchQueriesPreviousPage struct { // `wdb`) * Microsoft Write (`wri`) * Rich Text Format (`rtf`) * // Shockwave Flash (`swf`) * Text (`ans`, `txt`). Additional filetypes // may be added in the future. An up-to-date list can always be found in - // Google's [file type - // FAQ](https://support.google.com/webmasters/answer/35287). + // Google's file type FAQ. FileType string `json:"fileType,omitempty"` // Filter: Activates or deactivates the automatic filtering of Google - // search results. See [Automatic - // Filtering](https://developers.google.com/custom-search/docs/xml_result - // s#automaticFiltering) for more information about Google's search - // results filters. Valid values for this parameter are: * `0`: Disabled - // * `1`: Enabled (default) **Note**: By default, Google applies - // filtering to all search results to improve the quality of those - // results. + // search results. See Automatic Filtering for more information about + // Google's search results filters. Valid values for this parameter are: + // * `0`: Disabled * `1`: Enabled (default) **Note**: By default, Google + // applies filtering to all search results to improve the quality of + // those results. Filter string `json:"filter,omitempty"` // Gl: Boosts search results whose country of origin matches the - // parameter value. See [Country - // Codes](https://developers.google.com/custom-search/docs/xml_results#co - // untryCodes) for a list of valid values. Specifying a `gl` parameter - // value in WebSearch requests should improve the relevance of results. - // This is particularly true for international customers and, even more - // specifically, for customers in English-speaking countries other than - // the United States. + // parameter value. See Country Codes for a list of valid values. + // Specifying a `gl` parameter value in WebSearch requests should + // improve the relevance of results. This is particularly true for + // international customers and, even more specifically, for customers in + // English-speaking countries other than the United States. Gl string `json:"gl,omitempty"` // GoogleHost: Specifies the Google domain (for example, google.com, @@ -841,15 +804,10 @@ type SearchQueriesPreviousPage struct { // Hl: Specifies the interface language (host language) of your user // interface. Explicitly setting this parameter improves the performance - // and the quality of your search results. See the [Interface - // Languages](https://developers.google.com/custom-search/docs/xml_result - // s#wsInterfaceLanguages) section of [Internationalizing Queries and - // Results - // Presentation](https://developers.google.com/custom-search/docs/xml_res - // ults#wsInternationalizing) for more information, and [Supported - // Interface - // Languages](https://developers.google.com/custom-search/docs/xml_result - // s_appendices#interfaceLanguages) for a list of supported languages. + // and the quality of your search results. See the Interface Languages + // section of Internationalizing Queries and Results Presentation for + // more information, and Supported Interface Languages for a list of + // supported languages. Hl string `json:"hl,omitempty"` // Hq: Appends the specified query terms to the query, as if they were @@ -894,9 +852,8 @@ type SearchQueriesPreviousPage struct { // OrTerms: Provides additional search terms to check for in a document, // where each document in the search results must contain at least one - // of the additional search terms. You can also use the [Boolean - // OR](https://developers.google.com/custom-search/docs/xml_results#Boole - // anOrqt) query term for this type of query. + // of the additional search terms. You can also use the Boolean OR query + // term for this type of query. OrTerms string `json:"orTerms,omitempty"` // OutputEncoding: The character encoding supported for search results. @@ -912,12 +869,10 @@ type SearchQueriesPreviousPage struct { // `cc_noncommercial` * `cc_nonderived` Rights string `json:"rights,omitempty"` - // Safe: Specifies the [SafeSearch - // level](https://developers.google.com/custom-search/docs/xml_results#sa - // feSearchLevels) used for filtering out adult results. This is a - // custom property not defined in the OpenSearch spec. Valid parameter - // values are: * "off": Disable SafeSearch * "active": Enable - // SafeSearch + // Safe: Specifies the SafeSearch level used for filtering out adult + // results. This is a custom property not defined in the OpenSearch + // spec. Valid parameter values are: * "off": Disable SafeSearch * + // "active": Enable SafeSearch Safe string `json:"safe,omitempty"` // SearchTerms: The search terms entered by the user. @@ -984,20 +939,16 @@ type SearchQueriesRequest struct { Count int64 `json:"count,omitempty"` // Cr: Restricts search results to documents originating in a particular - // country. You may use [Boolean - // operators](https://developers.google.com/custom-search/docs/xml_result - // s#booleanOperators) in the `cr` parameter's value. Google WebSearch - // determines the country of a document by analyzing the following: * - // The top-level domain (TLD) of the document's URL. * The geographic - // location of the web server's IP address. See [Country (cr) Parameter - // Values](https://developers.google.com/custom-search/docs/xml_results#c - // ountryCollections) for a list of valid values for this parameter. + // country. You may use Boolean operators in the `cr` parameter's value. + // Google WebSearch determines the country of a document by analyzing + // the following: * The top-level domain (TLD) of the document's URL. * + // The geographic location of the web server's IP address. See Country + // (cr) Parameter Values for a list of valid values for this parameter. Cr string `json:"cr,omitempty"` // Cx: The identifier of an engine created using the Programmable Search - // Engine [Control Panel](https://programmablesearchengine.google.com/). - // This is a custom property not defined in the OpenSearch spec. This - // parameter is **required**. + // Engine Control Panel. This is a custom property not defined in the + // OpenSearch spec. This parameter is **required**. Cx string `json:"cx,omitempty"` // DateRestrict: Restricts results to URLs based on date. Supported @@ -1008,11 +959,9 @@ type SearchQueriesRequest struct { // from the specified number of past years. DateRestrict string `json:"dateRestrict,omitempty"` - // DisableCnTwTranslation: Enables or disables the [Simplified and - // Traditional Chinese - // Search](https://developers.google.com/custom-search/docs/xml_results#c - // hineseSearch) feature. Supported values are: * `0`: enabled (default) - // * `1`: disabled + // DisableCnTwTranslation: Enables or disables the Simplified and + // Traditional Chinese Search feature. Supported values are: * `0`: + // enabled (default) * `1`: disabled DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"` // ExactTerms: Identifies a phrase that all documents in the search @@ -1032,28 +981,23 @@ type SearchQueriesRequest struct { // `wdb`) * Microsoft Write (`wri`) * Rich Text Format (`rtf`) * // Shockwave Flash (`swf`) * Text (`ans`, `txt`). Additional filetypes // may be added in the future. An up-to-date list can always be found in - // Google's [file type - // FAQ](https://support.google.com/webmasters/answer/35287). + // Google's file type FAQ. FileType string `json:"fileType,omitempty"` // Filter: Activates or deactivates the automatic filtering of Google - // search results. See [Automatic - // Filtering](https://developers.google.com/custom-search/docs/xml_result - // s#automaticFiltering) for more information about Google's search - // results filters. Valid values for this parameter are: * `0`: Disabled - // * `1`: Enabled (default) **Note**: By default, Google applies - // filtering to all search results to improve the quality of those - // results. + // search results. See Automatic Filtering for more information about + // Google's search results filters. Valid values for this parameter are: + // * `0`: Disabled * `1`: Enabled (default) **Note**: By default, Google + // applies filtering to all search results to improve the quality of + // those results. Filter string `json:"filter,omitempty"` // Gl: Boosts search results whose country of origin matches the - // parameter value. See [Country - // Codes](https://developers.google.com/custom-search/docs/xml_results#co - // untryCodes) for a list of valid values. Specifying a `gl` parameter - // value in WebSearch requests should improve the relevance of results. - // This is particularly true for international customers and, even more - // specifically, for customers in English-speaking countries other than - // the United States. + // parameter value. See Country Codes for a list of valid values. + // Specifying a `gl` parameter value in WebSearch requests should + // improve the relevance of results. This is particularly true for + // international customers and, even more specifically, for customers in + // English-speaking countries other than the United States. Gl string `json:"gl,omitempty"` // GoogleHost: Specifies the Google domain (for example, google.com, @@ -1067,15 +1011,10 @@ type SearchQueriesRequest struct { // Hl: Specifies the interface language (host language) of your user // interface. Explicitly setting this parameter improves the performance - // and the quality of your search results. See the [Interface - // Languages](https://developers.google.com/custom-search/docs/xml_result - // s#wsInterfaceLanguages) section of [Internationalizing Queries and - // Results - // Presentation](https://developers.google.com/custom-search/docs/xml_res - // ults#wsInternationalizing) for more information, and [Supported - // Interface - // Languages](https://developers.google.com/custom-search/docs/xml_result - // s_appendices#interfaceLanguages) for a list of supported languages. + // and the quality of your search results. See the Interface Languages + // section of Internationalizing Queries and Results Presentation for + // more information, and Supported Interface Languages for a list of + // supported languages. Hl string `json:"hl,omitempty"` // Hq: Appends the specified query terms to the query, as if they were @@ -1120,9 +1059,8 @@ type SearchQueriesRequest struct { // OrTerms: Provides additional search terms to check for in a document, // where each document in the search results must contain at least one - // of the additional search terms. You can also use the [Boolean - // OR](https://developers.google.com/custom-search/docs/xml_results#Boole - // anOrqt) query term for this type of query. + // of the additional search terms. You can also use the Boolean OR query + // term for this type of query. OrTerms string `json:"orTerms,omitempty"` // OutputEncoding: The character encoding supported for search results. @@ -1138,12 +1076,10 @@ type SearchQueriesRequest struct { // `cc_noncommercial` * `cc_nonderived` Rights string `json:"rights,omitempty"` - // Safe: Specifies the [SafeSearch - // level](https://developers.google.com/custom-search/docs/xml_results#sa - // feSearchLevels) used for filtering out adult results. This is a - // custom property not defined in the OpenSearch spec. Valid parameter - // values are: * "off": Disable SafeSearch * "active": Enable - // SafeSearch + // Safe: Specifies the SafeSearch level used for filtering out adult + // results. This is a custom property not defined in the OpenSearch + // spec. Valid parameter values are: * "off": Disable SafeSearch * + // "active": Enable SafeSearch Safe string `json:"safe,omitempty"` // SearchTerms: The search terms entered by the user. @@ -1293,9 +1229,7 @@ func (s *SearchSpelling) MarshalJSON() ([]byte, error) { // SearchUrl: OpenSearch template and URL. type SearchUrl struct { - // Template: The actual [OpenSearch - // template](http://www.opensearch.org/specifications/opensearch/1.1#open - // search_url_template_syntax) for this API. + // Template: The actual OpenSearch template for this API. Template string `json:"template,omitempty"` // Type: The MIME type of the OpenSearch URL template for the Custom @@ -1343,26 +1277,21 @@ func (r *CseService) List() *CseListCall { } // C2coff sets the optional parameter "c2coff": Enables or disables -// [Simplified and Traditional Chinese -// Search](https://developers.google.com/custom-search/docs/xml_results#c -// hineseSearch). The default value for this parameter is 0 (zero), -// meaning that the feature is enabled. Supported values are: * `1`: -// Disabled * `0`: Enabled (default) +// Simplified and Traditional Chinese Search. The default value for this +// parameter is 0 (zero), meaning that the feature is enabled. Supported +// values are: * `1`: Disabled * `0`: Enabled (default) func (c *CseListCall) C2coff(c2coff string) *CseListCall { c.urlParams_.Set("c2coff", c2coff) return c } // Cr sets the optional parameter "cr": Restricts search results to -// documents originating in a particular country. You may use [Boolean -// operators](https://developers.google.com/custom-search/docs/xml_result -// s_appendices#booleanOperators) in the cr parameter's value. Google -// Search determines the country of a document by analyzing: * the -// top-level domain (TLD) of the document's URL * the geographic -// location of the Web server's IP address See the [Country Parameter -// Values](https://developers.google.com/custom-search/docs/xml_results_a -// ppendices#countryCollections) page for a list of valid values for -// this parameter. +// documents originating in a particular country. You may use Boolean +// operators in the cr parameter's value. Google Search determines the +// country of a document by analyzing: * the top-level domain (TLD) of +// the document's URL * the geographic location of the Web server's IP +// address See the Country Parameter Values page for a list of valid +// values for this parameter. func (c *CseListCall) Cr(cr string) *CseListCall { c.urlParams_.Set("cr", cr) return c @@ -1404,22 +1333,19 @@ func (c *CseListCall) ExcludeTerms(excludeTerms string) *CseListCall { // FileType sets the optional parameter "fileType": Restricts results to // files of a specified extension. A list of file types indexable by -// Google can be found in Search Console [Help -// Center](https://support.google.com/webmasters/answer/35287). +// Google can be found in Search Console Help Center. func (c *CseListCall) FileType(fileType string) *CseListCall { c.urlParams_.Set("fileType", fileType) return c } // Filter sets the optional parameter "filter": Controls turning on or -// off the duplicate content filter. * See [Automatic -// Filtering](https://developers.google.com/custom-search/docs/xml_result -// s#automaticFiltering) for more information about Google's search -// results filters. Note that host crowding filtering applies only to -// multi-site searches. * By default, Google applies filtering to all -// search results to improve the quality of those results. Acceptable -// values are: * `0`: Turns off duplicate content filter. * `1`: Turns -// on duplicate content filter. +// off the duplicate content filter. * See Automatic Filtering for more +// information about Google's search results filters. Note that host +// crowding filtering applies only to multi-site searches. * By default, +// Google applies filtering to all search results to improve the quality +// of those results. Acceptable values are: * `0`: Turns off duplicate +// content filter. * `1`: Turns on duplicate content filter. func (c *CseListCall) Filter(filter string) *CseListCall { c.urlParams_.Set("filter", filter) return c @@ -1428,13 +1354,11 @@ func (c *CseListCall) Filter(filter string) *CseListCall { // Gl sets the optional parameter "gl": Geolocation of end user. * The // `gl` parameter value is a two-letter country code. The `gl` parameter // boosts search results whose country of origin matches the parameter -// value. See the [Country -// Codes](https://developers.google.com/custom-search/docs/xml_results_ap -// pendices#countryCodes) page for a list of valid values. * Specifying -// a `gl` parameter value should lead to more relevant results. This is -// particularly true for international customers and, even more -// specifically, for customers in English- speaking countries other than -// the United States. +// value. See the Country Codes page for a list of valid values. * +// Specifying a `gl` parameter value should lead to more relevant +// results. This is particularly true for international customers and, +// even more specifically, for customers in English- speaking countries +// other than the United States. func (c *CseListCall) Gl(gl string) *CseListCall { c.urlParams_.Set("gl", gl) return c @@ -1461,13 +1385,8 @@ func (c *CseListCall) HighRange(highRange string) *CseListCall { // Hl sets the optional parameter "hl": Sets the user interface // language. * Explicitly setting this parameter improves the // performance and the quality of your search results. * See the -// [Interface -// Languages](https://developers.google.com/custom-search/docs/xml_result -// s#wsInterfaceLanguages) section of [Internationalizing Queries and -// Results -// Presentation](https://developers.google.com/custom-search/docs/xml_res -// ults#wsInternationalizing) for more information, and (Supported -// Interface +// Interface Languages section of Internationalizing Queries and Results +// Presentation for more information, and (Supported Interface // Languages)[https://developers.google.com/custom-search/docs/xml_result // s_appendices#interfaceLanguages] for a list of supported languages. func (c *CseListCall) Hl(hl string) *CseListCall { @@ -1628,9 +1547,7 @@ func (c *CseListCall) RelatedSite(relatedSite string) *CseListCall { // Rights sets the optional parameter "rights": Filters based on // licensing. Supported values include: `cc_publicdomain`, // `cc_attribute`, `cc_sharealike`, `cc_noncommercial`, `cc_nonderived` -// and combinations of these. See [typical -// combinations](https://wiki.creativecommons.org/wiki/CC_Search_integrat -// ion). +// and combinations of these. See typical combinations. func (c *CseListCall) Rights(rights string) *CseListCall { c.urlParams_.Set("rights", rights) return c @@ -1690,9 +1607,7 @@ func (c *CseListCall) SiteSearchFilter(siteSearchFilter string) *CseListCall { // Sort sets the optional parameter "sort": The sort expression to apply // to the results. The sort parameter specifies that the results be // sorted according to the specified expression i.e. sort by date. -// [Example: -// sort=date](https://developers.google.com/custom-search/docs/structured -// _search#sort-by-attribute). +// Example: sort=date. func (c *CseListCall) Sort(sort string) *CseListCall { c.urlParams_.Set("sort", sort) return c @@ -2111,26 +2026,21 @@ func (r *CseSiterestrictService) List() *CseSiterestrictListCall { } // C2coff sets the optional parameter "c2coff": Enables or disables -// [Simplified and Traditional Chinese -// Search](https://developers.google.com/custom-search/docs/xml_results#c -// hineseSearch). The default value for this parameter is 0 (zero), -// meaning that the feature is enabled. Supported values are: * `1`: -// Disabled * `0`: Enabled (default) +// Simplified and Traditional Chinese Search. The default value for this +// parameter is 0 (zero), meaning that the feature is enabled. Supported +// values are: * `1`: Disabled * `0`: Enabled (default) func (c *CseSiterestrictListCall) C2coff(c2coff string) *CseSiterestrictListCall { c.urlParams_.Set("c2coff", c2coff) return c } // Cr sets the optional parameter "cr": Restricts search results to -// documents originating in a particular country. You may use [Boolean -// operators](https://developers.google.com/custom-search/docs/xml_result -// s_appendices#booleanOperators) in the cr parameter's value. Google -// Search determines the country of a document by analyzing: * the -// top-level domain (TLD) of the document's URL * the geographic -// location of the Web server's IP address See the [Country Parameter -// Values](https://developers.google.com/custom-search/docs/xml_results_a -// ppendices#countryCollections) page for a list of valid values for -// this parameter. +// documents originating in a particular country. You may use Boolean +// operators in the cr parameter's value. Google Search determines the +// country of a document by analyzing: * the top-level domain (TLD) of +// the document's URL * the geographic location of the Web server's IP +// address See the Country Parameter Values page for a list of valid +// values for this parameter. func (c *CseSiterestrictListCall) Cr(cr string) *CseSiterestrictListCall { c.urlParams_.Set("cr", cr) return c @@ -2172,22 +2082,19 @@ func (c *CseSiterestrictListCall) ExcludeTerms(excludeTerms string) *CseSiterest // FileType sets the optional parameter "fileType": Restricts results to // files of a specified extension. A list of file types indexable by -// Google can be found in Search Console [Help -// Center](https://support.google.com/webmasters/answer/35287). +// Google can be found in Search Console Help Center. func (c *CseSiterestrictListCall) FileType(fileType string) *CseSiterestrictListCall { c.urlParams_.Set("fileType", fileType) return c } // Filter sets the optional parameter "filter": Controls turning on or -// off the duplicate content filter. * See [Automatic -// Filtering](https://developers.google.com/custom-search/docs/xml_result -// s#automaticFiltering) for more information about Google's search -// results filters. Note that host crowding filtering applies only to -// multi-site searches. * By default, Google applies filtering to all -// search results to improve the quality of those results. Acceptable -// values are: * `0`: Turns off duplicate content filter. * `1`: Turns -// on duplicate content filter. +// off the duplicate content filter. * See Automatic Filtering for more +// information about Google's search results filters. Note that host +// crowding filtering applies only to multi-site searches. * By default, +// Google applies filtering to all search results to improve the quality +// of those results. Acceptable values are: * `0`: Turns off duplicate +// content filter. * `1`: Turns on duplicate content filter. func (c *CseSiterestrictListCall) Filter(filter string) *CseSiterestrictListCall { c.urlParams_.Set("filter", filter) return c @@ -2196,13 +2103,11 @@ func (c *CseSiterestrictListCall) Filter(filter string) *CseSiterestrictListCall // Gl sets the optional parameter "gl": Geolocation of end user. * The // `gl` parameter value is a two-letter country code. The `gl` parameter // boosts search results whose country of origin matches the parameter -// value. See the [Country -// Codes](https://developers.google.com/custom-search/docs/xml_results_ap -// pendices#countryCodes) page for a list of valid values. * Specifying -// a `gl` parameter value should lead to more relevant results. This is -// particularly true for international customers and, even more -// specifically, for customers in English- speaking countries other than -// the United States. +// value. See the Country Codes page for a list of valid values. * +// Specifying a `gl` parameter value should lead to more relevant +// results. This is particularly true for international customers and, +// even more specifically, for customers in English- speaking countries +// other than the United States. func (c *CseSiterestrictListCall) Gl(gl string) *CseSiterestrictListCall { c.urlParams_.Set("gl", gl) return c @@ -2229,13 +2134,8 @@ func (c *CseSiterestrictListCall) HighRange(highRange string) *CseSiterestrictLi // Hl sets the optional parameter "hl": Sets the user interface // language. * Explicitly setting this parameter improves the // performance and the quality of your search results. * See the -// [Interface -// Languages](https://developers.google.com/custom-search/docs/xml_result -// s#wsInterfaceLanguages) section of [Internationalizing Queries and -// Results -// Presentation](https://developers.google.com/custom-search/docs/xml_res -// ults#wsInternationalizing) for more information, and (Supported -// Interface +// Interface Languages section of Internationalizing Queries and Results +// Presentation for more information, and (Supported Interface // Languages)[https://developers.google.com/custom-search/docs/xml_result // s_appendices#interfaceLanguages] for a list of supported languages. func (c *CseSiterestrictListCall) Hl(hl string) *CseSiterestrictListCall { @@ -2396,9 +2296,7 @@ func (c *CseSiterestrictListCall) RelatedSite(relatedSite string) *CseSiterestri // Rights sets the optional parameter "rights": Filters based on // licensing. Supported values include: `cc_publicdomain`, // `cc_attribute`, `cc_sharealike`, `cc_noncommercial`, `cc_nonderived` -// and combinations of these. See [typical -// combinations](https://wiki.creativecommons.org/wiki/CC_Search_integrat -// ion). +// and combinations of these. See typical combinations. func (c *CseSiterestrictListCall) Rights(rights string) *CseSiterestrictListCall { c.urlParams_.Set("rights", rights) return c @@ -2458,9 +2356,7 @@ func (c *CseSiterestrictListCall) SiteSearchFilter(siteSearchFilter string) *Cse // Sort sets the optional parameter "sort": The sort expression to apply // to the results. The sort parameter specifies that the results be // sorted according to the specified expression i.e. sort by date. -// [Example: -// sort=date](https://developers.google.com/custom-search/docs/structured -// _search#sort-by-attribute). +// Example: sort=date. func (c *CseSiterestrictListCall) Sort(sort string) *CseSiterestrictListCall { c.urlParams_.Set("sort", sort) return c diff --git a/datacatalog/v1beta1/datacatalog-gen.go b/datacatalog/v1beta1/datacatalog-gen.go index 30ef74159e9..ca95f636190 100644 --- a/datacatalog/v1beta1/datacatalog-gen.go +++ b/datacatalog/v1beta1/datacatalog-gen.go @@ -296,9 +296,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -471,9 +469,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -676,11 +672,9 @@ type GoogleCloudDatacatalogV1beta1Entry struct { IntegratedSystem string `json:"integratedSystem,omitempty"` // LinkedResource: The resource this metadata entry refers to. For - // Google Cloud Platform resources, `linked_resource` is the [full name - // of the - // resource](https://cloud.google.com/apis/design/resource_names#full_res - // ource_name). For example, the `linked_resource` for a table resource - // from BigQuery is: * + // Google Cloud Platform resources, `linked_resource` is the full name + // of the resource. For example, the `linked_resource` for a table + // resource from BigQuery is: * // //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables // /tableId Output only when Entry is of type in the EntryType enum. For // entries with user_specified_type, this field is optional and defaults @@ -985,13 +979,11 @@ func (s *GoogleCloudDatacatalogV1beta1GcsFileSpec) MarshalJSON() ([]byte, error) // Storage fileset entry. type GoogleCloudDatacatalogV1beta1GcsFilesetSpec struct { // FilePatterns: Required. Patterns to identify a set of files in Google - // Cloud Storage. See [Cloud Storage - // documentation](https://cloud.google.com/storage/docs/gsutil/addlhelp/W - // ildcardNames) for more information. Note that bucket wildcards are - // currently not supported. Examples of valid file_patterns: * - // `gs://bucket_name/dir/*`: matches all files within `bucket_name/dir` - // directory. * `gs://bucket_name/dir/**`: matches all files in - // `bucket_name/dir` spanning all subdirectories. * + // Cloud Storage. See Cloud Storage documentation for more information. + // Note that bucket wildcards are currently not supported. Examples of + // valid file_patterns: * `gs://bucket_name/dir/*`: matches all files + // within `bucket_name/dir` directory. * `gs://bucket_name/dir/**`: + // matches all files in `bucket_name/dir` spanning all subdirectories. * // `gs://bucket_name/file*`: matches files prefixed by `file` in // `bucket_name` * `gs://bucket_name/??.txt`: matches files with two // characters followed by `.txt` in `bucket_name` * @@ -1494,9 +1486,8 @@ type GoogleCloudDatacatalogV1beta1SearchCatalogRequest struct { // that the user has access to. Query strings can be simple as "x" or // more qualified as: * name:x * column:x * description:y Note: Query // tokens need to have a minimum of 3 characters for substring matching - // to work correctly. See [Data Catalog Search - // Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-refer - // ence) for more information. + // to work correctly. See Data Catalog Search Syntax for more + // information. Query string `json:"query,omitempty"` // Scope: Required. The scope of this search request. A `scope` that has @@ -1856,8 +1847,7 @@ func (s *GoogleCloudDatacatalogV1beta1TableSpec) MarshalJSON() ([]byte, error) { // GoogleCloudDatacatalogV1beta1Tag: Tags are used to attach custom // metadata to Data Catalog resources. Tags conform to the -// specifications within their tag template. See [Data Catalog -// IAM](https://cloud.google.com/data-catalog/docs/concepts/iam) for +// specifications within their tag template. See Data Catalog IAM for // information on the permissions needed to create or view tags. type GoogleCloudDatacatalogV1beta1Tag struct { // Column: Resources like Entry can have schemas associated with them. @@ -2012,13 +2002,10 @@ func (s *GoogleCloudDatacatalogV1beta1TagFieldEnumValue) MarshalJSON() ([]byte, // GoogleCloudDatacatalogV1beta1TagTemplate: A tag template defines a // tag, which can have one or more typed fields. The template is used to -// create and attach the tag to GCP resources. [Tag template -// roles](https://cloud.google.com/iam/docs/understanding-roles#data-cata -// log-roles) provide permissions to create, edit, and use the template. -// See, for example, the [TagTemplate -// User](https://cloud.google.com/data-catalog/docs/how-to/template-user) -// role, which includes permission to use the tag template to tag -// resources. +// create and attach the tag to GCP resources. Tag template roles +// provide permissions to create, edit, and use the template. See, for +// example, the TagTemplate User role, which includes permission to use +// the tag template to tag resources. type GoogleCloudDatacatalogV1beta1TagTemplate struct { // DisplayName: The display name for this template. Defaults to an empty // string. @@ -2231,9 +2218,8 @@ func (s *GoogleCloudDatacatalogV1beta1ViewSpec) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2251,8 +2237,8 @@ func (s *GoogleCloudDatacatalogV1beta1ViewSpec) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -2287,9 +2273,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2355,8 +2340,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2434,9 +2418,8 @@ type CatalogSearchCall struct { // that Data Catalog search queries do not guarantee full recall. Query // results that match your query may not be returned, even in subsequent // result pages. Also note that results returned (and not returned) can -// vary across repeated search queries. See [Data Catalog Search -// Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-refer -// ence) for more information. +// vary across repeated search queries. See Data Catalog Search Syntax +// for more information. func (r *CatalogService) Search(googleclouddatacatalogv1beta1searchcatalogrequest *GoogleCloudDatacatalogV1beta1SearchCatalogRequest) *CatalogSearchCall { c := &CatalogSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.googleclouddatacatalogv1beta1searchcatalogrequest = googleclouddatacatalogv1beta1searchcatalogrequest @@ -5126,12 +5109,7 @@ type ProjectsLocationsEntryGroupsEntriesTagsCreateCall struct { } // Create: Creates a tag on an Entry. Note: The project identified by -// the `parent` parameter for the -// [tag](https://cloud.google.com/data-catalog/docs/reference/rest/v1beta -// 1/projects.locations.entryGroups.entries.tags/create#path-parameters) -// and the [tag -// template](https://cloud.google.com/data-catalog/docs/reference/rest/v1 -// beta1/projects.locations.tagTemplates/create#path-parameters) used to +// the `parent` parameter for the tag and the tag template used to // create the tag must be from the same organization. func (r *ProjectsLocationsEntryGroupsEntriesTagsService) Create(parent string, googleclouddatacatalogv1beta1tag *GoogleCloudDatacatalogV1beta1Tag) *ProjectsLocationsEntryGroupsEntriesTagsCreateCall { c := &ProjectsLocationsEntryGroupsEntriesTagsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -5750,12 +5728,7 @@ type ProjectsLocationsEntryGroupsTagsCreateCall struct { } // Create: Creates a tag on an Entry. Note: The project identified by -// the `parent` parameter for the -// [tag](https://cloud.google.com/data-catalog/docs/reference/rest/v1beta -// 1/projects.locations.entryGroups.entries.tags/create#path-parameters) -// and the [tag -// template](https://cloud.google.com/data-catalog/docs/reference/rest/v1 -// beta1/projects.locations.tagTemplates/create#path-parameters) used to +// the `parent` parameter for the tag and the tag template used to // create the tag must be from the same organization. func (r *ProjectsLocationsEntryGroupsTagsService) Create(parent string, googleclouddatacatalogv1beta1tag *GoogleCloudDatacatalogV1beta1Tag) *ProjectsLocationsEntryGroupsTagsCreateCall { c := &ProjectsLocationsEntryGroupsTagsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -6375,9 +6348,7 @@ type ProjectsLocationsTagTemplatesCreateCall struct { // Create: Creates a tag template. The user should enable the Data // Catalog API in the project identified by the `parent` parameter (see -// [Data Catalog Resource -// Project](https://cloud.google.com/data-catalog/docs/concepts/resource- -// project) for more information). +// Data Catalog Resource Project for more information). func (r *ProjectsLocationsTagTemplatesService) Create(parent string, googleclouddatacatalogv1beta1tagtemplate *GoogleCloudDatacatalogV1beta1TagTemplate) *ProjectsLocationsTagTemplatesCreateCall { c := &ProjectsLocationsTagTemplatesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7436,9 +7407,7 @@ type ProjectsLocationsTagTemplatesFieldsCreateCall struct { // Create: Creates a field in a tag template. The user should enable the // Data Catalog API in the project identified by the `parent` parameter -// (see [Data Catalog Resource -// Project](https://cloud.google.com/data-catalog/docs/concepts/resource- -// project) for more information). +// (see Data Catalog Resource Project for more information). func (r *ProjectsLocationsTagTemplatesFieldsService) Create(parent string, googleclouddatacatalogv1beta1tagtemplatefield *GoogleCloudDatacatalogV1beta1TagTemplateField) *ProjectsLocationsTagTemplatesFieldsCreateCall { c := &ProjectsLocationsTagTemplatesFieldsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7912,9 +7881,7 @@ type ProjectsLocationsTagTemplatesFieldsRenameCall struct { // Rename: Renames a field in a tag template. The user should enable the // Data Catalog API in the project identified by the `name` parameter -// (see [Data Catalog Resource -// Project](https://cloud.google.com/data-catalog/docs/concepts/resource- -// project) for more information). +// (see Data Catalog Resource Project for more information). func (r *ProjectsLocationsTagTemplatesFieldsService) Rename(name string, googleclouddatacatalogv1beta1renametagtemplatefieldrequest *GoogleCloudDatacatalogV1beta1RenameTagTemplateFieldRequest) *ProjectsLocationsTagTemplatesFieldsRenameCall { c := &ProjectsLocationsTagTemplatesFieldsRenameCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/dataflow/v1b3/dataflow-gen.go b/dataflow/v1b3/dataflow-gen.go index 867bd017ed4..cc5e79cf312 100644 --- a/dataflow/v1b3/dataflow-gen.go +++ b/dataflow/v1b3/dataflow-gen.go @@ -2164,10 +2164,9 @@ type FlexTemplateRuntimeEnvironment struct { // AdditionalUserLabels: Additional user labels to be specified for the // job. Keys and values must follow the restrictions specified in the - // [labeling - // restrictions](https://cloud.google.com/compute/docs/labeling-resources - // #restrictions) page. An object containing a list of "key": value - // pairs. Example: { "name": "wrench", "mass": "1kg", "count": "3" }. + // labeling restrictions page. An object containing a list of "key": + // value pairs. Example: { "name": "wrench", "mass": "1kg", "count": "3" + // }. AdditionalUserLabels map[string]string `json:"additionalUserLabels,omitempty"` // EnableStreamingEngine: Whether to enable Streaming Engine for the @@ -2236,10 +2235,9 @@ type FlexTemplateRuntimeEnvironment struct { // are set, `worker_zone` takes precedence. WorkerZone string `json:"workerZone,omitempty"` - // Zone: The Compute Engine [availability - // zone](https://cloud.google.com/compute/docs/regions-zones/regions-zone - // s) for launching worker instances to run your pipeline. In the - // future, worker_zone will take precedence. + // Zone: The Compute Engine availability zone for launching worker + // instances to run your pipeline. In the future, worker_zone will take + // precedence. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -5107,10 +5105,9 @@ type RuntimeEnvironment struct { // AdditionalUserLabels: Additional user labels to be specified for the // job. Keys and values should follow the restrictions specified in the - // [labeling - // restrictions](https://cloud.google.com/compute/docs/labeling-resources - // #restrictions) page. An object containing a list of "key": value - // pairs. Example: { "name": "wrench", "mass": "1kg", "count": "3" }. + // labeling restrictions page. An object containing a list of "key": + // value pairs. Example: { "name": "wrench", "mass": "1kg", "count": "3" + // }. AdditionalUserLabels map[string]string `json:"additionalUserLabels,omitempty"` // BypassTempDirValidation: Whether to bypass the safety checks for the @@ -5183,10 +5180,9 @@ type RuntimeEnvironment struct { // are set, `worker_zone` takes precedence. WorkerZone string `json:"workerZone,omitempty"` - // Zone: The Compute Engine [availability - // zone](https://cloud.google.com/compute/docs/regions-zones/regions-zone - // s) for launching worker instances to run your pipeline. In the - // future, worker_zone will take precedence. + // Zone: The Compute Engine availability zone for launching worker + // instances to run your pipeline. In the future, worker_zone will take + // precedence. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -6449,11 +6445,10 @@ func (s *StateFamilyConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/datafusion/v1/datafusion-gen.go b/datafusion/v1/datafusion-gen.go index 77f7c0b1eb7..2d851ae4d68 100644 --- a/datafusion/v1/datafusion-gen.go +++ b/datafusion/v1/datafusion-gen.go @@ -337,9 +337,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -999,9 +997,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1019,8 +1016,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1059,9 +1056,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1135,11 +1131,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1182,8 +1177,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2097,9 +2091,7 @@ func (r *ProjectsLocationsInstancesService) GetIamPolicy(resource string) *Proje // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsInstancesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsInstancesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/datafusion/v1beta1/datafusion-gen.go b/datafusion/v1beta1/datafusion-gen.go index 2d0cd25677d..3c805b8f7df 100644 --- a/datafusion/v1beta1/datafusion-gen.go +++ b/datafusion/v1beta1/datafusion-gen.go @@ -337,9 +337,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -997,9 +995,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1017,8 +1014,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1057,9 +1054,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1133,11 +1129,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1180,8 +1175,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2099,9 +2093,7 @@ func (r *ProjectsLocationsInstancesService) GetIamPolicy(resource string) *Proje // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsInstancesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsInstancesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/datalabeling/v1beta1/datalabeling-gen.go b/datalabeling/v1beta1/datalabeling-gen.go index bc5450d8eb5..411d851b322 100644 --- a/datalabeling/v1beta1/datalabeling-gen.go +++ b/datalabeling/v1beta1/datalabeling-gen.go @@ -567,10 +567,9 @@ type GoogleCloudDatalabelingV1alpha1HumanAnnotationConfig struct { // `[a-zA-Z\\d_-]{0,128}`. LabelGroup string `json:"labelGroup,omitempty"` - // LanguageCode: Optional. The Language of this question, as a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Default value - // is en-US. Only need to set this when task is language related. For - // example, French text classification. + // LanguageCode: Optional. The Language of this question, as a BCP-47. + // Default value is en-US. Only need to set this when task is language + // related. For example, French text classification. LanguageCode string `json:"languageCode,omitempty"` // QuestionDuration: Optional. Maximum duration for contributors to @@ -1697,12 +1696,9 @@ type GoogleCloudDatalabelingV1beta1BigQuerySource struct { // long. If you specify the URI of a table that does not exist, Data // Labeling Service creates a table at the URI with the correct schema // when you create your EvaluationJob. If you specify the URI of a table - // that already exists, it must have the [correct - // schema](/ml-engine/docs/continuous-evaluation/create-job#table-schema) - // . Provide the table URI in the following format: - // "bq://{your_project_id}/ {your_dataset_name}/{your_table_name}" - // [Learn - // more](/ml-engine/docs/continuous-evaluation/create-job#table-schema). + // that already exists, it must have the correct schema. Provide the + // table URI in the following format: "bq://{your_project_id}/ + // {your_dataset_name}/{your_table_name}" Learn more. InputUri string `json:"inputUri,omitempty"` // ForceSendFields is a list of field names (e.g. "InputUri") to @@ -1731,10 +1727,9 @@ func (s *GoogleCloudDatalabelingV1beta1BigQuerySource) MarshalJSON() ([]byte, er // GoogleCloudDatalabelingV1beta1BoundingBoxEvaluationOptions: Options // regarding evaluation between bounding boxes. type GoogleCloudDatalabelingV1beta1BoundingBoxEvaluationOptions struct { - // IouThreshold: Minimum [intersection-over-union - // (IOU)](/vision/automl/object-detection/docs/evaluate#intersection-over - // -union) required for 2 bounding boxes to be considered a match. This - // must be a number between 0 and 1. + // IouThreshold: Minimum intersection-over-union (IOU) required for 2 + // bounding boxes to be considered a match. This must be a number + // between 0 and 1. IouThreshold float64 `json:"iouThreshold,omitempty"` // ForceSendFields is a list of field names (e.g. "IouThreshold") to @@ -1907,9 +1902,8 @@ type GoogleCloudDatalabelingV1beta1ConfidenceMetricsEntry struct { // label is categorized as positive or negative (in the context of this // point on the PR curve) based on whether the label's score meets this // threshold. For image object detection (bounding box) tasks, this is - // the [intersection-over-union - // (IOU)](/vision/automl/object-detection/docs/evaluate#intersection-over - // -union) threshold for the context of this point on the PR curve. + // the intersection-over-union (IOU) threshold for the context of this + // point on the PR curve. ConfidenceThreshold float64 `json:"confidenceThreshold,omitempty"` // F1Score: Harmonic mean of recall and precision. @@ -2485,9 +2479,8 @@ func (s *GoogleCloudDatalabelingV1beta1EvaluationConfig) MarshalJSON() ([]byte, } // GoogleCloudDatalabelingV1beta1EvaluationJob: Defines an evaluation -// job that runs periodically to generate Evaluations. [Creating an -// evaluation job](/ml-engine/docs/continuous-evaluation/create-job) is -// the starting point for using continuous evaluation. +// job that runs periodically to generate Evaluations. Creating an +// evaluation job is the starting point for using continuous evaluation. type GoogleCloudDatalabelingV1beta1EvaluationJob struct { // AnnotationSpecSet: Required. Name of the AnnotationSpecSet describing // all the labels that your machine learning model outputs. You must @@ -2519,11 +2512,10 @@ type GoogleCloudDatalabelingV1beta1EvaluationJob struct { // in the evaluation job's BigQuery table, set this to `false`. LabelMissingGroundTruth bool `json:"labelMissingGroundTruth,omitempty"` - // ModelVersion: Required. The [AI Platform Prediction model - // version](/ml-engine/docs/prediction-overview) to be evaluated. - // Prediction input and output is sampled from this model version. When - // creating an evaluation job, specify the model version in the - // following format: + // ModelVersion: Required. The AI Platform Prediction model version to + // be evaluated. Prediction input and output is sampled from this model + // version. When creating an evaluation job, specify the model version + // in the following format: // "projects/{project_id}/models/{model_name}/versions/{version_name}" // There can only be one evaluation job per model version. ModelVersion string `json:"modelVersion,omitempty"` @@ -2536,13 +2528,10 @@ type GoogleCloudDatalabelingV1beta1EvaluationJob struct { // Schedule: Required. Describes the interval at which the job runs. // This interval must be at least 1 day, and it is rounded to the // nearest day. For example, if you specify a 50-hour interval, the job - // runs every 2 days. You can provide the schedule in [crontab - // format](/scheduler/docs/configuring/cron-job-schedules) or in an - // [English-like - // format](/appengine/docs/standard/python/config/cronref#schedule_format - // ). Regardless of what you specify, the job will run at 10:00 AM UTC. - // Only the interval from this schedule is used, not the specific time - // of day. + // runs every 2 days. You can provide the schedule in crontab format or + // in an English-like format. Regardless of what you specify, the job + // will run at 10:00 AM UTC. Only the interval from this schedule is + // used, not the specific time of day. Schedule string `json:"schedule,omitempty"` // State: Output only. Describes the current state of the job. @@ -2677,9 +2666,7 @@ type GoogleCloudDatalabelingV1beta1EvaluationJobConfig struct { // `label_score_json_key`: the score key for prediction output. // Required. * `bounding_box_json_key`: the bounding box key for // prediction output. Required if your model version perform image - // object detection. Learn [how to configure prediction - // keys](/ml-engine/docs/continuous-evaluation/create-job#prediction-keys - // ). + // object detection. Learn how to configure prediction keys. BigqueryImportKeys map[string]string `json:"bigqueryImportKeys,omitempty"` // BoundingPolyConfig: Specify this field if your model version performs @@ -3329,10 +3316,9 @@ type GoogleCloudDatalabelingV1beta1HumanAnnotationConfig struct { // `[a-zA-Z\\d_-]{0,128}`. LabelGroup string `json:"labelGroup,omitempty"` - // LanguageCode: Optional. The Language of this question, as a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Default value - // is en-US. Only need to set this when task is language related. For - // example, French text classification. + // LanguageCode: Optional. The Language of this question, as a BCP-47. + // Default value is en-US. Only need to set this when task is language + // related. For example, French text classification. LanguageCode string `json:"languageCode,omitempty"` // QuestionDuration: Optional. Maximum duration for contributors to @@ -5744,8 +5730,7 @@ func (s *GoogleCloudDatalabelingV1beta1TextEntityExtractionConfig) MarshalJSON() // GoogleCloudDatalabelingV1beta1TextMetadata: Metadata for the text. type GoogleCloudDatalabelingV1beta1TextMetadata struct { - // LanguageCode: The language of this text, as a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Default value + // LanguageCode: The language of this text, as a BCP-47. Default value // is en-US. LanguageCode string `json:"languageCode,omitempty"` @@ -6358,10 +6343,9 @@ type GoogleCloudDatalabelingV1p1alpha1HumanAnnotationConfig struct { // `[a-zA-Z\\d_-]{0,128}`. LabelGroup string `json:"labelGroup,omitempty"` - // LanguageCode: Optional. The Language of this question, as a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Default value - // is en-US. Only need to set this when task is language related. For - // example, French text classification. + // LanguageCode: Optional. The Language of this question, as a BCP-47. + // Default value is en-US. Only need to set this when task is language + // related. For example, French text classification. LanguageCode string `json:"languageCode,omitempty"` // QuestionDuration: Optional. Maximum duration for contributors to @@ -7207,10 +7191,9 @@ type GoogleCloudDatalabelingV1p2alpha1HumanAnnotationConfig struct { // `[a-zA-Z\\d_-]{0,128}`. LabelGroup string `json:"labelGroup,omitempty"` - // LanguageCode: Optional. The Language of this question, as a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Default value - // is en-US. Only need to set this when task is language related. For - // example, French text classification. + // LanguageCode: Optional. The Language of this question, as a BCP-47. + // Default value is en-US. Only need to set this when task is language + // related. For example, French text classification. LanguageCode string `json:"languageCode,omitempty"` // QuestionDuration: Optional. Maximum duration for contributors to @@ -7950,11 +7933,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/datamigration/v1beta1/datamigration-gen.go b/datamigration/v1beta1/datamigration-gen.go index 2b6edfa3212..2a4264e568e 100644 --- a/datamigration/v1beta1/datamigration-gen.go +++ b/datamigration/v1beta1/datamigration-gen.go @@ -299,9 +299,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -486,8 +484,8 @@ type CloudSqlSettings struct { // Tier: The tier (or machine type) for this instance, for example: // `db-n1-standard-1` (MySQL instances) or `db-custom-1-3840` - // (PostgreSQL instances). For more information, see [Cloud SQL Instance - // Settings](https://cloud.google.com/sql/docs/mysql/instance-settings). + // (PostgreSQL instances). For more information, see Cloud SQL Instance + // Settings. Tier string `json:"tier,omitempty"` // UserLabels: The resource labels for a Cloud SQL instance to use to @@ -1342,9 +1340,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1362,8 +1359,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1402,9 +1399,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1532,9 +1528,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // SqlAclEntry: An entry for an Access Control list. type SqlAclEntry struct { - // ExpireTime: The time when this access control entry expires in [RFC - // 3339](https://tools.ietf.org/html/rfc3339) format, for example: - // `2012-11-15T16:19:00.094Z`. + // ExpireTime: The time when this access control entry expires in RFC + // 3339 format, for example: `2012-11-15T16:19:00.094Z`. ExpireTime string `json:"expireTime,omitempty"` // Label: A label to identify this entry. @@ -1714,11 +1709,10 @@ type StaticIpConnectivity struct { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1766,8 +1760,7 @@ type StopMigrationJobRequest struct { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2773,9 +2766,7 @@ func (r *ProjectsLocationsConnectionProfilesService) GetIamPolicy(resource strin // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsConnectionProfilesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsConnectionProfilesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -4239,9 +4230,7 @@ func (r *ProjectsLocationsMigrationJobsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsMigrationJobsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsMigrationJobsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/datastore/v1/datastore-gen.go b/datastore/v1/datastore-gen.go index ac11b6f55a9..8b251bc9fcf 100644 --- a/datastore/v1/datastore-gen.go +++ b/datastore/v1/datastore-gen.go @@ -753,10 +753,8 @@ type GoogleDatastoreAdminV1ExportEntitiesRequest struct { // `gs://BUCKET_NAME[/NAMESPACE_PATH]`, where `BUCKET_NAME` is the name // of the Cloud Storage bucket and `NAMESPACE_PATH` is an optional Cloud // Storage namespace path (this is not a Cloud Datastore namespace). For - // more information about Cloud Storage namespace paths, see [Object - // name - // considerations](https://cloud.google.com/storage/docs/naming#object-co - // nsiderations). The resulting files will be nested deeper than the + // more information about Cloud Storage namespace paths, see Object name + // considerations. The resulting files will be nested deeper than the // specified URL prefix. The final output URL will be provided in the // google.datastore.admin.v1.ExportEntitiesResponse.output_url field. // That value should be used for subsequent ImportEntities operations. @@ -881,10 +879,8 @@ type GoogleDatastoreAdminV1ImportEntitiesRequest struct { // `NAMESPACE_PATH` is an optional Cloud Storage namespace path (this is // not a Cloud Datastore namespace), and `OVERALL_EXPORT_METADATA_FILE` // is the metadata file written by the ExportEntities operation. For - // more information about Cloud Storage namespace paths, see [Object - // name - // considerations](https://cloud.google.com/storage/docs/naming#object-co - // nsiderations). For more information, see + // more information about Cloud Storage namespace paths, see Object name + // considerations. For more information, see // google.datastore.admin.v1.ExportEntitiesResponse.output_url. InputUrl string `json:"inputUrl,omitempty"` @@ -1493,9 +1489,7 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GqlQuery: A [GQL -// query](https://cloud.google.com/datastore/docs/apis/gql/gql_reference) -// . +// GqlQuery: A GQL query. type GqlQuery struct { // AllowLiterals: When false, the query string must not contain any // literals and instead must bind all values. For example, `SELECT * @@ -1516,9 +1510,7 @@ type GqlQuery struct { // true. PositionalBindings []*GqlQueryParameter `json:"positionalBindings,omitempty"` - // QueryString: A string of the format described - // [here](https://cloud.google.com/datastore/docs/apis/gql/gql_reference) - // . + // QueryString: A string of the format described here. QueryString string `json:"queryString,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowLiterals") to @@ -2098,10 +2090,8 @@ type Query struct { DistinctOn []*PropertyReference `json:"distinctOn,omitempty"` // EndCursor: An ending point for the query results. Query cursors are - // returned in query result batches and [can only be used to limit the - // same - // query](https://cloud.google.com/datastore/docs/concepts/queries#cursor - // s_limits_and_offsets). + // returned in query result batches and can only be used to limit the + // same query. EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. @@ -2129,10 +2119,8 @@ type Query struct { Projection []*Projection `json:"projection,omitempty"` // StartCursor: A starting point for the query results. Query cursors - // are returned in query result batches and [can only be used to - // continue the same - // query](https://cloud.google.com/datastore/docs/concepts/queries#cursor - // s_limits_and_offsets). + // are returned in query result batches and can only be used to continue + // the same query. StartCursor string `json:"startCursor,omitempty"` // ForceSendFields is a list of field names (e.g. "DistinctOn") to @@ -2464,11 +2452,10 @@ func (s *RunQueryResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2681,7 +2668,7 @@ func (c *ProjectsAllocateIdsCall) Header() http.Header { func (c *ProjectsAllocateIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2821,7 +2808,7 @@ func (c *ProjectsBeginTransactionCall) Header() http.Header { func (c *ProjectsBeginTransactionCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2962,7 +2949,7 @@ func (c *ProjectsCommitCall) Header() http.Header { func (c *ProjectsCommitCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3109,7 +3096,7 @@ func (c *ProjectsExportCall) Header() http.Header { func (c *ProjectsExportCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3254,7 +3241,7 @@ func (c *ProjectsImportCall) Header() http.Header { func (c *ProjectsImportCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3394,7 +3381,7 @@ func (c *ProjectsLookupCall) Header() http.Header { func (c *ProjectsLookupCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3535,7 +3522,7 @@ func (c *ProjectsReserveIdsCall) Header() http.Header { func (c *ProjectsReserveIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3675,7 +3662,7 @@ func (c *ProjectsRollbackCall) Header() http.Header { func (c *ProjectsRollbackCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3815,7 +3802,7 @@ func (c *ProjectsRunQueryCall) Header() http.Header { func (c *ProjectsRunQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3963,7 +3950,7 @@ func (c *ProjectsIndexesCreateCall) Header() http.Header { func (c *ProjectsIndexesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4110,7 +4097,7 @@ func (c *ProjectsIndexesDeleteCall) Header() http.Header { func (c *ProjectsIndexesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4261,7 +4248,7 @@ func (c *ProjectsIndexesGetCall) Header() http.Header { func (c *ProjectsIndexesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4435,7 +4422,7 @@ func (c *ProjectsIndexesListCall) Header() http.Header { func (c *ProjectsIndexesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4615,7 +4602,7 @@ func (c *ProjectsOperationsCancelCall) Header() http.Header { func (c *ProjectsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4749,7 +4736,7 @@ func (c *ProjectsOperationsDeleteCall) Header() http.Header { func (c *ProjectsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4893,7 +4880,7 @@ func (c *ProjectsOperationsGetCall) Header() http.Header { func (c *ProjectsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5068,7 +5055,7 @@ func (c *ProjectsOperationsListCall) Header() http.Header { func (c *ProjectsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/datastore/v1beta1/datastore-gen.go b/datastore/v1beta1/datastore-gen.go index c8bd5dd871d..856b72a3775 100644 --- a/datastore/v1beta1/datastore-gen.go +++ b/datastore/v1beta1/datastore-gen.go @@ -624,10 +624,9 @@ type GoogleDatastoreAdminV1beta1ExportEntitiesRequest struct { // the name of the Cloud Storage bucket and `NAMESPACE_PATH` is an // optional Cloud Storage namespace path (this is not a Cloud Datastore // namespace). For more information about Cloud Storage namespace paths, - // see [Object name - // considerations](https://cloud.google.com/storage/docs/naming#object-co - // nsiderations). The resulting files will be nested deeper than the - // specified URL prefix. The final output URL will be provided in the + // see Object name considerations. The resulting files will be nested + // deeper than the specified URL prefix. The final output URL will be + // provided in the // google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url // field. That value should be used for subsequent ImportEntities // operations. By nesting the data files deeper, the same Cloud Storage @@ -753,10 +752,8 @@ type GoogleDatastoreAdminV1beta1ImportEntitiesRequest struct { // `NAMESPACE_PATH` is an optional Cloud Storage namespace path (this is // not a Cloud Datastore namespace), and `OVERALL_EXPORT_METADATA_FILE` // is the metadata file written by the ExportEntities operation. For - // more information about Cloud Storage namespace paths, see [Object - // name - // considerations](https://cloud.google.com/storage/docs/naming#object-co - // nsiderations). For more information, see + // more information about Cloud Storage namespace paths, see Object name + // considerations. For more information, see // google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url. InputUrl string `json:"inputUrl,omitempty"` @@ -884,11 +881,10 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/datastore/v1beta3/datastore-gen.go b/datastore/v1beta3/datastore-gen.go index c1f54a87e0c..981f0c2b042 100644 --- a/datastore/v1beta3/datastore-gen.go +++ b/datastore/v1beta3/datastore-gen.go @@ -1109,9 +1109,7 @@ func (s *GoogleDatastoreAdminV1beta1Progress) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GqlQuery: A [GQL -// query](https://cloud.google.com/datastore/docs/apis/gql/gql_reference) -// . +// GqlQuery: A GQL query. type GqlQuery struct { // AllowLiterals: When false, the query string must not contain any // literals and instead must bind all values. For example, `SELECT * @@ -1132,9 +1130,7 @@ type GqlQuery struct { // true. PositionalBindings []*GqlQueryParameter `json:"positionalBindings,omitempty"` - // QueryString: A string of the format described - // [here](https://cloud.google.com/datastore/docs/apis/gql/gql_reference) - // . + // QueryString: A string of the format described here. QueryString string `json:"queryString,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowLiterals") to @@ -1714,10 +1710,8 @@ type Query struct { DistinctOn []*PropertyReference `json:"distinctOn,omitempty"` // EndCursor: An ending point for the query results. Query cursors are - // returned in query result batches and [can only be used to limit the - // same - // query](https://cloud.google.com/datastore/docs/concepts/queries#cursor - // s_limits_and_offsets). + // returned in query result batches and can only be used to limit the + // same query. EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. @@ -1745,10 +1739,8 @@ type Query struct { Projection []*Projection `json:"projection,omitempty"` // StartCursor: A starting point for the query results. Query cursors - // are returned in query result batches and [can only be used to - // continue the same - // query](https://cloud.google.com/datastore/docs/concepts/queries#cursor - // s_limits_and_offsets). + // are returned in query result batches and can only be used to continue + // the same query. StartCursor string `json:"startCursor,omitempty"` // ForceSendFields is a list of field names (e.g. "DistinctOn") to @@ -2255,7 +2247,7 @@ func (c *ProjectsAllocateIdsCall) Header() http.Header { func (c *ProjectsAllocateIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2395,7 +2387,7 @@ func (c *ProjectsBeginTransactionCall) Header() http.Header { func (c *ProjectsBeginTransactionCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2536,7 +2528,7 @@ func (c *ProjectsCommitCall) Header() http.Header { func (c *ProjectsCommitCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2676,7 +2668,7 @@ func (c *ProjectsLookupCall) Header() http.Header { func (c *ProjectsLookupCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2817,7 +2809,7 @@ func (c *ProjectsReserveIdsCall) Header() http.Header { func (c *ProjectsReserveIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2957,7 +2949,7 @@ func (c *ProjectsRollbackCall) Header() http.Header { func (c *ProjectsRollbackCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3097,7 +3089,7 @@ func (c *ProjectsRunQueryCall) Header() http.Header { func (c *ProjectsRunQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/deploymentmanager/v0.alpha/deploymentmanager-gen.go b/deploymentmanager/v0.alpha/deploymentmanager-gen.go index e1b8779d640..1da92800db5 100644 --- a/deploymentmanager/v0.alpha/deploymentmanager-gen.go +++ b/deploymentmanager/v0.alpha/deploymentmanager-gen.go @@ -442,9 +442,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -559,9 +557,8 @@ type CompositeType struct { // Labels: Map of labels; provided by the client when the resource is // created or updated. Specifically: Label keys must be between 1 and 63 // characters long and must conform to the following regular expression: - // `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // `a-z?` Label values must be between 0 and 63 characters long and must + // conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*CompositeTypeLabelEntry `json:"labels,omitempty"` // Name: Name of the composite type, must follow the expression: @@ -770,9 +767,9 @@ type Deployment struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the last @@ -913,9 +910,9 @@ type DeploymentUpdate struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentUpdateLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the update @@ -1438,17 +1435,12 @@ func (s *MethodMap) MarshalJSON() ([]byte, error) { } // Operation: Represents an Operation resource. Google Compute Engine -// has three Operation resources: * -// [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionOperation -// s) * -// [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) -// You can use an operation resource to manage asynchronous API -// requests. For more information, read Handling API responses. -// Operations can be global, regional or zonal. - For global operations, -// use the `globalOperations` resource. - For regional operations, use -// the `regionOperations` resource. - For zonal operations, use the +// has three Operation resources: * Global * Regional * Zonal You can +// use an operation resource to manage asynchronous API requests. For +// more information, read Handling API responses. Operations can be +// global, regional or zonal. - For global operations, use the +// `globalOperations` resource. - For regional operations, use the +// `regionOperations` resource. - For zonal operations, use the // `zonalOperations` resource. For more information, read Global, // Regional, and Zonal Resources. type Operation struct { @@ -1862,9 +1854,8 @@ func (s *Options) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1882,8 +1873,8 @@ func (s *Options) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1922,9 +1913,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2749,9 +2739,9 @@ type Type struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*TypeLabelEntry `json:"labels,omitempty"` // Name: Name of the type. @@ -2945,9 +2935,9 @@ type TypeProvider struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?` + // regular expression: `a-z?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?` Labels []*TypeProviderLabelEntry `json:"labels,omitempty"` // Name: Name of the resource; provided by the client when the resource diff --git a/deploymentmanager/v2/deploymentmanager-gen.go b/deploymentmanager/v2/deploymentmanager-gen.go index 6d20ed380e0..8a4c3ac14de 100644 --- a/deploymentmanager/v2/deploymentmanager-gen.go +++ b/deploymentmanager/v2/deploymentmanager-gen.go @@ -315,9 +315,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -431,9 +429,9 @@ type Deployment struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the last @@ -535,9 +533,9 @@ type DeploymentUpdate struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentUpdateLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the update @@ -927,17 +925,12 @@ func (s *ManifestsListResponse) MarshalJSON() ([]byte, error) { } // Operation: Represents an Operation resource. Google Compute Engine -// has three Operation resources: * -// [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionOperation -// s) * -// [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) -// You can use an operation resource to manage asynchronous API -// requests. For more information, read Handling API responses. -// Operations can be global, regional or zonal. - For global operations, -// use the `globalOperations` resource. - For regional operations, use -// the `regionOperations` resource. - For zonal operations, use the +// has three Operation resources: * Global * Regional * Zonal You can +// use an operation resource to manage asynchronous API requests. For +// more information, read Handling API responses. Operations can be +// global, regional or zonal. - For global operations, use the +// `globalOperations` resource. - For regional operations, use the +// `regionOperations` resource. - For zonal operations, use the // `zonalOperations` resource. For more information, read Global, // Regional, and Zonal Resources. type Operation struct { @@ -1310,9 +1303,8 @@ func (s *OperationsListResponse) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1330,8 +1322,8 @@ func (s *OperationsListResponse) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1370,9 +1362,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/deploymentmanager/v2beta/deploymentmanager-gen.go b/deploymentmanager/v2beta/deploymentmanager-gen.go index 67df9345002..8079ea515fc 100644 --- a/deploymentmanager/v2beta/deploymentmanager-gen.go +++ b/deploymentmanager/v2beta/deploymentmanager-gen.go @@ -442,9 +442,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -555,9 +553,8 @@ type CompositeType struct { // Labels: Map of labels; provided by the client when the resource is // created or updated. Specifically: Label keys must be between 1 and 63 // characters long and must conform to the following regular expression: - // `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // `a-z?` Label values must be between 0 and 63 characters long and must + // conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*CompositeTypeLabelEntry `json:"labels,omitempty"` // Name: Name of the composite type, must follow the expression: @@ -763,9 +760,9 @@ type Deployment struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the last @@ -867,9 +864,9 @@ type DeploymentUpdate struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentUpdateLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the update @@ -1346,17 +1343,12 @@ func (s *ManifestsListResponse) MarshalJSON() ([]byte, error) { } // Operation: Represents an Operation resource. Google Compute Engine -// has three Operation resources: * -// [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) -// * -// [Regional](/compute/docs/reference/rest/{$api_version}/regionOperation -// s) * -// [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations) -// You can use an operation resource to manage asynchronous API -// requests. For more information, read Handling API responses. -// Operations can be global, regional or zonal. - For global operations, -// use the `globalOperations` resource. - For regional operations, use -// the `regionOperations` resource. - For zonal operations, use the +// has three Operation resources: * Global * Regional * Zonal You can +// use an operation resource to manage asynchronous API requests. For +// more information, read Handling API responses. Operations can be +// global, regional or zonal. - For global operations, use the +// `globalOperations` resource. - For regional operations, use the +// `regionOperations` resource. - For zonal operations, use the // `zonalOperations` resource. For more information, read Global, // Regional, and Zonal Resources. type Operation struct { @@ -1775,9 +1767,8 @@ func (s *Options) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1795,8 +1786,8 @@ func (s *Options) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1835,9 +1826,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2627,9 +2617,9 @@ type Type struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*TypeLabelEntry `json:"labels,omitempty"` // Name: Name of the type. @@ -2819,9 +2809,9 @@ type TypeProvider struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?` + // regular expression: `a-z?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?` Labels []*TypeProviderLabelEntry `json:"labels,omitempty"` // Name: Name of the resource; provided by the client when the resource diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 9b91b355f23..c4edc91d1b4 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -771,7 +771,7 @@ type GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText struct { AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` // Ssml: The SSML text to be synthesized. For more information, see - // [SSML](/speech/text-to-speech/docs/ssml). + // SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -1600,7 +1600,7 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText struct { AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` // Ssml: The SSML text to be synthesized. For more information, see - // [SSML](/speech/text-to-speech/docs/ssml). + // SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -1999,8 +1999,7 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse) Marsh // conversation to structured data that your apps and services can // understand. You design and build a Dialogflow agent to handle the // types of conversations required for your system. For more information -// about agents, see the [Agent -// guide](https://cloud.google.com/dialogflow/docs/agents-overview). +// about agents, see the Agent guide. type GoogleCloudDialogflowV2Agent struct { // ApiVersion: Optional. API version displayed in Dialogflow console. If // not specified, V2 API is assumed. Clients are free to query different @@ -2015,8 +2014,7 @@ type GoogleCloudDialogflowV2Agent struct { ApiVersion string `json:"apiVersion,omitempty"` // AvatarUri: Optional. The URI of the agent's avatar. Avatars are used - // throughout the Dialogflow console and in the self-hosted [Web - // Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo) + // throughout the Dialogflow console and in the self-hosted Web Demo // integration. AvatarUri string `json:"avatarUri,omitempty"` @@ -2031,10 +2029,9 @@ type GoogleCloudDialogflowV2Agent struct { ClassificationThreshold float64 `json:"classificationThreshold,omitempty"` // DefaultLanguageCode: Required. The default language of the agent as a - // language tag. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. This field - // cannot be set by the `Update` method. + // language tag. See Language Support for a list of the currently + // supported language codes. This field cannot be set by the `Update` + // method. DefaultLanguageCode string `json:"defaultLanguageCode,omitempty"` // Description: Optional. The description of this agent. The maximum @@ -2079,9 +2076,8 @@ type GoogleCloudDialogflowV2Agent struct { // "TIER_ENTERPRISE_PLUS" - Enterprise tier (Plus). Tier string `json:"tier,omitempty"` - // TimeZone: Required. The time zone of this agent from the [time zone - // database](https://www.iana.org/time-zones), e.g., America/New_York, - // Europe/Paris. + // TimeZone: Required. The time zone of this agent from the time zone + // database, e.g., America/New_York, Europe/Paris. TimeZone string `json:"timeZone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2130,15 +2126,13 @@ func (s *GoogleCloudDialogflowV2Agent) UnmarshalJSON(data []byte) error { // or purely a part of the message between two entities or message // start/end. type GoogleCloudDialogflowV2AnnotatedMessagePart struct { - // EntityType: The [Dialogflow system entity - // type](https://cloud.google.com/dialogflow/docs/reference/system-entiti - // es) of this message part. If this is empty, Dialogflow could not - // annotate the phrase part with a system entity. + // EntityType: The Dialogflow system entity type of this message part. + // If this is empty, Dialogflow could not annotate the phrase part with + // a system entity. EntityType string `json:"entityType,omitempty"` - // FormattedValue: The [Dialogflow system entity formatted value - // ](https://cloud.google.com/dialogflow/docs/reference/system-entities) - // of this message part. For example for a system entity of type + // FormattedValue: The Dialogflow system entity formatted value of this + // message part. For example for a system entity of type // `@sys.unit-currency`, this may contain: { "amount": 5, "currency": // "USD" } FormattedValue interface{} `json:"formattedValue,omitempty"` @@ -2177,9 +2171,7 @@ type GoogleCloudDialogflowV2BatchCreateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see [Multilingual intent and entity - // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int - // ent-entity). + // more information, see Multilingual intent and entity data. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Entities") to @@ -2215,9 +2207,7 @@ type GoogleCloudDialogflowV2BatchDeleteEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see [Multilingual intent and entity - // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int - // ent-entity). + // more information, see Multilingual intent and entity data. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "EntityValues") to @@ -2312,9 +2302,7 @@ type GoogleCloudDialogflowV2BatchUpdateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see [Multilingual intent and entity - // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int - // ent-entity). + // more information, see Multilingual intent and entity data. LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -2358,9 +2346,7 @@ type GoogleCloudDialogflowV2BatchUpdateEntityTypesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see [Multilingual intent and entity - // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int - // ent-entity). + // more information, see Multilingual intent and entity data. LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -2441,9 +2427,7 @@ type GoogleCloudDialogflowV2BatchUpdateIntentsRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see [Multilingual intent and entity - // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int - // ent-entity). + // more information, see Multilingual intent and entity data. LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -2514,8 +2498,7 @@ func (s *GoogleCloudDialogflowV2BatchUpdateIntentsResponse) MarshalJSON() ([]byt // active. While any contexts are active, Dialogflow is more likely to // match intents that are configured with input contexts that correspond // to the currently active contexts. For more information about context, -// see the [Contexts -// guide](https://cloud.google.com/dialogflow/docs/contexts-overview). +// see the Contexts guide. type GoogleCloudDialogflowV2Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -2753,8 +2736,7 @@ func (s *GoogleCloudDialogflowV2DetectIntentResponse) MarshalJSON() ([]byte, err // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// [Entity -// guide](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide. type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -2901,8 +2883,7 @@ func (s *GoogleCloudDialogflowV2EntityTypeEntity) MarshalJSON() ([]byte, error) // published to the default environment. When you create agent versions, // you can publish them to custom environments. You can create a variety // of custom environments for: - testing - development - production - -// etc. For more information, see the [versions and environments -// guide](https://cloud.google.com/dialogflow/docs/agents-versions). +// etc. For more information, see the versions and environments guide. type GoogleCloudDialogflowV2Environment struct { // AgentVersion: Optional. The agent version loaded into this // environment. Format: `projects//agent/versions/`. @@ -2962,11 +2943,10 @@ func (s *GoogleCloudDialogflowV2Environment) MarshalJSON() ([]byte, error) { // `name` may be used by the agent in the response: "Hello // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2EventInput struct { - // LanguageCode: Required. The language of this query. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // LanguageCode: Required. The language of this query. See Language + // Support for a list of the currently supported language codes. Note + // that queries in the same session do not necessarily need to specify + // the same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -3009,10 +2989,9 @@ func (s *GoogleCloudDialogflowV2EventInput) MarshalJSON() ([]byte, error) { // GoogleCloudDialogflowV2ExportAgentRequest: The request message for // Agents.ExportAgent. type GoogleCloudDialogflowV2ExportAgentRequest struct { - // AgentUri: Required. The [Google Cloud - // Storage](https://cloud.google.com/storage/docs/) URI to export the - // agent to. The format of this URI must be `gs:///`. If left - // unspecified, the serialized agent is returned inline. + // AgentUri: Required. The Google Cloud Storage URI to export the agent + // to. The format of this URI must be `gs:///`. If left unspecified, the + // serialized agent is returned inline. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentUri") to @@ -3079,8 +3058,7 @@ func (s *GoogleCloudDialogflowV2ExportAgentResponse) MarshalJSON() ([]byte, erro // by calling a service that you define. For example, if an end-user // wants to schedule a haircut on Friday, your service can check your // database and respond to the end-user with availability information -// for Friday. For more information, see the [fulfillment -// guide](https://cloud.google.com/dialogflow/docs/fulfillment-overview). +// for Friday. For more information, see the fulfillment guide. type GoogleCloudDialogflowV2Fulfillment struct { // DisplayName: Optional. The human-readable name of the fulfillment, // unique within the agent. @@ -3291,11 +3269,9 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { EnableWordInfo bool `json:"enableWordInfo,omitempty"` // LanguageCode: Required. The language of the supplied audio. - // Dialogflow does not do translations. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // Dialogflow does not do translations. See Language Support for a list + // of the currently supported language codes. Note that queries in the + // same session do not necessarily need to specify the same language. LanguageCode string `json:"languageCode,omitempty"` // Model: Which Speech model to select for the given request. Select the @@ -3304,10 +3280,8 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { // parameters in the InputAudioConfig. If enhanced speech model is // enabled for the agent and an enhanced version of the specified model // for the language does not exist, then the speech is recognized using - // the standard version of the specified model. Refer to [Cloud Speech - // API - // documentation](https://cloud.google.com/speech-to-text/docs/basics#sel - // ect-model) for more details. + // the standard version of the specified model. Refer to Cloud Speech + // API documentation for more details. Model string `json:"model,omitempty"` // ModelVariant: Which variant of the Speech model to use. @@ -3335,18 +3309,15 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { ModelVariant string `json:"modelVariant,omitempty"` // PhraseHints: A list of strings containing words and phrases that the - // speech recognizer should recognize with higher likelihood. See [the - // Cloud Speech - // documentation](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) for more details. This field is deprecated. Please use - // [speech_contexts]() instead. If you specify both [phrase_hints]() and - // [speech_contexts](), Dialogflow will treat the [phrase_hints]() as a - // single additional [SpeechContext](). + // speech recognizer should recognize with higher likelihood. See the + // Cloud Speech documentation for more details. This field is + // deprecated. Please use speech_contexts instead. If you specify both + // phrase_hints and speech_contexts, Dialogflow will treat the + // phrase_hints as a single additional SpeechContext. PhraseHints []string `json:"phraseHints,omitempty"` // SampleRateHertz: Required. Sample rate (in Hertz) of the audio - // content sent in the query. Refer to [Cloud Speech API - // documentation](https://cloud.google.com/speech-to-text/docs/basics) + // content sent in the query. Refer to Cloud Speech API documentation // for more details. SampleRateHertz int64 `json:"sampleRateHertz,omitempty"` @@ -3362,9 +3333,7 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { SingleUtterance bool `json:"singleUtterance,omitempty"` // SpeechContexts: Context information to assist speech recognition. See - // [the Cloud Speech - // documentation](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) for more details. + // the Cloud Speech documentation for more details. SpeechContexts []*GoogleCloudDialogflowV2SpeechContext `json:"speechContexts,omitempty"` // ForceSendFields is a list of field names (e.g. "AudioEncoding") to @@ -3397,8 +3366,7 @@ func (s *GoogleCloudDialogflowV2InputAudioConfig) MarshalJSON() ([]byte, error) // as an end-user expression or end-user input, Dialogflow matches the // end-user input to the best intent in your agent. Matching an intent // is also known as intent classification. For more information, see the -// [intent -// guide](https://cloud.google.com/dialogflow/docs/intents-overview). +// intent guide. type GoogleCloudDialogflowV2Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -3606,9 +3574,7 @@ func (s *GoogleCloudDialogflowV2IntentFollowupIntentInfo) MarshalJSON() ([]byte, // GoogleCloudDialogflowV2IntentMessage: A rich response message. // Corresponds to the intent `Response` field in the Dialogflow console. -// For more information, see [Rich response -// messages](https://cloud.google.com/dialogflow/docs/intents-rich-messag -// es). +// For more information, see Rich response messages. type GoogleCloudDialogflowV2IntentMessage struct { // BasicCard: The basic card response for Actions on Google. BasicCard *GoogleCloudDialogflowV2IntentMessageBasicCard `json:"basicCard,omitempty"` @@ -5028,9 +4994,8 @@ type GoogleCloudDialogflowV2Message struct { // CreateTime: Output only. The time when the message was created. CreateTime string `json:"createTime,omitempty"` - // LanguageCode: Optional. The message language. This should be a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. - // Example: "en-US". + // LanguageCode: Optional. The message language. This should be a BCP-47 + // language tag. Example: "en-US". LanguageCode string `json:"languageCode,omitempty"` // MessageAnnotation: Output only. The annotation for the message. @@ -5124,9 +5089,7 @@ type GoogleCloudDialogflowV2OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in [E.164 - // format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition - // agents. + // with the caller ID in E.164 format for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -5286,10 +5249,9 @@ type GoogleCloudDialogflowV2QueryParameters struct { // languages and persist for the session of this query. SessionEntityTypes []*GoogleCloudDialogflowV2SessionEntityType `json:"sessionEntityTypes,omitempty"` - // TimeZone: The time zone of this conversational query from the [time - // zone database](https://www.iana.org/time-zones), e.g., - // America/New_York, Europe/Paris. If not provided, the time zone - // specified in agent settings is used. + // TimeZone: The time zone of this conversational query from the time + // zone database, e.g., America/New_York, Europe/Paris. If not provided, + // the time zone specified in agent settings is used. TimeZone string `json:"timeZone,omitempty"` // WebhookHeaders: This field can be used to pass HTTP headers for a @@ -5370,9 +5332,8 @@ type GoogleCloudDialogflowV2QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. + // detection. See Language Support for a list of the currently supported + // language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -5664,8 +5625,7 @@ func (s *GoogleCloudDialogflowV2SentimentAnalysisResult) MarshalJSON() ([]byte, // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the [session entity -// guide](https://cloud.google.com/dialogflow/docs/entities-session). +// minutes. For more information, see the session entity guide. type GoogleCloudDialogflowV2SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -5743,9 +5703,7 @@ type GoogleCloudDialogflowV2SpeechContext struct { // This list can be used to: * improve accuracy for words and phrases // you expect the user to say, e.g. typical commands for your Dialogflow // agent * add additional words to the speech recognizer vocabulary * - // ... See the [Cloud Speech - // documentation](https://cloud.google.com/speech-to-text/quotas) for - // usage limits. + // ... See the Cloud Speech documentation for usage limits. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to @@ -5866,11 +5824,9 @@ func (s *GoogleCloudDialogflowV2SynthesizeSpeechConfig) UnmarshalJSON(data []byt // text to be processed. type GoogleCloudDialogflowV2TextInput struct { // LanguageCode: Required. The language of this conversational query. - // See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // See Language Support for a list of the currently supported language + // codes. Note that queries in the same session do not necessarily need + // to specify the same language. LanguageCode string `json:"languageCode,omitempty"` // Text: Required. The UTF-8 encoded natural language text to be @@ -6091,9 +6047,7 @@ func (s *GoogleCloudDialogflowV2WebhookRequest) MarshalJSON() ([]byte, error) { // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// [Protocol Buffers Language -// Guide](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// Protocol Buffers Language Guide. type GoogleCloudDialogflowV2WebhookResponse struct { // FollowupEventInput: Optional. Invokes the supplied events. When this // field is set, Dialogflow ignores the `fulfillment_text`, @@ -6123,12 +6077,9 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the [Google Assistant - // integration](https://cloud.google.com/dialogflow/docs/integrations/aog - // ) for rich response messages. See the format definition at [Google - // Assistant Dialogflow webhook - // format](https://developers.google.com/assistant/actions/build/json/dia - // logflow-webhook-json) + // This field is also used by the Google Assistant integration for rich + // response messages. See the format definition at Google Assistant + // Dialogflow webhook format Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -6239,8 +6190,7 @@ func (s *GoogleCloudDialogflowV2beta1BatchUpdateIntentsResponse) MarshalJSON() ( // that intent become active. While any contexts are active, Dialogflow // is more likely to match intents that are configured with input // contexts that correspond to the currently active contexts. For more -// information about context, see the [Contexts -// guide](https://cloud.google.com/dialogflow/docs/contexts-overview). +// information about context, see the Contexts guide. type GoogleCloudDialogflowV2beta1Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -6306,8 +6256,7 @@ func (s *GoogleCloudDialogflowV2beta1Context) MarshalJSON() ([]byte, error) { // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// [Entity -// guide](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide. type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -6420,11 +6369,10 @@ func (s *GoogleCloudDialogflowV2beta1EntityTypeEntity) MarshalJSON() ([]byte, er // parameter `name` may be used by the agent in the response: "Hello // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2beta1EventInput struct { - // LanguageCode: Required. The language of this query. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // LanguageCode: Required. The language of this query. See Language + // Support for a list of the currently supported language codes. Note + // that queries in the same session do not necessarily need to specify + // the same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -6505,8 +6453,7 @@ func (s *GoogleCloudDialogflowV2beta1ExportAgentResponse) MarshalJSON() ([]byte, // referred to as an end-user expression or end-user input, Dialogflow // matches the end-user input to the best intent in your agent. Matching // an intent is also known as intent classification. For more -// information, see the [intent -// guide](https://cloud.google.com/dialogflow/docs/intents-overview). +// information, see the intent guide. type GoogleCloudDialogflowV2beta1Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -7718,9 +7665,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction) MarshalJSO // phone number but does not dial automatically. type GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial struct { // PhoneNumber: Required. The phone number to fill in the default dialer - // app. This field should be in - // [E.164](https://en.wikipedia.org/wiki/E.164) format. An example of a - // correctly formatted phone number: +15556767888. + // app. This field should be in E.164 format. An example of a correctly + // formatted phone number: +15556767888. PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -8202,8 +8148,7 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio) MarshalJSO // either be set at request-level or can come from the agent-level // synthesizer config. type GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech struct { - // Ssml: The SSML to be synthesized. For more information, see - // [SSML](https://developers.google.com/actions/reference/ssml). + // Ssml: The SSML to be synthesized. For more information, see SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -8236,8 +8181,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech) Mar // Transfers the call in Telephony Gateway. type GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall struct { // PhoneNumber: Required. The phone number to transfer the call to in - // [E.164 format](https://en.wikipedia.org/wiki/E.164). We currently - // only allow transferring to US numbers (+1xxxyyyzzzz). + // E.164 format. We currently only allow transferring to US numbers + // (+1xxxyyyzzzz). PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -8611,9 +8556,7 @@ type GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in [E.164 - // format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition - // agents. + // with the caller ID in E.164 format for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -8695,9 +8638,8 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { KnowledgeAnswers *GoogleCloudDialogflowV2beta1KnowledgeAnswers `json:"knowledgeAnswers,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. + // detection. See Language Support for a list of the currently supported + // language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -8885,8 +8827,7 @@ func (s *GoogleCloudDialogflowV2beta1SentimentAnalysisResult) MarshalJSON() ([]b // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the [session entity -// guide](https://cloud.google.com/dialogflow/docs/entities-session). +// minutes. For more information, see the session entity guide. type GoogleCloudDialogflowV2beta1SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -9007,9 +8948,7 @@ func (s *GoogleCloudDialogflowV2beta1WebhookRequest) MarshalJSON() ([]byte, erro // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// [Protocol Buffers Language -// Guide](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// Protocol Buffers Language Guide. type GoogleCloudDialogflowV2beta1WebhookResponse struct { // EndInteraction: Optional. Indicates that this intent ends an // interaction. Some integrations (e.g., Actions on Google or Dialogflow @@ -9045,12 +8984,9 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the [Google Assistant - // integration](https://cloud.google.com/dialogflow/docs/integrations/aog - // ) for rich response messages. See the format definition at [Google - // Assistant Dialogflow webhook - // format](https://developers.google.com/assistant/actions/build/json/dia - // logflow-webhook-json) + // This field is also used by the Google Assistant integration for rich + // response messages. See the format definition at Google Assistant + // Dialogflow webhook format Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -9204,11 +9140,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -10038,10 +9973,8 @@ func (r *ProjectsAgentService) GetValidationResult(parent string) *ProjectsAgent // LanguageCode sets the optional parameter "languageCode": The language // for which you want a validation result. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsAgentGetValidationResultCall) LanguageCode(languageCode string) *ProjectsAgentGetValidationResultCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -10493,10 +10426,8 @@ type ProjectsAgentSearchCall struct { // Search: Returns the list of agents. Since there is at most one // conversational agent per project, this method is useful primarily for // listing all agents across projects the caller has access to. One can -// achieve that with a wildcard project collection id "-". Refer to -// [List -// Sub-Collections](https://cloud.google.com/apis/design/design_patterns# -// list_sub-collections). +// achieve that with a wildcard project collection id "-". Refer to List +// Sub-Collections. func (r *ProjectsAgentService) Search(parent string) *ProjectsAgentSearchCall { c := &ProjectsAgentSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11279,10 +11210,8 @@ func (r *ProjectsAgentEntityTypesService) Create(parent string, googleclouddialo // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -11567,10 +11496,8 @@ func (r *ProjectsAgentEntityTypesService) Get(name string) *ProjectsAgentEntityT // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -11729,10 +11656,8 @@ func (r *ProjectsAgentEntityTypesService) List(parent string) *ProjectsAgentEnti // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -11939,10 +11864,8 @@ func (r *ProjectsAgentEntityTypesService) Patch(nameid string, googleclouddialog // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12855,10 +12778,8 @@ type ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall struct { // structured, actionable data as a result. This method is not // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. -// Note: Always use agent versions for production traffic. See [Versions -// and -// environments](https://cloud.google.com/dialogflow/es/docs/agents-versi -// ons). +// Note: Always use agent versions for production traffic. See Versions +// and environments. func (r *ProjectsAgentEnvironmentsUsersSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2detectintentrequest *GoogleCloudDialogflowV2DetectIntentRequest) *ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall { c := &ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -14855,10 +14776,8 @@ func (c *ProjectsAgentIntentsCreateCall) IntentView(intentView string) *Projects // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15168,10 +15087,8 @@ func (c *ProjectsAgentIntentsGetCall) IntentView(intentView string) *ProjectsAge // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15354,10 +15271,8 @@ func (c *ProjectsAgentIntentsListCall) IntentView(intentView string) *ProjectsAg // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15589,10 +15504,8 @@ func (c *ProjectsAgentIntentsPatchCall) IntentView(intentView string) *ProjectsA // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15897,10 +15810,8 @@ type ProjectsAgentSessionsDetectIntentCall struct { // structured, actionable data as a result. This method is not // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. -// Note: Always use agent versions for production traffic. See [Versions -// and -// environments](https://cloud.google.com/dialogflow/es/docs/agents-versi -// ons). +// Note: Always use agent versions for production traffic. See Versions +// and environments. func (r *ProjectsAgentSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2detectintentrequest *GoogleCloudDialogflowV2DetectIntentRequest) *ProjectsAgentSessionsDetectIntentCall { c := &ProjectsAgentSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index 8d3279f4b63..e6444fa8bf9 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -987,7 +987,7 @@ type GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText struct { AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` // Ssml: The SSML text to be synthesized. For more information, see - // [SSML](/speech/text-to-speech/docs/ssml). + // SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -1816,7 +1816,7 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText struct { AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` // Ssml: The SSML text to be synthesized. For more information, see - // [SSML](/speech/text-to-speech/docs/ssml). + // SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -2213,15 +2213,13 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse) Marsh // or purely a part of the message between two entities or message // start/end. type GoogleCloudDialogflowV2AnnotatedMessagePart struct { - // EntityType: The [Dialogflow system entity - // type](https://cloud.google.com/dialogflow/docs/reference/system-entiti - // es) of this message part. If this is empty, Dialogflow could not - // annotate the phrase part with a system entity. + // EntityType: The Dialogflow system entity type of this message part. + // If this is empty, Dialogflow could not annotate the phrase part with + // a system entity. EntityType string `json:"entityType,omitempty"` - // FormattedValue: The [Dialogflow system entity formatted value - // ](https://cloud.google.com/dialogflow/docs/reference/system-entities) - // of this message part. For example for a system entity of type + // FormattedValue: The Dialogflow system entity formatted value of this + // message part. For example for a system entity of type // `@sys.unit-currency`, this may contain: { "amount": 5, "currency": // "USD" } FormattedValue interface{} `json:"formattedValue,omitempty"` @@ -2322,8 +2320,7 @@ func (s *GoogleCloudDialogflowV2BatchUpdateIntentsResponse) MarshalJSON() ([]byt // active. While any contexts are active, Dialogflow is more likely to // match intents that are configured with input contexts that correspond // to the currently active contexts. For more information about context, -// see the [Contexts -// guide](https://cloud.google.com/dialogflow/docs/contexts-overview). +// see the Contexts guide. type GoogleCloudDialogflowV2Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -2447,8 +2444,7 @@ func (s *GoogleCloudDialogflowV2ConversationEvent) MarshalJSON() ([]byte, error) // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// [Entity -// guide](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide. type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -2560,11 +2556,10 @@ func (s *GoogleCloudDialogflowV2EntityTypeEntity) MarshalJSON() ([]byte, error) // `name` may be used by the agent in the response: "Hello // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2EventInput struct { - // LanguageCode: Required. The language of this query. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // LanguageCode: Required. The language of this query. See Language + // Support for a list of the currently supported language codes. Note + // that queries in the same session do not necessarily need to specify + // the same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -2645,8 +2640,7 @@ func (s *GoogleCloudDialogflowV2ExportAgentResponse) MarshalJSON() ([]byte, erro // as an end-user expression or end-user input, Dialogflow matches the // end-user input to the best intent in your agent. Matching an intent // is also known as intent classification. For more information, see the -// [intent -// guide](https://cloud.google.com/dialogflow/docs/intents-overview). +// intent guide. type GoogleCloudDialogflowV2Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -2821,9 +2815,7 @@ func (s *GoogleCloudDialogflowV2IntentFollowupIntentInfo) MarshalJSON() ([]byte, // GoogleCloudDialogflowV2IntentMessage: A rich response message. // Corresponds to the intent `Response` field in the Dialogflow console. -// For more information, see [Rich response -// messages](https://cloud.google.com/dialogflow/docs/intents-rich-messag -// es). +// For more information, see Rich response messages. type GoogleCloudDialogflowV2IntentMessage struct { // BasicCard: The basic card response for Actions on Google. BasicCard *GoogleCloudDialogflowV2IntentMessageBasicCard `json:"basicCard,omitempty"` @@ -4052,9 +4044,8 @@ type GoogleCloudDialogflowV2Message struct { // CreateTime: Output only. The time when the message was created. CreateTime string `json:"createTime,omitempty"` - // LanguageCode: Optional. The message language. This should be a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. - // Example: "en-US". + // LanguageCode: Optional. The message language. This should be a BCP-47 + // language tag. Example: "en-US". LanguageCode string `json:"languageCode,omitempty"` // MessageAnnotation: Output only. The annotation for the message. @@ -4148,9 +4139,7 @@ type GoogleCloudDialogflowV2OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in [E.164 - // format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition - // agents. + // with the caller ID in E.164 format for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -4228,9 +4217,8 @@ type GoogleCloudDialogflowV2QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. + // detection. See Language Support for a list of the currently supported + // language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -4418,8 +4406,7 @@ func (s *GoogleCloudDialogflowV2SentimentAnalysisResult) MarshalJSON() ([]byte, // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the [session entity -// guide](https://cloud.google.com/dialogflow/docs/entities-session). +// minutes. For more information, see the session entity guide. type GoogleCloudDialogflowV2SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -4530,9 +4517,7 @@ func (s *GoogleCloudDialogflowV2WebhookRequest) MarshalJSON() ([]byte, error) { // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// [Protocol Buffers Language -// Guide](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// Protocol Buffers Language Guide. type GoogleCloudDialogflowV2WebhookResponse struct { // FollowupEventInput: Optional. Invokes the supplied events. When this // field is set, Dialogflow ignores the `fulfillment_text`, @@ -4562,12 +4547,9 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the [Google Assistant - // integration](https://cloud.google.com/dialogflow/docs/integrations/aog - // ) for rich response messages. See the format definition at [Google - // Assistant Dialogflow webhook - // format](https://developers.google.com/assistant/actions/build/json/dia - // logflow-webhook-json) + // This field is also used by the Google Assistant integration for rich + // response messages. See the format definition at Google Assistant + // Dialogflow webhook format Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -4615,8 +4597,7 @@ func (s *GoogleCloudDialogflowV2WebhookResponse) MarshalJSON() ([]byte, error) { // conversation to structured data that your apps and services can // understand. You design and build a Dialogflow agent to handle the // types of conversations required for your system. For more information -// about agents, see the [Agent -// guide](https://cloud.google.com/dialogflow/docs/agents-overview). +// about agents, see the Agent guide. type GoogleCloudDialogflowV2beta1Agent struct { // ApiVersion: Optional. API version displayed in Dialogflow console. If // not specified, V2 API is assumed. Clients are free to query different @@ -4631,8 +4612,7 @@ type GoogleCloudDialogflowV2beta1Agent struct { ApiVersion string `json:"apiVersion,omitempty"` // AvatarUri: Optional. The URI of the agent's avatar. Avatars are used - // throughout the Dialogflow console and in the self-hosted [Web - // Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo) + // throughout the Dialogflow console and in the self-hosted Web Demo // integration. AvatarUri string `json:"avatarUri,omitempty"` @@ -4647,10 +4627,9 @@ type GoogleCloudDialogflowV2beta1Agent struct { ClassificationThreshold float64 `json:"classificationThreshold,omitempty"` // DefaultLanguageCode: Required. The default language of the agent as a - // language tag. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. This field - // cannot be set by the `Update` method. + // language tag. See Language Support for a list of the currently + // supported language codes. This field cannot be set by the `Update` + // method. DefaultLanguageCode string `json:"defaultLanguageCode,omitempty"` // Description: Optional. The description of this agent. The maximum @@ -4696,9 +4675,8 @@ type GoogleCloudDialogflowV2beta1Agent struct { // "TIER_ENTERPRISE_PLUS" - Enterprise tier (Plus). Tier string `json:"tier,omitempty"` - // TimeZone: Required. The time zone of this agent from the [time zone - // database](https://www.iana.org/time-zones), e.g., America/New_York, - // Europe/Paris. + // TimeZone: Required. The time zone of this agent from the time zone + // database, e.g., America/New_York, Europe/Paris. TimeZone string `json:"timeZone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4750,9 +4728,7 @@ type GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see [Multilingual intent and entity - // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int - // ent-entity). + // more information, see Multilingual intent and entity data. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Entities") to @@ -4788,9 +4764,7 @@ type GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see [Multilingual intent and entity - // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int - // ent-entity). + // more information, see Multilingual intent and entity data. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "EntityValues") to @@ -4885,9 +4859,7 @@ type GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see [Multilingual intent and entity - // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int - // ent-entity). + // more information, see Multilingual intent and entity data. LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -4931,9 +4903,7 @@ type GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see [Multilingual intent and entity - // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int - // ent-entity). + // more information, see Multilingual intent and entity data. LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -5016,9 +4986,7 @@ type GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see [Multilingual intent and entity - // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int - // ent-entity). + // more information, see Multilingual intent and entity data. LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -5089,8 +5057,7 @@ func (s *GoogleCloudDialogflowV2beta1BatchUpdateIntentsResponse) MarshalJSON() ( // that intent become active. While any contexts are active, Dialogflow // is more likely to match intents that are configured with input // contexts that correspond to the currently active contexts. For more -// information about context, see the [Contexts -// guide](https://cloud.google.com/dialogflow/docs/contexts-overview). +// information about context, see the Contexts guide. type GoogleCloudDialogflowV2beta1Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -5274,10 +5241,9 @@ func (s *GoogleCloudDialogflowV2beta1DetectIntentResponse) MarshalJSON() ([]byte } // GoogleCloudDialogflowV2beta1Document: A knowledge document to be used -// by a KnowledgeBase. For more information, see the [knowledge base -// guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). -// Note: The `projects.agent.knowledgeBases.documents` resource is -// deprecated; only use `projects.knowledgeBases.documents`. +// by a KnowledgeBase. For more information, see the knowledge base +// guide. Note: The `projects.agent.knowledgeBases.documents` resource +// is deprecated; only use `projects.knowledgeBases.documents`. type GoogleCloudDialogflowV2beta1Document struct { // Content: The raw content of the document. This field is only // permitted for EXTRACTIVE_QA and FAQ knowledge types. Note: This field @@ -5413,8 +5379,7 @@ func (s *GoogleCloudDialogflowV2beta1DocumentReloadStatus) MarshalJSON() ([]byte // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// [Entity -// guide](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide. type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -5562,9 +5527,8 @@ func (s *GoogleCloudDialogflowV2beta1EntityTypeEntity) MarshalJSON() ([]byte, er // is published to the default environment. When you create agent // versions, you can publish them to custom environments. You can create // a variety of custom environments for: - testing - development - -// production - etc. For more information, see the [versions and -// environments -// guide](https://cloud.google.com/dialogflow/docs/agents-versions). +// production - etc. For more information, see the versions and +// environments guide. type GoogleCloudDialogflowV2beta1Environment struct { // AgentVersion: Optional. The agent version loaded into this // environment. Supported formats: - `projects//agent/versions/` - @@ -5625,11 +5589,10 @@ func (s *GoogleCloudDialogflowV2beta1Environment) MarshalJSON() ([]byte, error) // parameter `name` may be used by the agent in the response: "Hello // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2beta1EventInput struct { - // LanguageCode: Required. The language of this query. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // LanguageCode: Required. The language of this query. See Language + // Support for a list of the currently supported language codes. Note + // that queries in the same session do not necessarily need to specify + // the same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -5672,10 +5635,9 @@ func (s *GoogleCloudDialogflowV2beta1EventInput) MarshalJSON() ([]byte, error) { // GoogleCloudDialogflowV2beta1ExportAgentRequest: The request message // for Agents.ExportAgent. type GoogleCloudDialogflowV2beta1ExportAgentRequest struct { - // AgentUri: Optional. The [Google Cloud - // Storage](https://cloud.google.com/storage/docs/) URI to export the - // agent to. The format of this URI must be `gs:///`. If left - // unspecified, the serialized agent is returned inline. + // AgentUri: Optional. The Google Cloud Storage URI to export the agent + // to. The format of this URI must be `gs:///`. If left unspecified, the + // serialized agent is returned inline. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentUri") to @@ -5743,8 +5705,7 @@ func (s *GoogleCloudDialogflowV2beta1ExportAgentResponse) MarshalJSON() ([]byte, // example, if an end-user wants to schedule a haircut on Friday, your // service can check your database and respond to the end-user with // availability information for Friday. For more information, see the -// [fulfillment -// guide](https://cloud.google.com/dialogflow/docs/fulfillment-overview). +// fulfillment guide. type GoogleCloudDialogflowV2beta1Fulfillment struct { // DisplayName: The human-readable name of the fulfillment, unique // within the agent. @@ -5987,11 +5948,9 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { EnableWordInfo bool `json:"enableWordInfo,omitempty"` // LanguageCode: Required. The language of the supplied audio. - // Dialogflow does not do translations. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // Dialogflow does not do translations. See Language Support for a list + // of the currently supported language codes. Note that queries in the + // same session do not necessarily need to specify the same language. LanguageCode string `json:"languageCode,omitempty"` // Model: Which Speech model to select for the given request. Select the @@ -6000,10 +5959,8 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { // parameters in the InputAudioConfig. If enhanced speech model is // enabled for the agent and an enhanced version of the specified model // for the language does not exist, then the speech is recognized using - // the standard version of the specified model. Refer to [Cloud Speech - // API - // documentation](https://cloud.google.com/speech-to-text/docs/basics#sel - // ect-model) for more details. + // the standard version of the specified model. Refer to Cloud Speech + // API documentation for more details. Model string `json:"model,omitempty"` // ModelVariant: Which variant of the Speech model to use. @@ -6031,18 +5988,15 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { ModelVariant string `json:"modelVariant,omitempty"` // PhraseHints: A list of strings containing words and phrases that the - // speech recognizer should recognize with higher likelihood. See [the - // Cloud Speech - // documentation](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) for more details. This field is deprecated. Please use - // [speech_contexts]() instead. If you specify both [phrase_hints]() and - // [speech_contexts](), Dialogflow will treat the [phrase_hints]() as a - // single additional [SpeechContext](). + // speech recognizer should recognize with higher likelihood. See the + // Cloud Speech documentation for more details. This field is + // deprecated. Please use speech_contexts instead. If you specify both + // phrase_hints and speech_contexts, Dialogflow will treat the + // phrase_hints as a single additional SpeechContext. PhraseHints []string `json:"phraseHints,omitempty"` // SampleRateHertz: Required. Sample rate (in Hertz) of the audio - // content sent in the query. Refer to [Cloud Speech API - // documentation](https://cloud.google.com/speech-to-text/docs/basics) + // content sent in the query. Refer to Cloud Speech API documentation // for more details. SampleRateHertz int64 `json:"sampleRateHertz,omitempty"` @@ -6058,9 +6012,7 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { SingleUtterance bool `json:"singleUtterance,omitempty"` // SpeechContexts: Context information to assist speech recognition. See - // [the Cloud Speech - // documentation](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) for more details. + // the Cloud Speech documentation for more details. SpeechContexts []*GoogleCloudDialogflowV2beta1SpeechContext `json:"speechContexts,omitempty"` // ForceSendFields is a list of field names (e.g. "AudioEncoding") to @@ -6093,8 +6045,7 @@ func (s *GoogleCloudDialogflowV2beta1InputAudioConfig) MarshalJSON() ([]byte, er // referred to as an end-user expression or end-user input, Dialogflow // matches the end-user input to the best intent in your agent. Matching // an intent is also known as intent classification. For more -// information, see the [intent -// guide](https://cloud.google.com/dialogflow/docs/intents-overview). +// information, see the intent guide. type GoogleCloudDialogflowV2beta1Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -7339,9 +7290,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction) MarshalJSO // phone number but does not dial automatically. type GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial struct { // PhoneNumber: Required. The phone number to fill in the default dialer - // app. This field should be in - // [E.164](https://en.wikipedia.org/wiki/E.164) format. An example of a - // correctly formatted phone number: +15556767888. + // app. This field should be in E.164 format. An example of a correctly + // formatted phone number: +15556767888. PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -7823,8 +7773,7 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio) MarshalJSO // either be set at request-level or can come from the agent-level // synthesizer config. type GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech struct { - // Ssml: The SSML to be synthesized. For more information, see - // [SSML](https://developers.google.com/actions/reference/ssml). + // Ssml: The SSML to be synthesized. For more information, see SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -7857,8 +7806,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech) Mar // Transfers the call in Telephony Gateway. type GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall struct { // PhoneNumber: Required. The phone number to transfer the call to in - // [E.164 format](https://en.wikipedia.org/wiki/E.164). We currently - // only allow transferring to US numbers (+1xxxyyyzzzz). + // E.164 format. We currently only allow transferring to US numbers + // (+1xxxyyyzzzz). PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -8191,10 +8140,9 @@ func (s *GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer) UnmarshalJSON(data // Dialogflow. Your knowledge documents contain information that may be // useful during conversations with end-users. Some Dialogflow features // use knowledge bases when looking for a response to an end-user input. -// For more information, see the [knowledge base -// guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). -// Note: The `projects.agent.knowledgeBases` resource is deprecated; -// only use `projects.knowledgeBases`. +// For more information, see the knowledge base guide. Note: The +// `projects.agent.knowledgeBases` resource is deprecated; only use +// `projects.knowledgeBases`. type GoogleCloudDialogflowV2beta1KnowledgeBase struct { // DisplayName: Required. The display name of the knowledge base. The // name must be 1024 bytes or less; otherwise, the creation request @@ -8550,9 +8498,7 @@ type GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in [E.164 - // format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition - // agents. + // with the caller ID in E.164 format for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -8725,10 +8671,9 @@ type GoogleCloudDialogflowV2beta1QueryParameters struct { // silently ignored. SubAgents []*GoogleCloudDialogflowV2beta1SubAgent `json:"subAgents,omitempty"` - // TimeZone: The time zone of this conversational query from the [time - // zone database](https://www.iana.org/time-zones), e.g., - // America/New_York, Europe/Paris. If not provided, the time zone - // specified in agent settings is used. + // TimeZone: The time zone of this conversational query from the time + // zone database, e.g., America/New_York, Europe/Paris. If not provided, + // the time zone specified in agent settings is used. TimeZone string `json:"timeZone,omitempty"` // WebhookHeaders: This field can be used to pass HTTP headers for a @@ -8813,9 +8758,8 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { KnowledgeAnswers *GoogleCloudDialogflowV2beta1KnowledgeAnswers `json:"knowledgeAnswers,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. + // detection. See Language Support for a list of the currently supported + // language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -9143,8 +9087,7 @@ func (s *GoogleCloudDialogflowV2beta1SentimentAnalysisResult) MarshalJSON() ([]b // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the [session entity -// guide](https://cloud.google.com/dialogflow/docs/entities-session). +// minutes. For more information, see the session entity guide. type GoogleCloudDialogflowV2beta1SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -9226,9 +9169,7 @@ type GoogleCloudDialogflowV2beta1SpeechContext struct { // This list can be used to: * improve accuracy for words and phrases // you expect the user to say, e.g. typical commands for your Dialogflow // agent * add additional words to the speech recognizer vocabulary * - // ... See the [Cloud Speech - // documentation](https://cloud.google.com/speech-to-text/quotas) for - // usage limits. + // ... See the Cloud Speech documentation for usage limits. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to @@ -9384,11 +9325,9 @@ func (s *GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig) UnmarshalJSON(data // language text to be processed. type GoogleCloudDialogflowV2beta1TextInput struct { // LanguageCode: Required. The language of this conversational query. - // See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // See Language Support for a list of the currently supported language + // codes. Note that queries in the same session do not necessarily need + // to specify the same language. LanguageCode string `json:"languageCode,omitempty"` // Text: Required. The UTF-8 encoded natural language text to be @@ -9615,9 +9554,7 @@ func (s *GoogleCloudDialogflowV2beta1WebhookRequest) MarshalJSON() ([]byte, erro // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// [Protocol Buffers Language -// Guide](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// Protocol Buffers Language Guide. type GoogleCloudDialogflowV2beta1WebhookResponse struct { // EndInteraction: Optional. Indicates that this intent ends an // interaction. Some integrations (e.g., Actions on Google or Dialogflow @@ -9653,12 +9590,9 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the [Google Assistant - // integration](https://cloud.google.com/dialogflow/docs/integrations/aog - // ) for rich response messages. See the format definition at [Google - // Assistant Dialogflow webhook - // format](https://developers.google.com/assistant/actions/build/json/dia - // logflow-webhook-json) + // This field is also used by the Google Assistant integration for rich + // response messages. See the format definition at Google Assistant + // Dialogflow webhook format Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -9812,11 +9746,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -10648,10 +10581,8 @@ func (r *ProjectsAgentService) GetValidationResult(parent string) *ProjectsAgent // LanguageCode sets the optional parameter "languageCode": The language // for which you want a validation result. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsAgentGetValidationResultCall) LanguageCode(languageCode string) *ProjectsAgentGetValidationResultCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -11104,10 +11035,8 @@ type ProjectsAgentSearchCall struct { // Search: Returns the list of agents. Since there is at most one // conversational agent per project, this method is useful primarily for // listing all agents across projects the caller has access to. One can -// achieve that with a wildcard project collection id "-". Refer to -// [List -// Sub-Collections](https://cloud.google.com/apis/design/design_patterns# -// list_sub-collections). +// achieve that with a wildcard project collection id "-". Refer to List +// Sub-Collections. func (r *ProjectsAgentService) Search(parent string) *ProjectsAgentSearchCall { c := &ProjectsAgentSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11890,10 +11819,8 @@ func (r *ProjectsAgentEntityTypesService) Create(parent string, googleclouddialo // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12178,10 +12105,8 @@ func (r *ProjectsAgentEntityTypesService) Get(name string) *ProjectsAgentEntityT // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12340,10 +12265,8 @@ func (r *ProjectsAgentEntityTypesService) List(parent string) *ProjectsAgentEnti // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12550,10 +12473,8 @@ func (r *ProjectsAgentEntityTypesService) Patch(nameid string, googleclouddialog // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -13466,10 +13387,8 @@ type ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall struct { // structured, actionable data as a result. This method is not // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. -// Note: Always use agent versions for production traffic. See [Versions -// and -// environments](https://cloud.google.com/dialogflow/es/docs/agents-versi -// ons). +// Note: Always use agent versions for production traffic. See Versions +// and environments. func (r *ProjectsAgentEnvironmentsUsersSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2beta1detectintentrequest *GoogleCloudDialogflowV2beta1DetectIntentRequest) *ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall { c := &ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -15470,10 +15389,8 @@ func (c *ProjectsAgentIntentsCreateCall) IntentView(intentView string) *Projects // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15784,10 +15701,8 @@ func (c *ProjectsAgentIntentsGetCall) IntentView(intentView string) *ProjectsAge // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15971,10 +15886,8 @@ func (c *ProjectsAgentIntentsListCall) IntentView(intentView string) *ProjectsAg // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16206,10 +16119,8 @@ func (c *ProjectsAgentIntentsPatchCall) IntentView(intentView string) *ProjectsA // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16842,7 +16753,7 @@ func (r *ProjectsAgentKnowledgeBasesService) List(parent string) *ProjectsAgentK // bases whose display name contains "articles" and whose language code // is "en-gb". Note: An empty filter string (i.e. "") is a no-op and // will result in no filtering. For more information about filtering, -// see [API Filtering](https://aip.dev/160). +// see API Filtering. func (c *ProjectsAgentKnowledgeBasesListCall) Filter(filter string) *ProjectsAgentKnowledgeBasesListCall { c.urlParams_.Set("filter", filter) return c @@ -17657,7 +17568,7 @@ func (r *ProjectsAgentKnowledgeBasesDocumentsService) List(parent string) *Proje // display name contains "customer". * "state=ACTIVE" matches documents // with ACTIVE state. * "knowledge_types:FAQ AND state=ACTIVE" matches // all active FAQ documents. For more information about filtering, see -// [API Filtering](https://aip.dev/160). +// API Filtering. func (c *ProjectsAgentKnowledgeBasesDocumentsListCall) Filter(filter string) *ProjectsAgentKnowledgeBasesDocumentsListCall { c.urlParams_.Set("filter", filter) return c @@ -18297,10 +18208,8 @@ type ProjectsAgentSessionsDetectIntentCall struct { // structured, actionable data as a result. This method is not // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. -// Note: Always use agent versions for production traffic. See [Versions -// and -// environments](https://cloud.google.com/dialogflow/es/docs/agents-versi -// ons). +// Note: Always use agent versions for production traffic. See Versions +// and environments. func (r *ProjectsAgentSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2beta1detectintentrequest *GoogleCloudDialogflowV2beta1DetectIntentRequest) *ProjectsAgentSessionsDetectIntentCall { c := &ProjectsAgentSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -20458,7 +20367,7 @@ func (r *ProjectsKnowledgeBasesService) List(parent string) *ProjectsKnowledgeBa // bases whose display name contains "articles" and whose language code // is "en-gb". Note: An empty filter string (i.e. "") is a no-op and // will result in no filtering. For more information about filtering, -// see [API Filtering](https://aip.dev/160). +// see API Filtering. func (c *ProjectsKnowledgeBasesListCall) Filter(filter string) *ProjectsKnowledgeBasesListCall { c.urlParams_.Set("filter", filter) return c @@ -21273,7 +21182,7 @@ func (r *ProjectsKnowledgeBasesDocumentsService) List(parent string) *ProjectsKn // display name contains "customer". * "state=ACTIVE" matches documents // with ACTIVE state. * "knowledge_types:FAQ AND state=ACTIVE" matches // all active FAQ documents. For more information about filtering, see -// [API Filtering](https://aip.dev/160). +// API Filtering. func (c *ProjectsKnowledgeBasesDocumentsListCall) Filter(filter string) *ProjectsKnowledgeBasesDocumentsListCall { c.urlParams_.Set("filter", filter) return c @@ -22508,10 +22417,8 @@ func (r *ProjectsLocationsAgentService) GetValidationResult(parent string) *Proj // LanguageCode sets the optional parameter "languageCode": The language // for which you want a validation result. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentGetValidationResultCall) LanguageCode(languageCode string) *ProjectsLocationsAgentGetValidationResultCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -22964,10 +22871,8 @@ type ProjectsLocationsAgentSearchCall struct { // Search: Returns the list of agents. Since there is at most one // conversational agent per project, this method is useful primarily for // listing all agents across projects the caller has access to. One can -// achieve that with a wildcard project collection id "-". Refer to -// [List -// Sub-Collections](https://cloud.google.com/apis/design/design_patterns# -// list_sub-collections). +// achieve that with a wildcard project collection id "-". Refer to List +// Sub-Collections. func (r *ProjectsLocationsAgentService) Search(parent string) *ProjectsLocationsAgentSearchCall { c := &ProjectsLocationsAgentSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -23750,10 +23655,8 @@ func (r *ProjectsLocationsAgentEntityTypesService) Create(parent string, googlec // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsLocationsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -24038,10 +23941,8 @@ func (r *ProjectsLocationsAgentEntityTypesService) Get(name string) *ProjectsLoc // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsLocationsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -24200,10 +24101,8 @@ func (r *ProjectsLocationsAgentEntityTypesService) List(parent string) *Projects // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsLocationsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -24410,10 +24309,8 @@ func (r *ProjectsLocationsAgentEntityTypesService) Patch(nameid string, googlecl // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsLocationsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -25326,10 +25223,8 @@ type ProjectsLocationsAgentEnvironmentsUsersSessionsDetectIntentCall struct { // structured, actionable data as a result. This method is not // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. -// Note: Always use agent versions for production traffic. See [Versions -// and -// environments](https://cloud.google.com/dialogflow/es/docs/agents-versi -// ons). +// Note: Always use agent versions for production traffic. See Versions +// and environments. func (r *ProjectsLocationsAgentEnvironmentsUsersSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2beta1detectintentrequest *GoogleCloudDialogflowV2beta1DetectIntentRequest) *ProjectsLocationsAgentEnvironmentsUsersSessionsDetectIntentCall { c := &ProjectsLocationsAgentEnvironmentsUsersSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -27330,10 +27225,8 @@ func (c *ProjectsLocationsAgentIntentsCreateCall) IntentView(intentView string) // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsLocationsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -27644,10 +27537,8 @@ func (c *ProjectsLocationsAgentIntentsGetCall) IntentView(intentView string) *Pr // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsLocationsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -27831,10 +27722,8 @@ func (c *ProjectsLocationsAgentIntentsListCall) IntentView(intentView string) *P // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsLocationsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -28066,10 +27955,8 @@ func (c *ProjectsLocationsAgentIntentsPatchCall) IntentView(intentView string) * // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's -// default language is used. For more information, see [Multilingual -// intent and entity -// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data. func (c *ProjectsLocationsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -28375,10 +28262,8 @@ type ProjectsLocationsAgentSessionsDetectIntentCall struct { // structured, actionable data as a result. This method is not // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. -// Note: Always use agent versions for production traffic. See [Versions -// and -// environments](https://cloud.google.com/dialogflow/es/docs/agents-versi -// ons). +// Note: Always use agent versions for production traffic. See Versions +// and environments. func (r *ProjectsLocationsAgentSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2beta1detectintentrequest *GoogleCloudDialogflowV2beta1DetectIntentRequest) *ProjectsLocationsAgentSessionsDetectIntentCall { c := &ProjectsLocationsAgentSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -30536,7 +30421,7 @@ func (r *ProjectsLocationsKnowledgeBasesService) List(parent string) *ProjectsLo // bases whose display name contains "articles" and whose language code // is "en-gb". Note: An empty filter string (i.e. "") is a no-op and // will result in no filtering. For more information about filtering, -// see [API Filtering](https://aip.dev/160). +// see API Filtering. func (c *ProjectsLocationsKnowledgeBasesListCall) Filter(filter string) *ProjectsLocationsKnowledgeBasesListCall { c.urlParams_.Set("filter", filter) return c @@ -31351,7 +31236,7 @@ func (r *ProjectsLocationsKnowledgeBasesDocumentsService) List(parent string) *P // display name contains "customer". * "state=ACTIVE" matches documents // with ACTIVE state. * "knowledge_types:FAQ AND state=ACTIVE" matches // all active FAQ documents. For more information about filtering, see -// [API Filtering](https://aip.dev/160). +// API Filtering. func (c *ProjectsLocationsKnowledgeBasesDocumentsListCall) Filter(filter string) *ProjectsLocationsKnowledgeBasesDocumentsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 8515e54bc01..a3c8b4be515 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -367,16 +367,13 @@ type ProjectsOperationsService struct { // flows.. type GoogleCloudDialogflowCxV3Agent struct { // AvatarUri: The URI of the agent's avatar. Avatars are used throughout - // the Dialogflow console and in the self-hosted [Web - // Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo) - // integration. + // the Dialogflow console and in the self-hosted Web Demo integration. AvatarUri string `json:"avatarUri,omitempty"` // DefaultLanguageCode: Immutable. The default language of the agent as - // a language tag. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. This field - // cannot be set by the Agents.UpdateAgent method. + // a language tag. See Language Support for a list of the currently + // supported language codes. This field cannot be set by the + // Agents.UpdateAgent method. DefaultLanguageCode string `json:"defaultLanguageCode,omitempty"` // Description: The description of the agent. The maximum length is 500 @@ -409,9 +406,8 @@ type GoogleCloudDialogflowCxV3Agent struct { // `projects//locations//agents//flows/`. StartFlow string `json:"startFlow,omitempty"` - // TimeZone: Required. The time zone of the agent from the [time zone - // database](https://www.iana.org/time-zones), e.g., America/New_York, - // Europe/Paris. + // TimeZone: Required. The time zone of the agent from the time zone + // database, e.g., America/New_York, Europe/Paris. TimeZone string `json:"timeZone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -652,9 +648,7 @@ func (s *GoogleCloudDialogflowCxV3DtmfInput) MarshalJSON() ([]byte, error) { // that are built for an individual user such as favorites, preferences, // playlists, and so on. A user entity is represented by the // SessionEntityType type. For more information about entity types, see -// the [Dialogflow -// documentation](https://cloud.google.com/dialogflow/docs/entities-overv -// iew). +// the Dialogflow documentation. type GoogleCloudDialogflowCxV3EntityType struct { // AutoExpansionMode: Indicates whether the entity type can be // automatically expanded. @@ -973,10 +967,9 @@ func (s *GoogleCloudDialogflowCxV3EventInput) MarshalJSON() ([]byte, error) { // GoogleCloudDialogflowCxV3ExportAgentRequest: The request message for // Agents.ExportAgent. type GoogleCloudDialogflowCxV3ExportAgentRequest struct { - // AgentUri: Optional. The [Google Cloud - // Storage](https://cloud.google.com/storage/docs/) URI to export the - // agent to. The format of this URI must be `gs:///`. If left - // unspecified, the serialized agent is returned inline. + // AgentUri: Optional. The Google Cloud Storage URI to export the agent + // to. The format of this URI must be `gs:///`. If left unspecified, the + // serialized agent is returned inline. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentUri") to @@ -1444,9 +1437,8 @@ type GoogleCloudDialogflowCxV3FulfillmentConditionalCasesCase struct { // Condition: The condition to activate and select this case. Empty // means the condition is always true. The condition is evaluated - // against form parameters or session parameters. See the [conditions - // reference](https://cloud.google.com/dialogflow/cx/docs/reference/condi - // tion). + // against form parameters or session parameters. See the conditions + // reference. Condition string `json:"condition,omitempty"` // ForceSendFields is a list of field names (e.g. "CaseContent") to @@ -1593,10 +1585,8 @@ type GoogleCloudDialogflowCxV3InputAudioConfig struct { // on the parameters in the InputAudioConfig. If enhanced speech model // is enabled for the agent and an enhanced version of the specified // model for the language does not exist, then the speech is recognized - // using the standard version of the specified model. Refer to [Cloud - // Speech API - // documentation](https://cloud.google.com/speech-to-text/docs/basics#sel - // ect-model) for more details. + // using the standard version of the specified model. Refer to Cloud + // Speech API documentation for more details. Model string `json:"model,omitempty"` // ModelVariant: Optional. Which variant of the Speech model to use. @@ -1625,15 +1615,11 @@ type GoogleCloudDialogflowCxV3InputAudioConfig struct { // PhraseHints: Optional. A list of strings containing words and phrases // that the speech recognizer should recognize with higher likelihood. - // See [the Cloud Speech - // documentation](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) for more details. + // See the Cloud Speech documentation for more details. PhraseHints []string `json:"phraseHints,omitempty"` // SampleRateHertz: Sample rate (in Hertz) of the audio content sent in - // the query. Refer to [Cloud Speech API - // documentation](https://cloud.google.com/speech-to-text/docs/basics) - // for more details. + // the query. Refer to Cloud Speech API documentation for more details. SampleRateHertz int64 `json:"sampleRateHertz,omitempty"` // SingleUtterance: Optional. If `false` (default), recognition does not @@ -2717,8 +2703,7 @@ func (s *GoogleCloudDialogflowCxV3OutputAudioConfig) MarshalJSON() ([]byte, erro // turn, the current page will either stay the same or transition to // another page. You configure each page to collect information from the // end-user that is relevant for the conversational state represented by -// the page. For more information, see the [Page -// guide](https://cloud.google.com/dialogflow/cx/docs/concept/page). +// the page. For more information, see the Page guide. type GoogleCloudDialogflowCxV3Page struct { // DisplayName: Required. The human-readable name of the page, unique // within the agent. @@ -2935,11 +2920,10 @@ type GoogleCloudDialogflowCxV3QueryInput struct { // Intent: The intent to be triggered. Intent *GoogleCloudDialogflowCxV3IntentInput `json:"intent,omitempty"` - // LanguageCode: Required. The language of the input. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // LanguageCode: Required. The language of the input. See Language + // Support for a list of the currently supported language codes. Note + // that queries in the same session do not necessarily need to specify + // the same language. LanguageCode string `json:"languageCode,omitempty"` // Text: The natural language text to be processed. @@ -3001,10 +2985,9 @@ type GoogleCloudDialogflowCxV3QueryParameters struct { // languages and persist for the session of this query. SessionEntityTypes []*GoogleCloudDialogflowCxV3SessionEntityType `json:"sessionEntityTypes,omitempty"` - // TimeZone: The time zone of this conversational query from the [time - // zone database](https://www.iana.org/time-zones), e.g., - // America/New_York, Europe/Paris. If not provided, the time zone - // specified in the agent is used. + // TimeZone: The time zone of this conversational query from the time + // zone database, e.g., America/New_York, Europe/Paris. If not provided, + // the time zone specified in the agent is used. TimeZone string `json:"timeZone,omitempty"` // WebhookHeaders: This field can be used to pass HTTP headers for a @@ -3071,9 +3054,8 @@ type GoogleCloudDialogflowCxV3QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. + // detection. See Language Support for a list of the currently supported + // language codes. LanguageCode string `json:"languageCode,omitempty"` // Match: Intent match result, could be an intent or an event. @@ -3406,7 +3388,7 @@ type GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText struct { AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` // Ssml: The SSML text to be synthesized. For more information, see - // [SSML](/speech/text-to-speech/docs/ssml). + // SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -3517,9 +3499,8 @@ type GoogleCloudDialogflowCxV3RestoreAgentRequest struct { // AgentContent: Uncompressed raw byte content for agent. AgentContent string `json:"agentContent,omitempty"` - // AgentUri: The [Google Cloud - // Storage](https://cloud.google.com/storage/docs/) URI to restore agent - // from. The format of this URI must be `gs:///`. + // AgentUri: The Google Cloud Storage URI to restore agent from. The + // format of this URI must be `gs:///`. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -3687,9 +3668,7 @@ func (s *GoogleCloudDialogflowCxV3SentimentAnalysisResult) UnmarshalJSON(data [] // refer to the entity types defined at the agent level as "custom // entity types"). Note: session entity types apply to all queries, // regardless of the language. For more information about entity types, -// see the [Dialogflow -// documentation](https://cloud.google.com/dialogflow/docs/entities-overv -// iew). +// see the Dialogflow documentation. type GoogleCloudDialogflowCxV3SessionEntityType struct { // Entities: Required. The collection of entities to override or // supplement the custom entity type. @@ -3943,11 +3922,10 @@ type GoogleCloudDialogflowCxV3TrainFlowRequest struct { // transition into the specified flow. type GoogleCloudDialogflowCxV3TransitionRoute struct { // Condition: The condition to evaluate against form parameters or - // session parameters. See the [conditions - // reference](https://cloud.google.com/dialogflow/cx/docs/reference/condi - // tion). At least one of `intent` or `condition` must be specified. - // When both `intent` and `condition` are specified, the transition can - // only happen when both are fulfilled. + // session parameters. See the conditions reference. At least one of + // `intent` or `condition` must be specified. When both `intent` and + // `condition` are specified, the transition can only happen when both + // are fulfilled. Condition string `json:"condition,omitempty"` // Intent: The unique identifier of an Intent. Format: @@ -4932,7 +4910,7 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText struct { AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` // Ssml: The SSML text to be synthesized. For more information, see - // [SSML](/speech/text-to-speech/docs/ssml). + // SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -5329,15 +5307,13 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse) Marsh // or purely a part of the message between two entities or message // start/end. type GoogleCloudDialogflowV2AnnotatedMessagePart struct { - // EntityType: The [Dialogflow system entity - // type](https://cloud.google.com/dialogflow/docs/reference/system-entiti - // es) of this message part. If this is empty, Dialogflow could not - // annotate the phrase part with a system entity. + // EntityType: The Dialogflow system entity type of this message part. + // If this is empty, Dialogflow could not annotate the phrase part with + // a system entity. EntityType string `json:"entityType,omitempty"` - // FormattedValue: The [Dialogflow system entity formatted value - // ](https://cloud.google.com/dialogflow/docs/reference/system-entities) - // of this message part. For example for a system entity of type + // FormattedValue: The Dialogflow system entity formatted value of this + // message part. For example for a system entity of type // `@sys.unit-currency`, this may contain: { "amount": 5, "currency": // "USD" } FormattedValue interface{} `json:"formattedValue,omitempty"` @@ -5438,8 +5414,7 @@ func (s *GoogleCloudDialogflowV2BatchUpdateIntentsResponse) MarshalJSON() ([]byt // active. While any contexts are active, Dialogflow is more likely to // match intents that are configured with input contexts that correspond // to the currently active contexts. For more information about context, -// see the [Contexts -// guide](https://cloud.google.com/dialogflow/docs/contexts-overview). +// see the Contexts guide. type GoogleCloudDialogflowV2Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -5563,8 +5538,7 @@ func (s *GoogleCloudDialogflowV2ConversationEvent) MarshalJSON() ([]byte, error) // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// [Entity -// guide](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide. type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -5676,11 +5650,10 @@ func (s *GoogleCloudDialogflowV2EntityTypeEntity) MarshalJSON() ([]byte, error) // `name` may be used by the agent in the response: "Hello // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2EventInput struct { - // LanguageCode: Required. The language of this query. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // LanguageCode: Required. The language of this query. See Language + // Support for a list of the currently supported language codes. Note + // that queries in the same session do not necessarily need to specify + // the same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -5761,8 +5734,7 @@ func (s *GoogleCloudDialogflowV2ExportAgentResponse) MarshalJSON() ([]byte, erro // as an end-user expression or end-user input, Dialogflow matches the // end-user input to the best intent in your agent. Matching an intent // is also known as intent classification. For more information, see the -// [intent -// guide](https://cloud.google.com/dialogflow/docs/intents-overview). +// intent guide. type GoogleCloudDialogflowV2Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -5937,9 +5909,7 @@ func (s *GoogleCloudDialogflowV2IntentFollowupIntentInfo) MarshalJSON() ([]byte, // GoogleCloudDialogflowV2IntentMessage: A rich response message. // Corresponds to the intent `Response` field in the Dialogflow console. -// For more information, see [Rich response -// messages](https://cloud.google.com/dialogflow/docs/intents-rich-messag -// es). +// For more information, see Rich response messages. type GoogleCloudDialogflowV2IntentMessage struct { // BasicCard: The basic card response for Actions on Google. BasicCard *GoogleCloudDialogflowV2IntentMessageBasicCard `json:"basicCard,omitempty"` @@ -7168,9 +7138,8 @@ type GoogleCloudDialogflowV2Message struct { // CreateTime: Output only. The time when the message was created. CreateTime string `json:"createTime,omitempty"` - // LanguageCode: Optional. The message language. This should be a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. - // Example: "en-US". + // LanguageCode: Optional. The message language. This should be a BCP-47 + // language tag. Example: "en-US". LanguageCode string `json:"languageCode,omitempty"` // MessageAnnotation: Output only. The annotation for the message. @@ -7264,9 +7233,7 @@ type GoogleCloudDialogflowV2OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in [E.164 - // format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition - // agents. + // with the caller ID in E.164 format for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -7344,9 +7311,8 @@ type GoogleCloudDialogflowV2QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. + // detection. See Language Support for a list of the currently supported + // language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -7534,8 +7500,7 @@ func (s *GoogleCloudDialogflowV2SentimentAnalysisResult) MarshalJSON() ([]byte, // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the [session entity -// guide](https://cloud.google.com/dialogflow/docs/entities-session). +// minutes. For more information, see the session entity guide. type GoogleCloudDialogflowV2SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -7646,9 +7611,7 @@ func (s *GoogleCloudDialogflowV2WebhookRequest) MarshalJSON() ([]byte, error) { // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// [Protocol Buffers Language -// Guide](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// Protocol Buffers Language Guide. type GoogleCloudDialogflowV2WebhookResponse struct { // FollowupEventInput: Optional. Invokes the supplied events. When this // field is set, Dialogflow ignores the `fulfillment_text`, @@ -7678,12 +7641,9 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the [Google Assistant - // integration](https://cloud.google.com/dialogflow/docs/integrations/aog - // ) for rich response messages. See the format definition at [Google - // Assistant Dialogflow webhook - // format](https://developers.google.com/assistant/actions/build/json/dia - // logflow-webhook-json) + // This field is also used by the Google Assistant integration for rich + // response messages. See the format definition at Google Assistant + // Dialogflow webhook format Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -7794,8 +7754,7 @@ func (s *GoogleCloudDialogflowV2beta1BatchUpdateIntentsResponse) MarshalJSON() ( // that intent become active. While any contexts are active, Dialogflow // is more likely to match intents that are configured with input // contexts that correspond to the currently active contexts. For more -// information about context, see the [Contexts -// guide](https://cloud.google.com/dialogflow/docs/contexts-overview). +// information about context, see the Contexts guide. type GoogleCloudDialogflowV2beta1Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -7861,8 +7820,7 @@ func (s *GoogleCloudDialogflowV2beta1Context) MarshalJSON() ([]byte, error) { // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// [Entity -// guide](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide. type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -7975,11 +7933,10 @@ func (s *GoogleCloudDialogflowV2beta1EntityTypeEntity) MarshalJSON() ([]byte, er // parameter `name` may be used by the agent in the response: "Hello // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2beta1EventInput struct { - // LanguageCode: Required. The language of this query. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // LanguageCode: Required. The language of this query. See Language + // Support for a list of the currently supported language codes. Note + // that queries in the same session do not necessarily need to specify + // the same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -8060,8 +8017,7 @@ func (s *GoogleCloudDialogflowV2beta1ExportAgentResponse) MarshalJSON() ([]byte, // referred to as an end-user expression or end-user input, Dialogflow // matches the end-user input to the best intent in your agent. Matching // an intent is also known as intent classification. For more -// information, see the [intent -// guide](https://cloud.google.com/dialogflow/docs/intents-overview). +// information, see the intent guide. type GoogleCloudDialogflowV2beta1Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -9273,9 +9229,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction) MarshalJSO // phone number but does not dial automatically. type GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial struct { // PhoneNumber: Required. The phone number to fill in the default dialer - // app. This field should be in - // [E.164](https://en.wikipedia.org/wiki/E.164) format. An example of a - // correctly formatted phone number: +15556767888. + // app. This field should be in E.164 format. An example of a correctly + // formatted phone number: +15556767888. PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -9757,8 +9712,7 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio) MarshalJSO // either be set at request-level or can come from the agent-level // synthesizer config. type GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech struct { - // Ssml: The SSML to be synthesized. For more information, see - // [SSML](https://developers.google.com/actions/reference/ssml). + // Ssml: The SSML to be synthesized. For more information, see SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -9791,8 +9745,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech) Mar // Transfers the call in Telephony Gateway. type GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall struct { // PhoneNumber: Required. The phone number to transfer the call to in - // [E.164 format](https://en.wikipedia.org/wiki/E.164). We currently - // only allow transferring to US numbers (+1xxxyyyzzzz). + // E.164 format. We currently only allow transferring to US numbers + // (+1xxxyyyzzzz). PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -10166,9 +10120,7 @@ type GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in [E.164 - // format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition - // agents. + // with the caller ID in E.164 format for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -10250,9 +10202,8 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { KnowledgeAnswers *GoogleCloudDialogflowV2beta1KnowledgeAnswers `json:"knowledgeAnswers,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. + // detection. See Language Support for a list of the currently supported + // language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -10440,8 +10391,7 @@ func (s *GoogleCloudDialogflowV2beta1SentimentAnalysisResult) MarshalJSON() ([]b // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the [session entity -// guide](https://cloud.google.com/dialogflow/docs/entities-session). +// minutes. For more information, see the session entity guide. type GoogleCloudDialogflowV2beta1SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -10562,9 +10512,7 @@ func (s *GoogleCloudDialogflowV2beta1WebhookRequest) MarshalJSON() ([]byte, erro // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// [Protocol Buffers Language -// Guide](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// Protocol Buffers Language Guide. type GoogleCloudDialogflowV2beta1WebhookResponse struct { // EndInteraction: Optional. Indicates that this intent ends an // interaction. Some integrations (e.g., Actions on Google or Dialogflow @@ -10600,12 +10548,9 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the [Google Assistant - // integration](https://cloud.google.com/dialogflow/docs/integrations/aog - // ) for rich response messages. See the format definition at [Google - // Assistant Dialogflow webhook - // format](https://developers.google.com/assistant/actions/build/json/dia - // logflow-webhook-json) + // This field is also used by the Google Assistant integration for rich + // response messages. See the format definition at Google Assistant + // Dialogflow webhook format Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -10759,11 +10704,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -11926,10 +11870,8 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Create(parent string, google // of the following fields in `entity_type`: * // `EntityType.entities.value` * `EntityType.entities.synonyms` * // `EntityType.excluded_phrases.value` If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12234,10 +12176,9 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Get(name string) *ProjectsLo // to retrieve the entity type for. The following fields are language // dependent: * `EntityType.entities.value` * // `EntityType.entities.synonyms` * `EntityType.excluded_phrases.value` -// If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12398,10 +12339,9 @@ func (r *ProjectsLocationsAgentsEntityTypesService) List(parent string) *Project // to list entity types for. The following fields are language // dependent: * `EntityType.entities.value` * // `EntityType.entities.synonyms` * `EntityType.excluded_phrases.value` -// If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsEntityTypesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12610,10 +12550,8 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Patch(nameid string, googlec // of the following fields in `entity_type`: * // `EntityType.entities.value` * `EntityType.entities.synonyms` * // `EntityType.excluded_phrases.value` If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -13735,9 +13673,8 @@ type ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall struct { // structured, actionable data as a result. This method is not // idempotent, because it may cause session entity types to be updated, // which in turn might affect results of future queries. Note: Always -// use agent versions for production traffic. See [Versions and -// environments](https://cloud.google.com/dialogflow/cx/docs/concept/vers -// ion). +// use agent versions for production traffic. See Versions and +// environments. func (r *ProjectsLocationsAgentsEnvironmentsSessionsService) DetectIntent(sessionid string, googleclouddialogflowcxv3detectintentrequest *GoogleCloudDialogflowCxV3DetectIntentRequest) *ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall { c := &ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -14954,10 +14891,9 @@ func (r *ProjectsLocationsAgentsFlowsService) Create(parent string, googlecloudd // of the following fields in `flow`: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// specified, the agent's default language is used. Many languages are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15260,10 +15196,9 @@ func (r *ProjectsLocationsAgentsFlowsService) Get(name string) *ProjectsLocation // to retrieve the flow for. The following fields are language // dependent: * `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// specified, the agent's default language is used. Many languages are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15423,10 +15358,9 @@ func (r *ProjectsLocationsAgentsFlowsService) List(parent string) *ProjectsLocat // to list flows for. The following fields are language dependent: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// specified, the agent's default language is used. Many languages are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15635,10 +15569,9 @@ func (r *ProjectsLocationsAgentsFlowsService) Patch(nameid string, googleclouddi // of the following fields in `flow`: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// specified, the agent's default language is used. Many languages are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15954,10 +15887,9 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Create(parent string, googlec // `Page.form.parameters.fill_behavior.reprompt_event_handlers.messages` // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me -// ssages` If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// ssages` If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsFlowsPagesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16264,10 +16196,9 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Get(name string) *ProjectsLoc // `Page.form.parameters.fill_behavior.reprompt_event_handlers.messages` // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me -// ssages` If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// ssages` If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsFlowsPagesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16431,10 +16362,9 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) List(parent string) *Projects // `Page.form.parameters.fill_behavior.reprompt_event_handlers.messages` // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me -// ssages` If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// ssages` If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsFlowsPagesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16647,10 +16577,9 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Patch(nameid string, googlecl // `Page.form.parameters.fill_behavior.reprompt_event_handlers.messages` // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me -// ssages` If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// ssages` If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsFlowsPagesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16819,10 +16748,8 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Create(parent // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17126,10 +17053,8 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Get(name stri // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17291,10 +17216,8 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) List(parent s // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17503,10 +17426,8 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Patch(nameid // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18582,10 +18503,8 @@ func (r *ProjectsLocationsAgentsIntentsService) Create(parent string, googleclou // LanguageCode sets the optional parameter "languageCode": The language // of the following fields in `intent`: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsIntentsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18870,10 +18789,8 @@ func (r *ProjectsLocationsAgentsIntentsService) Get(name string) *ProjectsLocati // LanguageCode sets the optional parameter "languageCode": The language // to retrieve the intent for. The following fields are language // dependent: * `Intent.training_phrases.parts.text` If not specified, -// the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// the agent's default language is used. Many languages are supported. +// Note: languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsIntentsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19046,10 +18963,8 @@ func (c *ProjectsLocationsAgentsIntentsListCall) IntentView(intentView string) * // LanguageCode sets the optional parameter "languageCode": The language // to list intents for. The following fields are language dependent: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsIntentsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19272,10 +19187,8 @@ func (r *ProjectsLocationsAgentsIntentsService) Patch(nameid string, googlecloud // LanguageCode sets the optional parameter "languageCode": The language // of the following fields in `intent`: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsIntentsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19437,9 +19350,8 @@ type ProjectsLocationsAgentsSessionsDetectIntentCall struct { // structured, actionable data as a result. This method is not // idempotent, because it may cause session entity types to be updated, // which in turn might affect results of future queries. Note: Always -// use agent versions for production traffic. See [Versions and -// environments](https://cloud.google.com/dialogflow/cx/docs/concept/vers -// ion). +// use agent versions for production traffic. See Versions and +// environments. func (r *ProjectsLocationsAgentsSessionsService) DetectIntent(sessionid string, googleclouddialogflowcxv3detectintentrequest *GoogleCloudDialogflowCxV3DetectIntentRequest) *ProjectsLocationsAgentsSessionsDetectIntentCall { c := &ProjectsLocationsAgentsSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index fdca565e698..7b6d733037e 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -795,7 +795,7 @@ type GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText struct { AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` // Ssml: The SSML text to be synthesized. For more information, see - // [SSML](/speech/text-to-speech/docs/ssml). + // SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -1196,16 +1196,13 @@ func (s *GoogleCloudDialogflowCxV3WebhookResponseFulfillmentResponse) MarshalJSO // conversation flows.. type GoogleCloudDialogflowCxV3beta1Agent struct { // AvatarUri: The URI of the agent's avatar. Avatars are used throughout - // the Dialogflow console and in the self-hosted [Web - // Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo) - // integration. + // the Dialogflow console and in the self-hosted Web Demo integration. AvatarUri string `json:"avatarUri,omitempty"` // DefaultLanguageCode: Immutable. The default language of the agent as - // a language tag. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. This field - // cannot be set by the Agents.UpdateAgent method. + // a language tag. See Language Support for a list of the currently + // supported language codes. This field cannot be set by the + // Agents.UpdateAgent method. DefaultLanguageCode string `json:"defaultLanguageCode,omitempty"` // Description: The description of the agent. The maximum length is 500 @@ -1238,9 +1235,8 @@ type GoogleCloudDialogflowCxV3beta1Agent struct { // `projects//locations//agents//flows/`. StartFlow string `json:"startFlow,omitempty"` - // TimeZone: Required. The time zone of the agent from the [time zone - // database](https://www.iana.org/time-zones), e.g., America/New_York, - // Europe/Paris. + // TimeZone: Required. The time zone of the agent from the time zone + // database, e.g., America/New_York, Europe/Paris. TimeZone string `json:"timeZone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1481,9 +1477,7 @@ func (s *GoogleCloudDialogflowCxV3beta1DtmfInput) MarshalJSON() ([]byte, error) // that are built for an individual user such as favorites, preferences, // playlists, and so on. A user entity is represented by the // SessionEntityType type. For more information about entity types, see -// the [Dialogflow -// documentation](https://cloud.google.com/dialogflow/docs/entities-overv -// iew). +// the Dialogflow documentation. type GoogleCloudDialogflowCxV3beta1EntityType struct { // AutoExpansionMode: Indicates whether the entity type can be // automatically expanded. @@ -1803,10 +1797,9 @@ func (s *GoogleCloudDialogflowCxV3beta1EventInput) MarshalJSON() ([]byte, error) // GoogleCloudDialogflowCxV3beta1ExportAgentRequest: The request message // for Agents.ExportAgent. type GoogleCloudDialogflowCxV3beta1ExportAgentRequest struct { - // AgentUri: Optional. The [Google Cloud - // Storage](https://cloud.google.com/storage/docs/) URI to export the - // agent to. The format of this URI must be `gs:///`. If left - // unspecified, the serialized agent is returned inline. + // AgentUri: Optional. The Google Cloud Storage URI to export the agent + // to. The format of this URI must be `gs:///`. If left unspecified, the + // serialized agent is returned inline. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentUri") to @@ -2275,9 +2268,8 @@ type GoogleCloudDialogflowCxV3beta1FulfillmentConditionalCasesCase struct { // Condition: The condition to activate and select this case. Empty // means the condition is always true. The condition is evaluated - // against form parameters or session parameters. See the [conditions - // reference](https://cloud.google.com/dialogflow/cx/docs/reference/condi - // tion). + // against form parameters or session parameters. See the conditions + // reference. Condition string `json:"condition,omitempty"` // ForceSendFields is a list of field names (e.g. "CaseContent") to @@ -2425,10 +2417,8 @@ type GoogleCloudDialogflowCxV3beta1InputAudioConfig struct { // on the parameters in the InputAudioConfig. If enhanced speech model // is enabled for the agent and an enhanced version of the specified // model for the language does not exist, then the speech is recognized - // using the standard version of the specified model. Refer to [Cloud - // Speech API - // documentation](https://cloud.google.com/speech-to-text/docs/basics#sel - // ect-model) for more details. + // using the standard version of the specified model. Refer to Cloud + // Speech API documentation for more details. Model string `json:"model,omitempty"` // ModelVariant: Optional. Which variant of the Speech model to use. @@ -2457,15 +2447,11 @@ type GoogleCloudDialogflowCxV3beta1InputAudioConfig struct { // PhraseHints: Optional. A list of strings containing words and phrases // that the speech recognizer should recognize with higher likelihood. - // See [the Cloud Speech - // documentation](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) for more details. + // See the Cloud Speech documentation for more details. PhraseHints []string `json:"phraseHints,omitempty"` // SampleRateHertz: Sample rate (in Hertz) of the audio content sent in - // the query. Refer to [Cloud Speech API - // documentation](https://cloud.google.com/speech-to-text/docs/basics) - // for more details. + // the query. Refer to Cloud Speech API documentation for more details. SampleRateHertz int64 `json:"sampleRateHertz,omitempty"` // SingleUtterance: Optional. If `false` (default), recognition does not @@ -3551,8 +3537,7 @@ func (s *GoogleCloudDialogflowCxV3beta1OutputAudioConfig) MarshalJSON() ([]byte, // the same or transition to another page. You configure each page to // collect information from the end-user that is relevant for the // conversational state represented by the page. For more information, -// see the [Page -// guide](https://cloud.google.com/dialogflow/cx/docs/concept/page). +// see the Page guide. type GoogleCloudDialogflowCxV3beta1Page struct { // DisplayName: Required. The human-readable name of the page, unique // within the agent. @@ -3769,11 +3754,10 @@ type GoogleCloudDialogflowCxV3beta1QueryInput struct { // Intent: The intent to be triggered. Intent *GoogleCloudDialogflowCxV3beta1IntentInput `json:"intent,omitempty"` - // LanguageCode: Required. The language of the input. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // LanguageCode: Required. The language of the input. See Language + // Support for a list of the currently supported language codes. Note + // that queries in the same session do not necessarily need to specify + // the same language. LanguageCode string `json:"languageCode,omitempty"` // Text: The natural language text to be processed. @@ -3835,10 +3819,9 @@ type GoogleCloudDialogflowCxV3beta1QueryParameters struct { // languages and persist for the session of this query. SessionEntityTypes []*GoogleCloudDialogflowCxV3beta1SessionEntityType `json:"sessionEntityTypes,omitempty"` - // TimeZone: The time zone of this conversational query from the [time - // zone database](https://www.iana.org/time-zones), e.g., - // America/New_York, Europe/Paris. If not provided, the time zone - // specified in the agent is used. + // TimeZone: The time zone of this conversational query from the time + // zone database, e.g., America/New_York, Europe/Paris. If not provided, + // the time zone specified in the agent is used. TimeZone string `json:"timeZone,omitempty"` // WebhookHeaders: This field can be used to pass HTTP headers for a @@ -3905,9 +3888,8 @@ type GoogleCloudDialogflowCxV3beta1QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. + // detection. See Language Support for a list of the currently supported + // language codes. LanguageCode string `json:"languageCode,omitempty"` // Match: Intent match result, could be an intent or an event. @@ -4240,7 +4222,7 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText struct { AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` // Ssml: The SSML text to be synthesized. For more information, see - // [SSML](/speech/text-to-speech/docs/ssml). + // SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -4351,9 +4333,8 @@ type GoogleCloudDialogflowCxV3beta1RestoreAgentRequest struct { // AgentContent: Uncompressed raw byte content for agent. AgentContent string `json:"agentContent,omitempty"` - // AgentUri: The [Google Cloud - // Storage](https://cloud.google.com/storage/docs/) URI to restore agent - // from. The format of this URI must be `gs:///`. + // AgentUri: The Google Cloud Storage URI to restore agent from. The + // format of this URI must be `gs:///`. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -4521,9 +4502,7 @@ func (s *GoogleCloudDialogflowCxV3beta1SentimentAnalysisResult) UnmarshalJSON(da // session level (we refer to the entity types defined at the agent // level as "custom entity types"). Note: session entity types apply to // all queries, regardless of the language. For more information about -// entity types, see the [Dialogflow -// documentation](https://cloud.google.com/dialogflow/docs/entities-overv -// iew). +// entity types, see the Dialogflow documentation. type GoogleCloudDialogflowCxV3beta1SessionEntityType struct { // Entities: Required. The collection of entities to override or // supplement the custom entity type. @@ -4777,11 +4756,10 @@ type GoogleCloudDialogflowCxV3beta1TrainFlowRequest struct { // transition into the specified flow. type GoogleCloudDialogflowCxV3beta1TransitionRoute struct { // Condition: The condition to evaluate against form parameters or - // session parameters. See the [conditions - // reference](https://cloud.google.com/dialogflow/cx/docs/reference/condi - // tion). At least one of `intent` or `condition` must be specified. - // When both `intent` and `condition` are specified, the transition can - // only happen when both are fulfilled. + // session parameters. See the conditions reference. At least one of + // `intent` or `condition` must be specified. When both `intent` and + // `condition` are specified, the transition can only happen when both + // are fulfilled. Condition string `json:"condition,omitempty"` // Intent: The unique identifier of an Intent. Format: @@ -5335,15 +5313,13 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse) Marsh // or purely a part of the message between two entities or message // start/end. type GoogleCloudDialogflowV2AnnotatedMessagePart struct { - // EntityType: The [Dialogflow system entity - // type](https://cloud.google.com/dialogflow/docs/reference/system-entiti - // es) of this message part. If this is empty, Dialogflow could not - // annotate the phrase part with a system entity. + // EntityType: The Dialogflow system entity type of this message part. + // If this is empty, Dialogflow could not annotate the phrase part with + // a system entity. EntityType string `json:"entityType,omitempty"` - // FormattedValue: The [Dialogflow system entity formatted value - // ](https://cloud.google.com/dialogflow/docs/reference/system-entities) - // of this message part. For example for a system entity of type + // FormattedValue: The Dialogflow system entity formatted value of this + // message part. For example for a system entity of type // `@sys.unit-currency`, this may contain: { "amount": 5, "currency": // "USD" } FormattedValue interface{} `json:"formattedValue,omitempty"` @@ -5444,8 +5420,7 @@ func (s *GoogleCloudDialogflowV2BatchUpdateIntentsResponse) MarshalJSON() ([]byt // active. While any contexts are active, Dialogflow is more likely to // match intents that are configured with input contexts that correspond // to the currently active contexts. For more information about context, -// see the [Contexts -// guide](https://cloud.google.com/dialogflow/docs/contexts-overview). +// see the Contexts guide. type GoogleCloudDialogflowV2Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -5569,8 +5544,7 @@ func (s *GoogleCloudDialogflowV2ConversationEvent) MarshalJSON() ([]byte, error) // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// [Entity -// guide](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide. type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -5682,11 +5656,10 @@ func (s *GoogleCloudDialogflowV2EntityTypeEntity) MarshalJSON() ([]byte, error) // `name` may be used by the agent in the response: "Hello // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2EventInput struct { - // LanguageCode: Required. The language of this query. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // LanguageCode: Required. The language of this query. See Language + // Support for a list of the currently supported language codes. Note + // that queries in the same session do not necessarily need to specify + // the same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -5767,8 +5740,7 @@ func (s *GoogleCloudDialogflowV2ExportAgentResponse) MarshalJSON() ([]byte, erro // as an end-user expression or end-user input, Dialogflow matches the // end-user input to the best intent in your agent. Matching an intent // is also known as intent classification. For more information, see the -// [intent -// guide](https://cloud.google.com/dialogflow/docs/intents-overview). +// intent guide. type GoogleCloudDialogflowV2Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -5943,9 +5915,7 @@ func (s *GoogleCloudDialogflowV2IntentFollowupIntentInfo) MarshalJSON() ([]byte, // GoogleCloudDialogflowV2IntentMessage: A rich response message. // Corresponds to the intent `Response` field in the Dialogflow console. -// For more information, see [Rich response -// messages](https://cloud.google.com/dialogflow/docs/intents-rich-messag -// es). +// For more information, see Rich response messages. type GoogleCloudDialogflowV2IntentMessage struct { // BasicCard: The basic card response for Actions on Google. BasicCard *GoogleCloudDialogflowV2IntentMessageBasicCard `json:"basicCard,omitempty"` @@ -7174,9 +7144,8 @@ type GoogleCloudDialogflowV2Message struct { // CreateTime: Output only. The time when the message was created. CreateTime string `json:"createTime,omitempty"` - // LanguageCode: Optional. The message language. This should be a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. - // Example: "en-US". + // LanguageCode: Optional. The message language. This should be a BCP-47 + // language tag. Example: "en-US". LanguageCode string `json:"languageCode,omitempty"` // MessageAnnotation: Output only. The annotation for the message. @@ -7270,9 +7239,7 @@ type GoogleCloudDialogflowV2OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in [E.164 - // format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition - // agents. + // with the caller ID in E.164 format for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -7350,9 +7317,8 @@ type GoogleCloudDialogflowV2QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. + // detection. See Language Support for a list of the currently supported + // language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -7540,8 +7506,7 @@ func (s *GoogleCloudDialogflowV2SentimentAnalysisResult) MarshalJSON() ([]byte, // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the [session entity -// guide](https://cloud.google.com/dialogflow/docs/entities-session). +// minutes. For more information, see the session entity guide. type GoogleCloudDialogflowV2SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -7652,9 +7617,7 @@ func (s *GoogleCloudDialogflowV2WebhookRequest) MarshalJSON() ([]byte, error) { // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// [Protocol Buffers Language -// Guide](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// Protocol Buffers Language Guide. type GoogleCloudDialogflowV2WebhookResponse struct { // FollowupEventInput: Optional. Invokes the supplied events. When this // field is set, Dialogflow ignores the `fulfillment_text`, @@ -7684,12 +7647,9 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the [Google Assistant - // integration](https://cloud.google.com/dialogflow/docs/integrations/aog - // ) for rich response messages. See the format definition at [Google - // Assistant Dialogflow webhook - // format](https://developers.google.com/assistant/actions/build/json/dia - // logflow-webhook-json) + // This field is also used by the Google Assistant integration for rich + // response messages. See the format definition at Google Assistant + // Dialogflow webhook format Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -7800,8 +7760,7 @@ func (s *GoogleCloudDialogflowV2beta1BatchUpdateIntentsResponse) MarshalJSON() ( // that intent become active. While any contexts are active, Dialogflow // is more likely to match intents that are configured with input // contexts that correspond to the currently active contexts. For more -// information about context, see the [Contexts -// guide](https://cloud.google.com/dialogflow/docs/contexts-overview). +// information about context, see the Contexts guide. type GoogleCloudDialogflowV2beta1Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -7867,8 +7826,7 @@ func (s *GoogleCloudDialogflowV2beta1Context) MarshalJSON() ([]byte, error) { // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// [Entity -// guide](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide. type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -7981,11 +7939,10 @@ func (s *GoogleCloudDialogflowV2beta1EntityTypeEntity) MarshalJSON() ([]byte, er // parameter `name` may be used by the agent in the response: "Hello // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2beta1EventInput struct { - // LanguageCode: Required. The language of this query. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that - // queries in the same session do not necessarily need to specify the - // same language. + // LanguageCode: Required. The language of this query. See Language + // Support for a list of the currently supported language codes. Note + // that queries in the same session do not necessarily need to specify + // the same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -8066,8 +8023,7 @@ func (s *GoogleCloudDialogflowV2beta1ExportAgentResponse) MarshalJSON() ([]byte, // referred to as an end-user expression or end-user input, Dialogflow // matches the end-user input to the best intent in your agent. Matching // an intent is also known as intent classification. For more -// information, see the [intent -// guide](https://cloud.google.com/dialogflow/docs/intents-overview). +// information, see the intent guide. type GoogleCloudDialogflowV2beta1Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -9279,9 +9235,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction) MarshalJSO // phone number but does not dial automatically. type GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial struct { // PhoneNumber: Required. The phone number to fill in the default dialer - // app. This field should be in - // [E.164](https://en.wikipedia.org/wiki/E.164) format. An example of a - // correctly formatted phone number: +15556767888. + // app. This field should be in E.164 format. An example of a correctly + // formatted phone number: +15556767888. PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -9763,8 +9718,7 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio) MarshalJSO // either be set at request-level or can come from the agent-level // synthesizer config. type GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech struct { - // Ssml: The SSML to be synthesized. For more information, see - // [SSML](https://developers.google.com/actions/reference/ssml). + // Ssml: The SSML to be synthesized. For more information, see SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -9797,8 +9751,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech) Mar // Transfers the call in Telephony Gateway. type GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall struct { // PhoneNumber: Required. The phone number to transfer the call to in - // [E.164 format](https://en.wikipedia.org/wiki/E.164). We currently - // only allow transferring to US numbers (+1xxxyyyzzzz). + // E.164 format. We currently only allow transferring to US numbers + // (+1xxxyyyzzzz). PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -10172,9 +10126,7 @@ type GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in [E.164 - // format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition - // agents. + // with the caller ID in E.164 format for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -10256,9 +10208,8 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { KnowledgeAnswers *GoogleCloudDialogflowV2beta1KnowledgeAnswers `json:"knowledgeAnswers,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. + // detection. See Language Support for a list of the currently supported + // language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -10446,8 +10397,7 @@ func (s *GoogleCloudDialogflowV2beta1SentimentAnalysisResult) MarshalJSON() ([]b // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the [session entity -// guide](https://cloud.google.com/dialogflow/docs/entities-session). +// minutes. For more information, see the session entity guide. type GoogleCloudDialogflowV2beta1SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -10568,9 +10518,7 @@ func (s *GoogleCloudDialogflowV2beta1WebhookRequest) MarshalJSON() ([]byte, erro // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// [Protocol Buffers Language -// Guide](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// Protocol Buffers Language Guide. type GoogleCloudDialogflowV2beta1WebhookResponse struct { // EndInteraction: Optional. Indicates that this intent ends an // interaction. Some integrations (e.g., Actions on Google or Dialogflow @@ -10606,12 +10554,9 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the [Google Assistant - // integration](https://cloud.google.com/dialogflow/docs/integrations/aog - // ) for rich response messages. See the format definition at [Google - // Assistant Dialogflow webhook - // format](https://developers.google.com/assistant/actions/build/json/dia - // logflow-webhook-json) + // This field is also used by the Google Assistant integration for rich + // response messages. See the format definition at Google Assistant + // Dialogflow webhook format Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -10765,11 +10710,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -11935,10 +11879,8 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Create(parent string, google // of the following fields in `entity_type`: * // `EntityType.entities.value` * `EntityType.entities.synonyms` * // `EntityType.excluded_phrases.value` If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12244,10 +12186,9 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Get(name string) *ProjectsLo // to retrieve the entity type for. The following fields are language // dependent: * `EntityType.entities.value` * // `EntityType.entities.synonyms` * `EntityType.excluded_phrases.value` -// If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12409,10 +12350,9 @@ func (r *ProjectsLocationsAgentsEntityTypesService) List(parent string) *Project // to list entity types for. The following fields are language // dependent: * `EntityType.entities.value` * // `EntityType.entities.synonyms` * `EntityType.excluded_phrases.value` -// If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsEntityTypesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12621,10 +12561,8 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Patch(nameid string, googlec // of the following fields in `entity_type`: * // `EntityType.entities.value` * `EntityType.entities.synonyms` * // `EntityType.excluded_phrases.value` If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -13749,9 +13687,8 @@ type ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall struct { // structured, actionable data as a result. This method is not // idempotent, because it may cause session entity types to be updated, // which in turn might affect results of future queries. Note: Always -// use agent versions for production traffic. See [Versions and -// environments](https://cloud.google.com/dialogflow/cx/docs/concept/vers -// ion). +// use agent versions for production traffic. See Versions and +// environments. func (r *ProjectsLocationsAgentsEnvironmentsSessionsService) DetectIntent(sessionid string, googleclouddialogflowcxv3beta1detectintentrequest *GoogleCloudDialogflowCxV3beta1DetectIntentRequest) *ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall { c := &ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -14968,10 +14905,9 @@ func (r *ProjectsLocationsAgentsFlowsService) Create(parent string, googlecloudd // of the following fields in `flow`: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// specified, the agent's default language is used. Many languages are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15275,10 +15211,9 @@ func (r *ProjectsLocationsAgentsFlowsService) Get(name string) *ProjectsLocation // to retrieve the flow for. The following fields are language // dependent: * `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// specified, the agent's default language is used. Many languages are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15439,10 +15374,9 @@ func (r *ProjectsLocationsAgentsFlowsService) List(parent string) *ProjectsLocat // to list flows for. The following fields are language dependent: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// specified, the agent's default language is used. Many languages are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15651,10 +15585,9 @@ func (r *ProjectsLocationsAgentsFlowsService) Patch(nameid string, googleclouddi // of the following fields in `flow`: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// specified, the agent's default language is used. Many languages are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15971,10 +15904,9 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Create(parent string, googlec // `Page.form.parameters.fill_behavior.reprompt_event_handlers.messages` // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me -// ssages` If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// ssages` If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsFlowsPagesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16282,10 +16214,9 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Get(name string) *ProjectsLoc // `Page.form.parameters.fill_behavior.reprompt_event_handlers.messages` // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me -// ssages` If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// ssages` If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsFlowsPagesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16450,10 +16381,9 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) List(parent string) *Projects // `Page.form.parameters.fill_behavior.reprompt_event_handlers.messages` // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me -// ssages` If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// ssages` If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsFlowsPagesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16666,10 +16596,9 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Patch(nameid string, googlecl // `Page.form.parameters.fill_behavior.reprompt_event_handlers.messages` // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me -// ssages` If not specified, the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// ssages` If not specified, the agent's default language is used. Many +// languages are supported. Note: languages must be enabled in the agent +// before they can be used. func (c *ProjectsLocationsAgentsFlowsPagesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16839,10 +16768,8 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Create(parent // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17146,10 +17073,8 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Get(name stri // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17311,10 +17236,8 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) List(parent s // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17523,10 +17446,8 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Patch(nameid // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18604,10 +18525,8 @@ func (r *ProjectsLocationsAgentsIntentsService) Create(parent string, googleclou // LanguageCode sets the optional parameter "languageCode": The language // of the following fields in `intent`: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsIntentsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18893,10 +18812,8 @@ func (r *ProjectsLocationsAgentsIntentsService) Get(name string) *ProjectsLocati // LanguageCode sets the optional parameter "languageCode": The language // to retrieve the intent for. The following fields are language // dependent: * `Intent.training_phrases.parts.text` If not specified, -// the agent's default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// the agent's default language is used. Many languages are supported. +// Note: languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsIntentsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19070,10 +18987,8 @@ func (c *ProjectsLocationsAgentsIntentsListCall) IntentView(intentView string) * // LanguageCode sets the optional parameter "languageCode": The language // to list intents for. The following fields are language dependent: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsIntentsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19296,10 +19211,8 @@ func (r *ProjectsLocationsAgentsIntentsService) Patch(nameid string, googlecloud // LanguageCode sets the optional parameter "languageCode": The language // of the following fields in `intent`: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. [Many -// languages](https://cloud.google.com/dialogflow/docs/reference/language -// ) are supported. Note: languages must be enabled in the agent before -// they can be used. +// default language is used. Many languages are supported. Note: +// languages must be enabled in the agent before they can be used. func (c *ProjectsLocationsAgentsIntentsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19462,9 +19375,8 @@ type ProjectsLocationsAgentsSessionsDetectIntentCall struct { // structured, actionable data as a result. This method is not // idempotent, because it may cause session entity types to be updated, // which in turn might affect results of future queries. Note: Always -// use agent versions for production traffic. See [Versions and -// environments](https://cloud.google.com/dialogflow/cx/docs/concept/vers -// ion). +// use agent versions for production traffic. See Versions and +// environments. func (r *ProjectsLocationsAgentsSessionsService) DetectIntent(sessionid string, googleclouddialogflowcxv3beta1detectintentrequest *GoogleCloudDialogflowCxV3beta1DetectIntentRequest) *ProjectsLocationsAgentsSessionsDetectIntentCall { c := &ProjectsLocationsAgentsSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid diff --git a/digitalassetlinks/v1/digitalassetlinks-gen.go b/digitalassetlinks/v1/digitalassetlinks-gen.go index cd728b38ec5..2ee7b360f15 100644 --- a/digitalassetlinks/v1/digitalassetlinks-gen.go +++ b/digitalassetlinks/v1/digitalassetlinks-gen.go @@ -405,8 +405,7 @@ func (s *ListResponse) MarshalJSON() ([]byte, error) { // Statements are always made by the source asset, either directly or by // delegating to a statement list that is stored elsewhere. For more // detailed definitions of statements and assets, please refer to our -// [API documentation landing -// page](/digital-asset-links/v1/getting-started). +// API documentation landing page. type Statement struct { // Relation: The relation identifies the use of the statement as // intended by the source asset's owner (that is, the person or entity @@ -414,8 +413,7 @@ type Statement struct { // We identify relations with strings of the format `/`, where `` must // be one of a set of pre-defined purpose categories, and `` is a // free-form lowercase alphanumeric string that describes the specific - // use case of the statement. Refer to [our API - // documentation](/digital-asset-links/v1/relation-strings) for the + // use case of the statement. Refer to our API documentation for the // current list of supported relations. Example: // `delegate_permission/common.handle_all_urls` REQUIRED Relation string `json:"relation,omitempty"` @@ -520,9 +518,8 @@ type AssetlinksCheckCall struct { // the URL starts with `http://` instead of `https://`), the API cannot // verify its statements securely, and it is not possible to ensure that // the website's statements have not been altered by a third party. For -// more information, see the [Digital Asset Links technical design -// specification](https://github.com/google/digitalassetlinks/blob/master -// /well-known/details.md). +// more information, see the Digital Asset Links technical design +// specification. func (r *AssetlinksService) Check() *AssetlinksCheckCall { c := &AssetlinksCheckCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -532,8 +529,7 @@ func (r *AssetlinksService) Check() *AssetlinksCheckCall { // relation. We identify relations with strings of the format `/`, where // `` must be one of a set of pre-defined purpose categories, and `` is // a free-form lowercase alphanumeric string that describes the specific -// use case of the statement. Refer to [our API -// documentation](/digital-asset-links/v1/relation-strings) for the +// use case of the statement. Refer to our API documentation for the // current list of supported relations. For a query to match an asset // link, both the query's and the asset link's relation strings must // match exactly. Example: A query with relation @@ -812,31 +808,30 @@ type StatementsListCall struct { // match the specified target and statement string. The API guarantees // that all statements with secure source assets, such as HTTPS websites // or Android apps, have been made in a secure way by the owner of those -// assets, as described in the [Digital Asset Links technical design -// specification](https://github.com/google/digitalassetlinks/blob/master -// /well-known/details.md). Specifically, you should consider that for -// insecure websites (that is, where the URL starts with `http://` -// instead of `https://`), this guarantee cannot be made. The `List` -// command is most useful in cases where the API client wants to know -// all the ways in which two assets are related, or enumerate all the -// relationships from a particular source asset. Example: a feature that -// helps users navigate to related items. When a mobile app is running -// on a device, the feature would make it easy to navigate to the -// corresponding web site or Google+ profile. +// assets, as described in the Digital Asset Links technical design +// specification. Specifically, you should consider that for insecure +// websites (that is, where the URL starts with `http://` instead of +// `https://`), this guarantee cannot be made. The `List` command is +// most useful in cases where the API client wants to know all the ways +// in which two assets are related, or enumerate all the relationships +// from a particular source asset. Example: a feature that helps users +// navigate to related items. When a mobile app is running on a device, +// the feature would make it easy to navigate to the corresponding web +// site or Google+ profile. func (r *StatementsService) List() *StatementsListCall { c := &StatementsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c } // Relation sets the optional parameter "relation": Use only -// associations that match the specified relation. See the -// [`Statement`](#Statement) message for a detailed definition of -// relation strings. For a query to match a statement, one of the -// following must be true: * both the query's and the statement's -// relation strings match exactly, or * the query's relation string is -// empty or missing. Example: A query with relation -// `delegate_permission/common.handle_all_urls` matches an asset link -// with relation `delegate_permission/common.handle_all_urls`. +// associations that match the specified relation. See the `Statement` +// message for a detailed definition of relation strings. For a query to +// match a statement, one of the following must be true: * both the +// query's and the statement's relation strings match exactly, or * the +// query's relation string is empty or missing. Example: A query with +// relation `delegate_permission/common.handle_all_urls` matches an +// asset link with relation +// `delegate_permission/common.handle_all_urls`. func (c *StatementsListCall) Relation(relation string) *StatementsListCall { c.urlParams_.Set("relation", relation) return c diff --git a/displayvideo/v1/displayvideo-gen.go b/displayvideo/v1/displayvideo-gen.go index 65774ab5cbb..493d2c05173 100644 --- a/displayvideo/v1/displayvideo-gen.go +++ b/displayvideo/v1/displayvideo-gen.go @@ -3403,10 +3403,8 @@ func (s *Channel) MarshalJSON() ([]byte, error) { // `TARGETING_TYPE_CHANNEL`. type ChannelAssignedTargetingOptionDetails struct { // ChannelId: Required. ID of the channel. Should refer to the channel - // ID field on a [Partner-owned - // channel](partners.channels#Channel.FIELDS.channel_id) or - // [advertiser-owned - // channel](advertisers.channels#Channel.FIELDS.channel_id) resource. + // ID field on a Partner-owned channel or advertiser-owned channel + // resource. ChannelId int64 `json:"channelId,omitempty,string"` // Negative: Indicates if this option is being negatively targeted. For @@ -8440,10 +8438,9 @@ type LineItem struct { // the line item. PartnerRevenueModel *PartnerRevenueModel `json:"partnerRevenueModel,omitempty"` - // TargetingExpansion: The [targeting - // expansion](https://support.google.com/displayvideo/answer/10191558) - // settings of the line item. This config is only applicable when - // eligible audience list targeting is assigned to the line item. + // TargetingExpansion: The targeting expansion settings of the line + // item. This config is only applicable when eligible audience list + // targeting is assigned to the line item. TargetingExpansion *TargetingExpansionConfig `json:"targetingExpansion,omitempty"` // UpdateTime: Output only. The timestamp when the line item was last @@ -11792,11 +11789,10 @@ func (s *Site) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index d7ccf8e76b3..b21ef06219b 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -1359,9 +1359,8 @@ type GooglePrivacyDlpV2CloudStorageRegexFileSet struct { // ExcludeRegex: A list of regular expressions matching file paths to // exclude. All files in the bucket that match at least one of these // regular expressions will be excluded from the scan. Regular - // expressions use RE2 - // [syntax](https://github.com/google/re2/wiki/Syntax); a guide can be - // found under the google/re2 repository on GitHub. + // expressions use RE2 syntax; a guide can be found under the google/re2 + // repository on GitHub. ExcludeRegex []string `json:"excludeRegex,omitempty"` // IncludeRegex: A list of regular expressions matching file paths to @@ -1369,9 +1368,8 @@ type GooglePrivacyDlpV2CloudStorageRegexFileSet struct { // regular expressions will be included in the set of files, except for // those that also match an item in `exclude_regex`. Leaving this field // empty will match all files by default (this is equivalent to - // including `.*` in the list). Regular expressions use RE2 - // [syntax](https://github.com/google/re2/wiki/Syntax); a guide can be - // found under the google/re2 repository on GitHub. + // including `.*` in the list). Regular expressions use RE2 syntax; a + // guide can be found under the google/re2 repository on GitHub. IncludeRegex []string `json:"includeRegex,omitempty"` // ForceSendFields is a list of field names (e.g. "BucketName") to @@ -2105,20 +2103,18 @@ type GooglePrivacyDlpV2CryptoReplaceFfxFpeConfig struct { // example, if the name of custom infoType is 'MY_TOKEN_INFO_TYPE' and // the surrogate is 'abc', the full replacement value will be: // 'MY_TOKEN_INFO_TYPE(3):abc' This annotation identifies the surrogate - // when inspecting content using the custom infoType - // [`SurrogateType`](https://cloud.google.com/dlp/docs/reference/rest/v2/ - // InspectConfig#surrogatetype). This facilitates reversal of the - // surrogate when it occurs in free text. In order for inspection to - // work properly, the name of this infoType must not occur naturally - // anywhere in your data; otherwise, inspection may find a surrogate - // that does not correspond to an actual identifier. Therefore, choose - // your custom infoType name carefully after considering what your data - // looks like. One way to select a name that has a high chance of - // yielding reliable detection is to include one or more unicode - // characters that are highly improbable to exist in your data. For - // example, assuming your data is entered from a regular ASCII keyboard, - // the symbol with the hex code point 29DD might be used like so: - // ⧝MY_TOKEN_TYPE + // when inspecting content using the custom infoType `SurrogateType`. + // This facilitates reversal of the surrogate when it occurs in free + // text. In order for inspection to work properly, the name of this + // infoType must not occur naturally anywhere in your data; otherwise, + // inspection may find a surrogate that does not correspond to an actual + // identifier. Therefore, choose your custom infoType name carefully + // after considering what your data looks like. One way to select a name + // that has a high chance of yielding reliable detection is to include + // one or more unicode characters that are highly improbable to exist in + // your data. For example, assuming your data is entered from a regular + // ASCII keyboard, the symbol with the hex code point 29DD might be used + // like so: ⧝MY_TOKEN_TYPE SurrogateInfoType *GooglePrivacyDlpV2InfoType `json:"surrogateInfoType,omitempty"` // ForceSendFields is a list of field names (e.g. "CommonAlphabet") to @@ -2816,23 +2812,21 @@ func (s *GooglePrivacyDlpV2DetectionRule) MarshalJSON() ([]byte, error) { // dictionary of words or phrases. This can be used to match sensitive // information specific to the data, such as a list of employee IDs or // job titles. Dictionary words are case-insensitive and all characters -// other than letters and digits in the unicode [Basic Multilingual -// Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multili -// ngual_Plane) will be replaced with whitespace when scanning for -// matches, so the dictionary phrase "Sam Johnson" will match all three -// phrases "sam johnson", "Sam, Johnson", and "Sam (Johnson)". -// Additionally, the characters surrounding any match must be of a -// different type than the adjacent characters within the word, so -// letters must be next to non-letters and digits next to non-digits. -// For example, the dictionary word "jen" will match the first three -// letters of the text "jen123" but will return no matches for -// "jennifer". Dictionary words containing a large number of characters -// that are not letters or digits may result in unexpected findings -// because such characters are treated as whitespace. The -// [limits](https://cloud.google.com/dlp/limits) page contains details -// about the size limits of dictionaries. For dictionaries that do not -// fit within these constraints, consider using -// `LargeCustomDictionaryConfig` in the `StoredInfoType` API. +// other than letters and digits in the unicode Basic Multilingual Plane +// will be replaced with whitespace when scanning for matches, so the +// dictionary phrase "Sam Johnson" will match all three phrases "sam +// johnson", "Sam, Johnson", and "Sam (Johnson)". Additionally, the +// characters surrounding any match must be of a different type than the +// adjacent characters within the word, so letters must be next to +// non-letters and digits next to non-digits. For example, the +// dictionary word "jen" will match the first three letters of the text +// "jen123" but will return no matches for "jennifer". Dictionary words +// containing a large number of characters that are not letters or +// digits may result in unexpected findings because such characters are +// treated as whitespace. The limits page contains details about the +// size limits of dictionaries. For dictionaries that do not fit within +// these constraints, consider using `LargeCustomDictionaryConfig` in +// the `StoredInfoType` API. type GooglePrivacyDlpV2Dictionary struct { // CloudStoragePath: Newline-delimited file of words in Cloud Storage. // Only a single file is accepted. @@ -3305,10 +3299,10 @@ type GooglePrivacyDlpV2Finding struct { // Labels: The labels associated with this `Finding`. Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`. Label values must - // be between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than 10 labels - // can be associated with a given finding. Examples: * "environment" : + // regular expression: `a-z?`. Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than 10 labels can be + // associated with a given finding. Examples: * "environment" : // "production" * "pipeline" : "etl" Labels map[string]string `json:"labels,omitempty"` @@ -3585,12 +3579,11 @@ type GooglePrivacyDlpV2HybridFindingDetails struct { // being inspected. If configured by the job, some key values may be // required. The labels associated with `Finding`'s produced by hybrid // inspection. Label keys must be between 1 and 63 characters long and - // must conform to the following regular expression: - // `[a-z]([-a-z0-9]*[a-z0-9])?`. Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than 10 labels can be - // associated with a given finding. Examples: * "environment" : - // "production" * "pipeline" : "etl" + // must conform to the following regular expression: `a-z?`. Label + // values must be between 0 and 63 characters long and must conform to + // the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than + // 10 labels can be associated with a given finding. Examples: * + // "environment" : "production" * "pipeline" : "etl" Labels map[string]string `json:"labels,omitempty"` // RowOffset: Offset of the row for tables. Populate if the row(s) being @@ -3747,12 +3740,11 @@ type GooglePrivacyDlpV2HybridOptions struct { // Labels: To organize findings, these labels will be added to each // finding. Label keys must be between 1 and 63 characters long and must - // conform to the following regular expression: - // `[a-z]([-a-z0-9]*[a-z0-9])?`. Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than 10 labels can be - // associated with a given finding. Examples: * "environment" : - // "production" * "pipeline" : "etl" + // conform to the following regular expression: `a-z?`. Label values + // must be between 0 and 63 characters long and must conform to the + // regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than 10 + // labels can be associated with a given finding. Examples: * + // "environment" : "production" * "pipeline" : "etl" Labels map[string]string `json:"labels,omitempty"` // RequiredFindingLabelKeys: These are labels that each inspection @@ -5137,11 +5129,10 @@ func (s *GooglePrivacyDlpV2LDiversityResult) MarshalJSON() ([]byte, error) { // GooglePrivacyDlpV2LargeCustomDictionaryConfig: Configuration for a // custom dictionary created from a data source of any size up to the -// maximum size defined in the -// [limits](https://cloud.google.com/dlp/limits) page. The artifacts of -// dictionary creation are stored in the specified Google Cloud Storage -// location. Consider using `CustomInfoType.Dictionary` for smaller -// dictionaries that satisfy the size requirements. +// maximum size defined in the limits page. The artifacts of dictionary +// creation are stored in the specified Google Cloud Storage location. +// Consider using `CustomInfoType.Dictionary` for smaller dictionaries +// that satisfy the size requirements. type GooglePrivacyDlpV2LargeCustomDictionaryConfig struct { // BigQueryField: Field in a BigQuery table where each cell represents a // dictionary phrase. @@ -5950,8 +5941,7 @@ type GooglePrivacyDlpV2PublishSummaryToCscc struct { // GooglePrivacyDlpV2PublishToPubSub: Publish a message into given // Pub/Sub topic when DlpJob has completed. The message contains a // single field, `DlpJobName`, which is equal to the finished job's -// [`DlpJob.name`](https://cloud.google.com/dlp/docs/reference/rest/v2/pr -// ojects.dlpJobs#DlpJob). Compatible with: Inspect, Risk +// `DlpJob.name`. Compatible with: Inspect, Risk type GooglePrivacyDlpV2PublishToPubSub struct { // Topic: Cloud Pub/Sub topic to send notifications to. The topic must // have given publishing access rights to the DLP API service account @@ -7202,10 +7192,8 @@ func (s *GooglePrivacyDlpV2SummaryResult) MarshalJSON() ([]byte, error) { } // GooglePrivacyDlpV2SurrogateType: Message for detecting output from -// deidentification transformations such as -// [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/refere -// nce/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfi -// g). These types of transformations are those that perform +// deidentification transformations such as `CryptoReplaceFfxFpeConfig`. +// These types of transformations are those that perform // pseudonymization, thereby producing a "surrogate" as output. This // should be used in conjunction with a field on the transformation such // as `surrogate_info_type`. This CustomInfoType does not support the @@ -8005,11 +7993,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/docs/v1/docs-gen.go b/docs/v1/docs-gen.go index a9f60ace9c2..89cb45dde7c 100644 --- a/docs/v1/docs-gen.go +++ b/docs/v1/docs-gen.go @@ -6876,19 +6876,17 @@ type WeightedFontFamily struct { // Weight: The weight of the font. This field can have any value that is // a multiple of `100` between `100` and `900`, inclusive. This range // corresponds to the numerical values described in the CSS 2.1 - // Specification, [section - // 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with - // non-numerical values disallowed. The default value is `400` - // ("normal"). The font weight makes up just one component of the - // rendered font weight. The rendered weight is determined by a - // combination of the `weight` and the text style's resolved `bold` - // value, after accounting for inheritance: * If the text is bold and - // the weight is less than `400`, the rendered weight is 400. * If the - // text is bold and the weight is greater than or equal to `400` but is - // less than `700`, the rendered weight is `700`. * If the weight is - // greater than or equal to `700`, the rendered weight is equal to the - // weight. * If the text is not bold, the rendered weight is equal to - // the weight. + // Specification, section 15.6, with non-numerical values disallowed. + // The default value is `400` ("normal"). The font weight makes up just + // one component of the rendered font weight. The rendered weight is + // determined by a combination of the `weight` and the text style's + // resolved `bold` value, after accounting for inheritance: * If the + // text is bold and the weight is less than `400`, the rendered weight + // is 400. * If the text is bold and the weight is greater than or equal + // to `400` but is less than `700`, the rendered weight is `700`. * If + // the weight is greater than or equal to `700`, the rendered weight is + // equal to the weight. * If the text is not bold, the rendered weight + // is equal to the weight. Weight int64 `json:"weight,omitempty"` // ForceSendFields is a list of field names (e.g. "FontFamily") to diff --git a/documentai/v1beta2/documentai-gen.go b/documentai/v1beta2/documentai-gen.go index 5fefc7b103e..f5b7174eeb8 100644 --- a/documentai/v1beta2/documentai-gen.go +++ b/documentai/v1beta2/documentai-gen.go @@ -811,9 +811,7 @@ type GoogleCloudDocumentaiV1beta1Document struct { // Uri: Currently supports Google Cloud Storage URI of the form // `gs://bucket_name/object_name`. Object versioning is not supported. - // See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. + // See Google Cloud Storage Request URIs for more info. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -2723,9 +2721,7 @@ type GoogleCloudDocumentaiV1beta2Document struct { // Uri: Currently supports Google Cloud Storage URI of the form // `gs://bucket_name/object_name`. Object versioning is not supported. - // See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. + // See Google Cloud Storage Request URIs for more info. Uri string `json:"uri,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -5067,11 +5063,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -5514,8 +5509,8 @@ func (s *GoogleTypePostalAddress) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleTypeTimeZone: Represents a time zone from the [IANA Time Zone -// Database](https://www.iana.org/time-zones). +// GoogleTypeTimeZone: Represents a time zone from the IANA Time Zone +// Database. type GoogleTypeTimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` @@ -5594,7 +5589,7 @@ func (c *ProjectsDocumentsBatchProcessCall) Header() http.Header { func (c *ProjectsDocumentsBatchProcessCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5734,7 +5729,7 @@ func (c *ProjectsDocumentsProcessCall) Header() http.Header { func (c *ProjectsDocumentsProcessCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5876,7 +5871,7 @@ func (c *ProjectsLocationsDocumentsBatchProcessCall) Header() http.Header { func (c *ProjectsLocationsDocumentsBatchProcessCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6016,7 +6011,7 @@ func (c *ProjectsLocationsDocumentsProcessCall) Header() http.Header { func (c *ProjectsLocationsDocumentsProcessCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6168,7 +6163,7 @@ func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6314,7 +6309,7 @@ func (c *ProjectsOperationsGetCall) Header() http.Header { func (c *ProjectsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index daeb3118eb3..00f78960f21 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -811,9 +811,7 @@ type GoogleCloudDocumentaiV1beta1Document struct { // Uri: Currently supports Google Cloud Storage URI of the form // `gs://bucket_name/object_name`. Object versioning is not supported. - // See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. + // See Google Cloud Storage Request URIs for more info. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -2663,9 +2661,7 @@ type GoogleCloudDocumentaiV1beta2Document struct { // Uri: Currently supports Google Cloud Storage URI of the form // `gs://bucket_name/object_name`. Object versioning is not supported. - // See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. + // See Google Cloud Storage Request URIs for more info. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -4750,9 +4746,7 @@ type GoogleCloudDocumentaiV1beta3Document struct { // Uri: Currently supports Google Cloud Storage URI of the form // `gs://bucket_name/object_name`. Object versioning is not supported. - // See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. + // See Google Cloud Storage Request URIs for more info. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -6605,11 +6599,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -7052,8 +7045,8 @@ func (s *GoogleTypePostalAddress) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleTypeTimeZone: Represents a time zone from the [IANA Time Zone -// Database](https://www.iana.org/time-zones). +// GoogleTypeTimeZone: Represents a time zone from the IANA Time Zone +// Database. type GoogleTypeTimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` @@ -7140,7 +7133,7 @@ func (c *ProjectsLocationsGetCall) Header() http.Header { func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7306,7 +7299,7 @@ func (c *ProjectsLocationsListCall) Header() http.Header { func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7491,7 +7484,7 @@ func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7627,7 +7620,7 @@ func (c *ProjectsLocationsProcessorsBatchProcessCall) Header() http.Header { func (c *ProjectsLocationsProcessorsBatchProcessCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7767,7 +7760,7 @@ func (c *ProjectsLocationsProcessorsProcessCall) Header() http.Header { func (c *ProjectsLocationsProcessorsProcessCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7910,7 +7903,7 @@ func (c *ProjectsLocationsProcessorsHumanReviewConfigReviewDocumentCall) Header( func (c *ProjectsLocationsProcessorsHumanReviewConfigReviewDocumentCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8051,7 +8044,7 @@ func (c *ProjectsLocationsProcessorsProcessorVersionsBatchProcessCall) Header() func (c *ProjectsLocationsProcessorsProcessorVersionsBatchProcessCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8191,7 +8184,7 @@ func (c *ProjectsLocationsProcessorsProcessorVersionsProcessCall) Header() http. func (c *ProjectsLocationsProcessorsProcessorVersionsProcessCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/domains/v1alpha2/domains-gen.go b/domains/v1alpha2/domains-gen.go index 6c2fba5b63a..4fd8674644b 100644 --- a/domains/v1alpha2/domains-gen.go +++ b/domains/v1alpha2/domains-gen.go @@ -318,9 +318,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -555,10 +553,9 @@ func (s *Contact) MarshalJSON() ([]byte, error) { } // ContactSettings: Defines the contact information associated with a -// `Registration`. [ICANN](https://icann.org/) requires all domain names -// to have associated contact information. The `registrant_contact` is -// considered the domain's legal owner, and often the other contacts are -// identical. +// `Registration`. ICANN requires all domain names to have associated +// contact information. The `registrant_contact` is considered the +// domain's legal owner, and often the other contacts are identical. type ContactSettings struct { // AdminContact: Required. The administrative contact for the // `Registration`. @@ -665,8 +662,7 @@ type DnsSettings struct { // Commonly empty. GlueRecords []*GlueRecord `json:"glueRecords,omitempty"` - // GoogleDomainsDns: The free DNS zone provided by [Google - // Domains](https://domains.google/). + // GoogleDomainsDns: The free DNS zone provided by Google Domains. GoogleDomainsDns *GoogleDomainsDns `json:"googleDomainsDns,omitempty"` // ForceSendFields is a list of field names (e.g. "CustomDns") to @@ -867,7 +863,7 @@ func (s *GlueRecord) MarshalJSON() ([]byte, error) { // GoogleDomainsDns: Configuration for using the free DNS zone provided // by Google Domains as a `Registration`'s `dns_provider`. You cannot // configure the DNS zone itself using the API. To configure the DNS -// zone, go to [Google Domains](https://domains.google/). +// zone, go to Google Domains. type GoogleDomainsDns struct { // DsRecords: Output only. The list of DS records published for this // domain. The list is automatically populated when `ds_state` is @@ -1288,9 +1284,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1308,8 +1303,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1348,9 +1343,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1898,11 +1892,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1945,8 +1938,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3277,15 +3269,15 @@ type ProjectsLocationsRegistrationsExportCall struct { } // Export: Exports a `Registration` that you no longer want to use with -// Cloud Domains. You can continue to use the domain in [Google -// Domains](https://domains.google/) until it expires. If the export is -// successful: * The resource's `state` becomes `EXPORTED`, meaning that -// it is no longer managed by Cloud Domains * Because individual users -// can own domains in Google Domains, the calling user becomes the -// domain's sole owner. Permissions for the domain are subsequently -// managed in Google Domains. * Without further action, the domain does -// not renew automatically. The new owner can set up billing in Google -// Domains to renew the domain if needed. +// Cloud Domains. You can continue to use the domain in Google Domains +// until it expires. If the export is successful: * The resource's +// `state` becomes `EXPORTED`, meaning that it is no longer managed by +// Cloud Domains * Because individual users can own domains in Google +// Domains, the calling user becomes the domain's sole owner. +// Permissions for the domain are subsequently managed in Google +// Domains. * Without further action, the domain does not renew +// automatically. The new owner can set up billing in Google Domains to +// renew the domain if needed. func (r *ProjectsLocationsRegistrationsService) Export(name string, exportregistrationrequest *ExportRegistrationRequest) *ProjectsLocationsRegistrationsExportCall { c := &ProjectsLocationsRegistrationsExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3585,9 +3577,7 @@ func (r *ProjectsLocationsRegistrationsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsRegistrationsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRegistrationsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/domains/v1beta1/domains-gen.go b/domains/v1beta1/domains-gen.go index 1c6fa4e7850..1d857e5fe8b 100644 --- a/domains/v1beta1/domains-gen.go +++ b/domains/v1beta1/domains-gen.go @@ -318,9 +318,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -555,10 +553,9 @@ func (s *Contact) MarshalJSON() ([]byte, error) { } // ContactSettings: Defines the contact information associated with a -// `Registration`. [ICANN](https://icann.org/) requires all domain names -// to have associated contact information. The `registrant_contact` is -// considered the domain's legal owner, and often the other contacts are -// identical. +// `Registration`. ICANN requires all domain names to have associated +// contact information. The `registrant_contact` is considered the +// domain's legal owner, and often the other contacts are identical. type ContactSettings struct { // AdminContact: Required. The administrative contact for the // `Registration`. @@ -665,8 +662,7 @@ type DnsSettings struct { // Commonly empty. GlueRecords []*GlueRecord `json:"glueRecords,omitempty"` - // GoogleDomainsDns: The free DNS zone provided by [Google - // Domains](https://domains.google/). + // GoogleDomainsDns: The free DNS zone provided by Google Domains. GoogleDomainsDns *GoogleDomainsDns `json:"googleDomainsDns,omitempty"` // ForceSendFields is a list of field names (e.g. "CustomDns") to @@ -867,7 +863,7 @@ func (s *GlueRecord) MarshalJSON() ([]byte, error) { // GoogleDomainsDns: Configuration for using the free DNS zone provided // by Google Domains as a `Registration`'s `dns_provider`. You cannot // configure the DNS zone itself using the API. To configure the DNS -// zone, go to [Google Domains](https://domains.google/). +// zone, go to Google Domains. type GoogleDomainsDns struct { // DsRecords: Output only. The list of DS records published for this // domain. The list is automatically populated when `ds_state` is @@ -1288,9 +1284,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1308,8 +1303,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1348,9 +1343,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1898,11 +1892,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1945,8 +1938,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3277,15 +3269,15 @@ type ProjectsLocationsRegistrationsExportCall struct { } // Export: Exports a `Registration` that you no longer want to use with -// Cloud Domains. You can continue to use the domain in [Google -// Domains](https://domains.google/) until it expires. If the export is -// successful: * The resource's `state` becomes `EXPORTED`, meaning that -// it is no longer managed by Cloud Domains * Because individual users -// can own domains in Google Domains, the calling user becomes the -// domain's sole owner. Permissions for the domain are subsequently -// managed in Google Domains. * Without further action, the domain does -// not renew automatically. The new owner can set up billing in Google -// Domains to renew the domain if needed. +// Cloud Domains. You can continue to use the domain in Google Domains +// until it expires. If the export is successful: * The resource's +// `state` becomes `EXPORTED`, meaning that it is no longer managed by +// Cloud Domains * Because individual users can own domains in Google +// Domains, the calling user becomes the domain's sole owner. +// Permissions for the domain are subsequently managed in Google +// Domains. * Without further action, the domain does not renew +// automatically. The new owner can set up billing in Google Domains to +// renew the domain if needed. func (r *ProjectsLocationsRegistrationsService) Export(name string, exportregistrationrequest *ExportRegistrationRequest) *ProjectsLocationsRegistrationsExportCall { c := &ProjectsLocationsRegistrationsExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3585,9 +3577,7 @@ func (r *ProjectsLocationsRegistrationsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsRegistrationsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRegistrationsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/domainsrdap/v1/domainsrdap-gen.go b/domainsrdap/v1/domainsrdap-gen.go index aa089e0b2b7..2c162d13dbd 100644 --- a/domainsrdap/v1/domainsrdap-gen.go +++ b/domainsrdap/v1/domainsrdap-gen.go @@ -250,8 +250,7 @@ func (s *HttpBody) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Link: Links object defined in [section 4.2 of RFC -// 7483](https://tools.ietf.org/html/rfc7483#section-4.2). +// Link: Links object defined in section 4.2 of RFC 7483. type Link struct { // Href: Target URL of a link. Example: "http://example.com/previous". Href string `json:"href,omitempty"` @@ -298,8 +297,7 @@ func (s *Link) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Notice: Notices object defined in [section 4.3 of RFC -// 7483](https://tools.ietf.org/html/rfc7483#section-4.3). +// Notice: Notices object defined in section 4.3 of RFC 7483. type Notice struct { // Description: Description of the notice. Description []string `json:"description,omitempty"` @@ -310,11 +308,10 @@ type Notice struct { // Title: Title of a notice. Example: "Terms of Service". Title string `json:"title,omitempty"` - // Type: Type values defined in [section 10.2.1 of RFC - // 7483](https://tools.ietf.org/html/rfc7483#section-10.2.1) specific to - // a whole response: "result set truncated due to authorization", - // "result set truncated due to excessive load", "result set truncated - // due to unexplainable reasons". + // Type: Type values defined in section 10.2.1 of RFC 7483 specific to a + // whole response: "result set truncated due to authorization", "result + // set truncated due to excessive load", "result set truncated due to + // unexplainable reasons". Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -353,8 +350,7 @@ type RdapResponse struct { JsonResponse *HttpBody `json:"jsonResponse,omitempty"` // Lang: Error language code. Error response info fields are defined in - // [section 6 of RFC - // 7483](https://tools.ietf.org/html/rfc7483#section-6). + // section 6 of RFC 7483. Lang string `json:"lang,omitempty"` // Notices: Notices applying to this response. diff --git a/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go b/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go index 81edc157c89..4accfb2e1e1 100644 --- a/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go +++ b/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go @@ -2528,11 +2528,9 @@ func (s *RowStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Rule: A Rule defines a name, and a boolean expression in [conjunctive -// normal form](http: -// //mathworld.wolfram.com/ConjunctiveNormalForm.html){.external} that -// can be // applied to a path event to determine if that name should be -// applied. +// Rule: A Rule defines a name, and a boolean expression in conjunctive +// normal form{.external} that can be // applied to a path event to +// determine if that name should be applied. type Rule struct { DisjunctiveMatchStatements []*DisjunctiveMatchStatement `json:"disjunctiveMatchStatements,omitempty"` diff --git a/doubleclicksearch/v2/doubleclicksearch-gen.go b/doubleclicksearch/v2/doubleclicksearch-gen.go index 53c85faadac..fdb3be143df 100644 --- a/doubleclicksearch/v2/doubleclicksearch-gen.go +++ b/doubleclicksearch/v2/doubleclicksearch-gen.go @@ -711,9 +711,8 @@ type ReportRequest struct { // ReportType: Determines the type of rows that are returned in the // report. For example, if you specify `reportType: keyword`, each row - // in the report will contain data about a keyword. See the [Types of - // Reports](/search-ads/v2/report-types/) reference for the columns that - // are available for each type. + // in the report will contain data about a keyword. See the Types of + // Reports reference for the columns that are available for each type. ReportType string `json:"reportType,omitempty"` // RowCount: Synchronous report only. The maximum number of rows to diff --git a/eventarc/v1beta1/eventarc-gen.go b/eventarc/v1beta1/eventarc-gen.go index 5df7abcdf63..c0dba51cd74 100644 --- a/eventarc/v1beta1/eventarc-gen.go +++ b/eventarc/v1beta1/eventarc-gen.go @@ -285,9 +285,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -825,9 +823,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -845,8 +842,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -885,9 +882,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -992,11 +988,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1039,8 +1034,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1253,7 +1247,7 @@ func (c *ProjectsLocationsGetCall) Header() http.Header { func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1419,7 +1413,7 @@ func (c *ProjectsLocationsListCall) Header() http.Header { func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1600,7 +1594,7 @@ func (c *ProjectsLocationsOperationsCancelCall) Header() http.Header { func (c *ProjectsLocationsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1741,7 +1735,7 @@ func (c *ProjectsLocationsOperationsDeleteCall) Header() http.Header { func (c *ProjectsLocationsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1884,7 +1878,7 @@ func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2058,7 +2052,7 @@ func (c *ProjectsLocationsOperationsListCall) Header() http.Header { func (c *ProjectsLocationsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2237,7 +2231,7 @@ func (c *ProjectsLocationsTriggersCreateCall) Header() http.Header { func (c *ProjectsLocationsTriggersCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2388,7 +2382,7 @@ func (c *ProjectsLocationsTriggersDeleteCall) Header() http.Header { func (c *ProjectsLocationsTriggersDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2534,7 +2528,7 @@ func (c *ProjectsLocationsTriggersGetCall) Header() http.Header { func (c *ProjectsLocationsTriggersGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2650,9 +2644,7 @@ func (r *ProjectsLocationsTriggersService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsTriggersGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsTriggersGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -2695,7 +2687,7 @@ func (c *ProjectsLocationsTriggersGetIamPolicyCall) Header() http.Header { func (c *ProjectsLocationsTriggersGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2872,7 +2864,7 @@ func (c *ProjectsLocationsTriggersListCall) Header() http.Header { func (c *ProjectsLocationsTriggersListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3053,7 +3045,7 @@ func (c *ProjectsLocationsTriggersPatchCall) Header() http.Header { func (c *ProjectsLocationsTriggersPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3201,7 +3193,7 @@ func (c *ProjectsLocationsTriggersSetIamPolicyCall) Header() http.Header { func (c *ProjectsLocationsTriggersSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3346,7 +3338,7 @@ func (c *ProjectsLocationsTriggersTestIamPermissionsCall) Header() http.Header { func (c *ProjectsLocationsTriggersTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201118") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/fcm/v1/fcm-gen.go b/fcm/v1/fcm-gen.go index 3ba536ae75a..4469ada1f93 100644 --- a/fcm/v1/fcm-gen.go +++ b/fcm/v1/fcm-gen.go @@ -156,8 +156,8 @@ type ProjectsMessagesService struct { s *Service } -// AndroidConfig: Android specific options for messages sent through -// [FCM connection server](https://goo.gl/4GLdUl). +// AndroidConfig: Android specific options for messages sent through FCM +// connection server. type AndroidConfig struct { // CollapseKey: An identifier of a group of messages that can be // collapsed, so that only the last message gets sent when delivery can @@ -171,8 +171,7 @@ type AndroidConfig struct { // DirectBootOk: If set to true, messages will be allowed to be // delivered to the app while the device is in direct boot mode. See - // [Support Direct Boot - // mode](https://developer.android.com/training/articles/direct-boot). + // Support Direct Boot mode. DirectBootOk bool `json:"directBootOk,omitempty"` // FcmOptions: Options for features provided by the FCM SDK for Android. @@ -182,8 +181,7 @@ type AndroidConfig struct { Notification *AndroidNotification `json:"notification,omitempty"` // Priority: Message priority. Can take "normal" and "high" values. For - // more information, see [Setting the priority of a - // message](https://goo.gl/GjONJv). + // more information, see Setting the priority of a message. // // Possible values: // "NORMAL" - Default priority for data messages. Normal priority @@ -281,22 +279,21 @@ type AndroidNotification struct { // BodyLocArgs: Variable string values to be used in place of the format // specifiers in body_loc_key to use to localize the body text to the - // user's current localization. See [Formatting and - // Styling](https://goo.gl/MalYE3) for more information. + // user's current localization. See Formatting and Styling for more + // information. BodyLocArgs []string `json:"bodyLocArgs,omitempty"` // BodyLocKey: The key to the body string in the app's string resources // to use to localize the body text to the user's current localization. - // See [String Resources](https://goo.gl/NdFZGI) for more information. + // See String Resources for more information. BodyLocKey string `json:"bodyLocKey,omitempty"` - // ChannelId: The [notification's channel - // id](https://developer.android.com/guide/topics/ui/notifiers/notificati - // ons#ManageChannels) (new in Android O). The app must create a channel - // with this channel ID before any notification with this channel ID is - // received. If you don't send this channel ID in the request, or if the - // channel ID provided has not yet been created by the app, FCM uses the - // channel ID specified in the app manifest. + // ChannelId: The notification's channel id (new in Android O). The app + // must create a channel with this channel ID before any notification + // with this channel ID is received. If you don't send this channel ID + // in the request, or if the channel ID provided has not yet been + // created by the app, FCM uses the channel ID specified in the app + // manifest. ChannelId string `json:"channelId,omitempty"` // ClickAction: The action associated with a user click on the @@ -309,35 +306,26 @@ type AndroidNotification struct { // DefaultLightSettings: If set to true, use the Android framework's // default LED light settings for the notification. Default values are - // specified in - // [config.xml](https://android.googlesource.com/platform/frameworks/base - // /+/master/core/res/res/values/config.xml). If - // `default_light_settings` is set to true and `light_settings` is also - // set, the user-specified `light_settings` is used instead of the - // default value. + // specified in config.xml. If `default_light_settings` is set to true + // and `light_settings` is also set, the user-specified `light_settings` + // is used instead of the default value. DefaultLightSettings bool `json:"defaultLightSettings,omitempty"` // DefaultSound: If set to true, use the Android framework's default // sound for the notification. Default values are specified in - // [config.xml](https://android.googlesource.com/platform/frameworks/base - // /+/master/core/res/res/values/config.xml). + // config.xml. DefaultSound bool `json:"defaultSound,omitempty"` // DefaultVibrateTimings: If set to true, use the Android framework's // default vibrate pattern for the notification. Default values are - // specified in - // [config.xml](https://android.googlesource.com/platform/frameworks/base - // /+/master/core/res/res/values/config.xml). If - // `default_vibrate_timings` is set to true and `vibrate_timings` is - // also set, the default value is used instead of the user-specified - // `vibrate_timings`. + // specified in config.xml. If `default_vibrate_timings` is set to true + // and `vibrate_timings` is also set, the default value is used instead + // of the user-specified `vibrate_timings`. DefaultVibrateTimings bool `json:"defaultVibrateTimings,omitempty"` // EventTime: Set the time that the event in the notification occurred. // Notifications in the panel are sorted by this time. A point in time - // is represented using - // [protobuf.Timestamp](https://developers.google.com/protocol-buffers/do - // cs/reference/java/com/google/protobuf/Timestamp). + // is represented using protobuf.Timestamp. EventTime string `json:"eventTime,omitempty"` // Icon: The notification's icon. Sets the notification icon to myicon @@ -359,21 +347,17 @@ type AndroidNotification struct { // LocalOnly: Set whether or not this notification is relevant only to // the current device. Some notifications can be bridged to other // devices for remote display, such as a Wear OS watch. This hint can be - // set to recommend this notification not be bridged. See [Wear OS - // guides](https://developer.android.com/training/wearables/notifications - // /bridger#existing-method-of-preventing-bridging) + // set to recommend this notification not be bridged. See Wear OS guides LocalOnly bool `json:"localOnly,omitempty"` // NotificationCount: Sets the number of items this notification // represents. May be displayed as a badge count for launchers that - // support badging.See [Notification - // Badge](https://developer.android.com/training/notify-user/badges). - // For example, this might be useful if you're using just one - // notification to represent multiple new messages but you want the - // count here to represent the number of total new messages. If zero or - // unspecified, systems that support badging use the default, which is - // to increment a number displayed on the long-press menu each time a - // new notification arrives. + // support badging.See Notification Badge. For example, this might be + // useful if you're using just one notification to represent multiple + // new messages but you want the count here to represent the number of + // total new messages. If zero or unspecified, systems that support + // badging use the default, which is to increment a number displayed on + // the long-press menu each time a new notification arrives. NotificationCount int64 `json:"notificationCount,omitempty"` // NotificationPriority: Set the relative priority for this @@ -384,10 +368,8 @@ type AndroidNotification struct { // notification. The effect of setting the same priorities may differ // slightly on different platforms. Note this priority differs from // `AndroidMessagePriority`. This priority is processed by the client - // after the message has been delivered, whereas - // [AndroidMessagePriority](https://firebase.google.com/docs/reference/fc - // m/rest/v1/projects.messages#androidmessagepriority) is an FCM concept - // that controls when the message is delivered. + // after the message has been delivered, whereas AndroidMessagePriority + // is an FCM concept that controls when the message is delivered. // // Possible values: // "PRIORITY_UNSPECIFIED" - If priority is unspecified, notification @@ -438,31 +420,26 @@ type AndroidNotification struct { // TitleLocArgs: Variable string values to be used in place of the // format specifiers in title_loc_key to use to localize the title text - // to the user's current localization. See [Formatting and - // Styling](https://goo.gl/MalYE3) for more information. + // to the user's current localization. See Formatting and Styling for + // more information. TitleLocArgs []string `json:"titleLocArgs,omitempty"` // TitleLocKey: The key to the title string in the app's string // resources to use to localize the title text to the user's current - // localization. See [String Resources](https://goo.gl/NdFZGI) for more - // information. + // localization. See String Resources for more information. TitleLocKey string `json:"titleLocKey,omitempty"` // VibrateTimings: Set the vibration pattern to use. Pass in an array of - // [protobuf.Duration](https://developers.google.com/protocol-buffers/doc - // s/reference/google.protobuf#google.protobuf.Duration) to turn on or - // off the vibrator. The first value indicates the `Duration` to wait - // before turning the vibrator on. The next value indicates the - // `Duration` to keep the vibrator on. Subsequent values alternate - // between `Duration` to turn the vibrator off and to turn the vibrator - // on. If `vibrate_timings` is set and `default_vibrate_timings` is set - // to `true`, the default value is used instead of the user-specified - // `vibrate_timings`. + // protobuf.Duration to turn on or off the vibrator. The first value + // indicates the `Duration` to wait before turning the vibrator on. The + // next value indicates the `Duration` to keep the vibrator on. + // Subsequent values alternate between `Duration` to turn the vibrator + // off and to turn the vibrator on. If `vibrate_timings` is set and + // `default_vibrate_timings` is set to `true`, the default value is used + // instead of the user-specified `vibrate_timings`. VibrateTimings []string `json:"vibrateTimings,omitempty"` - // Visibility: Set the - // [Notification.visibility](https://developer.android.com/reference/andr - // oid/app/Notification.html#visibility) of the notification. + // Visibility: Set the Notification.visibility of the notification. // // Possible values: // "VISIBILITY_UNSPECIFIED" - If unspecified, default to @@ -498,25 +475,19 @@ func (s *AndroidNotification) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ApnsConfig: [Apple Push Notification Service](https://goo.gl/MXRTPa) -// specific options. +// ApnsConfig: Apple Push Notification Service specific options. type ApnsConfig struct { // FcmOptions: Options for features provided by the FCM SDK for iOS. FcmOptions *ApnsFcmOptions `json:"fcmOptions,omitempty"` // Headers: HTTP request headers defined in Apple Push Notification - // Service. Refer to [APNs request - // headers](https://developer.apple.com/documentation/usernotifications/s - // etting_up_a_remote_notification_server/sending_notification_requests_t - // o_apns) for supported headers, e.g. "apns-priority": "10". + // Service. Refer to APNs request headers for supported headers, e.g. + // "apns-priority": "10". Headers map[string]string `json:"headers,omitempty"` // Payload: APNs payload as a JSON object, including both `aps` - // dictionary and custom payload. See [Payload Key - // Reference](https://developer.apple.com/documentation/usernotifications - // /setting_up_a_remote_notification_server/generating_a_remote_notificat - // ion). If present, it overrides - // google.firebase.fcm.v1.Notification.title and + // dictionary and custom payload. See Payload Key Reference. If present, + // it overrides google.firebase.fcm.v1.Notification.title and // google.firebase.fcm.v1.Notification.body. Payload googleapi.RawMessage `json:"payload,omitempty"` @@ -730,21 +701,15 @@ func (s *FcmOptions) MarshalJSON() ([]byte, error) { // LightSettings: Settings to control notification LED. type LightSettings struct { - // Color: Required. Set `color` of the LED with - // [google.type.Color](https://github.com/googleapis/googleapis/blob/mast - // er/google/type/color.proto). + // Color: Required. Set `color` of the LED with google.type.Color. Color *Color `json:"color,omitempty"` // LightOffDuration: Required. Along with `light_on_duration `, define - // the blink rate of LED flashes. Resolution defined by - // [proto.Duration](https://developers.google.com/protocol-buffers/docs/r - // eference/google.protobuf#google.protobuf.Duration) + // the blink rate of LED flashes. Resolution defined by proto.Duration LightOffDuration string `json:"lightOffDuration,omitempty"` // LightOnDuration: Required. Along with `light_off_duration`, define - // the blink rate of LED flashes. Resolution defined by - // [proto.Duration](https://developers.google.com/protocol-buffers/docs/r - // eference/google.protobuf#google.protobuf.Duration) + // the blink rate of LED flashes. Resolution defined by proto.Duration LightOnDuration string `json:"lightOnDuration,omitempty"` // ForceSendFields is a list of field names (e.g. "Color") to @@ -773,11 +738,10 @@ func (s *LightSettings) MarshalJSON() ([]byte, error) { // Message: Message to send by Firebase Cloud Messaging Service. type Message struct { // Android: Input only. Android specific options for messages sent - // through [FCM connection server](https://goo.gl/4GLdUl). + // through FCM connection server. Android *AndroidConfig `json:"android,omitempty"` - // Apns: Input only. [Apple Push Notification - // Service](https://goo.gl/MXRTPa) specific options. + // Apns: Input only. Apple Push Notification Service specific options. Apns *ApnsConfig `json:"apns,omitempty"` // Condition: Condition to send a message to, e.g. "'foo' in topics && @@ -808,8 +772,7 @@ type Message struct { // "/topics/" prefix should not be provided. Topic string `json:"topic,omitempty"` - // Webpush: Input only. [Webpush - // protocol](https://tools.ietf.org/html/rfc8030) options. + // Webpush: Input only. Webpush protocol options. Webpush *WebpushConfig `json:"webpush,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -912,8 +875,7 @@ func (s *SendMessageRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// WebpushConfig: [Webpush -// protocol](https://tools.ietf.org/html/rfc8030) options. +// WebpushConfig: Webpush protocol options. type WebpushConfig struct { // Data: Arbitrary key/value payload. If present, it will override // google.firebase.fcm.v1.Message.data. @@ -922,14 +884,12 @@ type WebpushConfig struct { // FcmOptions: Options for features provided by the FCM SDK for Web. FcmOptions *WebpushFcmOptions `json:"fcmOptions,omitempty"` - // Headers: HTTP headers defined in webpush protocol. Refer to [Webpush - // protocol](https://tools.ietf.org/html/rfc8030#section-5) for - // supported headers, e.g. "TTL": "15". + // Headers: HTTP headers defined in webpush protocol. Refer to Webpush + // protocol for supported headers, e.g. "TTL": "15". Headers map[string]string `json:"headers,omitempty"` // Notification: Web Notification options as a JSON object. Supports - // Notification instance properties as defined in [Web Notification - // API](https://developer.mozilla.org/en-US/docs/Web/API/Notification). + // Notification instance properties as defined in Web Notification API. // If present, "title" and "body" fields override // [google.firebase.fcm.v1.Notification.title] and // [google.firebase.fcm.v1.Notification.body]. diff --git a/file/v1/file-gen.go b/file/v1/file-gen.go index c5ed1269c75..855f52bc348 100644 --- a/file/v1/file-gen.go +++ b/file/v1/file-gen.go @@ -1303,17 +1303,16 @@ type NetworkConfig struct { // "MODE_IPV4" - Use the IPv4 internet protocol. Modes []string `json:"modes,omitempty"` - // Network: The name of the Google Compute Engine [VPC - // network](/compute/docs/networks-and-firewalls#networks) to which the - // instance is connected. + // Network: The name of the Google Compute Engine VPC network to which + // the instance is connected. Network string `json:"network,omitempty"` - // ReservedIpRange: A /29 CIDR block in one of the [internal IP address - // ranges](https://www.arin.net/knowledge/address_filters.html) that - // identifies the range of IP addresses reserved for this instance. For - // example, 10.0.0.0/29 or 192.168.0.0/29. The range you specify can't - // overlap with either existing subnets or assigned IP address ranges - // for other Cloud Filestore instances in the selected VPC network. + // ReservedIpRange: A /29 CIDR block in one of the internal IP address + // ranges that identifies the range of IP addresses reserved for this + // instance. For example, 10.0.0.0/29 or 192.168.0.0/29. The range you + // specify can't overlap with either existing subnets or assigned IP + // address ranges for other Cloud Filestore instances in the selected + // VPC network. ReservedIpRange string `json:"reservedIpRange,omitempty"` // ForceSendFields is a list of field names (e.g. "IpAddresses") to @@ -1602,11 +1601,10 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/file/v1beta1/file-gen.go b/file/v1beta1/file-gen.go index 2b149f8b8ee..d39c653970a 100644 --- a/file/v1beta1/file-gen.go +++ b/file/v1beta1/file-gen.go @@ -1308,18 +1308,16 @@ type NetworkConfig struct { // "MODE_IPV4" - Use the IPv4 internet protocol. Modes []string `json:"modes,omitempty"` - // Network: The name of the Google Compute Engine [VPC - // network](/compute/docs/networks-and-firewalls#networks) to which the - // instance is connected. + // Network: The name of the Google Compute Engine VPC network to which + // the instance is connected. Network string `json:"network,omitempty"` // ReservedIpRange: A /29 CIDR block for Basic or a /23 CIDR block for - // High Scale in one of the [internal IP address - // ranges](https://www.arin.net/knowledge/address_filters.html) that - // identifies the range of IP addresses reserved for this instance. For - // example, 10.0.0.0/29 or 192.168.0.0/23. The range you specify can't - // overlap with either existing subnets or assigned IP address ranges - // for other Cloud Filestore instances in the selected VPC network. + // High Scale in one of the internal IP address ranges that identifies + // the range of IP addresses reserved for this instance. For example, + // 10.0.0.0/29 or 192.168.0.0/23. The range you specify can't overlap + // with either existing subnets or assigned IP address ranges for other + // Cloud Filestore instances in the selected VPC network. ReservedIpRange string `json:"reservedIpRange,omitempty"` // ForceSendFields is a list of field names (e.g. "IpAddresses") to @@ -1612,11 +1610,10 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/firebase/v1beta1/firebase-gen.go b/firebase/v1beta1/firebase-gen.go index 8e198ffc0e6..1a85dfdbd5f 100644 --- a/firebase/v1beta1/firebase-gen.go +++ b/firebase/v1beta1/firebase-gen.go @@ -259,29 +259,24 @@ type ProjectsWebAppsService struct { // AddFirebaseRequest: All fields are required. type AddFirebaseRequest struct { // LocationId: Deprecated. Instead, to set a Project's default GCP - // resource location, call - // [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) - // after you add Firebase resources to the GCP `Project`. The ID of the - // Project's default GCP resource location. The location must be one of - // the available [GCP resource - // locations](https://firebase.google.com/docs/projects/locations). + // resource location, call `FinalizeDefaultLocation` after you add + // Firebase resources to the GCP `Project`. The ID of the Project's + // default GCP resource location. The location must be one of the + // available GCP resource locations. LocationId string `json:"locationId,omitempty"` // RegionCode: Deprecated. Instead, to link a Project with a Google - // Analytics account, call - // [`AddGoogleAnalytics`](../../v1beta1/projects/addGoogleAnalytics) - // after you add Firebase resources to the GCP `Project`. The region - // code (CLDR) that the account will use for Google Analytics data For - // example: US, GB, or DE In Java, use - // `com.google.i18n.identifiers.RegionCode`. + // Analytics account, call `AddGoogleAnalytics` after you add Firebase + // resources to the GCP `Project`. The region code (CLDR) that the + // account will use for Google Analytics data For example: US, GB, or DE + // In Java, use `com.google.i18n.identifiers.RegionCode`. RegionCode string `json:"regionCode,omitempty"` // TimeZone: Deprecated. Instead, to link a Project with a Google - // Analytics account, call - // [`AddGoogleAnalytics`](../../v1beta1/projects/addGoogleAnalytics) - // after you add Firebase resources to the GCP `Project`. The time zone - // that the account will use for Google Analytics data. For example: - // America/Los_Angeles or Africa/Abidjan + // Analytics account, call `AddGoogleAnalytics` after you add Firebase + // resources to the GCP `Project`. The time zone that the account will + // use for Google Analytics data. For example: America/Los_Angeles or + // Africa/Abidjan TimeZone string `json:"timeZone,omitempty"` // ForceSendFields is a list of field names (e.g. "LocationId") to @@ -308,11 +303,11 @@ func (s *AddFirebaseRequest) MarshalJSON() ([]byte, error) { } type AddGoogleAnalyticsRequest struct { - // AnalyticsAccountId: The ID for the existing [Google Analytics - // account](http://www.google.com/analytics/) that you want to link with - // the `FirebaseProject`. Specifying this field will provision a new - // Google Analytics property in your Google Analytics account and - // associate the new property with the `FirebaseProject`. + // AnalyticsAccountId: The ID for the existing Google Analytics account + // that you want to link with the `FirebaseProject`. Specifying this + // field will provision a new Google Analytics property in your Google + // Analytics account and associate the new property with the + // `FirebaseProject`. AnalyticsAccountId string `json:"analyticsAccountId,omitempty"` // AnalyticsPropertyId: The ID for the existing Google Analytics @@ -348,12 +343,11 @@ type AdminSdkConfig struct { DatabaseURL string `json:"databaseURL,omitempty"` // LocationId: The ID of the Project's default GCP resource location. - // The location is one of the available [GCP resource - // locations](https://firebase.google.com/docs/projects/locations). This + // The location is one of the available GCP resource locations. This // field is omitted if the default GCP resource location has not been // finalized yet. To set a Project's default GCP resource location, call - // [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) - // after you add Firebase resources to the Project. + // `FinalizeDefaultLocation` after you add Firebase resources to the + // Project. LocationId string `json:"locationId,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier for the @@ -443,11 +437,10 @@ type AnalyticsProperty struct { // Id: The globally unique, Google-assigned identifier of the Google // Analytics property associated with the specified `FirebaseProject`. - // If you called - // [`AddGoogleAnalytics`](../../v1beta1/projects/addGoogleAnalytics) to - // link the `FirebaseProject` with a Google Analytics account, the value - // in this `id` field is the same as the ID of the property either - // specified or provisioned with that call to `AddGoogleAnalytics`. + // If you called `AddGoogleAnalytics` to link the `FirebaseProject` with + // a Google Analytics account, the value in this `id` field is the same + // as the ID of the property either specified or provisioned with that + // call to `AddGoogleAnalytics`. Id string `json:"id,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -485,15 +478,11 @@ type AndroidApp struct { // Name: The resource name of the AndroidApp, in the format: projects/ // PROJECT_IDENTIFIER/androidApps/APP_ID * PROJECT_IDENTIFIER: the - // parent Project's - // [`ProjectNumber`](../projects#FirebaseProject.FIELDS.project_number) - // ***(recommended)*** or its - // [`ProjectId`](../projects#FirebaseProject.FIELDS.project_id). Learn - // more about using project identifiers in Google's [AIP 2510 - // standard](https://google.aip.dev/cloud/2510). Note that the value for - // PROJECT_IDENTIFIER in any response body will be the `ProjectId`. * - // APP_ID: the globally unique, Firebase-assigned identifier for the App - // (see [`appId`](../projects.androidApps#AndroidApp.FIELDS.app_id)). + // parent Project's `ProjectNumber` ***(recommended)*** or its + // `ProjectId`. Learn more about using project identifiers in Google's + // AIP 2510 standard. Note that the value for PROJECT_IDENTIFIER in any + // response body will be the `ProjectId`. * APP_ID: the globally unique, + // Firebase-assigned identifier for the App (see `appId`). Name string `json:"name,omitempty"` // PackageName: Immutable. The canonical package name of the Android app @@ -575,33 +564,30 @@ type DefaultResources struct { // HostingSite: The default Firebase Hosting site name, in the format: // PROJECT_ID Though rare, your `projectId` might already be used as the // name for an existing Hosting site in another project (learn more - // about creating non-default, [additional - // sites](https://firebase.google.com/docs/hosting/multisites)). In - // these cases, your `projectId` is appended with a hyphen then five - // alphanumeric characters to create your default Hosting site name. For - // example, if your `projectId` is `myproject123`, your default Hosting - // site name might be: `myproject123-a5c16` + // about creating non-default, additional sites). In these cases, your + // `projectId` is appended with a hyphen then five alphanumeric + // characters to create your default Hosting site name. For example, if + // your `projectId` is `myproject123`, your default Hosting site name + // might be: `myproject123-a5c16` HostingSite string `json:"hostingSite,omitempty"` // LocationId: The ID of the Project's default GCP resource location. - // The location is one of the available [GCP resource - // locations](https://firebase.google.com/docs/projects/locations). This + // The location is one of the available GCP resource locations. This // field is omitted if the default GCP resource location has not been // finalized yet. To set a Project's default GCP resource location, call - // [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) - // after you add Firebase resources to the Project. + // `FinalizeDefaultLocation` after you add Firebase resources to the + // Project. LocationId string `json:"locationId,omitempty"` // RealtimeDatabaseInstance: The default Firebase Realtime Database // instance name, in the format: PROJECT_ID Though rare, your // `projectId` might already be used as the name for an existing // Realtime Database instance in another project (learn more about - // [database - // sharding](https://firebase.google.com/docs/database/usage/sharding)). - // In these cases, your `projectId` is appended with a hyphen then five - // alphanumeric characters to create your default Realtime Database - // instance name. For example, if your `projectId` is `myproject123`, - // your default database instance name might be: `myproject123-a5c16` + // database sharding). In these cases, your `projectId` is appended with + // a hyphen then five alphanumeric characters to create your default + // Realtime Database instance name. For example, if your `projectId` is + // `myproject123`, your default database instance name might be: + // `myproject123-a5c16` RealtimeDatabaseInstance string `json:"realtimeDatabaseInstance,omitempty"` // StorageBucket: The default Cloud Storage for Firebase storage bucket, @@ -645,8 +631,7 @@ type Empty struct { type FinalizeDefaultLocationRequest struct { // LocationId: The ID of the Project's default GCP resource location. - // The location must be one of the available [GCP resource - // locations](https://firebase.google.com/docs/projects/locations). + // The location must be one of the available GCP resource locations. LocationId string `json:"locationId,omitempty"` // ForceSendFields is a list of field names (e.g. "LocationId") to @@ -737,25 +722,21 @@ func (s *FirebaseAppInfo) MarshalJSON() ([]byte, error) { // sites, storage systems (Firebase Realtime Database, Cloud Firestore, // Cloud Storage buckets), and other Firebase and Google Cloud Platform // (GCP) resources. You create a `FirebaseProject` by calling -// AddFirebase and specifying an *existing* [GCP -// `Project`](https://cloud.google.com/resource-manager/reference/rest/v1 -// /projects). This adds Firebase resources to the existing GCP -// `Project`. Since a FirebaseProject is actually also a GCP `Project`, -// a `FirebaseProject` has the same underlying GCP identifiers -// (`projectNumber` and `projectId`). This allows for easy interop with -// Google APIs. +// AddFirebase and specifying an *existing* GCP `Project`. This adds +// Firebase resources to the existing GCP `Project`. Since a +// FirebaseProject is actually also a GCP `Project`, a `FirebaseProject` +// has the same underlying GCP identifiers (`projectNumber` and +// `projectId`). This allows for easy interop with Google APIs. type FirebaseProject struct { // DisplayName: The user-assigned display name of the Project. DisplayName string `json:"displayName,omitempty"` // Name: The resource name of the Project, in the format: // projects/PROJECT_IDENTIFIER PROJECT_IDENTIFIER: the Project's - // [`ProjectNumber`](../projects#FirebaseProject.FIELDS.project_number) - // ***(recommended)*** or its - // [`ProjectId`](../projects#FirebaseProject.FIELDS.project_id). Learn - // more about using project identifiers in Google's [AIP 2510 - // standard](https://google.aip.dev/cloud/2510). Note that the value for - // PROJECT_IDENTIFIER in any response body will be the `ProjectId`. + // `ProjectNumber` ***(recommended)*** or its `ProjectId`. Learn more + // about using project identifiers in Google's AIP 2510 standard. Note + // that the value for PROJECT_IDENTIFIER in any response body will be + // the `ProjectId`. Name string `json:"name,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier for the @@ -832,15 +813,11 @@ type IosApp struct { // Name: The resource name of the IosApp, in the format: // projects/PROJECT_IDENTIFIER /iosApps/APP_ID * PROJECT_IDENTIFIER: the - // parent Project's - // [`ProjectNumber`](../projects#FirebaseProject.FIELDS.project_number) - // ***(recommended)*** or its - // [`ProjectId`](../projects#FirebaseProject.FIELDS.project_id). Learn - // more about using project identifiers in Google's [AIP 2510 - // standard](https://google.aip.dev/cloud/2510). Note that the value for - // PROJECT_IDENTIFIER in any response body will be the `ProjectId`. * - // APP_ID: the globally unique, Firebase-assigned identifier for the App - // (see [`appId`](../projects.iosApps#IosApp.FIELDS.app_id)). + // parent Project's `ProjectNumber` ***(recommended)*** or its + // `ProjectId`. Learn more about using project identifiers in Google's + // AIP 2510 standard. Note that the value for PROJECT_IDENTIFIER in any + // response body will be the `ProjectId`. * APP_ID: the globally unique, + // Firebase-assigned identifier for the App (see `appId`). Name string `json:"name,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier of the parent @@ -1204,14 +1181,11 @@ type Location struct { Features []string `json:"features,omitempty"` // LocationId: The ID of the GCP resource location. It will be one of - // the available [GCP resource - // locations](https://firebase.google.com/docs/projects/locations#types). + // the available GCP resource locations. LocationId string `json:"locationId,omitempty"` - // Type: Indicates whether the GCP resource location is a [regional or - // multi-regional - // location](https://firebase.google.com/docs/projects/locations#types) - // for data replication. + // Type: Indicates whether the GCP resource location is a regional or + // multi-regional location for data replication. // // Possible values: // "LOCATION_TYPE_UNSPECIFIED" - Used internally for distinguishing @@ -1319,20 +1293,18 @@ type ProjectInfo struct { DisplayName string `json:"displayName,omitempty"` // LocationId: The ID of the Project's default GCP resource location. - // The location is one of the available [GCP resource - // locations](https://firebase.google.com/docs/projects/locations). Not - // all Projects will have this field populated. If it is not populated, - // it means that the Project does not yet have a default GCP resource + // The location is one of the available GCP resource locations. Not all + // Projects will have this field populated. If it is not populated, it + // means that the Project does not yet have a default GCP resource // location. To set a Project's default GCP resource location, call - // [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) - // after you add Firebase resources to the Project. + // `FinalizeDefaultLocation` after you add Firebase resources to the + // Project. LocationId string `json:"locationId,omitempty"` // Project: The resource name of the GCP `Project` to which Firebase // resources can be added, in the format: projects/PROJECT_IDENTIFIER - // Refer to the `FirebaseProject` - // [`name`](../projects#FirebaseProject.FIELDS.name) field for details - // about PROJECT_IDENTIFIER values. + // Refer to the `FirebaseProject` `name` field for details about + // PROJECT_IDENTIFIER values. Project string `json:"project,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -1444,18 +1416,13 @@ type ShaCertificate struct { // Name: The resource name of the ShaCertificate for the AndroidApp, in // the format: // projects/PROJECT_IDENTIFIER/androidApps/APP_ID/sha/SHA_HASH * - // PROJECT_IDENTIFIER: the parent Project's - // [`ProjectNumber`](../projects#FirebaseProject.FIELDS.project_number) - // ***(recommended)*** or its - // [`ProjectId`](../projects#FirebaseProject.FIELDS.project_id). Learn - // more about using project identifiers in Google's [AIP 2510 - // standard](https://google.aip.dev/cloud/2510). Note that the value for - // PROJECT_IDENTIFIER in any response body will be the `ProjectId`. * - // APP_ID: the globally unique, Firebase-assigned identifier for the App - // (see [`appId`](../projects.androidApps#AndroidApp.FIELDS.app_id)). * - // SHA_HASH: the certificate hash for the App (see - // [`shaHash`](../projects.androidApps.sha#ShaCertificate.FIELDS.sha_hash - // )). + // PROJECT_IDENTIFIER: the parent Project's `ProjectNumber` + // ***(recommended)*** or its `ProjectId`. Learn more about using + // project identifiers in Google's AIP 2510 standard. Note that the + // value for PROJECT_IDENTIFIER in any response body will be the + // `ProjectId`. * APP_ID: the globally unique, Firebase-assigned + // identifier for the App (see `appId`). * SHA_HASH: the certificate + // hash for the App (see `shaHash`). Name string `json:"name,omitempty"` // ShaHash: The certificate hash for the `AndroidApp`. @@ -1490,11 +1457,10 @@ func (s *ShaCertificate) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1585,22 +1551,20 @@ type StreamMapping struct { // projects/PROJECT_IDENTIFIER/androidApps/APP_ID or // projects/PROJECT_IDENTIFIER/iosApps/APP_ID or // projects/PROJECT_IDENTIFIER /webApps/APP_ID Refer to the - // `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) - // field for details about PROJECT_IDENTIFIER values. + // `FirebaseProject` `name` field for details about PROJECT_IDENTIFIER + // values. App string `json:"app,omitempty"` // MeasurementId: Applicable for Firebase Web Apps only. The unique // Google-assigned identifier of the Google Analytics web stream // associated with the Firebase Web App. Firebase SDKs use this ID to // interact with Google Analytics APIs. Learn more about this ID and - // Google Analytics web streams in the [Analytics - // documentation](https://support.google.com/analytics/topic/9303475). + // Google Analytics web streams in the Analytics documentation. MeasurementId string `json:"measurementId,omitempty"` // StreamId: The unique Google-assigned identifier of the Google // Analytics data stream associated with the Firebase App. Learn more - // about Google Analytics data streams in the [Analytics - // documentation](https://support.google.com/analytics/answer/9303323). + // about Google Analytics data streams in the Analytics documentation. StreamId int64 `json:"streamId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "App") to @@ -1641,15 +1605,11 @@ type WebApp struct { // Name: The resource name of the WebApp, in the format: // projects/PROJECT_IDENTIFIER /webApps/APP_ID * PROJECT_IDENTIFIER: the - // parent Project's - // [`ProjectNumber`](../projects#FirebaseProject.FIELDS.project_number) - // ***(recommended)*** or its - // [`ProjectId`](../projects#FirebaseProject.FIELDS.project_id). Learn - // more about using project identifiers in Google's [AIP 2510 - // standard](https://google.aip.dev/cloud/2510). Note that the value for - // PROJECT_IDENTIFIER in any response body will be the `ProjectId`. * - // APP_ID: the globally unique, Firebase-assigned identifier for the App - // (see [`appId`](../projects.webApps#WebApp.FIELDS.app_id)). + // parent Project's `ProjectNumber` ***(recommended)*** or its + // `ProjectId`. Learn more about using project identifiers in Google's + // AIP 2510 standard. Note that the value for PROJECT_IDENTIFIER in any + // response body will be the `ProjectId`. * APP_ID: the globally unique, + // Firebase-assigned identifier for the App (see `appId`). Name string `json:"name,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier of the parent @@ -1708,12 +1668,11 @@ type WebAppConfig struct { DatabaseURL string `json:"databaseURL,omitempty"` // LocationId: The ID of the Project's default GCP resource location. - // The location is one of the available [GCP resource - // locations](https://firebase.google.com/docs/projects/locations). This + // The location is one of the available GCP resource locations. This // field is omitted if the default GCP resource location has not been // finalized yet. To set a Project's default GCP resource location, call - // [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) - // after you add Firebase resources to the Project. + // `FinalizeDefaultLocation` after you add Firebase resources to the + // Project. LocationId string `json:"locationId,omitempty"` // MeasurementId: The unique Google-assigned identifier of the Google @@ -1721,16 +1680,13 @@ type WebAppConfig struct { // this ID to interact with Google Analytics APIs. This field is only // present if the `WebApp` is linked to a web stream in a Google // Analytics App + Web property. Learn more about this ID and Google - // Analytics web streams in the [Analytics - // documentation](https://support.google.com/analytics/topic/9303475). - // To generate a `measurementId` and link the `WebApp` with a Google - // Analytics web stream, call - // [`AddGoogleAnalytics`](../../v1beta1/projects/addGoogleAnalytics). - // For apps using the Firebase JavaScript SDK v7.20.0 and later, - // Firebase dynamically fetches the `measurementId` when your app - // initializes Analytics. Having this ID in your config object is - // optional, but it does serve as a fallback in the rare case that the - // dynamic fetch fails. + // Analytics web streams in the Analytics documentation. To generate a + // `measurementId` and link the `WebApp` with a Google Analytics web + // stream, call `AddGoogleAnalytics`. For apps using the Firebase + // JavaScript SDK v7.20.0 and later, Firebase dynamically fetches the + // `measurementId` when your app initializes Analytics. Having this ID + // in your config object is optional, but it does serve as a fallback in + // the rare case that the dynamic fetch fails. MeasurementId string `json:"measurementId,omitempty"` // MessagingSenderId: The sender ID for use with Firebase Cloud @@ -1785,11 +1741,10 @@ type AvailableProjectsListCall struct { // List: Lists each [Google Cloud Platform (GCP) `Project`] // (https://cloud.google.com/resource-manager/reference/rest/v1/projects) // that can have Firebase resources added to it. A Project will only be -// listed if: - The caller has sufficient [Google -// IAM](https://cloud.google.com/iam) permissions to call AddFirebase. - -// The Project is not already a FirebaseProject. - The Project is not in -// an Organization which has policies that prevent Firebase resources -// from being added. +// listed if: - The caller has sufficient Google IAM permissions to call +// AddFirebase. - The Project is not already a FirebaseProject. - The +// Project is not in an Organization which has policies that prevent +// Firebase resources from being added. func (r *AvailableProjectsService) List() *AvailableProjectsListCall { c := &AvailableProjectsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -2128,23 +2083,19 @@ type ProjectsAddFirebaseCall struct { // . Since a FirebaseProject is actually also a GCP `Project`, a // `FirebaseProject` has the same underlying GCP identifiers // (`projectNumber` and `projectId`). This allows for easy interop with -// Google APIs. The result of this call is an -// [`Operation`](../../v1beta1/operations). Poll the `Operation` to -// track the provisioning process by calling GetOperation until -// [`done`](../../v1beta1/operations#Operation.FIELDS.done) is `true`. -// When `done` is `true`, the `Operation` has either succeeded or -// failed. If the `Operation` succeeded, its -// [`response`](../../v1beta1/operations#Operation.FIELDS.response) is -// set to a FirebaseProject; if the `Operation` failed, its -// [`error`](../../v1beta1/operations#Operation.FIELDS.error) is set to -// a google.rpc.Status. The `Operation` is automatically deleted after -// completion, so there is no need to call DeleteOperation. This method -// does not modify any billing account information on the underlying GCP -// `Project`. To call `AddFirebase`, a project member or service account -// must have the following permissions (the IAM roles of Editor and -// Owner contain these permissions): `firebase.projects.update`, -// `resourcemanager.projects.get`, `serviceusage.services.enable`, and -// `serviceusage.services.get`. +// Google APIs. The result of this call is an `Operation`. Poll the +// `Operation` to track the provisioning process by calling GetOperation +// until `done` is `true`. When `done` is `true`, the `Operation` has +// either succeeded or failed. If the `Operation` succeeded, its +// `response` is set to a FirebaseProject; if the `Operation` failed, +// its `error` is set to a google.rpc.Status. The `Operation` is +// automatically deleted after completion, so there is no need to call +// DeleteOperation. This method does not modify any billing account +// information on the underlying GCP `Project`. To call `AddFirebase`, a +// project member or service account must have the following permissions +// (the IAM roles of Editor and Owner contain these permissions): +// `firebase.projects.update`, `resourcemanager.projects.get`, +// `serviceusage.services.enable`, and `serviceusage.services.get`. func (r *ProjectsService) AddFirebase(projectid string, addfirebaserequest *AddFirebaseRequest) *ProjectsAddFirebaseCall { c := &ProjectsAddFirebaseCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectid = projectid @@ -2286,11 +2237,10 @@ type ProjectsAddGoogleAnalyticsCall struct { } // AddGoogleAnalytics: Links the specified FirebaseProject with an -// existing [Google Analytics -// account](http://www.google.com/analytics/). Using this call, you can -// either: - Specify an `analyticsAccountId` to provision a new Google -// Analytics property within the specified account and associate the new -// property with the `FirebaseProject`. - Specify an existing +// existing Google Analytics account. Using this call, you can either: - +// Specify an `analyticsAccountId` to provision a new Google Analytics +// property within the specified account and associate the new property +// with the `FirebaseProject`. - Specify an existing // `analyticsPropertyId` to associate the property with the // `FirebaseProject`. Note that when you call `AddGoogleAnalytics`: 1. // The first check determines if any existing data streams in the Google @@ -2304,28 +2254,20 @@ type ProjectsAddGoogleAnalyticsCall struct { // that a new data stream is always provisioned for a Web App even if it // was previously associated with a data stream in the Analytics // property. Learn more about the hierarchy and structure of Google -// Analytics accounts in the [Analytics -// documentation](https://support.google.com/analytics/answer/9303323). -// The result of this call is an -// [`Operation`](../../v1beta1/operations). Poll the `Operation` to -// track the provisioning process by calling GetOperation until -// [`done`](../../v1beta1/operations#Operation.FIELDS.done) is `true`. +// Analytics accounts in the Analytics documentation. The result of this +// call is an `Operation`. Poll the `Operation` to track the +// provisioning process by calling GetOperation until `done` is `true`. // When `done` is `true`, the `Operation` has either succeeded or -// failed. If the `Operation` succeeded, its -// [`response`](../../v1beta1/operations#Operation.FIELDS.response) is -// set to an AnalyticsDetails; if the `Operation` failed, its -// [`error`](../../v1beta1/operations#Operation.FIELDS.error) is set to -// a google.rpc.Status. To call `AddGoogleAnalytics`, a project member +// failed. If the `Operation` succeeded, its `response` is set to an +// AnalyticsDetails; if the `Operation` failed, its `error` is set to a +// google.rpc.Status. To call `AddGoogleAnalytics`, a project member // must be an Owner for the existing `FirebaseProject` and have the -// [`Edit` -// permission](https://support.google.com/analytics/answer/2884495) for -// the Google Analytics account. If the `FirebaseProject` already has -// Google Analytics enabled, and you call `AddGoogleAnalytics` using an -// `analyticsPropertyId` that's different from the currently associated -// property, then the call will fail. Analytics may have already been -// enabled in the Firebase console or by specifying `timeZone` and -// `regionCode` in the call to -// [`AddFirebase`](../../v1beta1/projects/addFirebase). +// `Edit` permission for the Google Analytics account. If the +// `FirebaseProject` already has Google Analytics enabled, and you call +// `AddGoogleAnalytics` using an `analyticsPropertyId` that's different +// from the currently associated property, then the call will fail. +// Analytics may have already been enabled in the Firebase console or by +// specifying `timeZone` and `regionCode` in the call to `AddFirebase`. func (r *ProjectsService) AddGoogleAnalytics(parent string, addgoogleanalyticsrequest *AddGoogleAnalyticsRequest) *ProjectsAddGoogleAnalyticsCall { c := &ProjectsAddGoogleAnalyticsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -2616,9 +2558,7 @@ type ProjectsGetAdminSdkConfigCall struct { // GetAdminSdkConfig: Gets the configuration artifact associated with // the specified FirebaseProject, which can be used by servers to // simplify initialization. Typically, this configuration is used with -// the Firebase Admin SDK -// [initializeApp](https://firebase.google.com/docs/admin/setup#initializ -// e_the_sdk) command. +// the Firebase Admin SDK initializeApp command. func (r *ProjectsService) GetAdminSdkConfig(name string) *ProjectsGetAdminSdkConfigCall { c := &ProjectsGetAdminSdkConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3107,7 +3047,7 @@ type ProjectsPatchCall struct { } // Patch: Updates the attributes of the specified FirebaseProject. All -// [query parameters](#query-parameters) are required. +// query parameters are required. func (r *ProjectsService) Patch(nameid string, firebaseproject *FirebaseProject) *ProjectsPatchCall { c := &ProjectsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.nameid = nameid @@ -3269,13 +3209,12 @@ type ProjectsRemoveAnalyticsCall struct { // property. However, this call does not delete the Google Analytics // resources, such as the Google Analytics property or any data streams. // These resources may be re-associated later to the `FirebaseProject` -// by calling -// [`AddGoogleAnalytics`](../../v1beta1/projects/addGoogleAnalytics) and -// specifying the same `analyticsPropertyId`. For Android Apps and iOS -// Apps, this call re-links data streams with their corresponding apps. -// However, for Web Apps, this call provisions a *new* data stream for -// each Web App. To call `RemoveAnalytics`, a project member must be an -// Owner for the `FirebaseProject`. +// by calling `AddGoogleAnalytics` and specifying the same +// `analyticsPropertyId`. For Android Apps and iOS Apps, this call +// re-links data streams with their corresponding apps. However, for Web +// Apps, this call provisions a *new* data stream for each Web App. To +// call `RemoveAnalytics`, a project member must be an Owner for the +// `FirebaseProject`. func (r *ProjectsService) RemoveAnalytics(parent string, removeanalyticsrequest *RemoveAnalyticsRequest) *ProjectsRemoveAnalyticsCall { c := &ProjectsRemoveAnalyticsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -3428,26 +3367,23 @@ func (r *ProjectsService) SearchApps(parent string) *ProjectsSearchAppsCall { } // Filter sets the optional parameter "filter": A query string -// compatible with Google's [AIP-160](https://google.aip.dev/160) -// standard. Use any of the following fields in a query: * -// [`app_id`](../projects.apps#FirebaseAppInfo.FIELDS.app_id) * -// [`namespace`](../projects.apps#FirebaseAppInfo.FIELDS.namespace) * -// [`platform`](../projects.apps#FirebaseAppInfo.FIELDS.platform) We -// also support the following "virtual" fields (fields which are not -// actually part of the returned resource object, but can be queried as -// if they are pre-populated with specific values): * `sha1_hash`: This +// compatible with Google's AIP-160 standard. Use any of the following +// fields in a query: * `app_id` * `namespace` * `platform` We also +// support the following "virtual" fields (fields which are not actually +// part of the returned resource object, but can be queried as if they +// are pre-populated with specific values): * `sha1_hash`: This field is +// considered to be a repeated `string` field, populated with the list +// of all SHA-1 certificate fingerprints registered with the app. This +// list is empty if the app is not an Android app. * `sha256_hash`: This // field is considered to be a repeated `string` field, populated with -// the list of all SHA-1 certificate fingerprints registered with the +// the list of all SHA-256 certificate fingerprints registered with the // app. This list is empty if the app is not an Android app. * -// `sha256_hash`: This field is considered to be a repeated `string` -// field, populated with the list of all SHA-256 certificate -// fingerprints registered with the app. This list is empty if the app -// is not an Android app. * `app_store_id`: This field is considered to -// be a singular `string` field, populated with the Apple App Store ID -// registered with the app. This field is empty if the app is not an iOS -// app. * `team_id`: This field is considered to be a singular `string` -// field, populated with the Apple team ID registered with the app. This -// field is empty if the app is not an iOS app. +// `app_store_id`: This field is considered to be a singular `string` +// field, populated with the Apple App Store ID registered with the app. +// This field is empty if the app is not an iOS app. * `team_id`: This +// field is considered to be a singular `string` field, populated with +// the Apple team ID registered with the app. This field is empty if the +// app is not an iOS app. func (c *ProjectsSearchAppsCall) Filter(filter string) *ProjectsSearchAppsCall { c.urlParams_.Set("filter", filter) return c @@ -4864,18 +4800,16 @@ type ProjectsAvailableLocationsListCall struct { // List: Lists the valid Google Cloud Platform (GCP) resource locations // for the specified Project (including a FirebaseProject). One of these -// locations can be selected as the Project's [_default_ GCP resource -// location](https://firebase.google.com/docs/projects/locations), which -// is the geographical location where the Project's resources, such as -// Cloud Firestore, will be provisioned by default. However, if the -// default GCP resource location has already been set for the Project, -// then this setting cannot be changed. This call checks for any -// possible [location -// restrictions](https://cloud.google.com/resource-manager/docs/organizat -// ion-policy/defining-locations) for the specified Project and, thus, -// might return a subset of all possible GCP resource locations. To list -// all GCP resource locations (regardless of any restrictions), call the -// endpoint without specifying a unique project identifier (that is, +// locations can be selected as the Project's _default_ GCP resource +// location, which is the geographical location where the Project's +// resources, such as Cloud Firestore, will be provisioned by default. +// However, if the default GCP resource location has already been set +// for the Project, then this setting cannot be changed. This call +// checks for any possible location restrictions for the specified +// Project and, thus, might return a subset of all possible GCP resource +// locations. To list all GCP resource locations (regardless of any +// restrictions), call the endpoint without specifying a unique project +// identifier (that is, // `/v1beta1/{parent=projects/-}/listAvailableLocations`). To call // `ListAvailableLocations` with a specified project, a member must be // at minimum a Viewer of the Project. Calls without a specified project @@ -5078,35 +5012,27 @@ type ProjectsDefaultLocationFinalizeCall struct { // Finalize: Sets the default Google Cloud Platform (GCP) resource // location for the specified FirebaseProject. This method creates an -// App Engine application with a [default Cloud Storage -// bucket](https://cloud.google.com/appengine/docs/standard/python/google -// cloudstorageclient/setting-up-cloud-storage#activating_a_cloud_storage -// _bucket), located in the specified -// [`locationId`](#body.request_body.FIELDS.location_id). This location -// must be one of the available [GCP resource -// locations](https://firebase.google.com/docs/projects/locations). -// After the default GCP resource location is finalized, or if it was -// already set, it cannot be changed. The default GCP resource location -// for the specified `FirebaseProject` might already be set because -// either the underlying GCP `Project` already has an App Engine -// application or `FinalizeDefaultLocation` was previously called with a -// specified `locationId`. Any new calls to `FinalizeDefaultLocation` -// with a *different* specified `locationId` will return a 409 error. -// The result of this call is an -// [`Operation`](../../v1beta1/operations), which can be used to track -// the provisioning process. The -// [`response`](../../v1beta1/operations#Operation.FIELDS.response) type -// of the `Operation` is google.protobuf.Empty. The `Operation` can be -// polled by its `name` using GetOperation until `done` is true. When -// `done` is true, the `Operation` has either succeeded or failed. If -// the `Operation` has succeeded, its -// [`response`](../../v1beta1/operations#Operation.FIELDS.response) will -// be set to a google.protobuf.Empty; if the `Operation` has failed, its -// `error` will be set to a google.rpc.Status. The `Operation` is -// automatically deleted after completion, so there is no need to call -// DeleteOperation. All fields listed in the [request -// body](#request-body) are required. To call `FinalizeDefaultLocation`, -// a member must be an Owner of the Project. +// App Engine application with a default Cloud Storage bucket, located +// in the specified `locationId`. This location must be one of the +// available GCP resource locations. After the default GCP resource +// location is finalized, or if it was already set, it cannot be +// changed. The default GCP resource location for the specified +// `FirebaseProject` might already be set because either the underlying +// GCP `Project` already has an App Engine application or +// `FinalizeDefaultLocation` was previously called with a specified +// `locationId`. Any new calls to `FinalizeDefaultLocation` with a +// *different* specified `locationId` will return a 409 error. The +// result of this call is an `Operation`, which can be used to track the +// provisioning process. The `response` type of the `Operation` is +// google.protobuf.Empty. The `Operation` can be polled by its `name` +// using GetOperation until `done` is true. When `done` is true, the +// `Operation` has either succeeded or failed. If the `Operation` has +// succeeded, its `response` will be set to a google.protobuf.Empty; if +// the `Operation` has failed, its `error` will be set to a +// google.rpc.Status. The `Operation` is automatically deleted after +// completion, so there is no need to call DeleteOperation. All fields +// listed in the request body are required. To call +// `FinalizeDefaultLocation`, a member must be an Owner of the Project. func (r *ProjectsDefaultLocationService) Finalize(parent string, finalizedefaultlocationrequest *FinalizeDefaultLocationRequest) *ProjectsDefaultLocationFinalizeCall { c := &ProjectsDefaultLocationFinalizeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go b/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go index a782fe4b460..7e2ce2e8e4d 100644 --- a/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go +++ b/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go @@ -246,17 +246,13 @@ func (s *AndroidInfo) MarshalJSON() ([]byte, error) { // Dynamic Link. type CreateManagedShortLinkRequest struct { // DynamicLinkInfo: Information about the Dynamic Link to be shortened. - // [Learn - // more](https://firebase.google.com/docs/reference/dynamic-links/link-sh - // ortener). + // Learn more. DynamicLinkInfo *DynamicLinkInfo `json:"dynamicLinkInfo,omitempty"` // LongDynamicLink: Full long Dynamic Link URL with desired query // parameters specified. For example, // "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample" - // , [Learn - // more](https://firebase.google.com/docs/reference/dynamic-links/link-sh - // ortener). + // , Learn more. LongDynamicLink string `json:"longDynamicLink,omitempty"` // Name: Link name to associate with the link. It's used for marketer to @@ -341,17 +337,13 @@ func (s *CreateManagedShortLinkResponse) MarshalJSON() ([]byte, error) { // Link. type CreateShortDynamicLinkRequest struct { // DynamicLinkInfo: Information about the Dynamic Link to be shortened. - // [Learn - // more](https://firebase.google.com/docs/reference/dynamic-links/link-sh - // ortener). + // Learn more. DynamicLinkInfo *DynamicLinkInfo `json:"dynamicLinkInfo,omitempty"` // LongDynamicLink: Full long Dynamic Link URL with desired query // parameters specified. For example, // "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample" - // , [Learn - // more](https://firebase.google.com/docs/reference/dynamic-links/link-sh - // ortener). + // , Learn more. LongDynamicLink string `json:"longDynamicLink,omitempty"` // SdkVersion: Google SDK version. Version takes the form @@ -564,21 +556,15 @@ func (s *DynamicLinkEventStat) MarshalJSON() ([]byte, error) { // DynamicLinkInfo: Information about a Dynamic Link. type DynamicLinkInfo struct { // AnalyticsInfo: Parameters used for tracking. See all tracking - // parameters in the - // [documentation](https://firebase.google.com/docs/dynamic-links/create- - // manually). + // parameters in the documentation. AnalyticsInfo *AnalyticsInfo `json:"analyticsInfo,omitempty"` // AndroidInfo: Android related information. See Android related - // parameters in the - // [documentation](https://firebase.google.com/docs/dynamic-links/create- - // manually). + // parameters in the documentation. AndroidInfo *AndroidInfo `json:"androidInfo,omitempty"` // DesktopInfo: Desktop related information. See desktop related - // parameters in the - // [documentation](https://firebase.google.com/docs/dynamic-links/create- - // manually). + // parameters in the documentation. DesktopInfo *DesktopInfo `json:"desktopInfo,omitempty"` // DomainUriPrefix: E.g. https://maps.app.goo.gl, @@ -589,23 +575,19 @@ type DynamicLinkInfo struct { DomainUriPrefix string `json:"domainUriPrefix,omitempty"` // DynamicLinkDomain: Dynamic Links domain that the project owns, e.g. - // abcd.app.goo.gl [Learn - // more](https://firebase.google.com/docs/dynamic-links/android/receive) - // on how to set up Dynamic Link domain associated with your Firebase - // project. Required if missing domain_uri_prefix. + // abcd.app.goo.gl Learn more on how to set up Dynamic Link domain + // associated with your Firebase project. Required if missing + // domain_uri_prefix. DynamicLinkDomain string `json:"dynamicLinkDomain,omitempty"` // IosInfo: iOS related information. See iOS related parameters in the - // [documentation](https://firebase.google.com/docs/dynamic-links/create- - // manually). + // documentation. IosInfo *IosInfo `json:"iosInfo,omitempty"` // Link: The link your app will open, You can specify any URL your app // can handle. This link must be a well-formatted URL, be properly // URL-encoded, and use the HTTP or HTTPS scheme. See 'link' parameters - // in the - // [documentation](https://firebase.google.com/docs/dynamic-links/create- - // manually). Required. + // in the documentation. Required. Link string `json:"link,omitempty"` // NavigationInfo: Information of navigation behavior of a Firebase @@ -1061,14 +1043,11 @@ func (s *GetIosReopenAttributionResponse) MarshalJSON() ([]byte, error) { } // GooglePlayAnalytics: Parameters for Google Play Campaign -// Measurements. [Learn -// more](https://developers.google.com/analytics/devguides/collection/and -// roid/v4/campaigns#campaign-params) +// Measurements. Learn more type GooglePlayAnalytics struct { - // Gclid: [AdWords autotagging - // parameter](https://support.google.com/analytics/answer/1033981?hl=en); - // used to measure Google AdWords ads. This value is generated - // dynamically and should never be modified. + // Gclid: AdWords autotagging parameter; used to measure Google AdWords + // ads. This value is generated dynamically and should never be + // modified. Gclid string `json:"gclid,omitempty"` // UtmCampaign: Campaign name; used for keyword analysis to identify a diff --git a/firebasehosting/v1/firebasehosting-gen.go b/firebasehosting/v1/firebasehosting-gen.go index 83b19708305..72e6fed7dcf 100644 --- a/firebasehosting/v1/firebasehosting-gen.go +++ b/firebasehosting/v1/firebasehosting-gen.go @@ -247,11 +247,10 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/firebasehosting/v1beta1/firebasehosting-gen.go b/firebasehosting/v1beta1/firebasehosting-gen.go index a984dadbcb2..584d9cf4567 100644 --- a/firebasehosting/v1beta1/firebasehosting-gen.go +++ b/firebasehosting/v1beta1/firebasehosting-gen.go @@ -786,14 +786,11 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } -// Header: A [`header`](/docs/hosting/full-config#headers) is an object -// that specifies a URL pattern that, if matched to the request URL -// path, triggers Hosting to apply the specified custom response -// headers. +// Header: A `header` is an object that specifies a URL pattern that, if +// matched to the request URL path, triggers Hosting to apply the +// specified custom response headers. type Header struct { - // Glob: The user-supplied - // [glob](/docs/hosting/full-config#glob_pattern_matching) to match - // against the request URL path. + // Glob: The user-supplied glob to match against the request URL path. Glob string `json:"glob,omitempty"` // Headers: Required. The additional headers to add to the response. @@ -861,9 +858,8 @@ type ListChannelsResponse struct { Channels []*Channel `json:"channels,omitempty"` // NextPageToken: If there are additional releases remaining beyond the - // ones in this response, then supply this token in the next - // [`list`](../sites.channels/list) call to continue with the next set - // of releases. + // ones in this response, then supply this token in the next `list` call + // to continue with the next set of releases. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -930,9 +926,8 @@ func (s *ListDomainsResponse) MarshalJSON() ([]byte, error) { type ListReleasesResponse struct { // NextPageToken: If there are additional releases remaining beyond the - // ones in this response, then supply this token in the next - // [`list`](../sites.versions.files/list) call to continue with the next - // set of releases. + // ones in this response, then supply this token in the next `list` call + // to continue with the next set of releases. NextPageToken string `json:"nextPageToken,omitempty"` // Releases: The list of hashes of files that still need to be uploaded, @@ -1234,14 +1229,11 @@ func (s *PreviewConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Redirect: A [`redirect`](/docs/hosting/full-config#redirects) object -// specifies a URL pattern that, if matched to the request URL path, -// triggers Hosting to respond with a redirect to the specified -// destination path. +// Redirect: A `redirect` object specifies a URL pattern that, if +// matched to the request URL path, triggers Hosting to respond with a +// redirect to the specified destination path. type Redirect struct { - // Glob: The user-supplied - // [glob](/docs/hosting/full-config#glob_pattern_matching) to match - // against the request URL path. + // Glob: The user-supplied glob to match against the request URL path. Glob string `json:"glob,omitempty"` // Location: Required. The value to put in the HTTP location header of @@ -1283,9 +1275,8 @@ func (s *Redirect) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Release: A `Release` is a particular [collection of configurations -// and files](sites.versions) that is set to be public at a particular -// time. +// Release: A `Release` is a particular collection of configurations and +// files that is set to be public at a particular time. type Release struct { // Message: The deploy description when the release was created. The // value can be up to 512 characters. @@ -1293,8 +1284,7 @@ type Release struct { // Name: Output only. The unique identifier for the release, in the // format: sites/ site-name/releases/releaseID This name is provided in - // the response body when you call the - // [`CreateRelease`](sites.releases/create) endpoint. + // the response body when you call the `CreateRelease` endpoint. Name string `json:"name,omitempty"` // ReleaseTime: Output only. The time at which the version is set to be @@ -1350,10 +1340,9 @@ func (s *Release) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Rewrite: A [`rewrite`](/docs/hosting/full-config#rewrites) object -// specifies a URL pattern that, if matched to the request URL path, -// triggers Hosting to respond as if the service were given the -// specified destination URL. +// Rewrite: A `rewrite` object specifies a URL pattern that, if matched +// to the request URL path, triggers Hosting to respond as if the +// service were given the specified destination URL. type Rewrite struct { // DynamicLinks: The request will be forwarded to Firebase Dynamic // Links. @@ -1363,9 +1352,7 @@ type Rewrite struct { // function name exactly. Function string `json:"function,omitempty"` - // Glob: The user-supplied - // [glob](/docs/hosting/full-config#glob_pattern_matching) to match - // against the request URL path. + // Glob: The user-supplied glob to match against the request URL path. Glob string `json:"glob,omitempty"` // Path: The URL path to rewrite the request to. @@ -1405,8 +1392,7 @@ func (s *Rewrite) MarshalJSON() ([]byte, error) { // should be routed and processed before serving content. The URL // request paths are matched against the specified URL patterns in the // configuration, then Hosting applies the applicable configuration -// according to a specific [priority -// order](/docs/hosting/full-config#hosting_priority_order). +// according to a specific priority order. type ServingConfig struct { // AppAssociation: How to handle well known App Association files. // @@ -1523,11 +1509,10 @@ func (s *SiteConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1565,12 +1550,11 @@ func (s *Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Version: A `Version` is the collection of configuration and [static -// files](sites.versions.files) that determine how a site is displayed. +// Version: A `Version` is the collection of configuration and static +// files that determine how a site is displayed. type Version struct { // Config: The configuration for the behavior of the site. This - // configuration exists in the - // [`firebase.json`](/docs/cli/#the_firebasejson_file) file. + // configuration exists in the `firebase.json` file. Config *ServingConfig `json:"config,omitempty"` // CreateTime: Output only. The time at which the version was created. @@ -1603,8 +1587,7 @@ type Version struct { // Name: The unique identifier for a version, in the format: // sites/site-name /versions/versionID This name is provided in the - // response body when you call the - // [`CreateVersion`](../sites.versions/create) endpoint. + // response body when you call the `CreateVersion` endpoint. Name string `json:"name,omitempty"` // Preview: Deprecated in favor of site channels. Version preview @@ -1615,14 +1598,13 @@ type Version struct { Preview *PreviewConfig `json:"preview,omitempty"` // Status: The deploy status of a version. For a successful deploy, call - // the [`CreateVersion`](sites.versions/create) endpoint to make a new - // version (`CREATED` status), [upload all desired - // files](sites.versions/populateFiles) to the version, then - // [update](sites.versions/patch) the version to the `FINALIZED` status. - // Note that if you leave the version in the `CREATED` state for more - // than 12 hours, the system will automatically mark the version as - // `ABANDONED`. You can also change the status of a version to `DELETED` - // by calling the [`DeleteVersion`](sites.versions/delete) endpoint. + // the `CreateVersion` endpoint to make a new version (`CREATED` + // status), upload all desired files to the version, then update the + // version to the `FINALIZED` status. Note that if you leave the version + // in the `CREATED` state for more than 12 hours, the system will + // automatically mark the version as `ABANDONED`. You can also change + // the status of a version to `DELETED` by calling the `DeleteVersion` + // endpoint. // // Possible values: // "VERSION_STATUS_UNSPECIFIED" - The default status; should not be @@ -2031,10 +2013,9 @@ func (r *ProjectsSitesService) UpdateConfig(name string, siteconfig *SiteConfig) } // UpdateMask sets the optional parameter "updateMask": A set of field -// names from your [site configuration](../sites.SiteConfig) that you -// want to update. A field will be overwritten if, and only if, it's in -// the mask. If a mask is not provided then a default mask of only -// [`max_versions`](../sites.SiteConfig.max_versions) will be used. +// names from your site configuration that you want to update. A field +// will be overwritten if, and only if, it's in the mask. If a mask is +// not provided then a default mask of only `max_versions` will be used. func (c *ProjectsSitesUpdateConfigCall) UpdateMask(updateMask string) *ProjectsSitesUpdateConfigCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -5075,8 +5056,7 @@ type ProjectsSitesVersionsPatchCall struct { // method will fail with `FAILED_PRECONDITION` in the event of an // invalid state transition. The only valid transition for a version is // currently from a `CREATED` status to a `FINALIZED` status. Use -// [`DeleteVersion`](../sites.versions/delete) to set the status of a -// version to `DELETED`. +// `DeleteVersion` to set the status of a version to `DELETED`. func (r *ProjectsSitesVersionsService) Patch(nameid string, version *Version) *ProjectsSitesVersionsPatchCall { c := &ProjectsSitesVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.nameid = nameid @@ -5085,10 +5065,9 @@ func (r *ProjectsSitesVersionsService) Patch(nameid string, version *Version) *P } // UpdateMask sets the optional parameter "updateMask": A set of field -// names from your [version](../sites.versions) that you want to update. -// A field will be overwritten if, and only if, it's in the mask. If a -// mask is not provided then a default mask of only -// [`status`](../sites.versions#Version.FIELDS.status) will be used. +// names from your version that you want to update. A field will be +// overwritten if, and only if, it's in the mask. If a mask is not +// provided then a default mask of only `status` will be used. func (c *ProjectsSitesVersionsPatchCall) UpdateMask(updateMask string) *ProjectsSitesVersionsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -5756,10 +5735,9 @@ func (r *SitesService) UpdateConfig(name string, siteconfig *SiteConfig) *SitesU } // UpdateMask sets the optional parameter "updateMask": A set of field -// names from your [site configuration](../sites.SiteConfig) that you -// want to update. A field will be overwritten if, and only if, it's in -// the mask. If a mask is not provided then a default mask of only -// [`max_versions`](../sites.SiteConfig.max_versions) will be used. +// names from your site configuration that you want to update. A field +// will be overwritten if, and only if, it's in the mask. If a mask is +// not provided then a default mask of only `max_versions` will be used. func (c *SitesUpdateConfigCall) UpdateMask(updateMask string) *SitesUpdateConfigCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -8800,8 +8778,7 @@ type SitesVersionsPatchCall struct { // method will fail with `FAILED_PRECONDITION` in the event of an // invalid state transition. The only valid transition for a version is // currently from a `CREATED` status to a `FINALIZED` status. Use -// [`DeleteVersion`](../sites.versions/delete) to set the status of a -// version to `DELETED`. +// `DeleteVersion` to set the status of a version to `DELETED`. func (r *SitesVersionsService) Patch(nameid string, version *Version) *SitesVersionsPatchCall { c := &SitesVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.nameid = nameid @@ -8810,10 +8787,9 @@ func (r *SitesVersionsService) Patch(nameid string, version *Version) *SitesVers } // UpdateMask sets the optional parameter "updateMask": A set of field -// names from your [version](../sites.versions) that you want to update. -// A field will be overwritten if, and only if, it's in the mask. If a -// mask is not provided then a default mask of only -// [`status`](../sites.versions#Version.FIELDS.status) will be used. +// names from your version that you want to update. A field will be +// overwritten if, and only if, it's in the mask. If a mask is not +// provided then a default mask of only `status` will be used. func (c *SitesVersionsPatchCall) UpdateMask(updateMask string) *SitesVersionsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/firebaseml/v1/firebaseml-gen.go b/firebaseml/v1/firebaseml-gen.go index 60976f2872f..ae4e80675f9 100644 --- a/firebaseml/v1/firebaseml-gen.go +++ b/firebaseml/v1/firebaseml-gen.go @@ -298,11 +298,10 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/firebaseml/v1beta2/firebaseml-gen.go b/firebaseml/v1beta2/firebaseml-gen.go index 2b32993c7d0..efeeb0dbf53 100644 --- a/firebaseml/v1beta2/firebaseml-gen.go +++ b/firebaseml/v1beta2/firebaseml-gen.go @@ -428,11 +428,10 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index 3f3a36c3220..c669f1d51fd 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -2874,11 +2874,10 @@ func (s *RunQueryResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3496,7 +3495,7 @@ func (c *ProjectsDatabasesExportDocumentsCall) Header() http.Header { func (c *ProjectsDatabasesExportDocumentsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3642,7 +3641,7 @@ func (c *ProjectsDatabasesImportDocumentsCall) Header() http.Header { func (c *ProjectsDatabasesImportDocumentsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3792,7 +3791,7 @@ func (c *ProjectsDatabasesCollectionGroupsFieldsGetCall) Header() http.Header { func (c *ProjectsDatabasesCollectionGroupsFieldsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3966,7 +3965,7 @@ func (c *ProjectsDatabasesCollectionGroupsFieldsListCall) Header() http.Header { func (c *ProjectsDatabasesCollectionGroupsFieldsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4160,7 +4159,7 @@ func (c *ProjectsDatabasesCollectionGroupsFieldsPatchCall) Header() http.Header func (c *ProjectsDatabasesCollectionGroupsFieldsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4310,7 +4309,7 @@ func (c *ProjectsDatabasesCollectionGroupsIndexesCreateCall) Header() http.Heade func (c *ProjectsDatabasesCollectionGroupsIndexesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4449,7 +4448,7 @@ func (c *ProjectsDatabasesCollectionGroupsIndexesDeleteCall) Header() http.Heade func (c *ProjectsDatabasesCollectionGroupsIndexesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4591,7 +4590,7 @@ func (c *ProjectsDatabasesCollectionGroupsIndexesGetCall) Header() http.Header { func (c *ProjectsDatabasesCollectionGroupsIndexesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4758,7 +4757,7 @@ func (c *ProjectsDatabasesCollectionGroupsIndexesListCall) Header() http.Header func (c *ProjectsDatabasesCollectionGroupsIndexesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4935,7 +4934,7 @@ func (c *ProjectsDatabasesDocumentsBatchGetCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBatchGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5081,7 +5080,7 @@ func (c *ProjectsDatabasesDocumentsBatchWriteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBatchWriteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5222,7 +5221,7 @@ func (c *ProjectsDatabasesDocumentsBeginTransactionCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBeginTransactionCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5363,7 +5362,7 @@ func (c *ProjectsDatabasesDocumentsCommitCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsCommitCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5522,7 +5521,7 @@ func (c *ProjectsDatabasesDocumentsCreateDocumentCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsCreateDocumentCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5696,7 +5695,7 @@ func (c *ProjectsDatabasesDocumentsDeleteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5872,7 +5871,7 @@ func (c *ProjectsDatabasesDocumentsGetCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6092,7 +6091,7 @@ func (c *ProjectsDatabasesDocumentsListCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6297,7 +6296,7 @@ func (c *ProjectsDatabasesDocumentsListCollectionIdsCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListCollectionIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6459,7 +6458,7 @@ func (c *ProjectsDatabasesDocumentsListenCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListenCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6603,7 +6602,7 @@ func (c *ProjectsDatabasesDocumentsPartitionQueryCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsPartitionQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6797,7 +6796,7 @@ func (c *ProjectsDatabasesDocumentsPatchCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6961,7 +6960,7 @@ func (c *ProjectsDatabasesDocumentsRollbackCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsRollbackCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7102,7 +7101,7 @@ func (c *ProjectsDatabasesDocumentsRunQueryCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsRunQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7243,7 +7242,7 @@ func (c *ProjectsDatabasesDocumentsWriteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsWriteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7393,7 +7392,7 @@ func (c *ProjectsDatabasesOperationsCancelCall) Header() http.Header { func (c *ProjectsDatabasesOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7535,7 +7534,7 @@ func (c *ProjectsDatabasesOperationsDeleteCall) Header() http.Header { func (c *ProjectsDatabasesOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7679,7 +7678,7 @@ func (c *ProjectsDatabasesOperationsGetCall) Header() http.Header { func (c *ProjectsDatabasesOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7854,7 +7853,7 @@ func (c *ProjectsDatabasesOperationsListCall) Header() http.Header { func (c *ProjectsDatabasesOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8037,7 +8036,7 @@ func (c *ProjectsLocationsGetCall) Header() http.Header { func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8204,7 +8203,7 @@ func (c *ProjectsLocationsListCall) Header() http.Header { func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/firestore/v1beta1/firestore-gen.go b/firestore/v1beta1/firestore-gen.go index f0a45e97245..d078d4c7078 100644 --- a/firestore/v1beta1/firestore-gen.go +++ b/firestore/v1beta1/firestore-gen.go @@ -2401,11 +2401,10 @@ func (s *RunQueryResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3023,7 +3022,7 @@ func (c *ProjectsDatabasesExportDocumentsCall) Header() http.Header { func (c *ProjectsDatabasesExportDocumentsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3169,7 +3168,7 @@ func (c *ProjectsDatabasesImportDocumentsCall) Header() http.Header { func (c *ProjectsDatabasesImportDocumentsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3312,7 +3311,7 @@ func (c *ProjectsDatabasesDocumentsBatchGetCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBatchGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3458,7 +3457,7 @@ func (c *ProjectsDatabasesDocumentsBatchWriteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBatchWriteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3599,7 +3598,7 @@ func (c *ProjectsDatabasesDocumentsBeginTransactionCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBeginTransactionCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3740,7 +3739,7 @@ func (c *ProjectsDatabasesDocumentsCommitCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsCommitCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3899,7 +3898,7 @@ func (c *ProjectsDatabasesDocumentsCreateDocumentCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsCreateDocumentCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4073,7 +4072,7 @@ func (c *ProjectsDatabasesDocumentsDeleteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4249,7 +4248,7 @@ func (c *ProjectsDatabasesDocumentsGetCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4469,7 +4468,7 @@ func (c *ProjectsDatabasesDocumentsListCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4674,7 +4673,7 @@ func (c *ProjectsDatabasesDocumentsListCollectionIdsCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListCollectionIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4836,7 +4835,7 @@ func (c *ProjectsDatabasesDocumentsListenCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListenCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4980,7 +4979,7 @@ func (c *ProjectsDatabasesDocumentsPartitionQueryCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsPartitionQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5174,7 +5173,7 @@ func (c *ProjectsDatabasesDocumentsPatchCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5338,7 +5337,7 @@ func (c *ProjectsDatabasesDocumentsRollbackCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsRollbackCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5479,7 +5478,7 @@ func (c *ProjectsDatabasesDocumentsRunQueryCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsRunQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5620,7 +5619,7 @@ func (c *ProjectsDatabasesDocumentsWriteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsWriteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5769,7 +5768,7 @@ func (c *ProjectsDatabasesIndexesCreateCall) Header() http.Header { func (c *ProjectsDatabasesIndexesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5908,7 +5907,7 @@ func (c *ProjectsDatabasesIndexesDeleteCall) Header() http.Header { func (c *ProjectsDatabasesIndexesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6050,7 +6049,7 @@ func (c *ProjectsDatabasesIndexesGetCall) Header() http.Header { func (c *ProjectsDatabasesIndexesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6215,7 +6214,7 @@ func (c *ProjectsDatabasesIndexesListCall) Header() http.Header { func (c *ProjectsDatabasesIndexesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/firestore/v1beta2/firestore-gen.go b/firestore/v1beta2/firestore-gen.go index 0fabade9074..7985738a043 100644 --- a/firestore/v1beta2/firestore-gen.go +++ b/firestore/v1beta2/firestore-gen.go @@ -1035,11 +1035,10 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/gameservices/v1/gameservices-gen.go b/gameservices/v1/gameservices-gen.go index 66c754118d1..578a41b1512 100644 --- a/gameservices/v1/gameservices-gen.go +++ b/gameservices/v1/gameservices-gen.go @@ -364,9 +364,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1886,9 +1884,8 @@ func (s *OperationStatus) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1906,8 +1903,8 @@ func (s *OperationStatus) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1958,9 +1955,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2487,11 +2483,10 @@ func (s *SpecSource) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2697,8 +2692,7 @@ func (s *TargetState) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3715,9 +3709,7 @@ func (r *ProjectsLocationsGameServerDeploymentsService) GetIamPolicy(resource st // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/gameservices/v1beta/gameservices-gen.go b/gameservices/v1beta/gameservices-gen.go index f74ce5ef91c..3389a4c1bb6 100644 --- a/gameservices/v1beta/gameservices-gen.go +++ b/gameservices/v1beta/gameservices-gen.go @@ -364,9 +364,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1886,9 +1884,8 @@ func (s *OperationStatus) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1906,8 +1903,8 @@ func (s *OperationStatus) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1958,9 +1955,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2487,11 +2483,10 @@ func (s *SpecSource) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2697,8 +2692,7 @@ func (s *TargetState) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3715,9 +3709,7 @@ func (r *ProjectsLocationsGameServerDeploymentsService) GetIamPolicy(resource st // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/genomics/v1/genomics-gen.go b/genomics/v1/genomics-gen.go index a9f1e2f2c20..986e1722713 100644 --- a/genomics/v1/genomics-gen.go +++ b/genomics/v1/genomics-gen.go @@ -798,11 +798,10 @@ func (s *RuntimeMetadata) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -957,8 +956,8 @@ type OperationsCancelCall struct { // is not guaranteed. Clients may use Operations.GetOperation or // Operations.ListOperations to check whether the cancellation succeeded // or the operation completed despite cancellation. Authorization -// requires the following [Google IAM](https://cloud.google.com/iam) -// permission: * `genomics.operations.cancel` +// requires the following Google IAM permission: * +// `genomics.operations.cancel` func (r *OperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *OperationsCancelCall { c := &OperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -1102,8 +1101,7 @@ type OperationsGetCall struct { // Get: Gets the latest state of a long-running operation. Clients can // use this method to poll the operation result at intervals as // recommended by the API service. Authorization requires the following -// [Google IAM](https://cloud.google.com/iam) permission: * -// `genomics.operations.get` +// Google IAM permission: * `genomics.operations.get` func (r *OperationsService) Get(name string) *OperationsGetCall { c := &OperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -1249,9 +1247,8 @@ type OperationsListCall struct { } // List: Lists operations that match the specified filter in the -// request. Authorization requires the following [Google -// IAM](https://cloud.google.com/iam) permission: * -// `genomics.operations.list` +// request. Authorization requires the following Google IAM permission: +// * `genomics.operations.list` func (r *OperationsService) List(name string) *OperationsListCall { c := &OperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -1270,9 +1267,8 @@ func (r *OperationsService) List(name string) *OperationsListCall { // the value is true. In v1 and v1alpha2, the following filter fields // are supported: * projectId: Required. Corresponds to // OperationMetadata.projectId. * createTime: The time this job was -// created, in seconds from the -// [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or -// `<=` operators. * status: Can be `RUNNING`, `SUCCESS`, `FAILURE`, or +// created, in seconds from the epoch. Can use `>=` and/or `<=` +// operators. * status: Can be `RUNNING`, `SUCCESS`, `FAILURE`, or // `CANCELED`. Only one status may be specified. * labels.key where key // is a label key. Examples: * `projectId = my-project AND createTime >= // 1432140000` * `projectId = my-project AND createTime >= 1432140000 diff --git a/genomics/v1alpha2/genomics-gen.go b/genomics/v1alpha2/genomics-gen.go index 87a507196f7..6e4f70481c0 100644 --- a/genomics/v1alpha2/genomics-gen.go +++ b/genomics/v1alpha2/genomics-gen.go @@ -1171,10 +1171,8 @@ type PipelineResources struct { // to ssh into a private IP VM for debugging, you can ssh to a public VM // and then ssh into the private VM's Internal IP. If noAddress is set, // this pipeline run may only load docker images from Google Container - // Registry and not Docker Hub. Before using this, you must [configure - // access to Google services from internal - // IPs](https://cloud.google.com/compute/docs/configure-private-google-ac - // cess#configuring_access_to_google_services_from_internal_ips). + // Registry and not Docker Hub. Before using this, you must configure + // access to Google services from internal IPs. NoAddress bool `json:"noAddress,omitempty"` // Preemptible: Whether to use preemptible VMs. Defaults to `false`. In @@ -1627,11 +1625,10 @@ func (s *SetOperationStatusRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1818,8 +1815,8 @@ type OperationsCancelCall struct { // is not guaranteed. Clients may use Operations.GetOperation or // Operations.ListOperations to check whether the cancellation succeeded // or the operation completed despite cancellation. Authorization -// requires the following [Google IAM](https://cloud.google.com/iam) -// permission: * `genomics.operations.cancel` +// requires the following Google IAM permission: * +// `genomics.operations.cancel` func (r *OperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *OperationsCancelCall { c := &OperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -1963,8 +1960,7 @@ type OperationsGetCall struct { // Get: Gets the latest state of a long-running operation. Clients can // use this method to poll the operation result at intervals as // recommended by the API service. Authorization requires the following -// [Google IAM](https://cloud.google.com/iam) permission: * -// `genomics.operations.get` +// Google IAM permission: * `genomics.operations.get` func (r *OperationsService) Get(name string) *OperationsGetCall { c := &OperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2110,9 +2106,8 @@ type OperationsListCall struct { } // List: Lists operations that match the specified filter in the -// request. Authorization requires the following [Google -// IAM](https://cloud.google.com/iam) permission: * -// `genomics.operations.list` +// request. Authorization requires the following Google IAM permission: +// * `genomics.operations.list` func (r *OperationsService) List(name string) *OperationsListCall { c := &OperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2131,9 +2126,8 @@ func (r *OperationsService) List(name string) *OperationsListCall { // the value is true. In v1 and v1alpha2, the following filter fields // are supported: * projectId: Required. Corresponds to // OperationMetadata.projectId. * createTime: The time this job was -// created, in seconds from the -// [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or -// `<=` operators. * status: Can be `RUNNING`, `SUCCESS`, `FAILURE`, or +// created, in seconds from the epoch. Can use `>=` and/or `<=` +// operators. * status: Can be `RUNNING`, `SUCCESS`, `FAILURE`, or // `CANCELED`. Only one status may be specified. * labels.key where key // is a label key. Examples: * `projectId = my-project AND createTime >= // 1432140000` * `projectId = my-project AND createTime >= 1432140000 diff --git a/genomics/v2alpha1/genomics-gen.go b/genomics/v2alpha1/genomics-gen.go index 784fbd4b8ea..66c4aa10348 100644 --- a/genomics/v2alpha1/genomics-gen.go +++ b/genomics/v2alpha1/genomics-gen.go @@ -1638,11 +1638,10 @@ func (s *ServiceAccount) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1798,22 +1797,19 @@ type VirtualMachine struct { EnableStackdriverMonitoring bool `json:"enableStackdriverMonitoring,omitempty"` // Labels: Optional set of labels to apply to the VM and any attached - // disk resources. These labels must adhere to the [name and value - // restrictions](https://cloud.google.com/compute/docs/labeling-resources - // ) on VM labels imposed by Compute Engine. Labels keys with the prefix - // 'google-' are reserved for use by Google. Labels applied at creation - // time to the VM. Applied on a best-effort basis to attached disk - // resources shortly after VM creation. + // disk resources. These labels must adhere to the name and value + // restrictions on VM labels imposed by Compute Engine. Labels keys with + // the prefix 'google-' are reserved for use by Google. Labels applied + // at creation time to the VM. Applied on a best-effort basis to + // attached disk resources shortly after VM creation. Labels map[string]string `json:"labels,omitempty"` // MachineType: Required. The machine type of the virtual machine to // create. Must be the short name of a standard machine type (such as // "n1-standard-1") or a custom machine type (such as "custom-1-4096", // where "1" indicates the number of vCPUs and "4096" indicates the - // memory in MB). See [Creating an instance with a custom machine - // type](https://cloud.google.com/compute/docs/instances/creating-instanc - // e-with-custom-machine-type#create) for more specifications on - // creating a custom machine type. + // memory in MB). See Creating an instance with a custom machine type + // for more specifications on creating a custom machine type. MachineType string `json:"machineType,omitempty"` // Network: The VM network configuration. @@ -2029,8 +2025,7 @@ type PipelinesRunCall struct { // you delete this permission, or if you enabled the Cloud Genomics API // before the v2alpha1 API launch, you must disable and re-enable the // API to grant the Genomics Service Agent the required permissions. -// Authorization requires the following [Google -// IAM](https://cloud.google.com/iam/) permission: * +// Authorization requires the following Google IAM permission: * // `genomics.operations.create` [1]: /genomics/gsa func (r *PipelinesService) Run(runpipelinerequest *RunPipelineRequest) *PipelinesRunCall { c := &PipelinesRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -2163,8 +2158,8 @@ type ProjectsOperationsCancelCall struct { // is not guaranteed. Clients may use Operations.GetOperation or // Operations.ListOperations to check whether the cancellation succeeded // or the operation completed despite cancellation. Authorization -// requires the following [Google IAM](https://cloud.google.com/iam) -// permission: * `genomics.operations.cancel` +// requires the following Google IAM permission: * +// `genomics.operations.cancel` func (r *ProjectsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *ProjectsOperationsCancelCall { c := &ProjectsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2308,8 +2303,7 @@ type ProjectsOperationsGetCall struct { // Get: Gets the latest state of a long-running operation. Clients can // use this method to poll the operation result at intervals as // recommended by the API service. Authorization requires the following -// [Google IAM](https://cloud.google.com/iam) permission: * -// `genomics.operations.get` +// Google IAM permission: * `genomics.operations.get` func (r *ProjectsOperationsService) Get(name string) *ProjectsOperationsGetCall { c := &ProjectsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2455,9 +2449,8 @@ type ProjectsOperationsListCall struct { } // List: Lists operations that match the specified filter in the -// request. Authorization requires the following [Google -// IAM](https://cloud.google.com/iam) permission: * -// `genomics.operations.list` +// request. Authorization requires the following Google IAM permission: +// * `genomics.operations.list` func (r *ProjectsOperationsService) List(name string) *ProjectsOperationsListCall { c := &ProjectsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2476,9 +2469,8 @@ func (r *ProjectsOperationsService) List(name string) *ProjectsOperationsListCal // the value is true. In v1 and v1alpha2, the following filter fields // are supported: * projectId: Required. Corresponds to // OperationMetadata.projectId. * createTime: The time this job was -// created, in seconds from the -// [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or -// `<=` operators. * status: Can be `RUNNING`, `SUCCESS`, `FAILURE`, or +// created, in seconds from the epoch. Can use `>=` and/or `<=` +// operators. * status: Can be `RUNNING`, `SUCCESS`, `FAILURE`, or // `CANCELED`. Only one status may be specified. * labels.key where key // is a label key. Examples: * `projectId = my-project AND createTime >= // 1432140000` * `projectId = my-project AND createTime >= 1432140000 diff --git a/gmail/v1/gmail-gen.go b/gmail/v1/gmail-gen.go index 7ae244ae057..19dd95617c3 100644 --- a/gmail/v1/gmail-gen.go +++ b/gmail/v1/gmail-gen.go @@ -1526,9 +1526,8 @@ type Message struct { // message or draft to a thread, the following criteria must be met: 1. // The requested `threadId` must be specified on the `Message` or // `Draft.Message` you supply with your request. 2. The `References` and - // `In-Reply-To` headers must be set in compliance with the [RFC - // 2822](https://tools.ietf.org/html/rfc2822) standard. 3. The `Subject` - // headers must match. + // `In-Reply-To` headers must be set in compliance with the RFC 2822 + // standard. 3. The `Subject` headers must match. ThreadId string `json:"threadId,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go b/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go index ec5f55fa934..f284b817863 100644 --- a/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go +++ b/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go @@ -293,9 +293,7 @@ func (s *Domain) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// FeedbackLoop: [Feedback -// loop](https://support.google.com/mail/answer/6254652) identifier -// information. +// FeedbackLoop: Feedback loop identifier information. type FeedbackLoop struct { // Id: Feedback loop identifier that uniquely identifies individual // campaigns. @@ -346,15 +344,12 @@ func (s *FeedbackLoop) UnmarshalJSON(data []byte) error { // specific reputation category. type IpReputation struct { // IpCount: Total number of unique IPs in this reputation category. This - // metric only pertains to traffic that passed - // [SPF](http://www.openspf.org/) or [DKIM](http://www.dkim.org/). + // metric only pertains to traffic that passed SPF or DKIM. IpCount int64 `json:"ipCount,omitempty,string"` // NumIps: Total number of unique IPs in this reputation category. This - // metric only pertains to traffic that passed - // [SPF](http://www.openspf.org/) or [DKIM](http://www.dkim.org/). - // Deprecated to be complied with ApiLinter for Quantities. Use ip_count - // instead. + // metric only pertains to traffic that passed SPF or DKIM. Deprecated + // to be complied with ApiLinter for Quantities. Use ip_count instead. NumIps int64 `json:"numIps,omitempty,string"` // Reputation: The reputation category this IP reputation represents. @@ -478,19 +473,17 @@ func (s *ListTrafficStatsResponse) MarshalJSON() ([]byte, error) { // TrafficStats: Email traffic statistics pertaining to a specific date. type TrafficStats struct { // DeliveryErrors: Delivery errors for the domain. This metric only - // pertains to traffic that passed [SPF](http://www.openspf.org/) or - // [DKIM](http://www.dkim.org/). + // pertains to traffic that passed SPF or DKIM. DeliveryErrors []*DeliveryError `json:"deliveryErrors,omitempty"` // DkimSuccessRatio: The ratio of mail that successfully authenticated - // with DKIM vs. all mail that attempted to authenticate with - // [DKIM](http://www.dkim.org/). Spoofed mail is excluded. + // with DKIM vs. all mail that attempted to authenticate with DKIM. + // Spoofed mail is excluded. DkimSuccessRatio float64 `json:"dkimSuccessRatio,omitempty"` - // DmarcSuccessRatio: The ratio of mail that passed - // [DMARC](https://dmarc.org/) alignment checks vs all mail received - // from the domain that successfully authenticated with either of - // [SPF](http://www.openspf.org/) or [DKIM](http://www.dkim.org/). + // DmarcSuccessRatio: The ratio of mail that passed DMARC alignment + // checks vs all mail received from the domain that successfully + // authenticated with either of SPF or DKIM. DmarcSuccessRatio float64 `json:"dmarcSuccessRatio,omitempty"` // DomainReputation: Reputation of the domain. @@ -515,8 +508,7 @@ type TrafficStats struct { // InboundEncryptionRatio: The ratio of incoming mail (to Gmail), that // passed secure transport (TLS) vs all mail received from that domain. - // This metric only pertains to traffic that passed - // [SPF](http://www.openspf.org/) or [DKIM](http://www.dkim.org/). + // This metric only pertains to traffic that passed SPF or DKIM. InboundEncryptionRatio float64 `json:"inboundEncryptionRatio,omitempty"` // IpReputations: Reputation information pertaining to the IP addresses @@ -540,17 +532,17 @@ type TrafficStats struct { // SpammyFeedbackLoops: Spammy [Feedback loop identifiers] // (https://support.google.com/mail/answer/6254652) with their // individual spam rates. This metric only pertains to traffic that is - // authenticated by [DKIM](http://www.dkim.org/). + // authenticated by DKIM. SpammyFeedbackLoops []*FeedbackLoop `json:"spammyFeedbackLoops,omitempty"` // SpfSuccessRatio: The ratio of mail that successfully authenticated - // with SPF vs. all mail that attempted to authenticate with - // [SPF](http://www.openspf.org/). Spoofed mail is excluded. + // with SPF vs. all mail that attempted to authenticate with SPF. + // Spoofed mail is excluded. SpfSuccessRatio float64 `json:"spfSuccessRatio,omitempty"` // UserReportedSpamRatio: The ratio of user-report spam vs. email that // was sent to the inbox. This metric only pertains to emails - // authenticated by [DKIM](http://www.dkim.org/). + // authenticated by DKIM. UserReportedSpamRatio float64 `json:"userReportedSpamRatio,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/google-api-go-generator/gen.go b/google-api-go-generator/gen.go index e19e2730863..cb89308ec45 100644 --- a/google-api-go-generator/gen.go +++ b/google-api-go-generator/gen.go @@ -842,7 +842,7 @@ func (a *API) generateScopeConstants() { n++ ident := scopeIdentifier(scope) if scope.Description != "" { - a.p("%s", asComment("\t", scope.Description)) + a.p("%s", asComment("\t", removeMarkdownLinks(scope.Description))) } a.pn("\t%s = %q", ident, scope.ID) } @@ -905,7 +905,7 @@ func (p *Property) Default() string { } func (p *Property) Description() string { - return p.p.Schema.Description + return removeMarkdownLinks(p.p.Schema.Description) } func (p *Property) Enum() ([]string, bool) { @@ -1345,7 +1345,7 @@ func (s *Schema) writeVariant(api *API, v *disco.Variant) { } func (s *Schema) Description() string { - return s.typ.Description + return removeMarkdownLinks(s.typ.Description) } func (s *Schema) writeSchemaStruct(api *API) { @@ -1836,7 +1836,7 @@ func (meth *Method) generateCode() { pn(" header_ http.Header") pn("}") - p("\n%s", asComment("", methodName+": "+meth.m.Description)) + p("\n%s", asComment("", methodName+": "+removeMarkdownLinks(meth.m.Description))) if res != nil { if url := canonicalDocsURL[fmt.Sprintf("%v%v/%v", docsLink, res.Name, meth.m.Name)]; url != "" { pn("// For details, see %v", url) @@ -1889,7 +1889,7 @@ func (meth *Method) generateCode() { des := opt.p.Description des = strings.Replace(des, "Optional.", "", 1) des = strings.TrimSpace(des) - p("\n%s", asComment("", fmt.Sprintf("%s sets the optional parameter %q: %s", setter, opt.p.Name, des))) + p("\n%s", asComment("", fmt.Sprintf("%s sets the optional parameter %q: %s", setter, opt.p.Name, removeMarkdownLinks(des)))) addFieldValueComments(p, opt, "", true) np := new(namePool) np.Get("c") // take the receiver's name @@ -2370,7 +2370,7 @@ func (meth *Method) NewBodyArg(ds *disco.Schema) *argument { func (meth *Method) NewArg(apiname string, p *Param) *argument { apitype := p.p.Type - des := p.p.Description + des := removeMarkdownLinks(p.p.Description) goname := validGoIdentifer(apiname) // but might be changed later, if conflicts if strings.Contains(des, "identifier") && !strings.HasSuffix(strings.ToLower(goname), "id") { goname += "id" // yay @@ -2637,3 +2637,19 @@ func addFieldValueComments(p func(format string, args ...interface{}), field Fie p("%s", l) } } + +// markdownLinkRe is a non-greedy regex meant to find markdown style links. It +// also captures the name of the link. +var markdownLinkRe = regexp.MustCompile("([^`]|\\A)(\\[([^\\[]*?)]\\(.*?\\))([^`]|\\z)") + +func removeMarkdownLinks(input string) string { + out := input + sm := markdownLinkRe.FindAllStringSubmatch(input, -1) + if len(sm) == 0 { + return out + } + for _, match := range sm { + out = strings.Replace(out, match[2], match[3], 1) + } + return out +} diff --git a/google-api-go-generator/gen_test.go b/google-api-go-generator/gen_test.go index 1eda4b921cb..c581954d7dc 100644 --- a/google-api-go-generator/gen_test.go +++ b/google-api-go-generator/gen_test.go @@ -242,3 +242,30 @@ func TestIsNewerRevision(t *testing.T) { t.Fatalf("got %v, want %v", err, errOldRevision) } } + +func TestIt(t *testing.T) { + tests := []struct { + name string + input string + want string + }{ + {name: "basic", input: "[name](link)", want: "name"}, + {name: "no link", input: "name", want: "name"}, + {name: "empty string", input: "", want: ""}, + {name: "sentence", input: "This [is](link) a test.", want: "This is a test."}, + {name: "two links", input: "This [is](link) a [test](link).", want: "This is a test."}, + {name: "first incomplete link", input: "This [is] a [test](link).", want: "This [is] a test."}, + {name: "second incomplete link", input: "This [is](link) a (test).", want: "This is a (test)."}, + {name: "seperated", input: "This [is] (a) test.", want: "This [is] (a) test."}, + {name: "don't process code blocks", input: "This is `[a](link)` test.", want: "This is `[a](link)` test."}, + {name: "At start", input: "[This](link) is a test.", want: "This is a test."}, + {name: "At end ", input: "This is a [test.](link)", want: "This is a test."}, + } + for _, tc := range tests { + t.Run(tc.name, func(t *testing.T) { + if got := removeMarkdownLinks(tc.input); got != tc.want { + t.Errorf("removeMarkdownLinks(%q) = %q, want %q", tc.input, got, tc.want) + } + }) + } +} diff --git a/healthcare/v1/healthcare-gen.go b/healthcare/v1/healthcare-gen.go index c74b09d7d7d..294d0624aa9 100644 --- a/healthcare/v1/healthcare-gen.go +++ b/healthcare/v1/healthcare-gen.go @@ -393,9 +393,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1198,16 +1196,14 @@ type FhirStore struct { // read the historical versions. DisableResourceVersioning bool `json:"disableResourceVersioning,omitempty"` - // EnableUpdateCreate: Whether this FHIR store has the [updateCreate - // capability](https://www.hl7.org/fhir/capabilitystatement-definitions.h - // tml#CapabilityStatement.rest.resource.updateCreate). This determines - // if the client can use an Update operation to create a new resource - // with a client-specified ID. If false, all IDs are server-assigned - // through the Create operation and attempts to update a non-existent - // resource return errors. Be careful with the audit logs if - // client-specified resource IDs contain sensitive data such as patient - // identifiers, those IDs are part of the FHIR resource path recorded in - // Cloud audit logs and Cloud Pub/Sub notifications. + // EnableUpdateCreate: Whether this FHIR store has the updateCreate + // capability. This determines if the client can use an Update operation + // to create a new resource with a client-specified ID. If false, all + // IDs are server-assigned through the Create operation and attempts to + // update a non-existent resource return errors. Be careful with the + // audit logs if client-specified resource IDs contain sensitive data + // such as patient identifiers, those IDs are part of the FHIR resource + // path recorded in Cloud audit logs and Cloud Pub/Sub notifications. EnableUpdateCreate bool `json:"enableUpdateCreate,omitempty"` // Labels: User-supplied key-value pairs used to organize FHIR stores. @@ -1238,12 +1234,10 @@ type FhirStore struct { // to the new location in addition to the existing ones. When a location // is removed from the list, the server stops streaming to that // location. Before adding a new config, you must add the required - // [`bigquery.dataEditor`](https://cloud.google.com/bigquery/docs/access- - // control#bigquery.dataEditor) role to your project's **Cloud - // Healthcare Service Agent** [service - // account](https://cloud.google.com/iam/docs/service-accounts). Some - // lag (typically on the order of dozens of seconds) is expected before - // the results show up in the streaming destination. + // `bigquery.dataEditor` role to your project's **Cloud Healthcare + // Service Agent** service account. Some lag (typically on the order of + // dozens of seconds) is expected before the results show up in the + // streaming destination. StreamConfigs []*StreamConfig `json:"streamConfigs,omitempty"` // Version: Immutable. The FHIR specification version that this FHIR @@ -1608,25 +1602,21 @@ type Hl7V2NotificationConfig struct { // `labels."priority":*`. Filter string `json:"filter,omitempty"` - // PubsubTopic: The [Cloud - // Pub/Sub](https://cloud.google.com/pubsub/docs/) topic that - // notifications of changes are published on. Supplied by the client. - // The notification is a `PubsubMessage` with the following fields: * - // `PubsubMessage.Data` contains the resource name. * - // `PubsubMessage.MessageId` is the ID of this notification. It's - // guaranteed to be unique within the topic. * + // PubsubTopic: The Cloud Pub/Sub topic that notifications of changes + // are published on. Supplied by the client. The notification is a + // `PubsubMessage` with the following fields: * `PubsubMessage.Data` + // contains the resource name. * `PubsubMessage.MessageId` is the ID of + // this notification. It's guaranteed to be unique within the topic. * // `PubsubMessage.PublishTime` is the time when the message was // published. Note that notifications are only sent if the topic is - // non-empty. [Topic - // names](https://cloud.google.com/pubsub/docs/overview#names) must be - // scoped to a project. The Cloud Healthcare API service account, + // non-empty. Topic names must be scoped to a project. The Cloud + // Healthcare API service account, // service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com, // must have publisher permissions on the given Pub/Sub topic. Not // having adequate permissions causes the calls that send notifications // to fail. If a notification cannot be published to Cloud Pub/Sub, - // errors are logged to Cloud Logging. For more information, see - // [Viewing error logs in Cloud - // Logging](/healthcare/docs/how-tos/logging)). + // errors are logged to Cloud Logging. For more information, see Viewing + // error logs in Cloud Logging). PubsubTopic string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "Filter") to @@ -2403,25 +2393,20 @@ func (s *Message) MarshalJSON() ([]byte, error) { // NotificationConfig: Specifies where to send notifications upon // changes to a data store. type NotificationConfig struct { - // PubsubTopic: The [Cloud - // Pub/Sub](https://cloud.google.com/pubsub/docs/) topic that - // notifications of changes are published on. Supplied by the client. - // PubsubMessage.Data contains the resource name. - // PubsubMessage.MessageId is the ID of this message. It is guaranteed - // to be unique within the topic. PubsubMessage.PublishTime is the time - // at which the message was published. Notifications are only sent if - // the topic is non-empty. [Topic - // names](https://cloud.google.com/pubsub/docs/overview#names) must be - // scoped to a project. Cloud Healthcare API service account must have - // publisher permissions on the given Cloud Pub/Sub topic. Not having - // adequate permissions causes the calls that send notifications to - // fail. If a notification can't be published to Cloud Pub/Sub, errors - // are logged to Cloud Logging (see [Viewing - // logs](/healthcare/docs/how-tos/logging)). If the number of errors - // exceeds a certain rate, some aren't submitted. Note that not all - // operations trigger notifications, see [Configuring Pub/Sub - // notifications](https://cloud.google.com/healthcare/docs/how-tos/pubsub - // ) for specific details. + // PubsubTopic: The Cloud Pub/Sub topic that notifications of changes + // are published on. Supplied by the client. PubsubMessage.Data contains + // the resource name. PubsubMessage.MessageId is the ID of this message. + // It is guaranteed to be unique within the topic. + // PubsubMessage.PublishTime is the time at which the message was + // published. Notifications are only sent if the topic is non-empty. + // Topic names must be scoped to a project. Cloud Healthcare API service + // account must have publisher permissions on the given Cloud Pub/Sub + // topic. Not having adequate permissions causes the calls that send + // notifications to fail. If a notification can't be published to Cloud + // Pub/Sub, errors are logged to Cloud Logging (see Viewing logs). If + // the number of errors exceeds a certain rate, some aren't submitted. + // Note that not all operations trigger notifications, see Configuring + // Pub/Sub notifications for specific details. PubsubTopic string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "PubsubTopic") to @@ -2530,8 +2515,7 @@ type OperationMetadata struct { EndTime string `json:"endTime,omitempty"` // LogsUrl: A link to audit and error logs in the log viewer. Error logs - // are generated only by some operations, listed at [Viewing - // logs](/healthcare/docs/how-tos/logging). + // are generated only by some operations, listed at Viewing logs. LogsUrl string `json:"logsUrl,omitempty"` // ForceSendFields is a list of field names (e.g. "ApiMethodName") to @@ -2661,9 +2645,8 @@ func (s *PatientId) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2681,8 +2664,8 @@ func (s *PatientId) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2721,9 +2704,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2884,12 +2866,8 @@ func (s *SchemaConfig) MarshalJSON() ([]byte, error) { // specified FHIR store. type SearchResourcesRequest struct { // ResourceType: 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.ht - // ml), - // [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html) - // , - // [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)). + // Observation. For a complete list, see the FHIR Resource Index (DSTU2, + // STU3, R4). ResourceType string `json:"resourceType,omitempty"` // ForceSendFields is a list of field names (e.g. "ResourceType") to @@ -2999,11 +2977,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3072,8 +3049,7 @@ type StreamConfig struct { // and meta.versionId pair. Alternatively, the server created view // mentioned above also filters out duplicates. If a resource mutation // cannot be streamed to BigQuery, errors are logged to Cloud Logging. - // For more information, see [Viewing error logs in Cloud - // Logging](/healthcare/docs/how-tos/logging)). + // For more information, see Viewing error logs in Cloud Logging). BigqueryDestination *GoogleCloudHealthcareV1FhirBigQueryDestination `json:"bigqueryDestination,omitempty"` // ResourceTypes: Supply a FHIR resource type (such as "Patient" or @@ -3143,8 +3119,7 @@ func (s *TagFilterList) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3754,8 +3729,7 @@ type ProjectsLocationsDatasetsDeidentifyCall struct { // instances. The new de-identified dataset will not contain these // failed resources. Failed resource totals are tracked in // Operation.metadata. Error details are also logged to Cloud Logging. -// For more information, see [Viewing -// logs](/healthcare/docs/how-tos/logging). +// For more information, see Viewing logs. func (r *ProjectsLocationsDatasetsService) Deidentify(sourceDataset string, deidentifydatasetrequest *DeidentifyDatasetRequest) *ProjectsLocationsDatasetsDeidentifyCall { c := &ProjectsLocationsDatasetsDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceDataset = sourceDataset @@ -4187,9 +4161,7 @@ func (r *ProjectsLocationsDatasetsService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsDatasetsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -5130,8 +5102,7 @@ type ProjectsLocationsDatasetsDicomStoresDeidentifyCall struct { // result may still be successful if de-identification fails for some // DICOM instances. The output DICOM store will not contain these failed // resources. Failed resource totals are tracked in Operation.metadata. -// Error details are also logged to Cloud Logging (see [Viewing -// logs](/healthcare/docs/how-tos/logging)). +// Error details are also logged to Cloud Logging (see Viewing logs). func (r *ProjectsLocationsDatasetsDicomStoresService) Deidentify(sourceStore string, deidentifydicomstorerequest *DeidentifyDicomStoreRequest) *ProjectsLocationsDatasetsDicomStoresDeidentifyCall { c := &ProjectsLocationsDatasetsDicomStoresDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceStore = sourceStore @@ -5404,8 +5375,8 @@ type ProjectsLocationsDatasetsDicomStoresExportCall struct { // Export: Exports data to the specified destination by copying it from // the DICOM store. Errors are also logged to Cloud Logging. For more -// information, see [Viewing logs](/healthcare/docs/how-tos/logging). -// The metadata field type is OperationMetadata. +// information, see Viewing logs. The metadata field type is +// OperationMetadata. func (r *ProjectsLocationsDatasetsDicomStoresService) Export(name string, exportdicomdatarequest *ExportDicomDataRequest) *ProjectsLocationsDatasetsDicomStoresExportCall { c := &ProjectsLocationsDatasetsDicomStoresExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -5705,9 +5676,7 @@ func (r *ProjectsLocationsDatasetsDicomStoresService) GetIamPolicy(resource stri // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsDatasetsDicomStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsDicomStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -5858,8 +5827,8 @@ type ProjectsLocationsDatasetsDicomStoresImportCall struct { // Import: Imports data into the DICOM store by copying it from the // specified source. Errors are logged to Cloud Logging. For more -// information, see [Viewing logs](/healthcare/docs/how-tos/logging). -// The metadata field type is OperationMetadata. +// information, see Viewing logs. The metadata field type is +// OperationMetadata. func (r *ProjectsLocationsDatasetsDicomStoresService) Import(name string, importdicomdatarequest *ImportDicomDataRequest) *ProjectsLocationsDatasetsDicomStoresImportCall { c := &ProjectsLocationsDatasetsDicomStoresImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6364,13 +6333,9 @@ type ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall struct { // instances. See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForInstances, -// see [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForInstances, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// see Search transaction in the Cloud Healthcare API conformance +// statement. For samples that show how to call SearchForInstances, see +// Searching for studies, series, instances, and frames. func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6496,13 +6461,9 @@ type ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall struct { // See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForSeries, see -// [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForSeries, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// Search transaction in the Cloud Healthcare API conformance statement. +// For samples that show how to call SearchForSeries, see Searching for +// studies, series, instances, and frames. func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6628,13 +6589,9 @@ type ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall struct { // studies. See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForStudies, see -// [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForStudies, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// Search transaction in the Cloud Healthcare API conformance statement. +// For samples that show how to call SearchForStudies, see Searching for +// studies, series, instances, and frames. func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForStudies(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6902,12 +6859,9 @@ type ProjectsLocationsDatasetsDicomStoresStoreInstancesCall struct { // study instance unique identifiers (SUID). See [Store Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.5). For details on the implementation of StoreInstances, see -// [Store -// transaction](https://cloud.google.com/healthcare/docs/dicom#store_tran -// saction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call StoreInstances, see [Storing DICOM -// data](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storin -// g_dicom_data). +// Store transaction in the Cloud Healthcare API conformance statement. +// For samples that show how to call StoreInstances, see Storing DICOM +// data. func (r *ProjectsLocationsDatasetsDicomStoresService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7170,9 +7124,7 @@ type ProjectsLocationsDatasetsDicomStoresStudiesDeleteCall struct { // instances into a study while a delete operation is running for that // study could result in the new instances not appearing in search // results until the deletion operation finishes. For samples that show -// how to call DeleteStudy, see [Deleting a study, series, or -// instance](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#de -// leting_a_study_series_or_instance). +// how to call DeleteStudy, see Deleting a study, series, or instance. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7318,12 +7270,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall struct { // removed. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of -// RetrieveStudyMetadata, see [Metadata -// resources](https://cloud.google.com/healthcare/docs/dicom#metadata_res -// ources) in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveStudyMetadata, see [Retrieving -// metadata](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#re -// trieving_metadata). +// RetrieveStudyMetadata, see Metadata resources in the Cloud Healthcare +// API conformance statement. For samples that show how to call +// RetrieveStudyMetadata, see Retrieving metadata. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7449,13 +7398,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall struct { // study. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of RetrieveStudy, see -// [DICOM -// study/series/instances](https://cloud.google.com/healthcare/docs/dicom -// #dicom_studyseriesinstances) in the Cloud Healthcare API conformance +// DICOM study/series/instances in the Cloud Healthcare API conformance // statement. For samples that show how to call RetrieveStudy, see -// [Retrieving DICOM -// data](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrie -// ving_dicom_data). +// Retrieving DICOM data. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveStudy(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7581,13 +7526,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall struct { // instances. See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForInstances, -// see [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForInstances, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// see Search transaction in the Cloud Healthcare API conformance +// statement. For samples that show how to call SearchForInstances, see +// Searching for studies, series, instances, and frames. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7713,13 +7654,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall struct { // See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForSeries, see -// [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForSeries, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// Search transaction in the Cloud Healthcare API conformance statement. +// For samples that show how to call SearchForSeries, see Searching for +// studies, series, instances, and frames. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7845,12 +7782,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall struct { // study instance unique identifiers (SUID). See [Store Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.5). For details on the implementation of StoreInstances, see -// [Store -// transaction](https://cloud.google.com/healthcare/docs/dicom#store_tran -// saction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call StoreInstances, see [Storing DICOM -// data](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storin -// g_dicom_data). +// Store transaction in the Cloud Healthcare API conformance statement. +// For samples that show how to call StoreInstances, see Storing DICOM +// data. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7968,9 +7902,8 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesDeleteCall struct { // Inserting instances into a series while a delete operation is running // for that series could result in the new instances not appearing in // search results until the deletion operation finishes. For samples -// that show how to call DeleteSeries, see [Deleting a study, series, or -// instance](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#de -// leting_a_study_series_or_instance). +// that show how to call DeleteSeries, see Deleting a study, series, or +// instance. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8117,12 +8050,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall struc // data removed. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of -// RetrieveSeriesMetadata, see [Metadata -// resources](https://cloud.google.com/healthcare/docs/dicom#metadata_res -// ources) in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveSeriesMetadata, see [Retrieving -// metadata](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#re -// trieving_metadata). +// RetrieveSeriesMetadata, see Metadata resources in the Cloud +// Healthcare API conformance statement. For samples that show how to +// call RetrieveSeriesMetadata, see Retrieving metadata. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8248,13 +8178,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall struct // study and series. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of RetrieveSeries, see -// [DICOM -// study/series/instances](https://cloud.google.com/healthcare/docs/dicom -// #dicom_studyseriesinstances) in the Cloud Healthcare API conformance +// DICOM study/series/instances in the Cloud Healthcare API conformance // statement. For samples that show how to call RetrieveSeries, see -// [Retrieving DICOM -// data](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrie -// ving_dicom_data). +// Retrieving DICOM data. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8380,13 +8306,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall str // instances. See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForInstances, -// see [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForInstances, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// see Search transaction in the Cloud Healthcare API conformance +// statement. For samples that show how to call SearchForInstances, see +// Searching for studies, series, instances, and frames. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8512,9 +8434,7 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall struct // to the GET requests specified in the Retrieve transaction. Study and // series search results can take a few seconds to be updated after an // instance is deleted using DeleteInstance. For samples that show how -// to call DeleteInstance, see [Deleting a study, series, or -// instance](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#de -// leting_a_study_series_or_instance). +// to call DeleteInstance, see Deleting a study, series, or instance. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8661,14 +8581,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceC // [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of RetrieveInstance, see -// [DICOM -// study/series/instances](https://cloud.google.com/healthcare/docs/dicom -// #dicom_studyseriesinstances) and [DICOM -// instances](https://cloud.google.com/healthcare/docs/dicom#dicom_instan -// ces) in the Cloud Healthcare API conformance statement. For samples -// that show how to call RetrieveInstance, see [Retrieving an -// instance](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#re -// trieving_an_instance). +// DICOM study/series/instances and DICOM instances in the Cloud +// Healthcare API conformance statement. For samples that show how to +// call RetrieveInstance, see Retrieving an instance. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveInstance(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8796,13 +8711,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataC // [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of -// RetrieveInstanceMetadata, see [Metadata -// resources](https://cloud.google.com/healthcare/docs/dicom#metadata_res -// ources) in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveInstanceMetadata, see -// [Retrieving -// metadata](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#re -// trieving_metadata). +// RetrieveInstanceMetadata, see Metadata resources in the Cloud +// Healthcare API conformance statement. For samples that show how to +// call RetrieveInstanceMetadata, see Retrieving metadata. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8929,13 +8840,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedC // acceptable Rendered Media Type. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of -// RetrieveRenderedInstance, see [Rendered -// resources](https://cloud.google.com/healthcare/docs/dicom#rendered_res -// ources) in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveRenderedInstance, see -// [Retrieving consumer image -// formats](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#ret -// rieving_consumer_image_formats). +// RetrieveRenderedInstance, see Rendered resources in the Cloud +// Healthcare API conformance statement. For samples that show how to +// call RetrieveRenderedInstance, see Retrieving consumer image formats. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9062,12 +8969,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFra // [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4}. For details on the implementation of RetrieveFrames, see -// [DICOM -// frames](https://cloud.google.com/healthcare/docs/dicom#dicom_frames) -// in the Cloud Healthcare API conformance statement. For samples that -// show how to call RetrieveFrames, see [Retrieving DICOM -// data](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrie -// ving_dicom_data). +// DICOM frames in the Cloud Healthcare API conformance statement. For +// samples that show how to call RetrieveFrames, see Retrieving DICOM +// data. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveFrames(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9194,13 +9098,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRen // an acceptable Rendered Media Type. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of -// RetrieveRenderedFrames, see [Rendered -// resources](https://cloud.google.com/healthcare/docs/dicom#rendered_res -// ources) in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveRenderedFrames, see [Retrieving -// consumer image -// formats](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#ret -// rieving_consumer_image_formats). +// RetrieveRenderedFrames, see Rendered resources in the Cloud +// Healthcare API conformance statement. For samples that show how to +// call RetrieveRenderedFrames, see Retrieving consumer image formats. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9478,8 +9378,7 @@ type ProjectsLocationsDatasetsFhirStoresDeidentifyCall struct { // the destination store. The metadata field type is OperationMetadata. // If the request is successful, the response field type is // DeidentifyFhirStoreSummary. If errors occur, error is set. Error -// details are also logged to Cloud Logging (see [Viewing -// logs](/healthcare/docs/how-tos/logging)). +// details are also logged to Cloud Logging (see Viewing logs). func (r *ProjectsLocationsDatasetsFhirStoresService) Deidentify(sourceStore string, deidentifyfhirstorerequest *DeidentifyFhirStoreRequest) *ProjectsLocationsDatasetsFhirStoresDeidentifyCall { c := &ProjectsLocationsDatasetsFhirStoresDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceStore = sourceStore @@ -9754,10 +9653,10 @@ type ProjectsLocationsDatasetsFhirStoresExportCall struct { // destination. This method returns an Operation that can be used to // track the status of the export by calling GetOperation. Immediate // fatal errors appear in the error field, errors are also logged to -// Cloud Logging (see [Viewing logs](/healthcare/docs/how-tos/logging)). -// Otherwise, when the operation finishes, a detailed response of type -// ExportResourcesResponse is returned in the response field. The -// metadata field type for this operation is OperationMetadata. +// Cloud Logging (see Viewing logs). Otherwise, when the operation +// finishes, a detailed response of type ExportResourcesResponse is +// returned in the response field. The metadata field type for this +// operation is OperationMetadata. func (r *ProjectsLocationsDatasetsFhirStoresService) Export(name string, exportresourcesrequest *ExportResourcesRequest) *ProjectsLocationsDatasetsFhirStoresExportCall { c := &ProjectsLocationsDatasetsFhirStoresExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -10057,9 +9956,7 @@ func (r *ProjectsLocationsDatasetsFhirStoresService) GetIamPolicy(resource strin // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsDatasetsFhirStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsFhirStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -10258,9 +10155,8 @@ type ProjectsLocationsDatasetsFhirStoresImportCall struct { // by a FHIR search or Patient-everything operation. This method returns // an Operation that can be used to track the status of the import by // calling GetOperation. Immediate fatal errors appear in the error -// field, errors are also logged to Cloud Logging (see [Viewing -// logs](/healthcare/docs/how-tos/logging)). Otherwise, when the -// operation finishes, a detailed response of type +// field, errors are also logged to Cloud Logging (see Viewing logs). +// Otherwise, when the operation finishes, a detailed response of type // ImportResourcesResponse is returned in the response field. The // metadata field type for this operation is OperationMetadata. func (r *ProjectsLocationsDatasetsFhirStoresService) Import(name string, importresourcesrequest *ImportResourcesRequest) *ProjectsLocationsDatasetsFhirStoresImportCall { @@ -11051,15 +10947,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall struct { // PatientEverything: Retrieves a Patient resource and resources related // to that patient. Implements the FHIR extended operation -// Patient-everything -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/patient-operati -// ons.html#everything), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/patient-operations -// .html#everything), -// [R4](http://hl7.org/implement/standards/fhir/R4/patient-operations.htm -// l#everything)). On success, the response body will contain a -// JSON-encoded representation of a `Bundle` resource of type -// `searchset`, containing the results of the operation. Errors +// Patient-everything (DSTU2, STU3, R4). On success, the response body +// will contain a JSON-encoded representation of a `Bundle` resource of +// type `searchset`, containing the results of the operation. Errors // generated by the FHIR store will contain a JSON-encoded // `OperationOutcome` resource describing the reason for the error. If // the request cannot be mapped to a valid API method on a FHIR store, a @@ -11068,15 +10958,10 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall struct { // resources directly referenced by the patient resource. * Resources // directly referencing the patient resource that meet the inclusion // criteria. The inclusion criteria are based on the membership rules in -// the patient compartment definition -// ([DSTU2](http://hl7.org/fhir/DSTU2/compartment-patient.html), -// [STU3](http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html -// ), [R4](http://hl7.org/fhir/R4/compartmentdefinition-patient.html)), -// which details the eligible resource types and referencing search -// parameters. For samples that show how to call `Patient-everything`, -// see [Getting all patient compartment -// resources](/healthcare/docs/how-tos/fhir-resources#getting_all_patient -// _compartment_resources). +// the patient compartment definition (DSTU2, STU3, R4), which details +// the eligible resource types and referencing search parameters. For +// samples that show how to call `Patient-everything`, see Getting all +// patient compartment resources. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) PatientEverything(name string) *ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall { c := &ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11274,10 +11159,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall struct { // (excluding the current version) from the FHIR store. To remove all // versions of a resource, first delete the current version and then // call this method. This is not a FHIR standard operation. For samples -// that show how to call `Resource-purge`, see [Deleting historical -// versions of a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#deleting_historical_ -// versions_of_a_fhir_resource). +// that show how to call `Resource-purge`, see Deleting historical +// versions of a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ResourcePurge(name string) *ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall { c := &ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11408,23 +11291,13 @@ type ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall struct { header_ http.Header } -// Capabilities: Gets the FHIR capability statement -// ([STU3](http://hl7.org/implement/standards/fhir/STU3/capabilitystateme -// nt.html), -// [R4](http://hl7.org/implement/standards/fhir/R4/capabilitystatement.ht -// ml)), or the [conformance -// statement](http://hl7.org/implement/standards/fhir/DSTU2/conformance.h -// tml) in the DSTU2 case for the store, which contains a description of -// functionality supported by the server. Implements the FHIR standard -// capabilities interaction -// ([STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#capabil -// ities), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#capabilities -// )), or the [conformance -// interaction](http://hl7.org/implement/standards/fhir/DSTU2/http.html#c -// onformance) in the DSTU2 case. On success, the response body will -// contain a JSON-encoded representation of a `CapabilityStatement` -// resource. +// Capabilities: Gets the FHIR capability statement (STU3, R4), or the +// conformance statement in the DSTU2 case for the store, which contains +// a description of functionality supported by the server. Implements +// the FHIR standard capabilities interaction (STU3, R4), or the +// conformance interaction in the DSTU2 case. On success, the response +// body will contain a JSON-encoded representation of a +// `CapabilityStatement` resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Capabilities(name string) *ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall { c := &ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11537,24 +11410,17 @@ type ProjectsLocationsDatasetsFhirStoresFhirCreateCall struct { } // Create: Creates a FHIR resource. Implements the FHIR standard create -// interaction -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#creat -// e), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#create), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#create)), -// which creates a new resource with a server-assigned resource ID. The -// request body must contain a JSON-encoded FHIR resource, and the -// request headers must contain `Content-Type: application/fhir+json`. -// On success, the response body will contain a JSON-encoded -// representation of the resource as it was created on the server, -// including the server-assigned resource ID and version ID. Errors -// generated by the FHIR store will contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. For samples that show -// how to call `create`, see [Creating a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#creating_a_fhir_reso -// urce). +// interaction (DSTU2, STU3, R4), which creates a new resource with a +// server-assigned resource ID. The request body must contain a +// JSON-encoded FHIR resource, and the request headers must contain +// `Content-Type: application/fhir+json`. On success, the response body +// will contain a JSON-encoded representation of the resource as it was +// created on the server, including the server-assigned resource ID and +// version ID. Errors generated by the FHIR store will contain a +// JSON-encoded `OperationOutcome` resource describing the reason for +// the error. If the request cannot be mapped to a valid API method on a +// FHIR store, a generic GCP error might be returned instead. For +// samples that show how to call `create`, see Creating a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Create(parent string, type_ string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirCreateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11665,19 +11531,12 @@ type ProjectsLocationsDatasetsFhirStoresFhirDeleteCall struct { } // Delete: Deletes a FHIR resource. Implements the FHIR standard delete -// interaction -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#delet -// e), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#delete), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#delete)). -// Note: Unless resource versioning is disabled by setting the -// disable_resource_versioning flag on the FHIR store, the deleted -// resources will be moved to a history repository that can still be -// retrieved through vread and related methods, unless they are removed -// by the purge method. For samples that show how to call `delete`, see -// [Deleting a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#deleting_a_fhir_reso -// urce). +// interaction (DSTU2, STU3, R4). Note: Unless resource versioning is +// disabled by setting the disable_resource_versioning flag on the FHIR +// store, the deleted resources will be moved to a history repository +// that can still be retrieved through vread and related methods, unless +// they are removed by the purge method. For samples that show how to +// call `delete`, see Deleting a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Delete(name string) *ProjectsLocationsDatasetsFhirStoresFhirDeleteCall { c := &ProjectsLocationsDatasetsFhirStoresFhirDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11776,39 +11635,23 @@ type ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall struct { } // ExecuteBundle: Executes all the requests in the given Bundle. -// Implements the FHIR standard batch/transaction interaction -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#trans -// action), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#transact -// ion), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#transaction) -// ). Supports all interactions within a bundle, except search. This -// method accepts Bundles of type `batch` and `transaction`, processing -// them according to the batch processing rules -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0 -// .16.1), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.1 -// 7.1), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#brules)) -// and transaction processing rules -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0 -// .16.2), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.1 -// 7.2), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#trules)). -// The request body must contain a JSON-encoded FHIR `Bundle` resource, -// and the request headers must contain `Content-Type: -// application/fhir+json`. For a batch bundle or a successful -// transaction the response body will contain a JSON-encoded -// representation of a `Bundle` resource of type `batch-response` or -// `transaction-response` containing one entry for each entry in the -// request, with the outcome of processing the entry. In the case of an -// error for a transaction bundle, the response body will contain a -// JSON-encoded `OperationOutcome` resource describing the reason for -// the error. If the request cannot be mapped to a valid API method on a -// FHIR store, a generic GCP error might be returned instead. For -// samples that show how to call `executeBundle`, see [Managing FHIR -// resources using FHIR bundles](/healthcare/docs/how-tos/fhir-bundles). +// Implements the FHIR standard batch/transaction interaction (DSTU2, +// STU3, R4). Supports all interactions within a bundle, except search. +// This method accepts Bundles of type `batch` and `transaction`, +// processing them according to the batch processing rules (DSTU2, STU3, +// R4) and transaction processing rules (DSTU2, STU3, R4). The request +// body must contain a JSON-encoded FHIR `Bundle` resource, and the +// request headers must contain `Content-Type: application/fhir+json`. +// For a batch bundle or a successful transaction the response body will +// contain a JSON-encoded representation of a `Bundle` resource of type +// `batch-response` or `transaction-response` containing one entry for +// each entry in the request, with the outcome of processing the entry. +// In the case of an error for a transaction bundle, the response body +// will contain a JSON-encoded `OperationOutcome` resource describing +// the reason for the error. If the request cannot be mapped to a valid +// API method on a FHIR store, a generic GCP error might be returned +// instead. For samples that show how to call `executeBundle`, see +// Managing FHIR resources using FHIR bundles. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ExecuteBundle(parent string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall { c := &ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11911,22 +11754,15 @@ type ProjectsLocationsDatasetsFhirStoresFhirHistoryCall struct { // History: Lists all the versions of a resource (including the current // version and deleted versions) from the FHIR store. Implements the -// per-resource form of the FHIR standard history interaction -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#histo -// ry), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#history) -// , -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#history)). -// On success, the response body will contain a JSON-encoded +// per-resource form of the FHIR standard history interaction (DSTU2, +// STU3, R4). On success, the response body will contain a JSON-encoded // representation of a `Bundle` resource of type `history`, containing // the version history sorted from most recent to oldest versions. // Errors generated by the FHIR store will contain a JSON-encoded // `OperationOutcome` resource describing the reason for the error. If // the request cannot be mapped to a valid API method on a FHIR store, a // generic GCP error might be returned instead. For samples that show -// how to call `history`, see [Listing FHIR resource -// versions](/healthcare/docs/how-tos/fhir-resources#listing_fhir_resourc -// e_versions). +// how to call `history`, see Listing FHIR resource versions. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) History(name string) *ProjectsLocationsDatasetsFhirStoresFhirHistoryCall { c := &ProjectsLocationsDatasetsFhirStoresFhirHistoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12101,23 +11937,18 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatchCall struct { } // Patch: Updates part of an existing resource by applying the -// operations specified in a [JSON Patch](http://jsonpatch.com/) -// document. Implements the FHIR standard patch interaction -// ([STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#patch), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#patch)). -// DSTU2 doesn't define a patch method, but the server supports it in -// the same way it supports STU3. The request body must contain a JSON -// Patch document, and the request headers must contain `Content-Type: -// application/json-patch+json`. On success, the response body will -// contain a JSON-encoded representation of the updated resource, -// including the server-assigned version ID. Errors generated by the -// FHIR store will contain a JSON-encoded `OperationOutcome` resource -// describing the reason for the error. If the request cannot be mapped -// to a valid API method on a FHIR store, a generic GCP error might be -// returned instead. For samples that show how to call `patch`, see -// [Patching a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#patching_a_fhir_reso -// urce). +// operations specified in a JSON Patch document. Implements the FHIR +// standard patch interaction (STU3, R4). DSTU2 doesn't define a patch +// method, but the server supports it in the same way it supports STU3. +// The request body must contain a JSON Patch document, and the request +// headers must contain `Content-Type: application/json-patch+json`. On +// success, the response body will contain a JSON-encoded representation +// of the updated resource, including the server-assigned version ID. +// Errors generated by the FHIR store will contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. For samples that show +// how to call `patch`, see Patching a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Patch(name string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirPatchCall { c := &ProjectsLocationsDatasetsFhirStoresFhirPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12219,26 +12050,16 @@ type ProjectsLocationsDatasetsFhirStoresFhirReadCall struct { } // Read: Gets the contents of a FHIR resource. Implements the FHIR -// standard read interaction -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#read) -// , -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#read), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#read)). -// Also supports the FHIR standard conditional read interaction -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#cread -// ), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#cread), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#cread)) -// specified by supplying an `If-Modified-Since` header with a date/time -// value or an `If-None-Match` header with an ETag value. On success, -// the response body will contain a JSON-encoded representation of the -// resource. Errors generated by the FHIR store will contain a -// JSON-encoded `OperationOutcome` resource describing the reason for -// the error. If the request cannot be mapped to a valid API method on a -// FHIR store, a generic GCP error might be returned instead. For -// samples that show how to call `read`, see [Getting a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#getting_a_fhir_resou -// rce). +// standard read interaction (DSTU2, STU3, R4). Also supports the FHIR +// standard conditional read interaction (DSTU2, STU3, R4) specified by +// supplying an `If-Modified-Since` header with a date/time value or an +// `If-None-Match` header with an ETag value. On success, the response +// body will contain a JSON-encoded representation of the resource. +// Errors generated by the FHIR store will contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. For samples that show +// how to call `read`, see Getting a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Read(name string) *ProjectsLocationsDatasetsFhirStoresFhirReadCall { c := &ProjectsLocationsDatasetsFhirStoresFhirReadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12351,15 +12172,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // Search: Searches for resources in the given FHIR store according to // criteria specified as query parameters. Implements the FHIR standard -// search interaction -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#searc -// h), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#search), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#search)) -// using the search semantics described in the FHIR Search specification -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/search.html), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/search.html), -// [R4](http://hl7.org/implement/standards/fhir/R4/search.html)). +// search interaction (DSTU2, STU3, R4) using the search semantics +// described in the FHIR Search specification (DSTU2, STU3, R4). // Supports three methods of search defined by the specification: * `GET // [base]?[parameters]` to search across all resources. * `GET // [base]/[type]?[parameters]` to search resources of a specified type. @@ -12376,28 +12190,23 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // server's capability statement, retrieved through capabilities, // indicates what search parameters are supported on each FHIR resource. // A list of all search parameters defined by the specification can be -// found in the FHIR Search Parameter Registry -// ([STU3](http://hl7.org/implement/standards/fhir/STU3/searchparameter-r -// egistry.html), -// [R4](http://hl7.org/implement/standards/fhir/R4/searchparameter-regist -// ry.html)). FHIR search parameters for DSTU2 can be found on each -// resource's definition page. Supported search modifiers: `:missing`, -// `:exact`, `:contains`, `:text`, `:in`, `:not-in`, `:above`, `:below`, -// `:[type]`, `:not`, and `:recurse`. Supported search result -// parameters: `_sort`, `_count`, `_include`, `_revinclude`, -// `_summary=text`, `_summary=data`, and `_elements`. The maximum number -// of search results returned defaults to 100, which can be overridden -// by the `_count` parameter up to a maximum limit of 1000. If there are -// additional results, the returned `Bundle` will contain pagination -// links. Resources with a total size larger than 5MB or a field count -// larger than 50,000 might not be fully searchable as the server might -// trim its generated search index in those cases. Note: FHIR resources -// are indexed asynchronously, so there might be a slight delay between -// the time a resource is created or changes and when the change is -// reflected in search results. For samples and detailed information, -// see [Searching for FHIR -// resources](/healthcare/docs/how-tos/fhir-search) and [Advanced FHIR -// search features](/healthcare/docs/how-tos/fhir-advanced-search). +// found in the FHIR Search Parameter Registry (STU3, R4). FHIR search +// parameters for DSTU2 can be found on each resource's definition page. +// Supported search modifiers: `:missing`, `:exact`, `:contains`, +// `:text`, `:in`, `:not-in`, `:above`, `:below`, `:[type]`, `:not`, and +// `:recurse`. Supported search result parameters: `_sort`, `_count`, +// `_include`, `_revinclude`, `_summary=text`, `_summary=data`, and +// `_elements`. The maximum number of search results returned defaults +// to 100, which can be overridden by the `_count` parameter up to a +// maximum limit of 1000. If there are additional results, the returned +// `Bundle` will contain pagination links. Resources with a total size +// larger than 5MB or a field count larger than 50,000 might not be +// fully searchable as the server might trim its generated search index +// in those cases. Note: FHIR resources are indexed asynchronously, so +// there might be a slight delay between the time a resource is created +// or changes and when the change is reflected in search results. For +// samples and detailed information, see Searching for FHIR resources +// and Advanced FHIR search features. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Search(parent string, searchresourcesrequest *SearchResourcesRequest) *ProjectsLocationsDatasetsFhirStoresFhirSearchCall { c := &ProjectsLocationsDatasetsFhirStoresFhirSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12505,26 +12314,20 @@ type ProjectsLocationsDatasetsFhirStoresFhirUpdateCall struct { } // Update: Updates the entire contents of a resource. Implements the -// FHIR standard update interaction -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#updat -// e), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#update), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#update)). -// If the specified resource does not exist and the FHIR store has -// enable_update_create set, creates the resource with the -// client-specified ID. The request body must contain a JSON-encoded -// FHIR resource, and the request headers must contain `Content-Type: -// application/fhir+json`. The resource must contain an `id` element -// having an identical value to the ID in the REST path of the request. -// On success, the response body will contain a JSON-encoded -// representation of the updated resource, including the server-assigned -// version ID. Errors generated by the FHIR store will contain a -// JSON-encoded `OperationOutcome` resource describing the reason for -// the error. If the request cannot be mapped to a valid API method on a -// FHIR store, a generic GCP error might be returned instead. For -// samples that show how to call `update`, see [Updating a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#updating_a_fhir_reso -// urce). +// FHIR standard update interaction (DSTU2, STU3, R4). If the specified +// resource does not exist and the FHIR store has enable_update_create +// set, creates the resource with the client-specified ID. The request +// body must contain a JSON-encoded FHIR resource, and the request +// headers must contain `Content-Type: application/fhir+json`. The +// resource must contain an `id` element having an identical value to +// the ID in the REST path of the request. On success, the response body +// will contain a JSON-encoded representation of the updated resource, +// including the server-assigned version ID. Errors generated by the +// FHIR store will contain a JSON-encoded `OperationOutcome` resource +// describing the reason for the error. If the request cannot be mapped +// to a valid API method on a FHIR store, a generic GCP error might be +// returned instead. For samples that show how to call `update`, see +// Updating a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Update(name string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirUpdateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12627,20 +12430,13 @@ type ProjectsLocationsDatasetsFhirStoresFhirVreadCall struct { // Vread: Gets the contents of a version (current or historical) of a // FHIR resource by version ID. Implements the FHIR standard vread -// interaction -// ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#vread -// ), -// [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#vread), -// [R4](http://hl7.org/implement/standards/fhir/R4/http.html#vread)). On -// success, the response body will contain a JSON-encoded representation -// of the resource. Errors generated by the FHIR store will contain a -// JSON-encoded `OperationOutcome` resource describing the reason for -// the error. If the request cannot be mapped to a valid API method on a -// FHIR store, a generic GCP error might be returned instead. For -// samples that show how to call `vread`, see [Retrieving a FHIR -// resource -// version](/healthcare/docs/how-tos/fhir-resources#retrieving_a_fhir_res -// ource_version). +// interaction (DSTU2, STU3, R4). On success, the response body will +// contain a JSON-encoded representation of the resource. Errors +// generated by the FHIR store will contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. For samples that show +// how to call `vread`, see Retrieving a FHIR resource version. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Vread(name string) *ProjectsLocationsDatasetsFhirStoresFhirVreadCall { c := &ProjectsLocationsDatasetsFhirStoresFhirVreadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -13195,9 +12991,7 @@ func (r *ProjectsLocationsDatasetsHl7V2StoresService) GetIamPolicy(resource stri // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsDatasetsHl7V2StoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsHl7V2StoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/healthcare/v1beta1/healthcare-gen.go b/healthcare/v1beta1/healthcare-gen.go index dc212cfc6a5..0144ad0c087 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -910,9 +910,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -2681,16 +2679,14 @@ type FhirStore struct { // read the historical versions. DisableResourceVersioning bool `json:"disableResourceVersioning,omitempty"` - // EnableUpdateCreate: Whether this FHIR store has the [updateCreate - // capability](https://www.hl7.org/fhir/capabilitystatement-definitions.h - // tml#CapabilityStatement.rest.resource.updateCreate). This determines - // if the client can use an Update operation to create a new resource - // with a client-specified ID. If false, all IDs are server-assigned - // through the Create operation and attempts to update a non-existent - // resource return errors. Be careful with the audit logs if - // client-specified resource IDs contain sensitive data such as patient - // identifiers, those IDs are part of the FHIR resource path recorded in - // Cloud audit logs and Cloud Pub/Sub notifications. + // EnableUpdateCreate: Whether this FHIR store has the updateCreate + // capability. This determines if the client can use an Update operation + // to create a new resource with a client-specified ID. If false, all + // IDs are server-assigned through the Create operation and attempts to + // update a non-existent resource return errors. Be careful with the + // audit logs if client-specified resource IDs contain sensitive data + // such as patient identifiers, those IDs are part of the FHIR resource + // path recorded in Cloud audit logs and Cloud Pub/Sub notifications. EnableUpdateCreate bool `json:"enableUpdateCreate,omitempty"` // Labels: User-supplied key-value pairs used to organize FHIR stores. @@ -2721,12 +2717,10 @@ type FhirStore struct { // to the new location in addition to the existing ones. When a location // is removed from the list, the server stops streaming to that // location. Before adding a new config, you must add the required - // [`bigquery.dataEditor`](https://cloud.google.com/bigquery/docs/access- - // control#bigquery.dataEditor) role to your project's **Cloud - // Healthcare Service Agent** [service - // account](https://cloud.google.com/iam/docs/service-accounts). Some - // lag (typically on the order of dozens of seconds) is expected before - // the results show up in the streaming destination. + // `bigquery.dataEditor` role to your project's **Cloud Healthcare + // Service Agent** service account. Some lag (typically on the order of + // dozens of seconds) is expected before the results show up in the + // streaming destination. StreamConfigs []*StreamConfig `json:"streamConfigs,omitempty"` // Version: Immutable. The FHIR specification version that this FHIR @@ -3433,8 +3427,7 @@ type GoogleCloudHealthcareV1beta1DicomStreamConfig struct { // limit on streaming insert row size, therefore any instance that // generates more than 1 MB of BigQuery data will not be streamed. If an // instance cannot be streamed to BigQuery, errors will be logged to - // Cloud Logging (see [Viewing logs](/healthcare/docs/how- [Viewing - // logs](/healthcare/docs/how-tos/logging)). + // Cloud Logging (see Viewing logs). BigqueryDestination *GoogleCloudHealthcareV1beta1DicomBigQueryDestination `json:"bigqueryDestination,omitempty"` // ForceSendFields is a list of field names (e.g. "BigqueryDestination") @@ -3874,23 +3867,19 @@ type Hl7V2NotificationConfig struct { // `labels."priority":*`. Filter string `json:"filter,omitempty"` - // PubsubTopic: The [Cloud - // Pub/Sub](https://cloud.google.com/pubsub/docs/) topic that - // notifications of changes are published on. Supplied by the client. - // The notification is a `PubsubMessage` with the following fields: * - // `PubsubMessage.Data` contains the resource name. * - // `PubsubMessage.MessageId` is the ID of this notification. It is - // guaranteed to be unique within the topic. * + // PubsubTopic: The Cloud Pub/Sub topic that notifications of changes + // are published on. Supplied by the client. The notification is a + // `PubsubMessage` with the following fields: * `PubsubMessage.Data` + // contains the resource name. * `PubsubMessage.MessageId` is the ID of + // this notification. It is guaranteed to be unique within the topic. * // `PubsubMessage.PublishTime` is the time when the message was // published. Note that notifications are only sent if the topic is - // non-empty. [Topic - // names](https://cloud.google.com/pubsub/docs/overview#names) must be - // scoped to a project. Cloud Healthcare API service account must have - // publisher permissions on the given Pub/Sub topic. Not having adequate - // permissions causes the calls that send notifications to fail. If a - // notification can't be published to Cloud Pub/Sub, errors are logged - // to Cloud Logging. For more information, see [Viewing error logs in - // Cloud Logging](/healthcare/docs/how-tos/logging). + // non-empty. Topic names must be scoped to a project. Cloud Healthcare + // API service account must have publisher permissions on the given + // Pub/Sub topic. Not having adequate permissions causes the calls that + // send notifications to fail. If a notification can't be published to + // Cloud Pub/Sub, errors are logged to Cloud Logging. For more + // information, see Viewing error logs in Cloud Logging. PubsubTopic string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "Filter") to @@ -5214,25 +5203,20 @@ func (s *Message) MarshalJSON() ([]byte, error) { // NotificationConfig: Specifies where to send notifications upon // changes to a data store. type NotificationConfig struct { - // PubsubTopic: The [Cloud - // Pub/Sub](https://cloud.google.com/pubsub/docs/) topic that - // notifications of changes are published on. Supplied by the client. - // PubsubMessage.Data contains the resource name. - // PubsubMessage.MessageId is the ID of this message. It is guaranteed - // to be unique within the topic. PubsubMessage.PublishTime is the time - // at which the message was published. Notifications are only sent if - // the topic is non-empty. [Topic - // names](https://cloud.google.com/pubsub/docs/overview#names) must be - // scoped to a project. Cloud Healthcare API service account must have - // publisher permissions on the given Cloud Pub/Sub topic. Not having - // adequate permissions causes the calls that send notifications to - // fail. If a notification can't be published to Cloud Pub/Sub, errors - // are logged to Cloud Logging (see [Viewing - // logs](/healthcare/docs/how-tos/logging)). If the number of errors - // exceeds a certain rate, some aren't submitted. Note that not all - // operations trigger notifications, see [Configuring Pub/Sub - // notifications](https://cloud.google.com/healthcare/docs/how-tos/pubsub - // ) for specific details. + // PubsubTopic: The Cloud Pub/Sub topic that notifications of changes + // are published on. Supplied by the client. PubsubMessage.Data contains + // the resource name. PubsubMessage.MessageId is the ID of this message. + // It is guaranteed to be unique within the topic. + // PubsubMessage.PublishTime is the time at which the message was + // published. Notifications are only sent if the topic is non-empty. + // Topic names must be scoped to a project. Cloud Healthcare API service + // account must have publisher permissions on the given Cloud Pub/Sub + // topic. Not having adequate permissions causes the calls that send + // notifications to fail. If a notification can't be published to Cloud + // Pub/Sub, errors are logged to Cloud Logging (see Viewing logs). If + // the number of errors exceeds a certain rate, some aren't submitted. + // Note that not all operations trigger notifications, see Configuring + // Pub/Sub notifications for specific details. PubsubTopic string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "PubsubTopic") to @@ -5341,8 +5325,7 @@ type OperationMetadata struct { EndTime string `json:"endTime,omitempty"` // LogsUrl: A link to audit and error logs in the log viewer. Error logs - // are generated only by some operations, listed at [Viewing - // logs](/healthcare/docs/how-tos/logging). + // are generated only by some operations, listed at Viewing logs. LogsUrl string `json:"logsUrl,omitempty"` // ForceSendFields is a list of field names (e.g. "ApiMethodName") to @@ -5492,9 +5475,8 @@ func (s *PatientId) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -5512,8 +5494,8 @@ func (s *PatientId) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -5552,9 +5534,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -6085,12 +6066,8 @@ func (s *SchematizedData) MarshalJSON() ([]byte, error) { // specified FHIR store. type SearchResourcesRequest struct { // ResourceType: 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.h - // tml), - // [STU3](https://hl7.org/implement/standards/fhir/STU3/resourcelist.html - // ), - // [R4](https://hl7.org/implement/standards/fhir/R4/resourcelist.html)). + // Observation. For a complete list, see the FHIR Resource Index (DSTU2, + // STU3, R4). ResourceType string `json:"resourceType,omitempty"` // ForceSendFields is a list of field names (e.g. "ResourceType") to @@ -6269,11 +6246,10 @@ func (s *Signature) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -6342,8 +6318,7 @@ type StreamConfig struct { // and meta.versionId pair. Alternatively, the server created view // mentioned above also filters out duplicates. If a resource mutation // cannot be streamed to BigQuery, errors will be logged to Cloud - // Logging (see [Viewing error logs in Cloud - // Logging](/healthcare/docs/how-tos/logging)). + // Logging (see Viewing error logs in Cloud Logging). BigqueryDestination *GoogleCloudHealthcareV1beta1FhirBigQueryDestination `json:"bigqueryDestination,omitempty"` // ResourceTypes: Supply a FHIR resource type (such as "Patient" or @@ -6413,8 +6388,7 @@ func (s *TagFilterList) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -7239,8 +7213,7 @@ type ProjectsLocationsDatasetsDeidentifyCall struct { // de-identification fails for some resources. The new de-identified // dataset will not contain these failed resources. The number of // resources processed are tracked in Operation.metadata. Error details -// are logged to Cloud Logging. For more information, see [Viewing -// logs](/healthcare/docs/how-tos/logging). +// are logged to Cloud Logging. For more information, see Viewing logs. func (r *ProjectsLocationsDatasetsService) Deidentify(sourceDataset string, deidentifydatasetrequest *DeidentifyDatasetRequest) *ProjectsLocationsDatasetsDeidentifyCall { c := &ProjectsLocationsDatasetsDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceDataset = sourceDataset @@ -7672,9 +7645,7 @@ func (r *ProjectsLocationsDatasetsService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsDatasetsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -8744,7 +8715,7 @@ type ProjectsLocationsDatasetsAnnotationStoresEvaluateCall struct { // detailed response is returned of type // EvaluateAnnotationStoreResponse, contained in the response. The // metadata field type is OperationMetadata. Errors are logged to Cloud -// Logging (see [Viewing logs](/healthcare/docs/how-tos/logging)). +// Logging (see Viewing logs). func (r *ProjectsLocationsDatasetsAnnotationStoresService) Evaluate(name string, evaluateannotationstorerequest *EvaluateAnnotationStoreRequest) *ProjectsLocationsDatasetsAnnotationStoresEvaluateCall { c := &ProjectsLocationsDatasetsAnnotationStoresEvaluateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8888,8 +8859,7 @@ type ProjectsLocationsDatasetsAnnotationStoresExportCall struct { // is successful, a detailed response is returned of type // ExportAnnotationsResponse, contained in the response field when the // operation finishes. The metadata field type is OperationMetadata. -// Errors are logged to Cloud Logging (see [Viewing -// logs](/healthcare/docs/how-tos/logging)). +// Errors are logged to Cloud Logging (see Viewing logs). func (r *ProjectsLocationsDatasetsAnnotationStoresService) Export(name string, exportannotationsrequest *ExportAnnotationsRequest) *ProjectsLocationsDatasetsAnnotationStoresExportCall { c := &ProjectsLocationsDatasetsAnnotationStoresExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9190,9 +9160,7 @@ func (r *ProjectsLocationsDatasetsAnnotationStoresService) GetIamPolicy(resource // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsDatasetsAnnotationStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsAnnotationStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -9346,7 +9314,7 @@ type ProjectsLocationsDatasetsAnnotationStoresImportCall struct { // response is returned as of type ImportAnnotationsResponse, contained // in the response field when the operation finishes. The metadata field // type is OperationMetadata. Errors are logged to Cloud Logging (see -// [Viewing logs](/healthcare/docs/how-tos/logging)). +// Viewing logs). func (r *ProjectsLocationsDatasetsAnnotationStoresService) Import(name string, importannotationsrequest *ImportAnnotationsRequest) *ProjectsLocationsDatasetsAnnotationStoresImportCall { c := &ProjectsLocationsDatasetsAnnotationStoresImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11698,9 +11666,7 @@ func (r *ProjectsLocationsDatasetsConsentStoresService) GetIamPolicy(resource st // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsDatasetsConsentStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsConsentStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -16704,8 +16670,7 @@ type ProjectsLocationsDatasetsDicomStoresDeidentifyCall struct { // if de-identification fails for some DICOM instances. The output DICOM // store will not contain these failed resources. The number of // resources processed are tracked in Operation.metadata. Error details -// are logged to Cloud Logging. For more information, see [Viewing -// logs](/healthcare/docs/how-tos/logging). +// are logged to Cloud Logging. For more information, see Viewing logs. func (r *ProjectsLocationsDatasetsDicomStoresService) Deidentify(sourceStore string, deidentifydicomstorerequest *DeidentifyDicomStoreRequest) *ProjectsLocationsDatasetsDicomStoresDeidentifyCall { c := &ProjectsLocationsDatasetsDicomStoresDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceStore = sourceStore @@ -16978,8 +16943,8 @@ type ProjectsLocationsDatasetsDicomStoresExportCall struct { // Export: Exports data to the specified destination by copying it from // the DICOM store. Errors are also logged to Cloud Logging. For more -// information, see [Viewing logs](/healthcare/docs/how-tos/logging). -// The metadata field type is OperationMetadata. +// information, see Viewing logs. The metadata field type is +// OperationMetadata. func (r *ProjectsLocationsDatasetsDicomStoresService) Export(name string, exportdicomdatarequest *ExportDicomDataRequest) *ProjectsLocationsDatasetsDicomStoresExportCall { c := &ProjectsLocationsDatasetsDicomStoresExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -17279,9 +17244,7 @@ func (r *ProjectsLocationsDatasetsDicomStoresService) GetIamPolicy(resource stri // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsDatasetsDicomStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsDicomStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -17432,8 +17395,8 @@ type ProjectsLocationsDatasetsDicomStoresImportCall struct { // Import: Imports data into the DICOM store by copying it from the // specified source. Errors are logged to Cloud Logging. For more -// information, see [Viewing logs](/healthcare/docs/how-tos/logging). -// The metadata field type is OperationMetadata. +// information, see Viewing logs. The metadata field type is +// OperationMetadata. func (r *ProjectsLocationsDatasetsDicomStoresService) Import(name string, importdicomdatarequest *ImportDicomDataRequest) *ProjectsLocationsDatasetsDicomStoresImportCall { c := &ProjectsLocationsDatasetsDicomStoresImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -17935,16 +17898,11 @@ type ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall struct { } // SearchForInstances: SearchForInstances returns a list of matching -// instances. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// SearchForInstances, see [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForInstances, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// instances. See RetrieveTransaction. For details on the implementation +// of SearchForInstances, see Search transaction in the Cloud Healthcare +// API conformance statement. For samples that show how to call +// SearchForInstances, see Searching for studies, series, instances, and +// frames. func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18067,16 +18025,11 @@ type ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall struct { } // SearchForSeries: SearchForSeries returns a list of matching series. -// See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// SearchForSeries, see [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForSeries, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// See RetrieveTransaction. For details on the implementation of +// SearchForSeries, see Search transaction in the Cloud Healthcare API +// conformance statement. For samples that show how to call +// SearchForSeries, see Searching for studies, series, instances, and +// frames. func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18199,16 +18152,11 @@ type ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall struct { } // SearchForStudies: SearchForStudies returns a list of matching -// studies. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// SearchForStudies, see [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForStudies, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// studies. See RetrieveTransaction. For details on the implementation +// of SearchForStudies, see Search transaction in the Cloud Healthcare +// API conformance statement. For samples that show how to call +// SearchForStudies, see Searching for studies, series, instances, and +// frames. func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForStudies(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18473,15 +18421,10 @@ type ProjectsLocationsDatasetsDicomStoresStoreInstancesCall struct { } // StoreInstances: StoreInstances stores DICOM instances associated with -// study instance unique identifiers (SUID). See [Store -// Transaction](http://dicom.nema.org/medical/dicom/current/output/html/p -// art18.html#sect_10.5). For details on the implementation of -// StoreInstances, see [Store -// transaction](https://cloud.google.com/healthcare/docs/dicom#store_tran -// saction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call StoreInstances, see [Storing DICOM -// data](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storin -// g_dicom_data). +// study instance unique identifiers (SUID). See Store Transaction. For +// details on the implementation of StoreInstances, see Store +// transaction in the Cloud Healthcare API conformance statement. For +// samples that show how to call StoreInstances, see Storing DICOM data. func (r *ProjectsLocationsDatasetsDicomStoresService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18885,15 +18828,10 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall struct { // RetrieveMetadata: RetrieveStudyMetadata returns instance associated // with the given study presented as metadata with the bulk data -// removed. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// RetrieveStudyMetadata, see [Metadata -// resources](https://cloud.google.com/healthcare/docs/dicom#metadata_res -// ources) in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveStudyMetadata, see [Retrieving -// metadata](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#re -// trieving_metadata). +// removed. See RetrieveTransaction. For details on the implementation +// of RetrieveStudyMetadata, see Metadata resources in the Cloud +// Healthcare API conformance statement. For samples that show how to +// call RetrieveStudyMetadata, see Retrieving metadata. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19016,16 +18954,10 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall struct { } // RetrieveStudy: RetrieveStudy returns all instances within the given -// study. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// RetrieveStudy, see [DICOM -// study/series/instances](https://cloud.google.com/healthcare/docs/dicom -// #dicom_studyseriesinstances) in the Cloud Healthcare API conformance -// statement. For samples that show how to call RetrieveStudy, see -// [Retrieving DICOM -// data](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrie -// ving_dicom_data). +// study. See RetrieveTransaction. For details on the implementation of +// RetrieveStudy, see DICOM study/series/instances in the Cloud +// Healthcare API conformance statement. For samples that show how to +// call RetrieveStudy, see Retrieving DICOM data. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveStudy(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19148,16 +19080,11 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall struct { } // SearchForInstances: SearchForInstances returns a list of matching -// instances. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// SearchForInstances, see [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForInstances, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// instances. See RetrieveTransaction. For details on the implementation +// of SearchForInstances, see Search transaction in the Cloud Healthcare +// API conformance statement. For samples that show how to call +// SearchForInstances, see Searching for studies, series, instances, and +// frames. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19280,16 +19207,11 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall struct { } // SearchForSeries: SearchForSeries returns a list of matching series. -// See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// SearchForSeries, see [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForSeries, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// See RetrieveTransaction. For details on the implementation of +// SearchForSeries, see Search transaction in the Cloud Healthcare API +// conformance statement. For samples that show how to call +// SearchForSeries, see Searching for studies, series, instances, and +// frames. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19412,15 +19334,10 @@ type ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall struct { } // StoreInstances: StoreInstances stores DICOM instances associated with -// study instance unique identifiers (SUID). See [Store -// Transaction](http://dicom.nema.org/medical/dicom/current/output/html/p -// art18.html#sect_10.5). For details on the implementation of -// StoreInstances, see [Store -// transaction](https://cloud.google.com/healthcare/docs/dicom#store_tran -// saction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call StoreInstances, see [Storing DICOM -// data](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storin -// g_dicom_data). +// study instance unique identifiers (SUID). See Store Transaction. For +// details on the implementation of StoreInstances, see Store +// transaction in the Cloud Healthcare API conformance statement. For +// samples that show how to call StoreInstances, see Storing DICOM data. func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19681,15 +19598,10 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall struc // RetrieveMetadata: RetrieveSeriesMetadata returns instance associated // with the given study and series, presented as metadata with the bulk -// data removed. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// RetrieveSeriesMetadata, see [Metadata -// resources](https://cloud.google.com/healthcare/docs/dicom#metadata_res -// ources) in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveSeriesMetadata, see [Retrieving -// metadata](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#re -// trieving_metadata). +// data removed. See RetrieveTransaction. For details on the +// implementation of RetrieveSeriesMetadata, see Metadata resources in +// the Cloud Healthcare API conformance statement. For samples that show +// how to call RetrieveSeriesMetadata, see Retrieving metadata. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19812,16 +19724,10 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall struct } // RetrieveSeries: RetrieveSeries returns all instances within the given -// study and series. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// RetrieveSeries, see [DICOM -// study/series/instances](https://cloud.google.com/healthcare/docs/dicom -// #dicom_studyseriesinstances) in the Cloud Healthcare API conformance -// statement. For samples that show how to call RetrieveSeries, see -// [Retrieving DICOM -// data](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrie -// ving_dicom_data). +// study and series. See RetrieveTransaction. For details on the +// implementation of RetrieveSeries, see DICOM study/series/instances in +// the Cloud Healthcare API conformance statement. For samples that show +// how to call RetrieveSeries, see Retrieving DICOM data. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19944,16 +19850,11 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall str } // SearchForInstances: SearchForInstances returns a list of matching -// instances. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// SearchForInstances, see [Search -// transaction](https://cloud.google.com/healthcare/docs/dicom#search_tra -// nsaction) in the Cloud Healthcare API conformance statement. For -// samples that show how to call SearchForInstances, see [Searching for -// studies, series, instances, and -// frames](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#sear -// ching_for_studies_series_instances_and_frames). +// instances. See RetrieveTransaction. For details on the implementation +// of SearchForInstances, see Search transaction in the Cloud Healthcare +// API conformance statement. For samples that show how to call +// SearchForInstances, see Searching for studies, series, instances, and +// frames. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20079,9 +19980,7 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall struct // to the GET requests specified in the Retrieve transaction. Study and // series search results can take a few seconds to be updated after an // instance is deleted using DeleteInstance. For samples that show how -// to call DeleteInstance, see [Deleting a study, series, or -// instance](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#de -// leting_a_study_series_or_instance). +// to call DeleteInstance, see Deleting a study, series, or instance. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20225,16 +20124,11 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceC // RetrieveInstance: RetrieveInstance returns instance associated with // the given study, series, and SOP Instance UID. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// RetrieveInstance, see [DICOM -// study/series/instances](https://cloud.google.com/healthcare/docs/dicom -// #dicom_studyseriesinstances) and [DICOM -// instances](https://cloud.google.com/healthcare/docs/dicom#dicom_instan -// ces) in the Cloud Healthcare API conformance statement. For samples -// that show how to call RetrieveInstance, see [Retrieving an -// instance](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#re -// trieving_an_instance). +// RetrieveTransaction. For details on the implementation of +// RetrieveInstance, see DICOM study/series/instances and DICOM +// instances in the Cloud Healthcare API conformance statement. For +// samples that show how to call RetrieveInstance, see Retrieving an +// instance. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveInstance(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20359,15 +20253,10 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataC // RetrieveMetadata: RetrieveInstanceMetadata returns instance // associated with the given study, series, and SOP Instance UID // presented as metadata with the bulk data removed. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// RetrieveInstanceMetadata, see [Metadata -// resources](https://cloud.google.com/healthcare/docs/dicom#metadata_res -// ources) in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveInstanceMetadata, see -// [Retrieving -// metadata](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#re -// trieving_metadata). +// RetrieveTransaction. For details on the implementation of +// RetrieveInstanceMetadata, see Metadata resources in the Cloud +// Healthcare API conformance statement. For samples that show how to +// call RetrieveInstanceMetadata, see Retrieving metadata. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20491,16 +20380,11 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedC // RetrieveRendered: RetrieveRenderedInstance returns instance // associated with the given study, series, and SOP Instance UID in an -// acceptable Rendered Media Type. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// RetrieveRenderedInstance, see [Rendered -// resources](https://cloud.google.com/healthcare/docs/dicom#rendered_res -// ources) in the Cloud Healthcare API conformance statement. For +// acceptable Rendered Media Type. See RetrieveTransaction. For details +// on the implementation of RetrieveRenderedInstance, see Rendered +// resources in the Cloud Healthcare API conformance statement. For // samples that show how to call RetrieveRenderedInstance, see -// [Retrieving consumer image -// formats](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#ret -// rieving_consumer_image_formats). +// Retrieving consumer image formats. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20624,14 +20508,10 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFra // RetrieveFrames: RetrieveFrames returns instances associated with the // given study, series, SOP Instance UID and frame numbers. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// RetrieveFrames, see [DICOM -// frames](https://cloud.google.com/healthcare/docs/dicom#dicom_frames) -// in the Cloud Healthcare API conformance statement. For samples that -// show how to call RetrieveFrames, see [Retrieving DICOM -// data](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrie -// ving_dicom_data). +// RetrieveTransaction. For details on the implementation of +// RetrieveFrames, see DICOM frames in the Cloud Healthcare API +// conformance statement. For samples that show how to call +// RetrieveFrames, see Retrieving DICOM data. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveFrames(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20755,16 +20635,11 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRen // RetrieveRendered: RetrieveRenderedFrames returns instances associated // with the given study, series, SOP Instance UID and frame numbers in -// an acceptable Rendered Media Type. See -// [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/outp -// ut/html/part18.html#sect_10.4). For details on the implementation of -// RetrieveRenderedFrames, see [Rendered -// resources](https://cloud.google.com/healthcare/docs/dicom#rendered_res -// ources) in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveRenderedFrames, see [Retrieving -// consumer image -// formats](https://cloud.google.com/healthcare/docs/how-tos/dicomweb#ret -// rieving_consumer_image_formats). +// an acceptable Rendered Media Type. See RetrieveTransaction. For +// details on the implementation of RetrieveRenderedFrames, see Rendered +// resources in the Cloud Healthcare API conformance statement. For +// samples that show how to call RetrieveRenderedFrames, see Retrieving +// consumer image formats. func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -21043,8 +20918,7 @@ type ProjectsLocationsDatasetsFhirStoresDeidentifyCall struct { // If the request is successful, the response field type is // DeidentifyFhirStoreSummary. The number of resources processed are // tracked in Operation.metadata. Error details are logged to Cloud -// Logging. For more information, see [Viewing -// logs](/healthcare/docs/how-tos/logging). +// Logging. For more information, see Viewing logs. func (r *ProjectsLocationsDatasetsFhirStoresService) Deidentify(sourceStore string, deidentifyfhirstorerequest *DeidentifyFhirStoreRequest) *ProjectsLocationsDatasetsFhirStoresDeidentifyCall { c := &ProjectsLocationsDatasetsFhirStoresDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceStore = sourceStore @@ -21319,9 +21193,8 @@ type ProjectsLocationsDatasetsFhirStoresExportCall struct { // destination. This method returns an Operation that can be used to // track the status of the export by calling GetOperation. Immediate // fatal errors appear in the error field, errors are also logged to -// Cloud Logging (see [Viewing error logs in Cloud -// Logging](/healthcare/docs/how-tos/logging)). Otherwise, when the -// operation finishes, a detailed response of type +// Cloud Logging (see Viewing error logs in Cloud Logging). Otherwise, +// when the operation finishes, a detailed response of type // ExportResourcesResponse is returned in the response field. The // metadata field type for this operation is OperationMetadata. func (r *ProjectsLocationsDatasetsFhirStoresService) Export(name string, exportresourcesrequest *ExportResourcesRequest) *ProjectsLocationsDatasetsFhirStoresExportCall { @@ -21623,9 +21496,7 @@ func (r *ProjectsLocationsDatasetsFhirStoresService) GetIamPolicy(resource strin // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsDatasetsFhirStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsFhirStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -21824,9 +21695,8 @@ type ProjectsLocationsDatasetsFhirStoresImportCall struct { // by a FHIR search or Patient-everything operation. This method returns // an Operation that can be used to track the status of the import by // calling GetOperation. Immediate fatal errors appear in the error -// field, errors are also logged to Cloud Logging (see [Viewing -// logs](/healthcare/docs/how-tos/logging)). Otherwise, when the -// operation finishes, a detailed response of type +// field, errors are also logged to Cloud Logging (see Viewing logs). +// Otherwise, when the operation finishes, a detailed response of type // ImportResourcesResponse is returned in the response field. The // metadata field type for this operation is OperationMetadata. func (r *ProjectsLocationsDatasetsFhirStoresService) Import(name string, importresourcesrequest *ImportResourcesRequest) *ProjectsLocationsDatasetsFhirStoresImportCall { @@ -22617,18 +22487,13 @@ type ProjectsLocationsDatasetsFhirStoresFhirConceptMapSearchTranslateCall struct // ConceptMapSearchTranslate: Translates a code from one value set to // another by searching for appropriate concept maps. Implements the -// FHIR standard $translate operation -// ([DSTU2](https://www.hl7.org/fhir/DSTU2/operation-conceptmap-translate -// .html), -// [STU3](https://www.hl7.org/fhir/STU3/operation-conceptmap-translate.ht -// ml), -// [R4](https://www.hl7.org/fhir/R4/operation-conceptmap-translate.html)) -// . On success, the response body contains a JSON-encoded -// representation of a FHIR Parameters resource, which includes the -// translation result. Errors generated by the FHIR store contain a -// JSON-encoded `OperationOutcome` resource describing the reason for -// the error. If the request cannot be mapped to a valid API method on a -// FHIR store, a generic GCP error might be returned instead. +// FHIR standard $translate operation (DSTU2, STU3, R4). On success, the +// response body contains a JSON-encoded representation of a FHIR +// Parameters resource, which includes the translation result. Errors +// generated by the FHIR store contain a JSON-encoded `OperationOutcome` +// resource describing the reason for the error. If the request cannot +// be mapped to a valid API method on a FHIR store, a generic GCP error +// might be returned instead. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ConceptMapSearchTranslate(parent string) *ProjectsLocationsDatasetsFhirStoresFhirConceptMapSearchTranslateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirConceptMapSearchTranslateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -22817,18 +22682,13 @@ type ProjectsLocationsDatasetsFhirStoresFhirConceptMapTranslateCall struct { // ConceptMapTranslate: Translates a code from one value set to another // using a concept map. You can provide your own concept maps to // translate any code system to another code system. Implements the FHIR -// standard $translate operation -// ([DSTU2](https://www.hl7.org/fhir/DSTU2/operation-conceptmap-translate -// .html), -// [STU3](https://www.hl7.org/fhir/STU3/operation-conceptmap-translate.ht -// ml), -// [R4](https://www.hl7.org/fhir/R4/operation-conceptmap-translate.html)) -// . On success, the response body contains a JSON-encoded -// representation of a FHIR Parameters resource, which includes the -// translation result. Errors generated by the FHIR store contain a -// JSON-encoded `OperationOutcome` resource describing the reason for -// the error. If the request cannot be mapped to a valid API method on a -// FHIR store, a generic GCP error might be returned instead. +// standard $translate operation (DSTU2, STU3, R4). On success, the +// response body contains a JSON-encoded representation of a FHIR +// Parameters resource, which includes the translation result. Errors +// generated by the FHIR store contain a JSON-encoded `OperationOutcome` +// resource describing the reason for the error. If the request cannot +// be mapped to a valid API method on a FHIR store, a generic GCP error +// might be returned instead. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ConceptMapTranslate(name string) *ProjectsLocationsDatasetsFhirStoresFhirConceptMapTranslateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirConceptMapTranslateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -22978,20 +22838,17 @@ type ProjectsLocationsDatasetsFhirStoresFhirObservationLastnCall struct { // ObservationLastn: Retrieves the N most recent `Observation` resources // for a subject matching search criteria specified as query parameters, // grouped by `Observation.code`, sorted from most recent to oldest. -// Implements the FHIR extended operation Observation-lastn -// ([STU3](https://hl7.org/implement/standards/fhir/STU3/observation-oper -// ations.html#lastn), -// [R4](https://hl7.org/implement/standards/fhir/R4/observation-operation -// s.html#lastn)). DSTU2 doesn't define the Observation-lastn method, -// but the server supports it the same way it supports STU3. Search -// terms are provided as query parameters following the same pattern as -// the search method. The following search parameters must be provided: -// - `subject` or `patient` to specify a subject for the Observation. - -// `code`, `category` or any of the composite parameters that include -// `code`. Any other valid Observation search parameters can also be -// provided. This operation accepts an additional query parameter `max`, -// which specifies N, the maximum number of Observations to return from -// each group, with a default of 1. Searches with over 1000 results are +// Implements the FHIR extended operation Observation-lastn (STU3, R4). +// DSTU2 doesn't define the Observation-lastn method, but the server +// supports it the same way it supports STU3. Search terms are provided +// as query parameters following the same pattern as the search method. +// The following search parameters must be provided: - `subject` or +// `patient` to specify a subject for the Observation. - `code`, +// `category` or any of the composite parameters that include `code`. +// Any other valid Observation search parameters can also be provided. +// This operation accepts an additional query parameter `max`, which +// specifies N, the maximum number of Observations to return from each +// group, with a default of 1. Searches with over 1000 results are // rejected. Results are counted before grouping and limiting the // results with `max`. To stay within the limit, constrain these // searches using Observation search parameters such as `_lastUpdated` @@ -23114,14 +22971,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall struct { // PatientEverything: Retrieves a Patient resource and resources related // to that patient. Implements the FHIR extended operation -// Patient-everything -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/patient-operat -// ions.html#everything), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/patient-operation -// s.html#everything), -// [R4](https://hl7.org/implement/standards/fhir/R4/patient-operations.ht -// ml#everything)). On success, the response body contains a -// JSON-encoded representation of a `Bundle` resource of type +// Patient-everything (DSTU2, STU3, R4). On success, the response body +// contains a JSON-encoded representation of a `Bundle` resource of type // `searchset`, containing the results of the operation. Errors // generated by the FHIR store contain a JSON-encoded `OperationOutcome` // resource describing the reason for the error. If the request cannot @@ -23131,15 +22982,10 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall struct { // referenced by the patient resource. * Resources directly referencing // the patient resource that meet the inclusion criteria. The inclusion // criteria are based on the membership rules in the patient compartment -// definition -// ([DSTU2](https://hl7.org/fhir/DSTU2/compartment-patient.html), -// [STU3](http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html -// ), [R4](https://hl7.org/fhir/R4/compartmentdefinition-patient.html)), -// which details the eligible resource types and referencing search -// parameters. For samples that show how to call `Patient-everything`, -// see [Getting all patient compartment -// resources](/healthcare/docs/how-tos/fhir-resources#getting_all_patient -// _compartment_resources). +// definition (DSTU2, STU3, R4), which details the eligible resource +// types and referencing search parameters. For samples that show how to +// call `Patient-everything`, see Getting all patient compartment +// resources. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) PatientEverything(name string) *ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall { c := &ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -23337,10 +23183,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall struct { // (excluding the current version) from the FHIR store. To remove all // versions of a resource, first delete the current version and then // call this method. This is not a FHIR standard operation. For samples -// that show how to call `Resource-purge`, see [Deleting historical -// versions of a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#deleting_historical_ -// versions_of_a_fhir_resource). +// that show how to call `Resource-purge`, see Deleting historical +// versions of a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ResourcePurge(name string) *ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall { c := &ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -23471,23 +23315,13 @@ type ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall struct { header_ http.Header } -// Capabilities: Gets the FHIR capability statement -// ([STU3](https://hl7.org/implement/standards/fhir/STU3/capabilitystatem -// ent.html), -// [R4](https://hl7.org/implement/standards/fhir/R4/capabilitystatement.h -// tml)), or the [conformance -// statement](https://hl7.org/implement/standards/fhir/DSTU2/conformance. -// html) in the DSTU2 case for the store, which contains a description -// of functionality supported by the server. Implements the FHIR -// standard capabilities interaction -// ([STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#capabi -// lities), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#capabilitie -// s)), or the [conformance -// interaction](https://hl7.org/implement/standards/fhir/DSTU2/http.html# -// conformance) in the DSTU2 case. On success, the response body -// contains a JSON-encoded representation of a `CapabilityStatement` -// resource. +// Capabilities: Gets the FHIR capability statement (STU3, R4), or the +// conformance statement in the DSTU2 case for the store, which contains +// a description of functionality supported by the server. Implements +// the FHIR standard capabilities interaction (STU3, R4), or the +// conformance interaction in the DSTU2 case. On success, the response +// body contains a JSON-encoded representation of a +// `CapabilityStatement` resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Capabilities(name string) *ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall { c := &ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -23599,25 +23433,18 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalDeleteCall struct { } // ConditionalDelete: Deletes FHIR resources that match a search query. -// Implements the FHIR standard conditional delete interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1. -// 0.12.1), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0. -// 13.1), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#3.1.0.7.1)) -// . If multiple resources match, all matching resources are deleted. -// Search terms are provided as query parameters following the same -// pattern as the search method. Note: Unless resource versioning is -// disabled by setting the disable_resource_versioning flag on the FHIR -// store, the deleted resources are moved to a history repository that -// can still be retrieved through vread and related methods, unless they -// are removed by the purge method. This method requires +// Implements the FHIR standard conditional delete interaction (DSTU2, +// STU3, R4). If multiple resources match, all matching resources are +// deleted. Search terms are provided as query parameters following the +// same pattern as the search method. Note: Unless resource versioning +// is disabled by setting the disable_resource_versioning flag on the +// FHIR store, the deleted resources are moved to a history repository +// that can still be retrieved through vread and related methods, unless +// they are removed by the purge method. This method requires // the`healthcare.fhirStores.searchResources` and // `healthcare.fhirResources.delete` permissions on the parent FHIR // store. For samples that show how to call `conditionalDelete`, see -// [Conditionally deleting a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#conditionally_deleti -// ng_a_fhir_resource). +// Conditionally deleting a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ConditionalDelete(parent string, type_ string) *ProjectsLocationsDatasetsFhirStoresFhirConditionalDeleteCall { c := &ProjectsLocationsDatasetsFhirStoresFhirConditionalDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -23761,12 +23588,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalPatchCall struct { // ConditionalPatch: If a resource is found based on the search criteria // specified in the query parameters, updates part of that resource by -// applying the operations specified in a [JSON -// Patch](http://jsonpatch.com/) document. Implements the FHIR standard -// conditional patch interaction -// ([STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#patch) -// , [R4](https://hl7.org/implement/standards/fhir/R4/http.html#patch)). -// DSTU2 doesn't define a conditional patch method, but the server +// applying the operations specified in a JSON Patch document. +// Implements the FHIR standard conditional patch interaction (STU3, +// R4). DSTU2 doesn't define a conditional patch method, but the server // supports it in the same way it supports STU3. Search terms are // provided as query parameters following the same pattern as the search // method. If the search criteria identify more than one match, the @@ -23782,9 +23606,7 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalPatchCall struct { // the`healthcare.fhirStores.searchResources` permission on the parent // FHIR store and the `healthcare.fhirResources.patch` permission on the // requested FHIR store resource. For samples that show how to call -// `conditionalPatch`, see [Conditionally patching a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#conditionally_patchi -// ng_a_fhir_resource). +// `conditionalPatch`, see Conditionally patching a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ConditionalPatch(parent string, type_ string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirConditionalPatchCall { c := &ProjectsLocationsDatasetsFhirStoresFhirConditionalPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -23899,35 +23721,28 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalUpdateCall struct { // ConditionalUpdate: If a resource is found based on the search // criteria specified in the query parameters, updates the entire // contents of that resource. Implements the FHIR standard conditional -// update interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1. -// 0.10.2), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#cond-up -// date), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#cond-update -// )). Search terms are provided as query parameters following the same -// pattern as the search method. If the search criteria identify more -// than one match, the request returns a `412 Precondition Failed` -// error. If the search criteria identify zero matches, and the supplied -// resource body contains an `id`, and the FHIR store has -// enable_update_create set, creates the resource with the -// client-specified ID. If the search criteria identify zero matches, -// and the supplied resource body does not contain an `id`, the resource -// is created with a server-assigned ID as per the create method. The -// request body must contain a JSON-encoded FHIR resource, and the -// request headers must contain `Content-Type: application/fhir+json`. -// On success, the response body contains a JSON-encoded representation -// of the updated resource, including the server-assigned version ID. -// Errors generated by the FHIR store contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. This method requires +// update interaction (DSTU2, STU3, R4). Search terms are provided as +// query parameters following the same pattern as the search method. If +// the search criteria identify more than one match, the request returns +// a `412 Precondition Failed` error. If the search criteria identify +// zero matches, and the supplied resource body contains an `id`, and +// the FHIR store has enable_update_create set, creates the resource +// with the client-specified ID. If the search criteria identify zero +// matches, and the supplied resource body does not contain an `id`, the +// resource is created with a server-assigned ID as per the create +// method. The request body must contain a JSON-encoded FHIR resource, +// and the request headers must contain `Content-Type: +// application/fhir+json`. On success, the response body contains a +// JSON-encoded representation of the updated resource, including the +// server-assigned version ID. Errors generated by the FHIR store +// contain a JSON-encoded `OperationOutcome` resource describing the +// reason for the error. If the request cannot be mapped to a valid API +// method on a FHIR store, a generic GCP error might be returned +// instead. This method requires // the`healthcare.fhirStores.searchResources` and // `healthcare.fhirResources.update` permissions on the parent FHIR // store. For samples that show how to call `conditionalUpdate`, see -// [Conditionally updating a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#conditionally_updati -// ng_a_fhir_resource). +// Conditionally updating a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ConditionalUpdate(parent string, type_ string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirConditionalUpdateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirConditionalUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -24040,34 +23855,21 @@ type ProjectsLocationsDatasetsFhirStoresFhirCreateCall struct { } // Create: Creates a FHIR resource. Implements the FHIR standard create -// interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#crea -// te), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#create) -// , -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#create)), -// which creates a new resource with a server-assigned resource ID. Also -// supports the FHIR standard conditional create interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#ccre -// ate), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#ccreate -// ), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#ccreate)), -// specified by supplying an `If-None-Exist` header containing a FHIR -// search query. If no resources match this search query, the server -// processes the create operation as normal. The request body must -// contain a JSON-encoded FHIR resource, and the request headers must -// contain `Content-Type: application/fhir+json`. On success, the -// response body contains a JSON-encoded representation of the resource -// as it was created on the server, including the server-assigned -// resource ID and version ID. Errors generated by the FHIR store -// contain a JSON-encoded `OperationOutcome` resource describing the -// reason for the error. If the request cannot be mapped to a valid API -// method on a FHIR store, a generic GCP error might be returned -// instead. For samples that show how to call `create`, see [Creating a -// FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#creating_a_fhir_reso -// urce). +// interaction (DSTU2, STU3, R4), which creates a new resource with a +// server-assigned resource ID. Also supports the FHIR standard +// conditional create interaction (DSTU2, STU3, R4), specified by +// supplying an `If-None-Exist` header containing a FHIR search query. +// If no resources match this search query, the server processes the +// create operation as normal. The request body must contain a +// JSON-encoded FHIR resource, and the request headers must contain +// `Content-Type: application/fhir+json`. On success, the response body +// contains a JSON-encoded representation of the resource as it was +// created on the server, including the server-assigned resource ID and +// version ID. Errors generated by the FHIR store contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. For samples that show +// how to call `create`, see Creating a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Create(parent string, type_ string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirCreateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -24178,20 +23980,12 @@ type ProjectsLocationsDatasetsFhirStoresFhirDeleteCall struct { } // Delete: Deletes a FHIR resource. Implements the FHIR standard delete -// interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#dele -// te), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#delete) -// , -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#delete)). -// Note: Unless resource versioning is disabled by setting the -// disable_resource_versioning flag on the FHIR store, the deleted -// resources are moved to a history repository that can still be -// retrieved through vread and related methods, unless they are removed -// by the purge method. For samples that show how to call `delete`, see -// [Deleting a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#deleting_a_fhir_reso -// urce). +// interaction (DSTU2, STU3, R4). Note: Unless resource versioning is +// disabled by setting the disable_resource_versioning flag on the FHIR +// store, the deleted resources are moved to a history repository that +// can still be retrieved through vread and related methods, unless they +// are removed by the purge method. For samples that show how to call +// `delete`, see Deleting a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Delete(name string) *ProjectsLocationsDatasetsFhirStoresFhirDeleteCall { c := &ProjectsLocationsDatasetsFhirStoresFhirDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -24290,46 +24084,29 @@ type ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall struct { } // ExecuteBundle: Executes all the requests in the given Bundle. -// Implements the FHIR standard batch/transaction interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#tran -// saction), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#transac -// tion), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#transaction -// )). Supports all interactions within a bundle, except search. This -// method accepts Bundles of type `batch` and `transaction`, processing -// them according to the batch processing rules -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1. -// 0.16.1), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0. -// 17.1), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#brules)) -// and transaction processing rules -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1. -// 0.16.2), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0. -// 17.2), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#trules)). -// The request body must contain a JSON-encoded FHIR `Bundle` resource, -// and the request headers must contain `Content-Type: -// application/fhir+json`. For a batch bundle or a successful -// transaction the response body contains a JSON-encoded representation -// of a `Bundle` resource of type `batch-response` or -// `transaction-response` containing one entry for each entry in the -// request, with the outcome of processing the entry. In the case of an -// error for a transaction bundle, the response body contains a -// JSON-encoded `OperationOutcome` resource describing the reason for -// the error. If the request cannot be mapped to a valid API method on a -// FHIR store, a generic GCP error might be returned instead. This -// method requires permission for executing the requests in the bundle. -// The `executeBundle` permission grants permission to execute the -// request in the bundle but you must grant sufficient permissions to -// execute the individual requests in the bundle. For example, if the -// bundle contains a `create` request, you must have permission to -// execute the `create` request. Logging is available for the -// `executeBundle` permission. For samples that show how to call -// `executeBundle`, see [Managing FHIR resources using FHIR -// bundles](/healthcare/docs/how-tos/fhir-bundles). +// Implements the FHIR standard batch/transaction interaction (DSTU2, +// STU3, R4). Supports all interactions within a bundle, except search. +// This method accepts Bundles of type `batch` and `transaction`, +// processing them according to the batch processing rules (DSTU2, STU3, +// R4) and transaction processing rules (DSTU2, STU3, R4). The request +// body must contain a JSON-encoded FHIR `Bundle` resource, and the +// request headers must contain `Content-Type: application/fhir+json`. +// For a batch bundle or a successful transaction the response body +// contains a JSON-encoded representation of a `Bundle` resource of type +// `batch-response` or `transaction-response` containing one entry for +// each entry in the request, with the outcome of processing the entry. +// In the case of an error for a transaction bundle, the response body +// contains a JSON-encoded `OperationOutcome` resource describing the +// reason for the error. If the request cannot be mapped to a valid API +// method on a FHIR store, a generic GCP error might be returned +// instead. This method requires permission for executing the requests +// in the bundle. The `executeBundle` permission grants permission to +// execute the request in the bundle but you must grant sufficient +// permissions to execute the individual requests in the bundle. For +// example, if the bundle contains a `create` request, you must have +// permission to execute the `create` request. Logging is available for +// the `executeBundle` permission. For samples that show how to call +// `executeBundle`, see Managing FHIR resources using FHIR bundles. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ExecuteBundle(parent string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall { c := &ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -24432,22 +24209,15 @@ type ProjectsLocationsDatasetsFhirStoresFhirHistoryCall struct { // History: Lists all the versions of a resource (including the current // version and deleted versions) from the FHIR store. Implements the -// per-resource form of the FHIR standard history interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#hist -// ory), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#history -// ), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#history)). -// On success, the response body contains a JSON-encoded representation -// of a `Bundle` resource of type `history`, containing the version -// history sorted from most recent to oldest versions. Errors generated -// by the FHIR store contain a JSON-encoded `OperationOutcome` resource -// describing the reason for the error. If the request cannot be mapped -// to a valid API method on a FHIR store, a generic GCP error might be -// returned instead. For samples that show how to call `history`, see -// [Listing FHIR resource -// versions](/healthcare/docs/how-tos/fhir-resources#listing_fhir_resourc -// e_versions). +// per-resource form of the FHIR standard history interaction (DSTU2, +// STU3, R4). On success, the response body contains a JSON-encoded +// representation of a `Bundle` resource of type `history`, containing +// the version history sorted from most recent to oldest versions. +// Errors generated by the FHIR store contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. For samples that show +// how to call `history`, see Listing FHIR resource versions. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) History(name string) *ProjectsLocationsDatasetsFhirStoresFhirHistoryCall { c := &ProjectsLocationsDatasetsFhirStoresFhirHistoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -24622,23 +24392,18 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatchCall struct { } // Patch: Updates part of an existing resource by applying the -// operations specified in a [JSON Patch](http://jsonpatch.com/) -// document. Implements the FHIR standard patch interaction -// ([STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#patch) -// , [R4](https://hl7.org/implement/standards/fhir/R4/http.html#patch)). -// DSTU2 doesn't define a patch method, but the server supports it in -// the same way it supports STU3. The request body must contain a JSON -// Patch document, and the request headers must contain `Content-Type: -// application/json-patch+json`. On success, the response body contains -// a JSON-encoded representation of the updated resource, including the -// server-assigned version ID. Errors generated by the FHIR store -// contain a JSON-encoded `OperationOutcome` resource describing the -// reason for the error. If the request cannot be mapped to a valid API -// method on a FHIR store, a generic GCP error might be returned -// instead. For samples that show how to call `patch`, see [Patching a -// FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#patching_a_fhir_reso -// urce). +// operations specified in a JSON Patch document. Implements the FHIR +// standard patch interaction (STU3, R4). DSTU2 doesn't define a patch +// method, but the server supports it in the same way it supports STU3. +// The request body must contain a JSON Patch document, and the request +// headers must contain `Content-Type: application/json-patch+json`. On +// success, the response body contains a JSON-encoded representation of +// the updated resource, including the server-assigned version ID. +// Errors generated by the FHIR store contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. For samples that show +// how to call `patch`, see Patching a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Patch(name string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirPatchCall { c := &ProjectsLocationsDatasetsFhirStoresFhirPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -24740,26 +24505,16 @@ type ProjectsLocationsDatasetsFhirStoresFhirReadCall struct { } // Read: Gets the contents of a FHIR resource. Implements the FHIR -// standard read interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#read -// ), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#read), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#read)). -// Also supports the FHIR standard conditional read interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#crea -// d), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#cread), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#cread)) -// specified by supplying an `If-Modified-Since` header with a date/time -// value or an `If-None-Match` header with an ETag value. On success, -// the response body contains a JSON-encoded representation of the -// resource. Errors generated by the FHIR store contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. For samples that show -// how to call `read`, see [Getting a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#getting_a_fhir_resou -// rce). +// standard read interaction (DSTU2, STU3, R4). Also supports the FHIR +// standard conditional read interaction (DSTU2, STU3, R4) specified by +// supplying an `If-Modified-Since` header with a date/time value or an +// `If-None-Match` header with an ETag value. On success, the response +// body contains a JSON-encoded representation of the resource. Errors +// generated by the FHIR store contain a JSON-encoded `OperationOutcome` +// resource describing the reason for the error. If the request cannot +// be mapped to a valid API method on a FHIR store, a generic GCP error +// might be returned instead. For samples that show how to call `read`, +// see Getting a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Read(name string) *ProjectsLocationsDatasetsFhirStoresFhirReadCall { c := &ProjectsLocationsDatasetsFhirStoresFhirReadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -24872,15 +24627,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // Search: Searches for resources in the given FHIR store according to // criteria specified as query parameters. Implements the FHIR standard -// search interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#sear -// ch), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#search) -// , [R4](https://hl7.org/implement/standards/fhir/R4/http.html#search)) -// using the search semantics described in the FHIR Search specification -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/search.html), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/search.html), -// [R4](https://hl7.org/implement/standards/fhir/R4/search.html)). +// search interaction (DSTU2, STU3, R4) using the search semantics +// described in the FHIR Search specification (DSTU2, STU3, R4). // Supports three methods of search defined by the specification: * `GET // [base]?[parameters]` to search across all resources. * `GET // [base]/[type]?[parameters]` to search resources of a specified type. @@ -24897,28 +24645,23 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // statement, retrieved through capabilities, indicates what search // parameters are supported on each FHIR resource. A list of all search // parameters defined by the specification can be found in the FHIR -// Search Parameter Registry -// ([STU3](https://hl7.org/implement/standards/fhir/STU3/searchparameter- -// registry.html), -// [R4](https://hl7.org/implement/standards/fhir/R4/searchparameter-regis -// try.html)). FHIR search parameters for DSTU2 can be found on each -// resource's definition page. Supported search modifiers: `:missing`, -// `:exact`, `:contains`, `:text`, `:in`, `:not-in`, `:above`, `:below`, -// `:[type]`, `:not`, and `:recurse`. Supported search result -// parameters: `_sort`, `_count`, `_include`, `_revinclude`, -// `_summary=text`, `_summary=data`, and `_elements`. The maximum number -// of search results returned defaults to 100, which can be overridden -// by the `_count` parameter up to a maximum limit of 1000. If there are -// additional results, the returned `Bundle` contains pagination links. -// Resources with a total size larger than 5MB or a field count larger -// than 50,000 might not be fully searchable as the server might trim -// its generated search index in those cases. Note: FHIR resources are -// indexed asynchronously, so there might be a slight delay between the -// time a resource is created or changes and when the change is -// reflected in search results. For samples and detailed information, -// see [Searching for FHIR -// resources](/healthcare/docs/how-tos/fhir-search) and [Advanced FHIR -// search features](/healthcare/docs/how-tos/fhir-advanced-search). +// Search Parameter Registry (STU3, R4). FHIR search parameters for +// DSTU2 can be found on each resource's definition page. Supported +// search modifiers: `:missing`, `:exact`, `:contains`, `:text`, `:in`, +// `:not-in`, `:above`, `:below`, `:[type]`, `:not`, and `:recurse`. +// Supported search result parameters: `_sort`, `_count`, `_include`, +// `_revinclude`, `_summary=text`, `_summary=data`, and `_elements`. The +// maximum number of search results returned defaults to 100, which can +// be overridden by the `_count` parameter up to a maximum limit of +// 1000. If there are additional results, the returned `Bundle` contains +// pagination links. Resources with a total size larger than 5MB or a +// field count larger than 50,000 might not be fully searchable as the +// server might trim its generated search index in those cases. Note: +// FHIR resources are indexed asynchronously, so there might be a slight +// delay between the time a resource is created or changes and when the +// change is reflected in search results. For samples and detailed +// information, see Searching for FHIR resources and Advanced FHIR +// search features. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Search(parent string, searchresourcesrequest *SearchResourcesRequest) *ProjectsLocationsDatasetsFhirStoresFhirSearchCall { c := &ProjectsLocationsDatasetsFhirStoresFhirSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -25026,27 +24769,20 @@ type ProjectsLocationsDatasetsFhirStoresFhirUpdateCall struct { } // Update: Updates the entire contents of a resource. Implements the -// FHIR standard update interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#upda -// te), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#update) -// , -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#update)). -// If the specified resource does not exist and the FHIR store has -// enable_update_create set, creates the resource with the -// client-specified ID. The request body must contain a JSON-encoded -// FHIR resource, and the request headers must contain `Content-Type: -// application/fhir+json`. The resource must contain an `id` element -// having an identical value to the ID in the REST path of the request. -// On success, the response body contains a JSON-encoded representation -// of the updated resource, including the server-assigned version ID. -// Errors generated by the FHIR store contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. For samples that show -// how to call `update`, see [Updating a FHIR -// resource](/healthcare/docs/how-tos/fhir-resources#updating_a_fhir_reso -// urce). +// FHIR standard update interaction (DSTU2, STU3, R4). If the specified +// resource does not exist and the FHIR store has enable_update_create +// set, creates the resource with the client-specified ID. The request +// body must contain a JSON-encoded FHIR resource, and the request +// headers must contain `Content-Type: application/fhir+json`. The +// resource must contain an `id` element having an identical value to +// the ID in the REST path of the request. On success, the response body +// contains a JSON-encoded representation of the updated resource, +// including the server-assigned version ID. Errors generated by the +// FHIR store contain a JSON-encoded `OperationOutcome` resource +// describing the reason for the error. If the request cannot be mapped +// to a valid API method on a FHIR store, a generic GCP error might be +// returned instead. For samples that show how to call `update`, see +// Updating a FHIR resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Update(name string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirUpdateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -25149,20 +24885,13 @@ type ProjectsLocationsDatasetsFhirStoresFhirVreadCall struct { // Vread: Gets the contents of a version (current or historical) of a // FHIR resource by version ID. Implements the FHIR standard vread -// interaction -// ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#vrea -// d), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#vread), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#vread)). -// On success, the response body contains a JSON-encoded representation -// of the resource. Errors generated by the FHIR store contain a -// JSON-encoded `OperationOutcome` resource describing the reason for -// the error. If the request cannot be mapped to a valid API method on a -// FHIR store, a generic GCP error might be returned instead. For -// samples that show how to call `vread`, see [Retrieving a FHIR -// resource -// version](/healthcare/docs/how-tos/fhir-resources#retrieving_a_fhir_res -// ource_version). +// interaction (DSTU2, STU3, R4). On success, the response body contains +// a JSON-encoded representation of the resource. Errors generated by +// the FHIR store contain a JSON-encoded `OperationOutcome` resource +// describing the reason for the error. If the request cannot be mapped +// to a valid API method on a FHIR store, a generic GCP error might be +// returned instead. For samples that show how to call `vread`, see +// Retrieving a FHIR resource version. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Vread(name string) *ProjectsLocationsDatasetsFhirStoresFhirVreadCall { c := &ProjectsLocationsDatasetsFhirStoresFhirVreadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -25864,9 +25593,7 @@ func (r *ProjectsLocationsDatasetsHl7V2StoresService) GetIamPolicy(resource stri // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsDatasetsHl7V2StoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsHl7V2StoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -26037,10 +25764,9 @@ type ProjectsLocationsDatasetsHl7V2StoresImportCall struct { // This method returns an Operation that can be used to track the status // of the import by calling GetOperation. Immediate fatal errors appear // in the error field, errors are also logged to Cloud Logging (see -// [Viewing logs](/healthcare/docs/how-tos/logging)). Otherwise, when -// the operation finishes, a response of type ImportMessagesResponse is -// returned in the response field. The metadata field type for this -// operation is OperationMetadata. +// Viewing logs). Otherwise, when the operation finishes, a response of +// type ImportMessagesResponse is returned in the response field. The +// metadata field type for this operation is OperationMetadata. func (r *ProjectsLocationsDatasetsHl7V2StoresService) Import(name string, importmessagesrequest *ImportMessagesRequest) *ProjectsLocationsDatasetsHl7V2StoresImportCall { c := &ProjectsLocationsDatasetsHl7V2StoresImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/homegraph/v1/homegraph-gen.go b/homegraph/v1/homegraph-gen.go index 5e15629b09e..38822c934f2 100644 --- a/homegraph/v1/homegraph-gen.go +++ b/homegraph/v1/homegraph-gen.go @@ -221,11 +221,7 @@ type Device struct { Attributes googleapi.RawMessage `json:"attributes,omitempty"` // CustomData: Custom device attributes stored in Home Graph and - // provided to your smart home Action in each - // [QUERY](https://developers.google.com/assistant/smarthome/reference/in - // tent/query) and - // [EXECUTE](https://developers.google.com/assistant/smarthome/reference/ - // intent/execute) intent. + // provided to your smart home Action in each QUERY and EXECUTE intent. CustomData googleapi.RawMessage `json:"customData,omitempty"` // DeviceInfo: Device manufacturer, model, hardware version, and @@ -246,9 +242,7 @@ type Device struct { NotificationSupportedByAgent bool `json:"notificationSupportedByAgent,omitempty"` // OtherDeviceIds: Alternate IDs associated with this device. This is - // used to identify cloud synced devices enabled for [local - // fulfillment](https://developers.google.com/assistant/smarthome/concept - // s/local). + // used to identify cloud synced devices enabled for local fulfillment. OtherDeviceIds []*AgentOtherDeviceId `json:"otherDeviceIds,omitempty"` // RoomHint: Suggested name for the room where this device is installed. @@ -259,12 +253,10 @@ type Device struct { // installed. Google attempts to use this value during user setup. StructureHint string `json:"structureHint,omitempty"` - // Traits: Traits supported by the device. See [device - // traits](https://developers.google.com/assistant/smarthome/traits). + // Traits: Traits supported by the device. See device traits. Traits []string `json:"traits,omitempty"` - // Type: Hardware type of the device. See [device - // types](https://developers.google.com/assistant/smarthome/guides). + // Type: Hardware type of the device. See device types. Type string `json:"type,omitempty"` // WillReportState: Indicates whether your smart home Action will report @@ -378,8 +370,7 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } -// QueryRequest: Request type for the -// [`Query`](#google.home.graph.v1.HomeGraphApiService.Query) call. +// QueryRequest: Request type for the `Query` call. type QueryRequest struct { // AgentUserId: Required. Third-party user ID. AgentUserId string `json:"agentUserId,omitempty"` @@ -470,12 +461,9 @@ func (s *QueryRequestPayload) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// QueryResponse: Response type for the -// [`Query`](#google.home.graph.v1.HomeGraphApiService.Query) call. This -// should follow the same format as the Google smart home -// `action.devices.QUERY` -// [response](https://developers.google.com/assistant/smarthome/reference -// /intent/query). # Example ```json { "requestId": +// QueryResponse: Response type for the `Query` call. This should follow +// the same format as the Google smart home `action.devices.QUERY` +// response. # Example ```json { "requestId": // "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "devices": { // "123": { "on": true, "online": true }, "456": { "on": true, "online": // true, "brightness": 80, "color": { "name": "cerulean", "spectrumRGB": @@ -547,13 +535,11 @@ func (s *QueryResponsePayload) MarshalJSON() ([]byte, error) { // specific to a device. type ReportStateAndNotificationDevice struct { // Notifications: Notifications metadata for devices. See the **Device - // NOTIFICATIONS** section of the individual trait [reference - // guides](https://developers.google.com/assistant/smarthome/traits). + // NOTIFICATIONS** section of the individual trait reference guides. Notifications googleapi.RawMessage `json:"notifications,omitempty"` // States: States of devices to update. See the **Device STATES** - // section of the individual trait [reference - // guides](https://developers.google.com/assistant/smarthome/traits). + // section of the individual trait reference guides. States googleapi.RawMessage `json:"states,omitempty"` // ForceSendFields is a list of field names (e.g. "Notifications") to @@ -580,8 +566,7 @@ func (s *ReportStateAndNotificationDevice) MarshalJSON() ([]byte, error) { } // ReportStateAndNotificationRequest: Request type for the -// [`ReportStateAndNotification`](#google.home.graph.v1.HomeGraphApiServi -// ce.ReportStateAndNotification) call. It may include states, +// `ReportStateAndNotification` call. It may include states, // notifications, or both. States and notifications are defined per // `device_id` (for example, "123" and "456" in the following example). // # Example ```json { "requestId": @@ -596,9 +581,8 @@ type ReportStateAndNotificationRequest struct { EventId string `json:"eventId,omitempty"` // FollowUpToken: Token to maintain state in the follow up notification - // response. Deprecated. See the [notifications - // guide](https://developers.google.com/assistant/smarthome/develop/notif - // ications) for details on implementing follow up notifications. + // response. Deprecated. See the notifications guide for details on + // implementing follow up notifications. FollowUpToken string `json:"followUpToken,omitempty"` // Payload: Required. State of devices to update and notification @@ -632,8 +616,7 @@ func (s *ReportStateAndNotificationRequest) MarshalJSON() ([]byte, error) { } // ReportStateAndNotificationResponse: Response type for the -// [`ReportStateAndNotification`](#google.home.graph.v1.HomeGraphApiServi -// ce.ReportStateAndNotification) call. +// `ReportStateAndNotification` call. type ReportStateAndNotificationResponse struct { // RequestId: Request ID copied from ReportStateAndNotificationRequest. RequestId string `json:"requestId,omitempty"` @@ -665,9 +648,8 @@ func (s *ReportStateAndNotificationResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// RequestSyncDevicesRequest: Request type for the -// [`RequestSyncDevices`](#google.home.graph.v1.HomeGraphApiService.Reque -// stSyncDevices) call. +// RequestSyncDevicesRequest: Request type for the `RequestSyncDevices` +// call. type RequestSyncDevicesRequest struct { // AgentUserId: Required. Third-party user ID. AgentUserId string `json:"agentUserId,omitempty"` @@ -702,8 +684,7 @@ func (s *RequestSyncDevicesRequest) MarshalJSON() ([]byte, error) { } // RequestSyncDevicesResponse: Response type for the -// [`RequestSyncDevices`](#google.home.graph.v1.HomeGraphApiService.Reque -// stSyncDevices) call. Intentionally empty upon success. An HTTP +// `RequestSyncDevices` call. Intentionally empty upon success. An HTTP // response code is returned with more details upon failure. type RequestSyncDevicesResponse struct { // ServerResponse contains the HTTP response code and headers from the @@ -740,8 +721,7 @@ func (s *StateAndNotificationPayload) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// SyncRequest: Request type for the -// [`Sync`](#google.home.graph.v1.HomeGraphApiService.Sync) call. +// SyncRequest: Request type for the `Sync` call. type SyncRequest struct { // AgentUserId: Required. Third-party user ID. AgentUserId string `json:"agentUserId,omitempty"` @@ -772,12 +752,9 @@ func (s *SyncRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// SyncResponse: Response type for the -// [`Sync`](#google.home.graph.v1.HomeGraphApiService.Sync) call. This -// should follow the same format as the Google smart home -// `action.devices.SYNC` -// [response](https://developers.google.com/assistant/smarthome/reference -// /intent/sync). # Example ```json { "requestId": +// SyncResponse: Response type for the `Sync` call. This should follow +// the same format as the Google smart home `action.devices.SYNC` +// response. # Example ```json { "requestId": // "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "agentUserId": // "1836.15267389", "devices": [{ "id": "123", "type": // "action.devices.types.OUTLET", "traits": [ @@ -864,12 +841,11 @@ type AgentUsersDeleteCall struct { // Delete: Unlinks the given third-party user from your smart home // Action. All data related to this user will be deleted. For more -// details on how users link their accounts, see [fulfillment and -// authentication](https://developers.google.com/assistant/smarthome/conc -// epts/fulfillment-authentication). The third-party user's identity is -// passed in via the `agent_user_id` (see DeleteAgentUserRequest). This -// request must be authorized using service account credentials from -// your Actions console project. +// details on how users link their accounts, see fulfillment and +// authentication. The third-party user's identity is passed in via the +// `agent_user_id` (see DeleteAgentUserRequest). This request must be +// authorized using service account credentials from your Actions +// console project. func (r *AgentUsersService) Delete(agentUserId string) *AgentUsersDeleteCall { c := &AgentUsersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.agentUserId = agentUserId @@ -1143,13 +1119,10 @@ type DevicesReportStateAndNotificationCall struct { // ReportStateAndNotification: Reports device state and optionally sends // device notifications. Called by your smart home Action when the state // of a third-party device changes or you need to send a notification -// about the device. See [Implement Report -// State](https://developers.google.com/assistant/smarthome/develop/repor -// t-state) for more information. This method updates the device state -// according to its declared -// [traits](https://developers.google.com/assistant/smarthome/concepts/de -// vices-traits). Publishing a new state value outside of these traits -// will result in an `INVALID_ARGUMENT` error response. The third-party +// about the device. See Implement Report State for more information. +// This method updates the device state according to its declared +// traits. Publishing a new state value outside of these traits will +// result in an `INVALID_ARGUMENT` error response. The third-party // user's identity is passed in via the `agent_user_id` (see // ReportStateAndNotificationRequest). This request must be authorized // using service account credentials from your Actions console project. @@ -1278,10 +1251,9 @@ type DevicesRequestSyncCall struct { header_ http.Header } -// RequestSync: Requests Google to send an `action.devices.SYNC` -// [intent](https://developers.google.com/assistant/smarthome/reference/i -// ntent/sync) to your smart home Action to update device metadata for -// the given user. The third-party user's identity is passed via the +// RequestSync: Requests Google to send an `action.devices.SYNC` intent +// to your smart home Action to update device metadata for the given +// user. The third-party user's identity is passed via the // `agent_user_id` (see RequestSyncDevicesRequest). This request must be // authorized using service account credentials from your Actions // console project. diff --git a/iam/v1/iam-gen.go b/iam/v1/iam-gen.go index e903b083db7..030e0d3c66a 100644 --- a/iam/v1/iam-gen.go +++ b/iam/v1/iam-gen.go @@ -497,9 +497,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1270,9 +1268,8 @@ func (s *PermissionDelta) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1290,8 +1287,8 @@ func (s *PermissionDelta) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1330,9 +1327,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1696,12 +1692,11 @@ func (s *Role) MarshalJSON() ([]byte, error) { // ServiceAccount: An IAM service account. A service account is an // account for an application or a virtual machine (VM) instance, not a // person. You can use a service account to call Google APIs. To learn -// more, read the [overview of service -// accounts](https://cloud.google.com/iam/help/service-accounts/overview) -// . When you create a service account, you specify the project ID that -// owns the service account, as well as a name that must be unique -// within the project. IAM uses these values to create an email address -// that identifies the service account. +// more, read the overview of service accounts. When you create a +// service account, you specify the project ID that owns the service +// account, as well as a name that must be unique within the project. +// IAM uses these values to create an email address that identifies the +// service account. type ServiceAccount struct { // Description: Optional. A user-specified, human-readable description // of the service account. The maximum length is 256 UTF-8 bytes. @@ -1927,14 +1922,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// SignBlobRequest: Deprecated. [Migrate to Service Account Credentials -// API](https://cloud.google.com/iam/help/credentials/migrate-api). The -// service account sign blob request. +// SignBlobRequest: Deprecated. Migrate to Service Account Credentials +// API. The service account sign blob request. type SignBlobRequest struct { - // BytesToSign: Required. Deprecated. [Migrate to Service Account - // Credentials - // API](https://cloud.google.com/iam/help/credentials/migrate-api). The - // bytes to sign. + // BytesToSign: Required. Deprecated. Migrate to Service Account + // Credentials API. The bytes to sign. BytesToSign string `json:"bytesToSign,omitempty"` // ForceSendFields is a list of field names (e.g. "BytesToSign") to @@ -1960,18 +1952,15 @@ func (s *SignBlobRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// SignBlobResponse: Deprecated. [Migrate to Service Account Credentials -// API](https://cloud.google.com/iam/help/credentials/migrate-api). The -// service account sign blob response. +// SignBlobResponse: Deprecated. Migrate to Service Account Credentials +// API. The service account sign blob response. type SignBlobResponse struct { - // KeyId: Deprecated. [Migrate to Service Account Credentials - // API](https://cloud.google.com/iam/help/credentials/migrate-api). The - // id of the key used to sign the blob. + // KeyId: Deprecated. Migrate to Service Account Credentials API. The id + // of the key used to sign the blob. KeyId string `json:"keyId,omitempty"` - // Signature: Deprecated. [Migrate to Service Account Credentials - // API](https://cloud.google.com/iam/help/credentials/migrate-api). The - // signed blob. + // Signature: Deprecated. Migrate to Service Account Credentials API. + // The signed blob. Signature string `json:"signature,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2001,20 +1990,17 @@ func (s *SignBlobResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// SignJwtRequest: Deprecated. [Migrate to Service Account Credentials -// API](https://cloud.google.com/iam/help/credentials/migrate-api). The -// service account sign JWT request. +// SignJwtRequest: Deprecated. Migrate to Service Account Credentials +// API. The service account sign JWT request. type SignJwtRequest struct { - // Payload: Required. Deprecated. [Migrate to Service Account - // Credentials - // API](https://cloud.google.com/iam/help/credentials/migrate-api). The - // JWT payload to sign. Must be a serialized JSON object that contains a - // JWT Claims Set. For example: `{"sub": "user@example.com", "iat": - // 313435}` If the JWT Claims Set contains an expiration time (`exp`) - // claim, it must be an integer timestamp that is not in the past and no - // more than 1 hour in the future. If the JWT Claims Set does not - // contain an expiration time (`exp`) claim, this claim is added - // automatically, with a timestamp that is 1 hour in the future. + // Payload: Required. Deprecated. Migrate to Service Account Credentials + // API. The JWT payload to sign. Must be a serialized JSON object that + // contains a JWT Claims Set. For example: `{"sub": "user@example.com", + // "iat": 313435}` If the JWT Claims Set contains an expiration time + // (`exp`) claim, it must be an integer timestamp that is not in the + // past and no more than 1 hour in the future. If the JWT Claims Set + // does not contain an expiration time (`exp`) claim, this claim is + // added automatically, with a timestamp that is 1 hour in the future. Payload string `json:"payload,omitempty"` // ForceSendFields is a list of field names (e.g. "Payload") to @@ -2040,18 +2026,15 @@ func (s *SignJwtRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// SignJwtResponse: Deprecated. [Migrate to Service Account Credentials -// API](https://cloud.google.com/iam/help/credentials/migrate-api). The -// service account sign JWT response. +// SignJwtResponse: Deprecated. Migrate to Service Account Credentials +// API. The service account sign JWT response. type SignJwtResponse struct { - // KeyId: Deprecated. [Migrate to Service Account Credentials - // API](https://cloud.google.com/iam/help/credentials/migrate-api). The - // id of the key used to sign the JWT. + // KeyId: Deprecated. Migrate to Service Account Credentials API. The id + // of the key used to sign the JWT. KeyId string `json:"keyId,omitempty"` - // SignedJwt: Deprecated. [Migrate to Service Account Credentials - // API](https://cloud.google.com/iam/help/credentials/migrate-api). The - // signed JWT. + // SignedJwt: Deprecated. Migrate to Service Account Credentials API. + // The signed JWT. SignedJwt string `json:"signedJwt,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2083,11 +2066,10 @@ func (s *SignJwtResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2130,8 +2112,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2428,8 +2409,7 @@ type IamPoliciesQueryAuditableServicesCall struct { // QueryAuditableServices: Returns a list of services that allow you to // opt into audit logs that are not generated by default. To learn more -// about audit logs, see the [Logging -// documentation](https://cloud.google.com/logging/docs/audit). +// about audit logs, see the Logging documentation. func (r *IamPoliciesService) QueryAuditableServices(queryauditableservicesrequest *QueryAuditableServicesRequest) *IamPoliciesQueryAuditableServicesCall { c := &IamPoliciesQueryAuditableServicesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.queryauditableservicesrequest = queryauditableservicesrequest @@ -5642,8 +5622,7 @@ type ProjectsServiceAccountsGetIamPolicyCall struct { // check whether a service account has role grants on a resource, use // the `getIamPolicy` method for that resource. For example, to view the // role grants for a project, call the Resource Manager API's -// [`projects.getIamPolicy`](https://cloud.google.com/resource-manager/re -// ference/rest/v1/projects/getIamPolicy) method. +// `projects.getIamPolicy` method. func (r *ProjectsServiceAccountsService) GetIamPolicy(resource string) *ProjectsServiceAccountsGetIamPolicyCall { c := &ProjectsServiceAccountsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -5657,9 +5636,7 @@ func (r *ProjectsServiceAccountsService) GetIamPolicy(resource string) *Projects // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsServiceAccountsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsServiceAccountsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -6138,10 +6115,8 @@ type ProjectsServiceAccountsSetIamPolicyCall struct { // resource's `getIamPolicy` method to get its current IAM policy. 2. // Edit the policy so that it binds the service account to an IAM role // for the resource. 3. Call the resource's `setIamPolicy` method to -// update its IAM policy. For detailed instructions, see [Granting roles -// to a service account for specific -// resources](https://cloud.google.com/iam/help/service-accounts/granting -// -access-to-service-accounts). +// update its IAM policy. For detailed instructions, see Granting roles +// to a service account for specific resources. func (r *ProjectsServiceAccountsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsServiceAccountsSetIamPolicyCall { c := &ProjectsServiceAccountsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -6282,14 +6257,10 @@ type ProjectsServiceAccountsSignBlobCall struct { } // SignBlob: **Note:** This method is deprecated and will stop working -// on July 1, 2021. Use the -// [`signBlob`](https://cloud.google.com/iam/help/rest-credentials/v1/pro -// jects.serviceAccounts/signBlob) method in the IAM Service Account +// on July 1, 2021. Use the `signBlob` method in the IAM Service Account // Credentials API instead. If you currently use this method, see the -// [migration -// guide](https://cloud.google.com/iam/help/credentials/migrate-api) for -// instructions. Signs a blob using the system-managed private key for a -// ServiceAccount. +// migration guide for instructions. Signs a blob using the +// system-managed private key for a ServiceAccount. func (r *ProjectsServiceAccountsService) SignBlob(name string, signblobrequest *SignBlobRequest) *ProjectsServiceAccountsSignBlobCall { c := &ProjectsServiceAccountsSignBlobCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6430,14 +6401,10 @@ type ProjectsServiceAccountsSignJwtCall struct { } // SignJwt: **Note:** This method is deprecated and will stop working on -// July 1, 2021. Use the -// [`signJwt`](https://cloud.google.com/iam/help/rest-credentials/v1/proj -// ects.serviceAccounts/signJwt) method in the IAM Service Account +// July 1, 2021. Use the `signJwt` method in the IAM Service Account // Credentials API instead. If you currently use this method, see the -// [migration -// guide](https://cloud.google.com/iam/help/credentials/migrate-api) for -// instructions. Signs a JSON Web Token (JWT) using the system-managed -// private key for a ServiceAccount. +// migration guide for instructions. Signs a JSON Web Token (JWT) using +// the system-managed private key for a ServiceAccount. func (r *ProjectsServiceAccountsService) SignJwt(name string, signjwtrequest *SignJwtRequest) *ProjectsServiceAccountsSignJwtCall { c := &ProjectsServiceAccountsSignJwtCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7933,24 +7900,18 @@ func (c *RolesListCall) PageToken(pageToken string) *RolesListCall { } // Parent sets the optional parameter "parent": The `parent` parameter's -// value depends on the target resource for the request, namely -// [`roles`](/iam/reference/rest/v1/roles), -// [`projects`](/iam/reference/rest/v1/projects.roles), or -// [`organizations`](/iam/reference/rest/v1/organizations.roles). Each -// resource type's `parent` value format is described below: * -// [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string. -// This method doesn't require a resource; it simply returns all -// [predefined roles](/iam/docs/understanding-roles#predefined_roles) in -// Cloud IAM. Example request URL: `https://iam.googleapis.com/v1/roles` -// * -// [`projects.roles.list()`](/iam/reference/rest/v1/projects.roles/list): -// `projects/{PROJECT_ID}`. This method lists all project-level [custom -// roles](/iam/docs/understanding-custom-roles). Example request URL: +// value depends on the target resource for the request, namely `roles`, +// `projects`, or `organizations`. Each resource type's `parent` value +// format is described below: * `roles.list()`: An empty string. This +// method doesn't require a resource; it simply returns all predefined +// roles in Cloud IAM. Example request URL: +// `https://iam.googleapis.com/v1/roles` * `projects.roles.list()`: +// `projects/{PROJECT_ID}`. This method lists all project-level custom +// roles. Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * -// [`organizations.roles.list()`](/iam/reference/rest/v1/organizations.ro -// les/list): `organizations/{ORGANIZATION_ID}`. This method lists all -// organization-level [custom -// roles](/iam/docs/understanding-custom-roles). Example request URL: +// `organizations.roles.list()`: `organizations/{ORGANIZATION_ID}`. This +// method lists all organization-level custom roles. Example request +// URL: // `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` // Note: Wildcard (*) values are invalid; you must specify a complete // project ID or organization ID. diff --git a/iap/v1/iap-gen.go b/iap/v1/iap-gen.go index b2aa86bec74..9a7f7359aa6 100644 --- a/iap/v1/iap-gen.go +++ b/iap/v1/iap-gen.go @@ -299,9 +299,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -625,9 +623,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -851,9 +847,8 @@ func (s *OAuthSettings) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -871,8 +866,8 @@ func (s *OAuthSettings) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -907,9 +902,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1130,8 +1124,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/iap/v1beta1/iap-gen.go b/iap/v1beta1/iap-gen.go index 227f53c320a..6273da9e55d 100644 --- a/iap/v1beta1/iap-gen.go +++ b/iap/v1beta1/iap-gen.go @@ -152,9 +152,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -315,9 +313,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -356,9 +352,8 @@ func (s *GetPolicyOptions) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -376,8 +371,8 @@ func (s *GetPolicyOptions) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -412,9 +407,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -480,8 +474,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/jobs/v3/jobs-gen.go b/jobs/v3/jobs-gen.go index f4ceff6bc3d..ec4f3a7f6e0 100644 --- a/jobs/v3/jobs-gen.go +++ b/jobs/v3/jobs-gen.go @@ -1753,11 +1753,10 @@ type Job struct { // LanguageCode: Optional. The language of the posting. This field is // distinct from any requirements for fluency that are associated with // the job. Language codes must be in BCP-47 format, such as "en-US" or - // "sr-Latn". For more information, see [Tags for Identifying - // Languages](https://tools.ietf.org/html/bcp47){: class="external" - // target="_blank" }. If this field is unspecified and Job.description - // is present, detected language code based on Job.description is - // assigned, otherwise defaults to 'en_US'. + // "sr-Latn". For more information, see Tags for Identifying Languages{: + // class="external" target="_blank" }. If this field is unspecified and + // Job.description is present, detected language code based on + // Job.description is assigned, otherwise defaults to 'en_US'. LanguageCode string `json:"languageCode,omitempty"` // Name: Required during job update. The resource name for the job. This @@ -2274,8 +2273,7 @@ type JobQuery struct { // search against, for example, "en-US". If a value isn't specified, the // search results can contain jobs in any locale. Language codes should // be in BCP-47 format, such as "en-US" or "sr-Latn". For more - // information, see [Tags for Identifying - // Languages](https://tools.ietf.org/html/bcp47). At most 10 language + // information, see Tags for Identifying Languages. At most 10 language // code filters are allowed. LanguageCodes []string `json:"languageCodes,omitempty"` @@ -2303,8 +2301,8 @@ type JobQuery struct { // This field helps to better interpret the query. If a value isn't // specified, the query language code is automatically detected, which // may not be accurate. Language code should be in BCP-47 format, such - // as "en-US" or "sr-Latn". For more information, see [Tags for - // Identifying Languages](https://tools.ietf.org/html/bcp47). + // as "en-US" or "sr-Latn". For more information, see Tags for + // Identifying Languages. QueryLanguageCode string `json:"queryLanguageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "CommuteFilter") to @@ -3675,8 +3673,7 @@ func (c *ProjectsCompleteCall) CompanyName(companyName string) *ProjectsComplete // LanguageCode sets the optional parameter "languageCode": Deprecated. // Use language_codes instead. The language of the query. This is the // BCP-47 language code, such as "en-US" or "sr-Latn". For more -// information, see [Tags for Identifying -// Languages](https://tools.ietf.org/html/bcp47). For +// information, see Tags for Identifying Languages. For // CompletionType.JOB_TITLE type, only open jobs with the same // language_code are returned. For CompletionType.COMPANY_NAME type, // only companies having open jobs with the same language_code are @@ -3691,13 +3688,12 @@ func (c *ProjectsCompleteCall) LanguageCode(languageCode string) *ProjectsComple // LanguageCodes sets the optional parameter "languageCodes": The list // of languages of the query. This is the BCP-47 language code, such as -// "en-US" or "sr-Latn". For more information, see [Tags for Identifying -// Languages](https://tools.ietf.org/html/bcp47). For -// CompletionType.JOB_TITLE type, only open jobs with the same -// language_codes are returned. For CompletionType.COMPANY_NAME type, -// only companies having open jobs with the same language_codes are -// returned. For CompletionType.COMBINED type, only open jobs with the -// same language_codes or companies having open jobs with the same +// "en-US" or "sr-Latn". For more information, see Tags for Identifying +// Languages. For CompletionType.JOB_TITLE type, only open jobs with the +// same language_codes are returned. For CompletionType.COMPANY_NAME +// type, only companies having open jobs with the same language_codes +// are returned. For CompletionType.COMBINED type, only open jobs with +// the same language_codes or companies having open jobs with the same // language_codes are returned. The maximum number of allowed characters // is 255. func (c *ProjectsCompleteCall) LanguageCodes(languageCodes ...string) *ProjectsCompleteCall { @@ -3946,11 +3942,8 @@ type ProjectsClientEventsCreateCall struct { // Create: Report events issued when end user interacts with customer's // application that uses Cloud Talent Solution. You may inspect the -// created events in [self service -// tools](https://console.cloud.google.com/talent-solution/overview). -// [Learn -// more](https://cloud.google.com/talent-solution/docs/management-tools) -// about self service tools. +// created events in self service tools. Learn more about self service +// tools. func (r *ProjectsClientEventsService) Create(parent string, createclienteventrequest *CreateClientEventRequest) *ProjectsClientEventsCreateCall { c := &ProjectsClientEventsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/jobs/v3p1beta1/jobs-gen.go b/jobs/v3p1beta1/jobs-gen.go index a97537a88b3..4e4b61e914e 100644 --- a/jobs/v3p1beta1/jobs-gen.go +++ b/jobs/v3p1beta1/jobs-gen.go @@ -1967,11 +1967,10 @@ type Job struct { // LanguageCode: Optional. The language of the posting. This field is // distinct from any requirements for fluency that are associated with // the job. Language codes must be in BCP-47 format, such as "en-US" or - // "sr-Latn". For more information, see [Tags for Identifying - // Languages](https://tools.ietf.org/html/bcp47){: class="external" - // target="_blank" }. If this field is unspecified and Job.description - // is present, detected language code based on Job.description is - // assigned, otherwise defaults to 'en_US'. + // "sr-Latn". For more information, see Tags for Identifying Languages{: + // class="external" target="_blank" }. If this field is unspecified and + // Job.description is present, detected language code based on + // Job.description is assigned, otherwise defaults to 'en_US'. LanguageCode string `json:"languageCode,omitempty"` // Name: Required during job update. The resource name for the job. This @@ -2493,8 +2492,7 @@ type JobQuery struct { // search against, for example, "en-US". If a value isn't specified, the // search results can contain jobs in any locale. Language codes should // be in BCP-47 format, such as "en-US" or "sr-Latn". For more - // information, see [Tags for Identifying - // Languages](https://tools.ietf.org/html/bcp47). At most 10 language + // information, see Tags for Identifying Languages. At most 10 language // code filters are allowed. LanguageCodes []string `json:"languageCodes,omitempty"` @@ -2522,8 +2520,8 @@ type JobQuery struct { // This field helps to better interpret the query. If a value isn't // specified, the query language code is automatically detected, which // may not be accurate. Language code should be in BCP-47 format, such - // as "en-US" or "sr-Latn". For more information, see [Tags for - // Identifying Languages](https://tools.ietf.org/html/bcp47). + // as "en-US" or "sr-Latn". For more information, see Tags for + // Identifying Languages. QueryLanguageCode string `json:"queryLanguageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "CommuteFilter") to @@ -3810,11 +3808,10 @@ func (s *SpellingCorrection) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4031,8 +4028,7 @@ func (c *ProjectsCompleteCall) CompanyName(companyName string) *ProjectsComplete // LanguageCode sets the optional parameter "languageCode": Deprecated. // Use language_codes instead. The language of the query. This is the // BCP-47 language code, such as "en-US" or "sr-Latn". For more -// information, see [Tags for Identifying -// Languages](https://tools.ietf.org/html/bcp47). For +// information, see Tags for Identifying Languages. For // CompletionType.JOB_TITLE type, only open jobs with the same // language_code are returned. For CompletionType.COMPANY_NAME type, // only companies having open jobs with the same language_code are @@ -4047,13 +4043,12 @@ func (c *ProjectsCompleteCall) LanguageCode(languageCode string) *ProjectsComple // LanguageCodes sets the optional parameter "languageCodes": The list // of languages of the query. This is the BCP-47 language code, such as -// "en-US" or "sr-Latn". For more information, see [Tags for Identifying -// Languages](https://tools.ietf.org/html/bcp47). For -// CompletionType.JOB_TITLE type, only open jobs with the same -// language_codes are returned. For CompletionType.COMPANY_NAME type, -// only companies having open jobs with the same language_codes are -// returned. For CompletionType.COMBINED type, only open jobs with the -// same language_codes or companies having open jobs with the same +// "en-US" or "sr-Latn". For more information, see Tags for Identifying +// Languages. For CompletionType.JOB_TITLE type, only open jobs with the +// same language_codes are returned. For CompletionType.COMPANY_NAME +// type, only companies having open jobs with the same language_codes +// are returned. For CompletionType.COMBINED type, only open jobs with +// the same language_codes or companies having open jobs with the same // language_codes are returned. The maximum number of allowed characters // is 255. func (c *ProjectsCompleteCall) LanguageCodes(languageCodes ...string) *ProjectsCompleteCall { @@ -4302,11 +4297,8 @@ type ProjectsClientEventsCreateCall struct { // Create: Report events issued when end user interacts with customer's // application that uses Cloud Talent Solution. You may inspect the -// created events in [self service -// tools](https://console.cloud.google.com/talent-solution/overview). -// [Learn -// more](https://cloud.google.com/talent-solution/docs/management-tools) -// about self service tools. +// created events in self service tools. Learn more about self service +// tools. func (r *ProjectsClientEventsService) Create(parent string, createclienteventrequest *CreateClientEventRequest) *ProjectsClientEventsCreateCall { c := &ProjectsClientEventsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/jobs/v4/jobs-gen.go b/jobs/v4/jobs-gen.go index 3716c8f31c8..291ed0f3dae 100644 --- a/jobs/v4/jobs-gen.go +++ b/jobs/v4/jobs-gen.go @@ -1584,11 +1584,10 @@ type Job struct { // LanguageCode: The language of the posting. This field is distinct // from any requirements for fluency that are associated with the job. // Language codes must be in BCP-47 format, such as "en-US" or - // "sr-Latn". For more information, see [Tags for Identifying - // Languages](https://tools.ietf.org/html/bcp47){: class="external" - // target="_blank" }. If this field is unspecified and Job.description - // is present, detected language code based on Job.description is - // assigned, otherwise defaults to 'en_US'. + // "sr-Latn". For more information, see Tags for Identifying Languages{: + // class="external" target="_blank" }. If this field is unspecified and + // Job.description is present, detected language code based on + // Job.description is assigned, otherwise defaults to 'en_US'. LanguageCode string `json:"languageCode,omitempty"` // Name: Required during job update. The resource name for the job. This @@ -2114,9 +2113,8 @@ type JobQuery struct { // against, for example, "en-US". If a value isn't specified, the search // results can contain jobs in any locale. Language codes should be in // BCP-47 format, such as "en-US" or "sr-Latn". For more information, - // see [Tags for Identifying - // Languages](https://tools.ietf.org/html/bcp47). At most 10 language - // code filters are allowed. + // see Tags for Identifying Languages. At most 10 language code filters + // are allowed. LanguageCodes []string `json:"languageCodes,omitempty"` // LocationFilters: The location filter specifies geo-regions containing @@ -2143,8 +2141,8 @@ type JobQuery struct { // This field helps to better interpret the query. If a value isn't // specified, the query language code is automatically detected, which // may not be accurate. Language code should be in BCP-47 format, such - // as "en-US" or "sr-Latn". For more information, see [Tags for - // Identifying Languages](https://tools.ietf.org/html/bcp47). + // as "en-US" or "sr-Latn". For more information, see Tags for + // Identifying Languages. QueryLanguageCode string `json:"queryLanguageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "CommuteFilter") to @@ -3466,11 +3464,10 @@ func (s *SpellingCorrection) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3657,9 +3654,8 @@ func (c *ProjectsTenantsCompleteQueryCall) Company(company string) *ProjectsTena // LanguageCodes sets the optional parameter "languageCodes": The list // of languages of the query. This is the BCP-47 language code, such as -// "en-US" or "sr-Latn". For more information, see [Tags for Identifying -// Languages](https://tools.ietf.org/html/bcp47). The maximum number of -// allowed characters is 255. +// "en-US" or "sr-Latn". For more information, see Tags for Identifying +// Languages. The maximum number of allowed characters is 255. func (c *ProjectsTenantsCompleteQueryCall) LanguageCodes(languageCodes ...string) *ProjectsTenantsCompleteQueryCall { c.urlParams_.SetMulti("languageCodes", append([]string{}, languageCodes...)) return c @@ -4674,11 +4670,8 @@ type ProjectsTenantsClientEventsCreateCall struct { // Create: Report events issued when end user interacts with customer's // application that uses Cloud Talent Solution. You may inspect the -// created events in [self service -// tools](https://console.cloud.google.com/talent-solution/overview). -// [Learn -// more](https://cloud.google.com/talent-solution/docs/management-tools) -// about self service tools. +// created events in self service tools. Learn more about self service +// tools. func (r *ProjectsTenantsClientEventsService) Create(parent string, clientevent *ClientEvent) *ProjectsTenantsClientEventsCreateCall { c := &ProjectsTenantsClientEventsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/language/v1/language-gen.go b/language/v1/language-gen.go index be8e009ba1e..0f67cc12e0f 100644 --- a/language/v1/language-gen.go +++ b/language/v1/language-gen.go @@ -610,8 +610,7 @@ type ClassificationCategory struct { Confidence float64 `json:"confidence,omitempty"` // Name: The name of the category representing the document, from the - // [predefined - // taxonomy](https://cloud.google.com/natural-language/docs/categories). + // predefined taxonomy. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -853,12 +852,10 @@ type Document struct { // Language: The language of the document (if not specified, the // language is automatically detected). Both ISO and BCP-47 language - // codes are accepted. [Language - // Support](https://cloud.google.com/natural-language/docs/languages) - // lists currently supported languages for each API method. If the - // language (either specified by the caller or automatically detected) - // is not supported by the called API method, an `INVALID_ARGUMENT` - // error is returned. + // codes are accepted. Language Support lists currently supported + // languages for each API method. If the language (either specified by + // the caller or automatically detected) is not supported by the called + // API method, an `INVALID_ARGUMENT` error is returned. Language string `json:"language,omitempty"` // Type: Required. If the type is not set or is `TYPE_UNSPECIFIED`, @@ -1346,11 +1343,10 @@ func (s *Sentiment) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1426,8 +1422,7 @@ type Token struct { // DependencyEdge: Dependency tree parse for this token. DependencyEdge *DependencyEdge `json:"dependencyEdge,omitempty"` - // Lemma: [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) - // of the token. + // Lemma: Lemma of the token. Lemma string `json:"lemma,omitempty"` // PartOfSpeech: Parts of speech tag for this token. diff --git a/language/v1beta1/language-gen.go b/language/v1beta1/language-gen.go index 6a2ffb5a866..52824db2a42 100644 --- a/language/v1beta1/language-gen.go +++ b/language/v1beta1/language-gen.go @@ -655,12 +655,10 @@ type Document struct { // Language: The language of the document (if not specified, the // language is automatically detected). Both ISO and BCP-47 language - // codes are accepted. [Language - // Support](https://cloud.google.com/natural-language/docs/languages) - // lists currently supported languages for each API method. If the - // language (either specified by the caller or automatically detected) - // is not supported by the called API method, an `INVALID_ARGUMENT` - // error is returned. + // codes are accepted. Language Support lists currently supported + // languages for each API method. If the language (either specified by + // the caller or automatically detected) is not supported by the called + // API method, an `INVALID_ARGUMENT` error is returned. Language string `json:"language,omitempty"` // Type: Required. If the type is not set or is `TYPE_UNSPECIFIED`, @@ -1114,11 +1112,10 @@ func (s *Sentiment) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1194,8 +1191,7 @@ type Token struct { // DependencyEdge: Dependency tree parse for this token. DependencyEdge *DependencyEdge `json:"dependencyEdge,omitempty"` - // Lemma: [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) - // of the token. + // Lemma: Lemma of the token. Lemma string `json:"lemma,omitempty"` // PartOfSpeech: Parts of speech tag for this token. diff --git a/language/v1beta2/language-gen.go b/language/v1beta2/language-gen.go index 8e2e2f32127..6a757973a08 100644 --- a/language/v1beta2/language-gen.go +++ b/language/v1beta2/language-gen.go @@ -610,8 +610,7 @@ type ClassificationCategory struct { Confidence float64 `json:"confidence,omitempty"` // Name: The name of the category representing the document, from the - // [predefined - // taxonomy](https://cloud.google.com/natural-language/docs/categories). + // predefined taxonomy. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -865,12 +864,10 @@ type Document struct { // Language: The language of the document (if not specified, the // language is automatically detected). Both ISO and BCP-47 language - // codes are accepted. [Language - // Support](https://cloud.google.com/natural-language/docs/languages) - // lists currently supported languages for each API method. If the - // language (either specified by the caller or automatically detected) - // is not supported by the called API method, an `INVALID_ARGUMENT` - // error is returned. + // codes are accepted. Language Support lists currently supported + // languages for each API method. If the language (either specified by + // the caller or automatically detected) is not supported by the called + // API method, an `INVALID_ARGUMENT` error is returned. Language string `json:"language,omitempty"` // ReferenceWebUri: The web URI where the document comes from. This URI @@ -1061,8 +1058,7 @@ func (s *EntityMention) MarshalJSON() ([]byte, error) { type Features struct { // ClassifyText: Classify the full document into categories. If this is // true, the API will use the default model which classifies into a - // [predefined - // taxonomy](https://cloud.google.com/natural-language/docs/categories). + // predefined taxonomy. ClassifyText bool `json:"classifyText,omitempty"` // ExtractDocumentSentiment: Extract document-level sentiment. @@ -1365,11 +1361,10 @@ func (s *Sentiment) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1445,8 +1440,7 @@ type Token struct { // DependencyEdge: Dependency tree parse for this token. DependencyEdge *DependencyEdge `json:"dependencyEdge,omitempty"` - // Lemma: [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) - // of the token. + // Lemma: Lemma of the token. Lemma string `json:"lemma,omitempty"` // PartOfSpeech: Parts of speech tag for this token. diff --git a/lifesciences/v2beta/lifesciences-gen.go b/lifesciences/v2beta/lifesciences-gen.go index 0f7bd12f58a..0b47e6012de 100644 --- a/lifesciences/v2beta/lifesciences-gen.go +++ b/lifesciences/v2beta/lifesciences-gen.go @@ -1461,11 +1461,10 @@ func (s *ServiceAccount) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1588,22 +1587,19 @@ type VirtualMachine struct { EnableStackdriverMonitoring bool `json:"enableStackdriverMonitoring,omitempty"` // Labels: Optional set of labels to apply to the VM and any attached - // disk resources. These labels must adhere to the [name and value - // restrictions](https://cloud.google.com/compute/docs/labeling-resources - // ) on VM labels imposed by Compute Engine. Labels keys with the prefix - // 'google-' are reserved for use by Google. Labels applied at creation - // time to the VM. Applied on a best-effort basis to attached disk - // resources shortly after VM creation. + // disk resources. These labels must adhere to the name and value + // restrictions on VM labels imposed by Compute Engine. Labels keys with + // the prefix 'google-' are reserved for use by Google. Labels applied + // at creation time to the VM. Applied on a best-effort basis to + // attached disk resources shortly after VM creation. Labels map[string]string `json:"labels,omitempty"` // MachineType: Required. The machine type of the virtual machine to // create. Must be the short name of a standard machine type (such as // "n1-standard-1") or a custom machine type (such as "custom-1-4096", // where "1" indicates the number of vCPUs and "4096" indicates the - // memory in MB). See [Creating an instance with a custom machine - // type](https://cloud.google.com/compute/docs/instances/creating-instanc - // e-with-custom-machine-type#create) for more specifications on - // creating a custom machine type. + // memory in MB). See Creating an instance with a custom machine type + // for more specifications on creating a custom machine type. MachineType string `json:"machineType,omitempty"` // Network: The VM network configuration. @@ -2121,8 +2117,8 @@ type ProjectsLocationsOperationsCancelCall struct { // is not guaranteed. Clients may use Operations.GetOperation or // Operations.ListOperations to check whether the cancellation succeeded // or the operation completed despite cancellation. Authorization -// requires the following [Google IAM](https://cloud.google.com/iam) -// permission: * `lifesciences.operations.cancel` +// requires the following Google IAM permission: * +// `lifesciences.operations.cancel` func (r *ProjectsLocationsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *ProjectsLocationsOperationsCancelCall { c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2265,8 +2261,7 @@ type ProjectsLocationsOperationsGetCall struct { // Get: Gets the latest state of a long-running operation. Clients can // use this method to poll the operation result at intervals as // recommended by the API service. Authorization requires the following -// [Google IAM](https://cloud.google.com/iam) permission: * -// `lifesciences.operations.get` +// Google IAM permission: * `lifesciences.operations.get` func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { c := &ProjectsLocationsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2411,9 +2406,8 @@ type ProjectsLocationsOperationsListCall struct { } // List: Lists operations that match the specified filter in the -// request. Authorization requires the following [Google -// IAM](https://cloud.google.com/iam) permission: * -// `lifesciences.operations.list` +// request. Authorization requires the following Google IAM permission: +// * `lifesciences.operations.list` func (r *ProjectsLocationsOperationsService) List(name string) *ProjectsLocationsOperationsListCall { c := &ProjectsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2632,9 +2626,8 @@ type ProjectsLocationsPipelinesRunCall struct { // project. This is done automatically when the Cloud Life Sciences API // is first enabled, but if you delete this permission you must disable // and re-enable the API to grant the Life Sciences Service Agent the -// required permissions. Authorization requires the following [Google -// IAM](https://cloud.google.com/iam/) permission: * -// `lifesciences.workflows.run` +// required permissions. Authorization requires the following Google IAM +// permission: * `lifesciences.workflows.run` func (r *ProjectsLocationsPipelinesService) Run(parent string, runpipelinerequest *RunPipelineRequest) *ProjectsLocationsPipelinesRunCall { c := &ProjectsLocationsPipelinesRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/localservices/v1/localservices-gen.go b/localservices/v1/localservices-gen.go index 133ad93b8a8..c763b71154a 100644 --- a/localservices/v1/localservices-gen.go +++ b/localservices/v1/localservices-gen.go @@ -552,8 +552,8 @@ func (s *GoogleAdsHomeservicesLocalservicesV1SearchDetailedLeadReportsResponse) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleTypeTimeZone: Represents a time zone from the [IANA Time Zone -// Database](https://www.iana.org/time-zones). +// GoogleTypeTimeZone: Represents a time zone from the IANA Time Zone +// Database. type GoogleTypeTimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` diff --git a/managedidentities/v1/managedidentities-gen.go b/managedidentities/v1/managedidentities-gen.go index 73c77ab33be..38cd730d9d6 100644 --- a/managedidentities/v1/managedidentities-gen.go +++ b/managedidentities/v1/managedidentities-gen.go @@ -228,9 +228,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -460,11 +458,10 @@ type Domain struct { Admin string `json:"admin,omitempty"` // AuthorizedNetworks: Optional. The full names of the Google Compute - // Engine [networks](/compute/docs/networks-and-firewalls#networks) the - // domain instance is connected to. Networks can be added using - // UpdateDomain. The domain is only available on networks listed in - // `authorized_networks`. If CIDR subnets overlap between networks, - // domain creation will fail. + // Engine networks the domain instance is connected to. Networks can be + // added using UpdateDomain. The domain is only available on networks + // listed in `authorized_networks`. If CIDR subnets overlap between + // networks, domain creation will fail. AuthorizedNetworks []string `json:"authorizedNetworks,omitempty"` // CreateTime: Output only. The time the instance was created. @@ -1565,9 +1562,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1585,8 +1581,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1621,9 +1617,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1802,11 +1797,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1849,8 +1843,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3232,9 +3225,7 @@ func (r *ProjectsLocationsGlobalDomainsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGlobalDomainsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -3399,9 +3390,7 @@ func (c *ProjectsLocationsGlobalDomainsListCall) Filter(filter string) *Projects } // OrderBy sets the optional parameter "orderBy": Specifies the ordering -// of results. See [Sorting -// order](https://cloud.google.com/apis/design/design_patterns#sorting_or -// der) for more information. +// of results. See Sorting order for more information. func (c *ProjectsLocationsGlobalDomainsListCall) OrderBy(orderBy string) *ProjectsLocationsGlobalDomainsListCall { c.urlParams_.Set("orderBy", orderBy) return c diff --git a/managedidentities/v1alpha1/managedidentities-gen.go b/managedidentities/v1alpha1/managedidentities-gen.go index bc292f5e90a..9f0f1b334bb 100644 --- a/managedidentities/v1alpha1/managedidentities-gen.go +++ b/managedidentities/v1alpha1/managedidentities-gen.go @@ -239,9 +239,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -464,11 +462,11 @@ func (s *DetachTrustRequest) MarshalJSON() ([]byte, error) { // reconciled. At this point, Get will reflect an intermediate state. type Domain struct { // AuthorizedNetworks: Optional. The full names of the Google Compute - // Engine [networks](/compute/docs/networks-and-firewalls#networks) to - // which the instance is connected. Network can be added using - // UpdateDomain later. Domain is only available on network part of - // authorized_networks. Caller needs to make sure that CIDR subnets do - // not overlap between networks, else domain creation will fail. + // Engine networks to which the instance is connected. Network can be + // added using UpdateDomain later. Domain is only available on network + // part of authorized_networks. Caller needs to make sure that CIDR + // subnets do not overlap between networks, else domain creation will + // fail. AuthorizedNetworks []string `json:"authorizedNetworks,omitempty"` // CreateTime: Output only. The time the instance was created. Synthetic @@ -1619,9 +1617,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1639,8 +1636,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1675,9 +1672,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1902,11 +1898,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1949,8 +1944,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3330,9 +3324,7 @@ func (r *ProjectsLocationsGlobalDomainsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGlobalDomainsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/managedidentities/v1beta1/managedidentities-gen.go b/managedidentities/v1beta1/managedidentities-gen.go index 8226a544bd1..dd2110bd7d5 100644 --- a/managedidentities/v1beta1/managedidentities-gen.go +++ b/managedidentities/v1beta1/managedidentities-gen.go @@ -240,9 +240,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -472,11 +470,10 @@ type Domain struct { Admin string `json:"admin,omitempty"` // AuthorizedNetworks: Optional. The full names of the Google Compute - // Engine [networks](/compute/docs/networks-and-firewalls#networks) the - // domain instance is connected to. Networks can be added using - // UpdateDomain. The domain is only available on networks listed in - // `authorized_networks`. If CIDR subnets overlap between networks, - // domain creation will fail. + // Engine networks the domain instance is connected to. Networks can be + // added using UpdateDomain. The domain is only available on networks + // listed in `authorized_networks`. If CIDR subnets overlap between + // networks, domain creation will fail. AuthorizedNetworks []string `json:"authorizedNetworks,omitempty"` // CreateTime: Output only. The time the instance was created. @@ -1617,9 +1614,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1637,8 +1633,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1673,9 +1669,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1909,11 +1904,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1956,8 +1950,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3334,9 +3327,7 @@ func (r *ProjectsLocationsGlobalDomainsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGlobalDomainsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -3501,9 +3492,7 @@ func (c *ProjectsLocationsGlobalDomainsListCall) Filter(filter string) *Projects } // OrderBy sets the optional parameter "orderBy": Specifies the ordering -// of results. See [Sorting -// order](https://cloud.google.com/apis/design/design_patterns#sorting_or -// der) for more information. +// of results. See Sorting order for more information. func (c *ProjectsLocationsGlobalDomainsListCall) OrderBy(orderBy string) *ProjectsLocationsGlobalDomainsListCall { c.urlParams_.Set("orderBy", orderBy) return c diff --git a/memcache/v1beta2/memcache-gen.go b/memcache/v1beta2/memcache-gen.go index d19844dd30b..fbf5258f73e 100644 --- a/memcache/v1beta2/memcache-gen.go +++ b/memcache/v1beta2/memcache-gen.go @@ -863,10 +863,9 @@ func (s *GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata) MarshalJSON } type Instance struct { - // AuthorizedNetwork: The full name of the Google Compute Engine - // [network](https://cloud.google.com/vpc/docs/vpc) to which the - // instance is connected. If left unspecified, the `default` network - // will be used. + // AuthorizedNetwork: The full name of the Google Compute Engine network + // to which the instance is connected. If left unspecified, the + // `default` network will be used. AuthorizedNetwork string `json:"authorizedNetwork,omitempty"` // CreateTime: Output only. The time the instance was created. @@ -1498,11 +1497,10 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/ml/v1/ml-gen.go b/ml/v1/ml-gen.go index e8d54b34c4f..f35a064947a 100644 --- a/ml/v1/ml-gen.go +++ b/ml/v1/ml-gen.go @@ -871,9 +871,8 @@ func (s *GoogleCloudMlV1TrialParameter) UnmarshalJSON(data []byte) error { // GoogleCloudMlV1__AcceleratorConfig: Represents a hardware accelerator // request config. Note that the AcceleratorConfig can be used in both -// Jobs and Versions. Learn more about [accelerators for -// training](/ml-engine/docs/using-gpus) and [accelerators for online -// prediction](/ml-engine/docs/machine-types-online-prediction#gpus). +// Jobs and Versions. Learn more about accelerators for training and +// accelerators for online prediction. type GoogleCloudMlV1__AcceleratorConfig struct { // Count: The number of accelerators to attach to each machine running // the job. @@ -962,28 +961,24 @@ type GoogleCloudMlV1__AutoScaling struct { // deployed. Therefore, the cost of operating this model will be at // least `rate` * `min_nodes` * number of hours since last billing // cycle, where `rate` is the cost per node-hour as documented in the - // [pricing guide](/ml-engine/docs/pricing), even if no predictions are - // performed. There is additional cost for each prediction performed. - // Unlike manual scaling, if the load gets too heavy for the nodes that - // are up, the service will automatically add nodes to handle the - // increased load as well as scale back as traffic drops, always - // maintaining at least `min_nodes`. You will be charged for the time in - // which additional nodes are used. If `min_nodes` is not specified and - // AutoScaling is used with a [legacy (MLS1) machine - // type](/ml-engine/docs/machine-types-online-prediction), `min_nodes` - // defaults to 0, in which case, when traffic to a model stops (and - // after a cool-down period), nodes will be shut down and no charges - // will be incurred until traffic to the model resumes. If `min_nodes` - // is not specified and AutoScaling is used with a [Compute Engine (N1) - // machine type](/ml-engine/docs/machine-types-online-prediction), - // `min_nodes` defaults to 1. `min_nodes` must be at least 1 for use - // with a Compute Engine machine type. Note that you cannot use - // AutoScaling if your version uses - // [GPUs](#Version.FIELDS.accelerator_config). Instead, you must use - // ManualScaling. You can set `min_nodes` when creating the model - // version, and you can also update `min_nodes` for an existing version: - // update_body.json: { 'autoScaling': { 'minNodes': 5 } } HTTP request: - // PATCH + // pricing guide, even if no predictions are performed. There is + // additional cost for each prediction performed. Unlike manual scaling, + // if the load gets too heavy for the nodes that are up, the service + // will automatically add nodes to handle the increased load as well as + // scale back as traffic drops, always maintaining at least `min_nodes`. + // You will be charged for the time in which additional nodes are used. + // If `min_nodes` is not specified and AutoScaling is used with a legacy + // (MLS1) machine type, `min_nodes` defaults to 0, in which case, when + // traffic to a model stops (and after a cool-down period), nodes will + // be shut down and no charges will be incurred until traffic to the + // model resumes. If `min_nodes` is not specified and AutoScaling is + // used with a Compute Engine (N1) machine type, `min_nodes` defaults to + // 1. `min_nodes` must be at least 1 for use with a Compute Engine + // machine type. Note that you cannot use AutoScaling if your version + // uses GPUs. Instead, you must use ManualScaling. You can set + // `min_nodes` when creating the model version, and you can also update + // `min_nodes` for an existing version: update_body.json: { + // 'autoScaling': { 'minNodes': 5 } } HTTP request: PATCH // https://ml.googleapis.com/v1/{name=projects/*/models/*/versions/*}?update_mask=autoScaling.minNodes -d @./update_body.json MinNodes int64 `json:"minNodes,omitempty"` @@ -1289,10 +1284,8 @@ func (s *GoogleCloudMlV1__Config) MarshalJSON() ([]byte, error) { } // GoogleCloudMlV1__ContainerPort: Represents a network port in a single -// container. This message is a subset of the [Kubernetes ContainerPort -// v1 core -// specification](https://kubernetes.io/docs/reference/generated/kubernet -// es-api/v1.18/#containerport-v1-core). +// container. This message is a subset of the Kubernetes ContainerPort +// v1 core specification. type GoogleCloudMlV1__ContainerPort struct { // ContainerPort: Number of the port to expose on the container. This // must be a valid port number: 0 < PORT_NUMBER < 65536. @@ -1322,77 +1315,57 @@ func (s *GoogleCloudMlV1__ContainerPort) MarshalJSON() ([]byte, error) { } // GoogleCloudMlV1__ContainerSpec: Specification of a custom container -// for serving predictions. This message is a subset of the [Kubernetes -// Container v1 core -// specification](https://kubernetes.io/docs/reference/generated/kubernet -// es-api/v1.18/#container-v1-core). +// for serving predictions. This message is a subset of the Kubernetes +// Container v1 core specification. type GoogleCloudMlV1__ContainerSpec struct { // Args: Immutable. Specifies arguments for the command that runs when - // the container starts. This overrides the container's - // [`CMD`](https://docs.docker.com/engine/reference/builder/#cmd). - // Specify this field as an array of executable and arguments, similar - // to a Docker `CMD`'s "default parameters" form. If you don't specify - // this field but do specify the command field, then the command from - // the `command` field runs without any additional arguments. See the - // [Kubernetes documentation about how the `command` and `args` fields - // interact with a container's `ENTRYPOINT` and - // `CMD`](https://kubernetes.io/docs/tasks/inject-data-application/define - // -command-argument-container/#notes). If you don't specify this field - // and don't specify the `commmand` field, then the container's - // [`ENTRYPOINT`](https://docs.docker.com/engine/reference/builder/#cmd) - // and `CMD` determine what runs based on their default behavior. See - // the [Docker documentation about how `CMD` and `ENTRYPOINT` - // interact](https://docs.docker.com/engine/reference/builder/#understand - // -how-cmd-and-entrypoint-interact). In this field, you can reference - // [environment variables set by AI Platform - // Prediction](/ai-platform/prediction/docs/custom-container-requirements - // #aip-variables) and environment variables set in the env field. You - // cannot reference environment variables set in the Docker image. In - // order for environment variables to be expanded, reference them by - // using the following syntax: $( VARIABLE_NAME) Note that this differs - // from Bash variable expansion, which does not use parentheses. If a - // variable cannot be resolved, the reference in the input string is - // used unchanged. To avoid variable expansion, you can escape this - // syntax with `$$`; for example: $$(VARIABLE_NAME) This field - // corresponds to the `args` field of the [Kubernetes Containers v1 core - // API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1. - // 18/#container-v1-core). + // the container starts. This overrides the container's `CMD`. Specify + // this field as an array of executable and arguments, similar to a + // Docker `CMD`'s "default parameters" form. If you don't specify this + // field but do specify the command field, then the command from the + // `command` field runs without any additional arguments. See the + // Kubernetes documentation about how the `command` and `args` fields + // interact with a container's `ENTRYPOINT` and `CMD`. If you don't + // specify this field and don't specify the `commmand` field, then the + // container's `ENTRYPOINT` and `CMD` determine what runs based on their + // default behavior. See the Docker documentation about how `CMD` and + // `ENTRYPOINT` interact. In this field, you can reference environment + // variables set by AI Platform Prediction and environment variables set + // in the env field. You cannot reference environment variables set in + // the Docker image. In order for environment variables to be expanded, + // reference them by using the following syntax: $( VARIABLE_NAME) Note + // that this differs from Bash variable expansion, which does not use + // parentheses. If a variable cannot be resolved, the reference in the + // input string is used unchanged. To avoid variable expansion, you can + // escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This + // field corresponds to the `args` field of the Kubernetes Containers v1 + // core API. Args []string `json:"args,omitempty"` // Command: Immutable. Specifies the command that runs when the - // container starts. This overrides the container's - // [`ENTRYPOINT`](https://docs.docker.com/engine/reference/builder/#entry - // point). Specify this field as an array of executable and arguments, - // similar to a Docker `ENTRYPOINT`'s "exec" form, not its "shell" form. - // If you do not specify this field, then the container's `ENTRYPOINT` - // runs, in conjunction with the args field or the container's - // [`CMD`](https://docs.docker.com/engine/reference/builder/#cmd), if - // either exists. If this field is not specified and the container does - // not have an `ENTRYPOINT`, then refer to the [Docker documentation - // about how `CMD` and `ENTRYPOINT` - // interact](https://docs.docker.com/engine/reference/builder/#understand - // -how-cmd-and-entrypoint-interact). If you specify this field, then + // container starts. This overrides the container's `ENTRYPOINT`. + // Specify this field as an array of executable and arguments, similar + // to a Docker `ENTRYPOINT`'s "exec" form, not its "shell" form. If you + // do not specify this field, then the container's `ENTRYPOINT` runs, in + // conjunction with the args field or the container's `CMD`, if either + // exists. If this field is not specified and the container does not + // have an `ENTRYPOINT`, then refer to the Docker documentation about + // how `CMD` and `ENTRYPOINT` interact. If you specify this field, then // you can also specify the `args` field to provide additional arguments // for this command. However, if you specify this field, then the - // container's `CMD` is ignored. See the [Kubernetes documentation about + // container's `CMD` is ignored. See the Kubernetes documentation about // how the `command` and `args` fields interact with a container's - // `ENTRYPOINT` and - // `CMD`](https://kubernetes.io/docs/tasks/inject-data-application/define - // -command-argument-container/#notes). In this field, you can reference - // [environment variables set by AI Platform - // Prediction](/ai-platform/prediction/docs/custom-container-requirements - // #aip-variables) and environment variables set in the env field. You - // cannot reference environment variables set in the Docker image. In - // order for environment variables to be expanded, reference them by - // using the following syntax: $( VARIABLE_NAME) Note that this differs - // from Bash variable expansion, which does not use parentheses. If a - // variable cannot be resolved, the reference in the input string is - // used unchanged. To avoid variable expansion, you can escape this - // syntax with `$$`; for example: $$(VARIABLE_NAME) This field - // corresponds to the `command` field of the [Kubernetes Containers v1 - // core - // API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1. - // 18/#container-v1-core). + // `ENTRYPOINT` and `CMD`. In this field, you can reference environment + // variables set by AI Platform Prediction and environment variables set + // in the env field. You cannot reference environment variables set in + // the Docker image. In order for environment variables to be expanded, + // reference them by using the following syntax: $( VARIABLE_NAME) Note + // that this differs from Bash variable expansion, which does not use + // parentheses. If a variable cannot be resolved, the reference in the + // input string is used unchanged. To avoid variable expansion, you can + // escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This + // field corresponds to the `command` field of the Kubernetes Containers + // v1 core API. Command []string `json:"command,omitempty"` // Env: Immutable. List of environment variables to set in the @@ -1404,53 +1377,41 @@ type GoogleCloudMlV1__ContainerSpec struct { // bar`: ```json [ { "name": "VAR_1", "value": "foo" }, { "name": // "VAR_2", "value": "$(VAR_1) bar" } ] ``` If you switch the order of // the variables in the example, then the expansion does not occur. This - // field corresponds to the `env` field of the [Kubernetes Containers v1 - // core - // API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1. - // 18/#container-v1-core). + // field corresponds to the `env` field of the Kubernetes Containers v1 + // core API. Env []*GoogleCloudMlV1__EnvVar `json:"env,omitempty"` // Image: URI of the Docker image to be used as the custom container for - // serving predictions. This URI must identify [an image in Artifact - // Registry](/artifact-registry/docs/overview) and begin with the - // hostname `{REGION}-docker.pkg.dev`, where `{REGION}` is replaced by - // the region that matches AI Platform Prediction [regional - // endpoint](/ai-platform/prediction/docs/regional-endpoints) that you - // are using. For example, if you are using the - // `us-central1-ml.googleapis.com` endpoint, then this URI must begin - // with `us-central1-docker.pkg.dev`. To use a custom container, the [AI - // Platform Google-managed service - // account](/ai-platform/prediction/docs/custom-service-account#default) - // must have permission to pull (read) the Docker image at this URI. The - // AI Platform Google-managed service account has the following format: + // serving predictions. This URI must identify an image in Artifact + // Registry and begin with the hostname `{REGION}-docker.pkg.dev`, where + // `{REGION}` is replaced by the region that matches AI Platform + // Prediction regional endpoint that you are using. For example, if you + // are using the `us-central1-ml.googleapis.com` endpoint, then this URI + // must begin with `us-central1-docker.pkg.dev`. To use a custom + // container, the AI Platform Google-managed service account must have + // permission to pull (read) the Docker image at this URI. The AI + // Platform Google-managed service account has the following format: // `service-{PROJECT_NUMBER}@cloud-ml.google.com.iam.gserviceaccount.com` // {PROJECT_NUMBER} is replaced by your Google Cloud project number. By // default, this service account has necessary permissions to pull an // Artifact Registry image in the same Google Cloud project where you // are using AI Platform Prediction. In this case, no configuration is // necessary. If you want to use an image from a different Google Cloud - // project, learn how to [grant the Artifact Registry Reader - // (roles/artifactregistry.reader) role for a - // repository](/artifact-registry/docs/access-control#grant-repo) to - // your projet's AI Platform Google-managed service account. To learn - // about the requirements for the Docker image itself, read [Custom - // container - // requirements](/ai-platform/prediction/docs/custom-container-requiremen - // ts). + // project, learn how to grant the Artifact Registry Reader + // (roles/artifactregistry.reader) role for a repository to your + // projet's AI Platform Google-managed service account. To learn about + // the requirements for the Docker image itself, read Custom container + // requirements. Image string `json:"image,omitempty"` // Ports: Immutable. List of ports to expose from the container. AI // Platform Prediction sends any prediction requests that it receives to // the first port on this list. AI Platform Prediction also sends - // [liveness and health - // checks](/ai-platform/prediction/docs/custom-container-requirements#hea - // lth) to this port. If you do not specify this field, it defaults to - // following value: ```json [ { "containerPort": 8080 } ] ``` AI - // Platform Prediction does not use ports other than the first one - // listed. This field corresponds to the `ports` field of the - // [Kubernetes Containers v1 core - // API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1. - // 18/#container-v1-core). + // liveness and health checks to this port. If you do not specify this + // field, it defaults to following value: ```json [ { "containerPort": + // 8080 } ] ``` AI Platform Prediction does not use ports other than the + // first one listed. This field corresponds to the `ports` field of the + // Kubernetes Containers v1 core API. Ports []*GoogleCloudMlV1__ContainerPort `json:"ports,omitempty"` // ForceSendFields is a list of field names (e.g. "Args") to @@ -1545,29 +1506,23 @@ func (s *GoogleCloudMlV1__EncryptionConfig) MarshalJSON() ([]byte, error) { // GoogleCloudMlV1__EnvVar: Represents an environment variable to be // made available in a container. This message is a subset of the -// [Kubernetes EnvVar v1 core -// specification](https://kubernetes.io/docs/reference/generated/kubernet -// es-api/v1.18/#envvar-v1-core). +// Kubernetes EnvVar v1 core specification. type GoogleCloudMlV1__EnvVar struct { - // Name: Name of the environment variable. Must be a [valid C - // identifier](https://github.com/kubernetes/kubernetes/blob/v1.18.8/stag - // ing/src/k8s.io/apimachinery/pkg/util/validation/validation.go#L258) + // Name: Name of the environment variable. Must be a valid C identifier // and must not begin with the prefix `AIP_`. Name string `json:"name,omitempty"` // Value: Value of the environment variable. Defaults to an empty - // string. In this field, you can reference [environment variables set - // by AI Platform - // Prediction](/ai-platform/prediction/docs/custom-container-requirements - // #aip-variables) and environment variables set earlier in the same env - // field as where this message occurs. You cannot reference environment - // variables set in the Docker image. In order for environment variables - // to be expanded, reference them by using the following syntax: - // $(VARIABLE_NAME) Note that this differs from Bash variable expansion, - // which does not use parentheses. If a variable cannot be resolved, the - // reference in the input string is used unchanged. To avoid variable - // expansion, you can escape this syntax with `$$`; for example: - // $$(VARIABLE_NAME) + // string. In this field, you can reference environment variables set by + // AI Platform Prediction and environment variables set earlier in the + // same env field as where this message occurs. You cannot reference + // environment variables set in the Docker image. In order for + // environment variables to be expanded, reference them by using the + // following syntax: $(VARIABLE_NAME) Note that this differs from Bash + // variable expansion, which does not use parentheses. If a variable + // cannot be resolved, the reference in the input string is used + // unchanged. To avoid variable expansion, you can escape this syntax + // with `$$`; for example: $$(VARIABLE_NAME) Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -1625,8 +1580,8 @@ func (s *GoogleCloudMlV1__ExplainRequest) MarshalJSON() ([]byte, error) { // GoogleCloudMlV1__ExplanationConfig: Message holding configuration // options for explaining model predictions. There are three feature // attribution methods supported for TensorFlow models: integrated -// gradients, sampled Shapley, and XRAI. [Learn more about feature -// attributions.](/ai-platform/prediction/docs/ai-explanations/overview) +// gradients, sampled Shapley, and XRAI. Learn more about feature +// attributions. type GoogleCloudMlV1__ExplanationConfig struct { // IntegratedGradientsAttribution: Attributes credit by computing the // Aumann-Shapley value taking advantage of the model's fully @@ -2429,19 +2384,19 @@ type GoogleCloudMlV1__Model struct { // nodes send `stderr` and `stdout` streams to Cloud Logging. These can // be more verbose than the standard access logs (see // `onlinePredictionLogging`) and can incur higher cost. However, they - // are helpful for debugging. Note that [logs may incur a - // cost](/stackdriver/pricing), especially if your project receives - // prediction requests at a high QPS. Estimate your costs before - // enabling this option. Default is false. + // are helpful for debugging. Note that logs may incur a cost, + // especially if your project receives prediction requests at a high + // QPS. Estimate your costs before enabling this option. Default is + // false. OnlinePredictionConsoleLogging bool `json:"onlinePredictionConsoleLogging,omitempty"` // OnlinePredictionLogging: Optional. If true, online prediction access // logs are sent to Cloud Logging. These logs are like standard server // access logs, containing information like timestamp and latency for - // each request. Note that [logs may incur a - // cost](/stackdriver/pricing), especially if your project receives - // prediction requests at a high queries per second rate (QPS). Estimate - // your costs before enabling this option. Default is false. + // each request. Note that logs may incur a cost, especially if your + // project receives prediction requests at a high queries per second + // rate (QPS). Estimate your costs before enabling this option. Default + // is false. OnlinePredictionLogging bool `json:"onlinePredictionLogging,omitempty"` // Regions: Optional. The list of regions where the model is going to be @@ -2650,8 +2605,8 @@ func (s *GoogleCloudMlV1__ParameterSpec) UnmarshalJSON(data []byte) error { // against a trained model. type GoogleCloudMlV1__PredictRequest struct { // HttpBody: Required. The prediction request body. Refer to the - // [request body details section](#request-body-details) for more - // information on how to structure your request. + // request body details section for more information on how to structure + // your request. HttpBody *GoogleApi__HttpBody `json:"httpBody,omitempty"` // ForceSendFields is a list of field names (e.g. "HttpBody") to @@ -2747,12 +2702,9 @@ type GoogleCloudMlV1__PredictionInput struct { RuntimeVersion string `json:"runtimeVersion,omitempty"` // SignatureName: Optional. The name of the signature defined in the - // SavedModel to use for this job. Please refer to - // [SavedModel](https://tensorflow.github.io/serving/serving_basic.html) - // for information about how to use signatures. Defaults to - // [DEFAULT_SERVING_SIGNATURE_DEF_KEY](https://www.tensorflow.org/api_doc - // s/python/tf/saved_model/signature_constants) , which is - // "serving_default". + // SavedModel to use for this job. Please refer to SavedModel for + // information about how to use signatures. Defaults to + // DEFAULT_SERVING_SIGNATURE_DEF_KEY , which is "serving_default". SignatureName string `json:"signatureName,omitempty"` // Uri: Use this field if you want to specify a Google Cloud Storage @@ -2845,10 +2797,8 @@ func (s *GoogleCloudMlV1__PredictionOutput) UnmarshalJSON(data []byte) error { // replica in a cluster. type GoogleCloudMlV1__ReplicaConfig struct { // AcceleratorConfig: Represents the type and number of accelerators - // used by the replica. [Learn about restrictions on accelerator - // configurations for - // training.](/ai-platform/training/docs/using-gpus#compute-engine-machin - // e-types-with-gpu) + // used by the replica. Learn about restrictions on accelerator + // configurations for training. AcceleratorConfig *GoogleCloudMlV1__AcceleratorConfig `json:"acceleratorConfig,omitempty"` // ContainerArgs: Arguments to the entrypoint command. The following @@ -2878,24 +2828,20 @@ type GoogleCloudMlV1__ReplicaConfig struct { DiskConfig *GoogleCloudMlV1__DiskConfig `json:"diskConfig,omitempty"` // ImageUri: The Docker image to run on the replica. This image must be - // in Container Registry. Learn more about [configuring custom - // containers](/ai-platform/training/docs/distributed-training-containers - // ). + // in Container Registry. Learn more about configuring custom + // containers. ImageUri string `json:"imageUri,omitempty"` // TpuTfVersion: The AI Platform runtime version that includes a // TensorFlow version matching the one used in the custom container. // This field is required if the replica is a TPU worker that uses a // custom container. Otherwise, do not specify this field. This must be - // a [runtime version that currently supports training with - // TPUs](/ml-engine/docs/tensorflow/runtime-version-list#tpu-support). - // Note that the version of TensorFlow included in a runtime version may + // a runtime version that currently supports training with TPUs. Note + // that the version of TensorFlow included in a runtime version may // differ from the numbering of the runtime version itself, because it - // may have a different [patch - // version](https://www.tensorflow.org/guide/version_compat#semantic_vers - // ioning_20). In this field, you must specify the runtime version - // (TensorFlow minor version). For example, if your custom container - // runs TensorFlow `1.x.y`, specify `1.x`. + // may have a different patch version. In this field, you must specify + // the runtime version (TensorFlow minor version). For example, if your + // custom container runs TensorFlow `1.x.y`, specify `1.x`. TpuTfVersion string `json:"tpuTfVersion,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorConfig") @@ -2926,22 +2872,20 @@ func (s *GoogleCloudMlV1__ReplicaConfig) MarshalJSON() ([]byte, error) { // request-response pairs to a BigQuery table. Online prediction // requests to a model version and the responses to these requests are // converted to raw strings and saved to the specified BigQuery table. -// Logging is constrained by [BigQuery quotas and -// limits](/bigquery/quotas). If your project exceeds BigQuery quotas or -// limits, AI Platform Prediction does not log request-response pairs, -// but it continues to serve predictions. If you are using [continuous -// evaluation](/ml-engine/docs/continuous-evaluation/), you do not need -// to specify this configuration manually. Setting up continuous -// evaluation automatically enables logging of request-response pairs. +// Logging is constrained by BigQuery quotas and limits. If your project +// exceeds BigQuery quotas or limits, AI Platform Prediction does not +// log request-response pairs, but it continues to serve predictions. If +// you are using continuous evaluation, you do not need to specify this +// configuration manually. Setting up continuous evaluation +// automatically enables logging of request-response pairs. type GoogleCloudMlV1__RequestLoggingConfig struct { // BigqueryTableName: Required. Fully qualified BigQuery table name in // the following format: " project_id.dataset_name.table_name" The // specified table must already exist, and the "Cloud ML Service Agent" // for your project must have permission to write to it. The table must - // have the following [schema](/bigquery/docs/schemas): Field nameType - // Mode model STRING REQUIRED model_version STRING REQUIRED time - // TIMESTAMP REQUIRED raw_data STRING REQUIRED raw_prediction STRING - // NULLABLE groundtruth STRING NULLABLE + // have the following schema: Field nameType Mode model STRING REQUIRED + // model_version STRING REQUIRED time TIMESTAMP REQUIRED raw_data STRING + // REQUIRED raw_prediction STRING NULLABLE groundtruth STRING NULLABLE BigqueryTableName string `json:"bigqueryTableName,omitempty"` // SamplingPercentage: Percentage of requests to be logged, expressed as @@ -2991,29 +2935,26 @@ func (s *GoogleCloudMlV1__RequestLoggingConfig) UnmarshalJSON(data []byte) error // GoogleCloudMlV1__RouteMap: Specifies HTTP paths served by a custom // container. AI Platform Prediction sends requests to these paths on // the container; the custom container must run an HTTP server that -// responds to these requests with appropriate responses. Read [Custom -// container -// requirements](/ai-platform/prediction/docs/custom-container-requiremen -// ts) for details on how to create your container image to meet these -// requirements. +// responds to these requests with appropriate responses. Read Custom +// container requirements for details on how to create your container +// image to meet these requirements. type GoogleCloudMlV1__RouteMap struct { // Health: HTTP path on the container to send health checkss to. AI // Platform Prediction intermittently sends GET requests to this path on // the container's IP address and port to check that the container is - // healthy. Read more about [health - // checks](/ai-platform/prediction/docs/custom-container-requirements#che - // cks). For example, if you set this field to `/bar`, then AI Platform - // Prediction intermittently sends a GET request to the `/bar` path on - // the port of your container specified by the first value of - // Version.container.ports. If you don't specify this field, it defaults - // to the following value: /v1/models/ MODEL/versions/VERSION The - // placeholders in this value are replaced as follows: * MODEL: The name - // of the parent Model. This does not include the - // "projects/PROJECT_ID/models/" prefix that the API returns in output; - // it is the bare model name, as provided to projects.models.create. * - // VERSION: The name of the model version. This does not include the - // "projects/PROJECT_ID /models/MODEL/versions/" prefix that the API - // returns in output; it is the bare version name, as provided to + // healthy. Read more about health checks. For example, if you set this + // field to `/bar`, then AI Platform Prediction intermittently sends a + // GET request to the `/bar` path on the port of your container + // specified by the first value of Version.container.ports. If you don't + // specify this field, it defaults to the following value: /v1/models/ + // MODEL/versions/VERSION The placeholders in this value are replaced as + // follows: * MODEL: The name of the parent Model. This does not include + // the "projects/PROJECT_ID/models/" prefix that the API returns in + // output; it is the bare model name, as provided to + // projects.models.create. * VERSION: The name of the model version. + // This does not include the "projects/PROJECT_ID + // /models/MODEL/versions/" prefix that the API returns in output; it is + // the bare version name, as provided to // projects.models.versions.create. Health string `json:"health,omitempty"` @@ -3105,10 +3046,8 @@ type GoogleCloudMlV1__Scheduling struct { // example, if you want to ensure your job runs for no more than 2 // hours, set this field to `7200s` (2 hours * 60 minutes / hour * 60 // seconds / minute). If you submit your training job using the `gcloud` - // tool, you can [specify this field in a `config.yaml` - // file](/ai-platform/training/docs/training-jobs#formatting_your_configu - // ration_parameters). For example: ```yaml trainingInput: scheduling: - // maxRunningTime: 7200s ``` + // tool, you can specify this field in a `config.yaml` file. For + // example: ```yaml trainingInput: scheduling: maxRunningTime: 7200s ``` MaxRunningTime string `json:"maxRunningTime,omitempty"` // MaxWaitTime: Optional. The maximum job wait time, expressed in @@ -3120,21 +3059,18 @@ type GoogleCloudMlV1__Scheduling struct { // no longer be cancelled due to the maximum wait time. Therefore the // duration limited by this field does not overlap with the duration // limited by Scheduling.max_running_time. For example, if the job - // temporarily stops running and retries due to a [VM - // restart](/ai-platform/training/docs/overview#restarts), this cannot - // lead to a maximum wait time cancellation. However, independently of - // this constraint, AI Platform Training might stop a job if there are - // too many retries due to exhausted resources in a region. The - // following example describes how you might use this field: To cancel - // your job if it doesn't start running within 1 hour, set this field to - // `3600s` (1 hour * 60 minutes / hour * 60 seconds / minute). If the - // job is still in the `QUEUED` or `PREPARING` state after an hour of - // waiting, AI Platform Training cancels the job. If you submit your - // training job using the `gcloud` tool, you can [specify this field in - // a `config.yaml` - // file](/ai-platform/training/docs/training-jobs#formatting_your_configu - // ration_parameters). For example: ```yaml trainingInput: scheduling: - // maxWaitTime: 3600s ``` + // temporarily stops running and retries due to a VM restart, this + // cannot lead to a maximum wait time cancellation. However, + // independently of this constraint, AI Platform Training might stop a + // job if there are too many retries due to exhausted resources in a + // region. The following example describes how you might use this field: + // To cancel your job if it doesn't start running within 1 hour, set + // this field to `3600s` (1 hour * 60 minutes / hour * 60 seconds / + // minute). If the job is still in the `QUEUED` or `PREPARING` state + // after an hour of waiting, AI Platform Training cancels the job. If + // you submit your training job using the `gcloud` tool, you can specify + // this field in a `config.yaml` file. For example: ```yaml + // trainingInput: scheduling: maxWaitTime: 3600s ``` MaxWaitTime string `json:"maxWaitTime,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxRunningTime") to @@ -3393,8 +3329,8 @@ func (s *GoogleCloudMlV1__SuggestTrialsResponse) MarshalJSON() ([]byte, error) { // training job. When using the gcloud command to submit your training // job, you can specify the input parameters as command-line arguments // and/or in a YAML configuration file referenced from the --config -// command-line argument. For details, see the guide to [submitting a -// training job](/ai-platform/training/docs/training-jobs). +// command-line argument. For details, see the guide to submitting a +// training job. type GoogleCloudMlV1__TrainingInput struct { // Args: Optional. Command-line arguments passed to the training // application when it starts. If your job uses a custom container, then @@ -3405,22 +3341,18 @@ type GoogleCloudMlV1__TrainingInput struct { // encryption keys (CMEK) to protect resources created by a training // job, instead of using Google's default encryption. If this is set, // then all resources created by the training job will be encrypted with - // the customer-managed encryption key that you specify. [Learn how and - // when to use CMEK with AI Platform - // Training](/ai-platform/training/docs/cmek). + // the customer-managed encryption key that you specify. Learn how and + // when to use CMEK with AI Platform Training. EncryptionConfig *GoogleCloudMlV1__EncryptionConfig `json:"encryptionConfig,omitempty"` // EvaluatorConfig: Optional. The configuration for evaluators. You // should only set `evaluatorConfig.acceleratorConfig` if - // `evaluatorType` is set to a Compute Engine machine type. [Learn about - // restrictions on accelerator configurations for - // training.](/ai-platform/training/docs/using-gpus#compute-engine-machin - // e-types-with-gpu) Set `evaluatorConfig.imageUri` only if you build a - // custom image for your evaluator. If `evaluatorConfig.imageUri` has - // not been set, AI Platform uses the value of `masterConfig.imageUri`. - // Learn more about [configuring custom - // containers](/ai-platform/training/docs/distributed-training-containers - // ). + // `evaluatorType` is set to a Compute Engine machine type. Learn about + // restrictions on accelerator configurations for training. Set + // `evaluatorConfig.imageUri` only if you build a custom image for your + // evaluator. If `evaluatorConfig.imageUri` has not been set, AI + // Platform uses the value of `masterConfig.imageUri`. Learn more about + // configuring custom containers. EvaluatorConfig *GoogleCloudMlV1__ReplicaConfig `json:"evaluatorConfig,omitempty"` // EvaluatorCount: Optional. The number of evaluator replicas to use for @@ -3452,14 +3384,11 @@ type GoogleCloudMlV1__TrainingInput struct { // MasterConfig: Optional. The configuration for your master worker. You // should only set `masterConfig.acceleratorConfig` if `masterType` is - // set to a Compute Engine machine type. Learn about [restrictions on - // accelerator configurations for - // training.](/ai-platform/training/docs/using-gpus#compute-engine-machin - // e-types-with-gpu) Set `masterConfig.imageUri` only if you build a - // custom image. Only one of `masterConfig.imageUri` and - // `runtimeVersion` should be set. Learn more about [configuring custom - // containers](/ai-platform/training/docs/distributed-training-containers - // ). + // set to a Compute Engine machine type. Learn about restrictions on + // accelerator configurations for training. Set `masterConfig.imageUri` + // only if you build a custom image. Only one of `masterConfig.imageUri` + // and `runtimeVersion` should be set. Learn more about configuring + // custom containers. MasterConfig *GoogleCloudMlV1__ReplicaConfig `json:"masterConfig,omitempty"` // MasterType: Optional. Specifies the type of virtual machine to use @@ -3471,30 +3400,25 @@ type GoogleCloudMlV1__TrainingInput struct { // `n1-highmem-2` - `n1-highmem-4` - `n1-highmem-8` - `n1-highmem-16` - // `n1-highmem-32` - `n1-highmem-64` - `n1-highmem-96` - `n1-highcpu-16` // - `n1-highcpu-32` - `n1-highcpu-64` - `n1-highcpu-96` Learn more - // about [using Compute Engine machine - // types](/ml-engine/docs/machine-types#compute-engine-machine-types). - // Alternatively, you can use the following legacy machine types: - - // `standard` - `large_model` - `complex_model_s` - `complex_model_m` - - // `complex_model_l` - `standard_gpu` - `complex_model_m_gpu` - - // `complex_model_l_gpu` - `standard_p100` - `complex_model_m_p100` - - // `standard_v100` - `large_model_v100` - `complex_model_m_v100` - - // `complex_model_l_v100` Learn more about [using legacy machine - // types](/ml-engine/docs/machine-types#legacy-machine-types). Finally, - // if you want to use a TPU for training, specify `cloud_tpu` in this - // field. Learn more about the [special configuration options for - // training with - // TPUs](/ml-engine/docs/tensorflow/using-tpus#configuring_a_custom_tpu_m - // achine). + // about using Compute Engine machine types. Alternatively, you can use + // the following legacy machine types: - `standard` - `large_model` - + // `complex_model_s` - `complex_model_m` - `complex_model_l` - + // `standard_gpu` - `complex_model_m_gpu` - `complex_model_l_gpu` - + // `standard_p100` - `complex_model_m_p100` - `standard_v100` - + // `large_model_v100` - `complex_model_m_v100` - `complex_model_l_v100` + // Learn more about using legacy machine types. Finally, if you want to + // use a TPU for training, specify `cloud_tpu` in this field. Learn more + // about the special configuration options for training with TPUs. MasterType string `json:"masterType,omitempty"` - // Network: Optional. The full name of the [Compute Engine - // network](/vpc/docs/vpc) to which the Job is peered. For example, + // Network: Optional. The full name of the Compute Engine network to + // which the Job is peered. For example, // `projects/12345/global/networks/myVPC`. The format of this field is // `projects/{project}/global/networks/{network}`, where {project} is a // project number (like `12345`) and {network} is network name. Private // services access must already be configured for the network. If left - // unspecified, the Job is not peered with any network. [Learn about - // using VPC Network Peering.](/ai-platform/training/docs/vpc-peering). + // unspecified, the Job is not peered with any network. Learn about + // using VPC Network Peering.. Network string `json:"network,omitempty"` // PackageUris: Required. The Google Cloud Storage location of the @@ -3505,16 +3429,12 @@ type GoogleCloudMlV1__TrainingInput struct { // ParameterServerConfig: Optional. The configuration for parameter // servers. You should only set // `parameterServerConfig.acceleratorConfig` if `parameterServerType` is - // set to a Compute Engine machine type. [Learn about restrictions on - // accelerator configurations for - // training.](/ai-platform/training/docs/using-gpus#compute-engine-machin - // e-types-with-gpu) Set `parameterServerConfig.imageUri` only if you - // build a custom image for your parameter server. If - // `parameterServerConfig.imageUri` has not been set, AI Platform uses - // the value of `masterConfig.imageUri`. Learn more about [configuring - // custom - // containers](/ai-platform/training/docs/distributed-training-containers - // ). + // set to a Compute Engine machine type. Learn about restrictions on + // accelerator configurations for training. Set + // `parameterServerConfig.imageUri` only if you build a custom image for + // your parameter server. If `parameterServerConfig.imageUri` has not + // been set, AI Platform uses the value of `masterConfig.imageUri`. + // Learn more about configuring custom containers. ParameterServerConfig *GoogleCloudMlV1__ReplicaConfig `json:"parameterServerConfig,omitempty"` // ParameterServerCount: Optional. The number of parameter server @@ -3546,21 +3466,17 @@ type GoogleCloudMlV1__TrainingInput struct { // '3.5' is available when `runtime_version` is set to a version from // '1.4' to '1.14'. * Python '2.7' is available when `runtime_version` // is set to '1.15' or earlier. Read more about the Python versions - // available for [each runtime - // version](/ml-engine/docs/runtime-version-list). + // available for each runtime version. PythonVersion string `json:"pythonVersion,omitempty"` // Region: Required. The region to run the training job in. See the - // [available regions](/ai-platform/training/docs/regions) for AI - // Platform Training. + // available regions for AI Platform Training. Region string `json:"region,omitempty"` // RuntimeVersion: Optional. The AI Platform runtime version to use for // training. You must either specify this field or specify - // `masterConfig.imageUri`. For more information, see the [runtime - // version list](/ai-platform/training/docs/runtime-version-list) and - // learn [how to manage runtime - // versions](/ai-platform/training/docs/versioning). + // `masterConfig.imageUri`. For more information, see the runtime + // version list and learn how to manage runtime versions. RuntimeVersion string `json:"runtimeVersion,omitempty"` // ScaleTier: Required. Specifies the machine types, the number of @@ -3604,31 +3520,25 @@ type GoogleCloudMlV1__TrainingInput struct { // `iam.serviceAccounts.actAs` permission for the specified service // account. In addition, the AI Platform Training Google-managed service // account must have the `roles/iam.serviceAccountAdmin` role for the - // specified service account. [Learn more about configuring a service - // account.](/ai-platform/training/docs/custom-service-account) If not - // specified, the AI Platform Training Google-managed service account is - // used by default. + // specified service account. Learn more about configuring a service + // account. If not specified, the AI Platform Training Google-managed + // service account is used by default. ServiceAccount string `json:"serviceAccount,omitempty"` // UseChiefInTfConfig: Optional. Use `chief` instead of `master` in the // `TF_CONFIG` environment variable when training with a custom - // container. Defaults to `false`. [Learn more about this - // field.](/ai-platform/training/docs/distributed-training-details#chief- - // versus-master) This field has no effect for training jobs that don't - // use a custom container. + // container. Defaults to `false`. Learn more about this field. This + // field has no effect for training jobs that don't use a custom + // container. UseChiefInTfConfig bool `json:"useChiefInTfConfig,omitempty"` // WorkerConfig: Optional. The configuration for workers. You should // only set `workerConfig.acceleratorConfig` if `workerType` is set to a - // Compute Engine machine type. [Learn about restrictions on accelerator - // configurations for - // training.](/ai-platform/training/docs/using-gpus#compute-engine-machin - // e-types-with-gpu) Set `workerConfig.imageUri` only if you build a - // custom image for your worker. If `workerConfig.imageUri` has not been - // set, AI Platform uses the value of `masterConfig.imageUri`. Learn - // more about [configuring custom - // containers](/ai-platform/training/docs/distributed-training-containers - // ). + // Compute Engine machine type. Learn about restrictions on accelerator + // configurations for training. Set `workerConfig.imageUri` only if you + // build a custom image for your worker. If `workerConfig.imageUri` has + // not been set, AI Platform uses the value of `masterConfig.imageUri`. + // Learn more about configuring custom containers. WorkerConfig *GoogleCloudMlV1__ReplicaConfig `json:"workerConfig,omitempty"` // WorkerCount: Optional. The number of worker replicas to use for the @@ -3644,11 +3554,9 @@ type GoogleCloudMlV1__TrainingInput struct { // must be consistent with the category of machine type that // `masterType` uses. In other words, both must be Compute Engine // machine types or both must be legacy machine types. If you use - // `cloud_tpu` for this value, see special instructions for [configuring - // a custom TPU - // machine](/ml-engine/docs/tensorflow/using-tpus#configuring_a_custom_tp - // u_machine). This value must be present when `scaleTier` is set to - // `CUSTOM` and `workerCount` is greater than zero. + // `cloud_tpu` for this value, see special instructions for configuring + // a custom TPU machine. This value must be present when `scaleTier` is + // set to `CUSTOM` and `workerCount` is greater than zero. WorkerType string `json:"workerType,omitempty"` // ForceSendFields is a list of field names (e.g. "Args") to @@ -3690,9 +3598,8 @@ type GoogleCloudMlV1__TrainingOutput struct { // HyperparameterMetricTag: The TensorFlow summary tag name used for // optimizing hyperparameter tuning trials. See - // [`HyperparameterSpec.hyperparameterMetricTag`](#HyperparameterSpec.FIE - // LDS.hyperparameter_metric_tag) for more information. Only set for - // hyperparameter tuning jobs. + // `HyperparameterSpec.hyperparameterMetricTag` for more information. + // Only set for hyperparameter tuning jobs. HyperparameterMetricTag string `json:"hyperparameterMetricTag,omitempty"` // IsBuiltInAlgorithmJob: Whether this job is a built-in Algorithm job. @@ -3831,8 +3738,7 @@ type GoogleCloudMlV1__Version struct { // AcceleratorConfig: Optional. Accelerator config for using GPUs for // online prediction (beta). Only specify this field if you have // specified a Compute Engine (N1) machine type in the `machineType` - // field. Learn more about [using GPUs for online - // prediction](/ml-engine/docs/machine-types-online-prediction#gpus). + // field. Learn more about using GPUs for online prediction. AcceleratorConfig *GoogleCloudMlV1__AcceleratorConfig `json:"acceleratorConfig,omitempty"` // AutoScaling: Automatically scale the number of nodes used to serve @@ -3840,8 +3746,7 @@ type GoogleCloudMlV1__Version struct { // should be taken to ramp up traffic according to the model's ability // to scale or you will start seeing increases in latency and 429 // response codes. Note that you cannot use AutoScaling if your version - // uses [GPUs](#Version.FIELDS.accelerator_config). Instead, you must - // use specify `manual_scaling`. + // uses GPUs. Instead, you must use specify `manual_scaling`. AutoScaling *GoogleCloudMlV1__AutoScaling `json:"autoScaling,omitempty"` // Container: Optional. Specifies a custom container to use for serving @@ -3857,19 +3762,16 @@ type GoogleCloudMlV1__Version struct { // DeploymentUri: The Cloud Storage URI of a directory containing // trained model artifacts to be used to create the model version. See - // the [guide to deploying - // models](/ai-platform/prediction/docs/deploying-models) for more - // information. The total number of files under this directory must not - // exceed 1000. During projects.models.versions.create, AI Platform - // Prediction copies all files from the specified directory to a - // location managed by the service. From then on, AI Platform Prediction - // uses these copies of the model artifacts to serve predictions, not - // the original files in Cloud Storage, so this location is useful only - // as a historical record. If you specify container, then this field is - // optional. Otherwise, it is required. Learn [how to use this field - // with a custom - // container](/ai-platform/prediction/docs/custom-container-requirements# - // artifacts). + // the guide to deploying models for more information. The total number + // of files under this directory must not exceed 1000. During + // projects.models.versions.create, AI Platform Prediction copies all + // files from the specified directory to a location managed by the + // service. From then on, AI Platform Prediction uses these copies of + // the model artifacts to serve predictions, not the original files in + // Cloud Storage, so this location is useful only as a historical + // record. If you specify container, then this field is optional. + // Otherwise, it is required. Learn how to use this field with a custom + // container. DeploymentUri string `json:"deploymentUri,omitempty"` // Description: Optional. The description specified for the version when @@ -3901,10 +3803,8 @@ type GoogleCloudMlV1__Version struct { // Platform will analyze files in the deployment_uri to determine a // framework. If you choose `SCIKIT_LEARN` or `XGBOOST`, you must also // set the runtime version of the model to 1.4 or greater. Do **not** - // specify a framework if you're deploying a [custom prediction - // routine](/ai-platform/prediction/docs/custom-prediction-routines) or - // if you're using a [custom - // container](/ai-platform/prediction/docs/use-custom-container). + // specify a framework if you're deploying a custom prediction routine + // or if you're using a custom container. // // Possible values: // "FRAMEWORK_UNSPECIFIED" - Unspecified framework. Assigns a value @@ -3938,8 +3838,7 @@ type GoogleCloudMlV1__Version struct { // * `n1-highmem-8` * `n1-highmem-16` * `n1-highmem-32` * `n1-highcpu-2` // * `n1-highcpu-4` * `n1-highcpu-8` * `n1-highcpu-16` * `n1-highcpu-32` // `mls1-c4-m2` is in beta. All other machine types are generally - // available. Learn more about the [differences between machine - // types](/ml-engine/docs/machine-types-online-prediction). + // available. Learn more about the differences between machine types. MachineType string `json:"machineType,omitempty"` // ManualScaling: Manually select the number of nodes to use for serving @@ -3956,49 +3855,39 @@ type GoogleCloudMlV1__Version struct { Name string `json:"name,omitempty"` // PackageUris: Optional. Cloud Storage paths (`gs://…`) of packages - // for [custom prediction - // routines](/ml-engine/docs/tensorflow/custom-prediction-routines) or - // [scikit-learn pipelines with custom - // code](/ml-engine/docs/scikit/exporting-for-prediction#custom-pipeline- - // code). For a custom prediction routine, one of these packages must - // contain your Predictor class (see - // [`predictionClass`](#Version.FIELDS.prediction_class)). Additionally, + // for custom prediction routines or scikit-learn pipelines with custom + // code. For a custom prediction routine, one of these packages must + // contain your Predictor class (see `predictionClass`). Additionally, // include any dependencies used by your Predictor or scikit-learn - // pipeline uses that are not already included in your selected [runtime - // version](/ml-engine/docs/tensorflow/runtime-version-list). If you - // specify this field, you must also set - // [`runtimeVersion`](#Version.FIELDS.runtime_version) to 1.4 or - // greater. + // pipeline uses that are not already included in your selected runtime + // version. If you specify this field, you must also set + // `runtimeVersion` to 1.4 or greater. PackageUris []string `json:"packageUris,omitempty"` // PredictionClass: Optional. The fully qualified name // (module_name.class_name) of a class that implements the Predictor // interface described in this reference field. The module containing // this class should be included in a package provided to the - // [`packageUris` field](#Version.FIELDS.package_uris). Specify this - // field if and only if you are deploying a [custom prediction routine - // (beta)](/ml-engine/docs/tensorflow/custom-prediction-routines). If - // you specify this field, you must set - // [`runtimeVersion`](#Version.FIELDS.runtime_version) to 1.4 or greater - // and you must set `machineType` to a [legacy (MLS1) machine - // type](/ml-engine/docs/machine-types-online-prediction). The following - // code sample provides the Predictor interface: class - // Predictor(object): """Interface for constructing custom - // predictors.""" def predict(self, instances, **kwargs): """Performs - // custom prediction. Instances are the decoded values from the request. - // They have already been deserialized from JSON. Args: instances: A - // list of prediction input instances. **kwargs: A dictionary of keyword - // args provided as additional fields on the predict request body. - // Returns: A list of outputs containing the prediction results. This - // list must be JSON serializable. """ raise NotImplementedError() - // @classmethod def from_path(cls, model_dir): """Creates an instance of - // Predictor using the given path. Loading of the predictor should be - // done in this method. Args: model_dir: The local directory that - // contains the exported model file along with any additional files - // uploaded when creating the version resource. Returns: An instance - // implementing this Predictor class. """ raise NotImplementedError() - // Learn more about [the Predictor interface and custom prediction - // routines](/ml-engine/docs/tensorflow/custom-prediction-routines). + // `packageUris` field. Specify this field if and only if you are + // deploying a custom prediction routine (beta). If you specify this + // field, you must set `runtimeVersion` to 1.4 or greater and you must + // set `machineType` to a legacy (MLS1) machine type. The following code + // sample provides the Predictor interface: class Predictor(object): + // """Interface for constructing custom predictors.""" def predict(self, + // instances, **kwargs): """Performs custom prediction. Instances are + // the decoded values from the request. They have already been + // deserialized from JSON. Args: instances: A list of prediction input + // instances. **kwargs: A dictionary of keyword args provided as + // additional fields on the predict request body. Returns: A list of + // outputs containing the prediction results. This list must be JSON + // serializable. """ raise NotImplementedError() @classmethod def + // from_path(cls, model_dir): """Creates an instance of Predictor using + // the given path. Loading of the predictor should be done in this + // method. Args: model_dir: The local directory that contains the + // exported model file along with any additional files uploaded when + // creating the version resource. Returns: An instance implementing this + // Predictor class. """ raise NotImplementedError() Learn more about the + // Predictor interface and custom prediction routines. PredictionClass string `json:"predictionClass,omitempty"` // PythonVersion: Required. The version of Python used in prediction. @@ -4007,8 +3896,7 @@ type GoogleCloudMlV1__Version struct { // '3.5' is available when `runtime_version` is set to a version from // '1.4' to '1.14'. * Python '2.7' is available when `runtime_version` // is set to '1.15' or earlier. Read more about the Python versions - // available for [each runtime - // version](/ml-engine/docs/runtime-version-list). + // available for each runtime version. PythonVersion string `json:"pythonVersion,omitempty"` // RequestLoggingConfig: Optional. *Only* specify this field in a @@ -4028,16 +3916,14 @@ type GoogleCloudMlV1__Version struct { Routes *GoogleCloudMlV1__RouteMap `json:"routes,omitempty"` // RuntimeVersion: Required. The AI Platform runtime version to use for - // this deployment. For more information, see the [runtime version - // list](/ml-engine/docs/runtime-version-list) and [how to manage - // runtime versions](/ml-engine/docs/versioning). + // this deployment. For more information, see the runtime version list + // and how to manage runtime versions. RuntimeVersion string `json:"runtimeVersion,omitempty"` // ServiceAccount: Optional. Specifies the service account for resource // access control. If you specify this field, then you must also specify // either the `containerSpec` or the `predictionClass` field. Learn more - // about [using a custom service - // account](/ai-platform/prediction/docs/custom-service-account). + // about using a custom service account. ServiceAccount string `json:"serviceAccount,omitempty"` // State: Output only. The state of a version. @@ -4226,9 +4112,7 @@ type GoogleIamV1__Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *GoogleType__Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -4303,9 +4187,8 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) { // logical expression that allows access to a resource only if the // expression evaluates to `true`. A condition can add constraints based // on attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -4323,8 +4206,8 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type GoogleIamV1__Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -4363,9 +4246,8 @@ type GoogleIamV1__Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4438,8 +4320,7 @@ func (s *GoogleIamV1__SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type GoogleIamV1__TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -4612,11 +4493,10 @@ type GoogleProtobuf__Empty struct { // GoogleRpc__Status: The `Status` type defines a logical error model // that is suitable for different programming environments, including -// REST APIs and RPC APIs. It is used by -// [gRPC](https://github.com/grpc). Each `Status` message contains three -// pieces of data: error code, error message, and error details. You can -// find out more about this error model and how to work with it in the -// [API Design Guide](https://cloud.google.com/apis/design/errors). +// REST APIs and RPC APIs. It is used by gRPC. Each `Status` message +// contains three pieces of data: error code, error message, and error +// details. You can find out more about this error model and how to work +// with it in the API Design Guide. type GoogleRpc__Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -5602,9 +5482,7 @@ func (r *ProjectsJobsService) GetIamPolicy(resource string) *ProjectsJobsGetIamP // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsJobsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsJobsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -9469,9 +9347,7 @@ func (r *ProjectsModelsService) GetIamPolicy(resource string) *ProjectsModelsGet // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsModelsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsModelsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -10940,8 +10816,8 @@ func (r *ProjectsModelsVersionsService) Patch(name string, googlecloudmlv1__vers // only supported update mask fields are `description`, // `requestLoggingConfig`, `autoScaling.minNodes`, and // `manualScaling.nodes`. However, you can only update -// `manualScaling.nodes` if the version uses a [Compute Engine (N1) -// machine type](/ml-engine/docs/machine-types-online-prediction). +// `manualScaling.nodes` if the version uses a Compute Engine (N1) +// machine type. func (c *ProjectsModelsVersionsPatchCall) UpdateMask(updateMask string) *ProjectsModelsVersionsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/monitoring/v3/monitoring-gen.go b/monitoring/v3/monitoring-gen.go index 59e308306fd..1b1bc609525 100644 --- a/monitoring/v3/monitoring-gen.go +++ b/monitoring/v3/monitoring-gen.go @@ -1472,11 +1472,10 @@ type Distribution struct { Range *Range `json:"range,omitempty"` // SumOfSquaredDeviation: The sum of squared deviations from the mean of - // the values in the population. For values x_i this is: - // Sum[i=1..n]((x_i - mean)^2) Knuth, "The Art of Computer Programming", - // Vol. 2, page 232, 3rd edition describes Welford's method for - // accumulating this sum in one pass.If count is zero then this field - // must be zero. + // the values in the population. For values x_i this is: Sumi=1..n^2) + // Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd + // edition describes Welford's method for accumulating this sum in one + // pass.If count is zero then this field must be zero. SumOfSquaredDeviation float64 `json:"sumOfSquaredDeviation,omitempty"` // ForceSendFields is a list of field names (e.g. "BucketCounts") to diff --git a/networkmanagement/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index fde350254f8..bb9c89ea11d 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -361,9 +361,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -664,8 +662,7 @@ type Endpoint struct { // IpAddress: The IP address of the endpoint, which can be an external // or internal IP. An IPv6 address is only allowed when the test's - // destination is a [global load balancer - // VIP](/load-balancing/docs/load-balancing-overview). + // destination is a global load balancer VIP. IpAddress string `json:"ipAddress,omitempty"` // Network: A Compute Engine network URI. @@ -1457,9 +1454,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1477,8 +1473,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1517,9 +1513,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1737,11 +1732,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1908,8 +1902,7 @@ func (s *Step) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2933,9 +2926,7 @@ func (r *ProjectsLocationsGlobalConnectivityTestsService) GetIamPolicy(resource // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsGlobalConnectivityTestsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGlobalConnectivityTestsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/networkmanagement/v1beta1/networkmanagement-gen.go b/networkmanagement/v1beta1/networkmanagement-gen.go index ae480212462..05f2fa3c854 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -361,9 +361,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -724,13 +722,10 @@ type Empty struct { // Endpoint: Source or destination of the Connectivity Test. type Endpoint struct { - // CloudSqlInstance: A [Cloud SQL](https://cloud.google.com/sql) - // instance URI. + // CloudSqlInstance: A Cloud SQL instance URI. CloudSqlInstance string `json:"cloudSqlInstance,omitempty"` - // GkeMasterCluster: A cluster URI for [Google Kubernetes Engine - // master](https://cloud.google.com/kubernetes-engine/docs/concepts/clust - // er-architecture). + // GkeMasterCluster: A cluster URI for Google Kubernetes Engine master. GkeMasterCluster string `json:"gkeMasterCluster,omitempty"` // Instance: A Compute Engine instance URI. @@ -738,9 +733,7 @@ type Endpoint struct { // IpAddress: The IP address of the endpoint, which can be an external // or internal IP. An IPv6 address is only allowed when the test's - // destination is a [global load balancer - // VIP](https://cloud.google.com/load-balancing/docs/load-balancing-overv - // iew). + // destination is a global load balancer VIP. IpAddress string `json:"ipAddress,omitempty"` // Network: A Compute Engine network URI. @@ -1637,9 +1630,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1657,8 +1649,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1697,9 +1689,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1991,11 +1982,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2174,8 +2164,7 @@ func (s *Step) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3199,9 +3188,7 @@ func (r *ProjectsLocationsGlobalConnectivityTestsService) GetIamPolicy(resource // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsGlobalConnectivityTestsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGlobalConnectivityTestsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/notebooks/v1/notebooks-gen.go b/notebooks/v1/notebooks-gen.go index 1146b0ebd79..7f04519e6f3 100644 --- a/notebooks/v1/notebooks-gen.go +++ b/notebooks/v1/notebooks-gen.go @@ -193,9 +193,9 @@ type ProjectsLocationsOperationsService struct { } // AcceleratorConfig: Definition of a hardware accelerator. Note that -// not all combinations of `type` and `core_count` are valid. Check -// [GPUs on Compute Engine](/compute/docs/gpus/#gpus-list) to find a -// valid combination. TPUs are not supported. +// not all combinations of `type` and `core_count` are valid. Check GPUs +// on Compute Engine to find a valid combination. TPUs are not +// supported. type AcceleratorConfig struct { // CoreCount: Count of cores of this accelerator. CoreCount int64 `json:"coreCount,omitempty,string"` @@ -251,9 +251,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -607,9 +605,8 @@ func (s *GuestOsFeature) MarshalJSON() ([]byte, error) { // Instance: The definition of a notebook instance. type Instance struct { // AcceleratorConfig: The hardware accelerator used on this instance. If - // you use accelerators, make sure that your configuration has [enough - // vCPUs and memory to support the `machine_type` you have - // selected](/compute/docs/gpus/#gpus-list). + // you use accelerators, make sure that your configuration has enough + // vCPUs and memory to support the `machine_type` you have selected. AcceleratorConfig *AcceleratorConfig `json:"acceleratorConfig,omitempty"` // BootDiskSizeGb: Input only. The size of the boot disk in GB attached @@ -683,16 +680,15 @@ type Instance struct { // KmsKey: Input only. The KMS key used to encrypt the disks, only // applicable if disk_encryption is CMEK. Format: // `projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cry - // ptoKeys/{key_id}` Learn more about [using your own encryption - // keys](/kms/docs/quickstart). + // ptoKeys/{key_id}` Learn more about using your own encryption keys. KmsKey string `json:"kmsKey,omitempty"` // Labels: Labels to apply to this instance. These can be later modified // by the setLabels method. Labels map[string]string `json:"labels,omitempty"` - // MachineType: Required. The [Compute Engine machine - // type](/compute/docs/machine-types) of this instance. + // MachineType: Required. The Compute Engine machine type of this + // instance. MachineType string `json:"machineType,omitempty"` // Metadata: Custom metadata to apply to this instance. @@ -729,10 +725,8 @@ type Instance struct { // ServiceAccount: The service account on this instance, giving access // to other Google Cloud services. You can use any service account // within the same project, but you must have the service account user - // permission to use the instance. If not specified, the [Compute Engine - // default service - // account](https://cloud.google.com/compute/docs/access/service-accounts - // #default_service_account) is used. + // permission to use the instance. If not specified, the Compute Engine + // default service account is used. ServiceAccount string `json:"serviceAccount,omitempty"` // State: Output only. The state of this instance. @@ -1164,9 +1158,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1184,8 +1177,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1220,9 +1213,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1357,10 +1349,9 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // accelerator. type SetInstanceAcceleratorRequest struct { // CoreCount: Required. Count of cores of this accelerator. Note that - // not all combinations of `type` and `core_count` are valid. Check - // [GPUs on Compute - // Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to - // find a valid combination. TPUs are not supported. + // not all combinations of `type` and `core_count` are valid. Check GPUs + // on Compute Engine to find a valid combination. TPUs are not + // supported. CoreCount int64 `json:"coreCount,omitempty,string"` // Type: Required. Type of this accelerator. @@ -1438,8 +1429,7 @@ func (s *SetInstanceLabelsRequest) MarshalJSON() ([]byte, error) { // SetInstanceMachineTypeRequest: Request for setting instance machine // type. type SetInstanceMachineTypeRequest struct { - // MachineType: Required. The [Compute Engine machine - // type](https://cloud.google.com/compute/docs/machine-types). + // MachineType: Required. The Compute Engine machine type. MachineType string `json:"machineType,omitempty"` // ForceSendFields is a list of field names (e.g. "MachineType") to @@ -1471,11 +1461,10 @@ type StartInstanceRequest struct { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1522,8 +1511,7 @@ type StopInstanceRequest struct { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3129,9 +3117,7 @@ func (r *ProjectsLocationsInstancesService) GetIamPolicy(resource string) *Proje // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsInstancesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsInstancesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/osconfig/v1/osconfig-gen.go b/osconfig/v1/osconfig-gen.go index 67e21fc4283..3cc70596797 100644 --- a/osconfig/v1/osconfig-gen.go +++ b/osconfig/v1/osconfig-gen.go @@ -1018,8 +1018,7 @@ func (s *MonthlySchedule) MarshalJSON() ([]byte, error) { } // OneTimeSchedule: Sets the time for a one time patch deployment. -// Timestamp is in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text -// format. +// Timestamp is in RFC3339 text format. type OneTimeSchedule struct { // ExecuteTime: Required. The desired patch job execution time. ExecuteTime string `json:"executeTime,omitempty"` @@ -1116,13 +1115,10 @@ func (s *PatchConfig) MarshalJSON() ([]byte, error) { // patch jobs use to complete a patch. These configurations include // instance filter, package repository settings, and a schedule. For // more information about creating and managing patch deployments, see -// [Scheduling patch -// jobs](https://cloud.google.com/compute/docs/os-patch-management/schedu -// le-patch-jobs). +// Scheduling patch jobs. type PatchDeployment struct { // CreateTime: Output only. Time the patch deployment was created. - // Timestamp is in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text - // format. + // Timestamp is in RFC3339 text format. CreateTime string `json:"createTime,omitempty"` // Description: Optional. Description of the patch deployment. Length of @@ -1137,8 +1133,7 @@ type PatchDeployment struct { InstanceFilter *PatchInstanceFilter `json:"instanceFilter,omitempty"` // LastExecuteTime: Output only. The last time a patch job was started - // by this deployment. Timestamp is in - // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. + // by this deployment. Timestamp is in RFC3339 text format. LastExecuteTime string `json:"lastExecuteTime,omitempty"` // Name: Unique name for the patch deployment resource in a project. The @@ -1160,8 +1155,7 @@ type PatchDeployment struct { Rollout *PatchRollout `json:"rollout,omitempty"` // UpdateTime: Output only. Time the patch deployment was last updated. - // Timestamp is in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text - // format. + // Timestamp is in RFC3339 text format. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1245,13 +1239,12 @@ func (s *PatchInstanceFilter) MarshalJSON() ([]byte, error) { } // PatchInstanceFilterGroupLabel: Targets a group of VM instances by -// using their [assigned -// labels](https://cloud.google.com/compute/docs/labeling-resources). -// Labels are key-value pairs. A `GroupLabel` is a combination of labels -// that is used to target VMs for a patch job. For example, a patch job -// can target VMs that have the following `GroupLabel`: `{"env":"test", -// "app":"web"}`. This means that the patch job is applied to VMs that -// have both the labels `env=test` and `app=web`. +// using their assigned labels. Labels are key-value pairs. A +// `GroupLabel` is a combination of labels that is used to target VMs +// for a patch job. For example, a patch job can target VMs that have +// the following `GroupLabel`: `{"env":"test", "app":"web"}`. This means +// that the patch job is applied to VMs that have both the labels +// `env=test` and `app=web`. type PatchInstanceFilterGroupLabel struct { // Labels: Compute Engine instance labels that must be present for a VM // instance to be targeted by this filter. @@ -1284,9 +1277,7 @@ func (s *PatchInstanceFilterGroupLabel) MarshalJSON() ([]byte, error) { // in progress or has completed. Instance details are not included in // the job. To paginate through instance details, use // ListPatchJobInstanceDetails. For more information about patch jobs, -// see [Creating patch -// jobs](https://cloud.google.com/compute/docs/os-patch-management/create -// -patch-job). +// see Creating patch jobs. type PatchJob struct { // CreateTime: Time this patch job was created. CreateTime string `json:"createTime,omitempty"` @@ -1395,10 +1386,8 @@ func (s *PatchJob) UnmarshalJSON(data []byte) error { } // PatchJobInstanceDetails: Patch details for a VM instance. For more -// information about reviewing VM instance details, see [Listing all VM -// instance details for a specific patch -// job](https://cloud.google.com/compute/docs/os-patch-management/manage- -// patch-jobs#list-instance-details). +// information about reviewing VM instance details, see Listing all VM +// instance details for a specific patch job. type PatchJobInstanceDetails struct { // AttemptCount: The number of times the agent that the agent attempts // to apply the patch. @@ -1723,8 +1712,7 @@ func (s *TimeOfDay) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// TimeZone: Represents a time zone from the [IANA Time Zone -// Database](https://www.iana.org/time-zones). +// TimeZone: Represents a time zone from the IANA Time Zone Database. type TimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` diff --git a/osconfig/v1beta/osconfig-gen.go b/osconfig/v1beta/osconfig-gen.go index 93377cf515a..50f8414313d 100644 --- a/osconfig/v1beta/osconfig-gen.go +++ b/osconfig/v1beta/osconfig-gen.go @@ -856,10 +856,8 @@ type GuestPolicy struct { // empty, all VM instances underneath this policy are targeted. At the // same level in the resource hierarchy (that is within a project), the // service prevents the creation of multiple policies that conflict with - // each other. For more information, see how the service [handles - // assignment - // conflicts](/compute/docs/os-config-management/create-guest-policy#hand - // le-conflicts). + // each other. For more information, see how the service handles + // assignment conflicts. Assignment *Assignment `json:"assignment,omitempty"` // CreateTime: Output only. Time this guest policy was created. @@ -1564,8 +1562,7 @@ func (s *MonthlySchedule) MarshalJSON() ([]byte, error) { } // OneTimeSchedule: Sets the time for a one time patch deployment. -// Timestamp is in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text -// format. +// Timestamp is in RFC3339 text format. type OneTimeSchedule struct { // ExecuteTime: Required. The desired patch job execution time. ExecuteTime string `json:"executeTime,omitempty"` @@ -1774,13 +1771,10 @@ func (s *PatchConfig) MarshalJSON() ([]byte, error) { // patch jobs use to complete a patch. These configurations include // instance filter, package repository settings, and a schedule. For // more information about creating and managing patch deployments, see -// [Scheduling patch -// jobs](https://cloud.google.com/compute/docs/os-patch-management/schedu -// le-patch-jobs). +// Scheduling patch jobs. type PatchDeployment struct { // CreateTime: Output only. Time the patch deployment was created. - // Timestamp is in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text - // format. + // Timestamp is in RFC3339 text format. CreateTime string `json:"createTime,omitempty"` // Description: Optional. Description of the patch deployment. Length of @@ -1795,8 +1789,7 @@ type PatchDeployment struct { InstanceFilter *PatchInstanceFilter `json:"instanceFilter,omitempty"` // LastExecuteTime: Output only. The last time a patch job was started - // by this deployment. Timestamp is in - // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. + // by this deployment. Timestamp is in RFC3339 text format. LastExecuteTime string `json:"lastExecuteTime,omitempty"` // Name: Unique name for the patch deployment resource in a project. The @@ -1818,8 +1811,7 @@ type PatchDeployment struct { Rollout *PatchRollout `json:"rollout,omitempty"` // UpdateTime: Output only. Time the patch deployment was last updated. - // Timestamp is in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text - // format. + // Timestamp is in RFC3339 text format. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1938,9 +1930,7 @@ func (s *PatchInstanceFilterGroupLabel) MarshalJSON() ([]byte, error) { // in progress or has completed. Instance details are not included in // the job. To paginate through instance details, use // `ListPatchJobInstanceDetails`. For more information about patch jobs, -// see [Creating patch -// jobs](https://cloud.google.com/compute/docs/os-patch-management/create -// -patch-job). +// see Creating patch jobs. type PatchJob struct { // CreateTime: Time this patch job was created. CreateTime string `json:"createTime,omitempty"` @@ -2049,10 +2039,8 @@ func (s *PatchJob) UnmarshalJSON(data []byte) error { } // PatchJobInstanceDetails: Patch details for a VM instance. For more -// information about reviewing VM instance details, see [Listing all VM -// instance details for a specific patch -// job](https://cloud.google.com/compute/docs/os-patch-management/manage- -// patch-jobs#list-instance-details). +// information about reviewing VM instance details, see Listing all VM +// instance details for a specific patch job. type PatchJobInstanceDetails struct { // AttemptCount: The number of times the agent that the agent attempts // to apply the patch. @@ -2829,8 +2817,7 @@ type SoftwareRecipeStepRunScript struct { // Interpreter: The script interpreter to use to run the script. If no // interpreter is specified the script is executed directly, which - // likely only succeed for scripts with [shebang - // lines](https://en.wikipedia.org/wiki/Shebang_\(Unix\)). + // likely only succeed for scripts with shebang lines). // // Possible values: // "INTERPRETER_UNSPECIFIED" - Default value for ScriptType. @@ -2910,8 +2897,7 @@ func (s *TimeOfDay) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// TimeZone: Represents a time zone from the [IANA Time Zone -// Database](https://www.iana.org/time-zones). +// TimeZone: Represents a time zone from the IANA Time Zone Database. type TimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` diff --git a/people/v1/people-gen.go b/people/v1/people-gen.go index 5eb4e88f7ab..954e4c50c10 100644 --- a/people/v1/people-gen.go +++ b/people/v1/people-gen.go @@ -251,9 +251,7 @@ type Address struct { // Country: The country of the address. Country string `json:"country,omitempty"` - // CountryCode: The [ISO 3166-1 - // alpha-2](http://www.iso.org/iso/country_codes.htm) country code of - // the address. + // CountryCode: The ISO 3166-1 alpha-2 country code of the address. CountryCode string `json:"countryCode,omitempty"` // ExtendedAddress: The extended address of the address; for example, @@ -568,8 +566,8 @@ func (s *ClientData) MarshalJSON() ([]byte, error) { // ContactGroup: A contact group. type ContactGroup struct { - // Etag: The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) - // of the resource. Used for web cache validation. + // Etag: The HTTP entity tag of the resource. Used for web cache + // validation. Etag string `json:"etag,omitempty"` // FormattedName: Output only. The name translated and formatted in the @@ -593,8 +591,7 @@ type ContactGroup struct { // MemberResourceNames: Output only. The list of contact person resource // names that are members of the contact group. The field is not // populated for LIST requests and can only be updated through the - // [ModifyContactGroupMembers](/people/api/rest/v1/contactgroups/members/ - // modify). + // ModifyContactGroupMembers. MemberResourceNames []string `json:"memberResourceNames,omitempty"` // Metadata: Output only. Metadata about the contact group. @@ -678,9 +675,8 @@ func (s *ContactGroupMembership) MarshalJSON() ([]byte, error) { // ContactGroupMetadata: The metadata about a contact group. type ContactGroupMetadata struct { // Deleted: Output only. True if the contact group resource has been - // deleted. Populated only for - // [`ListContactGroups`](/people/api/rest/v1/contactgroups/list) - // requests that include a sync token. + // deleted. Populated only for `ListContactGroups` requests that include + // a sync token. Deleted bool `json:"deleted,omitempty"` // UpdateTime: Output only. The time the group was last updated. @@ -1524,8 +1520,7 @@ type Locale struct { // Metadata: Metadata about the locale. Metadata *FieldMetadata `json:"metadata,omitempty"` - // Value: The well-formed [IETF BCP - // 47](https://tools.ietf.org/html/bcp47) language tag representing the + // Value: The well-formed IETF BCP 47 language tag representing the // locale. Value string `json:"value,omitempty"` @@ -2048,8 +2043,8 @@ type Person struct { // EmailAddresses: The person's email addresses. EmailAddresses []*EmailAddress `json:"emailAddresses,omitempty"` - // Etag: The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) - // of the resource. Used for web cache validation. + // Etag: The HTTP entity tag of the resource. Used for web cache + // validation. Etag string `json:"etag,omitempty"` // Events: The person's events. @@ -2171,9 +2166,8 @@ func (s *Person) MarshalJSON() ([]byte, error) { // PersonMetadata: The metadata about a person. type PersonMetadata struct { // Deleted: Output only. True if the person resource has been deleted. - // Populated only for - // [`connections.list`](/people/api/rest/v1/people.connections/list) - // requests that include a sync token. + // Populated only for `connections.list` requests that include a sync + // token. Deleted bool `json:"deleted,omitempty"` // LinkedPeopleResourceNames: Output only. Resource names of people @@ -2192,11 +2186,10 @@ type PersonMetadata struct { ObjectType string `json:"objectType,omitempty"` // PreviousResourceNames: Output only. Any former resource names this - // person has had. Populated only for - // [`connections.list`](/people/api/rest/v1/people.connections/list) - // requests that include a sync token. The resource name may change when - // adding or removing fields that link a contact and profile such as a - // verified email, verified phone number, or profile URL. + // person has had. Populated only for `connections.list` requests that + // include a sync token. The resource name may change when adding or + // removing fields that link a contact and profile such as a verified + // email, verified phone number, or profile URL. PreviousResourceNames []string `json:"previousResourceNames,omitempty"` // Sources: The sources of data for the person. @@ -2271,9 +2264,8 @@ func (s *PersonResponse) MarshalJSON() ([]byte, error) { // PhoneNumber: A person's phone number. type PhoneNumber struct { - // CanonicalForm: Output only. The canonicalized [ITU-T - // E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008. - // pdf) form of the phone number. + // CanonicalForm: Output only. The canonicalized ITU-T E.164 form of the + // phone number. CanonicalForm string `json:"canonicalForm,omitempty"` // FormattedType: Output only. The type of the phone number translated @@ -2617,9 +2609,7 @@ type SipAddress struct { // of these predefined values: * `home` * `work` * `mobile` * `other` Type string `json:"type,omitempty"` - // Value: The SIP address in the [RFC 3261 - // 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI - // format. + // Value: The SIP address in the RFC 3261 19.1 SIP URI format. Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "FormattedType") to @@ -2678,9 +2668,8 @@ func (s *Skill) MarshalJSON() ([]byte, error) { // Source: The source of a field. type Source struct { - // Etag: **Only populated in `person.metadata.sources`.** The [HTTP - // entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. - // Used for web cache validation. + // Etag: **Only populated in `person.metadata.sources`.** The HTTP + // entity tag of the source. Used for web cache validation. Etag string `json:"etag,omitempty"` // Id: The unique identifier within the source type generated by the @@ -2741,11 +2730,10 @@ func (s *Source) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3621,8 +3609,7 @@ func (c *ContactGroupsListCall) PageSize(pageSize int64) *ContactGroupsListCall // PageToken sets the optional parameter "pageToken": The // next_page_token value returned from a previous call to -// [ListContactGroups](/people/api/rest/v1/contactgroups/list). Requests -// the next page of resources. +// ListContactGroups. Requests the next page of resources. func (c *ContactGroupsListCall) PageToken(pageToken string) *ContactGroupsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -5218,9 +5205,8 @@ func (c *PeopleGetBatchGetCall) RequestMaskIncludeField(requestMaskIncludeField // about the authenticated user, specify `people/me`. - To get // information about a google account, specify `people/{account_id}`. - // To get information about a contact, specify the resource name that -// identifies the contact as returned by -// [`people.connections.list`](/people/api/rest/v1/people.connections/lis -// t). You can include up to 50 resource names in one request. +// identifies the contact as returned by `people.connections.list`. You +// can include up to 50 resource names in one request. func (c *PeopleGetBatchGetCall) ResourceNames(resourceNames ...string) *PeopleGetBatchGetCall { c.urlParams_.SetMulti("resourceNames", append([]string{}, resourceNames...)) return c diff --git a/playablelocations/v3/playablelocations-gen.go b/playablelocations/v3/playablelocations-gen.go index 9b6b80d2bdf..d7492b6da32 100644 --- a/playablelocations/v3/playablelocations-gen.go +++ b/playablelocations/v3/playablelocations-gen.go @@ -346,11 +346,7 @@ type GoogleMapsPlayablelocationsV3SampleAreaFilter struct { // between cell level 11 and 14 (inclusive). S2 cells are 64-bit // integers that identify areas on the Earth. They are hierarchical, and // can therefore be used for spatial indexing. The S2 geometry library - // is available in a number of languages: * - // [C++](https://github.com/google/s2geometry) * - // [Java](https://github.com/google/s2-geometry-library-java) * - // [Go](https://github.com/golang/geo) * - // [Python](https://github.com/google/s2geometry/tree/master/src/python) + // is available in a number of languages: * C++ * Java * Go * Python S2CellId uint64 `json:"s2CellId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "S2CellId") to @@ -428,7 +424,7 @@ func (s *GoogleMapsPlayablelocationsV3SampleCriterion) MarshalJSON() ([]byte, er // use when searching for playable locations. type GoogleMapsPlayablelocationsV3SampleFilter struct { // IncludedTypes: Restricts the set of playable locations to just the - // [types](/maps/documentation/gaming/tt/types) that you want. + // types that you want. IncludedTypes []string `json:"includedTypes,omitempty"` // MaxLocationCount: Specifies the maximum number of playable locations @@ -485,8 +481,7 @@ type GoogleMapsPlayablelocationsV3SamplePlayableLocation struct { // sidewalk of the nearest road, if a nearby road exists. SnappedPoint *GoogleTypeLatLng `json:"snappedPoint,omitempty"` - // Types: A collection of [Playable Location - // Types](/maps/documentation/gaming/tt/types) for this playable + // Types: A collection of Playable Location Types for this playable // location. The first type in the collection is the primary type. Type // information might not be available for all playable locations. Types []string `json:"types,omitempty"` diff --git a/policytroubleshooter/v1/policytroubleshooter-gen.go b/policytroubleshooter/v1/policytroubleshooter-gen.go index 5844bc805c2..e93831931d3 100644 --- a/policytroubleshooter/v1/policytroubleshooter-gen.go +++ b/policytroubleshooter/v1/policytroubleshooter-gen.go @@ -626,9 +626,7 @@ type GoogleIamV1Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *GoogleTypeExpr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -703,9 +701,8 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // logical expression that allows access to a resource only if the // expression evaluates to `true`. A condition can add constraints based // on attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -723,8 +720,8 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type GoogleIamV1Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -763,9 +760,8 @@ type GoogleIamV1Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to diff --git a/policytroubleshooter/v1beta/policytroubleshooter-gen.go b/policytroubleshooter/v1beta/policytroubleshooter-gen.go index 8d4f15b2b34..ce140c96567 100644 --- a/policytroubleshooter/v1beta/policytroubleshooter-gen.go +++ b/policytroubleshooter/v1beta/policytroubleshooter-gen.go @@ -626,9 +626,7 @@ type GoogleIamV1Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *GoogleTypeExpr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -703,9 +701,8 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // logical expression that allows access to a resource only if the // expression evaluates to `true`. A condition can add constraints based // on attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -723,8 +720,8 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type GoogleIamV1Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -763,9 +760,8 @@ type GoogleIamV1Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to diff --git a/poly/v1/poly-gen.go b/poly/v1/poly-gen.go index efbfc0339cd..50384a0cb04 100644 --- a/poly/v1/poly-gen.go +++ b/poly/v1/poly-gen.go @@ -170,13 +170,11 @@ type UsersLikedassetsService struct { } // Asset: Represents and describes an asset in the Poly library. An -// asset is a 3D model or scene created using [Tilt -// Brush](//www.tiltbrush.com), [Blocks](//vr.google.com/blocks/), or -// any 3D program that produces a file that can be upload to Poly. +// asset is a 3D model or scene created using Tilt Brush, Blocks, or any +// 3D program that produces a file that can be upload to Poly. type Asset struct { // AuthorName: The author's publicly visible name. Use this name when - // giving credit to the author. For more information, see - // [Licensing](/poly/discover/licensing). + // giving credit to the author. For more information, see Licensing. AuthorName string `json:"authorName,omitempty"` // CreateTime: For published assets, the time when the asset was @@ -349,9 +347,7 @@ func (s *AssetImportMessage) MarshalJSON() ([]byte, error) { // thumbnail file. type File struct { // ContentType: The MIME content-type, such as `image/png`. For more - // information, see [MIME - // types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME - // _types). + // information, see MIME types. ContentType string `json:"contentType,omitempty"` // RelativePath: The path of the resource file relative to the root @@ -385,12 +381,10 @@ func (s *File) MarshalJSON() ([]byte, error) { } // Format: The same asset can be represented in different formats, for -// example, a [WaveFront -// .obj](//en.wikipedia.org/wiki/Wavefront_.obj_file) file with its -// corresponding .mtl file or a [Khronos glTF](//www.khronos.org/gltf) -// file with its corresponding .glb binary data. A format refers to a -// specific representation of an asset and contains all information -// needed to retrieve and describe this representation. +// example, a WaveFront .obj file with its corresponding .mtl file or a +// Khronos glTF file with its corresponding .glb binary data. A format +// refers to a specific representation of an asset and contains all +// information needed to retrieve and describe this representation. type Format struct { // FormatComplexity: Complexity stats about this representation of the // asset. @@ -788,9 +782,9 @@ func (s *PresentationParams) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Quaternion: A [Quaternion](//en.wikipedia.org/wiki/Quaternion). -// Please note: if in the response you see "w: 1" and nothing else this -// is the default value of [0, 0, 0, 1] where x,y, and z are 0. +// Quaternion: A Quaternion. Please note: if in the response you see "w: +// 1" and nothing else this is the default value of [0, 0, 0, 1] where +// x,y, and z are 0. type Quaternion struct { // W: The scalar component. W float64 `json:"w,omitempty"` diff --git a/privateca/v1beta1/privateca-gen.go b/privateca/v1beta1/privateca-gen.go index 20901a5ca3f..bdcf59096ae 100644 --- a/privateca/v1beta1/privateca-gen.go +++ b/privateca/v1beta1/privateca-gen.go @@ -503,9 +503,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -2037,9 +2035,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2057,8 +2054,8 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2097,9 +2094,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2134,9 +2130,8 @@ type PublicKey struct { // Key: Required. A public key. When this is specified in a request, the // padding and encoding can be any of the options described by the // respective 'KeyType' value. When this is generated by the service, it - // will always be an RFC 5280 - // [SubjectPublicKeyInfo](https://tools.ietf.org/html/rfc5280#section-4.1 - // ) structure containing an algorithm identifier and a key. + // will always be an RFC 5280 SubjectPublicKeyInfo structure containing + // an algorithm identifier and a key. Key string `json:"key,omitempty"` // Type: Optional. The type of public key. If specified, it must match @@ -2608,11 +2603,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2904,8 +2898,7 @@ func (s *SubordinateConfigChain) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3058,7 +3051,7 @@ func (c *ProjectsLocationsGetCall) Header() http.Header { func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3224,7 +3217,7 @@ func (c *ProjectsLocationsListCall) Header() http.Header { func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3400,7 +3393,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesActivateCall) Header() http.Head func (c *ProjectsLocationsCertificateAuthoritiesActivateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3566,7 +3559,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCreateCall) Header() http.Header func (c *ProjectsLocationsCertificateAuthoritiesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3716,7 +3709,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesDisableCall) Header() http.Heade func (c *ProjectsLocationsCertificateAuthoritiesDisableCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3856,7 +3849,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesEnableCall) Header() http.Header func (c *ProjectsLocationsCertificateAuthoritiesEnableCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4010,7 +4003,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesFetchCall) Header() http.Header func (c *ProjectsLocationsCertificateAuthoritiesFetchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4155,7 +4148,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesGetCall) Header() http.Header { func (c *ProjectsLocationsCertificateAuthoritiesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4271,9 +4264,7 @@ func (r *ProjectsLocationsCertificateAuthoritiesService) GetIamPolicy(resource s // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsCertificateAuthoritiesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsCertificateAuthoritiesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -4316,7 +4307,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesGetIamPolicyCall) Header() http. func (c *ProjectsLocationsCertificateAuthoritiesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4498,7 +4489,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesListCall) Header() http.Header { func (c *ProjectsLocationsCertificateAuthoritiesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4700,7 +4691,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesPatchCall) Header() http.Header func (c *ProjectsLocationsCertificateAuthoritiesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4852,7 +4843,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesRestoreCall) Header() http.Heade func (c *ProjectsLocationsCertificateAuthoritiesRestoreCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4992,7 +4983,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesScheduleDeleteCall) Header() htt func (c *ProjectsLocationsCertificateAuthoritiesScheduleDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5134,7 +5125,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesSetIamPolicyCall) Header() http. func (c *ProjectsLocationsCertificateAuthoritiesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5279,7 +5270,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesTestIamPermissionsCall) Header() func (c *ProjectsLocationsCertificateAuthoritiesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5428,7 +5419,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsGetCal func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5544,9 +5535,7 @@ func (r *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsServic // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -5589,7 +5578,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsGetIam func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5772,7 +5761,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsListCa func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5974,7 +5963,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsPatchC func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6127,7 +6116,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsSetIam func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6272,7 +6261,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsTestIa func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6440,7 +6429,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificatesCreateCall) Header() func (c *ProjectsLocationsCertificateAuthoritiesCertificatesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6599,7 +6588,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificatesGetCall) Header() ht func (c *ProjectsLocationsCertificateAuthoritiesCertificatesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6708,9 +6697,7 @@ func (r *ProjectsLocationsCertificateAuthoritiesCertificatesService) List(parent // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For details on supported -// filters and syntax, see [Certificates Filtering -// documentation](https://cloud.google.com/certificate-authority-service/ -// docs/sorting-filtering-certificates#filtering_support). +// filters and syntax, see Certificates Filtering documentation. func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) Filter(filter string) *ProjectsLocationsCertificateAuthoritiesCertificatesListCall { c.urlParams_.Set("filter", filter) return c @@ -6718,9 +6705,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) Filter(fil // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. For details on supported fields and syntax, -// see [Certificates Sorting -// documentation](https://cloud.google.com/certificate-authority-service/ -// docs/sorting-filtering-certificates#sorting_support). +// see Certificates Sorting documentation. func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) OrderBy(orderBy string) *ProjectsLocationsCertificateAuthoritiesCertificatesListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -6780,7 +6765,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) Header() h func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6982,7 +6967,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificatesPatchCall) Header() func (c *ProjectsLocationsCertificateAuthoritiesCertificatesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7133,7 +7118,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificatesRevokeCall) Header() func (c *ProjectsLocationsCertificateAuthoritiesCertificatesRevokeCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7282,7 +7267,7 @@ func (c *ProjectsLocationsOperationsCancelCall) Header() http.Header { func (c *ProjectsLocationsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7423,7 +7408,7 @@ func (c *ProjectsLocationsOperationsDeleteCall) Header() http.Header { func (c *ProjectsLocationsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7566,7 +7551,7 @@ func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7740,7 +7725,7 @@ func (c *ProjectsLocationsOperationsListCall) Header() http.Header { func (c *ProjectsLocationsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7921,7 +7906,7 @@ func (c *ProjectsLocationsReusableConfigsGetCall) Header() http.Header { func (c *ProjectsLocationsReusableConfigsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8037,9 +8022,7 @@ func (r *ProjectsLocationsReusableConfigsService) GetIamPolicy(resource string) // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsReusableConfigsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsReusableConfigsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -8082,7 +8065,7 @@ func (c *ProjectsLocationsReusableConfigsGetIamPolicyCall) Header() http.Header func (c *ProjectsLocationsReusableConfigsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8263,7 +8246,7 @@ func (c *ProjectsLocationsReusableConfigsListCall) Header() http.Header { func (c *ProjectsLocationsReusableConfigsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8442,7 +8425,7 @@ func (c *ProjectsLocationsReusableConfigsSetIamPolicyCall) Header() http.Header func (c *ProjectsLocationsReusableConfigsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8587,7 +8570,7 @@ func (c *ProjectsLocationsReusableConfigsTestIamPermissionsCall) Header() http.H func (c *ProjectsLocationsReusableConfigsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go index f8c770e1861..fcb550b39ea 100644 --- a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go +++ b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go @@ -1533,11 +1533,10 @@ func (s *SasPortalSignDeviceRequest) MarshalJSON() ([]byte, error) { // SasPortalStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type SasPortalStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/pubsub/v1/pubsub-gen.go b/pubsub/v1/pubsub-gen.go index 87d4a1fe953..c6db4c6767d 100644 --- a/pubsub/v1/pubsub-gen.go +++ b/pubsub/v1/pubsub-gen.go @@ -252,9 +252,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -817,10 +815,8 @@ func (s *ModifyPushConfigRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OidcToken: Contains information needed for generating an [OpenID -// Connect -// token](https://developers.google.com/identity/protocols/OpenIDConnect) -// . +// OidcToken: Contains information needed for generating an OpenID +// Connect token. type OidcToken struct { // Audience: Audience to be used when generating OIDC token. The // audience claim identifies the recipients that the JWT is intended @@ -831,9 +827,8 @@ type OidcToken struct { // specified, the Push endpoint URL will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: [Service account - // email](https://cloud.google.com/iam/docs/service-accounts) to be used - // for generating the OIDC token. The caller (for CreateSubscription, + // ServiceAccountEmail: Service account email to be used for generating + // the OIDC token. The caller (for CreateSubscription, // UpdateSubscription, and ModifyPushConfig RPCs) must have the // iam.serviceAccounts.actAs permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` @@ -872,9 +867,8 @@ func (s *OidcToken) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -892,8 +886,8 @@ func (s *OidcToken) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -928,9 +922,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1026,11 +1019,9 @@ func (s *PublishResponse) MarshalJSON() ([]byte, error) { // by subscribers. The message must contain either a non-empty data // field or at least one attribute. Note that client libraries represent // this object differently depending on the language. See the -// corresponding [client library -// documentation](https://cloud.google.com/pubsub/docs/reference/librarie -// s) for more information. See [quotas and limits] -// (https://cloud.google.com/pubsub/quotas) for more information about -// message limits. +// corresponding client library documentation for more information. See +// [quotas and limits] (https://cloud.google.com/pubsub/quotas) for more +// information about message limits. type PubsubMessage struct { // Attributes: Attributes for this message. If this field is empty, the // message must contain non-empty data. This can be used to filter @@ -1383,11 +1374,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Snapshot: A snapshot resource. Snapshots are used in -// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) -// operations, which allow you to manage message acknowledgments in -// bulk. That is, you can set the acknowledgment state of messages in an -// existing subscription to the state captured by a snapshot. +// Snapshot: A snapshot resource. Snapshots are used in Seek operations, +// which allow you to manage message acknowledgments in bulk. That is, +// you can set the acknowledgment state of messages in an existing +// subscription to the state captured by a snapshot. type Snapshot struct { // ExpireTime: The snapshot is guaranteed to exist up until this time. A // newly-created snapshot expires no later than 7 days from the time of @@ -1490,8 +1480,7 @@ type Subscription struct { // `expiration_policy.ttl` is 1 day. ExpirationPolicy *ExpirationPolicy `json:"expirationPolicy,omitempty"` - // Filter: An expression written in the Pub/Sub [filter - // language](https://cloud.google.com/pubsub/docs/filtering). If + // Filter: An expression written in the Pub/Sub filter language. If // non-empty, then only `PubsubMessage`s whose `attributes` field // matches the filter are delivered on this subscription. If empty, then // no messages are filtered out. @@ -1576,8 +1565,7 @@ func (s *Subscription) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1805,19 +1793,18 @@ type ProjectsSnapshotsCreateCall struct { } // Create: Creates a snapshot from the requested subscription. Snapshots -// are used in -// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) -// operations, which allow you to manage message acknowledgments in -// bulk. That is, you can set the acknowledgment state of messages in an -// existing subscription to the state captured by a snapshot. If the -// snapshot already exists, returns `ALREADY_EXISTS`. If the requested -// subscription doesn't exist, returns `NOT_FOUND`. If the backlog in -// the subscription is too old -- and the resulting snapshot would -// expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. -// See also the `Snapshot.expire_time` field. If the name is not -// provided in the request, the server will assign a random name for -// this snapshot on the same project as the subscription, conforming to -// the [resource name format] +// are used in Seek operations, which allow you to manage message +// acknowledgments in bulk. That is, you can set the acknowledgment +// state of messages in an existing subscription to the state captured +// by a snapshot. If the snapshot already exists, returns +// `ALREADY_EXISTS`. If the requested subscription doesn't exist, +// returns `NOT_FOUND`. If the backlog in the subscription is too old -- +// and the resulting snapshot would expire in less than 1 hour -- then +// `FAILED_PRECONDITION` is returned. See also the +// `Snapshot.expire_time` field. If the name is not provided in the +// request, the server will assign a random name for this snapshot on +// the same project as the subscription, conforming to the [resource +// name format] // (https://cloud.google.com/pubsub/docs/admin#resource_names). The // generated name is populated in the returned Snapshot object. Note // that for REST API requests, you must specify a name in the request. @@ -2265,9 +2252,7 @@ func (r *ProjectsSnapshotsService) GetIamPolicy(resource string) *ProjectsSnapsh // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsSnapshotsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsSnapshotsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -2417,11 +2402,10 @@ type ProjectsSnapshotsListCall struct { header_ http.Header } -// List: Lists the existing snapshots. Snapshots are used in [Seek]( -// https://cloud.google.com/pubsub/docs/replay-overview) operations, -// which allow you to manage message acknowledgments in bulk. That is, -// you can set the acknowledgment state of messages in an existing -// subscription to the state captured by a snapshot. +// List: Lists the existing snapshots. Snapshots are used in Seek +// operations, which allow you to manage message acknowledgments in +// bulk. That is, you can set the acknowledgment state of messages in an +// existing subscription to the state captured by a snapshot. func (r *ProjectsSnapshotsService) List(project string) *ProjectsSnapshotsListCall { c := &ProjectsSnapshotsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project @@ -3776,9 +3760,7 @@ func (r *ProjectsSubscriptionsService) GetIamPolicy(resource string) *ProjectsSu // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsSubscriptionsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsSubscriptionsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -5574,9 +5556,7 @@ func (r *ProjectsTopicsService) GetIamPolicy(resource string) *ProjectsTopicsGet // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsTopicsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsTopicsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -6493,10 +6473,10 @@ type ProjectsTopicsSnapshotsListCall struct { } // List: Lists the names of the snapshots on this topic. Snapshots are -// used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) -// operations, which allow you to manage message acknowledgments in -// bulk. That is, you can set the acknowledgment state of messages in an -// existing subscription to the state captured by a snapshot. +// used in Seek operations, which allow you to manage message +// acknowledgments in bulk. That is, you can set the acknowledgment +// state of messages in an existing subscription to the state captured +// by a snapshot. func (r *ProjectsTopicsSnapshotsService) List(topic string) *ProjectsTopicsSnapshotsListCall { c := &ProjectsTopicsSnapshotsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.topic = topic diff --git a/pubsub/v1beta2/pubsub-gen.go b/pubsub/v1beta2/pubsub-gen.go index 5fbed1e6b51..120ee795b57 100644 --- a/pubsub/v1beta2/pubsub-gen.go +++ b/pubsub/v1beta2/pubsub-gen.go @@ -228,9 +228,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -551,10 +549,8 @@ func (s *ModifyPushConfigRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OidcToken: Contains information needed for generating an [OpenID -// Connect -// token](https://developers.google.com/identity/protocols/OpenIDConnect) -// . +// OidcToken: Contains information needed for generating an OpenID +// Connect token. type OidcToken struct { // Audience: Audience to be used when generating OIDC token. The // audience claim identifies the recipients that the JWT is intended @@ -565,9 +561,8 @@ type OidcToken struct { // specified, the Push endpoint URL will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: [Service account - // email](https://cloud.google.com/iam/docs/service-accounts) to be used - // for generating the OIDC token. The caller (for CreateSubscription, + // ServiceAccountEmail: Service account email to be used for generating + // the OIDC token. The caller (for CreateSubscription, // UpdateSubscription, and ModifyPushConfig RPCs) must have the // iam.serviceAccounts.actAs permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` @@ -606,9 +601,8 @@ func (s *OidcToken) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -626,8 +620,8 @@ func (s *OidcToken) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -662,9 +656,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -764,7 +757,7 @@ type PubsubMessage struct { Attributes map[string]string `json:"attributes,omitempty"` // Data: The message payload. For JSON requests, the value of this field - // must be [base64-encoded](https://tools.ietf.org/html/rfc4648). + // must be base64-encoded. Data string `json:"data,omitempty"` // MessageId: ID of this message, assigned by the server when the @@ -1061,8 +1054,7 @@ func (s *Subscription) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1759,9 +1751,7 @@ func (r *ProjectsSubscriptionsService) GetIamPolicy(resource string) *ProjectsSu // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsSubscriptionsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsSubscriptionsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -3267,9 +3257,7 @@ func (r *ProjectsTopicsService) GetIamPolicy(resource string) *ProjectsTopicsGet // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsTopicsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsTopicsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/realtimebidding/v1/realtimebidding-gen.go b/realtimebidding/v1/realtimebidding-gen.go index 751fffd098d..9f8bb680378 100644 --- a/realtimebidding/v1/realtimebidding-gen.go +++ b/realtimebidding/v1/realtimebidding-gen.go @@ -496,11 +496,10 @@ type Creative struct { // DeclaredAttributes: All declared attributes for the ads that may be // shown from this creative. Can be used to filter the response of the - // creatives.list method. If the `excluded_attribute` field of a [bid - // request](https://developers.google.com/authorized-buyers/rtb/downloads - // /realtime-bidding-proto") contains one of the attributes that were - // declared or detected for a given creative, and a bid is submitted - // with that creative, the bid will be filtered before the auction. + // creatives.list method. If the `excluded_attribute` field of a bid + // request contains one of the attributes that were declared or detected + // for a given creative, and a bid is submitted with that creative, the + // bid will be filtered before the auction. // // Possible values: // "ATTRIBUTE_UNSPECIFIED" - Do not use. This is a placeholder value @@ -695,11 +694,10 @@ type CreativeServingDecision struct { // DetectedAttributes: Publisher-excludable attributes that were // detected for this creative. Can be used to filter the response of the - // creatives.list method. If the `excluded_attribute` field of a [bid - // request](https://developers.google.com/authorized-buyers/rtb/downloads - // /realtime-bidding-proto) contains one of the attributes that were - // declared or detected for a given creative, and a bid is submitted - // with that creative, the bid will be filtered before the auction. + // creatives.list method. If the `excluded_attribute` field of a bid + // request contains one of the attributes that were declared or detected + // for a given creative, and a bid is submitted with that creative, the + // bid will be filtered before the auction. // // Possible values: // "ATTRIBUTE_UNSPECIFIED" - Do not use. This is a placeholder value @@ -794,12 +792,10 @@ type CreativeServingDecision struct { // detected to be used by this creative. See // https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for // possible values. Can be used to filter the response of the - // creatives.list method. If the `allowed_vendor_type` field of a [bid - // request](https://developers.google.com/authorized-buyers/rtb/downloads - // /realtime-bidding-proto) does not contain one of the vendor type IDs - // that were declared or detected for a given creative, and a bid is - // submitted with that creative, the bid will be filtered before the - // auction. + // creatives.list method. If the `allowed_vendor_type` field of a bid + // request does not contain one of the vendor type IDs that were + // declared or detected for a given creative, and a bid is submitted + // with that creative, the bid will be filtered before the auction. DetectedVendorIds []int64 `json:"detectedVendorIds,omitempty"` // LastStatusUpdate: The last time the creative status was updated. Can @@ -1174,8 +1170,7 @@ type Empty struct { type GetRemarketingTagResponse struct { // Snippet: A HTML tag that can be placed on the advertiser's page to // add users to a user list. For more information and code samples on - // using snippet on your website refer to [Tag your site for - // remarketing]( https://support.google.com/google-ads/answer/2476688). + // using snippet on your website refer to Tag your site for remarketing. Snippet string `json:"snippet,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1935,15 +1930,10 @@ type PretargetingConfig struct { // sent only if the publisher is listed in the targeting dimension) or // negatively (bid requests will be sent only if the publisher is not // listed in the targeting dimension). A maximum of 10,000 publisher IDs - // can be targeted. Publisher IDs are found in - // [ads.txt](https://iabtechlab.com/ads-txt/) / - // [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid - // requests in the `BidRequest.publisher_id` field on the [Google RTB - // protocol](https://developers.google.com/authorized-buyers/rtb/download - // s/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / - // `BidRequest.app.publisher.id` field on the [OpenRTB - // protocol](https://developers.google.com/authorized-buyers/rtb/download - // s/openrtb-adx-proto). + // can be targeted. Publisher IDs are found in ads.txt / app-ads.txt and + // in bid requests in the `BidRequest.publisher_id` field on the Google + // RTB protocol or the `BidRequest.site.publisher.id` / + // `BidRequest.app.publisher.id` field on the OpenRTB protocol. PublisherTargeting *StringTargetingDimension `json:"publisherTargeting,omitempty"` // State: Output only. The state of this pretargeting configuration. diff --git a/recommendationengine/v1beta1/recommendationengine-gen.go b/recommendationengine/v1beta1/recommendationengine-gen.go index 190ba67eaae..f1a6643f3f2 100644 --- a/recommendationengine/v1beta1/recommendationengine-gen.go +++ b/recommendationengine/v1beta1/recommendationengine-gen.go @@ -547,8 +547,7 @@ type GoogleCloudRecommendationengineV1beta1CatalogItem struct { // ItemGroupId: Optional. Variant group identifier for prediction // results. UTF-8 encoded string with a length limit of 128 bytes. This - // field must be enabled before it can be used. [Learn - // more](/recommendations-ai/docs/catalog#item-group-id). + // field must be enabled before it can be used. Learn more. ItemGroupId string `json:"itemGroupId,omitempty"` // LanguageCode: Optional. Deprecated. The model automatically detects @@ -895,9 +894,8 @@ type GoogleCloudRecommendationengineV1beta1GcsSource struct { // path (for example, gs://bucket/directory/object.json) or a pattern // matching one or more files, such as gs://bucket/directory/*.json. A // request can contain at most 100 files, and each file can be up to 2 - // GB. See [Importing catalog - // information](/recommendations-ai/docs/upload-catalog) for the - // expected file format and setup instructions. + // GB. See Importing catalog information for the expected file format + // and setup instructions. InputUris []string `json:"inputUris,omitempty"` // JsonSchema: Optional. The schema to use when parsing the data from @@ -2531,11 +2529,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4222,8 +4219,7 @@ type ProjectsLocationsCatalogsEventStoresPlacementsPredictCall struct { // Predict: Makes a recommendation prediction. If using API Key based // authentication, the API Key must be registered using the -// PredictionApiKeyRegistry service. [Learn -// more](/recommendations-ai/docs/setting-up#register-key). +// PredictionApiKeyRegistry service. Learn more. func (r *ProjectsLocationsCatalogsEventStoresPlacementsService) Predict(name string, googlecloudrecommendationenginev1beta1predictrequest *GoogleCloudRecommendationengineV1beta1PredictRequest) *ProjectsLocationsCatalogsEventStoresPlacementsPredictCall { c := &ProjectsLocationsCatalogsEventStoresPlacementsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/redis/v1/redis-gen.go b/redis/v1/redis-gen.go index 39b2fcfd69d..256e240cb0c 100644 --- a/redis/v1/redis-gen.go +++ b/redis/v1/redis-gen.go @@ -479,9 +479,8 @@ type Instance struct { AuthEnabled bool `json:"authEnabled,omitempty"` // AuthorizedNetwork: Optional. The full name of the Google Compute - // Engine [network](https://cloud.google.com/vpc/docs/vpc) to which the - // instance is connected. If left unspecified, the `default` network - // will be used. + // Engine network to which the instance is connected. If left + // unspecified, the `default` network will be used. AuthorizedNetwork string `json:"authorizedNetwork,omitempty"` // ConnectMode: Optional. The network connect mode of the Redis @@ -949,11 +948,10 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -997,13 +995,11 @@ type TlsCertificate struct { Cert string `json:"cert,omitempty"` // CreateTime: Output only. The time when the certificate was created in - // [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example - // `2020-05-18T00:00:00.094Z`. + // RFC 3339 format, for example `2020-05-18T00:00:00.094Z`. CreateTime string `json:"createTime,omitempty"` - // ExpireTime: Output only. The time when the certificate expires in - // [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example - // `2020-05-18T00:00:00.094Z`. + // ExpireTime: Output only. The time when the certificate expires in RFC + // 3339 format, for example `2020-05-18T00:00:00.094Z`. ExpireTime string `json:"expireTime,omitempty"` // SerialNumber: Serial number, as extracted from the certificate. @@ -1424,13 +1420,13 @@ type ProjectsLocationsInstancesCreateCall struct { // Create: Creates a Redis instance based on the specified tier and // memory size. By default, the instance is accessible from the -// project's [default network](https://cloud.google.com/vpc/docs/vpc). -// The creation is executed asynchronously and callers may check the -// returned operation to track its progress. Once the operation is -// completed the Redis instance will be fully functional. Completed -// longrunning.Operation will contain the new instance object in the -// response field. The returned operation is automatically deleted after -// a few hours, so there is no need to call DeleteOperation. +// project's default network. The creation is executed asynchronously +// and callers may check the returned operation to track its progress. +// Once the operation is completed the Redis instance will be fully +// functional. Completed longrunning.Operation will contain the new +// instance object in the response field. The returned operation is +// automatically deleted after a few hours, so there is no need to call +// DeleteOperation. func (r *ProjectsLocationsInstancesService) Create(parent string, instance *Instance) *ProjectsLocationsInstancesCreateCall { c := &ProjectsLocationsInstancesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/redis/v1beta1/redis-gen.go b/redis/v1beta1/redis-gen.go index 128d3f0c908..1de8cd9279d 100644 --- a/redis/v1beta1/redis-gen.go +++ b/redis/v1beta1/redis-gen.go @@ -484,9 +484,8 @@ type Instance struct { AuthEnabled bool `json:"authEnabled,omitempty"` // AuthorizedNetwork: Optional. The full name of the Google Compute - // Engine [network](https://cloud.google.com/vpc/docs/vpc) to which the - // instance is connected. If left unspecified, the `default` network - // will be used. + // Engine network to which the instance is connected. If left + // unspecified, the `default` network will be used. AuthorizedNetwork string `json:"authorizedNetwork,omitempty"` // ConnectMode: Optional. The network connect mode of the Redis @@ -954,11 +953,10 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1002,13 +1000,11 @@ type TlsCertificate struct { Cert string `json:"cert,omitempty"` // CreateTime: Output only. The time when the certificate was created in - // [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example - // `2020-05-18T00:00:00.094Z`. + // RFC 3339 format, for example `2020-05-18T00:00:00.094Z`. CreateTime string `json:"createTime,omitempty"` - // ExpireTime: Output only. The time when the certificate expires in - // [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example - // `2020-05-18T00:00:00.094Z`. + // ExpireTime: Output only. The time when the certificate expires in RFC + // 3339 format, for example `2020-05-18T00:00:00.094Z`. ExpireTime string `json:"expireTime,omitempty"` // SerialNumber: Serial number, as extracted from the certificate. @@ -1429,13 +1425,13 @@ type ProjectsLocationsInstancesCreateCall struct { // Create: Creates a Redis instance based on the specified tier and // memory size. By default, the instance is accessible from the -// project's [default network](https://cloud.google.com/vpc/docs/vpc). -// The creation is executed asynchronously and callers may check the -// returned operation to track its progress. Once the operation is -// completed the Redis instance will be fully functional. Completed -// longrunning.Operation will contain the new instance object in the -// response field. The returned operation is automatically deleted after -// a few hours, so there is no need to call DeleteOperation. +// project's default network. The creation is executed asynchronously +// and callers may check the returned operation to track its progress. +// Once the operation is completed the Redis instance will be fully +// functional. Completed longrunning.Operation will contain the new +// instance object in the response field. The returned operation is +// automatically deleted after a few hours, so there is no need to call +// DeleteOperation. func (r *ProjectsLocationsInstancesService) Create(parent string, instance *Instance) *ProjectsLocationsInstancesCreateCall { c := &ProjectsLocationsInstancesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/remotebuildexecution/v1/remotebuildexecution-gen.go b/remotebuildexecution/v1/remotebuildexecution-gen.go index 17ae83bbdf4..b776f43f4f9 100644 --- a/remotebuildexecution/v1/remotebuildexecution-gen.go +++ b/remotebuildexecution/v1/remotebuildexecution-gen.go @@ -2384,9 +2384,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { // See https://cloud.google.com/compute/docs/disks/ DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"` - // DiskType: Required. Disk Type to use for the worker. See [Storage - // options](https://cloud.google.com/compute/docs/disks/#introduction). - // Currently only `pd-standard` and `pd-ssd` are supported. + // DiskType: Required. Disk Type to use for the worker. See Storage + // options. Currently only `pd-standard` and `pd-ssd` are supported. DiskType string `json:"diskType,omitempty"` // Labels: Labels associated with the workers. Label keys and values can @@ -2408,8 +2407,7 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { MaxConcurrentActions int64 `json:"maxConcurrentActions,omitempty,string"` // MinCpuPlatform: Minimum CPU platform to use when creating the worker. - // See [CPU - // Platforms](https://cloud.google.com/compute/docs/cpu-platforms). + // See CPU Platforms. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NetworkAccess: Determines the type of network access granted to @@ -2422,8 +2420,7 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { // Reserved: Determines whether the worker is reserved (equivalent to a // Compute Engine on-demand VM and therefore won't be preempted). See - // [Preemptible VMs](https://cloud.google.com/preemptible-vms/) for more - // details. + // Preemptible VMs for more details. Reserved bool `json:"reserved,omitempty"` // SoleTenantNodeType: The node type name to be used for sole-tenant @@ -3248,11 +3245,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/remotebuildexecution/v1alpha/remotebuildexecution-gen.go b/remotebuildexecution/v1alpha/remotebuildexecution-gen.go index 998adf276b3..036320037df 100644 --- a/remotebuildexecution/v1alpha/remotebuildexecution-gen.go +++ b/remotebuildexecution/v1alpha/remotebuildexecution-gen.go @@ -2364,9 +2364,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { // See https://cloud.google.com/compute/docs/disks/ DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"` - // DiskType: Required. Disk Type to use for the worker. See [Storage - // options](https://cloud.google.com/compute/docs/disks/#introduction). - // Currently only `pd-standard` and `pd-ssd` are supported. + // DiskType: Required. Disk Type to use for the worker. See Storage + // options. Currently only `pd-standard` and `pd-ssd` are supported. DiskType string `json:"diskType,omitempty"` // Labels: Labels associated with the workers. Label keys and values can @@ -2388,8 +2387,7 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { MaxConcurrentActions int64 `json:"maxConcurrentActions,omitempty,string"` // MinCpuPlatform: Minimum CPU platform to use when creating the worker. - // See [CPU - // Platforms](https://cloud.google.com/compute/docs/cpu-platforms). + // See CPU Platforms. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NetworkAccess: Determines the type of network access granted to @@ -2402,8 +2400,7 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { // Reserved: Determines whether the worker is reserved (equivalent to a // Compute Engine on-demand VM and therefore won't be preempted). See - // [Preemptible VMs](https://cloud.google.com/preemptible-vms/) for more - // details. + // Preemptible VMs for more details. Reserved bool `json:"reserved,omitempty"` // SoleTenantNodeType: The node type name to be used for sole-tenant @@ -3178,11 +3175,10 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/remotebuildexecution/v2/remotebuildexecution-gen.go b/remotebuildexecution/v2/remotebuildexecution-gen.go index e732bf72c82..48d08028be8 100644 --- a/remotebuildexecution/v2/remotebuildexecution-gen.go +++ b/remotebuildexecution/v2/remotebuildexecution-gen.go @@ -3126,9 +3126,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { // See https://cloud.google.com/compute/docs/disks/ DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"` - // DiskType: Required. Disk Type to use for the worker. See [Storage - // options](https://cloud.google.com/compute/docs/disks/#introduction). - // Currently only `pd-standard` and `pd-ssd` are supported. + // DiskType: Required. Disk Type to use for the worker. See Storage + // options. Currently only `pd-standard` and `pd-ssd` are supported. DiskType string `json:"diskType,omitempty"` // Labels: Labels associated with the workers. Label keys and values can @@ -3150,8 +3149,7 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { MaxConcurrentActions int64 `json:"maxConcurrentActions,omitempty,string"` // MinCpuPlatform: Minimum CPU platform to use when creating the worker. - // See [CPU - // Platforms](https://cloud.google.com/compute/docs/cpu-platforms). + // See CPU Platforms. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NetworkAccess: Determines the type of network access granted to @@ -3164,8 +3162,7 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { // Reserved: Determines whether the worker is reserved (equivalent to a // Compute Engine on-demand VM and therefore won't be preempted). See - // [Preemptible VMs](https://cloud.google.com/preemptible-vms/) for more - // details. + // Preemptible VMs for more details. Reserved bool `json:"reserved,omitempty"` // SoleTenantNodeType: The node type name to be used for sole-tenant @@ -3936,11 +3933,10 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/run/v1/run-gen.go b/run/v1/run-gen.go index cd7b0b9a77e..ebcb6311218 100644 --- a/run/v1/run-gen.go +++ b/run/v1/run-gen.go @@ -450,8 +450,7 @@ func (s *AuditLogConfig) MarshalJSON() ([]byte, error) { // AuthorizedDomain: A domain that a user has been authorized to // administer. To authorize use of a domain, verify ownership via -// [Webmaster -// Central](https://www.google.com/webmasters/verification/home). +// Webmaster Central. type AuthorizedDomain struct { // Id: Relative name of the domain authorized for use. Example: // `example.com`. @@ -493,9 +492,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -2204,9 +2201,8 @@ func (s *OwnerReference) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2224,8 +2220,8 @@ func (s *OwnerReference) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2264,9 +2260,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -3407,8 +3402,7 @@ func (s *TCPSocketAction) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -9685,9 +9679,7 @@ func (r *ProjectsLocationsServicesService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsServicesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsServicesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/run/v1alpha1/run-gen.go b/run/v1alpha1/run-gen.go index 3e14c88af58..c5b208fca79 100644 --- a/run/v1alpha1/run-gen.go +++ b/run/v1alpha1/run-gen.go @@ -561,8 +561,7 @@ func (s *AuditLogConfig) MarshalJSON() ([]byte, error) { // AuthorizedDomain: A domain that a user has been authorized to // administer. To authorize use of a domain, verify ownership via -// [Webmaster -// Central](https://www.google.com/webmasters/verification/home). +// Webmaster Central. type AuthorizedDomain struct { // Id: Relative name of the domain authorized for use. Example: // `example.com`. @@ -603,9 +602,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -3560,9 +3557,8 @@ func (s *OwnerReference) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -3580,8 +3576,8 @@ func (s *OwnerReference) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -3620,9 +3616,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -5024,8 +5019,7 @@ func (s *TCPSocketAction) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -18205,9 +18199,7 @@ func (r *ProjectsLocationsServicesService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsLocationsServicesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsServicesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/runtimeconfig/v1/runtimeconfig-gen.go b/runtimeconfig/v1/runtimeconfig-gen.go index 1c68ea9ee5c..978e3d810d1 100644 --- a/runtimeconfig/v1/runtimeconfig-gen.go +++ b/runtimeconfig/v1/runtimeconfig-gen.go @@ -266,11 +266,10 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/runtimeconfig/v1beta1/runtimeconfig-gen.go b/runtimeconfig/v1beta1/runtimeconfig-gen.go index 175cfb116d2..1f2433e32f8 100644 --- a/runtimeconfig/v1beta1/runtimeconfig-gen.go +++ b/runtimeconfig/v1beta1/runtimeconfig-gen.go @@ -208,9 +208,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -616,9 +614,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -636,8 +633,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -672,9 +669,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -782,11 +778,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -829,8 +824,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -905,10 +899,9 @@ type Variable struct { // element separators and are not part of the `[VARIABLE_NAME]` itself, // so `[VARIABLE_NAME]` must contain at least one non-slash character. // Multiple slashes are coalesced into single slash character. Each path - // segment should match - // [0-9A-Za-z](?:[_.A-Za-z0-9-]{0,62}[_.A-Za-z0-9])? regular expression. - // The length of a `[VARIABLE_NAME]` must be less than 256 characters. - // Once you create a variable, you cannot change the variable name. + // segment should match 0-9A-Za-z? regular expression. The length of a + // `[VARIABLE_NAME]` must be less than 256 characters. Once you create a + // variable, you cannot change the variable name. Name string `json:"name,omitempty"` // State: Output only. The current state of the variable. The variable @@ -975,9 +968,7 @@ func (s *Variable) MarshalJSON() ([]byte, error) { // in. Afterwards, your application runs some arbitrary code after the // condition has been met and the waiter returns successfully. Once // created, a Waiter resource is immutable. To learn more about using -// waiters, read the [Creating a -// Waiter](/deployment-manager/runtime-configurator/creating-a-waiter) -// documentation. +// waiters, read the Creating a Waiter documentation. type Waiter struct { // CreateTime: Output only. The instant at which this Waiter resource // was created. Adding the value of `timeout` to this instant yields the @@ -1545,9 +1536,7 @@ func (r *ProjectsConfigsService) GetIamPolicy(resource string) *ProjectsConfigsG // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsConfigsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsConfigsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -2617,10 +2606,8 @@ type ProjectsConfigsVariablesCreateCall struct { // Create: Creates a variable within the given configuration. You cannot // create a variable with a name that is a prefix of an existing // variable name, or a name that has an existing variable name as a -// prefix. To learn more about creating a variable, read the [Setting -// and Getting -// Data](/deployment-manager/runtime-configurator/set-and-get-variables) -// documentation. +// prefix. To learn more about creating a variable, read the Setting and +// Getting Data documentation. func (r *ProjectsConfigsVariablesService) Create(parent string, variable *Variable) *ProjectsConfigsVariablesCreateCall { c := &ProjectsConfigsVariablesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -3589,9 +3576,7 @@ type ProjectsConfigsVariablesWatchCall struct { // a larger value than internal timeout (60 seconds), the current // variable value is returned and the `variableState` will be // `VARIABLE_STATE_UNSPECIFIED`. To learn more about creating a watcher, -// read the [Watching a Variable for -// Changes](/deployment-manager/runtime-configurator/watching-a-variable) -// documentation. +// read the Watching a Variable for Changes documentation. func (r *ProjectsConfigsVariablesService) Watch(name string, watchvariablerequest *WatchVariableRequest) *ProjectsConfigsVariablesWatchCall { c := &ProjectsConfigsVariablesWatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/sasportal/v1alpha1/sasportal-gen.go b/sasportal/v1alpha1/sasportal-gen.go index 31a6ca6b35f..c11d33908d9 100644 --- a/sasportal/v1alpha1/sasportal-gen.go +++ b/sasportal/v1alpha1/sasportal-gen.go @@ -1533,11 +1533,10 @@ func (s *SasPortalSignDeviceRequest) MarshalJSON() ([]byte, error) { // SasPortalStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type SasPortalStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/script/v1/script-gen.go b/script/v1/script-gen.go index 38c153f5fb2..f557339fb60 100644 --- a/script/v1/script-gen.go +++ b/script/v1/script-gen.go @@ -573,14 +573,11 @@ type ExecutionRequest struct { // SessionState: *Deprecated*. For use with Android add-ons only. An ID // that represents the user's current session in the Android app for - // Google Docs or Sheets, included as extra data in the - // [Intent](https://developer.android.com/guide/components/intents-filter - // s.html) that launches the add-on. When an Android add-on is run with - // a session state, it gains the privileges of a - // [bound](https://developers.google.com/apps-script/guides/bound) - // script—that is, it can access information like the user's current - // cursor position (in Docs) or selected cell (in Sheets). To retrieve - // the state, call + // Google Docs or Sheets, included as extra data in the Intent that + // launches the add-on. When an Android add-on is run with a session + // state, it gains the privileges of a bound script—that is, it can + // access information like the user's current cursor position (in Docs) + // or selected cell (in Sheets). To retrieve the state, call // `Intent.getStringExtra("com.google.android.apps.docs.addons.SessionSta // te")`. Optional. SessionState string `json:"sessionState,omitempty"` @@ -1338,11 +1335,10 @@ func (s *MetricsValue) MarshalJSON() ([]byte, error) { // Operation: A representation of an execution of an Apps Script // function started with run. The execution response does not arrive // until the function finishes executing. The maximum execution runtime -// is listed in the [Apps Script quotas -// guide](/apps-script/guides/services/quotas#current_limitations). -// After execution has started, it can have one of four outcomes: - If -// the script function returns successfully, the response field contains -// an ExecutionResponse object with the function's return value in the +// is listed in the Apps Script quotas guide. After execution has +// started, it can have one of four outcomes: - If the script function +// returns successfully, the response field contains an +// ExecutionResponse object with the function's return value in the // object's `result` field. - If the script function (or Apps Script // itself) throws an exception, the error field contains a Status // object. The `Status` object's `details` field contains an array with @@ -4537,12 +4533,11 @@ type ScriptsRunCall struct { // must be deployed for use with the Apps Script API and the calling // application must share the same Cloud Platform project. This method // requires authorization with an OAuth 2.0 token that includes at least -// one of the scopes listed in the -// [Authorization](#authorization-scopes) section; script projects that -// do not require authorization cannot be executed through this API. To -// find the correct scopes to include in the authentication token, open -// the project in the script editor, then select **File > Project -// properties** and click the **Scopes** tab. The error `403, +// one of the scopes listed in the Authorization section; script +// projects that do not require authorization cannot be executed through +// this API. To find the correct scopes to include in the authentication +// token, open the project in the script editor, then select **File > +// Project properties** and click the **Scopes** tab. The error `403, // PERMISSION_DENIED: The caller does not have permission` indicates // that the Cloud Platform project used to authorize the request is not // the same as the one used by the script. diff --git a/searchconsole/v1/searchconsole-gen.go b/searchconsole/v1/searchconsole-gen.go index ad230addce1..3e74b467be4 100644 --- a/searchconsole/v1/searchconsole-gen.go +++ b/searchconsole/v1/searchconsole-gen.go @@ -719,7 +719,7 @@ func (s *SearchAnalyticsQueryResponse) MarshalJSON() ([]byte, error) { // SitemapsListResponse: List of sitemaps. type SitemapsListResponse struct { // Sitemap: Contains detailed information about a specific URL submitted - // as a [sitemap](https://support.google.com/webmasters/answer/156184). + // as a sitemap. Sitemap []*WmxSitemap `json:"sitemap,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -752,8 +752,8 @@ func (s *SitemapsListResponse) MarshalJSON() ([]byte, error) { // SitesListResponse: List of sites with access level information. type SitesListResponse struct { // SiteEntry: Contains permission level information about a Search - // Console site. For more information, see [Permissions in Search - // Console](https://support.google.com/webmasters/answer/2451999). + // Console site. For more information, see Permissions in Search + // Console. SiteEntry []*WmxSite `json:"siteEntry,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -828,8 +828,7 @@ func (s *TestStatus) MarshalJSON() ([]byte, error) { } // WmxSite: Contains permission level information about a Search Console -// site. For more information, see [Permissions in Search -// Console](https://support.google.com/webmasters/answer/2451999). +// site. For more information, see Permissions in Search Console. type WmxSite struct { // PermissionLevel: The user's permission level for the site. // @@ -876,8 +875,7 @@ func (s *WmxSite) MarshalJSON() ([]byte, error) { } // WmxSitemap: Contains detailed information about a specific URL -// submitted as a -// [sitemap](https://support.google.com/webmasters/answer/156184). +// submitted as a sitemap. type WmxSitemap struct { // Contents: The various content types in the sitemap. Contents []*WmxSitemapContent `json:"contents,omitempty"` @@ -1417,9 +1415,9 @@ type SitemapsListCall struct { header_ http.Header } -// List: Lists the [sitemaps-entries](/webmaster-tools/v3/sitemaps) -// submitted for this site, or included in the sitemap index file (if -// `sitemapIndex` is specified in the request). +// List: Lists the sitemaps-entries submitted for this site, or +// included in the sitemap index file (if `sitemapIndex` is specified in +// the request). func (r *SitemapsService) List(siteUrl string) *SitemapsListCall { c := &SitemapsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.siteUrl = siteUrl diff --git a/secretmanager/v1/secretmanager-gen.go b/secretmanager/v1/secretmanager-gen.go index ee581f4e0c0..f25fab8b27a 100644 --- a/secretmanager/v1/secretmanager-gen.go +++ b/secretmanager/v1/secretmanager-gen.go @@ -421,9 +421,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -823,9 +821,8 @@ func (s *Location) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -843,8 +840,8 @@ func (s *Location) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -883,9 +880,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1243,8 +1239,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2309,9 +2304,7 @@ func (r *ProjectsSecretsService) GetIamPolicy(resource string) *ProjectsSecretsG // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsSecretsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsSecretsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/secretmanager/v1beta1/secretmanager-gen.go b/secretmanager/v1beta1/secretmanager-gen.go index a15ac020d8c..a1cc08fc7b1 100644 --- a/secretmanager/v1beta1/secretmanager-gen.go +++ b/secretmanager/v1beta1/secretmanager-gen.go @@ -356,9 +356,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -691,9 +689,8 @@ func (s *Location) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -711,8 +708,8 @@ func (s *Location) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -751,9 +748,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1026,8 +1022,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2061,9 +2056,7 @@ func (r *ProjectsSecretsService) GetIamPolicy(resource string) *ProjectsSecretsG // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsSecretsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsSecretsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index e9f8af62071..35a9ae97946 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -513,9 +513,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -820,9 +818,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2151,9 +2147,8 @@ func (s *OrganizationSettings) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2171,8 +2166,8 @@ func (s *OrganizationSettings) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2211,9 +2206,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2542,11 +2536,10 @@ func (s *Source) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2629,8 +2622,7 @@ func (s *StreamingConfig) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index bd3d27eb46e..9079600561d 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -395,9 +395,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -703,9 +701,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1933,9 +1929,8 @@ func (s *OrganizationSettings) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1953,8 +1948,8 @@ func (s *OrganizationSettings) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1993,9 +1988,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2255,11 +2249,10 @@ func (s *Source) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2302,8 +2295,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go index a58eed0d251..23c4d07a462 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go @@ -242,15 +242,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses [semantic versioning](http://semver.org) - // where the major version number indicates a breaking change and the - // minor version an additive, non-breaking change. Both version numbers - // are signals to users what to expect from different versions, and - // should be carefully chosen based on the product plan. The major - // version is also reflected in the package name of the interface, which - // must end in `v`, as in `google.feature.v1`. For major versions 0 and - // 1, the suffix can be omitted. Zero major versions must only be used - // for experimental, non-GA interfaces. + // The versioning schema uses semantic versioning where the major + // version number indicates a breaking change and the minor version an + // additive, non-breaking change. Both version numbers are signals to + // users what to expect from different versions, and should be carefully + // chosen based on the product plan. The major version is also reflected + // in the package name of the interface, which must end in `v`, as in + // `google.feature.v1`. For major versions 0 and 1, the suffix can be + // omitted. Zero major versions must only be used for experimental, + // non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -352,15 +352,11 @@ func (s *AttachTenantProjectRequest) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthProvider struct { - // Audiences: The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // JWTs with audiences: - + // Audiences: The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, JWTs with audiences: - // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs @@ -384,14 +380,10 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html# - // ProviderMetadata). Optional if the key set document: - can be - // retrieved from [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html) - // of the issuer. - can be inferred from the email domain of the issuer - // (e.g. a Google service account). Example: - // https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery. Optional if the key set document: - + // can be retrieved from OpenID Discovery of the issuer. - can be + // inferred from the email domain of the issuer (e.g. a Google service + // account). Example: https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -429,19 +421,16 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // only JWTs with audience "https://Service_name/API_name" will be - // accepted. For example, if no audiences are in the setting, - // LibraryService API will only accept JWTs with the following audience + // components. The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, only JWTs with audience + // "https://Service_name/API_name" will be accepted. For example, if no + // audiences are in the setting, LibraryService API will only accept + // JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1283,21 +1272,19 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing - // [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), - // aka cross-domain traffic, would allow the backends served from this - // endpoint to receive and respond to HTTP OPTIONS requests. The - // response will be used by the browser to determine whether the - // subsequent cross-origin request is allowed to proceed. + // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the + // backends served from this endpoint to receive and respond to HTTP + // OPTIONS requests. The response will be used by the browser to + // determine whether the subsequent cross-origin request is allowed to + // proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this [API - // Endpoint](https://cloud.google.com/apis/design/glossary). It should - // be either a valid IPv4 address or a fully-qualified domain name. For + // frontend that will handle requests to this API Endpoint. It should be + // either a valid IPv4 address or a fully-qualified domain name. For // example, "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` @@ -1534,33 +1521,29 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including [Google -// APIs](https://github.com/googleapis/googleapis), [Cloud -// Endpoints](https://cloud.google.com/endpoints), [gRPC -// Gateway](https://github.com/grpc-ecosystem/grpc-gateway), and -// [Envoy](https://github.com/envoyproxy/envoy) proxy support this -// feature and use it for large scale production services. `HttpRule` -// defines the schema of the gRPC/REST mapping. The mapping specifies -// how different portions of the gRPC request message are mapped to the -// URL path, URL query parameters, and HTTP request body. It also -// controls how the gRPC response message is mapped to the HTTP response -// body. `HttpRule` is typically specified as an `google.api.http` -// annotation on the gRPC method. Each mapping specifies a URL path -// template and an HTTP method. The path template may refer to one or -// more fields in the gRPC request message, as long as each field is a -// non-repeated field with a primitive (non-message) type. The path -// template controls how fields of the request message are mapped to the -// URL path. Example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option -// (google.api.http) = { get: "/v1/{name=messages/*}" }; } } message -// GetMessageRequest { string name = 1; // Mapped to URL path. } message -// Message { string text = 1; // The resource content. } This enables an -// HTTP REST to gRPC mapping as below: HTTP | gRPC -----|----- `GET -// /v1/messages/123456` | `GetMessage(name: "messages/123456")` Any -// fields in the request message which are not bound by the path -// template automatically become HTTP query parameters if there is no -// HTTP request body. For example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option +// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud +// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use +// it for large scale production services. `HttpRule` defines the schema +// of the gRPC/REST mapping. The mapping specifies how different +// portions of the gRPC request message are mapped to the URL path, URL +// query parameters, and HTTP request body. It also controls how the +// gRPC response message is mapped to the HTTP response body. `HttpRule` +// is typically specified as an `google.api.http` annotation on the gRPC +// method. Each mapping specifies a URL path template and an HTTP +// method. The path template may refer to one or more fields in the gRPC +// request message, as long as each field is a non-repeated field with a +// primitive (non-message) type. The path template controls how fields +// of the request message are mapped to the URL path. Example: service +// Messaging { rpc GetMessage(GetMessageRequest) returns (Message) { +// option (google.api.http) = { get: "/v1/{name=messages/*}" }; } } +// message GetMessageRequest { string name = 1; // Mapped to URL path. } +// message Message { string text = 1; // The resource content. } This +// enables an HTTP REST to gRPC mapping as below: HTTP | gRPC +// -----|----- `GET /v1/messages/123456` | `GetMessage(name: +// "messages/123456")` Any fields in the request message which are not +// bound by the path template automatically become HTTP query parameters +// if there is no HTTP request body. For example: service Messaging { +// rpc GetMessage(GetMessageRequest) returns (Message) { option // (google.api.http) = { get:"/v1/messages/{message_id}" }; } } message // GetMessageRequest { message SubMessage { string subfield = 1; } // string message_id = 1; // Mapped to URL path. int64 revision = 2; // @@ -1640,16 +1623,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{var}`. If a variable contains multiple path segments, such as -// "{var=foo/*}" or "{var=**}", when such a variable is expanded -// into a URL path on the client side, all characters except -// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the -// reverse decoding, except "%2F" and "%2f" are left unchanged. Such -// variables show up in the [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{+var}`. ## Using gRPC API Service Configuration gRPC API Service +// Discovery Document as `{var}`. If a variable contains multiple path +// segments, such as "{var=foo/*}" or "{var=**}", when such a +// variable is expanded into a URL path on the client side, all +// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server +// side does the reverse decoding, except "%2F" and "%2f" are left +// unchanged. Such variables show up in the Discovery Document as +// `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The // service config is simply the YAML representation of the @@ -1665,14 +1645,12 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the [proto3 -// specification](https://developers.google.com/protocol-buffers/docs/pro -// to3#json). While the single segment variable follows the semantics of -// [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple -// String Expansion, the multi segment variable **does not** follow RFC -// 6570 Section 3.2.3 Reserved Expansion. The reason is that the -// Reserved Expansion does not expand special characters like `?` and -// `#`, which would lead to invalid URLs. As the result, gRPC +// to JSON conversion must follow the proto3 specification. While the +// single segment variable follows the semantics of RFC 6570 Section +// 3.2.2 Simple String Expansion, the multi segment variable **does +// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is +// that the Reserved Expansion does not expand special characters like +// `?` and `#`, which would lead to invalid URLs. As the result, gRPC // Transcoding uses a custom encoding for multi segment variables. The // path variables **must not** refer to any repeated or mapped field, // because client libraries are not capable of handling such variable @@ -2204,40 +2182,38 @@ type MetricDescriptor struct { // granular way, you can create a `DOUBLE CUMULATIVE` metric whose // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is - // `12005/1024`). The supported units are a subset of [The Unified Code - // for Units of Measure](http://unitsofmeasure.org/ucum.html) standard: - // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` - // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** - // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera - // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * - // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano - // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) - // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` - // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) - // **Grammar** The grammar also includes these connectors: * `/` - // division or ratio (as an infix operator). For examples, `kBy/{email}` - // or `MiBy/10ms` (although you should almost never have `/s` in a - // metric `unit`; rates should always be computed at query time from the - // underlying cumulative or delta value). * `.` multiplication or - // composition (as an infix operator). For examples, `GBy.d` or - // `k{watt}.h`. The grammar for a unit is as follows: Expression = - // Component { "." Component } { "/" Component } ; Component = ( [ - // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation - // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it - // follows a `UNIT`. If the annotation is used alone, then the unit is - // equivalent to `1`. For examples, `{request}/s == 1/s`, + // `12005/1024`). The supported units are a subset of The Unified Code + // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * + // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` + // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega + // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` + // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli + // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * + // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` + // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi + // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar + // also includes these connectors: * `/` division or ratio (as an infix + // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you + // should almost never have `/s` in a metric `unit`; rates should always + // be computed at query time from the underlying cumulative or delta + // value). * `.` multiplication or composition (as an infix operator). + // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as + // follows: Expression = Component { "." Component } { "/" Component } ; + // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | + // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a + // comment if it follows a `UNIT`. If the annotation is used alone, then + // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary [dimensionless - // unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, - // such as in `1/s`. It is typically used when none of the basic units - // are appropriate. For example, "new users per day" can be represented - // as `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new - // users). Alternatively, "thousands of page views per day" would be - // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric - // value of `5.3` would mean "5300 page views per day"). * `%` - // represents dimensionless value of 1/100, and annotates values giving - // a percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit of 1, such as in `1/s`. It is + // typically used when none of the basic units are appropriate. For + // example, "new users per day" can be represented as `1/d` or + // `{new-users}/d` (and a metric value `5` would mean "5 new users). + // Alternatively, "thousands of page views per day" would be represented + // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of + // `5.3` would mean "5300 page views per day"). * `%` represents + // dimensionless value of 1/100, and annotates values giving a + // percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -3349,11 +3325,10 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3779,11 +3754,11 @@ func (s *UndeleteTenantProjectRequest) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports [Google Cloud - // Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. - // To use Google Cloud Pub/Sub as the channel, this must be the name of - // a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format - // documented in https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub as a + // notification channel. To use Google Cloud Pub/Sub as the channel, + // this must be the name of a Cloud Pub/Sub topic that uses the Cloud + // Pub/Sub topic name format documented in + // https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index 59bcc1aca2f..46fb1795db9 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -232,15 +232,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses [semantic versioning](http://semver.org) - // where the major version number indicates a breaking change and the - // minor version an additive, non-breaking change. Both version numbers - // are signals to users what to expect from different versions, and - // should be carefully chosen based on the product plan. The major - // version is also reflected in the package name of the interface, which - // must end in `v`, as in `google.feature.v1`. For major versions 0 and - // 1, the suffix can be omitted. Zero major versions must only be used - // for experimental, non-GA interfaces. + // The versioning schema uses semantic versioning where the major + // version number indicates a breaking change and the minor version an + // additive, non-breaking change. Both version numbers are signals to + // users what to expect from different versions, and should be carefully + // chosen based on the product plan. The major version is also reflected + // in the package name of the interface, which must end in `v`, as in + // `google.feature.v1`. For major versions 0 and 1, the suffix can be + // omitted. Zero major versions must only be used for experimental, + // non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -267,15 +267,11 @@ func (s *Api) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthProvider struct { - // Audiences: The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // JWTs with audiences: - + // Audiences: The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, JWTs with audiences: - // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs @@ -299,14 +295,10 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html# - // ProviderMetadata). Optional if the key set document: - can be - // retrieved from [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html) - // of the issuer. - can be inferred from the email domain of the issuer - // (e.g. a Google service account). Example: - // https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery. Optional if the key set document: - + // can be retrieved from OpenID Discovery of the issuer. - can be + // inferred from the email domain of the issuer (e.g. a Google service + // account). Example: https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -344,19 +336,16 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // only JWTs with audience "https://Service_name/API_name" will be - // accepted. For example, if no audiences are in the setting, - // LibraryService API will only accept JWTs with the following audience + // components. The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, only JWTs with audience + // "https://Service_name/API_name" will be accepted. For example, if no + // audiences are in the setting, LibraryService API will only accept + // JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1094,21 +1083,19 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing - // [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), - // aka cross-domain traffic, would allow the backends served from this - // endpoint to receive and respond to HTTP OPTIONS requests. The - // response will be used by the browser to determine whether the - // subsequent cross-origin request is allowed to proceed. + // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the + // backends served from this endpoint to receive and respond to HTTP + // OPTIONS requests. The response will be used by the browser to + // determine whether the subsequent cross-origin request is allowed to + // proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this [API - // Endpoint](https://cloud.google.com/apis/design/glossary). It should - // be either a valid IPv4 address or a fully-qualified domain name. For + // frontend that will handle requests to this API Endpoint. It should be + // either a valid IPv4 address or a fully-qualified domain name. For // example, "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` @@ -1345,33 +1332,29 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including [Google -// APIs](https://github.com/googleapis/googleapis), [Cloud -// Endpoints](https://cloud.google.com/endpoints), [gRPC -// Gateway](https://github.com/grpc-ecosystem/grpc-gateway), and -// [Envoy](https://github.com/envoyproxy/envoy) proxy support this -// feature and use it for large scale production services. `HttpRule` -// defines the schema of the gRPC/REST mapping. The mapping specifies -// how different portions of the gRPC request message are mapped to the -// URL path, URL query parameters, and HTTP request body. It also -// controls how the gRPC response message is mapped to the HTTP response -// body. `HttpRule` is typically specified as an `google.api.http` -// annotation on the gRPC method. Each mapping specifies a URL path -// template and an HTTP method. The path template may refer to one or -// more fields in the gRPC request message, as long as each field is a -// non-repeated field with a primitive (non-message) type. The path -// template controls how fields of the request message are mapped to the -// URL path. Example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option -// (google.api.http) = { get: "/v1/{name=messages/*}" }; } } message -// GetMessageRequest { string name = 1; // Mapped to URL path. } message -// Message { string text = 1; // The resource content. } This enables an -// HTTP REST to gRPC mapping as below: HTTP | gRPC -----|----- `GET -// /v1/messages/123456` | `GetMessage(name: "messages/123456")` Any -// fields in the request message which are not bound by the path -// template automatically become HTTP query parameters if there is no -// HTTP request body. For example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option +// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud +// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use +// it for large scale production services. `HttpRule` defines the schema +// of the gRPC/REST mapping. The mapping specifies how different +// portions of the gRPC request message are mapped to the URL path, URL +// query parameters, and HTTP request body. It also controls how the +// gRPC response message is mapped to the HTTP response body. `HttpRule` +// is typically specified as an `google.api.http` annotation on the gRPC +// method. Each mapping specifies a URL path template and an HTTP +// method. The path template may refer to one or more fields in the gRPC +// request message, as long as each field is a non-repeated field with a +// primitive (non-message) type. The path template controls how fields +// of the request message are mapped to the URL path. Example: service +// Messaging { rpc GetMessage(GetMessageRequest) returns (Message) { +// option (google.api.http) = { get: "/v1/{name=messages/*}" }; } } +// message GetMessageRequest { string name = 1; // Mapped to URL path. } +// message Message { string text = 1; // The resource content. } This +// enables an HTTP REST to gRPC mapping as below: HTTP | gRPC +// -----|----- `GET /v1/messages/123456` | `GetMessage(name: +// "messages/123456")` Any fields in the request message which are not +// bound by the path template automatically become HTTP query parameters +// if there is no HTTP request body. For example: service Messaging { +// rpc GetMessage(GetMessageRequest) returns (Message) { option // (google.api.http) = { get:"/v1/messages/{message_id}" }; } } message // GetMessageRequest { message SubMessage { string subfield = 1; } // string message_id = 1; // Mapped to URL path. int64 revision = 2; // @@ -1451,16 +1434,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{var}`. If a variable contains multiple path segments, such as -// "{var=foo/*}" or "{var=**}", when such a variable is expanded -// into a URL path on the client side, all characters except -// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the -// reverse decoding, except "%2F" and "%2f" are left unchanged. Such -// variables show up in the [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{+var}`. ## Using gRPC API Service Configuration gRPC API Service +// Discovery Document as `{var}`. If a variable contains multiple path +// segments, such as "{var=foo/*}" or "{var=**}", when such a +// variable is expanded into a URL path on the client side, all +// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server +// side does the reverse decoding, except "%2F" and "%2f" are left +// unchanged. Such variables show up in the Discovery Document as +// `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The // service config is simply the YAML representation of the @@ -1476,14 +1456,12 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the [proto3 -// specification](https://developers.google.com/protocol-buffers/docs/pro -// to3#json). While the single segment variable follows the semantics of -// [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple -// String Expansion, the multi segment variable **does not** follow RFC -// 6570 Section 3.2.3 Reserved Expansion. The reason is that the -// Reserved Expansion does not expand special characters like `?` and -// `#`, which would lead to invalid URLs. As the result, gRPC +// to JSON conversion must follow the proto3 specification. While the +// single segment variable follows the semantics of RFC 6570 Section +// 3.2.2 Simple String Expansion, the multi segment variable **does +// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is +// that the Reserved Expansion does not expand special characters like +// `?` and `#`, which would lead to invalid URLs. As the result, gRPC // Transcoding uses a custom encoding for multi segment variables. The // path variables **must not** refer to any repeated or mapped field, // because client libraries are not capable of handling such variable @@ -1943,40 +1921,38 @@ type MetricDescriptor struct { // granular way, you can create a `DOUBLE CUMULATIVE` metric whose // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is - // `12005/1024`). The supported units are a subset of [The Unified Code - // for Units of Measure](http://unitsofmeasure.org/ucum.html) standard: - // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` - // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** - // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera - // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * - // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano - // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) - // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` - // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) - // **Grammar** The grammar also includes these connectors: * `/` - // division or ratio (as an infix operator). For examples, `kBy/{email}` - // or `MiBy/10ms` (although you should almost never have `/s` in a - // metric `unit`; rates should always be computed at query time from the - // underlying cumulative or delta value). * `.` multiplication or - // composition (as an infix operator). For examples, `GBy.d` or - // `k{watt}.h`. The grammar for a unit is as follows: Expression = - // Component { "." Component } { "/" Component } ; Component = ( [ - // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation - // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it - // follows a `UNIT`. If the annotation is used alone, then the unit is - // equivalent to `1`. For examples, `{request}/s == 1/s`, + // `12005/1024`). The supported units are a subset of The Unified Code + // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * + // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` + // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega + // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` + // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli + // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * + // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` + // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi + // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar + // also includes these connectors: * `/` division or ratio (as an infix + // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you + // should almost never have `/s` in a metric `unit`; rates should always + // be computed at query time from the underlying cumulative or delta + // value). * `.` multiplication or composition (as an infix operator). + // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as + // follows: Expression = Component { "." Component } { "/" Component } ; + // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | + // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a + // comment if it follows a `UNIT`. If the annotation is used alone, then + // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary [dimensionless - // unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, - // such as in `1/s`. It is typically used when none of the basic units - // are appropriate. For example, "new users per day" can be represented - // as `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new - // users). Alternatively, "thousands of page views per day" would be - // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric - // value of `5.3` would mean "5300 page views per day"). * `%` - // represents dimensionless value of 1/100, and annotates values giving - // a percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit of 1, such as in `1/s`. It is + // typically used when none of the basic units are appropriate. For + // example, "new users per day" can be represented as `1/d` or + // `{new-users}/d` (and a metric value `5` would mean "5 new users). + // Alternatively, "thousands of page views per day" would be represented + // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of + // `5.3` would mean "5300 page views per day"). * `%` represents + // dimensionless value of 1/100, and annotates values giving a + // percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -2951,11 +2927,10 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3165,11 +3140,11 @@ func (s *Type) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports [Google Cloud - // Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. - // To use Google Cloud Pub/Sub as the channel, this must be the name of - // a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format - // documented in https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub as a + // notification channel. To use Google Cloud Pub/Sub as the channel, + // this must be the name of a Cloud Pub/Sub topic that uses the Cloud + // Pub/Sub topic name format documented in + // https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer diff --git a/servicecontrol/v1/servicecontrol-gen.go b/servicecontrol/v1/servicecontrol-gen.go index 33ed6c14a3e..2ebc26b8bc5 100644 --- a/servicecontrol/v1/servicecontrol-gen.go +++ b/servicecontrol/v1/servicecontrol-gen.go @@ -531,8 +531,7 @@ type AuthenticationInfo struct { // request. For third party identity callers, the `principal_subject` // field is populated instead of this field. For privacy reasons, the // principal email address is sometimes redacted. For more information, - // see [Caller identities in audit - // logs](https://cloud.google.com/logging/docs/audit#user-id). + // see Caller identities in audit logs. PrincipalEmail string `json:"principalEmail,omitempty"` // PrincipalSubject: String representation of identity of requesting @@ -887,8 +886,7 @@ type ConsumerInfo struct { ProjectNumber int64 `json:"projectNumber,omitempty,string"` // Type: The type of the consumer which should have been defined in - // [Google Resource - // Manager](https://cloud.google.com/resource-manager/). + // Google Resource Manager. // // Possible values: // "CONSUMER_TYPE_UNSPECIFIED" - This is never used. @@ -972,9 +970,9 @@ type Distribution struct { Minimum float64 `json:"minimum,omitempty"` // SumOfSquaredDeviation: The sum of squared deviations from the mean: - // Sum[i=1..count]((x_i - mean)^2) where each x_i is a sample values. If - // `count` is zero then this field must be zero, otherwise validation of - // the request fails. + // Sumi=1..count^2) where each x_i is a sample values. If `count` is + // zero then this field must be zero, otherwise validation of the + // request fails. SumOfSquaredDeviation float64 `json:"sumOfSquaredDeviation,omitempty"` // ForceSendFields is a list of field names (e.g. "BucketCounts") to @@ -1237,9 +1235,8 @@ type HttpRequest struct { // "HTTP/2", "websocket" Protocol string `json:"protocol,omitempty"` - // Referer: The referer URL of the request, as defined in [HTTP/1.1 - // Header Field - // Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). + // Referer: The referer URL of the request, as defined in HTTP/1.1 + // Header Field Definitions. Referer string `json:"referer,omitempty"` // RemoteIp: The IP address (IPv4 or IPv6) of the client that issued the @@ -2675,11 +2672,10 @@ func (s *SpanContext) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2907,9 +2903,8 @@ type ServicesAllocateQuotaCall struct { // AllocateQuota: Attempts to allocate quota for the specified consumer. // It should be called before the operation is executed. This method // requires the `servicemanagement.services.quota` permission on the -// specified service. For more information, see [Cloud -// IAM](https://cloud.google.com/iam). **NOTE:** The client **must** -// fail-open on server errors `INTERNAL`, `UNKNOWN`, +// specified service. For more information, see Cloud IAM. **NOTE:** The +// client **must** fail-open on server errors `INTERNAL`, `UNKNOWN`, // `DEADLINE_EXCEEDED`, and `UNAVAILABLE`. To ensure system reliability, // the server may inject these errors to prohibit any hard dependency on // the quota functionality. @@ -3063,8 +3058,7 @@ type ServicesCheckCall struct { // having the latest policy information. NOTE: the CheckRequest has the // size limit of 64KB. This method requires the // `servicemanagement.services.check` permission on the specified -// service. For more information, see [Cloud -// IAM](https://cloud.google.com/iam). +// service. For more information, see Cloud IAM. func (r *ServicesService) Check(serviceName string, checkrequest *CheckRequest) *ServicesCheckCall { c := &ServicesCheckCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -3213,8 +3207,7 @@ type ServicesReportCall struct { // more than 0.01% for business and compliance reasons. NOTE: the // ReportRequest has the size limit (wire-format byte size) of 1MB. This // method requires the `servicemanagement.services.report` permission on -// the specified service. For more information, see [Google Cloud -// IAM](https://cloud.google.com/iam). +// the specified service. For more information, see Google Cloud IAM. func (r *ServicesService) Report(serviceName string, reportrequest *ReportRequest) *ServicesReportCall { c := &ServicesReportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName diff --git a/servicecontrol/v2/servicecontrol-gen.go b/servicecontrol/v2/servicecontrol-gen.go index 4e095e03452..38576f9a398 100644 --- a/servicecontrol/v2/servicecontrol-gen.go +++ b/servicecontrol/v2/servicecontrol-gen.go @@ -456,8 +456,7 @@ type AuthenticationInfo struct { // request. For third party identity callers, the `principal_subject` // field is populated instead of this field. For privacy reasons, the // principal email address is sometimes redacted. For more information, - // see [Caller identities in audit - // logs](https://cloud.google.com/logging/docs/audit#user-id). + // see Caller identities in audit logs. PrincipalEmail string `json:"principalEmail,omitempty"` // PrincipalSubject: String representation of identity of requesting @@ -599,7 +598,7 @@ type CheckResponse struct { Headers map[string]string `json:"headers,omitempty"` // Status: An 'OK' status allows the operation. Any other status - // indicates a denial; [google.rpc.Status.details]() would contain + // indicates a denial; google.rpc.Status.details would contain // additional details about the denial. Status *Status `json:"status,omitempty"` @@ -1185,11 +1184,10 @@ func (s *SpanContext) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1269,22 +1267,18 @@ type ServicesCheckCall struct { // Check: Private Preview. This feature is only available for approved // services. This method provides admission control for services that -// are integrated with [Service -// Infrastructure](/service-infrastructure). It checks whether an +// are integrated with Service Infrastructure. It checks whether an // operation should be allowed based on the service configuration and // relevant policies. It must be called before the operation is -// executed. For more information, see [Admission -// Control](/service-infrastructure/docs/admission-control). NOTE: The +// executed. For more information, see Admission Control. NOTE: The // admission control has an expected policy propagation delay of 60s. // The caller **must** not depend on the most recent policy changes. // NOTE: The admission control has a hard limit of 1 referenced // resources per call. If an operation refers to more than 1 resources, // the caller must call the Check method multiple times. This method // requires the `servicemanagement.services.check` permission on the -// specified service. For more information, see [Service Control API -// Access -// Control](https://cloud.google.com/service-infrastructure/docs/service- -// control/access-control). +// specified service. For more information, see Service Control API +// Access Control. func (r *ServicesService) Check(serviceName string, checkrequest *CheckRequest) *ServicesCheckCall { c := &ServicesCheckCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -1426,19 +1420,15 @@ type ServicesReportCall struct { // Report: Private Preview. This feature is only available for approved // services. This method provides telemetry reporting for services that -// are integrated with [Service -// Infrastructure](/service-infrastructure). It reports a list of +// are integrated with Service Infrastructure. It reports a list of // operations that have occurred on a service. It must be called after // the operations have been executed. For more information, see -// [Telemetry -// Reporting](/service-infrastructure/docs/telemetry-reporting). NOTE: -// The telemetry reporting has a hard limit of 1000 operations and 1MB -// per Report call. It is recommended to have no more than 100 -// operations per call. This method requires the +// Telemetry Reporting. NOTE: The telemetry reporting has a hard limit +// of 1000 operations and 1MB per Report call. It is recommended to have +// no more than 100 operations per call. This method requires the // `servicemanagement.services.report` permission on the specified -// service. For more information, see [Service Control API Access -// Control](https://cloud.google.com/service-infrastructure/docs/service- -// control/access-control). +// service. For more information, see Service Control API Access +// Control. func (r *ServicesService) Report(serviceName string, reportrequest *ReportRequest) *ServicesReportCall { c := &ServicesReportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName diff --git a/servicedirectory/v1/servicedirectory-gen.go b/servicedirectory/v1/servicedirectory-gen.go index 1fabf4ed16e..b62b7f2d29b 100644 --- a/servicedirectory/v1/servicedirectory-gen.go +++ b/servicedirectory/v1/servicedirectory-gen.go @@ -200,9 +200,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -439,9 +437,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -718,9 +714,8 @@ func (s *Namespace) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -738,8 +733,8 @@ func (s *Namespace) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -774,9 +769,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -982,8 +976,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/servicedirectory/v1beta1/servicedirectory-gen.go b/servicedirectory/v1beta1/servicedirectory-gen.go index 59ca7a170c4..dd94c2114b7 100644 --- a/servicedirectory/v1beta1/servicedirectory-gen.go +++ b/servicedirectory/v1beta1/servicedirectory-gen.go @@ -200,9 +200,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -436,9 +434,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -715,9 +711,8 @@ func (s *Namespace) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -735,8 +730,8 @@ func (s *Namespace) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -771,9 +766,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -976,8 +970,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/servicemanagement/v1/servicemanagement-gen.go b/servicemanagement/v1/servicemanagement-gen.go index 4c509d73d5b..7572aaa058f 100644 --- a/servicemanagement/v1/servicemanagement-gen.go +++ b/servicemanagement/v1/servicemanagement-gen.go @@ -278,15 +278,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses [semantic versioning](http://semver.org) - // where the major version number indicates a breaking change and the - // minor version an additive, non-breaking change. Both version numbers - // are signals to users what to expect from different versions, and - // should be carefully chosen based on the product plan. The major - // version is also reflected in the package name of the interface, which - // must end in `v`, as in `google.feature.v1`. For major versions 0 and - // 1, the suffix can be omitted. Zero major versions must only be used - // for experimental, non-GA interfaces. + // The versioning schema uses semantic versioning where the major + // version number indicates a breaking change and the minor version an + // additive, non-breaking change. Both version numbers are signals to + // users what to expect from different versions, and should be carefully + // chosen based on the product plan. The major version is also reflected + // in the package name of the interface, which must end in `v`, as in + // `google.feature.v1`. For major versions 0 and 1, the suffix can be + // omitted. Zero major versions must only be used for experimental, + // non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -410,15 +410,11 @@ func (s *AuditLogConfig) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthProvider struct { - // Audiences: The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // JWTs with audiences: - + // Audiences: The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, JWTs with audiences: - // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs @@ -442,14 +438,10 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html# - // ProviderMetadata). Optional if the key set document: - can be - // retrieved from [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html) - // of the issuer. - can be inferred from the email domain of the issuer - // (e.g. a Google service account). Example: - // https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery. Optional if the key set document: - + // can be retrieved from OpenID Discovery of the issuer. - can be + // inferred from the email domain of the issuer (e.g. a Google service + // account). Example: https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -487,19 +479,16 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // only JWTs with audience "https://Service_name/API_name" will be - // accepted. For example, if no audiences are in the setting, - // LibraryService API will only accept JWTs with the following audience + // components. The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, only JWTs with audience + // "https://Service_name/API_name" will be accepted. For example, if no + // audiences are in the setting, LibraryService API will only accept + // JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -862,9 +851,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1601,21 +1588,19 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing - // [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), - // aka cross-domain traffic, would allow the backends served from this - // endpoint to receive and respond to HTTP OPTIONS requests. The - // response will be used by the browser to determine whether the - // subsequent cross-origin request is allowed to proceed. + // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the + // backends served from this endpoint to receive and respond to HTTP + // OPTIONS requests. The response will be used by the browser to + // determine whether the subsequent cross-origin request is allowed to + // proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this [API - // Endpoint](https://cloud.google.com/apis/design/glossary). It should - // be either a valid IPv4 address or a fully-qualified domain name. For + // frontend that will handle requests to this API Endpoint. It should be + // either a valid IPv4 address or a fully-qualified domain name. For // example, "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` @@ -2020,9 +2005,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2094,33 +2077,29 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including [Google -// APIs](https://github.com/googleapis/googleapis), [Cloud -// Endpoints](https://cloud.google.com/endpoints), [gRPC -// Gateway](https://github.com/grpc-ecosystem/grpc-gateway), and -// [Envoy](https://github.com/envoyproxy/envoy) proxy support this -// feature and use it for large scale production services. `HttpRule` -// defines the schema of the gRPC/REST mapping. The mapping specifies -// how different portions of the gRPC request message are mapped to the -// URL path, URL query parameters, and HTTP request body. It also -// controls how the gRPC response message is mapped to the HTTP response -// body. `HttpRule` is typically specified as an `google.api.http` -// annotation on the gRPC method. Each mapping specifies a URL path -// template and an HTTP method. The path template may refer to one or -// more fields in the gRPC request message, as long as each field is a -// non-repeated field with a primitive (non-message) type. The path -// template controls how fields of the request message are mapped to the -// URL path. Example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option -// (google.api.http) = { get: "/v1/{name=messages/*}" }; } } message -// GetMessageRequest { string name = 1; // Mapped to URL path. } message -// Message { string text = 1; // The resource content. } This enables an -// HTTP REST to gRPC mapping as below: HTTP | gRPC -----|----- `GET -// /v1/messages/123456` | `GetMessage(name: "messages/123456")` Any -// fields in the request message which are not bound by the path -// template automatically become HTTP query parameters if there is no -// HTTP request body. For example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option +// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud +// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use +// it for large scale production services. `HttpRule` defines the schema +// of the gRPC/REST mapping. The mapping specifies how different +// portions of the gRPC request message are mapped to the URL path, URL +// query parameters, and HTTP request body. It also controls how the +// gRPC response message is mapped to the HTTP response body. `HttpRule` +// is typically specified as an `google.api.http` annotation on the gRPC +// method. Each mapping specifies a URL path template and an HTTP +// method. The path template may refer to one or more fields in the gRPC +// request message, as long as each field is a non-repeated field with a +// primitive (non-message) type. The path template controls how fields +// of the request message are mapped to the URL path. Example: service +// Messaging { rpc GetMessage(GetMessageRequest) returns (Message) { +// option (google.api.http) = { get: "/v1/{name=messages/*}" }; } } +// message GetMessageRequest { string name = 1; // Mapped to URL path. } +// message Message { string text = 1; // The resource content. } This +// enables an HTTP REST to gRPC mapping as below: HTTP | gRPC +// -----|----- `GET /v1/messages/123456` | `GetMessage(name: +// "messages/123456")` Any fields in the request message which are not +// bound by the path template automatically become HTTP query parameters +// if there is no HTTP request body. For example: service Messaging { +// rpc GetMessage(GetMessageRequest) returns (Message) { option // (google.api.http) = { get:"/v1/messages/{message_id}" }; } } message // GetMessageRequest { message SubMessage { string subfield = 1; } // string message_id = 1; // Mapped to URL path. int64 revision = 2; // @@ -2200,16 +2179,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{var}`. If a variable contains multiple path segments, such as -// "{var=foo/*}" or "{var=**}", when such a variable is expanded -// into a URL path on the client side, all characters except -// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the -// reverse decoding, except "%2F" and "%2f" are left unchanged. Such -// variables show up in the [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{+var}`. ## Using gRPC API Service Configuration gRPC API Service +// Discovery Document as `{var}`. If a variable contains multiple path +// segments, such as "{var=foo/*}" or "{var=**}", when such a +// variable is expanded into a URL path on the client side, all +// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server +// side does the reverse decoding, except "%2F" and "%2f" are left +// unchanged. Such variables show up in the Discovery Document as +// `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The // service config is simply the YAML representation of the @@ -2225,14 +2201,12 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the [proto3 -// specification](https://developers.google.com/protocol-buffers/docs/pro -// to3#json). While the single segment variable follows the semantics of -// [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple -// String Expansion, the multi segment variable **does not** follow RFC -// 6570 Section 3.2.3 Reserved Expansion. The reason is that the -// Reserved Expansion does not expand special characters like `?` and -// `#`, which would lead to invalid URLs. As the result, gRPC +// to JSON conversion must follow the proto3 specification. While the +// single segment variable follows the semantics of RFC 6570 Section +// 3.2.2 Simple String Expansion, the multi segment variable **does +// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is +// that the Reserved Expansion does not expand special characters like +// `?` and `#`, which would lead to invalid URLs. As the result, gRPC // Transcoding uses a custom encoding for multi segment variables. The // path variables **must not** refer to any repeated or mapped field, // because client libraries are not capable of handling such variable @@ -2681,8 +2655,8 @@ type ManagedService struct { // service. ProducerProjectId string `json:"producerProjectId,omitempty"` - // ServiceName: The name of the service. See the - // [overview](/service-management/overview) for naming requirements. + // ServiceName: The name of the service. See the overview for naming + // requirements. ServiceName string `json:"serviceName,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2876,40 +2850,38 @@ type MetricDescriptor struct { // granular way, you can create a `DOUBLE CUMULATIVE` metric whose // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is - // `12005/1024`). The supported units are a subset of [The Unified Code - // for Units of Measure](http://unitsofmeasure.org/ucum.html) standard: - // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` - // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** - // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera - // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * - // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano - // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) - // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` - // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) - // **Grammar** The grammar also includes these connectors: * `/` - // division or ratio (as an infix operator). For examples, `kBy/{email}` - // or `MiBy/10ms` (although you should almost never have `/s` in a - // metric `unit`; rates should always be computed at query time from the - // underlying cumulative or delta value). * `.` multiplication or - // composition (as an infix operator). For examples, `GBy.d` or - // `k{watt}.h`. The grammar for a unit is as follows: Expression = - // Component { "." Component } { "/" Component } ; Component = ( [ - // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation - // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it - // follows a `UNIT`. If the annotation is used alone, then the unit is - // equivalent to `1`. For examples, `{request}/s == 1/s`, + // `12005/1024`). The supported units are a subset of The Unified Code + // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * + // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` + // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega + // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` + // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli + // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * + // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` + // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi + // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar + // also includes these connectors: * `/` division or ratio (as an infix + // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you + // should almost never have `/s` in a metric `unit`; rates should always + // be computed at query time from the underlying cumulative or delta + // value). * `.` multiplication or composition (as an infix operator). + // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as + // follows: Expression = Component { "." Component } { "/" Component } ; + // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | + // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a + // comment if it follows a `UNIT`. If the annotation is used alone, then + // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary [dimensionless - // unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, - // such as in `1/s`. It is typically used when none of the basic units - // are appropriate. For example, "new users per day" can be represented - // as `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new - // users). Alternatively, "thousands of page views per day" would be - // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric - // value of `5.3` would mean "5300 page views per day"). * `%` - // represents dimensionless value of 1/100, and annotates values giving - // a percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit of 1, such as in `1/s`. It is + // typically used when none of the basic units are appropriate. For + // example, "new users per day" can be represented as `1/d` or + // `{new-users}/d` (and a metric value `5` would mean "5 new users). + // Alternatively, "thousands of page views per day" would be represented + // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of + // `5.3` would mean "5300 page views per day"). * `%` represents + // dimensionless value of 1/100, and annotates values giving a + // percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -3581,9 +3553,8 @@ func (s *Page) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -3601,8 +3572,8 @@ func (s *Page) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -3641,9 +3612,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4192,11 +4162,10 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4464,8 +4433,7 @@ func (s *SystemParameters) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -4646,11 +4614,11 @@ func (s *UndeleteServiceResponse) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports [Google Cloud - // Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. - // To use Google Cloud Pub/Sub as the channel, this must be the name of - // a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format - // documented in https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub as a + // notification channel. To use Google Cloud Pub/Sub as the channel, + // this must be the name of a Cloud Pub/Sub topic that uses the Cloud + // Pub/Sub topic name format documented in + // https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer @@ -5380,9 +5348,7 @@ type ServicesEnableCall struct { } // Enable: Enables a service for a project, so it can be used for the -// project. See [Cloud Auth -// Guide](https://cloud.google.com/docs/authentication) for more -// information. Operation +// project. See Cloud Auth Guide for more information. Operation func (r *ServicesService) Enable(serviceName string, enableservicerequest *EnableServiceRequest) *ServicesEnableCall { c := &ServicesEnableCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -8190,11 +8156,10 @@ func (r *ServicesRolloutsService) List(serviceName string) *ServicesRolloutsList // Filter sets the optional parameter "filter": Required. Use `filter` // to return subset of rollouts. The following filters are supported: -- -// To limit the results to only those in -// [status](google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS', -// use filter='status=SUCCESS' -- To limit the results to those in -// [status](google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED' -// or 'FAILED', use filter='status=CANCELLED OR status=FAILED' +// To limit the results to only those in status 'SUCCESS', use +// filter='status=SUCCESS' -- To limit the results to those in status +// 'CANCELLED' or 'FAILED', use filter='status=CANCELLED OR +// status=FAILED' func (c *ServicesRolloutsListCall) Filter(filter string) *ServicesRolloutsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/servicenetworking/v1/servicenetworking-gen.go b/servicenetworking/v1/servicenetworking-gen.go index e05beea2d4e..2e0f77bf21a 100644 --- a/servicenetworking/v1/servicenetworking-gen.go +++ b/servicenetworking/v1/servicenetworking-gen.go @@ -491,8 +491,8 @@ type AddSubnetworkRequest struct { // range. IpPrefixLength int64 `json:"ipPrefixLength,omitempty"` - // Region: Required. The name of a [region](/compute/docs/regions-zones) - // for the subnet, such `europe-west1`. + // Region: Required. The name of a region for the subnet, such + // `europe-west1`. Region string `json:"region,omitempty"` // RequestedAddress: Optional. The starting address of a range. The @@ -516,9 +516,8 @@ type AddSubnetworkRequest struct { SecondaryIpRangeSpecs []*SecondaryIpRangeSpec `json:"secondaryIpRangeSpecs,omitempty"` // Subnetwork: Required. A name for the new subnet. For information - // about the naming requirements, see - // [subnetwork](/compute/docs/reference/rest/v1/subnetworks) in the - // Compute API documentation. + // about the naming requirements, see subnetwork in the Compute API + // documentation. Subnetwork string `json:"subnetwork,omitempty"` // SubnetworkUsers: A list of members that are granted the @@ -588,15 +587,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses [semantic versioning](http://semver.org) - // where the major version number indicates a breaking change and the - // minor version an additive, non-breaking change. Both version numbers - // are signals to users what to expect from different versions, and - // should be carefully chosen based on the product plan. The major - // version is also reflected in the package name of the interface, which - // must end in `v`, as in `google.feature.v1`. For major versions 0 and - // 1, the suffix can be omitted. Zero major versions must only be used - // for experimental, non-GA interfaces. + // The versioning schema uses semantic versioning where the major + // version number indicates a breaking change and the minor version an + // additive, non-breaking change. Both version numbers are signals to + // users what to expect from different versions, and should be carefully + // chosen based on the product plan. The major version is also reflected + // in the package name of the interface, which must end in `v`, as in + // `google.feature.v1`. For major versions 0 and 1, the suffix can be + // omitted. Zero major versions must only be used for experimental, + // non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -623,15 +622,11 @@ func (s *Api) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthProvider struct { - // Audiences: The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // JWTs with audiences: - + // Audiences: The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, JWTs with audiences: - // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs @@ -655,14 +650,10 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html# - // ProviderMetadata). Optional if the key set document: - can be - // retrieved from [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html) - // of the issuer. - can be inferred from the email domain of the issuer - // (e.g. a Google service account). Example: - // https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery. Optional if the key set document: - + // can be retrieved from OpenID Discovery of the issuer. - can be + // inferred from the email domain of the issuer (e.g. a Google service + // account). Example: https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -700,19 +691,16 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // only JWTs with audience "https://Service_name/API_name" will be - // accepted. For example, if no audiences are in the setting, - // LibraryService API will only accept JWTs with the following audience + // components. The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, only JWTs with audience + // "https://Service_name/API_name" will be accepted. For example, if no + // audiences are in the setting, LibraryService API will only accept + // JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1769,21 +1757,19 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing - // [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), - // aka cross-domain traffic, would allow the backends served from this - // endpoint to receive and respond to HTTP OPTIONS requests. The - // response will be used by the browser to determine whether the - // subsequent cross-origin request is allowed to proceed. + // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the + // backends served from this endpoint to receive and respond to HTTP + // OPTIONS requests. The response will be used by the browser to + // determine whether the subsequent cross-origin request is allowed to + // proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this [API - // Endpoint](https://cloud.google.com/apis/design/glossary). It should - // be either a valid IPv4 address or a fully-qualified domain name. For + // frontend that will handle requests to this API Endpoint. It should be + // either a valid IPv4 address or a fully-qualified domain name. For // example, "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` @@ -2099,33 +2085,29 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including [Google -// APIs](https://github.com/googleapis/googleapis), [Cloud -// Endpoints](https://cloud.google.com/endpoints), [gRPC -// Gateway](https://github.com/grpc-ecosystem/grpc-gateway), and -// [Envoy](https://github.com/envoyproxy/envoy) proxy support this -// feature and use it for large scale production services. `HttpRule` -// defines the schema of the gRPC/REST mapping. The mapping specifies -// how different portions of the gRPC request message are mapped to the -// URL path, URL query parameters, and HTTP request body. It also -// controls how the gRPC response message is mapped to the HTTP response -// body. `HttpRule` is typically specified as an `google.api.http` -// annotation on the gRPC method. Each mapping specifies a URL path -// template and an HTTP method. The path template may refer to one or -// more fields in the gRPC request message, as long as each field is a -// non-repeated field with a primitive (non-message) type. The path -// template controls how fields of the request message are mapped to the -// URL path. Example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option -// (google.api.http) = { get: "/v1/{name=messages/*}" }; } } message -// GetMessageRequest { string name = 1; // Mapped to URL path. } message -// Message { string text = 1; // The resource content. } This enables an -// HTTP REST to gRPC mapping as below: HTTP | gRPC -----|----- `GET -// /v1/messages/123456` | `GetMessage(name: "messages/123456")` Any -// fields in the request message which are not bound by the path -// template automatically become HTTP query parameters if there is no -// HTTP request body. For example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option +// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud +// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use +// it for large scale production services. `HttpRule` defines the schema +// of the gRPC/REST mapping. The mapping specifies how different +// portions of the gRPC request message are mapped to the URL path, URL +// query parameters, and HTTP request body. It also controls how the +// gRPC response message is mapped to the HTTP response body. `HttpRule` +// is typically specified as an `google.api.http` annotation on the gRPC +// method. Each mapping specifies a URL path template and an HTTP +// method. The path template may refer to one or more fields in the gRPC +// request message, as long as each field is a non-repeated field with a +// primitive (non-message) type. The path template controls how fields +// of the request message are mapped to the URL path. Example: service +// Messaging { rpc GetMessage(GetMessageRequest) returns (Message) { +// option (google.api.http) = { get: "/v1/{name=messages/*}" }; } } +// message GetMessageRequest { string name = 1; // Mapped to URL path. } +// message Message { string text = 1; // The resource content. } This +// enables an HTTP REST to gRPC mapping as below: HTTP | gRPC +// -----|----- `GET /v1/messages/123456` | `GetMessage(name: +// "messages/123456")` Any fields in the request message which are not +// bound by the path template automatically become HTTP query parameters +// if there is no HTTP request body. For example: service Messaging { +// rpc GetMessage(GetMessageRequest) returns (Message) { option // (google.api.http) = { get:"/v1/messages/{message_id}" }; } } message // GetMessageRequest { message SubMessage { string subfield = 1; } // string message_id = 1; // Mapped to URL path. int64 revision = 2; // @@ -2205,16 +2187,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{var}`. If a variable contains multiple path segments, such as -// "{var=foo/*}" or "{var=**}", when such a variable is expanded -// into a URL path on the client side, all characters except -// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the -// reverse decoding, except "%2F" and "%2f" are left unchanged. Such -// variables show up in the [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{+var}`. ## Using gRPC API Service Configuration gRPC API Service +// Discovery Document as `{var}`. If a variable contains multiple path +// segments, such as "{var=foo/*}" or "{var=**}", when such a +// variable is expanded into a URL path on the client side, all +// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server +// side does the reverse decoding, except "%2F" and "%2f" are left +// unchanged. Such variables show up in the Discovery Document as +// `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The // service config is simply the YAML representation of the @@ -2230,14 +2209,12 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the [proto3 -// specification](https://developers.google.com/protocol-buffers/docs/pro -// to3#json). While the single segment variable follows the semantics of -// [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple -// String Expansion, the multi segment variable **does not** follow RFC -// 6570 Section 3.2.3 Reserved Expansion. The reason is that the -// Reserved Expansion does not expand special characters like `?` and -// `#`, which would lead to invalid URLs. As the result, gRPC +// to JSON conversion must follow the proto3 specification. While the +// single segment variable follows the semantics of RFC 6570 Section +// 3.2.2 Simple String Expansion, the multi segment variable **does +// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is +// that the Reserved Expansion does not expand special characters like +// `?` and `#`, which would lead to invalid URLs. As the result, gRPC // Transcoding uses a custom encoding for multi segment variables. The // path variables **must not** refer to any repeated or mapped field, // because client libraries are not capable of handling such variable @@ -2801,40 +2778,38 @@ type MetricDescriptor struct { // granular way, you can create a `DOUBLE CUMULATIVE` metric whose // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is - // `12005/1024`). The supported units are a subset of [The Unified Code - // for Units of Measure](http://unitsofmeasure.org/ucum.html) standard: - // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` - // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** - // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera - // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * - // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano - // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) - // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` - // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) - // **Grammar** The grammar also includes these connectors: * `/` - // division or ratio (as an infix operator). For examples, `kBy/{email}` - // or `MiBy/10ms` (although you should almost never have `/s` in a - // metric `unit`; rates should always be computed at query time from the - // underlying cumulative or delta value). * `.` multiplication or - // composition (as an infix operator). For examples, `GBy.d` or - // `k{watt}.h`. The grammar for a unit is as follows: Expression = - // Component { "." Component } { "/" Component } ; Component = ( [ - // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation - // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it - // follows a `UNIT`. If the annotation is used alone, then the unit is - // equivalent to `1`. For examples, `{request}/s == 1/s`, + // `12005/1024`). The supported units are a subset of The Unified Code + // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * + // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` + // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega + // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` + // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli + // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * + // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` + // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi + // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar + // also includes these connectors: * `/` division or ratio (as an infix + // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you + // should almost never have `/s` in a metric `unit`; rates should always + // be computed at query time from the underlying cumulative or delta + // value). * `.` multiplication or composition (as an infix operator). + // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as + // follows: Expression = Component { "." Component } { "/" Component } ; + // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | + // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a + // comment if it follows a `UNIT`. If the annotation is used alone, then + // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary [dimensionless - // unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, - // such as in `1/s`. It is typically used when none of the basic units - // are appropriate. For example, "new users per day" can be represented - // as `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new - // users). Alternatively, "thousands of page views per day" would be - // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric - // value of `5.3` would mean "5300 page views per day"). * `%` - // represents dimensionless value of 1/100, and annotates values giving - // a percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit of 1, such as in `1/s`. It is + // typically used when none of the basic units are appropriate. For + // example, "new users per day" can be represented as `1/d` or + // `{new-users}/d` (and a metric value `5` would mean "5 new users). + // Alternatively, "thousands of page views per day" would be represented + // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of + // `5.3` would mean "5300 page views per day"). * `%` represents + // dimensionless value of 1/100, and annotates values giving a + // percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -4227,11 +4202,10 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4568,11 +4542,11 @@ func (s *UpdateDnsRecordSetRequest) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports [Google Cloud - // Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. - // To use Google Cloud Pub/Sub as the channel, this must be the name of - // a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format - // documented in https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub as a + // notification channel. To use Google Cloud Pub/Sub as the channel, + // this must be the name of a Cloud Pub/Sub topic that uses the Cloud + // Pub/Sub topic name format documented in + // https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go index 807fb5df8eb..81e66c3bd76 100644 --- a/servicenetworking/v1beta/servicenetworking-gen.go +++ b/servicenetworking/v1beta/servicenetworking-gen.go @@ -285,8 +285,8 @@ type AddSubnetworkRequest struct { // range. IpPrefixLength int64 `json:"ipPrefixLength,omitempty"` - // Region: Required. The name of a [region](/compute/docs/regions-zones) - // for the subnet, such `europe-west1`. + // Region: Required. The name of a region for the subnet, such + // `europe-west1`. Region string `json:"region,omitempty"` // RequestedAddress: Optional. The starting address of a range. The @@ -298,9 +298,8 @@ type AddSubnetworkRequest struct { RequestedAddress string `json:"requestedAddress,omitempty"` // Subnetwork: Required. A name for the new subnet. For information - // about the naming requirements, see - // [subnetwork](/compute/docs/reference/rest/v1/subnetworks) in the - // Compute API documentation. + // about the naming requirements, see subnetwork in the Compute API + // documentation. Subnetwork string `json:"subnetwork,omitempty"` // SubnetworkUsers: A list of members that are granted the @@ -370,15 +369,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses [semantic versioning](http://semver.org) - // where the major version number indicates a breaking change and the - // minor version an additive, non-breaking change. Both version numbers - // are signals to users what to expect from different versions, and - // should be carefully chosen based on the product plan. The major - // version is also reflected in the package name of the interface, which - // must end in `v`, as in `google.feature.v1`. For major versions 0 and - // 1, the suffix can be omitted. Zero major versions must only be used - // for experimental, non-GA interfaces. + // The versioning schema uses semantic versioning where the major + // version number indicates a breaking change and the minor version an + // additive, non-breaking change. Both version numbers are signals to + // users what to expect from different versions, and should be carefully + // chosen based on the product plan. The major version is also reflected + // in the package name of the interface, which must end in `v`, as in + // `google.feature.v1`. For major versions 0 and 1, the suffix can be + // omitted. Zero major versions must only be used for experimental, + // non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -405,15 +404,11 @@ func (s *Api) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthProvider struct { - // Audiences: The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // JWTs with audiences: - + // Audiences: The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, JWTs with audiences: - // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs @@ -437,14 +432,10 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html# - // ProviderMetadata). Optional if the key set document: - can be - // retrieved from [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html) - // of the issuer. - can be inferred from the email domain of the issuer - // (e.g. a Google service account). Example: - // https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery. Optional if the key set document: - + // can be retrieved from OpenID Discovery of the issuer. - can be + // inferred from the email domain of the issuer (e.g. a Google service + // account). Example: https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -482,19 +473,16 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // only JWTs with audience "https://Service_name/API_name" will be - // accepted. For example, if no audiences are in the setting, - // LibraryService API will only accept JWTs with the following audience + // components. The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, only JWTs with audience + // "https://Service_name/API_name" will be accepted. For example, if no + // audiences are in the setting, LibraryService API will only accept + // JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1430,21 +1418,19 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing - // [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), - // aka cross-domain traffic, would allow the backends served from this - // endpoint to receive and respond to HTTP OPTIONS requests. The - // response will be used by the browser to determine whether the - // subsequent cross-origin request is allowed to proceed. + // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the + // backends served from this endpoint to receive and respond to HTTP + // OPTIONS requests. The response will be used by the browser to + // determine whether the subsequent cross-origin request is allowed to + // proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this [API - // Endpoint](https://cloud.google.com/apis/design/glossary). It should - // be either a valid IPv4 address or a fully-qualified domain name. For + // frontend that will handle requests to this API Endpoint. It should be + // either a valid IPv4 address or a fully-qualified domain name. For // example, "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` @@ -1760,33 +1746,29 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including [Google -// APIs](https://github.com/googleapis/googleapis), [Cloud -// Endpoints](https://cloud.google.com/endpoints), [gRPC -// Gateway](https://github.com/grpc-ecosystem/grpc-gateway), and -// [Envoy](https://github.com/envoyproxy/envoy) proxy support this -// feature and use it for large scale production services. `HttpRule` -// defines the schema of the gRPC/REST mapping. The mapping specifies -// how different portions of the gRPC request message are mapped to the -// URL path, URL query parameters, and HTTP request body. It also -// controls how the gRPC response message is mapped to the HTTP response -// body. `HttpRule` is typically specified as an `google.api.http` -// annotation on the gRPC method. Each mapping specifies a URL path -// template and an HTTP method. The path template may refer to one or -// more fields in the gRPC request message, as long as each field is a -// non-repeated field with a primitive (non-message) type. The path -// template controls how fields of the request message are mapped to the -// URL path. Example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option -// (google.api.http) = { get: "/v1/{name=messages/*}" }; } } message -// GetMessageRequest { string name = 1; // Mapped to URL path. } message -// Message { string text = 1; // The resource content. } This enables an -// HTTP REST to gRPC mapping as below: HTTP | gRPC -----|----- `GET -// /v1/messages/123456` | `GetMessage(name: "messages/123456")` Any -// fields in the request message which are not bound by the path -// template automatically become HTTP query parameters if there is no -// HTTP request body. For example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option +// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud +// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use +// it for large scale production services. `HttpRule` defines the schema +// of the gRPC/REST mapping. The mapping specifies how different +// portions of the gRPC request message are mapped to the URL path, URL +// query parameters, and HTTP request body. It also controls how the +// gRPC response message is mapped to the HTTP response body. `HttpRule` +// is typically specified as an `google.api.http` annotation on the gRPC +// method. Each mapping specifies a URL path template and an HTTP +// method. The path template may refer to one or more fields in the gRPC +// request message, as long as each field is a non-repeated field with a +// primitive (non-message) type. The path template controls how fields +// of the request message are mapped to the URL path. Example: service +// Messaging { rpc GetMessage(GetMessageRequest) returns (Message) { +// option (google.api.http) = { get: "/v1/{name=messages/*}" }; } } +// message GetMessageRequest { string name = 1; // Mapped to URL path. } +// message Message { string text = 1; // The resource content. } This +// enables an HTTP REST to gRPC mapping as below: HTTP | gRPC +// -----|----- `GET /v1/messages/123456` | `GetMessage(name: +// "messages/123456")` Any fields in the request message which are not +// bound by the path template automatically become HTTP query parameters +// if there is no HTTP request body. For example: service Messaging { +// rpc GetMessage(GetMessageRequest) returns (Message) { option // (google.api.http) = { get:"/v1/messages/{message_id}" }; } } message // GetMessageRequest { message SubMessage { string subfield = 1; } // string message_id = 1; // Mapped to URL path. int64 revision = 2; // @@ -1866,16 +1848,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{var}`. If a variable contains multiple path segments, such as -// "{var=foo/*}" or "{var=**}", when such a variable is expanded -// into a URL path on the client side, all characters except -// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the -// reverse decoding, except "%2F" and "%2f" are left unchanged. Such -// variables show up in the [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{+var}`. ## Using gRPC API Service Configuration gRPC API Service +// Discovery Document as `{var}`. If a variable contains multiple path +// segments, such as "{var=foo/*}" or "{var=**}", when such a +// variable is expanded into a URL path on the client side, all +// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server +// side does the reverse decoding, except "%2F" and "%2f" are left +// unchanged. Such variables show up in the Discovery Document as +// `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The // service config is simply the YAML representation of the @@ -1891,14 +1870,12 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the [proto3 -// specification](https://developers.google.com/protocol-buffers/docs/pro -// to3#json). While the single segment variable follows the semantics of -// [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple -// String Expansion, the multi segment variable **does not** follow RFC -// 6570 Section 3.2.3 Reserved Expansion. The reason is that the -// Reserved Expansion does not expand special characters like `?` and -// `#`, which would lead to invalid URLs. As the result, gRPC +// to JSON conversion must follow the proto3 specification. While the +// single segment variable follows the semantics of RFC 6570 Section +// 3.2.2 Simple String Expansion, the multi segment variable **does +// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is +// that the Reserved Expansion does not expand special characters like +// `?` and `#`, which would lead to invalid URLs. As the result, gRPC // Transcoding uses a custom encoding for multi segment variables. The // path variables **must not** refer to any repeated or mapped field, // because client libraries are not capable of handling such variable @@ -2391,40 +2368,38 @@ type MetricDescriptor struct { // granular way, you can create a `DOUBLE CUMULATIVE` metric whose // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is - // `12005/1024`). The supported units are a subset of [The Unified Code - // for Units of Measure](http://unitsofmeasure.org/ucum.html) standard: - // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` - // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** - // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera - // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * - // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano - // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) - // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` - // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) - // **Grammar** The grammar also includes these connectors: * `/` - // division or ratio (as an infix operator). For examples, `kBy/{email}` - // or `MiBy/10ms` (although you should almost never have `/s` in a - // metric `unit`; rates should always be computed at query time from the - // underlying cumulative or delta value). * `.` multiplication or - // composition (as an infix operator). For examples, `GBy.d` or - // `k{watt}.h`. The grammar for a unit is as follows: Expression = - // Component { "." Component } { "/" Component } ; Component = ( [ - // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation - // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it - // follows a `UNIT`. If the annotation is used alone, then the unit is - // equivalent to `1`. For examples, `{request}/s == 1/s`, + // `12005/1024`). The supported units are a subset of The Unified Code + // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * + // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` + // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega + // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` + // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli + // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * + // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` + // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi + // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar + // also includes these connectors: * `/` division or ratio (as an infix + // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you + // should almost never have `/s` in a metric `unit`; rates should always + // be computed at query time from the underlying cumulative or delta + // value). * `.` multiplication or composition (as an infix operator). + // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as + // follows: Expression = Component { "." Component } { "/" Component } ; + // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | + // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a + // comment if it follows a `UNIT`. If the annotation is used alone, then + // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary [dimensionless - // unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, - // such as in `1/s`. It is typically used when none of the basic units - // are appropriate. For example, "new users per day" can be represented - // as `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new - // users). Alternatively, "thousands of page views per day" would be - // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric - // value of `5.3` would mean "5300 page views per day"). * `%` - // represents dimensionless value of 1/100, and annotates values giving - // a percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit of 1, such as in `1/s`. It is + // typically used when none of the basic units are appropriate. For + // example, "new users per day" can be represented as `1/d` or + // `{new-users}/d` (and a metric value `5` would mean "5 new users). + // Alternatively, "thousands of page views per day" would be represented + // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of + // `5.3` would mean "5300 page views per day"). * `%` represents + // dimensionless value of 1/100, and annotates values giving a + // percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -3645,11 +3620,10 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3908,11 +3882,11 @@ type UpdateDnsRecordSetMetadata struct { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports [Google Cloud - // Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. - // To use Google Cloud Pub/Sub as the channel, this must be the name of - // a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format - // documented in https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub as a + // notification channel. To use Google Cloud Pub/Sub as the channel, + // this must be the name of a Cloud Pub/Sub topic that uses the Cloud + // Pub/Sub topic name format documented in + // https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index 836cfc5623f..0e135ad6873 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -269,15 +269,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses [semantic versioning](http://semver.org) - // where the major version number indicates a breaking change and the - // minor version an additive, non-breaking change. Both version numbers - // are signals to users what to expect from different versions, and - // should be carefully chosen based on the product plan. The major - // version is also reflected in the package name of the interface, which - // must end in `v`, as in `google.feature.v1`. For major versions 0 and - // 1, the suffix can be omitted. Zero major versions must only be used - // for experimental, non-GA interfaces. + // The versioning schema uses semantic versioning where the major + // version number indicates a breaking change and the minor version an + // additive, non-breaking change. Both version numbers are signals to + // users what to expect from different versions, and should be carefully + // chosen based on the product plan. The major version is also reflected + // in the package name of the interface, which must end in `v`, as in + // `google.feature.v1`. For major versions 0 and 1, the suffix can be + // omitted. Zero major versions must only be used for experimental, + // non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -304,15 +304,11 @@ func (s *Api) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthProvider struct { - // Audiences: The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // JWTs with audiences: - + // Audiences: The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, JWTs with audiences: - // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs @@ -336,14 +332,10 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html# - // ProviderMetadata). Optional if the key set document: - can be - // retrieved from [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html) - // of the issuer. - can be inferred from the email domain of the issuer - // (e.g. a Google service account). Example: - // https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery. Optional if the key set document: - + // can be retrieved from OpenID Discovery of the issuer. - can be + // inferred from the email domain of the issuer (e.g. a Google service + // account). Example: https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -381,19 +373,16 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // only JWTs with audience "https://Service_name/API_name" will be - // accepted. For example, if no audiences are in the setting, - // LibraryService API will only accept JWTs with the following audience + // components. The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, only JWTs with audience + // "https://Service_name/API_name" will be accepted. For example, if no + // audiences are in the setting, LibraryService API will only accept + // JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1444,21 +1433,19 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing - // [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), - // aka cross-domain traffic, would allow the backends served from this - // endpoint to receive and respond to HTTP OPTIONS requests. The - // response will be used by the browser to determine whether the - // subsequent cross-origin request is allowed to proceed. + // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the + // backends served from this endpoint to receive and respond to HTTP + // OPTIONS requests. The response will be used by the browser to + // determine whether the subsequent cross-origin request is allowed to + // proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this [API - // Endpoint](https://cloud.google.com/apis/design/glossary). It should - // be either a valid IPv4 address or a fully-qualified domain name. For + // frontend that will handle requests to this API Endpoint. It should be + // either a valid IPv4 address or a fully-qualified domain name. For // example, "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` @@ -2108,33 +2095,29 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including [Google -// APIs](https://github.com/googleapis/googleapis), [Cloud -// Endpoints](https://cloud.google.com/endpoints), [gRPC -// Gateway](https://github.com/grpc-ecosystem/grpc-gateway), and -// [Envoy](https://github.com/envoyproxy/envoy) proxy support this -// feature and use it for large scale production services. `HttpRule` -// defines the schema of the gRPC/REST mapping. The mapping specifies -// how different portions of the gRPC request message are mapped to the -// URL path, URL query parameters, and HTTP request body. It also -// controls how the gRPC response message is mapped to the HTTP response -// body. `HttpRule` is typically specified as an `google.api.http` -// annotation on the gRPC method. Each mapping specifies a URL path -// template and an HTTP method. The path template may refer to one or -// more fields in the gRPC request message, as long as each field is a -// non-repeated field with a primitive (non-message) type. The path -// template controls how fields of the request message are mapped to the -// URL path. Example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option -// (google.api.http) = { get: "/v1/{name=messages/*}" }; } } message -// GetMessageRequest { string name = 1; // Mapped to URL path. } message -// Message { string text = 1; // The resource content. } This enables an -// HTTP REST to gRPC mapping as below: HTTP | gRPC -----|----- `GET -// /v1/messages/123456` | `GetMessage(name: "messages/123456")` Any -// fields in the request message which are not bound by the path -// template automatically become HTTP query parameters if there is no -// HTTP request body. For example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option +// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud +// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use +// it for large scale production services. `HttpRule` defines the schema +// of the gRPC/REST mapping. The mapping specifies how different +// portions of the gRPC request message are mapped to the URL path, URL +// query parameters, and HTTP request body. It also controls how the +// gRPC response message is mapped to the HTTP response body. `HttpRule` +// is typically specified as an `google.api.http` annotation on the gRPC +// method. Each mapping specifies a URL path template and an HTTP +// method. The path template may refer to one or more fields in the gRPC +// request message, as long as each field is a non-repeated field with a +// primitive (non-message) type. The path template controls how fields +// of the request message are mapped to the URL path. Example: service +// Messaging { rpc GetMessage(GetMessageRequest) returns (Message) { +// option (google.api.http) = { get: "/v1/{name=messages/*}" }; } } +// message GetMessageRequest { string name = 1; // Mapped to URL path. } +// message Message { string text = 1; // The resource content. } This +// enables an HTTP REST to gRPC mapping as below: HTTP | gRPC +// -----|----- `GET /v1/messages/123456` | `GetMessage(name: +// "messages/123456")` Any fields in the request message which are not +// bound by the path template automatically become HTTP query parameters +// if there is no HTTP request body. For example: service Messaging { +// rpc GetMessage(GetMessageRequest) returns (Message) { option // (google.api.http) = { get:"/v1/messages/{message_id}" }; } } message // GetMessageRequest { message SubMessage { string subfield = 1; } // string message_id = 1; // Mapped to URL path. int64 revision = 2; // @@ -2214,16 +2197,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{var}`. If a variable contains multiple path segments, such as -// "{var=foo/*}" or "{var=**}", when such a variable is expanded -// into a URL path on the client side, all characters except -// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the -// reverse decoding, except "%2F" and "%2f" are left unchanged. Such -// variables show up in the [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{+var}`. ## Using gRPC API Service Configuration gRPC API Service +// Discovery Document as `{var}`. If a variable contains multiple path +// segments, such as "{var=foo/*}" or "{var=**}", when such a +// variable is expanded into a URL path on the client side, all +// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server +// side does the reverse decoding, except "%2F" and "%2f" are left +// unchanged. Such variables show up in the Discovery Document as +// `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The // service config is simply the YAML representation of the @@ -2239,14 +2219,12 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the [proto3 -// specification](https://developers.google.com/protocol-buffers/docs/pro -// to3#json). While the single segment variable follows the semantics of -// [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple -// String Expansion, the multi segment variable **does not** follow RFC -// 6570 Section 3.2.3 Reserved Expansion. The reason is that the -// Reserved Expansion does not expand special characters like `?` and -// `#`, which would lead to invalid URLs. As the result, gRPC +// to JSON conversion must follow the proto3 specification. While the +// single segment variable follows the semantics of RFC 6570 Section +// 3.2.2 Simple String Expansion, the multi segment variable **does +// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is +// that the Reserved Expansion does not expand special characters like +// `?` and `#`, which would lead to invalid URLs. As the result, gRPC // Transcoding uses a custom encoding for multi segment variables. The // path variables **must not** refer to any repeated or mapped field, // because client libraries are not capable of handling such variable @@ -2866,40 +2844,38 @@ type MetricDescriptor struct { // granular way, you can create a `DOUBLE CUMULATIVE` metric whose // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is - // `12005/1024`). The supported units are a subset of [The Unified Code - // for Units of Measure](http://unitsofmeasure.org/ucum.html) standard: - // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` - // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** - // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera - // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * - // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano - // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) - // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` - // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) - // **Grammar** The grammar also includes these connectors: * `/` - // division or ratio (as an infix operator). For examples, `kBy/{email}` - // or `MiBy/10ms` (although you should almost never have `/s` in a - // metric `unit`; rates should always be computed at query time from the - // underlying cumulative or delta value). * `.` multiplication or - // composition (as an infix operator). For examples, `GBy.d` or - // `k{watt}.h`. The grammar for a unit is as follows: Expression = - // Component { "." Component } { "/" Component } ; Component = ( [ - // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation - // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it - // follows a `UNIT`. If the annotation is used alone, then the unit is - // equivalent to `1`. For examples, `{request}/s == 1/s`, + // `12005/1024`). The supported units are a subset of The Unified Code + // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * + // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` + // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega + // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` + // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli + // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * + // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` + // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi + // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar + // also includes these connectors: * `/` division or ratio (as an infix + // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you + // should almost never have `/s` in a metric `unit`; rates should always + // be computed at query time from the underlying cumulative or delta + // value). * `.` multiplication or composition (as an infix operator). + // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as + // follows: Expression = Component { "." Component } { "/" Component } ; + // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | + // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a + // comment if it follows a `UNIT`. If the annotation is used alone, then + // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary [dimensionless - // unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, - // such as in `1/s`. It is typically used when none of the basic units - // are appropriate. For example, "new users per day" can be represented - // as `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new - // users). Alternatively, "thousands of page views per day" would be - // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric - // value of `5.3` would mean "5300 page views per day"). * `%` - // represents dimensionless value of 1/100, and annotates values giving - // a percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit of 1, such as in `1/s`. It is + // typically used when none of the basic units are appropriate. For + // example, "new users per day" can be represented as `1/d` or + // `{new-users}/d` (and a metric value `5` would mean "5 new users). + // Alternatively, "thousands of page views per day" would be represented + // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of + // `5.3` would mean "5300 page views per day"). * `%` represents + // dimensionless value of 1/100, and annotates values giving a + // percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -3867,11 +3843,10 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4081,11 +4056,11 @@ func (s *Type) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports [Google Cloud - // Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. - // To use Google Cloud Pub/Sub as the channel, this must be the name of - // a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format - // documented in https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub as a + // notification channel. To use Google Cloud Pub/Sub as the channel, + // this must be the name of a Cloud Pub/Sub topic that uses the Cloud + // Pub/Sub topic name format documented in + // https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer @@ -5577,9 +5552,8 @@ type ServicesListCall struct { // be filtered to only include services in a specific state, for example // to only include services enabled on the project. WARNING: If you need // to query enabled services frequently or across an organization, you -// should use [Cloud Asset Inventory -// API](https://cloud.google.com/asset-inventory/docs/apis), which -// provides higher throughput and richer filtering capability. +// should use Cloud Asset Inventory API, which provides higher +// throughput and richer filtering capability. func (r *ServicesService) List(parent string) *ServicesListCall { c := &ServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index 0100074011a..c9e87bac171 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -317,15 +317,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses [semantic versioning](http://semver.org) - // where the major version number indicates a breaking change and the - // minor version an additive, non-breaking change. Both version numbers - // are signals to users what to expect from different versions, and - // should be carefully chosen based on the product plan. The major - // version is also reflected in the package name of the interface, which - // must end in `v`, as in `google.feature.v1`. For major versions 0 and - // 1, the suffix can be omitted. Zero major versions must only be used - // for experimental, non-GA interfaces. + // The versioning schema uses semantic versioning where the major + // version number indicates a breaking change and the minor version an + // additive, non-breaking change. Both version numbers are signals to + // users what to expect from different versions, and should be carefully + // chosen based on the product plan. The major version is also reflected + // in the package name of the interface, which must end in `v`, as in + // `google.feature.v1`. For major versions 0 and 1, the suffix can be + // omitted. Zero major versions must only be used for experimental, + // non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -352,15 +352,11 @@ func (s *Api) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthProvider struct { - // Audiences: The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // JWTs with audiences: - + // Audiences: The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, JWTs with audiences: - // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs @@ -384,14 +380,10 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html# - // ProviderMetadata). Optional if the key set document: - can be - // retrieved from [OpenID - // Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html) - // of the issuer. - can be inferred from the email domain of the issuer - // (e.g. a Google service account). Example: - // https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery. Optional if the key set document: - + // can be retrieved from OpenID Discovery of the issuer. - can be + // inferred from the email domain of the issuer (e.g. a Google service + // account). Example: https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -429,19 +421,16 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for [JSON Web Token -// (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32) -// . +// support for JSON Web Token (JWT). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT - // [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-toke - // n-32#section-4.1.3). that are allowed to access. A JWT containing any - // of these audiences will be accepted. When this setting is absent, - // only JWTs with audience "https://Service_name/API_name" will be - // accepted. For example, if no audiences are in the setting, - // LibraryService API will only accept JWTs with the following audience + // components. The list of JWT audiences. that are allowed to access. A + // JWT containing any of these audiences will be accepted. When this + // setting is absent, only JWTs with audience + // "https://Service_name/API_name" will be accepted. For example, if no + // audiences are in the setting, LibraryService API will only accept + // JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1524,21 +1513,19 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing - // [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), - // aka cross-domain traffic, would allow the backends served from this - // endpoint to receive and respond to HTTP OPTIONS requests. The - // response will be used by the browser to determine whether the - // subsequent cross-origin request is allowed to proceed. + // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the + // backends served from this endpoint to receive and respond to HTTP + // OPTIONS requests. The response will be used by the browser to + // determine whether the subsequent cross-origin request is allowed to + // proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this [API - // Endpoint](https://cloud.google.com/apis/design/glossary). It should - // be either a valid IPv4 address or a fully-qualified domain name. For + // frontend that will handle requests to this API Endpoint. It should be + // either a valid IPv4 address or a fully-qualified domain name. For // example, "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` @@ -2184,33 +2171,29 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including [Google -// APIs](https://github.com/googleapis/googleapis), [Cloud -// Endpoints](https://cloud.google.com/endpoints), [gRPC -// Gateway](https://github.com/grpc-ecosystem/grpc-gateway), and -// [Envoy](https://github.com/envoyproxy/envoy) proxy support this -// feature and use it for large scale production services. `HttpRule` -// defines the schema of the gRPC/REST mapping. The mapping specifies -// how different portions of the gRPC request message are mapped to the -// URL path, URL query parameters, and HTTP request body. It also -// controls how the gRPC response message is mapped to the HTTP response -// body. `HttpRule` is typically specified as an `google.api.http` -// annotation on the gRPC method. Each mapping specifies a URL path -// template and an HTTP method. The path template may refer to one or -// more fields in the gRPC request message, as long as each field is a -// non-repeated field with a primitive (non-message) type. The path -// template controls how fields of the request message are mapped to the -// URL path. Example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option -// (google.api.http) = { get: "/v1/{name=messages/*}" }; } } message -// GetMessageRequest { string name = 1; // Mapped to URL path. } message -// Message { string text = 1; // The resource content. } This enables an -// HTTP REST to gRPC mapping as below: HTTP | gRPC -----|----- `GET -// /v1/messages/123456` | `GetMessage(name: "messages/123456")` Any -// fields in the request message which are not bound by the path -// template automatically become HTTP query parameters if there is no -// HTTP request body. For example: service Messaging { rpc -// GetMessage(GetMessageRequest) returns (Message) { option +// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud +// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use +// it for large scale production services. `HttpRule` defines the schema +// of the gRPC/REST mapping. The mapping specifies how different +// portions of the gRPC request message are mapped to the URL path, URL +// query parameters, and HTTP request body. It also controls how the +// gRPC response message is mapped to the HTTP response body. `HttpRule` +// is typically specified as an `google.api.http` annotation on the gRPC +// method. Each mapping specifies a URL path template and an HTTP +// method. The path template may refer to one or more fields in the gRPC +// request message, as long as each field is a non-repeated field with a +// primitive (non-message) type. The path template controls how fields +// of the request message are mapped to the URL path. Example: service +// Messaging { rpc GetMessage(GetMessageRequest) returns (Message) { +// option (google.api.http) = { get: "/v1/{name=messages/*}" }; } } +// message GetMessageRequest { string name = 1; // Mapped to URL path. } +// message Message { string text = 1; // The resource content. } This +// enables an HTTP REST to gRPC mapping as below: HTTP | gRPC +// -----|----- `GET /v1/messages/123456` | `GetMessage(name: +// "messages/123456")` Any fields in the request message which are not +// bound by the path template automatically become HTTP query parameters +// if there is no HTTP request body. For example: service Messaging { +// rpc GetMessage(GetMessageRequest) returns (Message) { option // (google.api.http) = { get:"/v1/messages/{message_id}" }; } } message // GetMessageRequest { message SubMessage { string subfield = 1; } // string message_id = 1; // Mapped to URL path. int64 revision = 2; // @@ -2290,16 +2273,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{var}`. If a variable contains multiple path segments, such as -// "{var=foo/*}" or "{var=**}", when such a variable is expanded -// into a URL path on the client side, all characters except -// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the -// reverse decoding, except "%2F" and "%2f" are left unchanged. Such -// variables show up in the [Discovery -// Document](https://developers.google.com/discovery/v1/reference/apis) -// as `{+var}`. ## Using gRPC API Service Configuration gRPC API Service +// Discovery Document as `{var}`. If a variable contains multiple path +// segments, such as "{var=foo/*}" or "{var=**}", when such a +// variable is expanded into a URL path on the client side, all +// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server +// side does the reverse decoding, except "%2F" and "%2f" are left +// unchanged. Such variables show up in the Discovery Document as +// `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The // service config is simply the YAML representation of the @@ -2315,14 +2295,12 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the [proto3 -// specification](https://developers.google.com/protocol-buffers/docs/pro -// to3#json). While the single segment variable follows the semantics of -// [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple -// String Expansion, the multi segment variable **does not** follow RFC -// 6570 Section 3.2.3 Reserved Expansion. The reason is that the -// Reserved Expansion does not expand special characters like `?` and -// `#`, which would lead to invalid URLs. As the result, gRPC +// to JSON conversion must follow the proto3 specification. While the +// single segment variable follows the semantics of RFC 6570 Section +// 3.2.2 Simple String Expansion, the multi segment variable **does +// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is +// that the Reserved Expansion does not expand special characters like +// `?` and `#`, which would lead to invalid URLs. As the result, gRPC // Transcoding uses a custom encoding for multi segment variables. The // path variables **must not** refer to any repeated or mapped field, // because client libraries are not capable of handling such variable @@ -3125,40 +3103,38 @@ type MetricDescriptor struct { // granular way, you can create a `DOUBLE CUMULATIVE` metric whose // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is - // `12005/1024`). The supported units are a subset of [The Unified Code - // for Units of Measure](http://unitsofmeasure.org/ucum.html) standard: - // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` - // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** - // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera - // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * - // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano - // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) - // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` - // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) - // **Grammar** The grammar also includes these connectors: * `/` - // division or ratio (as an infix operator). For examples, `kBy/{email}` - // or `MiBy/10ms` (although you should almost never have `/s` in a - // metric `unit`; rates should always be computed at query time from the - // underlying cumulative or delta value). * `.` multiplication or - // composition (as an infix operator). For examples, `GBy.d` or - // `k{watt}.h`. The grammar for a unit is as follows: Expression = - // Component { "." Component } { "/" Component } ; Component = ( [ - // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation - // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it - // follows a `UNIT`. If the annotation is used alone, then the unit is - // equivalent to `1`. For examples, `{request}/s == 1/s`, + // `12005/1024`). The supported units are a subset of The Unified Code + // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * + // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` + // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega + // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` + // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli + // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * + // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` + // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi + // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar + // also includes these connectors: * `/` division or ratio (as an infix + // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you + // should almost never have `/s` in a metric `unit`; rates should always + // be computed at query time from the underlying cumulative or delta + // value). * `.` multiplication or composition (as an infix operator). + // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as + // follows: Expression = Component { "." Component } { "/" Component } ; + // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | + // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a + // comment if it follows a `UNIT`. If the annotation is used alone, then + // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary [dimensionless - // unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, - // such as in `1/s`. It is typically used when none of the basic units - // are appropriate. For example, "new users per day" can be represented - // as `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new - // users). Alternatively, "thousands of page views per day" would be - // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric - // value of `5.3` would mean "5300 page views per day"). * `%` - // represents dimensionless value of 1/100, and annotates values giving - // a percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit of 1, such as in `1/s`. It is + // typically used when none of the basic units are appropriate. For + // example, "new users per day" can be represented as `1/d` or + // `{new-users}/d` (and a metric value `5` would mean "5 new users). + // Alternatively, "thousands of page views per day" would be represented + // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of + // `5.3` would mean "5300 page views per day"). * `%` represents + // dimensionless value of 1/100, and annotates values giving a + // percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -4329,11 +4305,10 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4543,11 +4518,11 @@ func (s *Type) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports [Google Cloud - // Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. - // To use Google Cloud Pub/Sub as the channel, this must be the name of - // a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format - // documented in https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub as a + // notification channel. To use Google Cloud Pub/Sub as the channel, + // this must be the name of a Cloud Pub/Sub topic that uses the Cloud + // Pub/Sub topic name format documented in + // https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer diff --git a/sheets/v4/sheets-gen.go b/sheets/v4/sheets-gen.go index b8a411b53f7..a2edb7f44ec 100644 --- a/sheets/v4/sheets-gen.go +++ b/sheets/v4/sheets-gen.go @@ -2285,9 +2285,8 @@ func (s *BigQueryQuerySpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// BigQueryTableSpec: Specifies a BigQuery table definition. Only -// [native tables](https://cloud.google.com/bigquery/docs/tables-intro) -// is allowed. +// BigQueryTableSpec: Specifies a BigQuery table definition. Only native +// tables is allowed. type BigQueryTableSpec struct { // DatasetId: The BigQuery dataset id. DatasetId string `json:"datasetId,omitempty"` @@ -4518,9 +4517,7 @@ func (s *DataSourceObjectReferences) MarshalJSON() ([]byte, error) { // a query. type DataSourceParameter struct { // Name: Named parameter. Must be a legitimate identifier for the - // DataSource that supports it. For example, [BigQuery - // identifier](https://cloud.google.com/bigquery/docs/reference/standard- - // sql/lexical#identifiers). + // DataSource that supports it. For example, BigQuery identifier. Name string `json:"name,omitempty"` // NamedRangeId: ID of a NamedRange. Its size must be 1x1. @@ -7543,9 +7540,8 @@ func (s *NamedRange) MarshalJSON() ([]byte, error) { type NumberFormat struct { // Pattern: Pattern string used for formatting. If not set, a default // pattern based on the user's locale will be used if necessary for the - // given type. See the [Date and Number Formats - // guide](/sheets/api/guides/formats) for more information about the - // supported patterns. + // given type. See the Date and Number Formats guide for more + // information about the supported patterns. Pattern string `json:"pattern,omitempty"` // Type: The type of the number format. When writing, this field must be @@ -12616,11 +12612,9 @@ type SpreadsheetsValuesAppendCall struct { // Append: Appends values to a spreadsheet. The input range is used to // search for existing data and find a "table" within that range. Values // will be appended to the next row of the table, starting with the -// first column of the table. See the -// [guide](/sheets/api/guides/values#appending_values) and [sample -// code](/sheets/api/samples/writing#append_values) for specific details -// of how tables are detected and data is appended. The caller must -// specify the spreadsheet ID, range, and a valueInputOption. The +// first column of the table. See the guide and sample code for specific +// details of how tables are detected and data is appended. The caller +// must specify the spreadsheet ID, range, and a valueInputOption. The // `valueInputOption` only controls how the input data will be added to // the sheet (column-wise or row-wise), it does not influence what cell // the data starts being written to. diff --git a/slides/v1/slides-gen.go b/slides/v1/slides-gen.go index 4b1cdf75cf6..7c60834c8fa 100644 --- a/slides/v1/slides-gen.go +++ b/slides/v1/slides-gen.go @@ -6939,11 +6939,10 @@ type WeightedFontFamily struct { // Weight: The rendered weight of the text. This field can have any // value that is a multiple of `100` between `100` and `900`, inclusive. // This range corresponds to the numerical values described in the CSS - // 2.1 Specification, [section - // 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with - // non-numerical values disallowed. Weights greater than or equal to - // `700` are considered bold, and weights less than `700`are not bold. - // The default value is `400` ("normal"). + // 2.1 Specification, section 15.6, with non-numerical values + // disallowed. Weights greater than or equal to `700` are considered + // bold, and weights less than `700`are not bold. The default value is + // `400` ("normal"). Weight int64 `json:"weight,omitempty"` // ForceSendFields is a list of field names (e.g. "FontFamily") to @@ -7639,8 +7638,8 @@ type PresentationsPagesGetThumbnailCall struct { // GetThumbnail: Generates a thumbnail of the latest version of the // specified page in the presentation and returns a URL to the thumbnail -// image. This request counts as an [expensive read -// request](/slides/limits) for quota purposes. +// image. This request counts as an expensive read request for quota +// purposes. func (r *PresentationsPagesService) GetThumbnail(presentationId string, pageObjectId string) *PresentationsPagesGetThumbnailCall { c := &PresentationsPagesGetThumbnailCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.presentationId = presentationId diff --git a/sourcerepo/v1/sourcerepo-gen.go b/sourcerepo/v1/sourcerepo-gen.go index 54dcc3969ec..a67c8df17ee 100644 --- a/sourcerepo/v1/sourcerepo-gen.go +++ b/sourcerepo/v1/sourcerepo-gen.go @@ -277,9 +277,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -566,9 +564,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -586,8 +583,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -626,9 +623,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -836,11 +832,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -926,8 +921,7 @@ type SyncRepoRequest struct { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // allowed. For more information see IAM Overview. Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1787,9 +1781,7 @@ func (r *ProjectsReposService) GetIamPolicy(resource string) *ProjectsReposGetIa // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// policies, see the IAM documentation. func (c *ProjectsReposGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsReposGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index 2c3fe521804..861a1f6806f 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -496,9 +496,7 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // IAM policies, see the IAM documentation. Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1380,9 +1378,7 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // policies, see the IAM documentation. RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1433,18 +1429,17 @@ type Instance struct { // how resource metrics are aggregated. And they can be used as // arguments to policy management rules (e.g. route, firewall, load // balancing, etc.). * Label keys must be between 1 and 63 characters - // long and must conform to the following regular expression: - // `[a-z]([-a-z0-9]*[a-z0-9])?`. * Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. * No more than 64 labels can be - // associated with a given resource. See https://goo.gl/xmQnxf for more - // information on and examples of labels. If you plan to use labels in - // your own code, please note that additional characters may be allowed - // in the future. And so you are advised to use an internal label - // representation, such as JSON, which doesn't rely upon specific - // characters being disallowed. For example, representing labels as the - // string: name + "_" + value would prove problematic if we were to - // allow "_" in a future release. + // long and must conform to the following regular expression: `a-z?`. * + // Label values must be between 0 and 63 characters long and must + // conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. * + // No more than 64 labels can be associated with a given resource. See + // https://goo.gl/xmQnxf for more information on and examples of labels. + // If you plan to use labels in your own code, please note that + // additional characters may be allowed in the future. And so you are + // advised to use an internal label representation, such as JSON, which + // doesn't rely upon specific characters being disallowed. For example, + // representing labels as the string: name + "_" + value would prove + // problematic if we were to allow "_" in a future release. Labels map[string]string `json:"labels,omitempty"` // Name: Required. A unique identifier for the instance, which cannot be @@ -1455,9 +1450,7 @@ type Instance struct { // NodeCount: The number of nodes allocated to this instance. This may // be zero in API responses for instances that are not yet in state - // `READY`. See [the - // documentation](https://cloud.google.com/spanner/docs/instances#node_co - // unt) for more information about nodes. + // `READY`. See the documentation for more information about nodes. NodeCount int64 `json:"nodeCount,omitempty"` // State: Output only. The current instance state. For CreateInstance, @@ -2562,9 +2555,8 @@ func (s *PlanNode) MarshalJSON() ([]byte, error) { // expression that allows access to a resource only if the expression // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which -// resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). **JSON example:** { "bindings": [ { "role": +// resources support conditions in their IAM policies, see the IAM +// documentation. **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2582,8 +2574,8 @@ func (s *PlanNode) MarshalJSON() ([]byte, error) { // condition: title: expirable access description: Does not grant access // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: -// 3 For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). +// 3 For a description of IAM and its features, see the IAM +// documentation. type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -2618,9 +2610,8 @@ type Policy struct { // of the conditions in the version `3` policy are lost. If a policy // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // resources support conditions in their IAM policies, see the IAM + // documentation. Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2877,9 +2868,7 @@ type ReadWrite struct { type ReplicaInfo struct { // DefaultLeaderLocation: If true, this location is designated as the // default leader location where leader replicas are placed. See the - // [region types - // documentation](https://cloud.google.com/spanner/docs/instances#region_ - // types) for more details. + // region types documentation for more details. DefaultLeaderLocation bool `json:"defaultLeaderLocation,omitempty"` // Location: The location of the serving resources, e.g. "us-central1". @@ -3236,11 +3225,11 @@ type Session struct { // Labels: The labels for the session. * Label keys must be between 1 // and 63 characters long and must conform to the following regular - // expression: `[a-z]([-a-z0-9]*[a-z0-9])?`. * Label values must be - // between 0 and 63 characters long and must conform to the regular - // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. * No more than 64 labels - // can be associated with a given session. See https://goo.gl/xmQnxf for - // more information on and examples of labels. + // expression: `a-z?`. * Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. * No more than 64 labels can be + // associated with a given session. See https://goo.gl/xmQnxf for more + // information on and examples of labels. Labels map[string]string `json:"labels,omitempty"` // Name: Output only. The name of the session. This is always @@ -3392,11 +3381,10 @@ func (s *Statement) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4179,7 +4167,7 @@ func (c *ProjectsInstanceConfigsGetCall) Header() http.Header { func (c *ProjectsInstanceConfigsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4341,7 +4329,7 @@ func (c *ProjectsInstanceConfigsListCall) Header() http.Header { func (c *ProjectsInstanceConfigsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4527,7 +4515,7 @@ func (c *ProjectsInstancesCreateCall) Header() http.Header { func (c *ProjectsInstancesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4670,7 +4658,7 @@ func (c *ProjectsInstancesDeleteCall) Header() http.Header { func (c *ProjectsInstancesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4820,7 +4808,7 @@ func (c *ProjectsInstancesGetCall) Header() http.Header { func (c *ProjectsInstancesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4965,7 +4953,7 @@ func (c *ProjectsInstancesGetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5148,7 +5136,7 @@ func (c *ProjectsInstancesListCall) Header() http.Header { func (c *ProjectsInstancesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5343,7 +5331,7 @@ func (c *ProjectsInstancesPatchCall) Header() http.Header { func (c *ProjectsInstancesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5486,7 +5474,7 @@ func (c *ProjectsInstancesSetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5631,7 +5619,7 @@ func (c *ProjectsInstancesTestIamPermissionsCall) Header() http.Header { func (c *ProjectsInstancesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5839,7 +5827,7 @@ func (c *ProjectsInstancesBackupOperationsListCall) Header() http.Header { func (c *ProjectsInstancesBackupOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6028,7 +6016,7 @@ func (c *ProjectsInstancesBackupsCreateCall) Header() http.Header { func (c *ProjectsInstancesBackupsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6172,7 +6160,7 @@ func (c *ProjectsInstancesBackupsDeleteCall) Header() http.Header { func (c *ProjectsInstancesBackupsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6314,7 +6302,7 @@ func (c *ProjectsInstancesBackupsGetCall) Header() http.Header { func (c *ProjectsInstancesBackupsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6455,7 +6443,7 @@ func (c *ProjectsInstancesBackupsGetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesBackupsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6651,7 +6639,7 @@ func (c *ProjectsInstancesBackupsListCall) Header() http.Header { func (c *ProjectsInstancesBackupsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6835,7 +6823,7 @@ func (c *ProjectsInstancesBackupsPatchCall) Header() http.Header { func (c *ProjectsInstancesBackupsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6986,7 +6974,7 @@ func (c *ProjectsInstancesBackupsSetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesBackupsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7134,7 +7122,7 @@ func (c *ProjectsInstancesBackupsTestIamPermissionsCall) Header() http.Header { func (c *ProjectsInstancesBackupsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7282,7 +7270,7 @@ func (c *ProjectsInstancesBackupsOperationsCancelCall) Header() http.Header { func (c *ProjectsInstancesBackupsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7416,7 +7404,7 @@ func (c *ProjectsInstancesBackupsOperationsDeleteCall) Header() http.Header { func (c *ProjectsInstancesBackupsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7560,7 +7548,7 @@ func (c *ProjectsInstancesBackupsOperationsGetCall) Header() http.Header { func (c *ProjectsInstancesBackupsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7735,7 +7723,7 @@ func (c *ProjectsInstancesBackupsOperationsListCall) Header() http.Header { func (c *ProjectsInstancesBackupsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7973,7 +7961,7 @@ func (c *ProjectsInstancesDatabaseOperationsListCall) Header() http.Header { func (c *ProjectsInstancesDatabaseOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8150,7 +8138,7 @@ func (c *ProjectsInstancesDatabasesCreateCall) Header() http.Header { func (c *ProjectsInstancesDatabasesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8291,7 +8279,7 @@ func (c *ProjectsInstancesDatabasesDropDatabaseCall) Header() http.Header { func (c *ProjectsInstancesDatabasesDropDatabaseCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8433,7 +8421,7 @@ func (c *ProjectsInstancesDatabasesGetCall) Header() http.Header { func (c *ProjectsInstancesDatabasesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8580,7 +8568,7 @@ func (c *ProjectsInstancesDatabasesGetDdlCall) Header() http.Header { func (c *ProjectsInstancesDatabasesGetDdlCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8721,7 +8709,7 @@ func (c *ProjectsInstancesDatabasesGetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesDatabasesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8887,7 +8875,7 @@ func (c *ProjectsInstancesDatabasesListCall) Header() http.Header { func (c *ProjectsInstancesDatabasesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9067,7 +9055,7 @@ func (c *ProjectsInstancesDatabasesRestoreCall) Header() http.Header { func (c *ProjectsInstancesDatabasesRestoreCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9212,7 +9200,7 @@ func (c *ProjectsInstancesDatabasesSetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9360,7 +9348,7 @@ func (c *ProjectsInstancesDatabasesTestIamPermissionsCall) Header() http.Header func (c *ProjectsInstancesDatabasesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9506,7 +9494,7 @@ func (c *ProjectsInstancesDatabasesUpdateDdlCall) Header() http.Header { func (c *ProjectsInstancesDatabasesUpdateDdlCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9654,7 +9642,7 @@ func (c *ProjectsInstancesDatabasesOperationsCancelCall) Header() http.Header { func (c *ProjectsInstancesDatabasesOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9788,7 +9776,7 @@ func (c *ProjectsInstancesDatabasesOperationsDeleteCall) Header() http.Header { func (c *ProjectsInstancesDatabasesOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9932,7 +9920,7 @@ func (c *ProjectsInstancesDatabasesOperationsGetCall) Header() http.Header { func (c *ProjectsInstancesDatabasesOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10107,7 +10095,7 @@ func (c *ProjectsInstancesDatabasesOperationsListCall) Header() http.Header { func (c *ProjectsInstancesDatabasesOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10282,7 +10270,7 @@ func (c *ProjectsInstancesDatabasesSessionsBatchCreateCall) Header() http.Header func (c *ProjectsInstancesDatabasesSessionsBatchCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10425,7 +10413,7 @@ func (c *ProjectsInstancesDatabasesSessionsBeginTransactionCall) Header() http.H func (c *ProjectsInstancesDatabasesSessionsBeginTransactionCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10577,7 +10565,7 @@ func (c *ProjectsInstancesDatabasesSessionsCommitCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsCommitCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10730,7 +10718,7 @@ func (c *ProjectsInstancesDatabasesSessionsCreateCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10871,7 +10859,7 @@ func (c *ProjectsInstancesDatabasesSessionsDeleteCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11012,7 +11000,7 @@ func (c *ProjectsInstancesDatabasesSessionsExecuteBatchDmlCall) Header() http.He func (c *ProjectsInstancesDatabasesSessionsExecuteBatchDmlCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11160,7 +11148,7 @@ func (c *ProjectsInstancesDatabasesSessionsExecuteSqlCall) Header() http.Header func (c *ProjectsInstancesDatabasesSessionsExecuteSqlCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11304,7 +11292,7 @@ func (c *ProjectsInstancesDatabasesSessionsExecuteStreamingSqlCall) Header() htt func (c *ProjectsInstancesDatabasesSessionsExecuteStreamingSqlCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11456,7 +11444,7 @@ func (c *ProjectsInstancesDatabasesSessionsGetCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11629,7 +11617,7 @@ func (c *ProjectsInstancesDatabasesSessionsListCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11812,7 +11800,7 @@ func (c *ProjectsInstancesDatabasesSessionsPartitionQueryCall) Header() http.Hea func (c *ProjectsInstancesDatabasesSessionsPartitionQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11965,7 +11953,7 @@ func (c *ProjectsInstancesDatabasesSessionsPartitionReadCall) Header() http.Head func (c *ProjectsInstancesDatabasesSessionsPartitionReadCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12114,7 +12102,7 @@ func (c *ProjectsInstancesDatabasesSessionsReadCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsReadCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12260,7 +12248,7 @@ func (c *ProjectsInstancesDatabasesSessionsRollbackCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsRollbackCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12404,7 +12392,7 @@ func (c *ProjectsInstancesDatabasesSessionsStreamingReadCall) Header() http.Head func (c *ProjectsInstancesDatabasesSessionsStreamingReadCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12552,7 +12540,7 @@ func (c *ProjectsInstancesOperationsCancelCall) Header() http.Header { func (c *ProjectsInstancesOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12686,7 +12674,7 @@ func (c *ProjectsInstancesOperationsDeleteCall) Header() http.Header { func (c *ProjectsInstancesOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12830,7 +12818,7 @@ func (c *ProjectsInstancesOperationsGetCall) Header() http.Header { func (c *ProjectsInstancesOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -13005,7 +12993,7 @@ func (c *ProjectsInstancesOperationsListCall) Header() http.Header { func (c *ProjectsInstancesOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/speech/v1/speech-gen.go b/speech/v1/speech-gen.go index be148b457fb..a8d24f737e6 100644 --- a/speech/v1/speech-gen.go +++ b/speech/v1/speech-gen.go @@ -406,8 +406,7 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // RecognitionAudio: Contains audio data in the encoding specified in // the `RecognitionConfig`. Either `content` or `uri` must be supplied. // Supplying both or neither returns google.rpc.Code.INVALID_ARGUMENT. -// See [content -// limits](https://cloud.google.com/speech-to-text/quotas#content). +// See content limits. type RecognitionAudio struct { // Content: The audio data bytes encoded as specified in // `RecognitionConfig`. Note: as with all bytes fields, proto buffers @@ -420,8 +419,8 @@ type RecognitionAudio struct { // (for example, gzip). Currently, only Google Cloud Storage URIs are // supported, which must be specified in the following format: // `gs://bucket_name/object_name` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see [Request - // URIs](https://cloud.google.com/storage/docs/reference-uris). + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -532,10 +531,8 @@ type RecognitionConfig struct { Encoding string `json:"encoding,omitempty"` // LanguageCode: Required. The language of the supplied audio as a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. - // Example: "en-US". See [Language - // Support](https://cloud.google.com/speech-to-text/docs/languages) for - // a list of the currently supported language codes. + // BCP-47 language tag. Example: "en-US". See Language Support for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Maximum number of recognition hypotheses to be @@ -581,9 +578,8 @@ type RecognitionConfig struct { SampleRateHertz int64 `json:"sampleRateHertz,omitempty"` // SpeechContexts: Array of SpeechContext. A means to provide context to - // assist the speech recognition. For more information, see [speech - // adaptation](https://cloud.google.com/speech-to-text/docs/context-stren - // gth). + // assist the speech recognition. For more information, see speech + // adaptation. SpeechContexts []*SpeechContext `json:"speechContexts,omitempty"` // UseEnhanced: Set to true to use an enhanced model for speech @@ -848,13 +844,11 @@ type SpeechContext struct { // can be used to improve the accuracy for specific words and phrases, // for example, if specific commands are typically spoken by the user. // This can also be used to add additional words to the vocabulary of - // the recognizer. See [usage - // limits](https://cloud.google.com/speech-to-text/quotas#content). List - // items can also be set to classes for groups of words that represent - // common concepts that occur in natural language. For example, rather - // than providing phrase hints for every month of the year, using the - // $MONTH class improves the likelihood of correctly transcribing audio - // that includes months. + // the recognizer. See usage limits. List items can also be set to + // classes for groups of words that represent common concepts that occur + // in natural language. For example, rather than providing phrase hints + // for every month of the year, using the $MONTH class improves the + // likelihood of correctly transcribing audio that includes months. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -978,11 +972,10 @@ func (s *SpeechRecognitionResult) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1795,9 +1788,7 @@ type SpeechLongrunningrecognizeCall struct { // receive results via the google.longrunning.Operations interface. // Returns either an `Operation.error` or an `Operation.response` which // contains a `LongRunningRecognizeResponse` message. For more -// information on asynchronous speech recognition, see the -// [how-to](https://cloud.google.com/speech-to-text/docs/async-recognize) -// . +// information on asynchronous speech recognition, see the how-to. func (r *SpeechService) Longrunningrecognize(longrunningrecognizerequest *LongRunningRecognizeRequest) *SpeechLongrunningrecognizeCall { c := &SpeechLongrunningrecognizeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.longrunningrecognizerequest = longrunningrecognizerequest diff --git a/speech/v1p1beta1/speech-gen.go b/speech/v1p1beta1/speech-gen.go index fbb687047bb..e59e783e6ab 100644 --- a/speech/v1p1beta1/speech-gen.go +++ b/speech/v1p1beta1/speech-gen.go @@ -475,21 +475,19 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // to improve the accuracy for specific words and phrases, for example, // if specific commands are typically spoken by the user. This can also // be used to add additional words to the vocabulary of the recognizer. -// See [usage -// limits](https://cloud.google.com/speech-to-text/quotas#content). List -// items can also include pre-built or custom classes containing groups -// of words that represent common concepts that occur in natural -// language. For example, rather than providing a phrase hint for every -// month of the year (e.g. "i was born in january", "i was born in -// febuary", ...), use the pre-built `$MONTH` class improves the -// likelihood of correctly transcribing audio that includes months (e.g. -// "i was born in $month"). To refer to pre-built classes, use the -// class' symbol prepended with `$` e.g. `$MONTH`. To refer to custom -// classes that were defined inline in the request, set the class's -// `custom_class_id` to a string unique to all class resources and -// inline classes. Then use the class' id wrapped in $`{...}` e.g. -// "${my-months}". To refer to custom classes resources, use the class' -// id wrapped in `${}` (e.g. `${my-months}`). +// See usage limits. List items can also include pre-built or custom +// classes containing groups of words that represent common concepts +// that occur in natural language. For example, rather than providing a +// phrase hint for every month of the year (e.g. "i was born in +// january", "i was born in febuary", ...), use the pre-built `$MONTH` +// class improves the likelihood of correctly transcribing audio that +// includes months (e.g. "i was born in $month"). To refer to pre-built +// classes, use the class' symbol prepended with `$` e.g. `$MONTH`. To +// refer to custom classes that were defined inline in the request, set +// the class's `custom_class_id` to a string unique to all class +// resources and inline classes. Then use the class' id wrapped in +// $`{...}` e.g. "${my-months}". To refer to custom classes resources, +// use the class' id wrapped in `${}` (e.g. `${my-months}`). type Phrase struct { // Boost: Hint Boost. Overrides the boost set at the phrase set level. // Positive value will increase the probability that a specific phrase @@ -605,8 +603,7 @@ func (s *PhraseSet) UnmarshalJSON(data []byte) error { // RecognitionAudio: Contains audio data in the encoding specified in // the `RecognitionConfig`. Either `content` or `uri` must be supplied. // Supplying both or neither returns google.rpc.Code.INVALID_ARGUMENT. -// See [content -// limits](https://cloud.google.com/speech-to-text/quotas#content). +// See content limits. type RecognitionAudio struct { // Content: The audio data bytes encoded as specified in // `RecognitionConfig`. Note: as with all bytes fields, proto buffers @@ -619,8 +616,8 @@ type RecognitionAudio struct { // (for example, gzip). Currently, only Google Cloud Storage URIs are // supported, which must be specified in the following format: // `gs://bucket_name/object_name` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see [Request - // URIs](https://cloud.google.com/storage/docs/reference-uris). + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -651,23 +648,20 @@ func (s *RecognitionAudio) MarshalJSON() ([]byte, error) { type RecognitionConfig struct { // Adaptation: Speech adaptation configuration improves the accuracy of // speech recognition. When speech adaptation is set it supersedes the - // `speech_contexts` field. For more information, see the [speech - // adaptation](https://cloud.google.com/speech-to-text/docs/context-stren - // gth) documentation. + // `speech_contexts` field. For more information, see the speech + // adaptation documentation. Adaptation *SpeechAdaptation `json:"adaptation,omitempty"` - // AlternativeLanguageCodes: A list of up to 3 additional - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags, - // listing possible alternative languages of the supplied audio. See - // [Language - // Support](https://cloud.google.com/speech-to-text/docs/languages) for - // a list of the currently supported language codes. If alternative - // languages are listed, recognition result will contain recognition in - // the most likely language detected including the main language_code. - // The recognition result will include the language tag of the language - // detected in the audio. Note: This feature is only supported for Voice - // Command and Voice Search use cases and performance may vary for other - // use cases (e.g., phone call transcription). + // AlternativeLanguageCodes: A list of up to 3 additional BCP-47 + // language tags, listing possible alternative languages of the supplied + // audio. See Language Support for a list of the currently supported + // language codes. If alternative languages are listed, recognition + // result will contain recognition in the most likely language detected + // including the main language_code. The recognition result will include + // the language tag of the language detected in the audio. Note: This + // feature is only supported for Voice Command and Voice Search use + // cases and performance may vary for other use cases (e.g., phone call + // transcription). AlternativeLanguageCodes []string `json:"alternativeLanguageCodes,omitempty"` // AudioChannelCount: The number of channels in the input audio data. @@ -774,10 +768,8 @@ type RecognitionConfig struct { Encoding string `json:"encoding,omitempty"` // LanguageCode: Required. The language of the supplied audio as a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. - // Example: "en-US". See [Language - // Support](https://cloud.google.com/speech-to-text/docs/languages) for - // a list of the currently supported language codes. + // BCP-47 language tag. Example: "en-US". See Language Support for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Maximum number of recognition hypotheses to be @@ -823,9 +815,8 @@ type RecognitionConfig struct { SampleRateHertz int64 `json:"sampleRateHertz,omitempty"` // SpeechContexts: Array of SpeechContext. A means to provide context to - // assist the speech recognition. For more information, see [speech - // adaptation](https://cloud.google.com/speech-to-text/docs/context-stren - // gth). + // assist the speech recognition. For more information, see speech + // adaptation. SpeechContexts []*SpeechContext `json:"speechContexts,omitempty"` // UseEnhanced: Set to true to use an enhanced model for speech @@ -1140,13 +1131,11 @@ type SpeechContext struct { // can be used to improve the accuracy for specific words and phrases, // for example, if specific commands are typically spoken by the user. // This can also be used to add additional words to the vocabulary of - // the recognizer. See [usage - // limits](https://cloud.google.com/speech-to-text/quotas#content). List - // items can also be set to classes for groups of words that represent - // common concepts that occur in natural language. For example, rather - // than providing phrase hints for every month of the year, using the - // $MONTH class improves the likelihood of correctly transcribing audio - // that includes months. + // the recognizer. See usage limits. List items can also be set to + // classes for groups of words that represent common concepts that occur + // in natural language. For example, rather than providing phrase hints + // for every month of the year, using the $MONTH class improves the + // likelihood of correctly transcribing audio that includes months. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to @@ -1259,10 +1248,9 @@ type SpeechRecognitionResult struct { // from '1' to 'N'. ChannelTag int64 `json:"channelTag,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1290,11 +1278,10 @@ func (s *SpeechRecognitionResult) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2130,9 +2117,7 @@ type SpeechLongrunningrecognizeCall struct { // receive results via the google.longrunning.Operations interface. // Returns either an `Operation.error` or an `Operation.response` which // contains a `LongRunningRecognizeResponse` message. For more -// information on asynchronous speech recognition, see the -// [how-to](https://cloud.google.com/speech-to-text/docs/async-recognize) -// . +// information on asynchronous speech recognition, see the how-to. func (r *SpeechService) Longrunningrecognize(longrunningrecognizerequest *LongRunningRecognizeRequest) *SpeechLongrunningrecognizeCall { c := &SpeechLongrunningrecognizeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.longrunningrecognizerequest = longrunningrecognizerequest diff --git a/speech/v2beta1/speech-gen.go b/speech/v2beta1/speech-gen.go index 0b939736031..0782fb8325c 100644 --- a/speech/v2beta1/speech-gen.go +++ b/speech/v2beta1/speech-gen.go @@ -420,10 +420,9 @@ type SpeechRecognitionResult struct { // from `1` to `N`. ChannelTag int64 `json:"channelTag,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -451,11 +450,10 @@ func (s *SpeechRecognitionResult) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/storagetransfer/v1/storagetransfer-gen.go b/storagetransfer/v1/storagetransfer-gen.go index 8e0fea4c334..10dcceed8a0 100644 --- a/storagetransfer/v1/storagetransfer-gen.go +++ b/storagetransfer/v1/storagetransfer-gen.go @@ -168,11 +168,9 @@ type TransferOperationsService struct { s *Service } -// AwsAccessKey: AWS access key (see [AWS Security -// Credentials](https://docs.aws.amazon.com/general/latest/gr/aws-securit -// y-credentials.html)). For information on our data retention policy -// for user credentials, see [User -// credentials](data-retention#user-credentials). +// AwsAccessKey: AWS access key (see AWS Security Credentials). For +// information on our data retention policy for user credentials, see +// User credentials. type AwsAccessKey struct { // AccessKeyId: Required. AWS access key ID. AccessKeyId string `json:"accessKeyId,omitempty"` @@ -211,13 +209,10 @@ type AwsS3Data struct { // AwsAccessKey: Required. Input only. AWS access key used to sign the // API requests to the AWS S3 bucket. Permissions on the bucket must be // granted to the access ID of the AWS access key. For information on - // our data retention policy for user credentials, see [User - // credentials](data-retention#user-credentials). + // our data retention policy for user credentials, see User credentials. AwsAccessKey *AwsAccessKey `json:"awsAccessKey,omitempty"` - // BucketName: Required. S3 Bucket name (see [Creating a - // bucket](https://docs.aws.amazon.com/AmazonS3/latest/dev/create-bucket- - // get-location-example.html)). + // BucketName: Required. S3 Bucket name (see Creating a bucket). BucketName string `json:"bucketName,omitempty"` // ForceSendFields is a list of field names (e.g. "AwsAccessKey") to @@ -246,18 +241,12 @@ func (s *AwsS3Data) MarshalJSON() ([]byte, error) { // AzureBlobStorageData: An AzureBlobStorageData resource can be a data // source, but not a data sink. An AzureBlobStorageData resource // represents one Azure container. The storage account determines the -// [Azure -// endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storag -// e-create-storage-account#storage-account-endpoints). In an -// AzureBlobStorageData resource, a blobs's name is the [Azure Blob -// Storage blob's key -// name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming -// -and-referencing-containers--blobs--and-metadata#blob-names). +// Azure endpoint. In an AzureBlobStorageData resource, a blobs's name +// is the Azure Blob Storage blob's key name. type AzureBlobStorageData struct { // AzureCredentials: Required. Input only. Credentials used to // authenticate API requests to Azure. For information on our data - // retention policy for user credentials, see [User - // credentials](data-retention#user-credentials). + // retention policy for user credentials, see User credentials. AzureCredentials *AzureCredentials `json:"azureCredentials,omitempty"` // Container: Required. The container to transfer from the Azure Storage @@ -292,14 +281,11 @@ func (s *AzureBlobStorageData) MarshalJSON() ([]byte, error) { } // AzureCredentials: Azure credentials For information on our data -// retention policy for user credentials, see [User -// credentials](data-retention#user-credentials). +// retention policy for user credentials, see User credentials. type AzureCredentials struct { - // SasToken: Required. Azure shared access signature. (see [Grant - // limited access to Azure Storage resources using shared access - // signatures - // (SAS)](https://docs.microsoft.com/en-us/azure/storage/common/storage-s - // as-overview)). + // SasToken: Required. Azure shared access signature. (see Grant limited + // access to Azure Storage resources using shared access signatures + // (SAS)). SasToken string `json:"sasToken,omitempty"` // ForceSendFields is a list of field names (e.g. "SasToken") to @@ -550,9 +536,8 @@ func (s *ErrorSummary) MarshalJSON() ([]byte, error) { // `updated` property of Cloud Storage objects, which changes when the // content or the metadata of the object is updated. type GcsData struct { - // BucketName: Required. Cloud Storage bucket name (see [Bucket Name - // Requirements](https://cloud.google.com/storage/docs/naming#requirement - // s)). + // BucketName: Required. Cloud Storage bucket name (see Bucket Name + // Requirements). BucketName string `json:"bucketName,omitempty"` // ForceSendFields is a list of field names (e.g. "BucketName") to @@ -619,17 +604,16 @@ func (s *GoogleServiceAccount) MarshalJSON() ([]byte, error) { // following tab-delimited fields: * **HTTP URL** — The location of // the object. * **Length** — The size of the object in bytes. * // **MD5** — The base64-encoded MD5 hash of the object. For an example -// of a valid TSV file, see [Transferring data from -// URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). -// When transferring data based on a URL list, keep the following in -// mind: * When an object located at `http(s)://hostname:port/` is -// transferred to a data sink, the name of the object at the data sink -// is `/`. * If the specified size of an object does not match the -// actual size of the object fetched, the object will not be -// transferred. * If the specified MD5 does not match the MD5 computed -// from the transferred bytes, the object transfer will fail. * Ensure -// that each URL you specify is publicly accessible. For example, in -// Cloud Storage you can [share an object publicly] +// of a valid TSV file, see Transferring data from URLs. When +// transferring data based on a URL list, keep the following in mind: * +// When an object located at `http(s)://hostname:port/` is transferred +// to a data sink, the name of the object at the data sink is `/`. * If +// the specified size of an object does not match the actual size of the +// object fetched, the object will not be transferred. * If the +// specified MD5 does not match the MD5 computed from the transferred +// bytes, the object transfer will fail. * Ensure that each URL you +// specify is publicly accessible. For example, in Cloud Storage you can +// [share an object publicly] // (https://cloud.google.com/storage/docs/cloud-console#_sharingdata) // and get a link to it. * Storage Transfer Service obeys `robots.txt` // rules and requires the source HTTP server to support `Range` requests @@ -1041,11 +1025,10 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1583,7 +1566,7 @@ func (c *GoogleServiceAccountsGetCall) Header() http.Header { func (c *GoogleServiceAccountsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1715,7 +1698,7 @@ func (c *TransferJobsCreateCall) Header() http.Header { func (c *TransferJobsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1852,7 +1835,7 @@ func (c *TransferJobsGetCall) Header() http.Header { func (c *TransferJobsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2016,7 +1999,7 @@ func (c *TransferJobsListCall) Header() http.Header { func (c *TransferJobsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2182,7 +2165,7 @@ func (c *TransferJobsPatchCall) Header() http.Header { func (c *TransferJobsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2340,7 +2323,7 @@ func (c *TransferOperationsCancelCall) Header() http.Header { func (c *TransferOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2491,7 +2474,7 @@ func (c *TransferOperationsGetCall) Header() http.Header { func (c *TransferOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2650,7 +2633,7 @@ func (c *TransferOperationsListCall) Header() http.Header { func (c *TransferOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2824,7 +2807,7 @@ func (c *TransferOperationsPauseCall) Header() http.Header { func (c *TransferOperationsPauseCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2964,7 +2947,7 @@ func (c *TransferOperationsResumeCall) Header() http.Header { func (c *TransferOperationsResumeCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201208") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/streetviewpublish/v1/streetviewpublish-gen.go b/streetviewpublish/v1/streetviewpublish-gen.go index 576cfb10675..fe01f719dca 100644 --- a/streetviewpublish/v1/streetviewpublish-gen.go +++ b/streetviewpublish/v1/streetviewpublish-gen.go @@ -841,11 +841,10 @@ func (s *Pose) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -973,9 +972,8 @@ type PhotoCreateCall struct { // Create: After the client finishes uploading the photo with the // returned UploadRef, CreatePhoto publishes the uploaded Photo to // Street View on Google Maps. Currently, the only way to set heading, -// pitch, and roll in CreatePhoto is through the [Photo Sphere XMP -// metadata](https://developers.google.com/streetview/spherical-metadata) -// in the photo bytes. CreatePhoto ignores the `pose.heading`, +// pitch, and roll in CreatePhoto is through the Photo Sphere XMP +// metadata in the photo bytes. CreatePhoto ignores the `pose.heading`, // `pose.pitch`, `pose.roll`, `pose.altitude`, and `pose.level` fields // in Pose. This method returns the following error codes: * // google.rpc.Code.INVALID_ARGUMENT if the request is malformed or if diff --git a/sts/v1beta/sts-gen.go b/sts/v1beta/sts-gen.go index 96daf899af1..0183ac6533c 100644 --- a/sts/v1beta/sts-gen.go +++ b/sts/v1beta/sts-gen.go @@ -167,20 +167,16 @@ type GoogleIdentityStsV1betaExchangeTokenRequest struct { // SubjectToken: Required. The input token. This token is a either an // external credential issued by a workload identity pool provider, or a // short-lived access token issued by Google. If the token is an OIDC - // JWT, it must use the JWT format defined in [RFC - // 7523](https://tools.ietf.org/html/rfc7523), and the + // JWT, it must use the JWT format defined in RFC 7523, and the // `subject_token_type` must be `urn:ietf:params:oauth:token-type:jwt`. // The following headers are required: - `kid`: The identifier of the // signing key securing the JWT. - `alg`: The cryptographic algorithm // securing the JWT. Must be `RS256`. The following payload fields are - // required. For more information, see [RFC 7523, Section - // 3](https://tools.ietf.org/html/rfc7523#section-3): - `iss`: The + // required. For more information, see RFC 7523, Section 3: - `iss`: The // issuer of the token. The issuer must provide a discovery document at // the URL `/.well-known/openid-configuration`, where `` is the value of // this field. The document must be formatted according to section 4.2 - // of the [OIDC 1.0 Discovery - // specification](https://openid.net/specs/openid-connect-discovery-1_0.h - // tml#ProviderConfigurationResponse). - `iat`: The issue time, in + // of the OIDC 1.0 Discovery specification. - `iat`: The issue time, in // seconds, since the Unix epoch. Must be in the past. - `exp`: The // expiration time, in seconds, since the Unix epoch. Must be less than // 48 hours after `iat`. Shorter expiration times are more secure. If @@ -192,24 +188,19 @@ type GoogleIdentityStsV1betaExchangeTokenRequest struct { // 1517963104, "exp": 1517966704, "aud": "113475438248934895348", "sub": // "113475438248934895348", "my_claims": { "additional_claim": "value" } // } ``` If `subject_token` is an AWS token, it must be a serialized, - // [signed](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api - // _requests.html) request to the AWS - // [`GetCallerIdentity()`](https://docs.aws.amazon.com/STS/latest/APIRefe - // rence/API_GetCallerIdentity) method. Format the request as - // URL-encoded JSON, and set the `subject_token_type` parameter to - // `urn:ietf:params:aws:token-type:aws4_request`. The following - // parameters are required: - `url`: The URL of the AWS STS endpoint for - // `GetCallerIdentity()`, such as + // signed request to the AWS `GetCallerIdentity()` method. Format the + // request as URL-encoded JSON, and set the `subject_token_type` + // parameter to `urn:ietf:params:aws:token-type:aws4_request`. The + // following parameters are required: - `url`: The URL of the AWS STS + // endpoint for `GetCallerIdentity()`, such as // `https://sts.amazonaws.com?Action=GetCallerIdentity&Version=2011-06-15 // `. Regional endpoints are also supported. - `method`: The HTTP // request method: `POST`. - `headers`: The HTTP request headers, which // must include: - `Authorization`: The request signature. - // `x-amz-date`: The time you will send the request, formatted as an - // [ISO8601 - // Basic](https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.ht - // ml#sigv4_elements_date) string. This is typically set to the current - // time and used to prevent replay attacks. - `host`: The hostname of - // the `url` field; for example, `sts.amazonaws.com`. - + // ISO8601 Basic string. This is typically set to the current time and + // used to prevent replay attacks. - `host`: The hostname of the `url` + // field; for example, `sts.amazonaws.com`. - // `x-goog-cloud-target-resource`: The full, canonical resource name of // the workload identity pool provider, with or without an `https:` // prefix. To help ensure data integrity, we recommend including this diff --git a/texttospeech/v1/texttospeech-gen.go b/texttospeech/v1/texttospeech-gen.go index 4f121704909..cacea0d9712 100644 --- a/texttospeech/v1/texttospeech-gen.go +++ b/texttospeech/v1/texttospeech-gen.go @@ -179,9 +179,7 @@ type AudioConfig struct { // EffectsProfileId: Optional. Input only. An identifier which selects // 'audio effects' profiles that are applied on (post synthesized) text // to speech. Effects are applied on top of each other in the order they - // are given. See [audio - // profiles](https://cloud.google.com/text-to-speech/docs/audio-profiles) - // for current supported profile ids. + // are given. See audio profiles for current supported profile ids. EffectsProfileId []string `json:"effectsProfileId,omitempty"` // Pitch: Optional. Input only. Speaking pitch, in the range [-20.0, @@ -298,8 +296,7 @@ func (s *ListVoicesResponse) MarshalJSON() ([]byte, error) { type SynthesisInput struct { // Ssml: The SSML document to be synthesized. The SSML document must be // valid and well-formed. Otherwise the RPC will fail and return - // google.rpc.Code.INVALID_ARGUMENT. For more information, see - // [SSML](https://cloud.google.com/text-to-speech/docs/ssml). + // google.rpc.Code.INVALID_ARGUMENT. For more information, see SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -404,8 +401,7 @@ func (s *SynthesizeSpeechResponse) MarshalJSON() ([]byte, error) { // Voice: Description of a voice supported by the TTS service. type Voice struct { // LanguageCodes: The languages that this voice supports, expressed as - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags - // (e.g. "en-US", "es-419", "cmn-tw"). + // BCP-47 language tags (e.g. "en-US", "es-419", "cmn-tw"). LanguageCodes []string `json:"languageCodes,omitempty"` // Name: The name of this voice. Each distinct voice has a unique name. @@ -457,9 +453,8 @@ func (s *Voice) MarshalJSON() ([]byte, error) { // synthesis request. type VoiceSelectionParams struct { // LanguageCode: Required. The language (and potentially also the - // region) of the voice expressed as a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, - // e.g. "en-US". This should not include a script tag (e.g. use "cmn-cn" + // region) of the voice expressed as a BCP-47 language tag, e.g. + // "en-US". This should not include a script tag (e.g. use "cmn-cn" // rather than "cmn-Hant-cn"), because the script will be inferred from // the input provided in the SynthesisInput. The TTS service will use // this parameter to help choose an appropriate voice. Note that the TTS @@ -660,13 +655,13 @@ func (r *VoicesService) List() *VoicesListCall { } // LanguageCode sets the optional parameter "languageCode": Recommended. -// [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. -// If specified, the ListVoices call will only return voices that can be -// used to synthesize this language_code. E.g. when specifying "en-NZ", -// you will get supported "en-\*" voices; when specifying "no", you will -// get supported "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) -// voices; specifying "zh" will also get supported "cmn-\*" voices; -// specifying "zh-hk" will also get supported "yue-\*" voices. +// BCP-47 language tag. If specified, the ListVoices call will only +// return voices that can be used to synthesize this language_code. E.g. +// when specifying "en-NZ", you will get supported "en-\*" voices; when +// specifying "no", you will get supported "no-\*" (Norwegian) and +// "nb-\*" (Norwegian Bokmal) voices; specifying "zh" will also get +// supported "cmn-\*" voices; specifying "zh-hk" will also get supported +// "yue-\*" voices. func (c *VoicesListCall) LanguageCode(languageCode string) *VoicesListCall { c.urlParams_.Set("languageCode", languageCode) return c diff --git a/texttospeech/v1beta1/texttospeech-gen.go b/texttospeech/v1beta1/texttospeech-gen.go index f14cccd51c6..996a4f78c1f 100644 --- a/texttospeech/v1beta1/texttospeech-gen.go +++ b/texttospeech/v1beta1/texttospeech-gen.go @@ -183,9 +183,7 @@ type AudioConfig struct { // EffectsProfileId: Optional. Input only. An identifier which selects // 'audio effects' profiles that are applied on (post synthesized) text // to speech. Effects are applied on top of each other in the order they - // are given. See [audio - // profiles](https://cloud.google.com/text-to-speech/docs/audio-profiles) - // for current supported profile ids. + // are given. See audio profiles for current supported profile ids. EffectsProfileId []string `json:"effectsProfileId,omitempty"` // Pitch: Optional. Input only. Speaking pitch, in the range [-20.0, @@ -302,8 +300,7 @@ func (s *ListVoicesResponse) MarshalJSON() ([]byte, error) { type SynthesisInput struct { // Ssml: The SSML document to be synthesized. The SSML document must be // valid and well-formed. Otherwise the RPC will fail and return - // google.rpc.Code.INVALID_ARGUMENT. For more information, see - // [SSML](https://cloud.google.com/text-to-speech/docs/ssml). + // google.rpc.Code.INVALID_ARGUMENT. For more information, see SSML. Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -473,8 +470,7 @@ func (s *Timepoint) UnmarshalJSON(data []byte) error { // Voice: Description of a voice supported by the TTS service. type Voice struct { // LanguageCodes: The languages that this voice supports, expressed as - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags - // (e.g. "en-US", "es-419", "cmn-tw"). + // BCP-47 language tags (e.g. "en-US", "es-419", "cmn-tw"). LanguageCodes []string `json:"languageCodes,omitempty"` // Name: The name of this voice. Each distinct voice has a unique name. @@ -526,9 +522,8 @@ func (s *Voice) MarshalJSON() ([]byte, error) { // synthesis request. type VoiceSelectionParams struct { // LanguageCode: Required. The language (and potentially also the - // region) of the voice expressed as a - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, - // e.g. "en-US". This should not include a script tag (e.g. use "cmn-cn" + // region) of the voice expressed as a BCP-47 language tag, e.g. + // "en-US". This should not include a script tag (e.g. use "cmn-cn" // rather than "cmn-Hant-cn"), because the script will be inferred from // the input provided in the SynthesisInput. The TTS service will use // this parameter to help choose an appropriate voice. Note that the TTS @@ -729,13 +724,13 @@ func (r *VoicesService) List() *VoicesListCall { } // LanguageCode sets the optional parameter "languageCode": Recommended. -// [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. -// If specified, the ListVoices call will only return voices that can be -// used to synthesize this language_code. E.g. when specifying "en-NZ", -// you will get supported "en-\*" voices; when specifying "no", you will -// get supported "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) -// voices; specifying "zh" will also get supported "cmn-\*" voices; -// specifying "zh-hk" will also get supported "yue-\*" voices. +// BCP-47 language tag. If specified, the ListVoices call will only +// return voices that can be used to synthesize this language_code. E.g. +// when specifying "en-NZ", you will get supported "en-\*" voices; when +// specifying "no", you will get supported "no-\*" (Norwegian) and +// "nb-\*" (Norwegian Bokmal) voices; specifying "zh" will also get +// supported "cmn-\*" voices; specifying "zh-hk" will also get supported +// "yue-\*" voices. func (c *VoicesListCall) LanguageCode(languageCode string) *VoicesListCall { c.urlParams_.Set("languageCode", languageCode) return c diff --git a/toolresults/v1beta3/toolresults-gen.go b/toolresults/v1beta3/toolresults-gen.go index 140b349b532..9b970370605 100644 --- a/toolresults/v1beta3/toolresults-gen.go +++ b/toolresults/v1beta3/toolresults-gen.go @@ -3313,11 +3313,10 @@ func (s *StartActivityNotFound) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4173,10 +4172,9 @@ func (s *Thumbnail) MarshalJSON() ([]byte, error) { // Gregorian calendar which extends the Gregorian calendar backwards to // year one. All minutes are 60 seconds long. Leap seconds are "smeared" // so that no leap second table is needed for interpretation, using a -// [24-hour linear smear](https://developers.google.com/time/smear). The -// range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. -// By restricting to that range, we ensure that we can convert to and -// from [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings. +// 24-hour linear smear. The range is from 0001-01-01T00:00:00Z to +// 9999-12-31T23:59:59.999999999Z. By restricting to that range, we +// ensure that we can convert to and from RFC 3339 date strings. type Timestamp struct { // Nanos: Non-negative fractions of a second at nanosecond resolution. // Negative second values with fractions must still have non-negative diff --git a/tpu/v1/tpu-gen.go b/tpu/v1/tpu-gen.go index e2eeaa5b881..62bb1c11e05 100644 --- a/tpu/v1/tpu-gen.go +++ b/tpu/v1/tpu-gen.go @@ -846,11 +846,10 @@ type StartNodeRequest struct { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/tpu/v1alpha1/tpu-gen.go b/tpu/v1alpha1/tpu-gen.go index 5fb9f8d853e..aa01220e197 100644 --- a/tpu/v1alpha1/tpu-gen.go +++ b/tpu/v1alpha1/tpu-gen.go @@ -846,11 +846,10 @@ type StartNodeRequest struct { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/translate/v3/translate-gen.go b/translate/v3/translate-gen.go index d87013ad588..552cdf7db3c 100644 --- a/translate/v3/translate-gen.go +++ b/translate/v3/translate-gen.go @@ -536,8 +536,7 @@ type GlossaryInputConfig struct { // source/target term pairs. For equivalent term sets glossaries: - CSV // (`.csv`): Multi-column CSV file defining equivalent glossary terms in // multiple languages. See documentation for more information - - // [glossaries](https://cloud.google.com/translate/docs/advanced/glossary - // ). + // glossaries. GcsSource *GcsSource `json:"gcsSource,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsSource") to @@ -983,11 +982,10 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/translate/v3beta1/translate-gen.go b/translate/v3beta1/translate-gen.go index 37d250f74c2..9ba05e08942 100644 --- a/translate/v3beta1/translate-gen.go +++ b/translate/v3beta1/translate-gen.go @@ -533,9 +533,7 @@ type GlossaryInputConfig struct { // source/target term pairs. For equivalent term sets glossaries: - CSV // (`.csv`): Multi-column CSV file defining equivalent glossary terms in // multiple languages. The format is defined for Google Translation - // Toolkit and documented in [Use a - // glossary](https://support.google.com/translatortoolkit/answer/6306379? - // hl=en). + // Toolkit and documented in Use a glossary. GcsSource *GcsSource `json:"gcsSource,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsSource") to @@ -981,11 +979,10 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/vault/v1/vault-gen.go b/vault/v1/vault-gen.go index f7145bc63e6..9a63ec99a00 100644 --- a/vault/v1/vault-gen.go +++ b/vault/v1/vault-gen.go @@ -2289,11 +2289,10 @@ func (s *SharedDriveInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/videointelligence/v1/videointelligence-gen.go b/videointelligence/v1/videointelligence-gen.go index fd446b8d602..609cbf2824a 100644 --- a/videointelligence/v1/videointelligence-gen.go +++ b/videointelligence/v1/videointelligence-gen.go @@ -287,17 +287,15 @@ type GoogleCloudVideointelligenceV1AnnotateVideoRequest struct { // unset. InputContent string `json:"inputContent,omitempty"` - // InputUri: Input video location. Currently, only [Cloud - // Storage](https://cloud.google.com/storage/) URIs are supported. URIs - // must be specified in the following format: `gs://bucket-id/object-id` - // (other URI formats return google.rpc.Code.INVALID_ARGUMENT). For more - // information, see [Request - // URIs](https://cloud.google.com/storage/docs/request-endpoints). To - // identify multiple videos, a video URI may include wildcards in the - // `object-id`. Supported wildcards: '*' to match 0 or more characters; - // '?' to match 1 character. If unset, the input video should be - // embedded in the request as `input_content`. If set, `input_content` - // must be unset. + // InputUri: Input video location. Currently, only Cloud Storage URIs + // are supported. URIs must be specified in the following format: + // `gs://bucket-id/object-id` (other URI formats return + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. To identify multiple videos, a video URI may include wildcards + // in the `object-id`. Supported wildcards: '*' to match 0 or more + // characters; '?' to match 1 character. If unset, the input video + // should be embedded in the request as `input_content`. If set, + // `input_content` must be unset. InputUri string `json:"inputUri,omitempty"` // LocationId: Optional. Cloud region where annotation should take @@ -307,12 +305,11 @@ type GoogleCloudVideointelligenceV1AnnotateVideoRequest struct { LocationId string `json:"locationId,omitempty"` // OutputUri: Optional. Location where the output (in JSON format) - // should be stored. Currently, only [Cloud - // Storage](https://cloud.google.com/storage/) URIs are supported. These - // must be specified in the following format: `gs://bucket-id/object-id` - // (other URI formats return google.rpc.Code.INVALID_ARGUMENT). For more - // information, see [Request - // URIs](https://cloud.google.com/storage/docs/request-endpoints). + // should be stored. Currently, only Cloud Storage URIs are supported. + // These must be specified in the following format: + // `gs://bucket-id/object-id` (other URI formats return + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. OutputUri string `json:"outputUri,omitempty"` // VideoContext: Additional video context and/or feature-specific @@ -486,9 +483,8 @@ type GoogleCloudVideointelligenceV1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1447,8 +1443,7 @@ type GoogleCloudVideointelligenceV1SpeechContext struct { // them. This can be used to improve the accuracy for specific words and // phrases, for example, if specific commands are typically spoken by // the user. This can also be used to add additional words to the - // vocabulary of the recognizer. See [usage - // limits](https://cloud.google.com/speech/limits#content). + // vocabulary of the recognizer. See usage limits. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -1540,10 +1535,9 @@ type GoogleCloudVideointelligenceV1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1613,10 +1607,8 @@ type GoogleCloudVideointelligenceV1SpeechTranscriptionConfig struct { FilterProfanity bool `json:"filterProfanity,omitempty"` // LanguageCode: Required. *Required* The language of the supplied audio - // as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language - // tag. Example: "en-US". See [Language - // Support](https://cloud.google.com/speech/docs/languages) for a list - // of the currently supported language codes. + // as a BCP-47 language tag. Example: "en-US". See Language Support for + // a list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Optional. Maximum number of recognition hypotheses @@ -1930,8 +1922,7 @@ type GoogleCloudVideointelligenceV1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1992,8 +1983,7 @@ type GoogleCloudVideointelligenceV1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -2414,9 +2404,8 @@ type GoogleCloudVideointelligenceV1beta2Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -3181,10 +3170,9 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1beta2SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -3450,8 +3438,7 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -3512,8 +3499,7 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1beta2LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3876,9 +3862,8 @@ type GoogleCloudVideointelligenceV1p1beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4645,10 +4630,9 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p1beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -4914,8 +4898,7 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4976,8 +4959,7 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p1beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -5340,9 +5322,8 @@ type GoogleCloudVideointelligenceV1p2beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -6109,10 +6090,9 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p2beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -6378,8 +6358,7 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6440,8 +6419,7 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p2beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6910,9 +6888,8 @@ type GoogleCloudVideointelligenceV1p3beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7725,10 +7702,9 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p3beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -8083,8 +8059,7 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8148,8 +8123,7 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p3beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8454,11 +8428,10 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/videointelligence/v1beta2/videointelligence-gen.go b/videointelligence/v1beta2/videointelligence-gen.go index 94e30904749..932392010ec 100644 --- a/videointelligence/v1beta2/videointelligence-gen.go +++ b/videointelligence/v1beta2/videointelligence-gen.go @@ -323,9 +323,8 @@ type GoogleCloudVideointelligenceV1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1088,10 +1087,9 @@ type GoogleCloudVideointelligenceV1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1356,8 +1354,7 @@ type GoogleCloudVideointelligenceV1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1418,8 +1415,7 @@ type GoogleCloudVideointelligenceV1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1661,17 +1657,15 @@ type GoogleCloudVideointelligenceV1beta2AnnotateVideoRequest struct { // unset. InputContent string `json:"inputContent,omitempty"` - // InputUri: Input video location. Currently, only [Cloud - // Storage](https://cloud.google.com/storage/) URIs are supported. URIs - // must be specified in the following format: `gs://bucket-id/object-id` - // (other URI formats return google.rpc.Code.INVALID_ARGUMENT). For more - // information, see [Request - // URIs](https://cloud.google.com/storage/docs/request-endpoints). To - // identify multiple videos, a video URI may include wildcards in the - // `object-id`. Supported wildcards: '*' to match 0 or more characters; - // '?' to match 1 character. If unset, the input video should be - // embedded in the request as `input_content`. If set, `input_content` - // must be unset. + // InputUri: Input video location. Currently, only Cloud Storage URIs + // are supported. URIs must be specified in the following format: + // `gs://bucket-id/object-id` (other URI formats return + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. To identify multiple videos, a video URI may include wildcards + // in the `object-id`. Supported wildcards: '*' to match 0 or more + // characters; '?' to match 1 character. If unset, the input video + // should be embedded in the request as `input_content`. If set, + // `input_content` must be unset. InputUri string `json:"inputUri,omitempty"` // LocationId: Optional. Cloud region where annotation should take @@ -1681,12 +1675,11 @@ type GoogleCloudVideointelligenceV1beta2AnnotateVideoRequest struct { LocationId string `json:"locationId,omitempty"` // OutputUri: Optional. Location where the output (in JSON format) - // should be stored. Currently, only [Cloud - // Storage](https://cloud.google.com/storage/) URIs are supported. These - // must be specified in the following format: `gs://bucket-id/object-id` - // (other URI formats return google.rpc.Code.INVALID_ARGUMENT). For more - // information, see [Request - // URIs](https://cloud.google.com/storage/docs/request-endpoints). + // should be stored. Currently, only Cloud Storage URIs are supported. + // These must be specified in the following format: + // `gs://bucket-id/object-id` (other URI formats return + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. OutputUri string `json:"outputUri,omitempty"` // VideoContext: Additional video context and/or feature-specific @@ -1861,9 +1854,8 @@ type GoogleCloudVideointelligenceV1beta2Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2825,8 +2817,7 @@ type GoogleCloudVideointelligenceV1beta2SpeechContext struct { // them. This can be used to improve the accuracy for specific words and // phrases, for example, if specific commands are typically spoken by // the user. This can also be used to add additional words to the - // vocabulary of the recognizer. See [usage - // limits](https://cloud.google.com/speech/limits#content). + // vocabulary of the recognizer. See usage limits. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -2918,10 +2909,9 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1beta2SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -2991,10 +2981,8 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscriptionConfig struct { FilterProfanity bool `json:"filterProfanity,omitempty"` // LanguageCode: Required. *Required* The language of the supplied audio - // as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language - // tag. Example: "en-US". See [Language - // Support](https://cloud.google.com/speech/docs/languages) for a list - // of the currently supported language codes. + // as a BCP-47 language tag. Example: "en-US". See Language Support for + // a list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Optional. Maximum number of recognition hypotheses @@ -3309,8 +3297,7 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -3371,8 +3358,7 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1beta2LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3793,9 +3779,8 @@ type GoogleCloudVideointelligenceV1p1beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4562,10 +4547,9 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p1beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -4831,8 +4815,7 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4893,8 +4876,7 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p1beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -5257,9 +5239,8 @@ type GoogleCloudVideointelligenceV1p2beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -6026,10 +6007,9 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p2beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -6295,8 +6275,7 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6357,8 +6336,7 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p2beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6827,9 +6805,8 @@ type GoogleCloudVideointelligenceV1p3beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7642,10 +7619,9 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p3beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -8000,8 +7976,7 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8065,8 +8040,7 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p3beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8317,11 +8291,10 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/videointelligence/v1p1beta1/videointelligence-gen.go b/videointelligence/v1p1beta1/videointelligence-gen.go index 58235e8e91a..262e040f603 100644 --- a/videointelligence/v1p1beta1/videointelligence-gen.go +++ b/videointelligence/v1p1beta1/videointelligence-gen.go @@ -323,9 +323,8 @@ type GoogleCloudVideointelligenceV1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1088,10 +1087,9 @@ type GoogleCloudVideointelligenceV1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1356,8 +1354,7 @@ type GoogleCloudVideointelligenceV1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1418,8 +1415,7 @@ type GoogleCloudVideointelligenceV1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1782,9 +1778,8 @@ type GoogleCloudVideointelligenceV1beta2Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2549,10 +2544,9 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1beta2SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -2818,8 +2812,7 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -2880,8 +2873,7 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1beta2LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3123,17 +3115,15 @@ type GoogleCloudVideointelligenceV1p1beta1AnnotateVideoRequest struct { // unset. InputContent string `json:"inputContent,omitempty"` - // InputUri: Input video location. Currently, only [Cloud - // Storage](https://cloud.google.com/storage/) URIs are supported. URIs - // must be specified in the following format: `gs://bucket-id/object-id` - // (other URI formats return google.rpc.Code.INVALID_ARGUMENT). For more - // information, see [Request - // URIs](https://cloud.google.com/storage/docs/request-endpoints). To - // identify multiple videos, a video URI may include wildcards in the - // `object-id`. Supported wildcards: '*' to match 0 or more characters; - // '?' to match 1 character. If unset, the input video should be - // embedded in the request as `input_content`. If set, `input_content` - // must be unset. + // InputUri: Input video location. Currently, only Cloud Storage URIs + // are supported. URIs must be specified in the following format: + // `gs://bucket-id/object-id` (other URI formats return + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. To identify multiple videos, a video URI may include wildcards + // in the `object-id`. Supported wildcards: '*' to match 0 or more + // characters; '?' to match 1 character. If unset, the input video + // should be embedded in the request as `input_content`. If set, + // `input_content` must be unset. InputUri string `json:"inputUri,omitempty"` // LocationId: Optional. Cloud region where annotation should take @@ -3143,12 +3133,11 @@ type GoogleCloudVideointelligenceV1p1beta1AnnotateVideoRequest struct { LocationId string `json:"locationId,omitempty"` // OutputUri: Optional. Location where the output (in JSON format) - // should be stored. Currently, only [Cloud - // Storage](https://cloud.google.com/storage/) URIs are supported. These - // must be specified in the following format: `gs://bucket-id/object-id` - // (other URI formats return google.rpc.Code.INVALID_ARGUMENT). For more - // information, see [Request - // URIs](https://cloud.google.com/storage/docs/request-endpoints). + // should be stored. Currently, only Cloud Storage URIs are supported. + // These must be specified in the following format: + // `gs://bucket-id/object-id` (other URI formats return + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. OutputUri string `json:"outputUri,omitempty"` // VideoContext: Additional video context and/or feature-specific @@ -3323,9 +3312,8 @@ type GoogleCloudVideointelligenceV1p1beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4289,8 +4277,7 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechContext struct { // them. This can be used to improve the accuracy for specific words and // phrases, for example, if specific commands are typically spoken by // the user. This can also be used to add additional words to the - // vocabulary of the recognizer. See [usage - // limits](https://cloud.google.com/speech/limits#content). + // vocabulary of the recognizer. See usage limits. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -4382,10 +4369,9 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p1beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -4455,10 +4441,8 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscriptionConfig struct { FilterProfanity bool `json:"filterProfanity,omitempty"` // LanguageCode: Required. *Required* The language of the supplied audio - // as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language - // tag. Example: "en-US". See [Language - // Support](https://cloud.google.com/speech/docs/languages) for a list - // of the currently supported language codes. + // as a BCP-47 language tag. Example: "en-US". See Language Support for + // a list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Optional. Maximum number of recognition hypotheses @@ -4773,8 +4757,7 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4835,8 +4818,7 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p1beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -5257,9 +5239,8 @@ type GoogleCloudVideointelligenceV1p2beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -6026,10 +6007,9 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p2beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -6295,8 +6275,7 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6357,8 +6336,7 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p2beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6827,9 +6805,8 @@ type GoogleCloudVideointelligenceV1p3beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7642,10 +7619,9 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p3beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -8000,8 +7976,7 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8065,8 +8040,7 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p3beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8317,11 +8291,10 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/videointelligence/v1p2beta1/videointelligence-gen.go b/videointelligence/v1p2beta1/videointelligence-gen.go index 60e690c03c2..486d4e79003 100644 --- a/videointelligence/v1p2beta1/videointelligence-gen.go +++ b/videointelligence/v1p2beta1/videointelligence-gen.go @@ -323,9 +323,8 @@ type GoogleCloudVideointelligenceV1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1088,10 +1087,9 @@ type GoogleCloudVideointelligenceV1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1356,8 +1354,7 @@ type GoogleCloudVideointelligenceV1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1418,8 +1415,7 @@ type GoogleCloudVideointelligenceV1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1782,9 +1778,8 @@ type GoogleCloudVideointelligenceV1beta2Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2549,10 +2544,9 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1beta2SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -2818,8 +2812,7 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -2880,8 +2873,7 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1beta2LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3244,9 +3236,8 @@ type GoogleCloudVideointelligenceV1p1beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4013,10 +4004,9 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p1beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -4282,8 +4272,7 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4344,8 +4333,7 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p1beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -4587,17 +4575,15 @@ type GoogleCloudVideointelligenceV1p2beta1AnnotateVideoRequest struct { // unset. InputContent string `json:"inputContent,omitempty"` - // InputUri: Input video location. Currently, only [Cloud - // Storage](https://cloud.google.com/storage/) URIs are supported. URIs - // must be specified in the following format: `gs://bucket-id/object-id` - // (other URI formats return google.rpc.Code.INVALID_ARGUMENT). For more - // information, see [Request - // URIs](https://cloud.google.com/storage/docs/request-endpoints). To - // identify multiple videos, a video URI may include wildcards in the - // `object-id`. Supported wildcards: '*' to match 0 or more characters; - // '?' to match 1 character. If unset, the input video should be - // embedded in the request as `input_content`. If set, `input_content` - // must be unset. + // InputUri: Input video location. Currently, only Cloud Storage URIs + // are supported. URIs must be specified in the following format: + // `gs://bucket-id/object-id` (other URI formats return + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. To identify multiple videos, a video URI may include wildcards + // in the `object-id`. Supported wildcards: '*' to match 0 or more + // characters; '?' to match 1 character. If unset, the input video + // should be embedded in the request as `input_content`. If set, + // `input_content` must be unset. InputUri string `json:"inputUri,omitempty"` // LocationId: Optional. Cloud region where annotation should take @@ -4607,12 +4593,11 @@ type GoogleCloudVideointelligenceV1p2beta1AnnotateVideoRequest struct { LocationId string `json:"locationId,omitempty"` // OutputUri: Optional. Location where the output (in JSON format) - // should be stored. Currently, only [Cloud - // Storage](https://cloud.google.com/storage/) URIs are supported. These - // must be specified in the following format: `gs://bucket-id/object-id` - // (other URI formats return google.rpc.Code.INVALID_ARGUMENT). For more - // information, see [Request - // URIs](https://cloud.google.com/storage/docs/request-endpoints). + // should be stored. Currently, only Cloud Storage URIs are supported. + // These must be specified in the following format: + // `gs://bucket-id/object-id` (other URI formats return + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. OutputUri string `json:"outputUri,omitempty"` // VideoContext: Additional video context and/or feature-specific @@ -4787,9 +4772,8 @@ type GoogleCloudVideointelligenceV1p2beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -5753,8 +5737,7 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechContext struct { // them. This can be used to improve the accuracy for specific words and // phrases, for example, if specific commands are typically spoken by // the user. This can also be used to add additional words to the - // vocabulary of the recognizer. See [usage - // limits](https://cloud.google.com/speech/limits#content). + // vocabulary of the recognizer. See usage limits. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -5846,10 +5829,9 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p2beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -5919,10 +5901,8 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscriptionConfig struct { FilterProfanity bool `json:"filterProfanity,omitempty"` // LanguageCode: Required. *Required* The language of the supplied audio - // as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language - // tag. Example: "en-US". See [Language - // Support](https://cloud.google.com/speech/docs/languages) for a list - // of the currently supported language codes. + // as a BCP-47 language tag. Example: "en-US". See Language Support for + // a list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Optional. Maximum number of recognition hypotheses @@ -6237,8 +6217,7 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6299,8 +6278,7 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p2beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6827,9 +6805,8 @@ type GoogleCloudVideointelligenceV1p3beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7642,10 +7619,9 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p3beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -8000,8 +7976,7 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8065,8 +8040,7 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p3beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8317,11 +8291,10 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/videointelligence/v1p3beta1/videointelligence-gen.go b/videointelligence/v1p3beta1/videointelligence-gen.go index 154bd8b78a8..3bf7ea8312e 100644 --- a/videointelligence/v1p3beta1/videointelligence-gen.go +++ b/videointelligence/v1p3beta1/videointelligence-gen.go @@ -323,9 +323,8 @@ type GoogleCloudVideointelligenceV1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1088,10 +1087,9 @@ type GoogleCloudVideointelligenceV1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1356,8 +1354,7 @@ type GoogleCloudVideointelligenceV1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1418,8 +1415,7 @@ type GoogleCloudVideointelligenceV1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1782,9 +1778,8 @@ type GoogleCloudVideointelligenceV1beta2Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2549,10 +2544,9 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1beta2SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -2818,8 +2812,7 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -2880,8 +2873,7 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1beta2LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3244,9 +3236,8 @@ type GoogleCloudVideointelligenceV1p1beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4013,10 +4004,9 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p1beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -4282,8 +4272,7 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4344,8 +4333,7 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p1beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -4708,9 +4696,8 @@ type GoogleCloudVideointelligenceV1p2beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -5477,10 +5464,9 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p2beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -5746,8 +5732,7 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -5808,8 +5793,7 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p2beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6052,17 +6036,15 @@ type GoogleCloudVideointelligenceV1p3beta1AnnotateVideoRequest struct { // unset. InputContent string `json:"inputContent,omitempty"` - // InputUri: Input video location. Currently, only [Cloud - // Storage](https://cloud.google.com/storage/) URIs are supported. URIs - // must be specified in the following format: `gs://bucket-id/object-id` - // (other URI formats return google.rpc.Code.INVALID_ARGUMENT). For more - // information, see [Request - // URIs](https://cloud.google.com/storage/docs/request-endpoints). To - // identify multiple videos, a video URI may include wildcards in the - // `object-id`. Supported wildcards: '*' to match 0 or more characters; - // '?' to match 1 character. If unset, the input video should be - // embedded in the request as `input_content`. If set, `input_content` - // must be unset. + // InputUri: Input video location. Currently, only Cloud Storage URIs + // are supported. URIs must be specified in the following format: + // `gs://bucket-id/object-id` (other URI formats return + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. To identify multiple videos, a video URI may include wildcards + // in the `object-id`. Supported wildcards: '*' to match 0 or more + // characters; '?' to match 1 character. If unset, the input video + // should be embedded in the request as `input_content`. If set, + // `input_content` must be unset. InputUri string `json:"inputUri,omitempty"` // LocationId: Optional. Cloud region where annotation should take @@ -6072,12 +6054,11 @@ type GoogleCloudVideointelligenceV1p3beta1AnnotateVideoRequest struct { LocationId string `json:"locationId,omitempty"` // OutputUri: Optional. Location where the output (in JSON format) - // should be stored. Currently, only [Cloud - // Storage](https://cloud.google.com/storage/) URIs are supported. These - // must be specified in the following format: `gs://bucket-id/object-id` - // (other URI formats return google.rpc.Code.INVALID_ARGUMENT). For more - // information, see [Request - // URIs](https://cloud.google.com/storage/docs/request-endpoints). + // should be stored. Currently, only Cloud Storage URIs are supported. + // These must be specified in the following format: + // `gs://bucket-id/object-id` (other URI formats return + // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request + // URIs. OutputUri string `json:"outputUri,omitempty"` // VideoContext: Additional video context and/or feature-specific @@ -6358,9 +6339,8 @@ type GoogleCloudVideointelligenceV1p3beta1Entity struct { // Description: Textual description, e.g., `Fixed-gear bicycle`. Description string `json:"description,omitempty"` - // EntityId: Opaque entity ID. Some IDs may be available in [Google - // Knowledge Graph Search - // API](https://developers.google.com/knowledge-graph/). + // EntityId: Opaque entity ID. Some IDs may be available in Google + // Knowledge Graph Search API. EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7370,8 +7350,7 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechContext struct { // them. This can be used to improve the accuracy for specific words and // phrases, for example, if specific commands are typically spoken by // the user. This can also be used to add additional words to the - // vocabulary of the recognizer. See [usage - // limits](https://cloud.google.com/speech/limits#content). + // vocabulary of the recognizer. See usage limits. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -7463,10 +7442,9 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p3beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The - // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag - // of the language in this result. This language code was detected to - // have the most likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 language tag of the language in + // this result. This language code was detected to have the most + // likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -7536,10 +7514,8 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscriptionConfig struct { FilterProfanity bool `json:"filterProfanity,omitempty"` // LanguageCode: Required. *Required* The language of the supplied audio - // as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language - // tag. Example: "en-US". See [Language - // Support](https://cloud.google.com/speech/docs/languages) for a list - // of the currently supported language codes. + // as a BCP-47 language tag. Example: "en-US". See Language Support for + // a list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Optional. Maximum number of recognition hypotheses @@ -7943,8 +7919,7 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8008,8 +7983,7 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p3beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in [Cloud - // Storage](https://cloud.google.com/storage/). + // InputUri: Video file location in Cloud Storage. InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8318,11 +8292,10 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find out more about this -// error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/vision/v1/vision-gen.go b/vision/v1/vision-gen.go index 749fb27bd32..75a310c5dba 100644 --- a/vision/v1/vision-gen.go +++ b/vision/v1/vision-gen.go @@ -1538,8 +1538,8 @@ type EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -2382,8 +2382,8 @@ type GoogleCloudVisionV1p1beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p1beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -4682,8 +4682,8 @@ type GoogleCloudVisionV1p2beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p2beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -7033,8 +7033,8 @@ type GoogleCloudVisionV1p3beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p3beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -9566,8 +9566,8 @@ type GoogleCloudVisionV1p4beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p4beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -11642,8 +11642,7 @@ type ImageContext struct { // the language of the text in the image is known, setting a hint will // help get better results (although it will be a significant hindrance // if the hint is wrong). Text detection returns an error if one or more - // of the specified languages is not one of the [supported - // languages](https://cloud.google.com/vision/docs/languages). + // of the specified languages is not one of the supported languages. LanguageHints []string `json:"languageHints,omitempty"` // LatLongRect: Not used. @@ -11713,23 +11712,20 @@ func (s *ImageProperties) MarshalJSON() ([]byte, error) { type ImageSource struct { // GcsImageUri: **Use `image_uri` instead.** The Google Cloud Storage // URI of the form `gs://bucket_name/object_name`. Object versioning is - // not supported. See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. + // not supported. See Google Cloud Storage Request URIs for more info. GcsImageUri string `json:"gcsImageUri,omitempty"` // ImageUri: The URI of the source image. Can be either: 1. A Google // Cloud Storage URI of the form `gs://bucket_name/object_name`. Object - // versioning is not supported. See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. 2. A publicly-accessible image HTTP/HTTPS URL. When fetching - // images from HTTP/HTTPS URLs, Google cannot guarantee that the request - // will be completed. Your request may fail if the specified host denies - // the request (e.g. due to request throttling or DOS prevention), or if - // Google throttles requests to the site for abuse prevention. You - // should not depend on externally-hosted images for production - // applications. When both `gcs_image_uri` and `image_uri` are - // specified, `image_uri` takes precedence. + // versioning is not supported. See Google Cloud Storage Request URIs + // for more info. 2. A publicly-accessible image HTTP/HTTPS URL. When + // fetching images from HTTP/HTTPS URLs, Google cannot guarantee that + // the request will be completed. Your request may fail if the specified + // host denies the request (e.g. due to request throttling or DOS + // prevention), or if Google throttles requests to the site for abuse + // prevention. You should not depend on externally-hosted images for + // production applications. When both `gcs_image_uri` and `image_uri` + // are specified, `image_uri` takes precedence. ImageUri string `json:"imageUri,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsImageUri") to @@ -13367,11 +13363,10 @@ func (s *SafeSearchAnnotation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/vision/v1p1beta1/vision-gen.go b/vision/v1p1beta1/vision-gen.go index 5e1f0419bb6..93840c3d1c7 100644 --- a/vision/v1p1beta1/vision-gen.go +++ b/vision/v1p1beta1/vision-gen.go @@ -1034,8 +1034,8 @@ type EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -2200,8 +2200,8 @@ type GoogleCloudVisionV1p1beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p1beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -2722,8 +2722,7 @@ type GoogleCloudVisionV1p1beta1ImageContext struct { // the language of the text in the image is known, setting a hint will // help get better results (although it will be a significant hindrance // if the hint is wrong). Text detection returns an error if one or more - // of the specified languages is not one of the [supported - // languages](https://cloud.google.com/vision/docs/languages). + // of the specified languages is not one of the supported languages. LanguageHints []string `json:"languageHints,omitempty"` // LatLongRect: Not used. @@ -2794,23 +2793,20 @@ func (s *GoogleCloudVisionV1p1beta1ImageProperties) MarshalJSON() ([]byte, error type GoogleCloudVisionV1p1beta1ImageSource struct { // GcsImageUri: **Use `image_uri` instead.** The Google Cloud Storage // URI of the form `gs://bucket_name/object_name`. Object versioning is - // not supported. See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. + // not supported. See Google Cloud Storage Request URIs for more info. GcsImageUri string `json:"gcsImageUri,omitempty"` // ImageUri: The URI of the source image. Can be either: 1. A Google // Cloud Storage URI of the form `gs://bucket_name/object_name`. Object - // versioning is not supported. See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. 2. A publicly-accessible image HTTP/HTTPS URL. When fetching - // images from HTTP/HTTPS URLs, Google cannot guarantee that the request - // will be completed. Your request may fail if the specified host denies - // the request (e.g. due to request throttling or DOS prevention), or if - // Google throttles requests to the site for abuse prevention. You - // should not depend on externally-hosted images for production - // applications. When both `gcs_image_uri` and `image_uri` are - // specified, `image_uri` takes precedence. + // versioning is not supported. See Google Cloud Storage Request URIs + // for more info. 2. A publicly-accessible image HTTP/HTTPS URL. When + // fetching images from HTTP/HTTPS URLs, Google cannot guarantee that + // the request will be completed. Your request may fail if the specified + // host denies the request (e.g. due to request throttling or DOS + // prevention), or if Google throttles requests to the site for abuse + // prevention. You should not depend on externally-hosted images for + // production applications. When both `gcs_image_uri` and `image_uri` + // are specified, `image_uri` takes precedence. ImageUri string `json:"imageUri,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsImageUri") to @@ -4815,8 +4811,8 @@ type GoogleCloudVisionV1p2beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p2beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -7166,8 +7162,8 @@ type GoogleCloudVisionV1p3beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p3beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -9699,8 +9695,8 @@ type GoogleCloudVisionV1p4beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p4beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -12808,11 +12804,10 @@ func (s *SafeSearchAnnotation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/vision/v1p2beta1/vision-gen.go b/vision/v1p2beta1/vision-gen.go index dd465ae98a1..5e9e5409190 100644 --- a/vision/v1p2beta1/vision-gen.go +++ b/vision/v1p2beta1/vision-gen.go @@ -1034,8 +1034,8 @@ type EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -1818,8 +1818,8 @@ type GoogleCloudVisionV1p1beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p1beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -4500,8 +4500,8 @@ type GoogleCloudVisionV1p2beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p2beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -5022,8 +5022,7 @@ type GoogleCloudVisionV1p2beta1ImageContext struct { // the language of the text in the image is known, setting a hint will // help get better results (although it will be a significant hindrance // if the hint is wrong). Text detection returns an error if one or more - // of the specified languages is not one of the [supported - // languages](https://cloud.google.com/vision/docs/languages). + // of the specified languages is not one of the supported languages. LanguageHints []string `json:"languageHints,omitempty"` // LatLongRect: Not used. @@ -5094,23 +5093,20 @@ func (s *GoogleCloudVisionV1p2beta1ImageProperties) MarshalJSON() ([]byte, error type GoogleCloudVisionV1p2beta1ImageSource struct { // GcsImageUri: **Use `image_uri` instead.** The Google Cloud Storage // URI of the form `gs://bucket_name/object_name`. Object versioning is - // not supported. See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. + // not supported. See Google Cloud Storage Request URIs for more info. GcsImageUri string `json:"gcsImageUri,omitempty"` // ImageUri: The URI of the source image. Can be either: 1. A Google // Cloud Storage URI of the form `gs://bucket_name/object_name`. Object - // versioning is not supported. See [Google Cloud Storage Request - // URIs](https://cloud.google.com/storage/docs/reference-uris) for more - // info. 2. A publicly-accessible image HTTP/HTTPS URL. When fetching - // images from HTTP/HTTPS URLs, Google cannot guarantee that the request - // will be completed. Your request may fail if the specified host denies - // the request (e.g. due to request throttling or DOS prevention), or if - // Google throttles requests to the site for abuse prevention. You - // should not depend on externally-hosted images for production - // applications. When both `gcs_image_uri` and `image_uri` are - // specified, `image_uri` takes precedence. + // versioning is not supported. See Google Cloud Storage Request URIs + // for more info. 2. A publicly-accessible image HTTP/HTTPS URL. When + // fetching images from HTTP/HTTPS URLs, Google cannot guarantee that + // the request will be completed. Your request may fail if the specified + // host denies the request (e.g. due to request throttling or DOS + // prevention), or if Google throttles requests to the site for abuse + // prevention. You should not depend on externally-hosted images for + // production applications. When both `gcs_image_uri` and `image_uri` + // are specified, `image_uri` takes precedence. ImageUri string `json:"imageUri,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsImageUri") to @@ -7166,8 +7162,8 @@ type GoogleCloudVisionV1p3beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p3beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -9699,8 +9695,8 @@ type GoogleCloudVisionV1p4beta1EntityAnnotation struct { // Location information is usually present for landmarks. Locations []*GoogleCloudVisionV1p4beta1LocationInfo `json:"locations,omitempty"` - // Mid: Opaque entity ID. Some IDs may be available in [Google Knowledge - // Graph Search API](https://developers.google.com/knowledge-graph/). + // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge + // Graph Search API. Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -12808,11 +12804,10 @@ func (s *SafeSearchAnnotation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/workflowexecutions/v1beta/workflowexecutions-gen.go b/workflowexecutions/v1beta/workflowexecutions-gen.go index 590d052f877..face2bdb375 100644 --- a/workflowexecutions/v1beta/workflowexecutions-gen.go +++ b/workflowexecutions/v1beta/workflowexecutions-gen.go @@ -217,9 +217,7 @@ func (s *Error) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Execution: A running instance of a -// [Workflow](/workflows/docs/reference/rest/v1beta/projects.locations.wo -// rkflows). +// Execution: A running instance of a Workflow. type Execution struct { // Argument: Input parameters of the execution represented as a JSON // string. The size limit is 32KB. diff --git a/workflows/v1beta/workflows-gen.go b/workflows/v1beta/workflows-gen.go index fc95f93e7a6..4dfba3a02c2 100644 --- a/workflows/v1beta/workflows-gen.go +++ b/workflows/v1beta/workflows-gen.go @@ -461,11 +461,10 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each -// `Status` message contains three pieces of data: error code, error -// message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// and RPC APIs. It is used by gRPC. Each `Status` message contains +// three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it +// in the API Design Guide. type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -643,7 +642,7 @@ func (c *ProjectsLocationsGetCall) Header() http.Header { func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -809,7 +808,7 @@ func (c *ProjectsLocationsListCall) Header() http.Header { func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -982,7 +981,7 @@ func (c *ProjectsLocationsOperationsDeleteCall) Header() http.Header { func (c *ProjectsLocationsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1125,7 +1124,7 @@ func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1299,7 +1298,7 @@ func (c *ProjectsLocationsOperationsListCall) Header() http.Header { func (c *ProjectsLocationsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1484,7 +1483,7 @@ func (c *ProjectsLocationsWorkflowsCreateCall) Header() http.Header { func (c *ProjectsLocationsWorkflowsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1628,7 +1627,7 @@ func (c *ProjectsLocationsWorkflowsDeleteCall) Header() http.Header { func (c *ProjectsLocationsWorkflowsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1769,7 +1768,7 @@ func (c *ProjectsLocationsWorkflowsGetCall) Header() http.Header { func (c *ProjectsLocationsWorkflowsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1951,7 +1950,7 @@ func (c *ProjectsLocationsWorkflowsListCall) Header() http.Header { func (c *ProjectsLocationsWorkflowsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2139,7 +2138,7 @@ func (c *ProjectsLocationsWorkflowsPatchCall) Header() http.Header { func (c *ProjectsLocationsWorkflowsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201209") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/youtubeanalytics/v2/youtubeanalytics-gen.go b/youtubeanalytics/v2/youtubeanalytics-gen.go index a0f7890c89e..fc12fcc7ec8 100644 --- a/youtubeanalytics/v2/youtubeanalytics-gen.go +++ b/youtubeanalytics/v2/youtubeanalytics-gen.go @@ -1918,12 +1918,10 @@ func (c *ReportsQueryCall) Currency(currency string) *ReportsQueryCall { // Dimensions sets the optional parameter "dimensions": A // comma-separated list of YouTube Analytics dimensions, such as `views` -// or `ageGroup,gender`. See the [Available -// Reports](/youtube/analytics/v2/available_reports) document for a list +// or `ageGroup,gender`. See the Available Reports document for a list // of the reports that you can retrieve and the dimensions used for -// those reports. Also see the -// [Dimensions](/youtube/analytics/v2/dimsmets/dims) document for -// definitions of those dimensions." pattern: [0-9a-zA-Z,]+ +// those reports. Also see the Dimensions document for definitions of +// those dimensions." pattern: [0-9a-zA-Z,]+ func (c *ReportsQueryCall) Dimensions(dimensions string) *ReportsQueryCall { c.urlParams_.Set("dimensions", dimensions) return c @@ -1939,12 +1937,11 @@ func (c *ReportsQueryCall) EndDate(endDate string) *ReportsQueryCall { // Filters sets the optional parameter "filters": A list of filters that // should be applied when retrieving YouTube Analytics data. The -// [Available Reports](/youtube/analytics/v2/available_reports) document -// identifies the dimensions that can be used to filter each report, and -// the [Dimensions](/youtube/analytics/v2/dimsmets/dims) document -// defines those dimensions. If a request uses multiple filters, join -// them together with a semicolon (`;`), and the returned result table -// will satisfy both filters. For example, a filters parameter value of +// Available Reports document identifies the dimensions that can be used +// to filter each report, and the Dimensions document defines those +// dimensions. If a request uses multiple filters, join them together +// with a semicolon (`;`), and the returned result table will satisfy +// both filters. For example, a filters parameter value of // `video==dMH0bHeiRNg;country==IT` restricts the result set to include // data for the given video in Italy.", func (c *ReportsQueryCall) Filters(filters string) *ReportsQueryCall { @@ -1983,11 +1980,10 @@ func (c *ReportsQueryCall) MaxResults(maxResults int64) *ReportsQueryCall { // Metrics sets the optional parameter "metrics": A comma-separated list // of YouTube Analytics metrics, such as `views` or `likes,dislikes`. -// See the [Available Reports](/youtube/analytics/v2/available_reports) -// document for a list of the reports that you can retrieve and the -// metrics available in each report, and see the -// [Metrics](/youtube/analytics/v2/dimsmets/mets) document for -// definitions of those metrics. required: true, pattern: [0-9a-zA-Z,]+ +// See the Available Reports document for a list of the reports that you +// can retrieve and the metrics available in each report, and see the +// Metrics document for definitions of those metrics. required: true, +// pattern: [0-9a-zA-Z,]+ func (c *ReportsQueryCall) Metrics(metrics string) *ReportsQueryCall { c.urlParams_.Set("metrics", metrics) return c From 888c547e9c981ea01020a798c81a3fdf2fa2f2a0 Mon Sep 17 00:00:00 2001 From: Cody Oss Date: Wed, 16 Dec 2020 09:45:36 -0700 Subject: [PATCH 2/4] keep links --- .../v1/abusiveexperiencereport-gen.go | 13 +- .../v1/acceleratedmobilepageurl-gen.go | 11 +- .../v1/accesscontextmanager-gen.go | 12 +- .../v1beta/accesscontextmanager-gen.go | 9 +- .../v2beta1/adexchangebuyer2-gen.go | 34 +- .../v1/adexperiencereport-gen.go | 16 +- admin/directory/v1/admin-gen.go | 237 +++-- admin/reports/v1/admin-gen.go | 3 +- alertcenter/v1beta1/alertcenter-gen.go | 30 +- analyticsdata/v1alpha/analyticsdata-gen.go | 66 +- .../v4/analyticsreporting-gen.go | 146 +-- .../v1/androiddeviceprovisioning-gen.go | 58 +- androidmanagement/v1/androidmanagement-gen.go | 52 +- androidpublisher/v3/androidpublisher-gen.go | 17 +- apigateway/v1beta/apigateway-gen.go | 33 +- apigee/v1/apigee-gen.go | 141 ++- appengine/v1beta4/appengine-gen.go | 40 +- appengine/v1beta5/appengine-gen.go | 40 +- artifactregistry/v1/artifactregistry-gen.go | 6 +- .../v1beta1/artifactregistry-gen.go | 27 +- .../v1beta2/artifactregistry-gen.go | 27 +- assuredworkloads/v1/assuredworkloads-gen.go | 9 +- bigquery/v2/bigquery-gen.go | 18 +- .../v1beta1/bigqueryconnection-gen.go | 18 +- .../v1/bigquerydatatransfer-gen.go | 9 +- .../v1/bigqueryreservation-gen.go | 9 +- .../v1beta1/bigqueryreservation-gen.go | 12 +- bigtableadmin/v2/bigtableadmin-gen.go | 32 +- billingbudgets/v1/billingbudgets-gen.go | 9 +- billingbudgets/v1beta1/billingbudgets-gen.go | 4 +- .../v1/binaryauthorization-gen.go | 21 +- .../v1beta1/binaryauthorization-gen.go | 21 +- chat/v1/chat-gen.go | 5 +- classroom/v1/classroom-gen.go | 99 +- cloudasset/v1/cloudasset-gen.go | 215 ++-- cloudasset/v1beta1/cloudasset-gen.go | 97 +- cloudasset/v1p1beta1/cloudasset-gen.go | 29 +- cloudasset/v1p4beta1/cloudasset-gen.go | 69 +- cloudasset/v1p5beta1/cloudasset-gen.go | 83 +- cloudbilling/v1/cloudbilling-gen.go | 98 +- cloudbuild/v1/cloudbuild-gen.go | 27 +- cloudbuild/v1alpha1/cloudbuild-gen.go | 27 +- cloudbuild/v1alpha2/cloudbuild-gen.go | 27 +- .../v1beta1/clouderrorreporting-gen.go | 53 +- cloudfunctions/v1/cloudfunctions-gen.go | 44 +- cloudidentity/v1/cloudidentity-gen.go | 246 +++-- cloudidentity/v1beta1/cloudidentity-gen.go | 239 +++-- cloudiot/v1/cloudiot-gen.go | 27 +- cloudkms/v1/cloudkms-gen.go | 64 +- cloudprofiler/v2/cloudprofiler-gen.go | 22 +- .../v1/cloudresourcemanager-gen.go | 51 +- .../v1beta1/cloudresourcemanager-gen.go | 20 +- .../v2/cloudresourcemanager-gen.go | 27 +- .../v2beta1/cloudresourcemanager-gen.go | 27 +- cloudscheduler/v1/cloudscheduler-gen.go | 132 ++- cloudscheduler/v1beta1/cloudscheduler-gen.go | 132 ++- cloudsearch/v1/cloudsearch-gen.go | 72 +- cloudshell/v1/cloudshell-gen.go | 9 +- cloudshell/v1alpha1/cloudshell-gen.go | 9 +- cloudtasks/v2/cloudtasks-gen.go | 332 +++--- cloudtasks/v2beta2/cloudtasks-gen.go | 296 ++++-- cloudtasks/v2beta3/cloudtasks-gen.go | 370 ++++--- cloudtrace/v2/cloudtrace-gen.go | 12 +- cloudtrace/v2beta1/cloudtrace-gen.go | 10 +- composer/v1/composer-gen.go | 111 +- composer/v1beta1/composer-gen.go | 112 +- compute/v0.alpha/compute-gen.go | 93 +- compute/v0.beta/compute-gen.go | 93 +- compute/v1/compute-gen.go | 90 +- container/v1/container-gen.go | 601 ++++++----- container/v1beta1/container-gen.go | 580 ++++++----- .../v1alpha1/containeranalysis-gen.go | 33 +- .../v1beta1/containeranalysis-gen.go | 54 +- content/v2.1/content-gen.go | 10 +- customsearch/v1/customsearch-gen.go | 381 ++++--- datacatalog/v1beta1/datacatalog-gen.go | 84 +- dataflow/v1b3/dataflow-gen.go | 37 +- datafusion/v1/datafusion-gen.go | 27 +- datafusion/v1beta1/datafusion-gen.go | 27 +- datalabeling/v1beta1/datalabeling-gen.go | 87 +- datamigration/v1beta1/datamigration-gen.go | 35 +- datastore/v1/datastore-gen.go | 67 +- datastore/v1beta1/datastore-gen.go | 20 +- datastore/v1beta3/datastore-gen.go | 28 +- .../v0.alpha/deploymentmanager-gen.go | 57 +- deploymentmanager/v2/deploymentmanager-gen.go | 40 +- .../v2beta/deploymentmanager-gen.go | 57 +- dialogflow/v2/dialogflow-gen.go | 255 +++-- dialogflow/v2beta1/dialogflow-gen.go | 325 ++++-- dialogflow/v3/dialogflow-gen.go | 305 ++++-- dialogflow/v3beta1/dialogflow-gen.go | 305 ++++-- digitalassetlinks/v1/digitalassetlinks-gen.go | 39 +- displayvideo/v1/displayvideo-gen.go | 21 +- dlp/v2/dlp-gen.go | 108 +- docs/v1/docs-gen.go | 24 +- documentai/v1beta2/documentai-gen.go | 17 +- documentai/v1beta3/documentai-gen.go | 20 +- domains/v1alpha2/domains-gen.go | 55 +- domains/v1beta1/domains-gen.go | 55 +- domainsrdap/v1/domainsrdap-gen.go | 12 +- .../v1.1/doubleclickbidmanager-gen.go | 6 +- doubleclicksearch/v2/doubleclicksearch-gen.go | 3 +- eventarc/v1beta1/eventarc-gen.go | 27 +- fcm/v1/fcm-gen.go | 140 ++- file/v1/file-gen.go | 24 +- file/v1beta1/file-gen.go | 17 +- firebase/v1beta1/firebase-gen.go | 403 +++++--- .../v1/firebasedynamiclinks-gen.go | 48 +- firebasehosting/v1/firebasehosting-gen.go | 9 +- .../v1beta1/firebasehosting-gen.go | 117 ++- firebaseml/v1/firebaseml-gen.go | 9 +- firebaseml/v1beta2/firebaseml-gen.go | 9 +- firestore/v1/firestore-gen.go | 69 +- firestore/v1beta1/firestore-gen.go | 51 +- firestore/v1beta2/firestore-gen.go | 9 +- gameservices/v1/gameservices-gen.go | 27 +- gameservices/v1beta/gameservices-gen.go | 27 +- genomics/v1/genomics-gen.go | 24 +- genomics/v1alpha2/genomics-gen.go | 28 +- genomics/v2alpha1/genomics-gen.go | 41 +- gmail/v1/gmail-gen.go | 3 +- .../v1beta1/gmailpostmastertools-gen.go | 35 +- google-api-go-generator/gen.go | 4 +- google-api-go-generator/gen_test.go | 14 +- healthcare/v1/healthcare-gen.go | 668 +++++++----- healthcare/v1beta1/healthcare-gen.go | 967 +++++++++++------- homegraph/v1/homegraph-gen.go | 91 +- iam/v1/iam-gen.go | 144 ++- iap/v1/iap-gen.go | 18 +- iap/v1beta1/iap-gen.go | 18 +- jobs/v3/jobs-gen.go | 49 +- jobs/v3p1beta1/jobs-gen.go | 58 +- jobs/v4/jobs-gen.go | 32 +- language/v1/language-gen.go | 25 +- language/v1beta1/language-gen.go | 22 +- language/v1beta2/language-gen.go | 28 +- lifesciences/v2beta/lifesciences-gen.go | 38 +- localservices/v1/localservices-gen.go | 2 +- managedidentities/v1/managedidentities-gen.go | 40 +- .../v1alpha1/managedidentities-gen.go | 37 +- .../v1beta1/managedidentities-gen.go | 40 +- memcache/v1beta2/memcache-gen.go | 13 +- ml/v1/ml-gen.go | 563 ++++++---- monitoring/v3/monitoring-gen.go | 102 +- networkmanagement/v1/networkmanagement-gen.go | 30 +- .../v1beta1/networkmanagement-gen.go | 38 +- notebooks/v1/notebooks-gen.go | 53 +- osconfig/v1/osconfig-gen.go | 40 +- osconfig/v1beta/osconfig-gen.go | 34 +- people/v1/people-gen.go | 65 +- playablelocations/v3/playablelocations-gen.go | 15 +- .../v1/policytroubleshooter-gen.go | 12 +- .../v1beta/policytroubleshooter-gen.go | 12 +- poly/v1/poly-gen.go | 28 +- privateca/v1beta1/privateca-gen.go | 46 +- .../v1alpha1/prod_tt_sasportal-gen.go | 9 +- pubsub/v1/pubsub-gen.go | 94 +- pubsub/v1beta2/pubsub-gen.go | 31 +- realtimebidding/v1/realtimebidding-gen.go | 41 +- .../v1beta1/recommendationengine-gen.go | 20 +- redis/v1/redis-gen.go | 34 +- redis/v1beta1/redis-gen.go | 34 +- .../v1/remotebuildexecution-gen.go | 18 +- .../v1alpha/remotebuildexecution-gen.go | 18 +- .../v2/remotebuildexecution-gen.go | 18 +- run/v1/run-gen.go | 21 +- run/v1alpha1/run-gen.go | 21 +- runtimeconfig/v1/runtimeconfig-gen.go | 9 +- runtimeconfig/v1beta1/runtimeconfig-gen.go | 46 +- sasportal/v1alpha1/sasportal-gen.go | 9 +- script/v1/script-gen.go | 36 +- searchconsole/v1/searchconsole-gen.go | 18 +- secretmanager/v1/secretmanager-gen.go | 18 +- secretmanager/v1beta1/secretmanager-gen.go | 18 +- securitycenter/v1/securitycenter-gen.go | 27 +- securitycenter/v1beta1/securitycenter-gen.go | 27 +- .../v1/serviceconsumermanagement-gen.go | 219 ++-- .../v1beta1/serviceconsumermanagement-gen.go | 219 ++-- servicecontrol/v1/servicecontrol-gen.go | 34 +- servicecontrol/v2/servicecontrol-gen.go | 59 +- servicedirectory/v1/servicedirectory-gen.go | 18 +- .../v1beta1/servicedirectory-gen.go | 18 +- servicemanagement/v1/servicemanagement-gen.go | 252 +++-- servicenetworking/v1/servicenetworking-gen.go | 226 ++-- .../v1beta/servicenetworking-gen.go | 226 ++-- serviceusage/v1/serviceusage-gen.go | 224 ++-- serviceusage/v1beta1/serviceusage-gen.go | 219 ++-- sheets/v4/sheets-gen.go | 20 +- slides/v1/slides-gen.go | 13 +- sourcerepo/v1/sourcerepo-gen.go | 27 +- spanner/v1/spanner-gen.go | 179 ++-- speech/v1/speech-gen.go | 38 +- speech/v1p1beta1/speech-gen.go | 96 +- speech/v2beta1/speech-gen.go | 16 +- storagetransfer/v1/storagetransfer-gen.go | 86 +- streetviewpublish/v1/streetviewpublish-gen.go | 17 +- sts/v1beta/sts-gen.go | 62 +- texttospeech/v1/texttospeech-gen.go | 27 +- texttospeech/v1beta1/texttospeech-gen.go | 27 +- toolresults/v1beta3/toolresults-gen.go | 16 +- tpu/v1/tpu-gen.go | 9 +- tpu/v1alpha1/tpu-gen.go | 9 +- translate/v3/translate-gen.go | 12 +- translate/v3beta1/translate-gen.go | 12 +- vault/v1/vault-gen.go | 9 +- videointelligence/v1/videointelligence-gen.go | 129 ++- .../v1beta2/videointelligence-gen.go | 129 ++- .../v1p1beta1/videointelligence-gen.go | 129 ++- .../v1p2beta1/videointelligence-gen.go | 129 ++- .../v1p3beta1/videointelligence-gen.go | 129 ++- vision/v1/vision-gen.go | 42 +- vision/v1p1beta1/vision-gen.go | 42 +- vision/v1p2beta1/vision-gen.go | 42 +- .../v1beta/workflowexecutions-gen.go | 3 +- workflows/v1beta/workflows-gen.go | 9 +- youtubeanalytics/v2/youtubeanalytics-gen.go | 28 +- 216 files changed, 10129 insertions(+), 6525 deletions(-) diff --git a/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go b/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go index 01f959c642f..de998ac45b5 100644 --- a/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go +++ b/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go @@ -155,11 +155,13 @@ type SiteSummaryResponse struct { // "FAILING" - Failing. AbusiveStatus string `json:"abusiveStatus,omitempty"` - // EnforcementTime: The time at which enforcement against the site began - // or will begin. Not set when the filter_status is OFF. + // EnforcementTime: The time at which enforcement + // (https://support.google.com/webtools/answer/7538608) against the site + // began or will begin. Not set when the filter_status is OFF. EnforcementTime string `json:"enforcementTime,omitempty"` - // FilterStatus: The site's enforcement status. + // FilterStatus: The site's enforcement status + // (https://support.google.com/webtools/answer/7538608). // // Possible values: // "UNKNOWN" - N/A. @@ -174,8 +176,9 @@ type SiteSummaryResponse struct { // ReportUrl: A link to the full Abusive Experience Report for the site. // Not set in ViolatingSitesResponse. Note that you must complete the - // Search Console verification process for the site before you can - // access the full report. + // Search Console verification process + // (https://support.google.com/webmasters/answer/9008080) for the site + // before you can access the full report. ReportUrl string `json:"reportUrl,omitempty"` // ReviewedSite: The name of the reviewed site, e.g. `google.com`. diff --git a/acceleratedmobilepageurl/v1/acceleratedmobilepageurl-gen.go b/acceleratedmobilepageurl/v1/acceleratedmobilepageurl-gen.go index a7028f68a8b..4cd127dd2b7 100644 --- a/acceleratedmobilepageurl/v1/acceleratedmobilepageurl-gen.go +++ b/acceleratedmobilepageurl/v1/acceleratedmobilepageurl-gen.go @@ -138,8 +138,9 @@ type AmpUrl struct { // AmpUrl: The AMP URL pointing to the publisher's web server. AmpUrl string `json:"ampUrl,omitempty"` - // CdnAmpUrl: The AMP Cache URL pointing to the cached document in the - // Google AMP Cache. + // CdnAmpUrl: The AMP Cache URL + // (/amp/cache/overview#amp-cache-url-format) pointing to the cached + // document in the Google AMP Cache. CdnAmpUrl string `json:"cdnAmpUrl,omitempty"` // OriginalUrl: The original non-AMP URL. @@ -237,7 +238,8 @@ type BatchGetAmpUrlsRequest struct { LookupStrategy string `json:"lookupStrategy,omitempty"` // Urls: List of URLs to look up for the paired AMP URLs. The URLs are - // case-sensitive. Up to 50 URLs per lookup (see Usage Limits). + // case-sensitive. Up to 50 URLs per lookup (see Usage Limits + // (/amp/cache/reference/limits)). Urls []string `json:"urls,omitempty"` // ForceSendFields is a list of field names (e.g. "LookupStrategy") to @@ -312,7 +314,8 @@ type AmpUrlsBatchGetCall struct { header_ http.Header } -// BatchGet: Returns AMP URL(s) and equivalent AMP Cache URL(s). +// BatchGet: Returns AMP URL(s) and equivalent AMP Cache URL(s) +// (/amp/cache/overview#amp-cache-url-format). func (r *AmpUrlsService) BatchGet(batchgetampurlsrequest *BatchGetAmpUrlsRequest) *AmpUrlsBatchGetCall { c := &AmpUrlsBatchGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.batchgetampurlsrequest = batchgetampurlsrequest diff --git a/accesscontextmanager/v1/accesscontextmanager-gen.go b/accesscontextmanager/v1/accesscontextmanager-gen.go index cb8d001d071..8391969ce2b 100644 --- a/accesscontextmanager/v1/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1/accesscontextmanager-gen.go @@ -868,7 +868,8 @@ type GcpUserAccessBinding struct { // Name: Immutable. Assigned by the server during creation. The last // segment has an arbitrary length and has only URI unreserved - // characters (as defined by RFC 3986 Section 2.3). Should not be + // characters (as defined by RFC 3986 Section 2.3 + // (https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be // specified by the client during creation. Example: // "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N" Name string `json:"name,omitempty"` @@ -1710,10 +1711,11 @@ func (s *ServicePerimeterConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/accesscontextmanager/v1beta/accesscontextmanager-gen.go b/accesscontextmanager/v1beta/accesscontextmanager-gen.go index 1a025b99a03..b9004b2c04e 100644 --- a/accesscontextmanager/v1beta/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1beta/accesscontextmanager-gen.go @@ -914,10 +914,11 @@ func (s *ServicePerimeterConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go index f0cf0ffdc5d..98b6a7ee023 100644 --- a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go +++ b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go @@ -977,7 +977,9 @@ func (s *Buyer) MarshalJSON() ([]byte, error) { // was not successful, as described by the specified callout status. type CalloutStatusRow struct { // CalloutStatusId: The ID of the callout status. See - // callout-status-codes. + // callout-status-codes + // (https://developers.google.com/authorized-buyers/rtb/downloads/callout + // -status-codes). CalloutStatusId int64 `json:"calloutStatusId,omitempty"` // ImpressionCount: The number of impressions for which there was a bid @@ -1038,9 +1040,14 @@ type Client struct { // among all the entities with the same type. The value of this field is // ignored if the entity type is not provided. A list of all known // advertisers with their identifiers is available in the - // advertisers.txt file. A list of all known brands with their - // identifiers is available in the brands.txt file. A list of all known - // agencies with their identifiers is available in the agencies.txt + // advertisers.txt + // (https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt) + // file. A list of all known brands with their identifiers is available + // in the brands.txt + // (https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt) + // file. A list of all known agencies with their identifiers is + // available in the agencies.txt + // (https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt) // file. EntityId int64 `json:"entityId,omitempty,string"` @@ -1793,7 +1800,9 @@ type CreativeStatusRow struct { BidCount *MetricValue `json:"bidCount,omitempty"` // CreativeStatusId: The ID of the creative status. See - // creative-status-codes. + // creative-status-codes + // (https://developers.google.com/authorized-buyers/rtb/downloads/creativ + // e-status-codes). CreativeStatusId int64 `json:"creativeStatusId,omitempty"` // RowDimensions: The values of all dimensions associated with metric @@ -2685,8 +2694,9 @@ type FilterSet struct { // seller (publisher) networks on which to filter; may be empty. The // filters represented by multiple seller network IDs are ORed together // (i.e., if non-empty, results must match any one of the publisher - // networks). See seller-network-ids file for the set of existing seller - // network IDs. + // networks). See seller-network-ids + // (https://developers.google.com/authorized-buyers/rtb/downloads/seller- + // network-ids) file for the set of existing seller network IDs. SellerNetworkIds []int64 `json:"sellerNetworkIds,omitempty"` // TimeSeriesGranularity: The granularity of time intervals if a time @@ -3882,8 +3892,9 @@ func (s *ListPublisherProfilesResponse) MarshalJSON() ([]byte, error) { // applies to. type LocationContext struct { // GeoCriteriaIds: IDs representing the geo location for this context. - // Please refer to the geo-table.csv file for different geo criteria - // IDs. + // Please refer to the geo-table.csv + // (https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) + // file for different geo criteria IDs. GeoCriteriaIds []int64 `json:"geoCriteriaIds,omitempty"` // ForceSendFields is a list of field names (e.g. "GeoCriteriaIds") to @@ -5072,7 +5083,10 @@ type ResumeProposalRequest struct { // for a given row. type RowDimensions struct { // PublisherIdentifier: The publisher identifier for this row, if a - // breakdown by BreakdownDimension.PUBLISHER_IDENTIFIER was requested. + // breakdown by BreakdownDimension.PUBLISHER_IDENTIFIER + // (https://developers.google.com/authorized-buyers/apis/reference/rest/v + // 2beta1/bidders.accounts.filterSets#FilterSet.BreakdownDimension) was + // requested. PublisherIdentifier string `json:"publisherIdentifier,omitempty"` // TimeInterval: The time interval that this row represents. diff --git a/adexperiencereport/v1/adexperiencereport-gen.go b/adexperiencereport/v1/adexperiencereport-gen.go index 8c58b6487b4..86db656803d 100644 --- a/adexperiencereport/v1/adexperiencereport-gen.go +++ b/adexperiencereport/v1/adexperiencereport-gen.go @@ -158,12 +158,15 @@ type PlatformSummary struct { // "FAILING" - Failing. BetterAdsStatus string `json:"betterAdsStatus,omitempty"` - // EnforcementTime: The time at which enforcement against the site began - // or will begin on this platform. Not set when the filter_status is - // OFF. + // EnforcementTime: The time at which enforcement + // (https://support.google.com/webtools/answer/7308033) against the site + // began or will begin on this platform. Not set when the filter_status + // is OFF. EnforcementTime string `json:"enforcementTime,omitempty"` - // FilterStatus: The site's enforcement status on this platform. + // FilterStatus: The site's enforcement status + // (https://support.google.com/webtools/answer/7308033) on this + // platform. // // Possible values: // "UNKNOWN" - N/A. @@ -190,8 +193,9 @@ type PlatformSummary struct { // ReportUrl: A link to the full Ad Experience Report for the site on // this platform.. Not set in ViolatingSitesResponse. Note that you must - // complete the Search Console verification process for the site before - // you can access the full report. + // complete the Search Console verification process + // (https://support.google.com/webmasters/answer/9008080) for the site + // before you can access the full report. ReportUrl string `json:"reportUrl,omitempty"` // UnderReview: Whether the site is currently under review on this diff --git a/admin/directory/v1/admin-gen.go b/admin/directory/v1/admin-gen.go index e718c20dc0c..d0c225fe5cd 100644 --- a/admin/directory/v1/admin-gen.go +++ b/admin/directory/v1/admin-gen.go @@ -667,13 +667,14 @@ func (s *Aliases) MarshalJSON() ([]byte, error) { // application on certain devices. The ASP access code is used instead // of the login and password you commonly use when accessing an // application through a browser. For more information about ASPs and -// how to create one, see the help center. +// how to create one, see the help center +// (//http://support.google.com/a/bin/answer.py?amp;answer=1032419). type Asp struct { // CodeId: The unique ID of the ASP. CodeId int64 `json:"codeId,omitempty"` // CreationTime: The time when the ASP was created. Expressed in Unix - // time format. + // time (http://en.wikipedia.org/wiki/Epoch_time) format. CreationTime int64 `json:"creationTime,omitempty,string"` // Etag: ETag of the ASP. @@ -684,7 +685,7 @@ type Asp struct { Kind string `json:"kind,omitempty"` // LastTimeUsed: The time when the ASP was last used. Expressed in Unix - // time format. + // time (http://en.wikipedia.org/wiki/Epoch_time) format. LastTimeUsed int64 `json:"lastTimeUsed,omitempty,string"` // Name: The name of the application that the user, represented by their @@ -761,9 +762,9 @@ func (s *Asps) MarshalJSON() ([]byte, error) { // Building: Public API: Resources.buildings type Building struct { - // Address: The postal address of the building. See `PostalAddress` for - // details. Note that only a single address line and region code are - // required. + // Address: The postal address of the building. See `PostalAddress` + // (/my-business/reference/rest/v4/PostalAddress) for details. Note that + // only a single address line and region code are required. Address *BuildingAddress `json:"address,omitempty"` // BuildingId: Unique identifier for the building. The maximum length is @@ -1160,8 +1161,10 @@ func (s *Channel) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ChromeOsDevice: Google Chrome devices run on the Chrome OS. For more -// information about common API tasks, see the Developer's Guide. +// ChromeOsDevice: Google Chrome devices run on the Chrome OS +// (http://support.google.com/chromeos). For more information about +// common API tasks, see the Developer's Guide +// (/admin-sdk/directory/v1/guides/manage-chrome-devices). type ChromeOsDevice struct { // ActiveTimeRanges: List of active time ranges (Read-only). ActiveTimeRanges []*ChromeOsDeviceActiveTimeRanges `json:"activeTimeRanges,omitempty"` @@ -1187,7 +1190,9 @@ type ChromeOsDevice struct { // `Verified`: The device is running a valid version of the Chrome OS. * // `Dev`: The devices's developer hardware switch is enabled. When // booted, the device has a command line shell. For an example of a - // developer switch, see the Chromebook developer information. + // developer switch, see the Chromebook developer information + // (http://www.chromium.org/chromium-os/developer-information-for-chrome- + // os-devices/samsung-series-5-chromebook#TOC-Developer-switch). BootMode string `json:"bootMode,omitempty"` // CpuStatusReports: Reports of CPU utilization and temperature @@ -1259,7 +1264,9 @@ type ChromeOsDevice struct { // wireless carrier's post-pay service plan. If the device does not have // this information, this property is not included in the response. For // more information on how to export a MEID/IMEI list, see the - // Developer's Guide. + // Developer's Guide + // (/admin-sdk/directory/v1/guides/manage-chrome-devices.html#export_meid + // ). Meid string `json:"meid,omitempty"` // Model: The device's model information. If the device does not have @@ -1267,8 +1274,12 @@ type ChromeOsDevice struct { Model string `json:"model,omitempty"` // Notes: Notes about this device added by the administrator. This - // property can be searched with the list method's `query` parameter. - // Maximum length is 500 characters. Empty values are allowed. + // property can be searched + // (http://support.google.com/chromeos/a/bin/answer.py?answer=1698333) + // with the list + // (/admin-sdk/directory/v1/reference/chromeosdevices/list) method's + // `query` parameter. Maximum length is 500 characters. Empty values are + // allowed. Notes string `json:"notes,omitempty"` // OrderNumber: The device's order number. Only devices directly @@ -1279,9 +1290,10 @@ type ChromeOsDevice struct { // associated with the device. Path names are case insensitive. If the // parent organizational unit is the top-level organization, it is // represented as a forward slash, `/`. This property can be updated - // using the API. For more information about how to create an + // (/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_de + // vice) using the API. For more information about how to create an // organizational structure for your device, see the administration help - // center. + // center (http://support.google.com/a/bin/answer.py?answer=182433). OrgUnitPath string `json:"orgUnitPath,omitempty"` // OsVersion: The Chrome device's operating system version. @@ -1768,12 +1780,14 @@ type Customer struct { Kind string `json:"kind,omitempty"` // Language: The customer's ISO 639-2 language code. See the Language - // Codes page for the list of supported codes. Valid language codes - // outside the supported set will be accepted by the API but may lead to - // unexpected behavior. The default value is `en`. + // Codes (/admin-sdk/directory/v1/languages) page for the list of + // supported codes. Valid language codes outside the supported set will + // be accepted by the API but may lead to unexpected behavior. The + // default value is `en`. Language string `json:"language,omitempty"` - // PhoneNumber: The customer's contact phone number in E.164 format. + // PhoneNumber: The customer's contact phone number in E.164 + // (http://en.wikipedia.org/wiki/E.164) format. PhoneNumber string `json:"phoneNumber,omitempty"` // PostalAddress: The customer's postal address information. @@ -1822,7 +1836,8 @@ type CustomerPostalAddress struct { ContactName string `json:"contactName,omitempty"` // CountryCode: This is a required property. For `countryCode` - // information see the ISO 3166 country code elements. + // information see the ISO 3166 country code elements + // (http://www.iso.org/iso/country_codes.htm). CountryCode string `json:"countryCode,omitempty"` // Locality: Name of the locality. An example of a locality value is the @@ -2167,7 +2182,7 @@ func (s *DomainAliases) MarshalJSON() ([]byte, error) { type Domains struct { // CreationTime: Creation time of the domain. Expressed in Unix time - // format. (Read-only). + // (http://en.wikipedia.org/wiki/Epoch_time) format. (Read-only). CreationTime int64 `json:"creationTime,omitempty,string"` // DomainAliases: List of domain alias objects. (Read-only) @@ -2391,7 +2406,8 @@ func (s *Features) MarshalJSON() ([]byte, error) { // Group: Google Groups provide your users the ability to send messages // to groups of people using the group's email address. For more -// information about common tasks, see the Developer's Guide. +// information about common tasks, see the Developer's Guide +// (/admin-sdk/directory/v1/guides/manage-groups). type Group struct { // AdminCreated: Value is `true` if this group was created by an // administrator rather than a user. @@ -2417,7 +2433,8 @@ type Group struct { // domains, select the appropriate domain for the email address. The // `email` must be unique. This property is required when creating a // group. Group email addresses are subject to the same character usage - // rules as usernames, see the administration help center for the + // rules as usernames, see the administration help center + // (http://support.google.com/a/bin/answer.py?answer=33386) for the // details. Email string `json:"email,omitempty"` @@ -2513,7 +2530,7 @@ func (s *Groups) MarshalJSON() ([]byte, error) { // Member: A Google Groups member can be a user or another group. This // member can be inside or outside of your account's domains. For more // information about common group member tasks, see the Developer's -// Guide. +// Guide (/admin-sdk/directory/v1/guides/manage-group-members). type Member struct { // DeliverySettings: Defines mail delivery preferences of member. This // is only supported by create/update/get. @@ -2540,8 +2557,8 @@ type Member struct { // Role: The member's role in a group. The API returns an error for // cycles in group memberships. For example, if `group1` is a member of // `group2`, `group2` cannot be a member of `group1`. For more - // information about a member's role, see the administration help - // center. + // information about a member's role, see the administration help center + // (http://support.google.com/a/bin/answer.py?answer=167094). Role string `json:"role,omitempty"` // Status: Status of member (Immutable) @@ -2652,9 +2669,11 @@ func (s *MembersHasMember) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// MobileDevice: G Suite Mobile Management includes Android, Google -// Sync, and iOS devices. For more information about common group mobile -// device API tasks, see the Developer's Guide. +// MobileDevice: G Suite Mobile Management includes Android, Google Sync +// (http://support.google.com/a/bin/answer.py?answer=135937), and iOS +// devices. For more information about common group mobile device API +// tasks, see the Developer's Guide +// (/admin-sdk/directory/v1/guides/manage-mobile-devices.html). type MobileDevice struct { // AdbStatus: Adb (USB debugging) enabled or disabled on device // (Read-only) @@ -2700,8 +2719,10 @@ type MobileDevice struct { DevicePasswordStatus string `json:"devicePasswordStatus,omitempty"` // Email: List of owner's email addresses. If your application needs the - // current list of user emails, use the get method. For additional - // information, see the retrieve a user method. + // current list of user emails, use the get + // (/admin-sdk/directory/v1/reference/mobiledevices/get.html) method. + // For additional information, see the retrieve a user + // (/admin-sdk/directory/v1/guides/manage-users#get_user) method. Email []string `json:"email,omitempty"` // EncryptionStatus: Mobile Device Encryption Status (Read-only) @@ -2750,14 +2771,19 @@ type MobileDevice struct { Meid string `json:"meid,omitempty"` // Model: The mobile device's model name, for example Nexus S. This - // property can be updated. For more information, see the Developer's - // Guide. + // property can be updated + // (/admin-sdk/directory/v1/reference/mobiledevices/update.html). For + // more information, see the Developer's Guide + // (/admin-sdk/directory/v1/guides/manage-mobile=devices#update_mobile_de + // vice). Model string `json:"model,omitempty"` // Name: List of the owner's user names. If your application needs the - // current list of device owner names, use the get method. For more - // information about retrieving mobile device user information, see the - // Developer's Guide. + // current list of device owner names, use the get + // (/admin-sdk/directory/v1/reference/mobiledevices/get.html) method. + // For more information about retrieving mobile device user information, + // see the Developer's Guide + // (/admin-sdk/directory/v1/guides/manage-users#get_user). Name []string `json:"name,omitempty"` // NetworkOperator: Mobile Device mobile or network operator (if @@ -2765,8 +2791,11 @@ type MobileDevice struct { NetworkOperator string `json:"networkOperator,omitempty"` // Os: The mobile device's operating system, for example IOS 4.3 or - // Android 2.3.5. This property can be updated. For more information, - // see the Developer's Guide. + // Android 2.3.5. This property can be updated + // (/admin-sdk/directory/v1/reference/mobiledevices/update.html). For + // more information, see the Developer's Guide + // (/admin-sdk/directory/v1/guides/manage-mobile-devices#update_mobile_de + // vice). Os string `json:"os,omitempty"` // OtherAccountsInfo: List of accounts added on device (Read-only) @@ -2802,8 +2831,11 @@ type MobileDevice struct { UnknownSourcesStatus bool `json:"unknownSourcesStatus,omitempty"` // UserAgent: Gives information about the device such as `os` version. - // This property can be updated. For more information, see the - // Developer's Guide. + // This property can be updated + // (/admin-sdk/directory/v1/reference/mobiledevices/update.html). For + // more information, see the Developer's Guide + // (/admin-sdk/directory/v1/guides/manage-mobile-devices#update_mobile_de + // vice). UserAgent string `json:"userAgent,omitempty"` // WifiMacAddress: The device's MAC address on Wi-Fi networks. @@ -2846,9 +2878,10 @@ type MobileDeviceApplications struct { // Permission: The list of permissions of this application. These can be // either a standard Android permission or one defined by the - // application, and are found in an application's Android manifest. - // Examples of a Calendar application's permissions are `READ_CALENDAR`, - // or `MANAGE_ACCOUNTS`. + // application, and are found in an application's Android manifest + // (http://developer.android.com/guide/topics/manifest/uses-permission-el + // ement.html). Examples of a Calendar application's permissions are + // `READ_CALENDAR`, or `MANAGE_ACCOUNTS`. Permission []string `json:"permission,omitempty"` // VersionCode: The application's version code. An example is `13`. @@ -2951,14 +2984,17 @@ func (s *MobileDevices) MarshalJSON() ([]byte, error) { // OrgUnit: Managing your account's organizational units allows you to // configure your users' access to services and custom settings. For // more information about common organizational unit tasks, see the -// Developer's Guide. +// Developer's Guide +// (/admin-sdk/directory/v1/guides/manage-org-units.html). type OrgUnit struct { // BlockInheritance: Determines if a sub-organizational unit can inherit // the settings of the parent organization. The default value is // `false`, meaning a sub-organizational unit inherits the settings of // the nearest parent organizational unit. For more information on // inheritance and users in an organization structure, see the - // administration help center. + // administration help center + // (http://support.google.com/a/bin/answer.py?answer=182442&topic=1227584 + // &ctx=topic). BlockInheritance bool `json:"blockInheritance,omitempty"` // Description: Description of the organizational unit. @@ -2989,8 +3025,11 @@ type OrgUnit struct { // which G Suite services the user has access to. If the user is moved // to a new organization, the user's access changes. For more // information about organization structures, see the administration - // help center. For more information about moving a user to a different - // organization, see Update a user. + // help center + // (http://support.google.com/a/bin/answer.py?answer=182433&topic=1227584 + // &ctx=topic). For more information about moving a user to a different + // organization, see Update a user + // (/admin-sdk/directory/v1/guides/manage-users.html#update_user). OrgUnitPath string `json:"orgUnitPath,omitempty"` // ParentOrgUnitId: The unique ID of the parent organizational unit. @@ -3089,7 +3128,8 @@ type Privilege struct { PrivilegeName string `json:"privilegeName,omitempty"` // ServiceId: The obfuscated ID of the service this privilege is for. - // This value is returned with `Privileges.list()`. + // This value is returned with `Privileges.list()` + // (/admin-sdk/directory/v1/reference/privileges/list). ServiceId string `json:"serviceId,omitempty"` // ServiceName: The name of the service this privilege is for. @@ -3248,7 +3288,8 @@ type RoleRolePrivileges struct { PrivilegeName string `json:"privilegeName,omitempty"` // ServiceId: The obfuscated ID of the service this privilege is for. - // This value is returned with `Privileges.list()`. + // This value is returned with `Privileges.list()` + // (/admin-sdk/directory/v1/reference/privileges/list). ServiceId string `json:"serviceId,omitempty"` // ForceSendFields is a list of field names (e.g. "PrivilegeName") to @@ -3458,7 +3499,8 @@ func (s *Schema) MarshalJSON() ([]byte, error) { // profiles. You can use these fields to store information such as the // projects your users work on, their physical locations, their hire // dates, or whatever else fits your business needs. For more -// information, see Custom User Fields. +// information, see Custom User Fields +// (/admin-sdk/directory/v1/guides/manage-schemas). type SchemaFieldSpec struct { // DisplayName: Display Name of the field. DisplayName string `json:"displayName,omitempty"` @@ -3496,8 +3538,10 @@ type SchemaFieldSpec struct { NumericIndexingSpec *SchemaFieldSpecNumericIndexingSpec `json:"numericIndexingSpec,omitempty"` // ReadAccessType: Specifies who can view values of this field. See - // Retrieve users as a non-administrator for more information. Note: It - // may take up to 24 hours for changes to this field to be reflected. + // Retrieve users as a non-administrator + // (/admin-sdk/directory/v1/guides/manage-users#retrieve_users_non_admin) + // for more information. Note: It may take up to 24 hours for changes + // to this field to be reflected. ReadAccessType string `json:"readAccessType,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -3717,7 +3761,9 @@ func (s *Tokens) MarshalJSON() ([]byte, error) { // User: The Directory API allows you to create and manage your // account's users, user aliases, and user Gmail chat profile photos. // For more information about common tasks, see the User Accounts -// Developer's Guide and the User Aliases Developer's Guide. +// Developer's Guide (/admin-sdk/directory/v1/guides/manage-users.html) +// and the User Aliases Developer's Guide +// (/admin-sdk/directory/v1/guides/manage-user-aliases.html). type User struct { // Addresses: A list of the user's addresses. The maximum allowed data // size for this field is 10Kb. @@ -3736,7 +3782,8 @@ type User struct { // ChangePasswordAtNextLogin: Indicates if the user is forced to change // their password at next login. This setting doesn't apply when the - // user signs in via a third-party identity provider. + // user signs in via a third-party identity provider + // (https://support.google.com/a/answer/60224). ChangePasswordAtNextLogin bool `json:"changePasswordAtNextLogin,omitempty"` // CreationTime: User's G Suite account creation time. (Read-only) @@ -3746,11 +3793,13 @@ type User struct { CustomSchemas map[string]googleapi.RawMessage `json:"customSchemas,omitempty"` // CustomerId: Output only. The customer ID to retrieve all account - // users. You can use the alias `my_customer` to represent your - // account's `customerId`. As a reseller administrator, you can use the - // resold customer account's `customerId`. To get a `customerId`, use - // the account's primary domain in the `domain` parameter of a - // users.list request. + // users + // (/admin-sdk/directory/v1/guides/manage-users.html#get_all_users). You + // can use the alias `my_customer` to represent your account's + // `customerId`. As a reseller administrator, you can use the resold + // customer account's `customerId`. To get a `customerId`, use the + // account's primary domain in the `domain` parameter of a users.list + // (/admin-sdk/directory/v1/reference/users/list) request. CustomerId string `json:"customerId,omitempty"` DeletionTime string `json:"deletionTime,omitempty"` @@ -3773,7 +3822,9 @@ type User struct { // HashFunction: Stores the hash format of the password property. We // recommend sending the `password` property value as a base 16 bit // hexadecimal-encoded hash value. Set the `hashFunction` values as - // either the SHA-1, MD5, or crypt) hash format. + // either the SHA-1 (http://wikipedia.org/wiki/SHA-1), MD5 + // (http://wikipedia.org/wiki/MD5), or crypt + // (https://en.wikipedia.org/wiki/Crypt_(C)) hash format. HashFunction string `json:"hashFunction,omitempty"` // Id: The unique ID for the user. A user `id` can be used as a user @@ -3789,24 +3840,32 @@ type User struct { // IncludeInGlobalAddressList: Indicates if the user's profile is // visible in the G Suite global address list when the contact sharing // feature is enabled for the domain. For more information about - // excluding user profiles, see the administration help center. + // excluding user profiles, see the administration help center + // (http://support.google.com/a/bin/answer.py?answer=1285988). IncludeInGlobalAddressList bool `json:"includeInGlobalAddressList,omitempty"` - // IpWhitelisted: If `true`, the user's IP address is white listed. + // IpWhitelisted: If `true`, the user's IP address is white listed + // (http://support.google.com/a/bin/answer.py?answer=60752). IpWhitelisted bool `json:"ipWhitelisted,omitempty"` // IsAdmin: Output only. Indicates a user with super admininistrator // privileges. The `isAdmin` property can only be edited in the Make a - // user an administrator operation ( makeAdmin method). If edited in the - // user insert or update methods, the edit is ignored by the API - // service. + // user an administrator + // (/admin-sdk/directory/v1/guides/manage-users.html#make_admin) + // operation ( makeAdmin + // (/admin-sdk/directory/v1/reference/users/makeAdmin.html) method). If + // edited in the user insert + // (/admin-sdk/directory/v1/reference/users/insert.html) or update + // (/admin-sdk/directory/v1/reference/users/update.html) methods, the + // edit is ignored by the API service. IsAdmin bool `json:"isAdmin,omitempty"` // IsDelegatedAdmin: Output only. Indicates if the user is a delegated // administrator. Delegated administrators are supported by the API but // cannot create or undelete users, or make users administrators. These // requests are ignored by the API service. Roles and privileges for - // administrators are assigned using the Admin console. + // administrators are assigned using the Admin console + // (http://support.google.com/a/bin/answer.py?answer=33325). IsDelegatedAdmin bool `json:"isDelegatedAdmin,omitempty"` // IsEnforcedIn2Sv: Output only. Is 2-step verification enforced @@ -3847,8 +3906,9 @@ type User struct { // support unicode/UTF-8 characters, and can contain spaces, letters // (a-z), numbers (0-9), dashes (-), forward slashes (/), and periods // (.). For more information about character usage rules, see the - // administration help center. Maximum allowed data size for this field - // is 1Kb. + // administration help center + // (http://support.google.com/a/bin/answer.py?answer=33386). Maximum + // allowed data size for this field is 1Kb. Name *UserName `json:"name,omitempty"` // NonEditableAliases: Output only. List of the user's non-editable @@ -3875,7 +3935,9 @@ type User struct { // size for this field is 1Kb. Phones interface{} `json:"phones,omitempty"` - // PosixAccounts: A list of POSIX account information for the user. + // PosixAccounts: A list of POSIX + // (http://www.opengroup.org/austin/papers/posix_faq.html) account + // information for the user. PosixAccounts interface{} `json:"posixAccounts,omitempty"` // PrimaryEmail: The user's primary email address. This property is @@ -4528,8 +4590,9 @@ type UserPhoto struct { // `PNG`, `GIF`, `BMP`, `TIFF`, and web-safe base64 encoding. MimeType string `json:"mimeType,omitempty"` - // PhotoData: The user photo's upload data in web-safe Base64 format in - // bytes. This means: * The slash (/) character is replaced with the + // PhotoData: The user photo's upload data in web-safe Base64 + // (https://code.google.com/p/stringencoders/wiki/WebSafeBase64) format + // in bytes. This means: * The slash (/) character is replaced with the // underscore (_) character. * The plus sign (+) character is replaced // with the hyphen (-) character. * The equals sign (=) character is // replaced with the asterisk (*). * For padding, the period (.) @@ -5422,7 +5485,8 @@ type ChromeosdevicesActionCall struct { // consume a device license. If you do not have sufficient licenses // available when completing the re-enable action, you will receive an // error. For more information about deprovisioning and disabling -// devices, visit the help center. +// devices, visit the help center +// (https://support.google.com/chrome/a/answer/3523633). func (r *ChromeosdevicesService) Action(customerId string, resourceId string, chromeosdeviceaction *ChromeOsDeviceAction) *ChromeosdevicesActionCall { c := &ChromeosdevicesActionCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.customerId = customerId @@ -6172,7 +6236,8 @@ type ChromeosdevicesPatchCall struct { // Patch: Updates a device's updatable properties, such as // `annotatedUser`, `annotatedLocation`, `notes`, `orgUnitPath`, or -// `annotatedAssetId`. This method supports patch semantics. +// `annotatedAssetId`. This method supports patch semantics +// (/admin-sdk/directory/v1/guides/performance#patch). func (r *ChromeosdevicesService) Patch(customerId string, deviceId string, chromeosdevice *ChromeOsDevice) *ChromeosdevicesPatchCall { c := &ChromeosdevicesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.customerId = customerId @@ -8755,6 +8820,7 @@ func (r *GroupsService) List() *GroupsListCall { // As an account administrator, you can also use the `my_customer` alias // to represent your account's `customerId`. The `customerId` is also // returned as part of the Users +// (/admin-sdk/directory/v1/reference/users) func (c *GroupsListCall) Customer(customer string) *GroupsListCall { c.urlParams_.Set("customer", customer) return c @@ -9032,7 +9098,7 @@ type GroupsPatchCall struct { } // Patch: Updates a group's properties. This method supports patch -// semantics. +// semantics (/admin-sdk/directory/v1/guides/performance#patch). func (r *GroupsService) Patch(groupKey string, group *Group) *GroupsPatchCall { c := &GroupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.groupKey = groupKey @@ -10491,7 +10557,8 @@ type MembersPatchCall struct { } // Patch: Updates the membership properties of a user in the specified -// group. This method supports patch semantics. +// group. This method supports patch semantics +// (/admin-sdk/directory/v1/guides/performance#patch). func (r *MembersService) Patch(groupKey string, memberKey string, member *Member) *MembersPatchCall { c := &MembersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.groupKey = groupKey @@ -12110,7 +12177,7 @@ type OrgunitsPatchCall struct { } // Patch: Updates an organizational unit. This method supports patch -// semantics +// semantics (/admin-sdk/directory/v1/guides/performance#patch) func (r *OrgunitsService) Patch(customerId string, orgUnitPath string, orgunit *OrgUnit) *OrgunitsPatchCall { c := &OrgunitsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.customerId = customerId @@ -18506,7 +18573,9 @@ func (c *UsersGetCall) Projection(projection string) *UsersGetCall { // ViewType sets the optional parameter "viewType": Whether to fetch the // administrator-only or domain-wide public view of the user. For more -// information, see Retrieve a user as a non-administrator. +// information, see Retrieve a user as a non-administrator +// (/admin-sdk/directory/v1/guides/manage-users#retrieve_users_non_admin) +// . // // Possible values: // "view_type_undefined" @@ -18839,8 +18908,8 @@ func (c *UsersListCall) CustomFieldMask(customFieldMask string) *UsersListCall { // fetch all groups for a customer, fill this field instead of domain. // You can also use the `my_customer` alias to represent your account's // `customerId`. The `customerId` is also returned as part of the Users -// resource. Either the `customer` or the `domain` parameter must be -// provided. +// resource (/admin-sdk/directory/v1/reference/users). Either the +// `customer` or the `domain` parameter must be provided. func (c *UsersListCall) Customer(customer string) *UsersListCall { c.urlParams_.Set("customer", customer) return c @@ -18898,7 +18967,7 @@ func (c *UsersListCall) Projection(projection string) *UsersListCall { // Query sets the optional parameter "query": Query string for searching // user fields. For more information on constructing user queries, see -// Search for Users. +// Search for Users (/admin-sdk/directory/v1/guides/search-users). func (c *UsersListCall) Query(query string) *UsersListCall { c.urlParams_.Set("query", query) return c @@ -18925,7 +18994,9 @@ func (c *UsersListCall) SortOrder(sortOrder string) *UsersListCall { // ViewType sets the optional parameter "viewType": Whether to fetch the // administrator-only or domain-wide public view of the user. For more -// information, see Retrieve a user as a non-administrator. +// information, see Retrieve a user as a non-administrator +// (/admin-sdk/directory/v1/guides/manage-users#retrieve_users_non_admin) +// . // // Possible values: // "view_type_undefined" @@ -19915,7 +19986,9 @@ func (c *UsersWatchCall) SortOrder(sortOrder string) *UsersWatchCall { // ViewType sets the optional parameter "viewType": Whether to fetch the // administrator-only or domain-wide public view of the user. For more -// information, see Retrieve a user as a non-administrator. +// information, see Retrieve a user as a non-administrator +// (/admin-sdk/directory/v1/guides/manage-users#retrieve_users_non_admin) +// . // // Possible values: // "admin_view" (default) - Results include both administrator-only @@ -20985,7 +21058,7 @@ type UsersPhotosPatchCall struct { } // Patch: Adds a photo for the user. This method supports patch -// semantics. +// semantics (/admin-sdk/directory/v1/guides/performance#patch). func (r *UsersPhotosService) Patch(userKey string, userphoto *UserPhoto) *UsersPhotosPatchCall { c := &UsersPhotosPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.userKey = userKey diff --git a/admin/reports/v1/admin-gen.go b/admin/reports/v1/admin-gen.go index 8a98a9418c5..41d00ef348e 100644 --- a/admin/reports/v1/admin-gen.go +++ b/admin/reports/v1/admin-gen.go @@ -671,7 +671,8 @@ type UsageReport struct { // Parameters: Output only. Parameter value pairs for various // applications. For the Entity Usage Report parameters and values, see - // the Entity Usage parameters reference. + // the Entity Usage parameters reference + // (/admin-sdk/reports/v1/reference/usage-ref-appendix-a/entities). Parameters []*UsageReportParameters `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "Date") to diff --git a/alertcenter/v1beta1/alertcenter-gen.go b/alertcenter/v1beta1/alertcenter-gen.go index 154e0498f62..6df41d4cf46 100644 --- a/alertcenter/v1beta1/alertcenter-gen.go +++ b/alertcenter/v1beta1/alertcenter-gen.go @@ -310,7 +310,8 @@ type Alert struct { Metadata *AlertMetadata `json:"metadata,omitempty"` // SecurityInvestigationToolLink: Output only. An optional Security - // Investigation Tool query for this alert. + // Investigation Tool (https://support.google.com/a/answer/7575955) + // query for this alert. SecurityInvestigationToolLink string `json:"securityInvestigationToolLink,omitempty"` // Source: Required. A unique identifier for the system that reported @@ -326,7 +327,7 @@ type Alert struct { // Type: Required. The type of the alert. This is output only after // alert is created. For a list of available alert types see G Suite - // Alert types. + // Alert types (/admin-sdk/alertcenter/reference/alert-types). Type string `json:"type,omitempty"` // UpdateTime: Output only. The time this alert was last updated. @@ -1334,7 +1335,8 @@ func (s *MatchInfo) MarshalJSON() ([]byte, error) { } // Notification: Settings for callback notifications. For more details -// see G Suite Alert Notification. +// see G Suite Alert Notification +// (/admin-sdk/alertcenter/guides/notifications). type Notification struct { // CloudPubsubTopic: A Google Cloud Pub/sub topic destination. CloudPubsubTopic *CloudPubsubTopic `json:"cloudPubsubTopic,omitempty"` @@ -1364,7 +1366,8 @@ func (s *Notification) MarshalJSON() ([]byte, error) { } // PhishingSpike: Alert for a spike in user reported phishing. -// *Warning*: This type has been deprecated. Use MailPhishing instead. +// *Warning*: This type has been deprecated. Use MailPhishing +// (/admin-sdk/alertcenter/reference/rest/v1beta1/MailPhishing) instead. type PhishingSpike struct { // DomainId: The domain ID. DomainId *DomainId `json:"domainId,omitempty"` @@ -1683,10 +1686,11 @@ func (s *StateSponsoredAttack) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2641,8 +2645,10 @@ func (c *AlertsListCall) CustomerId(customerId string) *AlertsListCall { } // Filter sets the optional parameter "filter": A query string for -// filtering alert results. For more details, see Query filters and -// Supported query filter fields. +// filtering alert results. For more details, see Query filters +// (/admin-sdk/alertcenter/guides/query-filters) and Supported query +// filter fields +// (/admin-sdk/alertcenter/reference/filter-fields#alerts.list). func (c *AlertsListCall) Filter(filter string) *AlertsListCall { c.urlParams_.Set("filter", filter) return c @@ -3167,7 +3173,9 @@ func (c *AlertsFeedbackListCall) CustomerId(customerId string) *AlertsFeedbackLi // Filter sets the optional parameter "filter": A query string for // filtering alert feedback results. For more details, see Query filters -// and Supported query filter fields. +// (/admin-sdk/alertcenter/guides/query-filters) and Supported query +// filter fields +// (/admin-sdk/alertcenter/reference/filter-fields#alerts.feedback.list). func (c *AlertsFeedbackListCall) Filter(filter string) *AlertsFeedbackListCall { c.urlParams_.Set("filter", filter) return c diff --git a/analyticsdata/v1alpha/analyticsdata-gen.go b/analyticsdata/v1alpha/analyticsdata-gen.go index e934b05db2d..d9309ec2d1d 100644 --- a/analyticsdata/v1alpha/analyticsdata-gen.go +++ b/analyticsdata/v1alpha/analyticsdata-gen.go @@ -661,13 +661,14 @@ type Dimension struct { // concatenate(country, ", ", city). DimensionExpression *DimensionExpression `json:"dimensionExpression,omitempty"` - // Name: The name of the dimension. See the API Dimensions for the list - // of dimension names. If `dimensionExpression` is specified, `name` can - // be any string that you would like. For example if a - // `dimensionExpression` concatenates `country` and `city`, you could - // call that dimension `countryAndCity`. Dimensions are referenced by - // `name` in `dimensionFilter`, `orderBys`, `dimensionExpression`, and - // `pivots`. + // Name: The name of the dimension. See the API Dimensions + // (https://developers.google.com/analytics/devguides/reporting/data/v1/a + // pi-schema#dimensions) for the list of dimension names. If + // `dimensionExpression` is specified, `name` can be any string that you + // would like. For example if a `dimensionExpression` concatenates + // `country` and `city`, you could call that dimension `countryAndCity`. + // Dimensions are referenced by `name` in `dimensionFilter`, `orderBys`, + // `dimensionExpression`, and `pivots`. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "DimensionExpression") @@ -766,8 +767,8 @@ func (s *DimensionHeader) MarshalJSON() ([]byte, error) { // DimensionMetadata: Explains a dimension. type DimensionMetadata struct { - // ApiName: This dimension's name. Useable in Dimension's `name`. For - // example, `eventName`. + // ApiName: This dimension's name. Useable in Dimension (#Dimension)'s + // `name`. For example, `eventName`. ApiName string `json:"apiName,omitempty"` // CustomDefinition: True if the dimension is a custom dimension for @@ -887,7 +888,9 @@ func (s *DimensionValue) MarshalJSON() ([]byte, error) { // tracked. type Entity struct { // PropertyId: A Google Analytics GA4 property id. To learn more, see - // where to find your Property ID. + // where to find your Property ID + // (https://developers.google.com/analytics/devguides/reporting/data/v1/p + // roperty-id). PropertyId string `json:"propertyId,omitempty"` // ForceSendFields is a list of field names (e.g. "PropertyId") to @@ -1113,12 +1116,13 @@ type Metric struct { // `expression`. Invisible bool `json:"invisible,omitempty"` - // Name: The name of the metric. See the API Metrics for the list of - // metric names. If `expression` is specified, `name` can be any string - // that you would like. For example if `expression` is - // `screenPageViews/sessions`, you could call that metric's name = - // `viewsPerSession`. Metrics are referenced by `name` in - // `metricFilter`, `orderBys`, and metric `expression`. + // Name: The name of the metric. See the API Metrics + // (https://developers.google.com/analytics/devguides/reporting/data/v1/a + // pi-schema#metrics) for the list of metric names. If `expression` is + // specified, `name` can be any string that you would like. For example + // if `expression` is `screenPageViews/sessions`, you could call that + // metric's name = `viewsPerSession`. Metrics are referenced by `name` + // in `metricFilter`, `orderBys`, and metric `expression`. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Expression") to @@ -1202,8 +1206,8 @@ func (s *MetricHeader) MarshalJSON() ([]byte, error) { // MetricMetadata: Explains a metric. type MetricMetadata struct { - // ApiName: A metric name. Useable in Metric's `name`. For example, - // `eventCount`. + // ApiName: A metric name. Useable in Metric (#Metric)'s `name`. For + // example, `eventCount`. ApiName string `json:"apiName,omitempty"` // CustomDefinition: True if the metric is a custom metric for this @@ -1220,9 +1224,9 @@ type MetricMetadata struct { Description string `json:"description,omitempty"` // Expression: The mathematical expression for this derived metric. Can - // be used in Metric's `expression` field for equivalent reports. Most - // metrics are not expressions, and for non-expressions, this field is - // empty. + // be used in Metric (#Metric)'s `expression` field for equivalent + // reports. Most metrics are not expressions, and for non-expressions, + // this field is empty. Expression string `json:"expression,omitempty"` // Type: The type of this metric. @@ -1868,7 +1872,8 @@ type RunPivotReportRequest struct { Pivots []*Pivot `json:"pivots,omitempty"` // ReturnPropertyQuota: Toggles whether to return the current state of - // this Analytics Property's quota. Quota is returned in PropertyQuota. + // this Analytics Property's quota. Quota is returned in PropertyQuota + // (#PropertyQuota). ReturnPropertyQuota bool `json:"returnPropertyQuota,omitempty"` // ForceSendFields is a list of field names (e.g. "CohortSpec") to @@ -2003,7 +2008,7 @@ type RunRealtimeReportRequest struct { // ReturnPropertyQuota: Toggles whether to return the current state of // this Analytics Property's Realtime quota. Quota is returned in - // PropertyQuota. + // PropertyQuota (#PropertyQuota). ReturnPropertyQuota bool `json:"returnPropertyQuota,omitempty"` // ForceSendFields is a list of field names (e.g. "DimensionFilter") to @@ -2131,7 +2136,9 @@ type RunReportRequest struct { // Limit: The number of rows to return. If unspecified, 10 rows are // returned. If -1, all rows are returned. To learn more about this - // pagination parameter, see Pagination. + // pagination parameter, see Pagination + // (https://developers.google.com/analytics/devguides/reporting/data/v1/b + // asics#pagination). Limit int64 `json:"limit,omitempty,string"` // MetricAggregations: Aggregation of metrics. Aggregated metric values @@ -2156,14 +2163,17 @@ type RunReportRequest struct { Metrics []*Metric `json:"metrics,omitempty"` // Offset: The row count of the start row. The first row is counted as - // row 0. To learn more about this pagination parameter, see Pagination. + // row 0. To learn more about this pagination parameter, see Pagination + // (https://developers.google.com/analytics/devguides/reporting/data/v1/b + // asics#pagination). Offset int64 `json:"offset,omitempty,string"` // OrderBys: Specifies how rows are ordered in the response. OrderBys []*OrderBy `json:"orderBys,omitempty"` // ReturnPropertyQuota: Toggles whether to return the current state of - // this Analytics Property's quota. Quota is returned in PropertyQuota. + // this Analytics Property's quota. Quota is returned in PropertyQuota + // (#PropertyQuota). ReturnPropertyQuota bool `json:"returnPropertyQuota,omitempty"` // ForceSendFields is a list of field names (e.g. "CohortSpec") to @@ -2218,7 +2228,9 @@ type RunReportResponse struct { // the number of rows returned in the response. For example if a query // returns 175 rows and includes limit = 50 in the API request, the // response will contain row_count = 175 but only 50 rows. To learn more - // about this pagination parameter, see Pagination. + // about this pagination parameter, see Pagination + // (https://developers.google.com/analytics/devguides/reporting/data/v1/b + // asics#pagination). RowCount int64 `json:"rowCount,omitempty"` // Rows: Rows of dimension value combinations and metric values in the diff --git a/analyticsreporting/v4/analyticsreporting-gen.go b/analyticsreporting/v4/analyticsreporting-gen.go index 9f8dcc63e2b..6ddc13880b8 100644 --- a/analyticsreporting/v4/analyticsreporting-gen.go +++ b/analyticsreporting/v4/analyticsreporting-gen.go @@ -351,22 +351,27 @@ type CohortGroup struct { // LifetimeValue: Enable Life Time Value (LTV). LTV measures lifetime // value for users acquired through different channels. Please see: - // Cohort Analysis and Lifetime Value If the value of lifetimeValue is - // false: - The metric values are similar to the values in the web - // interface cohort report. - The cohort definition date ranges must be - // aligned to the calendar week and month. i.e. while requesting - // `ga:cohortNthWeek` the `startDate` in the cohort definition should be - // a Sunday and the `endDate` should be the following Saturday, and for - // `ga:cohortNthMonth`, the `startDate` should be the 1st of the month - // and `endDate` should be the last day of the month. When the - // lifetimeValue is true: - The metric values will correspond to the - // values in the web interface LifeTime value report. - The Lifetime - // Value report shows you how user value (Revenue) and engagement - // (Appviews, Goal Completions, Sessions, and Session Duration) grow - // during the 90 days after a user is acquired. - The metrics are - // calculated as a cumulative average per user per the time increment. - - // The cohort definition date ranges need not be aligned to the calendar - // week and month boundaries. - The `viewId` must be an app view ID + // Cohort Analysis (https://support.google.com/analytics/answer/6074676) + // and Lifetime Value + // (https://support.google.com/analytics/answer/6182550) If the value of + // lifetimeValue is false: - The metric values are similar to the values + // in the web interface cohort report. - The cohort definition date + // ranges must be aligned to the calendar week and month. i.e. while + // requesting `ga:cohortNthWeek` the `startDate` in the cohort + // definition should be a Sunday and the `endDate` should be the + // following Saturday, and for `ga:cohortNthMonth`, the `startDate` + // should be the 1st of the month and `endDate` should be the last day + // of the month. When the lifetimeValue is true: - The metric values + // will correspond to the values in the web interface LifeTime value + // report. - The Lifetime Value report shows you how user value + // (Revenue) and engagement (Appviews, Goal Completions, Sessions, and + // Session Duration) grow during the 90 days after a user is acquired. - + // The metrics are calculated as a cumulative average per user per the + // time increment. - The cohort definition date ranges need not be + // aligned to the calendar week and month boundaries. - The `viewId` + // must be an app view ID + // (https://support.google.com/analytics/answer/2649553#WebVersusAppViews + // ) LifetimeValue bool `json:"lifetimeValue,omitempty"` // ForceSendFields is a list of field names (e.g. "Cohorts") to @@ -457,8 +462,8 @@ func (s *CustomDimension) MarshalJSON() ([]byte, error) { } // DateRange: A contiguous set of days: startDate, startDate + 1 day, -// ..., endDate. The start and end dates are specified in ISO8601 date -// format `YYYY-MM-DD`. +// ..., endDate. The start and end dates are specified in ISO8601 +// (https://en.wikipedia.org/wiki/ISO_8601) date format `YYYY-MM-DD`. type DateRange struct { // EndDate: The end date for the query in the format `YYYY-MM-DD`. EndDate string `json:"endDate,omitempty"` @@ -522,9 +527,11 @@ func (s *DateRangeValues) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Dimension: Dimensions are attributes of your data. For example, the -// dimension `ga:city` indicates the city, for example, "Paris" or "New -// York", from which a session originates. +// Dimension: Dimensions +// (https://support.google.com/analytics/answer/1033861) are attributes +// of your data. For example, the dimension `ga:city` indicates the +// city, for example, "Paris" or "New York", from which a session +// originates. type Dimension struct { // HistogramBuckets: If non-empty, we place dimension values into // buckets after string to int64. Dimension values that are not the @@ -837,12 +844,15 @@ type GetReportsRequest struct { // `cohortGroup`. ReportRequests []*ReportRequest `json:"reportRequests,omitempty"` - // UseResourceQuotas: Enables resource based quotas, (defaults to - // `False`). If this field is set to `True` the per view (profile) - // quotas are governed by the computational cost of the request. Note - // that using cost based quotas will higher enable sampling rates. (10 - // Million for `SMALL`, 100M for `LARGE`. See the limits and quotas - // documentation for details. + // UseResourceQuotas: Enables resource based quotas + // (/analytics/devguides/reporting/core/v4/limits-quotas#analytics_report + // ing_api_v4), (defaults to `False`). If this field is set to `True` + // the per view (profile) quotas are governed by the computational cost + // of the request. Note that using cost based quotas will higher enable + // sampling rates. (10 Million for `SMALL`, 100M for `LARGE`. See the + // limits and quotas documentation + // (/analytics/devguides/reporting/core/v4/limits-quotas#analytics_report + // ing_api_v4) for details. UseResourceQuotas bool `json:"useResourceQuotas,omitempty"` // ForceSendFields is a list of field names (e.g. "ReportRequests") to @@ -1008,9 +1018,9 @@ func (s *GoalSetData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Metric: Metrics are the quantitative measurements. For example, the -// metric `ga:users` indicates the total number of users for the -// requested time period. +// Metric: Metrics (https://support.google.com/analytics/answer/1033861) +// are the quantitative measurements. For example, the metric `ga:users` +// indicates the total number of users for the requested time period. type Metric struct { // Alias: An alias for the metric expression is an alternate name for // the expression. The alias can be used for filtering and sorting. This @@ -1640,16 +1650,20 @@ type ReportData struct { // dimensions. Rows []*ReportRow `json:"rows,omitempty"` - // SamplesReadCounts: If the results are sampled, this returns the total - // number of samples read, one entry per date range. If the results are - // not sampled this field will not be defined. See developer guide for + // SamplesReadCounts: If the results are sampled + // (https://support.google.com/analytics/answer/2637192), this returns + // the total number of samples read, one entry per date range. If the + // results are not sampled this field will not be defined. See developer + // guide (/analytics/devguides/reporting/core/v4/basics#sampling) for // details. SamplesReadCounts googleapi.Int64s `json:"samplesReadCounts,omitempty"` - // SamplingSpaceSizes: If the results are sampled, this returns the - // total number of samples present, one entry per date range. If the + // SamplingSpaceSizes: If the results are sampled + // (https://support.google.com/analytics/answer/2637192), this returns + // the total number of samples present, one entry per date range. If the // results are not sampled this field will not be defined. See developer - // guide for details. + // guide (/analytics/devguides/reporting/core/v4/basics#sampling) for + // details. SamplingSpaceSizes googleapi.Int64s `json:"samplingSpaceSizes,omitempty"` // Totals: For each requested date range, for the set of all rows that @@ -1690,8 +1704,8 @@ func (s *ReportData) MarshalJSON() ([]byte, error) { type ReportRequest struct { // CohortGroup: Cohort group associated with this request. If there is a // cohort group in the request the `ga:cohort` dimension must be - // present. Every ReportRequest within a `batchGet` method must contain - // the same `cohortGroup` definition. + // present. Every ReportRequest (#ReportRequest) within a `batchGet` + // method must contain the same `cohortGroup` definition. CohortGroup *CohortGroup `json:"cohortGroup,omitempty"` // DateRanges: Date ranges in the request. The request can have a @@ -1702,8 +1716,9 @@ type ReportRequest struct { // second date range. The `reportRequest.dateRanges` field should not be // specified for cohorts or Lifetime value requests. If a date range is // not provided, the default date range is (startDate: current date - 7 - // days, endDate: current date - 1 day). Every ReportRequest within a - // `batchGet` method must contain the same `dateRanges` definition. + // days, endDate: current date - 1 day). Every ReportRequest + // (#ReportRequest) within a `batchGet` method must contain the same + // `dateRanges` definition. DateRanges []*DateRange `json:"dateRanges,omitempty"` // DimensionFilterClauses: The dimension filter clauses for filtering @@ -1723,7 +1738,9 @@ type ReportRequest struct { // expression. For example, the following expression selects // `ga:browser` dimension which starts with Firefox; // `ga:browser=~^Firefox`. For more information on dimensions and metric - // filters, see Filters reference. + // filters, see Filters reference + // (https://developers.google.com/analytics/devguides/reporting/core/v3/r + // eference#filters). FiltersExpression string `json:"filtersExpression,omitempty"` // HideTotals: If set to true, hides the total of all metrics for all @@ -1777,10 +1794,13 @@ type ReportRequest struct { // pivots. Pivots []*Pivot `json:"pivots,omitempty"` - // SamplingLevel: The desired report sample size. If the the - // `samplingLevel` field is unspecified the `DEFAULT` sampling level is - // used. Every ReportRequest within a `batchGet` method must contain the - // same `samplingLevel` definition. See developer guide for details. + // SamplingLevel: The desired report sample + // (https://support.google.com/analytics/answer/2637192) size. If the + // the `samplingLevel` field is unspecified the `DEFAULT` sampling level + // is used. Every ReportRequest (#ReportRequest) within a `batchGet` + // method must contain the same `samplingLevel` definition. See + // developer guide + // (/analytics/devguides/reporting/core/v4/basics#sampling) for details. // // Possible values: // "SAMPLING_UNSPECIFIED" - If the `samplingLevel` field is @@ -1794,14 +1814,16 @@ type ReportRequest struct { // Segments: Segment the data returned for the request. A segment // definition helps look at a subset of the segment request. A request - // can contain up to four segments. Every ReportRequest within a - // `batchGet` method must contain the same `segments` definition. - // Requests with segments must have the `ga:segment` dimension. + // can contain up to four segments. Every ReportRequest (#ReportRequest) + // within a `batchGet` method must contain the same `segments` + // definition. Requests with segments must have the `ga:segment` + // dimension. Segments []*Segment `json:"segments,omitempty"` - // ViewId: The Analytics view ID from which to retrieve data. Every - // ReportRequest within a `batchGet` method must contain the same - // `viewId`. + // ViewId: The Analytics view ID + // (https://support.google.com/analytics/answer/1009618) from which to + // retrieve data. Every ReportRequest (#ReportRequest) within a + // `batchGet` method must contain the same `viewId`. ViewId string `json:"viewId,omitempty"` // ForceSendFields is a list of field names (e.g. "CohortGroup") to @@ -1964,15 +1986,19 @@ type SearchUserActivityRequest struct { // PageToken: A continuation token to get the next page of the results. // Adding this to the request will return the rows after the pageToken. // The pageToken should be the value returned in the nextPageToken - // parameter in the response to the SearchUserActivityRequest request. + // parameter in the response to the SearchUserActivityRequest + // (#SearchUserActivityRequest) request. PageToken string `json:"pageToken,omitempty"` // User: Required. Unique user Id to query for. Every - // SearchUserActivityRequest must contain this field. + // SearchUserActivityRequest (#SearchUserActivityRequest) must contain + // this field. User *User `json:"user,omitempty"` - // ViewId: Required. The Analytics view ID from which to retrieve data. - // Every SearchUserActivityRequest must contain the `viewId`. + // ViewId: Required. The Analytics view ID + // (https://support.google.com/analytics/answer/1009618) from which to + // retrieve data. Every SearchUserActivityRequest + // (#SearchUserActivityRequest) must contain the `viewId`. ViewId string `json:"viewId,omitempty"` // ForceSendFields is a list of field names (e.g. "ActivityTypes") to @@ -2002,12 +2028,14 @@ func (s *SearchUserActivityRequest) MarshalJSON() ([]byte, error) { // call. type SearchUserActivityResponse struct { // NextPageToken: This token should be passed to - // SearchUserActivityRequest to retrieve the next page. + // SearchUserActivityRequest (#SearchUserActivityRequest) to retrieve + // the next page. NextPageToken string `json:"nextPageToken,omitempty"` - // SampleRate: This field represents the sampling rate for the given - // request and is a number between 0.0 to 1.0. See developer guide for - // details. + // SampleRate: This field represents the sampling rate + // (https://support.google.com/analytics/answer/2637192) for the given + // request and is a number between 0.0 to 1.0. See developer guide + // (/analytics/devguides/reporting/core/v4/basics#sampling) for details. SampleRate float64 `json:"sampleRate,omitempty"` // Sessions: Each record represents a session (device details, duration, diff --git a/androiddeviceprovisioning/v1/androiddeviceprovisioning-gen.go b/androiddeviceprovisioning/v1/androiddeviceprovisioning-gen.go index 9f7bc2059a4..34bec62ef72 100644 --- a/androiddeviceprovisioning/v1/androiddeviceprovisioning-gen.go +++ b/androiddeviceprovisioning/v1/androiddeviceprovisioning-gen.go @@ -798,11 +798,13 @@ type Device struct { DeviceId int64 `json:"deviceId,omitempty,string"` // DeviceIdentifier: The hardware IDs that identify a manufactured - // device. To learn more, read Identifiers. + // device. To learn more, read Identifiers + // (https://developers.google.com/zero-touch/guides/identifiers). DeviceIdentifier *DeviceIdentifier `json:"deviceIdentifier,omitempty"` // DeviceMetadata: The metadata attached to the device. Structured as - // key-value pairs. To learn more, read Device metadata. + // key-value pairs. To learn more, read Device metadata + // (https://developers.google.com/zero-touch/guides/metadata). DeviceMetadata *DeviceMetadata `json:"deviceMetadata,omitempty"` // Name: Output only. The API resource name in the format @@ -839,7 +841,7 @@ func (s *Device) MarshalJSON() ([]byte, error) { // DeviceClaim: A record of a device claimed by a reseller for a // customer. Devices claimed for zero-touch enrollment have a claim with // the type `SECTION_TYPE_ZERO_TOUCH`. To learn more, read Claim devices -// for customers. +// for customers (/zero-touch/guides/how-it-works#claim). type DeviceClaim struct { // OwnerCompanyId: The ID of the Customer that purchased the device. OwnerCompanyId int64 `json:"ownerCompanyId,omitempty,string"` @@ -891,14 +893,16 @@ func (s *DeviceClaim) MarshalJSON() ([]byte, error) { // DeviceIdentifier: Encapsulates hardware and product IDs to identify a // manufactured device. To understand requirements on identifier sets, -// read Identifiers. +// read Identifiers +// (https://developers.google.com/zero-touch/guides/identifiers). type DeviceIdentifier struct { // Imei: The device’s IMEI number. Validated on input. Imei string `json:"imei,omitempty"` // Manufacturer: The device manufacturer’s name. Matches the device's // built-in value returned from `android.os.Build.MANUFACTURER`. Allowed - // values are listed in manufacturers. + // values are listed in manufacturers + // (/zero-touch/resources/manufacturer-names#manufacturers-names). Manufacturer string `json:"manufacturer,omitempty"` // Meid: The device’s MEID number. @@ -906,7 +910,7 @@ type DeviceIdentifier struct { // Model: The device model's name. Matches the device's built-in value // returned from `android.os.Build.MODEL`. Allowed values are listed in - // models. + // models (/zero-touch/resources/manufacturer-names#model-names). Model string `json:"model,omitempty"` // SerialNumber: The manufacturer's serial number for the device. This @@ -937,7 +941,8 @@ func (s *DeviceIdentifier) MarshalJSON() ([]byte, error) { } // DeviceMetadata: Metadata entries that can be attached to a `Device`. -// To learn more, read Device metadata. +// To learn more, read Device metadata +// (https://developers.google.com/zero-touch/guides/metadata). type DeviceMetadata struct { // Entries: Metadata entries recorded as key-value pairs. Entries map[string]string `json:"entries,omitempty"` @@ -975,7 +980,8 @@ func (s *DeviceMetadata) MarshalJSON() ([]byte, error) { // IDs, such as IMEI number, belonging to the manufactured device. // Methods that operate on devices take a `DeviceReference` as a // parameter type because it's more flexible for the caller. To learn -// more about device identifiers, read Identifiers. +// more about device identifiers, read Identifiers +// (https://developers.google.com/zero-touch/guides/identifiers). type DeviceReference struct { // DeviceId: The ID of the device. DeviceId int64 `json:"deviceId,omitempty,string"` @@ -1009,7 +1015,7 @@ func (s *DeviceReference) MarshalJSON() ([]byte, error) { // DevicesLongRunningOperationMetadata: Tracks the status of a // long-running operation to asynchronously update a batch of reseller // metadata attached to devices. To learn more, read Long‑running -// batch operations. +// batch operations (/zero-touch/guides/how-it-works#operations). type DevicesLongRunningOperationMetadata struct { // DevicesCount: The number of metadata updates in the operation. This // might be different from the number of updates in the request if the @@ -1058,7 +1064,8 @@ func (s *DevicesLongRunningOperationMetadata) MarshalJSON() ([]byte, error) { // DevicesLongRunningOperationResponse: Tracks the status of a // long-running operation to claim, unclaim, or attach metadata to -// devices. To learn more, read Long‑running batch operations. +// devices. To learn more, read Long‑running batch operations +// (/zero-touch/guides/how-it-works#operations). type DevicesLongRunningOperationResponse struct { // PerDeviceStatus: The processing status for each device in the // operation. One `PerDeviceStatus` per device. The list order matches @@ -1093,10 +1100,12 @@ func (s *DevicesLongRunningOperationResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Dpc: An EMM's DPC (device policy controller). Zero-touch enrollment -// installs a DPC (listed in the `Configuration`) on a device to -// maintain the customer's mobile policies. All the DPCs listed by the -// API support zero-touch enrollment and are available in Google Play. +// Dpc: An EMM's DPC (device policy controller +// (http://developer.android.com/work/dpc/build-dpc.html)). Zero-touch +// enrollment installs a DPC (listed in the `Configuration`) on a device +// to maintain the customer's mobile policies. All the DPCs listed by +// the API support zero-touch enrollment and are available in Google +// Play. type Dpc struct { // DpcName: Output only. The title of the DPC app in Google Play. For // example, _Google Apps Device Policy_. Useful in an application's user @@ -1683,10 +1692,11 @@ func (s *PerDeviceStatusInBatch) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2637,7 +2647,8 @@ func (r *CustomersConfigurationsService) Patch(name string, configuration *Confi // UpdateMask sets the optional parameter "updateMask": Required. The // field mask applied to the target `Configuration` before updating the -// fields. To learn more about using field masks, read FieldMask in the +// fields. To learn more about using field masks, read FieldMask +// (/protocol-buffers/docs/reference/google.protobuf#fieldmask) in the // Protocol Buffers documentation. func (c *CustomersConfigurationsPatchCall) UpdateMask(updateMask string) *CustomersConfigurationsPatchCall { c.urlParams_.Set("updateMask", updateMask) @@ -4285,7 +4296,8 @@ type PartnersDevicesClaimAsyncCall struct { // ClaimAsync: Claims a batch of devices for a customer asynchronously. // Adds the devices to zero-touch enrollment. To learn more, read -// Long‑running batch operations. +// Long‑running batch operations +// (/zero-touch/guides/how-it-works#operations). func (r *PartnersDevicesService) ClaimAsync(partnerId int64, claimdevicesrequest *ClaimDevicesRequest) *PartnersDevicesClaimAsyncCall { c := &PartnersDevicesClaimAsyncCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.partnerId = partnerId @@ -5178,7 +5190,8 @@ type PartnersDevicesUnclaimAsyncCall struct { // UnclaimAsync: Unclaims a batch of devices for a customer // asynchronously. Removes the devices from zero-touch enrollment. To -// learn more, read Long‑running batch operations. +// learn more, read Long‑running batch operations +// (/zero-touch/guides/how-it-works#operations). func (r *PartnersDevicesService) UnclaimAsync(partnerId int64, unclaimdevicesrequest *UnclaimDevicesRequest) *PartnersDevicesUnclaimAsyncCall { c := &PartnersDevicesUnclaimAsyncCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.partnerId = partnerId @@ -5319,7 +5332,8 @@ type PartnersDevicesUpdateMetadataAsyncCall struct { // UpdateMetadataAsync: Updates the reseller metadata attached to a // batch of devices. This method updates devices asynchronously and // returns an `Operation` that can be used to track progress. Read -// Long‑running batch operations. +// Long‑running batch operations +// (/zero-touch/guides/how-it-works#operations). func (r *PartnersDevicesService) UpdateMetadataAsync(partnerId int64, updatedevicemetadatainbatchrequest *UpdateDeviceMetadataInBatchRequest) *PartnersDevicesUpdateMetadataAsyncCall { c := &PartnersDevicesUpdateMetadataAsyncCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.partnerId = partnerId diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index baad2398a7f..dbf1a60c3ea 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -4529,7 +4529,7 @@ func (c *EnterprisesCreateCall) Header() http.Header { func (c *EnterprisesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4681,7 +4681,7 @@ func (c *EnterprisesGetCall) Header() http.Header { func (c *EnterprisesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4824,7 +4824,7 @@ func (c *EnterprisesPatchCall) Header() http.Header { func (c *EnterprisesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4988,7 +4988,7 @@ func (c *EnterprisesApplicationsGetCall) Header() http.Header { func (c *EnterprisesApplicationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5149,7 +5149,7 @@ func (c *EnterprisesDevicesDeleteCall) Header() http.Header { func (c *EnterprisesDevicesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5311,7 +5311,7 @@ func (c *EnterprisesDevicesGetCall) Header() http.Header { func (c *EnterprisesDevicesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5448,7 +5448,7 @@ func (c *EnterprisesDevicesIssueCommandCall) Header() http.Header { func (c *EnterprisesDevicesIssueCommandCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5611,7 +5611,7 @@ func (c *EnterprisesDevicesListCall) Header() http.Header { func (c *EnterprisesDevicesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5786,7 +5786,7 @@ func (c *EnterprisesDevicesPatchCall) Header() http.Header { func (c *EnterprisesDevicesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5939,7 +5939,7 @@ func (c *EnterprisesDevicesOperationsCancelCall) Header() http.Header { func (c *EnterprisesDevicesOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6072,7 +6072,7 @@ func (c *EnterprisesDevicesOperationsDeleteCall) Header() http.Header { func (c *EnterprisesDevicesOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6215,7 +6215,7 @@ func (c *EnterprisesDevicesOperationsGetCall) Header() http.Header { func (c *EnterprisesDevicesOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6389,7 +6389,7 @@ func (c *EnterprisesDevicesOperationsListCall) Header() http.Header { func (c *EnterprisesDevicesOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6561,7 +6561,7 @@ func (c *EnterprisesEnrollmentTokensCreateCall) Header() http.Header { func (c *EnterprisesEnrollmentTokensCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6700,7 +6700,7 @@ func (c *EnterprisesEnrollmentTokensDeleteCall) Header() http.Header { func (c *EnterprisesEnrollmentTokensDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6831,7 +6831,7 @@ func (c *EnterprisesPoliciesDeleteCall) Header() http.Header { func (c *EnterprisesPoliciesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6972,7 +6972,7 @@ func (c *EnterprisesPoliciesGetCall) Header() http.Header { func (c *EnterprisesPoliciesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7130,7 +7130,7 @@ func (c *EnterprisesPoliciesListCall) Header() http.Header { func (c *EnterprisesPoliciesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7305,7 +7305,7 @@ func (c *EnterprisesPoliciesPatchCall) Header() http.Header { func (c *EnterprisesPoliciesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7451,7 +7451,7 @@ func (c *EnterprisesWebAppsCreateCall) Header() http.Header { func (c *EnterprisesWebAppsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7589,7 +7589,7 @@ func (c *EnterprisesWebAppsDeleteCall) Header() http.Header { func (c *EnterprisesWebAppsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7730,7 +7730,7 @@ func (c *EnterprisesWebAppsGetCall) Header() http.Header { func (c *EnterprisesWebAppsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7888,7 +7888,7 @@ func (c *EnterprisesWebAppsListCall) Header() http.Header { func (c *EnterprisesWebAppsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8063,7 +8063,7 @@ func (c *EnterprisesWebAppsPatchCall) Header() http.Header { func (c *EnterprisesWebAppsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8210,7 +8210,7 @@ func (c *EnterprisesWebTokensCreateCall) Header() http.Header { func (c *EnterprisesWebTokensCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8365,7 +8365,7 @@ func (c *SignupUrlsCreateCall) Header() http.Header { func (c *SignupUrlsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201212") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index a68e7809221..7c3f9c796a7 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -734,7 +734,9 @@ func (s *Comment) MarshalJSON() ([]byte, error) { // CountryTargeting: Country targeting specification. type CountryTargeting struct { - // Countries: Countries to target, specified as two letter CLDR codes. + // Countries: Countries to target, specified as two letter CLDR codes + // (https://unicode.org/cldr/charts/latest/supplemental/territory_contain + // ment_un_m_49.html). Countries []string `json:"countries,omitempty"` // IncludeRestOfWorld: Include "rest of world" as well as explicitly @@ -4311,7 +4313,9 @@ type EditsBundlesUploadCall struct { // Upload: Uploads a new Android App Bundle to this edit. If you are // using the Google API client libraries, please increase the timeout of // the http request before calling this endpoint (a timeout of 2 minutes -// is recommended). See Timeouts and Errors for an example in java. +// is recommended). See Timeouts and Errors +// (https://developers.google.com/api-client-library/java/google-api-java +// -client/errors) for an example in java. func (r *EditsBundlesService) Upload(packageName string, editId string) *EditsBundlesUploadCall { c := &EditsBundlesUploadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.packageName = packageName @@ -9783,7 +9787,9 @@ type InternalappsharingartifactsUploadapkCall struct { // Uploadapk: Uploads an APK to internal app sharing. If you are using // the Google API client libraries, please increase the timeout of the // http request before calling this endpoint (a timeout of 2 minutes is -// recommended). See Timeouts and Errors for an example in java. +// recommended). See Timeouts and Errors +// (https://developers.google.com/api-client-library/java/google-api-java +// -client/errors) for an example in java. func (r *InternalappsharingartifactsService) Uploadapk(packageName string) *InternalappsharingartifactsUploadapkCall { c := &InternalappsharingartifactsUploadapkCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.packageName = packageName @@ -10001,8 +10007,9 @@ type InternalappsharingartifactsUploadbundleCall struct { // Uploadbundle: Uploads an app bundle to internal app sharing. If you // are using the Google API client libraries, please increase the // timeout of the http request before calling this endpoint (a timeout -// of 2 minutes is recommended). See Timeouts and Errors for an example -// in java. +// of 2 minutes is recommended). See Timeouts and Errors +// (https://developers.google.com/api-client-library/java/google-api-java +// -client/errors) for an example in java. func (r *InternalappsharingartifactsService) Uploadbundle(packageName string) *InternalappsharingartifactsUploadbundleCall { c := &InternalappsharingartifactsUploadbundleCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.packageName = packageName diff --git a/apigateway/v1beta/apigateway-gen.go b/apigateway/v1beta/apigateway-gen.go index e102346e97e..12da87ff272 100644 --- a/apigateway/v1beta/apigateway-gen.go +++ b/apigateway/v1beta/apigateway-gen.go @@ -610,7 +610,8 @@ type ApigatewayBinding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *ApigatewayExpr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1242,7 +1243,9 @@ func (s *ApigatewayOperationMetadataDiagnostic) MarshalJSON() ([]byte, error) { // expression evaluates to `true`. A condition can add constraints based // on attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1261,7 +1264,7 @@ func (s *ApigatewayOperationMetadataDiagnostic) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type ApigatewayPolicy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1301,7 +1304,8 @@ type ApigatewayPolicy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1371,10 +1375,11 @@ func (s *ApigatewaySetIamPolicyRequest) MarshalJSON() ([]byte, error) { // ApigatewayStatus: The `Status` type defines a logical error model // that is suitable for different programming environments, including -// REST APIs and RPC APIs. It is used by gRPC. Each `Status` message -// contains three pieces of data: error code, error message, and error -// details. You can find out more about this error model and how to work -// with it in the API Design Guide. +// REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). +// Each `Status` message contains three pieces of data: error code, +// error message, and error details. You can find out more about this +// error model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type ApigatewayStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1417,7 +1422,8 @@ func (s *ApigatewayStatus) MarshalJSON() ([]byte, error) { type ApigatewayTestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2290,7 +2296,8 @@ func (r *ProjectsLocationsApisService) GetIamPolicy(resource string) *ProjectsLo // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsApisGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsApisGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -3565,7 +3572,8 @@ func (r *ProjectsLocationsApisConfigsService) GetIamPolicy(resource string) *Pro // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsApisConfigsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsApisConfigsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -4812,7 +4820,8 @@ func (r *ProjectsLocationsGatewaysService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsGatewaysGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGatewaysGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/apigee/v1/apigee-gen.go b/apigee/v1/apigee-gen.go index 74a8d7e1de3..d31666f2a63 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -5442,7 +5442,9 @@ func (s *GoogleCloudApigeeV1OptimizedStatsResponse) MarshalJSON() ([]byte, error type GoogleCloudApigeeV1Organization struct { // AnalyticsRegion: Required. Primary GCP region for analytics data - // storage. For valid values, see Create an Apigee organization. + // storage. For valid values, see Create an Apigee organization + // (https://cloud.google.com/apigee/docs/api-platform/get-started/create- + // org). AnalyticsRegion string `json:"analyticsRegion,omitempty"` // Attributes: Not used by Apigee. @@ -5450,10 +5452,11 @@ type GoogleCloudApigeeV1Organization struct { // AuthorizedNetwork: Compute Engine network used for Service Networking // to be peered with Apigee runtime instances. See Getting started with - // the Service Networking API. Valid only when [RuntimeType] is set to - // CLOUD. The value can be updated only when there are no runtime - // instances. For example: "default". **Note:** Not supported for Apigee - // hybrid. + // the Service Networking API + // (https://cloud.google.com/service-infrastructure/docs/service-networki + // ng/getting-started). Valid only when [RuntimeType] is set to CLOUD. + // The value can be updated only when there are no runtime instances. + // For example: "default". **Note:** Not supported for Apigee hybrid. AuthorizedNetwork string `json:"authorizedNetwork,omitempty"` // CaCertificate: Output only. Base64-encoded public certificate for the @@ -5511,7 +5514,8 @@ type GoogleCloudApigeeV1Organization struct { // SubscriptionType: Output only. Subscription type of the Apigee // organization. Valid values include trial (free, limited, and for // evaluation purposes only) or paid (full subscription has been - // purchased). See Apigee pricing. + // purchased). See Apigee pricing + // (https://cloud.google.com/apigee/pricing/). // // Possible values: // "SUBSCRIPTION_TYPE_UNSPECIFIED" - Subscription type not specified. @@ -5756,7 +5760,8 @@ func (s *GoogleCloudApigeeV1Property) MarshalJSON() ([]byte, error) { // ProvisionOrganization. type GoogleCloudApigeeV1ProvisionOrganizationRequest struct { // AnalyticsRegion: Primary Cloud Platform region for analytics data - // storage. For valid values, see Create an organization. Defaults to + // storage. For valid values, see Create an organization + // (https://docs.apigee.com/hybrid/latest/precog-provision). Defaults to // us-west1. AnalyticsRegion string `json:"analyticsRegion,omitempty"` @@ -7119,13 +7124,15 @@ func (s *GoogleCloudApigeeV1Subscription) MarshalJSON() ([]byte, error) { type GoogleCloudApigeeV1SyncAuthorization struct { // Etag: Entity tag (ETag) used for optimistic concurrency control as a // way to help prevent simultaneous updates from overwriting each other. - // For example, when you call getSyncAuthorization an ETag is returned - // in the response. Pass that ETag when calling the setSyncAuthorization - // to ensure that you are updating the correct version. If you don't - // pass the ETag in the call to `setSyncAuthorization`, then the - // existing authorization is overwritten indiscriminately. **Note**: We - // strongly recommend that you use the ETag in the read-modify-write - // cycle to avoid race conditions. + // For example, when you call getSyncAuthorization + // (organizations/getSyncAuthorization) an ETag is returned in the + // response. Pass that ETag when calling the setSyncAuthorization + // (organizations/setSyncAuthorization) to ensure that you are updating + // the correct version. If you don't pass the ETag in the call to + // `setSyncAuthorization`, then the existing authorization is + // overwritten indiscriminately. **Note**: We strongly recommend that + // you use the ETag in the read-modify-write cycle to avoid race + // conditions. Etag string `json:"etag,omitempty"` // Identities: Required. Array of service accounts to grant access to @@ -7136,7 +7143,9 @@ type GoogleCloudApigeeV1SyncAuthorization struct { // ount.com` You might specify multiple service accounts, for example, // if you have multiple environments and wish to assign a unique service // account to each one. The service accounts must have **Apigee - // Synchronizer Manager** role. See also Create service accounts. + // Synchronizer Manager** role. See also Create service accounts + // (https://cloud.google.com/apigee/docs/hybrid/latest/sa-about#create-th + // e-service-accounts). Identities []string `json:"identities,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -7692,7 +7701,8 @@ type GoogleIamV1Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -7768,7 +7778,9 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // expression evaluates to `true`. A condition can add constraints based // on attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -7787,7 +7799,7 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type GoogleIamV1Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -7827,7 +7839,8 @@ type GoogleIamV1Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -7900,7 +7913,8 @@ func (s *GoogleIamV1SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type GoogleIamV1TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -8146,10 +8160,11 @@ func (s *GoogleRpcPreconditionFailureViolation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -8407,7 +8422,9 @@ type OrganizationsCreateCall struct { } // Create: Creates an Apigee organization. See Create an Apigee -// organization. +// organization +// (https://cloud.google.com/apigee/docs/api-platform/get-started/create- +// org). func (r *OrganizationsService) Create(googlecloudapigeev1organization *GoogleCloudApigeeV1Organization) *OrganizationsCreateCall { c := &OrganizationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.googlecloudapigeev1organization = googlecloudapigeev1organization @@ -8680,7 +8697,9 @@ type OrganizationsGetCall struct { } // Get: Gets the profile for an Apigee organization. See Understanding -// organizations. +// organizations +// (https://cloud.google.com/apigee/docs/api-platform/fundamentals/organi +// zation-structure). func (r *OrganizationsService) Get(name string) *OrganizationsGetCall { c := &OrganizationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9006,11 +9025,13 @@ type OrganizationsGetSyncAuthorizationCall struct { // required to allow the Synchronizer to download environment data from // the control plane. An ETag is returned in the response to // `getSyncAuthorization`. Pass that ETag when calling -// setSyncAuthorization to ensure that you are updating the correct -// version. If you don't pass the ETag in the call to -// `setSyncAuthorization`, then the existing authorization is +// setSyncAuthorization (setSyncAuthorization) to ensure that you are +// updating the correct version. If you don't pass the ETag in the call +// to `setSyncAuthorization`, then the existing authorization is // overwritten indiscriminately. For more information, see Configure the -// Synchronizer. **Note**: Available to Apigee hybrid only. +// Synchronizer +// (https://cloud.google.com/apigee/docs/hybrid/latest/synchronizer-acces +// s). **Note**: Available to Apigee hybrid only. func (r *OrganizationsService) GetSyncAuthorization(name string, googlecloudapigeev1getsyncauthorizationrequest *GoogleCloudApigeeV1GetSyncAuthorizationRequest) *OrganizationsGetSyncAuthorizationCall { c := &OrganizationsGetSyncAuthorizationCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9152,7 +9173,9 @@ type OrganizationsListCall struct { } // List: Lists the Apigee organizations and associated GCP projects that -// you have permission to access. See Understanding organizations. +// you have permission to access. See Understanding organizations +// (https://cloud.google.com/apigee/docs/api-platform/fundamentals/organi +// zation-structure). func (r *OrganizationsService) List(parent string) *OrganizationsListCall { c := &OrganizationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9303,10 +9326,12 @@ type OrganizationsSetSyncAuthorizationCall struct { // must call this API to enable proper functioning of hybrid. Pass the // ETag when calling `setSyncAuthorization` to ensure that you are // updating the correct version. To get an ETag, call -// getSyncAuthorization. If you don't pass the ETag in the call to -// `setSyncAuthorization`, then the existing authorization is -// overwritten indiscriminately. For more information, see Configure the -// Synchronizer. **Note**: Available to Apigee hybrid only. +// getSyncAuthorization (getSyncAuthorization). If you don't pass the +// ETag in the call to `setSyncAuthorization`, then the existing +// authorization is overwritten indiscriminately. For more information, +// see Configure the Synchronizer +// (https://cloud.google.com/apigee/docs/hybrid/latest/synchronizer-acces +// s). **Note**: Available to Apigee hybrid only. func (r *OrganizationsService) SetSyncAuthorization(name string, googlecloudapigeev1syncauthorization *GoogleCloudApigeeV1SyncAuthorization) *OrganizationsSetSyncAuthorizationCall { c := &OrganizationsSetSyncAuthorizationCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -13166,7 +13191,7 @@ type OrganizationsApisRevisionsGetCall struct { // `-o filename.zip` to save the output to a file; otherwise, it // displays to `stdout`. Then, develop the API proxy configuration // locally and upload the updated API proxy configuration revision, as -// described in updateApiProxyRevision. +// described in updateApiProxyRevision (updateApiProxyRevision). func (r *OrganizationsApisRevisionsService) Get(name string) *OrganizationsApisRevisionsGetCall { c := &OrganizationsApisRevisionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -21624,9 +21649,10 @@ type OrganizationsEnvironmentsGetIamPolicyCall struct { } // GetIamPolicy: Gets the IAM policy on an environment. For more -// information, see Manage users, roles, and permissions using the API. -// You must have the `apigee.environments.getIamPolicy` permission to -// call this API. +// information, see Manage users, roles, and permissions using the API +// (https://cloud.google.com/apigee/docs/api-platform/system-administrati +// on/manage-users-roles). You must have the +// `apigee.environments.getIamPolicy` permission to call this API. func (r *OrganizationsEnvironmentsService) GetIamPolicy(resource string) *OrganizationsEnvironmentsGetIamPolicyCall { c := &OrganizationsEnvironmentsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -21640,7 +21666,8 @@ func (r *OrganizationsEnvironmentsService) GetIamPolicy(resource string) *Organi // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *OrganizationsEnvironmentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *OrganizationsEnvironmentsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -21791,7 +21818,9 @@ type OrganizationsEnvironmentsSetIamPolicyCall struct { // SetIamPolicy: Sets the IAM policy on an environment, if the policy // already exists it will be replaced. For more information, see Manage -// users, roles, and permissions using the API. You must have the +// users, roles, and permissions using the API +// (https://cloud.google.com/apigee/docs/api-platform/system-administrati +// on/manage-users-roles). You must have the // `apigee.environments.setIamPolicy` permission to call this API. func (r *OrganizationsEnvironmentsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsEnvironmentsSetIamPolicyCall { c := &OrganizationsEnvironmentsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -22353,7 +22382,7 @@ type OrganizationsEnvironmentsUpdateCall struct { // you must pass all existing properties to the API, even if they are // not being changed. If you omit properties from the payload, the // properties are removed. To get the current list of properties for the -// environment, use the Get Environment API. +// environment, use the Get Environment API (get). func (r *OrganizationsEnvironmentsService) Update(name string, googlecloudapigeev1environment *GoogleCloudApigeeV1Environment) *OrganizationsEnvironmentsUpdateCall { c := &OrganizationsEnvironmentsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -22666,7 +22695,7 @@ type OrganizationsEnvironmentsUpdateEnvironmentCall struct { // properties, you must pass all existing properties to the API, even if // they are not being changed. If you omit properties from the payload, // the properties are removed. To get the current list of properties for -// the environment, use the Get Environment API. +// the environment, use the Get Environment API (get). func (r *OrganizationsEnvironmentsService) UpdateEnvironment(name string, googlecloudapigeev1environment *GoogleCloudApigeeV1Environment) *OrganizationsEnvironmentsUpdateEnvironmentCall { c := &OrganizationsEnvironmentsUpdateEnvironmentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -29024,7 +29053,9 @@ type OrganizationsEnvironmentsResourcefilesCreateCall struct { // Create: Creates a resource file. Specify the `Content-Type` as // `application/octet-stream` or `multipart/form-data`. For more -// information about resource files, see Resource files. +// information about resource files, see Resource files +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi +// les). func (r *OrganizationsEnvironmentsResourcefilesService) Create(parent string, googleapihttpbody *GoogleApiHttpBody) *OrganizationsEnvironmentsResourcefilesCreateCall { c := &OrganizationsEnvironmentsResourcefilesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29034,7 +29065,7 @@ func (r *OrganizationsEnvironmentsResourcefilesService) Create(parent string, go // Name sets the optional parameter "name": Required. Name of the // resource file. Must match the regular expression: -// [a-zA-Z0-9:/\\!@#$%^&{}\\+\-=,.~'` ]{1,255} +// [a-zA-Z0-9:/\\!@#$%^&{}\\ ()+\-=,.~'` ]{1,255} func (c *OrganizationsEnvironmentsResourcefilesCreateCall) Name(name string) *OrganizationsEnvironmentsResourcefilesCreateCall { c.urlParams_.Set("name", name) return c @@ -29191,7 +29222,9 @@ type OrganizationsEnvironmentsResourcefilesDeleteCall struct { } // Delete: Deletes a resource file. For more information about resource -// files, see Resource files. +// files, see Resource files +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi +// les). func (r *OrganizationsEnvironmentsResourcefilesService) Delete(parent string, type_ string, name string) *OrganizationsEnvironmentsResourcefilesDeleteCall { c := &OrganizationsEnvironmentsResourcefilesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29343,7 +29376,9 @@ type OrganizationsEnvironmentsResourcefilesGetCall struct { } // Get: Gets the contents of a resource file. For more information about -// resource files, see Resource files. +// resource files, see Resource files +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi +// les). func (r *OrganizationsEnvironmentsResourcefilesService) Get(parent string, type_ string, name string) *OrganizationsEnvironmentsResourcefilesGetCall { c := &OrganizationsEnvironmentsResourcefilesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29506,7 +29541,9 @@ type OrganizationsEnvironmentsResourcefilesListCall struct { } // List: Lists all resource files, optionally filtering by type. For -// more information about resource files, see Resource files. +// more information about resource files, see Resource files +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi +// les). func (r *OrganizationsEnvironmentsResourcefilesService) List(parent string) *OrganizationsEnvironmentsResourcefilesListCall { c := &OrganizationsEnvironmentsResourcefilesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29667,7 +29704,9 @@ type OrganizationsEnvironmentsResourcefilesListEnvironmentResourcesCall struct { // ListEnvironmentResources: Lists all resource files, optionally // filtering by type. For more information about resource files, see -// Resource files. +// Resource files +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi +// les). func (r *OrganizationsEnvironmentsResourcefilesService) ListEnvironmentResources(parent string, type_ string) *OrganizationsEnvironmentsResourcefilesListEnvironmentResourcesCall { c := &OrganizationsEnvironmentsResourcefilesListEnvironmentResourcesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29826,7 +29865,9 @@ type OrganizationsEnvironmentsResourcefilesUpdateCall struct { // Update: Updates a resource file. Specify the `Content-Type` as // `application/octet-stream` or `multipart/form-data`. For more -// information about resource files, see Resource files. +// information about resource files, see Resource files +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi +// les). func (r *OrganizationsEnvironmentsResourcefilesService) Update(parent string, type_ string, name string, googleapihttpbody *GoogleApiHttpBody) *OrganizationsEnvironmentsResourcefilesUpdateCall { c := &OrganizationsEnvironmentsResourcefilesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/appengine/v1beta4/appengine-gen.go b/appengine/v1beta4/appengine-gen.go index 17b91327526..0fe037662c9 100644 --- a/appengine/v1beta4/appengine-gen.go +++ b/appengine/v1beta4/appengine-gen.go @@ -2768,7 +2768,7 @@ func (c *AppsCreateCall) Header() http.Header { func (c *AppsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2916,7 +2916,7 @@ func (c *AppsGetCall) Header() http.Header { func (c *AppsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3069,7 +3069,7 @@ func (c *AppsPatchCall) Header() http.Header { func (c *AppsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3225,7 +3225,7 @@ func (c *AppsLocationsGetCall) Header() http.Header { func (c *AppsLocationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3400,7 +3400,7 @@ func (c *AppsLocationsListCall) Header() http.Header { func (c *AppsLocationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3573,7 +3573,7 @@ func (c *AppsModulesDeleteCall) Header() http.Header { func (c *AppsModulesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3723,7 +3723,7 @@ func (c *AppsModulesGetCall) Header() http.Header { func (c *AppsModulesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3890,7 +3890,7 @@ func (c *AppsModulesListCall) Header() http.Header { func (c *AppsModulesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4088,7 +4088,7 @@ func (c *AppsModulesPatchCall) Header() http.Header { func (c *AppsModulesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4248,7 +4248,7 @@ func (c *AppsModulesVersionsCreateCall) Header() http.Header { func (c *AppsModulesVersionsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4397,7 +4397,7 @@ func (c *AppsModulesVersionsDeleteCall) Header() http.Header { func (c *AppsModulesVersionsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4570,7 +4570,7 @@ func (c *AppsModulesVersionsGetCall) Header() http.Header { func (c *AppsModulesVersionsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4767,7 +4767,7 @@ func (c *AppsModulesVersionsListCall) Header() http.Header { func (c *AppsModulesVersionsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4985,7 +4985,7 @@ func (c *AppsModulesVersionsPatchCall) Header() http.Header { func (c *AppsModulesVersionsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5158,7 +5158,7 @@ func (c *AppsModulesVersionsInstancesDebugCall) Header() http.Header { func (c *AppsModulesVersionsInstancesDebugCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5325,7 +5325,7 @@ func (c *AppsModulesVersionsInstancesDeleteCall) Header() http.Header { func (c *AppsModulesVersionsInstancesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5495,7 +5495,7 @@ func (c *AppsModulesVersionsInstancesGetCall) Header() http.Header { func (c *AppsModulesVersionsInstancesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5685,7 +5685,7 @@ func (c *AppsModulesVersionsInstancesListCall) Header() http.Header { func (c *AppsModulesVersionsInstancesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5882,7 +5882,7 @@ func (c *AppsOperationsGetCall) Header() http.Header { func (c *AppsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6065,7 +6065,7 @@ func (c *AppsOperationsListCall) Header() http.Header { func (c *AppsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/appengine/v1beta5/appengine-gen.go b/appengine/v1beta5/appengine-gen.go index eab2ba211e9..1beeb159ece 100644 --- a/appengine/v1beta5/appengine-gen.go +++ b/appengine/v1beta5/appengine-gen.go @@ -2727,7 +2727,7 @@ func (c *AppsCreateCall) Header() http.Header { func (c *AppsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2876,7 +2876,7 @@ func (c *AppsGetCall) Header() http.Header { func (c *AppsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3029,7 +3029,7 @@ func (c *AppsPatchCall) Header() http.Header { func (c *AppsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3185,7 +3185,7 @@ func (c *AppsLocationsGetCall) Header() http.Header { func (c *AppsLocationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3360,7 +3360,7 @@ func (c *AppsLocationsListCall) Header() http.Header { func (c *AppsLocationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3546,7 +3546,7 @@ func (c *AppsOperationsGetCall) Header() http.Header { func (c *AppsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3729,7 +3729,7 @@ func (c *AppsOperationsListCall) Header() http.Header { func (c *AppsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3902,7 +3902,7 @@ func (c *AppsServicesDeleteCall) Header() http.Header { func (c *AppsServicesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4052,7 +4052,7 @@ func (c *AppsServicesGetCall) Header() http.Header { func (c *AppsServicesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4219,7 +4219,7 @@ func (c *AppsServicesListCall) Header() http.Header { func (c *AppsServicesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4417,7 +4417,7 @@ func (c *AppsServicesPatchCall) Header() http.Header { func (c *AppsServicesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4577,7 +4577,7 @@ func (c *AppsServicesVersionsCreateCall) Header() http.Header { func (c *AppsServicesVersionsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4726,7 +4726,7 @@ func (c *AppsServicesVersionsDeleteCall) Header() http.Header { func (c *AppsServicesVersionsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4899,7 +4899,7 @@ func (c *AppsServicesVersionsGetCall) Header() http.Header { func (c *AppsServicesVersionsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5096,7 +5096,7 @@ func (c *AppsServicesVersionsListCall) Header() http.Header { func (c *AppsServicesVersionsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5314,7 +5314,7 @@ func (c *AppsServicesVersionsPatchCall) Header() http.Header { func (c *AppsServicesVersionsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5487,7 +5487,7 @@ func (c *AppsServicesVersionsInstancesDebugCall) Header() http.Header { func (c *AppsServicesVersionsInstancesDebugCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5654,7 +5654,7 @@ func (c *AppsServicesVersionsInstancesDeleteCall) Header() http.Header { func (c *AppsServicesVersionsInstancesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5824,7 +5824,7 @@ func (c *AppsServicesVersionsInstancesGetCall) Header() http.Header { func (c *AppsServicesVersionsInstancesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6014,7 +6014,7 @@ func (c *AppsServicesVersionsInstancesListCall) Header() http.Header { func (c *AppsServicesVersionsInstancesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/artifactregistry/v1/artifactregistry-gen.go b/artifactregistry/v1/artifactregistry-gen.go index 3acbc268f29..1c918556544 100644 --- a/artifactregistry/v1/artifactregistry-gen.go +++ b/artifactregistry/v1/artifactregistry-gen.go @@ -407,11 +407,11 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each // `Status` message contains three pieces of data: error code, error // message, and error details. You can find out more about this error -// model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/artifactregistry/v1beta1/artifactregistry-gen.go b/artifactregistry/v1beta1/artifactregistry-gen.go index cf7ef0ea20c..b53e887cdc1 100644 --- a/artifactregistry/v1beta1/artifactregistry-gen.go +++ b/artifactregistry/v1beta1/artifactregistry-gen.go @@ -244,7 +244,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1024,7 +1025,9 @@ func (s *Package) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1043,7 +1046,7 @@ func (s *Package) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1079,7 +1082,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1207,10 +1211,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1293,7 +1298,8 @@ func (s *Tag) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2568,7 +2574,8 @@ func (r *ProjectsLocationsRepositoriesService) GetIamPolicy(resource string) *Pr // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsRepositoriesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRepositoriesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/artifactregistry/v1beta2/artifactregistry-gen.go b/artifactregistry/v1beta2/artifactregistry-gen.go index 5b656a8708e..2a48f1343ad 100644 --- a/artifactregistry/v1beta2/artifactregistry-gen.go +++ b/artifactregistry/v1beta2/artifactregistry-gen.go @@ -244,7 +244,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1024,7 +1025,9 @@ func (s *Package) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1043,7 +1046,7 @@ func (s *Package) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1079,7 +1082,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1207,10 +1211,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1293,7 +1298,8 @@ func (s *Tag) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2568,7 +2574,8 @@ func (r *ProjectsLocationsRepositoriesService) GetIamPolicy(resource string) *Pr // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsRepositoriesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRepositoriesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/assuredworkloads/v1/assuredworkloads-gen.go b/assuredworkloads/v1/assuredworkloads-gen.go index f6749d368a3..c284292d64c 100644 --- a/assuredworkloads/v1/assuredworkloads-gen.go +++ b/assuredworkloads/v1/assuredworkloads-gen.go @@ -896,10 +896,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 8bed351139e..66b9424e50a 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -1186,7 +1186,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -2847,7 +2848,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -4884,7 +4886,9 @@ func (s *MultiClassClassificationMetrics) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -4903,7 +4907,7 @@ func (s *MultiClassClassificationMetrics) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -4943,7 +4947,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -7020,7 +7025,8 @@ func (s *TableSchema) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/bigqueryconnection/v1beta1/bigqueryconnection-gen.go b/bigqueryconnection/v1beta1/bigqueryconnection-gen.go index 4fe402c745d..84adee0d56f 100644 --- a/bigqueryconnection/v1beta1/bigqueryconnection-gen.go +++ b/bigqueryconnection/v1beta1/bigqueryconnection-gen.go @@ -283,7 +283,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -613,7 +614,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -689,7 +691,9 @@ func (s *ListConnectionsResponse) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -708,7 +712,7 @@ func (s *ListConnectionsResponse) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -748,7 +752,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -820,7 +825,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go index eca0a05a5d2..184d2f156d2 100644 --- a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go +++ b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go @@ -1021,10 +1021,11 @@ func (s *StartManualTransferRunsResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index 9f75e697206..1a99e56d76d 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -947,10 +947,11 @@ func (s *SplitCapacityCommitmentResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/bigqueryreservation/v1beta1/bigqueryreservation-gen.go b/bigqueryreservation/v1beta1/bigqueryreservation-gen.go index bcbbae84317..dff47064b45 100644 --- a/bigqueryreservation/v1beta1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1beta1/bigqueryreservation-gen.go @@ -803,10 +803,11 @@ func (s *SplitCapacityCommitmentResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2891,7 +2892,8 @@ func (r *ProjectsLocationsReservationsService) List(parent string) *ProjectsLoca // Filter sets the optional parameter "filter": Can be used to filter // out reservations based on names, capacity, etc, e.g.: // filter="reservation.slot_capacity > 200" filter="reservation.name = -// \"*dev/*\"" Advanced filtering syntax can be here. +// \"*dev/*\"" Advanced filtering syntax can be here +// (https://cloud.google.com/logging/docs/view/advanced-filters). func (c *ProjectsLocationsReservationsListCall) Filter(filter string) *ProjectsLocationsReservationsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/bigtableadmin/v2/bigtableadmin-gen.go b/bigtableadmin/v2/bigtableadmin-gen.go index c8547b84b5a..7d2683937e6 100644 --- a/bigtableadmin/v2/bigtableadmin-gen.go +++ b/bigtableadmin/v2/bigtableadmin-gen.go @@ -299,8 +299,9 @@ type AppProfile struct { // Preserve the value returned from `GetAppProfile` when calling // `UpdateAppProfile` to fail the request if there has been a // modification in the mean time. The `update_mask` of the request need - // not include `etag` for this protection to apply. See Wikipedia and - // RFC 7232 for more details. + // not include `etag` for this protection to apply. See Wikipedia + // (https://en.wikipedia.org/wiki/HTTP_ETag) and RFC 7232 + // (https://tools.ietf.org/html/rfc7232#section-2.3) for more details. Etag string `json:"etag,omitempty"` // MultiClusterRoutingUseAny: Use a multi-cluster routing policy. @@ -559,7 +560,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1386,7 +1388,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2111,7 +2114,9 @@ func (s *PartialUpdateInstanceRequest) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2130,7 +2135,7 @@ func (s *PartialUpdateInstanceRequest) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2170,7 +2175,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2427,10 +2433,11 @@ func (s *Split) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2583,7 +2590,8 @@ func (s *TableProgress) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/billingbudgets/v1/billingbudgets-gen.go b/billingbudgets/v1/billingbudgets-gen.go index 60b7e7b99db..16403bcdf61 100644 --- a/billingbudgets/v1/billingbudgets-gen.go +++ b/billingbudgets/v1/billingbudgets-gen.go @@ -272,7 +272,9 @@ type GoogleCloudBillingBudgetsV1Filter struct { // subtracted from gross cost to determine the spend for threshold // calculations. If Filter.credit_types_treatment is **not** // INCLUDE_SPECIFIED_CREDITS, this field must be empty. See a list of - // acceptable credit type values. + // acceptable credit type values + // (https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tab + // les#credits-type). CreditTypes []string `json:"creditTypes,omitempty"` // CreditTypesTreatment: Optional. If not set, default behavior is @@ -576,8 +578,9 @@ type BillingAccountsBudgetsCreateCall struct { header_ http.Header } -// Create: Creates a new budget. See Quotas and limits for more -// information on the limits of the number of budgets you can create. +// Create: Creates a new budget. See Quotas and limits +// (https://cloud.google.com/billing/quotas) for more information on the +// limits of the number of budgets you can create. func (r *BillingAccountsBudgetsService) Create(parent string, googlecloudbillingbudgetsv1budget *GoogleCloudBillingBudgetsV1Budget) *BillingAccountsBudgetsCreateCall { c := &BillingAccountsBudgetsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/billingbudgets/v1beta1/billingbudgets-gen.go b/billingbudgets/v1beta1/billingbudgets-gen.go index 03494b431ac..a1faf4be1e3 100644 --- a/billingbudgets/v1beta1/billingbudgets-gen.go +++ b/billingbudgets/v1beta1/billingbudgets-gen.go @@ -362,7 +362,9 @@ type GoogleCloudBillingBudgetsV1beta1Filter struct { // subtracted from gross cost to determine the spend for threshold // calculations. If Filter.credit_types_treatment is **not** // INCLUDE_SPECIFIED_CREDITS, this field must be empty. See a list of - // acceptable credit type values. + // acceptable credit type values + // (https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tab + // les#credits-type). CreditTypes []string `json:"creditTypes,omitempty"` // CreditTypesTreatment: Optional. If not set, default behavior is diff --git a/binaryauthorization/v1/binaryauthorization-gen.go b/binaryauthorization/v1/binaryauthorization-gen.go index d3b9a15bc8d..9bbd58bb3b5 100644 --- a/binaryauthorization/v1/binaryauthorization-gen.go +++ b/binaryauthorization/v1/binaryauthorization-gen.go @@ -425,7 +425,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -573,7 +574,9 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -592,7 +595,7 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type IamPolicy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -628,7 +631,8 @@ type IamPolicy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -972,7 +976,8 @@ func (s *Signature) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1920,7 +1925,8 @@ func (r *ProjectsAttestorsService) GetIamPolicy(resource string) *ProjectsAttest // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsAttestorsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsAttestorsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -2849,7 +2855,8 @@ func (r *ProjectsPolicyService) GetIamPolicy(resource string) *ProjectsPolicyGet // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsPolicyGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsPolicyGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/binaryauthorization/v1beta1/binaryauthorization-gen.go b/binaryauthorization/v1beta1/binaryauthorization-gen.go index 01bb277ca67..089290f5abc 100644 --- a/binaryauthorization/v1beta1/binaryauthorization-gen.go +++ b/binaryauthorization/v1beta1/binaryauthorization-gen.go @@ -427,7 +427,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -575,7 +576,9 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -594,7 +597,7 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type IamPolicy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -630,7 +633,8 @@ type IamPolicy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -974,7 +978,8 @@ func (s *Signature) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1922,7 +1927,8 @@ func (r *ProjectsAttestorsService) GetIamPolicy(resource string) *ProjectsAttest // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsAttestorsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsAttestorsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -2851,7 +2857,8 @@ func (r *ProjectsPolicyService) GetIamPolicy(resource string) *ProjectsPolicyGet // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsPolicyGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsPolicyGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 63beed4590b..212ffebe8c8 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -605,13 +605,14 @@ func (s *CardHeader) MarshalJSON() ([]byte, error) { type DeprecatedEvent struct { // Action: The form action data associated with an interactive card that // was clicked. Only populated for CARD_CLICKED events. See the - // Interactive Cards guide for more information. + // Interactive Cards guide (/hangouts/chat/how-tos/cards-onclick) for + // more information. Action *FormAction `json:"action,omitempty"` // ConfigCompleteRedirectUrl: The URL the bot should redirect the user // to after they have completed an authorization or configuration flow // outside of Google Chat. See the Authorizing access to 3p services - // guide for more information. + // guide (/hangouts/chat/how-tos/auth-3p) for more information. ConfigCompleteRedirectUrl string `json:"configCompleteRedirectUrl,omitempty"` // EventTime: The timestamp indicating when the event was dispatched. diff --git a/classroom/v1/classroom-gen.go b/classroom/v1/classroom-gen.go index 9002556786c..4c00f982ae1 100644 --- a/classroom/v1/classroom-gen.go +++ b/classroom/v1/classroom-gen.go @@ -601,7 +601,9 @@ func (s *Attachment) MarshalJSON() ([]byte, error) { // `classroom-notifications@system.gserviceaccount.com` the // `projects.topics.publish` permission. type CloudPubsubTopic struct { - // TopicName: The `name` field of a Cloud Pub/Sub Topic. + // TopicName: The `name` field of a Cloud Pub/Sub Topic + // (https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topic + // s#Topic). TopicName string `json:"topicName,omitempty"` // ForceSendFields is a list of field names (e.g. "TopicName") to @@ -4745,7 +4747,8 @@ type CoursesAnnouncementsDeleteCall struct { } // Delete: Deletes an announcement. This request must be made by the -// Developer Console project of the OAuth client ID used to create the +// Developer Console project of the OAuth client ID +// (https://support.google.com/cloud/answer/6158849) used to create the // corresponding announcement item. This method returns the following // error codes: * `PERMISSION_DENIED` if the requesting developer // project did not create the corresponding announcement, if the @@ -5636,16 +5639,17 @@ type CoursesCourseWorkCreateCall struct { // Create: Creates course work. The resulting course work (and // corresponding student submissions) are associated with the Developer -// Console project of the OAuth client ID used to make the request. -// Classroom API requests to modify course work and student submissions -// must be made with an OAuth client ID from the associated Developer -// Console project. This method returns the following error codes: * -// `PERMISSION_DENIED` if the requesting user is not permitted to access -// the requested course, create course work in the requested course, -// share a Drive attachment, or for access errors. * `INVALID_ARGUMENT` -// if the request is malformed. * `NOT_FOUND` if the requested course -// does not exist. * `FAILED_PRECONDITION` for the following request -// error: * AttachmentNotVisible +// Console project of the OAuth client ID +// (https://support.google.com/cloud/answer/6158849) used to make the +// request. Classroom API requests to modify course work and student +// submissions must be made with an OAuth client ID from the associated +// Developer Console project. This method returns the following error +// codes: * `PERMISSION_DENIED` if the requesting user is not permitted +// to access the requested course, create course work in the requested +// course, share a Drive attachment, or for access errors. * +// `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the +// requested course does not exist. * `FAILED_PRECONDITION` for the +// following request error: * AttachmentNotVisible func (r *CoursesCourseWorkService) Create(courseId string, coursework *CourseWork) *CoursesCourseWorkCreateCall { c := &CoursesCourseWorkCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -5785,7 +5789,8 @@ type CoursesCourseWorkDeleteCall struct { } // Delete: Deletes a course work. This request must be made by the -// Developer Console project of the OAuth client ID used to create the +// Developer Console project of the OAuth client ID +// (https://support.google.com/cloud/answer/6158849) used to create the // corresponding course work item. This method returns the following // error codes: * `PERMISSION_DENIED` if the requesting developer // project did not create the corresponding course work, if the @@ -6506,7 +6511,8 @@ type CoursesCourseWorkPatchCall struct { // Patch: Updates one or more fields of a course work. See // google.classroom.v1.CourseWork for details of which fields may be // updated and who may change them. This request must be made by the -// Developer Console project of the OAuth client ID used to create the +// Developer Console project of the OAuth client ID +// (https://support.google.com/cloud/answer/6158849) used to create the // corresponding course work item. This method returns the following // error codes: * `PERMISSION_DENIED` if the requesting developer // project did not create the corresponding course work, if the user is @@ -7165,13 +7171,14 @@ type CoursesCourseWorkStudentSubmissionsModifyAttachmentsCall struct { // Attachments may only be added to student submissions belonging to // course work objects with a `workType` of `ASSIGNMENT`. This request // must be made by the Developer Console project of the OAuth client ID -// used to create the corresponding course work item. This method -// returns the following error codes: * `PERMISSION_DENIED` if the -// requesting user is not permitted to access the requested course or -// course work, if the user is not permitted to modify attachments on -// the requested student submission, or for access errors. * -// `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the -// requested course, course work, or student submission does not exist. +// (https://support.google.com/cloud/answer/6158849) used to create the +// corresponding course work item. This method returns the following +// error codes: * `PERMISSION_DENIED` if the requesting user is not +// permitted to access the requested course or course work, if the user +// is not permitted to modify attachments on the requested student +// submission, or for access errors. * `INVALID_ARGUMENT` if the request +// is malformed. * `NOT_FOUND` if the requested course, course work, or +// student submission does not exist. func (r *CoursesCourseWorkStudentSubmissionsService) ModifyAttachments(courseId string, courseWorkId string, id string, modifyattachmentsrequest *ModifyAttachmentsRequest) *CoursesCourseWorkStudentSubmissionsModifyAttachmentsCall { c := &CoursesCourseWorkStudentSubmissionsModifyAttachmentsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -7334,7 +7341,8 @@ type CoursesCourseWorkStudentSubmissionsPatchCall struct { // Patch: Updates one or more fields of a student submission. See // google.classroom.v1.StudentSubmission for details of which fields may // be updated and who may change them. This request must be made by the -// Developer Console project of the OAuth client ID used to create the +// Developer Console project of the OAuth client ID +// (https://support.google.com/cloud/answer/6158849) used to create the // corresponding course work item. This method returns the following // error codes: * `PERMISSION_DENIED` if the requesting developer // project did not create the corresponding course work, if the user is @@ -7523,14 +7531,15 @@ type CoursesCourseWorkStudentSubmissionsReclaimCall struct { // Only the student that owns the requested student submission may call // this method, and only for a student submission that has been turned // in. This request must be made by the Developer Console project of the -// OAuth client ID used to create the corresponding course work item. -// This method returns the following error codes: * `PERMISSION_DENIED` -// if the requesting user is not permitted to access the requested -// course or course work, unsubmit the requested student submission, or -// for access errors. * `FAILED_PRECONDITION` if the student submission -// has not been turned in. * `INVALID_ARGUMENT` if the request is -// malformed. * `NOT_FOUND` if the requested course, course work, or -// student submission does not exist. +// OAuth client ID (https://support.google.com/cloud/answer/6158849) +// used to create the corresponding course work item. This method +// returns the following error codes: * `PERMISSION_DENIED` if the +// requesting user is not permitted to access the requested course or +// course work, unsubmit the requested student submission, or for access +// errors. * `FAILED_PRECONDITION` if the student submission has not +// been turned in. * `INVALID_ARGUMENT` if the request is malformed. * +// `NOT_FOUND` if the requested course, course work, or student +// submission does not exist. func (r *CoursesCourseWorkStudentSubmissionsService) Reclaim(courseId string, courseWorkId string, id string, reclaimstudentsubmissionrequest *ReclaimStudentSubmissionRequest) *CoursesCourseWorkStudentSubmissionsReclaimCall { c := &CoursesCourseWorkStudentSubmissionsReclaimCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -7695,11 +7704,12 @@ type CoursesCourseWorkStudentSubmissionsReturnCall struct { // returning a student submission does not set assignedGrade to the // draftGrade value. Only a teacher of the course that contains the // requested student submission may call this method. This request must -// be made by the Developer Console project of the OAuth client ID used -// to create the corresponding course work item. This method returns the -// following error codes: * `PERMISSION_DENIED` if the requesting user -// is not permitted to access the requested course or course work, -// return the requested student submission, or for access errors. * +// be made by the Developer Console project of the OAuth client ID +// (https://support.google.com/cloud/answer/6158849) used to create the +// corresponding course work item. This method returns the following +// error codes: * `PERMISSION_DENIED` if the requesting user is not +// permitted to access the requested course or course work, return the +// requested student submission, or for access errors. * // `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the // requested course, course work, or student submission does not exist. func (r *CoursesCourseWorkStudentSubmissionsService) Return(courseId string, courseWorkId string, id string, returnstudentsubmissionrequest *ReturnStudentSubmissionRequest) *CoursesCourseWorkStudentSubmissionsReturnCall { @@ -7865,13 +7875,13 @@ type CoursesCourseWorkStudentSubmissionsTurnInCall struct { // and may also update the submission state. This may only be called by // the student that owns the specified student submission. This request // must be made by the Developer Console project of the OAuth client ID -// used to create the corresponding course work item. This method -// returns the following error codes: * `PERMISSION_DENIED` if the -// requesting user is not permitted to access the requested course or -// course work, turn in the requested student submission, or for access -// errors. * `INVALID_ARGUMENT` if the request is malformed. * -// `NOT_FOUND` if the requested course, course work, or student -// submission does not exist. +// (https://support.google.com/cloud/answer/6158849) used to create the +// corresponding course work item. This method returns the following +// error codes: * `PERMISSION_DENIED` if the requesting user is not +// permitted to access the requested course or course work, turn in the +// requested student submission, or for access errors. * +// `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the +// requested course, course work, or student submission does not exist. func (r *CoursesCourseWorkStudentSubmissionsService) TurnIn(courseId string, courseWorkId string, id string, turninstudentsubmissionrequest *TurnInStudentSubmissionRequest) *CoursesCourseWorkStudentSubmissionsTurnInCall { c := &CoursesCourseWorkStudentSubmissionsTurnInCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -8175,8 +8185,9 @@ type CoursesCourseWorkMaterialsDeleteCall struct { } // Delete: Deletes a course work material. This request must be made by -// the Developer Console project of the OAuth client ID used to create -// the corresponding course work material item. This method returns the +// the Developer Console project of the OAuth client ID +// (https://support.google.com/cloud/answer/6158849) used to create the +// corresponding course work material item. This method returns the // following error codes: * `PERMISSION_DENIED` if the requesting // developer project did not create the corresponding course work // material, if the requesting user is not permitted to delete the diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index bbd4416f75f..6faa49d8ea2 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -281,19 +281,28 @@ func (s *AnalyzeIamPolicyResponse) MarshalJSON() ([]byte, error) { } // Asset: An asset in Google Cloud. An asset can be any resource in the -// Google Cloud resource hierarchy, a resource outside the Google Cloud -// resource hierarchy (such as Google Kubernetes Engine clusters and -// objects), or a policy (e.g. Cloud IAM policy). See Supported asset -// types for more information. +// Google Cloud resource hierarchy +// (https://cloud.google.com/resource-manager/docs/cloud-platform-resourc +// e-hierarchy), a resource outside the Google Cloud resource hierarchy +// (such as Google Kubernetes Engine clusters and objects), or a policy +// (e.g. Cloud IAM policy). See Supported asset types +// (https://cloud.google.com/asset-inventory/docs/supported-asset-types) +// for more information. type Asset struct { - // AccessLevel: Please also refer to the access level user guide. + // AccessLevel: Please also refer to the access level user guide + // (https://cloud.google.com/access-context-manager/docs/overview#access- + // levels). AccessLevel *GoogleIdentityAccesscontextmanagerV1AccessLevel `json:"accessLevel,omitempty"` - // AccessPolicy: Please also refer to the access policy user guide. + // AccessPolicy: Please also refer to the access policy user guide + // (https://cloud.google.com/access-context-manager/docs/overview#access- + // policies). AccessPolicy *GoogleIdentityAccesscontextmanagerV1AccessPolicy `json:"accessPolicy,omitempty"` // Ancestors: The ancestry path of an asset in Google Cloud resource - // hierarchy, represented as a list of relative resource names. An + // hierarchy + // (https://cloud.google.com/resource-manager/docs/cloud-platform-resourc + // e-hierarchy), represented as a list of relative resource names. An // ancestry path starts with the closest ancestor in the hierarchy and // ends at root. If the asset is a project, folder, or organization, the // ancestry path starts from the asset itself. Example: @@ -301,8 +310,9 @@ type Asset struct { Ancestors []string `json:"ancestors,omitempty"` // AssetType: The type of the asset. Example: - // `compute.googleapis.com/Disk` See Supported asset types for more - // information. + // `compute.googleapis.com/Disk` See Supported asset types + // (https://cloud.google.com/asset-inventory/docs/supported-asset-types) + // for more information. AssetType string `json:"assetType,omitempty"` // IamPolicy: A representation of the Cloud IAM policy set on a Google @@ -312,28 +322,34 @@ type Asset struct { // resource hierarchy. Therefore, the effectively policy is the union of // both the policy set on this resource and each policy set on all of // the resource's ancestry resource levels in the hierarchy. See this - // topic for more information. + // topic (https://cloud.google.com/iam/docs/policies#inheritance) for + // more information. IamPolicy *Policy `json:"iamPolicy,omitempty"` // Name: The full name of the asset. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1` See Resource names for more information. + // s/instance1` See Resource names + // (https://cloud.google.com/apis/design/resource_names#full_resource_nam + // e) for more information. Name string `json:"name,omitempty"` - // OrgPolicy: A representation of an organization policy. There can be - // more than one organization policy with different constraints set on a - // given resource. + // OrgPolicy: A representation of an organization policy + // (https://cloud.google.com/resource-manager/docs/organization-policy/ov + // erview#organization_policy). There can be more than one organization + // policy with different constraints set on a given resource. OrgPolicy []*GoogleCloudOrgpolicyV1Policy `json:"orgPolicy,omitempty"` // OsInventory: A representation of runtime OS Inventory information. - // See this topic for more information. + // See this topic + // (https://cloud.google.com/compute/docs/instances/os-inventory-manageme + // nt) for more information. OsInventory *Inventory `json:"osInventory,omitempty"` // Resource: A representation of the resource. Resource *Resource `json:"resource,omitempty"` // ServicePerimeter: Please also refer to the service perimeter user - // guide. + // guide (https://cloud.google.com/vpc-service-controls/docs/overview). ServicePerimeter *GoogleIdentityAccesscontextmanagerV1ServicePerimeter `json:"servicePerimeter,omitempty"` // UpdateTime: The last update timestamp of an asset. update_time is @@ -586,7 +602,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -743,11 +760,13 @@ type ExportAssetsRequest struct { // resources whose asset type starts with "compute.googleapis.com". * // ".*Instance" snapshots resources whose asset type ends with // "Instance". * ".*Instance.*" snapshots resources whose asset type - // contains "Instance". See RE2 for all supported regular expression - // syntax. If the regular expression does not match any supported asset - // type, an INVALID_ARGUMENT error will be returned. If specified, only - // matching assets will be returned, otherwise, it will snapshot all - // asset types. See Introduction to Cloud Asset Inventory for all + // contains "Instance". See RE2 + // (https://github.com/google/re2/wiki/Syntax) for all supported regular + // expression syntax. If the regular expression does not match any + // supported asset type, an INVALID_ARGUMENT error will be returned. If + // specified, only matching assets will be returned, otherwise, it will + // snapshot all asset types. See Introduction to Cloud Asset Inventory + // (https://cloud.google.com/asset-inventory/docs/overview) for all // supported asset types. AssetTypes []string `json:"assetTypes,omitempty"` @@ -869,14 +888,18 @@ type Feed struct { // asset_types. Only asset updates matching specified asset_names or // asset_types are exported to the feed. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1`. See Resource Names for more info. + // s/instance1`. See Resource Names + // (https://cloud.google.com/apis/design/resource_names#full_resource_nam + // e) for more info. AssetNames []string `json:"assetNames,omitempty"` // AssetTypes: A list of types of the assets to receive updates. You // must specify either or both of asset_names and asset_types. Only // asset updates matching specified asset_names or asset_types are // exported to the feed. Example: "compute.googleapis.com/Disk" See - // this topic for a list of all supported asset types. + // this topic + // (https://cloud.google.com/asset-inventory/docs/supported-asset-types) + // for a list of all supported asset types. AssetTypes []string `json:"assetTypes,omitempty"` // Condition: A condition which determines whether an asset update @@ -886,8 +909,9 @@ type Feed struct { // (https://github.com/google/cel-spec) on a TemporalAsset with name // `temporal_asset`. Example: a Feed with expression // ("temporal_asset.deleted == true") will only publish Asset deletions. - // Other fields of `Expr` are optional. See our user guide for detailed - // instructions. + // Other fields of `Expr` are optional. See our user guide + // (https://cloud.google.com/asset-inventory/docs/monitoring-asset-change + // s#feed_with_condition) for detailed instructions. Condition *Expr `json:"condition,omitempty"` // ContentType: Asset content type. If not specified, no content but the @@ -975,7 +999,9 @@ func (s *FeedOutputConfig) MarshalJSON() ([]byte, error) { type GcsDestination struct { // Uri: The uri of the Cloud Storage object. It's the same uri that is // used by gsutil. Example: "gs://bucket_name/object_name". See Viewing - // and Editing Object Metadata for more information. + // and Editing Object Metadata + // (https://cloud.google.com/storage/docs/viewing-editing-metadata) for + // more information. Uri string `json:"uri,omitempty"` // UriPrefix: The uri prefix of all generated Cloud Storage objects. @@ -1233,7 +1259,8 @@ type GoogleCloudAssetV1Identity struct { AnalysisState *IamPolicyAnalysisState `json:"analysisState,omitempty"` // Name: The identity name in any form of members appear in IAM policy - // binding, such as: - user:foo@google.com - group:group1@google.com - + // binding (https://cloud.google.com/iam/reference/rest/v1/Binding), + // such as: - user:foo@google.com - group:group1@google.com - // serviceAccount:s1@prj1.iam.gserviceaccount.com - // projectOwner:some_project_id - domain:google.com - allUsers - etc. Name string `json:"name,omitempty"` @@ -1306,6 +1333,7 @@ type GoogleCloudAssetV1Resource struct { AnalysisState *IamPolicyAnalysisState `json:"analysisState,omitempty"` // FullResourceName: The full resource name + // (https://cloud.google.com/asset-inventory/docs/resource-name-format) FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "AnalysisState") to @@ -1530,7 +1558,9 @@ type GoogleCloudOrgpolicyV1Policy struct { // Constraint: The name of the `Constraint` the `Policy` is configuring, // for example, `constraints/serviceuser.services`. A list of available - // constraints is available. Immutable after creation. + // constraints + // (/resource-manager/docs/organization-policy/org-policy-constraints) + // is available. Immutable after creation. Constraint string `json:"constraint,omitempty"` // Etag: An opaque tag indicating the current version of the `Policy`, @@ -2243,8 +2273,12 @@ type IamPolicyAnalysisQuery struct { // an organization number (such as "organizations/123"), a folder number // (such as "folders/123"), a project ID (such as // "projects/my-project-id"), or a project number (such as - // "projects/12345"). To know how to get organization id, visit here . - // To know how to get folder or project id, visit here . + // "projects/12345"). To know how to get organization id, visit here + // (https://cloud.google.com/resource-manager/docs/creating-managing-orga + // nization#retrieving_your_organization_id). To know how to get folder + // or project id, visit here + // (https://cloud.google.com/resource-manager/docs/creating-managing-fold + // ers#viewing_or_listing_folders_and_projects). Scope string `json:"scope,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessSelector") to @@ -2279,8 +2313,9 @@ type IamPolicyAnalysisResult struct { // selectors specified in the request. AccessControlLists []*GoogleCloudAssetV1AccessControlList `json:"accessControlLists,omitempty"` - // AttachedResourceFullName: The full resource name of the resource to - // which the iam_binding policy attaches. + // AttachedResourceFullName: The full resource name + // (https://cloud.google.com/asset-inventory/docs/resource-name-format) + // of the resource to which the iam_binding policy attaches. AttachedResourceFullName string `json:"attachedResourceFullName,omitempty"` // FullyExplored: Represents whether all analyses on the iam_binding @@ -2476,9 +2511,10 @@ type IamPolicySearchResult struct { // Resource: The full resource name of the resource associated with this // IAM policy. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1`. See Cloud Asset Inventory Resource Name Format for more - // information. To search against the `resource`: * use a field query. - // Example: `resource:organizations/123` + // s/instance1`. See Cloud Asset Inventory Resource Name Format + // (https://cloud.google.com/asset-inventory/docs/resource-name-format) + // for more information. To search against the `resource`: * use a field + // query. Example: `resource:organizations/123` Resource string `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "Explanation") to @@ -2509,9 +2545,10 @@ func (s *IamPolicySearchResult) MarshalJSON() ([]byte, error) { // to the groups they belong to, directly or indirectly. type IdentitySelector struct { // Identity: Required. The identity appear in the form of members in IAM - // policy binding. The examples of supported forms are: - // "user:mike@example.com", "group:admins@example.com", - // "domain:google.com", + // policy binding + // (https://cloud.google.com/iam/reference/rest/v1/Binding). The + // examples of supported forms are: "user:mike@example.com", + // "group:admins@example.com", "domain:google.com", // "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice // that wildcard characters (such as * and ?) are not supported. You // must give a specific identity. @@ -2990,7 +3027,9 @@ func (s *Permissions) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -3009,7 +3048,7 @@ func (s *Permissions) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -3049,7 +3088,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to @@ -3129,9 +3169,12 @@ type Resource struct { Location string `json:"location,omitempty"` // Parent: The full name of the immediate parent of this resource. See - // Resource Names for more information. For Google Cloud assets, this - // value is the parent resource defined in the Cloud IAM policy - // hierarchy. Example: + // Resource Names + // (https://cloud.google.com/apis/design/resource_names#full_resource_nam + // e) for more information. For Google Cloud assets, this value is the + // parent resource defined in the Cloud IAM policy hierarchy + // (https://cloud.google.com/iam/docs/overview#policy_hierarchy). + // Example: // `//cloudresourcemanager.googleapis.com/projects/my_project_123` For // third-party assets, this field may be set differently. Parent string `json:"parent,omitempty"` @@ -3177,7 +3220,9 @@ type ResourceSearchResult struct { // This field contains a subset of the resource metadata fields that are // returned by the List or Get APIs provided by the corresponding GCP // service (e.g., Compute Engine). see API references and supported - // searchable attributes for more information. You can search values of + // searchable attributes + // (https://cloud.google.com/asset-inventory/docs/supported-asset-types#s + // earchable_asset_types) for more information. You can search values of // these fields through free text search. However, you should not // consume the field programically as the field names and values may // change as the GCP service updates to a new incompatible API version. @@ -3205,9 +3250,11 @@ type ResourceSearchResult struct { DisplayName string `json:"displayName,omitempty"` // Labels: Labels associated with this resource. See Labelling and - // grouping GCP resources for more information. To search against the - // `labels`: * use a field query: - query on any label's key or value. - // Example: `labels:prod` - query by a given label. Example: + // grouping GCP resources + // (https://cloud.google.com/blog/products/gcp/labelling-and-grouping-you + // r-google-cloud-platform-resources) for more information. To search + // against the `labels`: * use a field query: - query on any label's key + // or value. Example: `labels:prod` - query by a given label. Example: // `labels.env:prod` - query by a given label's existence. Example: // `labels.env:*` * use a free text query. Example: `prod` Labels map[string]string `json:"labels,omitempty"` @@ -3220,16 +3267,19 @@ type ResourceSearchResult struct { // Name: The full resource name of this resource. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1`. See Cloud Asset Inventory Resource Name Format for more - // information. To search against the `name`: * use a field query. - // Example: `name:instance1` * use a free text query. Example: + // s/instance1`. See Cloud Asset Inventory Resource Name Format + // (https://cloud.google.com/asset-inventory/docs/resource-name-format) + // for more information. To search against the `name`: * use a field + // query. Example: `name:instance1` * use a free text query. Example: // `instance1` Name string `json:"name,omitempty"` // NetworkTags: Network tags associated with this resource. Like labels, // network tags are a type of annotations used to group GCP resources. - // See Labelling GCP resources for more information. To search against - // the `network_tags`: * use a field query. Example: + // See Labelling GCP resources + // (https://cloud.google.com/blog/products/gcp/labelling-and-grouping-you + // r-google-cloud-platform-resources) for more information. To search + // against the `network_tags`: * use a field query. Example: // `networkTags:internal` * use a free text query. Example: `internal` NetworkTags []string `json:"networkTags,omitempty"` @@ -3269,7 +3319,9 @@ func (s *ResourceSearchResult) MarshalJSON() ([]byte, error) { type ResourceSelector struct { // FullResourceName: Required. The [full resource name] // (https://cloud.google.com/asset-inventory/docs/resource-name-format) - // of a resource of supported resource types. + // of a resource of supported resource types + // (https://cloud.google.com/asset-inventory/docs/supported-asset-types#a + // nalyzable_asset_types). FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "FullResourceName") to @@ -3437,10 +3489,11 @@ func (s *SoftwarePackage) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4688,8 +4741,9 @@ func (c *V1AnalyzeIamPolicyCall) AnalysisQueryAccessSelectorRoles(analysisQueryA // AnalysisQueryIdentitySelectorIdentity sets the optional parameter // "analysisQuery.identitySelector.identity": Required. The identity -// appear in the form of members in IAM policy binding. The examples of -// supported forms are: "user:mike@example.com", +// appear in the form of members in IAM policy binding +// (https://cloud.google.com/iam/reference/rest/v1/Binding). The +// examples of supported forms are: "user:mike@example.com", // "group:admins@example.com", "domain:google.com", // "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice // that wildcard characters (such as * and ?) are not supported. You @@ -4793,7 +4847,9 @@ func (c *V1AnalyzeIamPolicyCall) AnalysisQueryOptionsOutputResourceEdges(analysi // parameter "analysisQuery.resourceSelector.fullResourceName": // Required. The [full resource name] // (https://cloud.google.com/asset-inventory/docs/resource-name-format) -// of a resource of supported resource types. +// of a resource of supported resource types +// (https://cloud.google.com/asset-inventory/docs/supported-asset-types#a +// nalyzable_asset_types). func (c *V1AnalyzeIamPolicyCall) AnalysisQueryResourceSelectorFullResourceName(analysisQueryResourceSelectorFullResourceName string) *V1AnalyzeIamPolicyCall { c.urlParams_.Set("analysisQuery.resourceSelector.fullResourceName", analysisQueryResourceSelectorFullResourceName) return c @@ -4801,12 +4857,14 @@ func (c *V1AnalyzeIamPolicyCall) AnalysisQueryResourceSelectorFullResourceName(a // ExecutionTimeout sets the optional parameter "executionTimeout": // Amount of time executable has to complete. See JSON representation of -// Duration. If this field is set with a value less than the RPC -// deadline, and the execution of your query hasn't finished in the -// specified execution timeout, you will get a response with partial -// result. Otherwise, your query's execution will continue until the RPC -// deadline. If it's not finished until then, you will get a -// DEADLINE_EXCEEDED error. Default is empty. +// Duration +// (https://developers.google.com/protocol-buffers/docs/proto3#json). If +// this field is set with a value less than the RPC deadline, and the +// execution of your query hasn't finished in the specified execution +// timeout, you will get a response with partial result. Otherwise, your +// query's execution will continue until the RPC deadline. If it's not +// finished until then, you will get a DEADLINE_EXCEEDED error. Default +// is empty. func (c *V1AnalyzeIamPolicyCall) ExecutionTimeout(executionTimeout string) *V1AnalyzeIamPolicyCall { c.urlParams_.Set("executionTimeout", executionTimeout) return c @@ -5571,7 +5629,9 @@ func (c *V1SearchAllIamPoliciesCall) PageToken(pageToken string) *V1SearchAllIam } // Query sets the optional parameter "query": The query statement. See -// how to construct a query for more information. If not specified or +// how to construct a query +// (https://cloud.google.com/asset-inventory/docs/searching-iam-policies# +// how_to_construct_a_query) for more information. If not specified or // empty, it will search all the IAM policies within the specified // `scope`. Examples: * `policy:amy@gmail.com` to find IAM policy // bindings that specify user "amy@gmail.com". * @@ -5782,7 +5842,9 @@ func (r *V1Service) SearchAllResources(scope string) *V1SearchAllResourcesCall { // AssetTypes sets the optional parameter "assetTypes": A list of asset // types that this request searches for. If empty, it will search all -// the searchable asset types. +// the searchable asset types +// (https://cloud.google.com/asset-inventory/docs/supported-asset-types#s +// earchable_asset_types). func (c *V1SearchAllResourcesCall) AssetTypes(assetTypes ...string) *V1SearchAllResourcesCall { c.urlParams_.SetMulti("assetTypes", append([]string{}, assetTypes...)) return c @@ -5824,16 +5886,19 @@ func (c *V1SearchAllResourcesCall) PageToken(pageToken string) *V1SearchAllResou } // Query sets the optional parameter "query": The query statement. See -// how to construct a query for more information. If not specified or +// how to construct a query +// (http://cloud.google.com/asset-inventory/docs/searching-resources#how_ +// to_construct_a_query) for more information. If not specified or // empty, it will search all the resources within the specified `scope`. // Note that the query string is compared against each Cloud IAM policy // binding, including its members, roles, and Cloud IAM conditions. The // returned Cloud IAM policies will only contain the bindings that match // your query. To learn more about the IAM policy structure, see IAM -// policy doc. Examples: * `name:Important` to find Cloud resources -// whose name contains "Important" as a word. * `displayName:Impor*` to -// find Cloud resources whose display name contains "Impor" as a prefix. -// * `description:*por*` to find Cloud resources whose description +// policy doc (https://cloud.google.com/iam/docs/policies#structure). +// Examples: * `name:Important` to find Cloud resources whose name +// contains "Important" as a word. * `displayName:Impor*` to find Cloud +// resources whose display name contains "Impor" as a prefix. * +// `description:*por*` to find Cloud resources whose description // contains "por" as a substring. * `location:us-west*` to find Cloud // resources whose location is prefixed with "us-west". * `labels:prod` // to find Cloud resources whose labels contain "prod" as a key or diff --git a/cloudasset/v1beta1/cloudasset-gen.go b/cloudasset/v1beta1/cloudasset-gen.go index 52ccd550c17..10d0351d613 100644 --- a/cloudasset/v1beta1/cloudasset-gen.go +++ b/cloudasset/v1beta1/cloudasset-gen.go @@ -205,20 +205,28 @@ type ProjectsOperationsService struct { } // Asset: An asset in Google Cloud. An asset can be any resource in the -// Google Cloud resource hierarchy, a resource outside the Google Cloud -// resource hierarchy (such as Google Kubernetes Engine clusters and -// objects), or a policy (e.g. Cloud IAM policy). See Supported asset -// types for more information. +// Google Cloud resource hierarchy +// (https://cloud.google.com/resource-manager/docs/cloud-platform-resourc +// e-hierarchy), a resource outside the Google Cloud resource hierarchy +// (such as Google Kubernetes Engine clusters and objects), or a policy +// (e.g. Cloud IAM policy). See Supported asset types +// (https://cloud.google.com/asset-inventory/docs/supported-asset-types) +// for more information. type Asset struct { - // AccessLevel: Please also refer to the access level user guide. + // AccessLevel: Please also refer to the access level user guide + // (https://cloud.google.com/access-context-manager/docs/overview#access- + // levels). AccessLevel *GoogleIdentityAccesscontextmanagerV1AccessLevel `json:"accessLevel,omitempty"` - // AccessPolicy: Please also refer to the access policy user guide. + // AccessPolicy: Please also refer to the access policy user guide + // (https://cloud.google.com/access-context-manager/docs/overview#access- + // policies). AccessPolicy *GoogleIdentityAccesscontextmanagerV1AccessPolicy `json:"accessPolicy,omitempty"` // AssetType: The type of the asset. Example: - // `compute.googleapis.com/Disk` See Supported asset types for more - // information. + // `compute.googleapis.com/Disk` See Supported asset types + // (https://cloud.google.com/asset-inventory/docs/supported-asset-types) + // for more information. AssetType string `json:"assetType,omitempty"` // IamPolicy: A representation of the Cloud IAM policy set on a Google @@ -228,24 +236,28 @@ type Asset struct { // resource hierarchy. Therefore, the effectively policy is the union of // both the policy set on this resource and each policy set on all of // the resource's ancestry resource levels in the hierarchy. See this - // topic for more information. + // topic (https://cloud.google.com/iam/docs/policies#inheritance) for + // more information. IamPolicy *Policy `json:"iamPolicy,omitempty"` // Name: The full name of the asset. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1` See Resource names for more information. + // s/instance1` See Resource names + // (https://cloud.google.com/apis/design/resource_names#full_resource_nam + // e) for more information. Name string `json:"name,omitempty"` - // OrgPolicy: A representation of an organization policy. There can be - // more than one organization policy with different constraints set on a - // given resource. + // OrgPolicy: A representation of an organization policy + // (https://cloud.google.com/resource-manager/docs/organization-policy/ov + // erview#organization_policy). There can be more than one organization + // policy with different constraints set on a given resource. OrgPolicy []*GoogleCloudOrgpolicyV1Policy `json:"orgPolicy,omitempty"` // Resource: A representation of the resource. Resource *Resource `json:"resource,omitempty"` // ServicePerimeter: Please also refer to the service perimeter user - // guide. + // guide (https://cloud.google.com/vpc-service-controls/docs/overview). ServicePerimeter *GoogleIdentityAccesscontextmanagerV1ServicePerimeter `json:"servicePerimeter,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to @@ -408,7 +420,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -477,7 +490,8 @@ type ExportAssetsRequest struct { // AssetTypes: A list of asset types of which to take a snapshot for. // For example: "google.compute.Disk". If specified, only matching // assets will be returned. See Introduction to Cloud Asset Inventory - // for all supported asset types. + // (https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/ + // overview) for all supported asset types. AssetTypes []string `json:"assetTypes,omitempty"` // ContentType: Asset content type. If not specified, no content but the @@ -588,7 +602,9 @@ func (s *Expr) MarshalJSON() ([]byte, error) { type GcsDestination struct { // Uri: The uri of the Cloud Storage object. It's the same uri that is // used by gsutil. For example: "gs://bucket_name/object_name". See - // Viewing and Editing Object Metadata for more information. + // Viewing and Editing Object Metadata + // (https://cloud.google.com/storage/docs/viewing-editing-metadata) for + // more information. Uri string `json:"uri,omitempty"` // UriPrefix: The uri prefix of all generated Cloud Storage objects. For @@ -823,7 +839,9 @@ type GoogleCloudOrgpolicyV1Policy struct { // Constraint: The name of the `Constraint` the `Policy` is configuring, // for example, `constraints/serviceuser.services`. A list of available - // constraints is available. Immutable after creation. + // constraints + // (/resource-manager/docs/organization-policy/org-policy-constraints) + // is available. Immutable after creation. Constraint string `json:"constraint,omitempty"` // Etag: An opaque tag indicating the current version of the `Policy`, @@ -1543,7 +1561,9 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1562,7 +1582,7 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1602,7 +1622,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to @@ -1648,9 +1669,12 @@ type Resource struct { DiscoveryName string `json:"discoveryName,omitempty"` // Parent: The full name of the immediate parent of this resource. See - // Resource Names for more information. For Google Cloud assets, this - // value is the parent resource defined in the Cloud IAM policy - // hierarchy. Example: + // Resource Names + // (https://cloud.google.com/apis/design/resource_names#full_resource_nam + // e) for more information. For Google Cloud assets, this value is the + // parent resource defined in the Cloud IAM policy hierarchy + // (https://cloud.google.com/iam/docs/overview#policy_hierarchy). + // Example: // `//cloudresourcemanager.googleapis.com/projects/my_project_123` For // third-party assets, this field may be set differently. Parent string `json:"parent,omitempty"` @@ -1689,10 +1713,11 @@ func (s *Resource) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2118,9 +2143,11 @@ func (r *OrganizationsService) BatchGetAssetsHistory(parent string) *Organizatio // AssetNames sets the optional parameter "assetNames": A list of the // full names of the assets. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance -// s/instance1`. See Resource Names for more info. The request becomes a -// no-op if the asset name list is empty, and the max size of the asset -// name list is 100 in one request. +// s/instance1`. See Resource Names +// (https://cloud.google.com/apis/design/resource_names#full_resource_nam +// e) for more info. The request becomes a no-op if the asset name list +// is empty, and the max size of the asset name list is 100 in one +// request. func (c *OrganizationsBatchGetAssetsHistoryCall) AssetNames(assetNames ...string) *OrganizationsBatchGetAssetsHistoryCall { c.urlParams_.SetMulti("assetNames", append([]string{}, assetNames...)) return c @@ -2632,9 +2659,11 @@ func (r *ProjectsService) BatchGetAssetsHistory(parent string) *ProjectsBatchGet // AssetNames sets the optional parameter "assetNames": A list of the // full names of the assets. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance -// s/instance1`. See Resource Names for more info. The request becomes a -// no-op if the asset name list is empty, and the max size of the asset -// name list is 100 in one request. +// s/instance1`. See Resource Names +// (https://cloud.google.com/apis/design/resource_names#full_resource_nam +// e) for more info. The request becomes a no-op if the asset name list +// is empty, and the max size of the asset name list is 100 in one +// request. func (c *ProjectsBatchGetAssetsHistoryCall) AssetNames(assetNames ...string) *ProjectsBatchGetAssetsHistoryCall { c.urlParams_.SetMulti("assetNames", append([]string{}, assetNames...)) return c diff --git a/cloudasset/v1p1beta1/cloudasset-gen.go b/cloudasset/v1p1beta1/cloudasset-gen.go index 78785eb091b..710a8009b6d 100644 --- a/cloudasset/v1p1beta1/cloudasset-gen.go +++ b/cloudasset/v1p1beta1/cloudasset-gen.go @@ -261,7 +261,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -441,8 +442,9 @@ type IamPolicySearchResult struct { // empty. Project string `json:"project,omitempty"` - // Resource: The full resource name of the resource associated with this - // IAM policy. + // Resource: The full resource name + // (https://cloud.google.com/apis/design/resource_names#full_resource_nam + // e) of the resource associated with this IAM policy. Resource string `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "Explanation") to @@ -509,7 +511,9 @@ func (s *Permissions) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -528,7 +532,7 @@ func (s *Permissions) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -568,7 +572,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to @@ -690,7 +695,9 @@ type StandardResourceMetadata struct { DisplayName string `json:"displayName,omitempty"` // Labels: Labels associated with this resource. See Labelling and - // grouping GCP resources for more information. + // grouping GCP resources + // (https://cloud.google.com/blog/products/gcp/labelling-and-grouping-you + // r-google-cloud-platform-resources) for more information. Labels map[string]string `json:"labels,omitempty"` // Location: Location can be "global", regional like "us-east1", or @@ -699,12 +706,16 @@ type StandardResourceMetadata struct { // Name: The full resource name. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1`. See Resource Names for more information. + // s/instance1`. See Resource Names + // (https://cloud.google.com/apis/design/resource_names#full_resource_nam + // e) for more information. Name string `json:"name,omitempty"` // NetworkTags: Network tags associated with this resource. Like labels, // network tags are a type of annotations used to group GCP resources. - // See Labelling GCP resources for more information. + // See Labelling GCP resources + // (lhttps://cloud.google.com/blog/products/gcp/labelling-and-grouping-yo + // ur-google-cloud-platform-resources) for more information. NetworkTags []string `json:"networkTags,omitempty"` // Project: The project that this resource belongs to, in the form of diff --git a/cloudasset/v1p4beta1/cloudasset-gen.go b/cloudasset/v1p4beta1/cloudasset-gen.go index b1b20a32cee..47f9b045835 100644 --- a/cloudasset/v1p4beta1/cloudasset-gen.go +++ b/cloudasset/v1p4beta1/cloudasset-gen.go @@ -236,7 +236,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -679,7 +680,8 @@ type GoogleCloudAssetV1p4beta1Identity struct { AnalysisState *GoogleCloudAssetV1p4beta1AnalysisState `json:"analysisState,omitempty"` // Name: The identity name in any form of members appear in IAM policy - // binding, such as: - user:foo@google.com - group:group1@google.com - + // binding (https://cloud.google.com/iam/reference/rest/v1/Binding), + // such as: - user:foo@google.com - group:group1@google.com - // serviceAccount:s1@prj1.iam.gserviceaccount.com - // projectOwner:some_project_id - domain:google.com - allUsers - etc. Name string `json:"name,omitempty"` @@ -752,6 +754,7 @@ type GoogleCloudAssetV1p4beta1Resource struct { AnalysisState *GoogleCloudAssetV1p4beta1AnalysisState `json:"analysisState,omitempty"` // FullResourceName: The full resource name + // (https://cloud.google.com/asset-inventory/docs/resource-name-format) FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "AnalysisState") to @@ -858,8 +861,12 @@ type IamPolicyAnalysisQuery struct { // an organization number (such as "organizations/123"), a folder number // (such as "folders/123"), a project ID (such as // "projects/my-project-id"), or a project number (such as - // "projects/12345"). To know how to get organization id, visit here . - // To know how to get folder or project id, visit here . + // "projects/12345"). To know how to get organization id, visit here + // (https://cloud.google.com/resource-manager/docs/creating-managing-orga + // nization#retrieving_your_organization_id). To know how to get folder + // or project id, visit here + // (https://cloud.google.com/resource-manager/docs/creating-managing-fold + // ers#viewing_or_listing_folders_and_projects). Parent string `json:"parent,omitempty"` // ResourceSelector: Optional. Specifies a resource for analysis. @@ -897,8 +904,9 @@ type IamPolicyAnalysisResult struct { // selectors specified in the request. AccessControlLists []*GoogleCloudAssetV1p4beta1AccessControlList `json:"accessControlLists,omitempty"` - // AttachedResourceFullName: The full resource name of the resource to - // which the iam_binding policy attaches. + // AttachedResourceFullName: The full resource name + // (https://cloud.google.com/asset-inventory/docs/resource-name-format) + // of the resource to which the iam_binding policy attaches. AttachedResourceFullName string `json:"attachedResourceFullName,omitempty"` // FullyExplored: Represents whether all analyses on the iam_binding @@ -942,9 +950,10 @@ func (s *IamPolicyAnalysisResult) MarshalJSON() ([]byte, error) { // to the groups they belong to, directly or indirectly. type IdentitySelector struct { // Identity: Required. The identity appear in the form of members in IAM - // policy binding. The examples of supported forms are: - // "user:mike@example.com", "group:admins@example.com", - // "domain:google.com", + // policy binding + // (https://cloud.google.com/iam/reference/rest/v1/Binding). The + // examples of supported forms are: "user:mike@example.com", + // "group:admins@example.com", "domain:google.com", // "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice // that wildcard characters (such as * and ?) are not supported. You // must give a specific identity. @@ -1122,8 +1131,11 @@ func (s *Options) MarshalJSON() ([]byte, error) { // policies, which may be set directly on the resource, or on ancestors // such as organizations, folders or projects. type ResourceSelector struct { - // FullResourceName: Required. The full resource name of a resource of - // supported resource types. + // FullResourceName: Required. The full resource name + // (https://cloud.google.com/asset-inventory/docs/resource-name-format) + // of a resource of supported resource types + // (https://cloud.google.com/asset-inventory/docs/supported-asset-types#a + // nalyzable_asset_types). FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "FullResourceName") to @@ -1152,10 +1164,11 @@ func (s *ResourceSelector) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1229,8 +1242,9 @@ func (c *V1p4beta1AnalyzeIamPolicyCall) AnalysisQueryAccessSelectorRoles(analysi // AnalysisQueryIdentitySelectorIdentity sets the optional parameter // "analysisQuery.identitySelector.identity": Required. The identity -// appear in the form of members in IAM policy binding. The examples of -// supported forms are: "user:mike@example.com", +// appear in the form of members in IAM policy binding +// (https://cloud.google.com/iam/reference/rest/v1/Binding). The +// examples of supported forms are: "user:mike@example.com", // "group:admins@example.com", "domain:google.com", // "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice // that wildcard characters (such as * and ?) are not supported. You @@ -1242,8 +1256,11 @@ func (c *V1p4beta1AnalyzeIamPolicyCall) AnalysisQueryIdentitySelectorIdentity(an // AnalysisQueryResourceSelectorFullResourceName sets the optional // parameter "analysisQuery.resourceSelector.fullResourceName": -// Required. The full resource name of a resource of supported resource -// types. +// Required. The full resource name +// (https://cloud.google.com/asset-inventory/docs/resource-name-format) +// of a resource of supported resource types +// (https://cloud.google.com/asset-inventory/docs/supported-asset-types#a +// nalyzable_asset_types). func (c *V1p4beta1AnalyzeIamPolicyCall) AnalysisQueryResourceSelectorFullResourceName(analysisQueryResourceSelectorFullResourceName string) *V1p4beta1AnalyzeIamPolicyCall { c.urlParams_.Set("analysisQuery.resourceSelector.fullResourceName", analysisQueryResourceSelectorFullResourceName) return c @@ -1278,12 +1295,14 @@ func (c *V1p4beta1AnalyzeIamPolicyCall) OptionsAnalyzeServiceAccountImpersonatio // OptionsExecutionTimeout sets the optional parameter // "options.executionTimeout": Amount of time executable has to -// complete. See JSON representation of Duration. If this field is set -// with a value less than the RPC deadline, and the execution of your -// query hasn't finished in the specified execution timeout, you will -// get a response with partial result. Otherwise, your query's execution -// will continue until the RPC deadline. If it's not finished until -// then, you will get a DEADLINE_EXCEEDED error. Default is empty. +// complete. See JSON representation of Duration +// (https://developers.google.com/protocol-buffers/docs/proto3#json). If +// this field is set with a value less than the RPC deadline, and the +// execution of your query hasn't finished in the specified execution +// timeout, you will get a response with partial result. Otherwise, your +// query's execution will continue until the RPC deadline. If it's not +// finished until then, you will get a DEADLINE_EXCEEDED error. Default +// is empty. func (c *V1p4beta1AnalyzeIamPolicyCall) OptionsExecutionTimeout(optionsExecutionTimeout string) *V1p4beta1AnalyzeIamPolicyCall { c.urlParams_.Set("options.executionTimeout", optionsExecutionTimeout) return c diff --git a/cloudasset/v1p5beta1/cloudasset-gen.go b/cloudasset/v1p5beta1/cloudasset-gen.go index 93b33bb7dea..58ce796610a 100644 --- a/cloudasset/v1p5beta1/cloudasset-gen.go +++ b/cloudasset/v1p5beta1/cloudasset-gen.go @@ -145,19 +145,28 @@ type AssetsService struct { } // Asset: An asset in Google Cloud. An asset can be any resource in the -// Google Cloud resource hierarchy, a resource outside the Google Cloud -// resource hierarchy (such as Google Kubernetes Engine clusters and -// objects), or a policy (e.g. Cloud IAM policy). See Supported asset -// types for more information. +// Google Cloud resource hierarchy +// (https://cloud.google.com/resource-manager/docs/cloud-platform-resourc +// e-hierarchy), a resource outside the Google Cloud resource hierarchy +// (such as Google Kubernetes Engine clusters and objects), or a policy +// (e.g. Cloud IAM policy). See Supported asset types +// (https://cloud.google.com/asset-inventory/docs/supported-asset-types) +// for more information. type Asset struct { - // AccessLevel: Please also refer to the access level user guide. + // AccessLevel: Please also refer to the access level user guide + // (https://cloud.google.com/access-context-manager/docs/overview#access- + // levels). AccessLevel *GoogleIdentityAccesscontextmanagerV1AccessLevel `json:"accessLevel,omitempty"` - // AccessPolicy: Please also refer to the access policy user guide. + // AccessPolicy: Please also refer to the access policy user guide + // (https://cloud.google.com/access-context-manager/docs/overview#access- + // policies). AccessPolicy *GoogleIdentityAccesscontextmanagerV1AccessPolicy `json:"accessPolicy,omitempty"` // Ancestors: The ancestry path of an asset in Google Cloud resource - // hierarchy, represented as a list of relative resource names. An + // hierarchy + // (https://cloud.google.com/resource-manager/docs/cloud-platform-resourc + // e-hierarchy), represented as a list of relative resource names. An // ancestry path starts with the closest ancestor in the hierarchy and // ends at root. If the asset is a project, folder, or organization, the // ancestry path starts from the asset itself. Example: @@ -165,8 +174,9 @@ type Asset struct { Ancestors []string `json:"ancestors,omitempty"` // AssetType: The type of the asset. Example: - // `compute.googleapis.com/Disk` See Supported asset types for more - // information. + // `compute.googleapis.com/Disk` See Supported asset types + // (https://cloud.google.com/asset-inventory/docs/supported-asset-types) + // for more information. AssetType string `json:"assetType,omitempty"` // IamPolicy: A representation of the Cloud IAM policy set on a Google @@ -176,24 +186,28 @@ type Asset struct { // resource hierarchy. Therefore, the effectively policy is the union of // both the policy set on this resource and each policy set on all of // the resource's ancestry resource levels in the hierarchy. See this - // topic for more information. + // topic (https://cloud.google.com/iam/docs/policies#inheritance) for + // more information. IamPolicy *Policy `json:"iamPolicy,omitempty"` // Name: The full name of the asset. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance - // s/instance1` See Resource names for more information. + // s/instance1` See Resource names + // (https://cloud.google.com/apis/design/resource_names#full_resource_nam + // e) for more information. Name string `json:"name,omitempty"` - // OrgPolicy: A representation of an organization policy. There can be - // more than one organization policy with different constraints set on a - // given resource. + // OrgPolicy: A representation of an organization policy + // (https://cloud.google.com/resource-manager/docs/organization-policy/ov + // erview#organization_policy). There can be more than one organization + // policy with different constraints set on a given resource. OrgPolicy []*GoogleCloudOrgpolicyV1Policy `json:"orgPolicy,omitempty"` // Resource: A representation of the resource. Resource *Resource `json:"resource,omitempty"` // ServicePerimeter: Please also refer to the service perimeter user - // guide. + // guide (https://cloud.google.com/vpc-service-controls/docs/overview). ServicePerimeter *GoogleIdentityAccesscontextmanagerV1ServicePerimeter `json:"servicePerimeter,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to @@ -324,7 +338,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -647,7 +662,9 @@ type GoogleCloudOrgpolicyV1Policy struct { // Constraint: The name of the `Constraint` the `Policy` is configuring, // for example, `constraints/serviceuser.services`. A list of available - // constraints is available. Immutable after creation. + // constraints + // (/resource-manager/docs/organization-policy/org-policy-constraints) + // is available. Immutable after creation. Constraint string `json:"constraint,omitempty"` // Etag: An opaque tag indicating the current version of the `Policy`, @@ -1315,7 +1332,9 @@ func (s *ListAssetsResponse) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1334,7 +1353,7 @@ func (s *ListAssetsResponse) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1374,7 +1393,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to @@ -1420,9 +1440,12 @@ type Resource struct { DiscoveryName string `json:"discoveryName,omitempty"` // Parent: The full name of the immediate parent of this resource. See - // Resource Names for more information. For Google Cloud assets, this - // value is the parent resource defined in the Cloud IAM policy - // hierarchy. Example: + // Resource Names + // (https://cloud.google.com/apis/design/resource_names#full_resource_nam + // e) for more information. For Google Cloud assets, this value is the + // parent resource defined in the Cloud IAM policy hierarchy + // (https://cloud.google.com/iam/docs/overview#policy_hierarchy). + // Example: // `//cloudresourcemanager.googleapis.com/projects/my_project_123` For // third-party assets, this field may be set differently. Parent string `json:"parent,omitempty"` @@ -1485,12 +1508,14 @@ func (r *AssetsService) List(parent string) *AssetsListCall { // asset type starts with "compute.googleapis.com". * ".*Instance" // snapshots resources whose asset type ends with "Instance". * // ".*Instance.*" snapshots resources whose asset type contains -// "Instance". See RE2 for all supported regular expression syntax. If -// the regular expression does not match any supported asset type, an -// INVALID_ARGUMENT error will be returned. If specified, only matching -// assets will be returned, otherwise, it will snapshot all asset types. -// See Introduction to Cloud Asset Inventory for all supported asset -// types. +// "Instance". See RE2 (https://github.com/google/re2/wiki/Syntax) for +// all supported regular expression syntax. If the regular expression +// does not match any supported asset type, an INVALID_ARGUMENT error +// will be returned. If specified, only matching assets will be +// returned, otherwise, it will snapshot all asset types. See +// Introduction to Cloud Asset Inventory +// (https://cloud.google.com/asset-inventory/docs/overview) for all +// supported asset types. func (c *AssetsListCall) AssetTypes(assetTypes ...string) *AssetsListCall { c.urlParams_.SetMulti("assetTypes", append([]string{}, assetTypes...)) return c diff --git a/cloudbilling/v1/cloudbilling-gen.go b/cloudbilling/v1/cloudbilling-gen.go index 5f9d74c9209..862032e3cf3 100644 --- a/cloudbilling/v1/cloudbilling-gen.go +++ b/cloudbilling/v1/cloudbilling-gen.go @@ -345,16 +345,18 @@ func (s *AuditLogConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// BillingAccount: A billing account in the Google Cloud Console. You -// can assign a billing account to one or more projects. +// BillingAccount: A billing account in the Google Cloud Console +// (https://console.cloud.google.com/). You can assign a billing account +// to one or more projects. type BillingAccount struct { // DisplayName: The display name given to the billing account, such as // `My Billing Account`. This name is displayed in the Google Cloud // Console. DisplayName string `json:"displayName,omitempty"` - // MasterBillingAccount: If this account is a subaccount, then this will - // be the resource name of the master billing account that it is being + // MasterBillingAccount: If this account is a subaccount + // (https://cloud.google.com/billing/docs/concepts), then this will be + // the resource name of the master billing account that it is being // resold through. Otherwise this will be empty. MasterBillingAccount string `json:"masterBillingAccount,omitempty"` @@ -405,7 +407,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -820,7 +823,9 @@ func (s *Money) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -839,7 +844,7 @@ func (s *Money) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -879,7 +884,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1257,7 +1263,8 @@ func (s *Sku) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1378,12 +1385,14 @@ type BillingAccountsCreateCall struct { } // Create: Creates a billing account. This method can only be used to -// create billing subaccounts by Google Cloud resellers. When creating a -// subaccount, the current authenticated user must have the -// `billing.accounts.update` IAM permission on the master account, which -// is typically given to billing account administrators. This method -// will return an error if the master account has not been provisioned -// as a reseller account. +// create billing subaccounts +// (https://cloud.google.com/billing/docs/concepts) by Google Cloud +// resellers. When creating a subaccount, the current authenticated user +// must have the `billing.accounts.update` IAM permission on the master +// account, which is typically given to billing account administrators +// (https://cloud.google.com/billing/docs/how-to/billing-access). This +// method will return an error if the master account has not been +// provisioned as a reseller account. func (r *BillingAccountsService) Create(billingaccount *BillingAccount) *BillingAccountsCreateCall { c := &BillingAccountsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.billingaccount = billingaccount @@ -1511,7 +1520,8 @@ type BillingAccountsGetCall struct { } // Get: Gets information about a billing account. The current -// authenticated user must be a viewer of the billing account. +// authenticated user must be a viewer of the billing account +// (https://cloud.google.com/billing/docs/how-to/billing-access). func (r *BillingAccountsService) Get(name string) *BillingAccountsGetCall { c := &BillingAccountsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -1659,7 +1669,8 @@ type BillingAccountsGetIamPolicyCall struct { // GetIamPolicy: Gets the access control policy for a billing account. // The caller must have the `billing.accounts.getIamPolicy` permission -// on the account, which is often given to billing account viewers. +// on the account, which is often given to billing account viewers +// (https://cloud.google.com/billing/docs/how-to/billing-access). func (r *BillingAccountsService) GetIamPolicy(resource string) *BillingAccountsGetIamPolicyCall { c := &BillingAccountsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -1673,7 +1684,8 @@ func (r *BillingAccountsService) GetIamPolicy(resource string) *BillingAccountsG // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *BillingAccountsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *BillingAccountsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -1824,7 +1836,8 @@ type BillingAccountsListCall struct { } // List: Lists the billing accounts that the current authenticated user -// has permission to view. +// has permission to view +// (https://cloud.google.com/billing/docs/how-to/billing-access). func (r *BillingAccountsService) List() *BillingAccountsListCall { c := &BillingAccountsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -1832,8 +1845,9 @@ func (r *BillingAccountsService) List() *BillingAccountsListCall { // Filter sets the optional parameter "filter": Options for how to // filter the returned billing accounts. Currently this only supports -// filtering for subaccounts under a single provided reseller billing -// account. (e.g. +// filtering for subaccounts +// (https://cloud.google.com/billing/docs/concepts) under a single +// provided reseller billing account. (e.g. // "master_billing_account=billingAccounts/012345-678901-ABCDEF"). // Boolean algebra and other fields are not currently supported. func (c *BillingAccountsListCall) Filter(filter string) *BillingAccountsListCall { @@ -2025,7 +2039,9 @@ type BillingAccountsPatchCall struct { // Patch: Updates a billing account's fields. Currently the only field // that can be edited is `display_name`. The current authenticated user // must have the `billing.accounts.update` IAM permission, which is -// typically given to the administrator of the billing account. +// typically given to the administrator +// (https://cloud.google.com/billing/docs/how-to/billing-access) of the +// billing account. func (r *BillingAccountsService) Patch(name string, billingaccount *BillingAccount) *BillingAccountsPatchCall { c := &BillingAccountsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2182,7 +2198,8 @@ type BillingAccountsSetIamPolicyCall struct { // SetIamPolicy: Sets the access control policy for a billing account. // Replaces any existing policy. The caller must have the // `billing.accounts.setIamPolicy` permission on the account, which is -// often given to billing account administrators. +// often given to billing account administrators +// (https://cloud.google.com/billing/docs/how-to/billing-access). func (r *BillingAccountsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *BillingAccountsSetIamPolicyCall { c := &BillingAccountsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -2471,7 +2488,8 @@ type BillingAccountsProjectsListCall struct { // List: Lists the projects associated with a billing account. The // current authenticated user must have the // `billing.resourceAssociations.list` IAM permission, which is often -// given to billing account viewers. +// given to billing account viewers +// (https://cloud.google.com/billing/docs/how-to/billing-access). func (r *BillingAccountsProjectsService) List(name string) *BillingAccountsProjectsListCall { c := &BillingAccountsProjectsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2667,7 +2685,8 @@ type ProjectsGetBillingInfoCall struct { } // GetBillingInfo: Gets the billing information for a project. The -// current authenticated user must have permission to view the project. +// current authenticated user must have permission to view the project +// (https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo ). func (r *ProjectsService) GetBillingInfo(name string) *ProjectsGetBillingInfoCall { c := &ProjectsGetBillingInfoCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2825,19 +2844,22 @@ type ProjectsUpdateBillingInfoCall struct { // be billed to the new billing account, even if the charge occurred // before the new billing account was assigned to the project. The // current authenticated user must have ownership privileges for both -// the project and the billing account. You can disable billing on the -// project by setting the `billing_account_name` field to empty. This -// action disassociates the current billing account from the project. -// Any billable activity of your in-use services will stop, and your -// application could stop functioning as expected. Any unbilled charges -// to date will be billed to the previously associated account. The -// current authenticated user must be either an owner of the project or -// an owner of the billing account for the project. Note that -// associating a project with a *closed* billing account will have much -// the same effect as disabling billing on the project: any paid -// resources used by the project will be shut down. Thus, unless you -// wish to disable billing, you should always call this method with the -// name of an *open* billing account. +// the project +// (https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo ) +// and the billing account +// (https://cloud.google.com/billing/docs/how-to/billing-access). You +// can disable billing on the project by setting the +// `billing_account_name` field to empty. This action disassociates the +// current billing account from the project. Any billable activity of +// your in-use services will stop, and your application could stop +// functioning as expected. Any unbilled charges to date will be billed +// to the previously associated account. The current authenticated user +// must be either an owner of the project or an owner of the billing +// account for the project. Note that associating a project with a +// *closed* billing account will have much the same effect as disabling +// billing on the project: any paid resources used by the project will +// be shut down. Thus, unless you wish to disable billing, you should +// always call this method with the name of an *open* billing account. func (r *ProjectsService) UpdateBillingInfo(name string, projectbillinginfo *ProjectBillingInfo) *ProjectsUpdateBillingInfoCall { c := &ProjectsUpdateBillingInfoCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/cloudbuild/v1/cloudbuild-gen.go b/cloudbuild/v1/cloudbuild-gen.go index 400cdfd9e59..dd0fc30bfa9 100644 --- a/cloudbuild/v1/cloudbuild-gen.go +++ b/cloudbuild/v1/cloudbuild-gen.go @@ -220,7 +220,8 @@ type ProjectsTriggersService struct { // upon successful completion of all build steps. type ArtifactObjects struct { // Location: Cloud Storage bucket and optional object path, in the form - // "gs://bucket/path/to/somewhere/". (see Bucket Name Requirements). + // "gs://bucket/path/to/somewhere/". (see Bucket Name Requirements + // (https://cloud.google.com/storage/docs/bucket-naming#requirements)). // Files in the workspace matching any path pattern will be uploaded to // Cloud Storage with this location as a prefix. Location string `json:"location,omitempty"` @@ -376,7 +377,9 @@ type Build struct { LogUrl string `json:"logUrl,omitempty"` // LogsBucket: Google Cloud Storage bucket where logs should be written - // (see Bucket Name Requirements). Logs file names will be of the format + // (see Bucket Name Requirements + // (https://cloud.google.com/storage/docs/bucket-naming#requirements)). + // Logs file names will be of the format // `${logs_bucket}/log-${build_id}.txt`. LogsBucket string `json:"logsBucket,omitempty"` @@ -687,7 +690,8 @@ type BuildStep struct { // attempt to pull the image first, using the builder service account's // credentials if necessary. The Docker daemon's cache will already have // the latest versions of all of the officially supported build steps - // (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker + // (https://github.com/GoogleCloudPlatform/cloud-builders + // (https://github.com/GoogleCloudPlatform/cloud-builders)). The Docker // daemon will also have cached many of the layers for some popular // images, like "ubuntu", "debian", but they will be refreshed at the // time you attempt to use them. If you built an image in a previous @@ -1608,8 +1612,9 @@ type Results struct { // BuildStepOutputs: List of build step outputs, produced by builder // images, in the order corresponding to build step indices. Cloud - // Builders can produce this output by writing to - // `$BUILDER_OUTPUT/output`. Only the first 4KB of data is stored. + // Builders (https://cloud.google.com/cloud-build/docs/cloud-builders) + // can produce this output by writing to `$BUILDER_OUTPUT/output`. Only + // the first 4KB of data is stored. BuildStepOutputs []string `json:"buildStepOutputs,omitempty"` // Images: Container images that were built as a part of the build. @@ -1871,10 +1876,11 @@ func (s *SourceProvenance) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1916,7 +1922,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { // Cloud Storage. type StorageSource struct { // Bucket: Google Cloud Storage bucket containing the source (see Bucket - // Name Requirements). + // Name Requirements + // (https://cloud.google.com/storage/docs/bucket-naming#requirements)). Bucket string `json:"bucket,omitempty"` // Generation: Google Cloud Storage generation for the object. If the diff --git a/cloudbuild/v1alpha1/cloudbuild-gen.go b/cloudbuild/v1alpha1/cloudbuild-gen.go index 37fe3c90120..753db1d9ad2 100644 --- a/cloudbuild/v1alpha1/cloudbuild-gen.go +++ b/cloudbuild/v1alpha1/cloudbuild-gen.go @@ -184,7 +184,8 @@ type ProjectsWorkerPoolsService struct { // upon successful completion of all build steps. type ArtifactObjects struct { // Location: Cloud Storage bucket and optional object path, in the form - // "gs://bucket/path/to/somewhere/". (see Bucket Name Requirements). + // "gs://bucket/path/to/somewhere/". (see Bucket Name Requirements + // (https://cloud.google.com/storage/docs/bucket-naming#requirements)). // Files in the workspace matching any path pattern will be uploaded to // Cloud Storage with this location as a prefix. Location string `json:"location,omitempty"` @@ -340,7 +341,9 @@ type Build struct { LogUrl string `json:"logUrl,omitempty"` // LogsBucket: Google Cloud Storage bucket where logs should be written - // (see Bucket Name Requirements). Logs file names will be of the format + // (see Bucket Name Requirements + // (https://cloud.google.com/storage/docs/bucket-naming#requirements)). + // Logs file names will be of the format // `${logs_bucket}/log-${build_id}.txt`. LogsBucket string `json:"logsBucket,omitempty"` @@ -647,7 +650,8 @@ type BuildStep struct { // attempt to pull the image first, using the builder service account's // credentials if necessary. The Docker daemon's cache will already have // the latest versions of all of the officially supported build steps - // (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker + // (https://github.com/GoogleCloudPlatform/cloud-builders + // (https://github.com/GoogleCloudPlatform/cloud-builders)). The Docker // daemon will also have cached many of the layers for some popular // images, like "ubuntu", "debian", but they will be refreshed at the // time you attempt to use them. If you built an image in a previous @@ -1302,8 +1306,9 @@ type Results struct { // BuildStepOutputs: List of build step outputs, produced by builder // images, in the order corresponding to build step indices. Cloud - // Builders can produce this output by writing to - // `$BUILDER_OUTPUT/output`. Only the first 4KB of data is stored. + // Builders (https://cloud.google.com/cloud-build/docs/cloud-builders) + // can produce this output by writing to `$BUILDER_OUTPUT/output`. Only + // the first 4KB of data is stored. BuildStepOutputs []string `json:"buildStepOutputs,omitempty"` // Images: Container images that were built as a part of the build. @@ -1530,10 +1535,11 @@ func (s *SourceProvenance) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1575,7 +1581,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { // Cloud Storage. type StorageSource struct { // Bucket: Google Cloud Storage bucket containing the source (see Bucket - // Name Requirements). + // Name Requirements + // (https://cloud.google.com/storage/docs/bucket-naming#requirements)). Bucket string `json:"bucket,omitempty"` // Generation: Google Cloud Storage generation for the object. If the diff --git a/cloudbuild/v1alpha2/cloudbuild-gen.go b/cloudbuild/v1alpha2/cloudbuild-gen.go index fc2895a7476..6b9f674d4c4 100644 --- a/cloudbuild/v1alpha2/cloudbuild-gen.go +++ b/cloudbuild/v1alpha2/cloudbuild-gen.go @@ -184,7 +184,8 @@ type ProjectsWorkerPoolsService struct { // upon successful completion of all build steps. type ArtifactObjects struct { // Location: Cloud Storage bucket and optional object path, in the form - // "gs://bucket/path/to/somewhere/". (see Bucket Name Requirements). + // "gs://bucket/path/to/somewhere/". (see Bucket Name Requirements + // (https://cloud.google.com/storage/docs/bucket-naming#requirements)). // Files in the workspace matching any path pattern will be uploaded to // Cloud Storage with this location as a prefix. Location string `json:"location,omitempty"` @@ -340,7 +341,9 @@ type Build struct { LogUrl string `json:"logUrl,omitempty"` // LogsBucket: Google Cloud Storage bucket where logs should be written - // (see Bucket Name Requirements). Logs file names will be of the format + // (see Bucket Name Requirements + // (https://cloud.google.com/storage/docs/bucket-naming#requirements)). + // Logs file names will be of the format // `${logs_bucket}/log-${build_id}.txt`. LogsBucket string `json:"logsBucket,omitempty"` @@ -647,7 +650,8 @@ type BuildStep struct { // attempt to pull the image first, using the builder service account's // credentials if necessary. The Docker daemon's cache will already have // the latest versions of all of the officially supported build steps - // (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker + // (https://github.com/GoogleCloudPlatform/cloud-builders + // (https://github.com/GoogleCloudPlatform/cloud-builders)). The Docker // daemon will also have cached many of the layers for some popular // images, like "ubuntu", "debian", but they will be refreshed at the // time you attempt to use them. If you built an image in a previous @@ -1295,8 +1299,9 @@ type Results struct { // BuildStepOutputs: List of build step outputs, produced by builder // images, in the order corresponding to build step indices. Cloud - // Builders can produce this output by writing to - // `$BUILDER_OUTPUT/output`. Only the first 4KB of data is stored. + // Builders (https://cloud.google.com/cloud-build/docs/cloud-builders) + // can produce this output by writing to `$BUILDER_OUTPUT/output`. Only + // the first 4KB of data is stored. BuildStepOutputs []string `json:"buildStepOutputs,omitempty"` // Images: Container images that were built as a part of the build. @@ -1523,10 +1528,11 @@ func (s *SourceProvenance) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1568,7 +1574,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { // Cloud Storage. type StorageSource struct { // Bucket: Google Cloud Storage bucket containing the source (see Bucket - // Name Requirements). + // Name Requirements + // (https://cloud.google.com/storage/docs/bucket-naming#requirements)). Bucket string `json:"bucket,omitempty"` // Generation: Google Cloud Storage generation for the object. If the diff --git a/clouderrorreporting/v1beta1/clouderrorreporting-gen.go b/clouderrorreporting/v1beta1/clouderrorreporting-gen.go index d6dcf86f0d4..48a7499fd31 100644 --- a/clouderrorreporting/v1beta1/clouderrorreporting-gen.go +++ b/clouderrorreporting/v1beta1/clouderrorreporting-gen.go @@ -576,14 +576,22 @@ type ReportedErrorEvent struct { // stack trace in one of the supported programming languages and // formats. Supported languages are Java, Python, JavaScript, Ruby, C#, // PHP, and Go. Supported stack trace formats are: * **Java**: Must be - // the return value of `Throwable.printStackTrace()`. * **Python**: Must - // be the return value of `traceback.format_exc()`. * **JavaScript**: - // Must be the value of `error.stack` as returned by V8. * **Ruby**: - // Must contain frames returned by `Exception.backtrace`. * **C#**: Must - // be the return value of `Exception.ToString()`. * **PHP**: Must start - // with `PHP (Notice|Parse error|Fatal error|Warning)` and contain the - // result of `(string)$exception`. * **Go**: Must be the return value of - // `runtime.Stack()`. + // the return value of `Throwable.printStackTrace()` + // (https://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html#pr + // intStackTrace%28%29). * **Python**: Must be the return value of + // `traceback.format_exc()` + // (https://docs.python.org/2/library/traceback.html#traceback.format_exc + // ). * **JavaScript**: Must be the value of `error.stack` + // (https://github.com/v8/v8/wiki/Stack-Trace-API) as returned by V8. * + // **Ruby**: Must contain frames returned by `Exception.backtrace` + // (https://ruby-doc.org/core-2.2.0/Exception.html#method-i-backtrace). + // * **C#**: Must be the return value of `Exception.ToString()` + // (https://msdn.microsoft.com/en-us/library/system.exception.tostring.as + // px). * **PHP**: Must start with `PHP (Notice|Parse error|Fatal + // error|Warning)` and contain the result of `(string)$exception` + // (http://php.net/manual/en/exception.tostring.php). * **Go**: Must be + // the return value of `runtime.Stack()` + // (https://golang.org/pkg/runtime/debug/#Stack). Message string `json:"message,omitempty"` // ServiceContext: Required. The service context in which this error has @@ -973,7 +981,9 @@ func (c *ProjectsEventsListCall) PageToken(pageToken string) *ProjectsEventsList // ServiceFilterResourceType sets the optional parameter // "serviceFilter.resourceType": The exact value to match against -// `ServiceContext.resource_type`. +// `ServiceContext.resource_type` +// (/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resourc +// e_type). func (c *ProjectsEventsListCall) ServiceFilterResourceType(serviceFilterResourceType string) *ProjectsEventsListCall { c.urlParams_.Set("serviceFilter.resourceType", serviceFilterResourceType) return c @@ -981,7 +991,9 @@ func (c *ProjectsEventsListCall) ServiceFilterResourceType(serviceFilterResource // ServiceFilterService sets the optional parameter // "serviceFilter.service": The exact value to match against -// `ServiceContext.service`. +// `ServiceContext.service` +// (/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.service +// ). func (c *ProjectsEventsListCall) ServiceFilterService(serviceFilterService string) *ProjectsEventsListCall { c.urlParams_.Set("serviceFilter.service", serviceFilterService) return c @@ -989,7 +1001,9 @@ func (c *ProjectsEventsListCall) ServiceFilterService(serviceFilterService strin // ServiceFilterVersion sets the optional parameter // "serviceFilter.version": The exact value to match against -// `ServiceContext.version`. +// `ServiceContext.version` +// (/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.version +// ). func (c *ProjectsEventsListCall) ServiceFilterVersion(serviceFilterVersion string) *ProjectsEventsListCall { c.urlParams_.Set("serviceFilter.version", serviceFilterVersion) return c @@ -1226,8 +1240,9 @@ type ProjectsEventsReportCall struct { } // Report: Report an individual error event. This endpoint accepts -// **either** an OAuth token, **or** an API key for authentication. To -// use an API key, append it to the URL as the value of a `key` +// **either** an OAuth token, **or** an API key +// (https://support.google.com/cloud/answer/6158862) for authentication. +// To use an API key, append it to the URL as the value of a `key` // parameter. For example: `POST // https://clouderrorreporting.googleapis.com/v1beta1/{projectName}/events:report?key=123ABC456` func (r *ProjectsEventsService) Report(projectName string, reportederrorevent *ReportedErrorEvent) *ProjectsEventsReportCall { @@ -1448,7 +1463,9 @@ func (c *ProjectsGroupStatsListCall) PageToken(pageToken string) *ProjectsGroupS // ServiceFilterResourceType sets the optional parameter // "serviceFilter.resourceType": The exact value to match against -// `ServiceContext.resource_type`. +// `ServiceContext.resource_type` +// (/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resourc +// e_type). func (c *ProjectsGroupStatsListCall) ServiceFilterResourceType(serviceFilterResourceType string) *ProjectsGroupStatsListCall { c.urlParams_.Set("serviceFilter.resourceType", serviceFilterResourceType) return c @@ -1456,7 +1473,9 @@ func (c *ProjectsGroupStatsListCall) ServiceFilterResourceType(serviceFilterReso // ServiceFilterService sets the optional parameter // "serviceFilter.service": The exact value to match against -// `ServiceContext.service`. +// `ServiceContext.service` +// (/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.service +// ). func (c *ProjectsGroupStatsListCall) ServiceFilterService(serviceFilterService string) *ProjectsGroupStatsListCall { c.urlParams_.Set("serviceFilter.service", serviceFilterService) return c @@ -1464,7 +1483,9 @@ func (c *ProjectsGroupStatsListCall) ServiceFilterService(serviceFilterService s // ServiceFilterVersion sets the optional parameter // "serviceFilter.version": The exact value to match against -// `ServiceContext.version`. +// `ServiceContext.version` +// (/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.version +// ). func (c *ProjectsGroupStatsListCall) ServiceFilterVersion(serviceFilterVersion string) *ProjectsGroupStatsListCall { c.urlParams_.Set("serviceFilter.version", serviceFilterVersion) return c diff --git a/cloudfunctions/v1/cloudfunctions-gen.go b/cloudfunctions/v1/cloudfunctions-gen.go index 68cd494b9b5..30073e50e0e 100644 --- a/cloudfunctions/v1/cloudfunctions-gen.go +++ b/cloudfunctions/v1/cloudfunctions-gen.go @@ -285,7 +285,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -478,8 +479,9 @@ type CloudFunction struct { // create more instances than the specified max instances limit. If your // function cannot tolerate this temporary behavior, you may want to // factor in a safety margin and set a lower max instances value than - // your function can tolerate. See the Max Instances Guide for more - // details. + // your function can tolerate. See the Max Instances + // (https://cloud.google.com/functions/docs/max-instances) Guide for + // more details. MaxInstances int64 `json:"maxInstances,omitempty"` // Name: A user-defined name of the function. Function names must be @@ -496,13 +498,14 @@ type CloudFunction struct { // {project} is a project id where the network is defined, and {network} // is the short name of the network. This field is mutually exclusive // with `vpc_connector` and will be replaced by it. See the VPC - // documentation for more information on connecting Cloud projects. + // documentation (https://cloud.google.com/compute/docs/vpc) for more + // information on connecting Cloud projects. Network string `json:"network,omitempty"` // Runtime: The runtime in which to run the function. Required when // deploying a new function, optional when updating an existing // function. For a complete list of possible choices, see the `gcloud` - // command reference. + // command reference (/sdk/gcloud/reference/functions/deploy#--runtime). Runtime string `json:"runtime,omitempty"` // ServiceAccountEmail: The email of the function's service account. If @@ -554,8 +557,8 @@ type CloudFunction struct { // name of the network connector resource. The format of this field is // `projects/*/locations/*/connectors/*` This field is mutually // exclusive with `network` field and will eventually replace it. See - // the VPC documentation for more information on connecting Cloud - // projects. + // the VPC documentation (https://cloud.google.com/compute/docs/vpc) for + // more information on connecting Cloud projects. VpcConnector string `json:"vpcConnector,omitempty"` // VpcConnectorEgressSettings: The egress settings for the connector, @@ -1174,7 +1177,9 @@ func (s *OperationMetadataV1) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1193,7 +1198,7 @@ func (s *OperationMetadataV1) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1233,7 +1238,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1354,10 +1360,11 @@ func (s *SourceRepository) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1400,7 +1407,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2037,7 +2045,8 @@ type ProjectsLocationsFunctionsCallCall struct { // Call: Synchronously invokes a deployed Cloud Function. To be used for // testing purposes as very limited traffic is allowed. For more -// information on the actual limits, refer to Rate Limits. +// information on the actual limits, refer to Rate Limits +// (https://cloud.google.com/functions/quotas#rate_limits). func (r *ProjectsLocationsFunctionsService) Call(name string, callfunctionrequest *CallFunctionRequest) *ProjectsLocationsFunctionsCallCall { c := &ProjectsLocationsFunctionsCallCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2911,7 +2920,8 @@ func (r *ProjectsLocationsFunctionsService) GetIamPolicy(resource string) *Proje // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsFunctionsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsFunctionsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/cloudidentity/v1/cloudidentity-gen.go b/cloudidentity/v1/cloudidentity-gen.go index e04d4d6a904..326696cd1e2 100644 --- a/cloudidentity/v1/cloudidentity-gen.go +++ b/cloudidentity/v1/cloudidentity-gen.go @@ -382,11 +382,12 @@ func (s *GoogleAppsCloudidentityDevicesV1AndroidAttributes) MarshalJSON() ([]byt // GoogleAppsCloudidentityDevicesV1ApproveDeviceUserRequest: Request // message for approving the device to access user data. type GoogleAppsCloudidentityDevicesV1ApproveDeviceUserRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -444,11 +445,12 @@ func (s *GoogleAppsCloudidentityDevicesV1ApproveDeviceUserResponse) MarshalJSON( // GoogleAppsCloudidentityDevicesV1BlockDeviceUserRequest: Request // message for blocking account on device. type GoogleAppsCloudidentityDevicesV1BlockDeviceUserRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -506,11 +508,12 @@ func (s *GoogleAppsCloudidentityDevicesV1BlockDeviceUserResponse) MarshalJSON() // GoogleAppsCloudidentityDevicesV1CancelWipeDeviceRequest: Request // message for cancelling an unfinished device wipe. type GoogleAppsCloudidentityDevicesV1CancelWipeDeviceRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -569,11 +572,12 @@ func (s *GoogleAppsCloudidentityDevicesV1CancelWipeDeviceResponse) MarshalJSON() // GoogleAppsCloudidentityDevicesV1CancelWipeDeviceUserRequest: Request // message for cancelling an unfinished user account wipe. type GoogleAppsCloudidentityDevicesV1CancelWipeDeviceUserRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -693,7 +697,9 @@ type GoogleAppsCloudidentityDevicesV1ClientState struct { // "UNMANAGED" - The resource is not managed. Managed string `json:"managed,omitempty"` - // Name: Output only. Resource name of the ClientState in format: + // Name: Output only. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // ClientState in format: // `devices/{device_id}/deviceUsers/{device_user_id}/clientState/{partner // _id}`, where partner_id corresponds to the partner storing the data. // For partners belonging to the "BeyondCorp Alliance", this is the @@ -902,9 +908,10 @@ type GoogleAppsCloudidentityDevicesV1Device struct { // Model: Output only. Model name of device. Example: Pixel 3. Model string `json:"model,omitempty"` - // Name: Output only. Resource name of the Device in format: - // `devices/{device_id}`, where device_id is the unique id assigned to - // the Device. + // Name: Output only. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the Device + // in format: `devices/{device_id}`, where device_id is the unique id + // assigned to the Device. Name string `json:"name,omitempty"` // NetworkOperator: Output only. Mobile or network operator of device, @@ -1018,9 +1025,10 @@ type GoogleAppsCloudidentityDevicesV1DeviceUser struct { // but the Windows account is still intact. ManagementState string `json:"managementState,omitempty"` - // Name: Output only. Resource name of the DeviceUser in format: - // `devices/{device_id}/deviceUsers/{user_id}`, where user_id is the ID - // of the user associated with the user session. + // Name: Output only. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // DeviceUser in format: `devices/{device_id}/deviceUsers/{user_id}`, + // where user_id is the ID of the user associated with the user session. Name string `json:"name,omitempty"` // PasswordState: Password state of the DeviceUser object @@ -1185,7 +1193,9 @@ type GoogleAppsCloudidentityDevicesV1LookupSelfDeviceUsersResponse struct { // Devices API methods such as List, Get, etc. Customer string `json:"customer,omitempty"` - // Names: Resource names of the DeviceUsers in the format: + // Names: Resource names + // (https://cloud.google.com/apis/design/resource_names) of the + // DeviceUsers in the format: // `devices/{device_id}/deviceUsers/{user_resource_id}`, where device_id // is the unique ID assigned to a Device and user_resource_id is the // unique user ID @@ -1225,11 +1235,12 @@ func (s *GoogleAppsCloudidentityDevicesV1LookupSelfDeviceUsersResponse) MarshalJ // GoogleAppsCloudidentityDevicesV1WipeDeviceRequest: Request message // for wiping all data on the device. type GoogleAppsCloudidentityDevicesV1WipeDeviceRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -1288,11 +1299,12 @@ func (s *GoogleAppsCloudidentityDevicesV1WipeDeviceResponse) MarshalJSON() ([]by // GoogleAppsCloudidentityDevicesV1WipeDeviceUserRequest: Request // message for starting an account wipe on device. type GoogleAppsCloudidentityDevicesV1WipeDeviceUserRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -1379,8 +1391,9 @@ type Group struct { // {"system/groups/external": ""}. Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. The resource name of the `Group`. Shall be of the - // form `groups/{group_id}`. + // Name: Output only. The resource name + // (https://cloud.google.com/apis/design/resource_names) of the `Group`. + // Shall be of the form `groups/{group_id}`. Name string `json:"name,omitempty"` // Parent: Required. Immutable. The resource name of the entity under @@ -1553,7 +1566,9 @@ func (s *ListMembershipsResponse) MarshalJSON() ([]byte, error) { // LookupGroupNameResponse: The response message for // GroupsService.LookupGroupName. type LookupGroupNameResponse struct { - // Name: The resource name of the looked-up `Group`. + // Name: The resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // looked-up `Group`. Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1586,8 +1601,10 @@ func (s *LookupGroupNameResponse) MarshalJSON() ([]byte, error) { // LookupMembershipNameResponse: The response message for // MembershipsService.LookupMembershipName. type LookupMembershipNameResponse struct { - // Name: The resource name of the looked-up `Membership`. Must be of the - // form `groups/{group_id}/memberships/{membership_id}`. + // Name: The resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // looked-up `Membership`. Must be of the form + // `groups/{group_id}/memberships/{membership_id}`. Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1677,8 +1694,10 @@ type Membership struct { // CreateTime: Output only. The time when the `Membership` was created. CreateTime string `json:"createTime,omitempty"` - // Name: Output only. The resource name of the `Membership`. Shall be of - // the form `groups/{group_id}/memberships/{membership_id}`. + // Name: Output only. The resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // `Membership`. Shall be of the form + // `groups/{group_id}/memberships/{membership_id}`. Name string `json:"name,omitempty"` // PreferredMemberKey: Required. Immutable. The `EntityKey` of the @@ -2046,10 +2065,11 @@ func (s *SearchTransitiveMembershipsResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2281,10 +2301,11 @@ func (r *DevicesService) Create(googleappscloudidentitydevicesv1device *GoogleAp } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesCreateCall) Customer(customer string) *DevicesCreateCall { c.urlParams_.Set("customer", customer) return c @@ -2419,10 +2440,11 @@ func (r *DevicesService) Delete(name string) *DevicesDeleteCall { } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeleteCall) Customer(customer string) *DevicesDeleteCall { c.urlParams_.Set("customer", customer) return c @@ -2562,12 +2584,13 @@ func (r *DevicesService) Get(name string) *DevicesGetCall { } // Customer sets the optional parameter "customer": Required. Resource -// name of the Customer in the format: `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. If you're -// using this API for your own organization, use -// `customers/my_customer`. If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// Customer in the format: `customers/{customer_id}`, where customer_id +// is the customer to whom the device belongs. If you're using this API +// for your own organization, use `customers/my_customer`. If you're +// using this API to manage another organization, use +// `customers/{customer_id}`, where customer_id is the customer to whom +// the device belongs. func (c *DevicesGetCall) Customer(customer string) *DevicesGetCall { c.urlParams_.Set("customer", customer) return c @@ -2719,12 +2742,13 @@ func (r *DevicesService) List() *DevicesListCall { } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer in the format: `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. If you're -// using this API for your own organization, use -// `customers/my_customer`. If you're using this API to manage another -// organization, use `customers/{customer_id}`, where customer_id is the -// customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer in the format: `customers/{customer_id}`, where customer_id +// is the customer to whom the device belongs. If you're using this API +// for your own organization, use `customers/my_customer`. If you're +// using this API to manage another organization, use +// `customers/{customer_id}`, where customer_id is the customer to whom +// the device belongs. func (c *DevicesListCall) Customer(customer string) *DevicesListCall { c.urlParams_.Set("customer", customer) return c @@ -2732,8 +2756,9 @@ func (c *DevicesListCall) Customer(customer string) *DevicesListCall { // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to -// Mobile device search fields. Multiple search fields are separated by -// the space character. +// Mobile device search fields +// (https://developers.google.com/admin-sdk/directory/v1/search-operators +// ). Multiple search fields are separated by the space character. func (c *DevicesListCall) Filter(filter string) *DevicesListCall { c.urlParams_.Set("filter", filter) return c @@ -3530,10 +3555,11 @@ func (r *DevicesDeviceUsersService) Delete(name string) *DevicesDeviceUsersDelet } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersDeleteCall) Customer(customer string) *DevicesDeviceUsersDeleteCall { c.urlParams_.Set("customer", customer) return c @@ -3673,10 +3699,11 @@ func (r *DevicesDeviceUsersService) Get(name string) *DevicesDeviceUsersGetCall } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersGetCall) Customer(customer string) *DevicesDeviceUsersGetCall { c.urlParams_.Set("customer", customer) return c @@ -3831,10 +3858,11 @@ func (r *DevicesDeviceUsersService) List(parent string) *DevicesDeviceUsersListC } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersListCall) Customer(customer string) *DevicesDeviceUsersListCall { c.urlParams_.Set("customer", customer) return c @@ -3842,8 +3870,9 @@ func (c *DevicesDeviceUsersListCall) Customer(customer string) *DevicesDeviceUse // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to -// Mobile device search fields. Multiple search fields are separated by -// the space character. +// Mobile device search fields +// (https://developers.google.com/admin-sdk/directory/v1/search-operators +// ). Multiple search fields are separated by the space character. func (c *DevicesDeviceUsersListCall) Filter(filter string) *DevicesDeviceUsersListCall { c.urlParams_.Set("filter", filter) return c @@ -4079,7 +4108,9 @@ func (r *DevicesDeviceUsersService) Lookup(parent string) *DevicesDeviceUsersLoo } // AndroidId sets the optional parameter "androidId": Android Id -// returned by Settings.Secure#ANDROID_ID. +// returned by Settings.Secure#ANDROID_ID +// (https://developer.android.com/reference/android/provider/Settings.Sec +// ure.html#ANDROID_ID). func (c *DevicesDeviceUsersLookupCall) AndroidId(androidId string) *DevicesDeviceUsersLookupCall { c.urlParams_.Set("androidId", androidId) return c @@ -4462,10 +4493,11 @@ func (r *DevicesDeviceUsersClientStatesService) Get(name string) *DevicesDeviceU } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersClientStatesGetCall) Customer(customer string) *DevicesDeviceUsersClientStatesGetCall { c.urlParams_.Set("customer", customer) return c @@ -4620,10 +4652,11 @@ func (r *DevicesDeviceUsersClientStatesService) List(parent string) *DevicesDevi } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersClientStatesListCall) Customer(customer string) *DevicesDeviceUsersClientStatesListCall { c.urlParams_.Set("customer", customer) return c @@ -4843,10 +4876,11 @@ func (r *DevicesDeviceUsersClientStatesService) Patch(name string, googleappsclo } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersClientStatesPatchCall) Customer(customer string) *DevicesDeviceUsersClientStatesPatchCall { c.urlParams_.Set("customer", customer) return c @@ -5658,7 +5692,9 @@ type GroupsLookupCall struct { header_ http.Header } -// Lookup: Looks up the resource name of a `Group` by its `EntityKey`. +// Lookup: Looks up the resource name +// (https://cloud.google.com/apis/design/resource_names) of a `Group` by +// its `EntityKey`. func (r *GroupsService) Lookup() *GroupsLookupCall { c := &GroupsLookupCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -6005,9 +6041,10 @@ func (c *GroupsSearchCall) PageToken(pageToken string) *GroupsSearchCall { } // Query sets the optional parameter "query": Required. The search -// query. Must be specified in Common Expression Language. May only -// contain equality operators on the parent and inclusion operators on -// labels (e.g., `parent == 'customers/{customer_id}' && +// query. Must be specified in Common Expression Language +// (https://opensource.google/projects/cel). May only contain equality +// operators on the parent and inclusion operators on labels (e.g., +// `parent == 'customers/{customer_id}' && // 'cloudidentity.googleapis.com/groups.discussion_forum' in labels`). func (c *GroupsSearchCall) Query(query string) *GroupsSearchCall { c.urlParams_.Set("query", query) @@ -7190,8 +7227,9 @@ type GroupsMembershipsLookupCall struct { header_ http.Header } -// Lookup: Looks up the resource name of a `Membership` by its -// `EntityKey`. +// Lookup: Looks up the resource name +// (https://cloud.google.com/apis/design/resource_names) of a +// `Membership` by its `EntityKey`. func (r *GroupsMembershipsService) Lookup(parent string) *GroupsMembershipsLookupCall { c := &GroupsMembershipsLookupCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/cloudidentity/v1beta1/cloudidentity-gen.go b/cloudidentity/v1beta1/cloudidentity-gen.go index d99623ab5fc..b12bb97a2cd 100644 --- a/cloudidentity/v1beta1/cloudidentity-gen.go +++ b/cloudidentity/v1beta1/cloudidentity-gen.go @@ -266,11 +266,12 @@ func (s *AndroidAttributes) MarshalJSON() ([]byte, error) { // ApproveDeviceUserRequest: Request message for approving the device to // access user data. type ApproveDeviceUserRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -328,11 +329,12 @@ func (s *ApproveDeviceUserResponse) MarshalJSON() ([]byte, error) { // BlockDeviceUserRequest: Request message for blocking account on // device. type BlockDeviceUserRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -390,11 +392,12 @@ func (s *BlockDeviceUserResponse) MarshalJSON() ([]byte, error) { // CancelWipeDeviceRequest: Request message for cancelling an unfinished // device wipe. type CancelWipeDeviceRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -453,11 +456,12 @@ func (s *CancelWipeDeviceResponse) MarshalJSON() ([]byte, error) { // CancelWipeDeviceUserRequest: Request message for cancelling an // unfinished user account wipe. type CancelWipeDeviceUserRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -610,7 +614,9 @@ type ClientState struct { // "UNMANAGED" - The resource is not managed. Managed string `json:"managed,omitempty"` - // Name: Output only. Resource name of the ClientState in format: + // Name: Output only. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // ClientState in format: // `devices/{device_id}/deviceUsers/{device_user_id}/clientState/{partner // _id}`, where partner_id corresponds to the partner storing the data. Name string `json:"name,omitempty"` @@ -656,11 +662,12 @@ func (s *ClientState) MarshalJSON() ([]byte, error) { // CreateDeviceRequest: Request message for creating a Company Owned // device. type CreateDeviceRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // Device: Required. The device to be created. The name field within @@ -846,9 +853,10 @@ type Device struct { // Model: Output only. Model name of device. Example: Pixel 3. Model string `json:"model,omitempty"` - // Name: Output only. Resource name of the Device in format: - // `devices/{device_id}`, where device_id is the unique id assigned to - // the Device. + // Name: Output only. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the Device + // in format: `devices/{device_id}`, where device_id is the unique id + // assigned to the Device. Name string `json:"name,omitempty"` // NetworkOperator: Output only. Mobile or network operator of device, @@ -962,9 +970,10 @@ type DeviceUser struct { // but the Windows account is still intact. ManagementState string `json:"managementState,omitempty"` - // Name: Output only. Resource name of the DeviceUser in format: - // `devices/{device_id}/deviceUsers/{user_id}`, where user_id is the ID - // of the user associated with the user session. + // Name: Output only. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // DeviceUser in format: `devices/{device_id}/deviceUsers/{user_id}`, + // where user_id is the ID of the user associated with the user session. Name string `json:"name,omitempty"` // PasswordState: Password state of the DeviceUser object @@ -1466,7 +1475,9 @@ type GoogleAppsCloudidentityDevicesV1ClientState struct { // "UNMANAGED" - The resource is not managed. Managed string `json:"managed,omitempty"` - // Name: Output only. Resource name of the ClientState in format: + // Name: Output only. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // ClientState in format: // `devices/{device_id}/deviceUsers/{device_user_id}/clientState/{partner // _id}`, where partner_id corresponds to the partner storing the data. // For partners belonging to the "BeyondCorp Alliance", this is the @@ -1671,9 +1682,10 @@ type GoogleAppsCloudidentityDevicesV1Device struct { // Model: Output only. Model name of device. Example: Pixel 3. Model string `json:"model,omitempty"` - // Name: Output only. Resource name of the Device in format: - // `devices/{device_id}`, where device_id is the unique id assigned to - // the Device. + // Name: Output only. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the Device + // in format: `devices/{device_id}`, where device_id is the unique id + // assigned to the Device. Name string `json:"name,omitempty"` // NetworkOperator: Output only. Mobile or network operator of device, @@ -1783,9 +1795,10 @@ type GoogleAppsCloudidentityDevicesV1DeviceUser struct { // but the Windows account is still intact. ManagementState string `json:"managementState,omitempty"` - // Name: Output only. Resource name of the DeviceUser in format: - // `devices/{device_id}/deviceUsers/{user_id}`, where user_id is the ID - // of the user associated with the user session. + // Name: Output only. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // DeviceUser in format: `devices/{device_id}/deviceUsers/{user_id}`, + // where user_id is the ID of the user associated with the user session. Name string `json:"name,omitempty"` // PasswordState: Password state of the DeviceUser object @@ -1925,8 +1938,9 @@ type Group struct { // {"system/groups/external": ""}. Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. The resource name of the `Group`. Shall be of the - // form `groups/{group_id}`. + // Name: Output only. The resource name + // (https://cloud.google.com/apis/design/resource_names) of the `Group`. + // Shall be of the form `groups/{group_id}`. Name string `json:"name,omitempty"` // Parent: Required. Immutable. The resource name of the entity under @@ -2207,7 +2221,9 @@ func (s *ListMembershipsResponse) MarshalJSON() ([]byte, error) { // LookupGroupNameResponse: The response message for // GroupsService.LookupGroupName. type LookupGroupNameResponse struct { - // Name: Output only. The resource name of the looked-up `Group`. + // Name: Output only. The resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // looked-up `Group`. Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2240,8 +2256,10 @@ func (s *LookupGroupNameResponse) MarshalJSON() ([]byte, error) { // LookupMembershipNameResponse: The response message for // MembershipsService.LookupMembershipName. type LookupMembershipNameResponse struct { - // Name: The resource name of the looked-up `Membership`. Must be of the - // form `groups/{group_id}/memberships/{membership_id}`. + // Name: The resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // looked-up `Membership`. Must be of the form + // `groups/{group_id}/memberships/{membership_id}`. Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2278,7 +2296,9 @@ type LookupSelfDeviceUsersResponse struct { // Devices API methods such as List, Get, etc. Customer string `json:"customer,omitempty"` - // Names: Resource names of the DeviceUsers in the format: + // Names: Resource names + // (https://cloud.google.com/apis/design/resource_names) of the + // DeviceUsers in the format: // `devices/{device_id}/deviceUsers/{user_resource_id}`, where device_id // is the unique ID assigned to a Device and user_resource_id is the // unique user ID @@ -2381,8 +2401,10 @@ type Membership struct { // when returned. MemberKey *EntityKey `json:"memberKey,omitempty"` - // Name: Output only. The resource name of the `Membership`. Shall be of - // the form `groups/{group_id}/memberships/{membership_id}`. + // Name: Output only. The resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // `Membership`. Shall be of the form + // `groups/{group_id}/memberships/{membership_id}`. Name string `json:"name,omitempty"` // PreferredMemberKey: Required. Immutable. The `EntityKey` of the @@ -2763,10 +2785,11 @@ func (s *SearchTransitiveMembershipsResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2871,11 +2894,12 @@ func (s *UpdateMembershipRolesParams) MarshalJSON() ([]byte, error) { // WipeDeviceRequest: Request message for wiping all data on the device. type WipeDeviceRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -2934,11 +2958,12 @@ func (s *WipeDeviceResponse) MarshalJSON() ([]byte, error) { // WipeDeviceUserRequest: Request message for starting an account wipe // on device. type WipeDeviceUserRequest struct { - // Customer: Required. Resource name of the customer. If you're using - // this API for your own organization, use `customers/my_customer` If - // you're using this API to manage another organization, use - // `customers/{customer_id}`, where customer_id is the customer to whom - // the device belongs. + // Customer: Required. Resource name + // (https://cloud.google.com/apis/design/resource_names) of the + // customer. If you're using this API for your own organization, use + // `customers/my_customer` If you're using this API to manage another + // organization, use `customers/{customer_id}`, where customer_id is the + // customer to whom the device belongs. Customer string `json:"customer,omitempty"` // ForceSendFields is a list of field names (e.g. "Customer") to @@ -3275,10 +3300,11 @@ func (r *DevicesService) Delete(name string) *DevicesDeleteCall { } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeleteCall) Customer(customer string) *DevicesDeleteCall { c.urlParams_.Set("customer", customer) return c @@ -3418,8 +3444,9 @@ func (r *DevicesService) Get(name string) *DevicesGetCall { } // Customer sets the optional parameter "customer": Required. Resource -// name of the Customer in format: `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// Customer in format: `customers/{customer_id}`, where customer_id is +// the customer to whom the device belongs. func (c *DevicesGetCall) Customer(customer string) *DevicesGetCall { c.urlParams_.Set("customer", customer) return c @@ -3570,7 +3597,8 @@ func (r *DevicesService) List() *DevicesListCall { } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. func (c *DevicesListCall) Customer(customer string) *DevicesListCall { c.urlParams_.Set("customer", customer) return c @@ -3578,8 +3606,9 @@ func (c *DevicesListCall) Customer(customer string) *DevicesListCall { // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to -// Mobile device search fields. Multiple search fields are separated by -// the space character. +// Mobile device search fields +// (https://developers.google.com/admin-sdk/directory/v1/search-operators +// ). Multiple search fields are separated by the space character. func (c *DevicesListCall) Filter(filter string) *DevicesListCall { c.urlParams_.Set("filter", filter) return c @@ -4373,10 +4402,11 @@ func (r *DevicesDeviceUsersService) Delete(name string) *DevicesDeviceUsersDelet } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersDeleteCall) Customer(customer string) *DevicesDeviceUsersDeleteCall { c.urlParams_.Set("customer", customer) return c @@ -4516,10 +4546,11 @@ func (r *DevicesDeviceUsersService) Get(name string) *DevicesDeviceUsersGetCall } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersGetCall) Customer(customer string) *DevicesDeviceUsersGetCall { c.urlParams_.Set("customer", customer) return c @@ -4672,10 +4703,11 @@ func (r *DevicesDeviceUsersService) List(parent string) *DevicesDeviceUsersListC } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersListCall) Customer(customer string) *DevicesDeviceUsersListCall { c.urlParams_.Set("customer", customer) return c @@ -4683,8 +4715,9 @@ func (c *DevicesDeviceUsersListCall) Customer(customer string) *DevicesDeviceUse // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to -// Mobile device search fields. Multiple search fields are separated by -// the space character. +// Mobile device search fields +// (https://developers.google.com/admin-sdk/directory/v1/search-operators +// ). Multiple search fields are separated by the space character. func (c *DevicesDeviceUsersListCall) Filter(filter string) *DevicesDeviceUsersListCall { c.urlParams_.Set("filter", filter) return c @@ -4917,7 +4950,9 @@ func (r *DevicesDeviceUsersService) Lookup(parent string) *DevicesDeviceUsersLoo } // AndroidId sets the optional parameter "androidId": Android Id -// returned by Settings.Secure#ANDROID_ID. +// returned by Settings.Secure#ANDROID_ID +// (https://developer.android.com/reference/android/provider/Settings.Sec +// ure.html#ANDROID_ID). func (c *DevicesDeviceUsersLookupCall) AndroidId(androidId string) *DevicesDeviceUsersLookupCall { c.urlParams_.Set("androidId", androidId) return c @@ -5291,10 +5326,11 @@ func (r *DevicesDeviceUsersClientStatesService) Get(name string) *DevicesDeviceU } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersClientStatesGetCall) Customer(customer string) *DevicesDeviceUsersClientStatesGetCall { c.urlParams_.Set("customer", customer) return c @@ -5451,10 +5487,11 @@ func (r *DevicesDeviceUsersClientStatesService) Patch(name string, clientstate * } // Customer sets the optional parameter "customer": Required. Resource -// name of the customer. If you're using this API for your own -// organization, use `customers/my_customer` If you're using this API to -// manage another organization, use `customers/{customer_id}`, where -// customer_id is the customer to whom the device belongs. +// name (https://cloud.google.com/apis/design/resource_names) of the +// customer. If you're using this API for your own organization, use +// `customers/my_customer` If you're using this API to manage another +// organization, use `customers/{customer_id}`, where customer_id is the +// customer to whom the device belongs. func (c *DevicesDeviceUsersClientStatesPatchCall) Customer(customer string) *DevicesDeviceUsersClientStatesPatchCall { c.urlParams_.Set("customer", customer) return c @@ -6266,7 +6303,9 @@ type GroupsLookupCall struct { header_ http.Header } -// Lookup: Looks up the resource name of a `Group` by its `EntityKey`. +// Lookup: Looks up the resource name +// (https://cloud.google.com/apis/design/resource_names) of a `Group` by +// its `EntityKey`. func (r *GroupsService) Lookup() *GroupsLookupCall { c := &GroupsLookupCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -6613,9 +6652,10 @@ func (c *GroupsSearchCall) PageToken(pageToken string) *GroupsSearchCall { } // Query sets the optional parameter "query": Required. The search -// query. Must be specified in Common Expression Language. May only -// contain equality operators on the parent and inclusion operators on -// labels (e.g., `parent == 'customers/{customer_id}' && +// query. Must be specified in Common Expression Language +// (https://opensource.google/projects/cel). May only contain equality +// operators on the parent and inclusion operators on labels (e.g., +// `parent == 'customers/{customer_id}' && // 'cloudidentity.googleapis.com/groups.discussion_forum' in labels`). func (c *GroupsSearchCall) Query(query string) *GroupsSearchCall { c.urlParams_.Set("query", query) @@ -7789,8 +7829,9 @@ type GroupsMembershipsLookupCall struct { header_ http.Header } -// Lookup: Looks up the resource name of a `Membership` by its -// `EntityKey`. +// Lookup: Looks up the resource name +// (https://cloud.google.com/apis/design/resource_names) of a +// `Membership` by its `EntityKey`. func (r *GroupsMembershipsService) Lookup(parent string) *GroupsMembershipsLookupCall { c := &GroupsMembershipsLookupCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/cloudiot/v1/cloudiot-gen.go b/cloudiot/v1/cloudiot-gen.go index 7ad483ee861..ad2876a5ea1 100644 --- a/cloudiot/v1/cloudiot-gen.go +++ b/cloudiot/v1/cloudiot-gen.go @@ -285,7 +285,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -919,7 +920,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1216,7 +1218,9 @@ func (s *MqttConfig) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1235,7 +1239,7 @@ func (s *MqttConfig) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1271,7 +1275,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1539,10 +1544,11 @@ func (s *StateNotificationConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1585,7 +1591,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/cloudkms/v1/cloudkms-gen.go b/cloudkms/v1/cloudkms-gen.go index 85bda260a8c..e26ecc4dbdc 100644 --- a/cloudkms/v1/cloudkms-gen.go +++ b/cloudkms/v1/cloudkms-gen.go @@ -534,7 +534,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -647,7 +648,7 @@ type CryptoKey struct { CreateTime string `json:"createTime,omitempty"` // Labels: Labels with user-defined metadata. For more information, see - // Labeling Keys. + // Labeling Keys (https://cloud.google.com/kms/docs/labeling-keys). Labels map[string]string `json:"labels,omitempty"` // Name: Output only. The resource name for this CryptoKey in the format @@ -1459,7 +1460,7 @@ func (s *ImportCryptoKeyVersionRequest) MarshalJSON() ([]byte, error) { // expires 3 days after it is created. Once expired, Cloud KMS will no // longer be able to import or unwrap any key material that was wrapped // with the ImportJob's public key. For more information, see Importing -// a key. +// a key (https://cloud.google.com/kms/docs/importing-a-key). type ImportJob struct { // Attestation: Output only. Statement that was generated and signed by // the key creator (for example, an HSM) at key creation time. Use this @@ -1949,7 +1950,9 @@ func (s *LocationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1968,7 +1971,7 @@ func (s *LocationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2008,7 +2011,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2083,8 +2087,10 @@ type PublicKey struct { Name string `json:"name,omitempty"` // Pem: The public key, encoded in PEM format. For more information, see - // the RFC 7468 sections for General Considerations and [Textual - // Encoding of Subject Public Key Info] + // the RFC 7468 (https://tools.ietf.org/html/rfc7468) sections for + // General Considerations + // (https://tools.ietf.org/html/rfc7468#section-2) and [Textual Encoding + // of Subject Public Key Info] // (https://tools.ietf.org/html/rfc7468#section-13). Pem string `json:"pem,omitempty"` @@ -2175,7 +2181,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2271,8 +2278,10 @@ func (s *UpdateCryptoKeyPrimaryVersionRequest) MarshalJSON() ([]byte, error) { // ImportMethod. type WrappingPublicKey struct { // Pem: The public key, encoded in PEM format. For more information, see - // the RFC 7468 sections for General Considerations and [Textual - // Encoding of Subject Public Key Info] + // the RFC 7468 (https://tools.ietf.org/html/rfc7468) sections for + // General Considerations + // (https://tools.ietf.org/html/rfc7468#section-2) and [Textual Encoding + // of Subject Public Key Info] // (https://tools.ietf.org/html/rfc7468#section-13). Pem string `json:"pem,omitempty"` @@ -2974,7 +2983,8 @@ func (r *ProjectsLocationsKeyRingsService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsKeyRingsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsKeyRingsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -3133,7 +3143,8 @@ func (r *ProjectsLocationsKeyRingsService) List(parent string) *ProjectsLocation // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For more information, see -// Sorting and filtering list results. +// Sorting and filtering list results +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsListCall) Filter(filter string) *ProjectsLocationsKeyRingsListCall { c.urlParams_.Set("filter", filter) return c @@ -3142,7 +3153,8 @@ func (c *ProjectsLocationsKeyRingsListCall) Filter(filter string) *ProjectsLocat // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. If not specified, the results will be // sorted in the default order. For more information, see Sorting and -// filtering list results. +// filtering list results +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -4251,7 +4263,8 @@ func (r *ProjectsLocationsKeyRingsCryptoKeysService) GetIamPolicy(resource strin // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsKeyRingsCryptoKeysGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsKeyRingsCryptoKeysGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -4410,7 +4423,8 @@ func (r *ProjectsLocationsKeyRingsCryptoKeysService) List(parent string) *Projec // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For more information, see -// Sorting and filtering list results. +// Sorting and filtering list results +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsCryptoKeysListCall) Filter(filter string) *ProjectsLocationsKeyRingsCryptoKeysListCall { c.urlParams_.Set("filter", filter) return c @@ -4419,7 +4433,8 @@ func (c *ProjectsLocationsKeyRingsCryptoKeysListCall) Filter(filter string) *Pro // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. If not specified, the results will be // sorted in the default order. For more information, see Sorting and -// filtering list results. +// filtering list results +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsCryptoKeysListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsCryptoKeysListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -6253,7 +6268,8 @@ func (r *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsService) List(paren // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For more information, see -// Sorting and filtering list results. +// Sorting and filtering list results +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall) Filter(filter string) *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall { c.urlParams_.Set("filter", filter) return c @@ -6262,7 +6278,8 @@ func (c *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall) Filter(fi // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. If not specified, the results will be // sorted in the default order. For more information, see Sorting and -// filtering list results. +// filtering list results +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -7108,7 +7125,8 @@ func (r *ProjectsLocationsKeyRingsImportJobsService) GetIamPolicy(resource strin // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsKeyRingsImportJobsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsKeyRingsImportJobsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -7267,7 +7285,8 @@ func (r *ProjectsLocationsKeyRingsImportJobsService) List(parent string) *Projec // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For more information, see -// Sorting and filtering list results. +// Sorting and filtering list results +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsImportJobsListCall) Filter(filter string) *ProjectsLocationsKeyRingsImportJobsListCall { c.urlParams_.Set("filter", filter) return c @@ -7276,7 +7295,8 @@ func (c *ProjectsLocationsKeyRingsImportJobsListCall) Filter(filter string) *Pro // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. If not specified, the results will be // sorted in the default order. For more information, see Sorting and -// filtering list results. +// filtering list results +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsImportJobsListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsImportJobsListCall { c.urlParams_.Set("orderBy", orderBy) return c diff --git a/cloudprofiler/v2/cloudprofiler-gen.go b/cloudprofiler/v2/cloudprofiler-gen.go index 28b6922b9aa..d64ba71a2fe 100644 --- a/cloudprofiler/v2/cloudprofiler-gen.go +++ b/cloudprofiler/v2/cloudprofiler-gen.go @@ -227,15 +227,16 @@ func (s *CreateProfileRequest) MarshalJSON() ([]byte, error) { // information. type Deployment struct { // Labels: Labels identify the deployment within the user universe and - // same target. Validation regex for label names: `^a-z0-9?$`. Value for - // an individual label must be <= 512 bytes, the total size of all label - // names and values must be <= 1024 bytes. Label named "language" can be - // used to record the programming language of the profiled deployment. - // The standard choices for the value include "java", "go", "python", - // "ruby", "nodejs", "php", "dotnet". For deployments running on Google - // Cloud Platform, "zone" or "region" label should be present describing - // the deployment location. An example of a zone is "us-central1-a", an - // example of a region is "us-central1" or "us-central". + // same target. Validation regex for label names: `^a-z0-9 + // ([a-z0-9-]{0,61}[a-z0-9])?$`. Value for an individual label must be + // <= 512 bytes, the total size of all label names and values must be <= + // 1024 bytes. Label named "language" can be used to record the + // programming language of the profiled deployment. The standard choices + // for the value include "java", "go", "python", "ruby", "nodejs", + // "php", "dotnet". For deployments running on Google Cloud Platform, + // "zone" or "region" label should be present describing the deployment + // location. An example of a zone is "us-central1-a", an example of a + // region is "us-central1" or "us-central". Labels map[string]string `json:"labels,omitempty"` // ProjectId: Project ID is the ID of a cloud project. Validation regex: @@ -245,7 +246,8 @@ type Deployment struct { // Target: Target is the service name used to group related deployments: // * Service name for GAE Flex / Standard. * Cluster and container name // for GKE. * User-specified string for direct GCE profiling (e.g. - // Java). * Job name for Dataflow. Validation regex: `^a-z?$`. + // Java). * Job name for Dataflow. Validation regex: `^a-z + // ([-a-z0-9_.]{0,253}[a-z0-9])?$`. Target string `json:"target,omitempty"` // ForceSendFields is a list of field names (e.g. "Labels") to diff --git a/cloudresourcemanager/v1/cloudresourcemanager-gen.go b/cloudresourcemanager/v1/cloudresourcemanager-gen.go index 0861f798e31..34c41a2edb3 100644 --- a/cloudresourcemanager/v1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v1/cloudresourcemanager-gen.go @@ -333,7 +333,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -592,10 +593,11 @@ func (s *CloudresourcemanagerGoogleCloudResourcemanagerV2beta1FolderOperation) M // for `Constraints` at different locations in the organization's // resource hierarchy. Policies are inherited down the resource // hierarchy from higher levels, but can also be overridden. For details -// about the inheritance rules please read about Policies. `Constraints` -// have a default behavior determined by the `constraint_default` field, -// which is the enforcement behavior that is used in the absence of a -// `Policy` being defined or inherited for the resource in question. +// about the inheritance rules please read about Policies +// (/resource-manager/reference/rest/v1/Policy). `Constraints` have a +// default behavior determined by the `constraint_default` field, which +// is the enforcement behavior that is used in the absence of a `Policy` +// being defined or inherited for the resource in question. type Constraint struct { // BooleanConstraint: Defines this constraint as being a // BooleanConstraint. @@ -1063,7 +1065,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1669,7 +1672,9 @@ type OrgPolicy struct { // Constraint: The name of the `Constraint` the `Policy` is configuring, // for example, `constraints/serviceuser.services`. A list of available - // constraints is available. Immutable after creation. + // constraints + // (/resource-manager/docs/organization-policy/org-policy-constraints) + // is available. Immutable after creation. Constraint string `json:"constraint,omitempty"` // Etag: An opaque tag indicating the current version of the `Policy`, @@ -1833,7 +1838,9 @@ func (s *OrganizationOwner) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1852,7 +1859,7 @@ func (s *OrganizationOwner) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1892,7 +1899,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2250,10 +2258,11 @@ func (s *SetOrgPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2296,7 +2305,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -6552,7 +6562,8 @@ type ProjectsGetIamPolicyCall struct { // exist. Authorization requires the Google IAM permission // `resourcemanager.projects.getIamPolicy` on the project. For // additional information about `resource` (e.g. my-project-id) -// structure and identification, see Resource Names. +// structure and identification, see Resource Names +// (https://cloud.google.com/apis/design/resource_names). func (r *ProjectsService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsGetIamPolicyCall { c := &ProjectsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -7400,7 +7411,8 @@ type ProjectsSetIamPolicyCall struct { // services completely inoperable. It is important to understand how the // service account is being used before removing or updating its roles. // For additional information about `resource` (e.g. my-project-id) -// structure and identification, see Resource Names. The following +// structure and identification, see Resource Names +// (https://cloud.google.com/apis/design/resource_names). The following // constraints apply when using `setIamPolicy()`: + Project does not // support `allUsers` and `allAuthenticatedUsers` as `members` in a // `Binding` of a `Policy`. + The owner role can be granted to a `user`, @@ -7712,8 +7724,9 @@ type ProjectsTestIamPermissionsCall struct { // TestIamPermissions: Returns permissions that a caller has on the // specified Project. For additional information about `resource` (e.g. -// my-project-id) structure and identification, see Resource Names. -// There are no permissions required for making this API call. +// my-project-id) structure and identification, see Resource Names +// (https://cloud.google.com/apis/design/resource_names). There are no +// permissions required for making this API call. func (r *ProjectsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsTestIamPermissionsCall { c := &ProjectsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource diff --git a/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go b/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go index 99df309b9b0..a3d8aa25ce1 100644 --- a/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go @@ -297,7 +297,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -805,7 +806,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1071,7 +1073,9 @@ func (s *OrganizationOwner) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1090,7 +1094,7 @@ func (s *OrganizationOwner) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1130,7 +1134,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1363,7 +1368,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2982,7 +2988,7 @@ type ProjectsGetIamPolicyCall struct { // GetIamPolicy: Returns the IAM access control policy for the specified // Project. Permission is denied if the policy or the resource does not // exist. For additional information about resource structure and -// identification, see Resource Names. +// identification, see Resource Names (/apis/design/resource_names). func (r *ProjectsService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsGetIamPolicyCall { c := &ProjectsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource diff --git a/cloudresourcemanager/v2/cloudresourcemanager-gen.go b/cloudresourcemanager/v2/cloudresourcemanager-gen.go index 6ccbbec6d7c..ca746fcda4b 100644 --- a/cloudresourcemanager/v2/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v2/cloudresourcemanager-gen.go @@ -269,7 +269,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -787,7 +788,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -998,7 +1000,9 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1017,7 +1021,7 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1057,7 +1061,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1254,10 +1259,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1300,7 +1306,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go b/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go index 98d39858b50..9fd5bb8c1ee 100644 --- a/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go @@ -269,7 +269,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -787,7 +788,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -998,7 +1000,9 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1017,7 +1021,7 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1057,7 +1061,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1254,10 +1259,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1300,7 +1306,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/cloudscheduler/v1/cloudscheduler-gen.go b/cloudscheduler/v1/cloudscheduler-gen.go index 0bcc1a92cf6..753affc3b43 100644 --- a/cloudscheduler/v1/cloudscheduler-gen.go +++ b/cloudscheduler/v1/cloudscheduler-gen.go @@ -255,14 +255,22 @@ func (s *AppEngineHttpTarget) MarshalJSON() ([]byte, error) { } // AppEngineRouting: App Engine Routing. For more information about -// services, versions, and instances see An Overview of App Engine, -// Microservices Architecture on Google App Engine, App Engine Standard -// request routing, and App Engine Flex request routing. +// services, versions, and instances see An Overview of App Engine +// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng +// ine), Microservices Architecture on Google App Engine +// (https://cloud.google.com/appengine/docs/python/microservices-on-app-e +// ngine), App Engine Standard request routing +// (https://cloud.google.com/appengine/docs/standard/python/how-requests- +// are-routed), and App Engine Flex request routing +// (https://cloud.google.com/appengine/docs/flexible/python/how-requests- +// are-routed). type AppEngineRouting struct { // Host: Output only. The host that the job is sent to. For more - // information about how App Engine requests are routed, see here. The - // host is constructed as: * `host = [application_domain_name]` `| - // [service] + '.' + [application_domain_name]` `| [version] + '.' + + // information about how App Engine requests are routed, see here + // (https://cloud.google.com/appengine/docs/standard/python/how-requests- + // are-routed). The host is constructed as: * `host = + // [application_domain_name]` `| [service] + '.' + + // [application_domain_name]` `| [version] + '.' + // [application_domain_name]` `| [version_dot_service]+ '.' + // [application_domain_name]` `| [instance] + '.' + // [application_domain_name]` `| [instance_dot_service] + '.' + @@ -288,9 +296,15 @@ type AppEngineRouting struct { // Instance: App instance. By default, the job is sent to an instance // which is available when the job is attempted. Requests can only be // sent to a specific instance if manual scaling is used in App Engine - // Standard. App Engine Flex does not support instances. For more - // information, see App Engine Standard request routing and App Engine - // Flex request routing. + // Standard + // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng + // ine?hl=en_US#scaling_types_and_instance_classes). App Engine Flex + // does not support instances. For more information, see App Engine + // Standard request routing + // (https://cloud.google.com/appengine/docs/standard/python/how-requests- + // are-routed) and App Engine Flex request routing + // (https://cloud.google.com/appengine/docs/flexible/python/how-requests- + // are-routed). Instance string `json:"instance,omitempty"` // Service: App service. By default, the job is sent to the service @@ -376,16 +390,19 @@ type HttpTarget struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` - // OauthToken: If specified, an OAuth token will be generated and - // attached as an `Authorization` header in the HTTP request. This type - // of authorization should generally only be used when calling Google - // APIs hosted on *.googleapis.com. + // OauthToken: If specified, an OAuth token + // (https://developers.google.com/identity/protocols/OAuth2) will be + // generated and attached as an `Authorization` header in the HTTP + // request. This type of authorization should generally only be used + // when calling Google APIs hosted on *.googleapis.com. OauthToken *OAuthToken `json:"oauthToken,omitempty"` - // OidcToken: If specified, an OIDC token will be generated and attached - // as an `Authorization` header in the HTTP request. This type of - // authorization can be used for many scenarios, including calling Cloud - // Run, or endpoints where you intend to validate the token yourself. + // OidcToken: If specified, an OIDC + // (https://developers.google.com/identity/protocols/OpenIDConnect) + // token will be generated and attached as an `Authorization` header in + // the HTTP request. This type of authorization can be used for many + // scenarios, including calling Cloud Run, or endpoints where you intend + // to validate the token yourself. OidcToken *OidcToken `json:"oidcToken,omitempty"` // Uri: Required. The full URI path that the request will be sent to. @@ -451,9 +468,11 @@ type Job struct { // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. * // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see - // Identifying projects * `LOCATION_ID` is the canonical ID for the - // job's location. The list of available locations can be obtained by - // calling ListLocations. For more information, see + // Identifying projects + // (https://cloud.google.com/resource-manager/docs/creating-managing-proj + // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for + // the job's location. The list of available locations can be obtained + // by calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `JOB_ID` can contain // only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores // (_). The maximum length is 500 characters. @@ -467,8 +486,10 @@ type Job struct { // Schedule: Required, except when used with UpdateJob. Describes the // schedule on which the job will be executed. The schedule can be - // either of the following types: * Crontab * English-like schedule As a - // general rule, execution `n + 1` of a job will not begin until + // either of the following types: * Crontab + // (http://en.wikipedia.org/wiki/Cron#Overview) * English-like schedule + // (https://cloud.google.com/scheduler/docs/configuring/cron-job-schedule + // s) As a general rule, execution `n + 1` of a job will not begin until // execution `n` has finished. Cloud Scheduler will never allow two // simultaneously outstanding executions. For example, this implies that // if the `n+1`th execution is scheduled to run at 16:00 but the `n`th @@ -506,11 +527,11 @@ type Job struct { // TimeZone: Specifies the time zone to be used in interpreting // schedule. The value of this field must be a time zone name from the - // tz database. Note that some time zones include a provision for - // daylight savings time. The rules for daylight saving time are - // determined by the chosen tz. For UTC use the string "utc". If a time - // zone is not specified, the default will be in UTC (also known as - // GMT). + // tz database (http://en.wikipedia.org/wiki/Tz_database). Note that + // some time zones include a provision for daylight savings time. The + // rules for daylight saving time are determined by the chosen tz. For + // UTC use the string "utc". If a time zone is not specified, the + // default will be in UTC (also known as GMT). TimeZone string `json:"timeZone,omitempty"` // UserUpdateTime: Output only. The creation time of the job. @@ -670,19 +691,21 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OAuthToken: Contains information needed for generating an OAuth -// token. This type of authorization should generally only be used when -// calling Google APIs hosted on *.googleapis.com. +// OAuthToken: Contains information needed for generating an OAuth token +// (https://developers.google.com/identity/protocols/OAuth2). This type +// of authorization should generally only be used when calling Google +// APIs hosted on *.googleapis.com. type OAuthToken struct { // Scope: OAuth scope to be used for generating OAuth access token. If // not specified, "https://www.googleapis.com/auth/cloud-platform" will // be used. Scope string `json:"scope,omitempty"` - // ServiceAccountEmail: Service account email to be used for generating - // OAuth token. The service account must be within the same project as - // the job. The caller must have iam.serviceAccounts.actAs permission - // for the service account. + // ServiceAccountEmail: Service account email + // (https://cloud.google.com/iam/docs/service-accounts) to be used for + // generating OAuth token. The service account must be within the same + // project as the job. The caller must have iam.serviceAccounts.actAs + // permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Scope") to @@ -709,18 +732,21 @@ func (s *OAuthToken) MarshalJSON() ([]byte, error) { } // OidcToken: Contains information needed for generating an OpenID -// Connect token. This type of authorization can be used for many -// scenarios, including calling Cloud Run, or endpoints where you intend -// to validate the token yourself. +// Connect token +// (https://developers.google.com/identity/protocols/OpenIDConnect). +// This type of authorization can be used for many scenarios, including +// calling Cloud Run, or endpoints where you intend to validate the +// token yourself. type OidcToken struct { // Audience: Audience to be used when generating OIDC token. If not // specified, the URI specified in target will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: Service account email to be used for generating - // OIDC token. The service account must be within the same project as - // the job. The caller must have iam.serviceAccounts.actAs permission - // for the service account. + // ServiceAccountEmail: Service account email + // (https://cloud.google.com/iam/docs/service-accounts) to be used for + // generating OIDC token. The service account must be within the same + // project as the job. The caller must have iam.serviceAccounts.actAs + // permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Audience") to @@ -754,9 +780,11 @@ type PauseJobRequest struct { // by subscribers. The message must contain either a non-empty data // field or at least one attribute. Note that client libraries represent // this object differently depending on the language. See the -// corresponding client library documentation for more information. See -// [quotas and limits] (https://cloud.google.com/pubsub/quotas) for more -// information about message limits. +// corresponding client library documentation +// (https://cloud.google.com/pubsub/docs/reference/libraries) for more +// information. See [quotas and limits] +// (https://cloud.google.com/pubsub/quotas) for more information about +// message limits. type PubsubMessage struct { // Attributes: Attributes for this message. If this field is empty, the // message must contain non-empty data. This can be used to filter @@ -825,9 +853,10 @@ type PubsubTarget struct { // TopicName: Required. The name of the Cloud Pub/Sub topic to which // messages will be published when a job is delivered. The topic name // must be in the same format as required by PubSub's - // PublishRequest.name, for example - // `projects/PROJECT_ID/topics/TOPIC_ID`. The topic must be in the same - // project as the Cloud Scheduler job. + // PublishRequest.name + // (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#p + // ublishrequest), for example `projects/PROJECT_ID/topics/TOPIC_ID`. + // The topic must be in the same project as the Cloud Scheduler job. TopicName string `json:"topicName,omitempty"` // ForceSendFields is a list of field names (e.g. "Attributes") to @@ -936,10 +965,11 @@ type RunJobRequest struct { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/cloudscheduler/v1beta1/cloudscheduler-gen.go b/cloudscheduler/v1beta1/cloudscheduler-gen.go index c40df341033..e806f888981 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-gen.go +++ b/cloudscheduler/v1beta1/cloudscheduler-gen.go @@ -255,14 +255,22 @@ func (s *AppEngineHttpTarget) MarshalJSON() ([]byte, error) { } // AppEngineRouting: App Engine Routing. For more information about -// services, versions, and instances see An Overview of App Engine, -// Microservices Architecture on Google App Engine, App Engine Standard -// request routing, and App Engine Flex request routing. +// services, versions, and instances see An Overview of App Engine +// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng +// ine), Microservices Architecture on Google App Engine +// (https://cloud.google.com/appengine/docs/python/microservices-on-app-e +// ngine), App Engine Standard request routing +// (https://cloud.google.com/appengine/docs/standard/python/how-requests- +// are-routed), and App Engine Flex request routing +// (https://cloud.google.com/appengine/docs/flexible/python/how-requests- +// are-routed). type AppEngineRouting struct { // Host: Output only. The host that the job is sent to. For more - // information about how App Engine requests are routed, see here. The - // host is constructed as: * `host = [application_domain_name]` `| - // [service] + '.' + [application_domain_name]` `| [version] + '.' + + // information about how App Engine requests are routed, see here + // (https://cloud.google.com/appengine/docs/standard/python/how-requests- + // are-routed). The host is constructed as: * `host = + // [application_domain_name]` `| [service] + '.' + + // [application_domain_name]` `| [version] + '.' + // [application_domain_name]` `| [version_dot_service]+ '.' + // [application_domain_name]` `| [instance] + '.' + // [application_domain_name]` `| [instance_dot_service] + '.' + @@ -288,9 +296,15 @@ type AppEngineRouting struct { // Instance: App instance. By default, the job is sent to an instance // which is available when the job is attempted. Requests can only be // sent to a specific instance if manual scaling is used in App Engine - // Standard. App Engine Flex does not support instances. For more - // information, see App Engine Standard request routing and App Engine - // Flex request routing. + // Standard + // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng + // ine?hl=en_US#scaling_types_and_instance_classes). App Engine Flex + // does not support instances. For more information, see App Engine + // Standard request routing + // (https://cloud.google.com/appengine/docs/standard/python/how-requests- + // are-routed) and App Engine Flex request routing + // (https://cloud.google.com/appengine/docs/flexible/python/how-requests- + // are-routed). Instance string `json:"instance,omitempty"` // Service: App service. By default, the job is sent to the service @@ -376,16 +390,19 @@ type HttpTarget struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` - // OauthToken: If specified, an OAuth token will be generated and - // attached as an `Authorization` header in the HTTP request. This type - // of authorization should generally only be used when calling Google - // APIs hosted on *.googleapis.com. + // OauthToken: If specified, an OAuth token + // (https://developers.google.com/identity/protocols/OAuth2) will be + // generated and attached as an `Authorization` header in the HTTP + // request. This type of authorization should generally only be used + // when calling Google APIs hosted on *.googleapis.com. OauthToken *OAuthToken `json:"oauthToken,omitempty"` - // OidcToken: If specified, an OIDC token will be generated and attached - // as an `Authorization` header in the HTTP request. This type of - // authorization can be used for many scenarios, including calling Cloud - // Run, or endpoints where you intend to validate the token yourself. + // OidcToken: If specified, an OIDC + // (https://developers.google.com/identity/protocols/OpenIDConnect) + // token will be generated and attached as an `Authorization` header in + // the HTTP request. This type of authorization can be used for many + // scenarios, including calling Cloud Run, or endpoints where you intend + // to validate the token yourself. OidcToken *OidcToken `json:"oidcToken,omitempty"` // Uri: Required. The full URI path that the request will be sent to. @@ -458,9 +475,11 @@ type Job struct { // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. * // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see - // Identifying projects * `LOCATION_ID` is the canonical ID for the - // job's location. The list of available locations can be obtained by - // calling ListLocations. For more information, see + // Identifying projects + // (https://cloud.google.com/resource-manager/docs/creating-managing-proj + // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for + // the job's location. The list of available locations can be obtained + // by calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `JOB_ID` can contain // only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores // (_). The maximum length is 500 characters. @@ -474,8 +493,10 @@ type Job struct { // Schedule: Required, except when used with UpdateJob. Describes the // schedule on which the job will be executed. The schedule can be - // either of the following types: * Crontab * English-like schedule As a - // general rule, execution `n + 1` of a job will not begin until + // either of the following types: * Crontab + // (http://en.wikipedia.org/wiki/Cron#Overview) * English-like schedule + // (https://cloud.google.com/scheduler/docs/configuring/cron-job-schedule + // s) As a general rule, execution `n + 1` of a job will not begin until // execution `n` has finished. Cloud Scheduler will never allow two // simultaneously outstanding executions. For example, this implies that // if the `n+1`th execution is scheduled to run at 16:00 but the `n`th @@ -513,11 +534,11 @@ type Job struct { // TimeZone: Specifies the time zone to be used in interpreting // schedule. The value of this field must be a time zone name from the - // tz database. Note that some time zones include a provision for - // daylight savings time. The rules for daylight saving time are - // determined by the chosen tz. For UTC use the string "utc". If a time - // zone is not specified, the default will be in UTC (also known as - // GMT). + // tz database (http://en.wikipedia.org/wiki/Tz_database). Note that + // some time zones include a provision for daylight savings time. The + // rules for daylight saving time are determined by the chosen tz. For + // UTC use the string "utc". If a time zone is not specified, the + // default will be in UTC (also known as GMT). TimeZone string `json:"timeZone,omitempty"` // UserUpdateTime: Output only. The creation time of the job. @@ -677,19 +698,21 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OAuthToken: Contains information needed for generating an OAuth -// token. This type of authorization should generally only be used when -// calling Google APIs hosted on *.googleapis.com. +// OAuthToken: Contains information needed for generating an OAuth token +// (https://developers.google.com/identity/protocols/OAuth2). This type +// of authorization should generally only be used when calling Google +// APIs hosted on *.googleapis.com. type OAuthToken struct { // Scope: OAuth scope to be used for generating OAuth access token. If // not specified, "https://www.googleapis.com/auth/cloud-platform" will // be used. Scope string `json:"scope,omitempty"` - // ServiceAccountEmail: Service account email to be used for generating - // OAuth token. The service account must be within the same project as - // the job. The caller must have iam.serviceAccounts.actAs permission - // for the service account. + // ServiceAccountEmail: Service account email + // (https://cloud.google.com/iam/docs/service-accounts) to be used for + // generating OAuth token. The service account must be within the same + // project as the job. The caller must have iam.serviceAccounts.actAs + // permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Scope") to @@ -716,18 +739,21 @@ func (s *OAuthToken) MarshalJSON() ([]byte, error) { } // OidcToken: Contains information needed for generating an OpenID -// Connect token. This type of authorization can be used for many -// scenarios, including calling Cloud Run, or endpoints where you intend -// to validate the token yourself. +// Connect token +// (https://developers.google.com/identity/protocols/OpenIDConnect). +// This type of authorization can be used for many scenarios, including +// calling Cloud Run, or endpoints where you intend to validate the +// token yourself. type OidcToken struct { // Audience: Audience to be used when generating OIDC token. If not // specified, the URI specified in target will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: Service account email to be used for generating - // OIDC token. The service account must be within the same project as - // the job. The caller must have iam.serviceAccounts.actAs permission - // for the service account. + // ServiceAccountEmail: Service account email + // (https://cloud.google.com/iam/docs/service-accounts) to be used for + // generating OIDC token. The service account must be within the same + // project as the job. The caller must have iam.serviceAccounts.actAs + // permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Audience") to @@ -761,9 +787,11 @@ type PauseJobRequest struct { // by subscribers. The message must contain either a non-empty data // field or at least one attribute. Note that client libraries represent // this object differently depending on the language. See the -// corresponding client library documentation for more information. See -// [quotas and limits] (https://cloud.google.com/pubsub/quotas) for more -// information about message limits. +// corresponding client library documentation +// (https://cloud.google.com/pubsub/docs/reference/libraries) for more +// information. See [quotas and limits] +// (https://cloud.google.com/pubsub/quotas) for more information about +// message limits. type PubsubMessage struct { // Attributes: Attributes for this message. If this field is empty, the // message must contain non-empty data. This can be used to filter @@ -832,9 +860,10 @@ type PubsubTarget struct { // TopicName: Required. The name of the Cloud Pub/Sub topic to which // messages will be published when a job is delivered. The topic name // must be in the same format as required by PubSub's - // PublishRequest.name, for example - // `projects/PROJECT_ID/topics/TOPIC_ID`. The topic must be in the same - // project as the Cloud Scheduler job. + // PublishRequest.name + // (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#p + // ublishrequest), for example `projects/PROJECT_ID/topics/TOPIC_ID`. + // The topic must be in the same project as the Cloud Scheduler job. TopicName string `json:"topicName,omitempty"` // ForceSendFields is a list of field names (e.g. "Attributes") to @@ -971,10 +1000,11 @@ func (s *RunJobRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/cloudsearch/v1/cloudsearch-gen.go b/cloudsearch/v1/cloudsearch-gen.go index 5773b0317f5..d3194924dd6 100644 --- a/cloudsearch/v1/cloudsearch-gen.go +++ b/cloudsearch/v1/cloudsearch-gen.go @@ -916,8 +916,9 @@ func (s *DataSourceRestriction) MarshalJSON() ([]byte, error) { // Date: Represents a whole calendar date, for example a date of birth. // The time of day and time zone are either specified elsewhere or are // not significant. The date is relative to the Proleptic Gregorian -// Calendar. The date must be a valid calendar date between the year 1 -// and 9999. +// Calendar +// (https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar). The +// date must be a valid calendar date between the year 1 and 9999. type Date struct { // Day: Day of month. Must be from 1 to 31 and valid for the year and // month. @@ -2670,7 +2671,7 @@ func (s *Item) MarshalJSON() ([]byte, error) { } // ItemAcl: Access control list information for the item. For more -// information see Map ACLs. +// information see Map ACLs (/cloud-search/docs/guides/acls). type ItemAcl struct { // AclInheritanceType: Sets the type of access rules to apply when an // item inherits its ACL from a parent. This should always be set in @@ -4586,15 +4587,17 @@ type RequestOptions struct { LanguageCode string `json:"languageCode,omitempty"` // SearchApplicationId: The ID generated when you create a search - // application using the admin console. + // application using the admin console + // (https://support.google.com/a/answer/9043922). SearchApplicationId string `json:"searchApplicationId,omitempty"` // TimeZone: Current user's time zone id, such as "America/Los_Angeles" // or "Australia/Sydney". These IDs are defined by Unicode Common Locale - // Data Repository (CLDR) project, and currently available in the file - // timezone.xml. This field is used to correctly interpret date and time - // queries. If this field is not specified, the default time zone (UTC) - // is used. + // Data Repository (CLDR) (http://cldr.unicode.org/) project, and + // currently available in the file timezone.xml + // (http://unicode.org/repos/cldr/trunk/common/bcp47/timezone.xml). This + // field is used to correctly interpret date and time queries. If this + // field is not specified, the default time zone (UTC) is used. TimeZone string `json:"timeZone,omitempty"` // ForceSendFields is a list of field names (e.g. "DebugOptions") to @@ -5278,6 +5281,7 @@ type SearchRequest struct { // Query: The raw query string. See supported search operators in the // Cloud search Cheat Sheet + // (https://support.google.com/a/users/answer/9299929) Query string `json:"query,omitempty"` // QueryInterpretationOptions: Options to interpret the user query. @@ -5759,10 +5763,11 @@ func (s *StartUploadItemRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -9430,15 +9435,20 @@ type MediaUploadCall struct { // Upload: Uploads media for indexing. The upload endpoint supports // direct and resumable upload protocols and is intended for large items -// that can not be inlined during index requests. To index large -// content: 1. Call indexing.datasources.items.upload with the item name -// to begin an upload session and retrieve the UploadItemRef. 1. Call -// media.upload to upload the content, as a streaming request, using the -// same resource name from the UploadItemRef from step 1. 1. Call +// that can not be inlined during index requests +// (https://developers.google.com/cloud-search/docs/reference/rest/v1/ind +// exing.datasources.items#itemcontent). To index large content: 1. Call +// indexing.datasources.items.upload with the item name to begin an +// upload session and retrieve the UploadItemRef. 1. Call media.upload +// to upload the content, as a streaming request, using the same +// resource name from the UploadItemRef from step 1. 1. Call // indexing.datasources.items.index to index the item. Populate the -// ItemContent with the UploadItemRef from step 1. For additional -// information, see Create a content connector using the REST API. -// **Note:** This API requires a service account to execute. +// ItemContent +// (/cloud-search/docs/reference/rest/v1/indexing.datasources.items#ItemC +// ontent) with the UploadItemRef from step 1. For additional +// information, see Create a content connector using the REST API +// (https://developers.google.com/cloud-search/docs/guides/content-connec +// tor#rest). **Note:** This API requires a service account to execute. func (r *MediaService) Upload(resourceName string, media *Media) *MediaUploadCall { c := &MediaUploadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resourceName = resourceName @@ -10031,7 +10041,8 @@ type QuerySearchCall struct { // This API requires a standard end user account to execute. A service // account can't perform Query API requests directly; to use a service // account to perform queries, set up G Suite domain-wide delegation of -// authority. +// authority +// (https://developers.google.com/cloud-search/docs/guides/delegation/). func (r *QueryService) Search(searchrequest *SearchRequest) *QuerySearchCall { c := &QuerySearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.searchrequest = searchrequest @@ -10161,7 +10172,8 @@ type QuerySuggestCall struct { // This API requires a standard end user account to execute. A service // account can't perform Query API requests directly; to use a service // account to perform queries, set up G Suite domain-wide delegation of -// authority. +// authority +// (https://developers.google.com/cloud-search/docs/guides/delegation/). func (r *QueryService) Suggest(suggestrequest *SuggestRequest) *QuerySuggestCall { c := &QuerySuggestCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.suggestrequest = suggestrequest @@ -10291,7 +10303,8 @@ type QuerySourcesListCall struct { // Suggest APIs. **Note:** This API requires a standard end user account // to execute. A service account can't perform Query API requests // directly; to use a service account to perform queries, set up G Suite -// domain-wide delegation of authority. +// domain-wide delegation of authority +// (https://developers.google.com/cloud-search/docs/guides/delegation/). func (r *QuerySourcesService) List() *QuerySourcesListCall { c := &QuerySourcesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -10330,7 +10343,8 @@ func (c *QuerySourcesListCall) RequestOptionsLanguageCode(requestOptionsLanguage // RequestOptionsSearchApplicationId sets the optional parameter // "requestOptions.searchApplicationId": The ID generated when you -// create a search application using the admin console. +// create a search application using the admin console +// (https://support.google.com/a/answer/9043922). func (c *QuerySourcesListCall) RequestOptionsSearchApplicationId(requestOptionsSearchApplicationId string) *QuerySourcesListCall { c.urlParams_.Set("requestOptions.searchApplicationId", requestOptionsSearchApplicationId) return c @@ -10339,10 +10353,12 @@ func (c *QuerySourcesListCall) RequestOptionsSearchApplicationId(requestOptionsS // RequestOptionsTimeZone sets the optional parameter // "requestOptions.timeZone": Current user's time zone id, such as // "America/Los_Angeles" or "Australia/Sydney". These IDs are defined by -// Unicode Common Locale Data Repository (CLDR) project, and currently -// available in the file timezone.xml. This field is used to correctly -// interpret date and time queries. If this field is not specified, the -// default time zone (UTC) is used. +// Unicode Common Locale Data Repository (CLDR) +// (http://cldr.unicode.org/) project, and currently available in the +// file timezone.xml +// (http://unicode.org/repos/cldr/trunk/common/bcp47/timezone.xml). This +// field is used to correctly interpret date and time queries. If this +// field is not specified, the default time zone (UTC) is used. func (c *QuerySourcesListCall) RequestOptionsTimeZone(requestOptionsTimeZone string) *QuerySourcesListCall { c.urlParams_.Set("requestOptions.timeZone", requestOptionsTimeZone) return c diff --git a/cloudshell/v1/cloudshell-gen.go b/cloudshell/v1/cloudshell-gen.go index 69413618044..41e4675e817 100644 --- a/cloudshell/v1/cloudshell-gen.go +++ b/cloudshell/v1/cloudshell-gen.go @@ -643,10 +643,11 @@ func (s *StartEnvironmentResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/cloudshell/v1alpha1/cloudshell-gen.go b/cloudshell/v1alpha1/cloudshell-gen.go index 811dc1da1f2..b800458546f 100644 --- a/cloudshell/v1alpha1/cloudshell-gen.go +++ b/cloudshell/v1alpha1/cloudshell-gen.go @@ -586,10 +586,11 @@ func (s *StartEnvironmentResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/cloudtasks/v2/cloudtasks-gen.go b/cloudtasks/v2/cloudtasks-gen.go index de0490d462b..e300a6925e3 100644 --- a/cloudtasks/v2/cloudtasks-gen.go +++ b/cloudtasks/v2/cloudtasks-gen.go @@ -185,26 +185,32 @@ type ProjectsLocationsQueuesTasksService struct { // AppEngineHttpRequest: App Engine HTTP request. The message defines // the HTTP request that is sent to an App Engine app when the task is // dispatched. Using AppEngineHttpRequest requires -// `appengine.applications.get` Google IAM permission for the project -// and the following scope: +// `appengine.applications.get` +// (https://cloud.google.com/appengine/docs/admin-api/access-control) +// Google IAM permission for the project and the following scope: // `https://www.googleapis.com/auth/cloud-platform` The task will be // delivered to the App Engine app which belongs to the same project as -// the queue. For more information, see How Requests are Routed and how -// routing is affected by dispatch files. Traffic is encrypted during -// transport and never leaves Google datacenters. Because this traffic -// is carried over a communication mechanism internal to Google, you -// cannot explicitly set the protocol (for example, HTTP or HTTPS). The -// request to the handler, however, will appear to have used the HTTP -// protocol. The AppEngineRouting used to construct the URL that the -// task is delivered to can be set at the queue-level or task-level: * -// If app_engine_routing_override is set on the queue, this value is -// used for all tasks in the queue, no matter what the setting is for -// the task-level app_engine_routing. The `url` that the task will be -// sent to is: * `url =` host `+` relative_uri Tasks can be dispatched -// to secure app handlers, unsecure app handlers, and URIs restricted -// with `login: admin`. Because tasks are not run as any user, they -// cannot be dispatched to URIs restricted with `login: required` Task -// dispatches also do not follow redirects. The task attempt has +// the queue. For more information, see How Requests are Routed +// (https://cloud.google.com/appengine/docs/standard/python/how-requests- +// are-routed) and how routing is affected by dispatch files +// (https://cloud.google.com/appengine/docs/python/config/dispatchref). +// Traffic is encrypted during transport and never leaves Google +// datacenters. Because this traffic is carried over a communication +// mechanism internal to Google, you cannot explicitly set the protocol +// (for example, HTTP or HTTPS). The request to the handler, however, +// will appear to have used the HTTP protocol. The AppEngineRouting used +// to construct the URL that the task is delivered to can be set at the +// queue-level or task-level: * If app_engine_routing_override is set on +// the queue, this value is used for all tasks in the queue, no matter +// what the setting is for the task-level app_engine_routing. The `url` +// that the task will be sent to is: * `url =` host `+` relative_uri +// Tasks can be dispatched to secure app handlers, unsecure app +// handlers, and URIs restricted with `login: admin` +// (https://cloud.google.com/appengine/docs/standard/python/config/appref +// ). Because tasks are not run as any user, they cannot be dispatched +// to URIs restricted with `login: required` +// (https://cloud.google.com/appengine/docs/standard/python/config/appref +// ) Task dispatches also do not follow redirects. The task attempt has // succeeded if the app's request handler returns an HTTP response code // in the range [`200` - `299`]. The task attempt has failed if the // app's handler returns a non-2xx response code or Cloud Tasks does not @@ -245,8 +251,10 @@ type AppEngineHttpRequest struct { // below cannot be set or overridden: * `Host` * `X-Google-*` * // `X-AppEngine-*` In addition, Cloud Tasks sets some headers when the // task is dispatched, such as headers containing information about the - // task; see request headers. These headers are set only when the task - // is dispatched, so they are not visible when the task is returned in a + // task; see request headers + // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#readi + // ng_request_headers). These headers are set only when the task is + // dispatched, so they are not visible when the task is returned in a // Cloud Tasks response. Although there is no specific limit for the // maximum number of headers or the size, there is a limit on the // maximum size of the Task. For more information, see the CreateTask @@ -257,8 +265,12 @@ type AppEngineHttpRequest struct { // POST. The app's request handler for the task's target URL must be // able to handle HTTP requests with this http_method, otherwise the // task attempt fails with error code 405 (Method Not Allowed). See - // Writing a push task request handler and the App Engine documentation - // for your runtime on How Requests are Handled. + // Writing a push task request handler + // (https://cloud.google.com/appengine/docs/java/taskqueue/push/creating- + // handlers#writing_a_push_task_request_handler) and the App Engine + // documentation for your runtime on How Requests are Handled + // (https://cloud.google.com/appengine/docs/standard/python3/how-requests + // -are-handled). // // Possible values: // "HTTP_METHOD_UNSPECIFIED" - HTTP method unspecified @@ -305,10 +317,18 @@ func (s *AppEngineHttpRequest) MarshalJSON() ([]byte, error) { // AppEngineRouting: App Engine Routing. Defines routing characteristics // specific to App Engine - service, version, and instance. For more // information about services, versions, and instances see An Overview -// of App Engine, Microservices Architecture on Google App Engine, App -// Engine Standard request routing, and App Engine Flex request routing. -// Using AppEngineRouting requires `appengine.applications.get` Google -// IAM permission for the project and the following scope: +// of App Engine +// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng +// ine), Microservices Architecture on Google App Engine +// (https://cloud.google.com/appengine/docs/python/microservices-on-app-e +// ngine), App Engine Standard request routing +// (https://cloud.google.com/appengine/docs/standard/python/how-requests- +// are-routed), and App Engine Flex request routing +// (https://cloud.google.com/appengine/docs/flexible/python/how-requests- +// are-routed). Using AppEngineRouting requires +// `appengine.applications.get` +// (https://cloud.google.com/appengine/docs/admin-api/access-control) +// Google IAM permission for the project and the following scope: // `https://www.googleapis.com/auth/cloud-platform` type AppEngineRouting struct { // Host: Output only. The host that the task is sent to. The host is @@ -316,15 +336,23 @@ type AppEngineRouting struct { // queue's project ID (for example .appspot.com), and the service, // version, and instance. Tasks which were created using the App Engine // SDK might have a custom domain name. For more information, see How - // Requests are Routed. + // Requests are Routed + // (https://cloud.google.com/appengine/docs/standard/python/how-requests- + // are-routed). Host string `json:"host,omitempty"` // Instance: App instance. By default, the task is sent to an instance // which is available when the task is attempted. Requests can only be // sent to a specific instance if manual scaling is used in App Engine - // Standard. App Engine Flex does not support instances. For more - // information, see App Engine Standard request routing and App Engine - // Flex request routing. + // Standard + // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng + // ine?hl=en_US#scaling_types_and_instance_classes). App Engine Flex + // does not support instances. For more information, see App Engine + // Standard request routing + // (https://cloud.google.com/appengine/docs/standard/python/how-requests- + // are-routed) and App Engine Flex request routing + // (https://cloud.google.com/appengine/docs/flexible/python/how-requests- + // are-routed). Instance string `json:"instance,omitempty"` // Service: App service. By default, the task is sent to the service @@ -422,7 +450,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -494,7 +523,8 @@ type CreateTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // Google IAM permission on the Task resource. + // Google IAM (https://cloud.google.com/iam/) permission on the Task + // resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -666,7 +696,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -751,16 +782,19 @@ type HttpRequest struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` - // OauthToken: If specified, an OAuth token will be generated and - // attached as an `Authorization` header in the HTTP request. This type - // of authorization should generally only be used when calling Google - // APIs hosted on *.googleapis.com. + // OauthToken: If specified, an OAuth token + // (https://developers.google.com/identity/protocols/OAuth2) will be + // generated and attached as an `Authorization` header in the HTTP + // request. This type of authorization should generally only be used + // when calling Google APIs hosted on *.googleapis.com. OauthToken *OAuthToken `json:"oauthToken,omitempty"` - // OidcToken: If specified, an OIDC token will be generated and attached - // as an `Authorization` header in the HTTP request. This type of - // authorization can be used for many scenarios, including calling Cloud - // Run, or endpoints where you intend to validate the token yourself. + // OidcToken: If specified, an OIDC + // (https://developers.google.com/identity/protocols/OpenIDConnect) + // token will be generated and attached as an `Authorization` header in + // the HTTP request. This type of authorization can be used for many + // scenarios, including calling Cloud Run, or endpoints where you intend + // to validate the token yourself. OidcToken *OidcToken `json:"oidcToken,omitempty"` // Url: Required. The full url path that the request will be sent to. @@ -959,19 +993,21 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OAuthToken: Contains information needed for generating an OAuth -// token. This type of authorization should generally only be used when -// calling Google APIs hosted on *.googleapis.com. +// OAuthToken: Contains information needed for generating an OAuth token +// (https://developers.google.com/identity/protocols/OAuth2). This type +// of authorization should generally only be used when calling Google +// APIs hosted on *.googleapis.com. type OAuthToken struct { // Scope: OAuth scope to be used for generating OAuth access token. If // not specified, "https://www.googleapis.com/auth/cloud-platform" will // be used. Scope string `json:"scope,omitempty"` - // ServiceAccountEmail: Service account email to be used for generating - // OAuth token. The service account must be within the same project as - // the queue. The caller must have iam.serviceAccounts.actAs permission - // for the service account. + // ServiceAccountEmail: Service account email + // (https://cloud.google.com/iam/docs/service-accounts) to be used for + // generating OAuth token. The service account must be within the same + // project as the queue. The caller must have iam.serviceAccounts.actAs + // permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Scope") to @@ -998,18 +1034,21 @@ func (s *OAuthToken) MarshalJSON() ([]byte, error) { } // OidcToken: Contains information needed for generating an OpenID -// Connect token. This type of authorization can be used for many -// scenarios, including calling Cloud Run, or endpoints where you intend -// to validate the token yourself. +// Connect token +// (https://developers.google.com/identity/protocols/OpenIDConnect). +// This type of authorization can be used for many scenarios, including +// calling Cloud Run, or endpoints where you intend to validate the +// token yourself. type OidcToken struct { // Audience: Audience to be used when generating OIDC token. If not // specified, the URI specified in target will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: Service account email to be used for generating - // OIDC token. The service account must be within the same project as - // the queue. The caller must have iam.serviceAccounts.actAs permission - // for the service account. + // ServiceAccountEmail: Service account email + // (https://cloud.google.com/iam/docs/service-accounts) to be used for + // generating OIDC token. The service account must be within the same + // project as the queue. The caller must have iam.serviceAccounts.actAs + // permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Audience") to @@ -1051,7 +1090,9 @@ type PauseQueueRequest struct { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1070,7 +1111,7 @@ type PauseQueueRequest struct { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1106,7 +1147,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1158,9 +1200,11 @@ type Queue struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` * // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see - // Identifying projects * `LOCATION_ID` is the canonical ID for the - // queue's location. The list of available locations can be obtained by - // calling ListLocations. For more information, see + // Identifying projects + // (https://cloud.google.com/resource-manager/docs/creating-managing-proj + // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for + // the queue's location. The list of available locations can be obtained + // by calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. @@ -1169,8 +1213,11 @@ type Queue struct { // PurgeTime: Output only. The last time this queue was purged. All // tasks that were created before this time were purged. A queue can be // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud - // Console. Purge time will be truncated to the nearest microsecond. - // Purge time will be unset if the queue has never been purged. + // Console + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus + // h/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). Purge + // time will be truncated to the nearest microsecond. Purge time will be + // unset if the queue has never been purged. PurgeTime string `json:"purgeTime,omitempty"` // RateLimits: Rate limits for task dispatches. rate_limits and @@ -1196,17 +1243,21 @@ type Queue struct { // the App Engine SDK: the queue-level retry settings apply to all tasks // in the queue which do not have retry settings explicitly set on the // task and were created by the App Engine SDK. See App Engine - // documentation. + // documentation + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus + // h/retrying-tasks). RetryConfig *RetryConfig `json:"retryConfig,omitempty"` // StackdriverLoggingConfig: Configuration options for writing logs to - // Stackdriver Logging. If this field is unset, then no logs are - // written. + // Stackdriver Logging (https://cloud.google.com/logging/docs/). If this + // field is unset, then no logs are written. StackdriverLoggingConfig *StackdriverLoggingConfig `json:"stackdriverLoggingConfig,omitempty"` // State: Output only. The state of the queue. `state` can only be // changed by called PauseQueue, ResumeQueue, or uploading - // queue.yaml/xml. UpdateQueue cannot be used to change `state`. + // queue.yaml/xml + // (https://cloud.google.com/appengine/docs/python/config/queueref). + // UpdateQueue cannot be used to change `state`. // // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -1269,19 +1320,22 @@ type RateLimits struct { // queue and the rate is high. This field allows the queue to have a // high rate so processing starts shortly after a task is enqueued, but // still limits resource usage when many tasks are enqueued in a short - // period of time. The token bucket algorithm is used to control the - // rate of task dispatches. Each queue has a token bucket that holds - // tokens, up to the maximum specified by `max_burst_size`. Each time a - // task is dispatched, a token is removed from the bucket. Tasks will be - // dispatched until the queue's bucket runs out of tokens. The bucket - // will be continuously refilled with new tokens based on + // period of time. The token bucket + // (https://wikipedia.org/wiki/Token_Bucket) algorithm is used to + // control the rate of task dispatches. Each queue has a token bucket + // that holds tokens, up to the maximum specified by `max_burst_size`. + // Each time a task is dispatched, a token is removed from the bucket. + // Tasks will be dispatched until the queue's bucket runs out of tokens. + // The bucket will be continuously refilled with new tokens based on // max_dispatches_per_second. Cloud Tasks will pick the value of // `max_burst_size` based on the value of max_dispatches_per_second. For // queues that were created or updated using `queue.yaml/xml`, - // `max_burst_size` is equal to bucket_size. Since `max_burst_size` is - // output only, if UpdateQueue is called on a queue created by - // `queue.yaml/xml`, `max_burst_size` will be reset based on the value - // of max_dispatches_per_second, regardless of whether + // `max_burst_size` is equal to bucket_size + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#bucket_size). Since `max_burst_size` is output only, if + // UpdateQueue is called on a queue created by `queue.yaml/xml`, + // `max_burst_size` will be reset based on the value of + // max_dispatches_per_second, regardless of whether // max_dispatches_per_second is updated. MaxBurstSize int64 `json:"maxBurstSize,omitempty"` @@ -1291,13 +1345,17 @@ type RateLimits struct { // the number of concurrent requests decreases. If unspecified when the // queue is created, Cloud Tasks will pick the default. The maximum // allowed value is 5,000. This field has the same meaning as - // max_concurrent_requests in queue.yaml/xml. + // max_concurrent_requests in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#max_concurrent_requests). MaxConcurrentDispatches int64 `json:"maxConcurrentDispatches,omitempty"` // MaxDispatchesPerSecond: The maximum rate at which tasks are // dispatched from this queue. If unspecified when the queue is created, // Cloud Tasks will pick the default. * The maximum allowed value is - // 500. This field has the same meaning as rate in queue.yaml/xml. + // 500. This field has the same meaning as rate in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#rate). MaxDispatchesPerSecond float64 `json:"maxDispatchesPerSecond,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxBurstSize") to @@ -1349,7 +1407,9 @@ type RetryConfig struct { // then there will be `max_attempts - 1` retries). Must be >= -1. If // unspecified when the queue is created, Cloud Tasks will pick the // default. -1 indicates unlimited attempts. This field has the same - // meaning as task_retry_limit in queue.yaml/xml. + // meaning as task_retry_limit in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxAttempts int64 `json:"maxAttempts,omitempty"` // MaxBackoff: A task will be scheduled for retry between min_backoff @@ -1357,7 +1417,9 @@ type RetryConfig struct { // specifies that the task should be retried. If unspecified when the // queue is created, Cloud Tasks will pick the default. `max_backoff` // will be truncated to the nearest second. This field has the same - // meaning as max_backoff_seconds in queue.yaml/xml. + // meaning as max_backoff_seconds in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxBackoff string `json:"maxBackoff,omitempty"` // MaxDoublings: The time between retries will double `max_doublings` @@ -1371,7 +1433,9 @@ type RetryConfig struct { // been attempted max_attempts times. Thus, the requests will retry at // 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, .... If unspecified when // the queue is created, Cloud Tasks will pick the default. This field - // has the same meaning as max_doublings in queue.yaml/xml. + // has the same meaning as max_doublings in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxDoublings int64 `json:"maxDoublings,omitempty"` // MaxRetryDuration: If positive, `max_retry_duration` specifies the @@ -1382,7 +1446,9 @@ type RetryConfig struct { // is unlimited. If unspecified when the queue is created, Cloud Tasks // will pick the default. `max_retry_duration` will be truncated to the // nearest second. This field has the same meaning as task_age_limit in - // queue.yaml/xml. + // queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxRetryDuration string `json:"maxRetryDuration,omitempty"` // MinBackoff: A task will be scheduled for retry between min_backoff @@ -1390,7 +1456,9 @@ type RetryConfig struct { // specifies that the task should be retried. If unspecified when the // queue is created, Cloud Tasks will pick the default. `min_backoff` // will be truncated to the nearest second. This field has the same - // meaning as min_backoff_seconds in queue.yaml/xml. + // meaning as min_backoff_seconds in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MinBackoff string `json:"minBackoff,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxAttempts") to @@ -1425,7 +1493,8 @@ type RunTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // Google IAM permission on the Task resource. + // Google IAM (https://cloud.google.com/iam/) permission on the Task + // resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -1494,12 +1563,12 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { } // StackdriverLoggingConfig: Configuration options for writing logs to -// Stackdriver Logging. +// Stackdriver Logging (https://cloud.google.com/logging/docs/). type StackdriverLoggingConfig struct { // SamplingRatio: Specifies the fraction of operations to write to - // Stackdriver Logging. This field may contain any value between 0.0 and - // 1.0, inclusive. 0.0 is the default and means that no operations are - // logged. + // Stackdriver Logging (https://cloud.google.com/logging/docs/). This + // field may contain any value between 0.0 and 1.0, inclusive. 0.0 is + // the default and means that no operations are logged. SamplingRatio float64 `json:"samplingRatio,omitempty"` // ForceSendFields is a list of field names (e.g. "SamplingRatio") to @@ -1541,10 +1610,11 @@ func (s *StackdriverLoggingConfig) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1609,17 +1679,20 @@ type Task struct { // of request: * For HTTP tasks, the default is 10 minutes. The deadline // must be in the interval [15 seconds, 30 minutes]. * For App Engine // tasks, 0 indicates that the request has the default deadline. The - // default deadline depends on the scaling type of the service: 10 - // minutes for standard apps with automatic scaling, 24 hours for - // standard apps with manual and basic scaling, and 60 minutes for flex - // apps. If the request deadline is set, it must be in the interval [15 - // seconds, 24 hours 15 seconds]. Regardless of the task's - // `dispatch_deadline`, the app handler will not run for longer than - // than the service's timeout. We recommend setting the - // `dispatch_deadline` to at most a few seconds more than the app - // handler's timeout. For more information see Timeouts. - // `dispatch_deadline` will be truncated to the nearest millisecond. The - // deadline is an approximate deadline. + // default deadline depends on the scaling type + // (https://cloud.google.com/appengine/docs/standard/go/how-instances-are + // -managed#instance_scaling) of the service: 10 minutes for standard + // apps with automatic scaling, 24 hours for standard apps with manual + // and basic scaling, and 60 minutes for flex apps. If the request + // deadline is set, it must be in the interval [15 seconds, 24 hours 15 + // seconds]. Regardless of the task's `dispatch_deadline`, the app + // handler will not run for longer than than the service's timeout. We + // recommend setting the `dispatch_deadline` to at most a few seconds + // more than the app handler's timeout. For more information see + // Timeouts + // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeo + // uts). `dispatch_deadline` will be truncated to the nearest + // millisecond. The deadline is an approximate deadline. DispatchDeadline string `json:"dispatchDeadline,omitempty"` // FirstAttempt: Output only. The status of the task's first attempt. @@ -1639,9 +1712,11 @@ type Task struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ // ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), // hyphens (-), colons (:), or periods (.). For more information, see - // Identifying projects * `LOCATION_ID` is the canonical ID for the - // task's location. The list of available locations can be obtained by - // calling ListLocations. For more information, see + // Identifying projects + // (https://cloud.google.com/resource-manager/docs/creating-managing-proj + // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for + // the task's location. The list of available locations can be obtained + // by calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. * `TASK_ID` can contain only letters @@ -1707,7 +1782,8 @@ func (s *Task) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2130,8 +2206,9 @@ type ProjectsLocationsQueuesCreateCall struct { // task will be deleted regardless of whether it was dispatched or not. // WARNING: Using this method may have unintended side effects if you // are using an App Engine `queue.yaml` or `queue.xml` file to manage -// your queues. Read Overview of Queue Management and queue.yaml before -// using this method. +// your queues. Read Overview of Queue Management and queue.yaml +// (https://cloud.google.com/tasks/docs/queue-yaml) before using this +// method. func (r *ProjectsLocationsQueuesService) Create(parent string, queue *Queue) *ProjectsLocationsQueuesCreateCall { c := &ProjectsLocationsQueuesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -2275,7 +2352,9 @@ type ProjectsLocationsQueuesDeleteCall struct { // same name can't be created for 7 days. WARNING: Using this method may // have unintended side effects if you are using an App Engine // `queue.yaml` or `queue.xml` file to manage your queues. Read Overview -// of Queue Management and queue.yaml before using this method. +// of Queue Management and queue.yaml +// (https://cloud.google.com/tasks/docs/queue-yaml) before using this +// method. func (r *ProjectsLocationsQueuesService) Delete(name string) *ProjectsLocationsQueuesDeleteCall { c := &ProjectsLocationsQueuesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2552,8 +2631,9 @@ type ProjectsLocationsQueuesGetIamPolicyCall struct { // GetIamPolicy: Gets the access control policy for a Queue. Returns an // empty policy if the resource exists and does not have a policy set. -// Authorization requires the following Google IAM permission on the -// specified resource parent: * `cloudtasks.queues.getIamPolicy` +// Authorization requires the following Google IAM +// (https://cloud.google.com/iam) permission on the specified resource +// parent: * `cloudtasks.queues.getIamPolicy` func (r *ProjectsLocationsQueuesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsQueuesGetIamPolicyCall { c := &ProjectsLocationsQueuesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -2704,9 +2784,10 @@ func (r *ProjectsLocationsQueuesService) List(parent string) *ProjectsLocationsQ // specify a subset of queues. Any Queue field can be used as a filter // and several operators as supported. For example: `<=, <, >=, >, !=, // =, :`. The filter syntax is the same as described in Stackdriver's -// Advanced Logs Filters. Sample filter "state: PAUSED". Note that using -// filters might cause fewer queues than the requested page_size to be -// returned. +// Advanced Logs Filters +// (https://cloud.google.com/logging/docs/view/advanced_filters). Sample +// filter "state: PAUSED". Note that using filters might cause fewer +// queues than the requested page_size to be returned. func (c *ProjectsLocationsQueuesListCall) Filter(filter string) *ProjectsLocationsQueuesListCall { c.urlParams_.Set("filter", filter) return c @@ -2914,7 +2995,9 @@ type ProjectsLocationsQueuesPatchCall struct { // it was dispatched or not. WARNING: Using this method may have // unintended side effects if you are using an App Engine `queue.yaml` // or `queue.xml` file to manage your queues. Read Overview of Queue -// Management and queue.yaml before using this method. +// Management and queue.yaml +// (https://cloud.google.com/tasks/docs/queue-yaml) before using this +// method. func (r *ProjectsLocationsQueuesService) Patch(name string, queue *Queue) *ProjectsLocationsQueuesPatchCall { c := &ProjectsLocationsQueuesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3359,7 +3442,8 @@ type ProjectsLocationsQueuesResumeCall struct { // state; after calling this method it will be set to RUNNING. WARNING: // Resuming many high-QPS queues at the same time can lead to target // overloading. If you are resuming high-QPS queues, follow the 500/50/5 -// pattern described in Managing Cloud Tasks Scaling Risks. +// pattern described in Managing Cloud Tasks Scaling Risks +// (https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). func (r *ProjectsLocationsQueuesService) Resume(name string, resumequeuerequest *ResumeQueueRequest) *ProjectsLocationsQueuesResumeCall { c := &ProjectsLocationsQueuesResumeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3503,8 +3587,8 @@ type ProjectsLocationsQueuesSetIamPolicyCall struct { // any existing policy. Note: The Cloud Console does not check // queue-level IAM permissions yet. Project-level permissions are // required to use the Cloud Console. Authorization requires the -// following Google IAM permission on the specified resource parent: * -// `cloudtasks.queues.setIamPolicy` +// following Google IAM (https://cloud.google.com/iam) permission on the +// specified resource parent: * `cloudtasks.queues.setIamPolicy` func (r *ProjectsLocationsQueuesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsQueuesSetIamPolicyCall { c := &ProjectsLocationsQueuesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -4076,8 +4160,8 @@ func (r *ProjectsLocationsQueuesTasksService) Get(name string) *ProjectsLocation // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` Google IAM permission on the Task -// resource. +// `cloudtasks.tasks.fullView` Google IAM +// (https://cloud.google.com/iam/) permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -4283,8 +4367,8 @@ func (c *ProjectsLocationsQueuesTasksListCall) PageToken(pageToken string) *Proj // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` Google IAM permission on the Task -// resource. +// `cloudtasks.tasks.fullView` Google IAM +// (https://cloud.google.com/iam/) permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. diff --git a/cloudtasks/v2beta2/cloudtasks-gen.go b/cloudtasks/v2beta2/cloudtasks-gen.go index d101f3cfe8a..bf8e605f936 100644 --- a/cloudtasks/v2beta2/cloudtasks-gen.go +++ b/cloudtasks/v2beta2/cloudtasks-gen.go @@ -218,36 +218,42 @@ func (s *AcknowledgeTaskRequest) MarshalJSON() ([]byte, error) { // the HTTP request that is sent to an App Engine app when the task is // dispatched. This proto can only be used for tasks in a queue which // has app_engine_http_target set. Using AppEngineHttpRequest requires -// `appengine.applications.get` Google IAM permission for the project -// and the following scope: +// `appengine.applications.get` +// (https://cloud.google.com/appengine/docs/admin-api/access-control) +// Google IAM permission for the project and the following scope: // `https://www.googleapis.com/auth/cloud-platform` The task will be // delivered to the App Engine app which belongs to the same project as -// the queue. For more information, see How Requests are Routed and how -// routing is affected by dispatch files. Traffic is encrypted during -// transport and never leaves Google datacenters. Because this traffic -// is carried over a communication mechanism internal to Google, you -// cannot explicitly set the protocol (for example, HTTP or HTTPS). The -// request to the handler, however, will appear to have used the HTTP -// protocol. The AppEngineRouting used to construct the URL that the -// task is delivered to can be set at the queue-level or task-level: * -// If set, app_engine_routing_override is used for all tasks in the -// queue, no matter what the setting is for the task-level -// app_engine_routing. The `url` that the task will be sent to is: * -// `url =` host `+` relative_url Tasks can be dispatched to secure app -// handlers, unsecure app handlers, and URIs restricted with `login: -// admin`. Because tasks are not run as any user, they cannot be -// dispatched to URIs restricted with `login: required` Task dispatches -// also do not follow redirects. The task attempt has succeeded if the -// app's request handler returns an HTTP response code in the range -// [`200` - `299`]. The task attempt has failed if the app's handler -// returns a non-2xx response code or Cloud Tasks does not receive -// response before the deadline. Failed tasks will be retried according -// to the retry configuration. `503` (Service Unavailable) is considered -// an App Engine system error instead of an application error and will -// cause Cloud Tasks' traffic congestion control to temporarily throttle -// the queue's dispatches. Unlike other types of task targets, a `429` -// (Too Many Requests) response from an app handler does not cause -// traffic congestion control to throttle the queue. +// the queue. For more information, see How Requests are Routed +// (https://cloud.google.com/appengine/docs/standard/python/how-requests- +// are-routed) and how routing is affected by dispatch files +// (https://cloud.google.com/appengine/docs/python/config/dispatchref). +// Traffic is encrypted during transport and never leaves Google +// datacenters. Because this traffic is carried over a communication +// mechanism internal to Google, you cannot explicitly set the protocol +// (for example, HTTP or HTTPS). The request to the handler, however, +// will appear to have used the HTTP protocol. The AppEngineRouting used +// to construct the URL that the task is delivered to can be set at the +// queue-level or task-level: * If set, app_engine_routing_override is +// used for all tasks in the queue, no matter what the setting is for +// the task-level app_engine_routing. The `url` that the task will be +// sent to is: * `url =` host `+` relative_url Tasks can be dispatched +// to secure app handlers, unsecure app handlers, and URIs restricted +// with `login: admin` +// (https://cloud.google.com/appengine/docs/standard/python/config/appref +// ). Because tasks are not run as any user, they cannot be dispatched +// to URIs restricted with `login: required` +// (https://cloud.google.com/appengine/docs/standard/python/config/appref +// ) Task dispatches also do not follow redirects. The task attempt has +// succeeded if the app's request handler returns an HTTP response code +// in the range [`200` - `299`]. The task attempt has failed if the +// app's handler returns a non-2xx response code or Cloud Tasks does not +// receive response before the deadline. Failed tasks will be retried +// according to the retry configuration. `503` (Service Unavailable) is +// considered an App Engine system error instead of an application error +// and will cause Cloud Tasks' traffic congestion control to temporarily +// throttle the queue's dispatches. Unlike other types of task targets, +// a `429` (Too Many Requests) response from an app handler does not +// cause traffic congestion control to throttle the queue. type AppEngineHttpRequest struct { // AppEngineRouting: Task-level setting for App Engine routing. If set, // app_engine_routing_override is used for all tasks in the queue, no @@ -272,20 +278,26 @@ type AppEngineHttpRequest struct { // below cannot be set or overridden: * `Host` * `X-Google-*` * // `X-AppEngine-*` In addition, Cloud Tasks sets some headers when the // task is dispatched, such as headers containing information about the - // task; see request headers. These headers are set only when the task - // is dispatched, so they are not visible when the task is returned in a - // Cloud Tasks response. Although there is no specific limit for the - // maximum number of headers or the size, there is a limit on the - // maximum size of the Task. For more information, see the CreateTask - // documentation. + // task; see request headers + // (https://cloud.google.com/appengine/docs/python/taskqueue/push/creatin + // g-handlers#reading_request_headers). These headers are set only when + // the task is dispatched, so they are not visible when the task is + // returned in a Cloud Tasks response. Although there is no specific + // limit for the maximum number of headers or the size, there is a limit + // on the maximum size of the Task. For more information, see the + // CreateTask documentation. Headers map[string]string `json:"headers,omitempty"` // HttpMethod: The HTTP method to use for the request. The default is // POST. The app's request handler for the task's target URL must be // able to handle HTTP requests with this http_method, otherwise the // task attempt fails with error code 405 (Method Not Allowed). See - // Writing a push task request handler and the App Engine documentation - // for your runtime on How Requests are Handled. + // Writing a push task request handler + // (https://cloud.google.com/appengine/docs/java/taskqueue/push/creating- + // handlers#writing_a_push_task_request_handler) and the App Engine + // documentation for your runtime on How Requests are Handled + // (https://cloud.google.com/appengine/docs/standard/python3/how-requests + // -are-handled). // // Possible values: // "HTTP_METHOD_UNSPECIFIED" - HTTP method unspecified @@ -338,6 +350,7 @@ func (s *AppEngineHttpRequest) MarshalJSON() ([]byte, error) { // AppEngineHttpTarget and AppEngineHttpRequest. The documentation for // AppEngineHttpRequest explains how the task's host URL is constructed. // Using AppEngineHttpTarget requires `appengine.applications.get` +// (https://cloud.google.com/appengine/docs/admin-api/access-control) // Google IAM permission for the project and the following scope: // `https://www.googleapis.com/auth/cloud-platform` type AppEngineHttpTarget struct { @@ -375,12 +388,21 @@ func (s *AppEngineHttpTarget) MarshalJSON() ([]byte, error) { // AppEngineRouting: App Engine Routing. Defines routing characteristics // specific to App Engine - service, version, and instance. For more // information about services, versions, and instances see An Overview -// of App Engine, Microservices Architecture on Google App Engine, App -// Engine Standard request routing, and App Engine Flex request routing. +// of App Engine +// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng +// ine), Microservices Architecture on Google App Engine +// (https://cloud.google.com/appengine/docs/python/microservices-on-app-e +// ngine), App Engine Standard request routing +// (https://cloud.google.com/appengine/docs/standard/python/how-requests- +// are-routed), and App Engine Flex request routing +// (https://cloud.google.com/appengine/docs/flexible/python/how-requests- +// are-routed). type AppEngineRouting struct { // Host: Output only. The host that the task is sent to. For more - // information, see How Requests are Routed. The host is constructed as: - // * `host = [application_domain_name]` `| [service] + '.' + + // information, see How Requests are Routed + // (https://cloud.google.com/appengine/docs/standard/python/how-requests- + // are-routed). The host is constructed as: * `host = + // [application_domain_name]` `| [service] + '.' + // [application_domain_name]` `| [version] + '.' + // [application_domain_name]` `| [version_dot_service]+ '.' + // [application_domain_name]` `| [instance] + '.' + @@ -408,9 +430,15 @@ type AppEngineRouting struct { // Instance: App instance. By default, the task is sent to an instance // which is available when the task is attempted. Requests can only be // sent to a specific instance if manual scaling is used in App Engine - // Standard. App Engine Flex does not support instances. For more - // information, see App Engine Standard request routing and App Engine - // Flex request routing. + // Standard + // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng + // ine?hl=en_US#scaling_types_and_instance_classes). App Engine Flex + // does not support instances. For more information, see App Engine + // Standard request routing + // (https://cloud.google.com/appengine/docs/standard/python/how-requests- + // are-routed) and App Engine Flex request routing + // (https://cloud.google.com/appengine/docs/flexible/python/how-requests- + // are-routed). Instance string `json:"instance,omitempty"` // Service: App service. By default, the task is sent to the service @@ -507,7 +535,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -580,7 +609,8 @@ type CancelLeaseRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // Google IAM permission on the Task resource. + // Google IAM (https://cloud.google.com/iam/) permission on the Task + // resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -632,7 +662,8 @@ type CreateTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // Google IAM permission on the Task resource. + // Google IAM (https://cloud.google.com/iam/) permission on the Task + // resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -805,7 +836,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -845,10 +877,12 @@ type LeaseTasksRequest struct { // function` * `tag = string` * `function = "oldest_tag()" The // `oldest_tag()` function returns tasks which have the same tag as the // oldest task (ordered by schedule time). SDK compatibility: Although - // the SDK allows tags to be either string or bytes, only UTF-8 encoded - // tags can be used in Cloud Tasks. Tag which aren't UTF-8 encoded can't - // be used in the filter and the task's tag will be displayed as empty - // in Cloud Tasks. + // the SDK allows tags to be either string or bytes + // (https://cloud.google.com/appengine/docs/standard/java/javadoc/com/goo + // gle/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), only UTF-8 + // encoded tags can be used in Cloud Tasks. Tag which aren't UTF-8 + // encoded can't be used in the filter and the task's tag will be + // displayed as empty in Cloud Tasks. Filter string `json:"filter,omitempty"` // LeaseDuration: Required. The duration of the lease. Each task @@ -876,7 +910,8 @@ type LeaseTasksRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // Google IAM permission on the Task resource. + // Google IAM (https://cloud.google.com/iam/) permission on the Task + // resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -1127,7 +1162,9 @@ type PauseQueueRequest struct { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1146,7 +1183,7 @@ type PauseQueueRequest struct { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1182,7 +1219,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1226,9 +1264,12 @@ type PullMessage struct { // tasks with the user ID. The task's tag can only be set when the task // is created. The tag must be less than 500 characters. SDK // compatibility: Although the SDK allows tags to be either string or - // bytes, only UTF-8 encoded tags can be used in Cloud Tasks. If a tag - // isn't UTF-8 encoded, the tag will be empty when the task is returned - // by Cloud Tasks. + // bytes + // (https://cloud.google.com/appengine/docs/standard/java/javadoc/com/goo + // gle/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), only UTF-8 + // encoded tags can be used in Cloud Tasks. If a tag isn't UTF-8 + // encoded, the tag will be empty when the task is returned by Cloud + // Tasks. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Payload") to @@ -1276,9 +1317,11 @@ type Queue struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` * // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see - // Identifying projects * `LOCATION_ID` is the canonical ID for the - // queue's location. The list of available locations can be obtained by - // calling ListLocations. For more information, see + // Identifying projects + // (https://cloud.google.com/resource-manager/docs/creating-managing-proj + // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for + // the queue's location. The list of available locations can be obtained + // by calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. @@ -1291,8 +1334,11 @@ type Queue struct { // PurgeTime: Output only. The last time this queue was purged. All // tasks that were created before this time were purged. A queue can be // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud - // Console. Purge time will be truncated to the nearest microsecond. - // Purge time will be unset if the queue has never been purged. + // Console + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus + // h/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). Purge + // time will be truncated to the nearest microsecond. Purge time will be + // unset if the queue has never been purged. PurgeTime string `json:"purgeTime,omitempty"` // RateLimits: Rate limits for task dispatches. rate_limits and @@ -1313,12 +1359,16 @@ type Queue struct { // the App Engine SDK: the queue-level retry settings apply to all tasks // in the queue which do not have retry settings explicitly set on the // task and were created by the App Engine SDK. See App Engine - // documentation. + // documentation + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus + // h/retrying-tasks). RetryConfig *RetryConfig `json:"retryConfig,omitempty"` // State: Output only. The state of the queue. `state` can only be // changed by called PauseQueue, ResumeQueue, or uploading - // queue.yaml/xml. UpdateQueue cannot be used to change `state`. + // queue.yaml/xml + // (https://cloud.google.com/appengine/docs/python/config/queueref). + // UpdateQueue cannot be used to change `state`. // // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -1456,20 +1506,22 @@ type RateLimits struct { // rate is high. This field allows the queue to have a high rate so // processing starts shortly after a task is enqueued, but still limits // resource usage when many tasks are enqueued in a short period of - // time. The token bucket algorithm is used to control the rate of task - // dispatches. Each queue has a token bucket that holds tokens, up to - // the maximum specified by `max_burst_size`. Each time a task is - // dispatched, a token is removed from the bucket. Tasks will be - // dispatched until the queue's bucket runs out of tokens. The bucket - // will be continuously refilled with new tokens based on - // max_dispatches_per_second. The default value of `max_burst_size` is - // picked by Cloud Tasks based on the value of + // time. The token bucket (https://wikipedia.org/wiki/Token_Bucket) + // algorithm is used to control the rate of task dispatches. Each queue + // has a token bucket that holds tokens, up to the maximum specified by + // `max_burst_size`. Each time a task is dispatched, a token is removed + // from the bucket. Tasks will be dispatched until the queue's bucket + // runs out of tokens. The bucket will be continuously refilled with new + // tokens based on max_dispatches_per_second. The default value of + // `max_burst_size` is picked by Cloud Tasks based on the value of // max_dispatches_per_second. The maximum value of `max_burst_size` is // 500. For App Engine queues that were created or updated using - // `queue.yaml/xml`, `max_burst_size` is equal to bucket_size. If - // UpdateQueue is called on a queue without explicitly setting a value - // for `max_burst_size`, `max_burst_size` value will get updated if - // UpdateQueue is updating max_dispatches_per_second. + // `queue.yaml/xml`, `max_burst_size` is equal to bucket_size + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#bucket_size). If UpdateQueue is called on a queue without + // explicitly setting a value for `max_burst_size`, `max_burst_size` + // value will get updated if UpdateQueue is updating + // max_dispatches_per_second. MaxBurstSize int64 `json:"maxBurstSize,omitempty"` // MaxConcurrentTasks: The maximum number of concurrent tasks that Cloud @@ -1480,7 +1532,9 @@ type RateLimits struct { // allowed value is 5,000. This field is output only for pull queues and // always -1, which indicates no limit. No other queue types can have // `max_concurrent_tasks` set to -1. This field has the same meaning as - // max_concurrent_requests in queue.yaml/xml. + // max_concurrent_requests in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#max_concurrent_requests). MaxConcurrentTasks int64 `json:"maxConcurrentTasks,omitempty"` // MaxTasksDispatchedPerSecond: The maximum rate at which tasks are @@ -1489,7 +1543,9 @@ type RateLimits struct { // maximum allowed value is 500. * This field is output only for pull // queues. In addition to the `max_tasks_dispatched_per_second` limit, a // maximum of 10 QPS of LeaseTasks requests are allowed per pull queue. - // This field has the same meaning as rate in queue.yaml/xml. + // This field has the same meaning as rate in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#rate). MaxTasksDispatchedPerSecond float64 `json:"maxTasksDispatchedPerSecond,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxBurstSize") to @@ -1543,7 +1599,8 @@ type RenewLeaseRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // Google IAM permission on the Task resource. + // Google IAM (https://cloud.google.com/iam/) permission on the Task + // resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -1606,7 +1663,9 @@ type RetryConfig struct { // queue is created, Cloud Tasks will pick the default. This field is // output only for pull queues. `max_backoff` will be truncated to the // nearest second. This field has the same meaning as - // max_backoff_seconds in queue.yaml/xml. + // max_backoff_seconds in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxBackoff string `json:"maxBackoff,omitempty"` // MaxDoublings: The time between retries will double `max_doublings` @@ -1621,7 +1680,9 @@ type RetryConfig struct { // 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, .... If unspecified when // the queue is created, Cloud Tasks will pick the default. This field // is output only for pull queues. This field has the same meaning as - // max_doublings in queue.yaml/xml. + // max_doublings in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxDoublings int64 `json:"maxDoublings,omitempty"` // MaxRetryDuration: If positive, `max_retry_duration` specifies the @@ -1632,7 +1693,9 @@ type RetryConfig struct { // is unlimited. If unspecified when the queue is created, Cloud Tasks // will pick the default. This field is output only for pull queues. // `max_retry_duration` will be truncated to the nearest second. This - // field has the same meaning as task_age_limit in queue.yaml/xml. + // field has the same meaning as task_age_limit in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxRetryDuration string `json:"maxRetryDuration,omitempty"` // MinBackoff: A task will be scheduled for retry between min_backoff @@ -1641,7 +1704,9 @@ type RetryConfig struct { // queue is created, Cloud Tasks will pick the default. This field is // output only for pull queues. `min_backoff` will be truncated to the // nearest second. This field has the same meaning as - // min_backoff_seconds in queue.yaml/xml. + // min_backoff_seconds in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MinBackoff string `json:"minBackoff,omitempty"` // UnlimitedAttempts: If true, then the number of attempts is unlimited. @@ -1679,7 +1744,8 @@ type RunTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // Google IAM permission on the Task resource. + // Google IAM (https://cloud.google.com/iam/) permission on the Task + // resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -1750,10 +1816,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1808,9 +1875,11 @@ type Task struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ // ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), // hyphens (-), colons (:), or periods (.). For more information, see - // Identifying projects * `LOCATION_ID` is the canonical ID for the - // task's location. The list of available locations can be obtained by - // calling ListLocations. For more information, see + // Identifying projects + // (https://cloud.google.com/resource-manager/docs/creating-managing-proj + // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for + // the task's location. The list of available locations can be obtained + // by calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. * `TASK_ID` can contain only letters @@ -1931,7 +2000,8 @@ func (s *TaskStatus) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2354,8 +2424,9 @@ type ProjectsLocationsQueuesCreateCall struct { // task will be deleted regardless of whether it was dispatched or not. // WARNING: Using this method may have unintended side effects if you // are using an App Engine `queue.yaml` or `queue.xml` file to manage -// your queues. Read Overview of Queue Management and queue.yaml before -// using this method. +// your queues. Read Overview of Queue Management and queue.yaml +// (https://cloud.google.com/tasks/docs/queue-yaml) before using this +// method. func (r *ProjectsLocationsQueuesService) Create(parent string, queue *Queue) *ProjectsLocationsQueuesCreateCall { c := &ProjectsLocationsQueuesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -2499,7 +2570,9 @@ type ProjectsLocationsQueuesDeleteCall struct { // same name can't be created for 7 days. WARNING: Using this method may // have unintended side effects if you are using an App Engine // `queue.yaml` or `queue.xml` file to manage your queues. Read Overview -// of Queue Management and queue.yaml before using this method. +// of Queue Management and queue.yaml +// (https://cloud.google.com/tasks/docs/queue-yaml) before using this +// method. func (r *ProjectsLocationsQueuesService) Delete(name string) *ProjectsLocationsQueuesDeleteCall { c := &ProjectsLocationsQueuesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2793,8 +2866,9 @@ type ProjectsLocationsQueuesGetIamPolicyCall struct { // GetIamPolicy: Gets the access control policy for a Queue. Returns an // empty policy if the resource exists and does not have a policy set. -// Authorization requires the following Google IAM permission on the -// specified resource parent: * `cloudtasks.queues.getIamPolicy` +// Authorization requires the following Google IAM +// (https://cloud.google.com/iam) permission on the specified resource +// parent: * `cloudtasks.queues.getIamPolicy` func (r *ProjectsLocationsQueuesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsQueuesGetIamPolicyCall { c := &ProjectsLocationsQueuesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -2945,9 +3019,10 @@ func (r *ProjectsLocationsQueuesService) List(parent string) *ProjectsLocationsQ // specify a subset of queues. Any Queue field can be used as a filter // and several operators as supported. For example: `<=, <, >=, >, !=, // =, :`. The filter syntax is the same as described in Stackdriver's -// Advanced Logs Filters. Sample filter "app_engine_http_target: *". -// Note that using filters might cause fewer queues than the -// requested_page size to be returned. +// Advanced Logs Filters +// (https://cloud.google.com/logging/docs/view/advanced_filters). Sample +// filter "app_engine_http_target: *". Note that using filters might +// cause fewer queues than the requested_page size to be returned. func (c *ProjectsLocationsQueuesListCall) Filter(filter string) *ProjectsLocationsQueuesListCall { c.urlParams_.Set("filter", filter) return c @@ -3172,7 +3247,9 @@ type ProjectsLocationsQueuesPatchCall struct { // it was dispatched or not. WARNING: Using this method may have // unintended side effects if you are using an App Engine `queue.yaml` // or `queue.xml` file to manage your queues. Read Overview of Queue -// Management and queue.yaml before using this method. +// Management and queue.yaml +// (https://cloud.google.com/tasks/docs/queue-yaml) before using this +// method. func (r *ProjectsLocationsQueuesService) Patch(name string, queue *Queue) *ProjectsLocationsQueuesPatchCall { c := &ProjectsLocationsQueuesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3617,7 +3694,8 @@ type ProjectsLocationsQueuesResumeCall struct { // state; after calling this method it will be set to RUNNING. WARNING: // Resuming many high-QPS queues at the same time can lead to target // overloading. If you are resuming high-QPS queues, follow the 500/50/5 -// pattern described in Managing Cloud Tasks Scaling Risks. +// pattern described in Managing Cloud Tasks Scaling Risks +// (https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). func (r *ProjectsLocationsQueuesService) Resume(name string, resumequeuerequest *ResumeQueueRequest) *ProjectsLocationsQueuesResumeCall { c := &ProjectsLocationsQueuesResumeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3761,8 +3839,8 @@ type ProjectsLocationsQueuesSetIamPolicyCall struct { // any existing policy. Note: The Cloud Console does not check // queue-level IAM permissions yet. Project-level permissions are // required to use the Cloud Console. Authorization requires the -// following Google IAM permission on the specified resource parent: * -// `cloudtasks.queues.setIamPolicy` +// following Google IAM (https://cloud.google.com/iam) permission on the +// specified resource parent: * `cloudtasks.queues.setIamPolicy` func (r *ProjectsLocationsQueuesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsQueuesSetIamPolicyCall { c := &ProjectsLocationsQueuesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -4624,8 +4702,8 @@ func (r *ProjectsLocationsQueuesTasksService) Get(name string) *ProjectsLocation // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` Google IAM permission on the Task -// resource. +// `cloudtasks.tasks.fullView` Google IAM +// (https://cloud.google.com/iam/) permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -4981,8 +5059,8 @@ func (c *ProjectsLocationsQueuesTasksListCall) PageToken(pageToken string) *Proj // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` Google IAM permission on the Task -// resource. +// `cloudtasks.tasks.fullView` Google IAM +// (https://cloud.google.com/iam/) permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. diff --git a/cloudtasks/v2beta3/cloudtasks-gen.go b/cloudtasks/v2beta3/cloudtasks-gen.go index c6f5d77f982..d346168ea19 100644 --- a/cloudtasks/v2beta3/cloudtasks-gen.go +++ b/cloudtasks/v2beta3/cloudtasks-gen.go @@ -186,8 +186,9 @@ type ProjectsLocationsQueuesTasksService struct { // to the App Engine application hostname specified by its // AppEngineHttpQueue and AppEngineHttpRequest. The documentation for // AppEngineHttpRequest explains how the task's host URL is constructed. -// Using AppEngineHttpQueue requires `appengine.applications.get` Google -// IAM permission for the project and the following scope: +// Using AppEngineHttpQueue requires `appengine.applications.get` +// (https://cloud.google.com/appengine/docs/admin-api/access-control) +// Google IAM permission for the project and the following scope: // `https://www.googleapis.com/auth/cloud-platform` type AppEngineHttpQueue struct { // AppEngineRoutingOverride: Overrides for the task-level @@ -224,36 +225,42 @@ func (s *AppEngineHttpQueue) MarshalJSON() ([]byte, error) { // AppEngineHttpRequest: App Engine HTTP request. The message defines // the HTTP request that is sent to an App Engine app when the task is // dispatched. Using AppEngineHttpRequest requires -// `appengine.applications.get` Google IAM permission for the project -// and the following scope: +// `appengine.applications.get` +// (https://cloud.google.com/appengine/docs/admin-api/access-control) +// Google IAM permission for the project and the following scope: // `https://www.googleapis.com/auth/cloud-platform` The task will be // delivered to the App Engine app which belongs to the same project as -// the queue. For more information, see How Requests are Routed and how -// routing is affected by dispatch files. Traffic is encrypted during -// transport and never leaves Google datacenters. Because this traffic -// is carried over a communication mechanism internal to Google, you -// cannot explicitly set the protocol (for example, HTTP or HTTPS). The -// request to the handler, however, will appear to have used the HTTP -// protocol. The AppEngineRouting used to construct the URL that the -// task is delivered to can be set at the queue-level or task-level: * -// If set, app_engine_routing_override is used for all tasks in the -// queue, no matter what the setting is for the task-level -// app_engine_routing. The `url` that the task will be sent to is: * -// `url =` host `+` relative_uri Tasks can be dispatched to secure app -// handlers, unsecure app handlers, and URIs restricted with `login: -// admin`. Because tasks are not run as any user, they cannot be -// dispatched to URIs restricted with `login: required` Task dispatches -// also do not follow redirects. The task attempt has succeeded if the -// app's request handler returns an HTTP response code in the range -// [`200` - `299`]. The task attempt has failed if the app's handler -// returns a non-2xx response code or Cloud Tasks does not receive -// response before the deadline. Failed tasks will be retried according -// to the retry configuration. `503` (Service Unavailable) is considered -// an App Engine system error instead of an application error and will -// cause Cloud Tasks' traffic congestion control to temporarily throttle -// the queue's dispatches. Unlike other types of task targets, a `429` -// (Too Many Requests) response from an app handler does not cause -// traffic congestion control to throttle the queue. +// the queue. For more information, see How Requests are Routed +// (https://cloud.google.com/appengine/docs/standard/python/how-requests- +// are-routed) and how routing is affected by dispatch files +// (https://cloud.google.com/appengine/docs/python/config/dispatchref). +// Traffic is encrypted during transport and never leaves Google +// datacenters. Because this traffic is carried over a communication +// mechanism internal to Google, you cannot explicitly set the protocol +// (for example, HTTP or HTTPS). The request to the handler, however, +// will appear to have used the HTTP protocol. The AppEngineRouting used +// to construct the URL that the task is delivered to can be set at the +// queue-level or task-level: * If set, app_engine_routing_override is +// used for all tasks in the queue, no matter what the setting is for +// the task-level app_engine_routing. The `url` that the task will be +// sent to is: * `url =` host `+` relative_uri Tasks can be dispatched +// to secure app handlers, unsecure app handlers, and URIs restricted +// with `login: admin` +// (https://cloud.google.com/appengine/docs/standard/python/config/appref +// ). Because tasks are not run as any user, they cannot be dispatched +// to URIs restricted with `login: required` +// (https://cloud.google.com/appengine/docs/standard/python/config/appref +// ) Task dispatches also do not follow redirects. The task attempt has +// succeeded if the app's request handler returns an HTTP response code +// in the range [`200` - `299`]. The task attempt has failed if the +// app's handler returns a non-2xx response code or Cloud Tasks does not +// receive response before the deadline. Failed tasks will be retried +// according to the retry configuration. `503` (Service Unavailable) is +// considered an App Engine system error instead of an application error +// and will cause Cloud Tasks' traffic congestion control to temporarily +// throttle the queue's dispatches. Unlike other types of task targets, +// a `429` (Too Many Requests) response from an app handler does not +// cause traffic congestion control to throttle the queue. type AppEngineHttpRequest struct { // AppEngineRouting: Task-level setting for App Engine routing. If set, // app_engine_routing_override is used for all tasks in the queue, no @@ -283,8 +290,10 @@ type AppEngineHttpRequest struct { // below cannot be set or overridden: * `Host` * `X-Google-*` * // `X-AppEngine-*` In addition, Cloud Tasks sets some headers when the // task is dispatched, such as headers containing information about the - // task; see request headers. These headers are set only when the task - // is dispatched, so they are not visible when the task is returned in a + // task; see request headers + // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#readi + // ng_request_headers). These headers are set only when the task is + // dispatched, so they are not visible when the task is returned in a // Cloud Tasks response. Although there is no specific limit for the // maximum number of headers or the size, there is a limit on the // maximum size of the Task. For more information, see the CreateTask @@ -295,8 +304,12 @@ type AppEngineHttpRequest struct { // POST. The app's request handler for the task's target URL must be // able to handle HTTP requests with this http_method, otherwise the // task attempt fails with error code 405 (Method Not Allowed). See - // Writing a push task request handler and the App Engine documentation - // for your runtime on How Requests are Handled. + // Writing a push task request handler + // (https://cloud.google.com/appengine/docs/java/taskqueue/push/creating- + // handlers#writing_a_push_task_request_handler) and the App Engine + // documentation for your runtime on How Requests are Handled + // (https://cloud.google.com/appengine/docs/standard/python3/how-requests + // -are-handled). // // Possible values: // "HTTP_METHOD_UNSPECIFIED" - HTTP method unspecified @@ -343,23 +356,38 @@ func (s *AppEngineHttpRequest) MarshalJSON() ([]byte, error) { // AppEngineRouting: App Engine Routing. Defines routing characteristics // specific to App Engine - service, version, and instance. For more // information about services, versions, and instances see An Overview -// of App Engine, Microservices Architecture on Google App Engine, App -// Engine Standard request routing, and App Engine Flex request routing. +// of App Engine +// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng +// ine), Microservices Architecture on Google App Engine +// (https://cloud.google.com/appengine/docs/python/microservices-on-app-e +// ngine), App Engine Standard request routing +// (https://cloud.google.com/appengine/docs/standard/python/how-requests- +// are-routed), and App Engine Flex request routing +// (https://cloud.google.com/appengine/docs/flexible/python/how-requests- +// are-routed). type AppEngineRouting struct { // Host: Output only. The host that the task is sent to. The host is // constructed from the domain name of the app associated with the // queue's project ID (for example .appspot.com), and the service, // version, and instance. Tasks which were created using the App Engine // SDK might have a custom domain name. For more information, see How - // Requests are Routed. + // Requests are Routed + // (https://cloud.google.com/appengine/docs/standard/python/how-requests- + // are-routed). Host string `json:"host,omitempty"` // Instance: App instance. By default, the task is sent to an instance // which is available when the task is attempted. Requests can only be // sent to a specific instance if manual scaling is used in App Engine - // Standard. App Engine Flex does not support instances. For more - // information, see App Engine Standard request routing and App Engine - // Flex request routing. + // Standard + // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng + // ine?hl=en_US#scaling_types_and_instance_classes). App Engine Flex + // does not support instances. For more information, see App Engine + // Standard request routing + // (https://cloud.google.com/appengine/docs/standard/python/how-requests- + // are-routed) and App Engine Flex request routing + // (https://cloud.google.com/appengine/docs/flexible/python/how-requests- + // are-routed). Instance string `json:"instance,omitempty"` // Service: App service. By default, the task is sent to the service @@ -457,7 +485,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -529,7 +558,8 @@ type CreateTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // Google IAM permission on the Task resource. + // Google IAM (https://cloud.google.com/iam/) permission on the Task + // resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -701,7 +731,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -786,16 +817,19 @@ type HttpRequest struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` - // OauthToken: If specified, an OAuth token will be generated and - // attached as an `Authorization` header in the HTTP request. This type - // of authorization should generally only be used when calling Google - // APIs hosted on *.googleapis.com. + // OauthToken: If specified, an OAuth token + // (https://developers.google.com/identity/protocols/OAuth2) will be + // generated and attached as an `Authorization` header in the HTTP + // request. This type of authorization should generally only be used + // when calling Google APIs hosted on *.googleapis.com. OauthToken *OAuthToken `json:"oauthToken,omitempty"` - // OidcToken: If specified, an OIDC token will be generated and attached - // as an `Authorization` header in the HTTP request. This type of - // authorization can be used for many scenarios, including calling Cloud - // Run, or endpoints where you intend to validate the token yourself. + // OidcToken: If specified, an OIDC + // (https://developers.google.com/identity/protocols/OpenIDConnect) + // token will be generated and attached as an `Authorization` header in + // the HTTP request. This type of authorization can be used for many + // scenarios, including calling Cloud Run, or endpoints where you intend + // to validate the token yourself. OidcToken *OidcToken `json:"oidcToken,omitempty"` // Url: Required. The full url path that the request will be sent to. @@ -994,19 +1028,21 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OAuthToken: Contains information needed for generating an OAuth -// token. This type of authorization should generally only be used when -// calling Google APIs hosted on *.googleapis.com. +// OAuthToken: Contains information needed for generating an OAuth token +// (https://developers.google.com/identity/protocols/OAuth2). This type +// of authorization should generally only be used when calling Google +// APIs hosted on *.googleapis.com. type OAuthToken struct { // Scope: OAuth scope to be used for generating OAuth access token. If // not specified, "https://www.googleapis.com/auth/cloud-platform" will // be used. Scope string `json:"scope,omitempty"` - // ServiceAccountEmail: Service account email to be used for generating - // OAuth token. The service account must be within the same project as - // the queue. The caller must have iam.serviceAccounts.actAs permission - // for the service account. + // ServiceAccountEmail: Service account email + // (https://cloud.google.com/iam/docs/service-accounts) to be used for + // generating OAuth token. The service account must be within the same + // project as the queue. The caller must have iam.serviceAccounts.actAs + // permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Scope") to @@ -1033,18 +1069,21 @@ func (s *OAuthToken) MarshalJSON() ([]byte, error) { } // OidcToken: Contains information needed for generating an OpenID -// Connect token. This type of authorization can be used for many -// scenarios, including calling Cloud Run, or endpoints where you intend -// to validate the token yourself. +// Connect token +// (https://developers.google.com/identity/protocols/OpenIDConnect). +// This type of authorization can be used for many scenarios, including +// calling Cloud Run, or endpoints where you intend to validate the +// token yourself. type OidcToken struct { // Audience: Audience to be used when generating OIDC token. If not // specified, the URI specified in target will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: Service account email to be used for generating - // OIDC token. The service account must be within the same project as - // the queue. The caller must have iam.serviceAccounts.actAs permission - // for the service account. + // ServiceAccountEmail: Service account email + // (https://cloud.google.com/iam/docs/service-accounts) to be used for + // generating OIDC token. The service account must be within the same + // project as the queue. The caller must have iam.serviceAccounts.actAs + // permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` // ForceSendFields is a list of field names (e.g. "Audience") to @@ -1086,7 +1125,9 @@ type PauseQueueRequest struct { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1105,7 +1146,7 @@ type PauseQueueRequest struct { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1141,7 +1182,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1182,9 +1224,12 @@ type PullMessage struct { // Tag: The tasks's tag. The tag is less than 500 characters. SDK // compatibility: Although the SDK allows tags to be either string or - // bytes, only UTF-8 encoded tags can be used in Cloud Tasks. If a tag - // isn't UTF-8 encoded, the tag will be empty when the task is returned - // by Cloud Tasks. + // bytes + // (https://cloud.google.com/appengine/docs/standard/java/javadoc/com/goo + // gle/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), only UTF-8 + // encoded tags can be used in Cloud Tasks. If a tag isn't UTF-8 + // encoded, the tag will be empty when the task is returned by Cloud + // Tasks. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Payload") to @@ -1229,9 +1274,11 @@ type Queue struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` * // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see - // Identifying projects * `LOCATION_ID` is the canonical ID for the - // queue's location. The list of available locations can be obtained by - // calling ListLocations. For more information, see + // Identifying projects + // (https://cloud.google.com/resource-manager/docs/creating-managing-proj + // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for + // the queue's location. The list of available locations can be obtained + // by calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. @@ -1240,8 +1287,11 @@ type Queue struct { // PurgeTime: Output only. The last time this queue was purged. All // tasks that were created before this time were purged. A queue can be // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud - // Console. Purge time will be truncated to the nearest microsecond. - // Purge time will be unset if the queue has never been purged. + // Console + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus + // h/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). Purge + // time will be truncated to the nearest microsecond. Purge time will be + // unset if the queue has never been purged. PurgeTime string `json:"purgeTime,omitempty"` // RateLimits: Rate limits for task dispatches. rate_limits and @@ -1267,17 +1317,21 @@ type Queue struct { // the App Engine SDK: the queue-level retry settings apply to all tasks // in the queue which do not have retry settings explicitly set on the // task and were created by the App Engine SDK. See App Engine - // documentation. + // documentation + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus + // h/retrying-tasks). RetryConfig *RetryConfig `json:"retryConfig,omitempty"` // StackdriverLoggingConfig: Configuration options for writing logs to - // Stackdriver Logging. If this field is unset, then no logs are - // written. + // Stackdriver Logging (https://cloud.google.com/logging/docs/). If this + // field is unset, then no logs are written. StackdriverLoggingConfig *StackdriverLoggingConfig `json:"stackdriverLoggingConfig,omitempty"` // State: Output only. The state of the queue. `state` can only be // changed by called PauseQueue, ResumeQueue, or uploading - // queue.yaml/xml. UpdateQueue cannot be used to change `state`. + // queue.yaml/xml + // (https://cloud.google.com/appengine/docs/python/config/queueref). + // UpdateQueue cannot be used to change `state`. // // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -1423,20 +1477,22 @@ type RateLimits struct { // rate is high. This field allows the queue to have a high rate so // processing starts shortly after a task is enqueued, but still limits // resource usage when many tasks are enqueued in a short period of - // time. The token bucket algorithm is used to control the rate of task - // dispatches. Each queue has a token bucket that holds tokens, up to - // the maximum specified by `max_burst_size`. Each time a task is - // dispatched, a token is removed from the bucket. Tasks will be - // dispatched until the queue's bucket runs out of tokens. The bucket - // will be continuously refilled with new tokens based on - // max_dispatches_per_second. The default value of `max_burst_size` is - // picked by Cloud Tasks based on the value of + // time. The token bucket (https://wikipedia.org/wiki/Token_Bucket) + // algorithm is used to control the rate of task dispatches. Each queue + // has a token bucket that holds tokens, up to the maximum specified by + // `max_burst_size`. Each time a task is dispatched, a token is removed + // from the bucket. Tasks will be dispatched until the queue's bucket + // runs out of tokens. The bucket will be continuously refilled with new + // tokens based on max_dispatches_per_second. The default value of + // `max_burst_size` is picked by Cloud Tasks based on the value of // max_dispatches_per_second. The maximum value of `max_burst_size` is // 500. For App Engine queues that were created or updated using - // `queue.yaml/xml`, `max_burst_size` is equal to bucket_size. If - // UpdateQueue is called on a queue without explicitly setting a value - // for `max_burst_size`, `max_burst_size` value will get updated if - // UpdateQueue is updating max_dispatches_per_second. + // `queue.yaml/xml`, `max_burst_size` is equal to bucket_size + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#bucket_size). If UpdateQueue is called on a queue without + // explicitly setting a value for `max_burst_size`, `max_burst_size` + // value will get updated if UpdateQueue is updating + // max_dispatches_per_second. MaxBurstSize int64 `json:"maxBurstSize,omitempty"` // MaxConcurrentDispatches: The maximum number of concurrent tasks that @@ -1445,14 +1501,18 @@ type RateLimits struct { // the number of concurrent requests decreases. If unspecified when the // queue is created, Cloud Tasks will pick the default. The maximum // allowed value is 5,000. This field has the same meaning as - // max_concurrent_requests in queue.yaml/xml. + // max_concurrent_requests in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#max_concurrent_requests). MaxConcurrentDispatches int64 `json:"maxConcurrentDispatches,omitempty"` // MaxDispatchesPerSecond: The maximum rate at which tasks are // dispatched from this queue. If unspecified when the queue is created, // Cloud Tasks will pick the default. * For App Engine queues, the // maximum allowed value is 500. This field has the same meaning as rate - // in queue.yaml/xml. + // in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#rate). MaxDispatchesPerSecond float64 `json:"maxDispatchesPerSecond,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxBurstSize") to @@ -1504,7 +1564,9 @@ type RetryConfig struct { // then there will be `max_attempts - 1` retries). Must be >= -1. If // unspecified when the queue is created, Cloud Tasks will pick the // default. -1 indicates unlimited attempts. This field has the same - // meaning as task_retry_limit in queue.yaml/xml. + // meaning as task_retry_limit in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxAttempts int64 `json:"maxAttempts,omitempty"` // MaxBackoff: A task will be scheduled for retry between min_backoff @@ -1512,7 +1574,9 @@ type RetryConfig struct { // specifies that the task should be retried. If unspecified when the // queue is created, Cloud Tasks will pick the default. `max_backoff` // will be truncated to the nearest second. This field has the same - // meaning as max_backoff_seconds in queue.yaml/xml. + // meaning as max_backoff_seconds in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxBackoff string `json:"maxBackoff,omitempty"` // MaxDoublings: The time between retries will double `max_doublings` @@ -1526,7 +1590,9 @@ type RetryConfig struct { // been attempted max_attempts times. Thus, the requests will retry at // 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, .... If unspecified when // the queue is created, Cloud Tasks will pick the default. This field - // has the same meaning as max_doublings in queue.yaml/xml. + // has the same meaning as max_doublings in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxDoublings int64 `json:"maxDoublings,omitempty"` // MaxRetryDuration: If positive, `max_retry_duration` specifies the @@ -1537,7 +1603,9 @@ type RetryConfig struct { // is unlimited. If unspecified when the queue is created, Cloud Tasks // will pick the default. `max_retry_duration` will be truncated to the // nearest second. This field has the same meaning as task_age_limit in - // queue.yaml/xml. + // queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MaxRetryDuration string `json:"maxRetryDuration,omitempty"` // MinBackoff: A task will be scheduled for retry between min_backoff @@ -1545,7 +1613,9 @@ type RetryConfig struct { // specifies that the task should be retried. If unspecified when the // queue is created, Cloud Tasks will pick the default. `min_backoff` // will be truncated to the nearest second. This field has the same - // meaning as min_backoff_seconds in queue.yaml/xml. + // meaning as min_backoff_seconds in queue.yaml/xml + // (https://cloud.google.com/appengine/docs/standard/python/config/queuer + // ef#retry_parameters). MinBackoff string `json:"minBackoff,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxAttempts") to @@ -1580,7 +1650,8 @@ type RunTaskRequest struct { // payloads, might be desirable to return only when needed because of // its large size or because of the sensitivity of data that it // contains. Authorization for FULL requires `cloudtasks.tasks.fullView` - // Google IAM permission on the Task resource. + // Google IAM (https://cloud.google.com/iam/) permission on the Task + // resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -1649,12 +1720,12 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { } // StackdriverLoggingConfig: Configuration options for writing logs to -// Stackdriver Logging. +// Stackdriver Logging (https://cloud.google.com/logging/docs/). type StackdriverLoggingConfig struct { // SamplingRatio: Specifies the fraction of operations to write to - // Stackdriver Logging. This field may contain any value between 0.0 and - // 1.0, inclusive. 0.0 is the default and means that no operations are - // logged. + // Stackdriver Logging (https://cloud.google.com/logging/docs/). This + // field may contain any value between 0.0 and 1.0, inclusive. 0.0 is + // the default and means that no operations are logged. SamplingRatio float64 `json:"samplingRatio,omitempty"` // ForceSendFields is a list of field names (e.g. "SamplingRatio") to @@ -1696,10 +1767,11 @@ func (s *StackdriverLoggingConfig) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1764,17 +1836,20 @@ type Task struct { // of request: * For HTTP tasks, the default is 10 minutes. The deadline // must be in the interval [15 seconds, 30 minutes]. * For App Engine // tasks, 0 indicates that the request has the default deadline. The - // default deadline depends on the scaling type of the service: 10 - // minutes for standard apps with automatic scaling, 24 hours for - // standard apps with manual and basic scaling, and 60 minutes for flex - // apps. If the request deadline is set, it must be in the interval [15 - // seconds, 24 hours 15 seconds]. Regardless of the task's - // `dispatch_deadline`, the app handler will not run for longer than - // than the service's timeout. We recommend setting the - // `dispatch_deadline` to at most a few seconds more than the app - // handler's timeout. For more information see Timeouts. - // `dispatch_deadline` will be truncated to the nearest millisecond. The - // deadline is an approximate deadline. + // default deadline depends on the scaling type + // (https://cloud.google.com/appengine/docs/standard/go/how-instances-are + // -managed#instance_scaling) of the service: 10 minutes for standard + // apps with automatic scaling, 24 hours for standard apps with manual + // and basic scaling, and 60 minutes for flex apps. If the request + // deadline is set, it must be in the interval [15 seconds, 24 hours 15 + // seconds]. Regardless of the task's `dispatch_deadline`, the app + // handler will not run for longer than than the service's timeout. We + // recommend setting the `dispatch_deadline` to at most a few seconds + // more than the app handler's timeout. For more information see + // Timeouts + // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeo + // uts). `dispatch_deadline` will be truncated to the nearest + // millisecond. The deadline is an approximate deadline. DispatchDeadline string `json:"dispatchDeadline,omitempty"` // FirstAttempt: Output only. The status of the task's first attempt. @@ -1794,9 +1869,11 @@ type Task struct { // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ // ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), // hyphens (-), colons (:), or periods (.). For more information, see - // Identifying projects * `LOCATION_ID` is the canonical ID for the - // task's location. The list of available locations can be obtained by - // calling ListLocations. For more information, see + // Identifying projects + // (https://cloud.google.com/resource-manager/docs/creating-managing-proj + // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for + // the task's location. The list of available locations can be obtained + // by calling ListLocations. For more information, see // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum // length is 100 characters. * `TASK_ID` can contain only letters @@ -1807,8 +1884,10 @@ type Task struct { // PullMessage: Pull Message contained in a task in a PULL queue type. // This payload type cannot be explicitly set through Cloud Tasks API. // Its purpose, currently is to provide backward compatibility with App - // Engine Task Queue pull queues to provide a way to inspect contents of - // pull tasks through the CloudTasks. + // Engine Task Queue pull + // (https://cloud.google.com/appengine/docs/standard/java/taskqueue/pull/ + // ) queues to provide a way to inspect contents of pull tasks through + // the CloudTasks. PullMessage *PullMessage `json:"pullMessage,omitempty"` // ResponseCount: Output only. The number of attempts which have @@ -1870,7 +1949,8 @@ func (s *Task) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2293,8 +2373,9 @@ type ProjectsLocationsQueuesCreateCall struct { // task will be deleted regardless of whether it was dispatched or not. // WARNING: Using this method may have unintended side effects if you // are using an App Engine `queue.yaml` or `queue.xml` file to manage -// your queues. Read Overview of Queue Management and queue.yaml before -// using this method. +// your queues. Read Overview of Queue Management and queue.yaml +// (https://cloud.google.com/tasks/docs/queue-yaml) before using this +// method. func (r *ProjectsLocationsQueuesService) Create(parent string, queue *Queue) *ProjectsLocationsQueuesCreateCall { c := &ProjectsLocationsQueuesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -2438,7 +2519,9 @@ type ProjectsLocationsQueuesDeleteCall struct { // same name can't be created for 7 days. WARNING: Using this method may // have unintended side effects if you are using an App Engine // `queue.yaml` or `queue.xml` file to manage your queues. Read Overview -// of Queue Management and queue.yaml before using this method. +// of Queue Management and queue.yaml +// (https://cloud.google.com/tasks/docs/queue-yaml) before using this +// method. func (r *ProjectsLocationsQueuesService) Delete(name string) *ProjectsLocationsQueuesDeleteCall { c := &ProjectsLocationsQueuesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2732,8 +2815,9 @@ type ProjectsLocationsQueuesGetIamPolicyCall struct { // GetIamPolicy: Gets the access control policy for a Queue. Returns an // empty policy if the resource exists and does not have a policy set. -// Authorization requires the following Google IAM permission on the -// specified resource parent: * `cloudtasks.queues.getIamPolicy` +// Authorization requires the following Google IAM +// (https://cloud.google.com/iam) permission on the specified resource +// parent: * `cloudtasks.queues.getIamPolicy` func (r *ProjectsLocationsQueuesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsQueuesGetIamPolicyCall { c := &ProjectsLocationsQueuesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -2884,9 +2968,10 @@ func (r *ProjectsLocationsQueuesService) List(parent string) *ProjectsLocationsQ // specify a subset of queues. Any Queue field can be used as a filter // and several operators as supported. For example: `<=, <, >=, >, !=, // =, :`. The filter syntax is the same as described in Stackdriver's -// Advanced Logs Filters. Sample filter "state: PAUSED". Note that using -// filters might cause fewer queues than the requested page_size to be -// returned. +// Advanced Logs Filters +// (https://cloud.google.com/logging/docs/view/advanced_filters). Sample +// filter "state: PAUSED". Note that using filters might cause fewer +// queues than the requested page_size to be returned. func (c *ProjectsLocationsQueuesListCall) Filter(filter string) *ProjectsLocationsQueuesListCall { c.urlParams_.Set("filter", filter) return c @@ -3111,7 +3196,9 @@ type ProjectsLocationsQueuesPatchCall struct { // it was dispatched or not. WARNING: Using this method may have // unintended side effects if you are using an App Engine `queue.yaml` // or `queue.xml` file to manage your queues. Read Overview of Queue -// Management and queue.yaml before using this method. +// Management and queue.yaml +// (https://cloud.google.com/tasks/docs/queue-yaml) before using this +// method. func (r *ProjectsLocationsQueuesService) Patch(name string, queue *Queue) *ProjectsLocationsQueuesPatchCall { c := &ProjectsLocationsQueuesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3556,7 +3643,8 @@ type ProjectsLocationsQueuesResumeCall struct { // state; after calling this method it will be set to RUNNING. WARNING: // Resuming many high-QPS queues at the same time can lead to target // overloading. If you are resuming high-QPS queues, follow the 500/50/5 -// pattern described in Managing Cloud Tasks Scaling Risks. +// pattern described in Managing Cloud Tasks Scaling Risks +// (https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). func (r *ProjectsLocationsQueuesService) Resume(name string, resumequeuerequest *ResumeQueueRequest) *ProjectsLocationsQueuesResumeCall { c := &ProjectsLocationsQueuesResumeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3700,8 +3788,8 @@ type ProjectsLocationsQueuesSetIamPolicyCall struct { // any existing policy. Note: The Cloud Console does not check // queue-level IAM permissions yet. Project-level permissions are // required to use the Cloud Console. Authorization requires the -// following Google IAM permission on the specified resource parent: * -// `cloudtasks.queues.setIamPolicy` +// following Google IAM (https://cloud.google.com/iam) permission on the +// specified resource parent: * `cloudtasks.queues.setIamPolicy` func (r *ProjectsLocationsQueuesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsQueuesSetIamPolicyCall { c := &ProjectsLocationsQueuesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -4273,8 +4361,8 @@ func (r *ProjectsLocationsQueuesTasksService) Get(name string) *ProjectsLocation // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` Google IAM permission on the Task -// resource. +// `cloudtasks.tasks.fullView` Google IAM +// (https://cloud.google.com/iam/) permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -4480,8 +4568,8 @@ func (c *ProjectsLocationsQueuesTasksListCall) PageToken(pageToken string) *Proj // default because some data, such as payloads, might be desirable to // return only when needed because of its large size or because of the // sensitivity of data that it contains. Authorization for FULL requires -// `cloudtasks.tasks.fullView` Google IAM permission on the Task -// resource. +// `cloudtasks.tasks.fullView` Google IAM +// (https://cloud.google.com/iam/) permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. diff --git a/cloudtrace/v2/cloudtrace-gen.go b/cloudtrace/v2/cloudtrace-gen.go index a0549a57410..c06b273def0 100644 --- a/cloudtrace/v2/cloudtrace-gen.go +++ b/cloudtrace/v2/cloudtrace-gen.go @@ -637,7 +637,8 @@ type StackFrame struct { LoadModule *Module `json:"loadModule,omitempty"` // OriginalFunctionName: An un-mangled function name, if `function_name` - // is mangled. The name can be fully-qualified (up to 1024 bytes). + // is mangled (http://www.avabodh.com/cxxin/namemangling.html). The name + // can be fully-qualified (up to 1024 bytes). OriginalFunctionName *TruncatableString `json:"originalFunctionName,omitempty"` // SourceVersion: The version of the deployed source code (up to 128 @@ -740,10 +741,11 @@ func (s *StackTrace) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/cloudtrace/v2beta1/cloudtrace-gen.go b/cloudtrace/v2beta1/cloudtrace-gen.go index f49478174fa..2f72182e24c 100644 --- a/cloudtrace/v2beta1/cloudtrace-gen.go +++ b/cloudtrace/v2beta1/cloudtrace-gen.go @@ -268,9 +268,13 @@ type TraceSink struct { // data. This field is set by sinks.create and sinks.update. The service // account will need to be granted write access to the destination // specified in the output configuration, see Granting access for a - // resource. To create tables and write data this account will need the - // dataEditor role. Read more about roles in the BigQuery documentation. - // E.g.: "service-00000001@00000002.iam.gserviceaccount.com" + // resource + // (/iam/docs/granting-roles-to-service-accounts#granting_access_to_a_ser + // vice_account_for_a_resource). To create tables and write data this + // account will need the dataEditor role. Read more about roles in the + // BigQuery documentation + // (https://cloud.google.com/bigquery/docs/access-control). E.g.: + // "service-00000001@00000002.iam.gserviceaccount.com" WriterIdentity string `json:"writerIdentity,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/composer/v1/composer-gen.go b/composer/v1/composer-gen.go index 8379c9c22e9..735c488cc8c 100644 --- a/composer/v1/composer-gen.go +++ b/composer/v1/composer-gen.go @@ -367,7 +367,8 @@ func (s *Environment) MarshalJSON() ([]byte, error) { // EnvironmentConfig: Configuration information for an environment. type EnvironmentConfig struct { // AirflowUri: Output only. The URI of the Apache Airflow Web UI hosted - // within this environment (see Airflow web interface). + // within this environment (see Airflow web interface + // (/composer/docs/how-to/accessing/airflow-web-interface)). AirflowUri string `json:"airflowUri,omitempty"` // DagGcsPrefix: Output only. The Cloud Storage prefix of the DAGs for @@ -431,10 +432,11 @@ type IPAllocationPolicy struct { // IP addresses to pods in the GKE cluster. This field is applicable // only when `use_ip_aliases` is true. Set to blank to have GKE choose a // range with the default size. Set to /netmask (e.g. `/14`) to have GKE - // choose a range with a specific netmask. Set to a CIDR notation (e.g. - // `10.96.0.0/14`) from the RFC-1918 private networks (e.g. - // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific - // range to use. + // choose a range with a specific netmask. Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. ClusterIpv4CidrBlock string `json:"clusterIpv4CidrBlock,omitempty"` // ClusterSecondaryRangeName: Optional. The name of the GKE cluster's @@ -446,10 +448,11 @@ type IPAllocationPolicy struct { // IP addresses in this GKE cluster. This field is applicable only when // `use_ip_aliases` is true. Set to blank to have GKE choose a range // with the default size. Set to /netmask (e.g. `/14`) to have GKE - // choose a range with a specific netmask. Set to a CIDR notation (e.g. - // `10.96.0.0/14`) from the RFC-1918 private networks (e.g. - // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific - // range to use. + // choose a range with a specific netmask. Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. ServicesIpv4CidrBlock string `json:"servicesIpv4CidrBlock,omitempty"` // ServicesSecondaryRangeName: Optional. The name of the services' @@ -656,22 +659,25 @@ type NodeConfig struct { // IPs are allocated in the GKE cluster. IpAllocationPolicy *IPAllocationPolicy `json:"ipAllocationPolicy,omitempty"` - // Location: Optional. The Compute Engine zone in which to deploy the - // VMs used to run the Apache Airflow software, specified as a relative - // resource name. For example: "projects/{projectId}/zones/{zoneId}". - // This `location` must belong to the enclosing environment's project - // and location. If both this field and `nodeConfig.machineType` are - // specified, `nodeConfig.machineType` must belong to this `location`; - // if both are unspecified, the service will pick a zone in the Compute - // Engine region corresponding to the Cloud Composer location, and - // propagate that choice to both fields. If only one field (`location` - // or `nodeConfig.machineType`) is specified, the location information - // from the specified field will be propagated to the unspecified field. + // Location: Optional. The Compute Engine zone + // (/compute/docs/regions-zones) in which to deploy the VMs used to run + // the Apache Airflow software, specified as a relative resource name + // (/apis/design/resource_names#relative_resource_name). For example: + // "projects/{projectId}/zones/{zoneId}". This `location` must belong to + // the enclosing environment's project and location. If both this field + // and `nodeConfig.machineType` are specified, `nodeConfig.machineType` + // must belong to this `location`; if both are unspecified, the service + // will pick a zone in the Compute Engine region corresponding to the + // Cloud Composer location, and propagate that choice to both fields. If + // only one field (`location` or `nodeConfig.machineType`) is specified, + // the location information from the specified field will be propagated + // to the unspecified field. Location string `json:"location,omitempty"` - // MachineType: Optional. The Compute Engine machine type used for - // cluster instances, specified as a relative resource name. For - // example: + // MachineType: Optional. The Compute Engine machine type + // (/compute/docs/machine-types) used for cluster instances, specified + // as a relative resource name + // (/apis/design/resource_names#relative_resource_name). For example: // "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}". // The `machineType` must belong to the enclosing environment's project // and location. If both this field and `nodeConfig.location` are @@ -682,17 +688,19 @@ type NodeConfig struct { // exactly one of this field and `nodeConfig.location` is specified, the // location information from the specified field will be propagated to // the unspecified field. The `machineTypeId` must not be a shared-core - // machine type. If this field is unspecified, the `machineTypeId` - // defaults to "n1-standard-1". + // machine type (/compute/docs/machine-types#sharedcore). If this field + // is unspecified, the `machineTypeId` defaults to "n1-standard-1". MachineType string `json:"machineType,omitempty"` // Network: Optional. The Compute Engine network to be used for machine - // communications, specified as a relative resource name. For example: - // "projects/{projectId}/global/networks/{networkId}". Shared VPC is not - // currently supported. The network must belong to the environment's - // project. If unspecified, the "default" network ID in the - // environment's project is used. If a Custom Subnet Network is - // provided, `nodeConfig.subnetwork` must also be provided. + // communications, specified as a relative resource name + // (/apis/design/resource_names#relative_resource_name). For example: + // "projects/{projectId}/global/networks/{networkId}". Shared VPC + // (/vpc/docs/shared-vpc) is not currently supported. The network must + // belong to the environment's project. If unspecified, the "default" + // network ID in the environment's project is used. If a Custom Subnet + // Network (/vpc/docs/vpc#vpc_networks_and_subnets) is provided, + // `nodeConfig.subnetwork` must also be provided. Network string `json:"network,omitempty"` // OauthScopes: Optional. The set of Google API scopes to be made @@ -708,8 +716,8 @@ type NodeConfig struct { ServiceAccount string `json:"serviceAccount,omitempty"` // Subnetwork: Optional. The Compute Engine subnetwork to be used for - // machine communications, specified as a relative resource name. For - // example: + // machine communications, specified as a relative resource name + // (/apis/design/resource_names#relative_resource_name). For example: // "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}" // If a subnetwork is provided, `nodeConfig.network` must also be // provided, and the subnetwork must belong to the enclosing @@ -718,8 +726,8 @@ type NodeConfig struct { // Tags: Optional. The list of instance tags applied to all node VMs. // Tags are used to identify valid sources or targets for network - // firewalls. Each tag within the list must comply with RFC1035. Cannot - // be updated. + // firewalls. Each tag within the list must comply with RFC1035 + // (https://www.ietf.org/rfc/rfc1035.txt). Cannot be updated. Tags []string `json:"tags,omitempty"` // ForceSendFields is a list of field names (e.g. "DiskSizeGb") to @@ -828,7 +836,7 @@ type OperationMetadata struct { OperationType string `json:"operationType,omitempty"` // Resource: Output only. The resource being operated on, as a relative - // resource name. + // resource name ( /apis/design/resource_names#relative_resource_name). Resource string `json:"resource,omitempty"` // ResourceUuid: Output only. The UUID of the resource being operated @@ -977,10 +985,12 @@ type SoftwareConfig struct { // brackets ("]"). The property name must not be empty and must not // contain an equals sign ("=") or semicolon (";"). Section and property // names must not contain a period ("."). Apache Airflow configuration - // property names must be written in snake_case. Property values can + // property names must be written in snake_case + // (https://en.wikipedia.org/wiki/Snake_case). Property values can // contain any character, and can be written in any lower/upper case // format. Certain Apache Airflow configuration property values are - // blocked, and cannot be overridden. + // blocked (/composer/docs/concepts/airflow-configurations), and cannot + // be overridden. AirflowConfigOverrides map[string]string `json:"airflowConfigOverrides,omitempty"` // EnvVariables: Optional. Additional environment variables to provide @@ -1003,13 +1013,15 @@ type SoftwareConfig struct { // 9]+.*)?`. When used as input, the server also checks if the provided // version is supported and denies the request for an unsupported // version. The Cloud Composer portion of the version is a semantic - // version or `latest`. When the patch version is omitted, the current - // Cloud Composer patch version is selected. When `latest` is provided - // instead of an explicit version number, the server replaces `latest` - // with the current Cloud Composer version and stores that version - // number in the same field. The portion of the image version that - // follows *airflow-* is an official Apache Airflow repository release - // name. See also Version List. + // version (https://semver.org) or `latest`. When the patch version is + // omitted, the current Cloud Composer patch version is selected. When + // `latest` is provided instead of an explicit version number, the + // server replaces `latest` with the current Cloud Composer version and + // stores that version number in the same field. The portion of the + // image version that follows *airflow-* is an official Apache Airflow + // repository release name + // (https://github.com/apache/incubator-airflow/releases). See also + // Version List (/composer/docs/concepts/versioning/composer-versions). ImageVersion string `json:"imageVersion,omitempty"` // PypiPackages: Optional. Custom Python Package Index (PyPI) packages @@ -1053,10 +1065,11 @@ func (s *SoftwareConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/composer/v1beta1/composer-gen.go b/composer/v1beta1/composer-gen.go index cfb2ecf761b..810298b944f 100644 --- a/composer/v1beta1/composer-gen.go +++ b/composer/v1beta1/composer-gen.go @@ -430,7 +430,8 @@ func (s *Environment) MarshalJSON() ([]byte, error) { // EnvironmentConfig: Configuration information for an environment. type EnvironmentConfig struct { // AirflowUri: Output only. The URI of the Apache Airflow Web UI hosted - // within this environment (see Airflow web interface). + // within this environment (see Airflow web interface + // (/composer/docs/how-to/accessing/airflow-web-interface)). AirflowUri string `json:"airflowUri,omitempty"` // DagGcsPrefix: Output only. The Cloud Storage prefix of the DAGs for @@ -518,10 +519,11 @@ type IPAllocationPolicy struct { // IP addresses to pods in the cluster. This field is applicable only // when `use_ip_aliases` is true. Set to blank to have GKE choose a // range with the default size. Set to /netmask (e.g. `/14`) to have GKE - // choose a range with a specific netmask. Set to a CIDR notation (e.g. - // `10.96.0.0/14`) from the RFC-1918 private networks (e.g. - // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific - // range to use. Specify `cluster_secondary_range_name` or + // choose a range with a specific netmask. Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. Specify `cluster_secondary_range_name` or // `cluster_ipv4_cidr_block` but not both. ClusterIpv4CidrBlock string `json:"clusterIpv4CidrBlock,omitempty"` @@ -535,10 +537,11 @@ type IPAllocationPolicy struct { // IP addresses in this cluster. This field is applicable only when // `use_ip_aliases` is true. Set to blank to have GKE choose a range // with the default size. Set to /netmask (e.g. `/14`) to have GKE - // choose a range with a specific netmask. Set to a CIDR notation (e.g. - // `10.96.0.0/14`) from the RFC-1918 private networks (e.g. - // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific - // range to use. Specify `services_secondary_range_name` or + // choose a range with a specific netmask. Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. Specify `services_secondary_range_name` or // `services_ipv4_cidr_block` but not both. ServicesIpv4CidrBlock string `json:"servicesIpv4CidrBlock,omitempty"` @@ -749,9 +752,10 @@ type MaintenanceWindow struct { EndTime string `json:"endTime,omitempty"` // Recurrence: Required. Maintenance window recurrence. Format is a - // subset of RFC-5545 `RRULE`. The only allowed values for `FREQ` field - // are `FREQ=DAILY` and `FREQ=WEEKLY;BYDAY=...` Example values: - // `FREQ=WEEKLY;BYDAY=TU,WE`, `FREQ=DAILY`. + // subset of RFC-5545 (https://tools.ietf.org/html/rfc5545) `RRULE`. The + // only allowed values for `FREQ` field are `FREQ=DAILY` and + // `FREQ=WEEKLY;BYDAY=...` Example values: `FREQ=WEEKLY;BYDAY=TU,WE`, + // `FREQ=DAILY`. Recurrence string `json:"recurrence,omitempty"` // StartTime: Required. Start time of the first recurrence of the @@ -792,22 +796,25 @@ type NodeConfig struct { // GKE cluster. IpAllocationPolicy *IPAllocationPolicy `json:"ipAllocationPolicy,omitempty"` - // Location: Optional. The Compute Engine zone in which to deploy the - // VMs used to run the Apache Airflow software, specified as a relative - // resource name. For example: "projects/{projectId}/zones/{zoneId}". - // This `location` must belong to the enclosing environment's project - // and location. If both this field and `nodeConfig.machineType` are - // specified, `nodeConfig.machineType` must belong to this `location`; - // if both are unspecified, the service will pick a zone in the Compute - // Engine region corresponding to the Cloud Composer location, and - // propagate that choice to both fields. If only one field (`location` - // or `nodeConfig.machineType`) is specified, the location information - // from the specified field will be propagated to the unspecified field. + // Location: Optional. The Compute Engine zone + // (/compute/docs/regions-zones) in which to deploy the VMs used to run + // the Apache Airflow software, specified as a relative resource name + // (/apis/design/resource_names#relative_resource_name). For example: + // "projects/{projectId}/zones/{zoneId}". This `location` must belong to + // the enclosing environment's project and location. If both this field + // and `nodeConfig.machineType` are specified, `nodeConfig.machineType` + // must belong to this `location`; if both are unspecified, the service + // will pick a zone in the Compute Engine region corresponding to the + // Cloud Composer location, and propagate that choice to both fields. If + // only one field (`location` or `nodeConfig.machineType`) is specified, + // the location information from the specified field will be propagated + // to the unspecified field. Location string `json:"location,omitempty"` - // MachineType: Optional. The Compute Engine machine type used for - // cluster instances, specified as a relative resource name. For - // example: + // MachineType: Optional. The Compute Engine machine type + // (/compute/docs/machine-types) used for cluster instances, specified + // as a relative resource name + // (/apis/design/resource_names#relative_resource_name). For example: // "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}". // The `machineType` must belong to the enclosing environment's project // and location. If both this field and `nodeConfig.location` are @@ -818,8 +825,8 @@ type NodeConfig struct { // exactly one of this field and `nodeConfig.location` is specified, the // location information from the specified field will be propagated to // the unspecified field. The `machineTypeId` must not be a shared-core - // machine type. If this field is unspecified, the `machineTypeId` - // defaults to "n1-standard-1". + // machine type (/compute/docs/machine-types#sharedcore). If this field + // is unspecified, the `machineTypeId` defaults to "n1-standard-1". MachineType string `json:"machineType,omitempty"` // MaxPodsPerNode: Optional. The maximum number of pods per node in the @@ -836,11 +843,13 @@ type NodeConfig struct { MaxPodsPerNode int64 `json:"maxPodsPerNode,omitempty"` // Network: Optional. The Compute Engine network to be used for machine - // communications, specified as a relative resource name. For example: + // communications, specified as a relative resource name + // (/apis/design/resource_names#relative_resource_name). For example: // "projects/{projectId}/global/networks/{networkId}". If unspecified, // the default network in the environment's project is used. If a Custom - // Subnet Network is provided, `nodeConfig.subnetwork` must also be - // provided. For Shared VPC subnetwork requirements, see + // Subnet Network (/vpc/docs/vpc#vpc_networks_and_subnets) is provided, + // `nodeConfig.subnetwork` must also be provided. For Shared VPC + // (/vpc/docs/shared-vpc) subnetwork requirements, see // `nodeConfig.subnetwork`. Network string `json:"network,omitempty"` @@ -857,8 +866,8 @@ type NodeConfig struct { ServiceAccount string `json:"serviceAccount,omitempty"` // Subnetwork: Optional. The Compute Engine subnetwork to be used for - // machine communications, specified as a relative resource name. For - // example: + // machine communications, specified as a relative resource name + // (/apis/design/resource_names#relative_resource_name). For example: // "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}" // If a subnetwork is provided, `nodeConfig.network` must also be // provided, and the subnetwork must belong to the enclosing @@ -867,8 +876,8 @@ type NodeConfig struct { // Tags: Optional. The list of instance tags applied to all node VMs. // Tags are used to identify valid sources or targets for network - // firewalls. Each tag within the list must comply with RFC1035. Cannot - // be updated. + // firewalls. Each tag within the list must comply with RFC1035 + // (https://www.ietf.org/rfc/rfc1035.txt). Cannot be updated. Tags []string `json:"tags,omitempty"` // ForceSendFields is a list of field names (e.g. "DiskSizeGb") to @@ -977,7 +986,7 @@ type OperationMetadata struct { OperationType string `json:"operationType,omitempty"` // Resource: Output only. The resource being operated on, as a relative - // resource name. + // resource name ( /apis/design/resource_names#relative_resource_name). Resource string `json:"resource,omitempty"` // ResourceUuid: Output only. The UUID of the resource being operated @@ -1129,10 +1138,12 @@ type SoftwareConfig struct { // brackets ("]"). The property name must not be empty and must not // contain an equals sign ("=") or semicolon (";"). Section and property // names must not contain a period ("."). Apache Airflow configuration - // property names must be written in snake_case. Property values can + // property names must be written in snake_case + // (https://en.wikipedia.org/wiki/Snake_case). Property values can // contain any character, and can be written in any lower/upper case // format. Certain Apache Airflow configuration property values are - // blocked, and cannot be overridden. + // blocked (/composer/docs/concepts/airflow-configurations), and cannot + // be overridden. AirflowConfigOverrides map[string]string `json:"airflowConfigOverrides,omitempty"` // EnvVariables: Optional. Additional environment variables to provide @@ -1155,13 +1166,15 @@ type SoftwareConfig struct { // 9]+.*)?`. When used as input, the server also checks if the provided // version is supported and denies the request for an unsupported // version. The Cloud Composer portion of the version is a semantic - // version or `latest`. When the patch version is omitted, the current - // Cloud Composer patch version is selected. When `latest` is provided - // instead of an explicit version number, the server replaces `latest` - // with the current Cloud Composer version and stores that version - // number in the same field. The portion of the image version that - // follows *airflow-* is an official Apache Airflow repository release - // name. See also Version List. + // version (https://semver.org) or `latest`. When the patch version is + // omitted, the current Cloud Composer patch version is selected. When + // `latest` is provided instead of an explicit version number, the + // server replaces `latest` with the current Cloud Composer version and + // stores that version number in the same field. The portion of the + // image version that follows *airflow-* is an official Apache Airflow + // repository release name + // (https://github.com/apache/incubator-airflow/releases). See also + // Version List (/composer/docs/concepts/versioning/composer-versions). ImageVersion string `json:"imageVersion,omitempty"` // PypiPackages: Optional. Custom Python Package Index (PyPI) packages @@ -1205,10 +1218,11 @@ func (s *SoftwareConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index a08dae288de..f35dcdf5401 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -3347,7 +3347,9 @@ func (s *AuthorizationLoggingOptions) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Autoscaler resources: // -// * Zonal * Regional +// * Zonal (/compute/docs/reference/rest/{$api_version}/autoscalers) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionAutoscalers) // // Use autoscalers to automatically add or delete instances from a // managed instance group according to your defined autoscaling policy. @@ -5185,9 +5187,13 @@ func (s *BackendBucketListWarningData) MarshalJSON() ([]byte, error) { // Backend services in Google Compute Engine can be either regionally or // globally scoped. // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/backendServices) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionBackendServices) // -// For more information, see Backend Services. +// F +// or more information, see Backend Services. // // (== resource_for {$api_version}.backendService ==) type BackendService struct { @@ -6826,7 +6832,8 @@ type Binding struct { // binding. // // To learn which resources support conditions in their IAM policies, - // see the IAM documentation. + // see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -8289,7 +8296,9 @@ func (s *DeprecationStatus) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk resources: // -// * Zonal * Regional +// * Zonal (/compute/docs/reference/rest/{$api_version}/disks) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionDisks) // // Persistent disks are required for running your VM instances. Create // both boot and non-boot (data) persistent disks. For more information, @@ -9072,7 +9081,9 @@ func (s *DiskMoveRequest) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk Type resources: // -// * Regional * Zonal +// * Regional +// (/compute/docs/reference/rest/{$api_version}/regionDiskTypes) * Zonal +// (/compute/docs/reference/rest/{$api_version}/diskTypes) // // You can choose from a variety of disk types based on your needs. For // more information, read Storage options. @@ -11559,7 +11570,10 @@ func (s *FixedOrPercent) MarshalJSON() ([]byte, error) { // Forwarding rule resources in GCP can be either regional or global in // scope: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/globalForwardingRules) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/forwardingRules) // // A forwarding rule and its corresponding IP address represent the // frontend configuration of a Google Cloud Platform load balancer. @@ -11589,7 +11603,9 @@ type ForwardingRule struct { // // The loadBalancingScheme and the forwarding rule's target determine // the type of IP address that you can use. For detailed information, - // refer to IP address specifications. + // refer to IP address specifications + // (/load-balancing/docs/forwarding-rule-concepts#ip_address_specificatio + // ns). // // Must be set to `0.0.0.0` when the target is targetGrpcProxy that has // validateForProxyless field set to true. @@ -11834,7 +11850,8 @@ type ForwardingRule struct { // For Internal TCP/UDP Load Balancing, if you specify allPorts, you // should not specify ports. // - // For more information, see Port specifications. + // For more information, see Port specifications + // (/load-balancing/docs/forwarding-rule-concepts#port_specifications). Ports []string `json:"ports,omitempty"` // Region: [Output Only] URL of the region where the regional forwarding @@ -11894,7 +11911,9 @@ type ForwardingRule struct { // same region as the forwarding rule. For global forwarding rules, this // target must be a global load balancing resource. The forwarded // traffic must be of a type appropriate to the target object. For more - // information, see the "Target" column in Port specifications. + // information, see the "Target" column in Port specifications + // (/load-balancing/docs/forwarding-rule-concepts#ip_address_specificatio + // ns). // // For Private Service Connect forwarding rules that forward traffic to // Google APIs, provide the name of a supported Google API bundle. @@ -13107,9 +13126,12 @@ func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Health Check resources: // -// * Global * Regional +// * Global (/compute/docs/reference/rest/{$api_version}/healthChecks) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionHealthChecks) // -// Internal HTTP(S) load balancers must use regional health checks +// Inte +// rnal HTTP(S) load balancers must use regional health checks // (`compute.v1.regionHealthChecks`). // // Traffic Director must use global health checks @@ -30203,7 +30225,12 @@ func (s *NotificationEndpointListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has three Operation resources: // -// * Global * Regional * Zonal +// * Global +// (/compute/docs/reference/rest/{$api_version}/globalOperations) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionOperations) * +// Zonal +// (/compute/docs/reference/rest/{$api_version}/zoneOperations) // // You can use an operation resource to manage asynchronous API // requests. For more information, read Handling API @@ -32335,9 +32362,11 @@ func (s *PermissionConstraint) MarshalJSON() ([]byte, error) { // access to a resource only if the expression evaluates to `true`. A // condition can add constraints based on attributes of the request, the // resource, or both. To learn which resources support conditions in -// their IAM policies, see the IAM documentation. +// their IAM policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). // -// **JSON example:** +// **J +// SON example:** // // { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", // "members": [ "user:mike@example.com", "group:admins@example.com", @@ -32361,7 +32390,8 @@ func (s *PermissionConstraint) MarshalJSON() ([]byte, error) { // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 // -// For a description of IAM and its features, see the IAM documentation. +// For a description of IAM and its features, see the IAM documentation +// (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -32422,7 +32452,8 @@ type Policy struct { // policy may specify any valid version or leave the field unset. // // To learn which resources support conditions in their IAM policies, - // see the IAM documentation. + // see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -42562,7 +42593,11 @@ func (s *SourceInstanceProperties) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two SSL Certificate resources: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/sslCertificates) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionSslCertificates) +// // // // @@ -45216,7 +45251,11 @@ func (s *TargetHttpProxiesScopedListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Target HTTP Proxy resources: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/targetHttpProxies) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionTargetHttpProxies) +// // // A target HTTP proxy is a component of GCP HTTP load balancers. // @@ -45880,7 +45919,11 @@ func (s *TargetHttpsProxiesSetSslCertificatesRequest) MarshalJSON() ([]byte, err // // Google Compute Engine has two Target HTTPS Proxy resources: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/targetHttpsProxies) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionTargetHttpsProxies) +// // // A target HTTPS proxy is a component of GCP HTTPS load balancers. // @@ -49325,7 +49368,9 @@ func (s *UpcomingMaintenance) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two URL Map resources: // -// * Global * Regional +// * Global (/compute/docs/reference/rest/{$api_version}/urlMaps) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionUrlMaps) // // A URL map resource is a component of certain types of GCP load // balancers and Traffic Director. @@ -152836,7 +152881,8 @@ type RegionUrlMapsInvalidateCacheCall struct { // InvalidateCache: Initiates a cache invalidation operation, // invalidating the specified path, scoped to the specified UrlMap. // -// For more information, see Invalidating cached content. +// For more information, see Invalidating cached content +// (/cdn/docs/invalidating-cached-content). func (r *RegionUrlMapsService) InvalidateCache(project string, region string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *RegionUrlMapsInvalidateCacheCall { c := &RegionUrlMapsInvalidateCacheCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project @@ -184561,7 +184607,8 @@ type UrlMapsInvalidateCacheCall struct { // InvalidateCache: Initiates a cache invalidation operation, // invalidating the specified path, scoped to the specified UrlMap. // -// For more information, see Invalidating cached content. +// For more information, see Invalidating cached content +// (/cdn/docs/invalidating-cached-content). func (r *UrlMapsService) InvalidateCache(project string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *UrlMapsInvalidateCacheCall { c := &UrlMapsInvalidateCacheCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index c9845c37057..722c71a5443 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -3010,7 +3010,9 @@ func (s *AuthorizationLoggingOptions) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Autoscaler resources: // -// * Zonal * Regional +// * Zonal (/compute/docs/reference/rest/{$api_version}/autoscalers) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionAutoscalers) // // Use autoscalers to automatically add or delete instances from a // managed instance group according to your defined autoscaling policy. @@ -4830,9 +4832,13 @@ func (s *BackendBucketListWarningData) MarshalJSON() ([]byte, error) { // Backend services in Google Compute Engine can be either regionally or // globally scoped. // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/backendServices) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionBackendServices) // -// For more information, see Backend Services. +// F +// or more information, see Backend Services. // // (== resource_for {$api_version}.backendService ==) type BackendService struct { @@ -6399,7 +6405,8 @@ type Binding struct { // binding. // // To learn which resources support conditions in their IAM policies, - // see the IAM documentation. + // see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -7640,7 +7647,9 @@ func (s *DeprecationStatus) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk resources: // -// * Zonal * Regional +// * Zonal (/compute/docs/reference/rest/{$api_version}/disks) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionDisks) // // Persistent disks are required for running your VM instances. Create // both boot and non-boot (data) persistent disks. For more information, @@ -8367,7 +8376,9 @@ func (s *DiskMoveRequest) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk Type resources: // -// * Regional * Zonal +// * Regional +// (/compute/docs/reference/rest/{$api_version}/regionDiskTypes) * Zonal +// (/compute/docs/reference/rest/{$api_version}/diskTypes) // // You can choose from a variety of disk types based on your needs. For // more information, read Storage options. @@ -10549,7 +10560,10 @@ func (s *FixedOrPercent) MarshalJSON() ([]byte, error) { // Forwarding rule resources in GCP can be either regional or global in // scope: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/globalForwardingRules) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/forwardingRules) // // A forwarding rule and its corresponding IP address represent the // frontend configuration of a Google Cloud Platform load balancer. @@ -10579,7 +10593,9 @@ type ForwardingRule struct { // // The loadBalancingScheme and the forwarding rule's target determine // the type of IP address that you can use. For detailed information, - // refer to IP address specifications. + // refer to IP address specifications + // (/load-balancing/docs/forwarding-rule-concepts#ip_address_specificatio + // ns). // // Must be set to `0.0.0.0` when the target is targetGrpcProxy that has // validateForProxyless field set to true. @@ -10819,7 +10835,8 @@ type ForwardingRule struct { // For Internal TCP/UDP Load Balancing, if you specify allPorts, you // should not specify ports. // - // For more information, see Port specifications. + // For more information, see Port specifications + // (/load-balancing/docs/forwarding-rule-concepts#port_specifications). Ports []string `json:"ports,omitempty"` // Region: [Output Only] URL of the region where the regional forwarding @@ -10875,7 +10892,9 @@ type ForwardingRule struct { // same region as the forwarding rule. For global forwarding rules, this // target must be a global load balancing resource. The forwarded // traffic must be of a type appropriate to the target object. For more - // information, see the "Target" column in Port specifications. + // information, see the "Target" column in Port specifications + // (/load-balancing/docs/forwarding-rule-concepts#ip_address_specificatio + // ns). // // For Private Service Connect forwarding rules that forward traffic to // Google APIs, provide the name of a supported Google API bundle. @@ -12020,9 +12039,12 @@ func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Health Check resources: // -// * Global * Regional +// * Global (/compute/docs/reference/rest/{$api_version}/healthChecks) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionHealthChecks) // -// Internal HTTP(S) load balancers must use regional health checks +// Inte +// rnal HTTP(S) load balancers must use regional health checks // (`compute.v1.regionHealthChecks`). // // Traffic Director must use global health checks @@ -27496,7 +27518,12 @@ func (s *NotificationEndpointListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has three Operation resources: // -// * Global * Regional * Zonal +// * Global +// (/compute/docs/reference/rest/{$api_version}/globalOperations) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionOperations) * +// Zonal +// (/compute/docs/reference/rest/{$api_version}/zoneOperations) // // You can use an operation resource to manage asynchronous API // requests. For more information, read Handling API @@ -29472,9 +29499,11 @@ func (s *PerInstanceConfig) MarshalJSON() ([]byte, error) { // access to a resource only if the expression evaluates to `true`. A // condition can add constraints based on attributes of the request, the // resource, or both. To learn which resources support conditions in -// their IAM policies, see the IAM documentation. +// their IAM policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). // -// **JSON example:** +// **J +// SON example:** // // { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", // "members": [ "user:mike@example.com", "group:admins@example.com", @@ -29498,7 +29527,8 @@ func (s *PerInstanceConfig) MarshalJSON() ([]byte, error) { // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 // -// For a description of IAM and its features, see the IAM documentation. +// For a description of IAM and its features, see the IAM documentation +// (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -29559,7 +29589,8 @@ type Policy struct { // policy may specify any valid version or leave the field unset. // // To learn which resources support conditions in their IAM policies, - // see the IAM documentation. + // see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -37535,7 +37566,11 @@ func (s *SourceInstanceProperties) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two SSL Certificate resources: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/sslCertificates) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionSslCertificates) +// // // // @@ -40046,7 +40081,11 @@ func (s *TargetHttpProxiesScopedListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Target HTTP Proxy resources: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/targetHttpProxies) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionTargetHttpProxies) +// // // A target HTTP proxy is a component of GCP HTTP load balancers. // @@ -40677,7 +40716,11 @@ func (s *TargetHttpsProxiesSetSslCertificatesRequest) MarshalJSON() ([]byte, err // // Google Compute Engine has two Target HTTPS Proxy resources: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/targetHttpsProxies) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionTargetHttpsProxies) +// // // A target HTTPS proxy is a component of GCP HTTPS load balancers. // @@ -43791,7 +43834,9 @@ func (s *TestPermissionsResponse) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two URL Map resources: // -// * Global * Regional +// * Global (/compute/docs/reference/rest/{$api_version}/urlMaps) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionUrlMaps) // // A URL map resource is a component of certain types of GCP load // balancers and Traffic Director. @@ -133084,7 +133129,8 @@ type RegionUrlMapsInvalidateCacheCall struct { // InvalidateCache: Initiates a cache invalidation operation, // invalidating the specified path, scoped to the specified UrlMap. // -// For more information, see Invalidating cached content. +// For more information, see Invalidating cached content +// (/cdn/docs/invalidating-cached-content). func (r *RegionUrlMapsService) InvalidateCache(project string, region string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *RegionUrlMapsInvalidateCacheCall { c := &RegionUrlMapsInvalidateCacheCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project @@ -162506,7 +162552,8 @@ type UrlMapsInvalidateCacheCall struct { // InvalidateCache: Initiates a cache invalidation operation, // invalidating the specified path, scoped to the specified UrlMap. // -// For more information, see Invalidating cached content. +// For more information, see Invalidating cached content +// (/cdn/docs/invalidating-cached-content). func (r *UrlMapsService) InvalidateCache(project string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *UrlMapsInvalidateCacheCall { c := &UrlMapsInvalidateCacheCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index 17a7afb9ebb..6c227847e59 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -2920,7 +2920,9 @@ func (s *AuthorizationLoggingOptions) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Autoscaler resources: // -// * Zonal * Regional +// * Zonal (/compute/docs/reference/rest/{$api_version}/autoscalers) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionAutoscalers) // // Use autoscalers to automatically add or delete instances from a // managed instance group according to your defined autoscaling policy. @@ -4490,9 +4492,13 @@ func (s *BackendBucketListWarningData) MarshalJSON() ([]byte, error) { // Backend services in Google Compute Engine can be either regionally or // globally scoped. // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/backendServices) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionBackendServices) // -// For more information, see Backend Services. +// F +// or more information, see Backend Services. // // (== resource_for {$api_version}.backendService ==) type BackendService struct { @@ -5642,7 +5648,8 @@ type Binding struct { // binding. // // To learn which resources support conditions in their IAM policies, - // see the IAM documentation. + // see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -6848,7 +6855,9 @@ func (s *DeprecationStatus) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk resources: // -// * Zonal * Regional +// * Zonal (/compute/docs/reference/rest/{$api_version}/disks) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionDisks) // // Persistent disks are required for running your VM instances. Create // both boot and non-boot (data) persistent disks. For more information, @@ -7545,7 +7554,9 @@ func (s *DiskMoveRequest) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Disk Type resources: // -// * Regional * Zonal +// * Regional +// (/compute/docs/reference/rest/{$api_version}/regionDiskTypes) * Zonal +// (/compute/docs/reference/rest/{$api_version}/diskTypes) // // You can choose from a variety of disk types based on your needs. For // more information, read Storage options. @@ -9538,7 +9549,10 @@ func (s *FixedOrPercent) MarshalJSON() ([]byte, error) { // Forwarding rule resources in GCP can be either regional or global in // scope: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/globalForwardingRules) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/forwardingRules) // // A forwarding rule and its corresponding IP address represent the // frontend configuration of a Google Cloud Platform load balancer. @@ -9568,7 +9582,9 @@ type ForwardingRule struct { // // The loadBalancingScheme and the forwarding rule's target determine // the type of IP address that you can use. For detailed information, - // refer to IP address specifications. + // refer to IP address specifications + // (/load-balancing/docs/forwarding-rule-concepts#ip_address_specificatio + // ns). // // Must be set to `0.0.0.0` when the target is targetGrpcProxy that has // validateForProxyless field set to true. @@ -9791,7 +9807,8 @@ type ForwardingRule struct { // For Internal TCP/UDP Load Balancing, if you specify allPorts, you // should not specify ports. // - // For more information, see Port specifications. + // For more information, see Port specifications + // (/load-balancing/docs/forwarding-rule-concepts#port_specifications). Ports []string `json:"ports,omitempty"` // Region: [Output Only] URL of the region where the regional forwarding @@ -9839,7 +9856,9 @@ type ForwardingRule struct { // same region as the forwarding rule. For global forwarding rules, this // target must be a global load balancing resource. The forwarded // traffic must be of a type appropriate to the target object. For more - // information, see the "Target" column in Port specifications. + // information, see the "Target" column in Port specifications + // (/load-balancing/docs/forwarding-rule-concepts#ip_address_specificatio + // ns). // // For Private Service Connect forwarding rules that forward traffic to // Google APIs, provide the name of a supported Google API bundle. @@ -10948,9 +10967,12 @@ func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Health Check resources: // -// * Global * Regional +// * Global (/compute/docs/reference/rest/{$api_version}/healthChecks) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionHealthChecks) // -// Internal HTTP(S) load balancers must use regional health checks +// Inte +// rnal HTTP(S) load balancers must use regional health checks // (`compute.v1.regionHealthChecks`). // // Traffic Director must use global health checks @@ -25527,7 +25549,12 @@ func (s *NotificationEndpointListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has three Operation resources: // -// * Global * Regional * Zonal +// * Global +// (/compute/docs/reference/rest/{$api_version}/globalOperations) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionOperations) * +// Zonal +// (/compute/docs/reference/rest/{$api_version}/zoneOperations) // // You can use an operation resource to manage asynchronous API // requests. For more information, read Handling API @@ -27409,9 +27436,11 @@ func (s *PerInstanceConfig) MarshalJSON() ([]byte, error) { // access to a resource only if the expression evaluates to `true`. A // condition can add constraints based on attributes of the request, the // resource, or both. To learn which resources support conditions in -// their IAM policies, see the IAM documentation. +// their IAM policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). // -// **JSON example:** +// **J +// SON example:** // // { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", // "members": [ "user:mike@example.com", "group:admins@example.com", @@ -27435,7 +27464,8 @@ func (s *PerInstanceConfig) MarshalJSON() ([]byte, error) { // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 // -// For a description of IAM and its features, see the IAM documentation. +// For a description of IAM and its features, see the IAM documentation +// (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -27496,7 +27526,8 @@ type Policy struct { // policy may specify any valid version or leave the field unset. // // To learn which resources support conditions in their IAM policies, - // see the IAM documentation. + // see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -34621,7 +34652,11 @@ func (s *SourceInstanceParams) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two SSL Certificate resources: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/sslCertificates) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionSslCertificates) +// // // // @@ -37114,7 +37149,11 @@ func (s *TargetHttpProxiesScopedListWarningData) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two Target HTTP Proxy resources: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/targetHttpProxies) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionTargetHttpProxies) +// // // A target HTTP proxy is a component of GCP HTTP load balancers. // @@ -37631,7 +37670,11 @@ func (s *TargetHttpsProxiesSetSslCertificatesRequest) MarshalJSON() ([]byte, err // // Google Compute Engine has two Target HTTPS Proxy resources: // -// * Global * Regional +// * Global +// (/compute/docs/reference/rest/{$api_version}/targetHttpsProxies) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionTargetHttpsProxies) +// // // A target HTTPS proxy is a component of GCP HTTPS load balancers. // @@ -40696,7 +40739,9 @@ func (s *TestPermissionsResponse) MarshalJSON() ([]byte, error) { // // Google Compute Engine has two URL Map resources: // -// * Global * Regional +// * Global (/compute/docs/reference/rest/{$api_version}/urlMaps) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionUrlMaps) // // A URL map resource is a component of certain types of GCP load // balancers and Traffic Director. @@ -146820,7 +146865,8 @@ type UrlMapsInvalidateCacheCall struct { // InvalidateCache: Initiates a cache invalidation operation, // invalidating the specified path, scoped to the specified UrlMap. // -// For more information, see Invalidating cached content. +// For more information, see Invalidating cached content +// (/cdn/docs/invalidating-cached-content). func (r *UrlMapsService) InvalidateCache(project string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *UrlMapsInvalidateCacheCall { c := &UrlMapsInvalidateCacheCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project diff --git a/container/v1/container-gen.go b/container/v1/container-gen.go index ba3995387b1..52c4fad457e 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -285,6 +285,7 @@ type AcceleratorConfig struct { // AcceleratorType: The accelerator type resource name. List of // supported accelerators here + // (https://cloud.google.com/compute/docs/gpus) AcceleratorType string `json:"acceleratorType,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to @@ -417,7 +418,8 @@ func (s *AuthenticatorGroupsConfig) MarshalJSON() ([]byte, error) { type AutoUpgradeOptions struct { // AutoUpgradeStartTime: [Output only] This field is set when upgrades // are about to commence with the approximate start time for the - // upgrades, in RFC3339 text format. + // upgrades, in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text + // format. AutoUpgradeStartTime string `json:"autoUpgradeStartTime,omitempty"` // Description: [Output only] This field is set when upgrades are about @@ -479,8 +481,10 @@ type AutoprovisioningNodePoolDefaults struct { // pools. The instance may be scheduled on the specified or newer CPU // platform. Applicable values are the friendly names of CPU platforms, // such as minCpuPlatform: Intel Haswell or minCpuPlatform: Intel Sandy - // Bridge. For more information, read how to specify min CPU platform To - // unset the min cpu platform field pass "automatic" as field value. + // Bridge. For more information, read how to specify min CPU platform + // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platf + // orm) To unset the min cpu platform field pass "automatic" as field + // value. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // OauthScopes: Scopes that are used by NAP when creating node pools. @@ -592,13 +596,14 @@ type CancelOperationRequest struct { OperationId string `json:"operationId,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the operation resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // operation resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -744,15 +749,17 @@ type Cluster struct { BinaryAuthorization *BinaryAuthorization `json:"binaryAuthorization,omitempty"` // ClusterIpv4Cidr: The IP address range of the container pods in this - // cluster, in CIDR notation (e.g. `10.96.0.0/14`). Leave blank to have - // one automatically chosen or specify a `/14` block in `10.0.0.0/8`. + // cluster, in CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically + // chosen or specify a `/14` block in `10.0.0.0/8`. ClusterIpv4Cidr string `json:"clusterIpv4Cidr,omitempty"` // Conditions: Which conditions caused the current cluster state. Conditions []*StatusCondition `json:"conditions,omitempty"` // CreateTime: [Output only] The time the cluster was created, in - // RFC3339 text format. + // RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text format. CreateTime string `json:"createTime,omitempty"` // CurrentMasterVersion: [Output only] The current software version of @@ -765,9 +772,11 @@ type Cluster struct { CurrentNodeCount int64 `json:"currentNodeCount,omitempty"` // CurrentNodeVersion: [Output only] Deprecated, use NodePools.version - // instead. The current version of the node software components. If they - // are currently at multiple versions because they're in the process of - // being upgraded, this reflects the minimum version of all nodes. + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro + // jects.locations.clusters.nodePools) instead. The current version of + // the node software components. If they are currently at multiple + // versions because they're in the process of being upgraded, this + // reflects the minimum version of all nodes. CurrentNodeVersion string `json:"currentNodeVersion,omitempty"` // DatabaseEncryption: Configuration of etcd encryption. @@ -800,7 +809,8 @@ type Cluster struct { Endpoint string `json:"endpoint,omitempty"` // ExpireTime: [Output only] The time the cluster will be automatically - // deleted in RFC3339 text format. + // deleted in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text + // format. ExpireTime string `json:"expireTime,omitempty"` // InitialClusterVersion: The initial Kubernetes version for this @@ -817,10 +827,11 @@ type Cluster struct { InitialClusterVersion string `json:"initialClusterVersion,omitempty"` // InitialNodeCount: The number of nodes to create in this cluster. You - // must ensure that your Compute Engine resource quota is sufficient for - // this number of instances. You must also have available firewall and - // routes quota. For requests, this field should only be used in lieu of - // a "node_pool" object, since this configuration (along with the + // must ensure that your Compute Engine resource quota + // (https://cloud.google.com/compute/quotas) is sufficient for this + // number of instances. You must also have available firewall and routes + // quota. For requests, this field should only be used in lieu of a + // "node_pool" object, since this configuration (along with the // "node_config") will be used to create a "NodePool" object with an // auto-generated name. Do not use this and a node_pool at the same // time. This field is deprecated, use node_pool.initial_node_count @@ -840,16 +851,24 @@ type Cluster struct { // LegacyAbac: Configuration for the legacy ABAC authorization mode. LegacyAbac *LegacyAbac `json:"legacyAbac,omitempty"` - // Location: [Output only] The name of the Google Compute Engine zone or - // region in which the cluster resides. + // Location: [Output only] The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava + // ilable) or region + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava + // ilable) in which the cluster resides. Location string `json:"location,omitempty"` - // Locations: The list of Google Compute Engine zones in which the + // Locations: The list of Google Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) in which the // cluster's nodes should be located. This field provides a default - // value if NodePool.Locations are not specified during node pool - // creation. Warning: changing cluster locations will update the - // NodePool.Locations of all node pools and will result in nodes being - // added and/or removed. + // value if NodePool.Locations + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro + // jects.locations.clusters.nodePools#NodePool.FIELDS.locations) are not + // specified during node pool creation. Warning: changing cluster + // locations will update the NodePool.Locations + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro + // jects.locations.clusters.nodePools#NodePool.FIELDS.locations) of all + // node pools and will result in nodes being added and/or removed. Locations []string `json:"locations,omitempty"` // LoggingService: The logging service the cluster should use to write @@ -894,9 +913,10 @@ type Cluster struct { // with a number or a letter. Name string `json:"name,omitempty"` - // Network: The name of the Google Compute Engine network to which the - // cluster is connected. If left unspecified, the `default` network will - // be used. + // Network: The name of the Google Compute Engine network + // (https://cloud.google.com/compute/docs/networks-and-firewalls#networks + // ) to which the cluster is connected. If left unspecified, the + // `default` network will be used. Network string `json:"network,omitempty"` // NetworkConfig: Configuration for cluster networking. @@ -946,9 +966,10 @@ type Cluster struct { SelfLink string `json:"selfLink,omitempty"` // ServicesIpv4Cidr: [Output only] The IP address range of the - // Kubernetes services in this cluster, in CIDR notation (e.g. - // `1.2.3.4/29`). Service addresses are typically put in the last `/16` - // from the container CIDR. + // Kubernetes services in this cluster, in CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `1.2.3.4/29`). Service addresses are typically put in + // the last `/16` from the container CIDR. ServicesIpv4Cidr string `json:"servicesIpv4Cidr,omitempty"` // ShieldedNodes: Shielded Nodes configuration. @@ -980,12 +1001,15 @@ type Cluster struct { // available. StatusMessage string `json:"statusMessage,omitempty"` - // Subnetwork: The name of the Google Compute Engine subnetwork to which - // the cluster is connected. + // Subnetwork: The name of the Google Compute Engine subnetwork + // (https://cloud.google.com/compute/docs/subnetworks) to which the + // cluster is connected. Subnetwork string `json:"subnetwork,omitempty"` // TpuIpv4CidrBlock: [Output only] The IP address range of the Cloud - // TPUs in this cluster, in CIDR notation (e.g. `1.2.3.4/29`). + // TPUs in this cluster, in CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `1.2.3.4/29`). TpuIpv4CidrBlock string `json:"tpuIpv4CidrBlock,omitempty"` // VerticalPodAutoscaling: Cluster-level Vertical Pod Autoscaling @@ -996,9 +1020,9 @@ type Cluster struct { // Service Accounts in GCP IAM policies. WorkloadIdentityConfig *WorkloadIdentityConfig `json:"workloadIdentityConfig,omitempty"` - // Zone: [Output only] The name of the Google Compute Engine zone in - // which the cluster resides. This field is deprecated, use location - // instead. + // Zone: [Output only] The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field is deprecated, use location instead. Zone string `json:"zone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1033,8 +1057,9 @@ func (s *Cluster) MarshalJSON() ([]byte, error) { // the size of the cluster and create/delete node pools based on the // current needs. type ClusterAutoscaling struct { - // AutoprovisioningLocations: The list of Google Compute Engine zones in - // which the NodePool's nodes can be created by NAP. + // AutoprovisioningLocations: The list of Google Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) in which the + // NodePool's nodes can be created by NAP. AutoprovisioningLocations []string `json:"autoprovisioningLocations,omitempty"` // AutoprovisioningNodePoolDefaults: AutoprovisioningNodePoolDefaults @@ -1104,11 +1129,12 @@ type ClusterUpdate struct { // visibility. DesiredIntraNodeVisibilityConfig *IntraNodeVisibilityConfig `json:"desiredIntraNodeVisibilityConfig,omitempty"` - // DesiredLocations: The desired list of Google Compute Engine zones in - // which the cluster's nodes should be located. This list must always - // include the cluster's primary zone. Warning: changing cluster - // locations will update the locations of all node pools and will result - // in nodes being added and/or removed. + // DesiredLocations: The desired list of Google Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster's nodes should be located. This list must always include the + // cluster's primary zone. Warning: changing cluster locations will + // update the locations of all node pools and will result in nodes being + // added and/or removed. DesiredLocations []string `json:"desiredLocations,omitempty"` // DesiredLoggingService: The logging service the cluster should use to @@ -1240,13 +1266,15 @@ type CompleteIPRotationRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number + // (https://developers.google.com/console/help/new/#projectnumber). This + // field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -1335,6 +1363,8 @@ func (s *ConsumptionMeteringConfig) MarshalJSON() ([]byte, error) { // CreateClusterRequest: CreateClusterRequest creates a cluster. type CreateClusterRequest struct { // Cluster: Required. A cluster resource + // (https://cloud.google.com/container-engine/reference/rest/v1/projects. + // locations.clusters) Cluster *Cluster `json:"cluster,omitempty"` // Parent: The parent (project and location) where the cluster will be @@ -1342,13 +1372,14 @@ type CreateClusterRequest struct { Parent string `json:"parent,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // parent field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the parent field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the parent field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // parent field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Cluster") to @@ -1390,13 +1421,15 @@ type CreateNodePoolRequest struct { Parent string `json:"parent,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // parent field. + // project number + // (https://developers.google.com/console/help/new/#projectnumber). This + // field has been deprecated and replaced by the parent field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the parent field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // parent field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -1427,12 +1460,14 @@ func (s *CreateNodePoolRequest) MarshalJSON() ([]byte, error) { type DailyMaintenanceWindow struct { // Duration: [Output only] Duration of the time window, automatically // chosen to be smallest possible in the given scenario. Duration will - // be in RFC3339 format "PTnHnMnS". + // be in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) format + // "PTnHnMnS". Duration string `json:"duration,omitempty"` // StartTime: Time within the maintenance window to start the - // maintenance operations. Time format should be in RFC3339 format - // "HH:MM", where HH : [00-23] and MM : [00-59] GMT. + // maintenance operations. Time format should be in RFC3339 + // (https://www.ietf.org/rfc/rfc3339.txt) format "HH:MM", where HH : + // [00-23] and MM : [00-59] GMT. StartTime string `json:"startTime,omitempty"` // ForceSendFields is a list of field names (e.g. "Duration") to @@ -1805,9 +1840,11 @@ type IPAllocationPolicy struct { // blank. This field is only applicable when `use_ip_aliases` is true. // Set to blank to have a range chosen with the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 - // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, - // `192.168.0.0/16`) to pick a specific range to use. + // Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. ClusterIpv4CidrBlock string `json:"clusterIpv4CidrBlock,omitempty"` // ClusterSecondaryRangeName: The name of the secondary range to be used @@ -1829,9 +1866,11 @@ type IPAllocationPolicy struct { // cluster. This is applicable only if `create_subnetwork` is true. Set // to blank to have a range chosen with the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 - // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, - // `192.168.0.0/16`) to pick a specific range to use. + // Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. NodeIpv4CidrBlock string `json:"nodeIpv4CidrBlock,omitempty"` // ServicesIpv4Cidr: This field is deprecated, use @@ -1843,9 +1882,11 @@ type IPAllocationPolicy struct { // default size. This field is only applicable when `use_ip_aliases` is // true. Set to blank to have a range chosen with the default size. Set // to /netmask (e.g. `/14`) to have a range chosen with a specific - // netmask. Set to a CIDR notation (e.g. `10.96.0.0/14`) from the - // RFC-1918 private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, - // `192.168.0.0/16`) to pick a specific range to use. + // netmask. Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. ServicesIpv4CidrBlock string `json:"servicesIpv4CidrBlock,omitempty"` // ServicesSecondaryRangeName: The name of the secondary range to be @@ -1865,9 +1906,11 @@ type IPAllocationPolicy struct { // the default size. This field is only applicable when `use_ip_aliases` // is true. If unspecified, the range will use the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 - // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, - // `192.168.0.0/16`) to pick a specific range to use. + // Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. TpuIpv4CidrBlock string `json:"tpuIpv4CidrBlock,omitempty"` // UseIpAliases: Whether alias IPs will be used for pod IPs in the @@ -2497,7 +2540,8 @@ type NetworkConfig struct { PrivateIpv6GoogleAccess string `json:"privateIpv6GoogleAccess,omitempty"` // Subnetwork: Output only. The relative name of the Google Compute - // Engine subnetwork to which the cluster is connected. Example: + // Engine subnetwork (https://cloud.google.com/compute/docs/vpc) to + // which the cluster is connected. Example: // projects/my-project/regions/us-central1/subnetworks/my-subnet Subnetwork string `json:"subnetwork,omitempty"` @@ -2638,8 +2682,9 @@ type NodeConfig struct { // information. LocalSsdCount int64 `json:"localSsdCount,omitempty"` - // MachineType: The name of a Google Compute Engine machine type If - // unspecified, the default machine type is `e2-medium`. + // MachineType: The name of a Google Compute Engine machine type + // (https://cloud.google.com/compute/docs/machine-types) If unspecified, + // the default machine type is `e2-medium`. MachineType string `json:"machineType,omitempty"` // Metadata: The metadata key/value pairs assigned to instances in the @@ -2666,11 +2711,14 @@ type NodeConfig struct { // Applicable values are the friendly names of CPU platforms, such as // `minCpuPlatform: "Intel Haswell" or `minCpuPlatform: "Intel Sandy // Bridge". For more information, read how to specify min CPU platform + // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platf + // orm) MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NodeGroup: Setting this field will assign instances of this pool to // run on the specified node group. This is useful for running workloads - // on sole tenant nodes. + // on sole tenant nodes + // (https://cloud.google.com/compute/docs/nodes/sole-tenant-nodes). NodeGroup string `json:"nodeGroup,omitempty"` // OauthScopes: The set of Google API scopes to be made available on all @@ -2679,10 +2727,10 @@ type NodeConfig struct { // included: * `https://www.googleapis.com/auth/compute` is required for // mounting persistent storage on your nodes. * // `https://www.googleapis.com/auth/devstorage.read_only` is required - // for communicating with **gcr.io** (the Google Container Registry). If - // unspecified, no scopes are added, unless Cloud Logging or Cloud - // Monitoring are enabled, in which case their required scopes will be - // added. + // for communicating with **gcr.io** (the Google Container Registry + // (https://cloud.google.com/container-registry/)). If unspecified, no + // scopes are added, unless Cloud Logging or Cloud Monitoring are + // enabled, in which case their required scopes will be added. OauthScopes []string `json:"oauthScopes,omitempty"` // Preemptible: Whether the nodes are created as preemptible VM @@ -2692,8 +2740,9 @@ type NodeConfig struct { Preemptible bool `json:"preemptible,omitempty"` // ReservationAffinity: The optional reservation affinity. Setting this - // field will apply the specified Zonal Compute Reservation to this node - // pool. + // field will apply the specified Zonal Compute Reservation + // (https://cloud.google.com/compute/docs/instances/reserving-zonal-resou + // rces) to this node pool. ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` // SandboxConfig: Sandbox configuration for this node. @@ -2805,20 +2854,26 @@ type NodePool struct { Config *NodeConfig `json:"config,omitempty"` // InitialNodeCount: The initial node count for the pool. You must - // ensure that your Compute Engine resource quota is sufficient for this + // ensure that your Compute Engine resource quota + // (https://cloud.google.com/compute/quotas) is sufficient for this // number of instances. You must also have available firewall and routes // quota. InitialNodeCount int64 `json:"initialNodeCount,omitempty"` // InstanceGroupUrls: [Output only] The resource URLs of the managed - // instance groups associated with this node pool. + // instance groups + // (https://cloud.google.com/compute/docs/instance-groups/creating-groups + // -of-managed-instances) associated with this node pool. InstanceGroupUrls []string `json:"instanceGroupUrls,omitempty"` - // Locations: The list of Google Compute Engine zones in which the + // Locations: The list of Google Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) in which the // NodePool's nodes should be located. If this value is unspecified - // during node pool creation, the Cluster.Locations value will be used, - // instead. Warning: changing node pool locations will result in nodes - // being added and/or removed. + // during node pool creation, the Cluster.Locations + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro + // jects.locations.clusters#Cluster.FIELDS.locations) value will be + // used, instead. Warning: changing node pool locations will result in + // nodes being added and/or removed. Locations []string `json:"locations,omitempty"` // Management: NodeManagement configuration for this NodePool. @@ -2942,8 +2997,9 @@ func (s *NodePoolAutoscaling) MarshalJSON() ([]byte, error) { // NodeTaint: Kubernetes taint is comprised of three fields: key, value, // and effect. Effect can only be one of three types: NoSchedule, -// PreferNoSchedule or NoExecute. See here for more information, -// including usage and the valid values. +// PreferNoSchedule or NoExecute. See here +// (https://kubernetes.io/docs/concepts/configuration/taint-and-toleratio +// n) for more information, including usage and the valid values. type NodeTaint struct { // Effect: Effect for taint. // @@ -2994,11 +3050,14 @@ type Operation struct { Detail string `json:"detail,omitempty"` // EndTime: [Output only] The time the operation completed, in RFC3339 - // text format. + // (https://www.ietf.org/rfc/rfc3339.txt) text format. EndTime string `json:"endTime,omitempty"` - // Location: [Output only] The name of the Google Compute Engine zone or - // region in which the cluster resides. + // Location: [Output only] The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava + // ilable) or region + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava + // ilable) in which the cluster resides. Location string `json:"location,omitempty"` // Name: The server-assigned ID for the operation. @@ -3038,7 +3097,7 @@ type Operation struct { SelfLink string `json:"selfLink,omitempty"` // StartTime: [Output only] The time the operation started, in RFC3339 - // text format. + // (https://www.ietf.org/rfc/rfc3339.txt) text format. StartTime string `json:"startTime,omitempty"` // Status: The current status of the operation. @@ -3058,7 +3117,8 @@ type Operation struct { // TargetLink: Server-defined URL for the target of the operation. TargetLink string `json:"targetLink,omitempty"` - // Zone: The name of the Google Compute Engine zone in which the + // Zone: The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the // operation is taking place. This field is deprecated, use location // instead. Zone string `json:"zone,omitempty"` @@ -3371,8 +3431,10 @@ func (s *ReleaseChannelConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ReservationAffinity: ReservationAffinity is the configuration of -// desired reservation which instances could take capacity from. +// ReservationAffinity: ReservationAffinity +// (https://cloud.google.com/compute/docs/instances/reserving-zonal-resou +// rces) is the configuration of desired reservation which instances +// could take capacity from. type ReservationAffinity struct { // ConsumeReservationType: Corresponds to the type of reservation // consumption. @@ -3512,13 +3574,14 @@ type RollbackNodePoolUpgradeRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3643,13 +3706,14 @@ type SetAddonsConfigRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "AddonsConfig") to @@ -3696,16 +3760,18 @@ type SetLabelsRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number + // (https://developers.google.com/console/help/new/#projectnumber). This + // field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // ResourceLabels: Required. The labels to set for that cluster. ResourceLabels map[string]string `json:"resourceLabels,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3748,13 +3814,14 @@ type SetLegacyAbacRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3788,11 +3855,11 @@ type SetLocationsRequest struct { ClusterId string `json:"clusterId,omitempty"` // Locations: Required. The desired list of Google Compute Engine zones - // in which the cluster's nodes should be located. Changing the - // locations a cluster is in will result in nodes being either created - // or removed from the cluster, depending on whether locations are being - // added or removed. This list must always include the cluster's primary - // zone. + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster's nodes should be located. Changing the locations a cluster + // is in will result in nodes being either created or removed from the + // cluster, depending on whether locations are being added or removed. + // This list must always include the cluster's primary zone. Locations []string `json:"locations,omitempty"` // Name: The name (project, location, cluster) of the cluster to set @@ -3801,13 +3868,14 @@ type SetLocationsRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3855,13 +3923,14 @@ type SetLoggingServiceRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3903,11 +3972,12 @@ type SetMaintenancePolicyRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. The Google Developers Console project ID or - // project number. + // project number (https://support.google.com/cloud/answer/6158840). ProjectId string `json:"projectId,omitempty"` - // Zone: Required. The name of the Google Compute Engine zone in which - // the cluster resides. + // Zone: Required. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -3958,16 +4028,17 @@ type SetMasterAuthRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Update: Required. A description of the update. Update *MasterAuth `json:"update,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to @@ -4017,13 +4088,14 @@ type SetMonitoringServiceRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4066,13 +4138,15 @@ type SetNetworkPolicyRequest struct { NetworkPolicy *NetworkPolicy `json:"networkPolicy,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number + // (https://developers.google.com/console/help/new/#projectnumber). This + // field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4118,13 +4192,14 @@ type SetNodePoolAutoscalingRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Autoscaling") to @@ -4170,13 +4245,14 @@ type SetNodePoolManagementRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4222,13 +4298,14 @@ type SetNodePoolSizeRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4337,16 +4414,18 @@ type StartIPRotationRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number + // (https://developers.google.com/console/help/new/#projectnumber). This + // field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // RotateCredentials: Whether to rotate credentials during IP rotation. RotateCredentials bool `json:"rotateCredentials,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4461,16 +4540,17 @@ type UpdateClusterRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Update: Required. A description of the update. Update *ClusterUpdate `json:"update,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4518,13 +4598,14 @@ type UpdateMasterRequest struct { Name string `json:"name,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4560,8 +4641,9 @@ type UpdateNodePoolRequest struct { // ImageType: Required. The desired image type for the node pool. ImageType string `json:"imageType,omitempty"` - // Locations: The desired list of Google Compute Engine zones in which - // the node pool's nodes should be located. Changing the locations for a + // Locations: The desired list of Google Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) in which the + // node pool's nodes should be located. Changing the locations for a // node pool will result in nodes being either created or removed from // the node pool, depending on whether locations are being added or // removed. @@ -4587,8 +4669,8 @@ type UpdateNodePoolRequest struct { NodeVersion string `json:"nodeVersion,omitempty"` // ProjectId: Deprecated. The Google Developers Console project ID or - // project number. This field has been deprecated and replaced by the - // name field. + // project number (https://support.google.com/cloud/answer/6158840). + // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // UpgradeSettings: Upgrade settings control disruption and speed of the @@ -4599,9 +4681,10 @@ type UpdateNodePoolRequest struct { // node pool. WorkloadMetadataConfig *WorkloadMetadataConfig `json:"workloadMetadataConfig,omitempty"` - // Zone: Deprecated. The name of the Google Compute Engine zone in which - // the cluster resides. This field has been deprecated and replaced by - // the name field. + // Zone: Deprecated. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field has been deprecated and replaced by the + // name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -5161,16 +5244,19 @@ func (r *ProjectsLocationsService) GetServerConfig(name string) *ProjectsLocatio } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console project ID or project number. This field -// has been deprecated and replaced by the name field. +// Google Developers Console project ID or project number +// (https://support.google.com/cloud/answer/6158840). This field has +// been deprecated and replaced by the name field. func (c *ProjectsLocationsGetServerConfigCall) ProjectId(projectId string) *ProjectsLocationsGetServerConfigCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine zone to return operations for. This field has -// been deprecated and replaced by the name field. +// Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) to return +// operations for. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsGetServerConfigCall) Zone(zone string) *ProjectsLocationsGetServerConfigCall { c.urlParams_.Set("zone", zone) return c @@ -5465,12 +5551,13 @@ type ProjectsLocationsClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is -// created in the project's default network. One firewall is added for -// the cluster. After cluster creation, the Kubelet creates routes for -// each node to allow the containers on that node to communicate with -// all other instances in the cluster. Finally, an entry is added to the -// project's global metadata indicating which CIDR range the cluster is -// using. +// created in the project's default network +// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks +// ). One firewall is added for the cluster. After cluster creation, the +// Kubelet creates routes for each node to allow the containers on that +// node to communicate with all other instances in the cluster. Finally, +// an entry is added to the project's global metadata indicating which +// CIDR range the cluster is using. func (r *ProjectsLocationsClustersService) Create(parent string, createclusterrequest *CreateClusterRequest) *ProjectsLocationsClustersCreateCall { c := &ProjectsLocationsClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5630,16 +5717,19 @@ func (c *ProjectsLocationsClustersDeleteCall) ClusterId(clusterId string) *Proje } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console project ID or project number. This field -// has been deprecated and replaced by the name field. +// Google Developers Console project ID or project number +// (https://support.google.com/cloud/answer/6158840). This field has +// been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersDeleteCall) ProjectId(projectId string) *ProjectsLocationsClustersDeleteCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine zone in which the cluster resides. This field -// has been deprecated and replaced by the name field. +// Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsClustersDeleteCall) Zone(zone string) *ProjectsLocationsClustersDeleteCall { c.urlParams_.Set("zone", zone) return c @@ -5800,16 +5890,19 @@ func (c *ProjectsLocationsClustersGetCall) ClusterId(clusterId string) *Projects } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console project ID or project number. This field -// has been deprecated and replaced by the name field. +// Google Developers Console project ID or project number +// (https://support.google.com/cloud/answer/6158840). This field has +// been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersGetCall) ProjectId(projectId string) *ProjectsLocationsClustersGetCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine zone in which the cluster resides. This field -// has been deprecated and replaced by the name field. +// Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsClustersGetCall) Zone(zone string) *ProjectsLocationsClustersGetCall { c.urlParams_.Set("zone", zone) return c @@ -6119,17 +6212,19 @@ func (r *ProjectsLocationsClustersService) List(parent string) *ProjectsLocation } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console project ID or project number. This field -// has been deprecated and replaced by the parent field. +// Google Developers Console project ID or project number +// (https://support.google.com/cloud/answer/6158840). This field has +// been deprecated and replaced by the parent field. func (c *ProjectsLocationsClustersListCall) ProjectId(projectId string) *ProjectsLocationsClustersListCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine zone in which the cluster resides, or "-" for -// all zones. This field has been deprecated and replaced by the parent -// field. +// Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides, or "-" for all zones. This field has been deprecated +// and replaced by the parent field. func (c *ProjectsLocationsClustersListCall) Zone(zone string) *ProjectsLocationsClustersListCall { c.urlParams_.Set("zone", zone) return c @@ -6564,7 +6659,9 @@ type ProjectsLocationsClustersSetLocationsCall struct { } // SetLocations: Sets the locations for a specific cluster. Deprecated. -// Use projects.locations.clusters.update instead. +// Use projects.locations.clusters.update +// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro +// jects.locations.clusters/update) instead. func (r *ProjectsLocationsClustersService) SetLocations(name string, setlocationsrequest *SetLocationsRequest) *ProjectsLocationsClustersSetLocationsCall { c := &ProjectsLocationsClustersSetLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8129,16 +8226,19 @@ func (c *ProjectsLocationsClustersNodePoolsDeleteCall) NodePoolId(nodePoolId str } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console project ID or project number. This field -// has been deprecated and replaced by the name field. +// Google Developers Console project ID or project number +// (https://developers.google.com/console/help/new/#projectnumber). This +// field has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersNodePoolsDeleteCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsDeleteCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine zone in which the cluster resides. This field -// has been deprecated and replaced by the name field. +// Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsClustersNodePoolsDeleteCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsDeleteCall { c.urlParams_.Set("zone", zone) return c @@ -8312,16 +8412,19 @@ func (c *ProjectsLocationsClustersNodePoolsGetCall) NodePoolId(nodePoolId string } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console project ID or project number. This field -// has been deprecated and replaced by the name field. +// Google Developers Console project ID or project number +// (https://developers.google.com/console/help/new/#projectnumber). This +// field has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersNodePoolsGetCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsGetCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine zone in which the cluster resides. This field -// has been deprecated and replaced by the name field. +// Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsClustersNodePoolsGetCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsGetCall { c.urlParams_.Set("zone", zone) return c @@ -8500,16 +8603,19 @@ func (c *ProjectsLocationsClustersNodePoolsListCall) ClusterId(clusterId string) } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console project ID or project number. This field -// has been deprecated and replaced by the parent field. +// Google Developers Console project ID or project number +// (https://developers.google.com/console/help/new/#projectnumber). This +// field has been deprecated and replaced by the parent field. func (c *ProjectsLocationsClustersNodePoolsListCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsListCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine zone in which the cluster resides. This field -// has been deprecated and replaced by the parent field. +// Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// parent field. func (c *ProjectsLocationsClustersNodePoolsListCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsListCall { c.urlParams_.Set("zone", zone) return c @@ -9373,7 +9479,8 @@ type ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall struct { } // GetOpenidConfiguration: Gets the OIDC discovery document for the -// cluster. See the OpenID Connect Discovery 1.0 specification for +// cluster. See the OpenID Connect Discovery 1.0 specification +// (https://openid.net/specs/openid-connect-discovery-1_0.html) for // details. This API is not yet intended for general use, and is not // available for all clusters. func (r *ProjectsLocationsClustersWellKnownService) GetOpenidConfiguration(parent string) *ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall { @@ -9672,16 +9779,19 @@ func (c *ProjectsLocationsOperationsGetCall) OperationId(operationId string) *Pr } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console project ID or project number. This field -// has been deprecated and replaced by the name field. +// Google Developers Console project ID or project number +// (https://support.google.com/cloud/answer/6158840). This field has +// been deprecated and replaced by the name field. func (c *ProjectsLocationsOperationsGetCall) ProjectId(projectId string) *ProjectsLocationsOperationsGetCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine zone in which the cluster resides. This field -// has been deprecated and replaced by the name field. +// Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsOperationsGetCall) Zone(zone string) *ProjectsLocationsOperationsGetCall { c.urlParams_.Set("zone", zone) return c @@ -9848,17 +9958,19 @@ func (r *ProjectsLocationsOperationsService) List(parent string) *ProjectsLocati } // ProjectId sets the optional parameter "projectId": Deprecated. The -// Google Developers Console project ID or project number. This field -// has been deprecated and replaced by the parent field. +// Google Developers Console project ID or project number +// (https://support.google.com/cloud/answer/6158840). This field has +// been deprecated and replaced by the parent field. func (c *ProjectsLocationsOperationsListCall) ProjectId(projectId string) *ProjectsLocationsOperationsListCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Deprecated. The name of the -// Google Compute Engine zone to return operations for, or `-` for all -// zones. This field has been deprecated and replaced by the parent -// field. +// Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) to return +// operations for, or `-` for all zones. This field has been deprecated +// and replaced by the parent field. func (c *ProjectsLocationsOperationsListCall) Zone(zone string) *ProjectsLocationsOperationsListCall { c.urlParams_.Set("zone", zone) return c @@ -10499,12 +10611,13 @@ type ProjectsZonesClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is -// created in the project's default network. One firewall is added for -// the cluster. After cluster creation, the Kubelet creates routes for -// each node to allow the containers on that node to communicate with -// all other instances in the cluster. Finally, an entry is added to the -// project's global metadata indicating which CIDR range the cluster is -// using. +// created in the project's default network +// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks +// ). One firewall is added for the cluster. After cluster creation, the +// Kubelet creates routes for each node to allow the containers on that +// node to communicate with all other instances in the cluster. Finally, +// an entry is added to the project's global metadata indicating which +// CIDR range the cluster is using. func (r *ProjectsZonesClustersService) Create(projectId string, zone string, createclusterrequest *CreateClusterRequest) *ProjectsZonesClustersCreateCall { c := &ProjectsZonesClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -11326,7 +11439,9 @@ type ProjectsZonesClustersLocationsCall struct { } // Locations: Sets the locations for a specific cluster. Deprecated. Use -// projects.locations.clusters.update instead. +// projects.locations.clusters.update +// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro +// jects.locations.clusters/update) instead. func (r *ProjectsZonesClustersService) Locations(projectId string, zone string, clusterId string, setlocationsrequest *SetLocationsRequest) *ProjectsZonesClustersLocationsCall { c := &ProjectsZonesClustersLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId diff --git a/container/v1beta1/container-gen.go b/container/v1beta1/container-gen.go index 60ca8e11f6d..136e49a3b0c 100644 --- a/container/v1beta1/container-gen.go +++ b/container/v1beta1/container-gen.go @@ -285,6 +285,7 @@ type AcceleratorConfig struct { // AcceleratorType: The accelerator type resource name. List of // supported accelerators here + // (https://cloud.google.com/compute/docs/gpus) AcceleratorType string `json:"acceleratorType,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to @@ -426,7 +427,8 @@ func (s *AuthenticatorGroupsConfig) MarshalJSON() ([]byte, error) { type AutoUpgradeOptions struct { // AutoUpgradeStartTime: [Output only] This field is set when upgrades // are about to commence with the approximate start time for the - // upgrades, in RFC3339 text format. + // upgrades, in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text + // format. AutoUpgradeStartTime string `json:"autoUpgradeStartTime,omitempty"` // Description: [Output only] This field is set when upgrades are about @@ -488,7 +490,9 @@ type AutoprovisioningNodePoolDefaults struct { // Applicable values are the friendly names of CPU platforms, such as // `minCpuPlatform: "Intel Haswell" or `minCpuPlatform: "Intel Sandy // Bridge". For more information, read how to specify min CPU platform - // To unset the min cpu platform field pass "automatic" as field value. + // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platf + // orm) To unset the min cpu platform field pass "automatic" as field + // value. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // OauthScopes: The set of Google API scopes to be made available on all @@ -497,10 +501,10 @@ type AutoprovisioningNodePoolDefaults struct { // included: * `https://www.googleapis.com/auth/compute` is required for // mounting persistent storage on your nodes. * // `https://www.googleapis.com/auth/devstorage.read_only` is required - // for communicating with **gcr.io** (the Google Container Registry). If - // unspecified, no scopes are added, unless Cloud Logging or Cloud - // Monitoring are enabled, in which case their required scopes will be - // added. + // for communicating with **gcr.io** (the Google Container Registry + // (https://cloud.google.com/container-registry/)). If unspecified, no + // scopes are added, unless Cloud Logging or Cloud Monitoring are + // enabled, in which case their required scopes will be added. OauthScopes []string `json:"oauthScopes,omitempty"` // ServiceAccount: The Google Cloud Platform Service Account to be used @@ -643,13 +647,15 @@ type CancelOperationRequest struct { OperationId string `json:"operationId,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the operation resides. This field has been deprecated - // and replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the operation resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -795,8 +801,10 @@ type Cluster struct { BinaryAuthorization *BinaryAuthorization `json:"binaryAuthorization,omitempty"` // ClusterIpv4Cidr: The IP address range of the container pods in this - // cluster, in CIDR notation (e.g. `10.96.0.0/14`). Leave blank to have - // one automatically chosen or specify a `/14` block in `10.0.0.0/8`. + // cluster, in CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically + // chosen or specify a `/14` block in `10.0.0.0/8`. ClusterIpv4Cidr string `json:"clusterIpv4Cidr,omitempty"` // ClusterTelemetry: Telemetry integration for the cluster. @@ -809,7 +817,7 @@ type Cluster struct { ConfidentialNodes *ConfidentialNodes `json:"confidentialNodes,omitempty"` // CreateTime: [Output only] The time the cluster was created, in - // RFC3339 text format. + // RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text format. CreateTime string `json:"createTime,omitempty"` // CurrentMasterVersion: [Output only] The current software version of @@ -822,9 +830,11 @@ type Cluster struct { CurrentNodeCount int64 `json:"currentNodeCount,omitempty"` // CurrentNodeVersion: [Output only] Deprecated, use NodePool.version - // instead. The current version of the node software components. If they - // are currently at multiple versions because they're in the process of - // being upgraded, this reflects the minimum version of all nodes. + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta + // 1/projects.locations.clusters.nodePools) instead. The current version + // of the node software components. If they are currently at multiple + // versions because they're in the process of being upgraded, this + // reflects the minimum version of all nodes. CurrentNodeVersion string `json:"currentNodeVersion,omitempty"` // DatabaseEncryption: Configuration of etcd encryption. @@ -858,7 +868,8 @@ type Cluster struct { Endpoint string `json:"endpoint,omitempty"` // ExpireTime: [Output only] The time the cluster will be automatically - // deleted in RFC3339 text format. + // deleted in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text + // format. ExpireTime string `json:"expireTime,omitempty"` // InitialClusterVersion: The initial Kubernetes version for this @@ -875,10 +886,11 @@ type Cluster struct { InitialClusterVersion string `json:"initialClusterVersion,omitempty"` // InitialNodeCount: The number of nodes to create in this cluster. You - // must ensure that your Compute Engine resource quota is sufficient for - // this number of instances. You must also have available firewall and - // routes quota. For requests, this field should only be used in lieu of - // a "node_pool" object, since this configuration (along with the + // must ensure that your Compute Engine resource quota + // (https://cloud.google.com/compute/quotas) is sufficient for this + // number of instances. You must also have available firewall and routes + // quota. For requests, this field should only be used in lieu of a + // "node_pool" object, since this configuration (along with the // "node_config") will be used to create a "NodePool" object with an // auto-generated name. Do not use this and a node_pool at the same // time. This field is deprecated, use node_pool.initial_node_count @@ -898,16 +910,24 @@ type Cluster struct { // LegacyAbac: Configuration for the legacy ABAC authorization mode. LegacyAbac *LegacyAbac `json:"legacyAbac,omitempty"` - // Location: [Output only] The name of the Google Compute Engine zone or - // region in which the cluster resides. + // Location: [Output only] The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava + // ilable) or region + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava + // ilable) in which the cluster resides. Location string `json:"location,omitempty"` - // Locations: The list of Google Compute Engine zones in which the + // Locations: The list of Google Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) in which the // cluster's nodes should be located. This field provides a default - // value if NodePool.Locations are not specified during node pool - // creation. Warning: changing cluster locations will update the - // NodePool.Locations of all node pools and will result in nodes being - // added and/or removed. + // value if NodePool.Locations + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro + // jects.locations.clusters.nodePools#NodePool.FIELDS.locations) are not + // specified during node pool creation. Warning: changing cluster + // locations will update the NodePool.Locations + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro + // jects.locations.clusters.nodePools#NodePool.FIELDS.locations) of all + // node pools and will result in nodes being added and/or removed. Locations []string `json:"locations,omitempty"` // LoggingService: The logging service the cluster should use to write @@ -962,9 +982,11 @@ type Cluster struct { // with a number or a letter. Name string `json:"name,omitempty"` - // Network: The name of the Google Compute Engine network to which the - // cluster is connected. If left unspecified, the `default` network will - // be used. On output this shows the network ID instead of the name. + // Network: The name of the Google Compute Engine network + // (https://cloud.google.com/compute/docs/networks-and-firewalls#networks + // ) to which the cluster is connected. If left unspecified, the + // `default` network will be used. On output this shows the network ID + // instead of the name. Network string `json:"network,omitempty"` // NetworkConfig: Configuration for cluster networking. @@ -1028,9 +1050,10 @@ type Cluster struct { SelfLink string `json:"selfLink,omitempty"` // ServicesIpv4Cidr: [Output only] The IP address range of the - // Kubernetes services in this cluster, in CIDR notation (e.g. - // `1.2.3.4/29`). Service addresses are typically put in the last `/16` - // from the container CIDR. + // Kubernetes services in this cluster, in CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `1.2.3.4/29`). Service addresses are typically put in + // the last `/16` from the container CIDR. ServicesIpv4Cidr string `json:"servicesIpv4Cidr,omitempty"` // ShieldedNodes: Shielded Nodes configuration. @@ -1061,16 +1084,19 @@ type Cluster struct { // available. StatusMessage string `json:"statusMessage,omitempty"` - // Subnetwork: The name of the Google Compute Engine subnetwork to which - // the cluster is connected. On output this shows the subnetwork ID - // instead of the name. + // Subnetwork: The name of the Google Compute Engine subnetwork + // (https://cloud.google.com/compute/docs/subnetworks) to which the + // cluster is connected. On output this shows the subnetwork ID instead + // of the name. Subnetwork string `json:"subnetwork,omitempty"` // TpuConfig: Configuration for Cloud TPU support; TpuConfig *TpuConfig `json:"tpuConfig,omitempty"` // TpuIpv4CidrBlock: [Output only] The IP address range of the Cloud - // TPUs in this cluster, in CIDR notation (e.g. `1.2.3.4/29`). + // TPUs in this cluster, in CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `1.2.3.4/29`). TpuIpv4CidrBlock string `json:"tpuIpv4CidrBlock,omitempty"` // VerticalPodAutoscaling: Cluster-level Vertical Pod Autoscaling @@ -1081,9 +1107,9 @@ type Cluster struct { // Service Accounts in GCP IAM policies. WorkloadIdentityConfig *WorkloadIdentityConfig `json:"workloadIdentityConfig,omitempty"` - // Zone: [Output only] The name of the Google Compute Engine zone in - // which the cluster resides. This field is deprecated, use location - // instead. + // Zone: [Output only] The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. This field is deprecated, use location instead. Zone string `json:"zone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1118,8 +1144,9 @@ func (s *Cluster) MarshalJSON() ([]byte, error) { // the size of the cluster and create/delete node pools based on the // current needs. type ClusterAutoscaling struct { - // AutoprovisioningLocations: The list of Google Compute Engine zones in - // which the NodePool's nodes can be created by NAP. + // AutoprovisioningLocations: The list of Google Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) in which the + // NodePool's nodes can be created by NAP. AutoprovisioningLocations []string `json:"autoprovisioningLocations,omitempty"` // AutoprovisioningNodePoolDefaults: AutoprovisioningNodePoolDefaults @@ -1249,11 +1276,12 @@ type ClusterUpdate struct { // visibility. DesiredIntraNodeVisibilityConfig *IntraNodeVisibilityConfig `json:"desiredIntraNodeVisibilityConfig,omitempty"` - // DesiredLocations: The desired list of Google Compute Engine zones in - // which the cluster's nodes should be located. This list must always - // include the cluster's primary zone. Warning: changing cluster - // locations will update the locations of all node pools and will result - // in nodes being added and/or removed. + // DesiredLocations: The desired list of Google Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster's nodes should be located. This list must always include the + // cluster's primary zone. Warning: changing cluster locations will + // update the locations of all node pools and will result in nodes being + // added and/or removed. DesiredLocations []string `json:"desiredLocations,omitempty"` // DesiredLoggingService: The logging service the cluster should use to @@ -1400,13 +1428,15 @@ type CompleteIPRotationRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://developers.google.com/console/help/new/#projectnumber). This + // field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -1526,6 +1556,8 @@ func (s *ConsumptionMeteringConfig) MarshalJSON() ([]byte, error) { // CreateClusterRequest: CreateClusterRequest creates a cluster. type CreateClusterRequest struct { // Cluster: Required. A cluster resource + // (https://cloud.google.com/container-engine/reference/rest/v1beta1/proj + // ects.locations.clusters) Cluster *Cluster `json:"cluster,omitempty"` // Parent: The parent (project and location) where the cluster will be @@ -1533,13 +1565,15 @@ type CreateClusterRequest struct { Parent string `json:"parent,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the parent field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the parent field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the parent field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the parent field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Cluster") to @@ -1581,13 +1615,15 @@ type CreateNodePoolRequest struct { Parent string `json:"parent,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the parent field. + // project ID or project number + // (https://developers.google.com/console/help/new/#projectnumber). This + // field has been deprecated and replaced by the parent field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the parent field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the parent field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -2039,9 +2075,11 @@ type IPAllocationPolicy struct { // blank. This field is only applicable when `use_ip_aliases` is true. // Set to blank to have a range chosen with the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 - // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, - // `192.168.0.0/16`) to pick a specific range to use. + // Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. ClusterIpv4CidrBlock string `json:"clusterIpv4CidrBlock,omitempty"` // ClusterSecondaryRangeName: The name of the secondary range to be used @@ -2063,9 +2101,11 @@ type IPAllocationPolicy struct { // cluster. This is applicable only if `create_subnetwork` is true. Set // to blank to have a range chosen with the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 - // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, - // `192.168.0.0/16`) to pick a specific range to use. + // Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. NodeIpv4CidrBlock string `json:"nodeIpv4CidrBlock,omitempty"` // ServicesIpv4Cidr: This field is deprecated, use @@ -2077,9 +2117,11 @@ type IPAllocationPolicy struct { // default size. This field is only applicable when `use_ip_aliases` is // true. Set to blank to have a range chosen with the default size. Set // to /netmask (e.g. `/14`) to have a range chosen with a specific - // netmask. Set to a CIDR notation (e.g. `10.96.0.0/14`) from the - // RFC-1918 private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, - // `192.168.0.0/16`) to pick a specific range to use. + // netmask. Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. ServicesIpv4CidrBlock string `json:"servicesIpv4CidrBlock,omitempty"` // ServicesSecondaryRangeName: The name of the secondary range to be @@ -2099,10 +2141,12 @@ type IPAllocationPolicy struct { // the default size. This field is only applicable when `use_ip_aliases` // is true. If unspecified, the range will use the default size. Set to // /netmask (e.g. `/14`) to have a range chosen with a specific netmask. - // Set to a CIDR notation (e.g. `10.96.0.0/14`) from the RFC-1918 - // private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, - // `192.168.0.0/16`) to pick a specific range to use. This field is - // deprecated, use cluster.tpu_config.ipv4_cidr_block instead. + // Set to a CIDR + // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks + // (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a + // specific range to use. This field is deprecated, use + // cluster.tpu_config.ipv4_cidr_block instead. TpuIpv4CidrBlock string `json:"tpuIpv4CidrBlock,omitempty"` // UseIpAliases: Whether alias IPs will be used for pod IPs in the @@ -2927,7 +2971,8 @@ type NetworkConfig struct { PrivateIpv6GoogleAccess string `json:"privateIpv6GoogleAccess,omitempty"` // Subnetwork: Output only. The relative name of the Google Compute - // Engine subnetwork to which the cluster is connected. Example: + // Engine subnetwork (https://cloud.google.com/compute/docs/vpc) to + // which the cluster is connected. Example: // projects/my-project/regions/us-central1/subnetworks/my-subnet Subnetwork string `json:"subnetwork,omitempty"` @@ -3079,7 +3124,8 @@ type NodeConfig struct { // information. LocalSsdCount int64 `json:"localSsdCount,omitempty"` - // MachineType: The name of a Google Compute Engine machine type. If + // MachineType: The name of a Google Compute Engine machine type + // (https://cloud.google.com/compute/docs/machine-types). If // unspecified, the default machine type is `e2-medium`. MachineType string `json:"machineType,omitempty"` @@ -3107,11 +3153,14 @@ type NodeConfig struct { // Applicable values are the friendly names of CPU platforms, such as // `minCpuPlatform: "Intel Haswell" or `minCpuPlatform: "Intel Sandy // Bridge". For more information, read how to specify min CPU platform + // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platf + // orm) MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NodeGroup: Setting this field will assign instances of this pool to // run on the specified node group. This is useful for running workloads - // on sole tenant nodes. + // on sole tenant nodes + // (https://cloud.google.com/compute/docs/nodes/sole-tenant-nodes). NodeGroup string `json:"nodeGroup,omitempty"` // OauthScopes: The set of Google API scopes to be made available on all @@ -3120,10 +3169,10 @@ type NodeConfig struct { // included: * `https://www.googleapis.com/auth/compute` is required for // mounting persistent storage on your nodes. * // `https://www.googleapis.com/auth/devstorage.read_only` is required - // for communicating with **gcr.io** (the Google Container Registry). If - // unspecified, no scopes are added, unless Cloud Logging or Cloud - // Monitoring are enabled, in which case their required scopes will be - // added. + // for communicating with **gcr.io** (the Google Container Registry + // (https://cloud.google.com/container-registry/)). If unspecified, no + // scopes are added, unless Cloud Logging or Cloud Monitoring are + // enabled, in which case their required scopes will be added. OauthScopes []string `json:"oauthScopes,omitempty"` // Preemptible: Whether the nodes are created as preemptible VM @@ -3133,8 +3182,9 @@ type NodeConfig struct { Preemptible bool `json:"preemptible,omitempty"` // ReservationAffinity: The optional reservation affinity. Setting this - // field will apply the specified Zonal Compute Reservation to this node - // pool. + // field will apply the specified Zonal Compute Reservation + // (https://cloud.google.com/compute/docs/instances/reserving-zonal-resou + // rces) to this node pool. ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` // SandboxConfig: Sandbox configuration for this node. @@ -3288,20 +3338,26 @@ type NodePool struct { Config *NodeConfig `json:"config,omitempty"` // InitialNodeCount: The initial node count for the pool. You must - // ensure that your Compute Engine resource quota is sufficient for this + // ensure that your Compute Engine resource quota + // (https://cloud.google.com/compute/quotas) is sufficient for this // number of instances. You must also have available firewall and routes // quota. InitialNodeCount int64 `json:"initialNodeCount,omitempty"` // InstanceGroupUrls: [Output only] The resource URLs of the managed - // instance groups associated with this node pool. + // instance groups + // (https://cloud.google.com/compute/docs/instance-groups/creating-groups + // -of-managed-instances) associated with this node pool. InstanceGroupUrls []string `json:"instanceGroupUrls,omitempty"` - // Locations: The list of Google Compute Engine zones in which the + // Locations: The list of Google Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) in which the // NodePool's nodes should be located. If this value is unspecified - // during node pool creation, the Cluster.Locations value will be used, - // instead. Warning: changing node pool locations will result in nodes - // being added and/or removed. + // during node pool creation, the Cluster.Locations + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro + // jects.locations.clusters#Cluster.FIELDS.locations) value will be + // used, instead. Warning: changing node pool locations will result in + // nodes being added and/or removed. Locations []string `json:"locations,omitempty"` // Management: NodeManagement configuration for this NodePool. @@ -3425,8 +3481,9 @@ func (s *NodePoolAutoscaling) MarshalJSON() ([]byte, error) { // NodeTaint: Kubernetes taint is comprised of three fields: key, value, // and effect. Effect can only be one of three types: NoSchedule, -// PreferNoSchedule or NoExecute. See here for more information, -// including usage and the valid values. +// PreferNoSchedule or NoExecute. See here +// (https://kubernetes.io/docs/concepts/configuration/taint-and-toleratio +// n) for more information, including usage and the valid values. type NodeTaint struct { // Effect: Effect for taint. // @@ -3507,14 +3564,17 @@ type Operation struct { Detail string `json:"detail,omitempty"` // EndTime: [Output only] The time the operation completed, in RFC3339 - // text format. + // (https://www.ietf.org/rfc/rfc3339.txt) text format. EndTime string `json:"endTime,omitempty"` // Error: The error result of the operation in case of failure. Error *Status `json:"error,omitempty"` - // Location: [Output only] The name of the Google Compute Engine zone or - // region in which the cluster resides. + // Location: [Output only] The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava + // ilable) or region + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava + // ilable) in which the cluster resides. Location string `json:"location,omitempty"` // Name: The server-assigned ID for the operation. @@ -3554,7 +3614,7 @@ type Operation struct { SelfLink string `json:"selfLink,omitempty"` // StartTime: [Output only] The time the operation started, in RFC3339 - // text format. + // (https://www.ietf.org/rfc/rfc3339.txt) text format. StartTime string `json:"startTime,omitempty"` // Status: The current status of the operation. @@ -3574,7 +3634,8 @@ type Operation struct { // TargetLink: Server-defined URL for the target of the operation. TargetLink string `json:"targetLink,omitempty"` - // Zone: The name of the Google Compute Engine zone in which the + // Zone: The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the // operation is taking place. This field is deprecated, use location // instead. Zone string `json:"zone,omitempty"` @@ -3954,8 +4015,10 @@ func (s *ReleaseChannelConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ReservationAffinity: ReservationAffinity is the configuration of -// desired reservation which instances could take capacity from. +// ReservationAffinity: ReservationAffinity +// (https://cloud.google.com/compute/docs/instances/reserving-zonal-resou +// rces) is the configuration of desired reservation which instances +// could take capacity from. type ReservationAffinity struct { // ConsumeReservationType: Corresponds to the type of reservation // consumption. @@ -4096,13 +4159,15 @@ type RollbackNodePoolUpgradeRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4230,13 +4295,15 @@ type SetAddonsConfigRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "AddonsConfig") to @@ -4283,16 +4350,18 @@ type SetLabelsRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://developers.google.com/console/help/new/#projectnumber). This + // field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // ResourceLabels: Required. The labels to set for that cluster. ResourceLabels map[string]string `json:"resourceLabels,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4335,13 +4404,15 @@ type SetLegacyAbacRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4375,11 +4446,11 @@ type SetLocationsRequest struct { ClusterId string `json:"clusterId,omitempty"` // Locations: Required. The desired list of Google Compute Engine zones - // in which the cluster's nodes should be located. Changing the - // locations a cluster is in will result in nodes being either created - // or removed from the cluster, depending on whether locations are being - // added or removed. This list must always include the cluster's primary - // zone. + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster's nodes should be located. Changing the locations a cluster + // is in will result in nodes being either created or removed from the + // cluster, depending on whether locations are being added or removed. + // This list must always include the cluster's primary zone. Locations []string `json:"locations,omitempty"` // Name: The name (project, location, cluster) of the cluster to set @@ -4388,13 +4459,15 @@ type SetLocationsRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4442,13 +4515,15 @@ type SetLoggingServiceRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4490,11 +4565,12 @@ type SetMaintenancePolicyRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. The Google Developers Console project ID or - // project number. + // project number (https://support.google.com/cloud/answer/6158840). ProjectId string `json:"projectId,omitempty"` - // Zone: Required. The name of the Google Compute Engine zone in which - // the cluster resides. + // Zone: Required. The name of the Google Compute Engine zone + // (https://cloud.google.com/compute/docs/zones#available) in which the + // cluster resides. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4545,16 +4621,18 @@ type SetMasterAuthRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Update: Required. A description of the update. Update *MasterAuth `json:"update,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to @@ -4604,13 +4682,15 @@ type SetMonitoringServiceRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4653,13 +4733,15 @@ type SetNetworkPolicyRequest struct { NetworkPolicy *NetworkPolicy `json:"networkPolicy,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://developers.google.com/console/help/new/#projectnumber). This + // field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4706,13 +4788,15 @@ type SetNodePoolAutoscalingRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Autoscaling") to @@ -4759,13 +4843,15 @@ type SetNodePoolManagementRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4812,13 +4898,15 @@ type SetNodePoolSizeRequest struct { NodePoolId string `json:"nodePoolId,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4927,16 +5015,18 @@ type StartIPRotationRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://developers.google.com/console/help/new/#projectnumber). This + // field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // RotateCredentials: Whether to rotate credentials during IP rotation. RotateCredentials bool `json:"rotateCredentials,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -4964,10 +5054,11 @@ func (s *StartIPRotationRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -5222,16 +5313,18 @@ type UpdateClusterRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Update: Required. A description of the update. Update *ClusterUpdate `json:"update,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -5279,13 +5372,15 @@ type UpdateMasterRequest struct { Name string `json:"name,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -5327,8 +5422,9 @@ type UpdateNodePoolRequest struct { // LinuxNodeConfig: Parameters that can be configured on Linux nodes. LinuxNodeConfig *LinuxNodeConfig `json:"linuxNodeConfig,omitempty"` - // Locations: The desired list of Google Compute Engine zones in which - // the node pool's nodes should be located. Changing the locations for a + // Locations: The desired list of Google Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) in which the + // node pool's nodes should be located. Changing the locations for a // node pool will result in nodes being either created or removed from // the node pool, depending on whether locations are being added or // removed. @@ -5355,8 +5451,9 @@ type UpdateNodePoolRequest struct { NodeVersion string `json:"nodeVersion,omitempty"` // ProjectId: Required. Deprecated. The Google Developers Console - // project ID or project number. This field has been deprecated and - // replaced by the name field. + // project ID or project number + // (https://support.google.com/cloud/answer/6158840). This field has + // been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` // UpgradeSettings: Upgrade settings control disruption and speed of the @@ -5368,8 +5465,9 @@ type UpdateNodePoolRequest struct { WorkloadMetadataConfig *WorkloadMetadataConfig `json:"workloadMetadataConfig,omitempty"` // Zone: Required. Deprecated. The name of the Google Compute Engine - // zone in which the cluster resides. This field has been deprecated and - // replaced by the name field. + // zone (https://cloud.google.com/compute/docs/zones#available) in which + // the cluster resides. This field has been deprecated and replaced by + // the name field. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterId") to @@ -5959,16 +6057,18 @@ func (r *ProjectsLocationsService) GetServerConfig(name string) *ProjectsLocatio // ProjectId sets the optional parameter "projectId": Required. // Deprecated. The Google Developers Console project ID or project -// number. This field has been deprecated and replaced by the name -// field. +// number (https://support.google.com/cloud/answer/6158840). This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsGetServerConfigCall) ProjectId(projectId string) *ProjectsLocationsGetServerConfigCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine zone to return operations for. This -// field has been deprecated and replaced by the name field. +// name of the Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) to return +// operations for. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsGetServerConfigCall) Zone(zone string) *ProjectsLocationsGetServerConfigCall { c.urlParams_.Set("zone", zone) return c @@ -6407,12 +6507,13 @@ type ProjectsLocationsClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is -// created in the project's default network. One firewall is added for -// the cluster. After cluster creation, the Kubelet creates routes for -// each node to allow the containers on that node to communicate with -// all other instances in the cluster. Finally, an entry is added to the -// project's global metadata indicating which CIDR range the cluster is -// using. +// created in the project's default network +// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks +// ). One firewall is added for the cluster. After cluster creation, the +// Kubelet creates routes for each node to allow the containers on that +// node to communicate with all other instances in the cluster. Finally, +// an entry is added to the project's global metadata indicating which +// CIDR range the cluster is using. func (r *ProjectsLocationsClustersService) Create(parent string, createclusterrequest *CreateClusterRequest) *ProjectsLocationsClustersCreateCall { c := &ProjectsLocationsClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6573,16 +6674,18 @@ func (c *ProjectsLocationsClustersDeleteCall) ClusterId(clusterId string) *Proje // ProjectId sets the optional parameter "projectId": Required. // Deprecated. The Google Developers Console project ID or project -// number. This field has been deprecated and replaced by the name -// field. +// number (https://support.google.com/cloud/answer/6158840). This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersDeleteCall) ProjectId(projectId string) *ProjectsLocationsClustersDeleteCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine zone in which the cluster resides. -// This field has been deprecated and replaced by the name field. +// name of the Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsClustersDeleteCall) Zone(zone string) *ProjectsLocationsClustersDeleteCall { c.urlParams_.Set("zone", zone) return c @@ -6744,16 +6847,18 @@ func (c *ProjectsLocationsClustersGetCall) ClusterId(clusterId string) *Projects // ProjectId sets the optional parameter "projectId": Required. // Deprecated. The Google Developers Console project ID or project -// number. This field has been deprecated and replaced by the name -// field. +// number (https://support.google.com/cloud/answer/6158840). This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersGetCall) ProjectId(projectId string) *ProjectsLocationsClustersGetCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine zone in which the cluster resides. -// This field has been deprecated and replaced by the name field. +// name of the Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsClustersGetCall) Zone(zone string) *ProjectsLocationsClustersGetCall { c.urlParams_.Set("zone", zone) return c @@ -7064,17 +7169,18 @@ func (r *ProjectsLocationsClustersService) List(parent string) *ProjectsLocation // ProjectId sets the optional parameter "projectId": Required. // Deprecated. The Google Developers Console project ID or project -// number. This field has been deprecated and replaced by the parent -// field. +// number (https://support.google.com/cloud/answer/6158840). This field +// has been deprecated and replaced by the parent field. func (c *ProjectsLocationsClustersListCall) ProjectId(projectId string) *ProjectsLocationsClustersListCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine zone in which the cluster resides, -// or "-" for all zones. This field has been deprecated and replaced by -// the parent field. +// name of the Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides, or "-" for all zones. This field has been deprecated +// and replaced by the parent field. func (c *ProjectsLocationsClustersListCall) Zone(zone string) *ProjectsLocationsClustersListCall { c.urlParams_.Set("zone", zone) return c @@ -7509,7 +7615,9 @@ type ProjectsLocationsClustersSetLocationsCall struct { } // SetLocations: Sets the locations for a specific cluster. Deprecated. -// Use projects.locations.clusters.update instead. +// Use projects.locations.clusters.update +// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta +// 1/projects.locations.clusters/update) instead. func (r *ProjectsLocationsClustersService) SetLocations(name string, setlocationsrequest *SetLocationsRequest) *ProjectsLocationsClustersSetLocationsCall { c := &ProjectsLocationsClustersSetLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9075,16 +9183,19 @@ func (c *ProjectsLocationsClustersNodePoolsDeleteCall) NodePoolId(nodePoolId str // ProjectId sets the optional parameter "projectId": Required. // Deprecated. The Google Developers Console project ID or project -// number. This field has been deprecated and replaced by the name -// field. +// number +// (https://developers.google.com/console/help/new/#projectnumber). This +// field has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersNodePoolsDeleteCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsDeleteCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine zone in which the cluster resides. -// This field has been deprecated and replaced by the name field. +// name of the Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsClustersNodePoolsDeleteCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsDeleteCall { c.urlParams_.Set("zone", zone) return c @@ -9259,16 +9370,19 @@ func (c *ProjectsLocationsClustersNodePoolsGetCall) NodePoolId(nodePoolId string // ProjectId sets the optional parameter "projectId": Required. // Deprecated. The Google Developers Console project ID or project -// number. This field has been deprecated and replaced by the name -// field. +// number +// (https://developers.google.com/console/help/new/#projectnumber). This +// field has been deprecated and replaced by the name field. func (c *ProjectsLocationsClustersNodePoolsGetCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsGetCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine zone in which the cluster resides. -// This field has been deprecated and replaced by the name field. +// name of the Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsClustersNodePoolsGetCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsGetCall { c.urlParams_.Set("zone", zone) return c @@ -9448,16 +9562,19 @@ func (c *ProjectsLocationsClustersNodePoolsListCall) ClusterId(clusterId string) // ProjectId sets the optional parameter "projectId": Required. // Deprecated. The Google Developers Console project ID or project -// number. This field has been deprecated and replaced by the parent -// field. +// number +// (https://developers.google.com/console/help/new/#projectnumber). This +// field has been deprecated and replaced by the parent field. func (c *ProjectsLocationsClustersNodePoolsListCall) ProjectId(projectId string) *ProjectsLocationsClustersNodePoolsListCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine zone in which the cluster resides. -// This field has been deprecated and replaced by the parent field. +// name of the Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// parent field. func (c *ProjectsLocationsClustersNodePoolsListCall) Zone(zone string) *ProjectsLocationsClustersNodePoolsListCall { c.urlParams_.Set("zone", zone) return c @@ -10321,7 +10438,8 @@ type ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall struct { } // GetOpenidConfiguration: Gets the OIDC discovery document for the -// cluster. See the OpenID Connect Discovery 1.0 specification for +// cluster. See the OpenID Connect Discovery 1.0 specification +// (https://openid.net/specs/openid-connect-discovery-1_0.html) for // details. This API is not yet intended for general use, and is not // available for all clusters. func (r *ProjectsLocationsClustersWellKnownService) GetOpenidConfiguration(parent string) *ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall { @@ -10621,16 +10739,18 @@ func (c *ProjectsLocationsOperationsGetCall) OperationId(operationId string) *Pr // ProjectId sets the optional parameter "projectId": Required. // Deprecated. The Google Developers Console project ID or project -// number. This field has been deprecated and replaced by the name -// field. +// number (https://support.google.com/cloud/answer/6158840). This field +// has been deprecated and replaced by the name field. func (c *ProjectsLocationsOperationsGetCall) ProjectId(projectId string) *ProjectsLocationsOperationsGetCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine zone in which the cluster resides. -// This field has been deprecated and replaced by the name field. +// name of the Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) in which the +// cluster resides. This field has been deprecated and replaced by the +// name field. func (c *ProjectsLocationsOperationsGetCall) Zone(zone string) *ProjectsLocationsOperationsGetCall { c.urlParams_.Set("zone", zone) return c @@ -10798,17 +10918,18 @@ func (r *ProjectsLocationsOperationsService) List(parent string) *ProjectsLocati // ProjectId sets the optional parameter "projectId": Required. // Deprecated. The Google Developers Console project ID or project -// number. This field has been deprecated and replaced by the parent -// field. +// number (https://support.google.com/cloud/answer/6158840). This field +// has been deprecated and replaced by the parent field. func (c *ProjectsLocationsOperationsListCall) ProjectId(projectId string) *ProjectsLocationsOperationsListCall { c.urlParams_.Set("projectId", projectId) return c } // Zone sets the optional parameter "zone": Required. Deprecated. The -// name of the Google Compute Engine zone to return operations for, or -// `-` for all zones. This field has been deprecated and replaced by the -// parent field. +// name of the Google Compute Engine zone +// (https://cloud.google.com/compute/docs/zones#available) to return +// operations for, or `-` for all zones. This field has been deprecated +// and replaced by the parent field. func (c *ProjectsLocationsOperationsListCall) Zone(zone string) *ProjectsLocationsOperationsListCall { c.urlParams_.Set("zone", zone) return c @@ -11449,12 +11570,13 @@ type ProjectsZonesClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is -// created in the project's default network. One firewall is added for -// the cluster. After cluster creation, the Kubelet creates routes for -// each node to allow the containers on that node to communicate with -// all other instances in the cluster. Finally, an entry is added to the -// project's global metadata indicating which CIDR range the cluster is -// using. +// created in the project's default network +// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks +// ). One firewall is added for the cluster. After cluster creation, the +// Kubelet creates routes for each node to allow the containers on that +// node to communicate with all other instances in the cluster. Finally, +// an entry is added to the project's global metadata indicating which +// CIDR range the cluster is using. func (r *ProjectsZonesClustersService) Create(projectId string, zone string, createclusterrequest *CreateClusterRequest) *ProjectsZonesClustersCreateCall { c := &ProjectsZonesClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -12276,7 +12398,9 @@ type ProjectsZonesClustersLocationsCall struct { } // Locations: Sets the locations for a specific cluster. Deprecated. Use -// projects.locations.clusters.update instead. +// projects.locations.clusters.update +// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta +// 1/projects.locations.clusters/update) instead. func (r *ProjectsZonesClustersService) Locations(projectId string, zone string, clusterId string, setlocationsrequest *SetLocationsRequest) *ProjectsZonesClustersLocationsCall { c := &ProjectsZonesClustersLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId diff --git a/containeranalysis/v1alpha1/containeranalysis-gen.go b/containeranalysis/v1alpha1/containeranalysis-gen.go index 5d0c3dcaeb5..f352a55bc2c 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -442,7 +442,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1097,7 +1098,8 @@ type Distribution struct { // "X64" - X64 architecture Architecture string `json:"architecture,omitempty"` - // CpeUri: The cpe_uri in cpe format denoting the package manager + // CpeUri: The cpe_uri in cpe format + // (https://cpe.mitre.org/specification/) denoting the package manager // version distributing a package. CpeUri string `json:"cpeUri,omitempty"` @@ -1317,7 +1319,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1939,7 +1942,8 @@ func (s *ListScanConfigsResponse) MarshalJSON() ([]byte, error) { // within a system's filesystem. e.g. glibc was found in // /var/lib/dpkg/status type Location struct { - // CpeUri: The cpe_uri in cpe format denoting the package manager + // CpeUri: The cpe_uri in cpe format + // (https://cpe.mitre.org/specification/) denoting the package manager // version distributing a package. CpeUri string `json:"cpeUri,omitempty"` @@ -2386,7 +2390,9 @@ func (s *PgpSignedAttestation) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2405,7 +2411,7 @@ func (s *PgpSignedAttestation) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -2441,7 +2447,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2758,10 +2765,11 @@ func (s *Source) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2841,7 +2849,8 @@ func (s *StorageSource) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/containeranalysis/v1beta1/containeranalysis-gen.go b/containeranalysis/v1beta1/containeranalysis-gen.go index 1085a07e24e..a594bb8d4bd 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -567,7 +567,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1149,9 +1150,10 @@ func (s *Derived) MarshalJSON() ([]byte, error) { // package for a specific distro/location. For example: glibc in // cpe:/o:debian:debian_linux:8 for versions 2.1 - 2.2 type Detail struct { - // CpeUri: Required. The CPE URI in cpe format in which the - // vulnerability manifests. Examples include distro or storage location - // for vulnerable jar. + // CpeUri: Required. The CPE URI in cpe format + // (https://cpe.mitre.org/specification/) in which the vulnerability + // manifests. Examples include distro or storage location for vulnerable + // jar. CpeUri string `json:"cpeUri,omitempty"` // Description: A vendor-specific description of this note. @@ -1355,8 +1357,9 @@ type Distribution struct { // "X64" - X64 architecture. Architecture string `json:"architecture,omitempty"` - // CpeUri: Required. The cpe_uri in CPE format denoting the package - // manager version distributing a package. + // CpeUri: Required. The cpe_uri in CPE format + // (https://cpe.mitre.org/specification/) denoting the package manager + // version distributing a package. CpeUri string `json:"cpeUri,omitempty"` // Description: The distribution channel-specific description of this @@ -1746,7 +1749,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2620,8 +2624,9 @@ func (s *ListScanConfigsResponse) MarshalJSON() ([]byte, error) { // within a system's filesystem. E.g., glibc was found in // `/var/lib/dpkg/status`. type Location struct { - // CpeUri: Required. The CPE URI in CPE format denoting the package - // manager version distributing a package. + // CpeUri: Required. The CPE URI in CPE format + // (https://cpe.mitre.org/specification/) denoting the package manager + // version distributing a package. CpeUri string `json:"cpeUri,omitempty"` // Path: The path from which we gathered that this package/version is @@ -3005,7 +3010,9 @@ func (s *PgpSignedAttestation) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -3024,7 +3031,7 @@ func (s *PgpSignedAttestation) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -3060,7 +3067,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -3508,10 +3516,11 @@ func (s *SourceContext) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3554,7 +3563,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3736,7 +3746,8 @@ func (s *Vulnerability) UnmarshalJSON(data []byte) error { // VulnerabilityLocation: The location of the vulnerability. type VulnerabilityLocation struct { - // CpeUri: Required. The CPE URI in cpe format format. Examples include + // CpeUri: Required. The CPE URI in cpe format + // (https://cpe.mitre.org/specification/) format. Examples include // distro or storage location for vulnerable jar. CpeUri string `json:"cpeUri,omitempty"` @@ -3804,9 +3815,10 @@ func (s *VulnerabilityOccurrencesSummary) MarshalJSON() ([]byte, error) { } type WindowsDetail struct { - // CpeUri: Required. The CPE URI in cpe format in which the - // vulnerability manifests. Examples include distro or storage location - // for vulnerable jar. + // CpeUri: Required. The CPE URI in cpe format + // (https://cpe.mitre.org/specification/) in which the vulnerability + // manifests. Examples include distro or storage location for vulnerable + // jar. CpeUri string `json:"cpeUri,omitempty"` // Description: The description of the vulnerability. diff --git a/content/v2.1/content-gen.go b/content/v2.1/content-gen.go index 2f55183e017..08382c2ce5b 100644 --- a/content/v2.1/content-gen.go +++ b/content/v2.1/content-gen.go @@ -6631,7 +6631,7 @@ type OrderTrackingSignal struct { // This value is optional. If left unset, the caller's merchant ID is // used. You must request access in order to provide data on behalf of // another merchant. For more information, see Submitting Order Tracking - // Signals. + // Signals (/shopping-content/guides/order-tracking-signals). MerchantId int64 `json:"merchantId,omitempty,string"` // OrderCreatedTime: Required. The time when the order was created on @@ -11517,8 +11517,9 @@ func (s *Region) MarshalJSON() ([]byte, error) { // RegionGeoTargetArea: A list of geotargets that defines the region // area. type RegionGeoTargetArea struct { - // GeotargetCriteriaIds: Required. A non-empty list of location IDs. - // They must all be of the same location type (e.g., state). + // GeotargetCriteriaIds: Required. A non-empty list of location IDs + // (https://developers.google.com/adwords/api/docs/appendix/geotargeting) + // . They must all be of the same location type (e.g., state). GeotargetCriteriaIds googleapi.Int64s `json:"geotargetCriteriaIds,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -14463,7 +14464,8 @@ func (s *TestOrderPickupDetailsPickupPerson) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// TimeZone: Represents a time zone from the IANA Time Zone Database. +// TimeZone: Represents a time zone from the IANA Time Zone Database +// (https://www.iana.org/time-zones). type TimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` diff --git a/customsearch/v1/customsearch-gen.go b/customsearch/v1/customsearch-gen.go index 06f9abb90f5..0f6d647b0a2 100644 --- a/customsearch/v1/customsearch-gen.go +++ b/customsearch/v1/customsearch-gen.go @@ -148,7 +148,9 @@ type CseSiterestrictService struct { // Promotion: Promotion result. type Promotion struct { // BodyLines: An array of block objects for this promotion. See Google - // WebSearch Protocol reference for more information. + // WebSearch Protocol reference + // (https://developers.google.com/custom-search/docs/xml_results) for + // more information. BodyLines []*PromotionBodyLines `json:"bodyLines,omitempty"` // DisplayLink: An abridged version of this search's result URL, e.g. @@ -295,7 +297,8 @@ type Result struct { // API, it is `customsearch#result.` Kind string `json:"kind,omitempty"` - // Labels: Encapsulates all information about refinement labels. + // Labels: Encapsulates all information about refinement labels + // (https://developers.google.com/custom-search/docs/xml_results). Labels []*ResultLabels `json:"labels,omitempty"` // Link: The full URL to which the search result is pointing, e.g. @@ -305,7 +308,9 @@ type Result struct { // Mime: The MIME type of the search result. Mime string `json:"mime,omitempty"` - // Pagemap: Contains PageMap information for this search result. + // Pagemap: Contains PageMap + // (https://developers.google.com/custom-search/docs/structured_data#page + // maps) information for this search result. Pagemap googleapi.RawMessage `json:"pagemap,omitempty"` // Snippet: The snippet of the search result, in plain text. @@ -426,8 +431,9 @@ func (s *ResultLabels) MarshalJSON() ([]byte, error) { type Search struct { // Context: Metadata and refinements associated with the given search // engine, including: * The name of the search engine that was used for - // the query. * A set of facet objects (refinements) you can use for - // refining a search. + // the query. * A set of facet objects + // (https://developers.google.com/custom-search/docs/refinements#create) + // (refinements) you can use for refining a search. Context googleapi.RawMessage `json:"context,omitempty"` // Items: The current set of custom search results. @@ -437,9 +443,10 @@ type Search struct { // it is customsearch#search. Kind string `json:"kind,omitempty"` - // Promotions: The set of promotions. Present only if the custom search - // engine's configuration files define any promotions for the given - // query. + // Promotions: The set of promotions + // (https://developers.google.com/custom-search/docs/promotions). + // Present only if the custom search engine's configuration files define + // any promotions for the given query. Promotions []*Promotion `json:"promotions,omitempty"` // Queries: Query metadata for the previous, current, and next pages of @@ -525,16 +532,20 @@ type SearchQueriesNextPage struct { Count int64 `json:"count,omitempty"` // Cr: Restricts search results to documents originating in a particular - // country. You may use Boolean operators in the `cr` parameter's value. - // Google WebSearch determines the country of a document by analyzing - // the following: * The top-level domain (TLD) of the document's URL. * - // The geographic location of the web server's IP address. See Country - // (cr) Parameter Values for a list of valid values for this parameter. + // country. You may use Boolean operators + // (https://developers.google.com/custom-search/docs/xml_results#booleanO + // perators) in the `cr` parameter's value. Google WebSearch determines + // the country of a document by analyzing the following: * The top-level + // domain (TLD) of the document's URL. * The geographic location of the + // web server's IP address. See Country (cr) Parameter Values + // (https://developers.google.com/custom-search/docs/xml_results#countryC + // ollections) for a list of valid values for this parameter. Cr string `json:"cr,omitempty"` // Cx: The identifier of an engine created using the Programmable Search - // Engine Control Panel. This is a custom property not defined in the - // OpenSearch spec. This parameter is **required**. + // Engine Control Panel (https://programmablesearchengine.google.com/). + // This is a custom property not defined in the OpenSearch spec. This + // parameter is **required**. Cx string `json:"cx,omitempty"` // DateRestrict: Restricts results to URLs based on date. Supported @@ -546,8 +557,10 @@ type SearchQueriesNextPage struct { DateRestrict string `json:"dateRestrict,omitempty"` // DisableCnTwTranslation: Enables or disables the Simplified and - // Traditional Chinese Search feature. Supported values are: * `0`: - // enabled (default) * `1`: disabled + // Traditional Chinese Search + // (https://developers.google.com/custom-search/docs/xml_results#chineseS + // earch) feature. Supported values are: * `0`: enabled (default) * `1`: + // disabled DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"` // ExactTerms: Identifies a phrase that all documents in the search @@ -567,23 +580,27 @@ type SearchQueriesNextPage struct { // `wdb`) * Microsoft Write (`wri`) * Rich Text Format (`rtf`) * // Shockwave Flash (`swf`) * Text (`ans`, `txt`). Additional filetypes // may be added in the future. An up-to-date list can always be found in - // Google's file type FAQ. + // Google's file type FAQ + // (https://support.google.com/webmasters/answer/35287). FileType string `json:"fileType,omitempty"` // Filter: Activates or deactivates the automatic filtering of Google - // search results. See Automatic Filtering for more information about - // Google's search results filters. Valid values for this parameter are: - // * `0`: Disabled * `1`: Enabled (default) **Note**: By default, Google - // applies filtering to all search results to improve the quality of - // those results. + // search results. See Automatic Filtering + // (https://developers.google.com/custom-search/docs/xml_results#automati + // cFiltering) for more information about Google's search results + // filters. Valid values for this parameter are: * `0`: Disabled * `1`: + // Enabled (default) **Note**: By default, Google applies filtering to + // all search results to improve the quality of those results. Filter string `json:"filter,omitempty"` // Gl: Boosts search results whose country of origin matches the - // parameter value. See Country Codes for a list of valid values. - // Specifying a `gl` parameter value in WebSearch requests should - // improve the relevance of results. This is particularly true for - // international customers and, even more specifically, for customers in - // English-speaking countries other than the United States. + // parameter value. See Country Codes + // (https://developers.google.com/custom-search/docs/xml_results#countryC + // odes) for a list of valid values. Specifying a `gl` parameter value + // in WebSearch requests should improve the relevance of results. This + // is particularly true for international customers and, even more + // specifically, for customers in English-speaking countries other than + // the United States. Gl string `json:"gl,omitempty"` // GoogleHost: Specifies the Google domain (for example, google.com, @@ -598,9 +615,13 @@ type SearchQueriesNextPage struct { // Hl: Specifies the interface language (host language) of your user // interface. Explicitly setting this parameter improves the performance // and the quality of your search results. See the Interface Languages - // section of Internationalizing Queries and Results Presentation for - // more information, and Supported Interface Languages for a list of - // supported languages. + // (https://developers.google.com/custom-search/docs/xml_results#wsInterf + // aceLanguages) section of Internationalizing Queries and Results + // Presentation + // (https://developers.google.com/custom-search/docs/xml_results#wsIntern + // ationalizing) for more information, and Supported Interface Languages + // (https://developers.google.com/custom-search/docs/xml_results_appendic + // es#interfaceLanguages) for a list of supported languages. Hl string `json:"hl,omitempty"` // Hq: Appends the specified query terms to the query, as if they were @@ -645,8 +666,9 @@ type SearchQueriesNextPage struct { // OrTerms: Provides additional search terms to check for in a document, // where each document in the search results must contain at least one - // of the additional search terms. You can also use the Boolean OR query - // term for this type of query. + // of the additional search terms. You can also use the Boolean OR + // (https://developers.google.com/custom-search/docs/xml_results#BooleanO + // rqt) query term for this type of query. OrTerms string `json:"orTerms,omitempty"` // OutputEncoding: The character encoding supported for search results. @@ -662,10 +684,11 @@ type SearchQueriesNextPage struct { // `cc_noncommercial` * `cc_nonderived` Rights string `json:"rights,omitempty"` - // Safe: Specifies the SafeSearch level used for filtering out adult - // results. This is a custom property not defined in the OpenSearch - // spec. Valid parameter values are: * "off": Disable SafeSearch * - // "active": Enable SafeSearch + // Safe: Specifies the SafeSearch level + // (https://developers.google.com/custom-search/docs/xml_results#safeSear + // chLevels) used for filtering out adult results. This is a custom + // property not defined in the OpenSearch spec. Valid parameter values + // are: * "off": Disable SafeSearch * "active": Enable SafeSearch Safe string `json:"safe,omitempty"` // SearchTerms: The search terms entered by the user. @@ -732,16 +755,20 @@ type SearchQueriesPreviousPage struct { Count int64 `json:"count,omitempty"` // Cr: Restricts search results to documents originating in a particular - // country. You may use Boolean operators in the `cr` parameter's value. - // Google WebSearch determines the country of a document by analyzing - // the following: * The top-level domain (TLD) of the document's URL. * - // The geographic location of the web server's IP address. See Country - // (cr) Parameter Values for a list of valid values for this parameter. + // country. You may use Boolean operators + // (https://developers.google.com/custom-search/docs/xml_results#booleanO + // perators) in the `cr` parameter's value. Google WebSearch determines + // the country of a document by analyzing the following: * The top-level + // domain (TLD) of the document's URL. * The geographic location of the + // web server's IP address. See Country (cr) Parameter Values + // (https://developers.google.com/custom-search/docs/xml_results#countryC + // ollections) for a list of valid values for this parameter. Cr string `json:"cr,omitempty"` // Cx: The identifier of an engine created using the Programmable Search - // Engine Control Panel. This is a custom property not defined in the - // OpenSearch spec. This parameter is **required**. + // Engine Control Panel (https://programmablesearchengine.google.com/). + // This is a custom property not defined in the OpenSearch spec. This + // parameter is **required**. Cx string `json:"cx,omitempty"` // DateRestrict: Restricts results to URLs based on date. Supported @@ -753,8 +780,10 @@ type SearchQueriesPreviousPage struct { DateRestrict string `json:"dateRestrict,omitempty"` // DisableCnTwTranslation: Enables or disables the Simplified and - // Traditional Chinese Search feature. Supported values are: * `0`: - // enabled (default) * `1`: disabled + // Traditional Chinese Search + // (https://developers.google.com/custom-search/docs/xml_results#chineseS + // earch) feature. Supported values are: * `0`: enabled (default) * `1`: + // disabled DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"` // ExactTerms: Identifies a phrase that all documents in the search @@ -774,23 +803,27 @@ type SearchQueriesPreviousPage struct { // `wdb`) * Microsoft Write (`wri`) * Rich Text Format (`rtf`) * // Shockwave Flash (`swf`) * Text (`ans`, `txt`). Additional filetypes // may be added in the future. An up-to-date list can always be found in - // Google's file type FAQ. + // Google's file type FAQ + // (https://support.google.com/webmasters/answer/35287). FileType string `json:"fileType,omitempty"` // Filter: Activates or deactivates the automatic filtering of Google - // search results. See Automatic Filtering for more information about - // Google's search results filters. Valid values for this parameter are: - // * `0`: Disabled * `1`: Enabled (default) **Note**: By default, Google - // applies filtering to all search results to improve the quality of - // those results. + // search results. See Automatic Filtering + // (https://developers.google.com/custom-search/docs/xml_results#automati + // cFiltering) for more information about Google's search results + // filters. Valid values for this parameter are: * `0`: Disabled * `1`: + // Enabled (default) **Note**: By default, Google applies filtering to + // all search results to improve the quality of those results. Filter string `json:"filter,omitempty"` // Gl: Boosts search results whose country of origin matches the - // parameter value. See Country Codes for a list of valid values. - // Specifying a `gl` parameter value in WebSearch requests should - // improve the relevance of results. This is particularly true for - // international customers and, even more specifically, for customers in - // English-speaking countries other than the United States. + // parameter value. See Country Codes + // (https://developers.google.com/custom-search/docs/xml_results#countryC + // odes) for a list of valid values. Specifying a `gl` parameter value + // in WebSearch requests should improve the relevance of results. This + // is particularly true for international customers and, even more + // specifically, for customers in English-speaking countries other than + // the United States. Gl string `json:"gl,omitempty"` // GoogleHost: Specifies the Google domain (for example, google.com, @@ -805,9 +838,13 @@ type SearchQueriesPreviousPage struct { // Hl: Specifies the interface language (host language) of your user // interface. Explicitly setting this parameter improves the performance // and the quality of your search results. See the Interface Languages - // section of Internationalizing Queries and Results Presentation for - // more information, and Supported Interface Languages for a list of - // supported languages. + // (https://developers.google.com/custom-search/docs/xml_results#wsInterf + // aceLanguages) section of Internationalizing Queries and Results + // Presentation + // (https://developers.google.com/custom-search/docs/xml_results#wsIntern + // ationalizing) for more information, and Supported Interface Languages + // (https://developers.google.com/custom-search/docs/xml_results_appendic + // es#interfaceLanguages) for a list of supported languages. Hl string `json:"hl,omitempty"` // Hq: Appends the specified query terms to the query, as if they were @@ -852,8 +889,9 @@ type SearchQueriesPreviousPage struct { // OrTerms: Provides additional search terms to check for in a document, // where each document in the search results must contain at least one - // of the additional search terms. You can also use the Boolean OR query - // term for this type of query. + // of the additional search terms. You can also use the Boolean OR + // (https://developers.google.com/custom-search/docs/xml_results#BooleanO + // rqt) query term for this type of query. OrTerms string `json:"orTerms,omitempty"` // OutputEncoding: The character encoding supported for search results. @@ -869,10 +907,11 @@ type SearchQueriesPreviousPage struct { // `cc_noncommercial` * `cc_nonderived` Rights string `json:"rights,omitempty"` - // Safe: Specifies the SafeSearch level used for filtering out adult - // results. This is a custom property not defined in the OpenSearch - // spec. Valid parameter values are: * "off": Disable SafeSearch * - // "active": Enable SafeSearch + // Safe: Specifies the SafeSearch level + // (https://developers.google.com/custom-search/docs/xml_results#safeSear + // chLevels) used for filtering out adult results. This is a custom + // property not defined in the OpenSearch spec. Valid parameter values + // are: * "off": Disable SafeSearch * "active": Enable SafeSearch Safe string `json:"safe,omitempty"` // SearchTerms: The search terms entered by the user. @@ -939,16 +978,20 @@ type SearchQueriesRequest struct { Count int64 `json:"count,omitempty"` // Cr: Restricts search results to documents originating in a particular - // country. You may use Boolean operators in the `cr` parameter's value. - // Google WebSearch determines the country of a document by analyzing - // the following: * The top-level domain (TLD) of the document's URL. * - // The geographic location of the web server's IP address. See Country - // (cr) Parameter Values for a list of valid values for this parameter. + // country. You may use Boolean operators + // (https://developers.google.com/custom-search/docs/xml_results#booleanO + // perators) in the `cr` parameter's value. Google WebSearch determines + // the country of a document by analyzing the following: * The top-level + // domain (TLD) of the document's URL. * The geographic location of the + // web server's IP address. See Country (cr) Parameter Values + // (https://developers.google.com/custom-search/docs/xml_results#countryC + // ollections) for a list of valid values for this parameter. Cr string `json:"cr,omitempty"` // Cx: The identifier of an engine created using the Programmable Search - // Engine Control Panel. This is a custom property not defined in the - // OpenSearch spec. This parameter is **required**. + // Engine Control Panel (https://programmablesearchengine.google.com/). + // This is a custom property not defined in the OpenSearch spec. This + // parameter is **required**. Cx string `json:"cx,omitempty"` // DateRestrict: Restricts results to URLs based on date. Supported @@ -960,8 +1003,10 @@ type SearchQueriesRequest struct { DateRestrict string `json:"dateRestrict,omitempty"` // DisableCnTwTranslation: Enables or disables the Simplified and - // Traditional Chinese Search feature. Supported values are: * `0`: - // enabled (default) * `1`: disabled + // Traditional Chinese Search + // (https://developers.google.com/custom-search/docs/xml_results#chineseS + // earch) feature. Supported values are: * `0`: enabled (default) * `1`: + // disabled DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"` // ExactTerms: Identifies a phrase that all documents in the search @@ -981,23 +1026,27 @@ type SearchQueriesRequest struct { // `wdb`) * Microsoft Write (`wri`) * Rich Text Format (`rtf`) * // Shockwave Flash (`swf`) * Text (`ans`, `txt`). Additional filetypes // may be added in the future. An up-to-date list can always be found in - // Google's file type FAQ. + // Google's file type FAQ + // (https://support.google.com/webmasters/answer/35287). FileType string `json:"fileType,omitempty"` // Filter: Activates or deactivates the automatic filtering of Google - // search results. See Automatic Filtering for more information about - // Google's search results filters. Valid values for this parameter are: - // * `0`: Disabled * `1`: Enabled (default) **Note**: By default, Google - // applies filtering to all search results to improve the quality of - // those results. + // search results. See Automatic Filtering + // (https://developers.google.com/custom-search/docs/xml_results#automati + // cFiltering) for more information about Google's search results + // filters. Valid values for this parameter are: * `0`: Disabled * `1`: + // Enabled (default) **Note**: By default, Google applies filtering to + // all search results to improve the quality of those results. Filter string `json:"filter,omitempty"` // Gl: Boosts search results whose country of origin matches the - // parameter value. See Country Codes for a list of valid values. - // Specifying a `gl` parameter value in WebSearch requests should - // improve the relevance of results. This is particularly true for - // international customers and, even more specifically, for customers in - // English-speaking countries other than the United States. + // parameter value. See Country Codes + // (https://developers.google.com/custom-search/docs/xml_results#countryC + // odes) for a list of valid values. Specifying a `gl` parameter value + // in WebSearch requests should improve the relevance of results. This + // is particularly true for international customers and, even more + // specifically, for customers in English-speaking countries other than + // the United States. Gl string `json:"gl,omitempty"` // GoogleHost: Specifies the Google domain (for example, google.com, @@ -1012,9 +1061,13 @@ type SearchQueriesRequest struct { // Hl: Specifies the interface language (host language) of your user // interface. Explicitly setting this parameter improves the performance // and the quality of your search results. See the Interface Languages - // section of Internationalizing Queries and Results Presentation for - // more information, and Supported Interface Languages for a list of - // supported languages. + // (https://developers.google.com/custom-search/docs/xml_results#wsInterf + // aceLanguages) section of Internationalizing Queries and Results + // Presentation + // (https://developers.google.com/custom-search/docs/xml_results#wsIntern + // ationalizing) for more information, and Supported Interface Languages + // (https://developers.google.com/custom-search/docs/xml_results_appendic + // es#interfaceLanguages) for a list of supported languages. Hl string `json:"hl,omitempty"` // Hq: Appends the specified query terms to the query, as if they were @@ -1059,8 +1112,9 @@ type SearchQueriesRequest struct { // OrTerms: Provides additional search terms to check for in a document, // where each document in the search results must contain at least one - // of the additional search terms. You can also use the Boolean OR query - // term for this type of query. + // of the additional search terms. You can also use the Boolean OR + // (https://developers.google.com/custom-search/docs/xml_results#BooleanO + // rqt) query term for this type of query. OrTerms string `json:"orTerms,omitempty"` // OutputEncoding: The character encoding supported for search results. @@ -1076,10 +1130,11 @@ type SearchQueriesRequest struct { // `cc_noncommercial` * `cc_nonderived` Rights string `json:"rights,omitempty"` - // Safe: Specifies the SafeSearch level used for filtering out adult - // results. This is a custom property not defined in the OpenSearch - // spec. Valid parameter values are: * "off": Disable SafeSearch * - // "active": Enable SafeSearch + // Safe: Specifies the SafeSearch level + // (https://developers.google.com/custom-search/docs/xml_results#safeSear + // chLevels) used for filtering out adult results. This is a custom + // property not defined in the OpenSearch spec. Valid parameter values + // are: * "off": Disable SafeSearch * "active": Enable SafeSearch Safe string `json:"safe,omitempty"` // SearchTerms: The search terms entered by the user. @@ -1229,7 +1284,9 @@ func (s *SearchSpelling) MarshalJSON() ([]byte, error) { // SearchUrl: OpenSearch template and URL. type SearchUrl struct { - // Template: The actual OpenSearch template for this API. + // Template: The actual OpenSearch template + // (http://www.opensearch.org/specifications/opensearch/1.1#opensearch_ur + // l_template_syntax) for this API. Template string `json:"template,omitempty"` // Type: The MIME type of the OpenSearch URL template for the Custom @@ -1277,9 +1334,11 @@ func (r *CseService) List() *CseListCall { } // C2coff sets the optional parameter "c2coff": Enables or disables -// Simplified and Traditional Chinese Search. The default value for this -// parameter is 0 (zero), meaning that the feature is enabled. Supported -// values are: * `1`: Disabled * `0`: Enabled (default) +// Simplified and Traditional Chinese Search +// (https://developers.google.com/custom-search/docs/xml_results#chineseS +// earch). The default value for this parameter is 0 (zero), meaning +// that the feature is enabled. Supported values are: * `1`: Disabled * +// `0`: Enabled (default) func (c *CseListCall) C2coff(c2coff string) *CseListCall { c.urlParams_.Set("c2coff", c2coff) return c @@ -1287,11 +1346,15 @@ func (c *CseListCall) C2coff(c2coff string) *CseListCall { // Cr sets the optional parameter "cr": Restricts search results to // documents originating in a particular country. You may use Boolean -// operators in the cr parameter's value. Google Search determines the -// country of a document by analyzing: * the top-level domain (TLD) of -// the document's URL * the geographic location of the Web server's IP -// address See the Country Parameter Values page for a list of valid -// values for this parameter. +// operators +// (https://developers.google.com/custom-search/docs/xml_results_appendic +// es#booleanOperators) in the cr parameter's value. Google Search +// determines the country of a document by analyzing: * the top-level +// domain (TLD) of the document's URL * the geographic location of the +// Web server's IP address See the Country Parameter Values +// (https://developers.google.com/custom-search/docs/xml_results_appendic +// es#countryCollections) page for a list of valid values for this +// parameter. func (c *CseListCall) Cr(cr string) *CseListCall { c.urlParams_.Set("cr", cr) return c @@ -1333,19 +1396,22 @@ func (c *CseListCall) ExcludeTerms(excludeTerms string) *CseListCall { // FileType sets the optional parameter "fileType": Restricts results to // files of a specified extension. A list of file types indexable by -// Google can be found in Search Console Help Center. +// Google can be found in Search Console Help Center +// (https://support.google.com/webmasters/answer/35287). func (c *CseListCall) FileType(fileType string) *CseListCall { c.urlParams_.Set("fileType", fileType) return c } // Filter sets the optional parameter "filter": Controls turning on or -// off the duplicate content filter. * See Automatic Filtering for more -// information about Google's search results filters. Note that host -// crowding filtering applies only to multi-site searches. * By default, -// Google applies filtering to all search results to improve the quality -// of those results. Acceptable values are: * `0`: Turns off duplicate -// content filter. * `1`: Turns on duplicate content filter. +// off the duplicate content filter. * See Automatic Filtering +// (https://developers.google.com/custom-search/docs/xml_results#automati +// cFiltering) for more information about Google's search results +// filters. Note that host crowding filtering applies only to multi-site +// searches. * By default, Google applies filtering to all search +// results to improve the quality of those results. Acceptable values +// are: * `0`: Turns off duplicate content filter. * `1`: Turns on +// duplicate content filter. func (c *CseListCall) Filter(filter string) *CseListCall { c.urlParams_.Set("filter", filter) return c @@ -1354,11 +1420,13 @@ func (c *CseListCall) Filter(filter string) *CseListCall { // Gl sets the optional parameter "gl": Geolocation of end user. * The // `gl` parameter value is a two-letter country code. The `gl` parameter // boosts search results whose country of origin matches the parameter -// value. See the Country Codes page for a list of valid values. * -// Specifying a `gl` parameter value should lead to more relevant -// results. This is particularly true for international customers and, -// even more specifically, for customers in English- speaking countries -// other than the United States. +// value. See the Country Codes +// (https://developers.google.com/custom-search/docs/xml_results_appendic +// es#countryCodes) page for a list of valid values. * Specifying a `gl` +// parameter value should lead to more relevant results. This is +// particularly true for international customers and, even more +// specifically, for customers in English- speaking countries other than +// the United States. func (c *CseListCall) Gl(gl string) *CseListCall { c.urlParams_.Set("gl", gl) return c @@ -1385,8 +1453,12 @@ func (c *CseListCall) HighRange(highRange string) *CseListCall { // Hl sets the optional parameter "hl": Sets the user interface // language. * Explicitly setting this parameter improves the // performance and the quality of your search results. * See the -// Interface Languages section of Internationalizing Queries and Results -// Presentation for more information, and (Supported Interface +// Interface Languages +// (https://developers.google.com/custom-search/docs/xml_results#wsInterf +// aceLanguages) section of Internationalizing Queries and Results +// Presentation +// (https://developers.google.com/custom-search/docs/xml_results#wsIntern +// ationalizing) for more information, and (Supported Interface // Languages)[https://developers.google.com/custom-search/docs/xml_result // s_appendices#interfaceLanguages] for a list of supported languages. func (c *CseListCall) Hl(hl string) *CseListCall { @@ -1547,7 +1619,8 @@ func (c *CseListCall) RelatedSite(relatedSite string) *CseListCall { // Rights sets the optional parameter "rights": Filters based on // licensing. Supported values include: `cc_publicdomain`, // `cc_attribute`, `cc_sharealike`, `cc_noncommercial`, `cc_nonderived` -// and combinations of these. See typical combinations. +// and combinations of these. See typical combinations +// (https://wiki.creativecommons.org/wiki/CC_Search_integration). func (c *CseListCall) Rights(rights string) *CseListCall { c.urlParams_.Set("rights", rights) return c @@ -1607,7 +1680,9 @@ func (c *CseListCall) SiteSearchFilter(siteSearchFilter string) *CseListCall { // Sort sets the optional parameter "sort": The sort expression to apply // to the results. The sort parameter specifies that the results be // sorted according to the specified expression i.e. sort by date. -// Example: sort=date. +// Example: sort=date +// (https://developers.google.com/custom-search/docs/structured_search#so +// rt-by-attribute). func (c *CseListCall) Sort(sort string) *CseListCall { c.urlParams_.Set("sort", sort) return c @@ -2026,9 +2101,11 @@ func (r *CseSiterestrictService) List() *CseSiterestrictListCall { } // C2coff sets the optional parameter "c2coff": Enables or disables -// Simplified and Traditional Chinese Search. The default value for this -// parameter is 0 (zero), meaning that the feature is enabled. Supported -// values are: * `1`: Disabled * `0`: Enabled (default) +// Simplified and Traditional Chinese Search +// (https://developers.google.com/custom-search/docs/xml_results#chineseS +// earch). The default value for this parameter is 0 (zero), meaning +// that the feature is enabled. Supported values are: * `1`: Disabled * +// `0`: Enabled (default) func (c *CseSiterestrictListCall) C2coff(c2coff string) *CseSiterestrictListCall { c.urlParams_.Set("c2coff", c2coff) return c @@ -2036,11 +2113,15 @@ func (c *CseSiterestrictListCall) C2coff(c2coff string) *CseSiterestrictListCall // Cr sets the optional parameter "cr": Restricts search results to // documents originating in a particular country. You may use Boolean -// operators in the cr parameter's value. Google Search determines the -// country of a document by analyzing: * the top-level domain (TLD) of -// the document's URL * the geographic location of the Web server's IP -// address See the Country Parameter Values page for a list of valid -// values for this parameter. +// operators +// (https://developers.google.com/custom-search/docs/xml_results_appendic +// es#booleanOperators) in the cr parameter's value. Google Search +// determines the country of a document by analyzing: * the top-level +// domain (TLD) of the document's URL * the geographic location of the +// Web server's IP address See the Country Parameter Values +// (https://developers.google.com/custom-search/docs/xml_results_appendic +// es#countryCollections) page for a list of valid values for this +// parameter. func (c *CseSiterestrictListCall) Cr(cr string) *CseSiterestrictListCall { c.urlParams_.Set("cr", cr) return c @@ -2082,19 +2163,22 @@ func (c *CseSiterestrictListCall) ExcludeTerms(excludeTerms string) *CseSiterest // FileType sets the optional parameter "fileType": Restricts results to // files of a specified extension. A list of file types indexable by -// Google can be found in Search Console Help Center. +// Google can be found in Search Console Help Center +// (https://support.google.com/webmasters/answer/35287). func (c *CseSiterestrictListCall) FileType(fileType string) *CseSiterestrictListCall { c.urlParams_.Set("fileType", fileType) return c } // Filter sets the optional parameter "filter": Controls turning on or -// off the duplicate content filter. * See Automatic Filtering for more -// information about Google's search results filters. Note that host -// crowding filtering applies only to multi-site searches. * By default, -// Google applies filtering to all search results to improve the quality -// of those results. Acceptable values are: * `0`: Turns off duplicate -// content filter. * `1`: Turns on duplicate content filter. +// off the duplicate content filter. * See Automatic Filtering +// (https://developers.google.com/custom-search/docs/xml_results#automati +// cFiltering) for more information about Google's search results +// filters. Note that host crowding filtering applies only to multi-site +// searches. * By default, Google applies filtering to all search +// results to improve the quality of those results. Acceptable values +// are: * `0`: Turns off duplicate content filter. * `1`: Turns on +// duplicate content filter. func (c *CseSiterestrictListCall) Filter(filter string) *CseSiterestrictListCall { c.urlParams_.Set("filter", filter) return c @@ -2103,11 +2187,13 @@ func (c *CseSiterestrictListCall) Filter(filter string) *CseSiterestrictListCall // Gl sets the optional parameter "gl": Geolocation of end user. * The // `gl` parameter value is a two-letter country code. The `gl` parameter // boosts search results whose country of origin matches the parameter -// value. See the Country Codes page for a list of valid values. * -// Specifying a `gl` parameter value should lead to more relevant -// results. This is particularly true for international customers and, -// even more specifically, for customers in English- speaking countries -// other than the United States. +// value. See the Country Codes +// (https://developers.google.com/custom-search/docs/xml_results_appendic +// es#countryCodes) page for a list of valid values. * Specifying a `gl` +// parameter value should lead to more relevant results. This is +// particularly true for international customers and, even more +// specifically, for customers in English- speaking countries other than +// the United States. func (c *CseSiterestrictListCall) Gl(gl string) *CseSiterestrictListCall { c.urlParams_.Set("gl", gl) return c @@ -2134,8 +2220,12 @@ func (c *CseSiterestrictListCall) HighRange(highRange string) *CseSiterestrictLi // Hl sets the optional parameter "hl": Sets the user interface // language. * Explicitly setting this parameter improves the // performance and the quality of your search results. * See the -// Interface Languages section of Internationalizing Queries and Results -// Presentation for more information, and (Supported Interface +// Interface Languages +// (https://developers.google.com/custom-search/docs/xml_results#wsInterf +// aceLanguages) section of Internationalizing Queries and Results +// Presentation +// (https://developers.google.com/custom-search/docs/xml_results#wsIntern +// ationalizing) for more information, and (Supported Interface // Languages)[https://developers.google.com/custom-search/docs/xml_result // s_appendices#interfaceLanguages] for a list of supported languages. func (c *CseSiterestrictListCall) Hl(hl string) *CseSiterestrictListCall { @@ -2296,7 +2386,8 @@ func (c *CseSiterestrictListCall) RelatedSite(relatedSite string) *CseSiterestri // Rights sets the optional parameter "rights": Filters based on // licensing. Supported values include: `cc_publicdomain`, // `cc_attribute`, `cc_sharealike`, `cc_noncommercial`, `cc_nonderived` -// and combinations of these. See typical combinations. +// and combinations of these. See typical combinations +// (https://wiki.creativecommons.org/wiki/CC_Search_integration). func (c *CseSiterestrictListCall) Rights(rights string) *CseSiterestrictListCall { c.urlParams_.Set("rights", rights) return c @@ -2356,7 +2447,9 @@ func (c *CseSiterestrictListCall) SiteSearchFilter(siteSearchFilter string) *Cse // Sort sets the optional parameter "sort": The sort expression to apply // to the results. The sort parameter specifies that the results be // sorted according to the specified expression i.e. sort by date. -// Example: sort=date. +// Example: sort=date +// (https://developers.google.com/custom-search/docs/structured_search#so +// rt-by-attribute). func (c *CseSiterestrictListCall) Sort(sort string) *CseSiterestrictListCall { c.urlParams_.Set("sort", sort) return c diff --git a/datacatalog/v1beta1/datacatalog-gen.go b/datacatalog/v1beta1/datacatalog-gen.go index 4bd270c6b20..2488fffd881 100644 --- a/datacatalog/v1beta1/datacatalog-gen.go +++ b/datacatalog/v1beta1/datacatalog-gen.go @@ -296,7 +296,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -469,7 +470,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -673,8 +675,10 @@ type GoogleCloudDatacatalogV1beta1Entry struct { // LinkedResource: The resource this metadata entry refers to. For // Google Cloud Platform resources, `linked_resource` is the full name - // of the resource. For example, the `linked_resource` for a table - // resource from BigQuery is: * + // of the resource + // (https://cloud.google.com/apis/design/resource_names#full_resource_nam + // e). For example, the `linked_resource` for a table resource from + // BigQuery is: * // //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables // /tableId Output only when Entry is of type in the EntryType enum. For // entries with user_specified_type, this field is optional and defaults @@ -979,11 +983,13 @@ func (s *GoogleCloudDatacatalogV1beta1GcsFileSpec) MarshalJSON() ([]byte, error) // Storage fileset entry. type GoogleCloudDatacatalogV1beta1GcsFilesetSpec struct { // FilePatterns: Required. Patterns to identify a set of files in Google - // Cloud Storage. See Cloud Storage documentation for more information. - // Note that bucket wildcards are currently not supported. Examples of - // valid file_patterns: * `gs://bucket_name/dir/*`: matches all files - // within `bucket_name/dir` directory. * `gs://bucket_name/dir/**`: - // matches all files in `bucket_name/dir` spanning all subdirectories. * + // Cloud Storage. See Cloud Storage documentation + // (https://cloud.google.com/storage/docs/gsutil/addlhelp/WildcardNames) + // for more information. Note that bucket wildcards are currently not + // supported. Examples of valid file_patterns: * + // `gs://bucket_name/dir/*`: matches all files within `bucket_name/dir` + // directory. * `gs://bucket_name/dir/**`: matches all files in + // `bucket_name/dir` spanning all subdirectories. * // `gs://bucket_name/file*`: matches files prefixed by `file` in // `bucket_name` * `gs://bucket_name/??.txt`: matches files with two // characters followed by `.txt` in `bucket_name` * @@ -1486,8 +1492,9 @@ type GoogleCloudDatacatalogV1beta1SearchCatalogRequest struct { // that the user has access to. Query strings can be simple as "x" or // more qualified as: * name:x * column:x * description:y Note: Query // tokens need to have a minimum of 3 characters for substring matching - // to work correctly. See Data Catalog Search Syntax for more - // information. + // to work correctly. See Data Catalog Search Syntax + // (https://cloud.google.com/data-catalog/docs/how-to/search-reference) + // for more information. Query string `json:"query,omitempty"` // Scope: Required. The scope of this search request. A `scope` that has @@ -1847,7 +1854,8 @@ func (s *GoogleCloudDatacatalogV1beta1TableSpec) MarshalJSON() ([]byte, error) { // GoogleCloudDatacatalogV1beta1Tag: Tags are used to attach custom // metadata to Data Catalog resources. Tags conform to the -// specifications within their tag template. See Data Catalog IAM for +// specifications within their tag template. See Data Catalog IAM +// (https://cloud.google.com/data-catalog/docs/concepts/iam) for // information on the permissions needed to create or view tags. type GoogleCloudDatacatalogV1beta1Tag struct { // Column: Resources like Entry can have schemas associated with them. @@ -2003,9 +2011,12 @@ func (s *GoogleCloudDatacatalogV1beta1TagFieldEnumValue) MarshalJSON() ([]byte, // GoogleCloudDatacatalogV1beta1TagTemplate: A tag template defines a // tag, which can have one or more typed fields. The template is used to // create and attach the tag to GCP resources. Tag template roles -// provide permissions to create, edit, and use the template. See, for -// example, the TagTemplate User role, which includes permission to use -// the tag template to tag resources. +// (https://cloud.google.com/iam/docs/understanding-roles#data-catalog-ro +// les) provide permissions to create, edit, and use the template. See, +// for example, the TagTemplate User +// (https://cloud.google.com/data-catalog/docs/how-to/template-user) +// role, which includes permission to use the tag template to tag +// resources. type GoogleCloudDatacatalogV1beta1TagTemplate struct { // DisplayName: The display name for this template. Defaults to an empty // string. @@ -2219,7 +2230,9 @@ func (s *GoogleCloudDatacatalogV1beta1ViewSpec) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2238,7 +2251,7 @@ func (s *GoogleCloudDatacatalogV1beta1ViewSpec) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -2274,7 +2287,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2340,7 +2354,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2419,6 +2434,7 @@ type CatalogSearchCall struct { // results that match your query may not be returned, even in subsequent // result pages. Also note that results returned (and not returned) can // vary across repeated search queries. See Data Catalog Search Syntax +// (https://cloud.google.com/data-catalog/docs/how-to/search-reference) // for more information. func (r *CatalogService) Search(googleclouddatacatalogv1beta1searchcatalogrequest *GoogleCloudDatacatalogV1beta1SearchCatalogRequest) *CatalogSearchCall { c := &CatalogSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -5109,8 +5125,13 @@ type ProjectsLocationsEntryGroupsEntriesTagsCreateCall struct { } // Create: Creates a tag on an Entry. Note: The project identified by -// the `parent` parameter for the tag and the tag template used to -// create the tag must be from the same organization. +// the `parent` parameter for the tag +// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/pro +// jects.locations.entryGroups.entries.tags/create#path-parameters) and +// the tag template +// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/pro +// jects.locations.tagTemplates/create#path-parameters) used to create +// the tag must be from the same organization. func (r *ProjectsLocationsEntryGroupsEntriesTagsService) Create(parent string, googleclouddatacatalogv1beta1tag *GoogleCloudDatacatalogV1beta1Tag) *ProjectsLocationsEntryGroupsEntriesTagsCreateCall { c := &ProjectsLocationsEntryGroupsEntriesTagsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5728,8 +5749,13 @@ type ProjectsLocationsEntryGroupsTagsCreateCall struct { } // Create: Creates a tag on an Entry. Note: The project identified by -// the `parent` parameter for the tag and the tag template used to -// create the tag must be from the same organization. +// the `parent` parameter for the tag +// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/pro +// jects.locations.entryGroups.entries.tags/create#path-parameters) and +// the tag template +// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/pro +// jects.locations.tagTemplates/create#path-parameters) used to create +// the tag must be from the same organization. func (r *ProjectsLocationsEntryGroupsTagsService) Create(parent string, googleclouddatacatalogv1beta1tag *GoogleCloudDatacatalogV1beta1Tag) *ProjectsLocationsEntryGroupsTagsCreateCall { c := &ProjectsLocationsEntryGroupsTagsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6348,7 +6374,9 @@ type ProjectsLocationsTagTemplatesCreateCall struct { // Create: Creates a tag template. The user should enable the Data // Catalog API in the project identified by the `parent` parameter (see -// Data Catalog Resource Project for more information). +// Data Catalog Resource Project +// (https://cloud.google.com/data-catalog/docs/concepts/resource-project) +// for more information). func (r *ProjectsLocationsTagTemplatesService) Create(parent string, googleclouddatacatalogv1beta1tagtemplate *GoogleCloudDatacatalogV1beta1TagTemplate) *ProjectsLocationsTagTemplatesCreateCall { c := &ProjectsLocationsTagTemplatesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7407,7 +7435,9 @@ type ProjectsLocationsTagTemplatesFieldsCreateCall struct { // Create: Creates a field in a tag template. The user should enable the // Data Catalog API in the project identified by the `parent` parameter -// (see Data Catalog Resource Project for more information). +// (see Data Catalog Resource Project +// (https://cloud.google.com/data-catalog/docs/concepts/resource-project) +// for more information). func (r *ProjectsLocationsTagTemplatesFieldsService) Create(parent string, googleclouddatacatalogv1beta1tagtemplatefield *GoogleCloudDatacatalogV1beta1TagTemplateField) *ProjectsLocationsTagTemplatesFieldsCreateCall { c := &ProjectsLocationsTagTemplatesFieldsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7881,7 +7911,9 @@ type ProjectsLocationsTagTemplatesFieldsRenameCall struct { // Rename: Renames a field in a tag template. The user should enable the // Data Catalog API in the project identified by the `name` parameter -// (see Data Catalog Resource Project for more information). +// (see Data Catalog Resource Project +// (https://cloud.google.com/data-catalog/docs/concepts/resource-project) +// for more information). func (r *ProjectsLocationsTagTemplatesFieldsService) Rename(name string, googleclouddatacatalogv1beta1renametagtemplatefieldrequest *GoogleCloudDatacatalogV1beta1RenameTagTemplateFieldRequest) *ProjectsLocationsTagTemplatesFieldsRenameCall { c := &ProjectsLocationsTagTemplatesFieldsRenameCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/dataflow/v1b3/dataflow-gen.go b/dataflow/v1b3/dataflow-gen.go index 5ad9332d073..d3a8439b92c 100644 --- a/dataflow/v1b3/dataflow-gen.go +++ b/dataflow/v1b3/dataflow-gen.go @@ -2164,9 +2164,10 @@ type FlexTemplateRuntimeEnvironment struct { // AdditionalUserLabels: Additional user labels to be specified for the // job. Keys and values must follow the restrictions specified in the - // labeling restrictions page. An object containing a list of "key": - // value pairs. Example: { "name": "wrench", "mass": "1kg", "count": "3" - // }. + // labeling restrictions + // (https://cloud.google.com/compute/docs/labeling-resources#restrictions + // ) page. An object containing a list of "key": value pairs. Example: { + // "name": "wrench", "mass": "1kg", "count": "3" }. AdditionalUserLabels map[string]string `json:"additionalUserLabels,omitempty"` // EnableStreamingEngine: Whether to enable Streaming Engine for the @@ -2235,9 +2236,10 @@ type FlexTemplateRuntimeEnvironment struct { // are set, `worker_zone` takes precedence. WorkerZone string `json:"workerZone,omitempty"` - // Zone: The Compute Engine availability zone for launching worker - // instances to run your pipeline. In the future, worker_zone will take - // precedence. + // Zone: The Compute Engine availability zone + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones) + // for launching worker instances to run your pipeline. In the future, + // worker_zone will take precedence. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -5105,9 +5107,10 @@ type RuntimeEnvironment struct { // AdditionalUserLabels: Additional user labels to be specified for the // job. Keys and values should follow the restrictions specified in the - // labeling restrictions page. An object containing a list of "key": - // value pairs. Example: { "name": "wrench", "mass": "1kg", "count": "3" - // }. + // labeling restrictions + // (https://cloud.google.com/compute/docs/labeling-resources#restrictions + // ) page. An object containing a list of "key": value pairs. Example: { + // "name": "wrench", "mass": "1kg", "count": "3" }. AdditionalUserLabels map[string]string `json:"additionalUserLabels,omitempty"` // BypassTempDirValidation: Whether to bypass the safety checks for the @@ -5180,9 +5183,10 @@ type RuntimeEnvironment struct { // are set, `worker_zone` takes precedence. WorkerZone string `json:"workerZone,omitempty"` - // Zone: The Compute Engine availability zone for launching worker - // instances to run your pipeline. In the future, worker_zone will take - // precedence. + // Zone: The Compute Engine availability zone + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones) + // for launching worker instances to run your pipeline. In the future, + // worker_zone will take precedence. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -6445,10 +6449,11 @@ func (s *StateFamilyConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/datafusion/v1/datafusion-gen.go b/datafusion/v1/datafusion-gen.go index ab295b1542c..cd27377a1b7 100644 --- a/datafusion/v1/datafusion-gen.go +++ b/datafusion/v1/datafusion-gen.go @@ -337,7 +337,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -998,7 +999,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1017,7 +1020,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1057,7 +1060,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1131,10 +1135,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1177,7 +1182,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2091,7 +2097,8 @@ func (r *ProjectsLocationsInstancesService) GetIamPolicy(resource string) *Proje // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsInstancesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsInstancesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/datafusion/v1beta1/datafusion-gen.go b/datafusion/v1beta1/datafusion-gen.go index 8e88e6d9b64..90208d75568 100644 --- a/datafusion/v1beta1/datafusion-gen.go +++ b/datafusion/v1beta1/datafusion-gen.go @@ -337,7 +337,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -996,7 +997,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1015,7 +1018,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1055,7 +1058,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1129,10 +1133,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1175,7 +1180,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2093,7 +2099,8 @@ func (r *ProjectsLocationsInstancesService) GetIamPolicy(resource string) *Proje // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsInstancesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsInstancesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/datalabeling/v1beta1/datalabeling-gen.go b/datalabeling/v1beta1/datalabeling-gen.go index 180392ca5e5..47a839c8c30 100644 --- a/datalabeling/v1beta1/datalabeling-gen.go +++ b/datalabeling/v1beta1/datalabeling-gen.go @@ -567,9 +567,10 @@ type GoogleCloudDatalabelingV1alpha1HumanAnnotationConfig struct { // `[a-zA-Z\\d_-]{0,128}`. LabelGroup string `json:"labelGroup,omitempty"` - // LanguageCode: Optional. The Language of this question, as a BCP-47. - // Default value is en-US. Only need to set this when task is language - // related. For example, French text classification. + // LanguageCode: Optional. The Language of this question, as a BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Default value is + // en-US. Only need to set this when task is language related. For + // example, French text classification. LanguageCode string `json:"languageCode,omitempty"` // QuestionDuration: Optional. Maximum duration for contributors to @@ -1696,9 +1697,11 @@ type GoogleCloudDatalabelingV1beta1BigQuerySource struct { // long. If you specify the URI of a table that does not exist, Data // Labeling Service creates a table at the URI with the correct schema // when you create your EvaluationJob. If you specify the URI of a table - // that already exists, it must have the correct schema. Provide the - // table URI in the following format: "bq://{your_project_id}/ - // {your_dataset_name}/{your_table_name}" Learn more. + // that already exists, it must have the correct schema + // (/ml-engine/docs/continuous-evaluation/create-job#table-schema). + // Provide the table URI in the following format: + // "bq://{your_project_id}/ {your_dataset_name}/{your_table_name}" Learn + // more (/ml-engine/docs/continuous-evaluation/create-job#table-schema). InputUri string `json:"inputUri,omitempty"` // ForceSendFields is a list of field names (e.g. "InputUri") to @@ -1727,9 +1730,10 @@ func (s *GoogleCloudDatalabelingV1beta1BigQuerySource) MarshalJSON() ([]byte, er // GoogleCloudDatalabelingV1beta1BoundingBoxEvaluationOptions: Options // regarding evaluation between bounding boxes. type GoogleCloudDatalabelingV1beta1BoundingBoxEvaluationOptions struct { - // IouThreshold: Minimum intersection-over-union (IOU) required for 2 - // bounding boxes to be considered a match. This must be a number - // between 0 and 1. + // IouThreshold: Minimum intersection-over-union (IOU) + // (/vision/automl/object-detection/docs/evaluate#intersection-over-union + // ) required for 2 bounding boxes to be considered a match. This must + // be a number between 0 and 1. IouThreshold float64 `json:"iouThreshold,omitempty"` // ForceSendFields is a list of field names (e.g. "IouThreshold") to @@ -1902,8 +1906,9 @@ type GoogleCloudDatalabelingV1beta1ConfidenceMetricsEntry struct { // label is categorized as positive or negative (in the context of this // point on the PR curve) based on whether the label's score meets this // threshold. For image object detection (bounding box) tasks, this is - // the intersection-over-union (IOU) threshold for the context of this - // point on the PR curve. + // the intersection-over-union (IOU) + // (/vision/automl/object-detection/docs/evaluate#intersection-over-union + // ) threshold for the context of this point on the PR curve. ConfidenceThreshold float64 `json:"confidenceThreshold,omitempty"` // F1Score: Harmonic mean of recall and precision. @@ -2480,7 +2485,8 @@ func (s *GoogleCloudDatalabelingV1beta1EvaluationConfig) MarshalJSON() ([]byte, // GoogleCloudDatalabelingV1beta1EvaluationJob: Defines an evaluation // job that runs periodically to generate Evaluations. Creating an -// evaluation job is the starting point for using continuous evaluation. +// evaluation job (/ml-engine/docs/continuous-evaluation/create-job) is +// the starting point for using continuous evaluation. type GoogleCloudDatalabelingV1beta1EvaluationJob struct { // AnnotationSpecSet: Required. Name of the AnnotationSpecSet describing // all the labels that your machine learning model outputs. You must @@ -2512,10 +2518,10 @@ type GoogleCloudDatalabelingV1beta1EvaluationJob struct { // in the evaluation job's BigQuery table, set this to `false`. LabelMissingGroundTruth bool `json:"labelMissingGroundTruth,omitempty"` - // ModelVersion: Required. The AI Platform Prediction model version to - // be evaluated. Prediction input and output is sampled from this model - // version. When creating an evaluation job, specify the model version - // in the following format: + // ModelVersion: Required. The AI Platform Prediction model version + // (/ml-engine/docs/prediction-overview) to be evaluated. Prediction + // input and output is sampled from this model version. When creating an + // evaluation job, specify the model version in the following format: // "projects/{project_id}/models/{model_name}/versions/{version_name}" // There can only be one evaluation job per model version. ModelVersion string `json:"modelVersion,omitempty"` @@ -2528,10 +2534,13 @@ type GoogleCloudDatalabelingV1beta1EvaluationJob struct { // Schedule: Required. Describes the interval at which the job runs. // This interval must be at least 1 day, and it is rounded to the // nearest day. For example, if you specify a 50-hour interval, the job - // runs every 2 days. You can provide the schedule in crontab format or - // in an English-like format. Regardless of what you specify, the job - // will run at 10:00 AM UTC. Only the interval from this schedule is - // used, not the specific time of day. + // runs every 2 days. You can provide the schedule in crontab format + // (/scheduler/docs/configuring/cron-job-schedules) or in an + // English-like format + // (/appengine/docs/standard/python/config/cronref#schedule_format). + // Regardless of what you specify, the job will run at 10:00 AM UTC. + // Only the interval from this schedule is used, not the specific time + // of day. Schedule string `json:"schedule,omitempty"` // State: Output only. Describes the current state of the job. @@ -2666,7 +2675,8 @@ type GoogleCloudDatalabelingV1beta1EvaluationJobConfig struct { // `label_score_json_key`: the score key for prediction output. // Required. * `bounding_box_json_key`: the bounding box key for // prediction output. Required if your model version perform image - // object detection. Learn how to configure prediction keys. + // object detection. Learn how to configure prediction keys + // (/ml-engine/docs/continuous-evaluation/create-job#prediction-keys). BigqueryImportKeys map[string]string `json:"bigqueryImportKeys,omitempty"` // BoundingPolyConfig: Specify this field if your model version performs @@ -3316,9 +3326,10 @@ type GoogleCloudDatalabelingV1beta1HumanAnnotationConfig struct { // `[a-zA-Z\\d_-]{0,128}`. LabelGroup string `json:"labelGroup,omitempty"` - // LanguageCode: Optional. The Language of this question, as a BCP-47. - // Default value is en-US. Only need to set this when task is language - // related. For example, French text classification. + // LanguageCode: Optional. The Language of this question, as a BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Default value is + // en-US. Only need to set this when task is language related. For + // example, French text classification. LanguageCode string `json:"languageCode,omitempty"` // QuestionDuration: Optional. Maximum duration for contributors to @@ -5730,8 +5741,9 @@ func (s *GoogleCloudDatalabelingV1beta1TextEntityExtractionConfig) MarshalJSON() // GoogleCloudDatalabelingV1beta1TextMetadata: Metadata for the text. type GoogleCloudDatalabelingV1beta1TextMetadata struct { - // LanguageCode: The language of this text, as a BCP-47. Default value - // is en-US. + // LanguageCode: The language of this text, as a BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Default value is + // en-US. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "LanguageCode") to @@ -6343,9 +6355,10 @@ type GoogleCloudDatalabelingV1p1alpha1HumanAnnotationConfig struct { // `[a-zA-Z\\d_-]{0,128}`. LabelGroup string `json:"labelGroup,omitempty"` - // LanguageCode: Optional. The Language of this question, as a BCP-47. - // Default value is en-US. Only need to set this when task is language - // related. For example, French text classification. + // LanguageCode: Optional. The Language of this question, as a BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Default value is + // en-US. Only need to set this when task is language related. For + // example, French text classification. LanguageCode string `json:"languageCode,omitempty"` // QuestionDuration: Optional. Maximum duration for contributors to @@ -7191,9 +7204,10 @@ type GoogleCloudDatalabelingV1p2alpha1HumanAnnotationConfig struct { // `[a-zA-Z\\d_-]{0,128}`. LabelGroup string `json:"labelGroup,omitempty"` - // LanguageCode: Optional. The Language of this question, as a BCP-47. - // Default value is en-US. Only need to set this when task is language - // related. For example, French text classification. + // LanguageCode: Optional. The Language of this question, as a BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Default value is + // en-US. Only need to set this when task is language related. For + // example, French text classification. LanguageCode string `json:"languageCode,omitempty"` // QuestionDuration: Optional. Maximum duration for contributors to @@ -7933,10 +7947,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/datamigration/v1beta1/datamigration-gen.go b/datamigration/v1beta1/datamigration-gen.go index e3c0262254d..d206b68bfb0 100644 --- a/datamigration/v1beta1/datamigration-gen.go +++ b/datamigration/v1beta1/datamigration-gen.go @@ -297,7 +297,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -483,7 +484,7 @@ type CloudSqlSettings struct { // Tier: The tier (or machine type) for this instance, for example: // `db-n1-standard-1` (MySQL instances) or `db-custom-1-3840` // (PostgreSQL instances). For more information, see Cloud SQL Instance - // Settings. + // Settings (https://cloud.google.com/sql/docs/mysql/instance-settings). Tier string `json:"tier,omitempty"` // UserLabels: The resource labels for a Cloud SQL instance to use to @@ -1339,7 +1340,9 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1358,7 +1361,7 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1398,7 +1401,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1527,7 +1531,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // SqlAclEntry: An entry for an Access Control list. type SqlAclEntry struct { // ExpireTime: The time when this access control entry expires in RFC - // 3339 format, for example: `2012-11-15T16:19:00.094Z`. + // 3339 (https://tools.ietf.org/html/rfc3339) format, for example: + // `2012-11-15T16:19:00.094Z`. ExpireTime string `json:"expireTime,omitempty"` // Label: A label to identify this entry. @@ -1707,10 +1712,11 @@ type StaticIpConnectivity struct { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1758,7 +1764,8 @@ type StopMigrationJobRequest struct { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2764,7 +2771,8 @@ func (r *ProjectsLocationsConnectionProfilesService) GetIamPolicy(resource strin // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsConnectionProfilesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsConnectionProfilesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -4228,7 +4236,8 @@ func (r *ProjectsLocationsMigrationJobsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsMigrationJobsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsMigrationJobsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/datastore/v1/datastore-gen.go b/datastore/v1/datastore-gen.go index 8b251bc9fcf..7ffb45ffd83 100644 --- a/datastore/v1/datastore-gen.go +++ b/datastore/v1/datastore-gen.go @@ -754,8 +754,10 @@ type GoogleDatastoreAdminV1ExportEntitiesRequest struct { // of the Cloud Storage bucket and `NAMESPACE_PATH` is an optional Cloud // Storage namespace path (this is not a Cloud Datastore namespace). For // more information about Cloud Storage namespace paths, see Object name - // considerations. The resulting files will be nested deeper than the - // specified URL prefix. The final output URL will be provided in the + // considerations + // (https://cloud.google.com/storage/docs/naming#object-considerations). + // The resulting files will be nested deeper than the specified URL + // prefix. The final output URL will be provided in the // google.datastore.admin.v1.ExportEntitiesResponse.output_url field. // That value should be used for subsequent ImportEntities operations. // By nesting the data files deeper, the same Cloud Storage bucket can @@ -880,7 +882,9 @@ type GoogleDatastoreAdminV1ImportEntitiesRequest struct { // not a Cloud Datastore namespace), and `OVERALL_EXPORT_METADATA_FILE` // is the metadata file written by the ExportEntities operation. For // more information about Cloud Storage namespace paths, see Object name - // considerations. For more information, see + // considerations + // (https://cloud.google.com/storage/docs/naming#object-considerations). + // For more information, see // google.datastore.admin.v1.ExportEntitiesResponse.output_url. InputUrl string `json:"inputUrl,omitempty"` @@ -1489,7 +1493,8 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GqlQuery: A GQL query. +// GqlQuery: A GQL query +// (https://cloud.google.com/datastore/docs/apis/gql/gql_reference). type GqlQuery struct { // AllowLiterals: When false, the query string must not contain any // literals and instead must bind all values. For example, `SELECT * @@ -1510,7 +1515,8 @@ type GqlQuery struct { // true. PositionalBindings []*GqlQueryParameter `json:"positionalBindings,omitempty"` - // QueryString: A string of the format described here. + // QueryString: A string of the format described here + // (https://cloud.google.com/datastore/docs/apis/gql/gql_reference). QueryString string `json:"queryString,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowLiterals") to @@ -2091,7 +2097,9 @@ type Query struct { // EndCursor: An ending point for the query results. Query cursors are // returned in query result batches and can only be used to limit the - // same query. + // same query + // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limi + // ts_and_offsets). EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. @@ -2120,7 +2128,9 @@ type Query struct { // StartCursor: A starting point for the query results. Query cursors // are returned in query result batches and can only be used to continue - // the same query. + // the same query + // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limi + // ts_and_offsets). StartCursor string `json:"startCursor,omitempty"` // ForceSendFields is a list of field names (e.g. "DistinctOn") to @@ -2452,10 +2462,11 @@ func (s *RunQueryResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2668,7 +2679,7 @@ func (c *ProjectsAllocateIdsCall) Header() http.Header { func (c *ProjectsAllocateIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2808,7 +2819,7 @@ func (c *ProjectsBeginTransactionCall) Header() http.Header { func (c *ProjectsBeginTransactionCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2949,7 +2960,7 @@ func (c *ProjectsCommitCall) Header() http.Header { func (c *ProjectsCommitCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3096,7 +3107,7 @@ func (c *ProjectsExportCall) Header() http.Header { func (c *ProjectsExportCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3241,7 +3252,7 @@ func (c *ProjectsImportCall) Header() http.Header { func (c *ProjectsImportCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3381,7 +3392,7 @@ func (c *ProjectsLookupCall) Header() http.Header { func (c *ProjectsLookupCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3522,7 +3533,7 @@ func (c *ProjectsReserveIdsCall) Header() http.Header { func (c *ProjectsReserveIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3662,7 +3673,7 @@ func (c *ProjectsRollbackCall) Header() http.Header { func (c *ProjectsRollbackCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3802,7 +3813,7 @@ func (c *ProjectsRunQueryCall) Header() http.Header { func (c *ProjectsRunQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3950,7 +3961,7 @@ func (c *ProjectsIndexesCreateCall) Header() http.Header { func (c *ProjectsIndexesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4097,7 +4108,7 @@ func (c *ProjectsIndexesDeleteCall) Header() http.Header { func (c *ProjectsIndexesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4248,7 +4259,7 @@ func (c *ProjectsIndexesGetCall) Header() http.Header { func (c *ProjectsIndexesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4422,7 +4433,7 @@ func (c *ProjectsIndexesListCall) Header() http.Header { func (c *ProjectsIndexesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4602,7 +4613,7 @@ func (c *ProjectsOperationsCancelCall) Header() http.Header { func (c *ProjectsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4736,7 +4747,7 @@ func (c *ProjectsOperationsDeleteCall) Header() http.Header { func (c *ProjectsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4880,7 +4891,7 @@ func (c *ProjectsOperationsGetCall) Header() http.Header { func (c *ProjectsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5055,7 +5066,7 @@ func (c *ProjectsOperationsListCall) Header() http.Header { func (c *ProjectsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/datastore/v1beta1/datastore-gen.go b/datastore/v1beta1/datastore-gen.go index 764c5d1cb19..36237adfb05 100644 --- a/datastore/v1beta1/datastore-gen.go +++ b/datastore/v1beta1/datastore-gen.go @@ -624,9 +624,10 @@ type GoogleDatastoreAdminV1beta1ExportEntitiesRequest struct { // the name of the Cloud Storage bucket and `NAMESPACE_PATH` is an // optional Cloud Storage namespace path (this is not a Cloud Datastore // namespace). For more information about Cloud Storage namespace paths, - // see Object name considerations. The resulting files will be nested - // deeper than the specified URL prefix. The final output URL will be - // provided in the + // see Object name considerations + // (https://cloud.google.com/storage/docs/naming#object-considerations). + // The resulting files will be nested deeper than the specified URL + // prefix. The final output URL will be provided in the // google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url // field. That value should be used for subsequent ImportEntities // operations. By nesting the data files deeper, the same Cloud Storage @@ -753,7 +754,9 @@ type GoogleDatastoreAdminV1beta1ImportEntitiesRequest struct { // not a Cloud Datastore namespace), and `OVERALL_EXPORT_METADATA_FILE` // is the metadata file written by the ExportEntities operation. For // more information about Cloud Storage namespace paths, see Object name - // considerations. For more information, see + // considerations + // (https://cloud.google.com/storage/docs/naming#object-considerations). + // For more information, see // google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url. InputUrl string `json:"inputUrl,omitempty"` @@ -881,10 +884,11 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/datastore/v1beta3/datastore-gen.go b/datastore/v1beta3/datastore-gen.go index 981f0c2b042..1fde20285d7 100644 --- a/datastore/v1beta3/datastore-gen.go +++ b/datastore/v1beta3/datastore-gen.go @@ -1109,7 +1109,8 @@ func (s *GoogleDatastoreAdminV1beta1Progress) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GqlQuery: A GQL query. +// GqlQuery: A GQL query +// (https://cloud.google.com/datastore/docs/apis/gql/gql_reference). type GqlQuery struct { // AllowLiterals: When false, the query string must not contain any // literals and instead must bind all values. For example, `SELECT * @@ -1130,7 +1131,8 @@ type GqlQuery struct { // true. PositionalBindings []*GqlQueryParameter `json:"positionalBindings,omitempty"` - // QueryString: A string of the format described here. + // QueryString: A string of the format described here + // (https://cloud.google.com/datastore/docs/apis/gql/gql_reference). QueryString string `json:"queryString,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowLiterals") to @@ -1711,7 +1713,9 @@ type Query struct { // EndCursor: An ending point for the query results. Query cursors are // returned in query result batches and can only be used to limit the - // same query. + // same query + // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limi + // ts_and_offsets). EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. @@ -1740,7 +1744,9 @@ type Query struct { // StartCursor: A starting point for the query results. Query cursors // are returned in query result batches and can only be used to continue - // the same query. + // the same query + // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limi + // ts_and_offsets). StartCursor string `json:"startCursor,omitempty"` // ForceSendFields is a list of field names (e.g. "DistinctOn") to @@ -2247,7 +2253,7 @@ func (c *ProjectsAllocateIdsCall) Header() http.Header { func (c *ProjectsAllocateIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2387,7 +2393,7 @@ func (c *ProjectsBeginTransactionCall) Header() http.Header { func (c *ProjectsBeginTransactionCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2528,7 +2534,7 @@ func (c *ProjectsCommitCall) Header() http.Header { func (c *ProjectsCommitCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2668,7 +2674,7 @@ func (c *ProjectsLookupCall) Header() http.Header { func (c *ProjectsLookupCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2809,7 +2815,7 @@ func (c *ProjectsReserveIdsCall) Header() http.Header { func (c *ProjectsReserveIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2949,7 +2955,7 @@ func (c *ProjectsRollbackCall) Header() http.Header { func (c *ProjectsRollbackCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3089,7 +3095,7 @@ func (c *ProjectsRunQueryCall) Header() http.Header { func (c *ProjectsRunQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/deploymentmanager/v0.alpha/deploymentmanager-gen.go b/deploymentmanager/v0.alpha/deploymentmanager-gen.go index 731a0fd12de..76e03bc6cde 100644 --- a/deploymentmanager/v0.alpha/deploymentmanager-gen.go +++ b/deploymentmanager/v0.alpha/deploymentmanager-gen.go @@ -442,7 +442,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -557,8 +558,9 @@ type CompositeType struct { // Labels: Map of labels; provided by the client when the resource is // created or updated. Specifically: Label keys must be between 1 and 63 // characters long and must conform to the following regular expression: - // `a-z?` Label values must be between 0 and 63 characters long and must - // conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*CompositeTypeLabelEntry `json:"labels,omitempty"` // Name: Name of the composite type, must follow the expression: @@ -767,9 +769,9 @@ type Deployment struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the last @@ -910,9 +912,9 @@ type DeploymentUpdate struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentUpdateLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the update @@ -1435,12 +1437,16 @@ func (s *MethodMap) MarshalJSON() ([]byte, error) { } // Operation: Represents an Operation resource. Google Compute Engine -// has three Operation resources: * Global * Regional * Zonal You can -// use an operation resource to manage asynchronous API requests. For -// more information, read Handling API responses. Operations can be -// global, regional or zonal. - For global operations, use the -// `globalOperations` resource. - For regional operations, use the -// `regionOperations` resource. - For zonal operations, use the +// has three Operation resources: * Global +// (/compute/docs/reference/rest/{$api_version}/globalOperations) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionOperations) * +// Zonal (/compute/docs/reference/rest/{$api_version}/zoneOperations) +// You can use an operation resource to manage asynchronous API +// requests. For more information, read Handling API responses. +// Operations can be global, regional or zonal. - For global operations, +// use the `globalOperations` resource. - For regional operations, use +// the `regionOperations` resource. - For zonal operations, use the // `zonalOperations` resource. For more information, read Global, // Regional, and Zonal Resources. type Operation struct { @@ -1855,7 +1861,9 @@ func (s *Options) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1874,7 +1882,7 @@ func (s *Options) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1914,7 +1922,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2739,9 +2748,9 @@ type Type struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*TypeLabelEntry `json:"labels,omitempty"` // Name: Name of the type. @@ -2935,9 +2944,9 @@ type TypeProvider struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?` + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?` Labels []*TypeProviderLabelEntry `json:"labels,omitempty"` // Name: Name of the resource; provided by the client when the resource diff --git a/deploymentmanager/v2/deploymentmanager-gen.go b/deploymentmanager/v2/deploymentmanager-gen.go index 997be0840b7..3b9147dfd3d 100644 --- a/deploymentmanager/v2/deploymentmanager-gen.go +++ b/deploymentmanager/v2/deploymentmanager-gen.go @@ -315,7 +315,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -429,9 +430,9 @@ type Deployment struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the last @@ -533,9 +534,9 @@ type DeploymentUpdate struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentUpdateLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the update @@ -925,12 +926,16 @@ func (s *ManifestsListResponse) MarshalJSON() ([]byte, error) { } // Operation: Represents an Operation resource. Google Compute Engine -// has three Operation resources: * Global * Regional * Zonal You can -// use an operation resource to manage asynchronous API requests. For -// more information, read Handling API responses. Operations can be -// global, regional or zonal. - For global operations, use the -// `globalOperations` resource. - For regional operations, use the -// `regionOperations` resource. - For zonal operations, use the +// has three Operation resources: * Global +// (/compute/docs/reference/rest/{$api_version}/globalOperations) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionOperations) * +// Zonal (/compute/docs/reference/rest/{$api_version}/zoneOperations) +// You can use an operation resource to manage asynchronous API +// requests. For more information, read Handling API responses. +// Operations can be global, regional or zonal. - For global operations, +// use the `globalOperations` resource. - For regional operations, use +// the `regionOperations` resource. - For zonal operations, use the // `zonalOperations` resource. For more information, read Global, // Regional, and Zonal Resources. type Operation struct { @@ -1304,7 +1309,9 @@ func (s *OperationsListResponse) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1323,7 +1330,7 @@ func (s *OperationsListResponse) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1363,7 +1370,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/deploymentmanager/v2beta/deploymentmanager-gen.go b/deploymentmanager/v2beta/deploymentmanager-gen.go index 618893ee24a..19c3ab5f02c 100644 --- a/deploymentmanager/v2beta/deploymentmanager-gen.go +++ b/deploymentmanager/v2beta/deploymentmanager-gen.go @@ -442,7 +442,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -553,8 +554,9 @@ type CompositeType struct { // Labels: Map of labels; provided by the client when the resource is // created or updated. Specifically: Label keys must be between 1 and 63 // characters long and must conform to the following regular expression: - // `a-z?` Label values must be between 0 and 63 characters long and must - // conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*CompositeTypeLabelEntry `json:"labels,omitempty"` // Name: Name of the composite type, must follow the expression: @@ -760,9 +762,9 @@ type Deployment struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the last @@ -864,9 +866,9 @@ type DeploymentUpdate struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*DeploymentUpdateLabelEntry `json:"labels,omitempty"` // Manifest: Output only. URL of the manifest representing the update @@ -1343,12 +1345,16 @@ func (s *ManifestsListResponse) MarshalJSON() ([]byte, error) { } // Operation: Represents an Operation resource. Google Compute Engine -// has three Operation resources: * Global * Regional * Zonal You can -// use an operation resource to manage asynchronous API requests. For -// more information, read Handling API responses. Operations can be -// global, regional or zonal. - For global operations, use the -// `globalOperations` resource. - For regional operations, use the -// `regionOperations` resource. - For zonal operations, use the +// has three Operation resources: * Global +// (/compute/docs/reference/rest/{$api_version}/globalOperations) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionOperations) * +// Zonal (/compute/docs/reference/rest/{$api_version}/zoneOperations) +// You can use an operation resource to manage asynchronous API +// requests. For more information, read Handling API responses. +// Operations can be global, regional or zonal. - For global operations, +// use the `globalOperations` resource. - For regional operations, use +// the `regionOperations` resource. - For zonal operations, use the // `zonalOperations` resource. For more information, read Global, // Regional, and Zonal Resources. type Operation struct { @@ -1768,7 +1774,9 @@ func (s *Options) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1787,7 +1795,7 @@ func (s *Options) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1827,7 +1835,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2617,9 +2626,9 @@ type Type struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. Labels []*TypeLabelEntry `json:"labels,omitempty"` // Name: Name of the type. @@ -2809,9 +2818,9 @@ type TypeProvider struct { // Labels: Map of One Platform labels; provided by the client when the // resource is created or updated. Specifically: Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?` Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?` + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?` Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?` Labels []*TypeProviderLabelEntry `json:"labels,omitempty"` // Name: Name of the resource; provided by the client when the resource diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index d6053a1e955..cc11cdb230a 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -770,8 +770,8 @@ type GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText struct { // can then starts the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Ssml: The SSML text to be synthesized. For more information, see - // SSML. + // Ssml: The SSML text to be synthesized. For more information, see SSML + // (/speech/text-to-speech/docs/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -1599,8 +1599,8 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText struct { // can then starts the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Ssml: The SSML text to be synthesized. For more information, see - // SSML. + // Ssml: The SSML text to be synthesized. For more information, see SSML + // (/speech/text-to-speech/docs/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -1999,7 +1999,8 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse) Marsh // conversation to structured data that your apps and services can // understand. You design and build a Dialogflow agent to handle the // types of conversations required for your system. For more information -// about agents, see the Agent guide. +// about agents, see the Agent guide +// (https://cloud.google.com/dialogflow/docs/agents-overview). type GoogleCloudDialogflowV2Agent struct { // ApiVersion: Optional. API version displayed in Dialogflow console. If // not specified, V2 API is assumed. Clients are free to query different @@ -2015,6 +2016,7 @@ type GoogleCloudDialogflowV2Agent struct { // AvatarUri: Optional. The URI of the agent's avatar. Avatars are used // throughout the Dialogflow console and in the self-hosted Web Demo + // (https://cloud.google.com/dialogflow/docs/integrations/web-demo) // integration. AvatarUri string `json:"avatarUri,omitempty"` @@ -2029,9 +2031,10 @@ type GoogleCloudDialogflowV2Agent struct { ClassificationThreshold float64 `json:"classificationThreshold,omitempty"` // DefaultLanguageCode: Required. The default language of the agent as a - // language tag. See Language Support for a list of the currently - // supported language codes. This field cannot be set by the `Update` - // method. + // language tag. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. This field cannot be + // set by the `Update` method. DefaultLanguageCode string `json:"defaultLanguageCode,omitempty"` // Description: Optional. The description of this agent. The maximum @@ -2077,7 +2080,8 @@ type GoogleCloudDialogflowV2Agent struct { Tier string `json:"tier,omitempty"` // TimeZone: Required. The time zone of this agent from the time zone - // database, e.g., America/New_York, Europe/Paris. + // database (https://www.iana.org/time-zones), e.g., America/New_York, + // Europe/Paris. TimeZone string `json:"timeZone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2126,13 +2130,15 @@ func (s *GoogleCloudDialogflowV2Agent) UnmarshalJSON(data []byte) error { // or purely a part of the message between two entities or message // start/end. type GoogleCloudDialogflowV2AnnotatedMessagePart struct { - // EntityType: The Dialogflow system entity type of this message part. - // If this is empty, Dialogflow could not annotate the phrase part with - // a system entity. + // EntityType: The Dialogflow system entity type + // (https://cloud.google.com/dialogflow/docs/reference/system-entities) + // of this message part. If this is empty, Dialogflow could not annotate + // the phrase part with a system entity. EntityType string `json:"entityType,omitempty"` - // FormattedValue: The Dialogflow system entity formatted value of this - // message part. For example for a system entity of type + // FormattedValue: The Dialogflow system entity formatted value + // (https://cloud.google.com/dialogflow/docs/reference/system-entities) + // of this message part. For example for a system entity of type // `@sys.unit-currency`, this may contain: { "amount": 5, "currency": // "USD" } FormattedValue interface{} `json:"formattedValue,omitempty"` @@ -2171,7 +2177,9 @@ type GoogleCloudDialogflowV2BatchCreateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see Multilingual intent and entity data. + // more information, see Multilingual intent and entity data + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e + // ntity). LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Entities") to @@ -2207,7 +2215,9 @@ type GoogleCloudDialogflowV2BatchDeleteEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see Multilingual intent and entity data. + // more information, see Multilingual intent and entity data + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e + // ntity). LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "EntityValues") to @@ -2302,7 +2312,9 @@ type GoogleCloudDialogflowV2BatchUpdateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see Multilingual intent and entity data. + // more information, see Multilingual intent and entity data + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e + // ntity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -2346,7 +2358,9 @@ type GoogleCloudDialogflowV2BatchUpdateEntityTypesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see Multilingual intent and entity data. + // more information, see Multilingual intent and entity data + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e + // ntity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -2427,7 +2441,9 @@ type GoogleCloudDialogflowV2BatchUpdateIntentsRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see Multilingual intent and entity data. + // more information, see Multilingual intent and entity data + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e + // ntity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -2498,7 +2514,8 @@ func (s *GoogleCloudDialogflowV2BatchUpdateIntentsResponse) MarshalJSON() ([]byt // active. While any contexts are active, Dialogflow is more likely to // match intents that are configured with input contexts that correspond // to the currently active contexts. For more information about context, -// see the Contexts guide. +// see the Contexts guide +// (https://cloud.google.com/dialogflow/docs/contexts-overview). type GoogleCloudDialogflowV2Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -2736,7 +2753,8 @@ func (s *GoogleCloudDialogflowV2DetectIntentResponse) MarshalJSON() ([]byte, err // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// Entity guide. +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -2883,7 +2901,8 @@ func (s *GoogleCloudDialogflowV2EntityTypeEntity) MarshalJSON() ([]byte, error) // published to the default environment. When you create agent versions, // you can publish them to custom environments. You can create a variety // of custom environments for: - testing - development - production - -// etc. For more information, see the versions and environments guide. +// etc. For more information, see the versions and environments guide +// (https://cloud.google.com/dialogflow/docs/agents-versions). type GoogleCloudDialogflowV2Environment struct { // AgentVersion: Optional. The agent version loaded into this // environment. Format: `projects//agent/versions/`. @@ -2944,9 +2963,10 @@ func (s *GoogleCloudDialogflowV2Environment) MarshalJSON() ([]byte, error) { // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2EventInput struct { // LanguageCode: Required. The language of this query. See Language - // Support for a list of the currently supported language codes. Note - // that queries in the same session do not necessarily need to specify - // the same language. + // Support (https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that + // queries in the same session do not necessarily need to specify the + // same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -2989,8 +3009,9 @@ func (s *GoogleCloudDialogflowV2EventInput) MarshalJSON() ([]byte, error) { // GoogleCloudDialogflowV2ExportAgentRequest: The request message for // Agents.ExportAgent. type GoogleCloudDialogflowV2ExportAgentRequest struct { - // AgentUri: Required. The Google Cloud Storage URI to export the agent - // to. The format of this URI must be `gs:///`. If left unspecified, the + // AgentUri: Required. The Google Cloud Storage + // (https://cloud.google.com/storage/docs/) URI to export the agent to. + // The format of this URI must be `gs:///`. If left unspecified, the // serialized agent is returned inline. AgentUri string `json:"agentUri,omitempty"` @@ -3058,7 +3079,8 @@ func (s *GoogleCloudDialogflowV2ExportAgentResponse) MarshalJSON() ([]byte, erro // by calling a service that you define. For example, if an end-user // wants to schedule a haircut on Friday, your service can check your // database and respond to the end-user with availability information -// for Friday. For more information, see the fulfillment guide. +// for Friday. For more information, see the fulfillment guide +// (https://cloud.google.com/dialogflow/docs/fulfillment-overview). type GoogleCloudDialogflowV2Fulfillment struct { // DisplayName: Optional. The human-readable name of the fulfillment, // unique within the agent. @@ -3269,9 +3291,11 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { EnableWordInfo bool `json:"enableWordInfo,omitempty"` // LanguageCode: Required. The language of the supplied audio. - // Dialogflow does not do translations. See Language Support for a list - // of the currently supported language codes. Note that queries in the - // same session do not necessarily need to specify the same language. + // Dialogflow does not do translations. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. Note that queries in + // the same session do not necessarily need to specify the same + // language. LanguageCode string `json:"languageCode,omitempty"` // Model: Which Speech model to select for the given request. Select the @@ -3281,7 +3305,9 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { // enabled for the agent and an enhanced version of the specified model // for the language does not exist, then the speech is recognized using // the standard version of the specified model. Refer to Cloud Speech - // API documentation for more details. + // API documentation + // (https://cloud.google.com/speech-to-text/docs/basics#select-model) + // for more details. Model string `json:"model,omitempty"` // ModelVariant: Which variant of the Speech model to use. @@ -3310,15 +3336,18 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { // PhraseHints: A list of strings containing words and phrases that the // speech recognizer should recognize with higher likelihood. See the - // Cloud Speech documentation for more details. This field is - // deprecated. Please use speech_contexts instead. If you specify both - // phrase_hints and speech_contexts, Dialogflow will treat the - // phrase_hints as a single additional SpeechContext. + // Cloud Speech documentation + // (https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) + // for more details. This field is deprecated. Please use + // speech_contexts () instead. If you specify both phrase_hints () and + // speech_contexts (), Dialogflow will treat the phrase_hints () as a + // single additional SpeechContext (). PhraseHints []string `json:"phraseHints,omitempty"` // SampleRateHertz: Required. Sample rate (in Hertz) of the audio // content sent in the query. Refer to Cloud Speech API documentation - // for more details. + // (https://cloud.google.com/speech-to-text/docs/basics) for more + // details. SampleRateHertz int64 `json:"sampleRateHertz,omitempty"` // SingleUtterance: If `false` (default), recognition does not cease @@ -3333,7 +3362,9 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { SingleUtterance bool `json:"singleUtterance,omitempty"` // SpeechContexts: Context information to assist speech recognition. See - // the Cloud Speech documentation for more details. + // the Cloud Speech documentation + // (https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) + // for more details. SpeechContexts []*GoogleCloudDialogflowV2SpeechContext `json:"speechContexts,omitempty"` // ForceSendFields is a list of field names (e.g. "AudioEncoding") to @@ -3366,7 +3397,8 @@ func (s *GoogleCloudDialogflowV2InputAudioConfig) MarshalJSON() ([]byte, error) // as an end-user expression or end-user input, Dialogflow matches the // end-user input to the best intent in your agent. Matching an intent // is also known as intent classification. For more information, see the -// intent guide. +// intent guide +// (https://cloud.google.com/dialogflow/docs/intents-overview). type GoogleCloudDialogflowV2Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -3574,7 +3606,8 @@ func (s *GoogleCloudDialogflowV2IntentFollowupIntentInfo) MarshalJSON() ([]byte, // GoogleCloudDialogflowV2IntentMessage: A rich response message. // Corresponds to the intent `Response` field in the Dialogflow console. -// For more information, see Rich response messages. +// For more information, see Rich response messages +// (https://cloud.google.com/dialogflow/docs/intents-rich-messages). type GoogleCloudDialogflowV2IntentMessage struct { // BasicCard: The basic card response for Actions on Google. BasicCard *GoogleCloudDialogflowV2IntentMessageBasicCard `json:"basicCard,omitempty"` @@ -4995,7 +5028,8 @@ type GoogleCloudDialogflowV2Message struct { CreateTime string `json:"createTime,omitempty"` // LanguageCode: Optional. The message language. This should be a BCP-47 - // language tag. Example: "en-US". + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Example: + // "en-US". LanguageCode string `json:"languageCode,omitempty"` // MessageAnnotation: Output only. The annotation for the message. @@ -5089,7 +5123,8 @@ type GoogleCloudDialogflowV2OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in E.164 format for Essentials Edition agents. + // with the caller ID in E.164 format + // (https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -5250,8 +5285,9 @@ type GoogleCloudDialogflowV2QueryParameters struct { SessionEntityTypes []*GoogleCloudDialogflowV2SessionEntityType `json:"sessionEntityTypes,omitempty"` // TimeZone: The time zone of this conversational query from the time - // zone database, e.g., America/New_York, Europe/Paris. If not provided, - // the time zone specified in agent settings is used. + // zone database (https://www.iana.org/time-zones), e.g., + // America/New_York, Europe/Paris. If not provided, the time zone + // specified in agent settings is used. TimeZone string `json:"timeZone,omitempty"` // WebhookHeaders: This field can be used to pass HTTP headers for a @@ -5332,8 +5368,9 @@ type GoogleCloudDialogflowV2QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See Language Support for a list of the currently supported - // language codes. + // detection. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -5625,7 +5662,8 @@ func (s *GoogleCloudDialogflowV2SentimentAnalysisResult) MarshalJSON() ([]byte, // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the session entity guide. +// minutes. For more information, see the session entity guide +// (https://cloud.google.com/dialogflow/docs/entities-session). type GoogleCloudDialogflowV2SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -5703,7 +5741,8 @@ type GoogleCloudDialogflowV2SpeechContext struct { // This list can be used to: * improve accuracy for words and phrases // you expect the user to say, e.g. typical commands for your Dialogflow // agent * add additional words to the speech recognizer vocabulary * - // ... See the Cloud Speech documentation for usage limits. + // ... See the Cloud Speech documentation + // (https://cloud.google.com/speech-to-text/quotas) for usage limits. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to @@ -5824,9 +5863,11 @@ func (s *GoogleCloudDialogflowV2SynthesizeSpeechConfig) UnmarshalJSON(data []byt // text to be processed. type GoogleCloudDialogflowV2TextInput struct { // LanguageCode: Required. The language of this conversational query. - // See Language Support for a list of the currently supported language - // codes. Note that queries in the same session do not necessarily need - // to specify the same language. + // See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. Note that queries in + // the same session do not necessarily need to specify the same + // language. LanguageCode string `json:"languageCode,omitempty"` // Text: Required. The UTF-8 encoded natural language text to be @@ -6047,7 +6088,8 @@ func (s *GoogleCloudDialogflowV2WebhookRequest) MarshalJSON() ([]byte, error) { // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// Protocol Buffers Language Guide. +// Protocol Buffers Language Guide +// (https://developers.google.com/protocol-buffers/docs/proto3#json). type GoogleCloudDialogflowV2WebhookResponse struct { // FollowupEventInput: Optional. Invokes the supplied events. When this // field is set, Dialogflow ignores the `fulfillment_text`, @@ -6077,9 +6119,12 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the Google Assistant integration for rich + // This field is also used by the Google Assistant integration + // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format + // (https://developers.google.com/assistant/actions/build/json/dialogflow + // -webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -6190,7 +6235,8 @@ func (s *GoogleCloudDialogflowV2beta1BatchUpdateIntentsResponse) MarshalJSON() ( // that intent become active. While any contexts are active, Dialogflow // is more likely to match intents that are configured with input // contexts that correspond to the currently active contexts. For more -// information about context, see the Contexts guide. +// information about context, see the Contexts guide +// (https://cloud.google.com/dialogflow/docs/contexts-overview). type GoogleCloudDialogflowV2beta1Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -6256,7 +6302,8 @@ func (s *GoogleCloudDialogflowV2beta1Context) MarshalJSON() ([]byte, error) { // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// Entity guide. +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -6370,9 +6417,10 @@ func (s *GoogleCloudDialogflowV2beta1EntityTypeEntity) MarshalJSON() ([]byte, er // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2beta1EventInput struct { // LanguageCode: Required. The language of this query. See Language - // Support for a list of the currently supported language codes. Note - // that queries in the same session do not necessarily need to specify - // the same language. + // Support (https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that + // queries in the same session do not necessarily need to specify the + // same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -6453,7 +6501,8 @@ func (s *GoogleCloudDialogflowV2beta1ExportAgentResponse) MarshalJSON() ([]byte, // referred to as an end-user expression or end-user input, Dialogflow // matches the end-user input to the best intent in your agent. Matching // an intent is also known as intent classification. For more -// information, see the intent guide. +// information, see the intent guide +// (https://cloud.google.com/dialogflow/docs/intents-overview). type GoogleCloudDialogflowV2beta1Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -7665,8 +7714,9 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction) MarshalJSO // phone number but does not dial automatically. type GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial struct { // PhoneNumber: Required. The phone number to fill in the default dialer - // app. This field should be in E.164 format. An example of a correctly - // formatted phone number: +15556767888. + // app. This field should be in E.164 + // (https://en.wikipedia.org/wiki/E.164) format. An example of a + // correctly formatted phone number: +15556767888. PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -8148,7 +8198,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio) MarshalJSO // either be set at request-level or can come from the agent-level // synthesizer config. type GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech struct { - // Ssml: The SSML to be synthesized. For more information, see SSML. + // Ssml: The SSML to be synthesized. For more information, see SSML + // (https://developers.google.com/actions/reference/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -8181,8 +8232,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech) Mar // Transfers the call in Telephony Gateway. type GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall struct { // PhoneNumber: Required. The phone number to transfer the call to in - // E.164 format. We currently only allow transferring to US numbers - // (+1xxxyyyzzzz). + // E.164 format (https://en.wikipedia.org/wiki/E.164). We currently only + // allow transferring to US numbers (+1xxxyyyzzzz). PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -8556,7 +8607,8 @@ type GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in E.164 format for Essentials Edition agents. + // with the caller ID in E.164 format + // (https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -8638,8 +8690,9 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { KnowledgeAnswers *GoogleCloudDialogflowV2beta1KnowledgeAnswers `json:"knowledgeAnswers,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See Language Support for a list of the currently supported - // language codes. + // detection. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -8827,7 +8880,8 @@ func (s *GoogleCloudDialogflowV2beta1SentimentAnalysisResult) MarshalJSON() ([]b // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the session entity guide. +// minutes. For more information, see the session entity guide +// (https://cloud.google.com/dialogflow/docs/entities-session). type GoogleCloudDialogflowV2beta1SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -8948,7 +9002,8 @@ func (s *GoogleCloudDialogflowV2beta1WebhookRequest) MarshalJSON() ([]byte, erro // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// Protocol Buffers Language Guide. +// Protocol Buffers Language Guide +// (https://developers.google.com/protocol-buffers/docs/proto3#json). type GoogleCloudDialogflowV2beta1WebhookResponse struct { // EndInteraction: Optional. Indicates that this intent ends an // interaction. Some integrations (e.g., Actions on Google or Dialogflow @@ -8984,9 +9039,12 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the Google Assistant integration for rich + // This field is also used by the Google Assistant integration + // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format + // (https://developers.google.com/assistant/actions/build/json/dialogflow + // -webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -9140,10 +9198,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -9973,8 +10032,10 @@ func (r *ProjectsAgentService) GetValidationResult(parent string) *ProjectsAgent // LanguageCode sets the optional parameter "languageCode": The language // for which you want a validation result. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsAgentGetValidationResultCall) LanguageCode(languageCode string) *ProjectsAgentGetValidationResultCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -10427,7 +10488,9 @@ type ProjectsAgentSearchCall struct { // conversational agent per project, this method is useful primarily for // listing all agents across projects the caller has access to. One can // achieve that with a wildcard project collection id "-". Refer to List -// Sub-Collections. +// Sub-Collections +// (https://cloud.google.com/apis/design/design_patterns#list_sub-collect +// ions). func (r *ProjectsAgentService) Search(parent string) *ProjectsAgentSearchCall { c := &ProjectsAgentSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11211,7 +11274,9 @@ func (r *ProjectsAgentEntityTypesService) Create(parent string, googleclouddialo // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -11497,7 +11562,9 @@ func (r *ProjectsAgentEntityTypesService) Get(name string) *ProjectsAgentEntityT // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -11657,7 +11724,9 @@ func (r *ProjectsAgentEntityTypesService) List(parent string) *ProjectsAgentEnti // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -11865,7 +11934,9 @@ func (r *ProjectsAgentEntityTypesService) Patch(nameid string, googleclouddialog // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12779,7 +12850,8 @@ type ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall struct { // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. // Note: Always use agent versions for production traffic. See Versions -// and environments. +// and environments +// (https://cloud.google.com/dialogflow/es/docs/agents-versions). func (r *ProjectsAgentEnvironmentsUsersSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2detectintentrequest *GoogleCloudDialogflowV2DetectIntentRequest) *ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall { c := &ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -14777,7 +14849,9 @@ func (c *ProjectsAgentIntentsCreateCall) IntentView(intentView string) *Projects // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15088,7 +15162,9 @@ func (c *ProjectsAgentIntentsGetCall) IntentView(intentView string) *ProjectsAge // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15272,7 +15348,9 @@ func (c *ProjectsAgentIntentsListCall) IntentView(intentView string) *ProjectsAg // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15505,7 +15583,9 @@ func (c *ProjectsAgentIntentsPatchCall) IntentView(intentView string) *ProjectsA // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15811,7 +15891,8 @@ type ProjectsAgentSessionsDetectIntentCall struct { // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. // Note: Always use agent versions for production traffic. See Versions -// and environments. +// and environments +// (https://cloud.google.com/dialogflow/es/docs/agents-versions). func (r *ProjectsAgentSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2detectintentrequest *GoogleCloudDialogflowV2DetectIntentRequest) *ProjectsAgentSessionsDetectIntentCall { c := &ProjectsAgentSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index 04e5118299f..9aa71536d66 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -986,8 +986,8 @@ type GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText struct { // can then starts the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Ssml: The SSML text to be synthesized. For more information, see - // SSML. + // Ssml: The SSML text to be synthesized. For more information, see SSML + // (/speech/text-to-speech/docs/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -1815,8 +1815,8 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText struct { // can then starts the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Ssml: The SSML text to be synthesized. For more information, see - // SSML. + // Ssml: The SSML text to be synthesized. For more information, see SSML + // (/speech/text-to-speech/docs/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -2213,13 +2213,15 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse) Marsh // or purely a part of the message between two entities or message // start/end. type GoogleCloudDialogflowV2AnnotatedMessagePart struct { - // EntityType: The Dialogflow system entity type of this message part. - // If this is empty, Dialogflow could not annotate the phrase part with - // a system entity. + // EntityType: The Dialogflow system entity type + // (https://cloud.google.com/dialogflow/docs/reference/system-entities) + // of this message part. If this is empty, Dialogflow could not annotate + // the phrase part with a system entity. EntityType string `json:"entityType,omitempty"` - // FormattedValue: The Dialogflow system entity formatted value of this - // message part. For example for a system entity of type + // FormattedValue: The Dialogflow system entity formatted value + // (https://cloud.google.com/dialogflow/docs/reference/system-entities) + // of this message part. For example for a system entity of type // `@sys.unit-currency`, this may contain: { "amount": 5, "currency": // "USD" } FormattedValue interface{} `json:"formattedValue,omitempty"` @@ -2320,7 +2322,8 @@ func (s *GoogleCloudDialogflowV2BatchUpdateIntentsResponse) MarshalJSON() ([]byt // active. While any contexts are active, Dialogflow is more likely to // match intents that are configured with input contexts that correspond // to the currently active contexts. For more information about context, -// see the Contexts guide. +// see the Contexts guide +// (https://cloud.google.com/dialogflow/docs/contexts-overview). type GoogleCloudDialogflowV2Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -2444,7 +2447,8 @@ func (s *GoogleCloudDialogflowV2ConversationEvent) MarshalJSON() ([]byte, error) // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// Entity guide. +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -2557,9 +2561,10 @@ func (s *GoogleCloudDialogflowV2EntityTypeEntity) MarshalJSON() ([]byte, error) // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2EventInput struct { // LanguageCode: Required. The language of this query. See Language - // Support for a list of the currently supported language codes. Note - // that queries in the same session do not necessarily need to specify - // the same language. + // Support (https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that + // queries in the same session do not necessarily need to specify the + // same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -2640,7 +2645,8 @@ func (s *GoogleCloudDialogflowV2ExportAgentResponse) MarshalJSON() ([]byte, erro // as an end-user expression or end-user input, Dialogflow matches the // end-user input to the best intent in your agent. Matching an intent // is also known as intent classification. For more information, see the -// intent guide. +// intent guide +// (https://cloud.google.com/dialogflow/docs/intents-overview). type GoogleCloudDialogflowV2Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -2815,7 +2821,8 @@ func (s *GoogleCloudDialogflowV2IntentFollowupIntentInfo) MarshalJSON() ([]byte, // GoogleCloudDialogflowV2IntentMessage: A rich response message. // Corresponds to the intent `Response` field in the Dialogflow console. -// For more information, see Rich response messages. +// For more information, see Rich response messages +// (https://cloud.google.com/dialogflow/docs/intents-rich-messages). type GoogleCloudDialogflowV2IntentMessage struct { // BasicCard: The basic card response for Actions on Google. BasicCard *GoogleCloudDialogflowV2IntentMessageBasicCard `json:"basicCard,omitempty"` @@ -4045,7 +4052,8 @@ type GoogleCloudDialogflowV2Message struct { CreateTime string `json:"createTime,omitempty"` // LanguageCode: Optional. The message language. This should be a BCP-47 - // language tag. Example: "en-US". + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Example: + // "en-US". LanguageCode string `json:"languageCode,omitempty"` // MessageAnnotation: Output only. The annotation for the message. @@ -4139,7 +4147,8 @@ type GoogleCloudDialogflowV2OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in E.164 format for Essentials Edition agents. + // with the caller ID in E.164 format + // (https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -4217,8 +4226,9 @@ type GoogleCloudDialogflowV2QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See Language Support for a list of the currently supported - // language codes. + // detection. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -4406,7 +4416,8 @@ func (s *GoogleCloudDialogflowV2SentimentAnalysisResult) MarshalJSON() ([]byte, // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the session entity guide. +// minutes. For more information, see the session entity guide +// (https://cloud.google.com/dialogflow/docs/entities-session). type GoogleCloudDialogflowV2SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -4517,7 +4528,8 @@ func (s *GoogleCloudDialogflowV2WebhookRequest) MarshalJSON() ([]byte, error) { // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// Protocol Buffers Language Guide. +// Protocol Buffers Language Guide +// (https://developers.google.com/protocol-buffers/docs/proto3#json). type GoogleCloudDialogflowV2WebhookResponse struct { // FollowupEventInput: Optional. Invokes the supplied events. When this // field is set, Dialogflow ignores the `fulfillment_text`, @@ -4547,9 +4559,12 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the Google Assistant integration for rich + // This field is also used by the Google Assistant integration + // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format + // (https://developers.google.com/assistant/actions/build/json/dialogflow + // -webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -4597,7 +4612,8 @@ func (s *GoogleCloudDialogflowV2WebhookResponse) MarshalJSON() ([]byte, error) { // conversation to structured data that your apps and services can // understand. You design and build a Dialogflow agent to handle the // types of conversations required for your system. For more information -// about agents, see the Agent guide. +// about agents, see the Agent guide +// (https://cloud.google.com/dialogflow/docs/agents-overview). type GoogleCloudDialogflowV2beta1Agent struct { // ApiVersion: Optional. API version displayed in Dialogflow console. If // not specified, V2 API is assumed. Clients are free to query different @@ -4613,6 +4629,7 @@ type GoogleCloudDialogflowV2beta1Agent struct { // AvatarUri: Optional. The URI of the agent's avatar. Avatars are used // throughout the Dialogflow console and in the self-hosted Web Demo + // (https://cloud.google.com/dialogflow/docs/integrations/web-demo) // integration. AvatarUri string `json:"avatarUri,omitempty"` @@ -4627,9 +4644,10 @@ type GoogleCloudDialogflowV2beta1Agent struct { ClassificationThreshold float64 `json:"classificationThreshold,omitempty"` // DefaultLanguageCode: Required. The default language of the agent as a - // language tag. See Language Support for a list of the currently - // supported language codes. This field cannot be set by the `Update` - // method. + // language tag. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. This field cannot be + // set by the `Update` method. DefaultLanguageCode string `json:"defaultLanguageCode,omitempty"` // Description: Optional. The description of this agent. The maximum @@ -4676,7 +4694,8 @@ type GoogleCloudDialogflowV2beta1Agent struct { Tier string `json:"tier,omitempty"` // TimeZone: Required. The time zone of this agent from the time zone - // database, e.g., America/New_York, Europe/Paris. + // database (https://www.iana.org/time-zones), e.g., America/New_York, + // Europe/Paris. TimeZone string `json:"timeZone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4728,7 +4747,9 @@ type GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see Multilingual intent and entity data. + // more information, see Multilingual intent and entity data + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e + // ntity). LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Entities") to @@ -4764,7 +4785,9 @@ type GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see Multilingual intent and entity data. + // more information, see Multilingual intent and entity data + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e + // ntity). LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "EntityValues") to @@ -4859,7 +4882,9 @@ type GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see Multilingual intent and entity data. + // more information, see Multilingual intent and entity data + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e + // ntity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -4903,7 +4928,9 @@ type GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see Multilingual intent and entity data. + // more information, see Multilingual intent and entity data + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e + // ntity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -4986,7 +5013,9 @@ type GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For - // more information, see Multilingual intent and entity data. + // more information, see Multilingual intent and entity data + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e + // ntity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -5057,7 +5086,8 @@ func (s *GoogleCloudDialogflowV2beta1BatchUpdateIntentsResponse) MarshalJSON() ( // that intent become active. While any contexts are active, Dialogflow // is more likely to match intents that are configured with input // contexts that correspond to the currently active contexts. For more -// information about context, see the Contexts guide. +// information about context, see the Contexts guide +// (https://cloud.google.com/dialogflow/docs/contexts-overview). type GoogleCloudDialogflowV2beta1Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -5242,8 +5272,9 @@ func (s *GoogleCloudDialogflowV2beta1DetectIntentResponse) MarshalJSON() ([]byte // GoogleCloudDialogflowV2beta1Document: A knowledge document to be used // by a KnowledgeBase. For more information, see the knowledge base -// guide. Note: The `projects.agent.knowledgeBases.documents` resource -// is deprecated; only use `projects.knowledgeBases.documents`. +// guide (https://cloud.google.com/dialogflow/docs/how/knowledge-bases). +// Note: The `projects.agent.knowledgeBases.documents` resource is +// deprecated; only use `projects.knowledgeBases.documents`. type GoogleCloudDialogflowV2beta1Document struct { // Content: The raw content of the document. This field is only // permitted for EXTRACTIVE_QA and FAQ knowledge types. Note: This field @@ -5379,7 +5410,8 @@ func (s *GoogleCloudDialogflowV2beta1DocumentReloadStatus) MarshalJSON() ([]byte // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// Entity guide. +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -5528,7 +5560,8 @@ func (s *GoogleCloudDialogflowV2beta1EntityTypeEntity) MarshalJSON() ([]byte, er // versions, you can publish them to custom environments. You can create // a variety of custom environments for: - testing - development - // production - etc. For more information, see the versions and -// environments guide. +// environments guide +// (https://cloud.google.com/dialogflow/docs/agents-versions). type GoogleCloudDialogflowV2beta1Environment struct { // AgentVersion: Optional. The agent version loaded into this // environment. Supported formats: - `projects//agent/versions/` - @@ -5590,9 +5623,10 @@ func (s *GoogleCloudDialogflowV2beta1Environment) MarshalJSON() ([]byte, error) // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2beta1EventInput struct { // LanguageCode: Required. The language of this query. See Language - // Support for a list of the currently supported language codes. Note - // that queries in the same session do not necessarily need to specify - // the same language. + // Support (https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that + // queries in the same session do not necessarily need to specify the + // same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -5635,8 +5669,9 @@ func (s *GoogleCloudDialogflowV2beta1EventInput) MarshalJSON() ([]byte, error) { // GoogleCloudDialogflowV2beta1ExportAgentRequest: The request message // for Agents.ExportAgent. type GoogleCloudDialogflowV2beta1ExportAgentRequest struct { - // AgentUri: Optional. The Google Cloud Storage URI to export the agent - // to. The format of this URI must be `gs:///`. If left unspecified, the + // AgentUri: Optional. The Google Cloud Storage + // (https://cloud.google.com/storage/docs/) URI to export the agent to. + // The format of this URI must be `gs:///`. If left unspecified, the // serialized agent is returned inline. AgentUri string `json:"agentUri,omitempty"` @@ -5705,7 +5740,8 @@ func (s *GoogleCloudDialogflowV2beta1ExportAgentResponse) MarshalJSON() ([]byte, // example, if an end-user wants to schedule a haircut on Friday, your // service can check your database and respond to the end-user with // availability information for Friday. For more information, see the -// fulfillment guide. +// fulfillment guide +// (https://cloud.google.com/dialogflow/docs/fulfillment-overview). type GoogleCloudDialogflowV2beta1Fulfillment struct { // DisplayName: The human-readable name of the fulfillment, unique // within the agent. @@ -5948,9 +5984,11 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { EnableWordInfo bool `json:"enableWordInfo,omitempty"` // LanguageCode: Required. The language of the supplied audio. - // Dialogflow does not do translations. See Language Support for a list - // of the currently supported language codes. Note that queries in the - // same session do not necessarily need to specify the same language. + // Dialogflow does not do translations. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. Note that queries in + // the same session do not necessarily need to specify the same + // language. LanguageCode string `json:"languageCode,omitempty"` // Model: Which Speech model to select for the given request. Select the @@ -5960,7 +5998,9 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { // enabled for the agent and an enhanced version of the specified model // for the language does not exist, then the speech is recognized using // the standard version of the specified model. Refer to Cloud Speech - // API documentation for more details. + // API documentation + // (https://cloud.google.com/speech-to-text/docs/basics#select-model) + // for more details. Model string `json:"model,omitempty"` // ModelVariant: Which variant of the Speech model to use. @@ -5989,15 +6029,18 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { // PhraseHints: A list of strings containing words and phrases that the // speech recognizer should recognize with higher likelihood. See the - // Cloud Speech documentation for more details. This field is - // deprecated. Please use speech_contexts instead. If you specify both - // phrase_hints and speech_contexts, Dialogflow will treat the - // phrase_hints as a single additional SpeechContext. + // Cloud Speech documentation + // (https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) + // for more details. This field is deprecated. Please use + // speech_contexts () instead. If you specify both phrase_hints () and + // speech_contexts (), Dialogflow will treat the phrase_hints () as a + // single additional SpeechContext (). PhraseHints []string `json:"phraseHints,omitempty"` // SampleRateHertz: Required. Sample rate (in Hertz) of the audio // content sent in the query. Refer to Cloud Speech API documentation - // for more details. + // (https://cloud.google.com/speech-to-text/docs/basics) for more + // details. SampleRateHertz int64 `json:"sampleRateHertz,omitempty"` // SingleUtterance: If `false` (default), recognition does not cease @@ -6012,7 +6055,9 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { SingleUtterance bool `json:"singleUtterance,omitempty"` // SpeechContexts: Context information to assist speech recognition. See - // the Cloud Speech documentation for more details. + // the Cloud Speech documentation + // (https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) + // for more details. SpeechContexts []*GoogleCloudDialogflowV2beta1SpeechContext `json:"speechContexts,omitempty"` // ForceSendFields is a list of field names (e.g. "AudioEncoding") to @@ -6045,7 +6090,8 @@ func (s *GoogleCloudDialogflowV2beta1InputAudioConfig) MarshalJSON() ([]byte, er // referred to as an end-user expression or end-user input, Dialogflow // matches the end-user input to the best intent in your agent. Matching // an intent is also known as intent classification. For more -// information, see the intent guide. +// information, see the intent guide +// (https://cloud.google.com/dialogflow/docs/intents-overview). type GoogleCloudDialogflowV2beta1Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -7290,8 +7336,9 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction) MarshalJSO // phone number but does not dial automatically. type GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial struct { // PhoneNumber: Required. The phone number to fill in the default dialer - // app. This field should be in E.164 format. An example of a correctly - // formatted phone number: +15556767888. + // app. This field should be in E.164 + // (https://en.wikipedia.org/wiki/E.164) format. An example of a + // correctly formatted phone number: +15556767888. PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -7773,7 +7820,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio) MarshalJSO // either be set at request-level or can come from the agent-level // synthesizer config. type GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech struct { - // Ssml: The SSML to be synthesized. For more information, see SSML. + // Ssml: The SSML to be synthesized. For more information, see SSML + // (https://developers.google.com/actions/reference/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -7806,8 +7854,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech) Mar // Transfers the call in Telephony Gateway. type GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall struct { // PhoneNumber: Required. The phone number to transfer the call to in - // E.164 format. We currently only allow transferring to US numbers - // (+1xxxyyyzzzz). + // E.164 format (https://en.wikipedia.org/wiki/E.164). We currently only + // allow transferring to US numbers (+1xxxyyyzzzz). PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -8140,8 +8188,9 @@ func (s *GoogleCloudDialogflowV2beta1KnowledgeAnswersAnswer) UnmarshalJSON(data // Dialogflow. Your knowledge documents contain information that may be // useful during conversations with end-users. Some Dialogflow features // use knowledge bases when looking for a response to an end-user input. -// For more information, see the knowledge base guide. Note: The -// `projects.agent.knowledgeBases` resource is deprecated; only use +// For more information, see the knowledge base guide +// (https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: +// The `projects.agent.knowledgeBases` resource is deprecated; only use // `projects.knowledgeBases`. type GoogleCloudDialogflowV2beta1KnowledgeBase struct { // DisplayName: Required. The display name of the knowledge base. The @@ -8498,7 +8547,8 @@ type GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in E.164 format for Essentials Edition agents. + // with the caller ID in E.164 format + // (https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -8672,8 +8722,9 @@ type GoogleCloudDialogflowV2beta1QueryParameters struct { SubAgents []*GoogleCloudDialogflowV2beta1SubAgent `json:"subAgents,omitempty"` // TimeZone: The time zone of this conversational query from the time - // zone database, e.g., America/New_York, Europe/Paris. If not provided, - // the time zone specified in agent settings is used. + // zone database (https://www.iana.org/time-zones), e.g., + // America/New_York, Europe/Paris. If not provided, the time zone + // specified in agent settings is used. TimeZone string `json:"timeZone,omitempty"` // WebhookHeaders: This field can be used to pass HTTP headers for a @@ -8758,8 +8809,9 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { KnowledgeAnswers *GoogleCloudDialogflowV2beta1KnowledgeAnswers `json:"knowledgeAnswers,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See Language Support for a list of the currently supported - // language codes. + // detection. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -9087,7 +9139,8 @@ func (s *GoogleCloudDialogflowV2beta1SentimentAnalysisResult) MarshalJSON() ([]b // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the session entity guide. +// minutes. For more information, see the session entity guide +// (https://cloud.google.com/dialogflow/docs/entities-session). type GoogleCloudDialogflowV2beta1SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -9169,7 +9222,8 @@ type GoogleCloudDialogflowV2beta1SpeechContext struct { // This list can be used to: * improve accuracy for words and phrases // you expect the user to say, e.g. typical commands for your Dialogflow // agent * add additional words to the speech recognizer vocabulary * - // ... See the Cloud Speech documentation for usage limits. + // ... See the Cloud Speech documentation + // (https://cloud.google.com/speech-to-text/quotas) for usage limits. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to @@ -9325,9 +9379,11 @@ func (s *GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig) UnmarshalJSON(data // language text to be processed. type GoogleCloudDialogflowV2beta1TextInput struct { // LanguageCode: Required. The language of this conversational query. - // See Language Support for a list of the currently supported language - // codes. Note that queries in the same session do not necessarily need - // to specify the same language. + // See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. Note that queries in + // the same session do not necessarily need to specify the same + // language. LanguageCode string `json:"languageCode,omitempty"` // Text: Required. The UTF-8 encoded natural language text to be @@ -9554,7 +9610,8 @@ func (s *GoogleCloudDialogflowV2beta1WebhookRequest) MarshalJSON() ([]byte, erro // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// Protocol Buffers Language Guide. +// Protocol Buffers Language Guide +// (https://developers.google.com/protocol-buffers/docs/proto3#json). type GoogleCloudDialogflowV2beta1WebhookResponse struct { // EndInteraction: Optional. Indicates that this intent ends an // interaction. Some integrations (e.g., Actions on Google or Dialogflow @@ -9590,9 +9647,12 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the Google Assistant integration for rich + // This field is also used by the Google Assistant integration + // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format + // (https://developers.google.com/assistant/actions/build/json/dialogflow + // -webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -9746,10 +9806,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -10581,8 +10642,10 @@ func (r *ProjectsAgentService) GetValidationResult(parent string) *ProjectsAgent // LanguageCode sets the optional parameter "languageCode": The language // for which you want a validation result. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsAgentGetValidationResultCall) LanguageCode(languageCode string) *ProjectsAgentGetValidationResultCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -11036,7 +11099,9 @@ type ProjectsAgentSearchCall struct { // conversational agent per project, this method is useful primarily for // listing all agents across projects the caller has access to. One can // achieve that with a wildcard project collection id "-". Refer to List -// Sub-Collections. +// Sub-Collections +// (https://cloud.google.com/apis/design/design_patterns#list_sub-collect +// ions). func (r *ProjectsAgentService) Search(parent string) *ProjectsAgentSearchCall { c := &ProjectsAgentSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11820,7 +11885,9 @@ func (r *ProjectsAgentEntityTypesService) Create(parent string, googleclouddialo // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12106,7 +12173,9 @@ func (r *ProjectsAgentEntityTypesService) Get(name string) *ProjectsAgentEntityT // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12266,7 +12335,9 @@ func (r *ProjectsAgentEntityTypesService) List(parent string) *ProjectsAgentEnti // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12474,7 +12545,9 @@ func (r *ProjectsAgentEntityTypesService) Patch(nameid string, googleclouddialog // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -13388,7 +13461,8 @@ type ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall struct { // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. // Note: Always use agent versions for production traffic. See Versions -// and environments. +// and environments +// (https://cloud.google.com/dialogflow/es/docs/agents-versions). func (r *ProjectsAgentEnvironmentsUsersSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2beta1detectintentrequest *GoogleCloudDialogflowV2beta1DetectIntentRequest) *ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall { c := &ProjectsAgentEnvironmentsUsersSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -15390,7 +15464,9 @@ func (c *ProjectsAgentIntentsCreateCall) IntentView(intentView string) *Projects // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15702,7 +15778,9 @@ func (c *ProjectsAgentIntentsGetCall) IntentView(intentView string) *ProjectsAge // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15887,7 +15965,9 @@ func (c *ProjectsAgentIntentsListCall) IntentView(intentView string) *ProjectsAg // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16120,7 +16200,9 @@ func (c *ProjectsAgentIntentsPatchCall) IntentView(intentView string) *ProjectsA // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16753,7 +16835,7 @@ func (r *ProjectsAgentKnowledgeBasesService) List(parent string) *ProjectsAgentK // bases whose display name contains "articles" and whose language code // is "en-gb". Note: An empty filter string (i.e. "") is a no-op and // will result in no filtering. For more information about filtering, -// see API Filtering. +// see API Filtering (https://aip.dev/160). func (c *ProjectsAgentKnowledgeBasesListCall) Filter(filter string) *ProjectsAgentKnowledgeBasesListCall { c.urlParams_.Set("filter", filter) return c @@ -17568,7 +17650,7 @@ func (r *ProjectsAgentKnowledgeBasesDocumentsService) List(parent string) *Proje // display name contains "customer". * "state=ACTIVE" matches documents // with ACTIVE state. * "knowledge_types:FAQ AND state=ACTIVE" matches // all active FAQ documents. For more information about filtering, see -// API Filtering. +// API Filtering (https://aip.dev/160). func (c *ProjectsAgentKnowledgeBasesDocumentsListCall) Filter(filter string) *ProjectsAgentKnowledgeBasesDocumentsListCall { c.urlParams_.Set("filter", filter) return c @@ -18209,7 +18291,8 @@ type ProjectsAgentSessionsDetectIntentCall struct { // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. // Note: Always use agent versions for production traffic. See Versions -// and environments. +// and environments +// (https://cloud.google.com/dialogflow/es/docs/agents-versions). func (r *ProjectsAgentSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2beta1detectintentrequest *GoogleCloudDialogflowV2beta1DetectIntentRequest) *ProjectsAgentSessionsDetectIntentCall { c := &ProjectsAgentSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -20367,7 +20450,7 @@ func (r *ProjectsKnowledgeBasesService) List(parent string) *ProjectsKnowledgeBa // bases whose display name contains "articles" and whose language code // is "en-gb". Note: An empty filter string (i.e. "") is a no-op and // will result in no filtering. For more information about filtering, -// see API Filtering. +// see API Filtering (https://aip.dev/160). func (c *ProjectsKnowledgeBasesListCall) Filter(filter string) *ProjectsKnowledgeBasesListCall { c.urlParams_.Set("filter", filter) return c @@ -21182,7 +21265,7 @@ func (r *ProjectsKnowledgeBasesDocumentsService) List(parent string) *ProjectsKn // display name contains "customer". * "state=ACTIVE" matches documents // with ACTIVE state. * "knowledge_types:FAQ AND state=ACTIVE" matches // all active FAQ documents. For more information about filtering, see -// API Filtering. +// API Filtering (https://aip.dev/160). func (c *ProjectsKnowledgeBasesDocumentsListCall) Filter(filter string) *ProjectsKnowledgeBasesDocumentsListCall { c.urlParams_.Set("filter", filter) return c @@ -22417,8 +22500,10 @@ func (r *ProjectsLocationsAgentService) GetValidationResult(parent string) *Proj // LanguageCode sets the optional parameter "languageCode": The language // for which you want a validation result. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentGetValidationResultCall) LanguageCode(languageCode string) *ProjectsLocationsAgentGetValidationResultCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -22872,7 +22957,9 @@ type ProjectsLocationsAgentSearchCall struct { // conversational agent per project, this method is useful primarily for // listing all agents across projects the caller has access to. One can // achieve that with a wildcard project collection id "-". Refer to List -// Sub-Collections. +// Sub-Collections +// (https://cloud.google.com/apis/design/design_patterns#list_sub-collect +// ions). func (r *ProjectsLocationsAgentService) Search(parent string) *ProjectsLocationsAgentSearchCall { c := &ProjectsLocationsAgentSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -23656,7 +23743,9 @@ func (r *ProjectsLocationsAgentEntityTypesService) Create(parent string, googlec // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsLocationsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -23942,7 +24031,9 @@ func (r *ProjectsLocationsAgentEntityTypesService) Get(name string) *ProjectsLoc // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsLocationsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -24102,7 +24193,9 @@ func (r *ProjectsLocationsAgentEntityTypesService) List(parent string) *Projects // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsLocationsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -24310,7 +24403,9 @@ func (r *ProjectsLocationsAgentEntityTypesService) Patch(nameid string, googlecl // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsLocationsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -25224,7 +25319,8 @@ type ProjectsLocationsAgentEnvironmentsUsersSessionsDetectIntentCall struct { // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. // Note: Always use agent versions for production traffic. See Versions -// and environments. +// and environments +// (https://cloud.google.com/dialogflow/es/docs/agents-versions). func (r *ProjectsLocationsAgentEnvironmentsUsersSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2beta1detectintentrequest *GoogleCloudDialogflowV2beta1DetectIntentRequest) *ProjectsLocationsAgentEnvironmentsUsersSessionsDetectIntentCall { c := &ProjectsLocationsAgentEnvironmentsUsersSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -27226,7 +27322,9 @@ func (c *ProjectsLocationsAgentIntentsCreateCall) IntentView(intentView string) // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsLocationsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -27538,7 +27636,9 @@ func (c *ProjectsLocationsAgentIntentsGetCall) IntentView(intentView string) *Pr // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsLocationsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -27723,7 +27823,9 @@ func (c *ProjectsLocationsAgentIntentsListCall) IntentView(intentView string) *P // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsLocationsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -27956,7 +28058,9 @@ func (c *ProjectsLocationsAgentIntentsPatchCall) IntentView(intentView string) * // LanguageCode sets the optional parameter "languageCode": The language // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual -// intent and entity data. +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e +// ntity). func (c *ProjectsLocationsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -28263,7 +28367,8 @@ type ProjectsLocationsAgentSessionsDetectIntentCall struct { // idempotent, because it may cause contexts and session entity types to // be updated, which in turn might affect results of future queries. // Note: Always use agent versions for production traffic. See Versions -// and environments. +// and environments +// (https://cloud.google.com/dialogflow/es/docs/agents-versions). func (r *ProjectsLocationsAgentSessionsService) DetectIntent(sessionid string, googleclouddialogflowv2beta1detectintentrequest *GoogleCloudDialogflowV2beta1DetectIntentRequest) *ProjectsLocationsAgentSessionsDetectIntentCall { c := &ProjectsLocationsAgentSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -30421,7 +30526,7 @@ func (r *ProjectsLocationsKnowledgeBasesService) List(parent string) *ProjectsLo // bases whose display name contains "articles" and whose language code // is "en-gb". Note: An empty filter string (i.e. "") is a no-op and // will result in no filtering. For more information about filtering, -// see API Filtering. +// see API Filtering (https://aip.dev/160). func (c *ProjectsLocationsKnowledgeBasesListCall) Filter(filter string) *ProjectsLocationsKnowledgeBasesListCall { c.urlParams_.Set("filter", filter) return c @@ -31236,7 +31341,7 @@ func (r *ProjectsLocationsKnowledgeBasesDocumentsService) List(parent string) *P // display name contains "customer". * "state=ACTIVE" matches documents // with ACTIVE state. * "knowledge_types:FAQ AND state=ACTIVE" matches // all active FAQ documents. For more information about filtering, see -// API Filtering. +// API Filtering (https://aip.dev/160). func (c *ProjectsLocationsKnowledgeBasesDocumentsListCall) Filter(filter string) *ProjectsLocationsKnowledgeBasesDocumentsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 4b4736d8659..05c27431bc9 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -367,13 +367,16 @@ type ProjectsOperationsService struct { // flows.. type GoogleCloudDialogflowCxV3Agent struct { // AvatarUri: The URI of the agent's avatar. Avatars are used throughout - // the Dialogflow console and in the self-hosted Web Demo integration. + // the Dialogflow console and in the self-hosted Web Demo + // (https://cloud.google.com/dialogflow/docs/integrations/web-demo) + // integration. AvatarUri string `json:"avatarUri,omitempty"` // DefaultLanguageCode: Immutable. The default language of the agent as - // a language tag. See Language Support for a list of the currently - // supported language codes. This field cannot be set by the - // Agents.UpdateAgent method. + // a language tag. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. This field cannot be + // set by the Agents.UpdateAgent method. DefaultLanguageCode string `json:"defaultLanguageCode,omitempty"` // Description: The description of the agent. The maximum length is 500 @@ -407,7 +410,8 @@ type GoogleCloudDialogflowCxV3Agent struct { StartFlow string `json:"startFlow,omitempty"` // TimeZone: Required. The time zone of the agent from the time zone - // database, e.g., America/New_York, Europe/Paris. + // database (https://www.iana.org/time-zones), e.g., America/New_York, + // Europe/Paris. TimeZone string `json:"timeZone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -648,7 +652,8 @@ func (s *GoogleCloudDialogflowCxV3DtmfInput) MarshalJSON() ([]byte, error) { // that are built for an individual user such as favorites, preferences, // playlists, and so on. A user entity is represented by the // SessionEntityType type. For more information about entity types, see -// the Dialogflow documentation. +// the Dialogflow documentation +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowCxV3EntityType struct { // AutoExpansionMode: Indicates whether the entity type can be // automatically expanded. @@ -967,8 +972,9 @@ func (s *GoogleCloudDialogflowCxV3EventInput) MarshalJSON() ([]byte, error) { // GoogleCloudDialogflowCxV3ExportAgentRequest: The request message for // Agents.ExportAgent. type GoogleCloudDialogflowCxV3ExportAgentRequest struct { - // AgentUri: Optional. The Google Cloud Storage URI to export the agent - // to. The format of this URI must be `gs:///`. If left unspecified, the + // AgentUri: Optional. The Google Cloud Storage + // (https://cloud.google.com/storage/docs/) URI to export the agent to. + // The format of this URI must be `gs:///`. If left unspecified, the // serialized agent is returned inline. AgentUri string `json:"agentUri,omitempty"` @@ -1438,7 +1444,8 @@ type GoogleCloudDialogflowCxV3FulfillmentConditionalCasesCase struct { // Condition: The condition to activate and select this case. Empty // means the condition is always true. The condition is evaluated // against form parameters or session parameters. See the conditions - // reference. + // reference + // (https://cloud.google.com/dialogflow/cx/docs/reference/condition). Condition string `json:"condition,omitempty"` // ForceSendFields is a list of field names (e.g. "CaseContent") to @@ -1586,7 +1593,9 @@ type GoogleCloudDialogflowCxV3InputAudioConfig struct { // is enabled for the agent and an enhanced version of the specified // model for the language does not exist, then the speech is recognized // using the standard version of the specified model. Refer to Cloud - // Speech API documentation for more details. + // Speech API documentation + // (https://cloud.google.com/speech-to-text/docs/basics#select-model) + // for more details. Model string `json:"model,omitempty"` // ModelVariant: Optional. Which variant of the Speech model to use. @@ -1615,11 +1624,15 @@ type GoogleCloudDialogflowCxV3InputAudioConfig struct { // PhraseHints: Optional. A list of strings containing words and phrases // that the speech recognizer should recognize with higher likelihood. - // See the Cloud Speech documentation for more details. + // See the Cloud Speech documentation + // (https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) + // for more details. PhraseHints []string `json:"phraseHints,omitempty"` // SampleRateHertz: Sample rate (in Hertz) of the audio content sent in - // the query. Refer to Cloud Speech API documentation for more details. + // the query. Refer to Cloud Speech API documentation + // (https://cloud.google.com/speech-to-text/docs/basics) for more + // details. SampleRateHertz int64 `json:"sampleRateHertz,omitempty"` // SingleUtterance: Optional. If `false` (default), recognition does not @@ -2703,7 +2716,8 @@ func (s *GoogleCloudDialogflowCxV3OutputAudioConfig) MarshalJSON() ([]byte, erro // turn, the current page will either stay the same or transition to // another page. You configure each page to collect information from the // end-user that is relevant for the conversational state represented by -// the page. For more information, see the Page guide. +// the page. For more information, see the Page guide +// (https://cloud.google.com/dialogflow/cx/docs/concept/page). type GoogleCloudDialogflowCxV3Page struct { // DisplayName: Required. The human-readable name of the page, unique // within the agent. @@ -2921,9 +2935,10 @@ type GoogleCloudDialogflowCxV3QueryInput struct { Intent *GoogleCloudDialogflowCxV3IntentInput `json:"intent,omitempty"` // LanguageCode: Required. The language of the input. See Language - // Support for a list of the currently supported language codes. Note - // that queries in the same session do not necessarily need to specify - // the same language. + // Support (https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that + // queries in the same session do not necessarily need to specify the + // same language. LanguageCode string `json:"languageCode,omitempty"` // Text: The natural language text to be processed. @@ -2986,8 +3001,9 @@ type GoogleCloudDialogflowCxV3QueryParameters struct { SessionEntityTypes []*GoogleCloudDialogflowCxV3SessionEntityType `json:"sessionEntityTypes,omitempty"` // TimeZone: The time zone of this conversational query from the time - // zone database, e.g., America/New_York, Europe/Paris. If not provided, - // the time zone specified in the agent is used. + // zone database (https://www.iana.org/time-zones), e.g., + // America/New_York, Europe/Paris. If not provided, the time zone + // specified in the agent is used. TimeZone string `json:"timeZone,omitempty"` // WebhookHeaders: This field can be used to pass HTTP headers for a @@ -3054,8 +3070,9 @@ type GoogleCloudDialogflowCxV3QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See Language Support for a list of the currently supported - // language codes. + // detection. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // Match: Intent match result, could be an intent or an event. @@ -3387,8 +3404,8 @@ type GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText struct { // can then starts the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Ssml: The SSML text to be synthesized. For more information, see - // SSML. + // Ssml: The SSML text to be synthesized. For more information, see SSML + // (/speech/text-to-speech/docs/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -3499,8 +3516,9 @@ type GoogleCloudDialogflowCxV3RestoreAgentRequest struct { // AgentContent: Uncompressed raw byte content for agent. AgentContent string `json:"agentContent,omitempty"` - // AgentUri: The Google Cloud Storage URI to restore agent from. The - // format of this URI must be `gs:///`. + // AgentUri: The Google Cloud Storage + // (https://cloud.google.com/storage/docs/) URI to restore agent from. + // The format of this URI must be `gs:///`. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -3668,7 +3686,8 @@ func (s *GoogleCloudDialogflowCxV3SentimentAnalysisResult) UnmarshalJSON(data [] // refer to the entity types defined at the agent level as "custom // entity types"). Note: session entity types apply to all queries, // regardless of the language. For more information about entity types, -// see the Dialogflow documentation. +// see the Dialogflow documentation +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowCxV3SessionEntityType struct { // Entities: Required. The collection of entities to override or // supplement the custom entity type. @@ -3922,10 +3941,11 @@ type GoogleCloudDialogflowCxV3TrainFlowRequest struct { // transition into the specified flow. type GoogleCloudDialogflowCxV3TransitionRoute struct { // Condition: The condition to evaluate against form parameters or - // session parameters. See the conditions reference. At least one of - // `intent` or `condition` must be specified. When both `intent` and - // `condition` are specified, the transition can only happen when both - // are fulfilled. + // session parameters. See the conditions reference + // (https://cloud.google.com/dialogflow/cx/docs/reference/condition). At + // least one of `intent` or `condition` must be specified. When both + // `intent` and `condition` are specified, the transition can only + // happen when both are fulfilled. Condition string `json:"condition,omitempty"` // Intent: The unique identifier of an Intent. Format: @@ -4909,8 +4929,8 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText struct { // can then starts the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Ssml: The SSML text to be synthesized. For more information, see - // SSML. + // Ssml: The SSML text to be synthesized. For more information, see SSML + // (/speech/text-to-speech/docs/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -5307,13 +5327,15 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse) Marsh // or purely a part of the message between two entities or message // start/end. type GoogleCloudDialogflowV2AnnotatedMessagePart struct { - // EntityType: The Dialogflow system entity type of this message part. - // If this is empty, Dialogflow could not annotate the phrase part with - // a system entity. + // EntityType: The Dialogflow system entity type + // (https://cloud.google.com/dialogflow/docs/reference/system-entities) + // of this message part. If this is empty, Dialogflow could not annotate + // the phrase part with a system entity. EntityType string `json:"entityType,omitempty"` - // FormattedValue: The Dialogflow system entity formatted value of this - // message part. For example for a system entity of type + // FormattedValue: The Dialogflow system entity formatted value + // (https://cloud.google.com/dialogflow/docs/reference/system-entities) + // of this message part. For example for a system entity of type // `@sys.unit-currency`, this may contain: { "amount": 5, "currency": // "USD" } FormattedValue interface{} `json:"formattedValue,omitempty"` @@ -5414,7 +5436,8 @@ func (s *GoogleCloudDialogflowV2BatchUpdateIntentsResponse) MarshalJSON() ([]byt // active. While any contexts are active, Dialogflow is more likely to // match intents that are configured with input contexts that correspond // to the currently active contexts. For more information about context, -// see the Contexts guide. +// see the Contexts guide +// (https://cloud.google.com/dialogflow/docs/contexts-overview). type GoogleCloudDialogflowV2Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -5538,7 +5561,8 @@ func (s *GoogleCloudDialogflowV2ConversationEvent) MarshalJSON() ([]byte, error) // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// Entity guide. +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -5651,9 +5675,10 @@ func (s *GoogleCloudDialogflowV2EntityTypeEntity) MarshalJSON() ([]byte, error) // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2EventInput struct { // LanguageCode: Required. The language of this query. See Language - // Support for a list of the currently supported language codes. Note - // that queries in the same session do not necessarily need to specify - // the same language. + // Support (https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that + // queries in the same session do not necessarily need to specify the + // same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -5734,7 +5759,8 @@ func (s *GoogleCloudDialogflowV2ExportAgentResponse) MarshalJSON() ([]byte, erro // as an end-user expression or end-user input, Dialogflow matches the // end-user input to the best intent in your agent. Matching an intent // is also known as intent classification. For more information, see the -// intent guide. +// intent guide +// (https://cloud.google.com/dialogflow/docs/intents-overview). type GoogleCloudDialogflowV2Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -5909,7 +5935,8 @@ func (s *GoogleCloudDialogflowV2IntentFollowupIntentInfo) MarshalJSON() ([]byte, // GoogleCloudDialogflowV2IntentMessage: A rich response message. // Corresponds to the intent `Response` field in the Dialogflow console. -// For more information, see Rich response messages. +// For more information, see Rich response messages +// (https://cloud.google.com/dialogflow/docs/intents-rich-messages). type GoogleCloudDialogflowV2IntentMessage struct { // BasicCard: The basic card response for Actions on Google. BasicCard *GoogleCloudDialogflowV2IntentMessageBasicCard `json:"basicCard,omitempty"` @@ -7139,7 +7166,8 @@ type GoogleCloudDialogflowV2Message struct { CreateTime string `json:"createTime,omitempty"` // LanguageCode: Optional. The message language. This should be a BCP-47 - // language tag. Example: "en-US". + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Example: + // "en-US". LanguageCode string `json:"languageCode,omitempty"` // MessageAnnotation: Output only. The annotation for the message. @@ -7233,7 +7261,8 @@ type GoogleCloudDialogflowV2OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in E.164 format for Essentials Edition agents. + // with the caller ID in E.164 format + // (https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -7311,8 +7340,9 @@ type GoogleCloudDialogflowV2QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See Language Support for a list of the currently supported - // language codes. + // detection. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -7500,7 +7530,8 @@ func (s *GoogleCloudDialogflowV2SentimentAnalysisResult) MarshalJSON() ([]byte, // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the session entity guide. +// minutes. For more information, see the session entity guide +// (https://cloud.google.com/dialogflow/docs/entities-session). type GoogleCloudDialogflowV2SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -7611,7 +7642,8 @@ func (s *GoogleCloudDialogflowV2WebhookRequest) MarshalJSON() ([]byte, error) { // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// Protocol Buffers Language Guide. +// Protocol Buffers Language Guide +// (https://developers.google.com/protocol-buffers/docs/proto3#json). type GoogleCloudDialogflowV2WebhookResponse struct { // FollowupEventInput: Optional. Invokes the supplied events. When this // field is set, Dialogflow ignores the `fulfillment_text`, @@ -7641,9 +7673,12 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the Google Assistant integration for rich + // This field is also used by the Google Assistant integration + // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format + // (https://developers.google.com/assistant/actions/build/json/dialogflow + // -webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -7754,7 +7789,8 @@ func (s *GoogleCloudDialogflowV2beta1BatchUpdateIntentsResponse) MarshalJSON() ( // that intent become active. While any contexts are active, Dialogflow // is more likely to match intents that are configured with input // contexts that correspond to the currently active contexts. For more -// information about context, see the Contexts guide. +// information about context, see the Contexts guide +// (https://cloud.google.com/dialogflow/docs/contexts-overview). type GoogleCloudDialogflowV2beta1Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -7820,7 +7856,8 @@ func (s *GoogleCloudDialogflowV2beta1Context) MarshalJSON() ([]byte, error) { // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// Entity guide. +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -7934,9 +7971,10 @@ func (s *GoogleCloudDialogflowV2beta1EntityTypeEntity) MarshalJSON() ([]byte, er // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2beta1EventInput struct { // LanguageCode: Required. The language of this query. See Language - // Support for a list of the currently supported language codes. Note - // that queries in the same session do not necessarily need to specify - // the same language. + // Support (https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that + // queries in the same session do not necessarily need to specify the + // same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -8017,7 +8055,8 @@ func (s *GoogleCloudDialogflowV2beta1ExportAgentResponse) MarshalJSON() ([]byte, // referred to as an end-user expression or end-user input, Dialogflow // matches the end-user input to the best intent in your agent. Matching // an intent is also known as intent classification. For more -// information, see the intent guide. +// information, see the intent guide +// (https://cloud.google.com/dialogflow/docs/intents-overview). type GoogleCloudDialogflowV2beta1Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -9229,8 +9268,9 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction) MarshalJSO // phone number but does not dial automatically. type GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial struct { // PhoneNumber: Required. The phone number to fill in the default dialer - // app. This field should be in E.164 format. An example of a correctly - // formatted phone number: +15556767888. + // app. This field should be in E.164 + // (https://en.wikipedia.org/wiki/E.164) format. An example of a + // correctly formatted phone number: +15556767888. PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -9712,7 +9752,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio) MarshalJSO // either be set at request-level or can come from the agent-level // synthesizer config. type GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech struct { - // Ssml: The SSML to be synthesized. For more information, see SSML. + // Ssml: The SSML to be synthesized. For more information, see SSML + // (https://developers.google.com/actions/reference/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -9745,8 +9786,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech) Mar // Transfers the call in Telephony Gateway. type GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall struct { // PhoneNumber: Required. The phone number to transfer the call to in - // E.164 format. We currently only allow transferring to US numbers - // (+1xxxyyyzzzz). + // E.164 format (https://en.wikipedia.org/wiki/E.164). We currently only + // allow transferring to US numbers (+1xxxyyyzzzz). PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -10120,7 +10161,8 @@ type GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in E.164 format for Essentials Edition agents. + // with the caller ID in E.164 format + // (https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -10202,8 +10244,9 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { KnowledgeAnswers *GoogleCloudDialogflowV2beta1KnowledgeAnswers `json:"knowledgeAnswers,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See Language Support for a list of the currently supported - // language codes. + // detection. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -10391,7 +10434,8 @@ func (s *GoogleCloudDialogflowV2beta1SentimentAnalysisResult) MarshalJSON() ([]b // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the session entity guide. +// minutes. For more information, see the session entity guide +// (https://cloud.google.com/dialogflow/docs/entities-session). type GoogleCloudDialogflowV2beta1SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -10512,7 +10556,8 @@ func (s *GoogleCloudDialogflowV2beta1WebhookRequest) MarshalJSON() ([]byte, erro // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// Protocol Buffers Language Guide. +// Protocol Buffers Language Guide +// (https://developers.google.com/protocol-buffers/docs/proto3#json). type GoogleCloudDialogflowV2beta1WebhookResponse struct { // EndInteraction: Optional. Indicates that this intent ends an // interaction. Some integrations (e.g., Actions on Google or Dialogflow @@ -10548,9 +10593,12 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the Google Assistant integration for rich + // This field is also used by the Google Assistant integration + // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format + // (https://developers.google.com/assistant/actions/build/json/dialogflow + // -webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -10704,10 +10752,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -11870,8 +11919,10 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Create(parent string, google // of the following fields in `entity_type`: * // `EntityType.entities.value` * `EntityType.entities.synonyms` * // `EntityType.excluded_phrases.value` If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12177,8 +12228,10 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Get(name string) *ProjectsLo // dependent: * `EntityType.entities.value` * // `EntityType.entities.synonyms` * `EntityType.excluded_phrases.value` // If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12340,8 +12393,10 @@ func (r *ProjectsLocationsAgentsEntityTypesService) List(parent string) *Project // dependent: * `EntityType.entities.value` * // `EntityType.entities.synonyms` * `EntityType.excluded_phrases.value` // If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsEntityTypesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12550,8 +12605,10 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Patch(nameid string, googlec // of the following fields in `entity_type`: * // `EntityType.entities.value` * `EntityType.entities.synonyms` * // `EntityType.excluded_phrases.value` If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -13674,7 +13731,8 @@ type ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall struct { // idempotent, because it may cause session entity types to be updated, // which in turn might affect results of future queries. Note: Always // use agent versions for production traffic. See Versions and -// environments. +// environments +// (https://cloud.google.com/dialogflow/cx/docs/concept/version). func (r *ProjectsLocationsAgentsEnvironmentsSessionsService) DetectIntent(sessionid string, googleclouddialogflowcxv3detectintentrequest *GoogleCloudDialogflowCxV3DetectIntentRequest) *ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall { c := &ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -14891,7 +14949,8 @@ func (r *ProjectsLocationsAgentsFlowsService) Create(parent string, googlecloudd // of the following fields in `flow`: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. Many languages are +// specified, the agent's default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are // supported. Note: languages must be enabled in the agent before they // can be used. func (c *ProjectsLocationsAgentsFlowsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsCreateCall { @@ -15196,7 +15255,8 @@ func (r *ProjectsLocationsAgentsFlowsService) Get(name string) *ProjectsLocation // to retrieve the flow for. The following fields are language // dependent: * `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. Many languages are +// specified, the agent's default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are // supported. Note: languages must be enabled in the agent before they // can be used. func (c *ProjectsLocationsAgentsFlowsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsGetCall { @@ -15358,7 +15418,8 @@ func (r *ProjectsLocationsAgentsFlowsService) List(parent string) *ProjectsLocat // to list flows for. The following fields are language dependent: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. Many languages are +// specified, the agent's default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are // supported. Note: languages must be enabled in the agent before they // can be used. func (c *ProjectsLocationsAgentsFlowsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsListCall { @@ -15569,7 +15630,8 @@ func (r *ProjectsLocationsAgentsFlowsService) Patch(nameid string, googleclouddi // of the following fields in `flow`: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. Many languages are +// specified, the agent's default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are // supported. Note: languages must be enabled in the agent before they // can be used. func (c *ProjectsLocationsAgentsFlowsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPatchCall { @@ -15888,8 +15950,10 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Create(parent string, googlec // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me // ssages` If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsPagesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16197,8 +16261,10 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Get(name string) *ProjectsLoc // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me // ssages` If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsPagesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16363,8 +16429,10 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) List(parent string) *Projects // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me // ssages` If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsPagesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16578,8 +16646,10 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Patch(nameid string, googlecl // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me // ssages` If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsPagesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16748,8 +16818,10 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Create(parent // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17053,8 +17125,10 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Get(name stri // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17216,8 +17290,10 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) List(parent s // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17426,8 +17502,10 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Patch(nameid // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18503,8 +18581,10 @@ func (r *ProjectsLocationsAgentsIntentsService) Create(parent string, googleclou // LanguageCode sets the optional parameter "languageCode": The language // of the following fields in `intent`: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsIntentsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18789,8 +18869,10 @@ func (r *ProjectsLocationsAgentsIntentsService) Get(name string) *ProjectsLocati // LanguageCode sets the optional parameter "languageCode": The language // to retrieve the intent for. The following fields are language // dependent: * `Intent.training_phrases.parts.text` If not specified, -// the agent's default language is used. Many languages are supported. -// Note: languages must be enabled in the agent before they can be used. +// the agent's default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsIntentsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18963,8 +19045,10 @@ func (c *ProjectsLocationsAgentsIntentsListCall) IntentView(intentView string) * // LanguageCode sets the optional parameter "languageCode": The language // to list intents for. The following fields are language dependent: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsIntentsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19187,8 +19271,10 @@ func (r *ProjectsLocationsAgentsIntentsService) Patch(nameid string, googlecloud // LanguageCode sets the optional parameter "languageCode": The language // of the following fields in `intent`: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsIntentsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19351,7 +19437,8 @@ type ProjectsLocationsAgentsSessionsDetectIntentCall struct { // idempotent, because it may cause session entity types to be updated, // which in turn might affect results of future queries. Note: Always // use agent versions for production traffic. See Versions and -// environments. +// environments +// (https://cloud.google.com/dialogflow/cx/docs/concept/version). func (r *ProjectsLocationsAgentsSessionsService) DetectIntent(sessionid string, googleclouddialogflowcxv3detectintentrequest *GoogleCloudDialogflowCxV3DetectIntentRequest) *ProjectsLocationsAgentsSessionsDetectIntentCall { c := &ProjectsLocationsAgentsSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index 7b3de31c726..6f140989ab8 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -794,8 +794,8 @@ type GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText struct { // can then starts the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Ssml: The SSML text to be synthesized. For more information, see - // SSML. + // Ssml: The SSML text to be synthesized. For more information, see SSML + // (/speech/text-to-speech/docs/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -1196,13 +1196,16 @@ func (s *GoogleCloudDialogflowCxV3WebhookResponseFulfillmentResponse) MarshalJSO // conversation flows.. type GoogleCloudDialogflowCxV3beta1Agent struct { // AvatarUri: The URI of the agent's avatar. Avatars are used throughout - // the Dialogflow console and in the self-hosted Web Demo integration. + // the Dialogflow console and in the self-hosted Web Demo + // (https://cloud.google.com/dialogflow/docs/integrations/web-demo) + // integration. AvatarUri string `json:"avatarUri,omitempty"` // DefaultLanguageCode: Immutable. The default language of the agent as - // a language tag. See Language Support for a list of the currently - // supported language codes. This field cannot be set by the - // Agents.UpdateAgent method. + // a language tag. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. This field cannot be + // set by the Agents.UpdateAgent method. DefaultLanguageCode string `json:"defaultLanguageCode,omitempty"` // Description: The description of the agent. The maximum length is 500 @@ -1236,7 +1239,8 @@ type GoogleCloudDialogflowCxV3beta1Agent struct { StartFlow string `json:"startFlow,omitempty"` // TimeZone: Required. The time zone of the agent from the time zone - // database, e.g., America/New_York, Europe/Paris. + // database (https://www.iana.org/time-zones), e.g., America/New_York, + // Europe/Paris. TimeZone string `json:"timeZone,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1477,7 +1481,8 @@ func (s *GoogleCloudDialogflowCxV3beta1DtmfInput) MarshalJSON() ([]byte, error) // that are built for an individual user such as favorites, preferences, // playlists, and so on. A user entity is represented by the // SessionEntityType type. For more information about entity types, see -// the Dialogflow documentation. +// the Dialogflow documentation +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowCxV3beta1EntityType struct { // AutoExpansionMode: Indicates whether the entity type can be // automatically expanded. @@ -1797,8 +1802,9 @@ func (s *GoogleCloudDialogflowCxV3beta1EventInput) MarshalJSON() ([]byte, error) // GoogleCloudDialogflowCxV3beta1ExportAgentRequest: The request message // for Agents.ExportAgent. type GoogleCloudDialogflowCxV3beta1ExportAgentRequest struct { - // AgentUri: Optional. The Google Cloud Storage URI to export the agent - // to. The format of this URI must be `gs:///`. If left unspecified, the + // AgentUri: Optional. The Google Cloud Storage + // (https://cloud.google.com/storage/docs/) URI to export the agent to. + // The format of this URI must be `gs:///`. If left unspecified, the // serialized agent is returned inline. AgentUri string `json:"agentUri,omitempty"` @@ -2269,7 +2275,8 @@ type GoogleCloudDialogflowCxV3beta1FulfillmentConditionalCasesCase struct { // Condition: The condition to activate and select this case. Empty // means the condition is always true. The condition is evaluated // against form parameters or session parameters. See the conditions - // reference. + // reference + // (https://cloud.google.com/dialogflow/cx/docs/reference/condition). Condition string `json:"condition,omitempty"` // ForceSendFields is a list of field names (e.g. "CaseContent") to @@ -2418,7 +2425,9 @@ type GoogleCloudDialogflowCxV3beta1InputAudioConfig struct { // is enabled for the agent and an enhanced version of the specified // model for the language does not exist, then the speech is recognized // using the standard version of the specified model. Refer to Cloud - // Speech API documentation for more details. + // Speech API documentation + // (https://cloud.google.com/speech-to-text/docs/basics#select-model) + // for more details. Model string `json:"model,omitempty"` // ModelVariant: Optional. Which variant of the Speech model to use. @@ -2447,11 +2456,15 @@ type GoogleCloudDialogflowCxV3beta1InputAudioConfig struct { // PhraseHints: Optional. A list of strings containing words and phrases // that the speech recognizer should recognize with higher likelihood. - // See the Cloud Speech documentation for more details. + // See the Cloud Speech documentation + // (https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) + // for more details. PhraseHints []string `json:"phraseHints,omitempty"` // SampleRateHertz: Sample rate (in Hertz) of the audio content sent in - // the query. Refer to Cloud Speech API documentation for more details. + // the query. Refer to Cloud Speech API documentation + // (https://cloud.google.com/speech-to-text/docs/basics) for more + // details. SampleRateHertz int64 `json:"sampleRateHertz,omitempty"` // SingleUtterance: Optional. If `false` (default), recognition does not @@ -3537,7 +3550,8 @@ func (s *GoogleCloudDialogflowCxV3beta1OutputAudioConfig) MarshalJSON() ([]byte, // the same or transition to another page. You configure each page to // collect information from the end-user that is relevant for the // conversational state represented by the page. For more information, -// see the Page guide. +// see the Page guide +// (https://cloud.google.com/dialogflow/cx/docs/concept/page). type GoogleCloudDialogflowCxV3beta1Page struct { // DisplayName: Required. The human-readable name of the page, unique // within the agent. @@ -3755,9 +3769,10 @@ type GoogleCloudDialogflowCxV3beta1QueryInput struct { Intent *GoogleCloudDialogflowCxV3beta1IntentInput `json:"intent,omitempty"` // LanguageCode: Required. The language of the input. See Language - // Support for a list of the currently supported language codes. Note - // that queries in the same session do not necessarily need to specify - // the same language. + // Support (https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that + // queries in the same session do not necessarily need to specify the + // same language. LanguageCode string `json:"languageCode,omitempty"` // Text: The natural language text to be processed. @@ -3820,8 +3835,9 @@ type GoogleCloudDialogflowCxV3beta1QueryParameters struct { SessionEntityTypes []*GoogleCloudDialogflowCxV3beta1SessionEntityType `json:"sessionEntityTypes,omitempty"` // TimeZone: The time zone of this conversational query from the time - // zone database, e.g., America/New_York, Europe/Paris. If not provided, - // the time zone specified in the agent is used. + // zone database (https://www.iana.org/time-zones), e.g., + // America/New_York, Europe/Paris. If not provided, the time zone + // specified in the agent is used. TimeZone string `json:"timeZone,omitempty"` // WebhookHeaders: This field can be used to pass HTTP headers for a @@ -3888,8 +3904,9 @@ type GoogleCloudDialogflowCxV3beta1QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See Language Support for a list of the currently supported - // language codes. + // detection. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // Match: Intent match result, could be an intent or an event. @@ -4221,8 +4238,8 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText struct { // can then starts the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Ssml: The SSML text to be synthesized. For more information, see - // SSML. + // Ssml: The SSML text to be synthesized. For more information, see SSML + // (/speech/text-to-speech/docs/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -4333,8 +4350,9 @@ type GoogleCloudDialogflowCxV3beta1RestoreAgentRequest struct { // AgentContent: Uncompressed raw byte content for agent. AgentContent string `json:"agentContent,omitempty"` - // AgentUri: The Google Cloud Storage URI to restore agent from. The - // format of this URI must be `gs:///`. + // AgentUri: The Google Cloud Storage + // (https://cloud.google.com/storage/docs/) URI to restore agent from. + // The format of this URI must be `gs:///`. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -4502,7 +4520,8 @@ func (s *GoogleCloudDialogflowCxV3beta1SentimentAnalysisResult) UnmarshalJSON(da // session level (we refer to the entity types defined at the agent // level as "custom entity types"). Note: session entity types apply to // all queries, regardless of the language. For more information about -// entity types, see the Dialogflow documentation. +// entity types, see the Dialogflow documentation +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowCxV3beta1SessionEntityType struct { // Entities: Required. The collection of entities to override or // supplement the custom entity type. @@ -4756,10 +4775,11 @@ type GoogleCloudDialogflowCxV3beta1TrainFlowRequest struct { // transition into the specified flow. type GoogleCloudDialogflowCxV3beta1TransitionRoute struct { // Condition: The condition to evaluate against form parameters or - // session parameters. See the conditions reference. At least one of - // `intent` or `condition` must be specified. When both `intent` and - // `condition` are specified, the transition can only happen when both - // are fulfilled. + // session parameters. See the conditions reference + // (https://cloud.google.com/dialogflow/cx/docs/reference/condition). At + // least one of `intent` or `condition` must be specified. When both + // `intent` and `condition` are specified, the transition can only + // happen when both are fulfilled. Condition string `json:"condition,omitempty"` // Intent: The unique identifier of an Intent. Format: @@ -5313,13 +5333,15 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookResponseFulfillmentResponse) Marsh // or purely a part of the message between two entities or message // start/end. type GoogleCloudDialogflowV2AnnotatedMessagePart struct { - // EntityType: The Dialogflow system entity type of this message part. - // If this is empty, Dialogflow could not annotate the phrase part with - // a system entity. + // EntityType: The Dialogflow system entity type + // (https://cloud.google.com/dialogflow/docs/reference/system-entities) + // of this message part. If this is empty, Dialogflow could not annotate + // the phrase part with a system entity. EntityType string `json:"entityType,omitempty"` - // FormattedValue: The Dialogflow system entity formatted value of this - // message part. For example for a system entity of type + // FormattedValue: The Dialogflow system entity formatted value + // (https://cloud.google.com/dialogflow/docs/reference/system-entities) + // of this message part. For example for a system entity of type // `@sys.unit-currency`, this may contain: { "amount": 5, "currency": // "USD" } FormattedValue interface{} `json:"formattedValue,omitempty"` @@ -5420,7 +5442,8 @@ func (s *GoogleCloudDialogflowV2BatchUpdateIntentsResponse) MarshalJSON() ([]byt // active. While any contexts are active, Dialogflow is more likely to // match intents that are configured with input contexts that correspond // to the currently active contexts. For more information about context, -// see the Contexts guide. +// see the Contexts guide +// (https://cloud.google.com/dialogflow/docs/contexts-overview). type GoogleCloudDialogflowV2Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -5544,7 +5567,8 @@ func (s *GoogleCloudDialogflowV2ConversationEvent) MarshalJSON() ([]byte, error) // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// Entity guide. +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -5657,9 +5681,10 @@ func (s *GoogleCloudDialogflowV2EntityTypeEntity) MarshalJSON() ([]byte, error) // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2EventInput struct { // LanguageCode: Required. The language of this query. See Language - // Support for a list of the currently supported language codes. Note - // that queries in the same session do not necessarily need to specify - // the same language. + // Support (https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that + // queries in the same session do not necessarily need to specify the + // same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -5740,7 +5765,8 @@ func (s *GoogleCloudDialogflowV2ExportAgentResponse) MarshalJSON() ([]byte, erro // as an end-user expression or end-user input, Dialogflow matches the // end-user input to the best intent in your agent. Matching an intent // is also known as intent classification. For more information, see the -// intent guide. +// intent guide +// (https://cloud.google.com/dialogflow/docs/intents-overview). type GoogleCloudDialogflowV2Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -5915,7 +5941,8 @@ func (s *GoogleCloudDialogflowV2IntentFollowupIntentInfo) MarshalJSON() ([]byte, // GoogleCloudDialogflowV2IntentMessage: A rich response message. // Corresponds to the intent `Response` field in the Dialogflow console. -// For more information, see Rich response messages. +// For more information, see Rich response messages +// (https://cloud.google.com/dialogflow/docs/intents-rich-messages). type GoogleCloudDialogflowV2IntentMessage struct { // BasicCard: The basic card response for Actions on Google. BasicCard *GoogleCloudDialogflowV2IntentMessageBasicCard `json:"basicCard,omitempty"` @@ -7145,7 +7172,8 @@ type GoogleCloudDialogflowV2Message struct { CreateTime string `json:"createTime,omitempty"` // LanguageCode: Optional. The message language. This should be a BCP-47 - // language tag. Example: "en-US". + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Example: + // "en-US". LanguageCode string `json:"languageCode,omitempty"` // MessageAnnotation: Output only. The annotation for the message. @@ -7239,7 +7267,8 @@ type GoogleCloudDialogflowV2OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in E.164 format for Essentials Edition agents. + // with the caller ID in E.164 format + // (https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -7317,8 +7346,9 @@ type GoogleCloudDialogflowV2QueryResult struct { IntentDetectionConfidence float64 `json:"intentDetectionConfidence,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See Language Support for a list of the currently supported - // language codes. + // detection. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -7506,7 +7536,8 @@ func (s *GoogleCloudDialogflowV2SentimentAnalysisResult) MarshalJSON() ([]byte, // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the session entity guide. +// minutes. For more information, see the session entity guide +// (https://cloud.google.com/dialogflow/docs/entities-session). type GoogleCloudDialogflowV2SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -7617,7 +7648,8 @@ func (s *GoogleCloudDialogflowV2WebhookRequest) MarshalJSON() ([]byte, error) { // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// Protocol Buffers Language Guide. +// Protocol Buffers Language Guide +// (https://developers.google.com/protocol-buffers/docs/proto3#json). type GoogleCloudDialogflowV2WebhookResponse struct { // FollowupEventInput: Optional. Invokes the supplied events. When this // field is set, Dialogflow ignores the `fulfillment_text`, @@ -7647,9 +7679,12 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the Google Assistant integration for rich + // This field is also used by the Google Assistant integration + // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format + // (https://developers.google.com/assistant/actions/build/json/dialogflow + // -webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -7760,7 +7795,8 @@ func (s *GoogleCloudDialogflowV2beta1BatchUpdateIntentsResponse) MarshalJSON() ( // that intent become active. While any contexts are active, Dialogflow // is more likely to match intents that are configured with input // contexts that correspond to the currently active contexts. For more -// information about context, see the Contexts guide. +// information about context, see the Contexts guide +// (https://cloud.google.com/dialogflow/docs/contexts-overview). type GoogleCloudDialogflowV2beta1Context struct { // LifespanCount: Optional. The number of conversational query requests // after which the context expires. The default is `0`. If set to `0`, @@ -7826,7 +7862,8 @@ func (s *GoogleCloudDialogflowV2beta1Context) MarshalJSON() ([]byte, error) { // entities for matching custom data. For example, you could define a // vegetable entity that can match the types of vegetables available for // purchase with a grocery store agent. For more information, see the -// Entity guide. +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -7940,9 +7977,10 @@ func (s *GoogleCloudDialogflowV2beta1EntityTypeEntity) MarshalJSON() ([]byte, er // #welcome_event.name! What can I do for you today?". type GoogleCloudDialogflowV2beta1EventInput struct { // LanguageCode: Required. The language of this query. See Language - // Support for a list of the currently supported language codes. Note - // that queries in the same session do not necessarily need to specify - // the same language. + // Support (https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that + // queries in the same session do not necessarily need to specify the + // same language. LanguageCode string `json:"languageCode,omitempty"` // Name: Required. The unique identifier of the event. @@ -8023,7 +8061,8 @@ func (s *GoogleCloudDialogflowV2beta1ExportAgentResponse) MarshalJSON() ([]byte, // referred to as an end-user expression or end-user input, Dialogflow // matches the end-user input to the best intent in your agent. Matching // an intent is also known as intent classification. For more -// information, see the intent guide. +// information, see the intent guide +// (https://cloud.google.com/dialogflow/docs/intents-overview). type GoogleCloudDialogflowV2beta1Intent struct { // Action: Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. @@ -9235,8 +9274,9 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedAction) MarshalJSO // phone number but does not dial automatically. type GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial struct { // PhoneNumber: Required. The phone number to fill in the default dialer - // app. This field should be in E.164 format. An example of a correctly - // formatted phone number: +15556767888. + // app. This field should be in E.164 + // (https://en.wikipedia.org/wiki/E.164) format. An example of a + // correctly formatted phone number: +15556767888. PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -9718,7 +9758,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonyPlayAudio) MarshalJSO // either be set at request-level or can come from the agent-level // synthesizer config. type GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech struct { - // Ssml: The SSML to be synthesized. For more information, see SSML. + // Ssml: The SSML to be synthesized. For more information, see SSML + // (https://developers.google.com/actions/reference/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -9751,8 +9792,8 @@ func (s *GoogleCloudDialogflowV2beta1IntentMessageTelephonySynthesizeSpeech) Mar // Transfers the call in Telephony Gateway. type GoogleCloudDialogflowV2beta1IntentMessageTelephonyTransferCall struct { // PhoneNumber: Required. The phone number to transfer the call to in - // E.164 format. We currently only allow transferring to US numbers - // (+1xxxyyyzzzz). + // E.164 format (https://en.wikipedia.org/wiki/E.164). We currently only + // allow transferring to US numbers (+1xxxyyyzzzz). PhoneNumber string `json:"phoneNumber,omitempty"` // ForceSendFields is a list of field names (e.g. "PhoneNumber") to @@ -10126,7 +10167,8 @@ type GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest struct { // Gateway integration, this field has the form: { "telephony": { // "caller_id": "+18558363987" } } Note: The caller ID field // (`caller_id`) will be redacted for Trial Edition agents and populated - // with the caller ID in E.164 format for Essentials Edition agents. + // with the caller ID in E.164 format + // (https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents. Payload googleapi.RawMessage `json:"payload,omitempty"` // Source: The source of this request, e.g., `google`, `facebook`, @@ -10208,8 +10250,9 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { KnowledgeAnswers *GoogleCloudDialogflowV2beta1KnowledgeAnswers `json:"knowledgeAnswers,omitempty"` // LanguageCode: The language that was triggered during intent - // detection. See Language Support for a list of the currently supported - // language codes. + // detection. See Language Support + // (https://cloud.google.com/dialogflow/docs/reference/language) for a + // list of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // OutputContexts: The collection of output contexts. If applicable, @@ -10397,7 +10440,8 @@ func (s *GoogleCloudDialogflowV2beta1SentimentAnalysisResult) MarshalJSON() ([]b // Session entities can extend or replace custom entity types and only // exist during the session that they were created for. All session // data, including session entities, is stored by Dialogflow for 20 -// minutes. For more information, see the session entity guide. +// minutes. For more information, see the session entity guide +// (https://cloud.google.com/dialogflow/docs/entities-session). type GoogleCloudDialogflowV2beta1SessionEntityType struct { // Entities: Required. The collection of entities associated with this // session entity type. @@ -10518,7 +10562,8 @@ func (s *GoogleCloudDialogflowV2beta1WebhookRequest) MarshalJSON() ([]byte, erro // value with the wrong type is a common error. To avoid this error: - // Use "" for empty strings - Use `{}` or `null` for empty objects - // Use `[]` or `null` for empty arrays For more information, see the -// Protocol Buffers Language Guide. +// Protocol Buffers Language Guide +// (https://developers.google.com/protocol-buffers/docs/proto3#json). type GoogleCloudDialogflowV2beta1WebhookResponse struct { // EndInteraction: Optional. Indicates that this intent ends an // interaction. Some integrations (e.g., Actions on Google or Dialogflow @@ -10554,9 +10599,12 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // your webhook to the integration or API caller. Arbitrary JSON objects // are supported. When provided, Dialogflow uses this field to populate // QueryResult.webhook_payload sent to the integration or API caller. - // This field is also used by the Google Assistant integration for rich + // This field is also used by the Google Assistant integration + // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format + // (https://developers.google.com/assistant/actions/build/json/dialogflow + // -webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -10710,10 +10758,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -11879,8 +11928,10 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Create(parent string, google // of the following fields in `entity_type`: * // `EntityType.entities.value` * `EntityType.entities.synonyms` * // `EntityType.excluded_phrases.value` If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12187,8 +12238,10 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Get(name string) *ProjectsLo // dependent: * `EntityType.entities.value` * // `EntityType.entities.synonyms` * `EntityType.excluded_phrases.value` // If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12351,8 +12404,10 @@ func (r *ProjectsLocationsAgentsEntityTypesService) List(parent string) *Project // dependent: * `EntityType.entities.value` * // `EntityType.entities.synonyms` * `EntityType.excluded_phrases.value` // If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsEntityTypesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -12561,8 +12616,10 @@ func (r *ProjectsLocationsAgentsEntityTypesService) Patch(nameid string, googlec // of the following fields in `entity_type`: * // `EntityType.entities.value` * `EntityType.entities.synonyms` * // `EntityType.excluded_phrases.value` If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -13688,7 +13745,8 @@ type ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall struct { // idempotent, because it may cause session entity types to be updated, // which in turn might affect results of future queries. Note: Always // use agent versions for production traffic. See Versions and -// environments. +// environments +// (https://cloud.google.com/dialogflow/cx/docs/concept/version). func (r *ProjectsLocationsAgentsEnvironmentsSessionsService) DetectIntent(sessionid string, googleclouddialogflowcxv3beta1detectintentrequest *GoogleCloudDialogflowCxV3beta1DetectIntentRequest) *ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall { c := &ProjectsLocationsAgentsEnvironmentsSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid @@ -14905,7 +14963,8 @@ func (r *ProjectsLocationsAgentsFlowsService) Create(parent string, googlecloudd // of the following fields in `flow`: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. Many languages are +// specified, the agent's default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are // supported. Note: languages must be enabled in the agent before they // can be used. func (c *ProjectsLocationsAgentsFlowsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsCreateCall { @@ -15211,7 +15270,8 @@ func (r *ProjectsLocationsAgentsFlowsService) Get(name string) *ProjectsLocation // to retrieve the flow for. The following fields are language // dependent: * `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. Many languages are +// specified, the agent's default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are // supported. Note: languages must be enabled in the agent before they // can be used. func (c *ProjectsLocationsAgentsFlowsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsGetCall { @@ -15374,7 +15434,8 @@ func (r *ProjectsLocationsAgentsFlowsService) List(parent string) *ProjectsLocat // to list flows for. The following fields are language dependent: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. Many languages are +// specified, the agent's default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are // supported. Note: languages must be enabled in the agent before they // can be used. func (c *ProjectsLocationsAgentsFlowsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsListCall { @@ -15585,7 +15646,8 @@ func (r *ProjectsLocationsAgentsFlowsService) Patch(nameid string, googleclouddi // of the following fields in `flow`: * // `Flow.event_handlers.trigger_fulfillment.messages` * // `Flow.transition_routes.trigger_fulfillment.messages` If not -// specified, the agent's default language is used. Many languages are +// specified, the agent's default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are // supported. Note: languages must be enabled in the agent before they // can be used. func (c *ProjectsLocationsAgentsFlowsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPatchCall { @@ -15905,8 +15967,10 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Create(parent string, googlec // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me // ssages` If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsPagesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16215,8 +16279,10 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Get(name string) *ProjectsLoc // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me // ssages` If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsPagesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16382,8 +16448,10 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) List(parent string) *Projects // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me // ssages` If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsPagesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16597,8 +16665,10 @@ func (r *ProjectsLocationsAgentsFlowsPagesService) Patch(nameid string, googlecl // * `Page.transition_routes.trigger_fulfillment.messages` * // `Page.transition_route_groups.transition_routes.trigger_fulfillment.me // ssages` If not specified, the agent's default language is used. Many -// languages are supported. Note: languages must be enabled in the agent -// before they can be used. +// languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsPagesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsPagesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16768,8 +16838,10 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Create(parent // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17073,8 +17145,10 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Get(name stri // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17236,8 +17310,10 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) List(parent s // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17446,8 +17522,10 @@ func (r *ProjectsLocationsAgentsFlowsTransitionRouteGroupsService) Patch(nameid // LanguageCode sets the optional parameter "languageCode": The language // to list transition route groups for. The field `messages` in // TransitionRoute is language dependent. If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsFlowsTransitionRouteGroupsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsFlowsTransitionRouteGroupsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18525,8 +18603,10 @@ func (r *ProjectsLocationsAgentsIntentsService) Create(parent string, googleclou // LanguageCode sets the optional parameter "languageCode": The language // of the following fields in `intent`: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsIntentsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18812,8 +18892,10 @@ func (r *ProjectsLocationsAgentsIntentsService) Get(name string) *ProjectsLocati // LanguageCode sets the optional parameter "languageCode": The language // to retrieve the intent for. The following fields are language // dependent: * `Intent.training_phrases.parts.text` If not specified, -// the agent's default language is used. Many languages are supported. -// Note: languages must be enabled in the agent before they can be used. +// the agent's default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsIntentsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18987,8 +19069,10 @@ func (c *ProjectsLocationsAgentsIntentsListCall) IntentView(intentView string) * // LanguageCode sets the optional parameter "languageCode": The language // to list intents for. The following fields are language dependent: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsIntentsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19211,8 +19295,10 @@ func (r *ProjectsLocationsAgentsIntentsService) Patch(nameid string, googlecloud // LanguageCode sets the optional parameter "languageCode": The language // of the following fields in `intent`: * // `Intent.training_phrases.parts.text` If not specified, the agent's -// default language is used. Many languages are supported. Note: -// languages must be enabled in the agent before they can be used. +// default language is used. Many languages +// (https://cloud.google.com/dialogflow/docs/reference/language) are +// supported. Note: languages must be enabled in the agent before they +// can be used. func (c *ProjectsLocationsAgentsIntentsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentsIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19376,7 +19462,8 @@ type ProjectsLocationsAgentsSessionsDetectIntentCall struct { // idempotent, because it may cause session entity types to be updated, // which in turn might affect results of future queries. Note: Always // use agent versions for production traffic. See Versions and -// environments. +// environments +// (https://cloud.google.com/dialogflow/cx/docs/concept/version). func (r *ProjectsLocationsAgentsSessionsService) DetectIntent(sessionid string, googleclouddialogflowcxv3beta1detectintentrequest *GoogleCloudDialogflowCxV3beta1DetectIntentRequest) *ProjectsLocationsAgentsSessionsDetectIntentCall { c := &ProjectsLocationsAgentsSessionsDetectIntentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sessionid = sessionid diff --git a/digitalassetlinks/v1/digitalassetlinks-gen.go b/digitalassetlinks/v1/digitalassetlinks-gen.go index c7e938df0ea..2aa88e7e8f6 100644 --- a/digitalassetlinks/v1/digitalassetlinks-gen.go +++ b/digitalassetlinks/v1/digitalassetlinks-gen.go @@ -405,7 +405,8 @@ func (s *ListResponse) MarshalJSON() ([]byte, error) { // Statements are always made by the source asset, either directly or by // delegating to a statement list that is stored elsewhere. For more // detailed definitions of statements and assets, please refer to our -// API documentation landing page. +// API documentation landing page +// (/digital-asset-links/v1/getting-started). type Statement struct { // Relation: The relation identifies the use of the statement as // intended by the source asset's owner (that is, the person or entity @@ -413,8 +414,9 @@ type Statement struct { // We identify relations with strings of the format `/`, where `` must // be one of a set of pre-defined purpose categories, and `` is a // free-form lowercase alphanumeric string that describes the specific - // use case of the statement. Refer to our API documentation for the - // current list of supported relations. Example: + // use case of the statement. Refer to our API documentation + // (/digital-asset-links/v1/relation-strings) for the current list of + // supported relations. Example: // `delegate_permission/common.handle_all_urls` REQUIRED Relation string `json:"relation,omitempty"` @@ -519,7 +521,9 @@ type AssetlinksCheckCall struct { // verify its statements securely, and it is not possible to ensure that // the website's statements have not been altered by a third party. For // more information, see the Digital Asset Links technical design -// specification. +// specification +// (https://github.com/google/digitalassetlinks/blob/master/well-known/de +// tails.md). func (r *AssetlinksService) Check() *AssetlinksCheckCall { c := &AssetlinksCheckCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -529,10 +533,11 @@ func (r *AssetlinksService) Check() *AssetlinksCheckCall { // relation. We identify relations with strings of the format `/`, where // `` must be one of a set of pre-defined purpose categories, and `` is // a free-form lowercase alphanumeric string that describes the specific -// use case of the statement. Refer to our API documentation for the -// current list of supported relations. For a query to match an asset -// link, both the query's and the asset link's relation strings must -// match exactly. Example: A query with relation +// use case of the statement. Refer to our API documentation +// (/digital-asset-links/v1/relation-strings) for the current list of +// supported relations. For a query to match an asset link, both the +// query's and the asset link's relation strings must match exactly. +// Example: A query with relation // `delegate_permission/common.handle_all_urls` matches an asset link // with relation `delegate_permission/common.handle_all_urls`. func (c *AssetlinksCheckCall) Relation(relation string) *AssetlinksCheckCall { @@ -809,7 +814,9 @@ type StatementsListCall struct { // that all statements with secure source assets, such as HTTPS websites // or Android apps, have been made in a secure way by the owner of those // assets, as described in the Digital Asset Links technical design -// specification. Specifically, you should consider that for insecure +// specification +// (https://github.com/google/digitalassetlinks/blob/master/well-known/de +// tails.md). Specifically, you should consider that for insecure // websites (that is, where the URL starts with `http://` instead of // `https://`), this guarantee cannot be made. The `List` command is // most useful in cases where the API client wants to know all the ways @@ -825,13 +832,13 @@ func (r *StatementsService) List() *StatementsListCall { // Relation sets the optional parameter "relation": Use only // associations that match the specified relation. See the `Statement` -// message for a detailed definition of relation strings. For a query to -// match a statement, one of the following must be true: * both the -// query's and the statement's relation strings match exactly, or * the -// query's relation string is empty or missing. Example: A query with -// relation `delegate_permission/common.handle_all_urls` matches an -// asset link with relation -// `delegate_permission/common.handle_all_urls`. +// (#Statement) message for a detailed definition of relation strings. +// For a query to match a statement, one of the following must be true: +// * both the query's and the statement's relation strings match +// exactly, or * the query's relation string is empty or missing. +// Example: A query with relation +// `delegate_permission/common.handle_all_urls` matches an asset link +// with relation `delegate_permission/common.handle_all_urls`. func (c *StatementsListCall) Relation(relation string) *StatementsListCall { c.urlParams_.Set("relation", relation) return c diff --git a/displayvideo/v1/displayvideo-gen.go b/displayvideo/v1/displayvideo-gen.go index 37febd2be4c..5593a2dc99e 100644 --- a/displayvideo/v1/displayvideo-gen.go +++ b/displayvideo/v1/displayvideo-gen.go @@ -3403,8 +3403,9 @@ func (s *Channel) MarshalJSON() ([]byte, error) { // `TARGETING_TYPE_CHANNEL`. type ChannelAssignedTargetingOptionDetails struct { // ChannelId: Required. ID of the channel. Should refer to the channel - // ID field on a Partner-owned channel or advertiser-owned channel - // resource. + // ID field on a Partner-owned channel + // (partners.channels#Channel.FIELDS.channel_id) or advertiser-owned + // channel (advertisers.channels#Channel.FIELDS.channel_id) resource. ChannelId int64 `json:"channelId,omitempty,string"` // Negative: Indicates if this option is being negatively targeted. For @@ -8438,9 +8439,10 @@ type LineItem struct { // the line item. PartnerRevenueModel *PartnerRevenueModel `json:"partnerRevenueModel,omitempty"` - // TargetingExpansion: The targeting expansion settings of the line - // item. This config is only applicable when eligible audience list - // targeting is assigned to the line item. + // TargetingExpansion: The targeting expansion + // (https://support.google.com/displayvideo/answer/10191558) settings of + // the line item. This config is only applicable when eligible audience + // list targeting is assigned to the line item. TargetingExpansion *TargetingExpansionConfig `json:"targetingExpansion,omitempty"` // UpdateTime: Output only. The timestamp when the line item was last @@ -11789,10 +11791,11 @@ func (s *Site) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index d95b86e9798..3b6815ccfa1 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -1359,8 +1359,9 @@ type GooglePrivacyDlpV2CloudStorageRegexFileSet struct { // ExcludeRegex: A list of regular expressions matching file paths to // exclude. All files in the bucket that match at least one of these // regular expressions will be excluded from the scan. Regular - // expressions use RE2 syntax; a guide can be found under the google/re2 - // repository on GitHub. + // expressions use RE2 syntax + // (https://github.com/google/re2/wiki/Syntax); a guide can be found + // under the google/re2 repository on GitHub. ExcludeRegex []string `json:"excludeRegex,omitempty"` // IncludeRegex: A list of regular expressions matching file paths to @@ -1368,8 +1369,9 @@ type GooglePrivacyDlpV2CloudStorageRegexFileSet struct { // regular expressions will be included in the set of files, except for // those that also match an item in `exclude_regex`. Leaving this field // empty will match all files by default (this is equivalent to - // including `.*` in the list). Regular expressions use RE2 syntax; a - // guide can be found under the google/re2 repository on GitHub. + // including `.*` in the list). Regular expressions use RE2 syntax + // (https://github.com/google/re2/wiki/Syntax); a guide can be found + // under the google/re2 repository on GitHub. IncludeRegex []string `json:"includeRegex,omitempty"` // ForceSendFields is a list of field names (e.g. "BucketName") to @@ -2103,18 +2105,19 @@ type GooglePrivacyDlpV2CryptoReplaceFfxFpeConfig struct { // example, if the name of custom infoType is 'MY_TOKEN_INFO_TYPE' and // the surrogate is 'abc', the full replacement value will be: // 'MY_TOKEN_INFO_TYPE(3):abc' This annotation identifies the surrogate - // when inspecting content using the custom infoType `SurrogateType`. - // This facilitates reversal of the surrogate when it occurs in free - // text. In order for inspection to work properly, the name of this - // infoType must not occur naturally anywhere in your data; otherwise, - // inspection may find a surrogate that does not correspond to an actual - // identifier. Therefore, choose your custom infoType name carefully - // after considering what your data looks like. One way to select a name - // that has a high chance of yielding reliable detection is to include - // one or more unicode characters that are highly improbable to exist in - // your data. For example, assuming your data is entered from a regular - // ASCII keyboard, the symbol with the hex code point 29DD might be used - // like so: ⧝MY_TOKEN_TYPE + // when inspecting content using the custom infoType `SurrogateType` + // (https://cloud.google.com/dlp/docs/reference/rest/v2/InspectConfig#sur + // rogatetype). This facilitates reversal of the surrogate when it + // occurs in free text. In order for inspection to work properly, the + // name of this infoType must not occur naturally anywhere in your data; + // otherwise, inspection may find a surrogate that does not correspond + // to an actual identifier. Therefore, choose your custom infoType name + // carefully after considering what your data looks like. One way to + // select a name that has a high chance of yielding reliable detection + // is to include one or more unicode characters that are highly + // improbable to exist in your data. For example, assuming your data is + // entered from a regular ASCII keyboard, the symbol with the hex code + // point 29DD might be used like so: ⧝MY_TOKEN_TYPE SurrogateInfoType *GooglePrivacyDlpV2InfoType `json:"surrogateInfoType,omitempty"` // ForceSendFields is a list of field names (e.g. "CommonAlphabet") to @@ -2813,8 +2816,9 @@ func (s *GooglePrivacyDlpV2DetectionRule) MarshalJSON() ([]byte, error) { // information specific to the data, such as a list of employee IDs or // job titles. Dictionary words are case-insensitive and all characters // other than letters and digits in the unicode Basic Multilingual Plane -// will be replaced with whitespace when scanning for matches, so the -// dictionary phrase "Sam Johnson" will match all three phrases "sam +// (https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_ +// Plane) will be replaced with whitespace when scanning for matches, so +// the dictionary phrase "Sam Johnson" will match all three phrases "sam // johnson", "Sam, Johnson", and "Sam (Johnson)". Additionally, the // characters surrounding any match must be of a different type than the // adjacent characters within the word, so letters must be next to @@ -2823,7 +2827,8 @@ func (s *GooglePrivacyDlpV2DetectionRule) MarshalJSON() ([]byte, error) { // "jen123" but will return no matches for "jennifer". Dictionary words // containing a large number of characters that are not letters or // digits may result in unexpected findings because such characters are -// treated as whitespace. The limits page contains details about the +// treated as whitespace. The limits +// (https://cloud.google.com/dlp/limits) page contains details about the // size limits of dictionaries. For dictionaries that do not fit within // these constraints, consider using `LargeCustomDictionaryConfig` in // the `StoredInfoType` API. @@ -3299,10 +3304,10 @@ type GooglePrivacyDlpV2Finding struct { // Labels: The labels associated with this `Finding`. Label keys must be // between 1 and 63 characters long and must conform to the following - // regular expression: `a-z?`. Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than 10 labels can be - // associated with a given finding. Examples: * "environment" : + // regular expression: `a-z ([-a-z0-9]*[a-z0-9])?`. Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than 10 labels + // can be associated with a given finding. Examples: * "environment" : // "production" * "pipeline" : "etl" Labels map[string]string `json:"labels,omitempty"` @@ -3579,11 +3584,12 @@ type GooglePrivacyDlpV2HybridFindingDetails struct { // being inspected. If configured by the job, some key values may be // required. The labels associated with `Finding`'s produced by hybrid // inspection. Label keys must be between 1 and 63 characters long and - // must conform to the following regular expression: `a-z?`. Label - // values must be between 0 and 63 characters long and must conform to - // the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than - // 10 labels can be associated with a given finding. Examples: * - // "environment" : "production" * "pipeline" : "etl" + // must conform to the following regular expression: `a-z + // ([-a-z0-9]*[a-z0-9])?`. Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than 10 labels can be + // associated with a given finding. Examples: * "environment" : + // "production" * "pipeline" : "etl" Labels map[string]string `json:"labels,omitempty"` // RowOffset: Offset of the row for tables. Populate if the row(s) being @@ -3740,11 +3746,12 @@ type GooglePrivacyDlpV2HybridOptions struct { // Labels: To organize findings, these labels will be added to each // finding. Label keys must be between 1 and 63 characters long and must - // conform to the following regular expression: `a-z?`. Label values - // must be between 0 and 63 characters long and must conform to the - // regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than 10 - // labels can be associated with a given finding. Examples: * - // "environment" : "production" * "pipeline" : "etl" + // conform to the following regular expression: `a-z + // ([-a-z0-9]*[a-z0-9])?`. Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No more than 10 labels can be + // associated with a given finding. Examples: * "environment" : + // "production" * "pipeline" : "etl" Labels map[string]string `json:"labels,omitempty"` // RequiredFindingLabelKeys: These are labels that each inspection @@ -5129,10 +5136,11 @@ func (s *GooglePrivacyDlpV2LDiversityResult) MarshalJSON() ([]byte, error) { // GooglePrivacyDlpV2LargeCustomDictionaryConfig: Configuration for a // custom dictionary created from a data source of any size up to the -// maximum size defined in the limits page. The artifacts of dictionary -// creation are stored in the specified Google Cloud Storage location. -// Consider using `CustomInfoType.Dictionary` for smaller dictionaries -// that satisfy the size requirements. +// maximum size defined in the limits +// (https://cloud.google.com/dlp/limits) page. The artifacts of +// dictionary creation are stored in the specified Google Cloud Storage +// location. Consider using `CustomInfoType.Dictionary` for smaller +// dictionaries that satisfy the size requirements. type GooglePrivacyDlpV2LargeCustomDictionaryConfig struct { // BigQueryField: Field in a BigQuery table where each cell represents a // dictionary phrase. @@ -5941,7 +5949,9 @@ type GooglePrivacyDlpV2PublishSummaryToCscc struct { // GooglePrivacyDlpV2PublishToPubSub: Publish a message into given // Pub/Sub topic when DlpJob has completed. The message contains a // single field, `DlpJobName`, which is equal to the finished job's -// `DlpJob.name`. Compatible with: Inspect, Risk +// `DlpJob.name` +// (https://cloud.google.com/dlp/docs/reference/rest/v2/projects.dlpJobs# +// DlpJob). Compatible with: Inspect, Risk type GooglePrivacyDlpV2PublishToPubSub struct { // Topic: Cloud Pub/Sub topic to send notifications to. The topic must // have given publishing access rights to the DLP API service account @@ -7186,12 +7196,13 @@ func (s *GooglePrivacyDlpV2SummaryResult) MarshalJSON() ([]byte, error) { } // GooglePrivacyDlpV2SurrogateType: Message for detecting output from -// deidentification transformations such as `CryptoReplaceFfxFpeConfig`. -// These types of transformations are those that perform -// pseudonymization, thereby producing a "surrogate" as output. This -// should be used in conjunction with a field on the transformation such -// as `surrogate_info_type`. This CustomInfoType does not support the -// use of `detection_rules`. +// deidentification transformations such as `CryptoReplaceFfxFpeConfig` +// (https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.dei +// dentifyTemplates#cryptoreplaceffxfpeconfig). These types of +// transformations are those that perform pseudonymization, thereby +// producing a "surrogate" as output. This should be used in conjunction +// with a field on the transformation such as `surrogate_info_type`. +// This CustomInfoType does not support the use of `detection_rules`. type GooglePrivacyDlpV2SurrogateType struct { } @@ -7985,10 +7996,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/docs/v1/docs-gen.go b/docs/v1/docs-gen.go index 3f12e677455..a7aa9398b00 100644 --- a/docs/v1/docs-gen.go +++ b/docs/v1/docs-gen.go @@ -6876,17 +6876,19 @@ type WeightedFontFamily struct { // Weight: The weight of the font. This field can have any value that is // a multiple of `100` between `100` and `900`, inclusive. This range // corresponds to the numerical values described in the CSS 2.1 - // Specification, section 15.6, with non-numerical values disallowed. - // The default value is `400` ("normal"). The font weight makes up just - // one component of the rendered font weight. The rendered weight is - // determined by a combination of the `weight` and the text style's - // resolved `bold` value, after accounting for inheritance: * If the - // text is bold and the weight is less than `400`, the rendered weight - // is 400. * If the text is bold and the weight is greater than or equal - // to `400` but is less than `700`, the rendered weight is `700`. * If - // the weight is greater than or equal to `700`, the rendered weight is - // equal to the weight. * If the text is not bold, the rendered weight - // is equal to the weight. + // Specification, section 15.6 + // (https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with + // non-numerical values disallowed. The default value is `400` + // ("normal"). The font weight makes up just one component of the + // rendered font weight. The rendered weight is determined by a + // combination of the `weight` and the text style's resolved `bold` + // value, after accounting for inheritance: * If the text is bold and + // the weight is less than `400`, the rendered weight is 400. * If the + // text is bold and the weight is greater than or equal to `400` but is + // less than `700`, the rendered weight is `700`. * If the weight is + // greater than or equal to `700`, the rendered weight is equal to the + // weight. * If the text is not bold, the rendered weight is equal to + // the weight. Weight int64 `json:"weight,omitempty"` // ForceSendFields is a list of field names (e.g. "FontFamily") to diff --git a/documentai/v1beta2/documentai-gen.go b/documentai/v1beta2/documentai-gen.go index cfc1ccde6e0..cccc11cc5a8 100644 --- a/documentai/v1beta2/documentai-gen.go +++ b/documentai/v1beta2/documentai-gen.go @@ -811,7 +811,8 @@ type GoogleCloudDocumentaiV1beta1Document struct { // Uri: Currently supports Google Cloud Storage URI of the form // `gs://bucket_name/object_name`. Object versioning is not supported. - // See Google Cloud Storage Request URIs for more info. + // See Google Cloud Storage Request URIs + // (https://cloud.google.com/storage/docs/reference-uris) for more info. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -2721,7 +2722,8 @@ type GoogleCloudDocumentaiV1beta2Document struct { // Uri: Currently supports Google Cloud Storage URI of the form // `gs://bucket_name/object_name`. Object versioning is not supported. - // See Google Cloud Storage Request URIs for more info. + // See Google Cloud Storage Request URIs + // (https://cloud.google.com/storage/docs/reference-uris) for more info. Uri string `json:"uri,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -5063,10 +5065,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -5510,7 +5513,7 @@ func (s *GoogleTypePostalAddress) MarshalJSON() ([]byte, error) { } // GoogleTypeTimeZone: Represents a time zone from the IANA Time Zone -// Database. +// Database (https://www.iana.org/time-zones). type GoogleTypeTimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 1b0491b219d..5d015142951 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -811,7 +811,8 @@ type GoogleCloudDocumentaiV1beta1Document struct { // Uri: Currently supports Google Cloud Storage URI of the form // `gs://bucket_name/object_name`. Object versioning is not supported. - // See Google Cloud Storage Request URIs for more info. + // See Google Cloud Storage Request URIs + // (https://cloud.google.com/storage/docs/reference-uris) for more info. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -2661,7 +2662,8 @@ type GoogleCloudDocumentaiV1beta2Document struct { // Uri: Currently supports Google Cloud Storage URI of the form // `gs://bucket_name/object_name`. Object versioning is not supported. - // See Google Cloud Storage Request URIs for more info. + // See Google Cloud Storage Request URIs + // (https://cloud.google.com/storage/docs/reference-uris) for more info. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -4746,7 +4748,8 @@ type GoogleCloudDocumentaiV1beta3Document struct { // Uri: Currently supports Google Cloud Storage URI of the form // `gs://bucket_name/object_name`. Object versioning is not supported. - // See Google Cloud Storage Request URIs for more info. + // See Google Cloud Storage Request URIs + // (https://cloud.google.com/storage/docs/reference-uris) for more info. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -6599,10 +6602,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -7046,7 +7050,7 @@ func (s *GoogleTypePostalAddress) MarshalJSON() ([]byte, error) { } // GoogleTypeTimeZone: Represents a time zone from the IANA Time Zone -// Database. +// Database (https://www.iana.org/time-zones). type GoogleTypeTimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` diff --git a/domains/v1alpha2/domains-gen.go b/domains/v1alpha2/domains-gen.go index 1d309949745..3e8df082bdb 100644 --- a/domains/v1alpha2/domains-gen.go +++ b/domains/v1alpha2/domains-gen.go @@ -318,7 +318,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -553,9 +554,10 @@ func (s *Contact) MarshalJSON() ([]byte, error) { } // ContactSettings: Defines the contact information associated with a -// `Registration`. ICANN requires all domain names to have associated -// contact information. The `registrant_contact` is considered the -// domain's legal owner, and often the other contacts are identical. +// `Registration`. ICANN (https://icann.org/) requires all domain names +// to have associated contact information. The `registrant_contact` is +// considered the domain's legal owner, and often the other contacts are +// identical. type ContactSettings struct { // AdminContact: Required. The administrative contact for the // `Registration`. @@ -662,7 +664,8 @@ type DnsSettings struct { // Commonly empty. GlueRecords []*GlueRecord `json:"glueRecords,omitempty"` - // GoogleDomainsDns: The free DNS zone provided by Google Domains. + // GoogleDomainsDns: The free DNS zone provided by Google Domains + // (https://domains.google/). GoogleDomainsDns *GoogleDomainsDns `json:"googleDomainsDns,omitempty"` // ForceSendFields is a list of field names (e.g. "CustomDns") to @@ -863,7 +866,7 @@ func (s *GlueRecord) MarshalJSON() ([]byte, error) { // GoogleDomainsDns: Configuration for using the free DNS zone provided // by Google Domains as a `Registration`'s `dns_provider`. You cannot // configure the DNS zone itself using the API. To configure the DNS -// zone, go to Google Domains. +// zone, go to Google Domains (https://domains.google/). type GoogleDomainsDns struct { // DsRecords: Output only. The list of DS records published for this // domain. The list is automatically populated when `ds_state` is @@ -1285,7 +1288,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1304,7 +1309,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1344,7 +1349,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1892,10 +1898,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1938,7 +1945,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3270,14 +3278,14 @@ type ProjectsLocationsRegistrationsExportCall struct { // Export: Exports a `Registration` that you no longer want to use with // Cloud Domains. You can continue to use the domain in Google Domains -// until it expires. If the export is successful: * The resource's -// `state` becomes `EXPORTED`, meaning that it is no longer managed by -// Cloud Domains * Because individual users can own domains in Google -// Domains, the calling user becomes the domain's sole owner. -// Permissions for the domain are subsequently managed in Google -// Domains. * Without further action, the domain does not renew -// automatically. The new owner can set up billing in Google Domains to -// renew the domain if needed. +// (https://domains.google/) until it expires. If the export is +// successful: * The resource's `state` becomes `EXPORTED`, meaning that +// it is no longer managed by Cloud Domains * Because individual users +// can own domains in Google Domains, the calling user becomes the +// domain's sole owner. Permissions for the domain are subsequently +// managed in Google Domains. * Without further action, the domain does +// not renew automatically. The new owner can set up billing in Google +// Domains to renew the domain if needed. func (r *ProjectsLocationsRegistrationsService) Export(name string, exportregistrationrequest *ExportRegistrationRequest) *ProjectsLocationsRegistrationsExportCall { c := &ProjectsLocationsRegistrationsExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3577,7 +3585,8 @@ func (r *ProjectsLocationsRegistrationsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsRegistrationsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRegistrationsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/domains/v1beta1/domains-gen.go b/domains/v1beta1/domains-gen.go index 20e0d12021a..eeb1c0bbfee 100644 --- a/domains/v1beta1/domains-gen.go +++ b/domains/v1beta1/domains-gen.go @@ -318,7 +318,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -553,9 +554,10 @@ func (s *Contact) MarshalJSON() ([]byte, error) { } // ContactSettings: Defines the contact information associated with a -// `Registration`. ICANN requires all domain names to have associated -// contact information. The `registrant_contact` is considered the -// domain's legal owner, and often the other contacts are identical. +// `Registration`. ICANN (https://icann.org/) requires all domain names +// to have associated contact information. The `registrant_contact` is +// considered the domain's legal owner, and often the other contacts are +// identical. type ContactSettings struct { // AdminContact: Required. The administrative contact for the // `Registration`. @@ -662,7 +664,8 @@ type DnsSettings struct { // Commonly empty. GlueRecords []*GlueRecord `json:"glueRecords,omitempty"` - // GoogleDomainsDns: The free DNS zone provided by Google Domains. + // GoogleDomainsDns: The free DNS zone provided by Google Domains + // (https://domains.google/). GoogleDomainsDns *GoogleDomainsDns `json:"googleDomainsDns,omitempty"` // ForceSendFields is a list of field names (e.g. "CustomDns") to @@ -863,7 +866,7 @@ func (s *GlueRecord) MarshalJSON() ([]byte, error) { // GoogleDomainsDns: Configuration for using the free DNS zone provided // by Google Domains as a `Registration`'s `dns_provider`. You cannot // configure the DNS zone itself using the API. To configure the DNS -// zone, go to Google Domains. +// zone, go to Google Domains (https://domains.google/). type GoogleDomainsDns struct { // DsRecords: Output only. The list of DS records published for this // domain. The list is automatically populated when `ds_state` is @@ -1285,7 +1288,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1304,7 +1309,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1344,7 +1349,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1892,10 +1898,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1938,7 +1945,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3270,14 +3278,14 @@ type ProjectsLocationsRegistrationsExportCall struct { // Export: Exports a `Registration` that you no longer want to use with // Cloud Domains. You can continue to use the domain in Google Domains -// until it expires. If the export is successful: * The resource's -// `state` becomes `EXPORTED`, meaning that it is no longer managed by -// Cloud Domains * Because individual users can own domains in Google -// Domains, the calling user becomes the domain's sole owner. -// Permissions for the domain are subsequently managed in Google -// Domains. * Without further action, the domain does not renew -// automatically. The new owner can set up billing in Google Domains to -// renew the domain if needed. +// (https://domains.google/) until it expires. If the export is +// successful: * The resource's `state` becomes `EXPORTED`, meaning that +// it is no longer managed by Cloud Domains * Because individual users +// can own domains in Google Domains, the calling user becomes the +// domain's sole owner. Permissions for the domain are subsequently +// managed in Google Domains. * Without further action, the domain does +// not renew automatically. The new owner can set up billing in Google +// Domains to renew the domain if needed. func (r *ProjectsLocationsRegistrationsService) Export(name string, exportregistrationrequest *ExportRegistrationRequest) *ProjectsLocationsRegistrationsExportCall { c := &ProjectsLocationsRegistrationsExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3577,7 +3585,8 @@ func (r *ProjectsLocationsRegistrationsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsRegistrationsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRegistrationsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/domainsrdap/v1/domainsrdap-gen.go b/domainsrdap/v1/domainsrdap-gen.go index 2cb2d438126..637efdf857f 100644 --- a/domainsrdap/v1/domainsrdap-gen.go +++ b/domainsrdap/v1/domainsrdap-gen.go @@ -250,7 +250,8 @@ func (s *HttpBody) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Link: Links object defined in section 4.2 of RFC 7483. +// Link: Links object defined in section 4.2 of RFC 7483 +// (https://tools.ietf.org/html/rfc7483#section-4.2). type Link struct { // Href: Target URL of a link. Example: "http://example.com/previous". Href string `json:"href,omitempty"` @@ -297,7 +298,8 @@ func (s *Link) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Notice: Notices object defined in section 4.3 of RFC 7483. +// Notice: Notices object defined in section 4.3 of RFC 7483 +// (https://tools.ietf.org/html/rfc7483#section-4.3). type Notice struct { // Description: Description of the notice. Description []string `json:"description,omitempty"` @@ -308,7 +310,8 @@ type Notice struct { // Title: Title of a notice. Example: "Terms of Service". Title string `json:"title,omitempty"` - // Type: Type values defined in section 10.2.1 of RFC 7483 specific to a + // Type: Type values defined in section 10.2.1 of RFC 7483 + // (https://tools.ietf.org/html/rfc7483#section-10.2.1) specific to a // whole response: "result set truncated due to authorization", "result // set truncated due to excessive load", "result set truncated due to // unexplainable reasons". @@ -350,7 +353,8 @@ type RdapResponse struct { JsonResponse *HttpBody `json:"jsonResponse,omitempty"` // Lang: Error language code. Error response info fields are defined in - // section 6 of RFC 7483. + // section 6 of RFC 7483 + // (https://tools.ietf.org/html/rfc7483#section-6). Lang string `json:"lang,omitempty"` // Notices: Notices applying to this response. diff --git a/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go b/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go index cef26fcfc47..8553dd01c83 100644 --- a/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go +++ b/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go @@ -2529,8 +2529,10 @@ func (s *RowStatus) MarshalJSON() ([]byte, error) { } // Rule: A Rule defines a name, and a boolean expression in conjunctive -// normal form{.external} that can be // applied to a path event to -// determine if that name should be applied. +// normal form (http: +// //mathworld.wolfram.com/ConjunctiveNormalForm.html){.external} that +// can be // applied to a path event to determine if that name should be +// applied. type Rule struct { DisjunctiveMatchStatements []*DisjunctiveMatchStatement `json:"disjunctiveMatchStatements,omitempty"` diff --git a/doubleclicksearch/v2/doubleclicksearch-gen.go b/doubleclicksearch/v2/doubleclicksearch-gen.go index 5681f2aba61..17a90c17fea 100644 --- a/doubleclicksearch/v2/doubleclicksearch-gen.go +++ b/doubleclicksearch/v2/doubleclicksearch-gen.go @@ -712,7 +712,8 @@ type ReportRequest struct { // ReportType: Determines the type of rows that are returned in the // report. For example, if you specify `reportType: keyword`, each row // in the report will contain data about a keyword. See the Types of - // Reports reference for the columns that are available for each type. + // Reports (/search-ads/v2/report-types/) reference for the columns that + // are available for each type. ReportType string `json:"reportType,omitempty"` // RowCount: Synchronous report only. The maximum number of rows to diff --git a/eventarc/v1beta1/eventarc-gen.go b/eventarc/v1beta1/eventarc-gen.go index 643d806d5e8..23dcd6f2217 100644 --- a/eventarc/v1beta1/eventarc-gen.go +++ b/eventarc/v1beta1/eventarc-gen.go @@ -285,7 +285,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -823,7 +824,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -842,7 +845,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -882,7 +885,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -987,10 +991,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1033,7 +1038,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2682,7 +2688,8 @@ func (r *ProjectsLocationsTriggersService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsTriggersGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsTriggersGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/fcm/v1/fcm-gen.go b/fcm/v1/fcm-gen.go index bc953df62fa..1972b7894ce 100644 --- a/fcm/v1/fcm-gen.go +++ b/fcm/v1/fcm-gen.go @@ -157,7 +157,7 @@ type ProjectsMessagesService struct { } // AndroidConfig: Android specific options for messages sent through FCM -// connection server. +// connection server (https://goo.gl/4GLdUl). type AndroidConfig struct { // CollapseKey: An identifier of a group of messages that can be // collapsed, so that only the last message gets sent when delivery can @@ -171,7 +171,8 @@ type AndroidConfig struct { // DirectBootOk: If set to true, messages will be allowed to be // delivered to the app while the device is in direct boot mode. See - // Support Direct Boot mode. + // Support Direct Boot mode + // (https://developer.android.com/training/articles/direct-boot). DirectBootOk bool `json:"directBootOk,omitempty"` // FcmOptions: Options for features provided by the FCM SDK for Android. @@ -181,7 +182,8 @@ type AndroidConfig struct { Notification *AndroidNotification `json:"notification,omitempty"` // Priority: Message priority. Can take "normal" and "high" values. For - // more information, see Setting the priority of a message. + // more information, see Setting the priority of a message + // (https://goo.gl/GjONJv). // // Possible values: // "NORMAL" - Default priority for data messages. Normal priority @@ -279,21 +281,22 @@ type AndroidNotification struct { // BodyLocArgs: Variable string values to be used in place of the format // specifiers in body_loc_key to use to localize the body text to the - // user's current localization. See Formatting and Styling for more - // information. + // user's current localization. See Formatting and Styling + // (https://goo.gl/MalYE3) for more information. BodyLocArgs []string `json:"bodyLocArgs,omitempty"` // BodyLocKey: The key to the body string in the app's string resources // to use to localize the body text to the user's current localization. - // See String Resources for more information. + // See String Resources (https://goo.gl/NdFZGI) for more information. BodyLocKey string `json:"bodyLocKey,omitempty"` - // ChannelId: The notification's channel id (new in Android O). The app - // must create a channel with this channel ID before any notification - // with this channel ID is received. If you don't send this channel ID - // in the request, or if the channel ID provided has not yet been - // created by the app, FCM uses the channel ID specified in the app - // manifest. + // ChannelId: The notification's channel id + // (https://developer.android.com/guide/topics/ui/notifiers/notifications + // #ManageChannels) (new in Android O). The app must create a channel + // with this channel ID before any notification with this channel ID is + // received. If you don't send this channel ID in the request, or if the + // channel ID provided has not yet been created by the app, FCM uses the + // channel ID specified in the app manifest. ChannelId string `json:"channelId,omitempty"` // ClickAction: The action associated with a user click on the @@ -306,26 +309,34 @@ type AndroidNotification struct { // DefaultLightSettings: If set to true, use the Android framework's // default LED light settings for the notification. Default values are - // specified in config.xml. If `default_light_settings` is set to true - // and `light_settings` is also set, the user-specified `light_settings` - // is used instead of the default value. + // specified in config.xml + // (https://android.googlesource.com/platform/frameworks/base/+/master/co + // re/res/res/values/config.xml). If `default_light_settings` is set to + // true and `light_settings` is also set, the user-specified + // `light_settings` is used instead of the default value. DefaultLightSettings bool `json:"defaultLightSettings,omitempty"` // DefaultSound: If set to true, use the Android framework's default // sound for the notification. Default values are specified in - // config.xml. + // config.xml + // (https://android.googlesource.com/platform/frameworks/base/+/master/co + // re/res/res/values/config.xml). DefaultSound bool `json:"defaultSound,omitempty"` // DefaultVibrateTimings: If set to true, use the Android framework's // default vibrate pattern for the notification. Default values are - // specified in config.xml. If `default_vibrate_timings` is set to true - // and `vibrate_timings` is also set, the default value is used instead - // of the user-specified `vibrate_timings`. + // specified in config.xml + // (https://android.googlesource.com/platform/frameworks/base/+/master/co + // re/res/res/values/config.xml). If `default_vibrate_timings` is set to + // true and `vibrate_timings` is also set, the default value is used + // instead of the user-specified `vibrate_timings`. DefaultVibrateTimings bool `json:"defaultVibrateTimings,omitempty"` // EventTime: Set the time that the event in the notification occurred. // Notifications in the panel are sorted by this time. A point in time - // is represented using protobuf.Timestamp. + // is represented using protobuf.Timestamp + // (https://developers.google.com/protocol-buffers/docs/reference/java/co + // m/google/protobuf/Timestamp). EventTime string `json:"eventTime,omitempty"` // Icon: The notification's icon. Sets the notification icon to myicon @@ -348,16 +359,20 @@ type AndroidNotification struct { // the current device. Some notifications can be bridged to other // devices for remote display, such as a Wear OS watch. This hint can be // set to recommend this notification not be bridged. See Wear OS guides + // (https://developer.android.com/training/wearables/notifications/bridge + // r#existing-method-of-preventing-bridging) LocalOnly bool `json:"localOnly,omitempty"` // NotificationCount: Sets the number of items this notification // represents. May be displayed as a badge count for launchers that - // support badging.See Notification Badge. For example, this might be - // useful if you're using just one notification to represent multiple - // new messages but you want the count here to represent the number of - // total new messages. If zero or unspecified, systems that support - // badging use the default, which is to increment a number displayed on - // the long-press menu each time a new notification arrives. + // support badging.See Notification Badge + // (https://developer.android.com/training/notify-user/badges). For + // example, this might be useful if you're using just one notification + // to represent multiple new messages but you want the count here to + // represent the number of total new messages. If zero or unspecified, + // systems that support badging use the default, which is to increment a + // number displayed on the long-press menu each time a new notification + // arrives. NotificationCount int64 `json:"notificationCount,omitempty"` // NotificationPriority: Set the relative priority for this @@ -369,7 +384,9 @@ type AndroidNotification struct { // slightly on different platforms. Note this priority differs from // `AndroidMessagePriority`. This priority is processed by the client // after the message has been delivered, whereas AndroidMessagePriority - // is an FCM concept that controls when the message is delivered. + // (https://firebase.google.com/docs/reference/fcm/rest/v1/projects.messa + // ges#androidmessagepriority) is an FCM concept that controls when the + // message is delivered. // // Possible values: // "PRIORITY_UNSPECIFIED" - If priority is unspecified, notification @@ -420,26 +437,31 @@ type AndroidNotification struct { // TitleLocArgs: Variable string values to be used in place of the // format specifiers in title_loc_key to use to localize the title text - // to the user's current localization. See Formatting and Styling for - // more information. + // to the user's current localization. See Formatting and Styling + // (https://goo.gl/MalYE3) for more information. TitleLocArgs []string `json:"titleLocArgs,omitempty"` // TitleLocKey: The key to the title string in the app's string // resources to use to localize the title text to the user's current - // localization. See String Resources for more information. + // localization. See String Resources (https://goo.gl/NdFZGI) for more + // information. TitleLocKey string `json:"titleLocKey,omitempty"` // VibrateTimings: Set the vibration pattern to use. Pass in an array of - // protobuf.Duration to turn on or off the vibrator. The first value - // indicates the `Duration` to wait before turning the vibrator on. The - // next value indicates the `Duration` to keep the vibrator on. - // Subsequent values alternate between `Duration` to turn the vibrator - // off and to turn the vibrator on. If `vibrate_timings` is set and - // `default_vibrate_timings` is set to `true`, the default value is used - // instead of the user-specified `vibrate_timings`. + // protobuf.Duration + // (https://developers.google.com/protocol-buffers/docs/reference/google. + // protobuf#google.protobuf.Duration) to turn on or off the vibrator. + // The first value indicates the `Duration` to wait before turning the + // vibrator on. The next value indicates the `Duration` to keep the + // vibrator on. Subsequent values alternate between `Duration` to turn + // the vibrator off and to turn the vibrator on. If `vibrate_timings` is + // set and `default_vibrate_timings` is set to `true`, the default value + // is used instead of the user-specified `vibrate_timings`. VibrateTimings []string `json:"vibrateTimings,omitempty"` - // Visibility: Set the Notification.visibility of the notification. + // Visibility: Set the Notification.visibility + // (https://developer.android.com/reference/android/app/Notification.html + // #visibility) of the notification. // // Possible values: // "VISIBILITY_UNSPECIFIED" - If unspecified, default to @@ -475,19 +497,24 @@ func (s *AndroidNotification) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ApnsConfig: Apple Push Notification Service specific options. +// ApnsConfig: Apple Push Notification Service (https://goo.gl/MXRTPa) +// specific options. type ApnsConfig struct { // FcmOptions: Options for features provided by the FCM SDK for iOS. FcmOptions *ApnsFcmOptions `json:"fcmOptions,omitempty"` // Headers: HTTP request headers defined in Apple Push Notification - // Service. Refer to APNs request headers for supported headers, e.g. - // "apns-priority": "10". + // Service. Refer to APNs request headers + // (https://developer.apple.com/documentation/usernotifications/setting_u + // p_a_remote_notification_server/sending_notification_requests_to_apns) + // for supported headers, e.g. "apns-priority": "10". Headers map[string]string `json:"headers,omitempty"` // Payload: APNs payload as a JSON object, including both `aps` - // dictionary and custom payload. See Payload Key Reference. If present, - // it overrides google.firebase.fcm.v1.Notification.title and + // dictionary and custom payload. See Payload Key Reference + // (https://developer.apple.com/documentation/usernotifications/setting_u + // p_a_remote_notification_server/generating_a_remote_notification). If + // present, it overrides google.firebase.fcm.v1.Notification.title and // google.firebase.fcm.v1.Notification.body. Payload googleapi.RawMessage `json:"payload,omitempty"` @@ -701,15 +728,21 @@ func (s *FcmOptions) MarshalJSON() ([]byte, error) { // LightSettings: Settings to control notification LED. type LightSettings struct { - // Color: Required. Set `color` of the LED with google.type.Color. + // Color: Required. Set `color` of the LED with google.type.Color + // (https://github.com/googleapis/googleapis/blob/master/google/type/colo + // r.proto). Color *Color `json:"color,omitempty"` // LightOffDuration: Required. Along with `light_on_duration `, define // the blink rate of LED flashes. Resolution defined by proto.Duration + // (https://developers.google.com/protocol-buffers/docs/reference/google. + // protobuf#google.protobuf.Duration) LightOffDuration string `json:"lightOffDuration,omitempty"` // LightOnDuration: Required. Along with `light_off_duration`, define // the blink rate of LED flashes. Resolution defined by proto.Duration + // (https://developers.google.com/protocol-buffers/docs/reference/google. + // protobuf#google.protobuf.Duration) LightOnDuration string `json:"lightOnDuration,omitempty"` // ForceSendFields is a list of field names (e.g. "Color") to @@ -738,10 +771,11 @@ func (s *LightSettings) MarshalJSON() ([]byte, error) { // Message: Message to send by Firebase Cloud Messaging Service. type Message struct { // Android: Input only. Android specific options for messages sent - // through FCM connection server. + // through FCM connection server (https://goo.gl/4GLdUl). Android *AndroidConfig `json:"android,omitempty"` - // Apns: Input only. Apple Push Notification Service specific options. + // Apns: Input only. Apple Push Notification Service + // (https://goo.gl/MXRTPa) specific options. Apns *ApnsConfig `json:"apns,omitempty"` // Condition: Condition to send a message to, e.g. "'foo' in topics && @@ -772,7 +806,8 @@ type Message struct { // "/topics/" prefix should not be provided. Topic string `json:"topic,omitempty"` - // Webpush: Input only. Webpush protocol options. + // Webpush: Input only. Webpush protocol + // (https://tools.ietf.org/html/rfc8030) options. Webpush *WebpushConfig `json:"webpush,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -875,7 +910,8 @@ func (s *SendMessageRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// WebpushConfig: Webpush protocol options. +// WebpushConfig: Webpush protocol (https://tools.ietf.org/html/rfc8030) +// options. type WebpushConfig struct { // Data: Arbitrary key/value payload. If present, it will override // google.firebase.fcm.v1.Message.data. @@ -885,12 +921,14 @@ type WebpushConfig struct { FcmOptions *WebpushFcmOptions `json:"fcmOptions,omitempty"` // Headers: HTTP headers defined in webpush protocol. Refer to Webpush - // protocol for supported headers, e.g. "TTL": "15". + // protocol (https://tools.ietf.org/html/rfc8030#section-5) for + // supported headers, e.g. "TTL": "15". Headers map[string]string `json:"headers,omitempty"` // Notification: Web Notification options as a JSON object. Supports - // Notification instance properties as defined in Web Notification API. - // If present, "title" and "body" fields override + // Notification instance properties as defined in Web Notification API + // (https://developer.mozilla.org/en-US/docs/Web/API/Notification). If + // present, "title" and "body" fields override // [google.firebase.fcm.v1.Notification.title] and // [google.firebase.fcm.v1.Notification.body]. Notification googleapi.RawMessage `json:"notification,omitempty"` diff --git a/file/v1/file-gen.go b/file/v1/file-gen.go index 73d2e1550e5..7b2bd737ef6 100644 --- a/file/v1/file-gen.go +++ b/file/v1/file-gen.go @@ -1303,16 +1303,17 @@ type NetworkConfig struct { // "MODE_IPV4" - Use the IPv4 internet protocol. Modes []string `json:"modes,omitempty"` - // Network: The name of the Google Compute Engine VPC network to which - // the instance is connected. + // Network: The name of the Google Compute Engine VPC network + // (/compute/docs/networks-and-firewalls#networks) to which the instance + // is connected. Network string `json:"network,omitempty"` // ReservedIpRange: A /29 CIDR block in one of the internal IP address - // ranges that identifies the range of IP addresses reserved for this - // instance. For example, 10.0.0.0/29 or 192.168.0.0/29. The range you - // specify can't overlap with either existing subnets or assigned IP - // address ranges for other Cloud Filestore instances in the selected - // VPC network. + // ranges (https://www.arin.net/knowledge/address_filters.html) that + // identifies the range of IP addresses reserved for this instance. For + // example, 10.0.0.0/29 or 192.168.0.0/29. The range you specify can't + // overlap with either existing subnets or assigned IP address ranges + // for other Cloud Filestore instances in the selected VPC network. ReservedIpRange string `json:"reservedIpRange,omitempty"` // ForceSendFields is a list of field names (e.g. "IpAddresses") to @@ -1601,10 +1602,11 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/file/v1beta1/file-gen.go b/file/v1beta1/file-gen.go index cc53ed6d005..02c67b9c205 100644 --- a/file/v1beta1/file-gen.go +++ b/file/v1beta1/file-gen.go @@ -1308,12 +1308,14 @@ type NetworkConfig struct { // "MODE_IPV4" - Use the IPv4 internet protocol. Modes []string `json:"modes,omitempty"` - // Network: The name of the Google Compute Engine VPC network to which - // the instance is connected. + // Network: The name of the Google Compute Engine VPC network + // (/compute/docs/networks-and-firewalls#networks) to which the instance + // is connected. Network string `json:"network,omitempty"` // ReservedIpRange: A /29 CIDR block for Basic or a /23 CIDR block for - // High Scale in one of the internal IP address ranges that identifies + // High Scale in one of the internal IP address ranges + // (https://www.arin.net/knowledge/address_filters.html) that identifies // the range of IP addresses reserved for this instance. For example, // 10.0.0.0/29 or 192.168.0.0/23. The range you specify can't overlap // with either existing subnets or assigned IP address ranges for other @@ -1610,10 +1612,11 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/firebase/v1beta1/firebase-gen.go b/firebase/v1beta1/firebase-gen.go index 758d6102a13..222df7101e7 100644 --- a/firebase/v1beta1/firebase-gen.go +++ b/firebase/v1beta1/firebase-gen.go @@ -259,21 +259,25 @@ type ProjectsWebAppsService struct { // AddFirebaseRequest: All fields are required. type AddFirebaseRequest struct { // LocationId: Deprecated. Instead, to set a Project's default GCP - // resource location, call `FinalizeDefaultLocation` after you add - // Firebase resources to the GCP `Project`. The ID of the Project's - // default GCP resource location. The location must be one of the - // available GCP resource locations. + // resource location, call `FinalizeDefaultLocation` + // (../projects.defaultLocation/finalize) after you add Firebase + // resources to the GCP `Project`. The ID of the Project's default GCP + // resource location. The location must be one of the available GCP + // resource locations + // (https://firebase.google.com/docs/projects/locations). LocationId string `json:"locationId,omitempty"` // RegionCode: Deprecated. Instead, to link a Project with a Google - // Analytics account, call `AddGoogleAnalytics` after you add Firebase + // Analytics account, call `AddGoogleAnalytics` + // (../../v1beta1/projects/addGoogleAnalytics) after you add Firebase // resources to the GCP `Project`. The region code (CLDR) that the // account will use for Google Analytics data For example: US, GB, or DE // In Java, use `com.google.i18n.identifiers.RegionCode`. RegionCode string `json:"regionCode,omitempty"` // TimeZone: Deprecated. Instead, to link a Project with a Google - // Analytics account, call `AddGoogleAnalytics` after you add Firebase + // Analytics account, call `AddGoogleAnalytics` + // (../../v1beta1/projects/addGoogleAnalytics) after you add Firebase // resources to the GCP `Project`. The time zone that the account will // use for Google Analytics data. For example: America/Los_Angeles or // Africa/Abidjan @@ -304,10 +308,10 @@ func (s *AddFirebaseRequest) MarshalJSON() ([]byte, error) { type AddGoogleAnalyticsRequest struct { // AnalyticsAccountId: The ID for the existing Google Analytics account - // that you want to link with the `FirebaseProject`. Specifying this - // field will provision a new Google Analytics property in your Google - // Analytics account and associate the new property with the - // `FirebaseProject`. + // (http://www.google.com/analytics/) that you want to link with the + // `FirebaseProject`. Specifying this field will provision a new Google + // Analytics property in your Google Analytics account and associate the + // new property with the `FirebaseProject`. AnalyticsAccountId string `json:"analyticsAccountId,omitempty"` // AnalyticsPropertyId: The ID for the existing Google Analytics @@ -343,11 +347,12 @@ type AdminSdkConfig struct { DatabaseURL string `json:"databaseURL,omitempty"` // LocationId: The ID of the Project's default GCP resource location. - // The location is one of the available GCP resource locations. This - // field is omitted if the default GCP resource location has not been - // finalized yet. To set a Project's default GCP resource location, call - // `FinalizeDefaultLocation` after you add Firebase resources to the - // Project. + // The location is one of the available GCP resource locations + // (https://firebase.google.com/docs/projects/locations). This field is + // omitted if the default GCP resource location has not been finalized + // yet. To set a Project's default GCP resource location, call + // `FinalizeDefaultLocation` (../projects.defaultLocation/finalize) + // after you add Firebase resources to the Project. LocationId string `json:"locationId,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier for the @@ -437,10 +442,11 @@ type AnalyticsProperty struct { // Id: The globally unique, Google-assigned identifier of the Google // Analytics property associated with the specified `FirebaseProject`. - // If you called `AddGoogleAnalytics` to link the `FirebaseProject` with - // a Google Analytics account, the value in this `id` field is the same - // as the ID of the property either specified or provisioned with that - // call to `AddGoogleAnalytics`. + // If you called `AddGoogleAnalytics` + // (../../v1beta1/projects/addGoogleAnalytics) to link the + // `FirebaseProject` with a Google Analytics account, the value in this + // `id` field is the same as the ID of the property either specified or + // provisioned with that call to `AddGoogleAnalytics`. Id string `json:"id,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -478,11 +484,15 @@ type AndroidApp struct { // Name: The resource name of the AndroidApp, in the format: projects/ // PROJECT_IDENTIFIER/androidApps/APP_ID * PROJECT_IDENTIFIER: the - // parent Project's `ProjectNumber` ***(recommended)*** or its - // `ProjectId`. Learn more about using project identifiers in Google's - // AIP 2510 standard. Note that the value for PROJECT_IDENTIFIER in any - // response body will be the `ProjectId`. * APP_ID: the globally unique, - // Firebase-assigned identifier for the App (see `appId`). + // parent Project's `ProjectNumber` + // (../projects#FirebaseProject.FIELDS.project_number) + // ***(recommended)*** or its `ProjectId` + // (../projects#FirebaseProject.FIELDS.project_id). Learn more about + // using project identifiers in Google's AIP 2510 standard + // (https://google.aip.dev/cloud/2510). Note that the value for + // PROJECT_IDENTIFIER in any response body will be the `ProjectId`. * + // APP_ID: the globally unique, Firebase-assigned identifier for the App + // (see `appId` (../projects.androidApps#AndroidApp.FIELDS.app_id)). Name string `json:"name,omitempty"` // PackageName: Immutable. The canonical package name of the Android app @@ -564,30 +574,33 @@ type DefaultResources struct { // HostingSite: The default Firebase Hosting site name, in the format: // PROJECT_ID Though rare, your `projectId` might already be used as the // name for an existing Hosting site in another project (learn more - // about creating non-default, additional sites). In these cases, your - // `projectId` is appended with a hyphen then five alphanumeric - // characters to create your default Hosting site name. For example, if - // your `projectId` is `myproject123`, your default Hosting site name - // might be: `myproject123-a5c16` + // about creating non-default, additional sites + // (https://firebase.google.com/docs/hosting/multisites)). In these + // cases, your `projectId` is appended with a hyphen then five + // alphanumeric characters to create your default Hosting site name. For + // example, if your `projectId` is `myproject123`, your default Hosting + // site name might be: `myproject123-a5c16` HostingSite string `json:"hostingSite,omitempty"` // LocationId: The ID of the Project's default GCP resource location. - // The location is one of the available GCP resource locations. This - // field is omitted if the default GCP resource location has not been - // finalized yet. To set a Project's default GCP resource location, call - // `FinalizeDefaultLocation` after you add Firebase resources to the - // Project. + // The location is one of the available GCP resource locations + // (https://firebase.google.com/docs/projects/locations). This field is + // omitted if the default GCP resource location has not been finalized + // yet. To set a Project's default GCP resource location, call + // `FinalizeDefaultLocation` (../projects.defaultLocation/finalize) + // after you add Firebase resources to the Project. LocationId string `json:"locationId,omitempty"` // RealtimeDatabaseInstance: The default Firebase Realtime Database // instance name, in the format: PROJECT_ID Though rare, your // `projectId` might already be used as the name for an existing // Realtime Database instance in another project (learn more about - // database sharding). In these cases, your `projectId` is appended with - // a hyphen then five alphanumeric characters to create your default - // Realtime Database instance name. For example, if your `projectId` is - // `myproject123`, your default database instance name might be: - // `myproject123-a5c16` + // database sharding + // (https://firebase.google.com/docs/database/usage/sharding)). In these + // cases, your `projectId` is appended with a hyphen then five + // alphanumeric characters to create your default Realtime Database + // instance name. For example, if your `projectId` is `myproject123`, + // your default database instance name might be: `myproject123-a5c16` RealtimeDatabaseInstance string `json:"realtimeDatabaseInstance,omitempty"` // StorageBucket: The default Cloud Storage for Firebase storage bucket, @@ -631,7 +644,8 @@ type Empty struct { type FinalizeDefaultLocationRequest struct { // LocationId: The ID of the Project's default GCP resource location. - // The location must be one of the available GCP resource locations. + // The location must be one of the available GCP resource locations + // (https://firebase.google.com/docs/projects/locations). LocationId string `json:"locationId,omitempty"` // ForceSendFields is a list of field names (e.g. "LocationId") to @@ -722,8 +736,9 @@ func (s *FirebaseAppInfo) MarshalJSON() ([]byte, error) { // sites, storage systems (Firebase Realtime Database, Cloud Firestore, // Cloud Storage buckets), and other Firebase and Google Cloud Platform // (GCP) resources. You create a `FirebaseProject` by calling -// AddFirebase and specifying an *existing* GCP `Project`. This adds -// Firebase resources to the existing GCP `Project`. Since a +// AddFirebase and specifying an *existing* GCP `Project` +// (https://cloud.google.com/resource-manager/reference/rest/v1/projects) +// . This adds Firebase resources to the existing GCP `Project`. Since a // FirebaseProject is actually also a GCP `Project`, a `FirebaseProject` // has the same underlying GCP identifiers (`projectNumber` and // `projectId`). This allows for easy interop with Google APIs. @@ -733,10 +748,12 @@ type FirebaseProject struct { // Name: The resource name of the Project, in the format: // projects/PROJECT_IDENTIFIER PROJECT_IDENTIFIER: the Project's - // `ProjectNumber` ***(recommended)*** or its `ProjectId`. Learn more - // about using project identifiers in Google's AIP 2510 standard. Note - // that the value for PROJECT_IDENTIFIER in any response body will be - // the `ProjectId`. + // `ProjectNumber` (../projects#FirebaseProject.FIELDS.project_number) + // ***(recommended)*** or its `ProjectId` + // (../projects#FirebaseProject.FIELDS.project_id). Learn more about + // using project identifiers in Google's AIP 2510 standard + // (https://google.aip.dev/cloud/2510). Note that the value for + // PROJECT_IDENTIFIER in any response body will be the `ProjectId`. Name string `json:"name,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier for the @@ -813,11 +830,15 @@ type IosApp struct { // Name: The resource name of the IosApp, in the format: // projects/PROJECT_IDENTIFIER /iosApps/APP_ID * PROJECT_IDENTIFIER: the - // parent Project's `ProjectNumber` ***(recommended)*** or its - // `ProjectId`. Learn more about using project identifiers in Google's - // AIP 2510 standard. Note that the value for PROJECT_IDENTIFIER in any - // response body will be the `ProjectId`. * APP_ID: the globally unique, - // Firebase-assigned identifier for the App (see `appId`). + // parent Project's `ProjectNumber` + // (../projects#FirebaseProject.FIELDS.project_number) + // ***(recommended)*** or its `ProjectId` + // (../projects#FirebaseProject.FIELDS.project_id). Learn more about + // using project identifiers in Google's AIP 2510 standard + // (https://google.aip.dev/cloud/2510). Note that the value for + // PROJECT_IDENTIFIER in any response body will be the `ProjectId`. * + // APP_ID: the globally unique, Firebase-assigned identifier for the App + // (see `appId` (../projects.iosApps#IosApp.FIELDS.app_id)). Name string `json:"name,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier of the parent @@ -1181,11 +1202,14 @@ type Location struct { Features []string `json:"features,omitempty"` // LocationId: The ID of the GCP resource location. It will be one of - // the available GCP resource locations. + // the available GCP resource locations + // (https://firebase.google.com/docs/projects/locations#types). LocationId string `json:"locationId,omitempty"` // Type: Indicates whether the GCP resource location is a regional or - // multi-regional location for data replication. + // multi-regional location + // (https://firebase.google.com/docs/projects/locations#types) for data + // replication. // // Possible values: // "LOCATION_TYPE_UNSPECIFIED" - Used internally for distinguishing @@ -1293,17 +1317,19 @@ type ProjectInfo struct { DisplayName string `json:"displayName,omitempty"` // LocationId: The ID of the Project's default GCP resource location. - // The location is one of the available GCP resource locations. Not all + // The location is one of the available GCP resource locations + // (https://firebase.google.com/docs/projects/locations). Not all // Projects will have this field populated. If it is not populated, it // means that the Project does not yet have a default GCP resource // location. To set a Project's default GCP resource location, call - // `FinalizeDefaultLocation` after you add Firebase resources to the - // Project. + // `FinalizeDefaultLocation` (../projects.defaultLocation/finalize) + // after you add Firebase resources to the Project. LocationId string `json:"locationId,omitempty"` // Project: The resource name of the GCP `Project` to which Firebase // resources can be added, in the format: projects/PROJECT_IDENTIFIER - // Refer to the `FirebaseProject` `name` field for details about + // Refer to the `FirebaseProject` `name` + // (../projects#FirebaseProject.FIELDS.name) field for details about // PROJECT_IDENTIFIER values. Project string `json:"project,omitempty"` @@ -1417,12 +1443,16 @@ type ShaCertificate struct { // the format: // projects/PROJECT_IDENTIFIER/androidApps/APP_ID/sha/SHA_HASH * // PROJECT_IDENTIFIER: the parent Project's `ProjectNumber` - // ***(recommended)*** or its `ProjectId`. Learn more about using - // project identifiers in Google's AIP 2510 standard. Note that the - // value for PROJECT_IDENTIFIER in any response body will be the - // `ProjectId`. * APP_ID: the globally unique, Firebase-assigned - // identifier for the App (see `appId`). * SHA_HASH: the certificate - // hash for the App (see `shaHash`). + // (../projects#FirebaseProject.FIELDS.project_number) + // ***(recommended)*** or its `ProjectId` + // (../projects#FirebaseProject.FIELDS.project_id). Learn more about + // using project identifiers in Google's AIP 2510 standard + // (https://google.aip.dev/cloud/2510). Note that the value for + // PROJECT_IDENTIFIER in any response body will be the `ProjectId`. * + // APP_ID: the globally unique, Firebase-assigned identifier for the App + // (see `appId` (../projects.androidApps#AndroidApp.FIELDS.app_id)). * + // SHA_HASH: the certificate hash for the App (see `shaHash` + // (../projects.androidApps.sha#ShaCertificate.FIELDS.sha_hash)). Name string `json:"name,omitempty"` // ShaHash: The certificate hash for the `AndroidApp`. @@ -1457,10 +1487,11 @@ func (s *ShaCertificate) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1551,20 +1582,22 @@ type StreamMapping struct { // projects/PROJECT_IDENTIFIER/androidApps/APP_ID or // projects/PROJECT_IDENTIFIER/iosApps/APP_ID or // projects/PROJECT_IDENTIFIER /webApps/APP_ID Refer to the - // `FirebaseProject` `name` field for details about PROJECT_IDENTIFIER - // values. + // `FirebaseProject` `name` (../projects#FirebaseProject.FIELDS.name) + // field for details about PROJECT_IDENTIFIER values. App string `json:"app,omitempty"` // MeasurementId: Applicable for Firebase Web Apps only. The unique // Google-assigned identifier of the Google Analytics web stream // associated with the Firebase Web App. Firebase SDKs use this ID to // interact with Google Analytics APIs. Learn more about this ID and - // Google Analytics web streams in the Analytics documentation. + // Google Analytics web streams in the Analytics documentation + // (https://support.google.com/analytics/topic/9303475). MeasurementId string `json:"measurementId,omitempty"` // StreamId: The unique Google-assigned identifier of the Google // Analytics data stream associated with the Firebase App. Learn more - // about Google Analytics data streams in the Analytics documentation. + // about Google Analytics data streams in the Analytics documentation + // (https://support.google.com/analytics/answer/9303323). StreamId int64 `json:"streamId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "App") to @@ -1605,11 +1638,15 @@ type WebApp struct { // Name: The resource name of the WebApp, in the format: // projects/PROJECT_IDENTIFIER /webApps/APP_ID * PROJECT_IDENTIFIER: the - // parent Project's `ProjectNumber` ***(recommended)*** or its - // `ProjectId`. Learn more about using project identifiers in Google's - // AIP 2510 standard. Note that the value for PROJECT_IDENTIFIER in any - // response body will be the `ProjectId`. * APP_ID: the globally unique, - // Firebase-assigned identifier for the App (see `appId`). + // parent Project's `ProjectNumber` + // (../projects#FirebaseProject.FIELDS.project_number) + // ***(recommended)*** or its `ProjectId` + // (../projects#FirebaseProject.FIELDS.project_id). Learn more about + // using project identifiers in Google's AIP 2510 standard + // (https://google.aip.dev/cloud/2510). Note that the value for + // PROJECT_IDENTIFIER in any response body will be the `ProjectId`. * + // APP_ID: the globally unique, Firebase-assigned identifier for the App + // (see `appId` (../projects.webApps#WebApp.FIELDS.app_id)). Name string `json:"name,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier of the parent @@ -1668,11 +1705,12 @@ type WebAppConfig struct { DatabaseURL string `json:"databaseURL,omitempty"` // LocationId: The ID of the Project's default GCP resource location. - // The location is one of the available GCP resource locations. This - // field is omitted if the default GCP resource location has not been - // finalized yet. To set a Project's default GCP resource location, call - // `FinalizeDefaultLocation` after you add Firebase resources to the - // Project. + // The location is one of the available GCP resource locations + // (https://firebase.google.com/docs/projects/locations). This field is + // omitted if the default GCP resource location has not been finalized + // yet. To set a Project's default GCP resource location, call + // `FinalizeDefaultLocation` (../projects.defaultLocation/finalize) + // after you add Firebase resources to the Project. LocationId string `json:"locationId,omitempty"` // MeasurementId: The unique Google-assigned identifier of the Google @@ -1680,13 +1718,15 @@ type WebAppConfig struct { // this ID to interact with Google Analytics APIs. This field is only // present if the `WebApp` is linked to a web stream in a Google // Analytics App + Web property. Learn more about this ID and Google - // Analytics web streams in the Analytics documentation. To generate a + // Analytics web streams in the Analytics documentation + // (https://support.google.com/analytics/topic/9303475). To generate a // `measurementId` and link the `WebApp` with a Google Analytics web - // stream, call `AddGoogleAnalytics`. For apps using the Firebase - // JavaScript SDK v7.20.0 and later, Firebase dynamically fetches the - // `measurementId` when your app initializes Analytics. Having this ID - // in your config object is optional, but it does serve as a fallback in - // the rare case that the dynamic fetch fails. + // stream, call `AddGoogleAnalytics` + // (../../v1beta1/projects/addGoogleAnalytics). For apps using the + // Firebase JavaScript SDK v7.20.0 and later, Firebase dynamically + // fetches the `measurementId` when your app initializes Analytics. + // Having this ID in your config object is optional, but it does serve + // as a fallback in the rare case that the dynamic fetch fails. MeasurementId string `json:"measurementId,omitempty"` // MessagingSenderId: The sender ID for use with Firebase Cloud @@ -1741,10 +1781,11 @@ type AvailableProjectsListCall struct { // List: Lists each [Google Cloud Platform (GCP) `Project`] // (https://cloud.google.com/resource-manager/reference/rest/v1/projects) // that can have Firebase resources added to it. A Project will only be -// listed if: - The caller has sufficient Google IAM permissions to call -// AddFirebase. - The Project is not already a FirebaseProject. - The -// Project is not in an Organization which has policies that prevent -// Firebase resources from being added. +// listed if: - The caller has sufficient Google IAM +// (https://cloud.google.com/iam) permissions to call AddFirebase. - The +// Project is not already a FirebaseProject. - The Project is not in an +// Organization which has policies that prevent Firebase resources from +// being added. func (r *AvailableProjectsService) List() *AvailableProjectsListCall { c := &AvailableProjectsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -2083,19 +2124,23 @@ type ProjectsAddFirebaseCall struct { // . Since a FirebaseProject is actually also a GCP `Project`, a // `FirebaseProject` has the same underlying GCP identifiers // (`projectNumber` and `projectId`). This allows for easy interop with -// Google APIs. The result of this call is an `Operation`. Poll the -// `Operation` to track the provisioning process by calling GetOperation -// until `done` is `true`. When `done` is `true`, the `Operation` has -// either succeeded or failed. If the `Operation` succeeded, its -// `response` is set to a FirebaseProject; if the `Operation` failed, -// its `error` is set to a google.rpc.Status. The `Operation` is -// automatically deleted after completion, so there is no need to call -// DeleteOperation. This method does not modify any billing account -// information on the underlying GCP `Project`. To call `AddFirebase`, a -// project member or service account must have the following permissions -// (the IAM roles of Editor and Owner contain these permissions): -// `firebase.projects.update`, `resourcemanager.projects.get`, -// `serviceusage.services.enable`, and `serviceusage.services.get`. +// Google APIs. The result of this call is an `Operation` +// (../../v1beta1/operations). Poll the `Operation` to track the +// provisioning process by calling GetOperation until `done` +// (../../v1beta1/operations#Operation.FIELDS.done) is `true`. When +// `done` is `true`, the `Operation` has either succeeded or failed. If +// the `Operation` succeeded, its `response` +// (../../v1beta1/operations#Operation.FIELDS.response) is set to a +// FirebaseProject; if the `Operation` failed, its `error` +// (../../v1beta1/operations#Operation.FIELDS.error) is set to a +// google.rpc.Status. The `Operation` is automatically deleted after +// completion, so there is no need to call DeleteOperation. This method +// does not modify any billing account information on the underlying GCP +// `Project`. To call `AddFirebase`, a project member or service account +// must have the following permissions (the IAM roles of Editor and +// Owner contain these permissions): `firebase.projects.update`, +// `resourcemanager.projects.get`, `serviceusage.services.enable`, and +// `serviceusage.services.get`. func (r *ProjectsService) AddFirebase(projectid string, addfirebaserequest *AddFirebaseRequest) *ProjectsAddFirebaseCall { c := &ProjectsAddFirebaseCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectid = projectid @@ -2237,37 +2282,44 @@ type ProjectsAddGoogleAnalyticsCall struct { } // AddGoogleAnalytics: Links the specified FirebaseProject with an -// existing Google Analytics account. Using this call, you can either: - -// Specify an `analyticsAccountId` to provision a new Google Analytics -// property within the specified account and associate the new property -// with the `FirebaseProject`. - Specify an existing -// `analyticsPropertyId` to associate the property with the -// `FirebaseProject`. Note that when you call `AddGoogleAnalytics`: 1. -// The first check determines if any existing data streams in the Google -// Analytics property correspond to any existing Firebase Apps in the -// `FirebaseProject` (based on the `packageName` or `bundleId` -// associated with the data stream). Then, as applicable, the data -// streams and apps are linked. Note that this auto-linking only applies -// to `AndroidApps` and `IosApps`. 2. If no corresponding data streams -// are found for the Firebase Apps, new data streams are provisioned in -// the Google Analytics property for each of the Firebase Apps. Note -// that a new data stream is always provisioned for a Web App even if it -// was previously associated with a data stream in the Analytics -// property. Learn more about the hierarchy and structure of Google -// Analytics accounts in the Analytics documentation. The result of this -// call is an `Operation`. Poll the `Operation` to track the -// provisioning process by calling GetOperation until `done` is `true`. -// When `done` is `true`, the `Operation` has either succeeded or -// failed. If the `Operation` succeeded, its `response` is set to an -// AnalyticsDetails; if the `Operation` failed, its `error` is set to a +// existing Google Analytics account (http://www.google.com/analytics/). +// Using this call, you can either: - Specify an `analyticsAccountId` to +// provision a new Google Analytics property within the specified +// account and associate the new property with the `FirebaseProject`. - +// Specify an existing `analyticsPropertyId` to associate the property +// with the `FirebaseProject`. Note that when you call +// `AddGoogleAnalytics`: 1. The first check determines if any existing +// data streams in the Google Analytics property correspond to any +// existing Firebase Apps in the `FirebaseProject` (based on the +// `packageName` or `bundleId` associated with the data stream). Then, +// as applicable, the data streams and apps are linked. Note that this +// auto-linking only applies to `AndroidApps` and `IosApps`. 2. If no +// corresponding data streams are found for the Firebase Apps, new data +// streams are provisioned in the Google Analytics property for each of +// the Firebase Apps. Note that a new data stream is always provisioned +// for a Web App even if it was previously associated with a data stream +// in the Analytics property. Learn more about the hierarchy and +// structure of Google Analytics accounts in the Analytics documentation +// (https://support.google.com/analytics/answer/9303323). The result of +// this call is an `Operation` (../../v1beta1/operations). Poll the +// `Operation` to track the provisioning process by calling GetOperation +// until `done` (../../v1beta1/operations#Operation.FIELDS.done) is +// `true`. When `done` is `true`, the `Operation` has either succeeded +// or failed. If the `Operation` succeeded, its `response` +// (../../v1beta1/operations#Operation.FIELDS.response) is set to an +// AnalyticsDetails; if the `Operation` failed, its `error` +// (../../v1beta1/operations#Operation.FIELDS.error) is set to a // google.rpc.Status. To call `AddGoogleAnalytics`, a project member // must be an Owner for the existing `FirebaseProject` and have the -// `Edit` permission for the Google Analytics account. If the -// `FirebaseProject` already has Google Analytics enabled, and you call -// `AddGoogleAnalytics` using an `analyticsPropertyId` that's different -// from the currently associated property, then the call will fail. -// Analytics may have already been enabled in the Firebase console or by -// specifying `timeZone` and `regionCode` in the call to `AddFirebase`. +// `Edit` permission +// (https://support.google.com/analytics/answer/2884495) for the Google +// Analytics account. If the `FirebaseProject` already has Google +// Analytics enabled, and you call `AddGoogleAnalytics` using an +// `analyticsPropertyId` that's different from the currently associated +// property, then the call will fail. Analytics may have already been +// enabled in the Firebase console or by specifying `timeZone` and +// `regionCode` in the call to `AddFirebase` +// (../../v1beta1/projects/addFirebase). func (r *ProjectsService) AddGoogleAnalytics(parent string, addgoogleanalyticsrequest *AddGoogleAnalyticsRequest) *ProjectsAddGoogleAnalyticsCall { c := &ProjectsAddGoogleAnalyticsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -2558,7 +2610,9 @@ type ProjectsGetAdminSdkConfigCall struct { // GetAdminSdkConfig: Gets the configuration artifact associated with // the specified FirebaseProject, which can be used by servers to // simplify initialization. Typically, this configuration is used with -// the Firebase Admin SDK initializeApp command. +// the Firebase Admin SDK initializeApp +// (https://firebase.google.com/docs/admin/setup#initialize_the_sdk) +// command. func (r *ProjectsService) GetAdminSdkConfig(name string) *ProjectsGetAdminSdkConfigCall { c := &ProjectsGetAdminSdkConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3047,7 +3101,7 @@ type ProjectsPatchCall struct { } // Patch: Updates the attributes of the specified FirebaseProject. All -// query parameters are required. +// query parameters (#query-parameters) are required. func (r *ProjectsService) Patch(nameid string, firebaseproject *FirebaseProject) *ProjectsPatchCall { c := &ProjectsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.nameid = nameid @@ -3209,7 +3263,8 @@ type ProjectsRemoveAnalyticsCall struct { // property. However, this call does not delete the Google Analytics // resources, such as the Google Analytics property or any data streams. // These resources may be re-associated later to the `FirebaseProject` -// by calling `AddGoogleAnalytics` and specifying the same +// by calling `AddGoogleAnalytics` +// (../../v1beta1/projects/addGoogleAnalytics) and specifying the same // `analyticsPropertyId`. For Android Apps and iOS Apps, this call // re-links data streams with their corresponding apps. However, for Web // Apps, this call provisions a *new* data stream for each Web App. To @@ -3367,11 +3422,14 @@ func (r *ProjectsService) SearchApps(parent string) *ProjectsSearchAppsCall { } // Filter sets the optional parameter "filter": A query string -// compatible with Google's AIP-160 standard. Use any of the following -// fields in a query: * `app_id` * `namespace` * `platform` We also -// support the following "virtual" fields (fields which are not actually -// part of the returned resource object, but can be queried as if they -// are pre-populated with specific values): * `sha1_hash`: This field is +// compatible with Google's AIP-160 (https://google.aip.dev/160) +// standard. Use any of the following fields in a query: * `app_id` +// (../projects.apps#FirebaseAppInfo.FIELDS.app_id) * `namespace` +// (../projects.apps#FirebaseAppInfo.FIELDS.namespace) * `platform` +// (../projects.apps#FirebaseAppInfo.FIELDS.platform) We also support +// the following "virtual" fields (fields which are not actually part of +// the returned resource object, but can be queried as if they are +// pre-populated with specific values): * `sha1_hash`: This field is // considered to be a repeated `string` field, populated with the list // of all SHA-1 certificate fingerprints registered with the app. This // list is empty if the app is not an Android app. * `sha256_hash`: This @@ -4801,15 +4859,17 @@ type ProjectsAvailableLocationsListCall struct { // List: Lists the valid Google Cloud Platform (GCP) resource locations // for the specified Project (including a FirebaseProject). One of these // locations can be selected as the Project's _default_ GCP resource -// location, which is the geographical location where the Project's -// resources, such as Cloud Firestore, will be provisioned by default. -// However, if the default GCP resource location has already been set -// for the Project, then this setting cannot be changed. This call -// checks for any possible location restrictions for the specified -// Project and, thus, might return a subset of all possible GCP resource -// locations. To list all GCP resource locations (regardless of any -// restrictions), call the endpoint without specifying a unique project -// identifier (that is, +// location (https://firebase.google.com/docs/projects/locations), which +// is the geographical location where the Project's resources, such as +// Cloud Firestore, will be provisioned by default. However, if the +// default GCP resource location has already been set for the Project, +// then this setting cannot be changed. This call checks for any +// possible location restrictions +// (https://cloud.google.com/resource-manager/docs/organization-policy/de +// fining-locations) for the specified Project and, thus, might return a +// subset of all possible GCP resource locations. To list all GCP +// resource locations (regardless of any restrictions), call the +// endpoint without specifying a unique project identifier (that is, // `/v1beta1/{parent=projects/-}/listAvailableLocations`). To call // `ListAvailableLocations` with a specified project, a member must be // at minimum a Viewer of the Project. Calls without a specified project @@ -5012,27 +5072,34 @@ type ProjectsDefaultLocationFinalizeCall struct { // Finalize: Sets the default Google Cloud Platform (GCP) resource // location for the specified FirebaseProject. This method creates an -// App Engine application with a default Cloud Storage bucket, located -// in the specified `locationId`. This location must be one of the -// available GCP resource locations. After the default GCP resource -// location is finalized, or if it was already set, it cannot be -// changed. The default GCP resource location for the specified -// `FirebaseProject` might already be set because either the underlying -// GCP `Project` already has an App Engine application or +// App Engine application with a default Cloud Storage bucket +// (https://cloud.google.com/appengine/docs/standard/python/googlecloudst +// orageclient/setting-up-cloud-storage#activating_a_cloud_storage_bucket +// ), located in the specified `locationId` +// (#body.request_body.FIELDS.location_id). This location must be one of +// the available GCP resource locations +// (https://firebase.google.com/docs/projects/locations). After the +// default GCP resource location is finalized, or if it was already set, +// it cannot be changed. The default GCP resource location for the +// specified `FirebaseProject` might already be set because either the +// underlying GCP `Project` already has an App Engine application or // `FinalizeDefaultLocation` was previously called with a specified // `locationId`. Any new calls to `FinalizeDefaultLocation` with a // *different* specified `locationId` will return a 409 error. The -// result of this call is an `Operation`, which can be used to track the -// provisioning process. The `response` type of the `Operation` is -// google.protobuf.Empty. The `Operation` can be polled by its `name` -// using GetOperation until `done` is true. When `done` is true, the -// `Operation` has either succeeded or failed. If the `Operation` has -// succeeded, its `response` will be set to a google.protobuf.Empty; if -// the `Operation` has failed, its `error` will be set to a -// google.rpc.Status. The `Operation` is automatically deleted after -// completion, so there is no need to call DeleteOperation. All fields -// listed in the request body are required. To call -// `FinalizeDefaultLocation`, a member must be an Owner of the Project. +// result of this call is an `Operation` (../../v1beta1/operations), +// which can be used to track the provisioning process. The `response` +// (../../v1beta1/operations#Operation.FIELDS.response) type of the +// `Operation` is google.protobuf.Empty. The `Operation` can be polled +// by its `name` using GetOperation until `done` is true. When `done` is +// true, the `Operation` has either succeeded or failed. If the +// `Operation` has succeeded, its `response` +// (../../v1beta1/operations#Operation.FIELDS.response) will be set to a +// google.protobuf.Empty; if the `Operation` has failed, its `error` +// will be set to a google.rpc.Status. The `Operation` is automatically +// deleted after completion, so there is no need to call +// DeleteOperation. All fields listed in the request body +// (#request-body) are required. To call `FinalizeDefaultLocation`, a +// member must be an Owner of the Project. func (r *ProjectsDefaultLocationService) Finalize(parent string, finalizedefaultlocationrequest *FinalizeDefaultLocationRequest) *ProjectsDefaultLocationFinalizeCall { c := &ProjectsDefaultLocationFinalizeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go b/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go index 9fee9060410..2bed9211533 100644 --- a/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go +++ b/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go @@ -246,13 +246,17 @@ func (s *AndroidInfo) MarshalJSON() ([]byte, error) { // Dynamic Link. type CreateManagedShortLinkRequest struct { // DynamicLinkInfo: Information about the Dynamic Link to be shortened. - // Learn more. + // Learn more + // (https://firebase.google.com/docs/reference/dynamic-links/link-shorten + // er). DynamicLinkInfo *DynamicLinkInfo `json:"dynamicLinkInfo,omitempty"` // LongDynamicLink: Full long Dynamic Link URL with desired query // parameters specified. For example, // "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample" - // , Learn more. + // , Learn more + // (https://firebase.google.com/docs/reference/dynamic-links/link-shorten + // er). LongDynamicLink string `json:"longDynamicLink,omitempty"` // Name: Link name to associate with the link. It's used for marketer to @@ -337,13 +341,17 @@ func (s *CreateManagedShortLinkResponse) MarshalJSON() ([]byte, error) { // Link. type CreateShortDynamicLinkRequest struct { // DynamicLinkInfo: Information about the Dynamic Link to be shortened. - // Learn more. + // Learn more + // (https://firebase.google.com/docs/reference/dynamic-links/link-shorten + // er). DynamicLinkInfo *DynamicLinkInfo `json:"dynamicLinkInfo,omitempty"` // LongDynamicLink: Full long Dynamic Link URL with desired query // parameters specified. For example, // "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample" - // , Learn more. + // , Learn more + // (https://firebase.google.com/docs/reference/dynamic-links/link-shorten + // er). LongDynamicLink string `json:"longDynamicLink,omitempty"` // SdkVersion: Google SDK version. Version takes the form @@ -556,15 +564,18 @@ func (s *DynamicLinkEventStat) MarshalJSON() ([]byte, error) { // DynamicLinkInfo: Information about a Dynamic Link. type DynamicLinkInfo struct { // AnalyticsInfo: Parameters used for tracking. See all tracking - // parameters in the documentation. + // parameters in the documentation + // (https://firebase.google.com/docs/dynamic-links/create-manually). AnalyticsInfo *AnalyticsInfo `json:"analyticsInfo,omitempty"` // AndroidInfo: Android related information. See Android related - // parameters in the documentation. + // parameters in the documentation + // (https://firebase.google.com/docs/dynamic-links/create-manually). AndroidInfo *AndroidInfo `json:"androidInfo,omitempty"` // DesktopInfo: Desktop related information. See desktop related - // parameters in the documentation. + // parameters in the documentation + // (https://firebase.google.com/docs/dynamic-links/create-manually). DesktopInfo *DesktopInfo `json:"desktopInfo,omitempty"` // DomainUriPrefix: E.g. https://maps.app.goo.gl, @@ -575,19 +586,23 @@ type DynamicLinkInfo struct { DomainUriPrefix string `json:"domainUriPrefix,omitempty"` // DynamicLinkDomain: Dynamic Links domain that the project owns, e.g. - // abcd.app.goo.gl Learn more on how to set up Dynamic Link domain - // associated with your Firebase project. Required if missing - // domain_uri_prefix. + // abcd.app.goo.gl Learn more + // (https://firebase.google.com/docs/dynamic-links/android/receive) on + // how to set up Dynamic Link domain associated with your Firebase + // project. Required if missing domain_uri_prefix. DynamicLinkDomain string `json:"dynamicLinkDomain,omitempty"` // IosInfo: iOS related information. See iOS related parameters in the - // documentation. + // documentation + // (https://firebase.google.com/docs/dynamic-links/create-manually). IosInfo *IosInfo `json:"iosInfo,omitempty"` // Link: The link your app will open, You can specify any URL your app // can handle. This link must be a well-formatted URL, be properly // URL-encoded, and use the HTTP or HTTPS scheme. See 'link' parameters - // in the documentation. Required. + // in the documentation + // (https://firebase.google.com/docs/dynamic-links/create-manually). + // Required. Link string `json:"link,omitempty"` // NavigationInfo: Information of navigation behavior of a Firebase @@ -1044,10 +1059,13 @@ func (s *GetIosReopenAttributionResponse) MarshalJSON() ([]byte, error) { // GooglePlayAnalytics: Parameters for Google Play Campaign // Measurements. Learn more +// (https://developers.google.com/analytics/devguides/collection/android/ +// v4/campaigns#campaign-params) type GooglePlayAnalytics struct { - // Gclid: AdWords autotagging parameter; used to measure Google AdWords - // ads. This value is generated dynamically and should never be - // modified. + // Gclid: AdWords autotagging parameter + // (https://support.google.com/analytics/answer/1033981?hl=en); used to + // measure Google AdWords ads. This value is generated dynamically and + // should never be modified. Gclid string `json:"gclid,omitempty"` // UtmCampaign: Campaign name; used for keyword analysis to identify a diff --git a/firebasehosting/v1/firebasehosting-gen.go b/firebasehosting/v1/firebasehosting-gen.go index 4e2bfd99f54..569f81c6abb 100644 --- a/firebasehosting/v1/firebasehosting-gen.go +++ b/firebasehosting/v1/firebasehosting-gen.go @@ -247,10 +247,11 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/firebasehosting/v1beta1/firebasehosting-gen.go b/firebasehosting/v1beta1/firebasehosting-gen.go index 3667bcced0f..7be5f2f356a 100644 --- a/firebasehosting/v1beta1/firebasehosting-gen.go +++ b/firebasehosting/v1beta1/firebasehosting-gen.go @@ -786,11 +786,14 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } -// Header: A `header` is an object that specifies a URL pattern that, if -// matched to the request URL path, triggers Hosting to apply the -// specified custom response headers. +// Header: A `header` (/docs/hosting/full-config#headers) is an object +// that specifies a URL pattern that, if matched to the request URL +// path, triggers Hosting to apply the specified custom response +// headers. type Header struct { - // Glob: The user-supplied glob to match against the request URL path. + // Glob: The user-supplied glob + // (/docs/hosting/full-config#glob_pattern_matching) to match against + // the request URL path. Glob string `json:"glob,omitempty"` // Headers: Required. The additional headers to add to the response. @@ -858,8 +861,9 @@ type ListChannelsResponse struct { Channels []*Channel `json:"channels,omitempty"` // NextPageToken: If there are additional releases remaining beyond the - // ones in this response, then supply this token in the next `list` call - // to continue with the next set of releases. + // ones in this response, then supply this token in the next `list` + // (../sites.channels/list) call to continue with the next set of + // releases. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -926,8 +930,9 @@ func (s *ListDomainsResponse) MarshalJSON() ([]byte, error) { type ListReleasesResponse struct { // NextPageToken: If there are additional releases remaining beyond the - // ones in this response, then supply this token in the next `list` call - // to continue with the next set of releases. + // ones in this response, then supply this token in the next `list` + // (../sites.versions.files/list) call to continue with the next set of + // releases. NextPageToken string `json:"nextPageToken,omitempty"` // Releases: The list of hashes of files that still need to be uploaded, @@ -1229,11 +1234,14 @@ func (s *PreviewConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Redirect: A `redirect` object specifies a URL pattern that, if -// matched to the request URL path, triggers Hosting to respond with a -// redirect to the specified destination path. +// Redirect: A `redirect` (/docs/hosting/full-config#redirects) object +// specifies a URL pattern that, if matched to the request URL path, +// triggers Hosting to respond with a redirect to the specified +// destination path. type Redirect struct { - // Glob: The user-supplied glob to match against the request URL path. + // Glob: The user-supplied glob + // (/docs/hosting/full-config#glob_pattern_matching) to match against + // the request URL path. Glob string `json:"glob,omitempty"` // Location: Required. The value to put in the HTTP location header of @@ -1276,7 +1284,7 @@ func (s *Redirect) MarshalJSON() ([]byte, error) { } // Release: A `Release` is a particular collection of configurations and -// files that is set to be public at a particular time. +// files (sites.versions) that is set to be public at a particular time. type Release struct { // Message: The deploy description when the release was created. The // value can be up to 512 characters. @@ -1284,7 +1292,8 @@ type Release struct { // Name: Output only. The unique identifier for the release, in the // format: sites/ site-name/releases/releaseID This name is provided in - // the response body when you call the `CreateRelease` endpoint. + // the response body when you call the `CreateRelease` + // (sites.releases/create) endpoint. Name string `json:"name,omitempty"` // ReleaseTime: Output only. The time at which the version is set to be @@ -1340,9 +1349,10 @@ func (s *Release) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Rewrite: A `rewrite` object specifies a URL pattern that, if matched -// to the request URL path, triggers Hosting to respond as if the -// service were given the specified destination URL. +// Rewrite: A `rewrite` (/docs/hosting/full-config#rewrites) object +// specifies a URL pattern that, if matched to the request URL path, +// triggers Hosting to respond as if the service were given the +// specified destination URL. type Rewrite struct { // DynamicLinks: The request will be forwarded to Firebase Dynamic // Links. @@ -1352,7 +1362,9 @@ type Rewrite struct { // function name exactly. Function string `json:"function,omitempty"` - // Glob: The user-supplied glob to match against the request URL path. + // Glob: The user-supplied glob + // (/docs/hosting/full-config#glob_pattern_matching) to match against + // the request URL path. Glob string `json:"glob,omitempty"` // Path: The URL path to rewrite the request to. @@ -1392,7 +1404,8 @@ func (s *Rewrite) MarshalJSON() ([]byte, error) { // should be routed and processed before serving content. The URL // request paths are matched against the specified URL patterns in the // configuration, then Hosting applies the applicable configuration -// according to a specific priority order. +// according to a specific priority order +// (/docs/hosting/full-config#hosting_priority_order). type ServingConfig struct { // AppAssociation: How to handle well known App Association files. // @@ -1509,10 +1522,11 @@ func (s *SiteConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1551,10 +1565,11 @@ func (s *Status) MarshalJSON() ([]byte, error) { } // Version: A `Version` is the collection of configuration and static -// files that determine how a site is displayed. +// files (sites.versions.files) that determine how a site is displayed. type Version struct { // Config: The configuration for the behavior of the site. This - // configuration exists in the `firebase.json` file. + // configuration exists in the `firebase.json` + // (/docs/cli/#the_firebasejson_file) file. Config *ServingConfig `json:"config,omitempty"` // CreateTime: Output only. The time at which the version was created. @@ -1587,7 +1602,8 @@ type Version struct { // Name: The unique identifier for a version, in the format: // sites/site-name /versions/versionID This name is provided in the - // response body when you call the `CreateVersion` endpoint. + // response body when you call the `CreateVersion` + // (../sites.versions/create) endpoint. Name string `json:"name,omitempty"` // Preview: Deprecated in favor of site channels. Version preview @@ -1598,13 +1614,14 @@ type Version struct { Preview *PreviewConfig `json:"preview,omitempty"` // Status: The deploy status of a version. For a successful deploy, call - // the `CreateVersion` endpoint to make a new version (`CREATED` - // status), upload all desired files to the version, then update the - // version to the `FINALIZED` status. Note that if you leave the version - // in the `CREATED` state for more than 12 hours, the system will - // automatically mark the version as `ABANDONED`. You can also change - // the status of a version to `DELETED` by calling the `DeleteVersion` - // endpoint. + // the `CreateVersion` (sites.versions/create) endpoint to make a new + // version (`CREATED` status), upload all desired files + // (sites.versions/populateFiles) to the version, then update + // (sites.versions/patch) the version to the `FINALIZED` status. Note + // that if you leave the version in the `CREATED` state for more than 12 + // hours, the system will automatically mark the version as `ABANDONED`. + // You can also change the status of a version to `DELETED` by calling + // the `DeleteVersion` (sites.versions/delete) endpoint. // // Possible values: // "VERSION_STATUS_UNSPECIFIED" - The default status; should not be @@ -2013,9 +2030,10 @@ func (r *ProjectsSitesService) UpdateConfig(name string, siteconfig *SiteConfig) } // UpdateMask sets the optional parameter "updateMask": A set of field -// names from your site configuration that you want to update. A field -// will be overwritten if, and only if, it's in the mask. If a mask is -// not provided then a default mask of only `max_versions` will be used. +// names from your site configuration (../sites.SiteConfig) that you +// want to update. A field will be overwritten if, and only if, it's in +// the mask. If a mask is not provided then a default mask of only +// `max_versions` (../sites.SiteConfig.max_versions) will be used. func (c *ProjectsSitesUpdateConfigCall) UpdateMask(updateMask string) *ProjectsSitesUpdateConfigCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -5056,7 +5074,8 @@ type ProjectsSitesVersionsPatchCall struct { // method will fail with `FAILED_PRECONDITION` in the event of an // invalid state transition. The only valid transition for a version is // currently from a `CREATED` status to a `FINALIZED` status. Use -// `DeleteVersion` to set the status of a version to `DELETED`. +// `DeleteVersion` (../sites.versions/delete) to set the status of a +// version to `DELETED`. func (r *ProjectsSitesVersionsService) Patch(nameid string, version *Version) *ProjectsSitesVersionsPatchCall { c := &ProjectsSitesVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.nameid = nameid @@ -5065,9 +5084,10 @@ func (r *ProjectsSitesVersionsService) Patch(nameid string, version *Version) *P } // UpdateMask sets the optional parameter "updateMask": A set of field -// names from your version that you want to update. A field will be -// overwritten if, and only if, it's in the mask. If a mask is not -// provided then a default mask of only `status` will be used. +// names from your version (../sites.versions) that you want to update. +// A field will be overwritten if, and only if, it's in the mask. If a +// mask is not provided then a default mask of only `status` +// (../sites.versions#Version.FIELDS.status) will be used. func (c *ProjectsSitesVersionsPatchCall) UpdateMask(updateMask string) *ProjectsSitesVersionsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -5735,9 +5755,10 @@ func (r *SitesService) UpdateConfig(name string, siteconfig *SiteConfig) *SitesU } // UpdateMask sets the optional parameter "updateMask": A set of field -// names from your site configuration that you want to update. A field -// will be overwritten if, and only if, it's in the mask. If a mask is -// not provided then a default mask of only `max_versions` will be used. +// names from your site configuration (../sites.SiteConfig) that you +// want to update. A field will be overwritten if, and only if, it's in +// the mask. If a mask is not provided then a default mask of only +// `max_versions` (../sites.SiteConfig.max_versions) will be used. func (c *SitesUpdateConfigCall) UpdateMask(updateMask string) *SitesUpdateConfigCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -8778,7 +8799,8 @@ type SitesVersionsPatchCall struct { // method will fail with `FAILED_PRECONDITION` in the event of an // invalid state transition. The only valid transition for a version is // currently from a `CREATED` status to a `FINALIZED` status. Use -// `DeleteVersion` to set the status of a version to `DELETED`. +// `DeleteVersion` (../sites.versions/delete) to set the status of a +// version to `DELETED`. func (r *SitesVersionsService) Patch(nameid string, version *Version) *SitesVersionsPatchCall { c := &SitesVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.nameid = nameid @@ -8787,9 +8809,10 @@ func (r *SitesVersionsService) Patch(nameid string, version *Version) *SitesVers } // UpdateMask sets the optional parameter "updateMask": A set of field -// names from your version that you want to update. A field will be -// overwritten if, and only if, it's in the mask. If a mask is not -// provided then a default mask of only `status` will be used. +// names from your version (../sites.versions) that you want to update. +// A field will be overwritten if, and only if, it's in the mask. If a +// mask is not provided then a default mask of only `status` +// (../sites.versions#Version.FIELDS.status) will be used. func (c *SitesVersionsPatchCall) UpdateMask(updateMask string) *SitesVersionsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/firebaseml/v1/firebaseml-gen.go b/firebaseml/v1/firebaseml-gen.go index 6111efafc83..c0660dba6a6 100644 --- a/firebaseml/v1/firebaseml-gen.go +++ b/firebaseml/v1/firebaseml-gen.go @@ -298,10 +298,11 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/firebaseml/v1beta2/firebaseml-gen.go b/firebaseml/v1beta2/firebaseml-gen.go index 4dc4da4b725..573acddfb60 100644 --- a/firebaseml/v1beta2/firebaseml-gen.go +++ b/firebaseml/v1beta2/firebaseml-gen.go @@ -428,10 +428,11 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index c669f1d51fd..829df2c58f5 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -2874,10 +2874,11 @@ func (s *RunQueryResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3495,7 +3496,7 @@ func (c *ProjectsDatabasesExportDocumentsCall) Header() http.Header { func (c *ProjectsDatabasesExportDocumentsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3641,7 +3642,7 @@ func (c *ProjectsDatabasesImportDocumentsCall) Header() http.Header { func (c *ProjectsDatabasesImportDocumentsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3791,7 +3792,7 @@ func (c *ProjectsDatabasesCollectionGroupsFieldsGetCall) Header() http.Header { func (c *ProjectsDatabasesCollectionGroupsFieldsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3965,7 +3966,7 @@ func (c *ProjectsDatabasesCollectionGroupsFieldsListCall) Header() http.Header { func (c *ProjectsDatabasesCollectionGroupsFieldsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4159,7 +4160,7 @@ func (c *ProjectsDatabasesCollectionGroupsFieldsPatchCall) Header() http.Header func (c *ProjectsDatabasesCollectionGroupsFieldsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4309,7 +4310,7 @@ func (c *ProjectsDatabasesCollectionGroupsIndexesCreateCall) Header() http.Heade func (c *ProjectsDatabasesCollectionGroupsIndexesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4448,7 +4449,7 @@ func (c *ProjectsDatabasesCollectionGroupsIndexesDeleteCall) Header() http.Heade func (c *ProjectsDatabasesCollectionGroupsIndexesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4590,7 +4591,7 @@ func (c *ProjectsDatabasesCollectionGroupsIndexesGetCall) Header() http.Header { func (c *ProjectsDatabasesCollectionGroupsIndexesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4757,7 +4758,7 @@ func (c *ProjectsDatabasesCollectionGroupsIndexesListCall) Header() http.Header func (c *ProjectsDatabasesCollectionGroupsIndexesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4934,7 +4935,7 @@ func (c *ProjectsDatabasesDocumentsBatchGetCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBatchGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5080,7 +5081,7 @@ func (c *ProjectsDatabasesDocumentsBatchWriteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBatchWriteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5221,7 +5222,7 @@ func (c *ProjectsDatabasesDocumentsBeginTransactionCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBeginTransactionCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5362,7 +5363,7 @@ func (c *ProjectsDatabasesDocumentsCommitCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsCommitCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5521,7 +5522,7 @@ func (c *ProjectsDatabasesDocumentsCreateDocumentCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsCreateDocumentCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5695,7 +5696,7 @@ func (c *ProjectsDatabasesDocumentsDeleteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5871,7 +5872,7 @@ func (c *ProjectsDatabasesDocumentsGetCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6091,7 +6092,7 @@ func (c *ProjectsDatabasesDocumentsListCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6296,7 +6297,7 @@ func (c *ProjectsDatabasesDocumentsListCollectionIdsCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListCollectionIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6458,7 +6459,7 @@ func (c *ProjectsDatabasesDocumentsListenCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListenCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6602,7 +6603,7 @@ func (c *ProjectsDatabasesDocumentsPartitionQueryCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsPartitionQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6796,7 +6797,7 @@ func (c *ProjectsDatabasesDocumentsPatchCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6960,7 +6961,7 @@ func (c *ProjectsDatabasesDocumentsRollbackCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsRollbackCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7101,7 +7102,7 @@ func (c *ProjectsDatabasesDocumentsRunQueryCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsRunQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7242,7 +7243,7 @@ func (c *ProjectsDatabasesDocumentsWriteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsWriteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7392,7 +7393,7 @@ func (c *ProjectsDatabasesOperationsCancelCall) Header() http.Header { func (c *ProjectsDatabasesOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7534,7 +7535,7 @@ func (c *ProjectsDatabasesOperationsDeleteCall) Header() http.Header { func (c *ProjectsDatabasesOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7678,7 +7679,7 @@ func (c *ProjectsDatabasesOperationsGetCall) Header() http.Header { func (c *ProjectsDatabasesOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7853,7 +7854,7 @@ func (c *ProjectsDatabasesOperationsListCall) Header() http.Header { func (c *ProjectsDatabasesOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8036,7 +8037,7 @@ func (c *ProjectsLocationsGetCall) Header() http.Header { func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8203,7 +8204,7 @@ func (c *ProjectsLocationsListCall) Header() http.Header { func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/firestore/v1beta1/firestore-gen.go b/firestore/v1beta1/firestore-gen.go index d078d4c7078..5d1e5821b52 100644 --- a/firestore/v1beta1/firestore-gen.go +++ b/firestore/v1beta1/firestore-gen.go @@ -2401,10 +2401,11 @@ func (s *RunQueryResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3022,7 +3023,7 @@ func (c *ProjectsDatabasesExportDocumentsCall) Header() http.Header { func (c *ProjectsDatabasesExportDocumentsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3168,7 +3169,7 @@ func (c *ProjectsDatabasesImportDocumentsCall) Header() http.Header { func (c *ProjectsDatabasesImportDocumentsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3311,7 +3312,7 @@ func (c *ProjectsDatabasesDocumentsBatchGetCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBatchGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3457,7 +3458,7 @@ func (c *ProjectsDatabasesDocumentsBatchWriteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBatchWriteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3598,7 +3599,7 @@ func (c *ProjectsDatabasesDocumentsBeginTransactionCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsBeginTransactionCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3739,7 +3740,7 @@ func (c *ProjectsDatabasesDocumentsCommitCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsCommitCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3898,7 +3899,7 @@ func (c *ProjectsDatabasesDocumentsCreateDocumentCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsCreateDocumentCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4072,7 +4073,7 @@ func (c *ProjectsDatabasesDocumentsDeleteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4248,7 +4249,7 @@ func (c *ProjectsDatabasesDocumentsGetCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4468,7 +4469,7 @@ func (c *ProjectsDatabasesDocumentsListCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4673,7 +4674,7 @@ func (c *ProjectsDatabasesDocumentsListCollectionIdsCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListCollectionIdsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4835,7 +4836,7 @@ func (c *ProjectsDatabasesDocumentsListenCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsListenCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4979,7 +4980,7 @@ func (c *ProjectsDatabasesDocumentsPartitionQueryCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsPartitionQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5173,7 +5174,7 @@ func (c *ProjectsDatabasesDocumentsPatchCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5337,7 +5338,7 @@ func (c *ProjectsDatabasesDocumentsRollbackCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsRollbackCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5478,7 +5479,7 @@ func (c *ProjectsDatabasesDocumentsRunQueryCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsRunQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5619,7 +5620,7 @@ func (c *ProjectsDatabasesDocumentsWriteCall) Header() http.Header { func (c *ProjectsDatabasesDocumentsWriteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5768,7 +5769,7 @@ func (c *ProjectsDatabasesIndexesCreateCall) Header() http.Header { func (c *ProjectsDatabasesIndexesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5907,7 +5908,7 @@ func (c *ProjectsDatabasesIndexesDeleteCall) Header() http.Header { func (c *ProjectsDatabasesIndexesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6049,7 +6050,7 @@ func (c *ProjectsDatabasesIndexesGetCall) Header() http.Header { func (c *ProjectsDatabasesIndexesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6214,7 +6215,7 @@ func (c *ProjectsDatabasesIndexesListCall) Header() http.Header { func (c *ProjectsDatabasesIndexesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/firestore/v1beta2/firestore-gen.go b/firestore/v1beta2/firestore-gen.go index 8b999944589..e28645b2d02 100644 --- a/firestore/v1beta2/firestore-gen.go +++ b/firestore/v1beta2/firestore-gen.go @@ -1035,10 +1035,11 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/gameservices/v1/gameservices-gen.go b/gameservices/v1/gameservices-gen.go index 8e3ab7717a3..6350902ca98 100644 --- a/gameservices/v1/gameservices-gen.go +++ b/gameservices/v1/gameservices-gen.go @@ -364,7 +364,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1885,7 +1886,9 @@ func (s *OperationStatus) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1904,7 +1907,7 @@ func (s *OperationStatus) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1956,7 +1959,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2483,10 +2487,11 @@ func (s *SpecSource) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2692,7 +2697,8 @@ func (s *TargetState) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3709,7 +3715,8 @@ func (r *ProjectsLocationsGameServerDeploymentsService) GetIamPolicy(resource st // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/gameservices/v1beta/gameservices-gen.go b/gameservices/v1beta/gameservices-gen.go index 0c25624a13b..172123b8527 100644 --- a/gameservices/v1beta/gameservices-gen.go +++ b/gameservices/v1beta/gameservices-gen.go @@ -364,7 +364,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1885,7 +1886,9 @@ func (s *OperationStatus) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1904,7 +1907,7 @@ func (s *OperationStatus) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1956,7 +1959,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2483,10 +2487,11 @@ func (s *SpecSource) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2692,7 +2697,8 @@ func (s *TargetState) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3709,7 +3715,8 @@ func (r *ProjectsLocationsGameServerDeploymentsService) GetIamPolicy(resource st // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/genomics/v1/genomics-gen.go b/genomics/v1/genomics-gen.go index 0f11671ec0e..da9b7af5d40 100644 --- a/genomics/v1/genomics-gen.go +++ b/genomics/v1/genomics-gen.go @@ -798,10 +798,11 @@ func (s *RuntimeMetadata) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -956,8 +957,8 @@ type OperationsCancelCall struct { // is not guaranteed. Clients may use Operations.GetOperation or // Operations.ListOperations to check whether the cancellation succeeded // or the operation completed despite cancellation. Authorization -// requires the following Google IAM permission: * -// `genomics.operations.cancel` +// requires the following Google IAM (https://cloud.google.com/iam) +// permission: * `genomics.operations.cancel` func (r *OperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *OperationsCancelCall { c := &OperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -1101,7 +1102,8 @@ type OperationsGetCall struct { // Get: Gets the latest state of a long-running operation. Clients can // use this method to poll the operation result at intervals as // recommended by the API service. Authorization requires the following -// Google IAM permission: * `genomics.operations.get` +// Google IAM (https://cloud.google.com/iam) permission: * +// `genomics.operations.get` func (r *OperationsService) Get(name string) *OperationsGetCall { c := &OperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -1247,8 +1249,9 @@ type OperationsListCall struct { } // List: Lists operations that match the specified filter in the -// request. Authorization requires the following Google IAM permission: -// * `genomics.operations.list` +// request. Authorization requires the following Google IAM +// (https://cloud.google.com/iam) permission: * +// `genomics.operations.list` func (r *OperationsService) List(name string) *OperationsListCall { c := &OperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -1267,7 +1270,8 @@ func (r *OperationsService) List(name string) *OperationsListCall { // the value is true. In v1 and v1alpha2, the following filter fields // are supported: * projectId: Required. Corresponds to // OperationMetadata.projectId. * createTime: The time this job was -// created, in seconds from the epoch. Can use `>=` and/or `<=` +// created, in seconds from the epoch +// (http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `<=` // operators. * status: Can be `RUNNING`, `SUCCESS`, `FAILURE`, or // `CANCELED`. Only one status may be specified. * labels.key where key // is a label key. Examples: * `projectId = my-project AND createTime >= diff --git a/genomics/v1alpha2/genomics-gen.go b/genomics/v1alpha2/genomics-gen.go index 6f9ca085521..9ae025062a6 100644 --- a/genomics/v1alpha2/genomics-gen.go +++ b/genomics/v1alpha2/genomics-gen.go @@ -1172,7 +1172,9 @@ type PipelineResources struct { // and then ssh into the private VM's Internal IP. If noAddress is set, // this pipeline run may only load docker images from Google Container // Registry and not Docker Hub. Before using this, you must configure - // access to Google services from internal IPs. + // access to Google services from internal IPs + // (https://cloud.google.com/compute/docs/configure-private-google-access + // #configuring_access_to_google_services_from_internal_ips). NoAddress bool `json:"noAddress,omitempty"` // Preemptible: Whether to use preemptible VMs. Defaults to `false`. In @@ -1625,10 +1627,11 @@ func (s *SetOperationStatusRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1815,8 +1818,8 @@ type OperationsCancelCall struct { // is not guaranteed. Clients may use Operations.GetOperation or // Operations.ListOperations to check whether the cancellation succeeded // or the operation completed despite cancellation. Authorization -// requires the following Google IAM permission: * -// `genomics.operations.cancel` +// requires the following Google IAM (https://cloud.google.com/iam) +// permission: * `genomics.operations.cancel` func (r *OperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *OperationsCancelCall { c := &OperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -1960,7 +1963,8 @@ type OperationsGetCall struct { // Get: Gets the latest state of a long-running operation. Clients can // use this method to poll the operation result at intervals as // recommended by the API service. Authorization requires the following -// Google IAM permission: * `genomics.operations.get` +// Google IAM (https://cloud.google.com/iam) permission: * +// `genomics.operations.get` func (r *OperationsService) Get(name string) *OperationsGetCall { c := &OperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2106,8 +2110,9 @@ type OperationsListCall struct { } // List: Lists operations that match the specified filter in the -// request. Authorization requires the following Google IAM permission: -// * `genomics.operations.list` +// request. Authorization requires the following Google IAM +// (https://cloud.google.com/iam) permission: * +// `genomics.operations.list` func (r *OperationsService) List(name string) *OperationsListCall { c := &OperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2126,7 +2131,8 @@ func (r *OperationsService) List(name string) *OperationsListCall { // the value is true. In v1 and v1alpha2, the following filter fields // are supported: * projectId: Required. Corresponds to // OperationMetadata.projectId. * createTime: The time this job was -// created, in seconds from the epoch. Can use `>=` and/or `<=` +// created, in seconds from the epoch +// (http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `<=` // operators. * status: Can be `RUNNING`, `SUCCESS`, `FAILURE`, or // `CANCELED`. Only one status may be specified. * labels.key where key // is a label key. Examples: * `projectId = my-project AND createTime >= diff --git a/genomics/v2alpha1/genomics-gen.go b/genomics/v2alpha1/genomics-gen.go index 2ee8be54559..a57128acd51 100644 --- a/genomics/v2alpha1/genomics-gen.go +++ b/genomics/v2alpha1/genomics-gen.go @@ -1638,10 +1638,11 @@ func (s *ServiceAccount) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1798,10 +1799,12 @@ type VirtualMachine struct { // Labels: Optional set of labels to apply to the VM and any attached // disk resources. These labels must adhere to the name and value - // restrictions on VM labels imposed by Compute Engine. Labels keys with - // the prefix 'google-' are reserved for use by Google. Labels applied - // at creation time to the VM. Applied on a best-effort basis to - // attached disk resources shortly after VM creation. + // restrictions + // (https://cloud.google.com/compute/docs/labeling-resources) on VM + // labels imposed by Compute Engine. Labels keys with the prefix + // 'google-' are reserved for use by Google. Labels applied at creation + // time to the VM. Applied on a best-effort basis to attached disk + // resources shortly after VM creation. Labels map[string]string `json:"labels,omitempty"` // MachineType: Required. The machine type of the virtual machine to @@ -1809,7 +1812,9 @@ type VirtualMachine struct { // "n1-standard-1") or a custom machine type (such as "custom-1-4096", // where "1" indicates the number of vCPUs and "4096" indicates the // memory in MB). See Creating an instance with a custom machine type - // for more specifications on creating a custom machine type. + // (https://cloud.google.com/compute/docs/instances/creating-instance-wit + // h-custom-machine-type#create) for more specifications on creating a + // custom machine type. MachineType string `json:"machineType,omitempty"` // Network: The VM network configuration. @@ -2025,7 +2030,8 @@ type PipelinesRunCall struct { // you delete this permission, or if you enabled the Cloud Genomics API // before the v2alpha1 API launch, you must disable and re-enable the // API to grant the Genomics Service Agent the required permissions. -// Authorization requires the following Google IAM permission: * +// Authorization requires the following Google IAM +// (https://cloud.google.com/iam/) permission: * // `genomics.operations.create` [1]: /genomics/gsa func (r *PipelinesService) Run(runpipelinerequest *RunPipelineRequest) *PipelinesRunCall { c := &PipelinesRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -2158,8 +2164,8 @@ type ProjectsOperationsCancelCall struct { // is not guaranteed. Clients may use Operations.GetOperation or // Operations.ListOperations to check whether the cancellation succeeded // or the operation completed despite cancellation. Authorization -// requires the following Google IAM permission: * -// `genomics.operations.cancel` +// requires the following Google IAM (https://cloud.google.com/iam) +// permission: * `genomics.operations.cancel` func (r *ProjectsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *ProjectsOperationsCancelCall { c := &ProjectsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2303,7 +2309,8 @@ type ProjectsOperationsGetCall struct { // Get: Gets the latest state of a long-running operation. Clients can // use this method to poll the operation result at intervals as // recommended by the API service. Authorization requires the following -// Google IAM permission: * `genomics.operations.get` +// Google IAM (https://cloud.google.com/iam) permission: * +// `genomics.operations.get` func (r *ProjectsOperationsService) Get(name string) *ProjectsOperationsGetCall { c := &ProjectsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2449,8 +2456,9 @@ type ProjectsOperationsListCall struct { } // List: Lists operations that match the specified filter in the -// request. Authorization requires the following Google IAM permission: -// * `genomics.operations.list` +// request. Authorization requires the following Google IAM +// (https://cloud.google.com/iam) permission: * +// `genomics.operations.list` func (r *ProjectsOperationsService) List(name string) *ProjectsOperationsListCall { c := &ProjectsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2469,7 +2477,8 @@ func (r *ProjectsOperationsService) List(name string) *ProjectsOperationsListCal // the value is true. In v1 and v1alpha2, the following filter fields // are supported: * projectId: Required. Corresponds to // OperationMetadata.projectId. * createTime: The time this job was -// created, in seconds from the epoch. Can use `>=` and/or `<=` +// created, in seconds from the epoch +// (http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `<=` // operators. * status: Can be `RUNNING`, `SUCCESS`, `FAILURE`, or // `CANCELED`. Only one status may be specified. * labels.key where key // is a label key. Examples: * `projectId = my-project AND createTime >= diff --git a/gmail/v1/gmail-gen.go b/gmail/v1/gmail-gen.go index 78ae2136877..64e29c7b4a1 100644 --- a/gmail/v1/gmail-gen.go +++ b/gmail/v1/gmail-gen.go @@ -1527,7 +1527,8 @@ type Message struct { // The requested `threadId` must be specified on the `Message` or // `Draft.Message` you supply with your request. 2. The `References` and // `In-Reply-To` headers must be set in compliance with the RFC 2822 - // standard. 3. The `Subject` headers must match. + // (https://tools.ietf.org/html/rfc2822) standard. 3. The `Subject` + // headers must match. ThreadId string `json:"threadId,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go b/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go index 8c727b1b02e..eb230b041bb 100644 --- a/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go +++ b/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go @@ -293,7 +293,9 @@ func (s *Domain) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// FeedbackLoop: Feedback loop identifier information. +// FeedbackLoop: Feedback loop +// (https://support.google.com/mail/answer/6254652) identifier +// information. type FeedbackLoop struct { // Id: Feedback loop identifier that uniquely identifies individual // campaigns. @@ -344,11 +346,13 @@ func (s *FeedbackLoop) UnmarshalJSON(data []byte) error { // specific reputation category. type IpReputation struct { // IpCount: Total number of unique IPs in this reputation category. This - // metric only pertains to traffic that passed SPF or DKIM. + // metric only pertains to traffic that passed SPF + // (http://www.openspf.org/) or DKIM (http://www.dkim.org/). IpCount int64 `json:"ipCount,omitempty,string"` // NumIps: Total number of unique IPs in this reputation category. This - // metric only pertains to traffic that passed SPF or DKIM. Deprecated + // metric only pertains to traffic that passed SPF + // (http://www.openspf.org/) or DKIM (http://www.dkim.org/). Deprecated // to be complied with ApiLinter for Quantities. Use ip_count instead. NumIps int64 `json:"numIps,omitempty,string"` @@ -473,17 +477,19 @@ func (s *ListTrafficStatsResponse) MarshalJSON() ([]byte, error) { // TrafficStats: Email traffic statistics pertaining to a specific date. type TrafficStats struct { // DeliveryErrors: Delivery errors for the domain. This metric only - // pertains to traffic that passed SPF or DKIM. + // pertains to traffic that passed SPF (http://www.openspf.org/) or DKIM + // (http://www.dkim.org/). DeliveryErrors []*DeliveryError `json:"deliveryErrors,omitempty"` // DkimSuccessRatio: The ratio of mail that successfully authenticated - // with DKIM vs. all mail that attempted to authenticate with DKIM. - // Spoofed mail is excluded. + // with DKIM vs. all mail that attempted to authenticate with DKIM + // (http://www.dkim.org/). Spoofed mail is excluded. DkimSuccessRatio float64 `json:"dkimSuccessRatio,omitempty"` - // DmarcSuccessRatio: The ratio of mail that passed DMARC alignment - // checks vs all mail received from the domain that successfully - // authenticated with either of SPF or DKIM. + // DmarcSuccessRatio: The ratio of mail that passed DMARC + // (https://dmarc.org/) alignment checks vs all mail received from the + // domain that successfully authenticated with either of SPF + // (http://www.openspf.org/) or DKIM (http://www.dkim.org/). DmarcSuccessRatio float64 `json:"dmarcSuccessRatio,omitempty"` // DomainReputation: Reputation of the domain. @@ -508,7 +514,8 @@ type TrafficStats struct { // InboundEncryptionRatio: The ratio of incoming mail (to Gmail), that // passed secure transport (TLS) vs all mail received from that domain. - // This metric only pertains to traffic that passed SPF or DKIM. + // This metric only pertains to traffic that passed SPF + // (http://www.openspf.org/) or DKIM (http://www.dkim.org/). InboundEncryptionRatio float64 `json:"inboundEncryptionRatio,omitempty"` // IpReputations: Reputation information pertaining to the IP addresses @@ -532,17 +539,17 @@ type TrafficStats struct { // SpammyFeedbackLoops: Spammy [Feedback loop identifiers] // (https://support.google.com/mail/answer/6254652) with their // individual spam rates. This metric only pertains to traffic that is - // authenticated by DKIM. + // authenticated by DKIM (http://www.dkim.org/). SpammyFeedbackLoops []*FeedbackLoop `json:"spammyFeedbackLoops,omitempty"` // SpfSuccessRatio: The ratio of mail that successfully authenticated - // with SPF vs. all mail that attempted to authenticate with SPF. - // Spoofed mail is excluded. + // with SPF vs. all mail that attempted to authenticate with SPF + // (http://www.openspf.org/). Spoofed mail is excluded. SpfSuccessRatio float64 `json:"spfSuccessRatio,omitempty"` // UserReportedSpamRatio: The ratio of user-report spam vs. email that // was sent to the inbox. This metric only pertains to emails - // authenticated by DKIM. + // authenticated by DKIM (http://www.dkim.org/). UserReportedSpamRatio float64 `json:"userReportedSpamRatio,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/google-api-go-generator/gen.go b/google-api-go-generator/gen.go index da6e96165ad..41b36d88e02 100644 --- a/google-api-go-generator/gen.go +++ b/google-api-go-generator/gen.go @@ -2644,7 +2644,7 @@ func addFieldValueComments(p func(format string, args ...interface{}), field Fie // markdownLinkRe is a non-greedy regex meant to find markdown style links. It // also captures the name of the link. -var markdownLinkRe = regexp.MustCompile("([^`]|\\A)(\\[([^\\[]*?)]\\(.*?\\))([^`]|\\z)") +var markdownLinkRe = regexp.MustCompile("([^`]|\\A)(\\[([^\\[]*?)]\\((.*?)\\))([^`]|\\z)") func removeMarkdownLinks(input string) string { out := input @@ -2653,7 +2653,7 @@ func removeMarkdownLinks(input string) string { return out } for _, match := range sm { - out = strings.Replace(out, match[2], match[3], 1) + out = strings.Replace(out, match[2], fmt.Sprintf("%s (%s)", match[3], match[4]), 1) } return out } diff --git a/google-api-go-generator/gen_test.go b/google-api-go-generator/gen_test.go index c581954d7dc..cd9f8d25ec3 100644 --- a/google-api-go-generator/gen_test.go +++ b/google-api-go-generator/gen_test.go @@ -249,17 +249,17 @@ func TestIt(t *testing.T) { input string want string }{ - {name: "basic", input: "[name](link)", want: "name"}, + {name: "basic", input: "[name](link)", want: "name (link)"}, {name: "no link", input: "name", want: "name"}, {name: "empty string", input: "", want: ""}, - {name: "sentence", input: "This [is](link) a test.", want: "This is a test."}, - {name: "two links", input: "This [is](link) a [test](link).", want: "This is a test."}, - {name: "first incomplete link", input: "This [is] a [test](link).", want: "This [is] a test."}, - {name: "second incomplete link", input: "This [is](link) a (test).", want: "This is a (test)."}, + {name: "sentence", input: "This [is](link) a test.", want: "This is (link) a test."}, + {name: "two links", input: "This [is](link) a [test](link).", want: "This is (link) a test (link)."}, + {name: "first incomplete link", input: "This [is] a [test](link).", want: "This [is] a test (link)."}, + {name: "second incomplete link", input: "This [is](link) a (test).", want: "This is (link) a (test)."}, {name: "seperated", input: "This [is] (a) test.", want: "This [is] (a) test."}, {name: "don't process code blocks", input: "This is `[a](link)` test.", want: "This is `[a](link)` test."}, - {name: "At start", input: "[This](link) is a test.", want: "This is a test."}, - {name: "At end ", input: "This is a [test.](link)", want: "This is a test."}, + {name: "At start", input: "[This](link) is a test.", want: "This (link) is a test."}, + {name: "At end ", input: "This is a [test.](link)", want: "This is a test. (link)"}, } for _, tc := range tests { t.Run(tc.name, func(t *testing.T) { diff --git a/healthcare/v1/healthcare-gen.go b/healthcare/v1/healthcare-gen.go index ed9aa75dd76..b7494233901 100644 --- a/healthcare/v1/healthcare-gen.go +++ b/healthcare/v1/healthcare-gen.go @@ -393,7 +393,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1197,13 +1198,16 @@ type FhirStore struct { DisableResourceVersioning bool `json:"disableResourceVersioning,omitempty"` // EnableUpdateCreate: Whether this FHIR store has the updateCreate - // capability. This determines if the client can use an Update operation - // to create a new resource with a client-specified ID. If false, all - // IDs are server-assigned through the Create operation and attempts to - // update a non-existent resource return errors. Be careful with the - // audit logs if client-specified resource IDs contain sensitive data - // such as patient identifiers, those IDs are part of the FHIR resource - // path recorded in Cloud audit logs and Cloud Pub/Sub notifications. + // capability + // (https://www.hl7.org/fhir/capabilitystatement-definitions.html#Capabil + // ityStatement.rest.resource.updateCreate). This determines if the + // client can use an Update operation to create a new resource with a + // client-specified ID. If false, all IDs are server-assigned through + // the Create operation and attempts to update a non-existent resource + // return errors. Be careful with the audit logs if client-specified + // resource IDs contain sensitive data such as patient identifiers, + // those IDs are part of the FHIR resource path recorded in Cloud audit + // logs and Cloud Pub/Sub notifications. EnableUpdateCreate bool `json:"enableUpdateCreate,omitempty"` // Labels: User-supplied key-value pairs used to organize FHIR stores. @@ -1234,10 +1238,12 @@ type FhirStore struct { // to the new location in addition to the existing ones. When a location // is removed from the list, the server stops streaming to that // location. Before adding a new config, you must add the required - // `bigquery.dataEditor` role to your project's **Cloud Healthcare - // Service Agent** service account. Some lag (typically on the order of - // dozens of seconds) is expected before the results show up in the - // streaming destination. + // `bigquery.dataEditor` + // (https://cloud.google.com/bigquery/docs/access-control#bigquery.dataEd + // itor) role to your project's **Cloud Healthcare Service Agent** + // service account (https://cloud.google.com/iam/docs/service-accounts). + // Some lag (typically on the order of dozens of seconds) is expected + // before the results show up in the streaming destination. StreamConfigs []*StreamConfig `json:"streamConfigs,omitempty"` // Version: Immutable. The FHIR specification version that this FHIR @@ -1602,21 +1608,23 @@ type Hl7V2NotificationConfig struct { // `labels."priority":*`. Filter string `json:"filter,omitempty"` - // PubsubTopic: The Cloud Pub/Sub topic that notifications of changes - // are published on. Supplied by the client. The notification is a - // `PubsubMessage` with the following fields: * `PubsubMessage.Data` + // PubsubTopic: The Cloud Pub/Sub + // (https://cloud.google.com/pubsub/docs/) topic that notifications of + // changes are published on. Supplied by the client. The notification is + // a `PubsubMessage` with the following fields: * `PubsubMessage.Data` // contains the resource name. * `PubsubMessage.MessageId` is the ID of // this notification. It's guaranteed to be unique within the topic. * // `PubsubMessage.PublishTime` is the time when the message was // published. Note that notifications are only sent if the topic is - // non-empty. Topic names must be scoped to a project. The Cloud - // Healthcare API service account, + // non-empty. Topic names + // (https://cloud.google.com/pubsub/docs/overview#names) must be scoped + // to a project. The Cloud Healthcare API service account, // service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com, // must have publisher permissions on the given Pub/Sub topic. Not // having adequate permissions causes the calls that send notifications // to fail. If a notification cannot be published to Cloud Pub/Sub, // errors are logged to Cloud Logging. For more information, see Viewing - // error logs in Cloud Logging). + // error logs in Cloud Logging (/healthcare/docs/how-tos/logging)). PubsubTopic string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "Filter") to @@ -2393,20 +2401,24 @@ func (s *Message) MarshalJSON() ([]byte, error) { // NotificationConfig: Specifies where to send notifications upon // changes to a data store. type NotificationConfig struct { - // PubsubTopic: The Cloud Pub/Sub topic that notifications of changes - // are published on. Supplied by the client. PubsubMessage.Data contains - // the resource name. PubsubMessage.MessageId is the ID of this message. - // It is guaranteed to be unique within the topic. + // PubsubTopic: The Cloud Pub/Sub + // (https://cloud.google.com/pubsub/docs/) topic that notifications of + // changes are published on. Supplied by the client. PubsubMessage.Data + // contains the resource name. PubsubMessage.MessageId is the ID of this + // message. It is guaranteed to be unique within the topic. // PubsubMessage.PublishTime is the time at which the message was // published. Notifications are only sent if the topic is non-empty. - // Topic names must be scoped to a project. Cloud Healthcare API service - // account must have publisher permissions on the given Cloud Pub/Sub - // topic. Not having adequate permissions causes the calls that send - // notifications to fail. If a notification can't be published to Cloud - // Pub/Sub, errors are logged to Cloud Logging (see Viewing logs). If - // the number of errors exceeds a certain rate, some aren't submitted. - // Note that not all operations trigger notifications, see Configuring - // Pub/Sub notifications for specific details. + // Topic names (https://cloud.google.com/pubsub/docs/overview#names) + // must be scoped to a project. Cloud Healthcare API service account + // must have publisher permissions on the given Cloud Pub/Sub topic. Not + // having adequate permissions causes the calls that send notifications + // to fail. If a notification can't be published to Cloud Pub/Sub, + // errors are logged to Cloud Logging (see Viewing logs + // (/healthcare/docs/how-tos/logging)). If the number of errors exceeds + // a certain rate, some aren't submitted. Note that not all operations + // trigger notifications, see Configuring Pub/Sub notifications + // (https://cloud.google.com/healthcare/docs/how-tos/pubsub) for + // specific details. PubsubTopic string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "PubsubTopic") to @@ -2515,7 +2527,8 @@ type OperationMetadata struct { EndTime string `json:"endTime,omitempty"` // LogsUrl: A link to audit and error logs in the log viewer. Error logs - // are generated only by some operations, listed at Viewing logs. + // are generated only by some operations, listed at Viewing logs + // (/healthcare/docs/how-tos/logging). LogsUrl string `json:"logsUrl,omitempty"` // ForceSendFields is a list of field names (e.g. "ApiMethodName") to @@ -2646,7 +2659,9 @@ func (s *PatientId) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2665,7 +2680,7 @@ func (s *PatientId) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2705,7 +2720,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2866,8 +2882,11 @@ func (s *SchemaConfig) MarshalJSON() ([]byte, error) { // specified FHIR store. type SearchResourcesRequest struct { // ResourceType: The FHIR resource type to search, such as Patient or - // Observation. For a complete list, see the FHIR Resource Index (DSTU2, - // STU3, R4). + // 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)). ResourceType string `json:"resourceType,omitempty"` // ForceSendFields is a list of field names (e.g. "ResourceType") to @@ -2977,10 +2996,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3049,7 +3069,8 @@ type StreamConfig struct { // and meta.versionId pair. Alternatively, the server created view // mentioned above also filters out duplicates. If a resource mutation // cannot be streamed to BigQuery, errors are logged to Cloud Logging. - // For more information, see Viewing error logs in Cloud Logging). + // For more information, see Viewing error logs in Cloud Logging + // (/healthcare/docs/how-tos/logging)). BigqueryDestination *GoogleCloudHealthcareV1FhirBigQueryDestination `json:"bigqueryDestination,omitempty"` // ResourceTypes: Supply a FHIR resource type (such as "Patient" or @@ -3119,7 +3140,8 @@ func (s *TagFilterList) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3729,7 +3751,8 @@ type ProjectsLocationsDatasetsDeidentifyCall struct { // instances. The new de-identified dataset will not contain these // failed resources. Failed resource totals are tracked in // Operation.metadata. Error details are also logged to Cloud Logging. -// For more information, see Viewing logs. +// For more information, see Viewing logs +// (/healthcare/docs/how-tos/logging). func (r *ProjectsLocationsDatasetsService) Deidentify(sourceDataset string, deidentifydatasetrequest *DeidentifyDatasetRequest) *ProjectsLocationsDatasetsDeidentifyCall { c := &ProjectsLocationsDatasetsDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceDataset = sourceDataset @@ -4161,7 +4184,8 @@ func (r *ProjectsLocationsDatasetsService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsDatasetsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -5102,7 +5126,8 @@ type ProjectsLocationsDatasetsDicomStoresDeidentifyCall struct { // result may still be successful if de-identification fails for some // DICOM instances. The output DICOM store will not contain these failed // resources. Failed resource totals are tracked in Operation.metadata. -// Error details are also logged to Cloud Logging (see Viewing logs). +// Error details are also logged to Cloud Logging (see Viewing logs +// (/healthcare/docs/how-tos/logging)). func (r *ProjectsLocationsDatasetsDicomStoresService) Deidentify(sourceStore string, deidentifydicomstorerequest *DeidentifyDicomStoreRequest) *ProjectsLocationsDatasetsDicomStoresDeidentifyCall { c := &ProjectsLocationsDatasetsDicomStoresDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceStore = sourceStore @@ -5375,8 +5400,8 @@ type ProjectsLocationsDatasetsDicomStoresExportCall struct { // Export: Exports data to the specified destination by copying it from // the DICOM store. Errors are also logged to Cloud Logging. For more -// information, see Viewing logs. The metadata field type is -// OperationMetadata. +// information, see Viewing logs (/healthcare/docs/how-tos/logging). The +// metadata field type is OperationMetadata. func (r *ProjectsLocationsDatasetsDicomStoresService) Export(name string, exportdicomdatarequest *ExportDicomDataRequest) *ProjectsLocationsDatasetsDicomStoresExportCall { c := &ProjectsLocationsDatasetsDicomStoresExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -5676,7 +5701,8 @@ func (r *ProjectsLocationsDatasetsDicomStoresService) GetIamPolicy(resource stri // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsDatasetsDicomStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsDicomStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -5827,8 +5853,8 @@ type ProjectsLocationsDatasetsDicomStoresImportCall struct { // Import: Imports data into the DICOM store by copying it from the // specified source. Errors are logged to Cloud Logging. For more -// information, see Viewing logs. The metadata field type is -// OperationMetadata. +// information, see Viewing logs (/healthcare/docs/how-tos/logging). The +// metadata field type is OperationMetadata. func (r *ProjectsLocationsDatasetsDicomStoresService) Import(name string, importdicomdatarequest *ImportDicomDataRequest) *ProjectsLocationsDatasetsDicomStoresImportCall { c := &ProjectsLocationsDatasetsDicomStoresImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6333,9 +6359,13 @@ type ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall struct { // instances. See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForInstances, -// see Search transaction in the Cloud Healthcare API conformance -// statement. For samples that show how to call SearchForInstances, see -// Searching for studies, series, instances, and frames. +// see Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForInstances, see Searching for studies, +// series, instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6461,9 +6491,13 @@ type ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall struct { // See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForSeries, see -// Search transaction in the Cloud Healthcare API conformance statement. -// For samples that show how to call SearchForSeries, see Searching for -// studies, series, instances, and frames. +// Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForSeries, see Searching for studies, series, +// instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6589,9 +6623,13 @@ type ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall struct { // studies. See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForStudies, see -// Search transaction in the Cloud Healthcare API conformance statement. -// For samples that show how to call SearchForStudies, see Searching for -// studies, series, instances, and frames. +// Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForStudies, see Searching for studies, series, +// instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForStudies(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6859,9 +6897,12 @@ type ProjectsLocationsDatasetsDicomStoresStoreInstancesCall struct { // study instance unique identifiers (SUID). See [Store Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.5). For details on the implementation of StoreInstances, see -// Store transaction in the Cloud Healthcare API conformance statement. -// For samples that show how to call StoreInstances, see Storing DICOM -// data. +// Store transaction +// (https://cloud.google.com/healthcare/docs/dicom#store_transaction) in +// the Cloud Healthcare API conformance statement. For samples that show +// how to call StoreInstances, see Storing DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dic +// om_data). func (r *ProjectsLocationsDatasetsDicomStoresService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7124,7 +7165,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesDeleteCall struct { // instances into a study while a delete operation is running for that // study could result in the new instances not appearing in search // results until the deletion operation finishes. For samples that show -// how to call DeleteStudy, see Deleting a study, series, or instance. +// how to call DeleteStudy, see Deleting a study, series, or instance +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_ +// study_series_or_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7270,9 +7313,12 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall struct { // removed. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of -// RetrieveStudyMetadata, see Metadata resources in the Cloud Healthcare -// API conformance statement. For samples that show how to call -// RetrieveStudyMetadata, see Retrieving metadata. +// RetrieveStudyMetadata, see Metadata resources +// (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveStudyMetadata, see Retrieving metadata +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7398,9 +7444,12 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall struct { // study. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of RetrieveStudy, see -// DICOM study/series/instances in the Cloud Healthcare API conformance -// statement. For samples that show how to call RetrieveStudy, see -// Retrieving DICOM data. +// DICOM study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta +// nces) in the Cloud Healthcare API conformance statement. For samples +// that show how to call RetrieveStudy, see Retrieving DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveStudy(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7526,9 +7575,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall struct { // instances. See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForInstances, -// see Search transaction in the Cloud Healthcare API conformance -// statement. For samples that show how to call SearchForInstances, see -// Searching for studies, series, instances, and frames. +// see Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForInstances, see Searching for studies, +// series, instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7654,9 +7707,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall struct { // See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForSeries, see -// Search transaction in the Cloud Healthcare API conformance statement. -// For samples that show how to call SearchForSeries, see Searching for -// studies, series, instances, and frames. +// Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForSeries, see Searching for studies, series, +// instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7782,9 +7839,12 @@ type ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall struct { // study instance unique identifiers (SUID). See [Store Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.5). For details on the implementation of StoreInstances, see -// Store transaction in the Cloud Healthcare API conformance statement. -// For samples that show how to call StoreInstances, see Storing DICOM -// data. +// Store transaction +// (https://cloud.google.com/healthcare/docs/dicom#store_transaction) in +// the Cloud Healthcare API conformance statement. For samples that show +// how to call StoreInstances, see Storing DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dic +// om_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7903,7 +7963,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesDeleteCall struct { // for that series could result in the new instances not appearing in // search results until the deletion operation finishes. For samples // that show how to call DeleteSeries, see Deleting a study, series, or -// instance. +// instance +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_ +// study_series_or_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8050,9 +8112,12 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall struc // data removed. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of -// RetrieveSeriesMetadata, see Metadata resources in the Cloud -// Healthcare API conformance statement. For samples that show how to -// call RetrieveSeriesMetadata, see Retrieving metadata. +// RetrieveSeriesMetadata, see Metadata resources +// (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveSeriesMetadata, see Retrieving metadata +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8178,9 +8243,12 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall struct // study and series. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of RetrieveSeries, see -// DICOM study/series/instances in the Cloud Healthcare API conformance -// statement. For samples that show how to call RetrieveSeries, see -// Retrieving DICOM data. +// DICOM study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta +// nces) in the Cloud Healthcare API conformance statement. For samples +// that show how to call RetrieveSeries, see Retrieving DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8306,9 +8374,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall str // instances. See [Search Transaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.6). For details on the implementation of SearchForInstances, -// see Search transaction in the Cloud Healthcare API conformance -// statement. For samples that show how to call SearchForInstances, see -// Searching for studies, series, instances, and frames. +// see Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForInstances, see Searching for studies, +// series, instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8434,7 +8506,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall struct // to the GET requests specified in the Retrieve transaction. Study and // series search results can take a few seconds to be updated after an // instance is deleted using DeleteInstance. For samples that show how -// to call DeleteInstance, see Deleting a study, series, or instance. +// to call DeleteInstance, see Deleting a study, series, or instance +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_ +// study_series_or_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8581,9 +8655,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceC // [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of RetrieveInstance, see -// DICOM study/series/instances and DICOM instances in the Cloud -// Healthcare API conformance statement. For samples that show how to -// call RetrieveInstance, see Retrieving an instance. +// DICOM study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta +// nces) and DICOM instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_instances) in +// the Cloud Healthcare API conformance statement. For samples that show +// how to call RetrieveInstance, see Retrieving an instance +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// an_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveInstance(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8711,9 +8790,12 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataC // [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of -// RetrieveInstanceMetadata, see Metadata resources in the Cloud -// Healthcare API conformance statement. For samples that show how to -// call RetrieveInstanceMetadata, see Retrieving metadata. +// RetrieveInstanceMetadata, see Metadata resources +// (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveInstanceMetadata, see Retrieving metadata +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8840,9 +8922,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedC // acceptable Rendered Media Type. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of -// RetrieveRenderedInstance, see Rendered resources in the Cloud -// Healthcare API conformance statement. For samples that show how to -// call RetrieveRenderedInstance, see Retrieving consumer image formats. +// RetrieveRenderedInstance, see Rendered resources +// (https://cloud.google.com/healthcare/docs/dicom#rendered_resources) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveRenderedInstance, see Retrieving consumer +// image formats +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// consumer_image_formats). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8969,9 +9055,12 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFra // [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4}. For details on the implementation of RetrieveFrames, see -// DICOM frames in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveFrames, see Retrieving DICOM -// data. +// DICOM frames +// (https://cloud.google.com/healthcare/docs/dicom#dicom_frames) in the +// Cloud Healthcare API conformance statement. For samples that show how +// to call RetrieveFrames, see Retrieving DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveFrames(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9098,9 +9187,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRen // an acceptable Rendered Media Type. See [RetrieveTransaction] // (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s // ect_10.4). For details on the implementation of -// RetrieveRenderedFrames, see Rendered resources in the Cloud -// Healthcare API conformance statement. For samples that show how to -// call RetrieveRenderedFrames, see Retrieving consumer image formats. +// RetrieveRenderedFrames, see Rendered resources +// (https://cloud.google.com/healthcare/docs/dicom#rendered_resources) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveRenderedFrames, see Retrieving consumer +// image formats +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// consumer_image_formats). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9378,7 +9471,8 @@ type ProjectsLocationsDatasetsFhirStoresDeidentifyCall struct { // the destination store. The metadata field type is OperationMetadata. // If the request is successful, the response field type is // DeidentifyFhirStoreSummary. If errors occur, error is set. Error -// details are also logged to Cloud Logging (see Viewing logs). +// details are also logged to Cloud Logging (see Viewing logs +// (/healthcare/docs/how-tos/logging)). func (r *ProjectsLocationsDatasetsFhirStoresService) Deidentify(sourceStore string, deidentifyfhirstorerequest *DeidentifyFhirStoreRequest) *ProjectsLocationsDatasetsFhirStoresDeidentifyCall { c := &ProjectsLocationsDatasetsFhirStoresDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceStore = sourceStore @@ -9653,10 +9747,10 @@ type ProjectsLocationsDatasetsFhirStoresExportCall struct { // destination. This method returns an Operation that can be used to // track the status of the export by calling GetOperation. Immediate // fatal errors appear in the error field, errors are also logged to -// Cloud Logging (see Viewing logs). Otherwise, when the operation -// finishes, a detailed response of type ExportResourcesResponse is -// returned in the response field. The metadata field type for this -// operation is OperationMetadata. +// Cloud Logging (see Viewing logs (/healthcare/docs/how-tos/logging)). +// Otherwise, when the operation finishes, a detailed response of type +// ExportResourcesResponse is returned in the response field. The +// metadata field type for this operation is OperationMetadata. func (r *ProjectsLocationsDatasetsFhirStoresService) Export(name string, exportresourcesrequest *ExportResourcesRequest) *ProjectsLocationsDatasetsFhirStoresExportCall { c := &ProjectsLocationsDatasetsFhirStoresExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9956,7 +10050,8 @@ func (r *ProjectsLocationsDatasetsFhirStoresService) GetIamPolicy(resource strin // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsDatasetsFhirStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsFhirStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -10155,10 +10250,11 @@ type ProjectsLocationsDatasetsFhirStoresImportCall struct { // by a FHIR search or Patient-everything operation. This method returns // an Operation that can be used to track the status of the import by // calling GetOperation. Immediate fatal errors appear in the error -// field, errors are also logged to Cloud Logging (see Viewing logs). -// Otherwise, when the operation finishes, a detailed response of type -// ImportResourcesResponse is returned in the response field. The -// metadata field type for this operation is OperationMetadata. +// field, errors are also logged to Cloud Logging (see Viewing logs +// (/healthcare/docs/how-tos/logging)). Otherwise, when the operation +// finishes, a detailed response of type ImportResourcesResponse is +// returned in the response field. The metadata field type for this +// operation is OperationMetadata. func (r *ProjectsLocationsDatasetsFhirStoresService) Import(name string, importresourcesrequest *ImportResourcesRequest) *ProjectsLocationsDatasetsFhirStoresImportCall { c := &ProjectsLocationsDatasetsFhirStoresImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -10947,21 +11043,31 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall struct { // PatientEverything: Retrieves a Patient resource and resources related // to that patient. Implements the FHIR extended operation -// Patient-everything (DSTU2, STU3, R4). On success, the response body -// will contain a JSON-encoded representation of a `Bundle` resource of -// type `searchset`, containing the results of the operation. Errors -// generated by the FHIR store will contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. The resources in scope -// for the response are: * The patient resource itself. * All the -// resources directly referenced by the patient resource. * Resources -// directly referencing the patient resource that meet the inclusion -// criteria. The inclusion criteria are based on the membership rules in -// the patient compartment definition (DSTU2, STU3, R4), which details -// the eligible resource types and referencing search parameters. For -// samples that show how to call `Patient-everything`, see Getting all -// patient compartment resources. +// Patient-everything (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/patient-operations.html +// #everything), STU3 +// (http://hl7.org/implement/standards/fhir/STU3/patient-operations.html# +// everything), R4 +// (http://hl7.org/implement/standards/fhir/R4/patient-operations.html#ev +// erything)). On success, the response body will contain a JSON-encoded +// representation of a `Bundle` resource of type `searchset`, containing +// the results of the operation. Errors generated by the FHIR store will +// contain a JSON-encoded `OperationOutcome` resource describing the +// reason for the error. If the request cannot be mapped to a valid API +// method on a FHIR store, a generic GCP error might be returned +// instead. The resources in scope for the response are: * The patient +// resource itself. * All the resources directly referenced by the +// patient resource. * Resources directly referencing the patient +// resource that meet the inclusion criteria. The inclusion criteria are +// based on the membership rules in the patient compartment definition +// (DSTU2 (http://hl7.org/fhir/DSTU2/compartment-patient.html), STU3 +// (http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html), R4 +// (http://hl7.org/fhir/R4/compartmentdefinition-patient.html)), which +// details the eligible resource types and referencing search +// parameters. For samples that show how to call `Patient-everything`, +// see Getting all patient compartment resources +// (/healthcare/docs/how-tos/fhir-resources#getting_all_patient_compartme +// nt_resources). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) PatientEverything(name string) *ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall { c := &ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11160,7 +11266,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall struct { // versions of a resource, first delete the current version and then // call this method. This is not a FHIR standard operation. For samples // that show how to call `Resource-purge`, see Deleting historical -// versions of a FHIR resource. +// versions of a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#deleting_historical_versions_ +// of_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ResourcePurge(name string) *ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall { c := &ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11291,13 +11399,22 @@ type ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall struct { header_ http.Header } -// Capabilities: Gets the FHIR capability statement (STU3, R4), or the -// conformance statement in the DSTU2 case for the store, which contains -// a description of functionality supported by the server. Implements -// the FHIR standard capabilities interaction (STU3, R4), or the -// conformance interaction in the DSTU2 case. On success, the response -// body will contain a JSON-encoded representation of a -// `CapabilityStatement` resource. +// Capabilities: Gets the FHIR capability statement (STU3 +// (http://hl7.org/implement/standards/fhir/STU3/capabilitystatement.html +// ), R4 +// (http://hl7.org/implement/standards/fhir/R4/capabilitystatement.html)) +// , or the conformance statement +// (http://hl7.org/implement/standards/fhir/DSTU2/conformance.html) in +// the DSTU2 case for the store, which contains a description of +// functionality supported by the server. Implements the FHIR standard +// capabilities interaction (STU3 +// (http://hl7.org/implement/standards/fhir/STU3/http.html#capabilities), +// R4 +// (http://hl7.org/implement/standards/fhir/R4/http.html#capabilities)), +// or the conformance interaction +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#conformance) +// in the DSTU2 case. On success, the response body will contain a +// JSON-encoded representation of a `CapabilityStatement` resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Capabilities(name string) *ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall { c := &ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11410,17 +11527,22 @@ type ProjectsLocationsDatasetsFhirStoresFhirCreateCall struct { } // Create: Creates a FHIR resource. Implements the FHIR standard create -// interaction (DSTU2, STU3, R4), which creates a new resource with a -// server-assigned resource ID. The request body must contain a -// JSON-encoded FHIR resource, and the request headers must contain -// `Content-Type: application/fhir+json`. On success, the response body -// will contain a JSON-encoded representation of the resource as it was -// created on the server, including the server-assigned resource ID and -// version ID. Errors generated by the FHIR store will contain a -// JSON-encoded `OperationOutcome` resource describing the reason for -// the error. If the request cannot be mapped to a valid API method on a -// FHIR store, a generic GCP error might be returned instead. For -// samples that show how to call `create`, see Creating a FHIR resource. +// interaction (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#create), +// STU3 (http://hl7.org/implement/standards/fhir/STU3/http.html#create), +// R4 (http://hl7.org/implement/standards/fhir/R4/http.html#create)), +// which creates a new resource with a server-assigned resource ID. The +// request body must contain a JSON-encoded FHIR resource, and the +// request headers must contain `Content-Type: application/fhir+json`. +// On success, the response body will contain a JSON-encoded +// representation of the resource as it was created on the server, +// including the server-assigned resource ID and version ID. Errors +// generated by the FHIR store will contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. For samples that show +// how to call `create`, see Creating a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#creating_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Create(parent string, type_ string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirCreateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11531,12 +11653,17 @@ type ProjectsLocationsDatasetsFhirStoresFhirDeleteCall struct { } // Delete: Deletes a FHIR resource. Implements the FHIR standard delete -// interaction (DSTU2, STU3, R4). Note: Unless resource versioning is -// disabled by setting the disable_resource_versioning flag on the FHIR -// store, the deleted resources will be moved to a history repository -// that can still be retrieved through vread and related methods, unless -// they are removed by the purge method. For samples that show how to -// call `delete`, see Deleting a FHIR resource. +// interaction (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#delete), +// STU3 (http://hl7.org/implement/standards/fhir/STU3/http.html#delete), +// R4 (http://hl7.org/implement/standards/fhir/R4/http.html#delete)). +// Note: Unless resource versioning is disabled by setting the +// disable_resource_versioning flag on the FHIR store, the deleted +// resources will be moved to a history repository that can still be +// retrieved through vread and related methods, unless they are removed +// by the purge method. For samples that show how to call `delete`, see +// Deleting a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#deleting_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Delete(name string) *ProjectsLocationsDatasetsFhirStoresFhirDeleteCall { c := &ProjectsLocationsDatasetsFhirStoresFhirDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11635,23 +11762,37 @@ type ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall struct { } // ExecuteBundle: Executes all the requests in the given Bundle. -// Implements the FHIR standard batch/transaction interaction (DSTU2, -// STU3, R4). Supports all interactions within a bundle, except search. -// This method accepts Bundles of type `batch` and `transaction`, -// processing them according to the batch processing rules (DSTU2, STU3, -// R4) and transaction processing rules (DSTU2, STU3, R4). The request -// body must contain a JSON-encoded FHIR `Bundle` resource, and the -// request headers must contain `Content-Type: application/fhir+json`. -// For a batch bundle or a successful transaction the response body will -// contain a JSON-encoded representation of a `Bundle` resource of type -// `batch-response` or `transaction-response` containing one entry for -// each entry in the request, with the outcome of processing the entry. -// In the case of an error for a transaction bundle, the response body -// will contain a JSON-encoded `OperationOutcome` resource describing -// the reason for the error. If the request cannot be mapped to a valid -// API method on a FHIR store, a generic GCP error might be returned -// instead. For samples that show how to call `executeBundle`, see -// Managing FHIR resources using FHIR bundles. +// Implements the FHIR standard batch/transaction interaction (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#transaction), +// STU3 +// (http://hl7.org/implement/standards/fhir/STU3/http.html#transaction), +// R4 +// (http://hl7.org/implement/standards/fhir/R4/http.html#transaction)). +// Supports all interactions within a bundle, except search. This method +// accepts Bundles of type `batch` and `transaction`, processing them +// according to the batch processing rules (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.1), +// STU3 +// (http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.1), +// R4 (http://hl7.org/implement/standards/fhir/R4/http.html#brules)) and +// transaction processing rules (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.2), +// STU3 +// (http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.2), +// R4 (http://hl7.org/implement/standards/fhir/R4/http.html#trules)). +// The request body must contain a JSON-encoded FHIR `Bundle` resource, +// and the request headers must contain `Content-Type: +// application/fhir+json`. For a batch bundle or a successful +// transaction the response body will contain a JSON-encoded +// representation of a `Bundle` resource of type `batch-response` or +// `transaction-response` containing one entry for each entry in the +// request, with the outcome of processing the entry. In the case of an +// error for a transaction bundle, the response body will contain a +// JSON-encoded `OperationOutcome` resource describing the reason for +// the error. If the request cannot be mapped to a valid API method on a +// FHIR store, a generic GCP error might be returned instead. For +// samples that show how to call `executeBundle`, see Managing FHIR +// resources using FHIR bundles (/healthcare/docs/how-tos/fhir-bundles). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ExecuteBundle(parent string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall { c := &ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11754,15 +11895,21 @@ type ProjectsLocationsDatasetsFhirStoresFhirHistoryCall struct { // History: Lists all the versions of a resource (including the current // version and deleted versions) from the FHIR store. Implements the -// per-resource form of the FHIR standard history interaction (DSTU2, -// STU3, R4). On success, the response body will contain a JSON-encoded -// representation of a `Bundle` resource of type `history`, containing -// the version history sorted from most recent to oldest versions. -// Errors generated by the FHIR store will contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. For samples that show -// how to call `history`, see Listing FHIR resource versions. +// per-resource form of the FHIR standard history interaction (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#history), +// STU3 +// (http://hl7.org/implement/standards/fhir/STU3/http.html#history), R4 +// (http://hl7.org/implement/standards/fhir/R4/http.html#history)). On +// success, the response body will contain a JSON-encoded representation +// of a `Bundle` resource of type `history`, containing the version +// history sorted from most recent to oldest versions. Errors generated +// by the FHIR store will contain a JSON-encoded `OperationOutcome` +// resource describing the reason for the error. If the request cannot +// be mapped to a valid API method on a FHIR store, a generic GCP error +// might be returned instead. For samples that show how to call +// `history`, see Listing FHIR resource versions +// (/healthcare/docs/how-tos/fhir-resources#listing_fhir_resource_version +// s). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) History(name string) *ProjectsLocationsDatasetsFhirStoresFhirHistoryCall { c := &ProjectsLocationsDatasetsFhirStoresFhirHistoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11937,18 +12084,22 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatchCall struct { } // Patch: Updates part of an existing resource by applying the -// operations specified in a JSON Patch document. Implements the FHIR -// standard patch interaction (STU3, R4). DSTU2 doesn't define a patch -// method, but the server supports it in the same way it supports STU3. -// The request body must contain a JSON Patch document, and the request -// headers must contain `Content-Type: application/json-patch+json`. On -// success, the response body will contain a JSON-encoded representation -// of the updated resource, including the server-assigned version ID. -// Errors generated by the FHIR store will contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. For samples that show -// how to call `patch`, see Patching a FHIR resource. +// operations specified in a JSON Patch (http://jsonpatch.com/) +// document. Implements the FHIR standard patch interaction (STU3 +// (http://hl7.org/implement/standards/fhir/STU3/http.html#patch), R4 +// (http://hl7.org/implement/standards/fhir/R4/http.html#patch)). DSTU2 +// doesn't define a patch method, but the server supports it in the same +// way it supports STU3. The request body must contain a JSON Patch +// document, and the request headers must contain `Content-Type: +// application/json-patch+json`. On success, the response body will +// contain a JSON-encoded representation of the updated resource, +// including the server-assigned version ID. Errors generated by the +// FHIR store will contain a JSON-encoded `OperationOutcome` resource +// describing the reason for the error. If the request cannot be mapped +// to a valid API method on a FHIR store, a generic GCP error might be +// returned instead. For samples that show how to call `patch`, see +// Patching a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#patching_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Patch(name string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirPatchCall { c := &ProjectsLocationsDatasetsFhirStoresFhirPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12050,16 +12201,23 @@ type ProjectsLocationsDatasetsFhirStoresFhirReadCall struct { } // Read: Gets the contents of a FHIR resource. Implements the FHIR -// standard read interaction (DSTU2, STU3, R4). Also supports the FHIR -// standard conditional read interaction (DSTU2, STU3, R4) specified by -// supplying an `If-Modified-Since` header with a date/time value or an -// `If-None-Match` header with an ETag value. On success, the response -// body will contain a JSON-encoded representation of the resource. -// Errors generated by the FHIR store will contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. For samples that show -// how to call `read`, see Getting a FHIR resource. +// standard read interaction (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#read), STU3 +// (http://hl7.org/implement/standards/fhir/STU3/http.html#read), R4 +// (http://hl7.org/implement/standards/fhir/R4/http.html#read)). Also +// supports the FHIR standard conditional read interaction (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#cread), STU3 +// (http://hl7.org/implement/standards/fhir/STU3/http.html#cread), R4 +// (http://hl7.org/implement/standards/fhir/R4/http.html#cread)) +// specified by supplying an `If-Modified-Since` header with a date/time +// value or an `If-None-Match` header with an ETag value. On success, +// the response body will contain a JSON-encoded representation of the +// resource. Errors generated by the FHIR store will contain a +// JSON-encoded `OperationOutcome` resource describing the reason for +// the error. If the request cannot be mapped to a valid API method on a +// FHIR store, a generic GCP error might be returned instead. For +// samples that show how to call `read`, see Getting a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#getting_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Read(name string) *ProjectsLocationsDatasetsFhirStoresFhirReadCall { c := &ProjectsLocationsDatasetsFhirStoresFhirReadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12172,9 +12330,15 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // Search: Searches for resources in the given FHIR store according to // criteria specified as query parameters. Implements the FHIR standard -// search interaction (DSTU2, STU3, R4) using the search semantics -// described in the FHIR Search specification (DSTU2, STU3, R4). -// Supports three methods of search defined by the specification: * `GET +// search interaction (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#search), +// STU3 (http://hl7.org/implement/standards/fhir/STU3/http.html#search), +// R4 (http://hl7.org/implement/standards/fhir/R4/http.html#search)) +// using the search semantics described in the FHIR Search specification +// (DSTU2 (http://hl7.org/implement/standards/fhir/DSTU2/search.html), +// STU3 (http://hl7.org/implement/standards/fhir/STU3/search.html), R4 +// (http://hl7.org/implement/standards/fhir/R4/search.html)). Supports +// three methods of search defined by the specification: * `GET // [base]?[parameters]` to search across all resources. * `GET // [base]/[type]?[parameters]` to search resources of a specified type. // * `POST [base]/[type]/_search?[parameters]` as an alternate form @@ -12190,23 +12354,28 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // server's capability statement, retrieved through capabilities, // indicates what search parameters are supported on each FHIR resource. // A list of all search parameters defined by the specification can be -// found in the FHIR Search Parameter Registry (STU3, R4). FHIR search -// parameters for DSTU2 can be found on each resource's definition page. -// Supported search modifiers: `:missing`, `:exact`, `:contains`, -// `:text`, `:in`, `:not-in`, `:above`, `:below`, `:[type]`, `:not`, and -// `:recurse`. Supported search result parameters: `_sort`, `_count`, -// `_include`, `_revinclude`, `_summary=text`, `_summary=data`, and -// `_elements`. The maximum number of search results returned defaults -// to 100, which can be overridden by the `_count` parameter up to a -// maximum limit of 1000. If there are additional results, the returned -// `Bundle` will contain pagination links. Resources with a total size -// larger than 5MB or a field count larger than 50,000 might not be -// fully searchable as the server might trim its generated search index -// in those cases. Note: FHIR resources are indexed asynchronously, so -// there might be a slight delay between the time a resource is created -// or changes and when the change is reflected in search results. For -// samples and detailed information, see Searching for FHIR resources -// and Advanced FHIR search features. +// found in the FHIR Search Parameter Registry (STU3 +// (http://hl7.org/implement/standards/fhir/STU3/searchparameter-registry +// .html), R4 +// (http://hl7.org/implement/standards/fhir/R4/searchparameter-registry.h +// tml)). FHIR search parameters for DSTU2 can be found on each +// resource's definition page. Supported search modifiers: `:missing`, +// `:exact`, `:contains`, `:text`, `:in`, `:not-in`, `:above`, `:below`, +// `:[type]`, `:not`, and `:recurse`. Supported search result +// parameters: `_sort`, `_count`, `_include`, `_revinclude`, +// `_summary=text`, `_summary=data`, and `_elements`. The maximum number +// of search results returned defaults to 100, which can be overridden +// by the `_count` parameter up to a maximum limit of 1000. If there are +// additional results, the returned `Bundle` will contain pagination +// links. Resources with a total size larger than 5MB or a field count +// larger than 50,000 might not be fully searchable as the server might +// trim its generated search index in those cases. Note: FHIR resources +// are indexed asynchronously, so there might be a slight delay between +// the time a resource is created or changes and when the change is +// reflected in search results. For samples and detailed information, +// see Searching for FHIR resources +// (/healthcare/docs/how-tos/fhir-search) and Advanced FHIR search +// features (/healthcare/docs/how-tos/fhir-advanced-search). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Search(parent string, searchresourcesrequest *SearchResourcesRequest) *ProjectsLocationsDatasetsFhirStoresFhirSearchCall { c := &ProjectsLocationsDatasetsFhirStoresFhirSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12314,20 +12483,24 @@ type ProjectsLocationsDatasetsFhirStoresFhirUpdateCall struct { } // Update: Updates the entire contents of a resource. Implements the -// FHIR standard update interaction (DSTU2, STU3, R4). If the specified -// resource does not exist and the FHIR store has enable_update_create -// set, creates the resource with the client-specified ID. The request -// body must contain a JSON-encoded FHIR resource, and the request -// headers must contain `Content-Type: application/fhir+json`. The -// resource must contain an `id` element having an identical value to -// the ID in the REST path of the request. On success, the response body -// will contain a JSON-encoded representation of the updated resource, -// including the server-assigned version ID. Errors generated by the -// FHIR store will contain a JSON-encoded `OperationOutcome` resource -// describing the reason for the error. If the request cannot be mapped -// to a valid API method on a FHIR store, a generic GCP error might be -// returned instead. For samples that show how to call `update`, see -// Updating a FHIR resource. +// FHIR standard update interaction (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#update), +// STU3 (http://hl7.org/implement/standards/fhir/STU3/http.html#update), +// R4 (http://hl7.org/implement/standards/fhir/R4/http.html#update)). If +// the specified resource does not exist and the FHIR store has +// enable_update_create set, creates the resource with the +// client-specified ID. The request body must contain a JSON-encoded +// FHIR resource, and the request headers must contain `Content-Type: +// application/fhir+json`. The resource must contain an `id` element +// having an identical value to the ID in the REST path of the request. +// On success, the response body will contain a JSON-encoded +// representation of the updated resource, including the server-assigned +// version ID. Errors generated by the FHIR store will contain a +// JSON-encoded `OperationOutcome` resource describing the reason for +// the error. If the request cannot be mapped to a valid API method on a +// FHIR store, a generic GCP error might be returned instead. For +// samples that show how to call `update`, see Updating a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#updating_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Update(name string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirUpdateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12430,13 +12603,19 @@ type ProjectsLocationsDatasetsFhirStoresFhirVreadCall struct { // Vread: Gets the contents of a version (current or historical) of a // FHIR resource by version ID. Implements the FHIR standard vread -// interaction (DSTU2, STU3, R4). On success, the response body will -// contain a JSON-encoded representation of the resource. Errors -// generated by the FHIR store will contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. For samples that show -// how to call `vread`, see Retrieving a FHIR resource version. +// interaction (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/http.html#vread), STU3 +// (http://hl7.org/implement/standards/fhir/STU3/http.html#vread), R4 +// (http://hl7.org/implement/standards/fhir/R4/http.html#vread)). On +// success, the response body will contain a JSON-encoded representation +// of the resource. Errors generated by the FHIR store will contain a +// JSON-encoded `OperationOutcome` resource describing the reason for +// the error. If the request cannot be mapped to a valid API method on a +// FHIR store, a generic GCP error might be returned instead. For +// samples that show how to call `vread`, see Retrieving a FHIR resource +// version +// (/healthcare/docs/how-tos/fhir-resources#retrieving_a_fhir_resource_ve +// rsion). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Vread(name string) *ProjectsLocationsDatasetsFhirStoresFhirVreadCall { c := &ProjectsLocationsDatasetsFhirStoresFhirVreadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12991,7 +13170,8 @@ func (r *ProjectsLocationsDatasetsHl7V2StoresService) GetIamPolicy(resource stri // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsDatasetsHl7V2StoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsHl7V2StoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/healthcare/v1beta1/healthcare-gen.go b/healthcare/v1beta1/healthcare-gen.go index ca100127afb..e4186e46756 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -910,7 +910,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -2680,13 +2681,16 @@ type FhirStore struct { DisableResourceVersioning bool `json:"disableResourceVersioning,omitempty"` // EnableUpdateCreate: Whether this FHIR store has the updateCreate - // capability. This determines if the client can use an Update operation - // to create a new resource with a client-specified ID. If false, all - // IDs are server-assigned through the Create operation and attempts to - // update a non-existent resource return errors. Be careful with the - // audit logs if client-specified resource IDs contain sensitive data - // such as patient identifiers, those IDs are part of the FHIR resource - // path recorded in Cloud audit logs and Cloud Pub/Sub notifications. + // capability + // (https://www.hl7.org/fhir/capabilitystatement-definitions.html#Capabil + // ityStatement.rest.resource.updateCreate). This determines if the + // client can use an Update operation to create a new resource with a + // client-specified ID. If false, all IDs are server-assigned through + // the Create operation and attempts to update a non-existent resource + // return errors. Be careful with the audit logs if client-specified + // resource IDs contain sensitive data such as patient identifiers, + // those IDs are part of the FHIR resource path recorded in Cloud audit + // logs and Cloud Pub/Sub notifications. EnableUpdateCreate bool `json:"enableUpdateCreate,omitempty"` // Labels: User-supplied key-value pairs used to organize FHIR stores. @@ -2717,10 +2721,12 @@ type FhirStore struct { // to the new location in addition to the existing ones. When a location // is removed from the list, the server stops streaming to that // location. Before adding a new config, you must add the required - // `bigquery.dataEditor` role to your project's **Cloud Healthcare - // Service Agent** service account. Some lag (typically on the order of - // dozens of seconds) is expected before the results show up in the - // streaming destination. + // `bigquery.dataEditor` + // (https://cloud.google.com/bigquery/docs/access-control#bigquery.dataEd + // itor) role to your project's **Cloud Healthcare Service Agent** + // service account (https://cloud.google.com/iam/docs/service-accounts). + // Some lag (typically on the order of dozens of seconds) is expected + // before the results show up in the streaming destination. StreamConfigs []*StreamConfig `json:"streamConfigs,omitempty"` // Version: Immutable. The FHIR specification version that this FHIR @@ -3427,7 +3433,8 @@ type GoogleCloudHealthcareV1beta1DicomStreamConfig struct { // limit on streaming insert row size, therefore any instance that // generates more than 1 MB of BigQuery data will not be streamed. If an // instance cannot be streamed to BigQuery, errors will be logged to - // Cloud Logging (see Viewing logs). + // Cloud Logging (see Viewing logs (/healthcare/docs/how- [Viewing + // logs](/healthcare/docs/how-tos/logging)). BigqueryDestination *GoogleCloudHealthcareV1beta1DicomBigQueryDestination `json:"bigqueryDestination,omitempty"` // ForceSendFields is a list of field names (e.g. "BigqueryDestination") @@ -3867,19 +3874,22 @@ type Hl7V2NotificationConfig struct { // `labels."priority":*`. Filter string `json:"filter,omitempty"` - // PubsubTopic: The Cloud Pub/Sub topic that notifications of changes - // are published on. Supplied by the client. The notification is a - // `PubsubMessage` with the following fields: * `PubsubMessage.Data` + // PubsubTopic: The Cloud Pub/Sub + // (https://cloud.google.com/pubsub/docs/) topic that notifications of + // changes are published on. Supplied by the client. The notification is + // a `PubsubMessage` with the following fields: * `PubsubMessage.Data` // contains the resource name. * `PubsubMessage.MessageId` is the ID of // this notification. It is guaranteed to be unique within the topic. * // `PubsubMessage.PublishTime` is the time when the message was // published. Note that notifications are only sent if the topic is - // non-empty. Topic names must be scoped to a project. Cloud Healthcare - // API service account must have publisher permissions on the given - // Pub/Sub topic. Not having adequate permissions causes the calls that - // send notifications to fail. If a notification can't be published to - // Cloud Pub/Sub, errors are logged to Cloud Logging. For more - // information, see Viewing error logs in Cloud Logging. + // non-empty. Topic names + // (https://cloud.google.com/pubsub/docs/overview#names) must be scoped + // to a project. Cloud Healthcare API service account must have + // publisher permissions on the given Pub/Sub topic. Not having adequate + // permissions causes the calls that send notifications to fail. If a + // notification can't be published to Cloud Pub/Sub, errors are logged + // to Cloud Logging. For more information, see Viewing error logs in + // Cloud Logging (/healthcare/docs/how-tos/logging). PubsubTopic string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "Filter") to @@ -5203,20 +5213,24 @@ func (s *Message) MarshalJSON() ([]byte, error) { // NotificationConfig: Specifies where to send notifications upon // changes to a data store. type NotificationConfig struct { - // PubsubTopic: The Cloud Pub/Sub topic that notifications of changes - // are published on. Supplied by the client. PubsubMessage.Data contains - // the resource name. PubsubMessage.MessageId is the ID of this message. - // It is guaranteed to be unique within the topic. + // PubsubTopic: The Cloud Pub/Sub + // (https://cloud.google.com/pubsub/docs/) topic that notifications of + // changes are published on. Supplied by the client. PubsubMessage.Data + // contains the resource name. PubsubMessage.MessageId is the ID of this + // message. It is guaranteed to be unique within the topic. // PubsubMessage.PublishTime is the time at which the message was // published. Notifications are only sent if the topic is non-empty. - // Topic names must be scoped to a project. Cloud Healthcare API service - // account must have publisher permissions on the given Cloud Pub/Sub - // topic. Not having adequate permissions causes the calls that send - // notifications to fail. If a notification can't be published to Cloud - // Pub/Sub, errors are logged to Cloud Logging (see Viewing logs). If - // the number of errors exceeds a certain rate, some aren't submitted. - // Note that not all operations trigger notifications, see Configuring - // Pub/Sub notifications for specific details. + // Topic names (https://cloud.google.com/pubsub/docs/overview#names) + // must be scoped to a project. Cloud Healthcare API service account + // must have publisher permissions on the given Cloud Pub/Sub topic. Not + // having adequate permissions causes the calls that send notifications + // to fail. If a notification can't be published to Cloud Pub/Sub, + // errors are logged to Cloud Logging (see Viewing logs + // (/healthcare/docs/how-tos/logging)). If the number of errors exceeds + // a certain rate, some aren't submitted. Note that not all operations + // trigger notifications, see Configuring Pub/Sub notifications + // (https://cloud.google.com/healthcare/docs/how-tos/pubsub) for + // specific details. PubsubTopic string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "PubsubTopic") to @@ -5325,7 +5339,8 @@ type OperationMetadata struct { EndTime string `json:"endTime,omitempty"` // LogsUrl: A link to audit and error logs in the log viewer. Error logs - // are generated only by some operations, listed at Viewing logs. + // are generated only by some operations, listed at Viewing logs + // (/healthcare/docs/how-tos/logging). LogsUrl string `json:"logsUrl,omitempty"` // ForceSendFields is a list of field names (e.g. "ApiMethodName") to @@ -5476,7 +5491,9 @@ func (s *PatientId) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -5495,7 +5512,7 @@ func (s *PatientId) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -5535,7 +5552,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -6066,8 +6084,11 @@ func (s *SchematizedData) MarshalJSON() ([]byte, error) { // specified FHIR store. type SearchResourcesRequest struct { // ResourceType: The FHIR resource type to search, such as Patient or - // Observation. For a complete list, see the FHIR Resource Index (DSTU2, - // STU3, R4). + // 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)). ResourceType string `json:"resourceType,omitempty"` // ForceSendFields is a list of field names (e.g. "ResourceType") to @@ -6246,10 +6267,11 @@ func (s *Signature) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -6318,7 +6340,8 @@ type StreamConfig struct { // and meta.versionId pair. Alternatively, the server created view // mentioned above also filters out duplicates. If a resource mutation // cannot be streamed to BigQuery, errors will be logged to Cloud - // Logging (see Viewing error logs in Cloud Logging). + // Logging (see Viewing error logs in Cloud Logging + // (/healthcare/docs/how-tos/logging)). BigqueryDestination *GoogleCloudHealthcareV1beta1FhirBigQueryDestination `json:"bigqueryDestination,omitempty"` // ResourceTypes: Supply a FHIR resource type (such as "Patient" or @@ -6388,7 +6411,8 @@ func (s *TagFilterList) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -7213,7 +7237,8 @@ type ProjectsLocationsDatasetsDeidentifyCall struct { // de-identification fails for some resources. The new de-identified // dataset will not contain these failed resources. The number of // resources processed are tracked in Operation.metadata. Error details -// are logged to Cloud Logging. For more information, see Viewing logs. +// are logged to Cloud Logging. For more information, see Viewing logs +// (/healthcare/docs/how-tos/logging). func (r *ProjectsLocationsDatasetsService) Deidentify(sourceDataset string, deidentifydatasetrequest *DeidentifyDatasetRequest) *ProjectsLocationsDatasetsDeidentifyCall { c := &ProjectsLocationsDatasetsDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceDataset = sourceDataset @@ -7645,7 +7670,8 @@ func (r *ProjectsLocationsDatasetsService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsDatasetsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -8715,7 +8741,7 @@ type ProjectsLocationsDatasetsAnnotationStoresEvaluateCall struct { // detailed response is returned of type // EvaluateAnnotationStoreResponse, contained in the response. The // metadata field type is OperationMetadata. Errors are logged to Cloud -// Logging (see Viewing logs). +// Logging (see Viewing logs (/healthcare/docs/how-tos/logging)). func (r *ProjectsLocationsDatasetsAnnotationStoresService) Evaluate(name string, evaluateannotationstorerequest *EvaluateAnnotationStoreRequest) *ProjectsLocationsDatasetsAnnotationStoresEvaluateCall { c := &ProjectsLocationsDatasetsAnnotationStoresEvaluateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8859,7 +8885,8 @@ type ProjectsLocationsDatasetsAnnotationStoresExportCall struct { // is successful, a detailed response is returned of type // ExportAnnotationsResponse, contained in the response field when the // operation finishes. The metadata field type is OperationMetadata. -// Errors are logged to Cloud Logging (see Viewing logs). +// Errors are logged to Cloud Logging (see Viewing logs +// (/healthcare/docs/how-tos/logging)). func (r *ProjectsLocationsDatasetsAnnotationStoresService) Export(name string, exportannotationsrequest *ExportAnnotationsRequest) *ProjectsLocationsDatasetsAnnotationStoresExportCall { c := &ProjectsLocationsDatasetsAnnotationStoresExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9160,7 +9187,8 @@ func (r *ProjectsLocationsDatasetsAnnotationStoresService) GetIamPolicy(resource // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsDatasetsAnnotationStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsAnnotationStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -9314,7 +9342,7 @@ type ProjectsLocationsDatasetsAnnotationStoresImportCall struct { // response is returned as of type ImportAnnotationsResponse, contained // in the response field when the operation finishes. The metadata field // type is OperationMetadata. Errors are logged to Cloud Logging (see -// Viewing logs). +// Viewing logs (/healthcare/docs/how-tos/logging)). func (r *ProjectsLocationsDatasetsAnnotationStoresService) Import(name string, importannotationsrequest *ImportAnnotationsRequest) *ProjectsLocationsDatasetsAnnotationStoresImportCall { c := &ProjectsLocationsDatasetsAnnotationStoresImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11666,7 +11694,8 @@ func (r *ProjectsLocationsDatasetsConsentStoresService) GetIamPolicy(resource st // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsDatasetsConsentStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsConsentStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -16670,7 +16699,8 @@ type ProjectsLocationsDatasetsDicomStoresDeidentifyCall struct { // if de-identification fails for some DICOM instances. The output DICOM // store will not contain these failed resources. The number of // resources processed are tracked in Operation.metadata. Error details -// are logged to Cloud Logging. For more information, see Viewing logs. +// are logged to Cloud Logging. For more information, see Viewing logs +// (/healthcare/docs/how-tos/logging). func (r *ProjectsLocationsDatasetsDicomStoresService) Deidentify(sourceStore string, deidentifydicomstorerequest *DeidentifyDicomStoreRequest) *ProjectsLocationsDatasetsDicomStoresDeidentifyCall { c := &ProjectsLocationsDatasetsDicomStoresDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceStore = sourceStore @@ -16943,8 +16973,8 @@ type ProjectsLocationsDatasetsDicomStoresExportCall struct { // Export: Exports data to the specified destination by copying it from // the DICOM store. Errors are also logged to Cloud Logging. For more -// information, see Viewing logs. The metadata field type is -// OperationMetadata. +// information, see Viewing logs (/healthcare/docs/how-tos/logging). The +// metadata field type is OperationMetadata. func (r *ProjectsLocationsDatasetsDicomStoresService) Export(name string, exportdicomdatarequest *ExportDicomDataRequest) *ProjectsLocationsDatasetsDicomStoresExportCall { c := &ProjectsLocationsDatasetsDicomStoresExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -17244,7 +17274,8 @@ func (r *ProjectsLocationsDatasetsDicomStoresService) GetIamPolicy(resource stri // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsDatasetsDicomStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsDicomStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -17395,8 +17426,8 @@ type ProjectsLocationsDatasetsDicomStoresImportCall struct { // Import: Imports data into the DICOM store by copying it from the // specified source. Errors are logged to Cloud Logging. For more -// information, see Viewing logs. The metadata field type is -// OperationMetadata. +// information, see Viewing logs (/healthcare/docs/how-tos/logging). The +// metadata field type is OperationMetadata. func (r *ProjectsLocationsDatasetsDicomStoresService) Import(name string, importdicomdatarequest *ImportDicomDataRequest) *ProjectsLocationsDatasetsDicomStoresImportCall { c := &ProjectsLocationsDatasetsDicomStoresImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -17898,11 +17929,16 @@ type ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall struct { } // SearchForInstances: SearchForInstances returns a list of matching -// instances. See RetrieveTransaction. For details on the implementation -// of SearchForInstances, see Search transaction in the Cloud Healthcare -// API conformance statement. For samples that show how to call -// SearchForInstances, see Searching for studies, series, instances, and -// frames. +// instances. See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of SearchForInstances, +// see Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForInstances, see Searching for studies, +// series, instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18025,11 +18061,16 @@ type ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall struct { } // SearchForSeries: SearchForSeries returns a list of matching series. -// See RetrieveTransaction. For details on the implementation of -// SearchForSeries, see Search transaction in the Cloud Healthcare API -// conformance statement. For samples that show how to call -// SearchForSeries, see Searching for studies, series, instances, and -// frames. +// See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of SearchForSeries, see +// Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForSeries, see Searching for studies, series, +// instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18152,11 +18193,16 @@ type ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall struct { } // SearchForStudies: SearchForStudies returns a list of matching -// studies. See RetrieveTransaction. For details on the implementation -// of SearchForStudies, see Search transaction in the Cloud Healthcare -// API conformance statement. For samples that show how to call -// SearchForStudies, see Searching for studies, series, instances, and -// frames. +// studies. See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of SearchForStudies, see +// Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForStudies, see Searching for studies, series, +// instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForStudies(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18421,10 +18467,15 @@ type ProjectsLocationsDatasetsDicomStoresStoreInstancesCall struct { } // StoreInstances: StoreInstances stores DICOM instances associated with -// study instance unique identifiers (SUID). See Store Transaction. For -// details on the implementation of StoreInstances, see Store -// transaction in the Cloud Healthcare API conformance statement. For -// samples that show how to call StoreInstances, see Storing DICOM data. +// study instance unique identifiers (SUID). See Store Transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.5). For details on the implementation of StoreInstances, see +// Store transaction +// (https://cloud.google.com/healthcare/docs/dicom#store_transaction) in +// the Cloud Healthcare API conformance statement. For samples that show +// how to call StoreInstances, see Storing DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dic +// om_data). func (r *ProjectsLocationsDatasetsDicomStoresService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18828,10 +18879,15 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall struct { // RetrieveMetadata: RetrieveStudyMetadata returns instance associated // with the given study presented as metadata with the bulk data -// removed. See RetrieveTransaction. For details on the implementation -// of RetrieveStudyMetadata, see Metadata resources in the Cloud -// Healthcare API conformance statement. For samples that show how to -// call RetrieveStudyMetadata, see Retrieving metadata. +// removed. See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of +// RetrieveStudyMetadata, see Metadata resources +// (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveStudyMetadata, see Retrieving metadata +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18954,10 +19010,15 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall struct { } // RetrieveStudy: RetrieveStudy returns all instances within the given -// study. See RetrieveTransaction. For details on the implementation of -// RetrieveStudy, see DICOM study/series/instances in the Cloud -// Healthcare API conformance statement. For samples that show how to -// call RetrieveStudy, see Retrieving DICOM data. +// study. See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of RetrieveStudy, see +// DICOM study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta +// nces) in the Cloud Healthcare API conformance statement. For samples +// that show how to call RetrieveStudy, see Retrieving DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveStudy(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19080,11 +19141,16 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall struct { } // SearchForInstances: SearchForInstances returns a list of matching -// instances. See RetrieveTransaction. For details on the implementation -// of SearchForInstances, see Search transaction in the Cloud Healthcare -// API conformance statement. For samples that show how to call -// SearchForInstances, see Searching for studies, series, instances, and -// frames. +// instances. See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of SearchForInstances, +// see Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForInstances, see Searching for studies, +// series, instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19207,11 +19273,16 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall struct { } // SearchForSeries: SearchForSeries returns a list of matching series. -// See RetrieveTransaction. For details on the implementation of -// SearchForSeries, see Search transaction in the Cloud Healthcare API -// conformance statement. For samples that show how to call -// SearchForSeries, see Searching for studies, series, instances, and -// frames. +// See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of SearchForSeries, see +// Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForSeries, see Searching for studies, series, +// instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19334,10 +19405,15 @@ type ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall struct { } // StoreInstances: StoreInstances stores DICOM instances associated with -// study instance unique identifiers (SUID). See Store Transaction. For -// details on the implementation of StoreInstances, see Store -// transaction in the Cloud Healthcare API conformance statement. For -// samples that show how to call StoreInstances, see Storing DICOM data. +// study instance unique identifiers (SUID). See Store Transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.5). For details on the implementation of StoreInstances, see +// Store transaction +// (https://cloud.google.com/healthcare/docs/dicom#store_transaction) in +// the Cloud Healthcare API conformance statement. For samples that show +// how to call StoreInstances, see Storing DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dic +// om_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19598,10 +19674,15 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall struc // RetrieveMetadata: RetrieveSeriesMetadata returns instance associated // with the given study and series, presented as metadata with the bulk -// data removed. See RetrieveTransaction. For details on the -// implementation of RetrieveSeriesMetadata, see Metadata resources in -// the Cloud Healthcare API conformance statement. For samples that show -// how to call RetrieveSeriesMetadata, see Retrieving metadata. +// data removed. See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of +// RetrieveSeriesMetadata, see Metadata resources +// (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveSeriesMetadata, see Retrieving metadata +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19724,10 +19805,15 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall struct } // RetrieveSeries: RetrieveSeries returns all instances within the given -// study and series. See RetrieveTransaction. For details on the -// implementation of RetrieveSeries, see DICOM study/series/instances in -// the Cloud Healthcare API conformance statement. For samples that show -// how to call RetrieveSeries, see Retrieving DICOM data. +// study and series. See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of RetrieveSeries, see +// DICOM study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta +// nces) in the Cloud Healthcare API conformance statement. For samples +// that show how to call RetrieveSeries, see Retrieving DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19850,11 +19936,16 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall str } // SearchForInstances: SearchForInstances returns a list of matching -// instances. See RetrieveTransaction. For details on the implementation -// of SearchForInstances, see Search transaction in the Cloud Healthcare -// API conformance statement. For samples that show how to call -// SearchForInstances, see Searching for studies, series, instances, and -// frames. +// instances. See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of SearchForInstances, +// see Search transaction +// (https://cloud.google.com/healthcare/docs/dicom#search_transaction) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call SearchForInstances, see Searching for studies, +// series, instances, and frames +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f +// or_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19980,7 +20071,9 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall struct // to the GET requests specified in the Retrieve transaction. Study and // series search results can take a few seconds to be updated after an // instance is deleted using DeleteInstance. For samples that show how -// to call DeleteInstance, see Deleting a study, series, or instance. +// to call DeleteInstance, see Deleting a study, series, or instance +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_ +// study_series_or_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20124,11 +20217,17 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceC // RetrieveInstance: RetrieveInstance returns instance associated with // the given study, series, and SOP Instance UID. See -// RetrieveTransaction. For details on the implementation of -// RetrieveInstance, see DICOM study/series/instances and DICOM -// instances in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveInstance, see Retrieving an -// instance. +// RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of RetrieveInstance, see +// DICOM study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta +// nces) and DICOM instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_instances) in +// the Cloud Healthcare API conformance statement. For samples that show +// how to call RetrieveInstance, see Retrieving an instance +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// an_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveInstance(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20253,10 +20352,15 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataC // RetrieveMetadata: RetrieveInstanceMetadata returns instance // associated with the given study, series, and SOP Instance UID // presented as metadata with the bulk data removed. See -// RetrieveTransaction. For details on the implementation of -// RetrieveInstanceMetadata, see Metadata resources in the Cloud -// Healthcare API conformance statement. For samples that show how to -// call RetrieveInstanceMetadata, see Retrieving metadata. +// RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of +// RetrieveInstanceMetadata, see Metadata resources +// (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveInstanceMetadata, see Retrieving metadata +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20380,11 +20484,16 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedC // RetrieveRendered: RetrieveRenderedInstance returns instance // associated with the given study, series, and SOP Instance UID in an -// acceptable Rendered Media Type. See RetrieveTransaction. For details -// on the implementation of RetrieveRenderedInstance, see Rendered -// resources in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveRenderedInstance, see -// Retrieving consumer image formats. +// acceptable Rendered Media Type. See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of +// RetrieveRenderedInstance, see Rendered resources +// (https://cloud.google.com/healthcare/docs/dicom#rendered_resources) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveRenderedInstance, see Retrieving consumer +// image formats +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// consumer_image_formats). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20508,10 +20617,15 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFra // RetrieveFrames: RetrieveFrames returns instances associated with the // given study, series, SOP Instance UID and frame numbers. See -// RetrieveTransaction. For details on the implementation of -// RetrieveFrames, see DICOM frames in the Cloud Healthcare API -// conformance statement. For samples that show how to call -// RetrieveFrames, see Retrieving DICOM data. +// RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of RetrieveFrames, see +// DICOM frames +// (https://cloud.google.com/healthcare/docs/dicom#dicom_frames) in the +// Cloud Healthcare API conformance statement. For samples that show how +// to call RetrieveFrames, see Retrieving DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveFrames(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20635,11 +20749,16 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRen // RetrieveRendered: RetrieveRenderedFrames returns instances associated // with the given study, series, SOP Instance UID and frame numbers in -// an acceptable Rendered Media Type. See RetrieveTransaction. For -// details on the implementation of RetrieveRenderedFrames, see Rendered -// resources in the Cloud Healthcare API conformance statement. For -// samples that show how to call RetrieveRenderedFrames, see Retrieving -// consumer image formats. +// an acceptable Rendered Media Type. See RetrieveTransaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s +// ect_10.4). For details on the implementation of +// RetrieveRenderedFrames, see Rendered resources +// (https://cloud.google.com/healthcare/docs/dicom#rendered_resources) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveRenderedFrames, see Retrieving consumer +// image formats +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ +// consumer_image_formats). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20918,7 +21037,8 @@ type ProjectsLocationsDatasetsFhirStoresDeidentifyCall struct { // If the request is successful, the response field type is // DeidentifyFhirStoreSummary. The number of resources processed are // tracked in Operation.metadata. Error details are logged to Cloud -// Logging. For more information, see Viewing logs. +// Logging. For more information, see Viewing logs +// (/healthcare/docs/how-tos/logging). func (r *ProjectsLocationsDatasetsFhirStoresService) Deidentify(sourceStore string, deidentifyfhirstorerequest *DeidentifyFhirStoreRequest) *ProjectsLocationsDatasetsFhirStoresDeidentifyCall { c := &ProjectsLocationsDatasetsFhirStoresDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.sourceStore = sourceStore @@ -21193,10 +21313,11 @@ type ProjectsLocationsDatasetsFhirStoresExportCall struct { // destination. This method returns an Operation that can be used to // track the status of the export by calling GetOperation. Immediate // fatal errors appear in the error field, errors are also logged to -// Cloud Logging (see Viewing error logs in Cloud Logging). Otherwise, -// when the operation finishes, a detailed response of type -// ExportResourcesResponse is returned in the response field. The -// metadata field type for this operation is OperationMetadata. +// Cloud Logging (see Viewing error logs in Cloud Logging +// (/healthcare/docs/how-tos/logging)). Otherwise, when the operation +// finishes, a detailed response of type ExportResourcesResponse is +// returned in the response field. The metadata field type for this +// operation is OperationMetadata. func (r *ProjectsLocationsDatasetsFhirStoresService) Export(name string, exportresourcesrequest *ExportResourcesRequest) *ProjectsLocationsDatasetsFhirStoresExportCall { c := &ProjectsLocationsDatasetsFhirStoresExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -21496,7 +21617,8 @@ func (r *ProjectsLocationsDatasetsFhirStoresService) GetIamPolicy(resource strin // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsDatasetsFhirStoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsFhirStoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -21695,10 +21817,11 @@ type ProjectsLocationsDatasetsFhirStoresImportCall struct { // by a FHIR search or Patient-everything operation. This method returns // an Operation that can be used to track the status of the import by // calling GetOperation. Immediate fatal errors appear in the error -// field, errors are also logged to Cloud Logging (see Viewing logs). -// Otherwise, when the operation finishes, a detailed response of type -// ImportResourcesResponse is returned in the response field. The -// metadata field type for this operation is OperationMetadata. +// field, errors are also logged to Cloud Logging (see Viewing logs +// (/healthcare/docs/how-tos/logging)). Otherwise, when the operation +// finishes, a detailed response of type ImportResourcesResponse is +// returned in the response field. The metadata field type for this +// operation is OperationMetadata. func (r *ProjectsLocationsDatasetsFhirStoresService) Import(name string, importresourcesrequest *ImportResourcesRequest) *ProjectsLocationsDatasetsFhirStoresImportCall { c := &ProjectsLocationsDatasetsFhirStoresImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -22487,13 +22610,18 @@ type ProjectsLocationsDatasetsFhirStoresFhirConceptMapSearchTranslateCall struct // ConceptMapSearchTranslate: Translates a code from one value set to // another by searching for appropriate concept maps. Implements the -// FHIR standard $translate operation (DSTU2, STU3, R4). On success, the -// response body contains a JSON-encoded representation of a FHIR -// Parameters resource, which includes the translation result. Errors -// generated by the FHIR store contain a JSON-encoded `OperationOutcome` -// resource describing the reason for the error. If the request cannot -// be mapped to a valid API method on a FHIR store, a generic GCP error -// might be returned instead. +// FHIR standard $translate operation (DSTU2 +// (https://www.hl7.org/fhir/DSTU2/operation-conceptmap-translate.html), +// STU3 +// (https://www.hl7.org/fhir/STU3/operation-conceptmap-translate.html), +// R4 +// (https://www.hl7.org/fhir/R4/operation-conceptmap-translate.html)). +// On success, the response body contains a JSON-encoded representation +// of a FHIR Parameters resource, which includes the translation result. +// Errors generated by the FHIR store contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ConceptMapSearchTranslate(parent string) *ProjectsLocationsDatasetsFhirStoresFhirConceptMapSearchTranslateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirConceptMapSearchTranslateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -22682,13 +22810,18 @@ type ProjectsLocationsDatasetsFhirStoresFhirConceptMapTranslateCall struct { // ConceptMapTranslate: Translates a code from one value set to another // using a concept map. You can provide your own concept maps to // translate any code system to another code system. Implements the FHIR -// standard $translate operation (DSTU2, STU3, R4). On success, the -// response body contains a JSON-encoded representation of a FHIR -// Parameters resource, which includes the translation result. Errors -// generated by the FHIR store contain a JSON-encoded `OperationOutcome` -// resource describing the reason for the error. If the request cannot -// be mapped to a valid API method on a FHIR store, a generic GCP error -// might be returned instead. +// standard $translate operation (DSTU2 +// (https://www.hl7.org/fhir/DSTU2/operation-conceptmap-translate.html), +// STU3 +// (https://www.hl7.org/fhir/STU3/operation-conceptmap-translate.html), +// R4 +// (https://www.hl7.org/fhir/R4/operation-conceptmap-translate.html)). +// On success, the response body contains a JSON-encoded representation +// of a FHIR Parameters resource, which includes the translation result. +// Errors generated by the FHIR store contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ConceptMapTranslate(name string) *ProjectsLocationsDatasetsFhirStoresFhirConceptMapTranslateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirConceptMapTranslateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -22838,17 +22971,20 @@ type ProjectsLocationsDatasetsFhirStoresFhirObservationLastnCall struct { // ObservationLastn: Retrieves the N most recent `Observation` resources // for a subject matching search criteria specified as query parameters, // grouped by `Observation.code`, sorted from most recent to oldest. -// Implements the FHIR extended operation Observation-lastn (STU3, R4). -// DSTU2 doesn't define the Observation-lastn method, but the server -// supports it the same way it supports STU3. Search terms are provided -// as query parameters following the same pattern as the search method. -// The following search parameters must be provided: - `subject` or -// `patient` to specify a subject for the Observation. - `code`, -// `category` or any of the composite parameters that include `code`. -// Any other valid Observation search parameters can also be provided. -// This operation accepts an additional query parameter `max`, which -// specifies N, the maximum number of Observations to return from each -// group, with a default of 1. Searches with over 1000 results are +// Implements the FHIR extended operation Observation-lastn (STU3 +// (https://hl7.org/implement/standards/fhir/STU3/observation-operations. +// html#lastn), R4 +// (https://hl7.org/implement/standards/fhir/R4/observation-operations.ht +// ml#lastn)). DSTU2 doesn't define the Observation-lastn method, but +// the server supports it the same way it supports STU3. Search terms +// are provided as query parameters following the same pattern as the +// search method. The following search parameters must be provided: - +// `subject` or `patient` to specify a subject for the Observation. - +// `code`, `category` or any of the composite parameters that include +// `code`. Any other valid Observation search parameters can also be +// provided. This operation accepts an additional query parameter `max`, +// which specifies N, the maximum number of Observations to return from +// each group, with a default of 1. Searches with over 1000 results are // rejected. Results are counted before grouping and limiting the // results with `max`. To stay within the limit, constrain these // searches using Observation search parameters such as `_lastUpdated` @@ -22971,21 +23107,31 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall struct { // PatientEverything: Retrieves a Patient resource and resources related // to that patient. Implements the FHIR extended operation -// Patient-everything (DSTU2, STU3, R4). On success, the response body -// contains a JSON-encoded representation of a `Bundle` resource of type -// `searchset`, containing the results of the operation. Errors -// generated by the FHIR store contain a JSON-encoded `OperationOutcome` -// resource describing the reason for the error. If the request cannot -// be mapped to a valid API method on a FHIR store, a generic GCP error -// might be returned instead. The resources in scope for the response -// are: * The patient resource itself. * All the resources directly -// referenced by the patient resource. * Resources directly referencing -// the patient resource that meet the inclusion criteria. The inclusion -// criteria are based on the membership rules in the patient compartment -// definition (DSTU2, STU3, R4), which details the eligible resource -// types and referencing search parameters. For samples that show how to -// call `Patient-everything`, see Getting all patient compartment -// resources. +// Patient-everything (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/patient-operations.htm +// l#everything), STU3 +// (https://hl7.org/implement/standards/fhir/STU3/patient-operations.html +// #everything), R4 +// (https://hl7.org/implement/standards/fhir/R4/patient-operations.html#e +// verything)). On success, the response body contains a JSON-encoded +// representation of a `Bundle` resource of type `searchset`, containing +// the results of the operation. Errors generated by the FHIR store +// contain a JSON-encoded `OperationOutcome` resource describing the +// reason for the error. If the request cannot be mapped to a valid API +// method on a FHIR store, a generic GCP error might be returned +// instead. The resources in scope for the response are: * The patient +// resource itself. * All the resources directly referenced by the +// patient resource. * Resources directly referencing the patient +// resource that meet the inclusion criteria. The inclusion criteria are +// based on the membership rules in the patient compartment definition +// (DSTU2 (https://hl7.org/fhir/DSTU2/compartment-patient.html), STU3 +// (http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html), R4 +// (https://hl7.org/fhir/R4/compartmentdefinition-patient.html)), which +// details the eligible resource types and referencing search +// parameters. For samples that show how to call `Patient-everything`, +// see Getting all patient compartment resources +// (/healthcare/docs/how-tos/fhir-resources#getting_all_patient_compartme +// nt_resources). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) PatientEverything(name string) *ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall { c := &ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -23184,7 +23330,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall struct { // versions of a resource, first delete the current version and then // call this method. This is not a FHIR standard operation. For samples // that show how to call `Resource-purge`, see Deleting historical -// versions of a FHIR resource. +// versions of a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#deleting_historical_versions_ +// of_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ResourcePurge(name string) *ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall { c := &ProjectsLocationsDatasetsFhirStoresFhirResourcePurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -23315,13 +23463,22 @@ type ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall struct { header_ http.Header } -// Capabilities: Gets the FHIR capability statement (STU3, R4), or the -// conformance statement in the DSTU2 case for the store, which contains -// a description of functionality supported by the server. Implements -// the FHIR standard capabilities interaction (STU3, R4), or the -// conformance interaction in the DSTU2 case. On success, the response -// body contains a JSON-encoded representation of a -// `CapabilityStatement` resource. +// Capabilities: Gets the FHIR capability statement (STU3 +// (https://hl7.org/implement/standards/fhir/STU3/capabilitystatement.htm +// l), R4 +// (https://hl7.org/implement/standards/fhir/R4/capabilitystatement.html) +// ), or the conformance statement +// (https://hl7.org/implement/standards/fhir/DSTU2/conformance.html) in +// the DSTU2 case for the store, which contains a description of +// functionality supported by the server. Implements the FHIR standard +// capabilities interaction (STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#capabilities) +// , R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#capabilities)), +// or the conformance interaction +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#conformance) +// in the DSTU2 case. On success, the response body contains a +// JSON-encoded representation of a `CapabilityStatement` resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Capabilities(name string) *ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall { c := &ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -23433,18 +23590,25 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalDeleteCall struct { } // ConditionalDelete: Deletes FHIR resources that match a search query. -// Implements the FHIR standard conditional delete interaction (DSTU2, -// STU3, R4). If multiple resources match, all matching resources are -// deleted. Search terms are provided as query parameters following the -// same pattern as the search method. Note: Unless resource versioning -// is disabled by setting the disable_resource_versioning flag on the -// FHIR store, the deleted resources are moved to a history repository -// that can still be retrieved through vread and related methods, unless -// they are removed by the purge method. This method requires +// Implements the FHIR standard conditional delete interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.12.1), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.13.1), +// R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#3.1.0.7.1)). +// If multiple resources match, all matching resources are deleted. +// Search terms are provided as query parameters following the same +// pattern as the search method. Note: Unless resource versioning is +// disabled by setting the disable_resource_versioning flag on the FHIR +// store, the deleted resources are moved to a history repository that +// can still be retrieved through vread and related methods, unless they +// are removed by the purge method. This method requires // the`healthcare.fhirStores.searchResources` and // `healthcare.fhirResources.delete` permissions on the parent FHIR // store. For samples that show how to call `conditionalDelete`, see -// Conditionally deleting a FHIR resource. +// Conditionally deleting a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#conditionally_deleting_a_fhir +// _resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ConditionalDelete(parent string, type_ string) *ProjectsLocationsDatasetsFhirStoresFhirConditionalDeleteCall { c := &ProjectsLocationsDatasetsFhirStoresFhirConditionalDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -23588,25 +23752,30 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalPatchCall struct { // ConditionalPatch: If a resource is found based on the search criteria // specified in the query parameters, updates part of that resource by -// applying the operations specified in a JSON Patch document. -// Implements the FHIR standard conditional patch interaction (STU3, -// R4). DSTU2 doesn't define a conditional patch method, but the server -// supports it in the same way it supports STU3. Search terms are -// provided as query parameters following the same pattern as the search -// method. If the search criteria identify more than one match, the -// request returns a `412 Precondition Failed` error. The request body -// must contain a JSON Patch document, and the request headers must -// contain `Content-Type: application/json-patch+json`. On success, the -// response body contains a JSON-encoded representation of the updated -// resource, including the server-assigned version ID. Errors generated -// by the FHIR store contain a JSON-encoded `OperationOutcome` resource -// describing the reason for the error. If the request cannot be mapped -// to a valid API method on a FHIR store, a generic GCP error might be -// returned instead. This method requires +// applying the operations specified in a JSON Patch +// (http://jsonpatch.com/) document. Implements the FHIR standard +// conditional patch interaction (STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#patch), R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#patch)). DSTU2 +// doesn't define a conditional patch method, but the server supports it +// in the same way it supports STU3. Search terms are provided as query +// parameters following the same pattern as the search method. If the +// search criteria identify more than one match, the request returns a +// `412 Precondition Failed` error. The request body must contain a JSON +// Patch document, and the request headers must contain `Content-Type: +// application/json-patch+json`. On success, the response body contains +// a JSON-encoded representation of the updated resource, including the +// server-assigned version ID. Errors generated by the FHIR store +// contain a JSON-encoded `OperationOutcome` resource describing the +// reason for the error. If the request cannot be mapped to a valid API +// method on a FHIR store, a generic GCP error might be returned +// instead. This method requires // the`healthcare.fhirStores.searchResources` permission on the parent // FHIR store and the `healthcare.fhirResources.patch` permission on the // requested FHIR store resource. For samples that show how to call -// `conditionalPatch`, see Conditionally patching a FHIR resource. +// `conditionalPatch`, see Conditionally patching a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#conditionally_patching_a_fhir +// _resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ConditionalPatch(parent string, type_ string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirConditionalPatchCall { c := &ProjectsLocationsDatasetsFhirStoresFhirConditionalPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -23721,28 +23890,35 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalUpdateCall struct { // ConditionalUpdate: If a resource is found based on the search // criteria specified in the query parameters, updates the entire // contents of that resource. Implements the FHIR standard conditional -// update interaction (DSTU2, STU3, R4). Search terms are provided as -// query parameters following the same pattern as the search method. If -// the search criteria identify more than one match, the request returns -// a `412 Precondition Failed` error. If the search criteria identify -// zero matches, and the supplied resource body contains an `id`, and -// the FHIR store has enable_update_create set, creates the resource -// with the client-specified ID. If the search criteria identify zero -// matches, and the supplied resource body does not contain an `id`, the -// resource is created with a server-assigned ID as per the create -// method. The request body must contain a JSON-encoded FHIR resource, -// and the request headers must contain `Content-Type: -// application/fhir+json`. On success, the response body contains a -// JSON-encoded representation of the updated resource, including the -// server-assigned version ID. Errors generated by the FHIR store -// contain a JSON-encoded `OperationOutcome` resource describing the -// reason for the error. If the request cannot be mapped to a valid API -// method on a FHIR store, a generic GCP error might be returned -// instead. This method requires +// update interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.10.2), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#cond-update), +// R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#cond-update)). +// Search terms are provided as query parameters following the same +// pattern as the search method. If the search criteria identify more +// than one match, the request returns a `412 Precondition Failed` +// error. If the search criteria identify zero matches, and the supplied +// resource body contains an `id`, and the FHIR store has +// enable_update_create set, creates the resource with the +// client-specified ID. If the search criteria identify zero matches, +// and the supplied resource body does not contain an `id`, the resource +// is created with a server-assigned ID as per the create method. The +// request body must contain a JSON-encoded FHIR resource, and the +// request headers must contain `Content-Type: application/fhir+json`. +// On success, the response body contains a JSON-encoded representation +// of the updated resource, including the server-assigned version ID. +// Errors generated by the FHIR store contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. This method requires // the`healthcare.fhirStores.searchResources` and // `healthcare.fhirResources.update` permissions on the parent FHIR // store. For samples that show how to call `conditionalUpdate`, see -// Conditionally updating a FHIR resource. +// Conditionally updating a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#conditionally_updating_a_fhir +// _resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ConditionalUpdate(parent string, type_ string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirConditionalUpdateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirConditionalUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -23855,21 +24031,31 @@ type ProjectsLocationsDatasetsFhirStoresFhirCreateCall struct { } // Create: Creates a FHIR resource. Implements the FHIR standard create -// interaction (DSTU2, STU3, R4), which creates a new resource with a -// server-assigned resource ID. Also supports the FHIR standard -// conditional create interaction (DSTU2, STU3, R4), specified by -// supplying an `If-None-Exist` header containing a FHIR search query. -// If no resources match this search query, the server processes the -// create operation as normal. The request body must contain a -// JSON-encoded FHIR resource, and the request headers must contain -// `Content-Type: application/fhir+json`. On success, the response body -// contains a JSON-encoded representation of the resource as it was -// created on the server, including the server-assigned resource ID and -// version ID. Errors generated by the FHIR store contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. For samples that show -// how to call `create`, see Creating a FHIR resource. +// interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#create), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#create), R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#create)), +// which creates a new resource with a server-assigned resource ID. Also +// supports the FHIR standard conditional create interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#ccreate), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#ccreate), R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#ccreate)), +// specified by supplying an `If-None-Exist` header containing a FHIR +// search query. If no resources match this search query, the server +// processes the create operation as normal. The request body must +// contain a JSON-encoded FHIR resource, and the request headers must +// contain `Content-Type: application/fhir+json`. On success, the +// response body contains a JSON-encoded representation of the resource +// as it was created on the server, including the server-assigned +// resource ID and version ID. Errors generated by the FHIR store +// contain a JSON-encoded `OperationOutcome` resource describing the +// reason for the error. If the request cannot be mapped to a valid API +// method on a FHIR store, a generic GCP error might be returned +// instead. For samples that show how to call `create`, see Creating a +// FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#creating_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Create(parent string, type_ string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirCreateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -23980,12 +24166,18 @@ type ProjectsLocationsDatasetsFhirStoresFhirDeleteCall struct { } // Delete: Deletes a FHIR resource. Implements the FHIR standard delete -// interaction (DSTU2, STU3, R4). Note: Unless resource versioning is -// disabled by setting the disable_resource_versioning flag on the FHIR -// store, the deleted resources are moved to a history repository that -// can still be retrieved through vread and related methods, unless they -// are removed by the purge method. For samples that show how to call -// `delete`, see Deleting a FHIR resource. +// interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#delete), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#delete), R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#delete)). +// Note: Unless resource versioning is disabled by setting the +// disable_resource_versioning flag on the FHIR store, the deleted +// resources are moved to a history repository that can still be +// retrieved through vread and related methods, unless they are removed +// by the purge method. For samples that show how to call `delete`, see +// Deleting a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#deleting_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Delete(name string) *ProjectsLocationsDatasetsFhirStoresFhirDeleteCall { c := &ProjectsLocationsDatasetsFhirStoresFhirDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -24084,29 +24276,44 @@ type ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall struct { } // ExecuteBundle: Executes all the requests in the given Bundle. -// Implements the FHIR standard batch/transaction interaction (DSTU2, -// STU3, R4). Supports all interactions within a bundle, except search. -// This method accepts Bundles of type `batch` and `transaction`, -// processing them according to the batch processing rules (DSTU2, STU3, -// R4) and transaction processing rules (DSTU2, STU3, R4). The request -// body must contain a JSON-encoded FHIR `Bundle` resource, and the -// request headers must contain `Content-Type: application/fhir+json`. -// For a batch bundle or a successful transaction the response body -// contains a JSON-encoded representation of a `Bundle` resource of type -// `batch-response` or `transaction-response` containing one entry for -// each entry in the request, with the outcome of processing the entry. -// In the case of an error for a transaction bundle, the response body -// contains a JSON-encoded `OperationOutcome` resource describing the -// reason for the error. If the request cannot be mapped to a valid API -// method on a FHIR store, a generic GCP error might be returned -// instead. This method requires permission for executing the requests -// in the bundle. The `executeBundle` permission grants permission to -// execute the request in the bundle but you must grant sufficient -// permissions to execute the individual requests in the bundle. For -// example, if the bundle contains a `create` request, you must have -// permission to execute the `create` request. Logging is available for -// the `executeBundle` permission. For samples that show how to call -// `executeBundle`, see Managing FHIR resources using FHIR bundles. +// Implements the FHIR standard batch/transaction interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#transaction) +// , STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#transaction), +// R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#transaction)). +// Supports all interactions within a bundle, except search. This method +// accepts Bundles of type `batch` and `transaction`, processing them +// according to the batch processing rules (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.1), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.1), +// R4 (https://hl7.org/implement/standards/fhir/R4/http.html#brules)) +// and transaction processing rules (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.2), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.2), +// R4 (https://hl7.org/implement/standards/fhir/R4/http.html#trules)). +// The request body must contain a JSON-encoded FHIR `Bundle` resource, +// and the request headers must contain `Content-Type: +// application/fhir+json`. For a batch bundle or a successful +// transaction the response body contains a JSON-encoded representation +// of a `Bundle` resource of type `batch-response` or +// `transaction-response` containing one entry for each entry in the +// request, with the outcome of processing the entry. In the case of an +// error for a transaction bundle, the response body contains a +// JSON-encoded `OperationOutcome` resource describing the reason for +// the error. If the request cannot be mapped to a valid API method on a +// FHIR store, a generic GCP error might be returned instead. This +// method requires permission for executing the requests in the bundle. +// The `executeBundle` permission grants permission to execute the +// request in the bundle but you must grant sufficient permissions to +// execute the individual requests in the bundle. For example, if the +// bundle contains a `create` request, you must have permission to +// execute the `create` request. Logging is available for the +// `executeBundle` permission. For samples that show how to call +// `executeBundle`, see Managing FHIR resources using FHIR bundles +// (/healthcare/docs/how-tos/fhir-bundles). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) ExecuteBundle(parent string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall { c := &ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -24209,15 +24416,21 @@ type ProjectsLocationsDatasetsFhirStoresFhirHistoryCall struct { // History: Lists all the versions of a resource (including the current // version and deleted versions) from the FHIR store. Implements the -// per-resource form of the FHIR standard history interaction (DSTU2, -// STU3, R4). On success, the response body contains a JSON-encoded -// representation of a `Bundle` resource of type `history`, containing -// the version history sorted from most recent to oldest versions. -// Errors generated by the FHIR store contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. For samples that show -// how to call `history`, see Listing FHIR resource versions. +// per-resource form of the FHIR standard history interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#history), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#history), R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#history)). On +// success, the response body contains a JSON-encoded representation of +// a `Bundle` resource of type `history`, containing the version history +// sorted from most recent to oldest versions. Errors generated by the +// FHIR store contain a JSON-encoded `OperationOutcome` resource +// describing the reason for the error. If the request cannot be mapped +// to a valid API method on a FHIR store, a generic GCP error might be +// returned instead. For samples that show how to call `history`, see +// Listing FHIR resource versions +// (/healthcare/docs/how-tos/fhir-resources#listing_fhir_resource_version +// s). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) History(name string) *ProjectsLocationsDatasetsFhirStoresFhirHistoryCall { c := &ProjectsLocationsDatasetsFhirStoresFhirHistoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -24392,18 +24605,22 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatchCall struct { } // Patch: Updates part of an existing resource by applying the -// operations specified in a JSON Patch document. Implements the FHIR -// standard patch interaction (STU3, R4). DSTU2 doesn't define a patch -// method, but the server supports it in the same way it supports STU3. -// The request body must contain a JSON Patch document, and the request -// headers must contain `Content-Type: application/json-patch+json`. On -// success, the response body contains a JSON-encoded representation of -// the updated resource, including the server-assigned version ID. -// Errors generated by the FHIR store contain a JSON-encoded -// `OperationOutcome` resource describing the reason for the error. If -// the request cannot be mapped to a valid API method on a FHIR store, a -// generic GCP error might be returned instead. For samples that show -// how to call `patch`, see Patching a FHIR resource. +// operations specified in a JSON Patch (http://jsonpatch.com/) +// document. Implements the FHIR standard patch interaction (STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#patch), R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#patch)). DSTU2 +// doesn't define a patch method, but the server supports it in the same +// way it supports STU3. The request body must contain a JSON Patch +// document, and the request headers must contain `Content-Type: +// application/json-patch+json`. On success, the response body contains +// a JSON-encoded representation of the updated resource, including the +// server-assigned version ID. Errors generated by the FHIR store +// contain a JSON-encoded `OperationOutcome` resource describing the +// reason for the error. If the request cannot be mapped to a valid API +// method on a FHIR store, a generic GCP error might be returned +// instead. For samples that show how to call `patch`, see Patching a +// FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#patching_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Patch(name string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirPatchCall { c := &ProjectsLocationsDatasetsFhirStoresFhirPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -24505,16 +24722,23 @@ type ProjectsLocationsDatasetsFhirStoresFhirReadCall struct { } // Read: Gets the contents of a FHIR resource. Implements the FHIR -// standard read interaction (DSTU2, STU3, R4). Also supports the FHIR -// standard conditional read interaction (DSTU2, STU3, R4) specified by -// supplying an `If-Modified-Since` header with a date/time value or an -// `If-None-Match` header with an ETag value. On success, the response -// body contains a JSON-encoded representation of the resource. Errors -// generated by the FHIR store contain a JSON-encoded `OperationOutcome` -// resource describing the reason for the error. If the request cannot -// be mapped to a valid API method on a FHIR store, a generic GCP error -// might be returned instead. For samples that show how to call `read`, -// see Getting a FHIR resource. +// standard read interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#read), STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#read), R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#read)). Also +// supports the FHIR standard conditional read interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#cread), +// STU3 (https://hl7.org/implement/standards/fhir/STU3/http.html#cread), +// R4 (https://hl7.org/implement/standards/fhir/R4/http.html#cread)) +// specified by supplying an `If-Modified-Since` header with a date/time +// value or an `If-None-Match` header with an ETag value. On success, +// the response body contains a JSON-encoded representation of the +// resource. Errors generated by the FHIR store contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. For samples that show +// how to call `read`, see Getting a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#getting_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Read(name string) *ProjectsLocationsDatasetsFhirStoresFhirReadCall { c := &ProjectsLocationsDatasetsFhirStoresFhirReadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -24627,9 +24851,16 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // Search: Searches for resources in the given FHIR store according to // criteria specified as query parameters. Implements the FHIR standard -// search interaction (DSTU2, STU3, R4) using the search semantics -// described in the FHIR Search specification (DSTU2, STU3, R4). -// Supports three methods of search defined by the specification: * `GET +// search interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#search), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#search), R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#search)) using +// the search semantics described in the FHIR Search specification +// (DSTU2 (https://hl7.org/implement/standards/fhir/DSTU2/search.html), +// STU3 (https://hl7.org/implement/standards/fhir/STU3/search.html), R4 +// (https://hl7.org/implement/standards/fhir/R4/search.html)). Supports +// three methods of search defined by the specification: * `GET // [base]?[parameters]` to search across all resources. * `GET // [base]/[type]?[parameters]` to search resources of a specified type. // * `POST [base]/[type]/_search?[parameters]` as an alternate form @@ -24645,23 +24876,28 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // statement, retrieved through capabilities, indicates what search // parameters are supported on each FHIR resource. A list of all search // parameters defined by the specification can be found in the FHIR -// Search Parameter Registry (STU3, R4). FHIR search parameters for -// DSTU2 can be found on each resource's definition page. Supported -// search modifiers: `:missing`, `:exact`, `:contains`, `:text`, `:in`, -// `:not-in`, `:above`, `:below`, `:[type]`, `:not`, and `:recurse`. -// Supported search result parameters: `_sort`, `_count`, `_include`, -// `_revinclude`, `_summary=text`, `_summary=data`, and `_elements`. The -// maximum number of search results returned defaults to 100, which can -// be overridden by the `_count` parameter up to a maximum limit of -// 1000. If there are additional results, the returned `Bundle` contains -// pagination links. Resources with a total size larger than 5MB or a -// field count larger than 50,000 might not be fully searchable as the -// server might trim its generated search index in those cases. Note: -// FHIR resources are indexed asynchronously, so there might be a slight -// delay between the time a resource is created or changes and when the -// change is reflected in search results. For samples and detailed -// information, see Searching for FHIR resources and Advanced FHIR -// search features. +// Search Parameter Registry (STU3 +// (https://hl7.org/implement/standards/fhir/STU3/searchparameter-registr +// y.html), R4 +// (https://hl7.org/implement/standards/fhir/R4/searchparameter-registry. +// html)). FHIR search parameters for DSTU2 can be found on each +// resource's definition page. Supported search modifiers: `:missing`, +// `:exact`, `:contains`, `:text`, `:in`, `:not-in`, `:above`, `:below`, +// `:[type]`, `:not`, and `:recurse`. Supported search result +// parameters: `_sort`, `_count`, `_include`, `_revinclude`, +// `_summary=text`, `_summary=data`, and `_elements`. The maximum number +// of search results returned defaults to 100, which can be overridden +// by the `_count` parameter up to a maximum limit of 1000. If there are +// additional results, the returned `Bundle` contains pagination links. +// Resources with a total size larger than 5MB or a field count larger +// than 50,000 might not be fully searchable as the server might trim +// its generated search index in those cases. Note: FHIR resources are +// indexed asynchronously, so there might be a slight delay between the +// time a resource is created or changes and when the change is +// reflected in search results. For samples and detailed information, +// see Searching for FHIR resources +// (/healthcare/docs/how-tos/fhir-search) and Advanced FHIR search +// features (/healthcare/docs/how-tos/fhir-advanced-search). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Search(parent string, searchresourcesrequest *SearchResourcesRequest) *ProjectsLocationsDatasetsFhirStoresFhirSearchCall { c := &ProjectsLocationsDatasetsFhirStoresFhirSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -24769,20 +25005,25 @@ type ProjectsLocationsDatasetsFhirStoresFhirUpdateCall struct { } // Update: Updates the entire contents of a resource. Implements the -// FHIR standard update interaction (DSTU2, STU3, R4). If the specified -// resource does not exist and the FHIR store has enable_update_create -// set, creates the resource with the client-specified ID. The request -// body must contain a JSON-encoded FHIR resource, and the request -// headers must contain `Content-Type: application/fhir+json`. The -// resource must contain an `id` element having an identical value to -// the ID in the REST path of the request. On success, the response body -// contains a JSON-encoded representation of the updated resource, -// including the server-assigned version ID. Errors generated by the -// FHIR store contain a JSON-encoded `OperationOutcome` resource -// describing the reason for the error. If the request cannot be mapped -// to a valid API method on a FHIR store, a generic GCP error might be -// returned instead. For samples that show how to call `update`, see -// Updating a FHIR resource. +// FHIR standard update interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#update), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#update), R4 +// (https://hl7.org/implement/standards/fhir/R4/http.html#update)). If +// the specified resource does not exist and the FHIR store has +// enable_update_create set, creates the resource with the +// client-specified ID. The request body must contain a JSON-encoded +// FHIR resource, and the request headers must contain `Content-Type: +// application/fhir+json`. The resource must contain an `id` element +// having an identical value to the ID in the REST path of the request. +// On success, the response body contains a JSON-encoded representation +// of the updated resource, including the server-assigned version ID. +// Errors generated by the FHIR store contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If +// the request cannot be mapped to a valid API method on a FHIR store, a +// generic GCP error might be returned instead. For samples that show +// how to call `update`, see Updating a FHIR resource +// (/healthcare/docs/how-tos/fhir-resources#updating_a_fhir_resource). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Update(name string, body_ io.Reader) *ProjectsLocationsDatasetsFhirStoresFhirUpdateCall { c := &ProjectsLocationsDatasetsFhirStoresFhirUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -24885,13 +25126,19 @@ type ProjectsLocationsDatasetsFhirStoresFhirVreadCall struct { // Vread: Gets the contents of a version (current or historical) of a // FHIR resource by version ID. Implements the FHIR standard vread -// interaction (DSTU2, STU3, R4). On success, the response body contains -// a JSON-encoded representation of the resource. Errors generated by -// the FHIR store contain a JSON-encoded `OperationOutcome` resource -// describing the reason for the error. If the request cannot be mapped -// to a valid API method on a FHIR store, a generic GCP error might be -// returned instead. For samples that show how to call `vread`, see -// Retrieving a FHIR resource version. +// interaction (DSTU2 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#vread), +// STU3 (https://hl7.org/implement/standards/fhir/STU3/http.html#vread), +// R4 (https://hl7.org/implement/standards/fhir/R4/http.html#vread)). On +// success, the response body contains a JSON-encoded representation of +// the resource. Errors generated by the FHIR store contain a +// JSON-encoded `OperationOutcome` resource describing the reason for +// the error. If the request cannot be mapped to a valid API method on a +// FHIR store, a generic GCP error might be returned instead. For +// samples that show how to call `vread`, see Retrieving a FHIR resource +// version +// (/healthcare/docs/how-tos/fhir-resources#retrieving_a_fhir_resource_ve +// rsion). func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Vread(name string) *ProjectsLocationsDatasetsFhirStoresFhirVreadCall { c := &ProjectsLocationsDatasetsFhirStoresFhirVreadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -25593,7 +25840,8 @@ func (r *ProjectsLocationsDatasetsHl7V2StoresService) GetIamPolicy(resource stri // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsDatasetsHl7V2StoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDatasetsHl7V2StoresGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -25764,9 +26012,10 @@ type ProjectsLocationsDatasetsHl7V2StoresImportCall struct { // This method returns an Operation that can be used to track the status // of the import by calling GetOperation. Immediate fatal errors appear // in the error field, errors are also logged to Cloud Logging (see -// Viewing logs). Otherwise, when the operation finishes, a response of -// type ImportMessagesResponse is returned in the response field. The -// metadata field type for this operation is OperationMetadata. +// Viewing logs (/healthcare/docs/how-tos/logging)). Otherwise, when the +// operation finishes, a response of type ImportMessagesResponse is +// returned in the response field. The metadata field type for this +// operation is OperationMetadata. func (r *ProjectsLocationsDatasetsHl7V2StoresService) Import(name string, importmessagesrequest *ImportMessagesRequest) *ProjectsLocationsDatasetsHl7V2StoresImportCall { c := &ProjectsLocationsDatasetsHl7V2StoresImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/homegraph/v1/homegraph-gen.go b/homegraph/v1/homegraph-gen.go index c4d07b74c03..3b18b21cc49 100644 --- a/homegraph/v1/homegraph-gen.go +++ b/homegraph/v1/homegraph-gen.go @@ -221,7 +221,11 @@ type Device struct { Attributes googleapi.RawMessage `json:"attributes,omitempty"` // CustomData: Custom device attributes stored in Home Graph and - // provided to your smart home Action in each QUERY and EXECUTE intent. + // provided to your smart home Action in each QUERY + // (https://developers.google.com/assistant/smarthome/reference/intent/qu + // ery) and EXECUTE + // (https://developers.google.com/assistant/smarthome/reference/intent/ex + // ecute) intent. CustomData googleapi.RawMessage `json:"customData,omitempty"` // DeviceInfo: Device manufacturer, model, hardware version, and @@ -242,7 +246,8 @@ type Device struct { NotificationSupportedByAgent bool `json:"notificationSupportedByAgent,omitempty"` // OtherDeviceIds: Alternate IDs associated with this device. This is - // used to identify cloud synced devices enabled for local fulfillment. + // used to identify cloud synced devices enabled for local fulfillment + // (https://developers.google.com/assistant/smarthome/concepts/local). OtherDeviceIds []*AgentOtherDeviceId `json:"otherDeviceIds,omitempty"` // RoomHint: Suggested name for the room where this device is installed. @@ -253,10 +258,12 @@ type Device struct { // installed. Google attempts to use this value during user setup. StructureHint string `json:"structureHint,omitempty"` - // Traits: Traits supported by the device. See device traits. + // Traits: Traits supported by the device. See device traits + // (https://developers.google.com/assistant/smarthome/traits). Traits []string `json:"traits,omitempty"` - // Type: Hardware type of the device. See device types. + // Type: Hardware type of the device. See device types + // (https://developers.google.com/assistant/smarthome/guides). Type string `json:"type,omitempty"` // WillReportState: Indicates whether your smart home Action will report @@ -370,7 +377,8 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } -// QueryRequest: Request type for the `Query` call. +// QueryRequest: Request type for the `Query` +// (#google.home.graph.v1.HomeGraphApiService.Query) call. type QueryRequest struct { // AgentUserId: Required. Third-party user ID. AgentUserId string `json:"agentUserId,omitempty"` @@ -461,9 +469,12 @@ func (s *QueryRequestPayload) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// QueryResponse: Response type for the `Query` call. This should follow -// the same format as the Google smart home `action.devices.QUERY` -// response. # Example ```json { "requestId": +// QueryResponse: Response type for the `Query` +// (#google.home.graph.v1.HomeGraphApiService.Query) call. This should +// follow the same format as the Google smart home +// `action.devices.QUERY` response +// (https://developers.google.com/assistant/smarthome/reference/intent/qu +// ery). # Example ```json { "requestId": // "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "devices": { // "123": { "on": true, "online": true }, "456": { "on": true, "online": // true, "brightness": 80, "color": { "name": "cerulean", "spectrumRGB": @@ -535,11 +546,13 @@ func (s *QueryResponsePayload) MarshalJSON() ([]byte, error) { // specific to a device. type ReportStateAndNotificationDevice struct { // Notifications: Notifications metadata for devices. See the **Device - // NOTIFICATIONS** section of the individual trait reference guides. + // NOTIFICATIONS** section of the individual trait reference guides + // (https://developers.google.com/assistant/smarthome/traits). Notifications googleapi.RawMessage `json:"notifications,omitempty"` // States: States of devices to update. See the **Device STATES** - // section of the individual trait reference guides. + // section of the individual trait reference guides + // (https://developers.google.com/assistant/smarthome/traits). States googleapi.RawMessage `json:"states,omitempty"` // ForceSendFields is a list of field names (e.g. "Notifications") to @@ -566,10 +579,11 @@ func (s *ReportStateAndNotificationDevice) MarshalJSON() ([]byte, error) { } // ReportStateAndNotificationRequest: Request type for the -// `ReportStateAndNotification` call. It may include states, -// notifications, or both. States and notifications are defined per -// `device_id` (for example, "123" and "456" in the following example). -// # Example ```json { "requestId": +// `ReportStateAndNotification` +// (#google.home.graph.v1.HomeGraphApiService.ReportStateAndNotification) +// call. It may include states, notifications, or both. States and +// notifications are defined per `device_id` (for example, "123" and +// "456" in the following example). # Example ```json { "requestId": // "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "agentUserId": "1234", // "payload": { "devices": { "states": { "123": { "on": true }, "456": { // "on": true, "brightness": 10 } }, } } } ``` @@ -581,8 +595,9 @@ type ReportStateAndNotificationRequest struct { EventId string `json:"eventId,omitempty"` // FollowUpToken: Token to maintain state in the follow up notification - // response. Deprecated. See the notifications guide for details on - // implementing follow up notifications. + // response. Deprecated. See the notifications guide + // (https://developers.google.com/assistant/smarthome/develop/notificatio + // ns) for details on implementing follow up notifications. FollowUpToken string `json:"followUpToken,omitempty"` // Payload: Required. State of devices to update and notification @@ -616,7 +631,9 @@ func (s *ReportStateAndNotificationRequest) MarshalJSON() ([]byte, error) { } // ReportStateAndNotificationResponse: Response type for the -// `ReportStateAndNotification` call. +// `ReportStateAndNotification` +// (#google.home.graph.v1.HomeGraphApiService.ReportStateAndNotification) +// call. type ReportStateAndNotificationResponse struct { // RequestId: Request ID copied from ReportStateAndNotificationRequest. RequestId string `json:"requestId,omitempty"` @@ -649,7 +666,7 @@ func (s *ReportStateAndNotificationResponse) MarshalJSON() ([]byte, error) { } // RequestSyncDevicesRequest: Request type for the `RequestSyncDevices` -// call. +// (#google.home.graph.v1.HomeGraphApiService.RequestSyncDevices) call. type RequestSyncDevicesRequest struct { // AgentUserId: Required. Third-party user ID. AgentUserId string `json:"agentUserId,omitempty"` @@ -684,8 +701,10 @@ func (s *RequestSyncDevicesRequest) MarshalJSON() ([]byte, error) { } // RequestSyncDevicesResponse: Response type for the -// `RequestSyncDevices` call. Intentionally empty upon success. An HTTP -// response code is returned with more details upon failure. +// `RequestSyncDevices` +// (#google.home.graph.v1.HomeGraphApiService.RequestSyncDevices) call. +// Intentionally empty upon success. An HTTP response code is returned +// with more details upon failure. type RequestSyncDevicesResponse struct { // ServerResponse contains the HTTP response code and headers from the // server. @@ -721,7 +740,8 @@ func (s *StateAndNotificationPayload) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// SyncRequest: Request type for the `Sync` call. +// SyncRequest: Request type for the `Sync` +// (#google.home.graph.v1.HomeGraphApiService.Sync) call. type SyncRequest struct { // AgentUserId: Required. Third-party user ID. AgentUserId string `json:"agentUserId,omitempty"` @@ -752,9 +772,12 @@ func (s *SyncRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// SyncResponse: Response type for the `Sync` call. This should follow -// the same format as the Google smart home `action.devices.SYNC` -// response. # Example ```json { "requestId": +// SyncResponse: Response type for the `Sync` +// (#google.home.graph.v1.HomeGraphApiService.Sync) call. This should +// follow the same format as the Google smart home `action.devices.SYNC` +// response +// (https://developers.google.com/assistant/smarthome/reference/intent/sy +// nc). # Example ```json { "requestId": // "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "agentUserId": // "1836.15267389", "devices": [{ "id": "123", "type": // "action.devices.types.OUTLET", "traits": [ @@ -842,9 +865,11 @@ type AgentUsersDeleteCall struct { // Delete: Unlinks the given third-party user from your smart home // Action. All data related to this user will be deleted. For more // details on how users link their accounts, see fulfillment and -// authentication. The third-party user's identity is passed in via the -// `agent_user_id` (see DeleteAgentUserRequest). This request must be -// authorized using service account credentials from your Actions +// authentication +// (https://developers.google.com/assistant/smarthome/concepts/fulfillmen +// t-authentication). The third-party user's identity is passed in via +// the `agent_user_id` (see DeleteAgentUserRequest). This request must +// be authorized using service account credentials from your Actions // console project. func (r *AgentUsersService) Delete(agentUserId string) *AgentUsersDeleteCall { c := &AgentUsersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -1119,9 +1144,12 @@ type DevicesReportStateAndNotificationCall struct { // ReportStateAndNotification: Reports device state and optionally sends // device notifications. Called by your smart home Action when the state // of a third-party device changes or you need to send a notification -// about the device. See Implement Report State for more information. -// This method updates the device state according to its declared -// traits. Publishing a new state value outside of these traits will +// about the device. See Implement Report State +// (https://developers.google.com/assistant/smarthome/develop/report-stat +// e) for more information. This method updates the device state +// according to its declared traits +// (https://developers.google.com/assistant/smarthome/concepts/devices-tr +// aits). Publishing a new state value outside of these traits will // result in an `INVALID_ARGUMENT` error response. The third-party // user's identity is passed in via the `agent_user_id` (see // ReportStateAndNotificationRequest). This request must be authorized @@ -1252,7 +1280,8 @@ type DevicesRequestSyncCall struct { } // RequestSync: Requests Google to send an `action.devices.SYNC` intent -// to your smart home Action to update device metadata for the given +// (https://developers.google.com/assistant/smarthome/reference/intent/sy +// nc) to your smart home Action to update device metadata for the given // user. The third-party user's identity is passed via the // `agent_user_id` (see RequestSyncDevicesRequest). This request must be // authorized using service account credentials from your Actions diff --git a/iam/v1/iam-gen.go b/iam/v1/iam-gen.go index bce275e844e..bd997245013 100644 --- a/iam/v1/iam-gen.go +++ b/iam/v1/iam-gen.go @@ -497,7 +497,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1269,7 +1270,9 @@ func (s *PermissionDelta) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1288,7 +1291,7 @@ func (s *PermissionDelta) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1328,7 +1331,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1692,11 +1696,12 @@ func (s *Role) MarshalJSON() ([]byte, error) { // ServiceAccount: An IAM service account. A service account is an // account for an application or a virtual machine (VM) instance, not a // person. You can use a service account to call Google APIs. To learn -// more, read the overview of service accounts. When you create a -// service account, you specify the project ID that owns the service -// account, as well as a name that must be unique within the project. -// IAM uses these values to create an email address that identifies the -// service account. +// more, read the overview of service accounts +// (https://cloud.google.com/iam/help/service-accounts/overview). When +// you create a service account, you specify the project ID that owns +// the service account, as well as a name that must be unique within the +// project. IAM uses these values to create an email address that +// identifies the service account. type ServiceAccount struct { // Description: Optional. A user-specified, human-readable description // of the service account. The maximum length is 256 UTF-8 bytes. @@ -1923,10 +1928,13 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { } // SignBlobRequest: Deprecated. Migrate to Service Account Credentials -// API. The service account sign blob request. +// API (https://cloud.google.com/iam/help/credentials/migrate-api). The +// service account sign blob request. type SignBlobRequest struct { // BytesToSign: Required. Deprecated. Migrate to Service Account - // Credentials API. The bytes to sign. + // Credentials API + // (https://cloud.google.com/iam/help/credentials/migrate-api). The + // bytes to sign. BytesToSign string `json:"bytesToSign,omitempty"` // ForceSendFields is a list of field names (e.g. "BytesToSign") to @@ -1953,14 +1961,17 @@ func (s *SignBlobRequest) MarshalJSON() ([]byte, error) { } // SignBlobResponse: Deprecated. Migrate to Service Account Credentials -// API. The service account sign blob response. +// API (https://cloud.google.com/iam/help/credentials/migrate-api). The +// service account sign blob response. type SignBlobResponse struct { - // KeyId: Deprecated. Migrate to Service Account Credentials API. The id + // KeyId: Deprecated. Migrate to Service Account Credentials API + // (https://cloud.google.com/iam/help/credentials/migrate-api). The id // of the key used to sign the blob. KeyId string `json:"keyId,omitempty"` - // Signature: Deprecated. Migrate to Service Account Credentials API. - // The signed blob. + // Signature: Deprecated. Migrate to Service Account Credentials API + // (https://cloud.google.com/iam/help/credentials/migrate-api). The + // signed blob. Signature string `json:"signature,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1991,16 +2002,18 @@ func (s *SignBlobResponse) MarshalJSON() ([]byte, error) { } // SignJwtRequest: Deprecated. Migrate to Service Account Credentials -// API. The service account sign JWT request. +// API (https://cloud.google.com/iam/help/credentials/migrate-api). The +// service account sign JWT request. type SignJwtRequest struct { // Payload: Required. Deprecated. Migrate to Service Account Credentials - // API. The JWT payload to sign. Must be a serialized JSON object that - // contains a JWT Claims Set. For example: `{"sub": "user@example.com", - // "iat": 313435}` If the JWT Claims Set contains an expiration time - // (`exp`) claim, it must be an integer timestamp that is not in the - // past and no more than 1 hour in the future. If the JWT Claims Set - // does not contain an expiration time (`exp`) claim, this claim is - // added automatically, with a timestamp that is 1 hour in the future. + // API (https://cloud.google.com/iam/help/credentials/migrate-api). The + // JWT payload to sign. Must be a serialized JSON object that contains a + // JWT Claims Set. For example: `{"sub": "user@example.com", "iat": + // 313435}` If the JWT Claims Set contains an expiration time (`exp`) + // claim, it must be an integer timestamp that is not in the past and no + // more than 1 hour in the future. If the JWT Claims Set does not + // contain an expiration time (`exp`) claim, this claim is added + // automatically, with a timestamp that is 1 hour in the future. Payload string `json:"payload,omitempty"` // ForceSendFields is a list of field names (e.g. "Payload") to @@ -2027,14 +2040,17 @@ func (s *SignJwtRequest) MarshalJSON() ([]byte, error) { } // SignJwtResponse: Deprecated. Migrate to Service Account Credentials -// API. The service account sign JWT response. +// API (https://cloud.google.com/iam/help/credentials/migrate-api). The +// service account sign JWT response. type SignJwtResponse struct { - // KeyId: Deprecated. Migrate to Service Account Credentials API. The id + // KeyId: Deprecated. Migrate to Service Account Credentials API + // (https://cloud.google.com/iam/help/credentials/migrate-api). The id // of the key used to sign the JWT. KeyId string `json:"keyId,omitempty"` - // SignedJwt: Deprecated. Migrate to Service Account Credentials API. - // The signed JWT. + // SignedJwt: Deprecated. Migrate to Service Account Credentials API + // (https://cloud.google.com/iam/help/credentials/migrate-api). The + // signed JWT. SignedJwt string `json:"signedJwt,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2066,10 +2082,11 @@ func (s *SignJwtResponse) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2112,7 +2129,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2409,7 +2427,8 @@ type IamPoliciesQueryAuditableServicesCall struct { // QueryAuditableServices: Returns a list of services that allow you to // opt into audit logs that are not generated by default. To learn more -// about audit logs, see the Logging documentation. +// about audit logs, see the Logging documentation +// (https://cloud.google.com/logging/docs/audit). func (r *IamPoliciesService) QueryAuditableServices(queryauditableservicesrequest *QueryAuditableServicesRequest) *IamPoliciesQueryAuditableServicesCall { c := &IamPoliciesQueryAuditableServicesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.queryauditableservicesrequest = queryauditableservicesrequest @@ -5622,7 +5641,9 @@ type ProjectsServiceAccountsGetIamPolicyCall struct { // check whether a service account has role grants on a resource, use // the `getIamPolicy` method for that resource. For example, to view the // role grants for a project, call the Resource Manager API's -// `projects.getIamPolicy` method. +// `projects.getIamPolicy` +// (https://cloud.google.com/resource-manager/reference/rest/v1/projects/ +// getIamPolicy) method. func (r *ProjectsServiceAccountsService) GetIamPolicy(resource string) *ProjectsServiceAccountsGetIamPolicyCall { c := &ProjectsServiceAccountsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -5636,7 +5657,8 @@ func (r *ProjectsServiceAccountsService) GetIamPolicy(resource string) *Projects // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsServiceAccountsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsServiceAccountsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -6116,7 +6138,9 @@ type ProjectsServiceAccountsSetIamPolicyCall struct { // Edit the policy so that it binds the service account to an IAM role // for the resource. 3. Call the resource's `setIamPolicy` method to // update its IAM policy. For detailed instructions, see Granting roles -// to a service account for specific resources. +// to a service account for specific resources +// (https://cloud.google.com/iam/help/service-accounts/granting-access-to +// -service-accounts). func (r *ProjectsServiceAccountsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsServiceAccountsSetIamPolicyCall { c := &ProjectsServiceAccountsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -6257,10 +6281,13 @@ type ProjectsServiceAccountsSignBlobCall struct { } // SignBlob: **Note:** This method is deprecated and will stop working -// on July 1, 2021. Use the `signBlob` method in the IAM Service Account -// Credentials API instead. If you currently use this method, see the -// migration guide for instructions. Signs a blob using the -// system-managed private key for a ServiceAccount. +// on July 1, 2021. Use the `signBlob` +// (https://cloud.google.com/iam/help/rest-credentials/v1/projects.servic +// eAccounts/signBlob) method in the IAM Service Account Credentials API +// instead. If you currently use this method, see the migration guide +// (https://cloud.google.com/iam/help/credentials/migrate-api) for +// instructions. Signs a blob using the system-managed private key for a +// ServiceAccount. func (r *ProjectsServiceAccountsService) SignBlob(name string, signblobrequest *SignBlobRequest) *ProjectsServiceAccountsSignBlobCall { c := &ProjectsServiceAccountsSignBlobCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6401,10 +6428,13 @@ type ProjectsServiceAccountsSignJwtCall struct { } // SignJwt: **Note:** This method is deprecated and will stop working on -// July 1, 2021. Use the `signJwt` method in the IAM Service Account -// Credentials API instead. If you currently use this method, see the -// migration guide for instructions. Signs a JSON Web Token (JWT) using -// the system-managed private key for a ServiceAccount. +// July 1, 2021. Use the `signJwt` +// (https://cloud.google.com/iam/help/rest-credentials/v1/projects.servic +// eAccounts/signJwt) method in the IAM Service Account Credentials API +// instead. If you currently use this method, see the migration guide +// (https://cloud.google.com/iam/help/credentials/migrate-api) for +// instructions. Signs a JSON Web Token (JWT) using the system-managed +// private key for a ServiceAccount. func (r *ProjectsServiceAccountsService) SignJwt(name string, signjwtrequest *SignJwtRequest) *ProjectsServiceAccountsSignJwtCall { c := &ProjectsServiceAccountsSignJwtCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7900,18 +7930,24 @@ func (c *RolesListCall) PageToken(pageToken string) *RolesListCall { } // Parent sets the optional parameter "parent": The `parent` parameter's -// value depends on the target resource for the request, namely `roles`, -// `projects`, or `organizations`. Each resource type's `parent` value -// format is described below: * `roles.list()`: An empty string. This -// method doesn't require a resource; it simply returns all predefined -// roles in Cloud IAM. Example request URL: -// `https://iam.googleapis.com/v1/roles` * `projects.roles.list()`: +// value depends on the target resource for the request, namely `roles` +// (/iam/reference/rest/v1/roles), `projects` +// (/iam/reference/rest/v1/projects.roles), or `organizations` +// (/iam/reference/rest/v1/organizations.roles). Each resource type's +// `parent` value format is described below: * `roles.list()` +// (/iam/reference/rest/v1/roles/list): An empty string. This method +// doesn't require a resource; it simply returns all predefined roles +// (/iam/docs/understanding-roles#predefined_roles) in Cloud IAM. +// Example request URL: `https://iam.googleapis.com/v1/roles` * +// `projects.roles.list()` (/iam/reference/rest/v1/projects.roles/list): // `projects/{PROJECT_ID}`. This method lists all project-level custom -// roles. Example request URL: +// roles (/iam/docs/understanding-custom-roles). Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * -// `organizations.roles.list()`: `organizations/{ORGANIZATION_ID}`. This -// method lists all organization-level custom roles. Example request -// URL: +// `organizations.roles.list()` +// (/iam/reference/rest/v1/organizations.roles/list): +// `organizations/{ORGANIZATION_ID}`. This method lists all +// organization-level custom roles +// (/iam/docs/understanding-custom-roles). Example request URL: // `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` // Note: Wildcard (*) values are invalid; you must specify a complete // project ID or organization ID. diff --git a/iap/v1/iap-gen.go b/iap/v1/iap-gen.go index 47bf0b035dd..996293d4536 100644 --- a/iap/v1/iap-gen.go +++ b/iap/v1/iap-gen.go @@ -299,7 +299,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -623,7 +624,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -848,7 +850,9 @@ func (s *OAuthSettings) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -867,7 +871,7 @@ func (s *OAuthSettings) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -903,7 +907,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1124,7 +1129,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/iap/v1beta1/iap-gen.go b/iap/v1beta1/iap-gen.go index 5e92ba26662..dbceba56b0c 100644 --- a/iap/v1beta1/iap-gen.go +++ b/iap/v1beta1/iap-gen.go @@ -152,7 +152,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -313,7 +314,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -353,7 +355,9 @@ func (s *GetPolicyOptions) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -372,7 +376,7 @@ func (s *GetPolicyOptions) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -408,7 +412,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -474,7 +479,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/jobs/v3/jobs-gen.go b/jobs/v3/jobs-gen.go index 1ff7c1b35e8..f79ea4fdd06 100644 --- a/jobs/v3/jobs-gen.go +++ b/jobs/v3/jobs-gen.go @@ -1753,10 +1753,11 @@ type Job struct { // LanguageCode: Optional. The language of the posting. This field is // distinct from any requirements for fluency that are associated with // the job. Language codes must be in BCP-47 format, such as "en-US" or - // "sr-Latn". For more information, see Tags for Identifying Languages{: - // class="external" target="_blank" }. If this field is unspecified and - // Job.description is present, detected language code based on - // Job.description is assigned, otherwise defaults to 'en_US'. + // "sr-Latn". For more information, see Tags for Identifying Languages + // (https://tools.ietf.org/html/bcp47){: class="external" + // target="_blank" }. If this field is unspecified and Job.description + // is present, detected language code based on Job.description is + // assigned, otherwise defaults to 'en_US'. LanguageCode string `json:"languageCode,omitempty"` // Name: Required during job update. The resource name for the job. This @@ -2273,8 +2274,9 @@ type JobQuery struct { // search against, for example, "en-US". If a value isn't specified, the // search results can contain jobs in any locale. Language codes should // be in BCP-47 format, such as "en-US" or "sr-Latn". For more - // information, see Tags for Identifying Languages. At most 10 language - // code filters are allowed. + // information, see Tags for Identifying Languages + // (https://tools.ietf.org/html/bcp47). At most 10 language code filters + // are allowed. LanguageCodes []string `json:"languageCodes,omitempty"` // LocationFilters: Optional. The location filter specifies geo-regions @@ -2302,7 +2304,7 @@ type JobQuery struct { // specified, the query language code is automatically detected, which // may not be accurate. Language code should be in BCP-47 format, such // as "en-US" or "sr-Latn". For more information, see Tags for - // Identifying Languages. + // Identifying Languages (https://tools.ietf.org/html/bcp47). QueryLanguageCode string `json:"queryLanguageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "CommuteFilter") to @@ -3673,14 +3675,14 @@ func (c *ProjectsCompleteCall) CompanyName(companyName string) *ProjectsComplete // LanguageCode sets the optional parameter "languageCode": Deprecated. // Use language_codes instead. The language of the query. This is the // BCP-47 language code, such as "en-US" or "sr-Latn". For more -// information, see Tags for Identifying Languages. For -// CompletionType.JOB_TITLE type, only open jobs with the same -// language_code are returned. For CompletionType.COMPANY_NAME type, -// only companies having open jobs with the same language_code are -// returned. For CompletionType.COMBINED type, only open jobs with the -// same language_code or companies having open jobs with the same -// language_code are returned. The maximum number of allowed characters -// is 255. +// information, see Tags for Identifying Languages +// (https://tools.ietf.org/html/bcp47). For CompletionType.JOB_TITLE +// type, only open jobs with the same language_code are returned. For +// CompletionType.COMPANY_NAME type, only companies having open jobs +// with the same language_code are returned. For CompletionType.COMBINED +// type, only open jobs with the same language_code or companies having +// open jobs with the same language_code are returned. The maximum +// number of allowed characters is 255. func (c *ProjectsCompleteCall) LanguageCode(languageCode string) *ProjectsCompleteCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -3689,11 +3691,12 @@ func (c *ProjectsCompleteCall) LanguageCode(languageCode string) *ProjectsComple // LanguageCodes sets the optional parameter "languageCodes": The list // of languages of the query. This is the BCP-47 language code, such as // "en-US" or "sr-Latn". For more information, see Tags for Identifying -// Languages. For CompletionType.JOB_TITLE type, only open jobs with the -// same language_codes are returned. For CompletionType.COMPANY_NAME -// type, only companies having open jobs with the same language_codes -// are returned. For CompletionType.COMBINED type, only open jobs with -// the same language_codes or companies having open jobs with the same +// Languages (https://tools.ietf.org/html/bcp47). For +// CompletionType.JOB_TITLE type, only open jobs with the same +// language_codes are returned. For CompletionType.COMPANY_NAME type, +// only companies having open jobs with the same language_codes are +// returned. For CompletionType.COMBINED type, only open jobs with the +// same language_codes or companies having open jobs with the same // language_codes are returned. The maximum number of allowed characters // is 255. func (c *ProjectsCompleteCall) LanguageCodes(languageCodes ...string) *ProjectsCompleteCall { @@ -3942,8 +3945,10 @@ type ProjectsClientEventsCreateCall struct { // Create: Report events issued when end user interacts with customer's // application that uses Cloud Talent Solution. You may inspect the -// created events in self service tools. Learn more about self service -// tools. +// created events in self service tools +// (https://console.cloud.google.com/talent-solution/overview). Learn +// more (https://cloud.google.com/talent-solution/docs/management-tools) +// about self service tools. func (r *ProjectsClientEventsService) Create(parent string, createclienteventrequest *CreateClientEventRequest) *ProjectsClientEventsCreateCall { c := &ProjectsClientEventsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/jobs/v3p1beta1/jobs-gen.go b/jobs/v3p1beta1/jobs-gen.go index b3eb51e1cdc..a8bb272cab4 100644 --- a/jobs/v3p1beta1/jobs-gen.go +++ b/jobs/v3p1beta1/jobs-gen.go @@ -1967,10 +1967,11 @@ type Job struct { // LanguageCode: Optional. The language of the posting. This field is // distinct from any requirements for fluency that are associated with // the job. Language codes must be in BCP-47 format, such as "en-US" or - // "sr-Latn". For more information, see Tags for Identifying Languages{: - // class="external" target="_blank" }. If this field is unspecified and - // Job.description is present, detected language code based on - // Job.description is assigned, otherwise defaults to 'en_US'. + // "sr-Latn". For more information, see Tags for Identifying Languages + // (https://tools.ietf.org/html/bcp47){: class="external" + // target="_blank" }. If this field is unspecified and Job.description + // is present, detected language code based on Job.description is + // assigned, otherwise defaults to 'en_US'. LanguageCode string `json:"languageCode,omitempty"` // Name: Required during job update. The resource name for the job. This @@ -2492,8 +2493,9 @@ type JobQuery struct { // search against, for example, "en-US". If a value isn't specified, the // search results can contain jobs in any locale. Language codes should // be in BCP-47 format, such as "en-US" or "sr-Latn". For more - // information, see Tags for Identifying Languages. At most 10 language - // code filters are allowed. + // information, see Tags for Identifying Languages + // (https://tools.ietf.org/html/bcp47). At most 10 language code filters + // are allowed. LanguageCodes []string `json:"languageCodes,omitempty"` // LocationFilters: Optional. The location filter specifies geo-regions @@ -2521,7 +2523,7 @@ type JobQuery struct { // specified, the query language code is automatically detected, which // may not be accurate. Language code should be in BCP-47 format, such // as "en-US" or "sr-Latn". For more information, see Tags for - // Identifying Languages. + // Identifying Languages (https://tools.ietf.org/html/bcp47). QueryLanguageCode string `json:"queryLanguageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "CommuteFilter") to @@ -3808,10 +3810,11 @@ func (s *SpellingCorrection) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4028,14 +4031,14 @@ func (c *ProjectsCompleteCall) CompanyName(companyName string) *ProjectsComplete // LanguageCode sets the optional parameter "languageCode": Deprecated. // Use language_codes instead. The language of the query. This is the // BCP-47 language code, such as "en-US" or "sr-Latn". For more -// information, see Tags for Identifying Languages. For -// CompletionType.JOB_TITLE type, only open jobs with the same -// language_code are returned. For CompletionType.COMPANY_NAME type, -// only companies having open jobs with the same language_code are -// returned. For CompletionType.COMBINED type, only open jobs with the -// same language_code or companies having open jobs with the same -// language_code are returned. The maximum number of allowed characters -// is 255. +// information, see Tags for Identifying Languages +// (https://tools.ietf.org/html/bcp47). For CompletionType.JOB_TITLE +// type, only open jobs with the same language_code are returned. For +// CompletionType.COMPANY_NAME type, only companies having open jobs +// with the same language_code are returned. For CompletionType.COMBINED +// type, only open jobs with the same language_code or companies having +// open jobs with the same language_code are returned. The maximum +// number of allowed characters is 255. func (c *ProjectsCompleteCall) LanguageCode(languageCode string) *ProjectsCompleteCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -4044,11 +4047,12 @@ func (c *ProjectsCompleteCall) LanguageCode(languageCode string) *ProjectsComple // LanguageCodes sets the optional parameter "languageCodes": The list // of languages of the query. This is the BCP-47 language code, such as // "en-US" or "sr-Latn". For more information, see Tags for Identifying -// Languages. For CompletionType.JOB_TITLE type, only open jobs with the -// same language_codes are returned. For CompletionType.COMPANY_NAME -// type, only companies having open jobs with the same language_codes -// are returned. For CompletionType.COMBINED type, only open jobs with -// the same language_codes or companies having open jobs with the same +// Languages (https://tools.ietf.org/html/bcp47). For +// CompletionType.JOB_TITLE type, only open jobs with the same +// language_codes are returned. For CompletionType.COMPANY_NAME type, +// only companies having open jobs with the same language_codes are +// returned. For CompletionType.COMBINED type, only open jobs with the +// same language_codes or companies having open jobs with the same // language_codes are returned. The maximum number of allowed characters // is 255. func (c *ProjectsCompleteCall) LanguageCodes(languageCodes ...string) *ProjectsCompleteCall { @@ -4297,8 +4301,10 @@ type ProjectsClientEventsCreateCall struct { // Create: Report events issued when end user interacts with customer's // application that uses Cloud Talent Solution. You may inspect the -// created events in self service tools. Learn more about self service -// tools. +// created events in self service tools +// (https://console.cloud.google.com/talent-solution/overview). Learn +// more (https://cloud.google.com/talent-solution/docs/management-tools) +// about self service tools. func (r *ProjectsClientEventsService) Create(parent string, createclienteventrequest *CreateClientEventRequest) *ProjectsClientEventsCreateCall { c := &ProjectsClientEventsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/jobs/v4/jobs-gen.go b/jobs/v4/jobs-gen.go index bb9a789e5ac..c5d3c302e46 100644 --- a/jobs/v4/jobs-gen.go +++ b/jobs/v4/jobs-gen.go @@ -1584,10 +1584,11 @@ type Job struct { // LanguageCode: The language of the posting. This field is distinct // from any requirements for fluency that are associated with the job. // Language codes must be in BCP-47 format, such as "en-US" or - // "sr-Latn". For more information, see Tags for Identifying Languages{: - // class="external" target="_blank" }. If this field is unspecified and - // Job.description is present, detected language code based on - // Job.description is assigned, otherwise defaults to 'en_US'. + // "sr-Latn". For more information, see Tags for Identifying Languages + // (https://tools.ietf.org/html/bcp47){: class="external" + // target="_blank" }. If this field is unspecified and Job.description + // is present, detected language code based on Job.description is + // assigned, otherwise defaults to 'en_US'. LanguageCode string `json:"languageCode,omitempty"` // Name: Required during job update. The resource name for the job. This @@ -2113,7 +2114,8 @@ type JobQuery struct { // against, for example, "en-US". If a value isn't specified, the search // results can contain jobs in any locale. Language codes should be in // BCP-47 format, such as "en-US" or "sr-Latn". For more information, - // see Tags for Identifying Languages. At most 10 language code filters + // see Tags for Identifying Languages + // (https://tools.ietf.org/html/bcp47). At most 10 language code filters // are allowed. LanguageCodes []string `json:"languageCodes,omitempty"` @@ -2142,7 +2144,7 @@ type JobQuery struct { // specified, the query language code is automatically detected, which // may not be accurate. Language code should be in BCP-47 format, such // as "en-US" or "sr-Latn". For more information, see Tags for - // Identifying Languages. + // Identifying Languages (https://tools.ietf.org/html/bcp47). QueryLanguageCode string `json:"queryLanguageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "CommuteFilter") to @@ -3464,10 +3466,11 @@ func (s *SpellingCorrection) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3655,7 +3658,8 @@ func (c *ProjectsTenantsCompleteQueryCall) Company(company string) *ProjectsTena // LanguageCodes sets the optional parameter "languageCodes": The list // of languages of the query. This is the BCP-47 language code, such as // "en-US" or "sr-Latn". For more information, see Tags for Identifying -// Languages. The maximum number of allowed characters is 255. +// Languages (https://tools.ietf.org/html/bcp47). The maximum number of +// allowed characters is 255. func (c *ProjectsTenantsCompleteQueryCall) LanguageCodes(languageCodes ...string) *ProjectsTenantsCompleteQueryCall { c.urlParams_.SetMulti("languageCodes", append([]string{}, languageCodes...)) return c @@ -4670,8 +4674,10 @@ type ProjectsTenantsClientEventsCreateCall struct { // Create: Report events issued when end user interacts with customer's // application that uses Cloud Talent Solution. You may inspect the -// created events in self service tools. Learn more about self service -// tools. +// created events in self service tools +// (https://console.cloud.google.com/talent-solution/overview). Learn +// more (https://cloud.google.com/talent-solution/docs/management-tools) +// about self service tools. func (r *ProjectsTenantsClientEventsService) Create(parent string, clientevent *ClientEvent) *ProjectsTenantsClientEventsCreateCall { c := &ProjectsTenantsClientEventsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/language/v1/language-gen.go b/language/v1/language-gen.go index e459b17f21c..531ed67860f 100644 --- a/language/v1/language-gen.go +++ b/language/v1/language-gen.go @@ -610,7 +610,8 @@ type ClassificationCategory struct { Confidence float64 `json:"confidence,omitempty"` // Name: The name of the category representing the document, from the - // predefined taxonomy. + // predefined taxonomy + // (https://cloud.google.com/natural-language/docs/categories). Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -852,10 +853,12 @@ type Document struct { // Language: The language of the document (if not specified, the // language is automatically detected). Both ISO and BCP-47 language - // codes are accepted. Language Support lists currently supported - // languages for each API method. If the language (either specified by - // the caller or automatically detected) is not supported by the called - // API method, an `INVALID_ARGUMENT` error is returned. + // codes are accepted. Language Support + // (https://cloud.google.com/natural-language/docs/languages) lists + // currently supported languages for each API method. If the language + // (either specified by the caller or automatically detected) is not + // supported by the called API method, an `INVALID_ARGUMENT` error is + // returned. Language string `json:"language,omitempty"` // Type: Required. If the type is not set or is `TYPE_UNSPECIFIED`, @@ -1343,10 +1346,11 @@ func (s *Sentiment) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1422,7 +1426,8 @@ type Token struct { // DependencyEdge: Dependency tree parse for this token. DependencyEdge *DependencyEdge `json:"dependencyEdge,omitempty"` - // Lemma: Lemma of the token. + // Lemma: Lemma (https://en.wikipedia.org/wiki/Lemma_%28morphology%29) + // of the token. Lemma string `json:"lemma,omitempty"` // PartOfSpeech: Parts of speech tag for this token. diff --git a/language/v1beta1/language-gen.go b/language/v1beta1/language-gen.go index d295f90b7e5..4754c76e78c 100644 --- a/language/v1beta1/language-gen.go +++ b/language/v1beta1/language-gen.go @@ -655,10 +655,12 @@ type Document struct { // Language: The language of the document (if not specified, the // language is automatically detected). Both ISO and BCP-47 language - // codes are accepted. Language Support lists currently supported - // languages for each API method. If the language (either specified by - // the caller or automatically detected) is not supported by the called - // API method, an `INVALID_ARGUMENT` error is returned. + // codes are accepted. Language Support + // (https://cloud.google.com/natural-language/docs/languages) lists + // currently supported languages for each API method. If the language + // (either specified by the caller or automatically detected) is not + // supported by the called API method, an `INVALID_ARGUMENT` error is + // returned. Language string `json:"language,omitempty"` // Type: Required. If the type is not set or is `TYPE_UNSPECIFIED`, @@ -1112,10 +1114,11 @@ func (s *Sentiment) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1191,7 +1194,8 @@ type Token struct { // DependencyEdge: Dependency tree parse for this token. DependencyEdge *DependencyEdge `json:"dependencyEdge,omitempty"` - // Lemma: Lemma of the token. + // Lemma: Lemma (https://en.wikipedia.org/wiki/Lemma_%28morphology%29) + // of the token. Lemma string `json:"lemma,omitempty"` // PartOfSpeech: Parts of speech tag for this token. diff --git a/language/v1beta2/language-gen.go b/language/v1beta2/language-gen.go index 9818a7b73a6..e2828c3776e 100644 --- a/language/v1beta2/language-gen.go +++ b/language/v1beta2/language-gen.go @@ -610,7 +610,8 @@ type ClassificationCategory struct { Confidence float64 `json:"confidence,omitempty"` // Name: The name of the category representing the document, from the - // predefined taxonomy. + // predefined taxonomy + // (https://cloud.google.com/natural-language/docs/categories). Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -864,10 +865,12 @@ type Document struct { // Language: The language of the document (if not specified, the // language is automatically detected). Both ISO and BCP-47 language - // codes are accepted. Language Support lists currently supported - // languages for each API method. If the language (either specified by - // the caller or automatically detected) is not supported by the called - // API method, an `INVALID_ARGUMENT` error is returned. + // codes are accepted. Language Support + // (https://cloud.google.com/natural-language/docs/languages) lists + // currently supported languages for each API method. If the language + // (either specified by the caller or automatically detected) is not + // supported by the called API method, an `INVALID_ARGUMENT` error is + // returned. Language string `json:"language,omitempty"` // ReferenceWebUri: The web URI where the document comes from. This URI @@ -1058,7 +1061,8 @@ func (s *EntityMention) MarshalJSON() ([]byte, error) { type Features struct { // ClassifyText: Classify the full document into categories. If this is // true, the API will use the default model which classifies into a - // predefined taxonomy. + // predefined taxonomy + // (https://cloud.google.com/natural-language/docs/categories). ClassifyText bool `json:"classifyText,omitempty"` // ExtractDocumentSentiment: Extract document-level sentiment. @@ -1361,10 +1365,11 @@ func (s *Sentiment) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1440,7 +1445,8 @@ type Token struct { // DependencyEdge: Dependency tree parse for this token. DependencyEdge *DependencyEdge `json:"dependencyEdge,omitempty"` - // Lemma: Lemma of the token. + // Lemma: Lemma (https://en.wikipedia.org/wiki/Lemma_%28morphology%29) + // of the token. Lemma string `json:"lemma,omitempty"` // PartOfSpeech: Parts of speech tag for this token. diff --git a/lifesciences/v2beta/lifesciences-gen.go b/lifesciences/v2beta/lifesciences-gen.go index aa86d3495bc..da1e5cbe1d3 100644 --- a/lifesciences/v2beta/lifesciences-gen.go +++ b/lifesciences/v2beta/lifesciences-gen.go @@ -1461,10 +1461,11 @@ func (s *ServiceAccount) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1588,10 +1589,12 @@ type VirtualMachine struct { // Labels: Optional set of labels to apply to the VM and any attached // disk resources. These labels must adhere to the name and value - // restrictions on VM labels imposed by Compute Engine. Labels keys with - // the prefix 'google-' are reserved for use by Google. Labels applied - // at creation time to the VM. Applied on a best-effort basis to - // attached disk resources shortly after VM creation. + // restrictions + // (https://cloud.google.com/compute/docs/labeling-resources) on VM + // labels imposed by Compute Engine. Labels keys with the prefix + // 'google-' are reserved for use by Google. Labels applied at creation + // time to the VM. Applied on a best-effort basis to attached disk + // resources shortly after VM creation. Labels map[string]string `json:"labels,omitempty"` // MachineType: Required. The machine type of the virtual machine to @@ -1599,7 +1602,9 @@ type VirtualMachine struct { // "n1-standard-1") or a custom machine type (such as "custom-1-4096", // where "1" indicates the number of vCPUs and "4096" indicates the // memory in MB). See Creating an instance with a custom machine type - // for more specifications on creating a custom machine type. + // (https://cloud.google.com/compute/docs/instances/creating-instance-wit + // h-custom-machine-type#create) for more specifications on creating a + // custom machine type. MachineType string `json:"machineType,omitempty"` // Network: The VM network configuration. @@ -2117,8 +2122,8 @@ type ProjectsLocationsOperationsCancelCall struct { // is not guaranteed. Clients may use Operations.GetOperation or // Operations.ListOperations to check whether the cancellation succeeded // or the operation completed despite cancellation. Authorization -// requires the following Google IAM permission: * -// `lifesciences.operations.cancel` +// requires the following Google IAM (https://cloud.google.com/iam) +// permission: * `lifesciences.operations.cancel` func (r *ProjectsLocationsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *ProjectsLocationsOperationsCancelCall { c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2261,7 +2266,8 @@ type ProjectsLocationsOperationsGetCall struct { // Get: Gets the latest state of a long-running operation. Clients can // use this method to poll the operation result at intervals as // recommended by the API service. Authorization requires the following -// Google IAM permission: * `lifesciences.operations.get` +// Google IAM (https://cloud.google.com/iam) permission: * +// `lifesciences.operations.get` func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { c := &ProjectsLocationsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2406,8 +2412,9 @@ type ProjectsLocationsOperationsListCall struct { } // List: Lists operations that match the specified filter in the -// request. Authorization requires the following Google IAM permission: -// * `lifesciences.operations.list` +// request. Authorization requires the following Google IAM +// (https://cloud.google.com/iam) permission: * +// `lifesciences.operations.list` func (r *ProjectsLocationsOperationsService) List(name string) *ProjectsLocationsOperationsListCall { c := &ProjectsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2627,7 +2634,8 @@ type ProjectsLocationsPipelinesRunCall struct { // is first enabled, but if you delete this permission you must disable // and re-enable the API to grant the Life Sciences Service Agent the // required permissions. Authorization requires the following Google IAM -// permission: * `lifesciences.workflows.run` +// (https://cloud.google.com/iam/) permission: * +// `lifesciences.workflows.run` func (r *ProjectsLocationsPipelinesService) Run(parent string, runpipelinerequest *RunPipelineRequest) *ProjectsLocationsPipelinesRunCall { c := &ProjectsLocationsPipelinesRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/localservices/v1/localservices-gen.go b/localservices/v1/localservices-gen.go index 76da2727dc6..b5b028e4ab6 100644 --- a/localservices/v1/localservices-gen.go +++ b/localservices/v1/localservices-gen.go @@ -564,7 +564,7 @@ func (s *GoogleAdsHomeservicesLocalservicesV1SearchDetailedLeadReportsResponse) } // GoogleTypeTimeZone: Represents a time zone from the IANA Time Zone -// Database. +// Database (https://www.iana.org/time-zones). type GoogleTypeTimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` diff --git a/managedidentities/v1/managedidentities-gen.go b/managedidentities/v1/managedidentities-gen.go index e07d6004d42..acd8f281044 100644 --- a/managedidentities/v1/managedidentities-gen.go +++ b/managedidentities/v1/managedidentities-gen.go @@ -228,7 +228,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -458,10 +459,11 @@ type Domain struct { Admin string `json:"admin,omitempty"` // AuthorizedNetworks: Optional. The full names of the Google Compute - // Engine networks the domain instance is connected to. Networks can be - // added using UpdateDomain. The domain is only available on networks - // listed in `authorized_networks`. If CIDR subnets overlap between - // networks, domain creation will fail. + // Engine networks (/compute/docs/networks-and-firewalls#networks) the + // domain instance is connected to. Networks can be added using + // UpdateDomain. The domain is only available on networks listed in + // `authorized_networks`. If CIDR subnets overlap between networks, + // domain creation will fail. AuthorizedNetworks []string `json:"authorizedNetworks,omitempty"` // CreateTime: Output only. The time the instance was created. @@ -1563,7 +1565,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1582,7 +1586,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1618,7 +1622,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1797,10 +1802,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1843,7 +1849,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3225,7 +3232,8 @@ func (r *ProjectsLocationsGlobalDomainsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGlobalDomainsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -3390,7 +3398,9 @@ func (c *ProjectsLocationsGlobalDomainsListCall) Filter(filter string) *Projects } // OrderBy sets the optional parameter "orderBy": Specifies the ordering -// of results. See Sorting order for more information. +// of results. See Sorting order +// (https://cloud.google.com/apis/design/design_patterns#sorting_order) +// for more information. func (c *ProjectsLocationsGlobalDomainsListCall) OrderBy(orderBy string) *ProjectsLocationsGlobalDomainsListCall { c.urlParams_.Set("orderBy", orderBy) return c diff --git a/managedidentities/v1alpha1/managedidentities-gen.go b/managedidentities/v1alpha1/managedidentities-gen.go index db69dd57166..0328ecd2b19 100644 --- a/managedidentities/v1alpha1/managedidentities-gen.go +++ b/managedidentities/v1alpha1/managedidentities-gen.go @@ -239,7 +239,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -462,11 +463,11 @@ func (s *DetachTrustRequest) MarshalJSON() ([]byte, error) { // reconciled. At this point, Get will reflect an intermediate state. type Domain struct { // AuthorizedNetworks: Optional. The full names of the Google Compute - // Engine networks to which the instance is connected. Network can be - // added using UpdateDomain later. Domain is only available on network - // part of authorized_networks. Caller needs to make sure that CIDR - // subnets do not overlap between networks, else domain creation will - // fail. + // Engine networks (/compute/docs/networks-and-firewalls#networks) to + // which the instance is connected. Network can be added using + // UpdateDomain later. Domain is only available on network part of + // authorized_networks. Caller needs to make sure that CIDR subnets do + // not overlap between networks, else domain creation will fail. AuthorizedNetworks []string `json:"authorizedNetworks,omitempty"` // CreateTime: Output only. The time the instance was created. Synthetic @@ -1618,7 +1619,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1637,7 +1640,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1673,7 +1676,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1898,10 +1902,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1944,7 +1949,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3324,7 +3330,8 @@ func (r *ProjectsLocationsGlobalDomainsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGlobalDomainsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/managedidentities/v1beta1/managedidentities-gen.go b/managedidentities/v1beta1/managedidentities-gen.go index 3202dce1617..834c9bcd848 100644 --- a/managedidentities/v1beta1/managedidentities-gen.go +++ b/managedidentities/v1beta1/managedidentities-gen.go @@ -240,7 +240,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -470,10 +471,11 @@ type Domain struct { Admin string `json:"admin,omitempty"` // AuthorizedNetworks: Optional. The full names of the Google Compute - // Engine networks the domain instance is connected to. Networks can be - // added using UpdateDomain. The domain is only available on networks - // listed in `authorized_networks`. If CIDR subnets overlap between - // networks, domain creation will fail. + // Engine networks (/compute/docs/networks-and-firewalls#networks) the + // domain instance is connected to. Networks can be added using + // UpdateDomain. The domain is only available on networks listed in + // `authorized_networks`. If CIDR subnets overlap between networks, + // domain creation will fail. AuthorizedNetworks []string `json:"authorizedNetworks,omitempty"` // CreateTime: Output only. The time the instance was created. @@ -1615,7 +1617,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1634,7 +1638,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1670,7 +1674,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1904,10 +1909,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1950,7 +1956,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3327,7 +3334,8 @@ func (r *ProjectsLocationsGlobalDomainsService) GetIamPolicy(resource string) *P // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGlobalDomainsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -3492,7 +3500,9 @@ func (c *ProjectsLocationsGlobalDomainsListCall) Filter(filter string) *Projects } // OrderBy sets the optional parameter "orderBy": Specifies the ordering -// of results. See Sorting order for more information. +// of results. See Sorting order +// (https://cloud.google.com/apis/design/design_patterns#sorting_order) +// for more information. func (c *ProjectsLocationsGlobalDomainsListCall) OrderBy(orderBy string) *ProjectsLocationsGlobalDomainsListCall { c.urlParams_.Set("orderBy", orderBy) return c diff --git a/memcache/v1beta2/memcache-gen.go b/memcache/v1beta2/memcache-gen.go index f58c58fe0d8..cad3a4e9edc 100644 --- a/memcache/v1beta2/memcache-gen.go +++ b/memcache/v1beta2/memcache-gen.go @@ -864,8 +864,8 @@ func (s *GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata) MarshalJSON type Instance struct { // AuthorizedNetwork: The full name of the Google Compute Engine network - // to which the instance is connected. If left unspecified, the - // `default` network will be used. + // (https://cloud.google.com/vpc/docs/vpc) to which the instance is + // connected. If left unspecified, the `default` network will be used. AuthorizedNetwork string `json:"authorizedNetwork,omitempty"` // CreateTime: Output only. The time the instance was created. @@ -1497,10 +1497,11 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/ml/v1/ml-gen.go b/ml/v1/ml-gen.go index 116742fc911..3d839798428 100644 --- a/ml/v1/ml-gen.go +++ b/ml/v1/ml-gen.go @@ -871,8 +871,9 @@ func (s *GoogleCloudMlV1TrialParameter) UnmarshalJSON(data []byte) error { // GoogleCloudMlV1__AcceleratorConfig: Represents a hardware accelerator // request config. Note that the AcceleratorConfig can be used in both -// Jobs and Versions. Learn more about accelerators for training and -// accelerators for online prediction. +// Jobs and Versions. Learn more about accelerators for training +// (/ml-engine/docs/using-gpus) and accelerators for online prediction +// (/ml-engine/docs/machine-types-online-prediction#gpus). type GoogleCloudMlV1__AcceleratorConfig struct { // Count: The number of accelerators to attach to each machine running // the job. @@ -961,24 +962,28 @@ type GoogleCloudMlV1__AutoScaling struct { // deployed. Therefore, the cost of operating this model will be at // least `rate` * `min_nodes` * number of hours since last billing // cycle, where `rate` is the cost per node-hour as documented in the - // pricing guide, even if no predictions are performed. There is - // additional cost for each prediction performed. Unlike manual scaling, - // if the load gets too heavy for the nodes that are up, the service - // will automatically add nodes to handle the increased load as well as - // scale back as traffic drops, always maintaining at least `min_nodes`. - // You will be charged for the time in which additional nodes are used. - // If `min_nodes` is not specified and AutoScaling is used with a legacy - // (MLS1) machine type, `min_nodes` defaults to 0, in which case, when - // traffic to a model stops (and after a cool-down period), nodes will - // be shut down and no charges will be incurred until traffic to the - // model resumes. If `min_nodes` is not specified and AutoScaling is - // used with a Compute Engine (N1) machine type, `min_nodes` defaults to - // 1. `min_nodes` must be at least 1 for use with a Compute Engine - // machine type. Note that you cannot use AutoScaling if your version - // uses GPUs. Instead, you must use ManualScaling. You can set - // `min_nodes` when creating the model version, and you can also update - // `min_nodes` for an existing version: update_body.json: { - // 'autoScaling': { 'minNodes': 5 } } HTTP request: PATCH + // pricing guide (/ml-engine/docs/pricing), even if no predictions are + // performed. There is additional cost for each prediction performed. + // Unlike manual scaling, if the load gets too heavy for the nodes that + // are up, the service will automatically add nodes to handle the + // increased load as well as scale back as traffic drops, always + // maintaining at least `min_nodes`. You will be charged for the time in + // which additional nodes are used. If `min_nodes` is not specified and + // AutoScaling is used with a legacy (MLS1) machine type + // (/ml-engine/docs/machine-types-online-prediction), `min_nodes` + // defaults to 0, in which case, when traffic to a model stops (and + // after a cool-down period), nodes will be shut down and no charges + // will be incurred until traffic to the model resumes. If `min_nodes` + // is not specified and AutoScaling is used with a Compute Engine (N1) + // machine type (/ml-engine/docs/machine-types-online-prediction), + // `min_nodes` defaults to 1. `min_nodes` must be at least 1 for use + // with a Compute Engine machine type. Note that you cannot use + // AutoScaling if your version uses GPUs + // (#Version.FIELDS.accelerator_config). Instead, you must use + // ManualScaling. You can set `min_nodes` when creating the model + // version, and you can also update `min_nodes` for an existing version: + // update_body.json: { 'autoScaling': { 'minNodes': 5 } } HTTP request: + // PATCH // https://ml.googleapis.com/v1/{name=projects/*/models/*/versions/*}?update_mask=autoScaling.minNodes -d @./update_body.json MinNodes int64 `json:"minNodes,omitempty"` @@ -1285,7 +1290,9 @@ func (s *GoogleCloudMlV1__Config) MarshalJSON() ([]byte, error) { // GoogleCloudMlV1__ContainerPort: Represents a network port in a single // container. This message is a subset of the Kubernetes ContainerPort -// v1 core specification. +// v1 core specification +// (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# +// containerport-v1-core). type GoogleCloudMlV1__ContainerPort struct { // ContainerPort: Number of the port to expose on the container. This // must be a valid port number: 0 < PORT_NUMBER < 65536. @@ -1316,56 +1323,75 @@ func (s *GoogleCloudMlV1__ContainerPort) MarshalJSON() ([]byte, error) { // GoogleCloudMlV1__ContainerSpec: Specification of a custom container // for serving predictions. This message is a subset of the Kubernetes -// Container v1 core specification. +// Container v1 core specification +// (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# +// container-v1-core). type GoogleCloudMlV1__ContainerSpec struct { // Args: Immutable. Specifies arguments for the command that runs when - // the container starts. This overrides the container's `CMD`. Specify - // this field as an array of executable and arguments, similar to a - // Docker `CMD`'s "default parameters" form. If you don't specify this - // field but do specify the command field, then the command from the - // `command` field runs without any additional arguments. See the - // Kubernetes documentation about how the `command` and `args` fields - // interact with a container's `ENTRYPOINT` and `CMD`. If you don't - // specify this field and don't specify the `commmand` field, then the - // container's `ENTRYPOINT` and `CMD` determine what runs based on their - // default behavior. See the Docker documentation about how `CMD` and - // `ENTRYPOINT` interact. In this field, you can reference environment - // variables set by AI Platform Prediction and environment variables set - // in the env field. You cannot reference environment variables set in - // the Docker image. In order for environment variables to be expanded, - // reference them by using the following syntax: $( VARIABLE_NAME) Note - // that this differs from Bash variable expansion, which does not use - // parentheses. If a variable cannot be resolved, the reference in the - // input string is used unchanged. To avoid variable expansion, you can - // escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This - // field corresponds to the `args` field of the Kubernetes Containers v1 - // core API. + // the container starts. This overrides the container's `CMD` + // (https://docs.docker.com/engine/reference/builder/#cmd). Specify this + // field as an array of executable and arguments, similar to a Docker + // `CMD`'s "default parameters" form. If you don't specify this field + // but do specify the command field, then the command from the `command` + // field runs without any additional arguments. See the Kubernetes + // documentation about how the `command` and `args` fields interact with + // a container's `ENTRYPOINT` and `CMD` + // (https://kubernetes.io/docs/tasks/inject-data-application/define-comma + // nd-argument-container/#notes). If you don't specify this field and + // don't specify the `commmand` field, then the container's `ENTRYPOINT` + // (https://docs.docker.com/engine/reference/builder/#cmd) and `CMD` + // determine what runs based on their default behavior. See the Docker + // documentation about how `CMD` and `ENTRYPOINT` interact + // (https://docs.docker.com/engine/reference/builder/#understand-how-cmd- + // and-entrypoint-interact). In this field, you can reference + // environment variables set by AI Platform Prediction + // (/ai-platform/prediction/docs/custom-container-requirements#aip-variab + // les) and environment variables set in the env field. You cannot + // reference environment variables set in the Docker image. In order for + // environment variables to be expanded, reference them by using the + // following syntax: $( VARIABLE_NAME) Note that this differs from Bash + // variable expansion, which does not use parentheses. If a variable + // cannot be resolved, the reference in the input string is used + // unchanged. To avoid variable expansion, you can escape this syntax + // with `$$`; for example: $$(VARIABLE_NAME) This field corresponds to + // the `args` field of the Kubernetes Containers v1 core API + // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# + // container-v1-core). Args []string `json:"args,omitempty"` // Command: Immutable. Specifies the command that runs when the - // container starts. This overrides the container's `ENTRYPOINT`. + // container starts. This overrides the container's `ENTRYPOINT` + // (https://docs.docker.com/engine/reference/builder/#entrypoint). // Specify this field as an array of executable and arguments, similar // to a Docker `ENTRYPOINT`'s "exec" form, not its "shell" form. If you // do not specify this field, then the container's `ENTRYPOINT` runs, in - // conjunction with the args field or the container's `CMD`, if either + // conjunction with the args field or the container's `CMD` + // (https://docs.docker.com/engine/reference/builder/#cmd), if either // exists. If this field is not specified and the container does not // have an `ENTRYPOINT`, then refer to the Docker documentation about - // how `CMD` and `ENTRYPOINT` interact. If you specify this field, then - // you can also specify the `args` field to provide additional arguments - // for this command. However, if you specify this field, then the + // how `CMD` and `ENTRYPOINT` interact + // (https://docs.docker.com/engine/reference/builder/#understand-how-cmd- + // and-entrypoint-interact). If you specify this field, then you can + // also specify the `args` field to provide additional arguments for + // this command. However, if you specify this field, then the // container's `CMD` is ignored. See the Kubernetes documentation about // how the `command` and `args` fields interact with a container's - // `ENTRYPOINT` and `CMD`. In this field, you can reference environment - // variables set by AI Platform Prediction and environment variables set - // in the env field. You cannot reference environment variables set in - // the Docker image. In order for environment variables to be expanded, - // reference them by using the following syntax: $( VARIABLE_NAME) Note - // that this differs from Bash variable expansion, which does not use - // parentheses. If a variable cannot be resolved, the reference in the - // input string is used unchanged. To avoid variable expansion, you can - // escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This - // field corresponds to the `command` field of the Kubernetes Containers - // v1 core API. + // `ENTRYPOINT` and `CMD` + // (https://kubernetes.io/docs/tasks/inject-data-application/define-comma + // nd-argument-container/#notes). In this field, you can reference + // environment variables set by AI Platform Prediction + // (/ai-platform/prediction/docs/custom-container-requirements#aip-variab + // les) and environment variables set in the env field. You cannot + // reference environment variables set in the Docker image. In order for + // environment variables to be expanded, reference them by using the + // following syntax: $( VARIABLE_NAME) Note that this differs from Bash + // variable expansion, which does not use parentheses. If a variable + // cannot be resolved, the reference in the input string is used + // unchanged. To avoid variable expansion, you can escape this syntax + // with `$$`; for example: $$(VARIABLE_NAME) This field corresponds to + // the `command` field of the Kubernetes Containers v1 core API + // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# + // container-v1-core). Command []string `json:"command,omitempty"` // Env: Immutable. List of environment variables to set in the @@ -1378,19 +1404,23 @@ type GoogleCloudMlV1__ContainerSpec struct { // "VAR_2", "value": "$(VAR_1) bar" } ] ``` If you switch the order of // the variables in the example, then the expansion does not occur. This // field corresponds to the `env` field of the Kubernetes Containers v1 - // core API. + // core API + // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# + // container-v1-core). Env []*GoogleCloudMlV1__EnvVar `json:"env,omitempty"` // Image: URI of the Docker image to be used as the custom container for // serving predictions. This URI must identify an image in Artifact - // Registry and begin with the hostname `{REGION}-docker.pkg.dev`, where - // `{REGION}` is replaced by the region that matches AI Platform - // Prediction regional endpoint that you are using. For example, if you - // are using the `us-central1-ml.googleapis.com` endpoint, then this URI - // must begin with `us-central1-docker.pkg.dev`. To use a custom - // container, the AI Platform Google-managed service account must have - // permission to pull (read) the Docker image at this URI. The AI - // Platform Google-managed service account has the following format: + // Registry (/artifact-registry/docs/overview) and begin with the + // hostname `{REGION}-docker.pkg.dev`, where `{REGION}` is replaced by + // the region that matches AI Platform Prediction regional endpoint + // (/ai-platform/prediction/docs/regional-endpoints) that you are using. + // For example, if you are using the `us-central1-ml.googleapis.com` + // endpoint, then this URI must begin with `us-central1-docker.pkg.dev`. + // To use a custom container, the AI Platform Google-managed service + // account (/ai-platform/prediction/docs/custom-service-account#default) + // must have permission to pull (read) the Docker image at this URI. The + // AI Platform Google-managed service account has the following format: // `service-{PROJECT_NUMBER}@cloud-ml.google.com.iam.gserviceaccount.com` // {PROJECT_NUMBER} is replaced by your Google Cloud project number. By // default, this service account has necessary permissions to pull an @@ -1398,20 +1428,26 @@ type GoogleCloudMlV1__ContainerSpec struct { // are using AI Platform Prediction. In this case, no configuration is // necessary. If you want to use an image from a different Google Cloud // project, learn how to grant the Artifact Registry Reader - // (roles/artifactregistry.reader) role for a repository to your - // projet's AI Platform Google-managed service account. To learn about - // the requirements for the Docker image itself, read Custom container - // requirements. + // (roles/artifactregistry.reader) role for a repository + // (/artifact-registry/docs/access-control#grant-repo) to your projet's + // AI Platform Google-managed service account. To learn about the + // requirements for the Docker image itself, read Custom container + // requirements + // (/ai-platform/prediction/docs/custom-container-requirements). Image string `json:"image,omitempty"` // Ports: Immutable. List of ports to expose from the container. AI // Platform Prediction sends any prediction requests that it receives to // the first port on this list. AI Platform Prediction also sends - // liveness and health checks to this port. If you do not specify this - // field, it defaults to following value: ```json [ { "containerPort": - // 8080 } ] ``` AI Platform Prediction does not use ports other than the - // first one listed. This field corresponds to the `ports` field of the - // Kubernetes Containers v1 core API. + // liveness and health checks + // (/ai-platform/prediction/docs/custom-container-requirements#health) + // to this port. If you do not specify this field, it defaults to + // following value: ```json [ { "containerPort": 8080 } ] ``` AI + // Platform Prediction does not use ports other than the first one + // listed. This field corresponds to the `ports` field of the Kubernetes + // Containers v1 core API + // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# + // container-v1-core). Ports []*GoogleCloudMlV1__ContainerPort `json:"ports,omitempty"` // ForceSendFields is a list of field names (e.g. "Args") to @@ -1506,23 +1542,29 @@ func (s *GoogleCloudMlV1__EncryptionConfig) MarshalJSON() ([]byte, error) { // GoogleCloudMlV1__EnvVar: Represents an environment variable to be // made available in a container. This message is a subset of the -// Kubernetes EnvVar v1 core specification. +// Kubernetes EnvVar v1 core specification +// (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# +// envvar-v1-core). type GoogleCloudMlV1__EnvVar struct { // Name: Name of the environment variable. Must be a valid C identifier - // and must not begin with the prefix `AIP_`. + // (https://github.com/kubernetes/kubernetes/blob/v1.18.8/staging/src/k8s + // .io/apimachinery/pkg/util/validation/validation.go#L258) and must not + // begin with the prefix `AIP_`. Name string `json:"name,omitempty"` // Value: Value of the environment variable. Defaults to an empty // string. In this field, you can reference environment variables set by - // AI Platform Prediction and environment variables set earlier in the - // same env field as where this message occurs. You cannot reference - // environment variables set in the Docker image. In order for - // environment variables to be expanded, reference them by using the - // following syntax: $(VARIABLE_NAME) Note that this differs from Bash - // variable expansion, which does not use parentheses. If a variable - // cannot be resolved, the reference in the input string is used - // unchanged. To avoid variable expansion, you can escape this syntax - // with `$$`; for example: $$(VARIABLE_NAME) + // AI Platform Prediction + // (/ai-platform/prediction/docs/custom-container-requirements#aip-variab + // les) and environment variables set earlier in the same env field as + // where this message occurs. You cannot reference environment variables + // set in the Docker image. In order for environment variables to be + // expanded, reference them by using the following syntax: + // $(VARIABLE_NAME) Note that this differs from Bash variable expansion, + // which does not use parentheses. If a variable cannot be resolved, the + // reference in the input string is used unchanged. To avoid variable + // expansion, you can escape this syntax with `$$`; for example: + // $$(VARIABLE_NAME) Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -1581,7 +1623,7 @@ func (s *GoogleCloudMlV1__ExplainRequest) MarshalJSON() ([]byte, error) { // options for explaining model predictions. There are three feature // attribution methods supported for TensorFlow models: integrated // gradients, sampled Shapley, and XRAI. Learn more about feature -// attributions. +// attributions. (/ai-platform/prediction/docs/ai-explanations/overview) type GoogleCloudMlV1__ExplanationConfig struct { // IntegratedGradientsAttribution: Attributes credit by computing the // Aumann-Shapley value taking advantage of the model's fully @@ -2384,19 +2426,19 @@ type GoogleCloudMlV1__Model struct { // nodes send `stderr` and `stdout` streams to Cloud Logging. These can // be more verbose than the standard access logs (see // `onlinePredictionLogging`) and can incur higher cost. However, they - // are helpful for debugging. Note that logs may incur a cost, - // especially if your project receives prediction requests at a high - // QPS. Estimate your costs before enabling this option. Default is - // false. + // are helpful for debugging. Note that logs may incur a cost + // (/stackdriver/pricing), especially if your project receives + // prediction requests at a high QPS. Estimate your costs before + // enabling this option. Default is false. OnlinePredictionConsoleLogging bool `json:"onlinePredictionConsoleLogging,omitempty"` // OnlinePredictionLogging: Optional. If true, online prediction access // logs are sent to Cloud Logging. These logs are like standard server // access logs, containing information like timestamp and latency for - // each request. Note that logs may incur a cost, especially if your - // project receives prediction requests at a high queries per second - // rate (QPS). Estimate your costs before enabling this option. Default - // is false. + // each request. Note that logs may incur a cost (/stackdriver/pricing), + // especially if your project receives prediction requests at a high + // queries per second rate (QPS). Estimate your costs before enabling + // this option. Default is false. OnlinePredictionLogging bool `json:"onlinePredictionLogging,omitempty"` // Regions: Optional. The list of regions where the model is going to be @@ -2605,8 +2647,8 @@ func (s *GoogleCloudMlV1__ParameterSpec) UnmarshalJSON(data []byte) error { // against a trained model. type GoogleCloudMlV1__PredictRequest struct { // HttpBody: Required. The prediction request body. Refer to the - // request body details section for more information on how to structure - // your request. + // request body details section (#request-body-details) for more + // information on how to structure your request. HttpBody *GoogleApi__HttpBody `json:"httpBody,omitempty"` // ForceSendFields is a list of field names (e.g. "HttpBody") to @@ -2702,9 +2744,12 @@ type GoogleCloudMlV1__PredictionInput struct { RuntimeVersion string `json:"runtimeVersion,omitempty"` // SignatureName: Optional. The name of the signature defined in the - // SavedModel to use for this job. Please refer to SavedModel for + // SavedModel to use for this job. Please refer to SavedModel + // (https://tensorflow.github.io/serving/serving_basic.html) for // information about how to use signatures. Defaults to - // DEFAULT_SERVING_SIGNATURE_DEF_KEY , which is "serving_default". + // DEFAULT_SERVING_SIGNATURE_DEF_KEY + // (https://www.tensorflow.org/api_docs/python/tf/saved_model/signature_c + // onstants) , which is "serving_default". SignatureName string `json:"signatureName,omitempty"` // Uri: Use this field if you want to specify a Google Cloud Storage @@ -2799,6 +2844,8 @@ type GoogleCloudMlV1__ReplicaConfig struct { // AcceleratorConfig: Represents the type and number of accelerators // used by the replica. Learn about restrictions on accelerator // configurations for training. + // (/ai-platform/training/docs/using-gpus#compute-engine-machine-types-wi + // th-gpu) AcceleratorConfig *GoogleCloudMlV1__AcceleratorConfig `json:"acceleratorConfig,omitempty"` // ContainerArgs: Arguments to the entrypoint command. The following @@ -2828,20 +2875,23 @@ type GoogleCloudMlV1__ReplicaConfig struct { DiskConfig *GoogleCloudMlV1__DiskConfig `json:"diskConfig,omitempty"` // ImageUri: The Docker image to run on the replica. This image must be - // in Container Registry. Learn more about configuring custom - // containers. + // in Container Registry. Learn more about configuring custom containers + // (/ai-platform/training/docs/distributed-training-containers). ImageUri string `json:"imageUri,omitempty"` // TpuTfVersion: The AI Platform runtime version that includes a // TensorFlow version matching the one used in the custom container. // This field is required if the replica is a TPU worker that uses a // custom container. Otherwise, do not specify this field. This must be - // a runtime version that currently supports training with TPUs. Note + // a runtime version that currently supports training with TPUs + // (/ml-engine/docs/tensorflow/runtime-version-list#tpu-support). Note // that the version of TensorFlow included in a runtime version may // differ from the numbering of the runtime version itself, because it - // may have a different patch version. In this field, you must specify - // the runtime version (TensorFlow minor version). For example, if your - // custom container runs TensorFlow `1.x.y`, specify `1.x`. + // may have a different patch version + // (https://www.tensorflow.org/guide/version_compat#semantic_versioning_2 + // 0). In this field, you must specify the runtime version (TensorFlow + // minor version). For example, if your custom container runs TensorFlow + // `1.x.y`, specify `1.x`. TpuTfVersion string `json:"tpuTfVersion,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorConfig") @@ -2872,20 +2922,22 @@ func (s *GoogleCloudMlV1__ReplicaConfig) MarshalJSON() ([]byte, error) { // request-response pairs to a BigQuery table. Online prediction // requests to a model version and the responses to these requests are // converted to raw strings and saved to the specified BigQuery table. -// Logging is constrained by BigQuery quotas and limits. If your project -// exceeds BigQuery quotas or limits, AI Platform Prediction does not -// log request-response pairs, but it continues to serve predictions. If -// you are using continuous evaluation, you do not need to specify this -// configuration manually. Setting up continuous evaluation -// automatically enables logging of request-response pairs. +// Logging is constrained by BigQuery quotas and limits +// (/bigquery/quotas). If your project exceeds BigQuery quotas or +// limits, AI Platform Prediction does not log request-response pairs, +// but it continues to serve predictions. If you are using continuous +// evaluation (/ml-engine/docs/continuous-evaluation/), you do not need +// to specify this configuration manually. Setting up continuous +// evaluation automatically enables logging of request-response pairs. type GoogleCloudMlV1__RequestLoggingConfig struct { // BigqueryTableName: Required. Fully qualified BigQuery table name in // the following format: " project_id.dataset_name.table_name" The // specified table must already exist, and the "Cloud ML Service Agent" // for your project must have permission to write to it. The table must - // have the following schema: Field nameType Mode model STRING REQUIRED - // model_version STRING REQUIRED time TIMESTAMP REQUIRED raw_data STRING - // REQUIRED raw_prediction STRING NULLABLE groundtruth STRING NULLABLE + // have the following schema (/bigquery/docs/schemas): Field nameType + // Mode model STRING REQUIRED model_version STRING REQUIRED time + // TIMESTAMP REQUIRED raw_data STRING REQUIRED raw_prediction STRING + // NULLABLE groundtruth STRING NULLABLE BigqueryTableName string `json:"bigqueryTableName,omitempty"` // SamplingPercentage: Percentage of requests to be logged, expressed as @@ -2936,25 +2988,28 @@ func (s *GoogleCloudMlV1__RequestLoggingConfig) UnmarshalJSON(data []byte) error // container. AI Platform Prediction sends requests to these paths on // the container; the custom container must run an HTTP server that // responds to these requests with appropriate responses. Read Custom -// container requirements for details on how to create your container -// image to meet these requirements. +// container requirements +// (/ai-platform/prediction/docs/custom-container-requirements) for +// details on how to create your container image to meet these +// requirements. type GoogleCloudMlV1__RouteMap struct { // Health: HTTP path on the container to send health checkss to. AI // Platform Prediction intermittently sends GET requests to this path on // the container's IP address and port to check that the container is - // healthy. Read more about health checks. For example, if you set this - // field to `/bar`, then AI Platform Prediction intermittently sends a - // GET request to the `/bar` path on the port of your container - // specified by the first value of Version.container.ports. If you don't - // specify this field, it defaults to the following value: /v1/models/ - // MODEL/versions/VERSION The placeholders in this value are replaced as - // follows: * MODEL: The name of the parent Model. This does not include - // the "projects/PROJECT_ID/models/" prefix that the API returns in - // output; it is the bare model name, as provided to - // projects.models.create. * VERSION: The name of the model version. - // This does not include the "projects/PROJECT_ID - // /models/MODEL/versions/" prefix that the API returns in output; it is - // the bare version name, as provided to + // healthy. Read more about health checks + // (/ai-platform/prediction/docs/custom-container-requirements#checks). + // For example, if you set this field to `/bar`, then AI Platform + // Prediction intermittently sends a GET request to the `/bar` path on + // the port of your container specified by the first value of + // Version.container.ports. If you don't specify this field, it defaults + // to the following value: /v1/models/ MODEL/versions/VERSION The + // placeholders in this value are replaced as follows: * MODEL: The name + // of the parent Model. This does not include the + // "projects/PROJECT_ID/models/" prefix that the API returns in output; + // it is the bare model name, as provided to projects.models.create. * + // VERSION: The name of the model version. This does not include the + // "projects/PROJECT_ID /models/MODEL/versions/" prefix that the API + // returns in output; it is the bare version name, as provided to // projects.models.versions.create. Health string `json:"health,omitempty"` @@ -3046,8 +3101,10 @@ type GoogleCloudMlV1__Scheduling struct { // example, if you want to ensure your job runs for no more than 2 // hours, set this field to `7200s` (2 hours * 60 minutes / hour * 60 // seconds / minute). If you submit your training job using the `gcloud` - // tool, you can specify this field in a `config.yaml` file. For - // example: ```yaml trainingInput: scheduling: maxRunningTime: 7200s ``` + // tool, you can specify this field in a `config.yaml` file + // (/ai-platform/training/docs/training-jobs#formatting_your_configuratio + // n_parameters). For example: ```yaml trainingInput: scheduling: + // maxRunningTime: 7200s ``` MaxRunningTime string `json:"maxRunningTime,omitempty"` // MaxWaitTime: Optional. The maximum job wait time, expressed in @@ -3059,18 +3116,21 @@ type GoogleCloudMlV1__Scheduling struct { // no longer be cancelled due to the maximum wait time. Therefore the // duration limited by this field does not overlap with the duration // limited by Scheduling.max_running_time. For example, if the job - // temporarily stops running and retries due to a VM restart, this - // cannot lead to a maximum wait time cancellation. However, - // independently of this constraint, AI Platform Training might stop a - // job if there are too many retries due to exhausted resources in a - // region. The following example describes how you might use this field: - // To cancel your job if it doesn't start running within 1 hour, set - // this field to `3600s` (1 hour * 60 minutes / hour * 60 seconds / - // minute). If the job is still in the `QUEUED` or `PREPARING` state - // after an hour of waiting, AI Platform Training cancels the job. If - // you submit your training job using the `gcloud` tool, you can specify - // this field in a `config.yaml` file. For example: ```yaml - // trainingInput: scheduling: maxWaitTime: 3600s ``` + // temporarily stops running and retries due to a VM restart + // (/ai-platform/training/docs/overview#restarts), this cannot lead to a + // maximum wait time cancellation. However, independently of this + // constraint, AI Platform Training might stop a job if there are too + // many retries due to exhausted resources in a region. The following + // example describes how you might use this field: To cancel your job if + // it doesn't start running within 1 hour, set this field to `3600s` (1 + // hour * 60 minutes / hour * 60 seconds / minute). If the job is still + // in the `QUEUED` or `PREPARING` state after an hour of waiting, AI + // Platform Training cancels the job. If you submit your training job + // using the `gcloud` tool, you can specify this field in a + // `config.yaml` file + // (/ai-platform/training/docs/training-jobs#formatting_your_configuratio + // n_parameters). For example: ```yaml trainingInput: scheduling: + // maxWaitTime: 3600s ``` MaxWaitTime string `json:"maxWaitTime,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxRunningTime") to @@ -3330,7 +3390,7 @@ func (s *GoogleCloudMlV1__SuggestTrialsResponse) MarshalJSON() ([]byte, error) { // job, you can specify the input parameters as command-line arguments // and/or in a YAML configuration file referenced from the --config // command-line argument. For details, see the guide to submitting a -// training job. +// training job (/ai-platform/training/docs/training-jobs). type GoogleCloudMlV1__TrainingInput struct { // Args: Optional. Command-line arguments passed to the training // application when it starts. If your job uses a custom container, then @@ -3342,17 +3402,20 @@ type GoogleCloudMlV1__TrainingInput struct { // job, instead of using Google's default encryption. If this is set, // then all resources created by the training job will be encrypted with // the customer-managed encryption key that you specify. Learn how and - // when to use CMEK with AI Platform Training. + // when to use CMEK with AI Platform Training + // (/ai-platform/training/docs/cmek). EncryptionConfig *GoogleCloudMlV1__EncryptionConfig `json:"encryptionConfig,omitempty"` // EvaluatorConfig: Optional. The configuration for evaluators. You // should only set `evaluatorConfig.acceleratorConfig` if // `evaluatorType` is set to a Compute Engine machine type. Learn about - // restrictions on accelerator configurations for training. Set - // `evaluatorConfig.imageUri` only if you build a custom image for your - // evaluator. If `evaluatorConfig.imageUri` has not been set, AI - // Platform uses the value of `masterConfig.imageUri`. Learn more about - // configuring custom containers. + // restrictions on accelerator configurations for training. + // (/ai-platform/training/docs/using-gpus#compute-engine-machine-types-wi + // th-gpu) Set `evaluatorConfig.imageUri` only if you build a custom + // image for your evaluator. If `evaluatorConfig.imageUri` has not been + // set, AI Platform uses the value of `masterConfig.imageUri`. Learn + // more about configuring custom containers + // (/ai-platform/training/docs/distributed-training-containers). EvaluatorConfig *GoogleCloudMlV1__ReplicaConfig `json:"evaluatorConfig,omitempty"` // EvaluatorCount: Optional. The number of evaluator replicas to use for @@ -3385,10 +3448,12 @@ type GoogleCloudMlV1__TrainingInput struct { // MasterConfig: Optional. The configuration for your master worker. You // should only set `masterConfig.acceleratorConfig` if `masterType` is // set to a Compute Engine machine type. Learn about restrictions on - // accelerator configurations for training. Set `masterConfig.imageUri` - // only if you build a custom image. Only one of `masterConfig.imageUri` - // and `runtimeVersion` should be set. Learn more about configuring - // custom containers. + // accelerator configurations for training. + // (/ai-platform/training/docs/using-gpus#compute-engine-machine-types-wi + // th-gpu) Set `masterConfig.imageUri` only if you build a custom image. + // Only one of `masterConfig.imageUri` and `runtimeVersion` should be + // set. Learn more about configuring custom containers + // (/ai-platform/training/docs/distributed-training-containers). MasterConfig *GoogleCloudMlV1__ReplicaConfig `json:"masterConfig,omitempty"` // MasterType: Optional. Specifies the type of virtual machine to use @@ -3400,25 +3465,30 @@ type GoogleCloudMlV1__TrainingInput struct { // `n1-highmem-2` - `n1-highmem-4` - `n1-highmem-8` - `n1-highmem-16` - // `n1-highmem-32` - `n1-highmem-64` - `n1-highmem-96` - `n1-highcpu-16` // - `n1-highcpu-32` - `n1-highcpu-64` - `n1-highcpu-96` Learn more - // about using Compute Engine machine types. Alternatively, you can use - // the following legacy machine types: - `standard` - `large_model` - - // `complex_model_s` - `complex_model_m` - `complex_model_l` - - // `standard_gpu` - `complex_model_m_gpu` - `complex_model_l_gpu` - - // `standard_p100` - `complex_model_m_p100` - `standard_v100` - - // `large_model_v100` - `complex_model_m_v100` - `complex_model_l_v100` - // Learn more about using legacy machine types. Finally, if you want to - // use a TPU for training, specify `cloud_tpu` in this field. Learn more - // about the special configuration options for training with TPUs. + // about using Compute Engine machine types + // (/ml-engine/docs/machine-types#compute-engine-machine-types). + // Alternatively, you can use the following legacy machine types: - + // `standard` - `large_model` - `complex_model_s` - `complex_model_m` - + // `complex_model_l` - `standard_gpu` - `complex_model_m_gpu` - + // `complex_model_l_gpu` - `standard_p100` - `complex_model_m_p100` - + // `standard_v100` - `large_model_v100` - `complex_model_m_v100` - + // `complex_model_l_v100` Learn more about using legacy machine types + // (/ml-engine/docs/machine-types#legacy-machine-types). Finally, if you + // want to use a TPU for training, specify `cloud_tpu` in this field. + // Learn more about the special configuration options for training with + // TPUs + // (/ml-engine/docs/tensorflow/using-tpus#configuring_a_custom_tpu_machin + // e). MasterType string `json:"masterType,omitempty"` - // Network: Optional. The full name of the Compute Engine network to - // which the Job is peered. For example, + // Network: Optional. The full name of the Compute Engine network + // (/vpc/docs/vpc) to which the Job is peered. For example, // `projects/12345/global/networks/myVPC`. The format of this field is // `projects/{project}/global/networks/{network}`, where {project} is a // project number (like `12345`) and {network} is network name. Private // services access must already be configured for the network. If left // unspecified, the Job is not peered with any network. Learn about - // using VPC Network Peering.. + // using VPC Network Peering. (/ai-platform/training/docs/vpc-peering). Network string `json:"network,omitempty"` // PackageUris: Required. The Google Cloud Storage location of the @@ -3430,11 +3500,14 @@ type GoogleCloudMlV1__TrainingInput struct { // servers. You should only set // `parameterServerConfig.acceleratorConfig` if `parameterServerType` is // set to a Compute Engine machine type. Learn about restrictions on - // accelerator configurations for training. Set - // `parameterServerConfig.imageUri` only if you build a custom image for - // your parameter server. If `parameterServerConfig.imageUri` has not - // been set, AI Platform uses the value of `masterConfig.imageUri`. - // Learn more about configuring custom containers. + // accelerator configurations for training. + // (/ai-platform/training/docs/using-gpus#compute-engine-machine-types-wi + // th-gpu) Set `parameterServerConfig.imageUri` only if you build a + // custom image for your parameter server. If + // `parameterServerConfig.imageUri` has not been set, AI Platform uses + // the value of `masterConfig.imageUri`. Learn more about configuring + // custom containers + // (/ai-platform/training/docs/distributed-training-containers). ParameterServerConfig *GoogleCloudMlV1__ReplicaConfig `json:"parameterServerConfig,omitempty"` // ParameterServerCount: Optional. The number of parameter server @@ -3466,17 +3539,21 @@ type GoogleCloudMlV1__TrainingInput struct { // '3.5' is available when `runtime_version` is set to a version from // '1.4' to '1.14'. * Python '2.7' is available when `runtime_version` // is set to '1.15' or earlier. Read more about the Python versions - // available for each runtime version. + // available for each runtime version + // (/ml-engine/docs/runtime-version-list). PythonVersion string `json:"pythonVersion,omitempty"` // Region: Required. The region to run the training job in. See the - // available regions for AI Platform Training. + // available regions (/ai-platform/training/docs/regions) for AI + // Platform Training. Region string `json:"region,omitempty"` // RuntimeVersion: Optional. The AI Platform runtime version to use for // training. You must either specify this field or specify // `masterConfig.imageUri`. For more information, see the runtime - // version list and learn how to manage runtime versions. + // version list (/ai-platform/training/docs/runtime-version-list) and + // learn how to manage runtime versions + // (/ai-platform/training/docs/versioning). RuntimeVersion string `json:"runtimeVersion,omitempty"` // ScaleTier: Required. Specifies the machine types, the number of @@ -3521,24 +3598,29 @@ type GoogleCloudMlV1__TrainingInput struct { // account. In addition, the AI Platform Training Google-managed service // account must have the `roles/iam.serviceAccountAdmin` role for the // specified service account. Learn more about configuring a service - // account. If not specified, the AI Platform Training Google-managed - // service account is used by default. + // account. (/ai-platform/training/docs/custom-service-account) If not + // specified, the AI Platform Training Google-managed service account is + // used by default. ServiceAccount string `json:"serviceAccount,omitempty"` // UseChiefInTfConfig: Optional. Use `chief` instead of `master` in the // `TF_CONFIG` environment variable when training with a custom - // container. Defaults to `false`. Learn more about this field. This - // field has no effect for training jobs that don't use a custom - // container. + // container. Defaults to `false`. Learn more about this field. + // (/ai-platform/training/docs/distributed-training-details#chief-versus- + // master) This field has no effect for training jobs that don't use a + // custom container. UseChiefInTfConfig bool `json:"useChiefInTfConfig,omitempty"` // WorkerConfig: Optional. The configuration for workers. You should // only set `workerConfig.acceleratorConfig` if `workerType` is set to a // Compute Engine machine type. Learn about restrictions on accelerator - // configurations for training. Set `workerConfig.imageUri` only if you - // build a custom image for your worker. If `workerConfig.imageUri` has - // not been set, AI Platform uses the value of `masterConfig.imageUri`. - // Learn more about configuring custom containers. + // configurations for training. + // (/ai-platform/training/docs/using-gpus#compute-engine-machine-types-wi + // th-gpu) Set `workerConfig.imageUri` only if you build a custom image + // for your worker. If `workerConfig.imageUri` has not been set, AI + // Platform uses the value of `masterConfig.imageUri`. Learn more about + // configuring custom containers + // (/ai-platform/training/docs/distributed-training-containers). WorkerConfig *GoogleCloudMlV1__ReplicaConfig `json:"workerConfig,omitempty"` // WorkerCount: Optional. The number of worker replicas to use for the @@ -3555,8 +3637,10 @@ type GoogleCloudMlV1__TrainingInput struct { // `masterType` uses. In other words, both must be Compute Engine // machine types or both must be legacy machine types. If you use // `cloud_tpu` for this value, see special instructions for configuring - // a custom TPU machine. This value must be present when `scaleTier` is - // set to `CUSTOM` and `workerCount` is greater than zero. + // a custom TPU machine + // (/ml-engine/docs/tensorflow/using-tpus#configuring_a_custom_tpu_machin + // e). This value must be present when `scaleTier` is set to `CUSTOM` + // and `workerCount` is greater than zero. WorkerType string `json:"workerType,omitempty"` // ForceSendFields is a list of field names (e.g. "Args") to @@ -3598,8 +3682,9 @@ type GoogleCloudMlV1__TrainingOutput struct { // HyperparameterMetricTag: The TensorFlow summary tag name used for // optimizing hyperparameter tuning trials. See - // `HyperparameterSpec.hyperparameterMetricTag` for more information. - // Only set for hyperparameter tuning jobs. + // `HyperparameterSpec.hyperparameterMetricTag` + // (#HyperparameterSpec.FIELDS.hyperparameter_metric_tag) for more + // information. Only set for hyperparameter tuning jobs. HyperparameterMetricTag string `json:"hyperparameterMetricTag,omitempty"` // IsBuiltInAlgorithmJob: Whether this job is a built-in Algorithm job. @@ -3738,7 +3823,8 @@ type GoogleCloudMlV1__Version struct { // AcceleratorConfig: Optional. Accelerator config for using GPUs for // online prediction (beta). Only specify this field if you have // specified a Compute Engine (N1) machine type in the `machineType` - // field. Learn more about using GPUs for online prediction. + // field. Learn more about using GPUs for online prediction + // (/ml-engine/docs/machine-types-online-prediction#gpus). AcceleratorConfig *GoogleCloudMlV1__AcceleratorConfig `json:"acceleratorConfig,omitempty"` // AutoScaling: Automatically scale the number of nodes used to serve @@ -3746,7 +3832,8 @@ type GoogleCloudMlV1__Version struct { // should be taken to ramp up traffic according to the model's ability // to scale or you will start seeing increases in latency and 429 // response codes. Note that you cannot use AutoScaling if your version - // uses GPUs. Instead, you must use specify `manual_scaling`. + // uses GPUs (#Version.FIELDS.accelerator_config). Instead, you must use + // specify `manual_scaling`. AutoScaling *GoogleCloudMlV1__AutoScaling `json:"autoScaling,omitempty"` // Container: Optional. Specifies a custom container to use for serving @@ -3762,16 +3849,19 @@ type GoogleCloudMlV1__Version struct { // DeploymentUri: The Cloud Storage URI of a directory containing // trained model artifacts to be used to create the model version. See - // the guide to deploying models for more information. The total number - // of files under this directory must not exceed 1000. During - // projects.models.versions.create, AI Platform Prediction copies all - // files from the specified directory to a location managed by the + // the guide to deploying models + // (/ai-platform/prediction/docs/deploying-models) for more information. + // The total number of files under this directory must not exceed 1000. + // During projects.models.versions.create, AI Platform Prediction copies + // all files from the specified directory to a location managed by the // service. From then on, AI Platform Prediction uses these copies of // the model artifacts to serve predictions, not the original files in // Cloud Storage, so this location is useful only as a historical // record. If you specify container, then this field is optional. // Otherwise, it is required. Learn how to use this field with a custom - // container. + // container + // (/ai-platform/prediction/docs/custom-container-requirements#artifacts) + // . DeploymentUri string `json:"deploymentUri,omitempty"` // Description: Optional. The description specified for the version when @@ -3804,7 +3894,9 @@ type GoogleCloudMlV1__Version struct { // framework. If you choose `SCIKIT_LEARN` or `XGBOOST`, you must also // set the runtime version of the model to 1.4 or greater. Do **not** // specify a framework if you're deploying a custom prediction routine - // or if you're using a custom container. + // (/ai-platform/prediction/docs/custom-prediction-routines) or if + // you're using a custom container + // (/ai-platform/prediction/docs/use-custom-container). // // Possible values: // "FRAMEWORK_UNSPECIFIED" - Unspecified framework. Assigns a value @@ -3838,7 +3930,8 @@ type GoogleCloudMlV1__Version struct { // * `n1-highmem-8` * `n1-highmem-16` * `n1-highmem-32` * `n1-highcpu-2` // * `n1-highcpu-4` * `n1-highcpu-8` * `n1-highcpu-16` * `n1-highcpu-32` // `mls1-c4-m2` is in beta. All other machine types are generally - // available. Learn more about the differences between machine types. + // available. Learn more about the differences between machine types + // (/ml-engine/docs/machine-types-online-prediction). MachineType string `json:"machineType,omitempty"` // ManualScaling: Manually select the number of nodes to use for serving @@ -3855,23 +3948,31 @@ type GoogleCloudMlV1__Version struct { Name string `json:"name,omitempty"` // PackageUris: Optional. Cloud Storage paths (`gs://…`) of packages - // for custom prediction routines or scikit-learn pipelines with custom - // code. For a custom prediction routine, one of these packages must - // contain your Predictor class (see `predictionClass`). Additionally, - // include any dependencies used by your Predictor or scikit-learn - // pipeline uses that are not already included in your selected runtime - // version. If you specify this field, you must also set - // `runtimeVersion` to 1.4 or greater. + // for custom prediction routines + // (/ml-engine/docs/tensorflow/custom-prediction-routines) or + // scikit-learn pipelines with custom code + // (/ml-engine/docs/scikit/exporting-for-prediction#custom-pipeline-code) + // . For a custom prediction routine, one of these packages must contain + // your Predictor class (see `predictionClass` + // (#Version.FIELDS.prediction_class)). Additionally, include any + // dependencies used by your Predictor or scikit-learn pipeline uses + // that are not already included in your selected runtime version + // (/ml-engine/docs/tensorflow/runtime-version-list). If you specify + // this field, you must also set `runtimeVersion` + // (#Version.FIELDS.runtime_version) to 1.4 or greater. PackageUris []string `json:"packageUris,omitempty"` // PredictionClass: Optional. The fully qualified name // (module_name.class_name) of a class that implements the Predictor // interface described in this reference field. The module containing // this class should be included in a package provided to the - // `packageUris` field. Specify this field if and only if you are - // deploying a custom prediction routine (beta). If you specify this - // field, you must set `runtimeVersion` to 1.4 or greater and you must - // set `machineType` to a legacy (MLS1) machine type. The following code + // `packageUris` field (#Version.FIELDS.package_uris). Specify this + // field if and only if you are deploying a custom prediction routine + // (beta) (/ml-engine/docs/tensorflow/custom-prediction-routines). If + // you specify this field, you must set `runtimeVersion` + // (#Version.FIELDS.runtime_version) to 1.4 or greater and you must set + // `machineType` to a legacy (MLS1) machine type + // (/ml-engine/docs/machine-types-online-prediction). The following code // sample provides the Predictor interface: class Predictor(object): // """Interface for constructing custom predictors.""" def predict(self, // instances, **kwargs): """Performs custom prediction. Instances are @@ -3887,7 +3988,8 @@ type GoogleCloudMlV1__Version struct { // exported model file along with any additional files uploaded when // creating the version resource. Returns: An instance implementing this // Predictor class. """ raise NotImplementedError() Learn more about the - // Predictor interface and custom prediction routines. + // Predictor interface and custom prediction routines + // (/ml-engine/docs/tensorflow/custom-prediction-routines). PredictionClass string `json:"predictionClass,omitempty"` // PythonVersion: Required. The version of Python used in prediction. @@ -3896,7 +3998,8 @@ type GoogleCloudMlV1__Version struct { // '3.5' is available when `runtime_version` is set to a version from // '1.4' to '1.14'. * Python '2.7' is available when `runtime_version` // is set to '1.15' or earlier. Read more about the Python versions - // available for each runtime version. + // available for each runtime version + // (/ml-engine/docs/runtime-version-list). PythonVersion string `json:"pythonVersion,omitempty"` // RequestLoggingConfig: Optional. *Only* specify this field in a @@ -3917,13 +4020,15 @@ type GoogleCloudMlV1__Version struct { // RuntimeVersion: Required. The AI Platform runtime version to use for // this deployment. For more information, see the runtime version list - // and how to manage runtime versions. + // (/ml-engine/docs/runtime-version-list) and how to manage runtime + // versions (/ml-engine/docs/versioning). RuntimeVersion string `json:"runtimeVersion,omitempty"` // ServiceAccount: Optional. Specifies the service account for resource // access control. If you specify this field, then you must also specify // either the `containerSpec` or the `predictionClass` field. Learn more - // about using a custom service account. + // about using a custom service account + // (/ai-platform/prediction/docs/custom-service-account). ServiceAccount string `json:"serviceAccount,omitempty"` // State: Output only. The state of a version. @@ -4112,7 +4217,8 @@ type GoogleIamV1__Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleType__Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -4188,7 +4294,9 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) { // expression evaluates to `true`. A condition can add constraints based // on attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -4207,7 +4315,7 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type GoogleIamV1__Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -4247,7 +4355,8 @@ type GoogleIamV1__Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4320,7 +4429,8 @@ func (s *GoogleIamV1__SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type GoogleIamV1__TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -4493,10 +4603,11 @@ type GoogleProtobuf__Empty struct { // GoogleRpc__Status: The `Status` type defines a logical error model // that is suitable for different programming environments, including -// REST APIs and RPC APIs. It is used by gRPC. Each `Status` message -// contains three pieces of data: error code, error message, and error -// details. You can find out more about this error model and how to work -// with it in the API Design Guide. +// REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). +// Each `Status` message contains three pieces of data: error code, +// error message, and error details. You can find out more about this +// error model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpc__Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -5482,7 +5593,8 @@ func (r *ProjectsJobsService) GetIamPolicy(resource string) *ProjectsJobsGetIamP // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsJobsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsJobsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -9347,7 +9459,8 @@ func (r *ProjectsModelsService) GetIamPolicy(resource string) *ProjectsModelsGet // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsModelsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsModelsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -10817,7 +10930,7 @@ func (r *ProjectsModelsVersionsService) Patch(name string, googlecloudmlv1__vers // `requestLoggingConfig`, `autoScaling.minNodes`, and // `manualScaling.nodes`. However, you can only update // `manualScaling.nodes` if the version uses a Compute Engine (N1) -// machine type. +// machine type (/ml-engine/docs/machine-types-online-prediction). func (c *ProjectsModelsVersionsPatchCall) UpdateMask(updateMask string) *ProjectsModelsVersionsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/monitoring/v3/monitoring-gen.go b/monitoring/v3/monitoring-gen.go index bb203b16b3d..ea77ee49400 100644 --- a/monitoring/v3/monitoring-gen.go +++ b/monitoring/v3/monitoring-gen.go @@ -1472,10 +1472,10 @@ type Distribution struct { Range *Range `json:"range,omitempty"` // SumOfSquaredDeviation: The sum of squared deviations from the mean of - // the values in the population. For values x_i this is: Sumi=1..n^2) - // Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd - // edition describes Welford's method for accumulating this sum in one - // pass.If count is zero then this field must be zero. + // the values in the population. For values x_i this is: Sumi=1..n ((x_i + // - mean)^2) Knuth, "The Art of Computer Programming", Vol. 2, page + // 232, 3rd edition describes Welford's method for accumulating this sum + // in one pass.If count is zero then this field must be zero. SumOfSquaredDeviation float64 `json:"sumOfSquaredDeviation,omitempty"` // ForceSendFields is a list of field names (e.g. "BucketCounts") to @@ -5559,7 +5559,7 @@ func (c *ProjectsAlertPoliciesCreateCall) Header() http.Header { func (c *ProjectsAlertPoliciesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5698,7 +5698,7 @@ func (c *ProjectsAlertPoliciesDeleteCall) Header() http.Header { func (c *ProjectsAlertPoliciesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5840,7 +5840,7 @@ func (c *ProjectsAlertPoliciesGetCall) Header() http.Header { func (c *ProjectsAlertPoliciesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6022,7 +6022,7 @@ func (c *ProjectsAlertPoliciesListCall) Header() http.Header { func (c *ProjectsAlertPoliciesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6227,7 +6227,7 @@ func (c *ProjectsAlertPoliciesPatchCall) Header() http.Header { func (c *ProjectsAlertPoliciesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6376,7 +6376,7 @@ func (c *ProjectsCollectdTimeSeriesCreateCall) Header() http.Header { func (c *ProjectsCollectdTimeSeriesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6525,7 +6525,7 @@ func (c *ProjectsGroupsCreateCall) Header() http.Header { func (c *ProjectsGroupsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6678,7 +6678,7 @@ func (c *ProjectsGroupsDeleteCall) Header() http.Header { func (c *ProjectsGroupsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6825,7 +6825,7 @@ func (c *ProjectsGroupsGetCall) Header() http.Header { func (c *ProjectsGroupsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7020,7 +7020,7 @@ func (c *ProjectsGroupsListCall) Header() http.Header { func (c *ProjectsGroupsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7212,7 +7212,7 @@ func (c *ProjectsGroupsUpdateCall) Header() http.Header { func (c *ProjectsGroupsUpdateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7411,7 +7411,7 @@ func (c *ProjectsGroupsMembersListCall) Header() http.Header { func (c *ProjectsGroupsMembersListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7599,7 +7599,7 @@ func (c *ProjectsMetricDescriptorsCreateCall) Header() http.Header { func (c *ProjectsMetricDescriptorsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7740,7 +7740,7 @@ func (c *ProjectsMetricDescriptorsDeleteCall) Header() http.Header { func (c *ProjectsMetricDescriptorsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7883,7 +7883,7 @@ func (c *ProjectsMetricDescriptorsGetCall) Header() http.Header { func (c *ProjectsMetricDescriptorsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8060,7 +8060,7 @@ func (c *ProjectsMetricDescriptorsListCall) Header() http.Header { func (c *ProjectsMetricDescriptorsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8245,7 +8245,7 @@ func (c *ProjectsMonitoredResourceDescriptorsGetCall) Header() http.Header { func (c *ProjectsMonitoredResourceDescriptorsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8420,7 +8420,7 @@ func (c *ProjectsMonitoredResourceDescriptorsListCall) Header() http.Header { func (c *ProjectsMonitoredResourceDescriptorsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8608,7 +8608,7 @@ func (c *ProjectsNotificationChannelDescriptorsGetCall) Header() http.Header { func (c *ProjectsNotificationChannelDescriptorsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8772,7 +8772,7 @@ func (c *ProjectsNotificationChannelDescriptorsListCall) Header() http.Header { func (c *ProjectsNotificationChannelDescriptorsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8945,7 +8945,7 @@ func (c *ProjectsNotificationChannelsCreateCall) Header() http.Header { func (c *ProjectsNotificationChannelsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9094,7 +9094,7 @@ func (c *ProjectsNotificationChannelsDeleteCall) Header() http.Header { func (c *ProjectsNotificationChannelsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9246,7 +9246,7 @@ func (c *ProjectsNotificationChannelsGetCall) Header() http.Header { func (c *ProjectsNotificationChannelsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9403,7 +9403,7 @@ func (c *ProjectsNotificationChannelsGetVerificationCodeCall) Header() http.Head func (c *ProjectsNotificationChannelsGetVerificationCodeCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9593,7 +9593,7 @@ func (c *ProjectsNotificationChannelsListCall) Header() http.Header { func (c *ProjectsNotificationChannelsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9780,7 +9780,7 @@ func (c *ProjectsNotificationChannelsPatchCall) Header() http.Header { func (c *ProjectsNotificationChannelsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9929,7 +9929,7 @@ func (c *ProjectsNotificationChannelsSendVerificationCodeCall) Header() http.Hea func (c *ProjectsNotificationChannelsSendVerificationCodeCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10072,7 +10072,7 @@ func (c *ProjectsNotificationChannelsVerifyCall) Header() http.Header { func (c *ProjectsNotificationChannelsVerifyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10216,7 +10216,7 @@ func (c *ProjectsTimeSeriesCreateCall) Header() http.Header { func (c *ProjectsTimeSeriesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10915,7 +10915,7 @@ func (c *ProjectsTimeSeriesListCall) Header() http.Header { func (c *ProjectsTimeSeriesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11312,7 +11312,7 @@ func (c *ProjectsTimeSeriesQueryCall) Header() http.Header { func (c *ProjectsTimeSeriesQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11475,7 +11475,7 @@ func (c *ProjectsUptimeCheckConfigsCreateCall) Header() http.Header { func (c *ProjectsUptimeCheckConfigsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11617,7 +11617,7 @@ func (c *ProjectsUptimeCheckConfigsDeleteCall) Header() http.Header { func (c *ProjectsUptimeCheckConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11759,7 +11759,7 @@ func (c *ProjectsUptimeCheckConfigsGetCall) Header() http.Header { func (c *ProjectsUptimeCheckConfigsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11925,7 +11925,7 @@ func (c *ProjectsUptimeCheckConfigsListCall) Header() http.Header { func (c *ProjectsUptimeCheckConfigsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12107,7 +12107,7 @@ func (c *ProjectsUptimeCheckConfigsPatchCall) Header() http.Header { func (c *ProjectsUptimeCheckConfigsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12262,7 +12262,7 @@ func (c *ServicesCreateCall) Header() http.Header { func (c *ServicesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12406,7 +12406,7 @@ func (c *ServicesDeleteCall) Header() http.Header { func (c *ServicesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12548,7 +12548,7 @@ func (c *ServicesGetCall) Header() http.Header { func (c *ServicesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12730,7 +12730,7 @@ func (c *ServicesListCall) Header() http.Header { func (c *ServicesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12911,7 +12911,7 @@ func (c *ServicesPatchCall) Header() http.Header { func (c *ServicesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -13067,7 +13067,7 @@ func (c *ServicesServiceLevelObjectivesCreateCall) Header() http.Header { func (c *ServicesServiceLevelObjectivesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -13211,7 +13211,7 @@ func (c *ServicesServiceLevelObjectivesDeleteCall) Header() http.Header { func (c *ServicesServiceLevelObjectivesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -13374,7 +13374,7 @@ func (c *ServicesServiceLevelObjectivesGetCall) Header() http.Header { func (c *ServicesServiceLevelObjectivesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -13580,7 +13580,7 @@ func (c *ServicesServiceLevelObjectivesListCall) Header() http.Header { func (c *ServicesServiceLevelObjectivesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -13777,7 +13777,7 @@ func (c *ServicesServiceLevelObjectivesPatchCall) Header() http.Header { func (c *ServicesServiceLevelObjectivesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -13951,7 +13951,7 @@ func (c *UptimeCheckIpsListCall) Header() http.Header { func (c *UptimeCheckIpsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201213") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/networkmanagement/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index 81a0fe5e057..5abfcc1d21e 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -361,7 +361,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -662,7 +663,8 @@ type Endpoint struct { // IpAddress: The IP address of the endpoint, which can be an external // or internal IP. An IPv6 address is only allowed when the test's - // destination is a global load balancer VIP. + // destination is a global load balancer VIP + // (/load-balancing/docs/load-balancing-overview). IpAddress string `json:"ipAddress,omitempty"` // Network: A Compute Engine network URI. @@ -1455,7 +1457,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1474,7 +1478,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1514,7 +1518,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1732,10 +1737,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1902,7 +1908,8 @@ func (s *Step) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2926,7 +2933,8 @@ func (r *ProjectsLocationsGlobalConnectivityTestsService) GetIamPolicy(resource // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsGlobalConnectivityTestsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGlobalConnectivityTestsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/networkmanagement/v1beta1/networkmanagement-gen.go b/networkmanagement/v1beta1/networkmanagement-gen.go index 4fc1b408547..b00de41833d 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -361,7 +361,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -722,10 +723,13 @@ type Empty struct { // Endpoint: Source or destination of the Connectivity Test. type Endpoint struct { - // CloudSqlInstance: A Cloud SQL instance URI. + // CloudSqlInstance: A Cloud SQL (https://cloud.google.com/sql) instance + // URI. CloudSqlInstance string `json:"cloudSqlInstance,omitempty"` - // GkeMasterCluster: A cluster URI for Google Kubernetes Engine master. + // GkeMasterCluster: A cluster URI for Google Kubernetes Engine master + // (https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-arch + // itecture). GkeMasterCluster string `json:"gkeMasterCluster,omitempty"` // Instance: A Compute Engine instance URI. @@ -733,7 +737,9 @@ type Endpoint struct { // IpAddress: The IP address of the endpoint, which can be an external // or internal IP. An IPv6 address is only allowed when the test's - // destination is a global load balancer VIP. + // destination is a global load balancer VIP + // (https://cloud.google.com/load-balancing/docs/load-balancing-overview) + // . IpAddress string `json:"ipAddress,omitempty"` // Network: A Compute Engine network URI. @@ -1631,7 +1637,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1650,7 +1658,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1690,7 +1698,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1982,10 +1991,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2164,7 +2174,8 @@ func (s *Step) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3188,7 +3199,8 @@ func (r *ProjectsLocationsGlobalConnectivityTestsService) GetIamPolicy(resource // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsGlobalConnectivityTestsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGlobalConnectivityTestsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/notebooks/v1/notebooks-gen.go b/notebooks/v1/notebooks-gen.go index 37155eeca94..9191546c14b 100644 --- a/notebooks/v1/notebooks-gen.go +++ b/notebooks/v1/notebooks-gen.go @@ -194,8 +194,8 @@ type ProjectsLocationsOperationsService struct { // AcceleratorConfig: Definition of a hardware accelerator. Note that // not all combinations of `type` and `core_count` are valid. Check GPUs -// on Compute Engine to find a valid combination. TPUs are not -// supported. +// on Compute Engine (/compute/docs/gpus/#gpus-list) to find a valid +// combination. TPUs are not supported. type AcceleratorConfig struct { // CoreCount: Count of cores of this accelerator. CoreCount int64 `json:"coreCount,omitempty,string"` @@ -251,7 +251,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -606,7 +607,8 @@ func (s *GuestOsFeature) MarshalJSON() ([]byte, error) { type Instance struct { // AcceleratorConfig: The hardware accelerator used on this instance. If // you use accelerators, make sure that your configuration has enough - // vCPUs and memory to support the `machine_type` you have selected. + // vCPUs and memory to support the `machine_type` you have selected + // (/compute/docs/gpus/#gpus-list). AcceleratorConfig *AcceleratorConfig `json:"acceleratorConfig,omitempty"` // BootDiskSizeGb: Input only. The size of the boot disk in GB attached @@ -680,15 +682,16 @@ type Instance struct { // KmsKey: Input only. The KMS key used to encrypt the disks, only // applicable if disk_encryption is CMEK. Format: // `projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cry - // ptoKeys/{key_id}` Learn more about using your own encryption keys. + // ptoKeys/{key_id}` Learn more about using your own encryption keys + // (/kms/docs/quickstart). KmsKey string `json:"kmsKey,omitempty"` // Labels: Labels to apply to this instance. These can be later modified // by the setLabels method. Labels map[string]string `json:"labels,omitempty"` - // MachineType: Required. The Compute Engine machine type of this - // instance. + // MachineType: Required. The Compute Engine machine type + // (/compute/docs/machine-types) of this instance. MachineType string `json:"machineType,omitempty"` // Metadata: Custom metadata to apply to this instance. @@ -726,7 +729,9 @@ type Instance struct { // to other Google Cloud services. You can use any service account // within the same project, but you must have the service account user // permission to use the instance. If not specified, the Compute Engine - // default service account is used. + // default service account + // (https://cloud.google.com/compute/docs/access/service-accounts#default + // _service_account) is used. ServiceAccount string `json:"serviceAccount,omitempty"` // State: Output only. The state of this instance. @@ -1159,7 +1164,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1178,7 +1185,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -1214,7 +1221,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1350,8 +1358,9 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type SetInstanceAcceleratorRequest struct { // CoreCount: Required. Count of cores of this accelerator. Note that // not all combinations of `type` and `core_count` are valid. Check GPUs - // on Compute Engine to find a valid combination. TPUs are not - // supported. + // on Compute Engine + // (https://cloud.google.com/compute/docs/gpus/#gpus-list) to find a + // valid combination. TPUs are not supported. CoreCount int64 `json:"coreCount,omitempty,string"` // Type: Required. Type of this accelerator. @@ -1429,7 +1438,8 @@ func (s *SetInstanceLabelsRequest) MarshalJSON() ([]byte, error) { // SetInstanceMachineTypeRequest: Request for setting instance machine // type. type SetInstanceMachineTypeRequest struct { - // MachineType: Required. The Compute Engine machine type. + // MachineType: Required. The Compute Engine machine type + // (https://cloud.google.com/compute/docs/machine-types). MachineType string `json:"machineType,omitempty"` // ForceSendFields is a list of field names (e.g. "MachineType") to @@ -1461,10 +1471,11 @@ type StartInstanceRequest struct { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1511,7 +1522,8 @@ type StopInstanceRequest struct { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -3117,7 +3129,8 @@ func (r *ProjectsLocationsInstancesService) GetIamPolicy(resource string) *Proje // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsInstancesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsInstancesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/osconfig/v1/osconfig-gen.go b/osconfig/v1/osconfig-gen.go index 0ce75bed451..e83fb42925a 100644 --- a/osconfig/v1/osconfig-gen.go +++ b/osconfig/v1/osconfig-gen.go @@ -1018,7 +1018,8 @@ func (s *MonthlySchedule) MarshalJSON() ([]byte, error) { } // OneTimeSchedule: Sets the time for a one time patch deployment. -// Timestamp is in RFC3339 text format. +// Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text +// format. type OneTimeSchedule struct { // ExecuteTime: Required. The desired patch job execution time. ExecuteTime string `json:"executeTime,omitempty"` @@ -1115,10 +1116,13 @@ func (s *PatchConfig) MarshalJSON() ([]byte, error) { // patch jobs use to complete a patch. These configurations include // instance filter, package repository settings, and a schedule. For // more information about creating and managing patch deployments, see -// Scheduling patch jobs. +// Scheduling patch jobs +// (https://cloud.google.com/compute/docs/os-patch-management/schedule-pa +// tch-jobs). type PatchDeployment struct { // CreateTime: Output only. Time the patch deployment was created. - // Timestamp is in RFC3339 text format. + // Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text + // format. CreateTime string `json:"createTime,omitempty"` // Description: Optional. Description of the patch deployment. Length of @@ -1133,7 +1137,8 @@ type PatchDeployment struct { InstanceFilter *PatchInstanceFilter `json:"instanceFilter,omitempty"` // LastExecuteTime: Output only. The last time a patch job was started - // by this deployment. Timestamp is in RFC3339 text format. + // by this deployment. Timestamp is in RFC3339 + // (https://www.ietf.org/rfc/rfc3339.txt) text format. LastExecuteTime string `json:"lastExecuteTime,omitempty"` // Name: Unique name for the patch deployment resource in a project. The @@ -1155,7 +1160,8 @@ type PatchDeployment struct { Rollout *PatchRollout `json:"rollout,omitempty"` // UpdateTime: Output only. Time the patch deployment was last updated. - // Timestamp is in RFC3339 text format. + // Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text + // format. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1239,12 +1245,13 @@ func (s *PatchInstanceFilter) MarshalJSON() ([]byte, error) { } // PatchInstanceFilterGroupLabel: Targets a group of VM instances by -// using their assigned labels. Labels are key-value pairs. A -// `GroupLabel` is a combination of labels that is used to target VMs -// for a patch job. For example, a patch job can target VMs that have -// the following `GroupLabel`: `{"env":"test", "app":"web"}`. This means -// that the patch job is applied to VMs that have both the labels -// `env=test` and `app=web`. +// using their assigned labels +// (https://cloud.google.com/compute/docs/labeling-resources). Labels +// are key-value pairs. A `GroupLabel` is a combination of labels that +// is used to target VMs for a patch job. For example, a patch job can +// target VMs that have the following `GroupLabel`: `{"env":"test", +// "app":"web"}`. This means that the patch job is applied to VMs that +// have both the labels `env=test` and `app=web`. type PatchInstanceFilterGroupLabel struct { // Labels: Compute Engine instance labels that must be present for a VM // instance to be targeted by this filter. @@ -1277,7 +1284,9 @@ func (s *PatchInstanceFilterGroupLabel) MarshalJSON() ([]byte, error) { // in progress or has completed. Instance details are not included in // the job. To paginate through instance details, use // ListPatchJobInstanceDetails. For more information about patch jobs, -// see Creating patch jobs. +// see Creating patch jobs +// (https://cloud.google.com/compute/docs/os-patch-management/create-patc +// h-job). type PatchJob struct { // CreateTime: Time this patch job was created. CreateTime string `json:"createTime,omitempty"` @@ -1387,7 +1396,9 @@ func (s *PatchJob) UnmarshalJSON(data []byte) error { // PatchJobInstanceDetails: Patch details for a VM instance. For more // information about reviewing VM instance details, see Listing all VM -// instance details for a specific patch job. +// instance details for a specific patch job +// (https://cloud.google.com/compute/docs/os-patch-management/manage-patc +// h-jobs#list-instance-details). type PatchJobInstanceDetails struct { // AttemptCount: The number of times the agent that the agent attempts // to apply the patch. @@ -1712,7 +1723,8 @@ func (s *TimeOfDay) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// TimeZone: Represents a time zone from the IANA Time Zone Database. +// TimeZone: Represents a time zone from the IANA Time Zone Database +// (https://www.iana.org/time-zones). type TimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` diff --git a/osconfig/v1beta/osconfig-gen.go b/osconfig/v1beta/osconfig-gen.go index 488117b1ebe..dccbf86e1c3 100644 --- a/osconfig/v1beta/osconfig-gen.go +++ b/osconfig/v1beta/osconfig-gen.go @@ -857,7 +857,9 @@ type GuestPolicy struct { // same level in the resource hierarchy (that is within a project), the // service prevents the creation of multiple policies that conflict with // each other. For more information, see how the service handles - // assignment conflicts. + // assignment conflicts + // (/compute/docs/os-config-management/create-guest-policy#handle-conflic + // ts). Assignment *Assignment `json:"assignment,omitempty"` // CreateTime: Output only. Time this guest policy was created. @@ -1562,7 +1564,8 @@ func (s *MonthlySchedule) MarshalJSON() ([]byte, error) { } // OneTimeSchedule: Sets the time for a one time patch deployment. -// Timestamp is in RFC3339 text format. +// Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text +// format. type OneTimeSchedule struct { // ExecuteTime: Required. The desired patch job execution time. ExecuteTime string `json:"executeTime,omitempty"` @@ -1771,10 +1774,13 @@ func (s *PatchConfig) MarshalJSON() ([]byte, error) { // patch jobs use to complete a patch. These configurations include // instance filter, package repository settings, and a schedule. For // more information about creating and managing patch deployments, see -// Scheduling patch jobs. +// Scheduling patch jobs +// (https://cloud.google.com/compute/docs/os-patch-management/schedule-pa +// tch-jobs). type PatchDeployment struct { // CreateTime: Output only. Time the patch deployment was created. - // Timestamp is in RFC3339 text format. + // Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text + // format. CreateTime string `json:"createTime,omitempty"` // Description: Optional. Description of the patch deployment. Length of @@ -1789,7 +1795,8 @@ type PatchDeployment struct { InstanceFilter *PatchInstanceFilter `json:"instanceFilter,omitempty"` // LastExecuteTime: Output only. The last time a patch job was started - // by this deployment. Timestamp is in RFC3339 text format. + // by this deployment. Timestamp is in RFC3339 + // (https://www.ietf.org/rfc/rfc3339.txt) text format. LastExecuteTime string `json:"lastExecuteTime,omitempty"` // Name: Unique name for the patch deployment resource in a project. The @@ -1811,7 +1818,8 @@ type PatchDeployment struct { Rollout *PatchRollout `json:"rollout,omitempty"` // UpdateTime: Output only. Time the patch deployment was last updated. - // Timestamp is in RFC3339 text format. + // Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text + // format. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1930,7 +1938,9 @@ func (s *PatchInstanceFilterGroupLabel) MarshalJSON() ([]byte, error) { // in progress or has completed. Instance details are not included in // the job. To paginate through instance details, use // `ListPatchJobInstanceDetails`. For more information about patch jobs, -// see Creating patch jobs. +// see Creating patch jobs +// (https://cloud.google.com/compute/docs/os-patch-management/create-patc +// h-job). type PatchJob struct { // CreateTime: Time this patch job was created. CreateTime string `json:"createTime,omitempty"` @@ -2040,7 +2050,9 @@ func (s *PatchJob) UnmarshalJSON(data []byte) error { // PatchJobInstanceDetails: Patch details for a VM instance. For more // information about reviewing VM instance details, see Listing all VM -// instance details for a specific patch job. +// instance details for a specific patch job +// (https://cloud.google.com/compute/docs/os-patch-management/manage-patc +// h-jobs#list-instance-details). type PatchJobInstanceDetails struct { // AttemptCount: The number of times the agent that the agent attempts // to apply the patch. @@ -2817,7 +2829,8 @@ type SoftwareRecipeStepRunScript struct { // Interpreter: The script interpreter to use to run the script. If no // interpreter is specified the script is executed directly, which - // likely only succeed for scripts with shebang lines). + // likely only succeed for scripts with shebang lines + // (https://en.wikipedia.org/wiki/Shebang_\(Unix\)). // // Possible values: // "INTERPRETER_UNSPECIFIED" - Default value for ScriptType. @@ -2897,7 +2910,8 @@ func (s *TimeOfDay) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// TimeZone: Represents a time zone from the IANA Time Zone Database. +// TimeZone: Represents a time zone from the IANA Time Zone Database +// (https://www.iana.org/time-zones). type TimeZone struct { // Id: IANA Time Zone Database time zone, e.g. "America/New_York". Id string `json:"id,omitempty"` diff --git a/people/v1/people-gen.go b/people/v1/people-gen.go index 3ec233d165e..10d48d611d3 100644 --- a/people/v1/people-gen.go +++ b/people/v1/people-gen.go @@ -251,7 +251,9 @@ type Address struct { // Country: The country of the address. Country string `json:"country,omitempty"` - // CountryCode: The ISO 3166-1 alpha-2 country code of the address. + // CountryCode: The ISO 3166-1 alpha-2 + // (http://www.iso.org/iso/country_codes.htm) country code of the + // address. CountryCode string `json:"countryCode,omitempty"` // ExtendedAddress: The extended address of the address; for example, @@ -566,8 +568,8 @@ func (s *ClientData) MarshalJSON() ([]byte, error) { // ContactGroup: A contact group. type ContactGroup struct { - // Etag: The HTTP entity tag of the resource. Used for web cache - // validation. + // Etag: The HTTP entity tag (https://en.wikipedia.org/wiki/HTTP_ETag) + // of the resource. Used for web cache validation. Etag string `json:"etag,omitempty"` // FormattedName: Output only. The name translated and formatted in the @@ -591,7 +593,8 @@ type ContactGroup struct { // MemberResourceNames: Output only. The list of contact person resource // names that are members of the contact group. The field is not // populated for LIST requests and can only be updated through the - // ModifyContactGroupMembers. + // ModifyContactGroupMembers + // (/people/api/rest/v1/contactgroups/members/modify). MemberResourceNames []string `json:"memberResourceNames,omitempty"` // Metadata: Output only. Metadata about the contact group. @@ -675,8 +678,9 @@ func (s *ContactGroupMembership) MarshalJSON() ([]byte, error) { // ContactGroupMetadata: The metadata about a contact group. type ContactGroupMetadata struct { // Deleted: Output only. True if the contact group resource has been - // deleted. Populated only for `ListContactGroups` requests that include - // a sync token. + // deleted. Populated only for `ListContactGroups` + // (/people/api/rest/v1/contactgroups/list) requests that include a sync + // token. Deleted bool `json:"deleted,omitempty"` // UpdateTime: Output only. The time the group was last updated. @@ -1520,7 +1524,8 @@ type Locale struct { // Metadata: Metadata about the locale. Metadata *FieldMetadata `json:"metadata,omitempty"` - // Value: The well-formed IETF BCP 47 language tag representing the + // Value: The well-formed IETF BCP 47 + // (https://tools.ietf.org/html/bcp47) language tag representing the // locale. Value string `json:"value,omitempty"` @@ -2043,8 +2048,8 @@ type Person struct { // EmailAddresses: The person's email addresses. EmailAddresses []*EmailAddress `json:"emailAddresses,omitempty"` - // Etag: The HTTP entity tag of the resource. Used for web cache - // validation. + // Etag: The HTTP entity tag (https://en.wikipedia.org/wiki/HTTP_ETag) + // of the resource. Used for web cache validation. Etag string `json:"etag,omitempty"` // Events: The person's events. @@ -2166,8 +2171,9 @@ func (s *Person) MarshalJSON() ([]byte, error) { // PersonMetadata: The metadata about a person. type PersonMetadata struct { // Deleted: Output only. True if the person resource has been deleted. - // Populated only for `connections.list` requests that include a sync - // token. + // Populated only for `connections.list` + // (/people/api/rest/v1/people.connections/list) requests that include a + // sync token. Deleted bool `json:"deleted,omitempty"` // LinkedPeopleResourceNames: Output only. Resource names of people @@ -2186,10 +2192,11 @@ type PersonMetadata struct { ObjectType string `json:"objectType,omitempty"` // PreviousResourceNames: Output only. Any former resource names this - // person has had. Populated only for `connections.list` requests that - // include a sync token. The resource name may change when adding or - // removing fields that link a contact and profile such as a verified - // email, verified phone number, or profile URL. + // person has had. Populated only for `connections.list` + // (/people/api/rest/v1/people.connections/list) requests that include a + // sync token. The resource name may change when adding or removing + // fields that link a contact and profile such as a verified email, + // verified phone number, or profile URL. PreviousResourceNames []string `json:"previousResourceNames,omitempty"` // Sources: The sources of data for the person. @@ -2264,8 +2271,9 @@ func (s *PersonResponse) MarshalJSON() ([]byte, error) { // PhoneNumber: A person's phone number. type PhoneNumber struct { - // CanonicalForm: Output only. The canonicalized ITU-T E.164 form of the - // phone number. + // CanonicalForm: Output only. The canonicalized ITU-T E.164 + // (https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf) + // form of the phone number. CanonicalForm string `json:"canonicalForm,omitempty"` // FormattedType: Output only. The type of the phone number translated @@ -2609,7 +2617,8 @@ type SipAddress struct { // of these predefined values: * `home` * `work` * `mobile` * `other` Type string `json:"type,omitempty"` - // Value: The SIP address in the RFC 3261 19.1 SIP URI format. + // Value: The SIP address in the RFC 3261 19.1 + // (https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI format. Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "FormattedType") to @@ -2669,7 +2678,8 @@ func (s *Skill) MarshalJSON() ([]byte, error) { // Source: The source of a field. type Source struct { // Etag: **Only populated in `person.metadata.sources`.** The HTTP - // entity tag of the source. Used for web cache validation. + // entity tag (https://en.wikipedia.org/wiki/HTTP_ETag) of the source. + // Used for web cache validation. Etag string `json:"etag,omitempty"` // Id: The unique identifier within the source type generated by the @@ -2730,10 +2740,11 @@ func (s *Source) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3609,7 +3620,8 @@ func (c *ContactGroupsListCall) PageSize(pageSize int64) *ContactGroupsListCall // PageToken sets the optional parameter "pageToken": The // next_page_token value returned from a previous call to -// ListContactGroups. Requests the next page of resources. +// ListContactGroups (/people/api/rest/v1/contactgroups/list). Requests +// the next page of resources. func (c *ContactGroupsListCall) PageToken(pageToken string) *ContactGroupsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -5205,8 +5217,9 @@ func (c *PeopleGetBatchGetCall) RequestMaskIncludeField(requestMaskIncludeField // about the authenticated user, specify `people/me`. - To get // information about a google account, specify `people/{account_id}`. - // To get information about a contact, specify the resource name that -// identifies the contact as returned by `people.connections.list`. You -// can include up to 50 resource names in one request. +// identifies the contact as returned by `people.connections.list` +// (/people/api/rest/v1/people.connections/list). You can include up to +// 50 resource names in one request. func (c *PeopleGetBatchGetCall) ResourceNames(resourceNames ...string) *PeopleGetBatchGetCall { c.urlParams_.SetMulti("resourceNames", append([]string{}, resourceNames...)) return c diff --git a/playablelocations/v3/playablelocations-gen.go b/playablelocations/v3/playablelocations-gen.go index 0358bc68a59..dde9fc61c13 100644 --- a/playablelocations/v3/playablelocations-gen.go +++ b/playablelocations/v3/playablelocations-gen.go @@ -346,7 +346,11 @@ type GoogleMapsPlayablelocationsV3SampleAreaFilter struct { // between cell level 11 and 14 (inclusive). S2 cells are 64-bit // integers that identify areas on the Earth. They are hierarchical, and // can therefore be used for spatial indexing. The S2 geometry library - // is available in a number of languages: * C++ * Java * Go * Python + // is available in a number of languages: * C++ + // (https://github.com/google/s2geometry) * Java + // (https://github.com/google/s2-geometry-library-java) * Go + // (https://github.com/golang/geo) * Python + // (https://github.com/google/s2geometry/tree/master/src/python) S2CellId uint64 `json:"s2CellId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "S2CellId") to @@ -424,7 +428,7 @@ func (s *GoogleMapsPlayablelocationsV3SampleCriterion) MarshalJSON() ([]byte, er // use when searching for playable locations. type GoogleMapsPlayablelocationsV3SampleFilter struct { // IncludedTypes: Restricts the set of playable locations to just the - // types that you want. + // types (/maps/documentation/gaming/tt/types) that you want. IncludedTypes []string `json:"includedTypes,omitempty"` // MaxLocationCount: Specifies the maximum number of playable locations @@ -481,9 +485,10 @@ type GoogleMapsPlayablelocationsV3SamplePlayableLocation struct { // sidewalk of the nearest road, if a nearby road exists. SnappedPoint *GoogleTypeLatLng `json:"snappedPoint,omitempty"` - // Types: A collection of Playable Location Types for this playable - // location. The first type in the collection is the primary type. Type - // information might not be available for all playable locations. + // Types: A collection of Playable Location Types + // (/maps/documentation/gaming/tt/types) for this playable location. The + // first type in the collection is the primary type. Type information + // might not be available for all playable locations. Types []string `json:"types,omitempty"` // ForceSendFields is a list of field names (e.g. "CenterPoint") to diff --git a/policytroubleshooter/v1/policytroubleshooter-gen.go b/policytroubleshooter/v1/policytroubleshooter-gen.go index 1a41b4f32c1..91fde2e6140 100644 --- a/policytroubleshooter/v1/policytroubleshooter-gen.go +++ b/policytroubleshooter/v1/policytroubleshooter-gen.go @@ -626,7 +626,8 @@ type GoogleIamV1Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -702,7 +703,9 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // expression evaluates to `true`. A condition can add constraints based // on attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -721,7 +724,7 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type GoogleIamV1Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -761,7 +764,8 @@ type GoogleIamV1Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to diff --git a/policytroubleshooter/v1beta/policytroubleshooter-gen.go b/policytroubleshooter/v1beta/policytroubleshooter-gen.go index d3d2058184c..a45e07bd6eb 100644 --- a/policytroubleshooter/v1beta/policytroubleshooter-gen.go +++ b/policytroubleshooter/v1beta/policytroubleshooter-gen.go @@ -626,7 +626,8 @@ type GoogleIamV1Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -702,7 +703,9 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // expression evaluates to `true`. A condition can add constraints based // on attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -721,7 +724,7 @@ func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type GoogleIamV1Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -761,7 +764,8 @@ type GoogleIamV1Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "AuditConfigs") to diff --git a/poly/v1/poly-gen.go b/poly/v1/poly-gen.go index d1555277803..809588720d3 100644 --- a/poly/v1/poly-gen.go +++ b/poly/v1/poly-gen.go @@ -170,11 +170,13 @@ type UsersLikedassetsService struct { } // Asset: Represents and describes an asset in the Poly library. An -// asset is a 3D model or scene created using Tilt Brush, Blocks, or any -// 3D program that produces a file that can be upload to Poly. +// asset is a 3D model or scene created using Tilt Brush +// (//www.tiltbrush.com), Blocks (//vr.google.com/blocks/), or any 3D +// program that produces a file that can be upload to Poly. type Asset struct { // AuthorName: The author's publicly visible name. Use this name when - // giving credit to the author. For more information, see Licensing. + // giving credit to the author. For more information, see Licensing + // (/poly/discover/licensing). AuthorName string `json:"authorName,omitempty"` // CreateTime: For published assets, the time when the asset was @@ -347,7 +349,9 @@ func (s *AssetImportMessage) MarshalJSON() ([]byte, error) { // thumbnail file. type File struct { // ContentType: The MIME content-type, such as `image/png`. For more - // information, see MIME types. + // information, see MIME types + // (//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types + // ). ContentType string `json:"contentType,omitempty"` // RelativePath: The path of the resource file relative to the root @@ -381,10 +385,12 @@ func (s *File) MarshalJSON() ([]byte, error) { } // Format: The same asset can be represented in different formats, for -// example, a WaveFront .obj file with its corresponding .mtl file or a -// Khronos glTF file with its corresponding .glb binary data. A format -// refers to a specific representation of an asset and contains all -// information needed to retrieve and describe this representation. +// example, a WaveFront .obj +// (//en.wikipedia.org/wiki/Wavefront_.obj_file) file with its +// corresponding .mtl file or a Khronos glTF (//www.khronos.org/gltf) +// file with its corresponding .glb binary data. A format refers to a +// specific representation of an asset and contains all information +// needed to retrieve and describe this representation. type Format struct { // FormatComplexity: Complexity stats about this representation of the // asset. @@ -782,9 +788,9 @@ func (s *PresentationParams) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Quaternion: A Quaternion. Please note: if in the response you see "w: -// 1" and nothing else this is the default value of [0, 0, 0, 1] where -// x,y, and z are 0. +// Quaternion: A Quaternion (//en.wikipedia.org/wiki/Quaternion). Please +// note: if in the response you see "w: 1" and nothing else this is the +// default value of [0, 0, 0, 1] where x,y, and z are 0. type Quaternion struct { // W: The scalar component. W float64 `json:"w,omitempty"` diff --git a/privateca/v1beta1/privateca-gen.go b/privateca/v1beta1/privateca-gen.go index 664e5a40f20..318735aabba 100644 --- a/privateca/v1beta1/privateca-gen.go +++ b/privateca/v1beta1/privateca-gen.go @@ -503,7 +503,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -2036,7 +2037,9 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2055,7 +2058,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2095,7 +2098,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2130,8 +2134,9 @@ type PublicKey struct { // Key: Required. A public key. When this is specified in a request, the // padding and encoding can be any of the options described by the // respective 'KeyType' value. When this is generated by the service, it - // will always be an RFC 5280 SubjectPublicKeyInfo structure containing - // an algorithm identifier and a key. + // will always be an RFC 5280 SubjectPublicKeyInfo + // (https://tools.ietf.org/html/rfc5280#section-4.1) structure + // containing an algorithm identifier and a key. Key string `json:"key,omitempty"` // Type: Optional. The type of public key. If specified, it must match @@ -2603,10 +2608,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2898,7 +2904,8 @@ func (s *SubordinateConfigChain) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -4264,7 +4271,8 @@ func (r *ProjectsLocationsCertificateAuthoritiesService) GetIamPolicy(resource s // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsCertificateAuthoritiesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsCertificateAuthoritiesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -5535,7 +5543,8 @@ func (r *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsServic // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsCertificateAuthoritiesCertificateRevocationListsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -6697,7 +6706,9 @@ func (r *ProjectsLocationsCertificateAuthoritiesCertificatesService) List(parent // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For details on supported -// filters and syntax, see Certificates Filtering documentation. +// filters and syntax, see Certificates Filtering documentation +// (https://cloud.google.com/certificate-authority-service/docs/sorting-f +// iltering-certificates#filtering_support). func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) Filter(filter string) *ProjectsLocationsCertificateAuthoritiesCertificatesListCall { c.urlParams_.Set("filter", filter) return c @@ -6705,7 +6716,9 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) Filter(fil // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. For details on supported fields and syntax, -// see Certificates Sorting documentation. +// see Certificates Sorting documentation +// (https://cloud.google.com/certificate-authority-service/docs/sorting-f +// iltering-certificates#sorting_support). func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) OrderBy(orderBy string) *ProjectsLocationsCertificateAuthoritiesCertificatesListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -8022,7 +8035,8 @@ func (r *ProjectsLocationsReusableConfigsService) GetIamPolicy(resource string) // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsReusableConfigsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsReusableConfigsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go index fbb24126842..1c2ef860870 100644 --- a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go +++ b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go @@ -1533,10 +1533,11 @@ func (s *SasPortalSignDeviceRequest) MarshalJSON() ([]byte, error) { // SasPortalStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type SasPortalStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/pubsub/v1/pubsub-gen.go b/pubsub/v1/pubsub-gen.go index ad99e1fce91..284ce208120 100644 --- a/pubsub/v1/pubsub-gen.go +++ b/pubsub/v1/pubsub-gen.go @@ -252,7 +252,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -816,7 +817,8 @@ func (s *ModifyPushConfigRequest) MarshalJSON() ([]byte, error) { } // OidcToken: Contains information needed for generating an OpenID -// Connect token. +// Connect token +// (https://developers.google.com/identity/protocols/OpenIDConnect). type OidcToken struct { // Audience: Audience to be used when generating OIDC token. The // audience claim identifies the recipients that the JWT is intended @@ -827,8 +829,9 @@ type OidcToken struct { // specified, the Push endpoint URL will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: Service account email to be used for generating - // the OIDC token. The caller (for CreateSubscription, + // ServiceAccountEmail: Service account email + // (https://cloud.google.com/iam/docs/service-accounts) to be used for + // generating the OIDC token. The caller (for CreateSubscription, // UpdateSubscription, and ModifyPushConfig RPCs) must have the // iam.serviceAccounts.actAs permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` @@ -868,7 +871,9 @@ func (s *OidcToken) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -887,7 +892,7 @@ func (s *OidcToken) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -923,7 +928,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1019,9 +1025,11 @@ func (s *PublishResponse) MarshalJSON() ([]byte, error) { // by subscribers. The message must contain either a non-empty data // field or at least one attribute. Note that client libraries represent // this object differently depending on the language. See the -// corresponding client library documentation for more information. See -// [quotas and limits] (https://cloud.google.com/pubsub/quotas) for more -// information about message limits. +// corresponding client library documentation +// (https://cloud.google.com/pubsub/docs/reference/libraries) for more +// information. See [quotas and limits] +// (https://cloud.google.com/pubsub/quotas) for more information about +// message limits. type PubsubMessage struct { // Attributes: Attributes for this message. If this field is empty, the // message must contain non-empty data. This can be used to filter @@ -1374,7 +1382,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Snapshot: A snapshot resource. Snapshots are used in Seek operations, +// Snapshot: A snapshot resource. Snapshots are used in Seek +// (https://cloud.google.com/pubsub/docs/replay-overview) operations, // which allow you to manage message acknowledgments in bulk. That is, // you can set the acknowledgment state of messages in an existing // subscription to the state captured by a snapshot. @@ -1480,10 +1489,11 @@ type Subscription struct { // `expiration_policy.ttl` is 1 day. ExpirationPolicy *ExpirationPolicy `json:"expirationPolicy,omitempty"` - // Filter: An expression written in the Pub/Sub filter language. If - // non-empty, then only `PubsubMessage`s whose `attributes` field - // matches the filter are delivered on this subscription. If empty, then - // no messages are filtered out. + // Filter: An expression written in the Pub/Sub filter language + // (https://cloud.google.com/pubsub/docs/filtering). If non-empty, then + // only `PubsubMessage`s whose `attributes` field matches the filter are + // delivered on this subscription. If empty, then no messages are + // filtered out. Filter string `json:"filter,omitempty"` // Labels: See Creating and managing labels. @@ -1565,7 +1575,8 @@ func (s *Subscription) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1793,18 +1804,19 @@ type ProjectsSnapshotsCreateCall struct { } // Create: Creates a snapshot from the requested subscription. Snapshots -// are used in Seek operations, which allow you to manage message -// acknowledgments in bulk. That is, you can set the acknowledgment -// state of messages in an existing subscription to the state captured -// by a snapshot. If the snapshot already exists, returns -// `ALREADY_EXISTS`. If the requested subscription doesn't exist, -// returns `NOT_FOUND`. If the backlog in the subscription is too old -- -// and the resulting snapshot would expire in less than 1 hour -- then -// `FAILED_PRECONDITION` is returned. See also the -// `Snapshot.expire_time` field. If the name is not provided in the -// request, the server will assign a random name for this snapshot on -// the same project as the subscription, conforming to the [resource -// name format] +// are used in Seek +// (https://cloud.google.com/pubsub/docs/replay-overview) operations, +// which allow you to manage message acknowledgments in bulk. That is, +// you can set the acknowledgment state of messages in an existing +// subscription to the state captured by a snapshot. If the snapshot +// already exists, returns `ALREADY_EXISTS`. If the requested +// subscription doesn't exist, returns `NOT_FOUND`. If the backlog in +// the subscription is too old -- and the resulting snapshot would +// expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. +// See also the `Snapshot.expire_time` field. If the name is not +// provided in the request, the server will assign a random name for +// this snapshot on the same project as the subscription, conforming to +// the [resource name format] // (https://cloud.google.com/pubsub/docs/admin#resource_names). The // generated name is populated in the returned Snapshot object. Note // that for REST API requests, you must specify a name in the request. @@ -2252,7 +2264,8 @@ func (r *ProjectsSnapshotsService) GetIamPolicy(resource string) *ProjectsSnapsh // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsSnapshotsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsSnapshotsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -2402,10 +2415,11 @@ type ProjectsSnapshotsListCall struct { header_ http.Header } -// List: Lists the existing snapshots. Snapshots are used in Seek -// operations, which allow you to manage message acknowledgments in -// bulk. That is, you can set the acknowledgment state of messages in an -// existing subscription to the state captured by a snapshot. +// List: Lists the existing snapshots. Snapshots are used in Seek ( +// https://cloud.google.com/pubsub/docs/replay-overview) operations, +// which allow you to manage message acknowledgments in bulk. That is, +// you can set the acknowledgment state of messages in an existing +// subscription to the state captured by a snapshot. func (r *ProjectsSnapshotsService) List(project string) *ProjectsSnapshotsListCall { c := &ProjectsSnapshotsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project @@ -3760,7 +3774,8 @@ func (r *ProjectsSubscriptionsService) GetIamPolicy(resource string) *ProjectsSu // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsSubscriptionsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsSubscriptionsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -5556,7 +5571,8 @@ func (r *ProjectsTopicsService) GetIamPolicy(resource string) *ProjectsTopicsGet // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsTopicsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsTopicsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -6473,10 +6489,10 @@ type ProjectsTopicsSnapshotsListCall struct { } // List: Lists the names of the snapshots on this topic. Snapshots are -// used in Seek operations, which allow you to manage message -// acknowledgments in bulk. That is, you can set the acknowledgment -// state of messages in an existing subscription to the state captured -// by a snapshot. +// used in Seek (https://cloud.google.com/pubsub/docs/replay-overview) +// operations, which allow you to manage message acknowledgments in +// bulk. That is, you can set the acknowledgment state of messages in an +// existing subscription to the state captured by a snapshot. func (r *ProjectsTopicsSnapshotsService) List(topic string) *ProjectsTopicsSnapshotsListCall { c := &ProjectsTopicsSnapshotsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.topic = topic diff --git a/pubsub/v1beta2/pubsub-gen.go b/pubsub/v1beta2/pubsub-gen.go index 8a8a9933b2c..935a2d6d14f 100644 --- a/pubsub/v1beta2/pubsub-gen.go +++ b/pubsub/v1beta2/pubsub-gen.go @@ -228,7 +228,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -550,7 +551,8 @@ func (s *ModifyPushConfigRequest) MarshalJSON() ([]byte, error) { } // OidcToken: Contains information needed for generating an OpenID -// Connect token. +// Connect token +// (https://developers.google.com/identity/protocols/OpenIDConnect). type OidcToken struct { // Audience: Audience to be used when generating OIDC token. The // audience claim identifies the recipients that the JWT is intended @@ -561,8 +563,9 @@ type OidcToken struct { // specified, the Push endpoint URL will be used. Audience string `json:"audience,omitempty"` - // ServiceAccountEmail: Service account email to be used for generating - // the OIDC token. The caller (for CreateSubscription, + // ServiceAccountEmail: Service account email + // (https://cloud.google.com/iam/docs/service-accounts) to be used for + // generating the OIDC token. The caller (for CreateSubscription, // UpdateSubscription, and ModifyPushConfig RPCs) must have the // iam.serviceAccounts.actAs permission for the service account. ServiceAccountEmail string `json:"serviceAccountEmail,omitempty"` @@ -602,7 +605,9 @@ func (s *OidcToken) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -621,7 +626,7 @@ func (s *OidcToken) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -657,7 +662,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -757,7 +763,7 @@ type PubsubMessage struct { Attributes map[string]string `json:"attributes,omitempty"` // Data: The message payload. For JSON requests, the value of this field - // must be base64-encoded. + // must be base64-encoded (https://tools.ietf.org/html/rfc4648). Data string `json:"data,omitempty"` // MessageId: ID of this message, assigned by the server when the @@ -1054,7 +1060,8 @@ func (s *Subscription) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1751,7 +1758,8 @@ func (r *ProjectsSubscriptionsService) GetIamPolicy(resource string) *ProjectsSu // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsSubscriptionsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsSubscriptionsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -3257,7 +3265,8 @@ func (r *ProjectsTopicsService) GetIamPolicy(resource string) *ProjectsTopicsGet // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsTopicsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsTopicsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/realtimebidding/v1/realtimebidding-gen.go b/realtimebidding/v1/realtimebidding-gen.go index 68416c846ca..3c462d86bb2 100644 --- a/realtimebidding/v1/realtimebidding-gen.go +++ b/realtimebidding/v1/realtimebidding-gen.go @@ -497,9 +497,11 @@ type Creative struct { // DeclaredAttributes: All declared attributes for the ads that may be // shown from this creative. Can be used to filter the response of the // creatives.list method. If the `excluded_attribute` field of a bid - // request contains one of the attributes that were declared or detected - // for a given creative, and a bid is submitted with that creative, the - // bid will be filtered before the auction. + // request + // (https://developers.google.com/authorized-buyers/rtb/downloads/realtim + // e-bidding-proto") contains one of the attributes that were declared + // or detected for a given creative, and a bid is submitted with that + // creative, the bid will be filtered before the auction. // // Possible values: // "ATTRIBUTE_UNSPECIFIED" - Do not use. This is a placeholder value @@ -695,9 +697,11 @@ type CreativeServingDecision struct { // DetectedAttributes: Publisher-excludable attributes that were // detected for this creative. Can be used to filter the response of the // creatives.list method. If the `excluded_attribute` field of a bid - // request contains one of the attributes that were declared or detected - // for a given creative, and a bid is submitted with that creative, the - // bid will be filtered before the auction. + // request + // (https://developers.google.com/authorized-buyers/rtb/downloads/realtim + // e-bidding-proto) contains one of the attributes that were declared or + // detected for a given creative, and a bid is submitted with that + // creative, the bid will be filtered before the auction. // // Possible values: // "ATTRIBUTE_UNSPECIFIED" - Do not use. This is a placeholder value @@ -793,9 +797,12 @@ type CreativeServingDecision struct { // https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for // possible values. Can be used to filter the response of the // creatives.list method. If the `allowed_vendor_type` field of a bid - // request does not contain one of the vendor type IDs that were - // declared or detected for a given creative, and a bid is submitted - // with that creative, the bid will be filtered before the auction. + // request + // (https://developers.google.com/authorized-buyers/rtb/downloads/realtim + // e-bidding-proto) does not contain one of the vendor type IDs that + // were declared or detected for a given creative, and a bid is + // submitted with that creative, the bid will be filtered before the + // auction. DetectedVendorIds []int64 `json:"detectedVendorIds,omitempty"` // LastStatusUpdate: The last time the creative status was updated. Can @@ -1170,7 +1177,8 @@ type Empty struct { type GetRemarketingTagResponse struct { // Snippet: A HTML tag that can be placed on the advertiser's page to // add users to a user list. For more information and code samples on - // using snippet on your website refer to Tag your site for remarketing. + // using snippet on your website refer to Tag your site for remarketing + // ( https://support.google.com/google-ads/answer/2476688). Snippet string `json:"snippet,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1930,10 +1938,15 @@ type PretargetingConfig struct { // sent only if the publisher is listed in the targeting dimension) or // negatively (bid requests will be sent only if the publisher is not // listed in the targeting dimension). A maximum of 10,000 publisher IDs - // can be targeted. Publisher IDs are found in ads.txt / app-ads.txt and - // in bid requests in the `BidRequest.publisher_id` field on the Google - // RTB protocol or the `BidRequest.site.publisher.id` / - // `BidRequest.app.publisher.id` field on the OpenRTB protocol. + // can be targeted. Publisher IDs are found in ads.txt + // (https://iabtechlab.com/ads-txt/) / app-ads.txt + // (https://iabtechlab.com/app-ads-txt/) and in bid requests in the + // `BidRequest.publisher_id` field on the Google RTB protocol + // (https://developers.google.com/authorized-buyers/rtb/downloads/realtim + // e-bidding-proto) or the `BidRequest.site.publisher.id` / + // `BidRequest.app.publisher.id` field on the OpenRTB protocol + // (https://developers.google.com/authorized-buyers/rtb/downloads/openrtb + // -adx-proto). PublisherTargeting *StringTargetingDimension `json:"publisherTargeting,omitempty"` // State: Output only. The state of this pretargeting configuration. diff --git a/recommendationengine/v1beta1/recommendationengine-gen.go b/recommendationengine/v1beta1/recommendationengine-gen.go index 81d5783b427..7f343dd4b21 100644 --- a/recommendationengine/v1beta1/recommendationengine-gen.go +++ b/recommendationengine/v1beta1/recommendationengine-gen.go @@ -547,7 +547,8 @@ type GoogleCloudRecommendationengineV1beta1CatalogItem struct { // ItemGroupId: Optional. Variant group identifier for prediction // results. UTF-8 encoded string with a length limit of 128 bytes. This - // field must be enabled before it can be used. Learn more. + // field must be enabled before it can be used. Learn more + // (/recommendations-ai/docs/catalog#item-group-id). ItemGroupId string `json:"itemGroupId,omitempty"` // LanguageCode: Optional. Deprecated. The model automatically detects @@ -894,8 +895,9 @@ type GoogleCloudRecommendationengineV1beta1GcsSource struct { // path (for example, gs://bucket/directory/object.json) or a pattern // matching one or more files, such as gs://bucket/directory/*.json. A // request can contain at most 100 files, and each file can be up to 2 - // GB. See Importing catalog information for the expected file format - // and setup instructions. + // GB. See Importing catalog information + // (/recommendations-ai/docs/upload-catalog) for the expected file + // format and setup instructions. InputUris []string `json:"inputUris,omitempty"` // JsonSchema: Optional. The schema to use when parsing the data from @@ -2529,10 +2531,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4219,7 +4222,8 @@ type ProjectsLocationsCatalogsEventStoresPlacementsPredictCall struct { // Predict: Makes a recommendation prediction. If using API Key based // authentication, the API Key must be registered using the -// PredictionApiKeyRegistry service. Learn more. +// PredictionApiKeyRegistry service. Learn more +// (/recommendations-ai/docs/setting-up#register-key). func (r *ProjectsLocationsCatalogsEventStoresPlacementsService) Predict(name string, googlecloudrecommendationenginev1beta1predictrequest *GoogleCloudRecommendationengineV1beta1PredictRequest) *ProjectsLocationsCatalogsEventStoresPlacementsPredictCall { c := &ProjectsLocationsCatalogsEventStoresPlacementsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/redis/v1/redis-gen.go b/redis/v1/redis-gen.go index 6586b2f1db8..56f1ea1f19e 100644 --- a/redis/v1/redis-gen.go +++ b/redis/v1/redis-gen.go @@ -479,8 +479,9 @@ type Instance struct { AuthEnabled bool `json:"authEnabled,omitempty"` // AuthorizedNetwork: Optional. The full name of the Google Compute - // Engine network to which the instance is connected. If left - // unspecified, the `default` network will be used. + // Engine network (https://cloud.google.com/vpc/docs/vpc) to which the + // instance is connected. If left unspecified, the `default` network + // will be used. AuthorizedNetwork string `json:"authorizedNetwork,omitempty"` // ConnectMode: Optional. The network connect mode of the Redis @@ -947,10 +948,11 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -994,11 +996,13 @@ type TlsCertificate struct { Cert string `json:"cert,omitempty"` // CreateTime: Output only. The time when the certificate was created in - // RFC 3339 format, for example `2020-05-18T00:00:00.094Z`. + // RFC 3339 (https://tools.ietf.org/html/rfc3339) format, for example + // `2020-05-18T00:00:00.094Z`. CreateTime string `json:"createTime,omitempty"` // ExpireTime: Output only. The time when the certificate expires in RFC - // 3339 format, for example `2020-05-18T00:00:00.094Z`. + // 3339 (https://tools.ietf.org/html/rfc3339) format, for example + // `2020-05-18T00:00:00.094Z`. ExpireTime string `json:"expireTime,omitempty"` // SerialNumber: Serial number, as extracted from the certificate. @@ -1419,13 +1423,13 @@ type ProjectsLocationsInstancesCreateCall struct { // Create: Creates a Redis instance based on the specified tier and // memory size. By default, the instance is accessible from the -// project's default network. The creation is executed asynchronously -// and callers may check the returned operation to track its progress. -// Once the operation is completed the Redis instance will be fully -// functional. Completed longrunning.Operation will contain the new -// instance object in the response field. The returned operation is -// automatically deleted after a few hours, so there is no need to call -// DeleteOperation. +// project's default network (https://cloud.google.com/vpc/docs/vpc). +// The creation is executed asynchronously and callers may check the +// returned operation to track its progress. Once the operation is +// completed the Redis instance will be fully functional. Completed +// longrunning.Operation will contain the new instance object in the +// response field. The returned operation is automatically deleted after +// a few hours, so there is no need to call DeleteOperation. func (r *ProjectsLocationsInstancesService) Create(parent string, instance *Instance) *ProjectsLocationsInstancesCreateCall { c := &ProjectsLocationsInstancesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/redis/v1beta1/redis-gen.go b/redis/v1beta1/redis-gen.go index a6b0099d277..7b628fc808e 100644 --- a/redis/v1beta1/redis-gen.go +++ b/redis/v1beta1/redis-gen.go @@ -484,8 +484,9 @@ type Instance struct { AuthEnabled bool `json:"authEnabled,omitempty"` // AuthorizedNetwork: Optional. The full name of the Google Compute - // Engine network to which the instance is connected. If left - // unspecified, the `default` network will be used. + // Engine network (https://cloud.google.com/vpc/docs/vpc) to which the + // instance is connected. If left unspecified, the `default` network + // will be used. AuthorizedNetwork string `json:"authorizedNetwork,omitempty"` // ConnectMode: Optional. The network connect mode of the Redis @@ -952,10 +953,11 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -999,11 +1001,13 @@ type TlsCertificate struct { Cert string `json:"cert,omitempty"` // CreateTime: Output only. The time when the certificate was created in - // RFC 3339 format, for example `2020-05-18T00:00:00.094Z`. + // RFC 3339 (https://tools.ietf.org/html/rfc3339) format, for example + // `2020-05-18T00:00:00.094Z`. CreateTime string `json:"createTime,omitempty"` // ExpireTime: Output only. The time when the certificate expires in RFC - // 3339 format, for example `2020-05-18T00:00:00.094Z`. + // 3339 (https://tools.ietf.org/html/rfc3339) format, for example + // `2020-05-18T00:00:00.094Z`. ExpireTime string `json:"expireTime,omitempty"` // SerialNumber: Serial number, as extracted from the certificate. @@ -1424,13 +1428,13 @@ type ProjectsLocationsInstancesCreateCall struct { // Create: Creates a Redis instance based on the specified tier and // memory size. By default, the instance is accessible from the -// project's default network. The creation is executed asynchronously -// and callers may check the returned operation to track its progress. -// Once the operation is completed the Redis instance will be fully -// functional. Completed longrunning.Operation will contain the new -// instance object in the response field. The returned operation is -// automatically deleted after a few hours, so there is no need to call -// DeleteOperation. +// project's default network (https://cloud.google.com/vpc/docs/vpc). +// The creation is executed asynchronously and callers may check the +// returned operation to track its progress. Once the operation is +// completed the Redis instance will be fully functional. Completed +// longrunning.Operation will contain the new instance object in the +// response field. The returned operation is automatically deleted after +// a few hours, so there is no need to call DeleteOperation. func (r *ProjectsLocationsInstancesService) Create(parent string, instance *Instance) *ProjectsLocationsInstancesCreateCall { c := &ProjectsLocationsInstancesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/remotebuildexecution/v1/remotebuildexecution-gen.go b/remotebuildexecution/v1/remotebuildexecution-gen.go index e5a69d6b507..3995c2a376e 100644 --- a/remotebuildexecution/v1/remotebuildexecution-gen.go +++ b/remotebuildexecution/v1/remotebuildexecution-gen.go @@ -2385,7 +2385,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"` // DiskType: Required. Disk Type to use for the worker. See Storage - // options. Currently only `pd-standard` and `pd-ssd` are supported. + // options (https://cloud.google.com/compute/docs/disks/#introduction). + // Currently only `pd-standard` and `pd-ssd` are supported. DiskType string `json:"diskType,omitempty"` // Labels: Labels associated with the workers. Label keys and values can @@ -2407,7 +2408,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { MaxConcurrentActions int64 `json:"maxConcurrentActions,omitempty,string"` // MinCpuPlatform: Minimum CPU platform to use when creating the worker. - // See CPU Platforms. + // See CPU Platforms + // (https://cloud.google.com/compute/docs/cpu-platforms). MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NetworkAccess: Determines the type of network access granted to @@ -2420,7 +2422,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { // Reserved: Determines whether the worker is reserved (equivalent to a // Compute Engine on-demand VM and therefore won't be preempted). See - // Preemptible VMs for more details. + // Preemptible VMs (https://cloud.google.com/preemptible-vms/) for more + // details. Reserved bool `json:"reserved,omitempty"` // SoleTenantNodeType: The node type name to be used for sole-tenant @@ -3245,10 +3248,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/remotebuildexecution/v1alpha/remotebuildexecution-gen.go b/remotebuildexecution/v1alpha/remotebuildexecution-gen.go index 3a990067c05..04375b825e3 100644 --- a/remotebuildexecution/v1alpha/remotebuildexecution-gen.go +++ b/remotebuildexecution/v1alpha/remotebuildexecution-gen.go @@ -2365,7 +2365,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"` // DiskType: Required. Disk Type to use for the worker. See Storage - // options. Currently only `pd-standard` and `pd-ssd` are supported. + // options (https://cloud.google.com/compute/docs/disks/#introduction). + // Currently only `pd-standard` and `pd-ssd` are supported. DiskType string `json:"diskType,omitempty"` // Labels: Labels associated with the workers. Label keys and values can @@ -2387,7 +2388,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { MaxConcurrentActions int64 `json:"maxConcurrentActions,omitempty,string"` // MinCpuPlatform: Minimum CPU platform to use when creating the worker. - // See CPU Platforms. + // See CPU Platforms + // (https://cloud.google.com/compute/docs/cpu-platforms). MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NetworkAccess: Determines the type of network access granted to @@ -2400,7 +2402,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { // Reserved: Determines whether the worker is reserved (equivalent to a // Compute Engine on-demand VM and therefore won't be preempted). See - // Preemptible VMs for more details. + // Preemptible VMs (https://cloud.google.com/preemptible-vms/) for more + // details. Reserved bool `json:"reserved,omitempty"` // SoleTenantNodeType: The node type name to be used for sole-tenant @@ -3175,10 +3178,11 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/remotebuildexecution/v2/remotebuildexecution-gen.go b/remotebuildexecution/v2/remotebuildexecution-gen.go index 8f0f8b42ffe..ede62317bf6 100644 --- a/remotebuildexecution/v2/remotebuildexecution-gen.go +++ b/remotebuildexecution/v2/remotebuildexecution-gen.go @@ -3127,7 +3127,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"` // DiskType: Required. Disk Type to use for the worker. See Storage - // options. Currently only `pd-standard` and `pd-ssd` are supported. + // options (https://cloud.google.com/compute/docs/disks/#introduction). + // Currently only `pd-standard` and `pd-ssd` are supported. DiskType string `json:"diskType,omitempty"` // Labels: Labels associated with the workers. Label keys and values can @@ -3149,7 +3150,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { MaxConcurrentActions int64 `json:"maxConcurrentActions,omitempty,string"` // MinCpuPlatform: Minimum CPU platform to use when creating the worker. - // See CPU Platforms. + // See CPU Platforms + // (https://cloud.google.com/compute/docs/cpu-platforms). MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NetworkAccess: Determines the type of network access granted to @@ -3162,7 +3164,8 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig struct { // Reserved: Determines whether the worker is reserved (equivalent to a // Compute Engine on-demand VM and therefore won't be preempted). See - // Preemptible VMs for more details. + // Preemptible VMs (https://cloud.google.com/preemptible-vms/) for more + // details. Reserved bool `json:"reserved,omitempty"` // SoleTenantNodeType: The node type name to be used for sole-tenant @@ -3933,10 +3936,11 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/run/v1/run-gen.go b/run/v1/run-gen.go index 5450c2881e9..afb6de6243b 100644 --- a/run/v1/run-gen.go +++ b/run/v1/run-gen.go @@ -450,7 +450,8 @@ func (s *AuditLogConfig) MarshalJSON() ([]byte, error) { // AuthorizedDomain: A domain that a user has been authorized to // administer. To authorize use of a domain, verify ownership via -// Webmaster Central. +// Webmaster Central +// (https://www.google.com/webmasters/verification/home). type AuthorizedDomain struct { // Id: Relative name of the domain authorized for use. Example: // `example.com`. @@ -492,7 +493,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -2202,7 +2204,9 @@ func (s *OwnerReference) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2221,7 +2225,7 @@ func (s *OwnerReference) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2261,7 +2265,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -3402,7 +3407,8 @@ func (s *TCPSocketAction) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -9679,7 +9685,8 @@ func (r *ProjectsLocationsServicesService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsServicesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsServicesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/run/v1alpha1/run-gen.go b/run/v1alpha1/run-gen.go index 96aeb4d1d7b..d1e3c6413aa 100644 --- a/run/v1alpha1/run-gen.go +++ b/run/v1alpha1/run-gen.go @@ -561,7 +561,8 @@ func (s *AuditLogConfig) MarshalJSON() ([]byte, error) { // AuthorizedDomain: A domain that a user has been authorized to // administer. To authorize use of a domain, verify ownership via -// Webmaster Central. +// Webmaster Central +// (https://www.google.com/webmasters/verification/home). type AuthorizedDomain struct { // Id: Relative name of the domain authorized for use. Example: // `example.com`. @@ -602,7 +603,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -3558,7 +3560,9 @@ func (s *OwnerReference) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -3577,7 +3581,7 @@ func (s *OwnerReference) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -3617,7 +3621,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -5019,7 +5024,8 @@ func (s *TCPSocketAction) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -18199,7 +18205,8 @@ func (r *ProjectsLocationsServicesService) GetIamPolicy(resource string) *Projec // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsLocationsServicesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsServicesGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/runtimeconfig/v1/runtimeconfig-gen.go b/runtimeconfig/v1/runtimeconfig-gen.go index d1b62c9056e..a26d8ed38e6 100644 --- a/runtimeconfig/v1/runtimeconfig-gen.go +++ b/runtimeconfig/v1/runtimeconfig-gen.go @@ -266,10 +266,11 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/runtimeconfig/v1beta1/runtimeconfig-gen.go b/runtimeconfig/v1beta1/runtimeconfig-gen.go index 1a99d7bc748..d9ac4e4671d 100644 --- a/runtimeconfig/v1beta1/runtimeconfig-gen.go +++ b/runtimeconfig/v1beta1/runtimeconfig-gen.go @@ -208,7 +208,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -615,7 +616,9 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -634,7 +637,7 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -670,7 +673,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -778,10 +782,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -824,7 +829,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -899,9 +905,10 @@ type Variable struct { // element separators and are not part of the `[VARIABLE_NAME]` itself, // so `[VARIABLE_NAME]` must contain at least one non-slash character. // Multiple slashes are coalesced into single slash character. Each path - // segment should match 0-9A-Za-z? regular expression. The length of a - // `[VARIABLE_NAME]` must be less than 256 characters. Once you create a - // variable, you cannot change the variable name. + // segment should match 0-9A-Za-z (?:[_.A-Za-z0-9-]{0,62}[_.A-Za-z0-9])? + // regular expression. The length of a `[VARIABLE_NAME]` must be less + // than 256 characters. Once you create a variable, you cannot change + // the variable name. Name string `json:"name,omitempty"` // State: Output only. The current state of the variable. The variable @@ -968,7 +975,9 @@ func (s *Variable) MarshalJSON() ([]byte, error) { // in. Afterwards, your application runs some arbitrary code after the // condition has been met and the waiter returns successfully. Once // created, a Waiter resource is immutable. To learn more about using -// waiters, read the Creating a Waiter documentation. +// waiters, read the Creating a Waiter +// (/deployment-manager/runtime-configurator/creating-a-waiter) +// documentation. type Waiter struct { // CreateTime: Output only. The instant at which this Waiter resource // was created. Adding the value of `timeout` to this instant yields the @@ -1536,7 +1545,8 @@ func (r *ProjectsConfigsService) GetIamPolicy(resource string) *ProjectsConfigsG // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsConfigsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsConfigsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c @@ -2607,7 +2617,9 @@ type ProjectsConfigsVariablesCreateCall struct { // create a variable with a name that is a prefix of an existing // variable name, or a name that has an existing variable name as a // prefix. To learn more about creating a variable, read the Setting and -// Getting Data documentation. +// Getting Data +// (/deployment-manager/runtime-configurator/set-and-get-variables) +// documentation. func (r *ProjectsConfigsVariablesService) Create(parent string, variable *Variable) *ProjectsConfigsVariablesCreateCall { c := &ProjectsConfigsVariablesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -3576,7 +3588,9 @@ type ProjectsConfigsVariablesWatchCall struct { // a larger value than internal timeout (60 seconds), the current // variable value is returned and the `variableState` will be // `VARIABLE_STATE_UNSPECIFIED`. To learn more about creating a watcher, -// read the Watching a Variable for Changes documentation. +// read the Watching a Variable for Changes +// (/deployment-manager/runtime-configurator/watching-a-variable) +// documentation. func (r *ProjectsConfigsVariablesService) Watch(name string, watchvariablerequest *WatchVariableRequest) *ProjectsConfigsVariablesWatchCall { c := &ProjectsConfigsVariablesWatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/sasportal/v1alpha1/sasportal-gen.go b/sasportal/v1alpha1/sasportal-gen.go index 45e90c22c23..6a89c9a4393 100644 --- a/sasportal/v1alpha1/sasportal-gen.go +++ b/sasportal/v1alpha1/sasportal-gen.go @@ -1533,10 +1533,11 @@ func (s *SasPortalSignDeviceRequest) MarshalJSON() ([]byte, error) { // SasPortalStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type SasPortalStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/script/v1/script-gen.go b/script/v1/script-gen.go index 77459840d77..db73aca04bd 100644 --- a/script/v1/script-gen.go +++ b/script/v1/script-gen.go @@ -573,11 +573,14 @@ type ExecutionRequest struct { // SessionState: *Deprecated*. For use with Android add-ons only. An ID // that represents the user's current session in the Android app for - // Google Docs or Sheets, included as extra data in the Intent that - // launches the add-on. When an Android add-on is run with a session - // state, it gains the privileges of a bound script—that is, it can - // access information like the user's current cursor position (in Docs) - // or selected cell (in Sheets). To retrieve the state, call + // Google Docs or Sheets, included as extra data in the Intent + // (https://developer.android.com/guide/components/intents-filters.html) + // that launches the add-on. When an Android add-on is run with a + // session state, it gains the privileges of a bound + // (https://developers.google.com/apps-script/guides/bound) + // script—that is, it can access information like the user's current + // cursor position (in Docs) or selected cell (in Sheets). To retrieve + // the state, call // `Intent.getStringExtra("com.google.android.apps.docs.addons.SessionSta // te")`. Optional. SessionState string `json:"sessionState,omitempty"` @@ -1335,9 +1338,10 @@ func (s *MetricsValue) MarshalJSON() ([]byte, error) { // Operation: A representation of an execution of an Apps Script // function started with run. The execution response does not arrive // until the function finishes executing. The maximum execution runtime -// is listed in the Apps Script quotas guide. After execution has -// started, it can have one of four outcomes: - If the script function -// returns successfully, the response field contains an +// is listed in the Apps Script quotas guide +// (/apps-script/guides/services/quotas#current_limitations). After +// execution has started, it can have one of four outcomes: - If the +// script function returns successfully, the response field contains an // ExecutionResponse object with the function's return value in the // object's `result` field. - If the script function (or Apps Script // itself) throws an exception, the error field contains a Status @@ -4533,14 +4537,14 @@ type ScriptsRunCall struct { // must be deployed for use with the Apps Script API and the calling // application must share the same Cloud Platform project. This method // requires authorization with an OAuth 2.0 token that includes at least -// one of the scopes listed in the Authorization section; script -// projects that do not require authorization cannot be executed through -// this API. To find the correct scopes to include in the authentication -// token, open the project in the script editor, then select **File > -// Project properties** and click the **Scopes** tab. The error `403, -// PERMISSION_DENIED: The caller does not have permission` indicates -// that the Cloud Platform project used to authorize the request is not -// the same as the one used by the script. +// one of the scopes listed in the Authorization (#authorization-scopes) +// section; script projects that do not require authorization cannot be +// executed through this API. To find the correct scopes to include in +// the authentication token, open the project in the script editor, then +// select **File > Project properties** and click the **Scopes** tab. +// The error `403, PERMISSION_DENIED: The caller does not have +// permission` indicates that the Cloud Platform project used to +// authorize the request is not the same as the one used by the script. func (r *ScriptsService) Run(scriptId string, executionrequest *ExecutionRequest) *ScriptsRunCall { c := &ScriptsRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.scriptId = scriptId diff --git a/searchconsole/v1/searchconsole-gen.go b/searchconsole/v1/searchconsole-gen.go index 5c8acb29ba2..b7ff165f09e 100644 --- a/searchconsole/v1/searchconsole-gen.go +++ b/searchconsole/v1/searchconsole-gen.go @@ -719,7 +719,7 @@ func (s *SearchAnalyticsQueryResponse) MarshalJSON() ([]byte, error) { // SitemapsListResponse: List of sitemaps. type SitemapsListResponse struct { // Sitemap: Contains detailed information about a specific URL submitted - // as a sitemap. + // as a sitemap (https://support.google.com/webmasters/answer/156184). Sitemap []*WmxSitemap `json:"sitemap,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -752,8 +752,8 @@ func (s *SitemapsListResponse) MarshalJSON() ([]byte, error) { // SitesListResponse: List of sites with access level information. type SitesListResponse struct { // SiteEntry: Contains permission level information about a Search - // Console site. For more information, see Permissions in Search - // Console. + // Console site. For more information, see Permissions in Search Console + // (https://support.google.com/webmasters/answer/2451999). SiteEntry []*WmxSite `json:"siteEntry,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -828,7 +828,8 @@ func (s *TestStatus) MarshalJSON() ([]byte, error) { } // WmxSite: Contains permission level information about a Search Console -// site. For more information, see Permissions in Search Console. +// site. For more information, see Permissions in Search Console +// (https://support.google.com/webmasters/answer/2451999). type WmxSite struct { // PermissionLevel: The user's permission level for the site. // @@ -875,7 +876,8 @@ func (s *WmxSite) MarshalJSON() ([]byte, error) { } // WmxSitemap: Contains detailed information about a specific URL -// submitted as a sitemap. +// submitted as a sitemap +// (https://support.google.com/webmasters/answer/156184). type WmxSitemap struct { // Contents: The various content types in the sitemap. Contents []*WmxSitemapContent `json:"contents,omitempty"` @@ -1415,9 +1417,9 @@ type SitemapsListCall struct { header_ http.Header } -// List: Lists the sitemaps-entries submitted for this site, or -// included in the sitemap index file (if `sitemapIndex` is specified in -// the request). +// List: Lists the sitemaps-entries (/webmaster-tools/v3/sitemaps) +// submitted for this site, or included in the sitemap index file (if +// `sitemapIndex` is specified in the request). func (r *SitemapsService) List(siteUrl string) *SitemapsListCall { c := &SitemapsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.siteUrl = siteUrl diff --git a/secretmanager/v1/secretmanager-gen.go b/secretmanager/v1/secretmanager-gen.go index 9250e59f72b..c0d22d5516f 100644 --- a/secretmanager/v1/secretmanager-gen.go +++ b/secretmanager/v1/secretmanager-gen.go @@ -421,7 +421,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -822,7 +823,9 @@ func (s *Location) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -841,7 +844,7 @@ func (s *Location) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -881,7 +884,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1239,7 +1243,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2304,7 +2309,8 @@ func (r *ProjectsSecretsService) GetIamPolicy(resource string) *ProjectsSecretsG // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsSecretsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsSecretsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/secretmanager/v1beta1/secretmanager-gen.go b/secretmanager/v1beta1/secretmanager-gen.go index 23f1f6d55c1..a711032d6bc 100644 --- a/secretmanager/v1beta1/secretmanager-gen.go +++ b/secretmanager/v1beta1/secretmanager-gen.go @@ -356,7 +356,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -690,7 +691,9 @@ func (s *Location) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -709,7 +712,7 @@ func (s *Location) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -749,7 +752,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1022,7 +1026,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2056,7 +2061,8 @@ func (r *ProjectsSecretsService) GetIamPolicy(resource string) *ProjectsSecretsG // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsSecretsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsSecretsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index 0a78c8e6207..caf573e159f 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -513,7 +513,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -861,7 +862,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2191,7 +2193,9 @@ func (s *OrganizationSettings) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2210,7 +2214,7 @@ func (s *OrganizationSettings) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2250,7 +2254,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2579,10 +2584,11 @@ func (s *Source) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2665,7 +2671,8 @@ func (s *StreamingConfig) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index 86ae720cc5d..8410c76c78e 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -395,7 +395,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -744,7 +745,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1973,7 +1975,9 @@ func (s *OrganizationSettings) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1992,7 +1996,7 @@ func (s *OrganizationSettings) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2032,7 +2036,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2292,10 +2297,11 @@ func (s *Source) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2338,7 +2344,8 @@ func (s *Status) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go index 76cdbe5416c..6b6222b61ca 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go @@ -242,15 +242,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses semantic versioning where the major - // version number indicates a breaking change and the minor version an - // additive, non-breaking change. Both version numbers are signals to - // users what to expect from different versions, and should be carefully - // chosen based on the product plan. The major version is also reflected - // in the package name of the interface, which must end in `v`, as in - // `google.feature.v1`. For major versions 0 and 1, the suffix can be - // omitted. Zero major versions must only be used for experimental, - // non-GA interfaces. + // The versioning schema uses semantic versioning (http://semver.org) + // where the major version number indicates a breaking change and the + // minor version an additive, non-breaking change. Both version numbers + // are signals to users what to expect from different versions, and + // should be carefully chosen based on the product plan. The major + // version is also reflected in the package name of the interface, which + // must end in `v`, as in `google.feature.v1`. For major versions 0 and + // 1, the suffix can be omitted. Zero major versions must only be used + // for experimental, non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -352,12 +352,14 @@ func (s *AttachTenantProjectRequest) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { - // Audiences: The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, JWTs with audiences: - - // "https://[service.name]/[google.protobuf.Api.name]" - + // Audiences: The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, JWTs with + // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - @@ -380,10 +382,14 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See OpenID Discovery. Optional if the key set document: - - // can be retrieved from OpenID Discovery of the issuer. - can be - // inferred from the email domain of the issuer (e.g. a Google service - // account). Example: https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe + // tadata). Optional if the key set document: - can be retrieved from + // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the + // issuer. - can be inferred from the email domain of the issuer (e.g. a + // Google service account). Example: + // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -421,16 +427,18 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, only JWTs with audience - // "https://Service_name/API_name" will be accepted. For example, if no - // audiences are in the setting, LibraryService API will only accept - // JWTs with the following audience + // components. The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, only JWTs + // with audience "https://Service_name/API_name" will be accepted. For + // example, if no audiences are in the setting, LibraryService API will + // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1272,20 +1280,22 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the - // backends served from this endpoint to receive and respond to HTTP - // OPTIONS requests. The response will be used by the browser to - // determine whether the subsequent cross-origin request is allowed to - // proceed. + // AllowCors: Allowing CORS + // (https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka + // cross-domain traffic, would allow the backends served from this + // endpoint to receive and respond to HTTP OPTIONS requests. The + // response will be used by the browser to determine whether the + // subsequent cross-origin request is allowed to proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this API Endpoint. It should be - // either a valid IPv4 address or a fully-qualified domain name. For - // example, "8.8.8.8" or "myservice.appspot.com". + // frontend that will handle requests to this API Endpoint + // (https://cloud.google.com/apis/design/glossary). It should be either + // a valid IPv4 address or a fully-qualified domain name. For example, + // "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` // ForceSendFields is a list of field names (e.g. "Aliases") to @@ -1521,10 +1531,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud -// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use -// it for large scale production services. `HttpRule` defines the schema -// of the gRPC/REST mapping. The mapping specifies how different +// gRPC APIs and REST APIs. Many systems, including Google APIs +// (https://github.com/googleapis/googleapis), Cloud Endpoints +// (https://cloud.google.com/endpoints), gRPC Gateway +// (https://github.com/grpc-ecosystem/grpc-gateway), and Envoy +// (https://github.com/envoyproxy/envoy) proxy support this feature and +// use it for large scale production services. `HttpRule` defines the +// schema of the gRPC/REST mapping. The mapping specifies how different // portions of the gRPC request message are mapped to the URL path, URL // query parameters, and HTTP request body. It also controls how the // gRPC response message is mapped to the HTTP response body. `HttpRule` @@ -1623,12 +1636,15 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// Discovery Document as `{var}`. If a variable contains multiple path -// segments, such as "{var=foo/*}" or "{var=**}", when such a -// variable is expanded into a URL path on the client side, all -// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server -// side does the reverse decoding, except "%2F" and "%2f" are left -// unchanged. Such variables show up in the Discovery Document as +// Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as +// `{var}`. If a variable contains multiple path segments, such as +// "{var=foo/*}" or "{var=**}", when such a variable is expanded +// into a URL path on the client side, all characters except +// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the +// reverse decoding, except "%2F" and "%2f" are left unchanged. Such +// variables show up in the Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as // `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The @@ -1645,24 +1661,26 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the proto3 specification. While the -// single segment variable follows the semantics of RFC 6570 Section -// 3.2.2 Simple String Expansion, the multi segment variable **does -// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is -// that the Reserved Expansion does not expand special characters like -// `?` and `#`, which would lead to invalid URLs. As the result, gRPC -// Transcoding uses a custom encoding for multi segment variables. The -// path variables **must not** refer to any repeated or mapped field, -// because client libraries are not capable of handling such variable -// expansion. The path variables **must not** capture the leading "/" -// character. The reason is that the most common use case "{var}" does -// not capture the leading "/" character. For consistency, all path -// variables must share the same behavior. Repeated message fields must -// not be mapped to URL query parameters, because no client library can -// support such complicated mapping. If an API needs to use a JSON array -// for request or response body, it can map the request or response body -// to a repeated field. However, some gRPC Transcoding implementations -// may not support this feature. +// to JSON conversion must follow the proto3 specification +// (https://developers.google.com/protocol-buffers/docs/proto3#json). +// While the single segment variable follows the semantics of RFC 6570 +// (https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String +// Expansion, the multi segment variable **does not** follow RFC 6570 +// Section 3.2.3 Reserved Expansion. The reason is that the Reserved +// Expansion does not expand special characters like `?` and `#`, which +// would lead to invalid URLs. As the result, gRPC Transcoding uses a +// custom encoding for multi segment variables. The path variables +// **must not** refer to any repeated or mapped field, because client +// libraries are not capable of handling such variable expansion. The +// path variables **must not** capture the leading "/" character. The +// reason is that the most common use case "{var}" does not capture the +// leading "/" character. For consistency, all path variables must share +// the same behavior. Repeated message fields must not be mapped to URL +// query parameters, because no client library can support such +// complicated mapping. If an API needs to use a JSON array for request +// or response body, it can map the request or response body to a +// repeated field. However, some gRPC Transcoding implementations may +// not support this feature. type HttpRule struct { // AdditionalBindings: Additional HTTP bindings for the selector. Nested // bindings must not contain an `additional_bindings` field themselves @@ -2183,37 +2201,39 @@ type MetricDescriptor struct { // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is // `12005/1024`). The supported units are a subset of The Unified Code - // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * - // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` - // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega - // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` - // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli - // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * - // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` - // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi - // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar - // also includes these connectors: * `/` division or ratio (as an infix - // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you - // should almost never have `/s` in a metric `unit`; rates should always - // be computed at query time from the underlying cumulative or delta - // value). * `.` multiplication or composition (as an infix operator). - // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as - // follows: Expression = Component { "." Component } { "/" Component } ; - // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | - // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a - // comment if it follows a `UNIT`. If the annotation is used alone, then - // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, + // for Units of Measure (http://unitsofmeasure.org/ucum.html) standard: + // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` + // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** + // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera + // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * + // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano + // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) + // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` + // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) + // **Grammar** The grammar also includes these connectors: * `/` + // division or ratio (as an infix operator). For examples, `kBy/{email}` + // or `MiBy/10ms` (although you should almost never have `/s` in a + // metric `unit`; rates should always be computed at query time from the + // underlying cumulative or delta value). * `.` multiplication or + // composition (as an infix operator). For examples, `GBy.d` or + // `k{watt}.h`. The grammar for a unit is as follows: Expression = + // Component { "." Component } { "/" Component } ; Component = ( [ + // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation + // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it + // follows a `UNIT`. If the annotation is used alone, then the unit is + // equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary dimensionless unit of 1, such as in `1/s`. It is - // typically used when none of the basic units are appropriate. For - // example, "new users per day" can be represented as `1/d` or - // `{new-users}/d` (and a metric value `5` would mean "5 new users). - // Alternatively, "thousands of page views per day" would be represented - // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of - // `5.3` would mean "5300 page views per day"). * `%` represents - // dimensionless value of 1/100, and annotates values giving a - // percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit + // (https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such as + // in `1/s`. It is typically used when none of the basic units are + // appropriate. For example, "new users per day" can be represented as + // `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new + // users). Alternatively, "thousands of page views per day" would be + // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric + // value of `5.3` would mean "5300 page views per day"). * `%` + // represents dimensionless value of 1/100, and annotates values giving + // a percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -3325,10 +3345,11 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3754,11 +3775,11 @@ func (s *UndeleteTenantProjectRequest) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports Google Cloud Pub/Sub as a - // notification channel. To use Google Cloud Pub/Sub as the channel, - // this must be the name of a Cloud Pub/Sub topic that uses the Cloud - // Pub/Sub topic name format documented in - // https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub + // (https://cloud.google.com/pubsub) as a notification channel. To use + // Google Cloud Pub/Sub as the channel, this must be the name of a Cloud + // Pub/Sub topic that uses the Cloud Pub/Sub topic name format + // documented in https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index 8cd84f9b082..43825bb41e9 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -232,15 +232,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses semantic versioning where the major - // version number indicates a breaking change and the minor version an - // additive, non-breaking change. Both version numbers are signals to - // users what to expect from different versions, and should be carefully - // chosen based on the product plan. The major version is also reflected - // in the package name of the interface, which must end in `v`, as in - // `google.feature.v1`. For major versions 0 and 1, the suffix can be - // omitted. Zero major versions must only be used for experimental, - // non-GA interfaces. + // The versioning schema uses semantic versioning (http://semver.org) + // where the major version number indicates a breaking change and the + // minor version an additive, non-breaking change. Both version numbers + // are signals to users what to expect from different versions, and + // should be carefully chosen based on the product plan. The major + // version is also reflected in the package name of the interface, which + // must end in `v`, as in `google.feature.v1`. For major versions 0 and + // 1, the suffix can be omitted. Zero major versions must only be used + // for experimental, non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -267,12 +267,14 @@ func (s *Api) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { - // Audiences: The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, JWTs with audiences: - - // "https://[service.name]/[google.protobuf.Api.name]" - + // Audiences: The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, JWTs with + // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - @@ -295,10 +297,14 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See OpenID Discovery. Optional if the key set document: - - // can be retrieved from OpenID Discovery of the issuer. - can be - // inferred from the email domain of the issuer (e.g. a Google service - // account). Example: https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe + // tadata). Optional if the key set document: - can be retrieved from + // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the + // issuer. - can be inferred from the email domain of the issuer (e.g. a + // Google service account). Example: + // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -336,16 +342,18 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, only JWTs with audience - // "https://Service_name/API_name" will be accepted. For example, if no - // audiences are in the setting, LibraryService API will only accept - // JWTs with the following audience + // components. The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, only JWTs + // with audience "https://Service_name/API_name" will be accepted. For + // example, if no audiences are in the setting, LibraryService API will + // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1083,20 +1091,22 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the - // backends served from this endpoint to receive and respond to HTTP - // OPTIONS requests. The response will be used by the browser to - // determine whether the subsequent cross-origin request is allowed to - // proceed. + // AllowCors: Allowing CORS + // (https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka + // cross-domain traffic, would allow the backends served from this + // endpoint to receive and respond to HTTP OPTIONS requests. The + // response will be used by the browser to determine whether the + // subsequent cross-origin request is allowed to proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this API Endpoint. It should be - // either a valid IPv4 address or a fully-qualified domain name. For - // example, "8.8.8.8" or "myservice.appspot.com". + // frontend that will handle requests to this API Endpoint + // (https://cloud.google.com/apis/design/glossary). It should be either + // a valid IPv4 address or a fully-qualified domain name. For example, + // "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` // ForceSendFields is a list of field names (e.g. "Aliases") to @@ -1332,10 +1342,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud -// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use -// it for large scale production services. `HttpRule` defines the schema -// of the gRPC/REST mapping. The mapping specifies how different +// gRPC APIs and REST APIs. Many systems, including Google APIs +// (https://github.com/googleapis/googleapis), Cloud Endpoints +// (https://cloud.google.com/endpoints), gRPC Gateway +// (https://github.com/grpc-ecosystem/grpc-gateway), and Envoy +// (https://github.com/envoyproxy/envoy) proxy support this feature and +// use it for large scale production services. `HttpRule` defines the +// schema of the gRPC/REST mapping. The mapping specifies how different // portions of the gRPC request message are mapped to the URL path, URL // query parameters, and HTTP request body. It also controls how the // gRPC response message is mapped to the HTTP response body. `HttpRule` @@ -1434,12 +1447,15 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// Discovery Document as `{var}`. If a variable contains multiple path -// segments, such as "{var=foo/*}" or "{var=**}", when such a -// variable is expanded into a URL path on the client side, all -// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server -// side does the reverse decoding, except "%2F" and "%2f" are left -// unchanged. Such variables show up in the Discovery Document as +// Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as +// `{var}`. If a variable contains multiple path segments, such as +// "{var=foo/*}" or "{var=**}", when such a variable is expanded +// into a URL path on the client side, all characters except +// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the +// reverse decoding, except "%2F" and "%2f" are left unchanged. Such +// variables show up in the Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as // `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The @@ -1456,24 +1472,26 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the proto3 specification. While the -// single segment variable follows the semantics of RFC 6570 Section -// 3.2.2 Simple String Expansion, the multi segment variable **does -// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is -// that the Reserved Expansion does not expand special characters like -// `?` and `#`, which would lead to invalid URLs. As the result, gRPC -// Transcoding uses a custom encoding for multi segment variables. The -// path variables **must not** refer to any repeated or mapped field, -// because client libraries are not capable of handling such variable -// expansion. The path variables **must not** capture the leading "/" -// character. The reason is that the most common use case "{var}" does -// not capture the leading "/" character. For consistency, all path -// variables must share the same behavior. Repeated message fields must -// not be mapped to URL query parameters, because no client library can -// support such complicated mapping. If an API needs to use a JSON array -// for request or response body, it can map the request or response body -// to a repeated field. However, some gRPC Transcoding implementations -// may not support this feature. +// to JSON conversion must follow the proto3 specification +// (https://developers.google.com/protocol-buffers/docs/proto3#json). +// While the single segment variable follows the semantics of RFC 6570 +// (https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String +// Expansion, the multi segment variable **does not** follow RFC 6570 +// Section 3.2.3 Reserved Expansion. The reason is that the Reserved +// Expansion does not expand special characters like `?` and `#`, which +// would lead to invalid URLs. As the result, gRPC Transcoding uses a +// custom encoding for multi segment variables. The path variables +// **must not** refer to any repeated or mapped field, because client +// libraries are not capable of handling such variable expansion. The +// path variables **must not** capture the leading "/" character. The +// reason is that the most common use case "{var}" does not capture the +// leading "/" character. For consistency, all path variables must share +// the same behavior. Repeated message fields must not be mapped to URL +// query parameters, because no client library can support such +// complicated mapping. If an API needs to use a JSON array for request +// or response body, it can map the request or response body to a +// repeated field. However, some gRPC Transcoding implementations may +// not support this feature. type HttpRule struct { // AdditionalBindings: Additional HTTP bindings for the selector. Nested // bindings must not contain an `additional_bindings` field themselves @@ -1922,37 +1940,39 @@ type MetricDescriptor struct { // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is // `12005/1024`). The supported units are a subset of The Unified Code - // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * - // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` - // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega - // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` - // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli - // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * - // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` - // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi - // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar - // also includes these connectors: * `/` division or ratio (as an infix - // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you - // should almost never have `/s` in a metric `unit`; rates should always - // be computed at query time from the underlying cumulative or delta - // value). * `.` multiplication or composition (as an infix operator). - // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as - // follows: Expression = Component { "." Component } { "/" Component } ; - // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | - // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a - // comment if it follows a `UNIT`. If the annotation is used alone, then - // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, + // for Units of Measure (http://unitsofmeasure.org/ucum.html) standard: + // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` + // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** + // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera + // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * + // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano + // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) + // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` + // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) + // **Grammar** The grammar also includes these connectors: * `/` + // division or ratio (as an infix operator). For examples, `kBy/{email}` + // or `MiBy/10ms` (although you should almost never have `/s` in a + // metric `unit`; rates should always be computed at query time from the + // underlying cumulative or delta value). * `.` multiplication or + // composition (as an infix operator). For examples, `GBy.d` or + // `k{watt}.h`. The grammar for a unit is as follows: Expression = + // Component { "." Component } { "/" Component } ; Component = ( [ + // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation + // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it + // follows a `UNIT`. If the annotation is used alone, then the unit is + // equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary dimensionless unit of 1, such as in `1/s`. It is - // typically used when none of the basic units are appropriate. For - // example, "new users per day" can be represented as `1/d` or - // `{new-users}/d` (and a metric value `5` would mean "5 new users). - // Alternatively, "thousands of page views per day" would be represented - // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of - // `5.3` would mean "5300 page views per day"). * `%` represents - // dimensionless value of 1/100, and annotates values giving a - // percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit + // (https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such as + // in `1/s`. It is typically used when none of the basic units are + // appropriate. For example, "new users per day" can be represented as + // `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new + // users). Alternatively, "thousands of page views per day" would be + // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric + // value of `5.3` would mean "5300 page views per day"). * `%` + // represents dimensionless value of 1/100, and annotates values giving + // a percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -2927,10 +2947,11 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3140,11 +3161,11 @@ func (s *Type) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports Google Cloud Pub/Sub as a - // notification channel. To use Google Cloud Pub/Sub as the channel, - // this must be the name of a Cloud Pub/Sub topic that uses the Cloud - // Pub/Sub topic name format documented in - // https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub + // (https://cloud.google.com/pubsub) as a notification channel. To use + // Google Cloud Pub/Sub as the channel, this must be the name of a Cloud + // Pub/Sub topic that uses the Cloud Pub/Sub topic name format + // documented in https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer diff --git a/servicecontrol/v1/servicecontrol-gen.go b/servicecontrol/v1/servicecontrol-gen.go index dd013e38b0d..4456e932a25 100644 --- a/servicecontrol/v1/servicecontrol-gen.go +++ b/servicecontrol/v1/servicecontrol-gen.go @@ -531,7 +531,8 @@ type AuthenticationInfo struct { // request. For third party identity callers, the `principal_subject` // field is populated instead of this field. For privacy reasons, the // principal email address is sometimes redacted. For more information, - // see Caller identities in audit logs. + // see Caller identities in audit logs + // (https://cloud.google.com/logging/docs/audit#user-id). PrincipalEmail string `json:"principalEmail,omitempty"` // PrincipalSubject: String representation of identity of requesting @@ -886,7 +887,7 @@ type ConsumerInfo struct { ProjectNumber int64 `json:"projectNumber,omitempty,string"` // Type: The type of the consumer which should have been defined in - // Google Resource Manager. + // Google Resource Manager (https://cloud.google.com/resource-manager/). // // Possible values: // "CONSUMER_TYPE_UNSPECIFIED" - This is never used. @@ -970,9 +971,9 @@ type Distribution struct { Minimum float64 `json:"minimum,omitempty"` // SumOfSquaredDeviation: The sum of squared deviations from the mean: - // Sumi=1..count^2) where each x_i is a sample values. If `count` is - // zero then this field must be zero, otherwise validation of the - // request fails. + // Sumi=1..count ((x_i - mean)^2) where each x_i is a sample values. If + // `count` is zero then this field must be zero, otherwise validation of + // the request fails. SumOfSquaredDeviation float64 `json:"sumOfSquaredDeviation,omitempty"` // ForceSendFields is a list of field names (e.g. "BucketCounts") to @@ -1236,7 +1237,8 @@ type HttpRequest struct { Protocol string `json:"protocol,omitempty"` // Referer: The referer URL of the request, as defined in HTTP/1.1 - // Header Field Definitions. + // Header Field Definitions + // (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Referer string `json:"referer,omitempty"` // RemoteIp: The IP address (IPv4 or IPv6) of the client that issued the @@ -2672,10 +2674,11 @@ func (s *SpanContext) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2903,8 +2906,9 @@ type ServicesAllocateQuotaCall struct { // AllocateQuota: Attempts to allocate quota for the specified consumer. // It should be called before the operation is executed. This method // requires the `servicemanagement.services.quota` permission on the -// specified service. For more information, see Cloud IAM. **NOTE:** The -// client **must** fail-open on server errors `INTERNAL`, `UNKNOWN`, +// specified service. For more information, see Cloud IAM +// (https://cloud.google.com/iam). **NOTE:** The client **must** +// fail-open on server errors `INTERNAL`, `UNKNOWN`, // `DEADLINE_EXCEEDED`, and `UNAVAILABLE`. To ensure system reliability, // the server may inject these errors to prohibit any hard dependency on // the quota functionality. @@ -3058,7 +3062,8 @@ type ServicesCheckCall struct { // having the latest policy information. NOTE: the CheckRequest has the // size limit of 64KB. This method requires the // `servicemanagement.services.check` permission on the specified -// service. For more information, see Cloud IAM. +// service. For more information, see Cloud IAM +// (https://cloud.google.com/iam). func (r *ServicesService) Check(serviceName string, checkrequest *CheckRequest) *ServicesCheckCall { c := &ServicesCheckCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -3207,7 +3212,8 @@ type ServicesReportCall struct { // more than 0.01% for business and compliance reasons. NOTE: the // ReportRequest has the size limit (wire-format byte size) of 1MB. This // method requires the `servicemanagement.services.report` permission on -// the specified service. For more information, see Google Cloud IAM. +// the specified service. For more information, see Google Cloud IAM +// (https://cloud.google.com/iam). func (r *ServicesService) Report(serviceName string, reportrequest *ReportRequest) *ServicesReportCall { c := &ServicesReportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName diff --git a/servicecontrol/v2/servicecontrol-gen.go b/servicecontrol/v2/servicecontrol-gen.go index b71a7c8af95..64355f6ffe1 100644 --- a/servicecontrol/v2/servicecontrol-gen.go +++ b/servicecontrol/v2/servicecontrol-gen.go @@ -456,7 +456,8 @@ type AuthenticationInfo struct { // request. For third party identity callers, the `principal_subject` // field is populated instead of this field. For privacy reasons, the // principal email address is sometimes redacted. For more information, - // see Caller identities in audit logs. + // see Caller identities in audit logs + // (https://cloud.google.com/logging/docs/audit#user-id). PrincipalEmail string `json:"principalEmail,omitempty"` // PrincipalSubject: String representation of identity of requesting @@ -598,7 +599,7 @@ type CheckResponse struct { Headers map[string]string `json:"headers,omitempty"` // Status: An 'OK' status allows the operation. Any other status - // indicates a denial; google.rpc.Status.details would contain + // indicates a denial; google.rpc.Status.details () would contain // additional details about the denial. Status *Status `json:"status,omitempty"` @@ -1184,10 +1185,11 @@ func (s *SpanContext) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1267,18 +1269,20 @@ type ServicesCheckCall struct { // Check: Private Preview. This feature is only available for approved // services. This method provides admission control for services that -// are integrated with Service Infrastructure. It checks whether an -// operation should be allowed based on the service configuration and -// relevant policies. It must be called before the operation is -// executed. For more information, see Admission Control. NOTE: The -// admission control has an expected policy propagation delay of 60s. -// The caller **must** not depend on the most recent policy changes. -// NOTE: The admission control has a hard limit of 1 referenced -// resources per call. If an operation refers to more than 1 resources, -// the caller must call the Check method multiple times. This method -// requires the `servicemanagement.services.check` permission on the -// specified service. For more information, see Service Control API -// Access Control. +// are integrated with Service Infrastructure (/service-infrastructure). +// It checks whether an operation should be allowed based on the service +// configuration and relevant policies. It must be called before the +// operation is executed. For more information, see Admission Control +// (/service-infrastructure/docs/admission-control). NOTE: The admission +// control has an expected policy propagation delay of 60s. The caller +// **must** not depend on the most recent policy changes. NOTE: The +// admission control has a hard limit of 1 referenced resources per +// call. If an operation refers to more than 1 resources, the caller +// must call the Check method multiple times. This method requires the +// `servicemanagement.services.check` permission on the specified +// service. For more information, see Service Control API Access Control +// (https://cloud.google.com/service-infrastructure/docs/service-control/ +// access-control). func (r *ServicesService) Check(serviceName string, checkrequest *CheckRequest) *ServicesCheckCall { c := &ServicesCheckCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -1420,15 +1424,18 @@ type ServicesReportCall struct { // Report: Private Preview. This feature is only available for approved // services. This method provides telemetry reporting for services that -// are integrated with Service Infrastructure. It reports a list of -// operations that have occurred on a service. It must be called after -// the operations have been executed. For more information, see -// Telemetry Reporting. NOTE: The telemetry reporting has a hard limit -// of 1000 operations and 1MB per Report call. It is recommended to have -// no more than 100 operations per call. This method requires the +// are integrated with Service Infrastructure (/service-infrastructure). +// It reports a list of operations that have occurred on a service. It +// must be called after the operations have been executed. For more +// information, see Telemetry Reporting +// (/service-infrastructure/docs/telemetry-reporting). NOTE: The +// telemetry reporting has a hard limit of 1000 operations and 1MB per +// Report call. It is recommended to have no more than 100 operations +// per call. This method requires the // `servicemanagement.services.report` permission on the specified -// service. For more information, see Service Control API Access -// Control. +// service. For more information, see Service Control API Access Control +// (https://cloud.google.com/service-infrastructure/docs/service-control/ +// access-control). func (r *ServicesService) Report(serviceName string, reportrequest *ReportRequest) *ServicesReportCall { c := &ServicesReportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName diff --git a/servicedirectory/v1/servicedirectory-gen.go b/servicedirectory/v1/servicedirectory-gen.go index 1f74f4d6b88..03731f50ca6 100644 --- a/servicedirectory/v1/servicedirectory-gen.go +++ b/servicedirectory/v1/servicedirectory-gen.go @@ -200,7 +200,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -437,7 +438,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -715,7 +717,9 @@ func (s *Namespace) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -734,7 +738,7 @@ func (s *Namespace) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -770,7 +774,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -976,7 +981,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/servicedirectory/v1beta1/servicedirectory-gen.go b/servicedirectory/v1beta1/servicedirectory-gen.go index fc71d02b251..f8a3774157d 100644 --- a/servicedirectory/v1beta1/servicedirectory-gen.go +++ b/servicedirectory/v1beta1/servicedirectory-gen.go @@ -200,7 +200,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -434,7 +435,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -712,7 +714,9 @@ func (s *Namespace) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -731,7 +735,7 @@ func (s *Namespace) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -767,7 +771,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -970,7 +975,8 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to diff --git a/servicemanagement/v1/servicemanagement-gen.go b/servicemanagement/v1/servicemanagement-gen.go index 8ecf0abb356..5d06bcf286d 100644 --- a/servicemanagement/v1/servicemanagement-gen.go +++ b/servicemanagement/v1/servicemanagement-gen.go @@ -278,15 +278,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses semantic versioning where the major - // version number indicates a breaking change and the minor version an - // additive, non-breaking change. Both version numbers are signals to - // users what to expect from different versions, and should be carefully - // chosen based on the product plan. The major version is also reflected - // in the package name of the interface, which must end in `v`, as in - // `google.feature.v1`. For major versions 0 and 1, the suffix can be - // omitted. Zero major versions must only be used for experimental, - // non-GA interfaces. + // The versioning schema uses semantic versioning (http://semver.org) + // where the major version number indicates a breaking change and the + // minor version an additive, non-breaking change. Both version numbers + // are signals to users what to expect from different versions, and + // should be carefully chosen based on the product plan. The major + // version is also reflected in the package name of the interface, which + // must end in `v`, as in `google.feature.v1`. For major versions 0 and + // 1, the suffix can be omitted. Zero major versions must only be used + // for experimental, non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -410,12 +410,14 @@ func (s *AuditLogConfig) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { - // Audiences: The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, JWTs with audiences: - - // "https://[service.name]/[google.protobuf.Api.name]" - + // Audiences: The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, JWTs with + // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - @@ -438,10 +440,14 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See OpenID Discovery. Optional if the key set document: - - // can be retrieved from OpenID Discovery of the issuer. - can be - // inferred from the email domain of the issuer (e.g. a Google service - // account). Example: https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe + // tadata). Optional if the key set document: - can be retrieved from + // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the + // issuer. - can be inferred from the email domain of the issuer (e.g. a + // Google service account). Example: + // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -479,16 +485,18 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, only JWTs with audience - // "https://Service_name/API_name" will be accepted. For example, if no - // audiences are in the setting, LibraryService API will only accept - // JWTs with the following audience + // components. The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, only JWTs + // with audience "https://Service_name/API_name" will be accepted. For + // example, if no audiences are in the setting, LibraryService API will + // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -851,7 +859,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1589,20 +1598,22 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the - // backends served from this endpoint to receive and respond to HTTP - // OPTIONS requests. The response will be used by the browser to - // determine whether the subsequent cross-origin request is allowed to - // proceed. + // AllowCors: Allowing CORS + // (https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka + // cross-domain traffic, would allow the backends served from this + // endpoint to receive and respond to HTTP OPTIONS requests. The + // response will be used by the browser to determine whether the + // subsequent cross-origin request is allowed to proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this API Endpoint. It should be - // either a valid IPv4 address or a fully-qualified domain name. For - // example, "8.8.8.8" or "myservice.appspot.com". + // frontend that will handle requests to this API Endpoint + // (https://cloud.google.com/apis/design/glossary). It should be either + // a valid IPv4 address or a fully-qualified domain name. For example, + // "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` // ForceSendFields is a list of field names (e.g. "Aliases") to @@ -2006,7 +2017,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2078,10 +2090,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud -// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use -// it for large scale production services. `HttpRule` defines the schema -// of the gRPC/REST mapping. The mapping specifies how different +// gRPC APIs and REST APIs. Many systems, including Google APIs +// (https://github.com/googleapis/googleapis), Cloud Endpoints +// (https://cloud.google.com/endpoints), gRPC Gateway +// (https://github.com/grpc-ecosystem/grpc-gateway), and Envoy +// (https://github.com/envoyproxy/envoy) proxy support this feature and +// use it for large scale production services. `HttpRule` defines the +// schema of the gRPC/REST mapping. The mapping specifies how different // portions of the gRPC request message are mapped to the URL path, URL // query parameters, and HTTP request body. It also controls how the // gRPC response message is mapped to the HTTP response body. `HttpRule` @@ -2180,12 +2195,15 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// Discovery Document as `{var}`. If a variable contains multiple path -// segments, such as "{var=foo/*}" or "{var=**}", when such a -// variable is expanded into a URL path on the client side, all -// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server -// side does the reverse decoding, except "%2F" and "%2f" are left -// unchanged. Such variables show up in the Discovery Document as +// Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as +// `{var}`. If a variable contains multiple path segments, such as +// "{var=foo/*}" or "{var=**}", when such a variable is expanded +// into a URL path on the client side, all characters except +// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the +// reverse decoding, except "%2F" and "%2f" are left unchanged. Such +// variables show up in the Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as // `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The @@ -2202,24 +2220,26 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the proto3 specification. While the -// single segment variable follows the semantics of RFC 6570 Section -// 3.2.2 Simple String Expansion, the multi segment variable **does -// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is -// that the Reserved Expansion does not expand special characters like -// `?` and `#`, which would lead to invalid URLs. As the result, gRPC -// Transcoding uses a custom encoding for multi segment variables. The -// path variables **must not** refer to any repeated or mapped field, -// because client libraries are not capable of handling such variable -// expansion. The path variables **must not** capture the leading "/" -// character. The reason is that the most common use case "{var}" does -// not capture the leading "/" character. For consistency, all path -// variables must share the same behavior. Repeated message fields must -// not be mapped to URL query parameters, because no client library can -// support such complicated mapping. If an API needs to use a JSON array -// for request or response body, it can map the request or response body -// to a repeated field. However, some gRPC Transcoding implementations -// may not support this feature. +// to JSON conversion must follow the proto3 specification +// (https://developers.google.com/protocol-buffers/docs/proto3#json). +// While the single segment variable follows the semantics of RFC 6570 +// (https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String +// Expansion, the multi segment variable **does not** follow RFC 6570 +// Section 3.2.3 Reserved Expansion. The reason is that the Reserved +// Expansion does not expand special characters like `?` and `#`, which +// would lead to invalid URLs. As the result, gRPC Transcoding uses a +// custom encoding for multi segment variables. The path variables +// **must not** refer to any repeated or mapped field, because client +// libraries are not capable of handling such variable expansion. The +// path variables **must not** capture the leading "/" character. The +// reason is that the most common use case "{var}" does not capture the +// leading "/" character. For consistency, all path variables must share +// the same behavior. Repeated message fields must not be mapped to URL +// query parameters, because no client library can support such +// complicated mapping. If an API needs to use a JSON array for request +// or response body, it can map the request or response body to a +// repeated field. However, some gRPC Transcoding implementations may +// not support this feature. type HttpRule struct { // AdditionalBindings: Additional HTTP bindings for the selector. Nested // bindings must not contain an `additional_bindings` field themselves @@ -2656,8 +2676,8 @@ type ManagedService struct { // service. ProducerProjectId string `json:"producerProjectId,omitempty"` - // ServiceName: The name of the service. See the overview for naming - // requirements. + // ServiceName: The name of the service. See the overview + // (/service-management/overview) for naming requirements. ServiceName string `json:"serviceName,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2852,37 +2872,39 @@ type MetricDescriptor struct { // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is // `12005/1024`). The supported units are a subset of The Unified Code - // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * - // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` - // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega - // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` - // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli - // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * - // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` - // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi - // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar - // also includes these connectors: * `/` division or ratio (as an infix - // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you - // should almost never have `/s` in a metric `unit`; rates should always - // be computed at query time from the underlying cumulative or delta - // value). * `.` multiplication or composition (as an infix operator). - // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as - // follows: Expression = Component { "." Component } { "/" Component } ; - // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | - // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a - // comment if it follows a `UNIT`. If the annotation is used alone, then - // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, + // for Units of Measure (http://unitsofmeasure.org/ucum.html) standard: + // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` + // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** + // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera + // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * + // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano + // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) + // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` + // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) + // **Grammar** The grammar also includes these connectors: * `/` + // division or ratio (as an infix operator). For examples, `kBy/{email}` + // or `MiBy/10ms` (although you should almost never have `/s` in a + // metric `unit`; rates should always be computed at query time from the + // underlying cumulative or delta value). * `.` multiplication or + // composition (as an infix operator). For examples, `GBy.d` or + // `k{watt}.h`. The grammar for a unit is as follows: Expression = + // Component { "." Component } { "/" Component } ; Component = ( [ + // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation + // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it + // follows a `UNIT`. If the annotation is used alone, then the unit is + // equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary dimensionless unit of 1, such as in `1/s`. It is - // typically used when none of the basic units are appropriate. For - // example, "new users per day" can be represented as `1/d` or - // `{new-users}/d` (and a metric value `5` would mean "5 new users). - // Alternatively, "thousands of page views per day" would be represented - // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of - // `5.3` would mean "5300 page views per day"). * `%` represents - // dimensionless value of 1/100, and annotates values giving a - // percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit + // (https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such as + // in `1/s`. It is typically used when none of the basic units are + // appropriate. For example, "new users per day" can be represented as + // `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new + // users). Alternatively, "thousands of page views per day" would be + // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric + // value of `5.3` would mean "5300 page views per day"). * `%` + // represents dimensionless value of 1/100, and annotates values giving + // a percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -3555,7 +3577,9 @@ func (s *Page) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -3574,7 +3598,7 @@ func (s *Page) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -3614,7 +3638,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4164,10 +4189,11 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4435,7 +4461,8 @@ func (s *SystemParameters) MarshalJSON() ([]byte, error) { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -4616,11 +4643,11 @@ func (s *UndeleteServiceResponse) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports Google Cloud Pub/Sub as a - // notification channel. To use Google Cloud Pub/Sub as the channel, - // this must be the name of a Cloud Pub/Sub topic that uses the Cloud - // Pub/Sub topic name format documented in - // https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub + // (https://cloud.google.com/pubsub) as a notification channel. To use + // Google Cloud Pub/Sub as the channel, this must be the name of a Cloud + // Pub/Sub topic that uses the Cloud Pub/Sub topic name format + // documented in https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer @@ -5350,7 +5377,9 @@ type ServicesEnableCall struct { } // Enable: Enables a service for a project, so it can be used for the -// project. See Cloud Auth Guide for more information. Operation +// project. See Cloud Auth Guide +// (https://cloud.google.com/docs/authentication) for more information. +// Operation func (r *ServicesService) Enable(serviceName string, enableservicerequest *EnableServiceRequest) *ServicesEnableCall { c := &ServicesEnableCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -8158,10 +8187,11 @@ func (r *ServicesRolloutsService) List(serviceName string) *ServicesRolloutsList // Filter sets the optional parameter "filter": Required. Use `filter` // to return subset of rollouts. The following filters are supported: -- -// To limit the results to only those in status 'SUCCESS', use +// To limit the results to only those in status +// (google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS', use // filter='status=SUCCESS' -- To limit the results to those in status -// 'CANCELLED' or 'FAILED', use filter='status=CANCELLED OR -// status=FAILED' +// (google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED' or +// 'FAILED', use filter='status=CANCELLED OR status=FAILED' func (c *ServicesRolloutsListCall) Filter(filter string) *ServicesRolloutsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/servicenetworking/v1/servicenetworking-gen.go b/servicenetworking/v1/servicenetworking-gen.go index 971125e7186..ab916e6f467 100644 --- a/servicenetworking/v1/servicenetworking-gen.go +++ b/servicenetworking/v1/servicenetworking-gen.go @@ -491,8 +491,8 @@ type AddSubnetworkRequest struct { // range. IpPrefixLength int64 `json:"ipPrefixLength,omitempty"` - // Region: Required. The name of a region for the subnet, such - // `europe-west1`. + // Region: Required. The name of a region (/compute/docs/regions-zones) + // for the subnet, such `europe-west1`. Region string `json:"region,omitempty"` // RequestedAddress: Optional. The starting address of a range. The @@ -516,7 +516,8 @@ type AddSubnetworkRequest struct { SecondaryIpRangeSpecs []*SecondaryIpRangeSpec `json:"secondaryIpRangeSpecs,omitempty"` // Subnetwork: Required. A name for the new subnet. For information - // about the naming requirements, see subnetwork in the Compute API + // about the naming requirements, see subnetwork + // (/compute/docs/reference/rest/v1/subnetworks) in the Compute API // documentation. Subnetwork string `json:"subnetwork,omitempty"` @@ -587,15 +588,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses semantic versioning where the major - // version number indicates a breaking change and the minor version an - // additive, non-breaking change. Both version numbers are signals to - // users what to expect from different versions, and should be carefully - // chosen based on the product plan. The major version is also reflected - // in the package name of the interface, which must end in `v`, as in - // `google.feature.v1`. For major versions 0 and 1, the suffix can be - // omitted. Zero major versions must only be used for experimental, - // non-GA interfaces. + // The versioning schema uses semantic versioning (http://semver.org) + // where the major version number indicates a breaking change and the + // minor version an additive, non-breaking change. Both version numbers + // are signals to users what to expect from different versions, and + // should be carefully chosen based on the product plan. The major + // version is also reflected in the package name of the interface, which + // must end in `v`, as in `google.feature.v1`. For major versions 0 and + // 1, the suffix can be omitted. Zero major versions must only be used + // for experimental, non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -622,12 +623,14 @@ func (s *Api) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { - // Audiences: The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, JWTs with audiences: - - // "https://[service.name]/[google.protobuf.Api.name]" - + // Audiences: The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, JWTs with + // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - @@ -650,10 +653,14 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See OpenID Discovery. Optional if the key set document: - - // can be retrieved from OpenID Discovery of the issuer. - can be - // inferred from the email domain of the issuer (e.g. a Google service - // account). Example: https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe + // tadata). Optional if the key set document: - can be retrieved from + // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the + // issuer. - can be inferred from the email domain of the issuer (e.g. a + // Google service account). Example: + // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -691,16 +698,18 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, only JWTs with audience - // "https://Service_name/API_name" will be accepted. For example, if no - // audiences are in the setting, LibraryService API will only accept - // JWTs with the following audience + // components. The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, only JWTs + // with audience "https://Service_name/API_name" will be accepted. For + // example, if no audiences are in the setting, LibraryService API will + // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1757,20 +1766,22 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the - // backends served from this endpoint to receive and respond to HTTP - // OPTIONS requests. The response will be used by the browser to - // determine whether the subsequent cross-origin request is allowed to - // proceed. + // AllowCors: Allowing CORS + // (https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka + // cross-domain traffic, would allow the backends served from this + // endpoint to receive and respond to HTTP OPTIONS requests. The + // response will be used by the browser to determine whether the + // subsequent cross-origin request is allowed to proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this API Endpoint. It should be - // either a valid IPv4 address or a fully-qualified domain name. For - // example, "8.8.8.8" or "myservice.appspot.com". + // frontend that will handle requests to this API Endpoint + // (https://cloud.google.com/apis/design/glossary). It should be either + // a valid IPv4 address or a fully-qualified domain name. For example, + // "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` // ForceSendFields is a list of field names (e.g. "Aliases") to @@ -2085,10 +2096,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud -// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use -// it for large scale production services. `HttpRule` defines the schema -// of the gRPC/REST mapping. The mapping specifies how different +// gRPC APIs and REST APIs. Many systems, including Google APIs +// (https://github.com/googleapis/googleapis), Cloud Endpoints +// (https://cloud.google.com/endpoints), gRPC Gateway +// (https://github.com/grpc-ecosystem/grpc-gateway), and Envoy +// (https://github.com/envoyproxy/envoy) proxy support this feature and +// use it for large scale production services. `HttpRule` defines the +// schema of the gRPC/REST mapping. The mapping specifies how different // portions of the gRPC request message are mapped to the URL path, URL // query parameters, and HTTP request body. It also controls how the // gRPC response message is mapped to the HTTP response body. `HttpRule` @@ -2187,12 +2201,15 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// Discovery Document as `{var}`. If a variable contains multiple path -// segments, such as "{var=foo/*}" or "{var=**}", when such a -// variable is expanded into a URL path on the client side, all -// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server -// side does the reverse decoding, except "%2F" and "%2f" are left -// unchanged. Such variables show up in the Discovery Document as +// Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as +// `{var}`. If a variable contains multiple path segments, such as +// "{var=foo/*}" or "{var=**}", when such a variable is expanded +// into a URL path on the client side, all characters except +// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the +// reverse decoding, except "%2F" and "%2f" are left unchanged. Such +// variables show up in the Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as // `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The @@ -2209,24 +2226,26 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the proto3 specification. While the -// single segment variable follows the semantics of RFC 6570 Section -// 3.2.2 Simple String Expansion, the multi segment variable **does -// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is -// that the Reserved Expansion does not expand special characters like -// `?` and `#`, which would lead to invalid URLs. As the result, gRPC -// Transcoding uses a custom encoding for multi segment variables. The -// path variables **must not** refer to any repeated or mapped field, -// because client libraries are not capable of handling such variable -// expansion. The path variables **must not** capture the leading "/" -// character. The reason is that the most common use case "{var}" does -// not capture the leading "/" character. For consistency, all path -// variables must share the same behavior. Repeated message fields must -// not be mapped to URL query parameters, because no client library can -// support such complicated mapping. If an API needs to use a JSON array -// for request or response body, it can map the request or response body -// to a repeated field. However, some gRPC Transcoding implementations -// may not support this feature. +// to JSON conversion must follow the proto3 specification +// (https://developers.google.com/protocol-buffers/docs/proto3#json). +// While the single segment variable follows the semantics of RFC 6570 +// (https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String +// Expansion, the multi segment variable **does not** follow RFC 6570 +// Section 3.2.3 Reserved Expansion. The reason is that the Reserved +// Expansion does not expand special characters like `?` and `#`, which +// would lead to invalid URLs. As the result, gRPC Transcoding uses a +// custom encoding for multi segment variables. The path variables +// **must not** refer to any repeated or mapped field, because client +// libraries are not capable of handling such variable expansion. The +// path variables **must not** capture the leading "/" character. The +// reason is that the most common use case "{var}" does not capture the +// leading "/" character. For consistency, all path variables must share +// the same behavior. Repeated message fields must not be mapped to URL +// query parameters, because no client library can support such +// complicated mapping. If an API needs to use a JSON array for request +// or response body, it can map the request or response body to a +// repeated field. However, some gRPC Transcoding implementations may +// not support this feature. type HttpRule struct { // AdditionalBindings: Additional HTTP bindings for the selector. Nested // bindings must not contain an `additional_bindings` field themselves @@ -2779,37 +2798,39 @@ type MetricDescriptor struct { // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is // `12005/1024`). The supported units are a subset of The Unified Code - // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * - // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` - // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega - // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` - // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli - // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * - // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` - // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi - // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar - // also includes these connectors: * `/` division or ratio (as an infix - // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you - // should almost never have `/s` in a metric `unit`; rates should always - // be computed at query time from the underlying cumulative or delta - // value). * `.` multiplication or composition (as an infix operator). - // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as - // follows: Expression = Component { "." Component } { "/" Component } ; - // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | - // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a - // comment if it follows a `UNIT`. If the annotation is used alone, then - // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, + // for Units of Measure (http://unitsofmeasure.org/ucum.html) standard: + // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` + // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** + // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera + // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * + // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano + // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) + // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` + // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) + // **Grammar** The grammar also includes these connectors: * `/` + // division or ratio (as an infix operator). For examples, `kBy/{email}` + // or `MiBy/10ms` (although you should almost never have `/s` in a + // metric `unit`; rates should always be computed at query time from the + // underlying cumulative or delta value). * `.` multiplication or + // composition (as an infix operator). For examples, `GBy.d` or + // `k{watt}.h`. The grammar for a unit is as follows: Expression = + // Component { "." Component } { "/" Component } ; Component = ( [ + // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation + // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it + // follows a `UNIT`. If the annotation is used alone, then the unit is + // equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary dimensionless unit of 1, such as in `1/s`. It is - // typically used when none of the basic units are appropriate. For - // example, "new users per day" can be represented as `1/d` or - // `{new-users}/d` (and a metric value `5` would mean "5 new users). - // Alternatively, "thousands of page views per day" would be represented - // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of - // `5.3` would mean "5300 page views per day"). * `%` represents - // dimensionless value of 1/100, and annotates values giving a - // percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit + // (https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such as + // in `1/s`. It is typically used when none of the basic units are + // appropriate. For example, "new users per day" can be represented as + // `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new + // users). Alternatively, "thousands of page views per day" would be + // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric + // value of `5.3` would mean "5300 page views per day"). * `%` + // represents dimensionless value of 1/100, and annotates values giving + // a percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -4202,10 +4223,11 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4542,11 +4564,11 @@ func (s *UpdateDnsRecordSetRequest) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports Google Cloud Pub/Sub as a - // notification channel. To use Google Cloud Pub/Sub as the channel, - // this must be the name of a Cloud Pub/Sub topic that uses the Cloud - // Pub/Sub topic name format documented in - // https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub + // (https://cloud.google.com/pubsub) as a notification channel. To use + // Google Cloud Pub/Sub as the channel, this must be the name of a Cloud + // Pub/Sub topic that uses the Cloud Pub/Sub topic name format + // documented in https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go index 14bc68f0aa0..95ce419743c 100644 --- a/servicenetworking/v1beta/servicenetworking-gen.go +++ b/servicenetworking/v1beta/servicenetworking-gen.go @@ -285,8 +285,8 @@ type AddSubnetworkRequest struct { // range. IpPrefixLength int64 `json:"ipPrefixLength,omitempty"` - // Region: Required. The name of a region for the subnet, such - // `europe-west1`. + // Region: Required. The name of a region (/compute/docs/regions-zones) + // for the subnet, such `europe-west1`. Region string `json:"region,omitempty"` // RequestedAddress: Optional. The starting address of a range. The @@ -298,7 +298,8 @@ type AddSubnetworkRequest struct { RequestedAddress string `json:"requestedAddress,omitempty"` // Subnetwork: Required. A name for the new subnet. For information - // about the naming requirements, see subnetwork in the Compute API + // about the naming requirements, see subnetwork + // (/compute/docs/reference/rest/v1/subnetworks) in the Compute API // documentation. Subnetwork string `json:"subnetwork,omitempty"` @@ -369,15 +370,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses semantic versioning where the major - // version number indicates a breaking change and the minor version an - // additive, non-breaking change. Both version numbers are signals to - // users what to expect from different versions, and should be carefully - // chosen based on the product plan. The major version is also reflected - // in the package name of the interface, which must end in `v`, as in - // `google.feature.v1`. For major versions 0 and 1, the suffix can be - // omitted. Zero major versions must only be used for experimental, - // non-GA interfaces. + // The versioning schema uses semantic versioning (http://semver.org) + // where the major version number indicates a breaking change and the + // minor version an additive, non-breaking change. Both version numbers + // are signals to users what to expect from different versions, and + // should be carefully chosen based on the product plan. The major + // version is also reflected in the package name of the interface, which + // must end in `v`, as in `google.feature.v1`. For major versions 0 and + // 1, the suffix can be omitted. Zero major versions must only be used + // for experimental, non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -404,12 +405,14 @@ func (s *Api) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { - // Audiences: The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, JWTs with audiences: - - // "https://[service.name]/[google.protobuf.Api.name]" - + // Audiences: The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, JWTs with + // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - @@ -432,10 +435,14 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See OpenID Discovery. Optional if the key set document: - - // can be retrieved from OpenID Discovery of the issuer. - can be - // inferred from the email domain of the issuer (e.g. a Google service - // account). Example: https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe + // tadata). Optional if the key set document: - can be retrieved from + // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the + // issuer. - can be inferred from the email domain of the issuer (e.g. a + // Google service account). Example: + // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -473,16 +480,18 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, only JWTs with audience - // "https://Service_name/API_name" will be accepted. For example, if no - // audiences are in the setting, LibraryService API will only accept - // JWTs with the following audience + // components. The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, only JWTs + // with audience "https://Service_name/API_name" will be accepted. For + // example, if no audiences are in the setting, LibraryService API will + // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1418,20 +1427,22 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the - // backends served from this endpoint to receive and respond to HTTP - // OPTIONS requests. The response will be used by the browser to - // determine whether the subsequent cross-origin request is allowed to - // proceed. + // AllowCors: Allowing CORS + // (https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka + // cross-domain traffic, would allow the backends served from this + // endpoint to receive and respond to HTTP OPTIONS requests. The + // response will be used by the browser to determine whether the + // subsequent cross-origin request is allowed to proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this API Endpoint. It should be - // either a valid IPv4 address or a fully-qualified domain name. For - // example, "8.8.8.8" or "myservice.appspot.com". + // frontend that will handle requests to this API Endpoint + // (https://cloud.google.com/apis/design/glossary). It should be either + // a valid IPv4 address or a fully-qualified domain name. For example, + // "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` // ForceSendFields is a list of field names (e.g. "Aliases") to @@ -1746,10 +1757,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud -// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use -// it for large scale production services. `HttpRule` defines the schema -// of the gRPC/REST mapping. The mapping specifies how different +// gRPC APIs and REST APIs. Many systems, including Google APIs +// (https://github.com/googleapis/googleapis), Cloud Endpoints +// (https://cloud.google.com/endpoints), gRPC Gateway +// (https://github.com/grpc-ecosystem/grpc-gateway), and Envoy +// (https://github.com/envoyproxy/envoy) proxy support this feature and +// use it for large scale production services. `HttpRule` defines the +// schema of the gRPC/REST mapping. The mapping specifies how different // portions of the gRPC request message are mapped to the URL path, URL // query parameters, and HTTP request body. It also controls how the // gRPC response message is mapped to the HTTP response body. `HttpRule` @@ -1848,12 +1862,15 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// Discovery Document as `{var}`. If a variable contains multiple path -// segments, such as "{var=foo/*}" or "{var=**}", when such a -// variable is expanded into a URL path on the client side, all -// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server -// side does the reverse decoding, except "%2F" and "%2f" are left -// unchanged. Such variables show up in the Discovery Document as +// Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as +// `{var}`. If a variable contains multiple path segments, such as +// "{var=foo/*}" or "{var=**}", when such a variable is expanded +// into a URL path on the client side, all characters except +// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the +// reverse decoding, except "%2F" and "%2f" are left unchanged. Such +// variables show up in the Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as // `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The @@ -1870,24 +1887,26 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the proto3 specification. While the -// single segment variable follows the semantics of RFC 6570 Section -// 3.2.2 Simple String Expansion, the multi segment variable **does -// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is -// that the Reserved Expansion does not expand special characters like -// `?` and `#`, which would lead to invalid URLs. As the result, gRPC -// Transcoding uses a custom encoding for multi segment variables. The -// path variables **must not** refer to any repeated or mapped field, -// because client libraries are not capable of handling such variable -// expansion. The path variables **must not** capture the leading "/" -// character. The reason is that the most common use case "{var}" does -// not capture the leading "/" character. For consistency, all path -// variables must share the same behavior. Repeated message fields must -// not be mapped to URL query parameters, because no client library can -// support such complicated mapping. If an API needs to use a JSON array -// for request or response body, it can map the request or response body -// to a repeated field. However, some gRPC Transcoding implementations -// may not support this feature. +// to JSON conversion must follow the proto3 specification +// (https://developers.google.com/protocol-buffers/docs/proto3#json). +// While the single segment variable follows the semantics of RFC 6570 +// (https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String +// Expansion, the multi segment variable **does not** follow RFC 6570 +// Section 3.2.3 Reserved Expansion. The reason is that the Reserved +// Expansion does not expand special characters like `?` and `#`, which +// would lead to invalid URLs. As the result, gRPC Transcoding uses a +// custom encoding for multi segment variables. The path variables +// **must not** refer to any repeated or mapped field, because client +// libraries are not capable of handling such variable expansion. The +// path variables **must not** capture the leading "/" character. The +// reason is that the most common use case "{var}" does not capture the +// leading "/" character. For consistency, all path variables must share +// the same behavior. Repeated message fields must not be mapped to URL +// query parameters, because no client library can support such +// complicated mapping. If an API needs to use a JSON array for request +// or response body, it can map the request or response body to a +// repeated field. However, some gRPC Transcoding implementations may +// not support this feature. type HttpRule struct { // AdditionalBindings: Additional HTTP bindings for the selector. Nested // bindings must not contain an `additional_bindings` field themselves @@ -2369,37 +2388,39 @@ type MetricDescriptor struct { // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is // `12005/1024`). The supported units are a subset of The Unified Code - // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * - // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` - // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega - // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` - // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli - // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * - // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` - // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi - // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar - // also includes these connectors: * `/` division or ratio (as an infix - // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you - // should almost never have `/s` in a metric `unit`; rates should always - // be computed at query time from the underlying cumulative or delta - // value). * `.` multiplication or composition (as an infix operator). - // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as - // follows: Expression = Component { "." Component } { "/" Component } ; - // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | - // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a - // comment if it follows a `UNIT`. If the annotation is used alone, then - // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, + // for Units of Measure (http://unitsofmeasure.org/ucum.html) standard: + // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` + // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** + // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera + // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * + // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano + // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) + // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` + // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) + // **Grammar** The grammar also includes these connectors: * `/` + // division or ratio (as an infix operator). For examples, `kBy/{email}` + // or `MiBy/10ms` (although you should almost never have `/s` in a + // metric `unit`; rates should always be computed at query time from the + // underlying cumulative or delta value). * `.` multiplication or + // composition (as an infix operator). For examples, `GBy.d` or + // `k{watt}.h`. The grammar for a unit is as follows: Expression = + // Component { "." Component } { "/" Component } ; Component = ( [ + // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation + // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it + // follows a `UNIT`. If the annotation is used alone, then the unit is + // equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary dimensionless unit of 1, such as in `1/s`. It is - // typically used when none of the basic units are appropriate. For - // example, "new users per day" can be represented as `1/d` or - // `{new-users}/d` (and a metric value `5` would mean "5 new users). - // Alternatively, "thousands of page views per day" would be represented - // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of - // `5.3` would mean "5300 page views per day"). * `%` represents - // dimensionless value of 1/100, and annotates values giving a - // percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit + // (https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such as + // in `1/s`. It is typically used when none of the basic units are + // appropriate. For example, "new users per day" can be represented as + // `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new + // users). Alternatively, "thousands of page views per day" would be + // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric + // value of `5.3` would mean "5300 page views per day"). * `%` + // represents dimensionless value of 1/100, and annotates values giving + // a percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -3620,10 +3641,11 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -3882,11 +3904,11 @@ type UpdateDnsRecordSetMetadata struct { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports Google Cloud Pub/Sub as a - // notification channel. To use Google Cloud Pub/Sub as the channel, - // this must be the name of a Cloud Pub/Sub topic that uses the Cloud - // Pub/Sub topic name format documented in - // https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub + // (https://cloud.google.com/pubsub) as a notification channel. To use + // Google Cloud Pub/Sub as the channel, this must be the name of a Cloud + // Pub/Sub topic that uses the Cloud Pub/Sub topic name format + // documented in https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index 040913b2388..30c80ab8a66 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -269,15 +269,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses semantic versioning where the major - // version number indicates a breaking change and the minor version an - // additive, non-breaking change. Both version numbers are signals to - // users what to expect from different versions, and should be carefully - // chosen based on the product plan. The major version is also reflected - // in the package name of the interface, which must end in `v`, as in - // `google.feature.v1`. For major versions 0 and 1, the suffix can be - // omitted. Zero major versions must only be used for experimental, - // non-GA interfaces. + // The versioning schema uses semantic versioning (http://semver.org) + // where the major version number indicates a breaking change and the + // minor version an additive, non-breaking change. Both version numbers + // are signals to users what to expect from different versions, and + // should be carefully chosen based on the product plan. The major + // version is also reflected in the package name of the interface, which + // must end in `v`, as in `google.feature.v1`. For major versions 0 and + // 1, the suffix can be omitted. Zero major versions must only be used + // for experimental, non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -304,12 +304,14 @@ func (s *Api) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { - // Audiences: The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, JWTs with audiences: - - // "https://[service.name]/[google.protobuf.Api.name]" - + // Audiences: The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, JWTs with + // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - @@ -332,10 +334,14 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See OpenID Discovery. Optional if the key set document: - - // can be retrieved from OpenID Discovery of the issuer. - can be - // inferred from the email domain of the issuer (e.g. a Google service - // account). Example: https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe + // tadata). Optional if the key set document: - can be retrieved from + // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the + // issuer. - can be inferred from the email domain of the issuer (e.g. a + // Google service account). Example: + // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -373,16 +379,18 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, only JWTs with audience - // "https://Service_name/API_name" will be accepted. For example, if no - // audiences are in the setting, LibraryService API will only accept - // JWTs with the following audience + // components. The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, only JWTs + // with audience "https://Service_name/API_name" will be accepted. For + // example, if no audiences are in the setting, LibraryService API will + // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1433,20 +1441,22 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the - // backends served from this endpoint to receive and respond to HTTP - // OPTIONS requests. The response will be used by the browser to - // determine whether the subsequent cross-origin request is allowed to - // proceed. + // AllowCors: Allowing CORS + // (https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka + // cross-domain traffic, would allow the backends served from this + // endpoint to receive and respond to HTTP OPTIONS requests. The + // response will be used by the browser to determine whether the + // subsequent cross-origin request is allowed to proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this API Endpoint. It should be - // either a valid IPv4 address or a fully-qualified domain name. For - // example, "8.8.8.8" or "myservice.appspot.com". + // frontend that will handle requests to this API Endpoint + // (https://cloud.google.com/apis/design/glossary). It should be either + // a valid IPv4 address or a fully-qualified domain name. For example, + // "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` // ForceSendFields is a list of field names (e.g. "Aliases") to @@ -2095,10 +2105,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud -// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use -// it for large scale production services. `HttpRule` defines the schema -// of the gRPC/REST mapping. The mapping specifies how different +// gRPC APIs and REST APIs. Many systems, including Google APIs +// (https://github.com/googleapis/googleapis), Cloud Endpoints +// (https://cloud.google.com/endpoints), gRPC Gateway +// (https://github.com/grpc-ecosystem/grpc-gateway), and Envoy +// (https://github.com/envoyproxy/envoy) proxy support this feature and +// use it for large scale production services. `HttpRule` defines the +// schema of the gRPC/REST mapping. The mapping specifies how different // portions of the gRPC request message are mapped to the URL path, URL // query parameters, and HTTP request body. It also controls how the // gRPC response message is mapped to the HTTP response body. `HttpRule` @@ -2197,12 +2210,15 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// Discovery Document as `{var}`. If a variable contains multiple path -// segments, such as "{var=foo/*}" or "{var=**}", when such a -// variable is expanded into a URL path on the client side, all -// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server -// side does the reverse decoding, except "%2F" and "%2f" are left -// unchanged. Such variables show up in the Discovery Document as +// Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as +// `{var}`. If a variable contains multiple path segments, such as +// "{var=foo/*}" or "{var=**}", when such a variable is expanded +// into a URL path on the client side, all characters except +// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the +// reverse decoding, except "%2F" and "%2f" are left unchanged. Such +// variables show up in the Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as // `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The @@ -2219,24 +2235,26 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the proto3 specification. While the -// single segment variable follows the semantics of RFC 6570 Section -// 3.2.2 Simple String Expansion, the multi segment variable **does -// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is -// that the Reserved Expansion does not expand special characters like -// `?` and `#`, which would lead to invalid URLs. As the result, gRPC -// Transcoding uses a custom encoding for multi segment variables. The -// path variables **must not** refer to any repeated or mapped field, -// because client libraries are not capable of handling such variable -// expansion. The path variables **must not** capture the leading "/" -// character. The reason is that the most common use case "{var}" does -// not capture the leading "/" character. For consistency, all path -// variables must share the same behavior. Repeated message fields must -// not be mapped to URL query parameters, because no client library can -// support such complicated mapping. If an API needs to use a JSON array -// for request or response body, it can map the request or response body -// to a repeated field. However, some gRPC Transcoding implementations -// may not support this feature. +// to JSON conversion must follow the proto3 specification +// (https://developers.google.com/protocol-buffers/docs/proto3#json). +// While the single segment variable follows the semantics of RFC 6570 +// (https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String +// Expansion, the multi segment variable **does not** follow RFC 6570 +// Section 3.2.3 Reserved Expansion. The reason is that the Reserved +// Expansion does not expand special characters like `?` and `#`, which +// would lead to invalid URLs. As the result, gRPC Transcoding uses a +// custom encoding for multi segment variables. The path variables +// **must not** refer to any repeated or mapped field, because client +// libraries are not capable of handling such variable expansion. The +// path variables **must not** capture the leading "/" character. The +// reason is that the most common use case "{var}" does not capture the +// leading "/" character. For consistency, all path variables must share +// the same behavior. Repeated message fields must not be mapped to URL +// query parameters, because no client library can support such +// complicated mapping. If an API needs to use a JSON array for request +// or response body, it can map the request or response body to a +// repeated field. However, some gRPC Transcoding implementations may +// not support this feature. type HttpRule struct { // AdditionalBindings: Additional HTTP bindings for the selector. Nested // bindings must not contain an `additional_bindings` field themselves @@ -2845,37 +2863,39 @@ type MetricDescriptor struct { // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is // `12005/1024`). The supported units are a subset of The Unified Code - // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * - // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` - // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega - // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` - // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli - // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * - // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` - // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi - // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar - // also includes these connectors: * `/` division or ratio (as an infix - // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you - // should almost never have `/s` in a metric `unit`; rates should always - // be computed at query time from the underlying cumulative or delta - // value). * `.` multiplication or composition (as an infix operator). - // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as - // follows: Expression = Component { "." Component } { "/" Component } ; - // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | - // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a - // comment if it follows a `UNIT`. If the annotation is used alone, then - // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, + // for Units of Measure (http://unitsofmeasure.org/ucum.html) standard: + // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` + // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** + // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera + // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * + // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano + // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) + // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` + // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) + // **Grammar** The grammar also includes these connectors: * `/` + // division or ratio (as an infix operator). For examples, `kBy/{email}` + // or `MiBy/10ms` (although you should almost never have `/s` in a + // metric `unit`; rates should always be computed at query time from the + // underlying cumulative or delta value). * `.` multiplication or + // composition (as an infix operator). For examples, `GBy.d` or + // `k{watt}.h`. The grammar for a unit is as follows: Expression = + // Component { "." Component } { "/" Component } ; Component = ( [ + // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation + // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it + // follows a `UNIT`. If the annotation is used alone, then the unit is + // equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary dimensionless unit of 1, such as in `1/s`. It is - // typically used when none of the basic units are appropriate. For - // example, "new users per day" can be represented as `1/d` or - // `{new-users}/d` (and a metric value `5` would mean "5 new users). - // Alternatively, "thousands of page views per day" would be represented - // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of - // `5.3` would mean "5300 page views per day"). * `%` represents - // dimensionless value of 1/100, and annotates values giving a - // percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit + // (https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such as + // in `1/s`. It is typically used when none of the basic units are + // appropriate. For example, "new users per day" can be represented as + // `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new + // users). Alternatively, "thousands of page views per day" would be + // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric + // value of `5.3` would mean "5300 page views per day"). * `%` + // represents dimensionless value of 1/100, and annotates values giving + // a percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -3843,10 +3863,11 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4056,11 +4077,11 @@ func (s *Type) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports Google Cloud Pub/Sub as a - // notification channel. To use Google Cloud Pub/Sub as the channel, - // this must be the name of a Cloud Pub/Sub topic that uses the Cloud - // Pub/Sub topic name format documented in - // https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub + // (https://cloud.google.com/pubsub) as a notification channel. To use + // Google Cloud Pub/Sub as the channel, this must be the name of a Cloud + // Pub/Sub topic that uses the Cloud Pub/Sub topic name format + // documented in https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer @@ -5552,8 +5573,9 @@ type ServicesListCall struct { // be filtered to only include services in a specific state, for example // to only include services enabled on the project. WARNING: If you need // to query enabled services frequently or across an organization, you -// should use Cloud Asset Inventory API, which provides higher -// throughput and richer filtering capability. +// should use Cloud Asset Inventory API +// (https://cloud.google.com/asset-inventory/docs/apis), which provides +// higher throughput and richer filtering capability. func (r *ServicesService) List(parent string) *ServicesListCall { c := &ServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index 0d6bfe31c0d..c4002f260c0 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -317,15 +317,15 @@ type Api struct { // is empty, the major version is derived from the package name, as // outlined below. If the field is not empty, the version in the package // name will be verified to be consistent with what is provided here. - // The versioning schema uses semantic versioning where the major - // version number indicates a breaking change and the minor version an - // additive, non-breaking change. Both version numbers are signals to - // users what to expect from different versions, and should be carefully - // chosen based on the product plan. The major version is also reflected - // in the package name of the interface, which must end in `v`, as in - // `google.feature.v1`. For major versions 0 and 1, the suffix can be - // omitted. Zero major versions must only be used for experimental, - // non-GA interfaces. + // The versioning schema uses semantic versioning (http://semver.org) + // where the major version number indicates a breaking change and the + // minor version an additive, non-breaking change. Both version numbers + // are signals to users what to expect from different versions, and + // should be carefully chosen based on the product plan. The major + // version is also reflected in the package name of the interface, which + // must end in `v`, as in `google.feature.v1`. For major versions 0 and + // 1, the suffix can be omitted. Zero major versions must only be used + // for experimental, non-GA interfaces. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to @@ -352,12 +352,14 @@ func (s *Api) MarshalJSON() ([]byte, error) { } // AuthProvider: Configuration for an authentication provider, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { - // Audiences: The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, JWTs with audiences: - - // "https://[service.name]/[google.protobuf.Api.name]" - + // Audiences: The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, JWTs with + // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - @@ -380,10 +382,14 @@ type AuthProvider struct { Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature - // of the JWT. See OpenID Discovery. Optional if the key set document: - - // can be retrieved from OpenID Discovery of the issuer. - can be - // inferred from the email domain of the issuer (e.g. a Google service - // account). Example: https://www.googleapis.com/oauth2/v1/certs + // of the JWT. See OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe + // tadata). Optional if the key set document: - can be retrieved from + // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the + // issuer. - can be inferred from the email domain of the issuer (e.g. a + // Google service account). Example: + // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` // JwtLocations: Defines the locations to extract the JWT. JWT locations @@ -421,16 +427,18 @@ func (s *AuthProvider) MarshalJSON() ([]byte, error) { } // AuthRequirement: User-defined authentication requirements, including -// support for JSON Web Token (JWT). +// support for JSON Web Token (JWT) +// (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime - // components. The list of JWT audiences. that are allowed to access. A - // JWT containing any of these audiences will be accepted. When this - // setting is absent, only JWTs with audience - // "https://Service_name/API_name" will be accepted. For example, if no - // audiences are in the setting, LibraryService API will only accept - // JWTs with the following audience + // components. The list of JWT audiences + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio + // n-4.1.3). that are allowed to access. A JWT containing any of these + // audiences will be accepted. When this setting is absent, only JWTs + // with audience "https://Service_name/API_name" will be accepted. For + // example, if no audiences are in the setting, LibraryService API will + // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -1513,20 +1521,22 @@ type Endpoint struct { // hosted on. Aliases []string `json:"aliases,omitempty"` - // AllowCors: Allowing CORS, aka cross-domain traffic, would allow the - // backends served from this endpoint to receive and respond to HTTP - // OPTIONS requests. The response will be used by the browser to - // determine whether the subsequent cross-origin request is allowed to - // proceed. + // AllowCors: Allowing CORS + // (https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka + // cross-domain traffic, would allow the backends served from this + // endpoint to receive and respond to HTTP OPTIONS requests. The + // response will be used by the browser to determine whether the + // subsequent cross-origin request is allowed to proceed. AllowCors bool `json:"allowCors,omitempty"` // Name: The canonical name of this endpoint. Name string `json:"name,omitempty"` // Target: The specification of an Internet routable address of API - // frontend that will handle requests to this API Endpoint. It should be - // either a valid IPv4 address or a fully-qualified domain name. For - // example, "8.8.8.8" or "myservice.appspot.com". + // frontend that will handle requests to this API Endpoint + // (https://cloud.google.com/apis/design/glossary). It should be either + // a valid IPv4 address or a fully-qualified domain name. For example, + // "8.8.8.8" or "myservice.appspot.com". Target string `json:"target,omitempty"` // ForceSendFields is a list of field names (e.g. "Aliases") to @@ -2171,10 +2181,13 @@ func (s *Http) MarshalJSON() ([]byte, error) { // HttpRule: # gRPC Transcoding gRPC Transcoding is a feature for // mapping between a gRPC method and one or more HTTP REST endpoints. It // allows developers to build a single API service that supports both -// gRPC APIs and REST APIs. Many systems, including Google APIs, Cloud -// Endpoints, gRPC Gateway, and Envoy proxy support this feature and use -// it for large scale production services. `HttpRule` defines the schema -// of the gRPC/REST mapping. The mapping specifies how different +// gRPC APIs and REST APIs. Many systems, including Google APIs +// (https://github.com/googleapis/googleapis), Cloud Endpoints +// (https://cloud.google.com/endpoints), gRPC Gateway +// (https://github.com/grpc-ecosystem/grpc-gateway), and Envoy +// (https://github.com/envoyproxy/envoy) proxy support this feature and +// use it for large scale production services. `HttpRule` defines the +// schema of the gRPC/REST mapping. The mapping specifies how different // portions of the gRPC request message are mapped to the URL path, URL // query parameters, and HTTP request body. It also controls how the // gRPC response message is mapped to the HTTP response body. `HttpRule` @@ -2273,12 +2286,15 @@ func (s *Http) MarshalJSON() ([]byte, error) { // variable is expanded into a URL path on the client side, all // characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The server // side does the reverse decoding. Such variables show up in the -// Discovery Document as `{var}`. If a variable contains multiple path -// segments, such as "{var=foo/*}" or "{var=**}", when such a -// variable is expanded into a URL path on the client side, all -// characters except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server -// side does the reverse decoding, except "%2F" and "%2f" are left -// unchanged. Such variables show up in the Discovery Document as +// Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as +// `{var}`. If a variable contains multiple path segments, such as +// "{var=foo/*}" or "{var=**}", when such a variable is expanded +// into a URL path on the client side, all characters except +// `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the +// reverse decoding, except "%2F" and "%2f" are left unchanged. Such +// variables show up in the Discovery Document +// (https://developers.google.com/discovery/v1/reference/apis) as // `{+var}`. ## Using gRPC API Service Configuration gRPC API Service // Configuration (service config) is a configuration language for // configuring a gRPC service to become a user-facing product. The @@ -2295,24 +2311,26 @@ func (s *Http) MarshalJSON() ([]byte, error) { // example.v1.Messaging.GetMessage get: // /v1/messages/{message_id}/{sub.subfield} ## Special notes When gRPC // Transcoding is used to map a gRPC to JSON REST endpoints, the proto -// to JSON conversion must follow the proto3 specification. While the -// single segment variable follows the semantics of RFC 6570 Section -// 3.2.2 Simple String Expansion, the multi segment variable **does -// not** follow RFC 6570 Section 3.2.3 Reserved Expansion. The reason is -// that the Reserved Expansion does not expand special characters like -// `?` and `#`, which would lead to invalid URLs. As the result, gRPC -// Transcoding uses a custom encoding for multi segment variables. The -// path variables **must not** refer to any repeated or mapped field, -// because client libraries are not capable of handling such variable -// expansion. The path variables **must not** capture the leading "/" -// character. The reason is that the most common use case "{var}" does -// not capture the leading "/" character. For consistency, all path -// variables must share the same behavior. Repeated message fields must -// not be mapped to URL query parameters, because no client library can -// support such complicated mapping. If an API needs to use a JSON array -// for request or response body, it can map the request or response body -// to a repeated field. However, some gRPC Transcoding implementations -// may not support this feature. +// to JSON conversion must follow the proto3 specification +// (https://developers.google.com/protocol-buffers/docs/proto3#json). +// While the single segment variable follows the semantics of RFC 6570 +// (https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String +// Expansion, the multi segment variable **does not** follow RFC 6570 +// Section 3.2.3 Reserved Expansion. The reason is that the Reserved +// Expansion does not expand special characters like `?` and `#`, which +// would lead to invalid URLs. As the result, gRPC Transcoding uses a +// custom encoding for multi segment variables. The path variables +// **must not** refer to any repeated or mapped field, because client +// libraries are not capable of handling such variable expansion. The +// path variables **must not** capture the leading "/" character. The +// reason is that the most common use case "{var}" does not capture the +// leading "/" character. For consistency, all path variables must share +// the same behavior. Repeated message fields must not be mapped to URL +// query parameters, because no client library can support such +// complicated mapping. If an API needs to use a JSON array for request +// or response body, it can map the request or response body to a +// repeated field. However, some gRPC Transcoding implementations may +// not support this feature. type HttpRule struct { // AdditionalBindings: Additional HTTP bindings for the selector. Nested // bindings must not contain an `additional_bindings` field themselves @@ -3104,37 +3122,39 @@ type MetricDescriptor struct { // `unit` is `ks{CPU}`, and then write the value `12.005` (which is // `12005/1000`), or use `Kis{CPU}` and write `11.723` (which is // `12005/1024`). The supported units are a subset of The Unified Code - // for Units of Measure standard: **Basic units (UNIT)** * `bit` bit * - // `By` byte * `s` second * `min` minute * `h` hour * `d` day * `1` - // dimensionless **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega - // (10^6) * `G` giga (10^9) * `T` tera (10^12) * `P` peta (10^15) * `E` - // exa (10^18) * `Z` zetta (10^21) * `Y` yotta (10^24) * `m` milli - // (10^-3) * `u` micro (10^-6) * `n` nano (10^-9) * `p` pico (10^-12) * - // `f` femto (10^-15) * `a` atto (10^-18) * `z` zepto (10^-21) * `y` - // yocto (10^-24) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi - // (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar - // also includes these connectors: * `/` division or ratio (as an infix - // operator). For examples, `kBy/{email}` or `MiBy/10ms` (although you - // should almost never have `/s` in a metric `unit`; rates should always - // be computed at query time from the underlying cumulative or delta - // value). * `.` multiplication or composition (as an infix operator). - // For examples, `GBy.d` or `k{watt}.h`. The grammar for a unit is as - // follows: Expression = Component { "." Component } { "/" Component } ; - // Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | - // "1" ; Annotation = "{" NAME "}" ; Notes: * `Annotation` is just a - // comment if it follows a `UNIT`. If the annotation is used alone, then - // the unit is equivalent to `1`. For examples, `{request}/s == 1/s`, + // for Units of Measure (http://unitsofmeasure.org/ucum.html) standard: + // **Basic units (UNIT)** * `bit` bit * `By` byte * `s` second * `min` + // minute * `h` hour * `d` day * `1` dimensionless **Prefixes (PREFIX)** + // * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T` tera + // (10^12) * `P` peta (10^15) * `E` exa (10^18) * `Z` zetta (10^21) * + // `Y` yotta (10^24) * `m` milli (10^-3) * `u` micro (10^-6) * `n` nano + // (10^-9) * `p` pico (10^-12) * `f` femto (10^-15) * `a` atto (10^-18) + // * `z` zepto (10^-21) * `y` yocto (10^-24) * `Ki` kibi (2^10) * `Mi` + // mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) + // **Grammar** The grammar also includes these connectors: * `/` + // division or ratio (as an infix operator). For examples, `kBy/{email}` + // or `MiBy/10ms` (although you should almost never have `/s` in a + // metric `unit`; rates should always be computed at query time from the + // underlying cumulative or delta value). * `.` multiplication or + // composition (as an infix operator). For examples, `GBy.d` or + // `k{watt}.h`. The grammar for a unit is as follows: Expression = + // Component { "." Component } { "/" Component } ; Component = ( [ + // PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation + // = "{" NAME "}" ; Notes: * `Annotation` is just a comment if it + // follows a `UNIT`. If the annotation is used alone, then the unit is + // equivalent to `1`. For examples, `{request}/s == 1/s`, // `By{transmitted}/s == By/s`. * `NAME` is a sequence of non-blank // printable ASCII characters not containing `{` or `}`. * `1` - // represents a unitary dimensionless unit of 1, such as in `1/s`. It is - // typically used when none of the basic units are appropriate. For - // example, "new users per day" can be represented as `1/d` or - // `{new-users}/d` (and a metric value `5` would mean "5 new users). - // Alternatively, "thousands of page views per day" would be represented - // as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric value of - // `5.3` would mean "5300 page views per day"). * `%` represents - // dimensionless value of 1/100, and annotates values giving a - // percentage (so the metric values are typically in the range of + // represents a unitary dimensionless unit + // (https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such as + // in `1/s`. It is typically used when none of the basic units are + // appropriate. For example, "new users per day" can be represented as + // `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new + // users). Alternatively, "thousands of page views per day" would be + // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric + // value of `5.3` would mean "5300 page views per day"). * `%` + // represents dimensionless value of 1/100, and annotates values giving + // a percentage (so the metric values are typically in the range of // 0..100, and a metric value `3` means "3 percent"). * `10^2.%` // indicates a metric contains a ratio, typically in the range 0..1, // that will be multiplied by 100 and displayed as a percentage (so a @@ -4305,10 +4325,11 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4518,11 +4539,11 @@ func (s *Type) MarshalJSON() ([]byte, error) { type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used // for sending notifications to the service producer. Google Service - // Management currently only supports Google Cloud Pub/Sub as a - // notification channel. To use Google Cloud Pub/Sub as the channel, - // this must be the name of a Cloud Pub/Sub topic that uses the Cloud - // Pub/Sub topic name format documented in - // https://cloud.google.com/pubsub/docs/overview. + // Management currently only supports Google Cloud Pub/Sub + // (https://cloud.google.com/pubsub) as a notification channel. To use + // Google Cloud Pub/Sub as the channel, this must be the name of a Cloud + // Pub/Sub topic that uses the Cloud Pub/Sub topic name format + // documented in https://cloud.google.com/pubsub/docs/overview. ProducerNotificationChannel string `json:"producerNotificationChannel,omitempty"` // Requirements: Requirements that must be satisfied before a consumer diff --git a/sheets/v4/sheets-gen.go b/sheets/v4/sheets-gen.go index da145b51fb7..3e0802aba55 100644 --- a/sheets/v4/sheets-gen.go +++ b/sheets/v4/sheets-gen.go @@ -2286,7 +2286,8 @@ func (s *BigQueryQuerySpec) MarshalJSON() ([]byte, error) { } // BigQueryTableSpec: Specifies a BigQuery table definition. Only native -// tables is allowed. +// tables (https://cloud.google.com/bigquery/docs/tables-intro) is +// allowed. type BigQueryTableSpec struct { // DatasetId: The BigQuery dataset id. DatasetId string `json:"datasetId,omitempty"` @@ -4517,7 +4518,9 @@ func (s *DataSourceObjectReferences) MarshalJSON() ([]byte, error) { // a query. type DataSourceParameter struct { // Name: Named parameter. Must be a legitimate identifier for the - // DataSource that supports it. For example, BigQuery identifier. + // DataSource that supports it. For example, BigQuery identifier + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical + // #identifiers). Name string `json:"name,omitempty"` // NamedRangeId: ID of a NamedRange. Its size must be 1x1. @@ -7540,8 +7543,9 @@ func (s *NamedRange) MarshalJSON() ([]byte, error) { type NumberFormat struct { // Pattern: Pattern string used for formatting. If not set, a default // pattern based on the user's locale will be used if necessary for the - // given type. See the Date and Number Formats guide for more - // information about the supported patterns. + // given type. See the Date and Number Formats guide + // (/sheets/api/guides/formats) for more information about the supported + // patterns. Pattern string `json:"pattern,omitempty"` // Type: The type of the number format. When writing, this field must be @@ -12612,9 +12616,11 @@ type SpreadsheetsValuesAppendCall struct { // Append: Appends values to a spreadsheet. The input range is used to // search for existing data and find a "table" within that range. Values // will be appended to the next row of the table, starting with the -// first column of the table. See the guide and sample code for specific -// details of how tables are detected and data is appended. The caller -// must specify the spreadsheet ID, range, and a valueInputOption. The +// first column of the table. See the guide +// (/sheets/api/guides/values#appending_values) and sample code +// (/sheets/api/samples/writing#append_values) for specific details of +// how tables are detected and data is appended. The caller must specify +// the spreadsheet ID, range, and a valueInputOption. The // `valueInputOption` only controls how the input data will be added to // the sheet (column-wise or row-wise), it does not influence what cell // the data starts being written to. diff --git a/slides/v1/slides-gen.go b/slides/v1/slides-gen.go index 5c9caa94036..2def7e6da45 100644 --- a/slides/v1/slides-gen.go +++ b/slides/v1/slides-gen.go @@ -6939,10 +6939,11 @@ type WeightedFontFamily struct { // Weight: The rendered weight of the text. This field can have any // value that is a multiple of `100` between `100` and `900`, inclusive. // This range corresponds to the numerical values described in the CSS - // 2.1 Specification, section 15.6, with non-numerical values - // disallowed. Weights greater than or equal to `700` are considered - // bold, and weights less than `700`are not bold. The default value is - // `400` ("normal"). + // 2.1 Specification, section 15.6 + // (https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with + // non-numerical values disallowed. Weights greater than or equal to + // `700` are considered bold, and weights less than `700`are not bold. + // The default value is `400` ("normal"). Weight int64 `json:"weight,omitempty"` // ForceSendFields is a list of field names (e.g. "FontFamily") to @@ -7638,8 +7639,8 @@ type PresentationsPagesGetThumbnailCall struct { // GetThumbnail: Generates a thumbnail of the latest version of the // specified page in the presentation and returns a URL to the thumbnail -// image. This request counts as an expensive read request for quota -// purposes. +// image. This request counts as an expensive read request +// (/slides/limits) for quota purposes. func (r *PresentationsPagesService) GetThumbnail(presentationId string, pageObjectId string) *PresentationsPagesGetThumbnailCall { c := &PresentationsPagesGetThumbnailCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.presentationId = presentationId diff --git a/sourcerepo/v1/sourcerepo-gen.go b/sourcerepo/v1/sourcerepo-gen.go index b21ca954c50..6096da8ca4e 100644 --- a/sourcerepo/v1/sourcerepo-gen.go +++ b/sourcerepo/v1/sourcerepo-gen.go @@ -277,7 +277,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -565,7 +566,9 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -584,7 +587,7 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -624,7 +627,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -832,10 +836,11 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -921,7 +926,8 @@ type SyncRepoRequest struct { type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. // Permissions with wildcards (such as '*' or 'storage.*') are not - // allowed. For more information see IAM Overview. + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -1781,7 +1787,8 @@ func (r *ProjectsReposService) GetIamPolicy(resource string) *ProjectsReposGetIa // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM -// policies, see the IAM documentation. +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). func (c *ProjectsReposGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsReposGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index 861a1f6806f..1c08a4bd519 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -496,7 +496,8 @@ type Binding struct { // binding does not apply to the current request. However, a different // role binding might grant the same role to one or more of the members // in this binding. To learn which resources support conditions in their - // IAM policies, see the IAM documentation. + // IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -1378,7 +1379,8 @@ type GetPolicyOptions struct { // conditional bindings must specify version 3. Policies without any // conditional bindings may specify any valid value or leave the field // unset. To learn which resources support conditions in their IAM - // policies, see the IAM documentation. + // policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). RequestedPolicyVersion int64 `json:"requestedPolicyVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1429,17 +1431,18 @@ type Instance struct { // how resource metrics are aggregated. And they can be used as // arguments to policy management rules (e.g. route, firewall, load // balancing, etc.). * Label keys must be between 1 and 63 characters - // long and must conform to the following regular expression: `a-z?`. * - // Label values must be between 0 and 63 characters long and must - // conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. * - // No more than 64 labels can be associated with a given resource. See - // https://goo.gl/xmQnxf for more information on and examples of labels. - // If you plan to use labels in your own code, please note that - // additional characters may be allowed in the future. And so you are - // advised to use an internal label representation, such as JSON, which - // doesn't rely upon specific characters being disallowed. For example, - // representing labels as the string: name + "_" + value would prove - // problematic if we were to allow "_" in a future release. + // long and must conform to the following regular expression: `a-z + // ([-a-z0-9]*[a-z0-9])?`. * Label values must be between 0 and 63 + // characters long and must conform to the regular expression + // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. * No more than 64 labels can be + // associated with a given resource. See https://goo.gl/xmQnxf for more + // information on and examples of labels. If you plan to use labels in + // your own code, please note that additional characters may be allowed + // in the future. And so you are advised to use an internal label + // representation, such as JSON, which doesn't rely upon specific + // characters being disallowed. For example, representing labels as the + // string: name + "_" + value would prove problematic if we were to + // allow "_" in a future release. Labels map[string]string `json:"labels,omitempty"` // Name: Required. A unique identifier for the instance, which cannot be @@ -1450,7 +1453,9 @@ type Instance struct { // NodeCount: The number of nodes allocated to this instance. This may // be zero in API responses for instances that are not yet in state - // `READY`. See the documentation for more information about nodes. + // `READY`. See the documentation + // (https://cloud.google.com/spanner/docs/instances#node_count) for more + // information about nodes. NodeCount int64 `json:"nodeCount,omitempty"` // State: Output only. The current instance state. For CreateInstance, @@ -2556,7 +2561,9 @@ func (s *PlanNode) MarshalJSON() ([]byte, error) { // evaluates to `true`. A condition can add constraints based on // attributes of the request, the resource, or both. To learn which // resources support conditions in their IAM policies, see the IAM -// documentation. **JSON example:** { "bindings": [ { "role": +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -2575,7 +2582,7 @@ func (s *PlanNode) MarshalJSON() ([]byte, error) { // after Sep 2020 expression: request.time < // timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: // 3 For a description of IAM and its features, see the IAM -// documentation. +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // Bindings: Associates a list of `members` to a `role`. Optionally, may // specify a `condition` that determines how and when the `bindings` are @@ -2611,7 +2618,8 @@ type Policy struct { // does not include any conditions, operations on that policy may // specify any valid version or leave the field unset. To learn which // resources support conditions in their IAM policies, see the IAM - // documentation. + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2868,7 +2876,9 @@ type ReadWrite struct { type ReplicaInfo struct { // DefaultLeaderLocation: If true, this location is designated as the // default leader location where leader replicas are placed. See the - // region types documentation for more details. + // region types documentation + // (https://cloud.google.com/spanner/docs/instances#region_types) for + // more details. DefaultLeaderLocation bool `json:"defaultLeaderLocation,omitempty"` // Location: The location of the serving resources, e.g. "us-central1". @@ -3225,11 +3235,11 @@ type Session struct { // Labels: The labels for the session. * Label keys must be between 1 // and 63 characters long and must conform to the following regular - // expression: `a-z?`. * Label values must be between 0 and 63 - // characters long and must conform to the regular expression - // `([a-z]([-a-z0-9]*[a-z0-9])?)?`. * No more than 64 labels can be - // associated with a given session. See https://goo.gl/xmQnxf for more - // information on and examples of labels. + // expression: `a-z ([-a-z0-9]*[a-z0-9])?`. * Label values must be + // between 0 and 63 characters long and must conform to the regular + // expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. * No more than 64 labels + // can be associated with a given session. See https://goo.gl/xmQnxf for + // more information on and examples of labels. Labels map[string]string `json:"labels,omitempty"` // Name: Output only. The name of the session. This is always @@ -3381,10 +3391,11 @@ func (s *Statement) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4167,7 +4178,7 @@ func (c *ProjectsInstanceConfigsGetCall) Header() http.Header { func (c *ProjectsInstanceConfigsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4329,7 +4340,7 @@ func (c *ProjectsInstanceConfigsListCall) Header() http.Header { func (c *ProjectsInstanceConfigsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4515,7 +4526,7 @@ func (c *ProjectsInstancesCreateCall) Header() http.Header { func (c *ProjectsInstancesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4658,7 +4669,7 @@ func (c *ProjectsInstancesDeleteCall) Header() http.Header { func (c *ProjectsInstancesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4808,7 +4819,7 @@ func (c *ProjectsInstancesGetCall) Header() http.Header { func (c *ProjectsInstancesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4953,7 +4964,7 @@ func (c *ProjectsInstancesGetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5136,7 +5147,7 @@ func (c *ProjectsInstancesListCall) Header() http.Header { func (c *ProjectsInstancesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5331,7 +5342,7 @@ func (c *ProjectsInstancesPatchCall) Header() http.Header { func (c *ProjectsInstancesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5474,7 +5485,7 @@ func (c *ProjectsInstancesSetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5619,7 +5630,7 @@ func (c *ProjectsInstancesTestIamPermissionsCall) Header() http.Header { func (c *ProjectsInstancesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5827,7 +5838,7 @@ func (c *ProjectsInstancesBackupOperationsListCall) Header() http.Header { func (c *ProjectsInstancesBackupOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6016,7 +6027,7 @@ func (c *ProjectsInstancesBackupsCreateCall) Header() http.Header { func (c *ProjectsInstancesBackupsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6160,7 +6171,7 @@ func (c *ProjectsInstancesBackupsDeleteCall) Header() http.Header { func (c *ProjectsInstancesBackupsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6302,7 +6313,7 @@ func (c *ProjectsInstancesBackupsGetCall) Header() http.Header { func (c *ProjectsInstancesBackupsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6443,7 +6454,7 @@ func (c *ProjectsInstancesBackupsGetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesBackupsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6639,7 +6650,7 @@ func (c *ProjectsInstancesBackupsListCall) Header() http.Header { func (c *ProjectsInstancesBackupsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6823,7 +6834,7 @@ func (c *ProjectsInstancesBackupsPatchCall) Header() http.Header { func (c *ProjectsInstancesBackupsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6974,7 +6985,7 @@ func (c *ProjectsInstancesBackupsSetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesBackupsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7122,7 +7133,7 @@ func (c *ProjectsInstancesBackupsTestIamPermissionsCall) Header() http.Header { func (c *ProjectsInstancesBackupsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7270,7 +7281,7 @@ func (c *ProjectsInstancesBackupsOperationsCancelCall) Header() http.Header { func (c *ProjectsInstancesBackupsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7404,7 +7415,7 @@ func (c *ProjectsInstancesBackupsOperationsDeleteCall) Header() http.Header { func (c *ProjectsInstancesBackupsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7548,7 +7559,7 @@ func (c *ProjectsInstancesBackupsOperationsGetCall) Header() http.Header { func (c *ProjectsInstancesBackupsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7723,7 +7734,7 @@ func (c *ProjectsInstancesBackupsOperationsListCall) Header() http.Header { func (c *ProjectsInstancesBackupsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7961,7 +7972,7 @@ func (c *ProjectsInstancesDatabaseOperationsListCall) Header() http.Header { func (c *ProjectsInstancesDatabaseOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8138,7 +8149,7 @@ func (c *ProjectsInstancesDatabasesCreateCall) Header() http.Header { func (c *ProjectsInstancesDatabasesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8279,7 +8290,7 @@ func (c *ProjectsInstancesDatabasesDropDatabaseCall) Header() http.Header { func (c *ProjectsInstancesDatabasesDropDatabaseCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8421,7 +8432,7 @@ func (c *ProjectsInstancesDatabasesGetCall) Header() http.Header { func (c *ProjectsInstancesDatabasesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8568,7 +8579,7 @@ func (c *ProjectsInstancesDatabasesGetDdlCall) Header() http.Header { func (c *ProjectsInstancesDatabasesGetDdlCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8709,7 +8720,7 @@ func (c *ProjectsInstancesDatabasesGetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesDatabasesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8875,7 +8886,7 @@ func (c *ProjectsInstancesDatabasesListCall) Header() http.Header { func (c *ProjectsInstancesDatabasesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9055,7 +9066,7 @@ func (c *ProjectsInstancesDatabasesRestoreCall) Header() http.Header { func (c *ProjectsInstancesDatabasesRestoreCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9200,7 +9211,7 @@ func (c *ProjectsInstancesDatabasesSetIamPolicyCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9348,7 +9359,7 @@ func (c *ProjectsInstancesDatabasesTestIamPermissionsCall) Header() http.Header func (c *ProjectsInstancesDatabasesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9494,7 +9505,7 @@ func (c *ProjectsInstancesDatabasesUpdateDdlCall) Header() http.Header { func (c *ProjectsInstancesDatabasesUpdateDdlCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9642,7 +9653,7 @@ func (c *ProjectsInstancesDatabasesOperationsCancelCall) Header() http.Header { func (c *ProjectsInstancesDatabasesOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9776,7 +9787,7 @@ func (c *ProjectsInstancesDatabasesOperationsDeleteCall) Header() http.Header { func (c *ProjectsInstancesDatabasesOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9920,7 +9931,7 @@ func (c *ProjectsInstancesDatabasesOperationsGetCall) Header() http.Header { func (c *ProjectsInstancesDatabasesOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10095,7 +10106,7 @@ func (c *ProjectsInstancesDatabasesOperationsListCall) Header() http.Header { func (c *ProjectsInstancesDatabasesOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10270,7 +10281,7 @@ func (c *ProjectsInstancesDatabasesSessionsBatchCreateCall) Header() http.Header func (c *ProjectsInstancesDatabasesSessionsBatchCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10413,7 +10424,7 @@ func (c *ProjectsInstancesDatabasesSessionsBeginTransactionCall) Header() http.H func (c *ProjectsInstancesDatabasesSessionsBeginTransactionCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10565,7 +10576,7 @@ func (c *ProjectsInstancesDatabasesSessionsCommitCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsCommitCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10718,7 +10729,7 @@ func (c *ProjectsInstancesDatabasesSessionsCreateCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10859,7 +10870,7 @@ func (c *ProjectsInstancesDatabasesSessionsDeleteCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11000,7 +11011,7 @@ func (c *ProjectsInstancesDatabasesSessionsExecuteBatchDmlCall) Header() http.He func (c *ProjectsInstancesDatabasesSessionsExecuteBatchDmlCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11148,7 +11159,7 @@ func (c *ProjectsInstancesDatabasesSessionsExecuteSqlCall) Header() http.Header func (c *ProjectsInstancesDatabasesSessionsExecuteSqlCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11292,7 +11303,7 @@ func (c *ProjectsInstancesDatabasesSessionsExecuteStreamingSqlCall) Header() htt func (c *ProjectsInstancesDatabasesSessionsExecuteStreamingSqlCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11444,7 +11455,7 @@ func (c *ProjectsInstancesDatabasesSessionsGetCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11617,7 +11628,7 @@ func (c *ProjectsInstancesDatabasesSessionsListCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11800,7 +11811,7 @@ func (c *ProjectsInstancesDatabasesSessionsPartitionQueryCall) Header() http.Hea func (c *ProjectsInstancesDatabasesSessionsPartitionQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11953,7 +11964,7 @@ func (c *ProjectsInstancesDatabasesSessionsPartitionReadCall) Header() http.Head func (c *ProjectsInstancesDatabasesSessionsPartitionReadCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12102,7 +12113,7 @@ func (c *ProjectsInstancesDatabasesSessionsReadCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsReadCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12248,7 +12259,7 @@ func (c *ProjectsInstancesDatabasesSessionsRollbackCall) Header() http.Header { func (c *ProjectsInstancesDatabasesSessionsRollbackCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12392,7 +12403,7 @@ func (c *ProjectsInstancesDatabasesSessionsStreamingReadCall) Header() http.Head func (c *ProjectsInstancesDatabasesSessionsStreamingReadCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12540,7 +12551,7 @@ func (c *ProjectsInstancesOperationsCancelCall) Header() http.Header { func (c *ProjectsInstancesOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12674,7 +12685,7 @@ func (c *ProjectsInstancesOperationsDeleteCall) Header() http.Header { func (c *ProjectsInstancesOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12818,7 +12829,7 @@ func (c *ProjectsInstancesOperationsGetCall) Header() http.Header { func (c *ProjectsInstancesOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12993,7 +13004,7 @@ func (c *ProjectsInstancesOperationsListCall) Header() http.Header { func (c *ProjectsInstancesOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/speech/v1/speech-gen.go b/speech/v1/speech-gen.go index f90c9b8ce66..95c39ec6ba1 100644 --- a/speech/v1/speech-gen.go +++ b/speech/v1/speech-gen.go @@ -406,7 +406,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // RecognitionAudio: Contains audio data in the encoding specified in // the `RecognitionConfig`. Either `content` or `uri` must be supplied. // Supplying both or neither returns google.rpc.Code.INVALID_ARGUMENT. -// See content limits. +// See content limits +// (https://cloud.google.com/speech-to-text/quotas#content). type RecognitionAudio struct { // Content: The audio data bytes encoded as specified in // `RecognitionConfig`. Note: as with all bytes fields, proto buffers @@ -420,7 +421,7 @@ type RecognitionAudio struct { // supported, which must be specified in the following format: // `gs://bucket_name/object_name` (other URI formats return // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. + // URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -531,8 +532,10 @@ type RecognitionConfig struct { Encoding string `json:"encoding,omitempty"` // LanguageCode: Required. The language of the supplied audio as a - // BCP-47 language tag. Example: "en-US". See Language Support for a - // list of the currently supported language codes. + // BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. + // Example: "en-US". See Language Support + // (https://cloud.google.com/speech-to-text/docs/languages) for a list + // of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Maximum number of recognition hypotheses to be @@ -579,7 +582,8 @@ type RecognitionConfig struct { // SpeechContexts: Array of SpeechContext. A means to provide context to // assist the speech recognition. For more information, see speech - // adaptation. + // adaptation + // (https://cloud.google.com/speech-to-text/docs/context-strength). SpeechContexts []*SpeechContext `json:"speechContexts,omitempty"` // UseEnhanced: Set to true to use an enhanced model for speech @@ -844,11 +848,13 @@ type SpeechContext struct { // can be used to improve the accuracy for specific words and phrases, // for example, if specific commands are typically spoken by the user. // This can also be used to add additional words to the vocabulary of - // the recognizer. See usage limits. List items can also be set to - // classes for groups of words that represent common concepts that occur - // in natural language. For example, rather than providing phrase hints - // for every month of the year, using the $MONTH class improves the - // likelihood of correctly transcribing audio that includes months. + // the recognizer. See usage limits + // (https://cloud.google.com/speech-to-text/quotas#content). List items + // can also be set to classes for groups of words that represent common + // concepts that occur in natural language. For example, rather than + // providing phrase hints for every month of the year, using the $MONTH + // class improves the likelihood of correctly transcribing audio that + // includes months. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -972,10 +978,11 @@ func (s *SpeechRecognitionResult) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1788,7 +1795,8 @@ type SpeechLongrunningrecognizeCall struct { // receive results via the google.longrunning.Operations interface. // Returns either an `Operation.error` or an `Operation.response` which // contains a `LongRunningRecognizeResponse` message. For more -// information on asynchronous speech recognition, see the how-to. +// information on asynchronous speech recognition, see the how-to +// (https://cloud.google.com/speech-to-text/docs/async-recognize). func (r *SpeechService) Longrunningrecognize(longrunningrecognizerequest *LongRunningRecognizeRequest) *SpeechLongrunningrecognizeCall { c := &SpeechLongrunningrecognizeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.longrunningrecognizerequest = longrunningrecognizerequest diff --git a/speech/v1p1beta1/speech-gen.go b/speech/v1p1beta1/speech-gen.go index f625c808e70..e269f186aa2 100644 --- a/speech/v1p1beta1/speech-gen.go +++ b/speech/v1p1beta1/speech-gen.go @@ -475,19 +475,21 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // to improve the accuracy for specific words and phrases, for example, // if specific commands are typically spoken by the user. This can also // be used to add additional words to the vocabulary of the recognizer. -// See usage limits. List items can also include pre-built or custom -// classes containing groups of words that represent common concepts -// that occur in natural language. For example, rather than providing a -// phrase hint for every month of the year (e.g. "i was born in -// january", "i was born in febuary", ...), use the pre-built `$MONTH` -// class improves the likelihood of correctly transcribing audio that -// includes months (e.g. "i was born in $month"). To refer to pre-built -// classes, use the class' symbol prepended with `$` e.g. `$MONTH`. To -// refer to custom classes that were defined inline in the request, set -// the class's `custom_class_id` to a string unique to all class -// resources and inline classes. Then use the class' id wrapped in -// $`{...}` e.g. "${my-months}". To refer to custom classes resources, -// use the class' id wrapped in `${}` (e.g. `${my-months}`). +// See usage limits +// (https://cloud.google.com/speech-to-text/quotas#content). List items +// can also include pre-built or custom classes containing groups of +// words that represent common concepts that occur in natural language. +// For example, rather than providing a phrase hint for every month of +// the year (e.g. "i was born in january", "i was born in febuary", +// ...), use the pre-built `$MONTH` class improves the likelihood of +// correctly transcribing audio that includes months (e.g. "i was born +// in $month"). To refer to pre-built classes, use the class' symbol +// prepended with `$` e.g. `$MONTH`. To refer to custom classes that +// were defined inline in the request, set the class's `custom_class_id` +// to a string unique to all class resources and inline classes. Then +// use the class' id wrapped in $`{...}` e.g. "${my-months}". To refer +// to custom classes resources, use the class' id wrapped in `${}` (e.g. +// `${my-months}`). type Phrase struct { // Boost: Hint Boost. Overrides the boost set at the phrase set level. // Positive value will increase the probability that a specific phrase @@ -603,7 +605,8 @@ func (s *PhraseSet) UnmarshalJSON(data []byte) error { // RecognitionAudio: Contains audio data in the encoding specified in // the `RecognitionConfig`. Either `content` or `uri` must be supplied. // Supplying both or neither returns google.rpc.Code.INVALID_ARGUMENT. -// See content limits. +// See content limits +// (https://cloud.google.com/speech-to-text/quotas#content). type RecognitionAudio struct { // Content: The audio data bytes encoded as specified in // `RecognitionConfig`. Note: as with all bytes fields, proto buffers @@ -617,7 +620,7 @@ type RecognitionAudio struct { // supported, which must be specified in the following format: // `gs://bucket_name/object_name` (other URI formats return // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. + // URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -649,19 +652,22 @@ type RecognitionConfig struct { // Adaptation: Speech adaptation configuration improves the accuracy of // speech recognition. When speech adaptation is set it supersedes the // `speech_contexts` field. For more information, see the speech - // adaptation documentation. + // adaptation + // (https://cloud.google.com/speech-to-text/docs/context-strength) + // documentation. Adaptation *SpeechAdaptation `json:"adaptation,omitempty"` // AlternativeLanguageCodes: A list of up to 3 additional BCP-47 - // language tags, listing possible alternative languages of the supplied - // audio. See Language Support for a list of the currently supported - // language codes. If alternative languages are listed, recognition - // result will contain recognition in the most likely language detected - // including the main language_code. The recognition result will include - // the language tag of the language detected in the audio. Note: This - // feature is only supported for Voice Command and Voice Search use - // cases and performance may vary for other use cases (e.g., phone call - // transcription). + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags, listing + // possible alternative languages of the supplied audio. See Language + // Support (https://cloud.google.com/speech-to-text/docs/languages) for + // a list of the currently supported language codes. If alternative + // languages are listed, recognition result will contain recognition in + // the most likely language detected including the main language_code. + // The recognition result will include the language tag of the language + // detected in the audio. Note: This feature is only supported for Voice + // Command and Voice Search use cases and performance may vary for other + // use cases (e.g., phone call transcription). AlternativeLanguageCodes []string `json:"alternativeLanguageCodes,omitempty"` // AudioChannelCount: The number of channels in the input audio data. @@ -768,8 +774,10 @@ type RecognitionConfig struct { Encoding string `json:"encoding,omitempty"` // LanguageCode: Required. The language of the supplied audio as a - // BCP-47 language tag. Example: "en-US". See Language Support for a - // list of the currently supported language codes. + // BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. + // Example: "en-US". See Language Support + // (https://cloud.google.com/speech-to-text/docs/languages) for a list + // of the currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Maximum number of recognition hypotheses to be @@ -816,7 +824,8 @@ type RecognitionConfig struct { // SpeechContexts: Array of SpeechContext. A means to provide context to // assist the speech recognition. For more information, see speech - // adaptation. + // adaptation + // (https://cloud.google.com/speech-to-text/docs/context-strength). SpeechContexts []*SpeechContext `json:"speechContexts,omitempty"` // UseEnhanced: Set to true to use an enhanced model for speech @@ -1131,11 +1140,13 @@ type SpeechContext struct { // can be used to improve the accuracy for specific words and phrases, // for example, if specific commands are typically spoken by the user. // This can also be used to add additional words to the vocabulary of - // the recognizer. See usage limits. List items can also be set to - // classes for groups of words that represent common concepts that occur - // in natural language. For example, rather than providing phrase hints - // for every month of the year, using the $MONTH class improves the - // likelihood of correctly transcribing audio that includes months. + // the recognizer. See usage limits + // (https://cloud.google.com/speech-to-text/quotas#content). List items + // can also be set to classes for groups of words that represent common + // concepts that occur in natural language. For example, rather than + // providing phrase hints for every month of the year, using the $MONTH + // class improves the likelihood of correctly transcribing audio that + // includes months. Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to @@ -1248,9 +1259,10 @@ type SpeechRecognitionResult struct { // from '1' to 'N'. ChannelTag int64 `json:"channelTag,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1278,10 +1290,11 @@ func (s *SpeechRecognitionResult) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -2117,7 +2130,8 @@ type SpeechLongrunningrecognizeCall struct { // receive results via the google.longrunning.Operations interface. // Returns either an `Operation.error` or an `Operation.response` which // contains a `LongRunningRecognizeResponse` message. For more -// information on asynchronous speech recognition, see the how-to. +// information on asynchronous speech recognition, see the how-to +// (https://cloud.google.com/speech-to-text/docs/async-recognize). func (r *SpeechService) Longrunningrecognize(longrunningrecognizerequest *LongRunningRecognizeRequest) *SpeechLongrunningrecognizeCall { c := &SpeechLongrunningrecognizeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.longrunningrecognizerequest = longrunningrecognizerequest diff --git a/speech/v2beta1/speech-gen.go b/speech/v2beta1/speech-gen.go index d505f37a2b1..fb80ff6b78b 100644 --- a/speech/v2beta1/speech-gen.go +++ b/speech/v2beta1/speech-gen.go @@ -420,9 +420,10 @@ type SpeechRecognitionResult struct { // from `1` to `N`. ChannelTag int64 `json:"channelTag,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -450,10 +451,11 @@ func (s *SpeechRecognitionResult) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/storagetransfer/v1/storagetransfer-gen.go b/storagetransfer/v1/storagetransfer-gen.go index 10dcceed8a0..c64dd202a16 100644 --- a/storagetransfer/v1/storagetransfer-gen.go +++ b/storagetransfer/v1/storagetransfer-gen.go @@ -168,9 +168,10 @@ type TransferOperationsService struct { s *Service } -// AwsAccessKey: AWS access key (see AWS Security Credentials). For -// information on our data retention policy for user credentials, see -// User credentials. +// AwsAccessKey: AWS access key (see AWS Security Credentials +// (https://docs.aws.amazon.com/general/latest/gr/aws-security-credential +// s.html)). For information on our data retention policy for user +// credentials, see User credentials (data-retention#user-credentials). type AwsAccessKey struct { // AccessKeyId: Required. AWS access key ID. AccessKeyId string `json:"accessKeyId,omitempty"` @@ -209,10 +210,13 @@ type AwsS3Data struct { // AwsAccessKey: Required. Input only. AWS access key used to sign the // API requests to the AWS S3 bucket. Permissions on the bucket must be // granted to the access ID of the AWS access key. For information on - // our data retention policy for user credentials, see User credentials. + // our data retention policy for user credentials, see User credentials + // (data-retention#user-credentials). AwsAccessKey *AwsAccessKey `json:"awsAccessKey,omitempty"` - // BucketName: Required. S3 Bucket name (see Creating a bucket). + // BucketName: Required. S3 Bucket name (see Creating a bucket + // (https://docs.aws.amazon.com/AmazonS3/latest/dev/create-bucket-get-loc + // ation-example.html)). BucketName string `json:"bucketName,omitempty"` // ForceSendFields is a list of field names (e.g. "AwsAccessKey") to @@ -241,12 +245,18 @@ func (s *AwsS3Data) MarshalJSON() ([]byte, error) { // AzureBlobStorageData: An AzureBlobStorageData resource can be a data // source, but not a data sink. An AzureBlobStorageData resource // represents one Azure container. The storage account determines the -// Azure endpoint. In an AzureBlobStorageData resource, a blobs's name -// is the Azure Blob Storage blob's key name. +// Azure endpoint +// (https://docs.microsoft.com/en-us/azure/storage/common/storage-create- +// storage-account#storage-account-endpoints). In an +// AzureBlobStorageData resource, a blobs's name is the Azure Blob +// Storage blob's key name +// (https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and- +// referencing-containers--blobs--and-metadata#blob-names). type AzureBlobStorageData struct { // AzureCredentials: Required. Input only. Credentials used to // authenticate API requests to Azure. For information on our data - // retention policy for user credentials, see User credentials. + // retention policy for user credentials, see User credentials + // (data-retention#user-credentials). AzureCredentials *AzureCredentials `json:"azureCredentials,omitempty"` // Container: Required. The container to transfer from the Azure Storage @@ -281,11 +291,14 @@ func (s *AzureBlobStorageData) MarshalJSON() ([]byte, error) { } // AzureCredentials: Azure credentials For information on our data -// retention policy for user credentials, see User credentials. +// retention policy for user credentials, see User credentials +// (data-retention#user-credentials). type AzureCredentials struct { // SasToken: Required. Azure shared access signature. (see Grant limited // access to Azure Storage resources using shared access signatures - // (SAS)). + // (SAS) + // (https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-ove + // rview)). SasToken string `json:"sasToken,omitempty"` // ForceSendFields is a list of field names (e.g. "SasToken") to @@ -537,7 +550,8 @@ func (s *ErrorSummary) MarshalJSON() ([]byte, error) { // content or the metadata of the object is updated. type GcsData struct { // BucketName: Required. Cloud Storage bucket name (see Bucket Name - // Requirements). + // Requirements + // (https://cloud.google.com/storage/docs/naming#requirements)). BucketName string `json:"bucketName,omitempty"` // ForceSendFields is a list of field names (e.g. "BucketName") to @@ -604,16 +618,17 @@ func (s *GoogleServiceAccount) MarshalJSON() ([]byte, error) { // following tab-delimited fields: * **HTTP URL** — The location of // the object. * **Length** — The size of the object in bytes. * // **MD5** — The base64-encoded MD5 hash of the object. For an example -// of a valid TSV file, see Transferring data from URLs. When -// transferring data based on a URL list, keep the following in mind: * -// When an object located at `http(s)://hostname:port/` is transferred -// to a data sink, the name of the object at the data sink is `/`. * If -// the specified size of an object does not match the actual size of the -// object fetched, the object will not be transferred. * If the -// specified MD5 does not match the MD5 computed from the transferred -// bytes, the object transfer will fail. * Ensure that each URL you -// specify is publicly accessible. For example, in Cloud Storage you can -// [share an object publicly] +// of a valid TSV file, see Transferring data from URLs +// (https://cloud.google.com/storage-transfer/docs/create-url-list). +// When transferring data based on a URL list, keep the following in +// mind: * When an object located at `http(s)://hostname:port/` is +// transferred to a data sink, the name of the object at the data sink +// is `/`. * If the specified size of an object does not match the +// actual size of the object fetched, the object will not be +// transferred. * If the specified MD5 does not match the MD5 computed +// from the transferred bytes, the object transfer will fail. * Ensure +// that each URL you specify is publicly accessible. For example, in +// Cloud Storage you can [share an object publicly] // (https://cloud.google.com/storage/docs/cloud-console#_sharingdata) // and get a link to it. * Storage Transfer Service obeys `robots.txt` // rules and requires the source HTTP server to support `Range` requests @@ -1025,10 +1040,11 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -1566,7 +1582,7 @@ func (c *GoogleServiceAccountsGetCall) Header() http.Header { func (c *GoogleServiceAccountsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1698,7 +1714,7 @@ func (c *TransferJobsCreateCall) Header() http.Header { func (c *TransferJobsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1835,7 +1851,7 @@ func (c *TransferJobsGetCall) Header() http.Header { func (c *TransferJobsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1999,7 +2015,7 @@ func (c *TransferJobsListCall) Header() http.Header { func (c *TransferJobsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2165,7 +2181,7 @@ func (c *TransferJobsPatchCall) Header() http.Header { func (c *TransferJobsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2323,7 +2339,7 @@ func (c *TransferOperationsCancelCall) Header() http.Header { func (c *TransferOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2474,7 +2490,7 @@ func (c *TransferOperationsGetCall) Header() http.Header { func (c *TransferOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2633,7 +2649,7 @@ func (c *TransferOperationsListCall) Header() http.Header { func (c *TransferOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2807,7 +2823,7 @@ func (c *TransferOperationsPauseCall) Header() http.Header { func (c *TransferOperationsPauseCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2947,7 +2963,7 @@ func (c *TransferOperationsResumeCall) Header() http.Header { func (c *TransferOperationsResumeCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201210") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/streetviewpublish/v1/streetviewpublish-gen.go b/streetviewpublish/v1/streetviewpublish-gen.go index ef38642841e..ba44bdcf41c 100644 --- a/streetviewpublish/v1/streetviewpublish-gen.go +++ b/streetviewpublish/v1/streetviewpublish-gen.go @@ -841,10 +841,11 @@ func (s *Pose) UnmarshalJSON(data []byte) error { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -973,9 +974,11 @@ type PhotoCreateCall struct { // returned UploadRef, CreatePhoto publishes the uploaded Photo to // Street View on Google Maps. Currently, the only way to set heading, // pitch, and roll in CreatePhoto is through the Photo Sphere XMP -// metadata in the photo bytes. CreatePhoto ignores the `pose.heading`, -// `pose.pitch`, `pose.roll`, `pose.altitude`, and `pose.level` fields -// in Pose. This method returns the following error codes: * +// metadata +// (https://developers.google.com/streetview/spherical-metadata) in the +// photo bytes. CreatePhoto ignores the `pose.heading`, `pose.pitch`, +// `pose.roll`, `pose.altitude`, and `pose.level` fields in Pose. This +// method returns the following error codes: * // google.rpc.Code.INVALID_ARGUMENT if the request is malformed or if // the uploaded photo is not a 360 photo. * google.rpc.Code.NOT_FOUND if // the upload reference does not exist. * diff --git a/sts/v1beta/sts-gen.go b/sts/v1beta/sts-gen.go index af8419a4c0e..02fce287d33 100644 --- a/sts/v1beta/sts-gen.go +++ b/sts/v1beta/sts-gen.go @@ -167,40 +167,50 @@ type GoogleIdentityStsV1betaExchangeTokenRequest struct { // SubjectToken: Required. The input token. This token is a either an // external credential issued by a workload identity pool provider, or a // short-lived access token issued by Google. If the token is an OIDC - // JWT, it must use the JWT format defined in RFC 7523, and the - // `subject_token_type` must be `urn:ietf:params:oauth:token-type:jwt`. - // The following headers are required: - `kid`: The identifier of the - // signing key securing the JWT. - `alg`: The cryptographic algorithm - // securing the JWT. Must be `RS256`. The following payload fields are - // required. For more information, see RFC 7523, Section 3: - `iss`: The - // issuer of the token. The issuer must provide a discovery document at - // the URL `/.well-known/openid-configuration`, where `` is the value of - // this field. The document must be formatted according to section 4.2 - // of the OIDC 1.0 Discovery specification. - `iat`: The issue time, in - // seconds, since the Unix epoch. Must be in the past. - `exp`: The - // expiration time, in seconds, since the Unix epoch. Must be less than - // 48 hours after `iat`. Shorter expiration times are more secure. If - // possible, we recommend setting an expiration time less than 6 hours. - // - `sub`: The identity asserted in the JWT. - `aud`: Configured by the - // mapper policy. The default value is the service account's unique ID. - // Example header: ``` { "alg": "RS256", "kid": "us-east-11" } ``` - // Example payload: ``` { "iss": "https://accounts.google.com", "iat": + // JWT, it must use the JWT format defined in RFC 7523 + // (https://tools.ietf.org/html/rfc7523), and the `subject_token_type` + // must be `urn:ietf:params:oauth:token-type:jwt`. The following headers + // are required: - `kid`: The identifier of the signing key securing the + // JWT. - `alg`: The cryptographic algorithm securing the JWT. Must be + // `RS256`. The following payload fields are required. For more + // information, see RFC 7523, Section 3 + // (https://tools.ietf.org/html/rfc7523#section-3): - `iss`: The issuer + // of the token. The issuer must provide a discovery document at the URL + // `/.well-known/openid-configuration`, where `` is the value of this + // field. The document must be formatted according to section 4.2 of the + // OIDC 1.0 Discovery specification + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderCo + // nfigurationResponse). - `iat`: The issue time, in seconds, since the + // Unix epoch. Must be in the past. - `exp`: The expiration time, in + // seconds, since the Unix epoch. Must be less than 48 hours after + // `iat`. Shorter expiration times are more secure. If possible, we + // recommend setting an expiration time less than 6 hours. - `sub`: The + // identity asserted in the JWT. - `aud`: Configured by the mapper + // policy. The default value is the service account's unique ID. Example + // header: ``` { "alg": "RS256", "kid": "us-east-11" } ``` Example + // payload: ``` { "iss": "https://accounts.google.com", "iat": // 1517963104, "exp": 1517966704, "aud": "113475438248934895348", "sub": // "113475438248934895348", "my_claims": { "additional_claim": "value" } // } ``` If `subject_token` is an AWS token, it must be a serialized, - // signed request to the AWS `GetCallerIdentity()` method. Format the - // request as URL-encoded JSON, and set the `subject_token_type` - // parameter to `urn:ietf:params:aws:token-type:aws4_request`. The - // following parameters are required: - `url`: The URL of the AWS STS - // endpoint for `GetCallerIdentity()`, such as + // signed + // (https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_request + // s.html) request to the AWS `GetCallerIdentity()` + // (https://docs.aws.amazon.com/STS/latest/APIReference/API_GetCallerIden + // tity) method. Format the request as URL-encoded JSON, and set the + // `subject_token_type` parameter to + // `urn:ietf:params:aws:token-type:aws4_request`. The following + // parameters are required: - `url`: The URL of the AWS STS endpoint for + // `GetCallerIdentity()`, such as // `https://sts.amazonaws.com?Action=GetCallerIdentity&Version=2011-06-15 // `. Regional endpoints are also supported. - `method`: The HTTP // request method: `POST`. - `headers`: The HTTP request headers, which // must include: - `Authorization`: The request signature. - // `x-amz-date`: The time you will send the request, formatted as an - // ISO8601 Basic string. This is typically set to the current time and - // used to prevent replay attacks. - `host`: The hostname of the `url` - // field; for example, `sts.amazonaws.com`. - + // ISO8601 Basic + // (https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.html#sig + // v4_elements_date) string. This is typically set to the current time + // and used to prevent replay attacks. - `host`: The hostname of the + // `url` field; for example, `sts.amazonaws.com`. - // `x-goog-cloud-target-resource`: The full, canonical resource name of // the workload identity pool provider, with or without an `https:` // prefix. To help ensure data integrity, we recommend including this diff --git a/texttospeech/v1/texttospeech-gen.go b/texttospeech/v1/texttospeech-gen.go index 39cb846376b..b5a6c87cbff 100644 --- a/texttospeech/v1/texttospeech-gen.go +++ b/texttospeech/v1/texttospeech-gen.go @@ -179,7 +179,9 @@ type AudioConfig struct { // EffectsProfileId: Optional. Input only. An identifier which selects // 'audio effects' profiles that are applied on (post synthesized) text // to speech. Effects are applied on top of each other in the order they - // are given. See audio profiles for current supported profile ids. + // are given. See audio profiles + // (https://cloud.google.com/text-to-speech/docs/audio-profiles) for + // current supported profile ids. EffectsProfileId []string `json:"effectsProfileId,omitempty"` // Pitch: Optional. Input only. Speaking pitch, in the range [-20.0, @@ -296,7 +298,8 @@ func (s *ListVoicesResponse) MarshalJSON() ([]byte, error) { type SynthesisInput struct { // Ssml: The SSML document to be synthesized. The SSML document must be // valid and well-formed. Otherwise the RPC will fail and return - // google.rpc.Code.INVALID_ARGUMENT. For more information, see SSML. + // google.rpc.Code.INVALID_ARGUMENT. For more information, see SSML + // (https://cloud.google.com/text-to-speech/docs/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -401,7 +404,8 @@ func (s *SynthesizeSpeechResponse) MarshalJSON() ([]byte, error) { // Voice: Description of a voice supported by the TTS service. type Voice struct { // LanguageCodes: The languages that this voice supports, expressed as - // BCP-47 language tags (e.g. "en-US", "es-419", "cmn-tw"). + // BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags + // (e.g. "en-US", "es-419", "cmn-tw"). LanguageCodes []string `json:"languageCodes,omitempty"` // Name: The name of this voice. Each distinct voice has a unique name. @@ -453,7 +457,8 @@ func (s *Voice) MarshalJSON() ([]byte, error) { // synthesis request. type VoiceSelectionParams struct { // LanguageCode: Required. The language (and potentially also the - // region) of the voice expressed as a BCP-47 language tag, e.g. + // region) of the voice expressed as a BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. // "en-US". This should not include a script tag (e.g. use "cmn-cn" // rather than "cmn-Hant-cn"), because the script will be inferred from // the input provided in the SynthesisInput. The TTS service will use @@ -655,13 +660,13 @@ func (r *VoicesService) List() *VoicesListCall { } // LanguageCode sets the optional parameter "languageCode": Recommended. -// BCP-47 language tag. If specified, the ListVoices call will only -// return voices that can be used to synthesize this language_code. E.g. -// when specifying "en-NZ", you will get supported "en-\*" voices; when -// specifying "no", you will get supported "no-\*" (Norwegian) and -// "nb-\*" (Norwegian Bokmal) voices; specifying "zh" will also get -// supported "cmn-\*" voices; specifying "zh-hk" will also get supported -// "yue-\*" voices. +// BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. +// If specified, the ListVoices call will only return voices that can be +// used to synthesize this language_code. E.g. when specifying "en-NZ", +// you will get supported "en-\*" voices; when specifying "no", you will +// get supported "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) +// voices; specifying "zh" will also get supported "cmn-\*" voices; +// specifying "zh-hk" will also get supported "yue-\*" voices. func (c *VoicesListCall) LanguageCode(languageCode string) *VoicesListCall { c.urlParams_.Set("languageCode", languageCode) return c diff --git a/texttospeech/v1beta1/texttospeech-gen.go b/texttospeech/v1beta1/texttospeech-gen.go index 734e7fbcc7f..c5deb298942 100644 --- a/texttospeech/v1beta1/texttospeech-gen.go +++ b/texttospeech/v1beta1/texttospeech-gen.go @@ -183,7 +183,9 @@ type AudioConfig struct { // EffectsProfileId: Optional. Input only. An identifier which selects // 'audio effects' profiles that are applied on (post synthesized) text // to speech. Effects are applied on top of each other in the order they - // are given. See audio profiles for current supported profile ids. + // are given. See audio profiles + // (https://cloud.google.com/text-to-speech/docs/audio-profiles) for + // current supported profile ids. EffectsProfileId []string `json:"effectsProfileId,omitempty"` // Pitch: Optional. Input only. Speaking pitch, in the range [-20.0, @@ -300,7 +302,8 @@ func (s *ListVoicesResponse) MarshalJSON() ([]byte, error) { type SynthesisInput struct { // Ssml: The SSML document to be synthesized. The SSML document must be // valid and well-formed. Otherwise the RPC will fail and return - // google.rpc.Code.INVALID_ARGUMENT. For more information, see SSML. + // google.rpc.Code.INVALID_ARGUMENT. For more information, see SSML + // (https://cloud.google.com/text-to-speech/docs/ssml). Ssml string `json:"ssml,omitempty"` // Text: The raw text to be synthesized. @@ -470,7 +473,8 @@ func (s *Timepoint) UnmarshalJSON(data []byte) error { // Voice: Description of a voice supported by the TTS service. type Voice struct { // LanguageCodes: The languages that this voice supports, expressed as - // BCP-47 language tags (e.g. "en-US", "es-419", "cmn-tw"). + // BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags + // (e.g. "en-US", "es-419", "cmn-tw"). LanguageCodes []string `json:"languageCodes,omitempty"` // Name: The name of this voice. Each distinct voice has a unique name. @@ -522,7 +526,8 @@ func (s *Voice) MarshalJSON() ([]byte, error) { // synthesis request. type VoiceSelectionParams struct { // LanguageCode: Required. The language (and potentially also the - // region) of the voice expressed as a BCP-47 language tag, e.g. + // region) of the voice expressed as a BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. // "en-US". This should not include a script tag (e.g. use "cmn-cn" // rather than "cmn-Hant-cn"), because the script will be inferred from // the input provided in the SynthesisInput. The TTS service will use @@ -724,13 +729,13 @@ func (r *VoicesService) List() *VoicesListCall { } // LanguageCode sets the optional parameter "languageCode": Recommended. -// BCP-47 language tag. If specified, the ListVoices call will only -// return voices that can be used to synthesize this language_code. E.g. -// when specifying "en-NZ", you will get supported "en-\*" voices; when -// specifying "no", you will get supported "no-\*" (Norwegian) and -// "nb-\*" (Norwegian Bokmal) voices; specifying "zh" will also get -// supported "cmn-\*" voices; specifying "zh-hk" will also get supported -// "yue-\*" voices. +// BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. +// If specified, the ListVoices call will only return voices that can be +// used to synthesize this language_code. E.g. when specifying "en-NZ", +// you will get supported "en-\*" voices; when specifying "no", you will +// get supported "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) +// voices; specifying "zh" will also get supported "cmn-\*" voices; +// specifying "zh-hk" will also get supported "yue-\*" voices. func (c *VoicesListCall) LanguageCode(languageCode string) *VoicesListCall { c.urlParams_.Set("languageCode", languageCode) return c diff --git a/toolresults/v1beta3/toolresults-gen.go b/toolresults/v1beta3/toolresults-gen.go index d0f619ac7c2..b32b1c5b625 100644 --- a/toolresults/v1beta3/toolresults-gen.go +++ b/toolresults/v1beta3/toolresults-gen.go @@ -3313,10 +3313,11 @@ func (s *StartActivityNotFound) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. @@ -4172,9 +4173,10 @@ func (s *Thumbnail) MarshalJSON() ([]byte, error) { // Gregorian calendar which extends the Gregorian calendar backwards to // year one. All minutes are 60 seconds long. Leap seconds are "smeared" // so that no leap second table is needed for interpretation, using a -// 24-hour linear smear. The range is from 0001-01-01T00:00:00Z to -// 9999-12-31T23:59:59.999999999Z. By restricting to that range, we -// ensure that we can convert to and from RFC 3339 date strings. +// 24-hour linear smear (https://developers.google.com/time/smear). The +// range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. +// By restricting to that range, we ensure that we can convert to and +// from RFC 3339 (https://www.ietf.org/rfc/rfc3339.txt) date strings. type Timestamp struct { // Nanos: Non-negative fractions of a second at nanosecond resolution. // Negative second values with fractions must still have non-negative diff --git a/tpu/v1/tpu-gen.go b/tpu/v1/tpu-gen.go index db75422f914..2b4b46ce40f 100644 --- a/tpu/v1/tpu-gen.go +++ b/tpu/v1/tpu-gen.go @@ -846,10 +846,11 @@ type StartNodeRequest struct { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/tpu/v1alpha1/tpu-gen.go b/tpu/v1alpha1/tpu-gen.go index 1d065955b1e..0110c0f24e1 100644 --- a/tpu/v1alpha1/tpu-gen.go +++ b/tpu/v1alpha1/tpu-gen.go @@ -846,10 +846,11 @@ type StartNodeRequest struct { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/translate/v3/translate-gen.go b/translate/v3/translate-gen.go index d59576b1cdd..4055877449e 100644 --- a/translate/v3/translate-gen.go +++ b/translate/v3/translate-gen.go @@ -536,7 +536,8 @@ type GlossaryInputConfig struct { // source/target term pairs. For equivalent term sets glossaries: - CSV // (`.csv`): Multi-column CSV file defining equivalent glossary terms in // multiple languages. See documentation for more information - - // glossaries. + // glossaries + // (https://cloud.google.com/translate/docs/advanced/glossary). GcsSource *GcsSource `json:"gcsSource,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsSource") to @@ -982,10 +983,11 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/translate/v3beta1/translate-gen.go b/translate/v3beta1/translate-gen.go index 3ffea2fce43..068afd90116 100644 --- a/translate/v3beta1/translate-gen.go +++ b/translate/v3beta1/translate-gen.go @@ -533,7 +533,8 @@ type GlossaryInputConfig struct { // source/target term pairs. For equivalent term sets glossaries: - CSV // (`.csv`): Multi-column CSV file defining equivalent glossary terms in // multiple languages. The format is defined for Google Translation - // Toolkit and documented in Use a glossary. + // Toolkit and documented in Use a glossary + // (https://support.google.com/translatortoolkit/answer/6306379?hl=en). GcsSource *GcsSource `json:"gcsSource,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsSource") to @@ -979,10 +980,11 @@ func (s *OutputConfig) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/vault/v1/vault-gen.go b/vault/v1/vault-gen.go index 877644f9fd6..72945b4f799 100644 --- a/vault/v1/vault-gen.go +++ b/vault/v1/vault-gen.go @@ -2289,10 +2289,11 @@ func (s *SharedDriveInfo) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/videointelligence/v1/videointelligence-gen.go b/videointelligence/v1/videointelligence-gen.go index 571e8fe5e18..da5e8a574b8 100644 --- a/videointelligence/v1/videointelligence-gen.go +++ b/videointelligence/v1/videointelligence-gen.go @@ -287,15 +287,17 @@ type GoogleCloudVideointelligenceV1AnnotateVideoRequest struct { // unset. InputContent string `json:"inputContent,omitempty"` - // InputUri: Input video location. Currently, only Cloud Storage URIs - // are supported. URIs must be specified in the following format: - // `gs://bucket-id/object-id` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. To identify multiple videos, a video URI may include wildcards - // in the `object-id`. Supported wildcards: '*' to match 0 or more - // characters; '?' to match 1 character. If unset, the input video - // should be embedded in the request as `input_content`. If set, - // `input_content` must be unset. + // InputUri: Input video location. Currently, only Cloud Storage + // (https://cloud.google.com/storage/) URIs are supported. URIs must be + // specified in the following format: `gs://bucket-id/object-id` (other + // URI formats return google.rpc.Code.INVALID_ARGUMENT). For more + // information, see Request URIs + // (https://cloud.google.com/storage/docs/request-endpoints). To + // identify multiple videos, a video URI may include wildcards in the + // `object-id`. Supported wildcards: '*' to match 0 or more characters; + // '?' to match 1 character. If unset, the input video should be + // embedded in the request as `input_content`. If set, `input_content` + // must be unset. InputUri string `json:"inputUri,omitempty"` // LocationId: Optional. Cloud region where annotation should take @@ -305,11 +307,12 @@ type GoogleCloudVideointelligenceV1AnnotateVideoRequest struct { LocationId string `json:"locationId,omitempty"` // OutputUri: Optional. Location where the output (in JSON format) - // should be stored. Currently, only Cloud Storage URIs are supported. - // These must be specified in the following format: - // `gs://bucket-id/object-id` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. + // should be stored. Currently, only Cloud Storage + // (https://cloud.google.com/storage/) URIs are supported. These must be + // specified in the following format: `gs://bucket-id/object-id` (other + // URI formats return google.rpc.Code.INVALID_ARGUMENT). For more + // information, see Request URIs + // (https://cloud.google.com/storage/docs/request-endpoints). OutputUri string `json:"outputUri,omitempty"` // VideoContext: Additional video context and/or feature-specific @@ -484,7 +487,8 @@ type GoogleCloudVideointelligenceV1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1443,7 +1447,8 @@ type GoogleCloudVideointelligenceV1SpeechContext struct { // them. This can be used to improve the accuracy for specific words and // phrases, for example, if specific commands are typically spoken by // the user. This can also be used to add additional words to the - // vocabulary of the recognizer. See usage limits. + // vocabulary of the recognizer. See usage limits + // (https://cloud.google.com/speech/limits#content). Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -1535,9 +1540,10 @@ type GoogleCloudVideointelligenceV1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1607,8 +1613,10 @@ type GoogleCloudVideointelligenceV1SpeechTranscriptionConfig struct { FilterProfanity bool `json:"filterProfanity,omitempty"` // LanguageCode: Required. *Required* The language of the supplied audio - // as a BCP-47 language tag. Example: "en-US". See Language Support for - // a list of the currently supported language codes. + // as a BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language + // tag. Example: "en-US". See Language Support + // (https://cloud.google.com/speech/docs/languages) for a list of the + // currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Optional. Maximum number of recognition hypotheses @@ -1922,7 +1930,8 @@ type GoogleCloudVideointelligenceV1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1983,7 +1992,8 @@ type GoogleCloudVideointelligenceV1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -2405,7 +2415,8 @@ type GoogleCloudVideointelligenceV1beta2Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -3170,9 +3181,10 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1beta2SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -3438,7 +3450,8 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -3499,7 +3512,8 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1beta2LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3863,7 +3877,8 @@ type GoogleCloudVideointelligenceV1p1beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4630,9 +4645,10 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p1beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -4898,7 +4914,8 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4959,7 +4976,8 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p1beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -5323,7 +5341,8 @@ type GoogleCloudVideointelligenceV1p2beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -6090,9 +6109,10 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p2beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -6358,7 +6378,8 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6419,7 +6440,8 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p2beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6889,7 +6911,8 @@ type GoogleCloudVideointelligenceV1p3beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7702,9 +7725,10 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p3beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -8059,7 +8083,8 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8123,7 +8148,8 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p3beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8428,10 +8454,11 @@ type GoogleProtobufEmpty struct { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/videointelligence/v1beta2/videointelligence-gen.go b/videointelligence/v1beta2/videointelligence-gen.go index b29056d3c65..2d480a4bcde 100644 --- a/videointelligence/v1beta2/videointelligence-gen.go +++ b/videointelligence/v1beta2/videointelligence-gen.go @@ -324,7 +324,8 @@ type GoogleCloudVideointelligenceV1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1087,9 +1088,10 @@ type GoogleCloudVideointelligenceV1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1354,7 +1356,8 @@ type GoogleCloudVideointelligenceV1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1415,7 +1418,8 @@ type GoogleCloudVideointelligenceV1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1657,15 +1661,17 @@ type GoogleCloudVideointelligenceV1beta2AnnotateVideoRequest struct { // unset. InputContent string `json:"inputContent,omitempty"` - // InputUri: Input video location. Currently, only Cloud Storage URIs - // are supported. URIs must be specified in the following format: - // `gs://bucket-id/object-id` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. To identify multiple videos, a video URI may include wildcards - // in the `object-id`. Supported wildcards: '*' to match 0 or more - // characters; '?' to match 1 character. If unset, the input video - // should be embedded in the request as `input_content`. If set, - // `input_content` must be unset. + // InputUri: Input video location. Currently, only Cloud Storage + // (https://cloud.google.com/storage/) URIs are supported. URIs must be + // specified in the following format: `gs://bucket-id/object-id` (other + // URI formats return google.rpc.Code.INVALID_ARGUMENT). For more + // information, see Request URIs + // (https://cloud.google.com/storage/docs/request-endpoints). To + // identify multiple videos, a video URI may include wildcards in the + // `object-id`. Supported wildcards: '*' to match 0 or more characters; + // '?' to match 1 character. If unset, the input video should be + // embedded in the request as `input_content`. If set, `input_content` + // must be unset. InputUri string `json:"inputUri,omitempty"` // LocationId: Optional. Cloud region where annotation should take @@ -1675,11 +1681,12 @@ type GoogleCloudVideointelligenceV1beta2AnnotateVideoRequest struct { LocationId string `json:"locationId,omitempty"` // OutputUri: Optional. Location where the output (in JSON format) - // should be stored. Currently, only Cloud Storage URIs are supported. - // These must be specified in the following format: - // `gs://bucket-id/object-id` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. + // should be stored. Currently, only Cloud Storage + // (https://cloud.google.com/storage/) URIs are supported. These must be + // specified in the following format: `gs://bucket-id/object-id` (other + // URI formats return google.rpc.Code.INVALID_ARGUMENT). For more + // information, see Request URIs + // (https://cloud.google.com/storage/docs/request-endpoints). OutputUri string `json:"outputUri,omitempty"` // VideoContext: Additional video context and/or feature-specific @@ -1855,7 +1862,8 @@ type GoogleCloudVideointelligenceV1beta2Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2817,7 +2825,8 @@ type GoogleCloudVideointelligenceV1beta2SpeechContext struct { // them. This can be used to improve the accuracy for specific words and // phrases, for example, if specific commands are typically spoken by // the user. This can also be used to add additional words to the - // vocabulary of the recognizer. See usage limits. + // vocabulary of the recognizer. See usage limits + // (https://cloud.google.com/speech/limits#content). Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -2909,9 +2918,10 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1beta2SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -2981,8 +2991,10 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscriptionConfig struct { FilterProfanity bool `json:"filterProfanity,omitempty"` // LanguageCode: Required. *Required* The language of the supplied audio - // as a BCP-47 language tag. Example: "en-US". See Language Support for - // a list of the currently supported language codes. + // as a BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language + // tag. Example: "en-US". See Language Support + // (https://cloud.google.com/speech/docs/languages) for a list of the + // currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Optional. Maximum number of recognition hypotheses @@ -3297,7 +3309,8 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -3358,7 +3371,8 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1beta2LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3780,7 +3794,8 @@ type GoogleCloudVideointelligenceV1p1beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4547,9 +4562,10 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p1beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -4815,7 +4831,8 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4876,7 +4893,8 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p1beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -5240,7 +5258,8 @@ type GoogleCloudVideointelligenceV1p2beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -6007,9 +6026,10 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p2beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -6275,7 +6295,8 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6336,7 +6357,8 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p2beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6806,7 +6828,8 @@ type GoogleCloudVideointelligenceV1p3beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7619,9 +7642,10 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p3beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -7976,7 +8000,8 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8040,7 +8065,8 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p3beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8291,10 +8317,11 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/videointelligence/v1p1beta1/videointelligence-gen.go b/videointelligence/v1p1beta1/videointelligence-gen.go index 169b1fa3e49..2f651d35534 100644 --- a/videointelligence/v1p1beta1/videointelligence-gen.go +++ b/videointelligence/v1p1beta1/videointelligence-gen.go @@ -324,7 +324,8 @@ type GoogleCloudVideointelligenceV1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1087,9 +1088,10 @@ type GoogleCloudVideointelligenceV1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1354,7 +1356,8 @@ type GoogleCloudVideointelligenceV1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1415,7 +1418,8 @@ type GoogleCloudVideointelligenceV1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1779,7 +1783,8 @@ type GoogleCloudVideointelligenceV1beta2Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2544,9 +2549,10 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1beta2SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -2812,7 +2818,8 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -2873,7 +2880,8 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1beta2LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3115,15 +3123,17 @@ type GoogleCloudVideointelligenceV1p1beta1AnnotateVideoRequest struct { // unset. InputContent string `json:"inputContent,omitempty"` - // InputUri: Input video location. Currently, only Cloud Storage URIs - // are supported. URIs must be specified in the following format: - // `gs://bucket-id/object-id` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. To identify multiple videos, a video URI may include wildcards - // in the `object-id`. Supported wildcards: '*' to match 0 or more - // characters; '?' to match 1 character. If unset, the input video - // should be embedded in the request as `input_content`. If set, - // `input_content` must be unset. + // InputUri: Input video location. Currently, only Cloud Storage + // (https://cloud.google.com/storage/) URIs are supported. URIs must be + // specified in the following format: `gs://bucket-id/object-id` (other + // URI formats return google.rpc.Code.INVALID_ARGUMENT). For more + // information, see Request URIs + // (https://cloud.google.com/storage/docs/request-endpoints). To + // identify multiple videos, a video URI may include wildcards in the + // `object-id`. Supported wildcards: '*' to match 0 or more characters; + // '?' to match 1 character. If unset, the input video should be + // embedded in the request as `input_content`. If set, `input_content` + // must be unset. InputUri string `json:"inputUri,omitempty"` // LocationId: Optional. Cloud region where annotation should take @@ -3133,11 +3143,12 @@ type GoogleCloudVideointelligenceV1p1beta1AnnotateVideoRequest struct { LocationId string `json:"locationId,omitempty"` // OutputUri: Optional. Location where the output (in JSON format) - // should be stored. Currently, only Cloud Storage URIs are supported. - // These must be specified in the following format: - // `gs://bucket-id/object-id` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. + // should be stored. Currently, only Cloud Storage + // (https://cloud.google.com/storage/) URIs are supported. These must be + // specified in the following format: `gs://bucket-id/object-id` (other + // URI formats return google.rpc.Code.INVALID_ARGUMENT). For more + // information, see Request URIs + // (https://cloud.google.com/storage/docs/request-endpoints). OutputUri string `json:"outputUri,omitempty"` // VideoContext: Additional video context and/or feature-specific @@ -3313,7 +3324,8 @@ type GoogleCloudVideointelligenceV1p1beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4277,7 +4289,8 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechContext struct { // them. This can be used to improve the accuracy for specific words and // phrases, for example, if specific commands are typically spoken by // the user. This can also be used to add additional words to the - // vocabulary of the recognizer. See usage limits. + // vocabulary of the recognizer. See usage limits + // (https://cloud.google.com/speech/limits#content). Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -4369,9 +4382,10 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p1beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -4441,8 +4455,10 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscriptionConfig struct { FilterProfanity bool `json:"filterProfanity,omitempty"` // LanguageCode: Required. *Required* The language of the supplied audio - // as a BCP-47 language tag. Example: "en-US". See Language Support for - // a list of the currently supported language codes. + // as a BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language + // tag. Example: "en-US". See Language Support + // (https://cloud.google.com/speech/docs/languages) for a list of the + // currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Optional. Maximum number of recognition hypotheses @@ -4757,7 +4773,8 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4818,7 +4835,8 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p1beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -5240,7 +5258,8 @@ type GoogleCloudVideointelligenceV1p2beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -6007,9 +6026,10 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p2beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -6275,7 +6295,8 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6336,7 +6357,8 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p2beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6806,7 +6828,8 @@ type GoogleCloudVideointelligenceV1p3beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7619,9 +7642,10 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p3beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -7976,7 +8000,8 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8040,7 +8065,8 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p3beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8291,10 +8317,11 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/videointelligence/v1p2beta1/videointelligence-gen.go b/videointelligence/v1p2beta1/videointelligence-gen.go index 003300a19f9..40a26812036 100644 --- a/videointelligence/v1p2beta1/videointelligence-gen.go +++ b/videointelligence/v1p2beta1/videointelligence-gen.go @@ -324,7 +324,8 @@ type GoogleCloudVideointelligenceV1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1087,9 +1088,10 @@ type GoogleCloudVideointelligenceV1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1354,7 +1356,8 @@ type GoogleCloudVideointelligenceV1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1415,7 +1418,8 @@ type GoogleCloudVideointelligenceV1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1779,7 +1783,8 @@ type GoogleCloudVideointelligenceV1beta2Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2544,9 +2549,10 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1beta2SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -2812,7 +2818,8 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -2873,7 +2880,8 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1beta2LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3237,7 +3245,8 @@ type GoogleCloudVideointelligenceV1p1beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4004,9 +4013,10 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p1beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -4272,7 +4282,8 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4333,7 +4344,8 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p1beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -4575,15 +4587,17 @@ type GoogleCloudVideointelligenceV1p2beta1AnnotateVideoRequest struct { // unset. InputContent string `json:"inputContent,omitempty"` - // InputUri: Input video location. Currently, only Cloud Storage URIs - // are supported. URIs must be specified in the following format: - // `gs://bucket-id/object-id` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. To identify multiple videos, a video URI may include wildcards - // in the `object-id`. Supported wildcards: '*' to match 0 or more - // characters; '?' to match 1 character. If unset, the input video - // should be embedded in the request as `input_content`. If set, - // `input_content` must be unset. + // InputUri: Input video location. Currently, only Cloud Storage + // (https://cloud.google.com/storage/) URIs are supported. URIs must be + // specified in the following format: `gs://bucket-id/object-id` (other + // URI formats return google.rpc.Code.INVALID_ARGUMENT). For more + // information, see Request URIs + // (https://cloud.google.com/storage/docs/request-endpoints). To + // identify multiple videos, a video URI may include wildcards in the + // `object-id`. Supported wildcards: '*' to match 0 or more characters; + // '?' to match 1 character. If unset, the input video should be + // embedded in the request as `input_content`. If set, `input_content` + // must be unset. InputUri string `json:"inputUri,omitempty"` // LocationId: Optional. Cloud region where annotation should take @@ -4593,11 +4607,12 @@ type GoogleCloudVideointelligenceV1p2beta1AnnotateVideoRequest struct { LocationId string `json:"locationId,omitempty"` // OutputUri: Optional. Location where the output (in JSON format) - // should be stored. Currently, only Cloud Storage URIs are supported. - // These must be specified in the following format: - // `gs://bucket-id/object-id` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. + // should be stored. Currently, only Cloud Storage + // (https://cloud.google.com/storage/) URIs are supported. These must be + // specified in the following format: `gs://bucket-id/object-id` (other + // URI formats return google.rpc.Code.INVALID_ARGUMENT). For more + // information, see Request URIs + // (https://cloud.google.com/storage/docs/request-endpoints). OutputUri string `json:"outputUri,omitempty"` // VideoContext: Additional video context and/or feature-specific @@ -4773,7 +4788,8 @@ type GoogleCloudVideointelligenceV1p2beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -5737,7 +5753,8 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechContext struct { // them. This can be used to improve the accuracy for specific words and // phrases, for example, if specific commands are typically spoken by // the user. This can also be used to add additional words to the - // vocabulary of the recognizer. See usage limits. + // vocabulary of the recognizer. See usage limits + // (https://cloud.google.com/speech/limits#content). Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -5829,9 +5846,10 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p2beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -5901,8 +5919,10 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscriptionConfig struct { FilterProfanity bool `json:"filterProfanity,omitempty"` // LanguageCode: Required. *Required* The language of the supplied audio - // as a BCP-47 language tag. Example: "en-US". See Language Support for - // a list of the currently supported language codes. + // as a BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language + // tag. Example: "en-US". See Language Support + // (https://cloud.google.com/speech/docs/languages) for a list of the + // currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Optional. Maximum number of recognition hypotheses @@ -6217,7 +6237,8 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6278,7 +6299,8 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p2beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6806,7 +6828,8 @@ type GoogleCloudVideointelligenceV1p3beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7619,9 +7642,10 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p3beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -7976,7 +8000,8 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8040,7 +8065,8 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p3beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8291,10 +8317,11 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/videointelligence/v1p3beta1/videointelligence-gen.go b/videointelligence/v1p3beta1/videointelligence-gen.go index 4c9682a7614..876e441409e 100644 --- a/videointelligence/v1p3beta1/videointelligence-gen.go +++ b/videointelligence/v1p3beta1/videointelligence-gen.go @@ -324,7 +324,8 @@ type GoogleCloudVideointelligenceV1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1087,9 +1088,10 @@ type GoogleCloudVideointelligenceV1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -1354,7 +1356,8 @@ type GoogleCloudVideointelligenceV1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1415,7 +1418,8 @@ type GoogleCloudVideointelligenceV1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1779,7 +1783,8 @@ type GoogleCloudVideointelligenceV1beta2Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2544,9 +2549,10 @@ type GoogleCloudVideointelligenceV1beta2SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1beta2SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -2812,7 +2818,8 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -2873,7 +2880,8 @@ type GoogleCloudVideointelligenceV1beta2VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1beta2LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3237,7 +3245,8 @@ type GoogleCloudVideointelligenceV1p1beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4004,9 +4013,10 @@ type GoogleCloudVideointelligenceV1p1beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p1beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -4272,7 +4282,8 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4333,7 +4344,8 @@ type GoogleCloudVideointelligenceV1p1beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p1beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -4697,7 +4709,8 @@ type GoogleCloudVideointelligenceV1p2beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -5464,9 +5477,10 @@ type GoogleCloudVideointelligenceV1p2beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p2beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -5732,7 +5746,8 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -5793,7 +5808,8 @@ type GoogleCloudVideointelligenceV1p2beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p2beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6036,15 +6052,17 @@ type GoogleCloudVideointelligenceV1p3beta1AnnotateVideoRequest struct { // unset. InputContent string `json:"inputContent,omitempty"` - // InputUri: Input video location. Currently, only Cloud Storage URIs - // are supported. URIs must be specified in the following format: - // `gs://bucket-id/object-id` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. To identify multiple videos, a video URI may include wildcards - // in the `object-id`. Supported wildcards: '*' to match 0 or more - // characters; '?' to match 1 character. If unset, the input video - // should be embedded in the request as `input_content`. If set, - // `input_content` must be unset. + // InputUri: Input video location. Currently, only Cloud Storage + // (https://cloud.google.com/storage/) URIs are supported. URIs must be + // specified in the following format: `gs://bucket-id/object-id` (other + // URI formats return google.rpc.Code.INVALID_ARGUMENT). For more + // information, see Request URIs + // (https://cloud.google.com/storage/docs/request-endpoints). To + // identify multiple videos, a video URI may include wildcards in the + // `object-id`. Supported wildcards: '*' to match 0 or more characters; + // '?' to match 1 character. If unset, the input video should be + // embedded in the request as `input_content`. If set, `input_content` + // must be unset. InputUri string `json:"inputUri,omitempty"` // LocationId: Optional. Cloud region where annotation should take @@ -6054,11 +6072,12 @@ type GoogleCloudVideointelligenceV1p3beta1AnnotateVideoRequest struct { LocationId string `json:"locationId,omitempty"` // OutputUri: Optional. Location where the output (in JSON format) - // should be stored. Currently, only Cloud Storage URIs are supported. - // These must be specified in the following format: - // `gs://bucket-id/object-id` (other URI formats return - // google.rpc.Code.INVALID_ARGUMENT). For more information, see Request - // URIs. + // should be stored. Currently, only Cloud Storage + // (https://cloud.google.com/storage/) URIs are supported. These must be + // specified in the following format: `gs://bucket-id/object-id` (other + // URI formats return google.rpc.Code.INVALID_ARGUMENT). For more + // information, see Request URIs + // (https://cloud.google.com/storage/docs/request-endpoints). OutputUri string `json:"outputUri,omitempty"` // VideoContext: Additional video context and/or feature-specific @@ -6340,7 +6359,8 @@ type GoogleCloudVideointelligenceV1p3beta1Entity struct { Description string `json:"description,omitempty"` // EntityId: Opaque entity ID. Some IDs may be available in Google - // Knowledge Graph Search API. + // Knowledge Graph Search API + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7350,7 +7370,8 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechContext struct { // them. This can be used to improve the accuracy for specific words and // phrases, for example, if specific commands are typically spoken by // the user. This can also be used to add additional words to the - // vocabulary of the recognizer. See usage limits. + // vocabulary of the recognizer. See usage limits + // (https://cloud.google.com/speech/limits#content). Phrases []string `json:"phrases,omitempty"` // ForceSendFields is a list of field names (e.g. "Phrases") to @@ -7442,9 +7463,10 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscription struct { // the most probable, as ranked by the recognizer. Alternatives []*GoogleCloudVideointelligenceV1p3beta1SpeechRecognitionAlternative `json:"alternatives,omitempty"` - // LanguageCode: Output only. The BCP-47 language tag of the language in - // this result. This language code was detected to have the most - // likelihood of being spoken in the audio. + // LanguageCode: Output only. The BCP-47 + // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the + // language in this result. This language code was detected to have the + // most likelihood of being spoken in the audio. LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Alternatives") to @@ -7514,8 +7536,10 @@ type GoogleCloudVideointelligenceV1p3beta1SpeechTranscriptionConfig struct { FilterProfanity bool `json:"filterProfanity,omitempty"` // LanguageCode: Required. *Required* The language of the supplied audio - // as a BCP-47 language tag. Example: "en-US". See Language Support for - // a list of the currently supported language codes. + // as a BCP-47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language + // tag. Example: "en-US". See Language Support + // (https://cloud.google.com/speech/docs/languages) for a list of the + // currently supported language codes. LanguageCode string `json:"languageCode,omitempty"` // MaxAlternatives: Optional. Maximum number of recognition hypotheses @@ -7919,7 +7943,8 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationProgress struct { // "PERSON_DETECTION" - Person detection. Feature string `json:"feature,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -7983,7 +8008,8 @@ type GoogleCloudVideointelligenceV1p3beta1VideoAnnotationResults struct { // exactly one element for each unique label. FrameLabelAnnotations []*GoogleCloudVideointelligenceV1p3beta1LabelAnnotation `json:"frameLabelAnnotations,omitempty"` - // InputUri: Video file location in Cloud Storage. + // InputUri: Video file location in Cloud Storage + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8292,10 +8318,11 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // GoogleRpcStatus: The `Status` type defines a logical error model that // is suitable for different programming environments, including REST -// APIs and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type GoogleRpcStatus struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/vision/v1/vision-gen.go b/vision/v1/vision-gen.go index 9a5b90a3827..617f46e625d 100644 --- a/vision/v1/vision-gen.go +++ b/vision/v1/vision-gen.go @@ -1539,7 +1539,7 @@ type EntityAnnotation struct { Locations []*LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -2383,7 +2383,7 @@ type GoogleCloudVisionV1p1beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p1beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -4683,7 +4683,7 @@ type GoogleCloudVisionV1p2beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p2beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -7034,7 +7034,7 @@ type GoogleCloudVisionV1p3beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p3beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -9567,7 +9567,7 @@ type GoogleCloudVisionV1p4beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p4beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -11642,7 +11642,8 @@ type ImageContext struct { // the language of the text in the image is known, setting a hint will // help get better results (although it will be a significant hindrance // if the hint is wrong). Text detection returns an error if one or more - // of the specified languages is not one of the supported languages. + // of the specified languages is not one of the supported languages + // (https://cloud.google.com/vision/docs/languages). LanguageHints []string `json:"languageHints,omitempty"` // LatLongRect: Not used. @@ -11712,20 +11713,22 @@ func (s *ImageProperties) MarshalJSON() ([]byte, error) { type ImageSource struct { // GcsImageUri: **Use `image_uri` instead.** The Google Cloud Storage // URI of the form `gs://bucket_name/object_name`. Object versioning is - // not supported. See Google Cloud Storage Request URIs for more info. + // not supported. See Google Cloud Storage Request URIs + // (https://cloud.google.com/storage/docs/reference-uris) for more info. GcsImageUri string `json:"gcsImageUri,omitempty"` // ImageUri: The URI of the source image. Can be either: 1. A Google // Cloud Storage URI of the form `gs://bucket_name/object_name`. Object // versioning is not supported. See Google Cloud Storage Request URIs - // for more info. 2. A publicly-accessible image HTTP/HTTPS URL. When - // fetching images from HTTP/HTTPS URLs, Google cannot guarantee that - // the request will be completed. Your request may fail if the specified - // host denies the request (e.g. due to request throttling or DOS - // prevention), or if Google throttles requests to the site for abuse - // prevention. You should not depend on externally-hosted images for - // production applications. When both `gcs_image_uri` and `image_uri` - // are specified, `image_uri` takes precedence. + // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // 2. A publicly-accessible image HTTP/HTTPS URL. When fetching images + // from HTTP/HTTPS URLs, Google cannot guarantee that the request will + // be completed. Your request may fail if the specified host denies the + // request (e.g. due to request throttling or DOS prevention), or if + // Google throttles requests to the site for abuse prevention. You + // should not depend on externally-hosted images for production + // applications. When both `gcs_image_uri` and `image_uri` are + // specified, `image_uri` takes precedence. ImageUri string `json:"imageUri,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsImageUri") to @@ -13363,10 +13366,11 @@ func (s *SafeSearchAnnotation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/vision/v1p1beta1/vision-gen.go b/vision/v1p1beta1/vision-gen.go index 468b7a84bfd..73f00e0025f 100644 --- a/vision/v1p1beta1/vision-gen.go +++ b/vision/v1p1beta1/vision-gen.go @@ -1035,7 +1035,7 @@ type EntityAnnotation struct { Locations []*LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -2201,7 +2201,7 @@ type GoogleCloudVisionV1p1beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p1beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -2722,7 +2722,8 @@ type GoogleCloudVisionV1p1beta1ImageContext struct { // the language of the text in the image is known, setting a hint will // help get better results (although it will be a significant hindrance // if the hint is wrong). Text detection returns an error if one or more - // of the specified languages is not one of the supported languages. + // of the specified languages is not one of the supported languages + // (https://cloud.google.com/vision/docs/languages). LanguageHints []string `json:"languageHints,omitempty"` // LatLongRect: Not used. @@ -2793,20 +2794,22 @@ func (s *GoogleCloudVisionV1p1beta1ImageProperties) MarshalJSON() ([]byte, error type GoogleCloudVisionV1p1beta1ImageSource struct { // GcsImageUri: **Use `image_uri` instead.** The Google Cloud Storage // URI of the form `gs://bucket_name/object_name`. Object versioning is - // not supported. See Google Cloud Storage Request URIs for more info. + // not supported. See Google Cloud Storage Request URIs + // (https://cloud.google.com/storage/docs/reference-uris) for more info. GcsImageUri string `json:"gcsImageUri,omitempty"` // ImageUri: The URI of the source image. Can be either: 1. A Google // Cloud Storage URI of the form `gs://bucket_name/object_name`. Object // versioning is not supported. See Google Cloud Storage Request URIs - // for more info. 2. A publicly-accessible image HTTP/HTTPS URL. When - // fetching images from HTTP/HTTPS URLs, Google cannot guarantee that - // the request will be completed. Your request may fail if the specified - // host denies the request (e.g. due to request throttling or DOS - // prevention), or if Google throttles requests to the site for abuse - // prevention. You should not depend on externally-hosted images for - // production applications. When both `gcs_image_uri` and `image_uri` - // are specified, `image_uri` takes precedence. + // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // 2. A publicly-accessible image HTTP/HTTPS URL. When fetching images + // from HTTP/HTTPS URLs, Google cannot guarantee that the request will + // be completed. Your request may fail if the specified host denies the + // request (e.g. due to request throttling or DOS prevention), or if + // Google throttles requests to the site for abuse prevention. You + // should not depend on externally-hosted images for production + // applications. When both `gcs_image_uri` and `image_uri` are + // specified, `image_uri` takes precedence. ImageUri string `json:"imageUri,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsImageUri") to @@ -4812,7 +4815,7 @@ type GoogleCloudVisionV1p2beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p2beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -7163,7 +7166,7 @@ type GoogleCloudVisionV1p3beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p3beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -9696,7 +9699,7 @@ type GoogleCloudVisionV1p4beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p4beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -12804,10 +12807,11 @@ func (s *SafeSearchAnnotation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/vision/v1p2beta1/vision-gen.go b/vision/v1p2beta1/vision-gen.go index 8e427855748..dda844c71d2 100644 --- a/vision/v1p2beta1/vision-gen.go +++ b/vision/v1p2beta1/vision-gen.go @@ -1035,7 +1035,7 @@ type EntityAnnotation struct { Locations []*LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -1819,7 +1819,7 @@ type GoogleCloudVisionV1p1beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p1beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -4501,7 +4501,7 @@ type GoogleCloudVisionV1p2beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p2beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -5022,7 +5022,8 @@ type GoogleCloudVisionV1p2beta1ImageContext struct { // the language of the text in the image is known, setting a hint will // help get better results (although it will be a significant hindrance // if the hint is wrong). Text detection returns an error if one or more - // of the specified languages is not one of the supported languages. + // of the specified languages is not one of the supported languages + // (https://cloud.google.com/vision/docs/languages). LanguageHints []string `json:"languageHints,omitempty"` // LatLongRect: Not used. @@ -5093,20 +5094,22 @@ func (s *GoogleCloudVisionV1p2beta1ImageProperties) MarshalJSON() ([]byte, error type GoogleCloudVisionV1p2beta1ImageSource struct { // GcsImageUri: **Use `image_uri` instead.** The Google Cloud Storage // URI of the form `gs://bucket_name/object_name`. Object versioning is - // not supported. See Google Cloud Storage Request URIs for more info. + // not supported. See Google Cloud Storage Request URIs + // (https://cloud.google.com/storage/docs/reference-uris) for more info. GcsImageUri string `json:"gcsImageUri,omitempty"` // ImageUri: The URI of the source image. Can be either: 1. A Google // Cloud Storage URI of the form `gs://bucket_name/object_name`. Object // versioning is not supported. See Google Cloud Storage Request URIs - // for more info. 2. A publicly-accessible image HTTP/HTTPS URL. When - // fetching images from HTTP/HTTPS URLs, Google cannot guarantee that - // the request will be completed. Your request may fail if the specified - // host denies the request (e.g. due to request throttling or DOS - // prevention), or if Google throttles requests to the site for abuse - // prevention. You should not depend on externally-hosted images for - // production applications. When both `gcs_image_uri` and `image_uri` - // are specified, `image_uri` takes precedence. + // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // 2. A publicly-accessible image HTTP/HTTPS URL. When fetching images + // from HTTP/HTTPS URLs, Google cannot guarantee that the request will + // be completed. Your request may fail if the specified host denies the + // request (e.g. due to request throttling or DOS prevention), or if + // Google throttles requests to the site for abuse prevention. You + // should not depend on externally-hosted images for production + // applications. When both `gcs_image_uri` and `image_uri` are + // specified, `image_uri` takes precedence. ImageUri string `json:"imageUri,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsImageUri") to @@ -7163,7 +7166,7 @@ type GoogleCloudVisionV1p3beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p3beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -9696,7 +9699,7 @@ type GoogleCloudVisionV1p4beta1EntityAnnotation struct { Locations []*GoogleCloudVisionV1p4beta1LocationInfo `json:"locations,omitempty"` // Mid: Opaque entity ID. Some IDs may be available in Google Knowledge - // Graph Search API. + // Graph Search API (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -12804,10 +12807,11 @@ func (s *SafeSearchAnnotation) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/workflowexecutions/v1beta/workflowexecutions-gen.go b/workflowexecutions/v1beta/workflowexecutions-gen.go index adc7dba820d..4a1d2e55e0d 100644 --- a/workflowexecutions/v1beta/workflowexecutions-gen.go +++ b/workflowexecutions/v1beta/workflowexecutions-gen.go @@ -217,7 +217,8 @@ func (s *Error) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Execution: A running instance of a Workflow. +// Execution: A running instance of a Workflow +// (/workflows/docs/reference/rest/v1beta/projects.locations.workflows). type Execution struct { // Argument: Input parameters of the execution represented as a JSON // string. The size limit is 32KB. diff --git a/workflows/v1beta/workflows-gen.go b/workflows/v1beta/workflows-gen.go index d0c4f7db923..c545f8d1e3e 100644 --- a/workflows/v1beta/workflows-gen.go +++ b/workflows/v1beta/workflows-gen.go @@ -461,10 +461,11 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by gRPC. Each `Status` message contains -// three pieces of data: error code, error message, and error details. -// You can find out more about this error model and how to work with it -// in the API Design Guide. +// and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. diff --git a/youtubeanalytics/v2/youtubeanalytics-gen.go b/youtubeanalytics/v2/youtubeanalytics-gen.go index 397433547b6..2e2d30b6145 100644 --- a/youtubeanalytics/v2/youtubeanalytics-gen.go +++ b/youtubeanalytics/v2/youtubeanalytics-gen.go @@ -1918,9 +1918,11 @@ func (c *ReportsQueryCall) Currency(currency string) *ReportsQueryCall { // Dimensions sets the optional parameter "dimensions": A // comma-separated list of YouTube Analytics dimensions, such as `views` -// or `ageGroup,gender`. See the Available Reports document for a list -// of the reports that you can retrieve and the dimensions used for -// those reports. Also see the Dimensions document for definitions of +// or `ageGroup,gender`. See the Available Reports +// (/youtube/analytics/v2/available_reports) document for a list of the +// reports that you can retrieve and the dimensions used for those +// reports. Also see the Dimensions +// (/youtube/analytics/v2/dimsmets/dims) document for definitions of // those dimensions." pattern: [0-9a-zA-Z,]+ func (c *ReportsQueryCall) Dimensions(dimensions string) *ReportsQueryCall { c.urlParams_.Set("dimensions", dimensions) @@ -1937,11 +1939,12 @@ func (c *ReportsQueryCall) EndDate(endDate string) *ReportsQueryCall { // Filters sets the optional parameter "filters": A list of filters that // should be applied when retrieving YouTube Analytics data. The -// Available Reports document identifies the dimensions that can be used -// to filter each report, and the Dimensions document defines those -// dimensions. If a request uses multiple filters, join them together -// with a semicolon (`;`), and the returned result table will satisfy -// both filters. For example, a filters parameter value of +// Available Reports (/youtube/analytics/v2/available_reports) document +// identifies the dimensions that can be used to filter each report, and +// the Dimensions (/youtube/analytics/v2/dimsmets/dims) document defines +// those dimensions. If a request uses multiple filters, join them +// together with a semicolon (`;`), and the returned result table will +// satisfy both filters. For example, a filters parameter value of // `video==dMH0bHeiRNg;country==IT` restricts the result set to include // data for the given video in Italy.", func (c *ReportsQueryCall) Filters(filters string) *ReportsQueryCall { @@ -1980,10 +1983,11 @@ func (c *ReportsQueryCall) MaxResults(maxResults int64) *ReportsQueryCall { // Metrics sets the optional parameter "metrics": A comma-separated list // of YouTube Analytics metrics, such as `views` or `likes,dislikes`. -// See the Available Reports document for a list of the reports that you -// can retrieve and the metrics available in each report, and see the -// Metrics document for definitions of those metrics. required: true, -// pattern: [0-9a-zA-Z,]+ +// See the Available Reports (/youtube/analytics/v2/available_reports) +// document for a list of the reports that you can retrieve and the +// metrics available in each report, and see the Metrics +// (/youtube/analytics/v2/dimsmets/mets) document for definitions of +// those metrics. required: true, pattern: [0-9a-zA-Z,]+ func (c *ReportsQueryCall) Metrics(metrics string) *ReportsQueryCall { c.urlParams_.Set("metrics", metrics) return c From 3c7ab50730fbe03fb961ae1037d45bf26288b84b Mon Sep 17 00:00:00 2001 From: Cody Oss Date: Mon, 11 Jan 2021 11:02:52 -0700 Subject: [PATCH 3/4] fix issue where links would split across lines --- accessapproval/v1/accessapproval-gen.go | 15 +- .../v1/accesscontextmanager-gen.go | 9 +- .../v2beta1/adexchangebuyer2-gen.go | 15 +- admin/directory/v1/admin-gen.go | 18 +- admin/reports/v1/admin-gen.go | 21 +- alertcenter/v1beta1/alertcenter-gen.go | 3 +- analyticsdata/v1alpha/analyticsdata-gen.go | 51 +-- .../v4/analyticsreporting-gen.go | 6 +- androidmanagement/v1/androidmanagement-gen.go | 15 +- androidpublisher/v3/androidpublisher-gen.go | 31 +- apigateway/v1/apigateway-gen.go | 13 +- apigateway/v1beta/apigateway-gen.go | 21 +- apigee/v1/apigee-gen.go | 61 ++- appengine/v1/appengine-gen.go | 109 ++--- appengine/v1beta/appengine-gen.go | 103 ++--- appengine/v1beta4/appengine-gen.go | 60 ++- appengine/v1beta5/appengine-gen.go | 60 ++- bigquery/v2/bigquery-gen.go | 23 +- .../v1/bigquerydatatransfer-gen.go | 48 +- billingbudgets/v1/billingbudgets-gen.go | 16 +- billingbudgets/v1beta1/billingbudgets-gen.go | 16 +- classroom/v1/classroom-gen.go | 3 +- cloudasset/v1/cloudasset-gen.go | 152 +++---- cloudasset/v1beta1/cloudasset-gen.go | 46 +- cloudasset/v1p1beta1/cloudasset-gen.go | 12 +- cloudasset/v1p4beta1/cloudasset-gen.go | 14 +- cloudasset/v1p5beta1/cloudasset-gen.go | 40 +- .../v1beta1/clouderrorreporting-gen.go | 13 +- cloudidentity/v1/cloudidentity-gen.go | 11 +- cloudidentity/v1beta1/cloudidentity-gen.go | 11 +- cloudscheduler/v1/cloudscheduler-gen.go | 60 ++- cloudscheduler/v1beta1/cloudscheduler-gen.go | 60 ++- cloudsearch/v1/cloudsearch-gen.go | 19 +- cloudtasks/v2/cloudtasks-gen.go | 167 ++++--- cloudtasks/v2beta2/cloudtasks-gen.go | 155 +++---- cloudtasks/v2beta3/cloudtasks-gen.go | 178 ++++---- cloudtrace/v2beta1/cloudtrace-gen.go | 4 +- composer/v1beta1/composer-gen.go | 4 +- compute/v0.alpha/compute-gen.go | 84 ++-- compute/v0.beta/compute-gen.go | 76 +++- compute/v1/compute-gen.go | 50 ++- container/v1/container-gen.go | 96 ++-- container/v1beta1/container-gen.go | 104 +++-- .../v1alpha1/containeranalysis-gen.go | 8 +- .../v1beta1/containeranalysis-gen.go | 10 +- content/v2.1/content-gen.go | 4 +- customsearch/v1/customsearch-gen.go | 297 ++++++------- datacatalog/v1beta1/datacatalog-gen.go | 75 ++-- dataflow/v1b3/dataflow-gen.go | 13 +- datamigration/v1beta1/datamigration-gen.go | 6 +- dataproc/v1/dataproc-gen.go | 181 ++++---- dataproc/v1beta2/dataproc-gen.go | 173 ++++---- datastore/v1/datastore-gen.go | 6 +- datastore/v1beta3/datastore-gen.go | 6 +- dialogflow/v2/dialogflow-gen.go | 48 +- dialogflow/v2beta1/dialogflow-gen.go | 75 ++-- dialogflow/v3/dialogflow-gen.go | 6 +- dialogflow/v3beta1/dialogflow-gen.go | 6 +- digitalassetlinks/v1/digitalassetlinks-gen.go | 23 +- dlp/v2/dlp-gen.go | 54 +-- documentai/v1beta2/documentai-gen.go | 4 +- documentai/v1beta3/documentai-gen.go | 4 +- domains/v1alpha2/domains-gen.go | 4 +- domains/v1beta1/domains-gen.go | 4 +- eventarc/v1beta1/eventarc-gen.go | 15 +- fcm/v1/fcm-gen.go | 81 ++-- firebase/v1beta1/firebase-gen.go | 25 +- .../v1beta/firebasedatabase-gen.go | 5 +- .../v1/firebasedynamiclinks-gen.go | 15 +- genomics/v1alpha2/genomics-gen.go | 21 +- genomics/v2alpha1/genomics-gen.go | 5 +- google-api-go-generator/gen.go | 14 +- google-api-go-generator/gen_test.go | 15 +- .../testdata/http-body.want | 14 +- .../testdata/json-body.want | 77 ++-- .../testdata/resource-named-service.want | 71 +-- healthcare/v1/healthcare-gen.go | 290 ++++++------ healthcare/v1beta1/healthcare-gen.go | 413 ++++++++++-------- homegraph/v1/homegraph-gen.go | 47 +- iam/v1/iam-gen.go | 19 +- iap/v1/iap-gen.go | 5 +- jobs/v3/jobs-gen.go | 8 +- jobs/v3p1beta1/jobs-gen.go | 8 +- jobs/v4/jobs-gen.go | 8 +- lifesciences/v2beta/lifesciences-gen.go | 5 +- logging/v2/logging-gen.go | 7 +- .../v1alpha1/managedidentities-gen.go | 6 +- ml/v1/ml-gen.go | 70 ++- monitoring/v1/monitoring-gen.go | 8 +- monitoring/v3/monitoring-gen.go | 45 +- .../v1beta1/networkmanagement-gen.go | 6 +- notebooks/v1/notebooks-gen.go | 4 +- osconfig/v1/osconfig-gen.go | 13 +- osconfig/v1beta/osconfig-gen.go | 13 +- privateca/v1beta1/privateca-gen.go | 6 +- realtimebidding/v1/realtimebidding-gen.go | 42 +- .../v1beta1/recommendationengine-gen.go | 17 +- .../v1/remotebuildexecution-gen.go | 18 +- .../v1alpha/remotebuildexecution-gen.go | 25 +- .../v2/remotebuildexecution-gen.go | 18 +- run/v1/run-gen.go | 13 +- run/v1alpha1/run-gen.go | 36 +- run/v1beta1/run-gen.go | 12 +- searchconsole/v1/searchconsole-gen.go | 15 +- securitycenter/v1/securitycenter-gen.go | 47 +- securitycenter/v1beta1/securitycenter-gen.go | 60 ++- securitycenter/v1beta2/securitycenter-gen.go | 32 +- .../v1/serviceconsumermanagement-gen.go | 38 +- .../v1beta1/serviceconsumermanagement-gen.go | 38 +- servicecontrol/v1/servicecontrol-gen.go | 4 +- servicecontrol/v2/servicecontrol-gen.go | 10 +- servicemanagement/v1/servicemanagement-gen.go | 38 +- servicenetworking/v1/servicenetworking-gen.go | 38 +- .../v1beta/servicenetworking-gen.go | 38 +- serviceusage/v1/serviceusage-gen.go | 38 +- serviceusage/v1beta1/serviceusage-gen.go | 38 +- sheets/v4/sheets-gen.go | 11 +- slides/v1/slides-gen.go | 6 +- spanner/v1/spanner-gen.go | 5 +- storagetransfer/v1/storagetransfer-gen.go | 20 +- streetviewpublish/v1/streetviewpublish-gen.go | 22 +- sts/v1beta/sts-gen.go | 74 ++-- translate/v3/translate-gen.go | 6 +- translate/v3beta1/translate-gen.go | 6 +- youtube/v3/youtube-gen.go | 6 +- 125 files changed, 2624 insertions(+), 2566 deletions(-) diff --git a/accessapproval/v1/accessapproval-gen.go b/accessapproval/v1/accessapproval-gen.go index 9adb0296d42..05bd88e59e6 100644 --- a/accessapproval/v1/accessapproval-gen.go +++ b/accessapproval/v1/accessapproval-gen.go @@ -972,8 +972,9 @@ func (r *FoldersService) UpdateAccessApprovalSettings(name string, accessapprova // supported. For each field, if it is included, the currently stored // value will be entirely overwritten with the value of the field passed // in this request. For the `FieldMask` definition, see -// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If this field is left unset, only the notification_emails field will be -// updated. +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask +// If this field is left unset, only the notification_emails field will +// be updated. func (c *FoldersUpdateAccessApprovalSettingsCall) UpdateMask(updateMask string) *FoldersUpdateAccessApprovalSettingsCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -2057,8 +2058,9 @@ func (r *OrganizationsService) UpdateAccessApprovalSettings(name string, accessa // supported. For each field, if it is included, the currently stored // value will be entirely overwritten with the value of the field passed // in this request. For the `FieldMask` definition, see -// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If this field is left unset, only the notification_emails field will be -// updated. +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask +// If this field is left unset, only the notification_emails field will +// be updated. func (c *OrganizationsUpdateAccessApprovalSettingsCall) UpdateMask(updateMask string) *OrganizationsUpdateAccessApprovalSettingsCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -3142,8 +3144,9 @@ func (r *ProjectsService) UpdateAccessApprovalSettings(name string, accessapprov // supported. For each field, if it is included, the currently stored // value will be entirely overwritten with the value of the field passed // in this request. For the `FieldMask` definition, see -// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If this field is left unset, only the notification_emails field will be -// updated. +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask +// If this field is left unset, only the notification_emails field will +// be updated. func (c *ProjectsUpdateAccessApprovalSettingsCall) UpdateMask(updateMask string) *ProjectsUpdateAccessApprovalSettingsCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/accesscontextmanager/v1/accesscontextmanager-gen.go b/accesscontextmanager/v1/accesscontextmanager-gen.go index cc6ed1724cd..6918c98c9fa 100644 --- a/accesscontextmanager/v1/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1/accesscontextmanager-gen.go @@ -859,11 +859,10 @@ type GcpUserAccessBinding struct { // GroupKey: Required. Immutable. Google Group id whose members are // subject to this binding's restrictions. See "id" in the [G Suite // Directory API's Groups resource] - // (https://developers.google.com/admin-sdk/directory/v1/reference/groups - // #resource). If a group's email address/alias is changed, this - // resource will continue to point at the changed group. This field does - // not accept group email addresses or aliases. Example: - // "01d520gv4vjcrht" + // (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). + // If a group's email address/alias is changed, this resource will + // continue to point at the changed group. This field does not accept + // group email addresses or aliases. Example: "01d520gv4vjcrht" GroupKey string `json:"groupKey,omitempty"` // Name: Immutable. Assigned by the server during creation. The last diff --git a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go index b317956b315..498942cea30 100644 --- a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go +++ b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go @@ -978,8 +978,7 @@ func (s *Buyer) MarshalJSON() ([]byte, error) { type CalloutStatusRow struct { // CalloutStatusId: The ID of the callout status. See // callout-status-codes - // (https://developers.google.com/authorized-buyers/rtb/downloads/callout - // -status-codes). + // (https://developers.google.com/authorized-buyers/rtb/downloads/callout-status-codes). CalloutStatusId int64 `json:"calloutStatusId,omitempty"` // ImpressionCount: The number of impressions for which there was a bid @@ -1801,8 +1800,7 @@ type CreativeStatusRow struct { // CreativeStatusId: The ID of the creative status. See // creative-status-codes - // (https://developers.google.com/authorized-buyers/rtb/downloads/creativ - // e-status-codes). + // (https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes). CreativeStatusId int64 `json:"creativeStatusId,omitempty"` // RowDimensions: The values of all dimensions associated with metric @@ -2695,8 +2693,8 @@ type FilterSet struct { // filters represented by multiple seller network IDs are ORed together // (i.e., if non-empty, results must match any one of the publisher // networks). See seller-network-ids - // (https://developers.google.com/authorized-buyers/rtb/downloads/seller- - // network-ids) file for the set of existing seller network IDs. + // (https://developers.google.com/authorized-buyers/rtb/downloads/seller-network-ids) + // file for the set of existing seller network IDs. SellerNetworkIds []int64 `json:"sellerNetworkIds,omitempty"` // TimeSeriesGranularity: The granularity of time intervals if a time @@ -5084,9 +5082,8 @@ type ResumeProposalRequest struct { type RowDimensions struct { // PublisherIdentifier: The publisher identifier for this row, if a // breakdown by BreakdownDimension.PUBLISHER_IDENTIFIER - // (https://developers.google.com/authorized-buyers/apis/reference/rest/v - // 2beta1/bidders.accounts.filterSets#FilterSet.BreakdownDimension) was - // requested. + // (https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.BreakdownDimension) + // was requested. PublisherIdentifier string `json:"publisherIdentifier,omitempty"` // TimeInterval: The time interval that this row represents. diff --git a/admin/directory/v1/admin-gen.go b/admin/directory/v1/admin-gen.go index a96606b5696..7bb687361f8 100644 --- a/admin/directory/v1/admin-gen.go +++ b/admin/directory/v1/admin-gen.go @@ -1191,8 +1191,7 @@ type ChromeOsDevice struct { // `Dev`: The devices's developer hardware switch is enabled. When // booted, the device has a command line shell. For an example of a // developer switch, see the Chromebook developer information - // (http://www.chromium.org/chromium-os/developer-information-for-chrome- - // os-devices/samsung-series-5-chromebook#TOC-Developer-switch). + // (http://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch). BootMode string `json:"bootMode,omitempty"` // CpuStatusReports: Reports of CPU utilization and temperature @@ -2881,9 +2880,9 @@ type MobileDeviceApplications struct { // Permission: The list of permissions of this application. These can be // either a standard Android permission or one defined by the // application, and are found in an application's Android manifest - // (http://developer.android.com/guide/topics/manifest/uses-permission-el - // ement.html). Examples of a Calendar application's permissions are - // `READ_CALENDAR`, or `MANAGE_ACCOUNTS`. + // (http://developer.android.com/guide/topics/manifest/uses-permission-element.html). + // Examples of a Calendar application's permissions are `READ_CALENDAR`, + // or `MANAGE_ACCOUNTS`. Permission []string `json:"permission,omitempty"` // VersionCode: The application's version code. An example is `13`. @@ -2995,8 +2994,7 @@ type OrgUnit struct { // the nearest parent organizational unit. For more information on // inheritance and users in an organization structure, see the // administration help center - // (http://support.google.com/a/bin/answer.py?answer=182442&topic=1227584 - // &ctx=topic). + // (http://support.google.com/a/bin/answer.py?answer=182442&topic=1227584&ctx=topic). BlockInheritance bool `json:"blockInheritance,omitempty"` // Description: Description of the organizational unit. @@ -3028,9 +3026,9 @@ type OrgUnit struct { // is moved to a new organization, the user's access changes. For more // information about organization structures, see the administration // help center - // (http://support.google.com/a/bin/answer.py?answer=182433&topic=1227584 - // &ctx=topic). For more information about moving a user to a different - // organization, see Update a user + // (http://support.google.com/a/bin/answer.py?answer=182433&topic=1227584&ctx=topic). + // For more information about moving a user to a different organization, + // see Update a user // (/admin-sdk/directory/v1/guides/manage-users.html#update_user). OrgUnitPath string `json:"orgUnitPath,omitempty"` diff --git a/admin/reports/v1/admin-gen.go b/admin/reports/v1/admin-gen.go index dd62d370888..4657a41b3b8 100644 --- a/admin/reports/v1/admin-gen.go +++ b/admin/reports/v1/admin-gen.go @@ -2106,8 +2106,15 @@ func (c *EntityUsageReportsGetCall) CustomerId(customerId string) *EntityUsageRe // Filters are in the form `[application name]:parameter name[parameter // value],...`. In this example, the `<>` 'not equal to' operator is // URL-encoded in the request's query string (%3C%3E): GET -// https://www.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-01 ?parameters=gplus:community_name,gplus:num_total_members &filters=gplus:num_total_members%3C%3E0 The relational operators include: - `==` - 'equal to'. - `<>` - 'not equal to'. It is URL-encoded (%3C%3E). - `<` - 'less than'. It is URL-encoded (%3C). - `<=` - 'less than or equal to'. It is URL-encoded (%3C=). - `>` - 'greater than'. It is URL-encoded (%3E). - `>=` - 'greater than or equal to'. It is URL-encoded (%3E=). Filters can only be applied to numeric -// parameters. +// https://www.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-01 +// ?parameters=gplus:community_name,gplus:num_total_members +// &filters=gplus:num_total_members%3C%3E0 The relational operators +// include: - `==` - 'equal to'. - `<>` - 'not equal to'. It is +// URL-encoded (%3C%3E). - `<` - 'less than'. It is URL-encoded (%3C). - +// `<=` - 'less than or equal to'. It is URL-encoded (%3C=). - `>` - +// 'greater than'. It is URL-encoded (%3E). - `>=` - 'greater than or +// equal to'. It is URL-encoded (%3E=). Filters can only be applied to +// numeric parameters. func (c *EntityUsageReportsGetCall) Filters(filters string) *EntityUsageReportsGetCall { c.urlParams_.Set("filters", filters) return c @@ -2406,8 +2413,14 @@ func (c *UserUsageReportGetCall) CustomerId(customerId string) *UserUsageReportG // the form `[application name]:parameter name[parameter value],...`. In // this example, the `<>` 'not equal to' operator is URL-encoded in the // request's query string (%3C%3E): GET -// https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time &filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z The relational operators include: - `==` - 'equal to'. - `<>` - 'not equal to'. It is URL-encoded (%3C%3E). - `<` - 'less than'. It is URL-encoded (%3C). - `<=` - 'less than or equal to'. It is URL-encoded (%3C=). - `>` - 'greater than'. It is URL-encoded (%3E). - `>=` - 'greater than or equal to'. It is URL-encoded -// (%3E=). +// https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 +// ?parameters=accounts:last_login_time +// &filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z The +// relational operators include: - `==` - 'equal to'. - `<>` - 'not +// equal to'. It is URL-encoded (%3C%3E). - `<` - 'less than'. It is +// URL-encoded (%3C). - `<=` - 'less than or equal to'. It is +// URL-encoded (%3C=). - `>` - 'greater than'. It is URL-encoded (%3E). +// - `>=` - 'greater than or equal to'. It is URL-encoded (%3E=). func (c *UserUsageReportGetCall) Filters(filters string) *UserUsageReportGetCall { c.urlParams_.Set("filters", filters) return c diff --git a/alertcenter/v1beta1/alertcenter-gen.go b/alertcenter/v1beta1/alertcenter-gen.go index f8584172cb1..d434ff33b33 100644 --- a/alertcenter/v1beta1/alertcenter-gen.go +++ b/alertcenter/v1beta1/alertcenter-gen.go @@ -733,8 +733,7 @@ type CloudPubsubTopic struct { PayloadFormat string `json:"payloadFormat,omitempty"` // TopicName: The `name` field of a Cloud Pubsub [Topic] - // (https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topic - // s#Topic). + // (https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topics#Topic). TopicName string `json:"topicName,omitempty"` // ForceSendFields is a list of field names (e.g. "PayloadFormat") to diff --git a/analyticsdata/v1alpha/analyticsdata-gen.go b/analyticsdata/v1alpha/analyticsdata-gen.go index 750786b0d17..28bd7a2a602 100644 --- a/analyticsdata/v1alpha/analyticsdata-gen.go +++ b/analyticsdata/v1alpha/analyticsdata-gen.go @@ -454,13 +454,12 @@ func (s *CohortReportSettings) MarshalJSON() ([]byte, error) { // cohort is specified in the `cohort` object. Following that cohort for // the next six weeks is specified in the `cohortsRange` object. For // examples, see Cohort Report Examples -// (https://developers.google.com/analytics/devguides/reporting/data/v1/a -// dvanced#cohort_report_examples). The report response could show a -// weekly time series where say your app has retained 60% of this cohort -// after three weeks and 25% of this cohort after six weeks. These two -// percentages can be calculated by the metric -// `cohortActiveUsers/cohortTotalUsers` and will be separate rows in the -// report. +// (https://developers.google.com/analytics/devguides/reporting/data/v1/advanced#cohort_report_examples). +// The report response could show a weekly time series where say your +// app has retained 60% of this cohort after three weeks and 25% of this +// cohort after six weeks. These two percentages can be calculated by +// the metric `cohortActiveUsers/cohortTotalUsers` and will be separate +// rows in the report. type CohortSpec struct { // CohortReportSettings: Optional settings for a cohort report. CohortReportSettings *CohortReportSettings `json:"cohortReportSettings,omitempty"` @@ -664,13 +663,13 @@ type Dimension struct { DimensionExpression *DimensionExpression `json:"dimensionExpression,omitempty"` // Name: The name of the dimension. See the API Dimensions - // (https://developers.google.com/analytics/devguides/reporting/data/v1/a - // pi-schema#dimensions) for the list of dimension names. If - // `dimensionExpression` is specified, `name` can be any string that you - // would like. For example if a `dimensionExpression` concatenates - // `country` and `city`, you could call that dimension `countryAndCity`. - // Dimensions are referenced by `name` in `dimensionFilter`, `orderBys`, - // `dimensionExpression`, and `pivots`. + // (https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema#dimensions) + // for the list of dimension names. If `dimensionExpression` is + // specified, `name` can be any string that you would like. For example + // if a `dimensionExpression` concatenates `country` and `city`, you + // could call that dimension `countryAndCity`. Dimensions are referenced + // by `name` in `dimensionFilter`, `orderBys`, `dimensionExpression`, + // and `pivots`. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "DimensionExpression") @@ -891,8 +890,7 @@ func (s *DimensionValue) MarshalJSON() ([]byte, error) { type Entity struct { // PropertyId: A Google Analytics GA4 property id. To learn more, see // where to find your Property ID - // (https://developers.google.com/analytics/devguides/reporting/data/v1/p - // roperty-id). + // (https://developers.google.com/analytics/devguides/reporting/data/v1/property-id). PropertyId string `json:"propertyId,omitempty"` // ForceSendFields is a list of field names (e.g. "PropertyId") to @@ -1119,12 +1117,12 @@ type Metric struct { Invisible bool `json:"invisible,omitempty"` // Name: The name of the metric. See the API Metrics - // (https://developers.google.com/analytics/devguides/reporting/data/v1/a - // pi-schema#metrics) for the list of metric names. If `expression` is - // specified, `name` can be any string that you would like. For example - // if `expression` is `screenPageViews/sessions`, you could call that - // metric's name = `viewsPerSession`. Metrics are referenced by `name` - // in `metricFilter`, `orderBys`, and metric `expression`. + // (https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema#metrics) + // for the list of metric names. If `expression` is specified, `name` + // can be any string that you would like. For example if `expression` is + // `screenPageViews/sessions`, you could call that metric's name = + // `viewsPerSession`. Metrics are referenced by `name` in + // `metricFilter`, `orderBys`, and metric `expression`. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Expression") to @@ -2139,8 +2137,7 @@ type RunReportRequest struct { // Limit: The number of rows to return. If unspecified, 10 rows are // returned. If -1, all rows are returned. To learn more about this // pagination parameter, see Pagination - // (https://developers.google.com/analytics/devguides/reporting/data/v1/b - // asics#pagination). + // (https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination). Limit int64 `json:"limit,omitempty,string"` // MetricAggregations: Aggregation of metrics. Aggregated metric values @@ -2166,8 +2163,7 @@ type RunReportRequest struct { // Offset: The row count of the start row. The first row is counted as // row 0. To learn more about this pagination parameter, see Pagination - // (https://developers.google.com/analytics/devguides/reporting/data/v1/b - // asics#pagination). + // (https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination). Offset int64 `json:"offset,omitempty,string"` // OrderBys: Specifies how rows are ordered in the response. @@ -2231,8 +2227,7 @@ type RunReportResponse struct { // returns 175 rows and includes limit = 50 in the API request, the // response will contain row_count = 175 but only 50 rows. To learn more // about this pagination parameter, see Pagination - // (https://developers.google.com/analytics/devguides/reporting/data/v1/b - // asics#pagination). + // (https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination). RowCount int64 `json:"rowCount,omitempty"` // Rows: Rows of dimension value combinations and metric values in the diff --git a/analyticsreporting/v4/analyticsreporting-gen.go b/analyticsreporting/v4/analyticsreporting-gen.go index f04842c467a..94684e8b018 100644 --- a/analyticsreporting/v4/analyticsreporting-gen.go +++ b/analyticsreporting/v4/analyticsreporting-gen.go @@ -370,8 +370,7 @@ type CohortGroup struct { // time increment. - The cohort definition date ranges need not be // aligned to the calendar week and month boundaries. - The `viewId` // must be an app view ID - // (https://support.google.com/analytics/answer/2649553#WebVersusAppViews - // ) + // (https://support.google.com/analytics/answer/2649553#WebVersusAppViews) LifetimeValue bool `json:"lifetimeValue,omitempty"` // ForceSendFields is a list of field names (e.g. "Cohorts") to @@ -1739,8 +1738,7 @@ type ReportRequest struct { // `ga:browser` dimension which starts with Firefox; // `ga:browser=~^Firefox`. For more information on dimensions and metric // filters, see Filters reference - // (https://developers.google.com/analytics/devguides/reporting/core/v3/r - // eference#filters). + // (https://developers.google.com/analytics/devguides/reporting/core/v3/reference#filters). FiltersExpression string `json:"filtersExpression,omitempty"` // HideTotals: If set to true, hides the total of all metrics for all diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index 32d2383f09d..f24adcb71c1 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -718,9 +718,9 @@ type ApplicationReport struct { // SigningKeyCertFingerprints: The SHA-1 hash of each // android.content.pm.Signature - // (https://developer.android.com/reference/android/content/pm/Signature. - // html) associated with the app package. Each byte of each hash value - // is represented as a two-digit hexadecimal number. + // (https://developer.android.com/reference/android/content/pm/Signature.html) + // associated with the app package. Each byte of each hash value is + // represented as a two-digit hexadecimal number. SigningKeyCertFingerprints []string `json:"signingKeyCertFingerprints,omitempty"` // State: Application state. @@ -3877,9 +3877,9 @@ type SoftwareInfo struct { BootloaderVersion string `json:"bootloaderVersion,omitempty"` // DeviceBuildSignature: SHA-256 hash of android.content.pm.Signature - // (https://developer.android.com/reference/android/content/pm/Signature. - // html) associated with the system package, which can be used to verify - // that the system build hasn't been modified. + // (https://developer.android.com/reference/android/content/pm/Signature.html) + // associated with the system package, which can be used to verify that + // the system build hasn't been modified. DeviceBuildSignature string `json:"deviceBuildSignature,omitempty"` // DeviceKernelVersion: Kernel version, for example, 2.6.32.9-g103d848. @@ -4372,8 +4372,7 @@ type WebToken struct { // "STORE_BUILDER" - The organize apps page // (https://developers.google.com/android/management/apps#organize-apps). // "MANAGED_CONFIGURATIONS" - The managed configurations page - // (https://developers.google.com/android/management/managed-configuratio - // ns-iframe). + // (https://developers.google.com/android/management/managed-configurations-iframe). EnabledFeatures []string `json:"enabledFeatures,omitempty"` // Name: The name of the web token, which is generated by the server diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index f7497a8da8b..e06a03ea723 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -735,8 +735,7 @@ func (s *Comment) MarshalJSON() ([]byte, error) { // CountryTargeting: Country targeting specification. type CountryTargeting struct { // Countries: Countries to target, specified as two letter CLDR codes - // (https://unicode.org/cldr/charts/latest/supplemental/territory_contain - // ment_un_m_49.html). + // (https://unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html). Countries []string `json:"countries,omitempty"` // IncludeRestOfWorld: Include "rest of world" as well as explicitly @@ -1718,15 +1717,15 @@ type ProductPurchase struct { // ObfuscatedExternalAccountId: An obfuscated version of the id that is // uniquely associated with the user's account in your app. Only present // if specified using - // https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid when the purchase was - // made. + // https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid + // when the purchase was made. ObfuscatedExternalAccountId string `json:"obfuscatedExternalAccountId,omitempty"` // ObfuscatedExternalProfileId: An obfuscated version of the id that is // uniquely associated with the user's profile in your app. Only present // if specified using - // https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid when the purchase was - // made. + // https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid + // when the purchase was made. ObfuscatedExternalProfileId string `json:"obfuscatedExternalProfileId,omitempty"` // OrderId: The order id associated with the purchase of the inapp @@ -2201,15 +2200,15 @@ type SubscriptionPurchase struct { // uniquely associated with the user's account in your app. Present for // the following purchases: * If account linking happened as part of the // subscription purchase flow. * It was specified using - // https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid when the purchase was - // made. + // https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid + // when the purchase was made. ObfuscatedExternalAccountId string `json:"obfuscatedExternalAccountId,omitempty"` // ObfuscatedExternalProfileId: An obfuscated version of the id that is // uniquely associated with the user's profile in your app. Only present // if specified using - // https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid when the purchase was - // made. + // https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid + // when the purchase was made. ObfuscatedExternalProfileId string `json:"obfuscatedExternalProfileId,omitempty"` // OrderId: The order id of the latest recurring order associated with @@ -4314,8 +4313,8 @@ type EditsBundlesUploadCall struct { // using the Google API client libraries, please increase the timeout of // the http request before calling this endpoint (a timeout of 2 minutes // is recommended). See Timeouts and Errors -// (https://developers.google.com/api-client-library/java/google-api-java -// -client/errors) for an example in java. +// (https://developers.google.com/api-client-library/java/google-api-java-client/errors) +// for an example in java. func (r *EditsBundlesService) Upload(packageName string, editId string) *EditsBundlesUploadCall { c := &EditsBundlesUploadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.packageName = packageName @@ -9788,8 +9787,8 @@ type InternalappsharingartifactsUploadapkCall struct { // the Google API client libraries, please increase the timeout of the // http request before calling this endpoint (a timeout of 2 minutes is // recommended). See Timeouts and Errors -// (https://developers.google.com/api-client-library/java/google-api-java -// -client/errors) for an example in java. +// (https://developers.google.com/api-client-library/java/google-api-java-client/errors) +// for an example in java. func (r *InternalappsharingartifactsService) Uploadapk(packageName string) *InternalappsharingartifactsUploadapkCall { c := &InternalappsharingartifactsUploadapkCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.packageName = packageName @@ -10008,8 +10007,8 @@ type InternalappsharingartifactsUploadbundleCall struct { // are using the Google API client libraries, please increase the // timeout of the http request before calling this endpoint (a timeout // of 2 minutes is recommended). See Timeouts and Errors -// (https://developers.google.com/api-client-library/java/google-api-java -// -client/errors) for an example in java. +// (https://developers.google.com/api-client-library/java/google-api-java-client/errors) +// for an example in java. func (r *InternalappsharingartifactsService) Uploadbundle(packageName string) *InternalappsharingartifactsUploadbundleCall { c := &InternalappsharingartifactsUploadbundleCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.packageName = packageName diff --git a/apigateway/v1/apigateway-gen.go b/apigateway/v1/apigateway-gen.go index b447480a193..0d081086f12 100644 --- a/apigateway/v1/apigateway-gen.go +++ b/apigateway/v1/apigateway-gen.go @@ -219,8 +219,9 @@ type ApigatewayApi struct { // ManagedService: Optional. Immutable. The name of a Google Managed // Service ( - // https://cloud.google.com/service-infrastructure/docs/glossary#managed). If not specified, a new Service will automatically be created in the same project as this - // API. + // https://cloud.google.com/service-infrastructure/docs/glossary#managed). + // If not specified, a new Service will automatically be created in the + // same project as this API. ManagedService string `json:"managedService,omitempty"` // Name: Output only. Resource name of the API. Format: @@ -298,8 +299,12 @@ type ApigatewayApiConfig struct { // ManagedServiceConfigs: Optional. Service Configuration files. At // least one must be included when using gRPC service definitions. See - // https://cloud.google.com/endpoints/docs/grpc/grpc-service-config#service_configuration_overview for the expected file contents. If multiple files are specified, the files are merged with the following rules: * All singular scalar fields are merged using "last one wins" semantics in the order of the files uploaded. * Repeated fields are concatenated. * Singular embedded messages are merged using these rules for nested - // fields. + // https://cloud.google.com/endpoints/docs/grpc/grpc-service-config#service_configuration_overview + // for the expected file contents. If multiple files are specified, the + // files are merged with the following rules: * All singular scalar + // fields are merged using "last one wins" semantics in the order of the + // files uploaded. * Repeated fields are concatenated. * Singular + // embedded messages are merged using these rules for nested fields. ManagedServiceConfigs []*ApigatewayApiConfigFile `json:"managedServiceConfigs,omitempty"` // Name: Output only. Resource name of the API Config. Format: diff --git a/apigateway/v1beta/apigateway-gen.go b/apigateway/v1beta/apigateway-gen.go index e63dfee1124..a4b93d3c8cf 100644 --- a/apigateway/v1beta/apigateway-gen.go +++ b/apigateway/v1beta/apigateway-gen.go @@ -219,8 +219,9 @@ type ApigatewayApi struct { // ManagedService: Optional. Immutable. The name of a Google Managed // Service ( - // https://cloud.google.com/service-infrastructure/docs/glossary#managed). If not specified, a new Service will automatically be created in the same project as this - // API. + // https://cloud.google.com/service-infrastructure/docs/glossary#managed). + // If not specified, a new Service will automatically be created in the + // same project as this API. ManagedService string `json:"managedService,omitempty"` // Name: Output only. Resource name of the API. Format: @@ -301,8 +302,12 @@ type ApigatewayApiConfig struct { // ManagedServiceConfigs: Optional. Service Configuration files. At // least one must be included when using gRPC service definitions. See - // https://cloud.google.com/endpoints/docs/grpc/grpc-service-config#service_configuration_overview for the expected file contents. If multiple files are specified, the files are merged with the following rules: * All singular scalar fields are merged using "last one wins" semantics in the order of the files uploaded. * Repeated fields are concatenated. * Singular embedded messages are merged using these rules for nested - // fields. + // https://cloud.google.com/endpoints/docs/grpc/grpc-service-config#service_configuration_overview + // for the expected file contents. If multiple files are specified, the + // files are merged with the following rules: * All singular scalar + // fields are merged using "last one wins" semantics in the order of the + // files uploaded. * Repeated fields are concatenated. * Singular + // embedded messages are merged using these rules for nested fields. ManagedServiceConfigs []*ApigatewayApiConfigFile `json:"managedServiceConfigs,omitempty"` // Name: Output only. Resource name of the API Config. Format: @@ -565,9 +570,8 @@ func (s *ApigatewayAuditLogConfig) MarshalJSON() ([]byte, error) { type ApigatewayBackendConfig struct { // GoogleServiceAccount: Google Cloud IAM service account used to sign // OIDC tokens for backends that have authentication configured - // (https://cloud.google.com/service-infrastructure/docs/service-manageme - // nt/reference/rest/v1/services.configs#backend). This may either be - // the Service Account's email (i.e. + // (https://cloud.google.com/service-infrastructure/docs/service-management/reference/rest/v1/services.configs#backend). + // This may either be the Service Account's email (i.e. // "{ACCOUNT_ID}@{PROJECT}.iam.gserviceaccount.com") or its full // resource name (i.e. "projects/{PROJECT}/accounts/{UNIQUE_ID}"). This // is most often used when the backend is a GCP resource such as a Cloud @@ -575,8 +579,7 @@ type ApigatewayBackendConfig struct { // sent as an authorization header bearer token. The audience of the // OIDC token is configured in the associated Service Config in the // BackendRule option - // (https://github.com/googleapis/googleapis/blob/master/google/api/backe - // nd.proto#L125). + // (https://github.com/googleapis/googleapis/blob/master/google/api/backend.proto#L125). GoogleServiceAccount string `json:"googleServiceAccount,omitempty"` // ForceSendFields is a list of field names (e.g. diff --git a/apigee/v1/apigee-gen.go b/apigee/v1/apigee-gen.go index 7178b64ed6e..6e5a0a33206 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -5446,8 +5446,7 @@ func (s *GoogleCloudApigeeV1OptimizedStatsResponse) MarshalJSON() ([]byte, error type GoogleCloudApigeeV1Organization struct { // AnalyticsRegion: Required. Primary GCP region for analytics data // storage. For valid values, see Create an Apigee organization - // (https://cloud.google.com/apigee/docs/api-platform/get-started/create- - // org). + // (https://cloud.google.com/apigee/docs/api-platform/get-started/create-org). AnalyticsRegion string `json:"analyticsRegion,omitempty"` // Attributes: Not used by Apigee. @@ -5456,10 +5455,10 @@ type GoogleCloudApigeeV1Organization struct { // AuthorizedNetwork: Compute Engine network used for Service Networking // to be peered with Apigee runtime instances. See Getting started with // the Service Networking API - // (https://cloud.google.com/service-infrastructure/docs/service-networki - // ng/getting-started). Valid only when [RuntimeType] is set to CLOUD. - // The value can be updated only when there are no runtime instances. - // For example: "default". **Note:** Not supported for Apigee hybrid. + // (https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started). + // Valid only when [RuntimeType] is set to CLOUD. The value can be + // updated only when there are no runtime instances. For example: + // "default". **Note:** Not supported for Apigee hybrid. AuthorizedNetwork string `json:"authorizedNetwork,omitempty"` // CaCertificate: Output only. Base64-encoded public certificate for the @@ -7147,8 +7146,7 @@ type GoogleCloudApigeeV1SyncAuthorization struct { // if you have multiple environments and wish to assign a unique service // account to each one. The service accounts must have **Apigee // Synchronizer Manager** role. See also Create service accounts - // (https://cloud.google.com/apigee/docs/hybrid/latest/sa-about#create-th - // e-service-accounts). + // (https://cloud.google.com/apigee/docs/hybrid/latest/sa-about#create-the-service-accounts). Identities []string `json:"identities,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -8426,8 +8424,7 @@ type OrganizationsCreateCall struct { // Create: Creates an Apigee organization. See Create an Apigee // organization -// (https://cloud.google.com/apigee/docs/api-platform/get-started/create- -// org). +// (https://cloud.google.com/apigee/docs/api-platform/get-started/create-org). func (r *OrganizationsService) Create(googlecloudapigeev1organization *GoogleCloudApigeeV1Organization) *OrganizationsCreateCall { c := &OrganizationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.googlecloudapigeev1organization = googlecloudapigeev1organization @@ -8701,8 +8698,7 @@ type OrganizationsGetCall struct { // Get: Gets the profile for an Apigee organization. See Understanding // organizations -// (https://cloud.google.com/apigee/docs/api-platform/fundamentals/organi -// zation-structure). +// (https://cloud.google.com/apigee/docs/api-platform/fundamentals/organization-structure). func (r *OrganizationsService) Get(name string) *OrganizationsGetCall { c := &OrganizationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9033,8 +9029,8 @@ type OrganizationsGetSyncAuthorizationCall struct { // to `setSyncAuthorization`, then the existing authorization is // overwritten indiscriminately. For more information, see Configure the // Synchronizer -// (https://cloud.google.com/apigee/docs/hybrid/latest/synchronizer-acces -// s). **Note**: Available to Apigee hybrid only. +// (https://cloud.google.com/apigee/docs/hybrid/latest/synchronizer-access). +// **Note**: Available to Apigee hybrid only. func (r *OrganizationsService) GetSyncAuthorization(name string, googlecloudapigeev1getsyncauthorizationrequest *GoogleCloudApigeeV1GetSyncAuthorizationRequest) *OrganizationsGetSyncAuthorizationCall { c := &OrganizationsGetSyncAuthorizationCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9177,8 +9173,7 @@ type OrganizationsListCall struct { // List: Lists the Apigee organizations and associated GCP projects that // you have permission to access. See Understanding organizations -// (https://cloud.google.com/apigee/docs/api-platform/fundamentals/organi -// zation-structure). +// (https://cloud.google.com/apigee/docs/api-platform/fundamentals/organization-structure). func (r *OrganizationsService) List(parent string) *OrganizationsListCall { c := &OrganizationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9333,8 +9328,8 @@ type OrganizationsSetSyncAuthorizationCall struct { // ETag in the call to `setSyncAuthorization`, then the existing // authorization is overwritten indiscriminately. For more information, // see Configure the Synchronizer -// (https://cloud.google.com/apigee/docs/hybrid/latest/synchronizer-acces -// s). **Note**: Available to Apigee hybrid only. +// (https://cloud.google.com/apigee/docs/hybrid/latest/synchronizer-access). +// **Note**: Available to Apigee hybrid only. func (r *OrganizationsService) SetSyncAuthorization(name string, googlecloudapigeev1syncauthorization *GoogleCloudApigeeV1SyncAuthorization) *OrganizationsSetSyncAuthorizationCall { c := &OrganizationsSetSyncAuthorizationCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -21653,9 +21648,9 @@ type OrganizationsEnvironmentsGetIamPolicyCall struct { // GetIamPolicy: Gets the IAM policy on an environment. For more // information, see Manage users, roles, and permissions using the API -// (https://cloud.google.com/apigee/docs/api-platform/system-administrati -// on/manage-users-roles). You must have the -// `apigee.environments.getIamPolicy` permission to call this API. +// (https://cloud.google.com/apigee/docs/api-platform/system-administration/manage-users-roles). +// You must have the `apigee.environments.getIamPolicy` permission to +// call this API. func (r *OrganizationsEnvironmentsService) GetIamPolicy(resource string) *OrganizationsEnvironmentsGetIamPolicyCall { c := &OrganizationsEnvironmentsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -21822,9 +21817,9 @@ type OrganizationsEnvironmentsSetIamPolicyCall struct { // SetIamPolicy: Sets the IAM policy on an environment, if the policy // already exists it will be replaced. For more information, see Manage // users, roles, and permissions using the API -// (https://cloud.google.com/apigee/docs/api-platform/system-administrati -// on/manage-users-roles). You must have the -// `apigee.environments.setIamPolicy` permission to call this API. +// (https://cloud.google.com/apigee/docs/api-platform/system-administration/manage-users-roles). +// You must have the `apigee.environments.setIamPolicy` permission to +// call this API. func (r *OrganizationsEnvironmentsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsEnvironmentsSetIamPolicyCall { c := &OrganizationsEnvironmentsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -29061,8 +29056,7 @@ type OrganizationsEnvironmentsResourcefilesCreateCall struct { // Create: Creates a resource file. Specify the `Content-Type` as // `application/octet-stream` or `multipart/form-data`. For more // information about resource files, see Resource files -// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi -// les). +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-files). func (r *OrganizationsEnvironmentsResourcefilesService) Create(parent string, googleapihttpbody *GoogleApiHttpBody) *OrganizationsEnvironmentsResourcefilesCreateCall { c := &OrganizationsEnvironmentsResourcefilesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29230,8 +29224,7 @@ type OrganizationsEnvironmentsResourcefilesDeleteCall struct { // Delete: Deletes a resource file. For more information about resource // files, see Resource files -// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi -// les). +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-files). func (r *OrganizationsEnvironmentsResourcefilesService) Delete(parent string, type_ string, name string) *OrganizationsEnvironmentsResourcefilesDeleteCall { c := &OrganizationsEnvironmentsResourcefilesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29384,8 +29377,7 @@ type OrganizationsEnvironmentsResourcefilesGetCall struct { // Get: Gets the contents of a resource file. For more information about // resource files, see Resource files -// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi -// les). +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-files). func (r *OrganizationsEnvironmentsResourcefilesService) Get(parent string, type_ string, name string) *OrganizationsEnvironmentsResourcefilesGetCall { c := &OrganizationsEnvironmentsResourcefilesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29549,8 +29541,7 @@ type OrganizationsEnvironmentsResourcefilesListCall struct { // List: Lists all resource files, optionally filtering by type. For // more information about resource files, see Resource files -// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi -// les). +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-files). func (r *OrganizationsEnvironmentsResourcefilesService) List(parent string) *OrganizationsEnvironmentsResourcefilesListCall { c := &OrganizationsEnvironmentsResourcefilesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29712,8 +29703,7 @@ type OrganizationsEnvironmentsResourcefilesListEnvironmentResourcesCall struct { // ListEnvironmentResources: Lists all resource files, optionally // filtering by type. For more information about resource files, see // Resource files -// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi -// les). +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-files). func (r *OrganizationsEnvironmentsResourcefilesService) ListEnvironmentResources(parent string, type_ string) *OrganizationsEnvironmentsResourcefilesListEnvironmentResourcesCall { c := &OrganizationsEnvironmentsResourcefilesListEnvironmentResourcesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29873,8 +29863,7 @@ type OrganizationsEnvironmentsResourcefilesUpdateCall struct { // Update: Updates a resource file. Specify the `Content-Type` as // `application/octet-stream` or `multipart/form-data`. For more // information about resource files, see Resource files -// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-fi -// les). +// (https://cloud.google.com/apigee/docs/api-platform/develop/resource-files). func (r *OrganizationsEnvironmentsResourcefilesService) Update(parent string, type_ string, name string, googleapihttpbody *GoogleApiHttpBody) *OrganizationsEnvironmentsResourcefilesUpdateCall { c := &OrganizationsEnvironmentsResourcefilesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/appengine/v1/appengine-gen.go b/appengine/v1/appengine-gen.go index b5801a4ccad..11cc38f3d2f 100644 --- a/appengine/v1/appengine-gen.go +++ b/appengine/v1/appengine-gen.go @@ -1049,8 +1049,7 @@ type DebugInstanceRequest struct { // [KEY_VALUE] google-ssh // {"userName":"[USERNAME]","expireOn":"[EXPIRE_TIME]"}For more // information, see Adding and Removing SSH Keys - // (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-k - // eys). + // (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys). SshKey string `json:"sshKey,omitempty"` // ForceSendFields is a list of field names (e.g. "SshKey") to @@ -3431,9 +3430,9 @@ type Version struct { // DefaultExpiration: Duration that static files should be cached by web // proxies and browsers. Only applicable if the corresponding // StaticFilesHandler - // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a - // pps.services.versions#StaticFilesHandler) does not specify its own - // expiration time.Only returned in GET requests if view=FULL is set. + // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StaticFilesHandler) + // does not specify its own expiration time.Only returned in GET + // requests if view=FULL is set. DefaultExpiration string `json:"defaultExpiration,omitempty"` // Deployment: Code and application artifacts that make up this @@ -4187,8 +4186,9 @@ type AppsRepairCall struct { // App Engine service account. If you have deleted your App Engine // service account, this will not be able to recreate it. Instead, you // should attempt to use the IAM undelete API if possible at -// https://cloud.google.com/iam/reference/rest/v1/projects.serviceAccounts/undelete?apix_params=%7B"name"%3A"projects%2F-%2FserviceAccounts%2Funique_id"%2C"resource"%3A%7B%7D%7D . If the deletion was recent, the numeric ID can be found in the Cloud Console Activity -// Log. +// https://cloud.google.com/iam/reference/rest/v1/projects.serviceAccounts/undelete?apix_params=%7B"name"%3A"projects%2F-%2FserviceAccounts%2Funique_id"%2C"resource"%3A%7B%7D%7D +// . If the deletion was recent, the numeric ID can be found in the +// Cloud Console Activity Log. func (r *AppsService) Repair(appsId string, repairapplicationrequest *RepairApplicationRequest) *AppsRepairCall { c := &AppsRepairCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId @@ -8366,16 +8366,15 @@ func (r *AppsServicesService) Patch(appsId string, servicesId string, service *S // specify. By default, traffic is shifted immediately. For gradual // traffic migration, the target versions must be located within // instances that are configured for both warmup requests -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#InboundServiceType) and automatic scaling -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#AutomaticScaling). You must specify the shardBy -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services#ShardBy) field in the Service resource. Gradual traffic -// migration is not supported in the App Engine flexible environment. -// For examples, see Migrating and Splitting Traffic -// (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting -// -traffic). +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#InboundServiceType) +// and automatic scaling +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#AutomaticScaling). +// You must specify the shardBy +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services#ShardBy) +// field in the Service resource. Gradual traffic migration is not +// supported in the App Engine flexible environment. For examples, see +// Migrating and Splitting Traffic +// (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic). func (c *AppsServicesPatchCall) MigrateTraffic(migrateTraffic bool) *AppsServicesPatchCall { c.urlParams_.Set("migrateTraffic", fmt.Sprint(migrateTraffic)) return c @@ -9264,51 +9263,38 @@ type AppsServicesVersionsPatchCall struct { // following fields depending on the App Engine environment and type of // scaling that the version resource uses:Standard environment // instance_class -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#Version.FIELDS.instance_class)automatic scaling -// in the standard environment: automatic_scaling.min_idle_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#Version.FIELDS.automatic_scaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class)automatic +// scaling in the standard environment: +// automatic_scaling.min_idle_instances +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) // automatic_scaling.max_idle_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#Version.FIELDS.automatic_scaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) // automaticScaling.standard_scheduler_settings.max_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#StandardSchedulerSettings) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) // automaticScaling.standard_scheduler_settings.min_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#StandardSchedulerSettings) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) // automaticScaling.standard_scheduler_settings.target_cpu_utilization -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#StandardSchedulerSettings) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) // automaticScaling.standard_scheduler_settings.target_throughput_utiliza // tion -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#StandardSchedulerSettings)basic scaling or -// manual scaling in the standard environment: serving_status -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#Version.FIELDS.serving_status) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings)basic +// scaling or manual scaling in the standard environment: serving_status +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status) // manual_scaling.instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#manualscaling)Flexible environment -// serving_status -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#Version.FIELDS.serving_status)automatic scaling -// in the flexible environment: automatic_scaling.min_total_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#Version.FIELDS.automatic_scaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#manualscaling)Flexible +// environment serving_status +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status)automatic +// scaling in the flexible environment: +// automatic_scaling.min_total_instances +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) // automatic_scaling.max_total_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#Version.FIELDS.automatic_scaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) // automatic_scaling.cool_down_period_sec -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#Version.FIELDS.automatic_scaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) // automatic_scaling.cpu_utilization.target_utilization -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#Version.FIELDS.automatic_scaling)manual scaling -// in the flexible environment: manual_scaling.instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions#manualscaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling)manual +// scaling in the flexible environment: manual_scaling.instances +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#manualscaling) func (r *AppsServicesVersionsService) Patch(appsId string, servicesId string, versionsId string, version *Version) *AppsServicesVersionsPatchCall { c := &AppsServicesVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId @@ -9658,15 +9644,15 @@ type AppsServicesVersionsInstancesDeleteCall struct { // Delete: Stops a running instance.The instance might be automatically // recreated based on the scaling settings of the version. For more // information, see "How Instances are Managed" (standard environment -// (https://cloud.google.com/appengine/docs/standard/python/how-instances -// -are-managed) | flexible environment -// (https://cloud.google.com/appengine/docs/flexible/python/how-instances -// -are-managed)).To ensure that instances are not re-created and avoid -// getting billed, you can stop all instances within the target version -// by changing the serving status of the version to STOPPED with the +// (https://cloud.google.com/appengine/docs/standard/python/how-instances-are-managed) +// | flexible environment +// (https://cloud.google.com/appengine/docs/flexible/python/how-instances-are-managed)).To +// ensure that instances are not re-created and avoid getting billed, +// you can stop all instances within the target version by changing the +// serving status of the version to STOPPED with the // apps.services.versions.patch -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions/patch) method. +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions/patch) +// method. func (r *AppsServicesVersionsInstancesService) Delete(appsId string, servicesId string, versionsId string, instancesId string) *AppsServicesVersionsInstancesDeleteCall { c := &AppsServicesVersionsInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId @@ -10002,8 +9988,7 @@ type AppsServicesVersionsInstancesListCall struct { // List: Lists the instances of a version.Tip: To aggregate details // about instances over time, see the Stackdriver Monitoring API -// (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeS -// eries/list). +// (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). func (r *AppsServicesVersionsInstancesService) List(appsId string, servicesId string, versionsId string) *AppsServicesVersionsInstancesListCall { c := &AppsServicesVersionsInstancesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId diff --git a/appengine/v1beta/appengine-gen.go b/appengine/v1beta/appengine-gen.go index 89208d0db27..9ba92d4ee6a 100644 --- a/appengine/v1beta/appengine-gen.go +++ b/appengine/v1beta/appengine-gen.go @@ -1143,8 +1143,7 @@ type DebugInstanceRequest struct { // [KEY_VALUE] google-ssh // {"userName":"[USERNAME]","expireOn":"[EXPIRE_TIME]"}For more // information, see Adding and Removing SSH Keys - // (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-k - // eys). + // (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys). SshKey string `json:"sshKey,omitempty"` // ForceSendFields is a list of field names (e.g. "SshKey") to @@ -3530,10 +3529,9 @@ type Version struct { // DefaultExpiration: Duration that static files should be cached by web // proxies and browsers. Only applicable if the corresponding // StaticFilesHandler - // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be - // ta/apps.services.versions#StaticFilesHandler) does not specify its - // own expiration time.Only returned in GET requests if view=FULL is - // set. + // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StaticFilesHandler) + // does not specify its own expiration time.Only returned in GET + // requests if view=FULL is set. DefaultExpiration string `json:"defaultExpiration,omitempty"` // Deployment: Code and application artifacts that make up this @@ -4287,8 +4285,9 @@ type AppsRepairCall struct { // App Engine service account. If you have deleted your App Engine // service account, this will not be able to recreate it. Instead, you // should attempt to use the IAM undelete API if possible at -// https://cloud.google.com/iam/reference/rest/v1/projects.serviceAccounts/undelete?apix_params=%7B"name"%3A"projects%2F-%2FserviceAccounts%2Funique_id"%2C"resource"%3A%7B%7D%7D . If the deletion was recent, the numeric ID can be found in the Cloud Console Activity -// Log. +// https://cloud.google.com/iam/reference/rest/v1/projects.serviceAccounts/undelete?apix_params=%7B"name"%3A"projects%2F-%2FserviceAccounts%2Funique_id"%2C"resource"%3A%7B%7D%7D +// . If the deletion was recent, the numeric ID can be found in the +// Cloud Console Activity Log. func (r *AppsService) Repair(appsId string, repairapplicationrequest *RepairApplicationRequest) *AppsRepairCall { c := &AppsRepairCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId @@ -8466,17 +8465,15 @@ func (r *AppsServicesService) Patch(appsId string, servicesId string, service *S // specify. By default, traffic is shifted immediately. For gradual // traffic migration, the target versions must be located within // instances that are configured for both warmup requests -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#InboundServiceType) and automatic scaling -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#AutomaticScaling). You must specify the -// shardBy -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services#ShardBy) field in the Service resource. Gradual -// traffic migration is not supported in the App Engine flexible -// environment. For examples, see Migrating and Splitting Traffic -// (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting -// -traffic). +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#InboundServiceType) +// and automatic scaling +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#AutomaticScaling). +// You must specify the shardBy +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services#ShardBy) +// field in the Service resource. Gradual traffic migration is not +// supported in the App Engine flexible environment. For examples, see +// Migrating and Splitting Traffic +// (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic). func (c *AppsServicesPatchCall) MigrateTraffic(migrateTraffic bool) *AppsServicesPatchCall { c.urlParams_.Set("migrateTraffic", fmt.Sprint(migrateTraffic)) return c @@ -9365,53 +9362,38 @@ type AppsServicesVersionsPatchCall struct { // following fields depending on the App Engine environment and type of // scaling that the version resource uses:Standard environment // instance_class -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#Version.FIELDS.instance_class)automatic +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.instance_class)automatic // scaling in the standard environment: // automatic_scaling.min_idle_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#Version.FIELDS.automatic_scaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) // automatic_scaling.max_idle_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#Version.FIELDS.automatic_scaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) // automaticScaling.standard_scheduler_settings.max_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#StandardSchedulerSettings) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings) // automaticScaling.standard_scheduler_settings.min_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#StandardSchedulerSettings) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings) // automaticScaling.standard_scheduler_settings.target_cpu_utilization -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#StandardSchedulerSettings) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings) // automaticScaling.standard_scheduler_settings.target_throughput_utiliza // tion -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#StandardSchedulerSettings)basic scaling or -// manual scaling in the standard environment: serving_status -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#Version.FIELDS.serving_status) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings)basic +// scaling or manual scaling in the standard environment: serving_status +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.serving_status) // manual_scaling.instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#manualscaling)Flexible environment -// serving_status -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#Version.FIELDS.serving_status)automatic +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#manualscaling)Flexible +// environment serving_status +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.serving_status)automatic // scaling in the flexible environment: // automatic_scaling.min_total_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#Version.FIELDS.automatic_scaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) // automatic_scaling.max_total_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#Version.FIELDS.automatic_scaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) // automatic_scaling.cool_down_period_sec -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#Version.FIELDS.automatic_scaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling) // automatic_scaling.cpu_utilization.target_utilization -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#Version.FIELDS.automatic_scaling)manual +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.automatic_scaling)manual // scaling in the flexible environment: manual_scaling.instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta/apps.services.versions#manualscaling) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#manualscaling) func (r *AppsServicesVersionsService) Patch(appsId string, servicesId string, versionsId string, version *Version) *AppsServicesVersionsPatchCall { c := &AppsServicesVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId @@ -9761,15 +9743,15 @@ type AppsServicesVersionsInstancesDeleteCall struct { // Delete: Stops a running instance.The instance might be automatically // recreated based on the scaling settings of the version. For more // information, see "How Instances are Managed" (standard environment -// (https://cloud.google.com/appengine/docs/standard/python/how-instances -// -are-managed) | flexible environment -// (https://cloud.google.com/appengine/docs/flexible/python/how-instances -// -are-managed)).To ensure that instances are not re-created and avoid -// getting billed, you can stop all instances within the target version -// by changing the serving status of the version to STOPPED with the +// (https://cloud.google.com/appengine/docs/standard/python/how-instances-are-managed) +// | flexible environment +// (https://cloud.google.com/appengine/docs/flexible/python/how-instances-are-managed)).To +// ensure that instances are not re-created and avoid getting billed, +// you can stop all instances within the target version by changing the +// serving status of the version to STOPPED with the // apps.services.versions.patch -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a -// pps.services.versions/patch) method. +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions/patch) +// method. func (r *AppsServicesVersionsInstancesService) Delete(appsId string, servicesId string, versionsId string, instancesId string) *AppsServicesVersionsInstancesDeleteCall { c := &AppsServicesVersionsInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId @@ -10105,8 +10087,7 @@ type AppsServicesVersionsInstancesListCall struct { // List: Lists the instances of a version.Tip: To aggregate details // about instances over time, see the Stackdriver Monitoring API -// (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeS -// eries/list). +// (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). func (r *AppsServicesVersionsInstancesService) List(appsId string, servicesId string, versionsId string) *AppsServicesVersionsInstancesListCall { c := &AppsServicesVersionsInstancesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId diff --git a/appengine/v1beta4/appengine-gen.go b/appengine/v1beta4/appengine-gen.go index 141ea6834f7..d40936aadf6 100644 --- a/appengine/v1beta4/appengine-gen.go +++ b/appengine/v1beta4/appengine-gen.go @@ -694,8 +694,7 @@ type DebugInstanceRequest struct { // [USERNAME]:ssh-rsa [KEY_VALUE] google-ssh // {"userName":"[USERNAME]","expireOn":"[EXPIRE_TIME]"}For more // information, see Adding and Removing SSH Keys - // (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-k - // eys). + // (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys). SshKey string `json:"sshKey,omitempty"` // ForceSendFields is a list of field names (e.g. "SshKey") to @@ -2505,9 +2504,9 @@ type Version struct { // DefaultExpiration: Duration that static files should be cached by web // proxies and browsers. Only applicable if the corresponding // StaticFilesHandler - // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a - // pps.services.versions#staticfileshandler) does not specify its own - // expiration time.Only returned in GET requests if view=FULL is set. + // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) + // does not specify its own expiration time.Only returned in GET + // requests if view=FULL is set. DefaultExpiration string `json:"defaultExpiration,omitempty"` // Deployer: Email address of the user who created this @@ -3023,11 +3022,9 @@ type AppsPatchCall struct { // Patch: Updates the specified Application resource. You can update the // following fields: // auth_domain -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta4/apps#Application.FIELDS.auth_domain) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps#Application.FIELDS.auth_domain) // default_cookie_expiration -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta4/apps#Application.FIELDS.default_cookie_expiration) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps#Application.FIELDS.default_cookie_expiration) func (r *AppsService) Patch(appsId string, application *Application) *AppsPatchCall { c := &AppsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId @@ -4045,17 +4042,15 @@ func (c *AppsModulesPatchCall) Mask(mask string) *AppsModulesPatchCall { // specify. By default, traffic is shifted immediately. For gradual // traffic migration, the target versions must be located within // instances that are configured for both warmup requests -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta4/apps.modules.versions#inboundservicetype) and automatic scaling -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta4/apps.modules.versions#automaticscaling). You must specify the -// shardBy -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta4/apps.modules#shardby) field in the Module resource. Gradual -// traffic migration is not supported in the App Engine flexible -// environment. For examples, see Migrating and Splitting Traffic -// (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting -// -traffic). +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#inboundservicetype) +// and automatic scaling +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#automaticscaling). +// You must specify the shardBy +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules#shardby) +// field in the Module resource. Gradual traffic migration is not +// supported in the App Engine flexible environment. For examples, see +// Migrating and Splitting Traffic +// (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic). func (c *AppsModulesPatchCall) MigrateTraffic(migrateTraffic bool) *AppsModulesPatchCall { c.urlParams_.Set("migrateTraffic", fmt.Sprint(migrateTraffic)) return c @@ -4923,24 +4918,20 @@ type AppsModulesVersionsPatchCall struct { // following fields depending on the App Engine environment and type of // scaling that the version resource uses: // serving_status -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta4/apps.modules.versions#Version.FIELDS.serving_status): For -// Version resources that use basic scaling, manual scaling, or run in -// the App Engine flexible environment. +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.serving_status): +// For Version resources that use basic scaling, manual scaling, or run +// in the App Engine flexible environment. // instance_class -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta4/apps.modules.versions#Version.FIELDS.instance_class): For -// Version resources that run in the App Engine standard +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.instance_class): +// For Version resources that run in the App Engine standard // environment. // automatic_scaling.min_idle_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For -// Version resources that use automatic scaling and run in the App +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): +// For Version resources that use automatic scaling and run in the App // Engine standard environment. // automatic_scaling.max_idle_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For -// Version resources that use automatic scaling and run in the App +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): +// For Version resources that use automatic scaling and run in the App // Engine standard environment. func (r *AppsModulesVersionsService) Patch(appsId string, modulesId string, versionsId string, version *Version) *AppsModulesVersionsPatchCall { c := &AppsModulesVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -5624,8 +5615,7 @@ type AppsModulesVersionsInstancesListCall struct { // List: Lists the instances of a version.Tip: To aggregate details // about instances over time, see the Stackdriver Monitoring API -// (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeS -// eries/list). +// (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). func (r *AppsModulesVersionsInstancesService) List(appsId string, modulesId string, versionsId string) *AppsModulesVersionsInstancesListCall { c := &AppsModulesVersionsInstancesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId diff --git a/appengine/v1beta5/appengine-gen.go b/appengine/v1beta5/appengine-gen.go index 1e462662d44..e30390ac8d2 100644 --- a/appengine/v1beta5/appengine-gen.go +++ b/appengine/v1beta5/appengine-gen.go @@ -694,8 +694,7 @@ type DebugInstanceRequest struct { // [USERNAME]:ssh-rsa [KEY_VALUE] google-ssh // {"userName":"[USERNAME]","expireOn":"[EXPIRE_TIME]"}For more // information, see Adding and Removing SSH Keys - // (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-k - // eys). + // (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys). SshKey string `json:"sshKey,omitempty"` // ForceSendFields is a list of field names (e.g. "SshKey") to @@ -2460,9 +2459,9 @@ type Version struct { // DefaultExpiration: Duration that static files should be cached by web // proxies and browsers. Only applicable if the corresponding // StaticFilesHandler - // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/a - // pps.services.versions#staticfileshandler) does not specify its own - // expiration time.Only returned in GET requests if view=FULL is set. + // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) + // does not specify its own expiration time.Only returned in GET + // requests if view=FULL is set. DefaultExpiration string `json:"defaultExpiration,omitempty"` // Deployer: Email address of the user who created this @@ -2983,11 +2982,9 @@ type AppsPatchCall struct { // Patch: Updates the specified Application resource. You can update the // following fields: // auth_domain -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta5/apps#Application.FIELDS.auth_domain) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps#Application.FIELDS.auth_domain) // default_cookie_expiration -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta5/apps#Application.FIELDS.default_cookie_expiration) +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps#Application.FIELDS.default_cookie_expiration) func (r *AppsService) Patch(appsId string, application *Application) *AppsPatchCall { c := &AppsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId @@ -4374,17 +4371,15 @@ func (c *AppsServicesPatchCall) Mask(mask string) *AppsServicesPatchCall { // specify. By default, traffic is shifted immediately. For gradual // traffic migration, the target versions must be located within // instances that are configured for both warmup requests -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta5/apps.services.versions#inboundservicetype) and automatic scaling -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta5/apps.services.versions#automaticscaling). You must specify the -// shardBy -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta5/apps.services#shardby) field in the Service resource. Gradual -// traffic migration is not supported in the App Engine flexible -// environment. For examples, see Migrating and Splitting Traffic -// (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting -// -traffic). +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#inboundservicetype) +// and automatic scaling +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#automaticscaling). +// You must specify the shardBy +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services#shardby) +// field in the Service resource. Gradual traffic migration is not +// supported in the App Engine flexible environment. For examples, see +// Migrating and Splitting Traffic +// (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic). func (c *AppsServicesPatchCall) MigrateTraffic(migrateTraffic bool) *AppsServicesPatchCall { c.urlParams_.Set("migrateTraffic", fmt.Sprint(migrateTraffic)) return c @@ -5252,24 +5247,20 @@ type AppsServicesVersionsPatchCall struct { // following fields depending on the App Engine environment and type of // scaling that the version resource uses: // serving_status -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta5/apps.services.versions#Version.FIELDS.serving_status): For -// Version resources that use basic scaling, manual scaling, or run in -// the App Engine flexible environment. +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.serving_status): +// For Version resources that use basic scaling, manual scaling, or run +// in the App Engine flexible environment. // instance_class -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta5/apps.services.versions#Version.FIELDS.instance_class): For -// Version resources that run in the App Engine standard +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.instance_class): +// For Version resources that run in the App Engine standard // environment. // automatic_scaling.min_idle_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta5/apps.services.versions#Version.FIELDS.automatic_scaling): For -// Version resources that use automatic scaling and run in the App +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): +// For Version resources that use automatic scaling and run in the App // Engine standard environment. // automatic_scaling.max_idle_instances -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1be -// ta5/apps.services.versions#Version.FIELDS.automatic_scaling): For -// Version resources that use automatic scaling and run in the App +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): +// For Version resources that use automatic scaling and run in the App // Engine standard environment. func (r *AppsServicesVersionsService) Patch(appsId string, servicesId string, versionsId string, version *Version) *AppsServicesVersionsPatchCall { c := &AppsServicesVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -5953,8 +5944,7 @@ type AppsServicesVersionsInstancesListCall struct { // List: Lists the instances of a version.Tip: To aggregate details // about instances over time, see the Stackdriver Monitoring API -// (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeS -// eries/list). +// (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). func (r *AppsServicesVersionsInstancesService) List(appsId string, servicesId string, versionsId string) *AppsServicesVersionsInstancesListCall { c := &AppsServicesVersionsInstancesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 3d941bf8a86..84551ac1883 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -4242,8 +4242,23 @@ type JobStatistics2 struct { // StatementType: The type of query statement, if valid. Possible values // (new values might be added in the future): "SELECT": SELECT query. // "INSERT": INSERT query; see - // https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. "UPDATE": UPDATE query; see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. "DELETE": DELETE query; see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. "MERGE": MERGE query; see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. "ALTER_TABLE": ALTER TABLE query. "ALTER_VIEW": ALTER VIEW query. "ASSERT": ASSERT condition AS 'description'. "CREATE_FUNCTION": CREATE FUNCTION query. "CREATE_MODEL": CREATE [OR REPLACE] MODEL ... AS SELECT ... . "CREATE_PROCEDURE": CREATE PROCEDURE query. "CREATE_TABLE": CREATE [OR REPLACE] TABLE without AS SELECT. "CREATE_TABLE_AS_SELECT": CREATE [OR REPLACE] TABLE ... AS SELECT ... . "CREATE_VIEW": CREATE [OR REPLACE] VIEW ... AS SELECT ... . "DROP_FUNCTION" : DROP FUNCTION query. "DROP_PROCEDURE": DROP PROCEDURE query. "DROP_TABLE": DROP TABLE query. "DROP_VIEW": DROP VIEW - // query. + // https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. + // "UPDATE": UPDATE query; see + // https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. + // "DELETE": DELETE query; see + // https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. + // "MERGE": MERGE query; see + // https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. + // "ALTER_TABLE": ALTER TABLE query. "ALTER_VIEW": ALTER VIEW query. + // "ASSERT": ASSERT condition AS 'description'. "CREATE_FUNCTION": + // CREATE FUNCTION query. "CREATE_MODEL": CREATE [OR REPLACE] MODEL ... + // AS SELECT ... . "CREATE_PROCEDURE": CREATE PROCEDURE query. + // "CREATE_TABLE": CREATE [OR REPLACE] TABLE without AS SELECT. + // "CREATE_TABLE_AS_SELECT": CREATE [OR REPLACE] TABLE ... AS SELECT ... + // . "CREATE_VIEW": CREATE [OR REPLACE] VIEW ... AS SELECT ... . + // "DROP_FUNCTION" : DROP FUNCTION query. "DROP_PROCEDURE": DROP + // PROCEDURE query. "DROP_TABLE": DROP TABLE query. "DROP_VIEW": DROP + // VIEW query. StatementType string `json:"statementType,omitempty"` // Timeline: [Output-only] [Beta] Describes a timeline of job execution. @@ -6510,8 +6525,8 @@ type TableDataInsertAllRequest struct { // template, and inserts the rows into an instance table named // "{destination}{templateSuffix}". BigQuery will manage creation of the // instance table, using the schema of the base template table. See - // https://cloud.google.com/bigquery/streaming-data-into-bigquery#template-tables for considerations when working with templates - // tables. + // https://cloud.google.com/bigquery/streaming-data-into-bigquery#template-tables + // for considerations when working with templates tables. TemplateSuffix string `json:"templateSuffix,omitempty"` // ForceSendFields is a list of field names (e.g. "IgnoreUnknownValues") diff --git a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go index 8336df37c1f..5ce4a5f6004 100644 --- a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go +++ b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go @@ -1165,8 +1165,8 @@ type TransferConfig struct { // UTC. Examples of valid format: `1st,3rd monday of month 15:30`, // `every wed,fri of jan,jun 13:15`, and `first sunday of quarter // 00:00`. See more explanation about the format here: - // https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format NOTE: the granularity should be at least 8 hours, or less - // frequent. + // https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format + // NOTE: the granularity should be at least 8 hours, or less frequent. Schedule string `json:"schedule,omitempty"` // ScheduleOptions: Options customizing the data transfer schedule. @@ -2725,7 +2725,16 @@ func (r *ProjectsLocationsTransferConfigsService) Create(parent string, transfer // configuration. This is required if new credentials are needed, as // indicated by `CheckValidCreds`. In order to obtain // authorization_code, please make a request to -// https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=&scope=&redirect_uri= * client_id should be OAuth client_id of BigQuery DTS API for the given data source returned by ListDataSources method. * data_source_scopes are the scopes returned by ListDataSources method. * redirect_uri is an optional parameter. If not specified, then authorization code is posted to the opener of authorization flow window. Otherwise it will be sent to the redirect uri. A special value of urn:ietf:wg:oauth:2.0:oob means that authorization code should be returned in the title bar of the browser, with the page text prompting the user to copy the code and paste it in the +// https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=&scope=&redirect_uri= +// * client_id should be OAuth client_id of BigQuery DTS API for the +// given data source returned by ListDataSources method. * +// data_source_scopes are the scopes returned by ListDataSources method. +// * redirect_uri is an optional parameter. If not specified, then +// authorization code is posted to the opener of authorization flow +// window. Otherwise it will be sent to the redirect uri. A special +// value of urn:ietf:wg:oauth:2.0:oob means that authorization code +// should be returned in the title bar of the browser, with the page +// text prompting the user to copy the code and paste it in the // application. func (c *ProjectsLocationsTransferConfigsCreateCall) AuthorizationCode(authorizationCode string) *ProjectsLocationsTransferConfigsCreateCall { c.urlParams_.Set("authorizationCode", authorizationCode) @@ -3405,7 +3414,16 @@ func (r *ProjectsLocationsTransferConfigsService) Patch(name string, transfercon // configuration. If it is provided, the transfer configuration will be // associated with the authorizing user. In order to obtain // authorization_code, please make a request to -// https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=&scope=&redirect_uri= * client_id should be OAuth client_id of BigQuery DTS API for the given data source returned by ListDataSources method. * data_source_scopes are the scopes returned by ListDataSources method. * redirect_uri is an optional parameter. If not specified, then authorization code is posted to the opener of authorization flow window. Otherwise it will be sent to the redirect uri. A special value of urn:ietf:wg:oauth:2.0:oob means that authorization code should be returned in the title bar of the browser, with the page text prompting the user to copy the code and paste it in the +// https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=&scope=&redirect_uri= +// * client_id should be OAuth client_id of BigQuery DTS API for the +// given data source returned by ListDataSources method. * +// data_source_scopes are the scopes returned by ListDataSources method. +// * redirect_uri is an optional parameter. If not specified, then +// authorization code is posted to the opener of authorization flow +// window. Otherwise it will be sent to the redirect uri. A special +// value of urn:ietf:wg:oauth:2.0:oob means that authorization code +// should be returned in the title bar of the browser, with the page +// text prompting the user to copy the code and paste it in the // application. func (c *ProjectsLocationsTransferConfigsPatchCall) AuthorizationCode(authorizationCode string) *ProjectsLocationsTransferConfigsPatchCall { c.urlParams_.Set("authorizationCode", authorizationCode) @@ -4663,7 +4681,16 @@ func (r *ProjectsTransferConfigsService) Create(parent string, transferconfig *T // configuration. This is required if new credentials are needed, as // indicated by `CheckValidCreds`. In order to obtain // authorization_code, please make a request to -// https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=&scope=&redirect_uri= * client_id should be OAuth client_id of BigQuery DTS API for the given data source returned by ListDataSources method. * data_source_scopes are the scopes returned by ListDataSources method. * redirect_uri is an optional parameter. If not specified, then authorization code is posted to the opener of authorization flow window. Otherwise it will be sent to the redirect uri. A special value of urn:ietf:wg:oauth:2.0:oob means that authorization code should be returned in the title bar of the browser, with the page text prompting the user to copy the code and paste it in the +// https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=&scope=&redirect_uri= +// * client_id should be OAuth client_id of BigQuery DTS API for the +// given data source returned by ListDataSources method. * +// data_source_scopes are the scopes returned by ListDataSources method. +// * redirect_uri is an optional parameter. If not specified, then +// authorization code is posted to the opener of authorization flow +// window. Otherwise it will be sent to the redirect uri. A special +// value of urn:ietf:wg:oauth:2.0:oob means that authorization code +// should be returned in the title bar of the browser, with the page +// text prompting the user to copy the code and paste it in the // application. func (c *ProjectsTransferConfigsCreateCall) AuthorizationCode(authorizationCode string) *ProjectsTransferConfigsCreateCall { c.urlParams_.Set("authorizationCode", authorizationCode) @@ -5343,7 +5370,16 @@ func (r *ProjectsTransferConfigsService) Patch(name string, transferconfig *Tran // configuration. If it is provided, the transfer configuration will be // associated with the authorizing user. In order to obtain // authorization_code, please make a request to -// https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=&scope=&redirect_uri= * client_id should be OAuth client_id of BigQuery DTS API for the given data source returned by ListDataSources method. * data_source_scopes are the scopes returned by ListDataSources method. * redirect_uri is an optional parameter. If not specified, then authorization code is posted to the opener of authorization flow window. Otherwise it will be sent to the redirect uri. A special value of urn:ietf:wg:oauth:2.0:oob means that authorization code should be returned in the title bar of the browser, with the page text prompting the user to copy the code and paste it in the +// https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=&scope=&redirect_uri= +// * client_id should be OAuth client_id of BigQuery DTS API for the +// given data source returned by ListDataSources method. * +// data_source_scopes are the scopes returned by ListDataSources method. +// * redirect_uri is an optional parameter. If not specified, then +// authorization code is posted to the opener of authorization flow +// window. Otherwise it will be sent to the redirect uri. A special +// value of urn:ietf:wg:oauth:2.0:oob means that authorization code +// should be returned in the title bar of the browser, with the page +// text prompting the user to copy the code and paste it in the // application. func (c *ProjectsTransferConfigsPatchCall) AuthorizationCode(authorizationCode string) *ProjectsTransferConfigsPatchCall { c.urlParams_.Set("authorizationCode", authorizationCode) diff --git a/billingbudgets/v1/billingbudgets-gen.go b/billingbudgets/v1/billingbudgets-gen.go index 33a7cebf4a8..8bdfce40595 100644 --- a/billingbudgets/v1/billingbudgets-gen.go +++ b/billingbudgets/v1/billingbudgets-gen.go @@ -273,8 +273,7 @@ type GoogleCloudBillingBudgetsV1Filter struct { // calculations. If Filter.credit_types_treatment is **not** // INCLUDE_SPECIFIED_CREDITS, this field must be empty. See a list of // acceptable credit type values - // (https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tab - // les#credits-type). + // (https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type). CreditTypes []string `json:"creditTypes,omitempty"` // CreditTypesTreatment: Optional. If not set, default behavior is @@ -408,8 +407,8 @@ type GoogleCloudBillingBudgetsV1NotificationsRule struct { // the full REST resource name of a monitoring notification channel with // the form `projects/{project_id}/notificationChannels/{channel_id}`. A // maximum of 5 channels are allowed. See - // https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients for more - // details. + // https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients + // for more details. MonitoringNotificationChannels []string `json:"monitoringNotificationChannels,omitempty"` // PubsubTopic: Optional. The name of the Pub/Sub topic where budget @@ -417,8 +416,13 @@ type GoogleCloudBillingBudgetsV1NotificationsRule struct { // `projects/{project_id}/topics/{topic_id}`. Updates are sent at // regular intervals to the topic. The topic needs to be created before // the budget is created; see - // https://cloud.google.com/billing/docs/how-to/budgets#manage-notifications for more details. Caller is expected to have `pubsub.topics.setIamPolicy` permission on the topic when it's set for a budget, otherwise, the API call will fail with PERMISSION_DENIED. See https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications for more details on Pub/Sub roles and - // permissions. + // https://cloud.google.com/billing/docs/how-to/budgets#manage-notifications + // for more details. Caller is expected to have + // `pubsub.topics.setIamPolicy` permission on the topic when it's set + // for a budget, otherwise, the API call will fail with + // PERMISSION_DENIED. See + // https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications + // for more details on Pub/Sub roles and permissions. PubsubTopic string `json:"pubsubTopic,omitempty"` // SchemaVersion: Optional. The schema version of the notification sent diff --git a/billingbudgets/v1beta1/billingbudgets-gen.go b/billingbudgets/v1beta1/billingbudgets-gen.go index cf0c8bf242b..e3547a1f088 100644 --- a/billingbudgets/v1beta1/billingbudgets-gen.go +++ b/billingbudgets/v1beta1/billingbudgets-gen.go @@ -180,8 +180,8 @@ type GoogleCloudBillingBudgetsV1beta1AllUpdatesRule struct { // the full REST resource name of a monitoring notification channel with // the form `projects/{project_id}/notificationChannels/{channel_id}`. A // maximum of 5 channels are allowed. See - // https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients for more - // details. + // https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients + // for more details. MonitoringNotificationChannels []string `json:"monitoringNotificationChannels,omitempty"` // PubsubTopic: Optional. The name of the Pub/Sub topic where budget @@ -189,8 +189,13 @@ type GoogleCloudBillingBudgetsV1beta1AllUpdatesRule struct { // `projects/{project_id}/topics/{topic_id}`. Updates are sent at // regular intervals to the topic. The topic needs to be created before // the budget is created; see - // https://cloud.google.com/billing/docs/how-to/budgets#manage-notifications for more details. Caller is expected to have `pubsub.topics.setIamPolicy` permission on the topic when it's set for a budget, otherwise, the API call will fail with PERMISSION_DENIED. See https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications for more details on Pub/Sub roles and - // permissions. + // https://cloud.google.com/billing/docs/how-to/budgets#manage-notifications + // for more details. Caller is expected to have + // `pubsub.topics.setIamPolicy` permission on the topic when it's set + // for a budget, otherwise, the API call will fail with + // PERMISSION_DENIED. See + // https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications + // for more details on Pub/Sub roles and permissions. PubsubTopic string `json:"pubsubTopic,omitempty"` // SchemaVersion: Optional. The schema version of the notification sent @@ -363,8 +368,7 @@ type GoogleCloudBillingBudgetsV1beta1Filter struct { // calculations. If Filter.credit_types_treatment is **not** // INCLUDE_SPECIFIED_CREDITS, this field must be empty. See a list of // acceptable credit type values - // (https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tab - // les#credits-type). + // (https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type). CreditTypes []string `json:"creditTypes,omitempty"` // CreditTypesTreatment: Optional. If not set, default behavior is diff --git a/classroom/v1/classroom-gen.go b/classroom/v1/classroom-gen.go index 12ef201a8df..8ed3fb6d28a 100644 --- a/classroom/v1/classroom-gen.go +++ b/classroom/v1/classroom-gen.go @@ -602,8 +602,7 @@ func (s *Attachment) MarshalJSON() ([]byte, error) { // `projects.topics.publish` permission. type CloudPubsubTopic struct { // TopicName: The `name` field of a Cloud Pub/Sub Topic - // (https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topic - // s#Topic). + // (https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topics#Topic). TopicName string `json:"topicName,omitempty"` // ForceSendFields is a list of field names (e.g. "TopicName") to diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index 8a0fa77cb55..d65cb1a1e61 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -282,31 +282,29 @@ func (s *AnalyzeIamPolicyResponse) MarshalJSON() ([]byte, error) { // Asset: An asset in Google Cloud. An asset can be any resource in the // Google Cloud resource hierarchy -// (https://cloud.google.com/resource-manager/docs/cloud-platform-resourc -// e-hierarchy), a resource outside the Google Cloud resource hierarchy -// (such as Google Kubernetes Engine clusters and objects), or a policy -// (e.g. Cloud IAM policy). See Supported asset types +// (https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy), +// a resource outside the Google Cloud resource hierarchy (such as +// Google Kubernetes Engine clusters and objects), or a policy (e.g. +// Cloud IAM policy). See Supported asset types // (https://cloud.google.com/asset-inventory/docs/supported-asset-types) // for more information. type Asset struct { // AccessLevel: Please also refer to the access level user guide - // (https://cloud.google.com/access-context-manager/docs/overview#access- - // levels). + // (https://cloud.google.com/access-context-manager/docs/overview#access-levels). AccessLevel *GoogleIdentityAccesscontextmanagerV1AccessLevel `json:"accessLevel,omitempty"` // AccessPolicy: Please also refer to the access policy user guide - // (https://cloud.google.com/access-context-manager/docs/overview#access- - // policies). + // (https://cloud.google.com/access-context-manager/docs/overview#access-policies). AccessPolicy *GoogleIdentityAccesscontextmanagerV1AccessPolicy `json:"accessPolicy,omitempty"` // Ancestors: The ancestry path of an asset in Google Cloud resource // hierarchy - // (https://cloud.google.com/resource-manager/docs/cloud-platform-resourc - // e-hierarchy), represented as a list of relative resource names. An - // ancestry path starts with the closest ancestor in the hierarchy and - // ends at root. If the asset is a project, folder, or organization, the - // ancestry path starts from the asset itself. Example: - // `["projects/123456789", "folders/5432", "organizations/1234"]` + // (https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy), + // represented as a list of relative resource names. An ancestry path + // starts with the closest ancestor in the hierarchy and ends at root. + // If the asset is a project, folder, or organization, the ancestry path + // starts from the asset itself. Example: `["projects/123456789", + // "folders/5432", "organizations/1234"]` Ancestors []string `json:"ancestors,omitempty"` // AssetType: The type of the asset. Example: @@ -329,20 +327,20 @@ type Asset struct { // Name: The full name of the asset. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance // s/instance1` See Resource names - // (https://cloud.google.com/apis/design/resource_names#full_resource_nam - // e) for more information. + // (https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more information. Name string `json:"name,omitempty"` // OrgPolicy: A representation of an organization policy - // (https://cloud.google.com/resource-manager/docs/organization-policy/ov - // erview#organization_policy). There can be more than one organization - // policy with different constraints set on a given resource. + // (https://cloud.google.com/resource-manager/docs/organization-policy/overview#organization_policy). + // There can be more than one organization policy with different + // constraints set on a given resource. OrgPolicy []*GoogleCloudOrgpolicyV1Policy `json:"orgPolicy,omitempty"` // OsInventory: A representation of runtime OS Inventory information. // See this topic - // (https://cloud.google.com/compute/docs/instances/os-inventory-manageme - // nt) for more information. + // (https://cloud.google.com/compute/docs/instances/os-inventory-management) + // for more information. OsInventory *Inventory `json:"osInventory,omitempty"` // Resource: A representation of the resource. @@ -557,7 +555,7 @@ type BigQueryDestination struct { // nested fields in the Asset.resource.data field of that asset type (up // to the 15 nested level BigQuery supports // (https://cloud.google.com/bigquery/docs/nested-repeated#limitations)). - // The fields in >15 nested levels will be stored in JSON format string + // The fields in >15 nested levels will be stored in JSON format string // as a child column of its parent RECORD column. If error occurs when // exporting to any table, the whole export call will return an error // but the export results that already succeed will persist. Example: if @@ -889,8 +887,8 @@ type Feed struct { // asset_types are exported to the feed. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance // s/instance1`. See Resource Names - // (https://cloud.google.com/apis/design/resource_names#full_resource_nam - // e) for more info. + // (https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more info. AssetNames []string `json:"assetNames,omitempty"` // AssetTypes: A list of types of the assets to receive updates. You @@ -910,8 +908,8 @@ type Feed struct { // `temporal_asset`. Example: a Feed with expression // ("temporal_asset.deleted == true") will only publish Asset deletions. // Other fields of `Expr` are optional. See our user guide - // (https://cloud.google.com/asset-inventory/docs/monitoring-asset-change - // s#feed_with_condition) for detailed instructions. + // (https://cloud.google.com/asset-inventory/docs/monitoring-asset-changes#feed_with_condition) + // for detailed instructions. Condition *Expr `json:"condition,omitempty"` // ContentType: Asset content type. If not specified, no content but the @@ -2678,11 +2676,9 @@ type IamPolicyAnalysisQuery struct { // (such as "folders/123"), a project ID (such as // "projects/my-project-id"), or a project number (such as // "projects/12345"). To know how to get organization id, visit here - // (https://cloud.google.com/resource-manager/docs/creating-managing-orga - // nization#retrieving_your_organization_id). To know how to get folder - // or project id, visit here - // (https://cloud.google.com/resource-manager/docs/creating-managing-fold - // ers#viewing_or_listing_folders_and_projects). + // (https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id). + // To know how to get folder or project id, visit here + // (https://cloud.google.com/resource-manager/docs/creating-managing-folders#viewing_or_listing_folders_and_projects). Scope string `json:"scope,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessSelector") to @@ -3574,8 +3570,8 @@ type Resource struct { // Parent: The full name of the immediate parent of this resource. See // Resource Names - // (https://cloud.google.com/apis/design/resource_names#full_resource_nam - // e) for more information. For Google Cloud assets, this value is the + // (https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more information. For Google Cloud assets, this value is the // parent resource defined in the Cloud IAM policy hierarchy // (https://cloud.google.com/iam/docs/overview#policy_hierarchy). // Example: @@ -3625,15 +3621,14 @@ type ResourceSearchResult struct { // fields that are returned by the List or Get APIs provided by the // corresponding GCP service (e.g., Compute Engine). see API references // and supported searchable attributes - // (https://cloud.google.com/asset-inventory/docs/supported-asset-types#s - // earchable_asset_types) for more information. You can search values of - // these fields through free text search. However, you should not - // consume the field programically as the field names and values may - // change as the GCP service updates to a new incompatible API version. - // To search against the `additional_attributes`: * use a free text - // query to match the attributes values. Example: to search - // `additional_attributes = { dnsName: "foobar" }`, you can issue a - // query `foobar`. + // (https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types) + // for more information. You can search values of these fields through + // free text search. However, you should not consume the field + // programically as the field names and values may change as the GCP + // service updates to a new incompatible API version. To search against + // the `additional_attributes`: * use a free text query to match the + // attributes values. Example: to search `additional_attributes = { + // dnsName: "foobar" }`, you can issue a query `foobar`. AdditionalAttributes googleapi.RawMessage `json:"additionalAttributes,omitempty"` // AssetType: Required. The type of this resource. Example: @@ -3658,13 +3653,13 @@ type ResourceSearchResult struct { // Labels: Optional. Labels associated with this resource. See Labelling // and grouping GCP resources - // (https://cloud.google.com/blog/products/gcp/labelling-and-grouping-you - // r-google-cloud-platform-resources) for more information. This field - // is available only when the resource's proto contains it. To search - // against the `labels`: * use a field query: - query on any label's key - // or value. Example: `labels:prod` - query by a given label. Example: - // `labels.env:prod` - query by a given label's existence. Example: - // `labels.env:*` * use a free text query. Example: `prod` + // (https://cloud.google.com/blog/products/gcp/labelling-and-grouping-your-google-cloud-platform-resources) + // for more information. This field is available only when the + // resource's proto contains it. To search against the `labels`: * use a + // field query: - query on any label's key or value. Example: + // `labels:prod` - query by a given label. Example: `labels.env:prod` - + // query by a given label's existence. Example: `labels.env:*` * use a + // free text query. Example: `prod` Labels map[string]string `json:"labels,omitempty"` // Location: Optional. Location can be `global`, regional like @@ -3686,11 +3681,11 @@ type ResourceSearchResult struct { // NetworkTags: Optional. Network tags associated with this resource. // Like labels, network tags are a type of annotations used to group GCP // resources. See Labelling GCP resources - // (https://cloud.google.com/blog/products/gcp/labelling-and-grouping-you - // r-google-cloud-platform-resources) for more information. This field - // is available only when the resource's proto contains it. To search - // against the `network_tags`: * use a field query. Example: - // `networkTags:internal` * use a free text query. Example: `internal` + // (https://cloud.google.com/blog/products/gcp/labelling-and-grouping-your-google-cloud-platform-resources) + // for more information. This field is available only when the + // resource's proto contains it. To search against the `network_tags`: * + // use a field query. Example: `networkTags:internal` * use a free text + // query. Example: `internal` NetworkTags []string `json:"networkTags,omitempty"` // Project: Optional. The project that this resource belongs to, in the @@ -3731,8 +3726,7 @@ type ResourceSelector struct { // FullResourceName: Required. The [full resource name] // (https://cloud.google.com/asset-inventory/docs/resource-name-format) // of a resource of supported resource types - // (https://cloud.google.com/asset-inventory/docs/supported-asset-types#a - // nalyzable_asset_types). + // (https://cloud.google.com/asset-inventory/docs/supported-asset-types#analyzable_asset_types). FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "FullResourceName") to @@ -3852,8 +3846,8 @@ type SoftwarePackage struct { GoogetPackage *VersionedPackage `json:"googetPackage,omitempty"` // QfePackage: Details of a Windows Quick Fix engineering package. See - // https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/win32-quickfixengineering for info in Windows Quick Fix - // Engineering. + // https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/win32-quickfixengineering + // for info in Windows Quick Fix Engineering. QfePackage *WindowsQuickFixEngineeringPackage `json:"qfePackage,omitempty"` // WuaPackage: Details of a Windows Update package. See @@ -5259,8 +5253,7 @@ func (c *V1AnalyzeIamPolicyCall) AnalysisQueryOptionsOutputResourceEdges(analysi // Required. The [full resource name] // (https://cloud.google.com/asset-inventory/docs/resource-name-format) // of a resource of supported resource types -// (https://cloud.google.com/asset-inventory/docs/supported-asset-types#a -// nalyzable_asset_types). +// (https://cloud.google.com/asset-inventory/docs/supported-asset-types#analyzable_asset_types). func (c *V1AnalyzeIamPolicyCall) AnalysisQueryResourceSelectorFullResourceName(analysisQueryResourceSelectorFullResourceName string) *V1AnalyzeIamPolicyCall { c.urlParams_.Set("analysisQuery.resourceSelector.fullResourceName", analysisQueryResourceSelectorFullResourceName) return c @@ -6041,14 +6034,13 @@ func (c *V1SearchAllIamPoliciesCall) PageToken(pageToken string) *V1SearchAllIam // Query sets the optional parameter "query": The query statement. See // how to construct a query -// (https://cloud.google.com/asset-inventory/docs/searching-iam-policies# -// how_to_construct_a_query) for more information. If not specified or -// empty, it will search all the IAM policies within the specified -// `scope`. Note that the query string is compared against each Cloud -// IAM policy binding, including its members, roles, and Cloud IAM -// conditions. The returned Cloud IAM policies will only contain the -// bindings that match your query. To learn more about the IAM policy -// structure, see IAM policy doc +// (https://cloud.google.com/asset-inventory/docs/searching-iam-policies#how_to_construct_a_query) +// for more information. If not specified or empty, it will search all +// the IAM policies within the specified `scope`. Note that the query +// string is compared against each Cloud IAM policy binding, including +// its members, roles, and Cloud IAM conditions. The returned Cloud IAM +// policies will only contain the bindings that match your query. To +// learn more about the IAM policy structure, see IAM policy doc // (https://cloud.google.com/iam/docs/policies#structure). Examples: * // `policy:amy@gmail.com` to find IAM policy bindings that specify user // "amy@gmail.com". * `policy:roles/compute.admin` to find IAM policy @@ -6261,10 +6253,10 @@ func (r *V1Service) SearchAllResources(scope string) *V1SearchAllResourcesCall { // AssetTypes sets the optional parameter "assetTypes": A list of asset // types that this request searches for. If empty, it will search all // the searchable asset types -// (https://cloud.google.com/asset-inventory/docs/supported-asset-types#s -// earchable_asset_types). Regular expressions are also supported. For -// example: * "compute.googleapis.com.*" snapshots resources whose asset -// type starts with "compute.googleapis.com". * ".*Instance" snapshots +// (https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types). +// Regular expressions are also supported. For example: * +// "compute.googleapis.com.*" snapshots resources whose asset type +// starts with "compute.googleapis.com". * ".*Instance" snapshots // resources whose asset type ends with "Instance". * ".*Instance.*" // snapshots resources whose asset type contains "Instance". See RE2 // (https://github.com/google/re2/wiki/Syntax) for all supported regular @@ -6312,14 +6304,14 @@ func (c *V1SearchAllResourcesCall) PageToken(pageToken string) *V1SearchAllResou // Query sets the optional parameter "query": The query statement. See // how to construct a query -// (http://cloud.google.com/asset-inventory/docs/searching-resources#how_ -// to_construct_a_query) for more information. If not specified or -// empty, it will search all the resources within the specified `scope`. -// Examples: * `name:Important` to find Cloud resources whose name -// contains "Important" as a word. * `name=Important` to find the Cloud -// resource whose name is exactly "Important". * `displayName:Impor*` to -// find Cloud resources whose display name contains "Impor" as a prefix. -// * `description:*por*` to find Cloud resources whose description +// (http://cloud.google.com/asset-inventory/docs/searching-resources#how_to_construct_a_query) +// for more information. If not specified or empty, it will search all +// the resources within the specified `scope`. Examples: * +// `name:Important` to find Cloud resources whose name contains +// "Important" as a word. * `name=Important` to find the Cloud resource +// whose name is exactly "Important". * `displayName:Impor*` to find +// Cloud resources whose display name contains "Impor" as a prefix. * +// `description:*por*` to find Cloud resources whose description // contains "por" as a substring. * `location:us-west*` to find Cloud // resources whose location is prefixed with "us-west". * `labels:prod` // to find Cloud resources whose labels contain "prod" as a key or diff --git a/cloudasset/v1beta1/cloudasset-gen.go b/cloudasset/v1beta1/cloudasset-gen.go index afc1a006a6c..f64d8741549 100644 --- a/cloudasset/v1beta1/cloudasset-gen.go +++ b/cloudasset/v1beta1/cloudasset-gen.go @@ -206,21 +206,19 @@ type ProjectsOperationsService struct { // Asset: An asset in Google Cloud. An asset can be any resource in the // Google Cloud resource hierarchy -// (https://cloud.google.com/resource-manager/docs/cloud-platform-resourc -// e-hierarchy), a resource outside the Google Cloud resource hierarchy -// (such as Google Kubernetes Engine clusters and objects), or a policy -// (e.g. Cloud IAM policy). See Supported asset types +// (https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy), +// a resource outside the Google Cloud resource hierarchy (such as +// Google Kubernetes Engine clusters and objects), or a policy (e.g. +// Cloud IAM policy). See Supported asset types // (https://cloud.google.com/asset-inventory/docs/supported-asset-types) // for more information. type Asset struct { // AccessLevel: Please also refer to the access level user guide - // (https://cloud.google.com/access-context-manager/docs/overview#access- - // levels). + // (https://cloud.google.com/access-context-manager/docs/overview#access-levels). AccessLevel *GoogleIdentityAccesscontextmanagerV1AccessLevel `json:"accessLevel,omitempty"` // AccessPolicy: Please also refer to the access policy user guide - // (https://cloud.google.com/access-context-manager/docs/overview#access- - // policies). + // (https://cloud.google.com/access-context-manager/docs/overview#access-policies). AccessPolicy *GoogleIdentityAccesscontextmanagerV1AccessPolicy `json:"accessPolicy,omitempty"` // AssetType: The type of the asset. Example: @@ -243,14 +241,14 @@ type Asset struct { // Name: The full name of the asset. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance // s/instance1` See Resource names - // (https://cloud.google.com/apis/design/resource_names#full_resource_nam - // e) for more information. + // (https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more information. Name string `json:"name,omitempty"` // OrgPolicy: A representation of an organization policy - // (https://cloud.google.com/resource-manager/docs/organization-policy/ov - // erview#organization_policy). There can be more than one organization - // policy with different constraints set on a given resource. + // (https://cloud.google.com/resource-manager/docs/organization-policy/overview#organization_policy). + // There can be more than one organization policy with different + // constraints set on a given resource. OrgPolicy []*GoogleCloudOrgpolicyV1Policy `json:"orgPolicy,omitempty"` // Resource: A representation of the resource. @@ -490,8 +488,8 @@ type ExportAssetsRequest struct { // AssetTypes: A list of asset types of which to take a snapshot for. // For example: "google.compute.Disk". If specified, only matching // assets will be returned. See Introduction to Cloud Asset Inventory - // (https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/ - // overview) for all supported asset types. + // (https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview) + // for all supported asset types. AssetTypes []string `json:"assetTypes,omitempty"` // ContentType: Asset content type. If not specified, no content but the @@ -2074,8 +2072,8 @@ type Resource struct { // Parent: The full name of the immediate parent of this resource. See // Resource Names - // (https://cloud.google.com/apis/design/resource_names#full_resource_nam - // e) for more information. For Google Cloud assets, this value is the + // (https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more information. For Google Cloud assets, this value is the // parent resource defined in the Cloud IAM policy hierarchy // (https://cloud.google.com/iam/docs/overview#policy_hierarchy). // Example: @@ -2548,10 +2546,9 @@ func (r *OrganizationsService) BatchGetAssetsHistory(parent string) *Organizatio // full names of the assets. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance // s/instance1`. See Resource Names -// (https://cloud.google.com/apis/design/resource_names#full_resource_nam -// e) for more info. The request becomes a no-op if the asset name list -// is empty, and the max size of the asset name list is 100 in one -// request. +// (https://cloud.google.com/apis/design/resource_names#full_resource_name) +// for more info. The request becomes a no-op if the asset name list is +// empty, and the max size of the asset name list is 100 in one request. func (c *OrganizationsBatchGetAssetsHistoryCall) AssetNames(assetNames ...string) *OrganizationsBatchGetAssetsHistoryCall { c.urlParams_.SetMulti("assetNames", append([]string{}, assetNames...)) return c @@ -3064,10 +3061,9 @@ func (r *ProjectsService) BatchGetAssetsHistory(parent string) *ProjectsBatchGet // full names of the assets. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance // s/instance1`. See Resource Names -// (https://cloud.google.com/apis/design/resource_names#full_resource_nam -// e) for more info. The request becomes a no-op if the asset name list -// is empty, and the max size of the asset name list is 100 in one -// request. +// (https://cloud.google.com/apis/design/resource_names#full_resource_name) +// for more info. The request becomes a no-op if the asset name list is +// empty, and the max size of the asset name list is 100 in one request. func (c *ProjectsBatchGetAssetsHistoryCall) AssetNames(assetNames ...string) *ProjectsBatchGetAssetsHistoryCall { c.urlParams_.SetMulti("assetNames", append([]string{}, assetNames...)) return c diff --git a/cloudasset/v1p1beta1/cloudasset-gen.go b/cloudasset/v1p1beta1/cloudasset-gen.go index a5e03dce66f..b4caacf59c3 100644 --- a/cloudasset/v1p1beta1/cloudasset-gen.go +++ b/cloudasset/v1p1beta1/cloudasset-gen.go @@ -443,8 +443,8 @@ type IamPolicySearchResult struct { Project string `json:"project,omitempty"` // Resource: The full resource name - // (https://cloud.google.com/apis/design/resource_names#full_resource_nam - // e) of the resource associated with this IAM policy. + // (https://cloud.google.com/apis/design/resource_names#full_resource_name) + // of the resource associated with this IAM policy. Resource string `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "Explanation") to @@ -696,8 +696,8 @@ type StandardResourceMetadata struct { // Labels: Labels associated with this resource. See Labelling and // grouping GCP resources - // (https://cloud.google.com/blog/products/gcp/labelling-and-grouping-you - // r-google-cloud-platform-resources) for more information. + // (https://cloud.google.com/blog/products/gcp/labelling-and-grouping-your-google-cloud-platform-resources) + // for more information. Labels map[string]string `json:"labels,omitempty"` // Location: Location can be "global", regional like "us-east1", or @@ -707,8 +707,8 @@ type StandardResourceMetadata struct { // Name: The full resource name. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance // s/instance1`. See Resource Names - // (https://cloud.google.com/apis/design/resource_names#full_resource_nam - // e) for more information. + // (https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more information. Name string `json:"name,omitempty"` // NetworkTags: Network tags associated with this resource. Like labels, diff --git a/cloudasset/v1p4beta1/cloudasset-gen.go b/cloudasset/v1p4beta1/cloudasset-gen.go index 9b44d2089fa..b21ce3c3580 100644 --- a/cloudasset/v1p4beta1/cloudasset-gen.go +++ b/cloudasset/v1p4beta1/cloudasset-gen.go @@ -862,11 +862,9 @@ type IamPolicyAnalysisQuery struct { // (such as "folders/123"), a project ID (such as // "projects/my-project-id"), or a project number (such as // "projects/12345"). To know how to get organization id, visit here - // (https://cloud.google.com/resource-manager/docs/creating-managing-orga - // nization#retrieving_your_organization_id). To know how to get folder - // or project id, visit here - // (https://cloud.google.com/resource-manager/docs/creating-managing-fold - // ers#viewing_or_listing_folders_and_projects). + // (https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id). + // To know how to get folder or project id, visit here + // (https://cloud.google.com/resource-manager/docs/creating-managing-folders#viewing_or_listing_folders_and_projects). Parent string `json:"parent,omitempty"` // ResourceSelector: Optional. Specifies a resource for analysis. @@ -1134,8 +1132,7 @@ type ResourceSelector struct { // FullResourceName: Required. The full resource name // (https://cloud.google.com/asset-inventory/docs/resource-name-format) // of a resource of supported resource types - // (https://cloud.google.com/asset-inventory/docs/supported-asset-types#a - // nalyzable_asset_types). + // (https://cloud.google.com/asset-inventory/docs/supported-asset-types#analyzable_asset_types). FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "FullResourceName") to @@ -1259,8 +1256,7 @@ func (c *V1p4beta1AnalyzeIamPolicyCall) AnalysisQueryIdentitySelectorIdentity(an // Required. The full resource name // (https://cloud.google.com/asset-inventory/docs/resource-name-format) // of a resource of supported resource types -// (https://cloud.google.com/asset-inventory/docs/supported-asset-types#a -// nalyzable_asset_types). +// (https://cloud.google.com/asset-inventory/docs/supported-asset-types#analyzable_asset_types). func (c *V1p4beta1AnalyzeIamPolicyCall) AnalysisQueryResourceSelectorFullResourceName(analysisQueryResourceSelectorFullResourceName string) *V1p4beta1AnalyzeIamPolicyCall { c.urlParams_.Set("analysisQuery.resourceSelector.fullResourceName", analysisQueryResourceSelectorFullResourceName) return c diff --git a/cloudasset/v1p5beta1/cloudasset-gen.go b/cloudasset/v1p5beta1/cloudasset-gen.go index 36b8f698064..b1a2dc210dd 100644 --- a/cloudasset/v1p5beta1/cloudasset-gen.go +++ b/cloudasset/v1p5beta1/cloudasset-gen.go @@ -146,31 +146,29 @@ type AssetsService struct { // Asset: An asset in Google Cloud. An asset can be any resource in the // Google Cloud resource hierarchy -// (https://cloud.google.com/resource-manager/docs/cloud-platform-resourc -// e-hierarchy), a resource outside the Google Cloud resource hierarchy -// (such as Google Kubernetes Engine clusters and objects), or a policy -// (e.g. Cloud IAM policy). See Supported asset types +// (https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy), +// a resource outside the Google Cloud resource hierarchy (such as +// Google Kubernetes Engine clusters and objects), or a policy (e.g. +// Cloud IAM policy). See Supported asset types // (https://cloud.google.com/asset-inventory/docs/supported-asset-types) // for more information. type Asset struct { // AccessLevel: Please also refer to the access level user guide - // (https://cloud.google.com/access-context-manager/docs/overview#access- - // levels). + // (https://cloud.google.com/access-context-manager/docs/overview#access-levels). AccessLevel *GoogleIdentityAccesscontextmanagerV1AccessLevel `json:"accessLevel,omitempty"` // AccessPolicy: Please also refer to the access policy user guide - // (https://cloud.google.com/access-context-manager/docs/overview#access- - // policies). + // (https://cloud.google.com/access-context-manager/docs/overview#access-policies). AccessPolicy *GoogleIdentityAccesscontextmanagerV1AccessPolicy `json:"accessPolicy,omitempty"` // Ancestors: The ancestry path of an asset in Google Cloud resource // hierarchy - // (https://cloud.google.com/resource-manager/docs/cloud-platform-resourc - // e-hierarchy), represented as a list of relative resource names. An - // ancestry path starts with the closest ancestor in the hierarchy and - // ends at root. If the asset is a project, folder, or organization, the - // ancestry path starts from the asset itself. Example: - // `["projects/123456789", "folders/5432", "organizations/1234"]` + // (https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy), + // represented as a list of relative resource names. An ancestry path + // starts with the closest ancestor in the hierarchy and ends at root. + // If the asset is a project, folder, or organization, the ancestry path + // starts from the asset itself. Example: `["projects/123456789", + // "folders/5432", "organizations/1234"]` Ancestors []string `json:"ancestors,omitempty"` // AssetType: The type of the asset. Example: @@ -193,14 +191,14 @@ type Asset struct { // Name: The full name of the asset. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance // s/instance1` See Resource names - // (https://cloud.google.com/apis/design/resource_names#full_resource_nam - // e) for more information. + // (https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more information. Name string `json:"name,omitempty"` // OrgPolicy: A representation of an organization policy - // (https://cloud.google.com/resource-manager/docs/organization-policy/ov - // erview#organization_policy). There can be more than one organization - // policy with different constraints set on a given resource. + // (https://cloud.google.com/resource-manager/docs/organization-policy/overview#organization_policy). + // There can be more than one organization policy with different + // constraints set on a given resource. OrgPolicy []*GoogleCloudOrgpolicyV1Policy `json:"orgPolicy,omitempty"` // Resource: A representation of the resource. @@ -1845,8 +1843,8 @@ type Resource struct { // Parent: The full name of the immediate parent of this resource. See // Resource Names - // (https://cloud.google.com/apis/design/resource_names#full_resource_nam - // e) for more information. For Google Cloud assets, this value is the + // (https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more information. For Google Cloud assets, this value is the // parent resource defined in the Cloud IAM policy hierarchy // (https://cloud.google.com/iam/docs/overview#policy_hierarchy). // Example: diff --git a/clouderrorreporting/v1beta1/clouderrorreporting-gen.go b/clouderrorreporting/v1beta1/clouderrorreporting-gen.go index d96b9df6a0c..f02e29bfd91 100644 --- a/clouderrorreporting/v1beta1/clouderrorreporting-gen.go +++ b/clouderrorreporting/v1beta1/clouderrorreporting-gen.go @@ -577,17 +577,16 @@ type ReportedErrorEvent struct { // formats. Supported languages are Java, Python, JavaScript, Ruby, C#, // PHP, and Go. Supported stack trace formats are: * **Java**: Must be // the return value of `Throwable.printStackTrace()` - // (https://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html#pr - // intStackTrace%28%29). * **Python**: Must be the return value of - // `traceback.format_exc()` - // (https://docs.python.org/2/library/traceback.html#traceback.format_exc - // ). * **JavaScript**: Must be the value of `error.stack` + // (https://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html#printStackTrace%28%29). + // * **Python**: Must be the return value of `traceback.format_exc()` + // (https://docs.python.org/2/library/traceback.html#traceback.format_exc). + // * **JavaScript**: Must be the value of `error.stack` // (https://github.com/v8/v8/wiki/Stack-Trace-API) as returned by V8. * // **Ruby**: Must contain frames returned by `Exception.backtrace` // (https://ruby-doc.org/core-2.2.0/Exception.html#method-i-backtrace). // * **C#**: Must be the return value of `Exception.ToString()` - // (https://msdn.microsoft.com/en-us/library/system.exception.tostring.as - // px). * **PHP**: Must start with `PHP (Notice|Parse error|Fatal + // (https://msdn.microsoft.com/en-us/library/system.exception.tostring.aspx). + // * **PHP**: Must start with `PHP (Notice|Parse error|Fatal // error|Warning)` and contain the result of `(string)$exception` // (http://php.net/manual/en/exception.tostring.php). * **Go**: Must be // the return value of `runtime.Stack()` diff --git a/cloudidentity/v1/cloudidentity-gen.go b/cloudidentity/v1/cloudidentity-gen.go index 30901666def..638ad8dd734 100644 --- a/cloudidentity/v1/cloudidentity-gen.go +++ b/cloudidentity/v1/cloudidentity-gen.go @@ -2757,8 +2757,8 @@ func (c *DevicesListCall) Customer(customer string) *DevicesListCall { // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to // Mobile device search fields -// (https://developers.google.com/admin-sdk/directory/v1/search-operators -// ). Multiple search fields are separated by the space character. +// (https://developers.google.com/admin-sdk/directory/v1/search-operators). +// Multiple search fields are separated by the space character. func (c *DevicesListCall) Filter(filter string) *DevicesListCall { c.urlParams_.Set("filter", filter) return c @@ -3871,8 +3871,8 @@ func (c *DevicesDeviceUsersListCall) Customer(customer string) *DevicesDeviceUse // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to // Mobile device search fields -// (https://developers.google.com/admin-sdk/directory/v1/search-operators -// ). Multiple search fields are separated by the space character. +// (https://developers.google.com/admin-sdk/directory/v1/search-operators). +// Multiple search fields are separated by the space character. func (c *DevicesDeviceUsersListCall) Filter(filter string) *DevicesDeviceUsersListCall { c.urlParams_.Set("filter", filter) return c @@ -4109,8 +4109,7 @@ func (r *DevicesDeviceUsersService) Lookup(parent string) *DevicesDeviceUsersLoo // AndroidId sets the optional parameter "androidId": Android Id // returned by Settings.Secure#ANDROID_ID -// (https://developer.android.com/reference/android/provider/Settings.Sec -// ure.html#ANDROID_ID). +// (https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID). func (c *DevicesDeviceUsersLookupCall) AndroidId(androidId string) *DevicesDeviceUsersLookupCall { c.urlParams_.Set("androidId", androidId) return c diff --git a/cloudidentity/v1beta1/cloudidentity-gen.go b/cloudidentity/v1beta1/cloudidentity-gen.go index 893d07ea3d7..0f18291e0b4 100644 --- a/cloudidentity/v1beta1/cloudidentity-gen.go +++ b/cloudidentity/v1beta1/cloudidentity-gen.go @@ -3607,8 +3607,8 @@ func (c *DevicesListCall) Customer(customer string) *DevicesListCall { // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to // Mobile device search fields -// (https://developers.google.com/admin-sdk/directory/v1/search-operators -// ). Multiple search fields are separated by the space character. +// (https://developers.google.com/admin-sdk/directory/v1/search-operators). +// Multiple search fields are separated by the space character. func (c *DevicesListCall) Filter(filter string) *DevicesListCall { c.urlParams_.Set("filter", filter) return c @@ -4716,8 +4716,8 @@ func (c *DevicesDeviceUsersListCall) Customer(customer string) *DevicesDeviceUse // Filter sets the optional parameter "filter": Additional restrictions // when fetching list of devices. For a list of search fields, refer to // Mobile device search fields -// (https://developers.google.com/admin-sdk/directory/v1/search-operators -// ). Multiple search fields are separated by the space character. +// (https://developers.google.com/admin-sdk/directory/v1/search-operators). +// Multiple search fields are separated by the space character. func (c *DevicesDeviceUsersListCall) Filter(filter string) *DevicesDeviceUsersListCall { c.urlParams_.Set("filter", filter) return c @@ -4951,8 +4951,7 @@ func (r *DevicesDeviceUsersService) Lookup(parent string) *DevicesDeviceUsersLoo // AndroidId sets the optional parameter "androidId": Android Id // returned by Settings.Secure#ANDROID_ID -// (https://developer.android.com/reference/android/provider/Settings.Sec -// ure.html#ANDROID_ID). +// (https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID). func (c *DevicesDeviceUsersLookupCall) AndroidId(androidId string) *DevicesDeviceUsersLookupCall { c.urlParams_.Set("androidId", androidId) return c diff --git a/cloudscheduler/v1/cloudscheduler-gen.go b/cloudscheduler/v1/cloudscheduler-gen.go index 6bc4d014363..d91ec97ea8f 100644 --- a/cloudscheduler/v1/cloudscheduler-gen.go +++ b/cloudscheduler/v1/cloudscheduler-gen.go @@ -256,21 +256,19 @@ func (s *AppEngineHttpTarget) MarshalJSON() ([]byte, error) { // AppEngineRouting: App Engine Routing. For more information about // services, versions, and instances see An Overview of App Engine -// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng -// ine), Microservices Architecture on Google App Engine -// (https://cloud.google.com/appengine/docs/python/microservices-on-app-e -// ngine), App Engine Standard request routing -// (https://cloud.google.com/appengine/docs/standard/python/how-requests- -// are-routed), and App Engine Flex request routing -// (https://cloud.google.com/appengine/docs/flexible/python/how-requests- -// are-routed). +// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine), +// Microservices Architecture on Google App Engine +// (https://cloud.google.com/appengine/docs/python/microservices-on-app-engine), +// App Engine Standard request routing +// (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed), +// and App Engine Flex request routing +// (https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). type AppEngineRouting struct { // Host: Output only. The host that the job is sent to. For more // information about how App Engine requests are routed, see here - // (https://cloud.google.com/appengine/docs/standard/python/how-requests- - // are-routed). The host is constructed as: * `host = - // [application_domain_name]` `| [service] + '.' + - // [application_domain_name]` `| [version] + '.' + + // (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed). + // The host is constructed as: * `host = [application_domain_name]` `| + // [service] + '.' + [application_domain_name]` `| [version] + '.' + // [application_domain_name]` `| [version_dot_service]+ '.' + // [application_domain_name]` `| [instance] + '.' + // [application_domain_name]` `| [instance_dot_service] + '.' + @@ -297,14 +295,12 @@ type AppEngineRouting struct { // which is available when the job is attempted. Requests can only be // sent to a specific instance if manual scaling is used in App Engine // Standard - // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng - // ine?hl=en_US#scaling_types_and_instance_classes). App Engine Flex - // does not support instances. For more information, see App Engine - // Standard request routing - // (https://cloud.google.com/appengine/docs/standard/python/how-requests- - // are-routed) and App Engine Flex request routing - // (https://cloud.google.com/appengine/docs/flexible/python/how-requests- - // are-routed). + // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes). + // App Engine Flex does not support instances. For more information, see + // App Engine Standard request routing + // (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed) + // and App Engine Flex request routing + // (https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). Instance string `json:"instance,omitempty"` // Service: App service. By default, the job is sent to the service @@ -469,13 +465,13 @@ type Job struct { // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see // Identifying projects - // (https://cloud.google.com/resource-manager/docs/creating-managing-proj - // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for - // the job's location. The list of available locations can be obtained - // by calling ListLocations. For more information, see - // https://cloud.google.com/about/locations/. * `JOB_ID` can contain - // only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores - // (_). The maximum length is 500 characters. + // (https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) + // * `LOCATION_ID` is the canonical ID for the job's location. The list + // of available locations can be obtained by calling ListLocations. For + // more information, see https://cloud.google.com/about/locations/. * + // `JOB_ID` can contain only letters ([A-Za-z]), numbers ([0-9]), + // hyphens (-), or underscores (_). The maximum length is 500 + // characters. Name string `json:"name,omitempty"` // PubsubTarget: Pub/Sub target. @@ -488,8 +484,8 @@ type Job struct { // schedule on which the job will be executed. The schedule can be // either of the following types: * Crontab // (http://en.wikipedia.org/wiki/Cron#Overview) * English-like schedule - // (https://cloud.google.com/scheduler/docs/configuring/cron-job-schedule - // s) As a general rule, execution `n + 1` of a job will not begin until + // (https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules) + // As a general rule, execution `n + 1` of a job will not begin until // execution `n` has finished. Cloud Scheduler will never allow two // simultaneously outstanding executions. For example, this implies that // if the `n+1`th execution is scheduled to run at 16:00 but the `n`th @@ -854,9 +850,9 @@ type PubsubTarget struct { // messages will be published when a job is delivered. The topic name // must be in the same format as required by PubSub's // PublishRequest.name - // (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#p - // ublishrequest), for example `projects/PROJECT_ID/topics/TOPIC_ID`. - // The topic must be in the same project as the Cloud Scheduler job. + // (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#publishrequest), + // for example `projects/PROJECT_ID/topics/TOPIC_ID`. The topic must be + // in the same project as the Cloud Scheduler job. TopicName string `json:"topicName,omitempty"` // ForceSendFields is a list of field names (e.g. "Attributes") to diff --git a/cloudscheduler/v1beta1/cloudscheduler-gen.go b/cloudscheduler/v1beta1/cloudscheduler-gen.go index 7fde84e4b26..68c7ea3b097 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-gen.go +++ b/cloudscheduler/v1beta1/cloudscheduler-gen.go @@ -256,21 +256,19 @@ func (s *AppEngineHttpTarget) MarshalJSON() ([]byte, error) { // AppEngineRouting: App Engine Routing. For more information about // services, versions, and instances see An Overview of App Engine -// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng -// ine), Microservices Architecture on Google App Engine -// (https://cloud.google.com/appengine/docs/python/microservices-on-app-e -// ngine), App Engine Standard request routing -// (https://cloud.google.com/appengine/docs/standard/python/how-requests- -// are-routed), and App Engine Flex request routing -// (https://cloud.google.com/appengine/docs/flexible/python/how-requests- -// are-routed). +// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine), +// Microservices Architecture on Google App Engine +// (https://cloud.google.com/appengine/docs/python/microservices-on-app-engine), +// App Engine Standard request routing +// (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed), +// and App Engine Flex request routing +// (https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). type AppEngineRouting struct { // Host: Output only. The host that the job is sent to. For more // information about how App Engine requests are routed, see here - // (https://cloud.google.com/appengine/docs/standard/python/how-requests- - // are-routed). The host is constructed as: * `host = - // [application_domain_name]` `| [service] + '.' + - // [application_domain_name]` `| [version] + '.' + + // (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed). + // The host is constructed as: * `host = [application_domain_name]` `| + // [service] + '.' + [application_domain_name]` `| [version] + '.' + // [application_domain_name]` `| [version_dot_service]+ '.' + // [application_domain_name]` `| [instance] + '.' + // [application_domain_name]` `| [instance_dot_service] + '.' + @@ -297,14 +295,12 @@ type AppEngineRouting struct { // which is available when the job is attempted. Requests can only be // sent to a specific instance if manual scaling is used in App Engine // Standard - // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng - // ine?hl=en_US#scaling_types_and_instance_classes). App Engine Flex - // does not support instances. For more information, see App Engine - // Standard request routing - // (https://cloud.google.com/appengine/docs/standard/python/how-requests- - // are-routed) and App Engine Flex request routing - // (https://cloud.google.com/appengine/docs/flexible/python/how-requests- - // are-routed). + // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes). + // App Engine Flex does not support instances. For more information, see + // App Engine Standard request routing + // (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed) + // and App Engine Flex request routing + // (https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). Instance string `json:"instance,omitempty"` // Service: App service. By default, the job is sent to the service @@ -476,13 +472,13 @@ type Job struct { // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see // Identifying projects - // (https://cloud.google.com/resource-manager/docs/creating-managing-proj - // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for - // the job's location. The list of available locations can be obtained - // by calling ListLocations. For more information, see - // https://cloud.google.com/about/locations/. * `JOB_ID` can contain - // only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores - // (_). The maximum length is 500 characters. + // (https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) + // * `LOCATION_ID` is the canonical ID for the job's location. The list + // of available locations can be obtained by calling ListLocations. For + // more information, see https://cloud.google.com/about/locations/. * + // `JOB_ID` can contain only letters ([A-Za-z]), numbers ([0-9]), + // hyphens (-), or underscores (_). The maximum length is 500 + // characters. Name string `json:"name,omitempty"` // PubsubTarget: Pub/Sub target. @@ -495,8 +491,8 @@ type Job struct { // schedule on which the job will be executed. The schedule can be // either of the following types: * Crontab // (http://en.wikipedia.org/wiki/Cron#Overview) * English-like schedule - // (https://cloud.google.com/scheduler/docs/configuring/cron-job-schedule - // s) As a general rule, execution `n + 1` of a job will not begin until + // (https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules) + // As a general rule, execution `n + 1` of a job will not begin until // execution `n` has finished. Cloud Scheduler will never allow two // simultaneously outstanding executions. For example, this implies that // if the `n+1`th execution is scheduled to run at 16:00 but the `n`th @@ -861,9 +857,9 @@ type PubsubTarget struct { // messages will be published when a job is delivered. The topic name // must be in the same format as required by PubSub's // PublishRequest.name - // (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#p - // ublishrequest), for example `projects/PROJECT_ID/topics/TOPIC_ID`. - // The topic must be in the same project as the Cloud Scheduler job. + // (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#publishrequest), + // for example `projects/PROJECT_ID/topics/TOPIC_ID`. The topic must be + // in the same project as the Cloud Scheduler job. TopicName string `json:"topicName,omitempty"` // ForceSendFields is a list of field names (e.g. "Attributes") to diff --git a/cloudsearch/v1/cloudsearch-gen.go b/cloudsearch/v1/cloudsearch-gen.go index 74d67dd784e..dd6937d904b 100644 --- a/cloudsearch/v1/cloudsearch-gen.go +++ b/cloudsearch/v1/cloudsearch-gen.go @@ -9436,19 +9436,18 @@ type MediaUploadCall struct { // Upload: Uploads media for indexing. The upload endpoint supports // direct and resumable upload protocols and is intended for large items // that can not be inlined during index requests -// (https://developers.google.com/cloud-search/docs/reference/rest/v1/ind -// exing.datasources.items#itemcontent). To index large content: 1. Call -// indexing.datasources.items.upload with the item name to begin an -// upload session and retrieve the UploadItemRef. 1. Call media.upload -// to upload the content, as a streaming request, using the same -// resource name from the UploadItemRef from step 1. 1. Call -// indexing.datasources.items.index to index the item. Populate the -// ItemContent +// (https://developers.google.com/cloud-search/docs/reference/rest/v1/indexing.datasources.items#itemcontent). +// To index large content: 1. Call indexing.datasources.items.upload +// with the item name to begin an upload session and retrieve the +// UploadItemRef. 1. Call media.upload to upload the content, as a +// streaming request, using the same resource name from the +// UploadItemRef from step 1. 1. Call indexing.datasources.items.index +// to index the item. Populate the ItemContent // (/cloud-search/docs/reference/rest/v1/indexing.datasources.items#ItemC // ontent) with the UploadItemRef from step 1. For additional // information, see Create a content connector using the REST API -// (https://developers.google.com/cloud-search/docs/guides/content-connec -// tor#rest). **Note:** This API requires a service account to execute. +// (https://developers.google.com/cloud-search/docs/guides/content-connector#rest). +// **Note:** This API requires a service account to execute. func (r *MediaService) Upload(resourceName string, media *Media) *MediaUploadCall { c := &MediaUploadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resourceName = resourceName diff --git a/cloudtasks/v2/cloudtasks-gen.go b/cloudtasks/v2/cloudtasks-gen.go index a1403296a4c..bbcc2dc9456 100644 --- a/cloudtasks/v2/cloudtasks-gen.go +++ b/cloudtasks/v2/cloudtasks-gen.go @@ -191,8 +191,8 @@ type ProjectsLocationsQueuesTasksService struct { // `https://www.googleapis.com/auth/cloud-platform` The task will be // delivered to the App Engine app which belongs to the same project as // the queue. For more information, see How Requests are Routed -// (https://cloud.google.com/appengine/docs/standard/python/how-requests- -// are-routed) and how routing is affected by dispatch files +// (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed) +// and how routing is affected by dispatch files // (https://cloud.google.com/appengine/docs/python/config/dispatchref). // Traffic is encrypted during transport and never leaves Google // datacenters. Because this traffic is carried over a communication @@ -206,11 +206,11 @@ type ProjectsLocationsQueuesTasksService struct { // that the task will be sent to is: * `url =` host `+` relative_uri // Tasks can be dispatched to secure app handlers, unsecure app // handlers, and URIs restricted with `login: admin` -// (https://cloud.google.com/appengine/docs/standard/python/config/appref -// ). Because tasks are not run as any user, they cannot be dispatched -// to URIs restricted with `login: required` -// (https://cloud.google.com/appengine/docs/standard/python/config/appref -// ) Task dispatches also do not follow redirects. The task attempt has +// (https://cloud.google.com/appengine/docs/standard/python/config/appref). +// Because tasks are not run as any user, they cannot be dispatched to +// URIs restricted with `login: required` +// (https://cloud.google.com/appengine/docs/standard/python/config/appref) +// Task dispatches also do not follow redirects. The task attempt has // succeeded if the app's request handler returns an HTTP response code // in the range [`200` - `299`]. The task attempt has failed if the // app's handler returns a non-2xx response code or Cloud Tasks does not @@ -252,13 +252,12 @@ type AppEngineHttpRequest struct { // `X-AppEngine-*` In addition, Cloud Tasks sets some headers when the // task is dispatched, such as headers containing information about the // task; see request headers - // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#readi - // ng_request_headers). These headers are set only when the task is - // dispatched, so they are not visible when the task is returned in a - // Cloud Tasks response. Although there is no specific limit for the - // maximum number of headers or the size, there is a limit on the - // maximum size of the Task. For more information, see the CreateTask - // documentation. + // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#reading_request_headers). + // These headers are set only when the task is dispatched, so they are + // not visible when the task is returned in a Cloud Tasks response. + // Although there is no specific limit for the maximum number of headers + // or the size, there is a limit on the maximum size of the Task. For + // more information, see the CreateTask documentation. Headers map[string]string `json:"headers,omitempty"` // HttpMethod: The HTTP method to use for the request. The default is @@ -266,11 +265,10 @@ type AppEngineHttpRequest struct { // able to handle HTTP requests with this http_method, otherwise the // task attempt fails with error code 405 (Method Not Allowed). See // Writing a push task request handler - // (https://cloud.google.com/appengine/docs/java/taskqueue/push/creating- - // handlers#writing_a_push_task_request_handler) and the App Engine - // documentation for your runtime on How Requests are Handled - // (https://cloud.google.com/appengine/docs/standard/python3/how-requests - // -are-handled). + // (https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler) + // and the App Engine documentation for your runtime on How Requests are + // Handled + // (https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled). // // Possible values: // "HTTP_METHOD_UNSPECIFIED" - HTTP method unspecified @@ -318,15 +316,14 @@ func (s *AppEngineHttpRequest) MarshalJSON() ([]byte, error) { // specific to App Engine - service, version, and instance. For more // information about services, versions, and instances see An Overview // of App Engine -// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng -// ine), Microservices Architecture on Google App Engine -// (https://cloud.google.com/appengine/docs/python/microservices-on-app-e -// ngine), App Engine Standard request routing -// (https://cloud.google.com/appengine/docs/standard/python/how-requests- -// are-routed), and App Engine Flex request routing -// (https://cloud.google.com/appengine/docs/flexible/python/how-requests- -// are-routed). Using AppEngineRouting requires -// `appengine.applications.get` +// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine), +// Microservices Architecture on Google App Engine +// (https://cloud.google.com/appengine/docs/python/microservices-on-app-engine), +// App Engine Standard request routing +// (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed), +// and App Engine Flex request routing +// (https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). +// Using AppEngineRouting requires `appengine.applications.get` // (https://cloud.google.com/appengine/docs/admin-api/access-control) // Google IAM permission for the project and the following scope: // `https://www.googleapis.com/auth/cloud-platform` @@ -337,22 +334,19 @@ type AppEngineRouting struct { // version, and instance. Tasks which were created using the App Engine // SDK might have a custom domain name. For more information, see How // Requests are Routed - // (https://cloud.google.com/appengine/docs/standard/python/how-requests- - // are-routed). + // (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed). Host string `json:"host,omitempty"` // Instance: App instance. By default, the task is sent to an instance // which is available when the task is attempted. Requests can only be // sent to a specific instance if manual scaling is used in App Engine // Standard - // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng - // ine?hl=en_US#scaling_types_and_instance_classes). App Engine Flex - // does not support instances. For more information, see App Engine - // Standard request routing - // (https://cloud.google.com/appengine/docs/standard/python/how-requests- - // are-routed) and App Engine Flex request routing - // (https://cloud.google.com/appengine/docs/flexible/python/how-requests- - // are-routed). + // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes). + // App Engine Flex does not support instances. For more information, see + // App Engine Standard request routing + // (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed) + // and App Engine Flex request routing + // (https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). Instance string `json:"instance,omitempty"` // Service: App service. By default, the task is sent to the service @@ -1201,23 +1195,21 @@ type Queue struct { // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see // Identifying projects - // (https://cloud.google.com/resource-manager/docs/creating-managing-proj - // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for - // the queue's location. The list of available locations can be obtained - // by calling ListLocations. For more information, see - // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain - // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum - // length is 100 characters. + // (https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) + // * `LOCATION_ID` is the canonical ID for the queue's location. The + // list of available locations can be obtained by calling ListLocations. + // For more information, see https://cloud.google.com/about/locations/. + // * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or + // hyphens (-). The maximum length is 100 characters. Name string `json:"name,omitempty"` // PurgeTime: Output only. The last time this queue was purged. All // tasks that were created before this time were purged. A queue can be // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud // Console - // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus - // h/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). Purge - // time will be truncated to the nearest microsecond. Purge time will be - // unset if the queue has never been purged. + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). + // Purge time will be truncated to the nearest microsecond. Purge time + // will be unset if the queue has never been purged. PurgeTime string `json:"purgeTime,omitempty"` // RateLimits: Rate limits for task dispatches. rate_limits and @@ -1244,8 +1236,7 @@ type Queue struct { // in the queue which do not have retry settings explicitly set on the // task and were created by the App Engine SDK. See App Engine // documentation - // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus - // h/retrying-tasks). + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks). RetryConfig *RetryConfig `json:"retryConfig,omitempty"` // StackdriverLoggingConfig: Configuration options for writing logs to @@ -1331,12 +1322,11 @@ type RateLimits struct { // `max_burst_size` based on the value of max_dispatches_per_second. For // queues that were created or updated using `queue.yaml/xml`, // `max_burst_size` is equal to bucket_size - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#bucket_size). Since `max_burst_size` is output only, if - // UpdateQueue is called on a queue created by `queue.yaml/xml`, - // `max_burst_size` will be reset based on the value of - // max_dispatches_per_second, regardless of whether - // max_dispatches_per_second is updated. + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#bucket_size). + // Since `max_burst_size` is output only, if UpdateQueue is called on a + // queue created by `queue.yaml/xml`, `max_burst_size` will be reset + // based on the value of max_dispatches_per_second, regardless of + // whether max_dispatches_per_second is updated. MaxBurstSize int64 `json:"maxBurstSize,omitempty"` // MaxConcurrentDispatches: The maximum number of concurrent tasks that @@ -1346,16 +1336,14 @@ type RateLimits struct { // queue is created, Cloud Tasks will pick the default. The maximum // allowed value is 5,000. This field has the same meaning as // max_concurrent_requests in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#max_concurrent_requests). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#max_concurrent_requests). MaxConcurrentDispatches int64 `json:"maxConcurrentDispatches,omitempty"` // MaxDispatchesPerSecond: The maximum rate at which tasks are // dispatched from this queue. If unspecified when the queue is created, // Cloud Tasks will pick the default. * The maximum allowed value is // 500. This field has the same meaning as rate in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#rate). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate). MaxDispatchesPerSecond float64 `json:"maxDispatchesPerSecond,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxBurstSize") to @@ -1408,8 +1396,7 @@ type RetryConfig struct { // unspecified when the queue is created, Cloud Tasks will pick the // default. -1 indicates unlimited attempts. This field has the same // meaning as task_retry_limit in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxAttempts int64 `json:"maxAttempts,omitempty"` // MaxBackoff: A task will be scheduled for retry between min_backoff @@ -1418,8 +1405,7 @@ type RetryConfig struct { // queue is created, Cloud Tasks will pick the default. `max_backoff` // will be truncated to the nearest second. This field has the same // meaning as max_backoff_seconds in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxBackoff string `json:"maxBackoff,omitempty"` // MaxDoublings: The time between retries will double `max_doublings` @@ -1434,8 +1420,7 @@ type RetryConfig struct { // 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, .... If unspecified when // the queue is created, Cloud Tasks will pick the default. This field // has the same meaning as max_doublings in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxDoublings int64 `json:"maxDoublings,omitempty"` // MaxRetryDuration: If positive, `max_retry_duration` specifies the @@ -1447,8 +1432,7 @@ type RetryConfig struct { // will pick the default. `max_retry_duration` will be truncated to the // nearest second. This field has the same meaning as task_age_limit in // queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxRetryDuration string `json:"maxRetryDuration,omitempty"` // MinBackoff: A task will be scheduled for retry between min_backoff @@ -1457,8 +1441,7 @@ type RetryConfig struct { // queue is created, Cloud Tasks will pick the default. `min_backoff` // will be truncated to the nearest second. This field has the same // meaning as min_backoff_seconds in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MinBackoff string `json:"minBackoff,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxAttempts") to @@ -1680,19 +1663,18 @@ type Task struct { // must be in the interval [15 seconds, 30 minutes]. * For App Engine // tasks, 0 indicates that the request has the default deadline. The // default deadline depends on the scaling type - // (https://cloud.google.com/appengine/docs/standard/go/how-instances-are - // -managed#instance_scaling) of the service: 10 minutes for standard - // apps with automatic scaling, 24 hours for standard apps with manual - // and basic scaling, and 60 minutes for flex apps. If the request - // deadline is set, it must be in the interval [15 seconds, 24 hours 15 - // seconds]. Regardless of the task's `dispatch_deadline`, the app - // handler will not run for longer than than the service's timeout. We - // recommend setting the `dispatch_deadline` to at most a few seconds - // more than the app handler's timeout. For more information see - // Timeouts - // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeo - // uts). `dispatch_deadline` will be truncated to the nearest - // millisecond. The deadline is an approximate deadline. + // (https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling) + // of the service: 10 minutes for standard apps with automatic scaling, + // 24 hours for standard apps with manual and basic scaling, and 60 + // minutes for flex apps. If the request deadline is set, it must be in + // the interval [15 seconds, 24 hours 15 seconds]. Regardless of the + // task's `dispatch_deadline`, the app handler will not run for longer + // than than the service's timeout. We recommend setting the + // `dispatch_deadline` to at most a few seconds more than the app + // handler's timeout. For more information see Timeouts + // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts). + // `dispatch_deadline` will be truncated to the nearest millisecond. The + // deadline is an approximate deadline. DispatchDeadline string `json:"dispatchDeadline,omitempty"` // FirstAttempt: Output only. The status of the task's first attempt. @@ -1713,15 +1695,14 @@ type Task struct { // ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), // hyphens (-), colons (:), or periods (.). For more information, see // Identifying projects - // (https://cloud.google.com/resource-manager/docs/creating-managing-proj - // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for - // the task's location. The list of available locations can be obtained - // by calling ListLocations. For more information, see - // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain - // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum - // length is 100 characters. * `TASK_ID` can contain only letters - // ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores (_). The - // maximum length is 500 characters. + // (https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) + // * `LOCATION_ID` is the canonical ID for the task's location. The list + // of available locations can be obtained by calling ListLocations. For + // more information, see https://cloud.google.com/about/locations/. * + // `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or + // hyphens (-). The maximum length is 100 characters. * `TASK_ID` can + // contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or + // underscores (_). The maximum length is 500 characters. Name string `json:"name,omitempty"` // ResponseCount: Output only. The number of attempts which have diff --git a/cloudtasks/v2beta2/cloudtasks-gen.go b/cloudtasks/v2beta2/cloudtasks-gen.go index 84d1d187983..36ad2ef77e0 100644 --- a/cloudtasks/v2beta2/cloudtasks-gen.go +++ b/cloudtasks/v2beta2/cloudtasks-gen.go @@ -224,8 +224,8 @@ func (s *AcknowledgeTaskRequest) MarshalJSON() ([]byte, error) { // `https://www.googleapis.com/auth/cloud-platform` The task will be // delivered to the App Engine app which belongs to the same project as // the queue. For more information, see How Requests are Routed -// (https://cloud.google.com/appengine/docs/standard/python/how-requests- -// are-routed) and how routing is affected by dispatch files +// (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed) +// and how routing is affected by dispatch files // (https://cloud.google.com/appengine/docs/python/config/dispatchref). // Traffic is encrypted during transport and never leaves Google // datacenters. Because this traffic is carried over a communication @@ -239,11 +239,11 @@ func (s *AcknowledgeTaskRequest) MarshalJSON() ([]byte, error) { // sent to is: * `url =` host `+` relative_url Tasks can be dispatched // to secure app handlers, unsecure app handlers, and URIs restricted // with `login: admin` -// (https://cloud.google.com/appengine/docs/standard/python/config/appref -// ). Because tasks are not run as any user, they cannot be dispatched -// to URIs restricted with `login: required` -// (https://cloud.google.com/appengine/docs/standard/python/config/appref -// ) Task dispatches also do not follow redirects. The task attempt has +// (https://cloud.google.com/appengine/docs/standard/python/config/appref). +// Because tasks are not run as any user, they cannot be dispatched to +// URIs restricted with `login: required` +// (https://cloud.google.com/appengine/docs/standard/python/config/appref) +// Task dispatches also do not follow redirects. The task attempt has // succeeded if the app's request handler returns an HTTP response code // in the range [`200` - `299`]. The task attempt has failed if the // app's handler returns a non-2xx response code or Cloud Tasks does not @@ -279,13 +279,12 @@ type AppEngineHttpRequest struct { // `X-AppEngine-*` In addition, Cloud Tasks sets some headers when the // task is dispatched, such as headers containing information about the // task; see request headers - // (https://cloud.google.com/appengine/docs/python/taskqueue/push/creatin - // g-handlers#reading_request_headers). These headers are set only when - // the task is dispatched, so they are not visible when the task is - // returned in a Cloud Tasks response. Although there is no specific - // limit for the maximum number of headers or the size, there is a limit - // on the maximum size of the Task. For more information, see the - // CreateTask documentation. + // (https://cloud.google.com/appengine/docs/python/taskqueue/push/creating-handlers#reading_request_headers). + // These headers are set only when the task is dispatched, so they are + // not visible when the task is returned in a Cloud Tasks response. + // Although there is no specific limit for the maximum number of headers + // or the size, there is a limit on the maximum size of the Task. For + // more information, see the CreateTask documentation. Headers map[string]string `json:"headers,omitempty"` // HttpMethod: The HTTP method to use for the request. The default is @@ -293,11 +292,10 @@ type AppEngineHttpRequest struct { // able to handle HTTP requests with this http_method, otherwise the // task attempt fails with error code 405 (Method Not Allowed). See // Writing a push task request handler - // (https://cloud.google.com/appengine/docs/java/taskqueue/push/creating- - // handlers#writing_a_push_task_request_handler) and the App Engine - // documentation for your runtime on How Requests are Handled - // (https://cloud.google.com/appengine/docs/standard/python3/how-requests - // -are-handled). + // (https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler) + // and the App Engine documentation for your runtime on How Requests are + // Handled + // (https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled). // // Possible values: // "HTTP_METHOD_UNSPECIFIED" - HTTP method unspecified @@ -389,21 +387,19 @@ func (s *AppEngineHttpTarget) MarshalJSON() ([]byte, error) { // specific to App Engine - service, version, and instance. For more // information about services, versions, and instances see An Overview // of App Engine -// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng -// ine), Microservices Architecture on Google App Engine -// (https://cloud.google.com/appengine/docs/python/microservices-on-app-e -// ngine), App Engine Standard request routing -// (https://cloud.google.com/appengine/docs/standard/python/how-requests- -// are-routed), and App Engine Flex request routing -// (https://cloud.google.com/appengine/docs/flexible/python/how-requests- -// are-routed). +// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine), +// Microservices Architecture on Google App Engine +// (https://cloud.google.com/appengine/docs/python/microservices-on-app-engine), +// App Engine Standard request routing +// (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed), +// and App Engine Flex request routing +// (https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). type AppEngineRouting struct { // Host: Output only. The host that the task is sent to. For more // information, see How Requests are Routed - // (https://cloud.google.com/appengine/docs/standard/python/how-requests- - // are-routed). The host is constructed as: * `host = - // [application_domain_name]` `| [service] + '.' + - // [application_domain_name]` `| [version] + '.' + + // (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed). + // The host is constructed as: * `host = [application_domain_name]` `| + // [service] + '.' + [application_domain_name]` `| [version] + '.' + // [application_domain_name]` `| [version_dot_service]+ '.' + // [application_domain_name]` `| [instance] + '.' + // [application_domain_name]` `| [instance_dot_service] + '.' + @@ -431,14 +427,12 @@ type AppEngineRouting struct { // which is available when the task is attempted. Requests can only be // sent to a specific instance if manual scaling is used in App Engine // Standard - // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng - // ine?hl=en_US#scaling_types_and_instance_classes). App Engine Flex - // does not support instances. For more information, see App Engine - // Standard request routing - // (https://cloud.google.com/appengine/docs/standard/python/how-requests- - // are-routed) and App Engine Flex request routing - // (https://cloud.google.com/appengine/docs/flexible/python/how-requests- - // are-routed). + // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes). + // App Engine Flex does not support instances. For more information, see + // App Engine Standard request routing + // (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed) + // and App Engine Flex request routing + // (https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). Instance string `json:"instance,omitempty"` // Service: App service. By default, the task is sent to the service @@ -878,10 +872,9 @@ type LeaseTasksRequest struct { // `oldest_tag()` function returns tasks which have the same tag as the // oldest task (ordered by schedule time). SDK compatibility: Although // the SDK allows tags to be either string or bytes - // (https://cloud.google.com/appengine/docs/standard/java/javadoc/com/goo - // gle/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), only UTF-8 - // encoded tags can be used in Cloud Tasks. Tag which aren't UTF-8 - // encoded can't be used in the filter and the task's tag will be + // (https://cloud.google.com/appengine/docs/standard/java/javadoc/com/google/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), + // only UTF-8 encoded tags can be used in Cloud Tasks. Tag which aren't + // UTF-8 encoded can't be used in the filter and the task's tag will be // displayed as empty in Cloud Tasks. Filter string `json:"filter,omitempty"` @@ -1265,11 +1258,10 @@ type PullMessage struct { // is created. The tag must be less than 500 characters. SDK // compatibility: Although the SDK allows tags to be either string or // bytes - // (https://cloud.google.com/appengine/docs/standard/java/javadoc/com/goo - // gle/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), only UTF-8 - // encoded tags can be used in Cloud Tasks. If a tag isn't UTF-8 - // encoded, the tag will be empty when the task is returned by Cloud - // Tasks. + // (https://cloud.google.com/appengine/docs/standard/java/javadoc/com/google/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), + // only UTF-8 encoded tags can be used in Cloud Tasks. If a tag isn't + // UTF-8 encoded, the tag will be empty when the task is returned by + // Cloud Tasks. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Payload") to @@ -1318,13 +1310,12 @@ type Queue struct { // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see // Identifying projects - // (https://cloud.google.com/resource-manager/docs/creating-managing-proj - // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for - // the queue's location. The list of available locations can be obtained - // by calling ListLocations. For more information, see - // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain - // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum - // length is 100 characters. + // (https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) + // * `LOCATION_ID` is the canonical ID for the queue's location. The + // list of available locations can be obtained by calling ListLocations. + // For more information, see https://cloud.google.com/about/locations/. + // * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or + // hyphens (-). The maximum length is 100 characters. Name string `json:"name,omitempty"` // PullTarget: Pull target. A pull queue is a queue that has a @@ -1335,10 +1326,9 @@ type Queue struct { // tasks that were created before this time were purged. A queue can be // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud // Console - // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus - // h/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). Purge - // time will be truncated to the nearest microsecond. Purge time will be - // unset if the queue has never been purged. + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). + // Purge time will be truncated to the nearest microsecond. Purge time + // will be unset if the queue has never been purged. PurgeTime string `json:"purgeTime,omitempty"` // RateLimits: Rate limits for task dispatches. rate_limits and @@ -1360,8 +1350,7 @@ type Queue struct { // in the queue which do not have retry settings explicitly set on the // task and were created by the App Engine SDK. See App Engine // documentation - // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus - // h/retrying-tasks). + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks). RetryConfig *RetryConfig `json:"retryConfig,omitempty"` // State: Output only. The state of the queue. `state` can only be @@ -1517,11 +1506,10 @@ type RateLimits struct { // max_dispatches_per_second. The maximum value of `max_burst_size` is // 500. For App Engine queues that were created or updated using // `queue.yaml/xml`, `max_burst_size` is equal to bucket_size - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#bucket_size). If UpdateQueue is called on a queue without - // explicitly setting a value for `max_burst_size`, `max_burst_size` - // value will get updated if UpdateQueue is updating - // max_dispatches_per_second. + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#bucket_size). + // If UpdateQueue is called on a queue without explicitly setting a + // value for `max_burst_size`, `max_burst_size` value will get updated + // if UpdateQueue is updating max_dispatches_per_second. MaxBurstSize int64 `json:"maxBurstSize,omitempty"` // MaxConcurrentTasks: The maximum number of concurrent tasks that Cloud @@ -1533,8 +1521,7 @@ type RateLimits struct { // always -1, which indicates no limit. No other queue types can have // `max_concurrent_tasks` set to -1. This field has the same meaning as // max_concurrent_requests in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#max_concurrent_requests). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#max_concurrent_requests). MaxConcurrentTasks int64 `json:"maxConcurrentTasks,omitempty"` // MaxTasksDispatchedPerSecond: The maximum rate at which tasks are @@ -1544,8 +1531,7 @@ type RateLimits struct { // queues. In addition to the `max_tasks_dispatched_per_second` limit, a // maximum of 10 QPS of LeaseTasks requests are allowed per pull queue. // This field has the same meaning as rate in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#rate). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate). MaxTasksDispatchedPerSecond float64 `json:"maxTasksDispatchedPerSecond,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxBurstSize") to @@ -1664,8 +1650,7 @@ type RetryConfig struct { // output only for pull queues. `max_backoff` will be truncated to the // nearest second. This field has the same meaning as // max_backoff_seconds in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxBackoff string `json:"maxBackoff,omitempty"` // MaxDoublings: The time between retries will double `max_doublings` @@ -1681,8 +1666,7 @@ type RetryConfig struct { // the queue is created, Cloud Tasks will pick the default. This field // is output only for pull queues. This field has the same meaning as // max_doublings in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxDoublings int64 `json:"maxDoublings,omitempty"` // MaxRetryDuration: If positive, `max_retry_duration` specifies the @@ -1694,8 +1678,7 @@ type RetryConfig struct { // will pick the default. This field is output only for pull queues. // `max_retry_duration` will be truncated to the nearest second. This // field has the same meaning as task_age_limit in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxRetryDuration string `json:"maxRetryDuration,omitempty"` // MinBackoff: A task will be scheduled for retry between min_backoff @@ -1705,8 +1688,7 @@ type RetryConfig struct { // output only for pull queues. `min_backoff` will be truncated to the // nearest second. This field has the same meaning as // min_backoff_seconds in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MinBackoff string `json:"minBackoff,omitempty"` // UnlimitedAttempts: If true, then the number of attempts is unlimited. @@ -1876,15 +1858,14 @@ type Task struct { // ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), // hyphens (-), colons (:), or periods (.). For more information, see // Identifying projects - // (https://cloud.google.com/resource-manager/docs/creating-managing-proj - // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for - // the task's location. The list of available locations can be obtained - // by calling ListLocations. For more information, see - // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain - // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum - // length is 100 characters. * `TASK_ID` can contain only letters - // ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores (_). The - // maximum length is 500 characters. + // (https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) + // * `LOCATION_ID` is the canonical ID for the task's location. The list + // of available locations can be obtained by calling ListLocations. For + // more information, see https://cloud.google.com/about/locations/. * + // `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or + // hyphens (-). The maximum length is 100 characters. * `TASK_ID` can + // contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or + // underscores (_). The maximum length is 500 characters. Name string `json:"name,omitempty"` // PullMessage: LeaseTasks to process the task. Can be set only if diff --git a/cloudtasks/v2beta3/cloudtasks-gen.go b/cloudtasks/v2beta3/cloudtasks-gen.go index fd468774dc0..3f3e4fa0575 100644 --- a/cloudtasks/v2beta3/cloudtasks-gen.go +++ b/cloudtasks/v2beta3/cloudtasks-gen.go @@ -231,8 +231,8 @@ func (s *AppEngineHttpQueue) MarshalJSON() ([]byte, error) { // `https://www.googleapis.com/auth/cloud-platform` The task will be // delivered to the App Engine app which belongs to the same project as // the queue. For more information, see How Requests are Routed -// (https://cloud.google.com/appengine/docs/standard/python/how-requests- -// are-routed) and how routing is affected by dispatch files +// (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed) +// and how routing is affected by dispatch files // (https://cloud.google.com/appengine/docs/python/config/dispatchref). // Traffic is encrypted during transport and never leaves Google // datacenters. Because this traffic is carried over a communication @@ -246,11 +246,11 @@ func (s *AppEngineHttpQueue) MarshalJSON() ([]byte, error) { // sent to is: * `url =` host `+` relative_uri Tasks can be dispatched // to secure app handlers, unsecure app handlers, and URIs restricted // with `login: admin` -// (https://cloud.google.com/appengine/docs/standard/python/config/appref -// ). Because tasks are not run as any user, they cannot be dispatched -// to URIs restricted with `login: required` -// (https://cloud.google.com/appengine/docs/standard/python/config/appref -// ) Task dispatches also do not follow redirects. The task attempt has +// (https://cloud.google.com/appengine/docs/standard/python/config/appref). +// Because tasks are not run as any user, they cannot be dispatched to +// URIs restricted with `login: required` +// (https://cloud.google.com/appengine/docs/standard/python/config/appref) +// Task dispatches also do not follow redirects. The task attempt has // succeeded if the app's request handler returns an HTTP response code // in the range [`200` - `299`]. The task attempt has failed if the // app's handler returns a non-2xx response code or Cloud Tasks does not @@ -291,13 +291,12 @@ type AppEngineHttpRequest struct { // `X-AppEngine-*` In addition, Cloud Tasks sets some headers when the // task is dispatched, such as headers containing information about the // task; see request headers - // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#readi - // ng_request_headers). These headers are set only when the task is - // dispatched, so they are not visible when the task is returned in a - // Cloud Tasks response. Although there is no specific limit for the - // maximum number of headers or the size, there is a limit on the - // maximum size of the Task. For more information, see the CreateTask - // documentation. + // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#reading_request_headers). + // These headers are set only when the task is dispatched, so they are + // not visible when the task is returned in a Cloud Tasks response. + // Although there is no specific limit for the maximum number of headers + // or the size, there is a limit on the maximum size of the Task. For + // more information, see the CreateTask documentation. Headers map[string]string `json:"headers,omitempty"` // HttpMethod: The HTTP method to use for the request. The default is @@ -305,11 +304,10 @@ type AppEngineHttpRequest struct { // able to handle HTTP requests with this http_method, otherwise the // task attempt fails with error code 405 (Method Not Allowed). See // Writing a push task request handler - // (https://cloud.google.com/appengine/docs/java/taskqueue/push/creating- - // handlers#writing_a_push_task_request_handler) and the App Engine - // documentation for your runtime on How Requests are Handled - // (https://cloud.google.com/appengine/docs/standard/python3/how-requests - // -are-handled). + // (https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler) + // and the App Engine documentation for your runtime on How Requests are + // Handled + // (https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled). // // Possible values: // "HTTP_METHOD_UNSPECIFIED" - HTTP method unspecified @@ -357,14 +355,13 @@ func (s *AppEngineHttpRequest) MarshalJSON() ([]byte, error) { // specific to App Engine - service, version, and instance. For more // information about services, versions, and instances see An Overview // of App Engine -// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng -// ine), Microservices Architecture on Google App Engine -// (https://cloud.google.com/appengine/docs/python/microservices-on-app-e -// ngine), App Engine Standard request routing -// (https://cloud.google.com/appengine/docs/standard/python/how-requests- -// are-routed), and App Engine Flex request routing -// (https://cloud.google.com/appengine/docs/flexible/python/how-requests- -// are-routed). +// (https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine), +// Microservices Architecture on Google App Engine +// (https://cloud.google.com/appengine/docs/python/microservices-on-app-engine), +// App Engine Standard request routing +// (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed), +// and App Engine Flex request routing +// (https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). type AppEngineRouting struct { // Host: Output only. The host that the task is sent to. The host is // constructed from the domain name of the app associated with the @@ -372,22 +369,19 @@ type AppEngineRouting struct { // version, and instance. Tasks which were created using the App Engine // SDK might have a custom domain name. For more information, see How // Requests are Routed - // (https://cloud.google.com/appengine/docs/standard/python/how-requests- - // are-routed). + // (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed). Host string `json:"host,omitempty"` // Instance: App instance. By default, the task is sent to an instance // which is available when the task is attempted. Requests can only be // sent to a specific instance if manual scaling is used in App Engine // Standard - // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-eng - // ine?hl=en_US#scaling_types_and_instance_classes). App Engine Flex - // does not support instances. For more information, see App Engine - // Standard request routing - // (https://cloud.google.com/appengine/docs/standard/python/how-requests- - // are-routed) and App Engine Flex request routing - // (https://cloud.google.com/appengine/docs/flexible/python/how-requests- - // are-routed). + // (https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes). + // App Engine Flex does not support instances. For more information, see + // App Engine Standard request routing + // (https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed) + // and App Engine Flex request routing + // (https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). Instance string `json:"instance,omitempty"` // Service: App service. By default, the task is sent to the service @@ -1225,11 +1219,10 @@ type PullMessage struct { // Tag: The tasks's tag. The tag is less than 500 characters. SDK // compatibility: Although the SDK allows tags to be either string or // bytes - // (https://cloud.google.com/appengine/docs/standard/java/javadoc/com/goo - // gle/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), only UTF-8 - // encoded tags can be used in Cloud Tasks. If a tag isn't UTF-8 - // encoded, the tag will be empty when the task is returned by Cloud - // Tasks. + // (https://cloud.google.com/appengine/docs/standard/java/javadoc/com/google/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-), + // only UTF-8 encoded tags can be used in Cloud Tasks. If a tag isn't + // UTF-8 encoded, the tag will be empty when the task is returned by + // Cloud Tasks. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Payload") to @@ -1275,23 +1268,21 @@ type Queue struct { // `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens // (-), colons (:), or periods (.). For more information, see // Identifying projects - // (https://cloud.google.com/resource-manager/docs/creating-managing-proj - // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for - // the queue's location. The list of available locations can be obtained - // by calling ListLocations. For more information, see - // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain - // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum - // length is 100 characters. + // (https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) + // * `LOCATION_ID` is the canonical ID for the queue's location. The + // list of available locations can be obtained by calling ListLocations. + // For more information, see https://cloud.google.com/about/locations/. + // * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or + // hyphens (-). The maximum length is 100 characters. Name string `json:"name,omitempty"` // PurgeTime: Output only. The last time this queue was purged. All // tasks that were created before this time were purged. A queue can be // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud // Console - // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus - // h/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). Purge - // time will be truncated to the nearest microsecond. Purge time will be - // unset if the queue has never been purged. + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). + // Purge time will be truncated to the nearest microsecond. Purge time + // will be unset if the queue has never been purged. PurgeTime string `json:"purgeTime,omitempty"` // RateLimits: Rate limits for task dispatches. rate_limits and @@ -1318,8 +1309,7 @@ type Queue struct { // in the queue which do not have retry settings explicitly set on the // task and were created by the App Engine SDK. See App Engine // documentation - // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/pus - // h/retrying-tasks). + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks). RetryConfig *RetryConfig `json:"retryConfig,omitempty"` // StackdriverLoggingConfig: Configuration options for writing logs to @@ -1488,11 +1478,10 @@ type RateLimits struct { // max_dispatches_per_second. The maximum value of `max_burst_size` is // 500. For App Engine queues that were created or updated using // `queue.yaml/xml`, `max_burst_size` is equal to bucket_size - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#bucket_size). If UpdateQueue is called on a queue without - // explicitly setting a value for `max_burst_size`, `max_burst_size` - // value will get updated if UpdateQueue is updating - // max_dispatches_per_second. + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#bucket_size). + // If UpdateQueue is called on a queue without explicitly setting a + // value for `max_burst_size`, `max_burst_size` value will get updated + // if UpdateQueue is updating max_dispatches_per_second. MaxBurstSize int64 `json:"maxBurstSize,omitempty"` // MaxConcurrentDispatches: The maximum number of concurrent tasks that @@ -1502,8 +1491,7 @@ type RateLimits struct { // queue is created, Cloud Tasks will pick the default. The maximum // allowed value is 5,000. This field has the same meaning as // max_concurrent_requests in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#max_concurrent_requests). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#max_concurrent_requests). MaxConcurrentDispatches int64 `json:"maxConcurrentDispatches,omitempty"` // MaxDispatchesPerSecond: The maximum rate at which tasks are @@ -1511,8 +1499,7 @@ type RateLimits struct { // Cloud Tasks will pick the default. * For App Engine queues, the // maximum allowed value is 500. This field has the same meaning as rate // in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#rate). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate). MaxDispatchesPerSecond float64 `json:"maxDispatchesPerSecond,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxBurstSize") to @@ -1565,8 +1552,7 @@ type RetryConfig struct { // unspecified when the queue is created, Cloud Tasks will pick the // default. -1 indicates unlimited attempts. This field has the same // meaning as task_retry_limit in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxAttempts int64 `json:"maxAttempts,omitempty"` // MaxBackoff: A task will be scheduled for retry between min_backoff @@ -1575,8 +1561,7 @@ type RetryConfig struct { // queue is created, Cloud Tasks will pick the default. `max_backoff` // will be truncated to the nearest second. This field has the same // meaning as max_backoff_seconds in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxBackoff string `json:"maxBackoff,omitempty"` // MaxDoublings: The time between retries will double `max_doublings` @@ -1591,8 +1576,7 @@ type RetryConfig struct { // 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, .... If unspecified when // the queue is created, Cloud Tasks will pick the default. This field // has the same meaning as max_doublings in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxDoublings int64 `json:"maxDoublings,omitempty"` // MaxRetryDuration: If positive, `max_retry_duration` specifies the @@ -1604,8 +1588,7 @@ type RetryConfig struct { // will pick the default. `max_retry_duration` will be truncated to the // nearest second. This field has the same meaning as task_age_limit in // queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MaxRetryDuration string `json:"maxRetryDuration,omitempty"` // MinBackoff: A task will be scheduled for retry between min_backoff @@ -1614,8 +1597,7 @@ type RetryConfig struct { // queue is created, Cloud Tasks will pick the default. `min_backoff` // will be truncated to the nearest second. This field has the same // meaning as min_backoff_seconds in queue.yaml/xml - // (https://cloud.google.com/appengine/docs/standard/python/config/queuer - // ef#retry_parameters). + // (https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters). MinBackoff string `json:"minBackoff,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxAttempts") to @@ -1837,19 +1819,18 @@ type Task struct { // must be in the interval [15 seconds, 30 minutes]. * For App Engine // tasks, 0 indicates that the request has the default deadline. The // default deadline depends on the scaling type - // (https://cloud.google.com/appengine/docs/standard/go/how-instances-are - // -managed#instance_scaling) of the service: 10 minutes for standard - // apps with automatic scaling, 24 hours for standard apps with manual - // and basic scaling, and 60 minutes for flex apps. If the request - // deadline is set, it must be in the interval [15 seconds, 24 hours 15 - // seconds]. Regardless of the task's `dispatch_deadline`, the app - // handler will not run for longer than than the service's timeout. We - // recommend setting the `dispatch_deadline` to at most a few seconds - // more than the app handler's timeout. For more information see - // Timeouts - // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeo - // uts). `dispatch_deadline` will be truncated to the nearest - // millisecond. The deadline is an approximate deadline. + // (https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling) + // of the service: 10 minutes for standard apps with automatic scaling, + // 24 hours for standard apps with manual and basic scaling, and 60 + // minutes for flex apps. If the request deadline is set, it must be in + // the interval [15 seconds, 24 hours 15 seconds]. Regardless of the + // task's `dispatch_deadline`, the app handler will not run for longer + // than than the service's timeout. We recommend setting the + // `dispatch_deadline` to at most a few seconds more than the app + // handler's timeout. For more information see Timeouts + // (https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts). + // `dispatch_deadline` will be truncated to the nearest millisecond. The + // deadline is an approximate deadline. DispatchDeadline string `json:"dispatchDeadline,omitempty"` // FirstAttempt: Output only. The status of the task's first attempt. @@ -1870,24 +1851,23 @@ type Task struct { // ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), // hyphens (-), colons (:), or periods (.). For more information, see // Identifying projects - // (https://cloud.google.com/resource-manager/docs/creating-managing-proj - // ects#identifying_projects) * `LOCATION_ID` is the canonical ID for - // the task's location. The list of available locations can be obtained - // by calling ListLocations. For more information, see - // https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain - // letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum - // length is 100 characters. * `TASK_ID` can contain only letters - // ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores (_). The - // maximum length is 500 characters. + // (https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) + // * `LOCATION_ID` is the canonical ID for the task's location. The list + // of available locations can be obtained by calling ListLocations. For + // more information, see https://cloud.google.com/about/locations/. * + // `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or + // hyphens (-). The maximum length is 100 characters. * `TASK_ID` can + // contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or + // underscores (_). The maximum length is 500 characters. Name string `json:"name,omitempty"` // PullMessage: Pull Message contained in a task in a PULL queue type. // This payload type cannot be explicitly set through Cloud Tasks API. // Its purpose, currently is to provide backward compatibility with App // Engine Task Queue pull - // (https://cloud.google.com/appengine/docs/standard/java/taskqueue/pull/ - // ) queues to provide a way to inspect contents of pull tasks through - // the CloudTasks. + // (https://cloud.google.com/appengine/docs/standard/java/taskqueue/pull/) + // queues to provide a way to inspect contents of pull tasks through the + // CloudTasks. PullMessage *PullMessage `json:"pullMessage,omitempty"` // ResponseCount: Output only. The number of attempts which have diff --git a/cloudtrace/v2beta1/cloudtrace-gen.go b/cloudtrace/v2beta1/cloudtrace-gen.go index f1e8f74c80b..c223c0e3e4f 100644 --- a/cloudtrace/v2beta1/cloudtrace-gen.go +++ b/cloudtrace/v2beta1/cloudtrace-gen.go @@ -949,8 +949,8 @@ func (r *ProjectsTraceSinksService) Patch(nameid string, tracesink *TraceSink) * // update mask. `name` and `writer_identity` fields cannot be updated. // An empty updateMask is considered an error. For a detailed // `FieldMask` definition, see -// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask Example: -// `updateMask=output_config`. +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask +// Example: `updateMask=output_config`. func (c *ProjectsTraceSinksPatchCall) UpdateMask(updateMask string) *ProjectsTraceSinksPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/composer/v1beta1/composer-gen.go b/composer/v1beta1/composer-gen.go index 8241d4e65a2..cc596fcd290 100644 --- a/composer/v1beta1/composer-gen.go +++ b/composer/v1beta1/composer-gen.go @@ -838,8 +838,8 @@ type NodeConfig struct { // node pools if their value is not explicitly set during node pool // creation. For more information, see [Optimizing IP address // allocation] - // (https://cloud.google.com/kubernetes-engine/docs/how-to/flexible-pod-c - // idr). Cannot be updated. + // (https://cloud.google.com/kubernetes-engine/docs/how-to/flexible-pod-cidr). + // Cannot be updated. MaxPodsPerNode int64 `json:"maxPodsPerNode,omitempty"` // Network: Optional. The Compute Engine network to be used for machine diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index 6bd6b336b22..109b91bdfe5 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -2967,8 +2967,7 @@ type AttachedDiskInitializeParams struct { // not specified, the default is pd-standard, specified using the full // URL. For // example: - // https://www.googleapis.com/compute/v1/projects/project/zones/ - // zone/diskTypes/pd-standard + // https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard // // // Other values include pd-ssd and local-ssd. If you define this field, @@ -2976,6 +2975,7 @@ type AttachedDiskInitializeParams struct { // following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType + // // - projects/project/zones/zone/diskTypes/diskType // - zones/zone/diskTypes/diskType Note that for InstanceTemplate, this // is the name of the disk type, not URL. @@ -3032,13 +3032,11 @@ type AttachedDiskInitializeParams struct { // projects/debian-cloud/global/images/family/debian-9 // // - // Alternati - // vely, use a specific version of a public operating system + // Alternatively, use a specific version of a public operating system // image: // projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD // // - // // To create a disk with a custom image that you created, specify the // image name in the following // format: @@ -4244,7 +4242,8 @@ type AutoscalingPolicyCustomMetricUtilization struct { // proportionally to the metric. // // For example, a good metric to use as a utilization_target is - // https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. The autoscaler works to keep this value constant for each of the + // https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. + // The autoscaler works to keep this value constant for each of the // instances. UtilizationTarget float64 `json:"utilizationTarget,omitempty"` @@ -5192,8 +5191,7 @@ func (s *BackendBucketListWarningData) MarshalJSON() ([]byte, error) { // Regional // (/compute/docs/reference/rest/{$api_version}/regionBackendServices) // -// F -// or more information, see Backend Services. +// For more information, see Backend Services. // // (== resource_for {$api_version}.backendService ==) type BackendService struct { @@ -6957,6 +6955,7 @@ type BulkInsertInstanceResource struct { // valid URLs to an instance template: // - // https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + // // - projects/project/global/instanceTemplates/instanceTemplate // - global/instanceTemplates/instanceTemplate // @@ -8164,8 +8163,7 @@ type CustomerEncryptionKey struct { // - After being wrapped, the key must be encoded in RFC 4648 base64 // encoding. Gets the RSA public key certificate provided by Google // at: - // https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingre - // ss.pem + // https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem RsaEncryptedKey string `json:"rsaEncryptedKey,omitempty"` // Sha256: [Output only] The RFC 4648 base64 encoded SHA-256 hash of the @@ -8462,6 +8460,7 @@ type Disk struct { // following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk SourceDisk string `json:"sourceDisk,omitempty"` @@ -8484,13 +8483,11 @@ type Disk struct { // projects/debian-cloud/global/images/family/debian-9 // // - // Alternati - // vely, use a specific version of a public operating system + // Alternatively, use a specific version of a public operating system // image: // projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD // // - // // To create a disk with a custom image that you created, specify the // image name in the following // format: @@ -8522,6 +8519,7 @@ type Disk struct { // the resource. For example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/global/inPlaceSnapshots/inPlaceSnapshots + // // - projects/project/global/inPlaceSnapshots/inPlaceSnapshots // - global/inPlaceSnapshots/inPlaceSnapshots SourceInPlaceSnapshot string `json:"sourceInPlaceSnapshot,omitempty"` @@ -8540,6 +8538,7 @@ type Disk struct { // resource. For example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot + // // - projects/project/zones/zone/instantSnapshots/instantSnapshot // - zones/zone/instantSnapshots/instantSnapshot SourceInstantSnapshot string `json:"sourceInstantSnapshot,omitempty"` @@ -8558,6 +8557,7 @@ type Disk struct { // the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot + // // - projects/project/global/snapshots/snapshot // - global/snapshots/snapshot SourceSnapshot string `json:"sourceSnapshot,omitempty"` @@ -8611,8 +8611,7 @@ type Disk struct { // disk is created. This includes a list of URLs to the license // resource. For example, to provide a debian // license: - // https://www.googleapis.com/compute/v1/projects/debian-cloud/g - // lobal/licenses/debian-9-stretch + // https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch UserLicenses []string `json:"userLicenses,omitempty"` // Users: [Output Only] Links to the users of the disk (attached @@ -9049,6 +9048,7 @@ type DiskMoveRequest struct { // // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk TargetDisk string `json:"targetDisk,omitempty"` @@ -10675,6 +10675,7 @@ type Firewall struct { // // - // https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network + // // - projects/myproject/global/networks/my-network // - global/networks/default Network string `json:"network,omitempty"` @@ -11595,7 +11596,8 @@ type ForwardingRule struct { // is assigned. Methods for specifying an IP address: // // * IPv4 dotted decimal, as in `100.1.2.3` * Full URL, as in - // https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name * Partial URL or by name, as in: + // https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name + // * Partial URL or by name, as in: // - projects/project_id/regions/region/addresses/address-name // - regions/region/addresses/address-name // - global/addresses/address-name @@ -13130,8 +13132,7 @@ func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error) { // Regional // (/compute/docs/reference/rest/{$api_version}/regionHealthChecks) // -// Inte -// rnal HTTP(S) load balancers must use regional health checks +// Internal HTTP(S) load balancers must use regional health checks // (`compute.v1.regionHealthChecks`). // // Traffic Director must use global health checks @@ -13454,6 +13455,7 @@ func (s *HealthCheckLogConfig) MarshalJSON() ([]byte, error) { // For example, the following are valid URLs: // - // https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check +// // - projects/project-id/global/httpHealthChecks/health-check // - global/httpHealthChecks/health-check type HealthCheckReference struct { @@ -13622,6 +13624,7 @@ func (s *HealthCheckService) MarshalJSON() ([]byte, error) { // check service. For example, the following are valid URLs: // - // https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service +// // - // projects/project-id/regions/us-west1/healthCheckServices/health-check- // service @@ -15725,6 +15728,7 @@ type Image struct { // image. For example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk SourceDisk string `json:"sourceDisk,omitempty"` @@ -16106,6 +16110,7 @@ type InPlaceSnapshot struct { // partial URL. For example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk SourceDisk string `json:"sourceDisk,omitempty"` @@ -19900,6 +19905,7 @@ type InstanceMoveRequest struct { // an instance: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance // - zones/zone/instances/instance TargetInstance string `json:"targetInstance,omitempty"` @@ -20137,6 +20143,7 @@ type InstanceTemplate struct { // example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance SourceInstance string `json:"sourceInstance,omitempty"` @@ -21021,6 +21028,7 @@ type InstantSnapshot struct { // partial URL. For example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk SourceDisk string `json:"sourceDisk,omitempty"` @@ -24500,6 +24508,7 @@ type MachineImage struct { // example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance SourceInstance string `json:"sourceInstance,omitempty"` @@ -27208,6 +27217,7 @@ type NetworkInterface struct { // or partial URL. For example, the following are all valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project/global/networks/network + // // - projects/project/global/networks/network // - global/networks/default Network string `json:"network,omitempty"` @@ -27253,6 +27263,7 @@ type NetworkInterface struct { // are all valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork + // // - regions/region/subnetworks/subnetwork Subnetwork string `json:"subnetwork,omitempty"` @@ -32024,6 +32035,7 @@ type PathMatcher struct { // are all valid URLs to a BackendService resource: // - // https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService + // // - compute/v1/projects/project/global/backendServices/backendService // // - global/backendServices/backendService If defaultRouteAction is @@ -32365,8 +32377,7 @@ func (s *PermissionConstraint) MarshalJSON() ([]byte, error) { // their IAM policies, see the IAM documentation // (https://cloud.google.com/iam/help/conditions/resource-policies). // -// **J -// SON example:** +// **JSON example:** // // { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", // "members": [ "user:mike@example.com", "group:admins@example.com", @@ -37986,14 +37997,14 @@ type Route struct { // - 10.128.0.56 // - // https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule + // // - regions/region/forwardingRules/forwardingRule NextHopIlb string `json:"nextHopIlb,omitempty"` // NextHopInstance: The URL to an instance that should handle matching // packets. You can specify this as a full or partial URL. For // example: - // https://www.googleapis.com/compute/v1/projects/project/zones/ - // zone/instances/ + // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ NextHopInstance string `json:"nextHopInstance,omitempty"` // NextHopInterconnectAttachment: [Output Only] The URL to an @@ -42437,6 +42448,7 @@ type SourceDiskEncryptionKey struct { // values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk SourceDisk string `json:"sourceDisk,omitempty"` @@ -42600,7 +42612,6 @@ func (s *SourceInstanceProperties) MarshalJSON() ([]byte, error) { // // // -// // The sslCertificates are used by: // - external HTTPS load balancers // - SSL proxy load balancers @@ -45256,7 +45267,6 @@ func (s *TargetHttpProxiesScopedListWarningData) MarshalJSON() ([]byte, error) { // Regional // (/compute/docs/reference/rest/{$api_version}/regionTargetHttpProxies) // -// // A target HTTP proxy is a component of GCP HTTP load balancers. // // * targetHttpProxies are used by external HTTP load balancers and @@ -45288,7 +45298,15 @@ type TargetHttpProxy struct { // HttpFilters: URLs to networkservices.HttpFilter resources enabled for // xDS clients using this configuration. For example, - // https://networkservices.googleapis.com/v1alpha1/projects/project/locations/locationhttpFilters/httpFilter Only filters that handle outbound connection and stream events may be specified. These filters work in conjunction with a default set of HTTP filters that may already be configured by Traffic Director. Traffic Director will determine the final location of these filters within xDS configuration based on the name of the HTTP filter. If Traffic Director positions multiple filters at the same location, those filters will be in the same order as specified in this list. + // https://networkservices.googleapis.com/v1alpha1/projects/project/locations/locationhttpFilters/httpFilter + // Only filters that handle outbound connection and stream events may be + // specified. These filters work in conjunction with a default set of + // HTTP filters that may already be configured by Traffic Director. + // Traffic Director will determine the final location of these filters + // within xDS configuration based on the name of the HTTP filter. If + // Traffic Director positions multiple filters at the same location, + // those filters will be in the same order as specified in this + // list. // httpFilters only applies for loadbalancers with loadBalancingScheme // set to INTERNAL_SELF_MANAGED. See ForwardingRule for more details. HttpFilters []string `json:"httpFilters,omitempty"` @@ -45980,7 +45998,15 @@ type TargetHttpsProxy struct { // HttpFilters: URLs to networkservices.HttpFilter resources enabled for // xDS clients using this configuration. For example, - // https://networkservices.googleapis.com/beta/projects/project/locations/locationhttpFilters/httpFilter Only filters that handle outbound connection and stream events may be specified. These filters work in conjunction with a default set of HTTP filters that may already be configured by Traffic Director. Traffic Director will determine the final location of these filters within xDS configuration based on the name of the HTTP filter. If Traffic Director positions multiple filters at the same location, those filters will be in the same order as specified in this list. + // https://networkservices.googleapis.com/beta/projects/project/locations/locationhttpFilters/httpFilter + // Only filters that handle outbound connection and stream events may be + // specified. These filters work in conjunction with a default set of + // HTTP filters that may already be configured by Traffic Director. + // Traffic Director will determine the final location of these filters + // within xDS configuration based on the name of the HTTP filter. If + // Traffic Director positions multiple filters at the same location, + // those filters will be in the same order as specified in this + // list. // httpFilters only applies for loadbalancers with loadBalancingScheme // set to INTERNAL_SELF_MANAGED. See ForwardingRule for more details. HttpFilters []string `json:"httpFilters,omitempty"` @@ -46073,6 +46099,7 @@ type TargetHttpsProxy struct { // the following are all valid URLs for specifying a URL map: // - // https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map + // // - projects/project/global/urlMaps/url-map // - global/urlMaps/url-map UrlMap string `json:"urlMap,omitempty"` @@ -46450,6 +46477,7 @@ type TargetInstance struct { // virtual machine. For example, the following are all valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance // - zones/zone/instances/instance Instance string `json:"instance,omitempty"` @@ -47511,6 +47539,7 @@ type TargetPoolsAddInstanceRequest struct { // are valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name + // // - projects/project-id/zones/zone/instances/instance-name // - zones/zone/instances/instance-name Instances []*InstanceReference `json:"instances,omitempty"` @@ -47543,6 +47572,7 @@ type TargetPoolsRemoveHealthCheckRequest struct { // valid partial URL. For example, the following are valid URLs: // - // https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check + // // - projects/project/global/httpHealthChecks/health-check // - global/httpHealthChecks/health-check HealthChecks []*HealthCheckReference `json:"healthChecks,omitempty"` @@ -92709,6 +92739,7 @@ func (c *InstancesInsertCall) RequestId(requestId string) *InstancesInsertCall { // the following are all valid URLs to an instance template: // - // https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate +// // - projects/project/global/instanceTemplates/instanceTemplate // - global/instanceTemplates/instanceTemplate func (c *InstancesInsertCall) SourceInstanceTemplate(sourceInstanceTemplate string) *InstancesInsertCall { @@ -92723,6 +92754,7 @@ func (c *InstancesInsertCall) SourceInstanceTemplate(sourceInstanceTemplate stri // the following are all valid URLs to a machine image: // - // https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage +// // - projects/project/global/global/machineImages/machineImage // - global/machineImages/machineImage func (c *InstancesInsertCall) SourceMachineImage(sourceMachineImage string) *InstancesInsertCall { diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index a1f5fc536c7..4765d5c2bcc 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -2730,8 +2730,7 @@ type AttachedDiskInitializeParams struct { // not specified, the default is pd-standard, specified using the full // URL. For // example: - // https://www.googleapis.com/compute/v1/projects/project/zones/ - // zone/diskTypes/pd-standard + // https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard // // // Other values include pd-ssd and local-ssd. If you define this field, @@ -2739,6 +2738,7 @@ type AttachedDiskInitializeParams struct { // following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType + // // - projects/project/zones/zone/diskTypes/diskType // - zones/zone/diskTypes/diskType Note that for InstanceTemplate, this // is the name of the disk type, not URL. @@ -2787,13 +2787,11 @@ type AttachedDiskInitializeParams struct { // projects/debian-cloud/global/images/family/debian-9 // // - // Alternati - // vely, use a specific version of a public operating system + // Alternatively, use a specific version of a public operating system // image: // projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD // // - // // To create a disk with a custom image that you created, specify the // image name in the following // format: @@ -3902,7 +3900,8 @@ type AutoscalingPolicyCustomMetricUtilization struct { // proportionally to the metric. // // For example, a good metric to use as a utilization_target is - // https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. The autoscaler works to keep this value constant for each of the + // https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. + // The autoscaler works to keep this value constant for each of the // instances. UtilizationTarget float64 `json:"utilizationTarget,omitempty"` @@ -4837,8 +4836,7 @@ func (s *BackendBucketListWarningData) MarshalJSON() ([]byte, error) { // Regional // (/compute/docs/reference/rest/{$api_version}/regionBackendServices) // -// F -// or more information, see Backend Services. +// For more information, see Backend Services. // // (== resource_for {$api_version}.backendService ==) type BackendService struct { @@ -7515,8 +7513,7 @@ type CustomerEncryptionKey struct { // - After being wrapped, the key must be encoded in RFC 4648 base64 // encoding. Gets the RSA public key certificate provided by Google // at: - // https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingre - // ss.pem + // https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem RsaEncryptedKey string `json:"rsaEncryptedKey,omitempty"` // Sha256: [Output only] The RFC 4648 base64 encoded SHA-256 hash of the @@ -7802,6 +7799,7 @@ type Disk struct { // following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk SourceDisk string `json:"sourceDisk,omitempty"` @@ -7824,13 +7822,11 @@ type Disk struct { // projects/debian-cloud/global/images/family/debian-9 // // - // Alternati - // vely, use a specific version of a public operating system + // Alternatively, use a specific version of a public operating system // image: // projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD // // - // // To create a disk with a custom image that you created, specify the // image name in the following // format: @@ -7862,6 +7858,7 @@ type Disk struct { // the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot + // // - projects/project/global/snapshots/snapshot // - global/snapshots/snapshot SourceSnapshot string `json:"sourceSnapshot,omitempty"` @@ -8344,6 +8341,7 @@ type DiskMoveRequest struct { // // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk TargetDisk string `json:"targetDisk,omitempty"` @@ -9966,6 +9964,7 @@ type Firewall struct { // // - // https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network + // // - projects/myproject/global/networks/my-network // - global/networks/default Network string `json:"network,omitempty"` @@ -10585,7 +10584,8 @@ type ForwardingRule struct { // is assigned. Methods for specifying an IP address: // // * IPv4 dotted decimal, as in `100.1.2.3` * Full URL, as in - // https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name * Partial URL or by name, as in: + // https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name + // * Partial URL or by name, as in: // - projects/project_id/regions/region/addresses/address-name // - regions/region/addresses/address-name // - global/addresses/address-name @@ -12043,8 +12043,7 @@ func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error) { // Regional // (/compute/docs/reference/rest/{$api_version}/regionHealthChecks) // -// Inte -// rnal HTTP(S) load balancers must use regional health checks +// Internal HTTP(S) load balancers must use regional health checks // (`compute.v1.regionHealthChecks`). // // Traffic Director must use global health checks @@ -12360,6 +12359,7 @@ func (s *HealthCheckLogConfig) MarshalJSON() ([]byte, error) { // For example, the following are valid URLs: // - // https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check +// // - projects/project-id/global/httpHealthChecks/health-check // - global/httpHealthChecks/health-check type HealthCheckReference struct { @@ -12524,6 +12524,7 @@ func (s *HealthCheckService) MarshalJSON() ([]byte, error) { // check service. For example, the following are valid URLs: // - // https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service +// // - // projects/project-id/regions/us-west1/healthCheckServices/health-check- // service @@ -14615,6 +14616,7 @@ type Image struct { // image. For example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk SourceDisk string `json:"sourceDisk,omitempty"` @@ -18394,6 +18396,7 @@ type InstanceMoveRequest struct { // an instance: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance // - zones/zone/instances/instance TargetInstance string `json:"targetInstance,omitempty"` @@ -18616,6 +18619,7 @@ type InstanceTemplate struct { // example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance SourceInstance string `json:"sourceInstance,omitempty"` @@ -22023,6 +22027,7 @@ type MachineImage struct { // example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance SourceInstance string `json:"sourceInstance,omitempty"` @@ -24595,6 +24600,7 @@ type NetworkInterface struct { // or partial URL. For example, the following are all valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project/global/networks/network + // // - projects/project/global/networks/network // - global/networks/default Network string `json:"network,omitempty"` @@ -24622,6 +24628,7 @@ type NetworkInterface struct { // are all valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork + // // - regions/region/subnetworks/subnetwork Subnetwork string `json:"subnetwork,omitempty"` @@ -29280,6 +29287,7 @@ type PathMatcher struct { // are all valid URLs to a BackendService resource: // - // https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService + // // - compute/v1/projects/project/global/backendServices/backendService // // - global/backendServices/backendService If defaultRouteAction is @@ -29502,8 +29510,7 @@ func (s *PerInstanceConfig) MarshalJSON() ([]byte, error) { // their IAM policies, see the IAM documentation // (https://cloud.google.com/iam/help/conditions/resource-policies). // -// **J -// SON example:** +// **JSON example:** // // { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", // "members": [ "user:mike@example.com", "group:admins@example.com", @@ -33791,14 +33798,14 @@ type Route struct { // - 10.128.0.56 // - // https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule + // // - regions/region/forwardingRules/forwardingRule NextHopIlb string `json:"nextHopIlb,omitempty"` // NextHopInstance: The URL to an instance that should handle matching // packets. You can specify this as a full or partial URL. For // example: - // https://www.googleapis.com/compute/v1/projects/project/zones/ - // zone/instances/ + // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ NextHopInstance string `json:"nextHopInstance,omitempty"` // NextHopInterconnectAttachment: [Output Only] The URL to an @@ -37410,6 +37417,7 @@ type SourceDiskEncryptionKey struct { // values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk SourceDisk string `json:"sourceDisk,omitempty"` @@ -37573,7 +37581,6 @@ func (s *SourceInstanceProperties) MarshalJSON() ([]byte, error) { // // // -// // The sslCertificates are used by: // - external HTTPS load balancers // - SSL proxy load balancers @@ -40086,7 +40093,6 @@ func (s *TargetHttpProxiesScopedListWarningData) MarshalJSON() ([]byte, error) { // Regional // (/compute/docs/reference/rest/{$api_version}/regionTargetHttpProxies) // -// // A target HTTP proxy is a component of GCP HTTP load balancers. // // * targetHttpProxies are used by external HTTP load balancers and @@ -40118,7 +40124,15 @@ type TargetHttpProxy struct { // HttpFilters: URLs to networkservices.HttpFilter resources enabled for // xDS clients using this configuration. For example, - // https://networkservices.googleapis.com/v1alpha1/projects/project/locations/locationhttpFilters/httpFilter Only filters that handle outbound connection and stream events may be specified. These filters work in conjunction with a default set of HTTP filters that may already be configured by Traffic Director. Traffic Director will determine the final location of these filters within xDS configuration based on the name of the HTTP filter. If Traffic Director positions multiple filters at the same location, those filters will be in the same order as specified in this list. + // https://networkservices.googleapis.com/v1alpha1/projects/project/locations/locationhttpFilters/httpFilter + // Only filters that handle outbound connection and stream events may be + // specified. These filters work in conjunction with a default set of + // HTTP filters that may already be configured by Traffic Director. + // Traffic Director will determine the final location of these filters + // within xDS configuration based on the name of the HTTP filter. If + // Traffic Director positions multiple filters at the same location, + // those filters will be in the same order as specified in this + // list. // httpFilters only applies for loadbalancers with loadBalancingScheme // set to INTERNAL_SELF_MANAGED. See ForwardingRule for more details. HttpFilters []string `json:"httpFilters,omitempty"` @@ -40762,7 +40776,15 @@ type TargetHttpsProxy struct { // HttpFilters: URLs to networkservices.HttpFilter resources enabled for // xDS clients using this configuration. For example, - // https://networkservices.googleapis.com/beta/projects/project/locations/locationhttpFilters/httpFilter Only filters that handle outbound connection and stream events may be specified. These filters work in conjunction with a default set of HTTP filters that may already be configured by Traffic Director. Traffic Director will determine the final location of these filters within xDS configuration based on the name of the HTTP filter. If Traffic Director positions multiple filters at the same location, those filters will be in the same order as specified in this list. + // https://networkservices.googleapis.com/beta/projects/project/locations/locationhttpFilters/httpFilter + // Only filters that handle outbound connection and stream events may be + // specified. These filters work in conjunction with a default set of + // HTTP filters that may already be configured by Traffic Director. + // Traffic Director will determine the final location of these filters + // within xDS configuration based on the name of the HTTP filter. If + // Traffic Director positions multiple filters at the same location, + // those filters will be in the same order as specified in this + // list. // httpFilters only applies for loadbalancers with loadBalancingScheme // set to INTERNAL_SELF_MANAGED. See ForwardingRule for more details. HttpFilters []string `json:"httpFilters,omitempty"` @@ -40851,6 +40873,7 @@ type TargetHttpsProxy struct { // the following are all valid URLs for specifying a URL map: // - // https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map + // // - projects/project/global/urlMaps/url-map // - global/urlMaps/url-map UrlMap string `json:"urlMap,omitempty"` @@ -41228,6 +41251,7 @@ type TargetInstance struct { // virtual machine. For example, the following are all valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance // - zones/zone/instances/instance Instance string `json:"instance,omitempty"` @@ -42280,6 +42304,7 @@ type TargetPoolsAddInstanceRequest struct { // are valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name + // // - projects/project-id/zones/zone/instances/instance-name // - zones/zone/instances/instance-name Instances []*InstanceReference `json:"instances,omitempty"` @@ -42312,6 +42337,7 @@ type TargetPoolsRemoveHealthCheckRequest struct { // valid partial URL. For example, the following are valid URLs: // - // https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check + // // - projects/project/global/httpHealthChecks/health-check // - global/httpHealthChecks/health-check HealthChecks []*HealthCheckReference `json:"healthChecks,omitempty"` @@ -84719,6 +84745,7 @@ func (c *InstancesInsertCall) RequestId(requestId string) *InstancesInsertCall { // the following are all valid URLs to an instance template: // - // https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate +// // - projects/project/global/instanceTemplates/instanceTemplate // - global/instanceTemplates/instanceTemplate func (c *InstancesInsertCall) SourceInstanceTemplate(sourceInstanceTemplate string) *InstancesInsertCall { @@ -84733,6 +84760,7 @@ func (c *InstancesInsertCall) SourceInstanceTemplate(sourceInstanceTemplate stri // the following are all valid URLs to a machine image: // - // https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage +// // - projects/project/global/global/machineImages/machineImage // - global/machineImages/machineImage func (c *InstancesInsertCall) SourceMachineImage(sourceMachineImage string) *InstancesInsertCall { diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index 3d5008700a4..ebbd412d14d 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -2652,8 +2652,7 @@ type AttachedDiskInitializeParams struct { // not specified, the default is pd-standard, specified using the full // URL. For // example: - // https://www.googleapis.com/compute/v1/projects/project/zones/ - // zone/diskTypes/pd-standard + // https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard // // // Other values include pd-ssd and local-ssd. If you define this field, @@ -2661,6 +2660,7 @@ type AttachedDiskInitializeParams struct { // following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType + // // - projects/project/zones/zone/diskTypes/diskType // - zones/zone/diskTypes/diskType Note that for InstanceTemplate, this // is the name of the disk type, not URL. @@ -2697,13 +2697,11 @@ type AttachedDiskInitializeParams struct { // projects/debian-cloud/global/images/family/debian-9 // // - // Alternati - // vely, use a specific version of a public operating system + // Alternatively, use a specific version of a public operating system // image: // projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD // // - // // To create a disk with a custom image that you created, specify the // image name in the following // format: @@ -3784,7 +3782,8 @@ type AutoscalingPolicyCustomMetricUtilization struct { // proportionally to the metric. // // For example, a good metric to use as a utilization_target is - // https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. The autoscaler works to keep this value constant for each of the + // https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. + // The autoscaler works to keep this value constant for each of the // instances. UtilizationTarget float64 `json:"utilizationTarget,omitempty"` @@ -4497,8 +4496,7 @@ func (s *BackendBucketListWarningData) MarshalJSON() ([]byte, error) { // Regional // (/compute/docs/reference/rest/{$api_version}/regionBackendServices) // -// F -// or more information, see Backend Services. +// For more information, see Backend Services. // // (== resource_for {$api_version}.backendService ==) type BackendService struct { @@ -6993,6 +6991,7 @@ type Disk struct { // following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk SourceDisk string `json:"sourceDisk,omitempty"` @@ -7015,13 +7014,11 @@ type Disk struct { // projects/debian-cloud/global/images/family/debian-9 // // - // Alternati - // vely, use a specific version of a public operating system + // Alternatively, use a specific version of a public operating system // image: // projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD // // - // // To create a disk with a custom image that you created, specify the // image name in the following // format: @@ -7053,6 +7050,7 @@ type Disk struct { // the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot + // // - projects/project/global/snapshots/snapshot // - global/snapshots/snapshot SourceSnapshot string `json:"sourceSnapshot,omitempty"` @@ -7522,6 +7520,7 @@ type DiskMoveRequest struct { // // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk TargetDisk string `json:"targetDisk,omitempty"` @@ -9129,6 +9128,7 @@ type Firewall struct { // // - // https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network + // // - projects/myproject/global/networks/my-network // - global/networks/default Network string `json:"network,omitempty"` @@ -9574,7 +9574,8 @@ type ForwardingRule struct { // is assigned. Methods for specifying an IP address: // // * IPv4 dotted decimal, as in `100.1.2.3` * Full URL, as in - // https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name * Partial URL or by name, as in: + // https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name + // * Partial URL or by name, as in: // - projects/project_id/regions/region/addresses/address-name // - regions/region/addresses/address-name // - global/addresses/address-name @@ -10971,8 +10972,7 @@ func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error) { // Regional // (/compute/docs/reference/rest/{$api_version}/regionHealthChecks) // -// Inte -// rnal HTTP(S) load balancers must use regional health checks +// Internal HTTP(S) load balancers must use regional health checks // (`compute.v1.regionHealthChecks`). // // Traffic Director must use global health checks @@ -11288,6 +11288,7 @@ func (s *HealthCheckLogConfig) MarshalJSON() ([]byte, error) { // For example, the following are valid URLs: // - // https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check +// // - projects/project-id/global/httpHealthChecks/health-check // - global/httpHealthChecks/health-check type HealthCheckReference struct { @@ -11435,6 +11436,7 @@ func (s *HealthCheckService) MarshalJSON() ([]byte, error) { // check service. For example, the following are valid URLs: // - // https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service +// // - // projects/project-id/regions/us-west1/healthCheckServices/health-check- // service @@ -13463,6 +13465,7 @@ type Image struct { // image. For example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + // // - projects/project/zones/zone/disks/disk // - zones/zone/disks/disk SourceDisk string `json:"sourceDisk,omitempty"` @@ -17107,6 +17110,7 @@ type InstanceMoveRequest struct { // an instance: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance // - zones/zone/instances/instance TargetInstance string `json:"targetInstance,omitempty"` @@ -17315,6 +17319,7 @@ type InstanceTemplate struct { // example, the following are valid values: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance SourceInstance string `json:"sourceInstance,omitempty"` @@ -22740,6 +22745,7 @@ type NetworkInterface struct { // or partial URL. For example, the following are all valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project/global/networks/network + // // - projects/project/global/networks/network // - global/networks/default Network string `json:"network,omitempty"` @@ -22767,6 +22773,7 @@ type NetworkInterface struct { // are all valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork + // // - regions/region/subnetworks/subnetwork Subnetwork string `json:"subnetwork,omitempty"` @@ -27217,6 +27224,7 @@ type PathMatcher struct { // are all valid URLs to a BackendService resource: // - // https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService + // // - compute/v1/projects/project/global/backendServices/backendService // // - global/backendServices/backendService If defaultRouteAction is @@ -27439,8 +27447,7 @@ func (s *PerInstanceConfig) MarshalJSON() ([]byte, error) { // their IAM policies, see the IAM documentation // (https://cloud.google.com/iam/help/conditions/resource-policies). // -// **J -// SON example:** +// **JSON example:** // // { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", // "members": [ "user:mike@example.com", "group:admins@example.com", @@ -31671,14 +31678,14 @@ type Route struct { // - 10.128.0.56 // - // https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule + // // - regions/region/forwardingRules/forwardingRule NextHopIlb string `json:"nextHopIlb,omitempty"` // NextHopInstance: The URL to an instance that should handle matching // packets. You can specify this as a full or partial URL. For // example: - // https://www.googleapis.com/compute/v1/projects/project/zones/ - // zone/instances/ + // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ NextHopInstance string `json:"nextHopInstance,omitempty"` // NextHopIp: The network IP address of an instance that should handle @@ -34659,7 +34666,6 @@ func (s *SourceInstanceParams) MarshalJSON() ([]byte, error) { // // // -// // The sslCertificates are used by: // - external HTTPS load balancers // - SSL proxy load balancers @@ -37154,7 +37160,6 @@ func (s *TargetHttpProxiesScopedListWarningData) MarshalJSON() ([]byte, error) { // Regional // (/compute/docs/reference/rest/{$api_version}/regionTargetHttpProxies) // -// // A target HTTP proxy is a component of GCP HTTP load balancers. // // * targetHttpProxies are used by external HTTP load balancers and @@ -37792,6 +37797,7 @@ type TargetHttpsProxy struct { // the following are all valid URLs for specifying a URL map: // - // https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map + // // - projects/project/global/urlMaps/url-map // - global/urlMaps/url-map UrlMap string `json:"urlMap,omitempty"` @@ -38169,6 +38175,7 @@ type TargetInstance struct { // virtual machine. For example, the following are all valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + // // - projects/project/zones/zone/instances/instance // - zones/zone/instances/instance Instance string `json:"instance,omitempty"` @@ -39216,6 +39223,7 @@ type TargetPoolsAddInstanceRequest struct { // are valid URLs: // - // https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name + // // - projects/project-id/zones/zone/instances/instance-name // - zones/zone/instances/instance-name Instances []*InstanceReference `json:"instances,omitempty"` @@ -39248,6 +39256,7 @@ type TargetPoolsRemoveHealthCheckRequest struct { // valid partial URL. For example, the following are valid URLs: // - // https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check + // // - projects/project/global/httpHealthChecks/health-check // - global/httpHealthChecks/health-check HealthChecks []*HealthCheckReference `json:"healthChecks,omitempty"` @@ -78121,6 +78130,7 @@ func (c *InstancesInsertCall) RequestId(requestId string) *InstancesInsertCall { // the following are all valid URLs to an instance template: // - // https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate +// // - projects/project/global/instanceTemplates/instanceTemplate // - global/instanceTemplates/instanceTemplate func (c *InstancesInsertCall) SourceInstanceTemplate(sourceInstanceTemplate string) *InstancesInsertCall { diff --git a/container/v1/container-gen.go b/container/v1/container-gen.go index 940781aa5fc..61ef1ecb746 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -482,9 +482,8 @@ type AutoprovisioningNodePoolDefaults struct { // platform. Applicable values are the friendly names of CPU platforms, // such as minCpuPlatform: Intel Haswell or minCpuPlatform: Intel Sandy // Bridge. For more information, read how to specify min CPU platform - // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platf - // orm) To unset the min cpu platform field pass "automatic" as field - // value. + // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform) + // To unset the min cpu platform field pass "automatic" as field value. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // OauthScopes: Scopes that are used by NAP when creating node pools. @@ -772,11 +771,10 @@ type Cluster struct { CurrentNodeCount int64 `json:"currentNodeCount,omitempty"` // CurrentNodeVersion: [Output only] Deprecated, use NodePools.version - // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro - // jects.locations.clusters.nodePools) instead. The current version of - // the node software components. If they are currently at multiple - // versions because they're in the process of being upgraded, this - // reflects the minimum version of all nodes. + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters.nodePools) + // instead. The current version of the node software components. If they + // are currently at multiple versions because they're in the process of + // being upgraded, this reflects the minimum version of all nodes. CurrentNodeVersion string `json:"currentNodeVersion,omitempty"` // DatabaseEncryption: Configuration of etcd encryption. @@ -852,23 +850,22 @@ type Cluster struct { LegacyAbac *LegacyAbac `json:"legacyAbac,omitempty"` // Location: [Output only] The name of the Google Compute Engine zone - // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava - // ilable) or region - // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava - // ilable) in which the cluster resides. + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) + // or region + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) + // in which the cluster resides. Location string `json:"location,omitempty"` // Locations: The list of Google Compute Engine zones // (https://cloud.google.com/compute/docs/zones#available) in which the // cluster's nodes should be located. This field provides a default // value if NodePool.Locations - // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro - // jects.locations.clusters.nodePools#NodePool.FIELDS.locations) are not - // specified during node pool creation. Warning: changing cluster - // locations will update the NodePool.Locations - // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro - // jects.locations.clusters.nodePools#NodePool.FIELDS.locations) of all - // node pools and will result in nodes being added and/or removed. + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters.nodePools#NodePool.FIELDS.locations) + // are not specified during node pool creation. Warning: changing + // cluster locations will update the NodePool.Locations + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters.nodePools#NodePool.FIELDS.locations) + // of all node pools and will result in nodes being added and/or + // removed. Locations []string `json:"locations,omitempty"` // LoggingService: The logging service the cluster should use to write @@ -914,9 +911,9 @@ type Cluster struct { Name string `json:"name,omitempty"` // Network: The name of the Google Compute Engine network - // (https://cloud.google.com/compute/docs/networks-and-firewalls#networks - // ) to which the cluster is connected. If left unspecified, the - // `default` network will be used. + // (https://cloud.google.com/compute/docs/networks-and-firewalls#networks) + // to which the cluster is connected. If left unspecified, the `default` + // network will be used. Network string `json:"network,omitempty"` // NetworkConfig: Configuration for cluster networking. @@ -1363,8 +1360,7 @@ func (s *ConsumptionMeteringConfig) MarshalJSON() ([]byte, error) { // CreateClusterRequest: CreateClusterRequest creates a cluster. type CreateClusterRequest struct { // Cluster: Required. A cluster resource - // (https://cloud.google.com/container-engine/reference/rest/v1/projects. - // locations.clusters) + // (https://cloud.google.com/container-engine/reference/rest/v1/projects.locations.clusters) Cluster *Cluster `json:"cluster,omitempty"` // Parent: The parent (project and location) where the cluster will be @@ -2711,8 +2707,7 @@ type NodeConfig struct { // Applicable values are the friendly names of CPU platforms, such as // `minCpuPlatform: "Intel Haswell" or `minCpuPlatform: "Intel Sandy // Bridge". For more information, read how to specify min CPU platform - // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platf - // orm) + // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform) MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NodeGroup: Setting this field will assign instances of this pool to @@ -2741,8 +2736,8 @@ type NodeConfig struct { // ReservationAffinity: The optional reservation affinity. Setting this // field will apply the specified Zonal Compute Reservation - // (https://cloud.google.com/compute/docs/instances/reserving-zonal-resou - // rces) to this node pool. + // (https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) + // to this node pool. ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` // SandboxConfig: Sandbox configuration for this node. @@ -2862,18 +2857,17 @@ type NodePool struct { // InstanceGroupUrls: [Output only] The resource URLs of the managed // instance groups - // (https://cloud.google.com/compute/docs/instance-groups/creating-groups - // -of-managed-instances) associated with this node pool. + // (https://cloud.google.com/compute/docs/instance-groups/creating-groups-of-managed-instances) + // associated with this node pool. InstanceGroupUrls []string `json:"instanceGroupUrls,omitempty"` // Locations: The list of Google Compute Engine zones // (https://cloud.google.com/compute/docs/zones#available) in which the // NodePool's nodes should be located. If this value is unspecified // during node pool creation, the Cluster.Locations - // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro - // jects.locations.clusters#Cluster.FIELDS.locations) value will be - // used, instead. Warning: changing node pool locations will result in - // nodes being added and/or removed. + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters#Cluster.FIELDS.locations) + // value will be used, instead. Warning: changing node pool locations + // will result in nodes being added and/or removed. Locations []string `json:"locations,omitempty"` // Management: NodeManagement configuration for this NodePool. @@ -2998,8 +2992,8 @@ func (s *NodePoolAutoscaling) MarshalJSON() ([]byte, error) { // NodeTaint: Kubernetes taint is comprised of three fields: key, value, // and effect. Effect can only be one of three types: NoSchedule, // PreferNoSchedule or NoExecute. See here -// (https://kubernetes.io/docs/concepts/configuration/taint-and-toleratio -// n) for more information, including usage and the valid values. +// (https://kubernetes.io/docs/concepts/configuration/taint-and-toleration) +// for more information, including usage and the valid values. type NodeTaint struct { // Effect: Effect for taint. // @@ -3054,10 +3048,10 @@ type Operation struct { EndTime string `json:"endTime,omitempty"` // Location: [Output only] The name of the Google Compute Engine zone - // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava - // ilable) or region - // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava - // ilable) in which the cluster resides. + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) + // or region + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) + // in which the cluster resides. Location string `json:"location,omitempty"` // Name: The server-assigned ID for the operation. @@ -3432,9 +3426,9 @@ func (s *ReleaseChannelConfig) MarshalJSON() ([]byte, error) { } // ReservationAffinity: ReservationAffinity -// (https://cloud.google.com/compute/docs/instances/reserving-zonal-resou -// rces) is the configuration of desired reservation which instances -// could take capacity from. +// (https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) +// is the configuration of desired reservation which instances could +// take capacity from. type ReservationAffinity struct { // ConsumeReservationType: Corresponds to the type of reservation // consumption. @@ -5551,8 +5545,8 @@ type ProjectsLocationsClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is // created in the project's default network -// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks -// ). One firewall is added for the cluster. After cluster creation, the +// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks). +// One firewall is added for the cluster. After cluster creation, the // Kubelet creates routes for each node to allow the containers on that // node to communicate with all other instances in the cluster. Finally, // an entry is added to the project's global metadata indicating which @@ -6659,8 +6653,8 @@ type ProjectsLocationsClustersSetLocationsCall struct { // SetLocations: Sets the locations for a specific cluster. Deprecated. // Use projects.locations.clusters.update -// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro -// jects.locations.clusters/update) instead. +// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters/update) +// instead. func (r *ProjectsLocationsClustersService) SetLocations(name string, setlocationsrequest *SetLocationsRequest) *ProjectsLocationsClustersSetLocationsCall { c := &ProjectsLocationsClustersSetLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -10611,8 +10605,8 @@ type ProjectsZonesClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is // created in the project's default network -// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks -// ). One firewall is added for the cluster. After cluster creation, the +// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks). +// One firewall is added for the cluster. After cluster creation, the // Kubelet creates routes for each node to allow the containers on that // node to communicate with all other instances in the cluster. Finally, // an entry is added to the project's global metadata indicating which @@ -11439,8 +11433,8 @@ type ProjectsZonesClustersLocationsCall struct { // Locations: Sets the locations for a specific cluster. Deprecated. Use // projects.locations.clusters.update -// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro -// jects.locations.clusters/update) instead. +// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters/update) +// instead. func (r *ProjectsZonesClustersService) Locations(projectId string, zone string, clusterId string, setlocationsrequest *SetLocationsRequest) *ProjectsZonesClustersLocationsCall { c := &ProjectsZonesClustersLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId diff --git a/container/v1beta1/container-gen.go b/container/v1beta1/container-gen.go index 6234719acc8..bfa4104e3f7 100644 --- a/container/v1beta1/container-gen.go +++ b/container/v1beta1/container-gen.go @@ -490,9 +490,8 @@ type AutoprovisioningNodePoolDefaults struct { // Applicable values are the friendly names of CPU platforms, such as // `minCpuPlatform: "Intel Haswell" or `minCpuPlatform: "Intel Sandy // Bridge". For more information, read how to specify min CPU platform - // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platf - // orm) To unset the min cpu platform field pass "automatic" as field - // value. + // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform) + // To unset the min cpu platform field pass "automatic" as field value. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // OauthScopes: The set of Google API scopes to be made available on all @@ -830,11 +829,10 @@ type Cluster struct { CurrentNodeCount int64 `json:"currentNodeCount,omitempty"` // CurrentNodeVersion: [Output only] Deprecated, use NodePool.version - // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta - // 1/projects.locations.clusters.nodePools) instead. The current version - // of the node software components. If they are currently at multiple - // versions because they're in the process of being upgraded, this - // reflects the minimum version of all nodes. + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters.nodePools) + // instead. The current version of the node software components. If they + // are currently at multiple versions because they're in the process of + // being upgraded, this reflects the minimum version of all nodes. CurrentNodeVersion string `json:"currentNodeVersion,omitempty"` // DatabaseEncryption: Configuration of etcd encryption. @@ -911,23 +909,22 @@ type Cluster struct { LegacyAbac *LegacyAbac `json:"legacyAbac,omitempty"` // Location: [Output only] The name of the Google Compute Engine zone - // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava - // ilable) or region - // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava - // ilable) in which the cluster resides. + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) + // or region + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) + // in which the cluster resides. Location string `json:"location,omitempty"` // Locations: The list of Google Compute Engine zones // (https://cloud.google.com/compute/docs/zones#available) in which the // cluster's nodes should be located. This field provides a default // value if NodePool.Locations - // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro - // jects.locations.clusters.nodePools#NodePool.FIELDS.locations) are not - // specified during node pool creation. Warning: changing cluster - // locations will update the NodePool.Locations - // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro - // jects.locations.clusters.nodePools#NodePool.FIELDS.locations) of all - // node pools and will result in nodes being added and/or removed. + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters.nodePools#NodePool.FIELDS.locations) + // are not specified during node pool creation. Warning: changing + // cluster locations will update the NodePool.Locations + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters.nodePools#NodePool.FIELDS.locations) + // of all node pools and will result in nodes being added and/or + // removed. Locations []string `json:"locations,omitempty"` // LoggingService: The logging service the cluster should use to write @@ -983,10 +980,10 @@ type Cluster struct { Name string `json:"name,omitempty"` // Network: The name of the Google Compute Engine network - // (https://cloud.google.com/compute/docs/networks-and-firewalls#networks - // ) to which the cluster is connected. If left unspecified, the - // `default` network will be used. On output this shows the network ID - // instead of the name. + // (https://cloud.google.com/compute/docs/networks-and-firewalls#networks) + // to which the cluster is connected. If left unspecified, the `default` + // network will be used. On output this shows the network ID instead of + // the name. Network string `json:"network,omitempty"` // NetworkConfig: Configuration for cluster networking. @@ -1556,8 +1553,7 @@ func (s *ConsumptionMeteringConfig) MarshalJSON() ([]byte, error) { // CreateClusterRequest: CreateClusterRequest creates a cluster. type CreateClusterRequest struct { // Cluster: Required. A cluster resource - // (https://cloud.google.com/container-engine/reference/rest/v1beta1/proj - // ects.locations.clusters) + // (https://cloud.google.com/container-engine/reference/rest/v1beta1/projects.locations.clusters) Cluster *Cluster `json:"cluster,omitempty"` // Parent: The parent (project and location) where the cluster will be @@ -3153,8 +3149,7 @@ type NodeConfig struct { // Applicable values are the friendly names of CPU platforms, such as // `minCpuPlatform: "Intel Haswell" or `minCpuPlatform: "Intel Sandy // Bridge". For more information, read how to specify min CPU platform - // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platf - // orm) + // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform) MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NodeGroup: Setting this field will assign instances of this pool to @@ -3183,8 +3178,8 @@ type NodeConfig struct { // ReservationAffinity: The optional reservation affinity. Setting this // field will apply the specified Zonal Compute Reservation - // (https://cloud.google.com/compute/docs/instances/reserving-zonal-resou - // rces) to this node pool. + // (https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) + // to this node pool. ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` // SandboxConfig: Sandbox configuration for this node. @@ -3258,7 +3253,11 @@ type NodeKubeletConfig struct { CpuCfsQuotaPeriod string `json:"cpuCfsQuotaPeriod,omitempty"` // CpuManagerPolicy: Control the CPU management policy on the node. See - // https://kubernetes.io/docs/tasks/administer-cluster/cpu-management-policies/ The following values are allowed. - "none": the default, which represents the existing scheduling behavior. - "static": allows pods with certain resource characteristics to be granted increased CPU affinity and exclusivity on the node. The default value is 'none' if + // https://kubernetes.io/docs/tasks/administer-cluster/cpu-management-policies/ + // The following values are allowed. - "none": the default, which + // represents the existing scheduling behavior. - "static": allows pods + // with certain resource characteristics to be granted increased CPU + // affinity and exclusivity on the node. The default value is 'none' if // unspecified. CpuManagerPolicy string `json:"cpuManagerPolicy,omitempty"` @@ -3346,18 +3345,17 @@ type NodePool struct { // InstanceGroupUrls: [Output only] The resource URLs of the managed // instance groups - // (https://cloud.google.com/compute/docs/instance-groups/creating-groups - // -of-managed-instances) associated with this node pool. + // (https://cloud.google.com/compute/docs/instance-groups/creating-groups-of-managed-instances) + // associated with this node pool. InstanceGroupUrls []string `json:"instanceGroupUrls,omitempty"` // Locations: The list of Google Compute Engine zones // (https://cloud.google.com/compute/docs/zones#available) in which the // NodePool's nodes should be located. If this value is unspecified // during node pool creation, the Cluster.Locations - // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/pro - // jects.locations.clusters#Cluster.FIELDS.locations) value will be - // used, instead. Warning: changing node pool locations will result in - // nodes being added and/or removed. + // (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters#Cluster.FIELDS.locations) + // value will be used, instead. Warning: changing node pool locations + // will result in nodes being added and/or removed. Locations []string `json:"locations,omitempty"` // Management: NodeManagement configuration for this NodePool. @@ -3482,8 +3480,8 @@ func (s *NodePoolAutoscaling) MarshalJSON() ([]byte, error) { // NodeTaint: Kubernetes taint is comprised of three fields: key, value, // and effect. Effect can only be one of three types: NoSchedule, // PreferNoSchedule or NoExecute. See here -// (https://kubernetes.io/docs/concepts/configuration/taint-and-toleratio -// n) for more information, including usage and the valid values. +// (https://kubernetes.io/docs/concepts/configuration/taint-and-toleration) +// for more information, including usage and the valid values. type NodeTaint struct { // Effect: Effect for taint. // @@ -3571,10 +3569,10 @@ type Operation struct { Error *Status `json:"error,omitempty"` // Location: [Output only] The name of the Google Compute Engine zone - // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava - // ilable) or region - // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#ava - // ilable) in which the cluster resides. + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) + // or region + // (https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) + // in which the cluster resides. Location string `json:"location,omitempty"` // Name: The server-assigned ID for the operation. @@ -4016,9 +4014,9 @@ func (s *ReleaseChannelConfig) MarshalJSON() ([]byte, error) { } // ReservationAffinity: ReservationAffinity -// (https://cloud.google.com/compute/docs/instances/reserving-zonal-resou -// rces) is the configuration of desired reservation which instances -// could take capacity from. +// (https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) +// is the configuration of desired reservation which instances could +// take capacity from. type ReservationAffinity struct { // ConsumeReservationType: Corresponds to the type of reservation // consumption. @@ -6507,8 +6505,8 @@ type ProjectsLocationsClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is // created in the project's default network -// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks -// ). One firewall is added for the cluster. After cluster creation, the +// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks). +// One firewall is added for the cluster. After cluster creation, the // Kubelet creates routes for each node to allow the containers on that // node to communicate with all other instances in the cluster. Finally, // an entry is added to the project's global metadata indicating which @@ -7615,8 +7613,8 @@ type ProjectsLocationsClustersSetLocationsCall struct { // SetLocations: Sets the locations for a specific cluster. Deprecated. // Use projects.locations.clusters.update -// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta -// 1/projects.locations.clusters/update) instead. +// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters/update) +// instead. func (r *ProjectsLocationsClustersService) SetLocations(name string, setlocationsrequest *SetLocationsRequest) *ProjectsLocationsClustersSetLocationsCall { c := &ProjectsLocationsClustersSetLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11570,8 +11568,8 @@ type ProjectsZonesClustersCreateCall struct { // Create: Creates a cluster, consisting of the specified number and // type of Google Compute Engine instances. By default, the cluster is // created in the project's default network -// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks -// ). One firewall is added for the cluster. After cluster creation, the +// (https://cloud.google.com/compute/docs/networks-and-firewalls#networks). +// One firewall is added for the cluster. After cluster creation, the // Kubelet creates routes for each node to allow the containers on that // node to communicate with all other instances in the cluster. Finally, // an entry is added to the project's global metadata indicating which @@ -12398,8 +12396,8 @@ type ProjectsZonesClustersLocationsCall struct { // Locations: Sets the locations for a specific cluster. Deprecated. Use // projects.locations.clusters.update -// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta -// 1/projects.locations.clusters/update) instead. +// (https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters/update) +// instead. func (r *ProjectsZonesClustersService) Locations(projectId string, zone string, clusterId string, setlocationsrequest *SetLocationsRequest) *ProjectsZonesClustersLocationsCall { c := &ProjectsZonesClustersLocationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId diff --git a/containeranalysis/v1alpha1/containeranalysis-gen.go b/containeranalysis/v1alpha1/containeranalysis-gen.go index de14843e349..5453d3e700f 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -2325,8 +2325,9 @@ type PgpSignedAttestation struct { // Possible values: // "CONTENT_TYPE_UNSPECIFIED" - `ContentType` is not set. // "SIMPLE_SIGNING_JSON" - Atomic format attestation signature. See - // https://github.com/containers/image/blob/8a5d2f82a6e3263290c8e0276c3e0f64e77723e7/docs/atomic-signature.md The payload extracted from `signature` is a JSON blob conforming to the linked - // schema. + // https://github.com/containers/image/blob/8a5d2f82a6e3263290c8e0276c3e0f64e77723e7/docs/atomic-signature.md + // The payload extracted from `signature` is a JSON blob conforming to + // the linked schema. ContentType string `json:"contentType,omitempty"` // PgpKeyId: The cryptographic fingerprint of the key used to generate @@ -3064,7 +3065,8 @@ func (s *UpgradeOccurrence) MarshalJSON() ([]byte, error) { // Version: Version contains structured information about the version of // the package. For a discussion of this in Debian/Ubuntu: -// http://serverfault.com/questions/604541/debian-packages-version-convention For a discussion of this in Redhat/Fedora/Centos: +// http://serverfault.com/questions/604541/debian-packages-version-convention +// For a discussion of this in Redhat/Fedora/Centos: // http://blog.jasonantman.com/2014/07/how-yum-and-rpm-compare-versions/ type Version struct { // Epoch: Used to correct mistakes in the version numbering scheme. diff --git a/containeranalysis/v1beta1/containeranalysis-gen.go b/containeranalysis/v1beta1/containeranalysis-gen.go index c3665556d1f..940c7460bc0 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -1634,8 +1634,9 @@ type GenericSignedAttestation struct { // Possible values: // "CONTENT_TYPE_UNSPECIFIED" - `ContentType` is not set. // "SIMPLE_SIGNING_JSON" - Atomic format attestation signature. See - // https://github.com/containers/image/blob/8a5d2f82a6e3263290c8e0276c3e0f64e77723e7/docs/atomic-signature.md The payload extracted in `plaintext` is a JSON blob conforming to the linked - // schema. + // https://github.com/containers/image/blob/8a5d2f82a6e3263290c8e0276c3e0f64e77723e7/docs/atomic-signature.md + // The payload extracted in `plaintext` is a JSON blob conforming to the + // linked schema. ContentType string `json:"contentType,omitempty"` // SerializedPayload: The serialized payload that is verified by one or @@ -2945,8 +2946,9 @@ type PgpSignedAttestation struct { // Possible values: // "CONTENT_TYPE_UNSPECIFIED" - `ContentType` is not set. // "SIMPLE_SIGNING_JSON" - Atomic format attestation signature. See - // https://github.com/containers/image/blob/8a5d2f82a6e3263290c8e0276c3e0f64e77723e7/docs/atomic-signature.md The payload extracted from `signature` is a JSON blob conforming to the linked - // schema. + // https://github.com/containers/image/blob/8a5d2f82a6e3263290c8e0276c3e0f64e77723e7/docs/atomic-signature.md + // The payload extracted from `signature` is a JSON blob conforming to + // the linked schema. ContentType string `json:"contentType,omitempty"` // PgpKeyId: The cryptographic fingerprint of the key used to generate diff --git a/content/v2.1/content-gen.go b/content/v2.1/content-gen.go index 60524a259e9..1020404b9a0 100644 --- a/content/v2.1/content-gen.go +++ b/content/v2.1/content-gen.go @@ -11518,8 +11518,8 @@ func (s *Region) MarshalJSON() ([]byte, error) { // area. type RegionGeoTargetArea struct { // GeotargetCriteriaIds: Required. A non-empty list of location IDs - // (https://developers.google.com/adwords/api/docs/appendix/geotargeting) - // . They must all be of the same location type (e.g., state). + // (https://developers.google.com/adwords/api/docs/appendix/geotargeting). + // They must all be of the same location type (e.g., state). GeotargetCriteriaIds googleapi.Int64s `json:"geotargetCriteriaIds,omitempty"` // ForceSendFields is a list of field names (e.g. diff --git a/customsearch/v1/customsearch-gen.go b/customsearch/v1/customsearch-gen.go index f799fbe6209..c44303eedc9 100644 --- a/customsearch/v1/customsearch-gen.go +++ b/customsearch/v1/customsearch-gen.go @@ -309,8 +309,8 @@ type Result struct { Mime string `json:"mime,omitempty"` // Pagemap: Contains PageMap - // (https://developers.google.com/custom-search/docs/structured_data#page - // maps) information for this search result. + // (https://developers.google.com/custom-search/docs/structured_data#pagemaps) + // information for this search result. Pagemap googleapi.RawMessage `json:"pagemap,omitempty"` // Snippet: The snippet of the search result, in plain text. @@ -533,13 +533,13 @@ type SearchQueriesNextPage struct { // Cr: Restricts search results to documents originating in a particular // country. You may use Boolean operators - // (https://developers.google.com/custom-search/docs/xml_results#booleanO - // perators) in the `cr` parameter's value. Google WebSearch determines - // the country of a document by analyzing the following: * The top-level + // (https://developers.google.com/custom-search/docs/xml_results#booleanOperators) + // in the `cr` parameter's value. Google WebSearch determines the + // country of a document by analyzing the following: * The top-level // domain (TLD) of the document's URL. * The geographic location of the // web server's IP address. See Country (cr) Parameter Values - // (https://developers.google.com/custom-search/docs/xml_results#countryC - // ollections) for a list of valid values for this parameter. + // (https://developers.google.com/custom-search/docs/xml_results#countryCollections) + // for a list of valid values for this parameter. Cr string `json:"cr,omitempty"` // Cx: The identifier of an engine created using the Programmable Search @@ -558,8 +558,8 @@ type SearchQueriesNextPage struct { // DisableCnTwTranslation: Enables or disables the Simplified and // Traditional Chinese Search - // (https://developers.google.com/custom-search/docs/xml_results#chineseS - // earch) feature. Supported values are: * `0`: enabled (default) * `1`: + // (https://developers.google.com/custom-search/docs/xml_results#chineseSearch) + // feature. Supported values are: * `0`: enabled (default) * `1`: // disabled DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"` @@ -586,19 +586,19 @@ type SearchQueriesNextPage struct { // Filter: Activates or deactivates the automatic filtering of Google // search results. See Automatic Filtering - // (https://developers.google.com/custom-search/docs/xml_results#automati - // cFiltering) for more information about Google's search results - // filters. Valid values for this parameter are: * `0`: Disabled * `1`: - // Enabled (default) **Note**: By default, Google applies filtering to - // all search results to improve the quality of those results. + // (https://developers.google.com/custom-search/docs/xml_results#automaticFiltering) + // for more information about Google's search results filters. Valid + // values for this parameter are: * `0`: Disabled * `1`: Enabled + // (default) **Note**: By default, Google applies filtering to all + // search results to improve the quality of those results. Filter string `json:"filter,omitempty"` // Gl: Boosts search results whose country of origin matches the // parameter value. See Country Codes - // (https://developers.google.com/custom-search/docs/xml_results#countryC - // odes) for a list of valid values. Specifying a `gl` parameter value - // in WebSearch requests should improve the relevance of results. This - // is particularly true for international customers and, even more + // (https://developers.google.com/custom-search/docs/xml_results#countryCodes) + // for a list of valid values. Specifying a `gl` parameter value in + // WebSearch requests should improve the relevance of results. This is + // particularly true for international customers and, even more // specifically, for customers in English-speaking countries other than // the United States. Gl string `json:"gl,omitempty"` @@ -615,13 +615,12 @@ type SearchQueriesNextPage struct { // Hl: Specifies the interface language (host language) of your user // interface. Explicitly setting this parameter improves the performance // and the quality of your search results. See the Interface Languages - // (https://developers.google.com/custom-search/docs/xml_results#wsInterf - // aceLanguages) section of Internationalizing Queries and Results - // Presentation - // (https://developers.google.com/custom-search/docs/xml_results#wsIntern - // ationalizing) for more information, and Supported Interface Languages - // (https://developers.google.com/custom-search/docs/xml_results_appendic - // es#interfaceLanguages) for a list of supported languages. + // (https://developers.google.com/custom-search/docs/xml_results#wsInterfaceLanguages) + // section of Internationalizing Queries and Results Presentation + // (https://developers.google.com/custom-search/docs/xml_results#wsInternationalizing) + // for more information, and Supported Interface Languages + // (https://developers.google.com/custom-search/docs/xml_results_appendices#interfaceLanguages) + // for a list of supported languages. Hl string `json:"hl,omitempty"` // Hq: Appends the specified query terms to the query, as if they were @@ -667,8 +666,8 @@ type SearchQueriesNextPage struct { // OrTerms: Provides additional search terms to check for in a document, // where each document in the search results must contain at least one // of the additional search terms. You can also use the Boolean OR - // (https://developers.google.com/custom-search/docs/xml_results#BooleanO - // rqt) query term for this type of query. + // (https://developers.google.com/custom-search/docs/xml_results#BooleanOrqt) + // query term for this type of query. OrTerms string `json:"orTerms,omitempty"` // OutputEncoding: The character encoding supported for search results. @@ -685,10 +684,10 @@ type SearchQueriesNextPage struct { Rights string `json:"rights,omitempty"` // Safe: Specifies the SafeSearch level - // (https://developers.google.com/custom-search/docs/xml_results#safeSear - // chLevels) used for filtering out adult results. This is a custom - // property not defined in the OpenSearch spec. Valid parameter values - // are: * "off": Disable SafeSearch * "active": Enable SafeSearch + // (https://developers.google.com/custom-search/docs/xml_results#safeSearchLevels) + // used for filtering out adult results. This is a custom property not + // defined in the OpenSearch spec. Valid parameter values are: * + // "off": Disable SafeSearch * "active": Enable SafeSearch Safe string `json:"safe,omitempty"` // SearchTerms: The search terms entered by the user. @@ -756,13 +755,13 @@ type SearchQueriesPreviousPage struct { // Cr: Restricts search results to documents originating in a particular // country. You may use Boolean operators - // (https://developers.google.com/custom-search/docs/xml_results#booleanO - // perators) in the `cr` parameter's value. Google WebSearch determines - // the country of a document by analyzing the following: * The top-level + // (https://developers.google.com/custom-search/docs/xml_results#booleanOperators) + // in the `cr` parameter's value. Google WebSearch determines the + // country of a document by analyzing the following: * The top-level // domain (TLD) of the document's URL. * The geographic location of the // web server's IP address. See Country (cr) Parameter Values - // (https://developers.google.com/custom-search/docs/xml_results#countryC - // ollections) for a list of valid values for this parameter. + // (https://developers.google.com/custom-search/docs/xml_results#countryCollections) + // for a list of valid values for this parameter. Cr string `json:"cr,omitempty"` // Cx: The identifier of an engine created using the Programmable Search @@ -781,8 +780,8 @@ type SearchQueriesPreviousPage struct { // DisableCnTwTranslation: Enables or disables the Simplified and // Traditional Chinese Search - // (https://developers.google.com/custom-search/docs/xml_results#chineseS - // earch) feature. Supported values are: * `0`: enabled (default) * `1`: + // (https://developers.google.com/custom-search/docs/xml_results#chineseSearch) + // feature. Supported values are: * `0`: enabled (default) * `1`: // disabled DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"` @@ -809,19 +808,19 @@ type SearchQueriesPreviousPage struct { // Filter: Activates or deactivates the automatic filtering of Google // search results. See Automatic Filtering - // (https://developers.google.com/custom-search/docs/xml_results#automati - // cFiltering) for more information about Google's search results - // filters. Valid values for this parameter are: * `0`: Disabled * `1`: - // Enabled (default) **Note**: By default, Google applies filtering to - // all search results to improve the quality of those results. + // (https://developers.google.com/custom-search/docs/xml_results#automaticFiltering) + // for more information about Google's search results filters. Valid + // values for this parameter are: * `0`: Disabled * `1`: Enabled + // (default) **Note**: By default, Google applies filtering to all + // search results to improve the quality of those results. Filter string `json:"filter,omitempty"` // Gl: Boosts search results whose country of origin matches the // parameter value. See Country Codes - // (https://developers.google.com/custom-search/docs/xml_results#countryC - // odes) for a list of valid values. Specifying a `gl` parameter value - // in WebSearch requests should improve the relevance of results. This - // is particularly true for international customers and, even more + // (https://developers.google.com/custom-search/docs/xml_results#countryCodes) + // for a list of valid values. Specifying a `gl` parameter value in + // WebSearch requests should improve the relevance of results. This is + // particularly true for international customers and, even more // specifically, for customers in English-speaking countries other than // the United States. Gl string `json:"gl,omitempty"` @@ -838,13 +837,12 @@ type SearchQueriesPreviousPage struct { // Hl: Specifies the interface language (host language) of your user // interface. Explicitly setting this parameter improves the performance // and the quality of your search results. See the Interface Languages - // (https://developers.google.com/custom-search/docs/xml_results#wsInterf - // aceLanguages) section of Internationalizing Queries and Results - // Presentation - // (https://developers.google.com/custom-search/docs/xml_results#wsIntern - // ationalizing) for more information, and Supported Interface Languages - // (https://developers.google.com/custom-search/docs/xml_results_appendic - // es#interfaceLanguages) for a list of supported languages. + // (https://developers.google.com/custom-search/docs/xml_results#wsInterfaceLanguages) + // section of Internationalizing Queries and Results Presentation + // (https://developers.google.com/custom-search/docs/xml_results#wsInternationalizing) + // for more information, and Supported Interface Languages + // (https://developers.google.com/custom-search/docs/xml_results_appendices#interfaceLanguages) + // for a list of supported languages. Hl string `json:"hl,omitempty"` // Hq: Appends the specified query terms to the query, as if they were @@ -890,8 +888,8 @@ type SearchQueriesPreviousPage struct { // OrTerms: Provides additional search terms to check for in a document, // where each document in the search results must contain at least one // of the additional search terms. You can also use the Boolean OR - // (https://developers.google.com/custom-search/docs/xml_results#BooleanO - // rqt) query term for this type of query. + // (https://developers.google.com/custom-search/docs/xml_results#BooleanOrqt) + // query term for this type of query. OrTerms string `json:"orTerms,omitempty"` // OutputEncoding: The character encoding supported for search results. @@ -908,10 +906,10 @@ type SearchQueriesPreviousPage struct { Rights string `json:"rights,omitempty"` // Safe: Specifies the SafeSearch level - // (https://developers.google.com/custom-search/docs/xml_results#safeSear - // chLevels) used for filtering out adult results. This is a custom - // property not defined in the OpenSearch spec. Valid parameter values - // are: * "off": Disable SafeSearch * "active": Enable SafeSearch + // (https://developers.google.com/custom-search/docs/xml_results#safeSearchLevels) + // used for filtering out adult results. This is a custom property not + // defined in the OpenSearch spec. Valid parameter values are: * + // "off": Disable SafeSearch * "active": Enable SafeSearch Safe string `json:"safe,omitempty"` // SearchTerms: The search terms entered by the user. @@ -979,13 +977,13 @@ type SearchQueriesRequest struct { // Cr: Restricts search results to documents originating in a particular // country. You may use Boolean operators - // (https://developers.google.com/custom-search/docs/xml_results#booleanO - // perators) in the `cr` parameter's value. Google WebSearch determines - // the country of a document by analyzing the following: * The top-level + // (https://developers.google.com/custom-search/docs/xml_results#booleanOperators) + // in the `cr` parameter's value. Google WebSearch determines the + // country of a document by analyzing the following: * The top-level // domain (TLD) of the document's URL. * The geographic location of the // web server's IP address. See Country (cr) Parameter Values - // (https://developers.google.com/custom-search/docs/xml_results#countryC - // ollections) for a list of valid values for this parameter. + // (https://developers.google.com/custom-search/docs/xml_results#countryCollections) + // for a list of valid values for this parameter. Cr string `json:"cr,omitempty"` // Cx: The identifier of an engine created using the Programmable Search @@ -1004,8 +1002,8 @@ type SearchQueriesRequest struct { // DisableCnTwTranslation: Enables or disables the Simplified and // Traditional Chinese Search - // (https://developers.google.com/custom-search/docs/xml_results#chineseS - // earch) feature. Supported values are: * `0`: enabled (default) * `1`: + // (https://developers.google.com/custom-search/docs/xml_results#chineseSearch) + // feature. Supported values are: * `0`: enabled (default) * `1`: // disabled DisableCnTwTranslation string `json:"disableCnTwTranslation,omitempty"` @@ -1032,19 +1030,19 @@ type SearchQueriesRequest struct { // Filter: Activates or deactivates the automatic filtering of Google // search results. See Automatic Filtering - // (https://developers.google.com/custom-search/docs/xml_results#automati - // cFiltering) for more information about Google's search results - // filters. Valid values for this parameter are: * `0`: Disabled * `1`: - // Enabled (default) **Note**: By default, Google applies filtering to - // all search results to improve the quality of those results. + // (https://developers.google.com/custom-search/docs/xml_results#automaticFiltering) + // for more information about Google's search results filters. Valid + // values for this parameter are: * `0`: Disabled * `1`: Enabled + // (default) **Note**: By default, Google applies filtering to all + // search results to improve the quality of those results. Filter string `json:"filter,omitempty"` // Gl: Boosts search results whose country of origin matches the // parameter value. See Country Codes - // (https://developers.google.com/custom-search/docs/xml_results#countryC - // odes) for a list of valid values. Specifying a `gl` parameter value - // in WebSearch requests should improve the relevance of results. This - // is particularly true for international customers and, even more + // (https://developers.google.com/custom-search/docs/xml_results#countryCodes) + // for a list of valid values. Specifying a `gl` parameter value in + // WebSearch requests should improve the relevance of results. This is + // particularly true for international customers and, even more // specifically, for customers in English-speaking countries other than // the United States. Gl string `json:"gl,omitempty"` @@ -1061,13 +1059,12 @@ type SearchQueriesRequest struct { // Hl: Specifies the interface language (host language) of your user // interface. Explicitly setting this parameter improves the performance // and the quality of your search results. See the Interface Languages - // (https://developers.google.com/custom-search/docs/xml_results#wsInterf - // aceLanguages) section of Internationalizing Queries and Results - // Presentation - // (https://developers.google.com/custom-search/docs/xml_results#wsIntern - // ationalizing) for more information, and Supported Interface Languages - // (https://developers.google.com/custom-search/docs/xml_results_appendic - // es#interfaceLanguages) for a list of supported languages. + // (https://developers.google.com/custom-search/docs/xml_results#wsInterfaceLanguages) + // section of Internationalizing Queries and Results Presentation + // (https://developers.google.com/custom-search/docs/xml_results#wsInternationalizing) + // for more information, and Supported Interface Languages + // (https://developers.google.com/custom-search/docs/xml_results_appendices#interfaceLanguages) + // for a list of supported languages. Hl string `json:"hl,omitempty"` // Hq: Appends the specified query terms to the query, as if they were @@ -1113,8 +1110,8 @@ type SearchQueriesRequest struct { // OrTerms: Provides additional search terms to check for in a document, // where each document in the search results must contain at least one // of the additional search terms. You can also use the Boolean OR - // (https://developers.google.com/custom-search/docs/xml_results#BooleanO - // rqt) query term for this type of query. + // (https://developers.google.com/custom-search/docs/xml_results#BooleanOrqt) + // query term for this type of query. OrTerms string `json:"orTerms,omitempty"` // OutputEncoding: The character encoding supported for search results. @@ -1131,10 +1128,10 @@ type SearchQueriesRequest struct { Rights string `json:"rights,omitempty"` // Safe: Specifies the SafeSearch level - // (https://developers.google.com/custom-search/docs/xml_results#safeSear - // chLevels) used for filtering out adult results. This is a custom - // property not defined in the OpenSearch spec. Valid parameter values - // are: * "off": Disable SafeSearch * "active": Enable SafeSearch + // (https://developers.google.com/custom-search/docs/xml_results#safeSearchLevels) + // used for filtering out adult results. This is a custom property not + // defined in the OpenSearch spec. Valid parameter values are: * + // "off": Disable SafeSearch * "active": Enable SafeSearch Safe string `json:"safe,omitempty"` // SearchTerms: The search terms entered by the user. @@ -1285,8 +1282,8 @@ func (s *SearchSpelling) MarshalJSON() ([]byte, error) { // SearchUrl: OpenSearch template and URL. type SearchUrl struct { // Template: The actual OpenSearch template - // (http://www.opensearch.org/specifications/opensearch/1.1#opensearch_ur - // l_template_syntax) for this API. + // (http://www.opensearch.org/specifications/opensearch/1.1#opensearch_url_template_syntax) + // for this API. Template string `json:"template,omitempty"` // Type: The MIME type of the OpenSearch URL template for the Custom @@ -1335,10 +1332,10 @@ func (r *CseService) List() *CseListCall { // C2coff sets the optional parameter "c2coff": Enables or disables // Simplified and Traditional Chinese Search -// (https://developers.google.com/custom-search/docs/xml_results#chineseS -// earch). The default value for this parameter is 0 (zero), meaning -// that the feature is enabled. Supported values are: * `1`: Disabled * -// `0`: Enabled (default) +// (https://developers.google.com/custom-search/docs/xml_results#chineseSearch). +// The default value for this parameter is 0 (zero), meaning that the +// feature is enabled. Supported values are: * `1`: Disabled * `0`: +// Enabled (default) func (c *CseListCall) C2coff(c2coff string) *CseListCall { c.urlParams_.Set("c2coff", c2coff) return c @@ -1347,14 +1344,13 @@ func (c *CseListCall) C2coff(c2coff string) *CseListCall { // Cr sets the optional parameter "cr": Restricts search results to // documents originating in a particular country. You may use Boolean // operators -// (https://developers.google.com/custom-search/docs/xml_results_appendic -// es#booleanOperators) in the cr parameter's value. Google Search -// determines the country of a document by analyzing: * the top-level -// domain (TLD) of the document's URL * the geographic location of the -// Web server's IP address See the Country Parameter Values -// (https://developers.google.com/custom-search/docs/xml_results_appendic -// es#countryCollections) page for a list of valid values for this -// parameter. +// (https://developers.google.com/custom-search/docs/xml_results_appendices#booleanOperators) +// in the cr parameter's value. Google Search determines the country of +// a document by analyzing: * the top-level domain (TLD) of the +// document's URL * the geographic location of the Web server's IP +// address See the Country Parameter Values +// (https://developers.google.com/custom-search/docs/xml_results_appendices#countryCollections) +// page for a list of valid values for this parameter. func (c *CseListCall) Cr(cr string) *CseListCall { c.urlParams_.Set("cr", cr) return c @@ -1405,13 +1401,12 @@ func (c *CseListCall) FileType(fileType string) *CseListCall { // Filter sets the optional parameter "filter": Controls turning on or // off the duplicate content filter. * See Automatic Filtering -// (https://developers.google.com/custom-search/docs/xml_results#automati -// cFiltering) for more information about Google's search results -// filters. Note that host crowding filtering applies only to multi-site -// searches. * By default, Google applies filtering to all search -// results to improve the quality of those results. Acceptable values -// are: * `0`: Turns off duplicate content filter. * `1`: Turns on -// duplicate content filter. +// (https://developers.google.com/custom-search/docs/xml_results#automaticFiltering) +// for more information about Google's search results filters. Note that +// host crowding filtering applies only to multi-site searches. * By +// default, Google applies filtering to all search results to improve +// the quality of those results. Acceptable values are: * `0`: Turns off +// duplicate content filter. * `1`: Turns on duplicate content filter. func (c *CseListCall) Filter(filter string) *CseListCall { c.urlParams_.Set("filter", filter) return c @@ -1421,12 +1416,11 @@ func (c *CseListCall) Filter(filter string) *CseListCall { // `gl` parameter value is a two-letter country code. The `gl` parameter // boosts search results whose country of origin matches the parameter // value. See the Country Codes -// (https://developers.google.com/custom-search/docs/xml_results_appendic -// es#countryCodes) page for a list of valid values. * Specifying a `gl` -// parameter value should lead to more relevant results. This is -// particularly true for international customers and, even more -// specifically, for customers in English- speaking countries other than -// the United States. +// (https://developers.google.com/custom-search/docs/xml_results_appendices#countryCodes) +// page for a list of valid values. * Specifying a `gl` parameter value +// should lead to more relevant results. This is particularly true for +// international customers and, even more specifically, for customers in +// English- speaking countries other than the United States. func (c *CseListCall) Gl(gl string) *CseListCall { c.urlParams_.Set("gl", gl) return c @@ -1454,11 +1448,10 @@ func (c *CseListCall) HighRange(highRange string) *CseListCall { // language. * Explicitly setting this parameter improves the // performance and the quality of your search results. * See the // Interface Languages -// (https://developers.google.com/custom-search/docs/xml_results#wsInterf -// aceLanguages) section of Internationalizing Queries and Results -// Presentation -// (https://developers.google.com/custom-search/docs/xml_results#wsIntern -// ationalizing) for more information, and (Supported Interface +// (https://developers.google.com/custom-search/docs/xml_results#wsInterfaceLanguages) +// section of Internationalizing Queries and Results Presentation +// (https://developers.google.com/custom-search/docs/xml_results#wsInternationalizing) +// for more information, and (Supported Interface // Languages)[https://developers.google.com/custom-search/docs/xml_result // s_appendices#interfaceLanguages] for a list of supported languages. func (c *CseListCall) Hl(hl string) *CseListCall { @@ -1681,8 +1674,7 @@ func (c *CseListCall) SiteSearchFilter(siteSearchFilter string) *CseListCall { // to the results. The sort parameter specifies that the results be // sorted according to the specified expression i.e. sort by date. // Example: sort=date -// (https://developers.google.com/custom-search/docs/structured_search#so -// rt-by-attribute). +// (https://developers.google.com/custom-search/docs/structured_search#sort-by-attribute). func (c *CseListCall) Sort(sort string) *CseListCall { c.urlParams_.Set("sort", sort) return c @@ -2102,10 +2094,10 @@ func (r *CseSiterestrictService) List() *CseSiterestrictListCall { // C2coff sets the optional parameter "c2coff": Enables or disables // Simplified and Traditional Chinese Search -// (https://developers.google.com/custom-search/docs/xml_results#chineseS -// earch). The default value for this parameter is 0 (zero), meaning -// that the feature is enabled. Supported values are: * `1`: Disabled * -// `0`: Enabled (default) +// (https://developers.google.com/custom-search/docs/xml_results#chineseSearch). +// The default value for this parameter is 0 (zero), meaning that the +// feature is enabled. Supported values are: * `1`: Disabled * `0`: +// Enabled (default) func (c *CseSiterestrictListCall) C2coff(c2coff string) *CseSiterestrictListCall { c.urlParams_.Set("c2coff", c2coff) return c @@ -2114,14 +2106,13 @@ func (c *CseSiterestrictListCall) C2coff(c2coff string) *CseSiterestrictListCall // Cr sets the optional parameter "cr": Restricts search results to // documents originating in a particular country. You may use Boolean // operators -// (https://developers.google.com/custom-search/docs/xml_results_appendic -// es#booleanOperators) in the cr parameter's value. Google Search -// determines the country of a document by analyzing: * the top-level -// domain (TLD) of the document's URL * the geographic location of the -// Web server's IP address See the Country Parameter Values -// (https://developers.google.com/custom-search/docs/xml_results_appendic -// es#countryCollections) page for a list of valid values for this -// parameter. +// (https://developers.google.com/custom-search/docs/xml_results_appendices#booleanOperators) +// in the cr parameter's value. Google Search determines the country of +// a document by analyzing: * the top-level domain (TLD) of the +// document's URL * the geographic location of the Web server's IP +// address See the Country Parameter Values +// (https://developers.google.com/custom-search/docs/xml_results_appendices#countryCollections) +// page for a list of valid values for this parameter. func (c *CseSiterestrictListCall) Cr(cr string) *CseSiterestrictListCall { c.urlParams_.Set("cr", cr) return c @@ -2172,13 +2163,12 @@ func (c *CseSiterestrictListCall) FileType(fileType string) *CseSiterestrictList // Filter sets the optional parameter "filter": Controls turning on or // off the duplicate content filter. * See Automatic Filtering -// (https://developers.google.com/custom-search/docs/xml_results#automati -// cFiltering) for more information about Google's search results -// filters. Note that host crowding filtering applies only to multi-site -// searches. * By default, Google applies filtering to all search -// results to improve the quality of those results. Acceptable values -// are: * `0`: Turns off duplicate content filter. * `1`: Turns on -// duplicate content filter. +// (https://developers.google.com/custom-search/docs/xml_results#automaticFiltering) +// for more information about Google's search results filters. Note that +// host crowding filtering applies only to multi-site searches. * By +// default, Google applies filtering to all search results to improve +// the quality of those results. Acceptable values are: * `0`: Turns off +// duplicate content filter. * `1`: Turns on duplicate content filter. func (c *CseSiterestrictListCall) Filter(filter string) *CseSiterestrictListCall { c.urlParams_.Set("filter", filter) return c @@ -2188,12 +2178,11 @@ func (c *CseSiterestrictListCall) Filter(filter string) *CseSiterestrictListCall // `gl` parameter value is a two-letter country code. The `gl` parameter // boosts search results whose country of origin matches the parameter // value. See the Country Codes -// (https://developers.google.com/custom-search/docs/xml_results_appendic -// es#countryCodes) page for a list of valid values. * Specifying a `gl` -// parameter value should lead to more relevant results. This is -// particularly true for international customers and, even more -// specifically, for customers in English- speaking countries other than -// the United States. +// (https://developers.google.com/custom-search/docs/xml_results_appendices#countryCodes) +// page for a list of valid values. * Specifying a `gl` parameter value +// should lead to more relevant results. This is particularly true for +// international customers and, even more specifically, for customers in +// English- speaking countries other than the United States. func (c *CseSiterestrictListCall) Gl(gl string) *CseSiterestrictListCall { c.urlParams_.Set("gl", gl) return c @@ -2221,11 +2210,10 @@ func (c *CseSiterestrictListCall) HighRange(highRange string) *CseSiterestrictLi // language. * Explicitly setting this parameter improves the // performance and the quality of your search results. * See the // Interface Languages -// (https://developers.google.com/custom-search/docs/xml_results#wsInterf -// aceLanguages) section of Internationalizing Queries and Results -// Presentation -// (https://developers.google.com/custom-search/docs/xml_results#wsIntern -// ationalizing) for more information, and (Supported Interface +// (https://developers.google.com/custom-search/docs/xml_results#wsInterfaceLanguages) +// section of Internationalizing Queries and Results Presentation +// (https://developers.google.com/custom-search/docs/xml_results#wsInternationalizing) +// for more information, and (Supported Interface // Languages)[https://developers.google.com/custom-search/docs/xml_result // s_appendices#interfaceLanguages] for a list of supported languages. func (c *CseSiterestrictListCall) Hl(hl string) *CseSiterestrictListCall { @@ -2448,8 +2436,7 @@ func (c *CseSiterestrictListCall) SiteSearchFilter(siteSearchFilter string) *Cse // to the results. The sort parameter specifies that the results be // sorted according to the specified expression i.e. sort by date. // Example: sort=date -// (https://developers.google.com/custom-search/docs/structured_search#so -// rt-by-attribute). +// (https://developers.google.com/custom-search/docs/structured_search#sort-by-attribute). func (c *CseSiterestrictListCall) Sort(sort string) *CseSiterestrictListCall { c.urlParams_.Set("sort", sort) return c diff --git a/datacatalog/v1beta1/datacatalog-gen.go b/datacatalog/v1beta1/datacatalog-gen.go index 99fa7132148..9bdd9504b26 100644 --- a/datacatalog/v1beta1/datacatalog-gen.go +++ b/datacatalog/v1beta1/datacatalog-gen.go @@ -676,9 +676,9 @@ type GoogleCloudDatacatalogV1beta1Entry struct { // LinkedResource: The resource this metadata entry refers to. For // Google Cloud Platform resources, `linked_resource` is the full name // of the resource - // (https://cloud.google.com/apis/design/resource_names#full_resource_nam - // e). For example, the `linked_resource` for a table resource from - // BigQuery is: * + // (https://cloud.google.com/apis/design/resource_names#full_resource_name). + // For example, the `linked_resource` for a table resource from BigQuery + // is: * // //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables // /tableId Output only when Entry is of type in the EntryType enum. For // entries with user_specified_type, this field is optional and defaults @@ -1636,7 +1636,8 @@ func (s *GoogleCloudDatacatalogV1beta1SearchCatalogResponse) MarshalJSON() ([]by type GoogleCloudDatacatalogV1beta1SearchCatalogResult struct { // LinkedResource: The full name of the cloud resource the entry belongs // to. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name. Example: * + // https://cloud.google.com/apis/design/resource_names#full_resource_name. + // Example: * // `//bigquery.googleapis.com/projects/projectId/datasets/datasetId/table // s/tableId` LinkedResource string `json:"linkedResource,omitempty"` @@ -2015,9 +2016,9 @@ func (s *GoogleCloudDatacatalogV1beta1TagFieldEnumValue) MarshalJSON() ([]byte, // GoogleCloudDatacatalogV1beta1TagTemplate: A tag template defines a // tag, which can have one or more typed fields. The template is used to // create and attach the tag to GCP resources. Tag template roles -// (https://cloud.google.com/iam/docs/understanding-roles#data-catalog-ro -// les) provide permissions to create, edit, and use the template. See, -// for example, the TagTemplate User +// (https://cloud.google.com/iam/docs/understanding-roles#data-catalog-roles) +// provide permissions to create, edit, and use the template. See, for +// example, the TagTemplate User // (https://cloud.google.com/data-catalog/docs/how-to/template-user) // role, which includes permission to use the tag template to tag // resources. @@ -2598,8 +2599,10 @@ func (r *EntriesService) Lookup() *EntriesLookupCall { // LinkedResource sets the optional parameter "linkedResource": The full // name of the Google Cloud Platform resource the Data Catalog entry // represents. See: -// https://cloud.google.com/apis/design/resource_names#full_resource_name. Full names are case-sensitive. Examples: * //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId * -// //pubsub.googleapis.com/projects/projectId/topics/topicId +// https://cloud.google.com/apis/design/resource_names#full_resource_name. +// Full names are case-sensitive. Examples: * +// //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables +// /tableId * //pubsub.googleapis.com/projects/projectId/topics/topicId func (c *EntriesLookupCall) LinkedResource(linkedResource string) *EntriesLookupCall { c.urlParams_.Set("linkedResource", linkedResource) return c @@ -2760,7 +2763,7 @@ type ProjectsLocationsEntryGroupsCreateCall struct { // Catalog API in the project identified by the `parent` parameter (see // [Data Catalog Resource Project] // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsEntryGroupsService) Create(parent string, googleclouddatacatalogv1beta1entrygroup *GoogleCloudDatacatalogV1beta1EntryGroup) *ProjectsLocationsEntryGroupsCreateCall { c := &ProjectsLocationsEntryGroupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -2919,7 +2922,7 @@ type ProjectsLocationsEntryGroupsDeleteCall struct { // the project identified by the `name` parameter (see [Data Catalog // Resource Project] // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsEntryGroupsService) Delete(name string) *ProjectsLocationsEntryGroupsDeleteCall { c := &ProjectsLocationsEntryGroupsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3568,7 +3571,7 @@ type ProjectsLocationsEntryGroupsPatchCall struct { // API in the project identified by the `entry_group.name` parameter // (see [Data Catalog Resource Project] // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsEntryGroupsService) Patch(name string, googleclouddatacatalogv1beta1entrygroup *GoogleCloudDatacatalogV1beta1EntryGroup) *ProjectsLocationsEntryGroupsPatchCall { c := &ProjectsLocationsEntryGroupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4023,7 +4026,7 @@ type ProjectsLocationsEntryGroupsEntriesCreateCall struct { // Catalog API in the project identified by the `parent` parameter (see // [Data Catalog Resource Project] // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). A maximum of 100,000 entries may be created +// for more information). A maximum of 100,000 entries may be created // per entry group. func (r *ProjectsLocationsEntryGroupsEntriesService) Create(parent string, googleclouddatacatalogv1beta1entry *GoogleCloudDatacatalogV1beta1Entry) *ProjectsLocationsEntryGroupsEntriesCreateCall { c := &ProjectsLocationsEntryGroupsEntriesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -4181,7 +4184,7 @@ type ProjectsLocationsEntryGroupsEntriesDeleteCall struct { // Catalog API in the project identified by the `name` parameter (see // [Data Catalog Resource Project] // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsEntryGroupsEntriesService) Delete(name string) *ProjectsLocationsEntryGroupsEntriesDeleteCall { c := &ProjectsLocationsEntryGroupsEntriesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4820,7 +4823,7 @@ type ProjectsLocationsEntryGroupsEntriesPatchCall struct { // Catalog API in the project identified by the `entry.name` parameter // (see [Data Catalog Resource Project] // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsEntryGroupsEntriesService) Patch(name string, googleclouddatacatalogv1beta1entry *GoogleCloudDatacatalogV1beta1Entry) *ProjectsLocationsEntryGroupsEntriesPatchCall { c := &ProjectsLocationsEntryGroupsEntriesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -5130,12 +5133,10 @@ type ProjectsLocationsEntryGroupsEntriesTagsCreateCall struct { // Create: Creates a tag on an Entry. Note: The project identified by // the `parent` parameter for the tag -// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/pro -// jects.locations.entryGroups.entries.tags/create#path-parameters) and -// the tag template -// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/pro -// jects.locations.tagTemplates/create#path-parameters) used to create -// the tag must be from the same organization. +// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.entryGroups.entries.tags/create#path-parameters) +// and the tag template +// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.tagTemplates/create#path-parameters) +// used to create the tag must be from the same organization. func (r *ProjectsLocationsEntryGroupsEntriesTagsService) Create(parent string, googleclouddatacatalogv1beta1tag *GoogleCloudDatacatalogV1beta1Tag) *ProjectsLocationsEntryGroupsEntriesTagsCreateCall { c := &ProjectsLocationsEntryGroupsEntriesTagsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5754,12 +5755,10 @@ type ProjectsLocationsEntryGroupsTagsCreateCall struct { // Create: Creates a tag on an Entry. Note: The project identified by // the `parent` parameter for the tag -// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/pro -// jects.locations.entryGroups.entries.tags/create#path-parameters) and -// the tag template -// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/pro -// jects.locations.tagTemplates/create#path-parameters) used to create -// the tag must be from the same organization. +// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.entryGroups.entries.tags/create#path-parameters) +// and the tag template +// (https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.tagTemplates/create#path-parameters) +// used to create the tag must be from the same organization. func (r *ProjectsLocationsEntryGroupsTagsService) Create(parent string, googleclouddatacatalogv1beta1tag *GoogleCloudDatacatalogV1beta1Tag) *ProjectsLocationsEntryGroupsTagsCreateCall { c := &ProjectsLocationsEntryGroupsTagsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6380,7 +6379,7 @@ type ProjectsLocationsTagTemplatesCreateCall struct { // Catalog API in the project identified by the `parent` parameter (see // Data Catalog Resource Project // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsTagTemplatesService) Create(parent string, googleclouddatacatalogv1beta1tagtemplate *GoogleCloudDatacatalogV1beta1TagTemplate) *ProjectsLocationsTagTemplatesCreateCall { c := &ProjectsLocationsTagTemplatesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6537,7 +6536,7 @@ type ProjectsLocationsTagTemplatesDeleteCall struct { // should enable the Data Catalog API in the project identified by the // `name` parameter (see [Data Catalog Resource Project] // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsTagTemplatesService) Delete(name string) *ProjectsLocationsTagTemplatesDeleteCall { c := &ProjectsLocationsTagTemplatesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6985,7 +6984,7 @@ type ProjectsLocationsTagTemplatesPatchCall struct { // API in the project identified by the `tag_template.name` parameter // (see [Data Catalog Resource Project] // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsTagTemplatesService) Patch(name string, googleclouddatacatalogv1beta1tagtemplate *GoogleCloudDatacatalogV1beta1TagTemplate) *ProjectsLocationsTagTemplatesPatchCall { c := &ProjectsLocationsTagTemplatesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7441,7 +7440,7 @@ type ProjectsLocationsTagTemplatesFieldsCreateCall struct { // Data Catalog API in the project identified by the `parent` parameter // (see Data Catalog Resource Project // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsTagTemplatesFieldsService) Create(parent string, googleclouddatacatalogv1beta1tagtemplatefield *GoogleCloudDatacatalogV1beta1TagTemplateField) *ProjectsLocationsTagTemplatesFieldsCreateCall { c := &ProjectsLocationsTagTemplatesFieldsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7602,7 +7601,7 @@ type ProjectsLocationsTagTemplatesFieldsDeleteCall struct { // Users should enable the Data Catalog API in the project identified by // the `name` parameter (see [Data Catalog Resource Project] // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsTagTemplatesFieldsService) Delete(name string) *ProjectsLocationsTagTemplatesFieldsDeleteCall { c := &ProjectsLocationsTagTemplatesFieldsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7752,7 +7751,7 @@ type ProjectsLocationsTagTemplatesFieldsPatchCall struct { // the project identified by the `name` parameter (see [Data Catalog // Resource Project] // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsTagTemplatesFieldsService) Patch(name string, googleclouddatacatalogv1beta1tagtemplatefield *GoogleCloudDatacatalogV1beta1TagTemplateField) *ProjectsLocationsTagTemplatesFieldsPatchCall { c := &ProjectsLocationsTagTemplatesFieldsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7917,7 +7916,7 @@ type ProjectsLocationsTagTemplatesFieldsRenameCall struct { // Data Catalog API in the project identified by the `name` parameter // (see Data Catalog Resource Project // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) -// for more information). +// for more information). func (r *ProjectsLocationsTagTemplatesFieldsService) Rename(name string, googleclouddatacatalogv1beta1renametagtemplatefieldrequest *GoogleCloudDatacatalogV1beta1RenameTagTemplateFieldRequest) *ProjectsLocationsTagTemplatesFieldsRenameCall { c := &ProjectsLocationsTagTemplatesFieldsRenameCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9283,8 +9282,8 @@ func (r *ProjectsLocationsTaxonomiesService) Patch(name string, googleclouddatac // UpdateMask sets the optional parameter "updateMask": The update mask // applies to the resource. For the `FieldMask` definition, see -// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If not set, defaults to all of the fields that are allowed to -// update. +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask +// If not set, defaults to all of the fields that are allowed to update. func (c *ProjectsLocationsTaxonomiesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsTaxonomiesPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -10475,8 +10474,8 @@ func (r *ProjectsLocationsTaxonomiesPolicyTagsService) Patch(name string, google // If update_mask is not provided, all allowed fields (i.e. // display_name, description and parent) will be updated. For more // information including the `FieldMask` definition, see -// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If not set, defaults to all of the fields that are allowed to -// update. +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask +// If not set, defaults to all of the fields that are allowed to update. func (c *ProjectsLocationsTaxonomiesPolicyTagsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsTaxonomiesPolicyTagsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/dataflow/v1b3/dataflow-gen.go b/dataflow/v1b3/dataflow-gen.go index a72338d1487..d8d5ecbe5bc 100644 --- a/dataflow/v1b3/dataflow-gen.go +++ b/dataflow/v1b3/dataflow-gen.go @@ -2165,8 +2165,8 @@ type FlexTemplateRuntimeEnvironment struct { // AdditionalUserLabels: Additional user labels to be specified for the // job. Keys and values must follow the restrictions specified in the // labeling restrictions - // (https://cloud.google.com/compute/docs/labeling-resources#restrictions - // ) page. An object containing a list of "key": value pairs. Example: { + // (https://cloud.google.com/compute/docs/labeling-resources#restrictions) + // page. An object containing a list of "key": value pairs. Example: { // "name": "wrench", "mass": "1kg", "count": "3" }. AdditionalUserLabels map[string]string `json:"additionalUserLabels,omitempty"` @@ -5108,8 +5108,8 @@ type RuntimeEnvironment struct { // AdditionalUserLabels: Additional user labels to be specified for the // job. Keys and values should follow the restrictions specified in the // labeling restrictions - // (https://cloud.google.com/compute/docs/labeling-resources#restrictions - // ) page. An object containing a list of "key": value pairs. Example: { + // (https://cloud.google.com/compute/docs/labeling-resources#restrictions) + // page. An object containing a list of "key": value pairs. Example: { // "name": "wrench", "mass": "1kg", "count": "3" }. AdditionalUserLabels map[string]string `json:"additionalUserLabels,omitempty"` @@ -7686,8 +7686,9 @@ type WorkerHealthReport struct { Msg string `json:"msg,omitempty"` // Pods: The pods running on the worker. See: - // http://kubernetes.io/v1.1/docs/api-reference/v1/definitions.html#_v1_pod This field is used by the worker to send the status of the indvidual containers running on each - // worker. + // http://kubernetes.io/v1.1/docs/api-reference/v1/definitions.html#_v1_pod + // This field is used by the worker to send the status of the indvidual + // containers running on each worker. Pods []googleapi.RawMessage `json:"pods,omitempty"` // ReportInterval: The interval at which the worker is sending health diff --git a/datamigration/v1beta1/datamigration-gen.go b/datamigration/v1beta1/datamigration-gen.go index cbfe26580dd..82560b271cf 100644 --- a/datamigration/v1beta1/datamigration-gen.go +++ b/datamigration/v1beta1/datamigration-gen.go @@ -1449,8 +1449,10 @@ type ResumeMigrationJobRequest struct { // ReverseSshConnectivity: The details needed to configure a reverse SSH // tunnel between the source and destination databases. These details // will be used when calling the generateSshScript method (see -// https://cloud.google.com/database-migration/docs/reference/rest/v1beta1/projects.locations.migrationJobs/generateSshScript) to produce the script that will help set up the reverse SSH tunnel, and to set up the VPC peering between the Cloud SQL private network and the -// VPC. +// https://cloud.google.com/database-migration/docs/reference/rest/v1beta1/projects.locations.migrationJobs/generateSshScript) +// to produce the script that will help set up the reverse SSH tunnel, +// and to set up the VPC peering between the Cloud SQL private network +// and the VPC. type ReverseSshConnectivity struct { // Vm: The name of the virtual machine (Compute Engine) used as the // bastion server for the SSH tunnel. diff --git a/dataproc/v1/dataproc-gen.go b/dataproc/v1/dataproc-gen.go index 5ac493397c5..115076ad878 100644 --- a/dataproc/v1/dataproc-gen.go +++ b/dataproc/v1/dataproc-gen.go @@ -265,10 +265,14 @@ type AcceleratorConfig struct { // AcceleratorTypeUri: Full URL, partial URI, or short name of the // accelerator type resource to expose to this instance. See Compute // Engine AcceleratorTypes - // (https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes - // ).Examples: - // https://www.googleapis.com/compute/beta/projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80 projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80 nvidia-tesla-k80Auto Zone Exception: If you are using the Dataproc Auto Zone Placement (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the accelerator type resource, for example, - // nvidia-tesla-k80. + // (https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes).Examples: + // https://www.googleapis.com/compute/beta/projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80 + // projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k + // 80 nvidia-tesla-k80Auto Zone Exception: If you are using the Dataproc + // Auto Zone Placement + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) + // feature, you must use the short name of the accelerator type + // resource, for example, nvidia-tesla-k80. AcceleratorTypeUri string `json:"acceleratorTypeUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to @@ -301,8 +305,10 @@ type AutoscalingConfig struct { // PolicyUri: Optional. The autoscaling policy used by the cluster.Only // resource names including projectid and location (region) are valid. // Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[policy_id] projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[policy_id]Note that the policy must be in the same project and Dataproc - // region. + // https://www.googleapis.com/compute/v1/projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[policy_id] + // projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/ + // [policy_id]Note that the policy must be in the same project and + // Dataproc region. PolicyUri string `json:"policyUri,omitempty"` // ForceSendFields is a list of field names (e.g. "PolicyUri") to @@ -436,9 +442,8 @@ type BasicYarnAutoscalingConfig struct { // memory remaining after the update (more aggressive scaling). A // scale-down factor of 0 disables removing workers, which can be // beneficial for autoscaling a single job. See How autoscaling works - // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/ - // autoscaling#how_autoscaling_works) for more information.Bounds: 0.0, - // 1.0. + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/autoscaling#how_autoscaling_works) + // for more information.Bounds: 0.0, 1.0. ScaleDownFactor float64 `json:"scaleDownFactor,omitempty"` // ScaleDownMinWorkerFraction: Optional. Minimum scale-down threshold as @@ -455,9 +460,8 @@ type BasicYarnAutoscalingConfig struct { // remaining after the update (more aggressive scaling). A scale-up // factor closer to 0 will result in a smaller magnitude of scaling up // (less aggressive scaling). See How autoscaling works - // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/ - // autoscaling#how_autoscaling_works) for more information.Bounds: 0.0, - // 1.0. + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/autoscaling#how_autoscaling_works) + // for more information.Bounds: 0.0, 1.0. ScaleUpFactor float64 `json:"scaleUpFactor,omitempty"` // ScaleUpMinWorkerFraction: Optional. Minimum scale-up threshold as a @@ -669,9 +673,9 @@ type ClusterConfig struct { // according to the Compute Engine zone where your cluster is deployed, // and then create and manage this project-level, per-location bucket // (see Dataproc staging bucket - // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/ - // staging-bucket)). This field requires a Cloud Storage bucket name, - // not a URI to a Cloud Storage bucket. + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/staging-bucket)). + // This field requires a Cloud Storage bucket name, not a URI to a Cloud + // Storage bucket. ConfigBucket string `json:"configBucket,omitempty"` // EncryptionConfig: Optional. Encryption settings for the cluster. @@ -1242,8 +1246,7 @@ type GceClusterConfig struct { // Metadata: The Compute Engine metadata entries to add to all instances // (see Project and instance metadata - // (https://cloud.google.com/compute/docs/storing-retrieving-metadata#pro - // ject_and_instance_metadata)). + // (https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)). Metadata map[string]string `json:"metadata,omitempty"` // NetworkUri: Optional. The Compute Engine network to be used for @@ -1254,8 +1257,8 @@ type GceClusterConfig struct { // (https://cloud.google.com/compute/docs/subnetworks) for more // information).A full URL, partial URI, or short name are valid. // Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default projects/[project_id]/regions/global/default - // default + // https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default + // projects/[project_id]/regions/global/default default NetworkUri string `json:"networkUri,omitempty"` // NodeGroupAffinity: Optional. Node Group Affinity for sole-tenant @@ -1283,15 +1286,13 @@ type GceClusterConfig struct { ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` // ServiceAccount: Optional. The Dataproc service account - // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/ - // service-accounts#service_accounts_in_dataproc) (also see VM Data - // Plane identity - // (https://cloud.google.com/dataproc/docs/concepts/iam/dataproc-principa - // ls#vm_service_account_data_plane_identity)) used by Dataproc cluster - // VM instances to access Google Cloud Platform services.If not - // specified, the Compute Engine default service account - // (https://cloud.google.com/compute/docs/access/service-accounts#default - // _service_account) is used. + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/service-accounts#service_accounts_in_dataproc) + // (also see VM Data Plane identity + // (https://cloud.google.com/dataproc/docs/concepts/iam/dataproc-principals#vm_service_account_data_plane_identity)) + // used by Dataproc cluster VM instances to access Google Cloud Platform + // services.If not specified, the Compute Engine default service account + // (https://cloud.google.com/compute/docs/access/service-accounts#default_service_account) + // is used. ServiceAccount string `json:"serviceAccount,omitempty"` // ServiceAccountScopes: Optional. The URIs of service account scopes to @@ -1314,8 +1315,8 @@ type GceClusterConfig struct { // SubnetworkUri: Optional. The Compute Engine subnetwork to be used for // machine communications. Cannot be specified with network_uri.A full // URL, partial URI, or short name are valid. Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/subnetworks/sub0 projects/[project_id]/regions/us-east1/subnetworks/sub0 - // sub0 + // https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/subnetworks/sub0 + // projects/[project_id]/regions/us-east1/subnetworks/sub0 sub0 SubnetworkUri string `json:"subnetworkUri,omitempty"` // Tags: The Compute Engine tags to add to all instances (see Tagging @@ -1329,8 +1330,8 @@ type GceClusterConfig struct { // zone in the corresponding Compute Engine region. On a get request, // zone will always be present.A full URL, partial URI, or short name // are valid. Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone] projects/[project_id]/zones/[zone] - // us-central1-f + // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone] + // projects/[project_id]/zones/[zone] us-central1-f ZoneUri string `json:"zoneUri,omitempty"` // ForceSendFields is a list of field names (e.g. "InternalIpOnly") to @@ -1424,11 +1425,9 @@ func (s *GetPolicyOptions) MarshalJSON() ([]byte, error) { } // HadoopJob: A Dataproc job for running Apache Hadoop MapReduce -// (https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop -// -mapreduce-client-core/MapReduceTutorial.html) jobs on Apache Hadoop -// YARN -// (https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YA -// RN.html). +// (https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html) +// jobs on Apache Hadoop YARN +// (https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html). type HadoopJob struct { // ArchiveUris: Optional. HCFS URIs of archives to be extracted in the // working directory of Hadoop drivers and tasks. Supported file types: @@ -1654,8 +1653,13 @@ type InstanceGroupConfig struct { // ImageUri: Optional. The Compute Engine image resource used for // cluster instances.The URI can represent an image or image // family.Image examples: - // https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id] projects/[project_id]/global/images/[image-id] image-idImage family examples. Dataproc will use the most recent image from the family: https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name] projects/[project_id]/global/images/family/[custom-image-family-name]If the URI is unspecified, it will be inferred from SoftwareConfig.image_version or the system - // default. + // https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id] + // projects/[project_id]/global/images/[image-id] image-idImage family + // examples. Dataproc will use the most recent image from the family: + // https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name] + // projects/[project_id]/global/images/family/[custom-image-family-name]I + // f the URI is unspecified, it will be inferred from + // SoftwareConfig.image_version or the system default. ImageUri string `json:"imageUri,omitempty"` // InstanceNames: Output only. The list of instance names. Dataproc @@ -1674,8 +1678,13 @@ type InstanceGroupConfig struct { // MachineTypeUri: Optional. The Compute Engine machine type used for // cluster instances.A full URL, partial URI, or short name are valid. // Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2 projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2 n1-standard-2Auto Zone Exception: If you are using the Dataproc Auto Zone Placement (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the machine type resource, for example, - // n1-standard-2. + // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2 + // projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2 + // n1-standard-2Auto Zone Exception: If you are using the Dataproc Auto + // Zone Placement + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) + // feature, you must use the short name of the machine type resource, + // for example, n1-standard-2. MachineTypeUri string `json:"machineTypeUri,omitempty"` // ManagedGroupConfig: Output only. The config for Compute Engine @@ -1685,8 +1694,7 @@ type InstanceGroupConfig struct { // MinCpuPlatform: Optional. Specifies the minimum cpu platform for the // Instance Group. See Dataproc -> Minimum CPU Platform - // (https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min- - // cpu). + // (https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu). MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NumInstances: Optional. The number of VM instances in the instance @@ -2588,7 +2596,8 @@ type NodeGroupAffinity struct { // (https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups) // that the cluster will be created on.A full URL, partial URI, or node // group name are valid. Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1 projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1 + // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1 + // projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1 // node-group-1 NodeGroupUri string `json:"nodeGroupUri,omitempty"` @@ -2623,10 +2632,10 @@ type NodeInitializationAction struct { // ExecutionTimeout: Optional. Amount of time executable has to // complete. Default is 10 minutes (see JSON representation of Duration - // (https://developers.google.com/protocol-buffers/docs/proto3#json)).Clu - // ster creation fails with an explanatory error message (the name of - // the executable that caused the error and the exceeded timeout period) - // if the executable is not completed at end of the timeout period. + // (https://developers.google.com/protocol-buffers/docs/proto3#json)).Cluster + // creation fails with an explanatory error message (the name of the + // executable that caused the error and the exceeded timeout period) if + // the executable is not completed at end of the timeout period. ExecutionTimeout string `json:"executionTimeout,omitempty"` // ForceSendFields is a list of field names (e.g. "ExecutableFile") to @@ -3306,12 +3315,11 @@ func (s *ShieldedInstanceConfig) MarshalJSON() ([]byte, error) { type SoftwareConfig struct { // ImageVersion: Optional. The version of software inside the cluster. // It must be one of the supported Dataproc Versions - // (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-v - // ersions#supported_dataproc_versions), such as "1.2" (including a - // subminor version, such as "1.2.29"), or the "preview" version - // (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-v - // ersions#other_versions). If unspecified, it defaults to the latest - // Debian version. + // (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#supported_dataproc_versions), + // such as "1.2" (including a subminor version, such as "1.2.29"), or + // the "preview" version + // (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#other_versions). + // If unspecified, it defaults to the latest Debian version. ImageVersion string `json:"imageVersion,omitempty"` // OptionalComponents: Optional. The set of components to activate on @@ -5923,11 +5931,10 @@ type ProjectsLocationsWorkflowTemplatesInstantiateCall struct { // operations.cancel. This will cause any inflight jobs to be cancelled // and workflow-owned clusters to be deleted.The Operation.metadata will // be WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#workflowmetadata). Also see Using WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#u -// sing_workflowmetadata).On successful completion, Operation.response -// will be Empty. +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). +// Also see Using WorkflowMetadata +// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).On +// successful completion, Operation.response will be Empty. func (r *ProjectsLocationsWorkflowTemplatesService) Instantiate(name string, instantiateworkflowtemplaterequest *InstantiateWorkflowTemplateRequest) *ProjectsLocationsWorkflowTemplatesInstantiateCall { c := &ProjectsLocationsWorkflowTemplatesInstantiateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6076,11 +6083,10 @@ type ProjectsLocationsWorkflowTemplatesInstantiateInlineCall struct { // aborted via operations.cancel. This will cause any inflight jobs to // be cancelled and workflow-owned clusters to be deleted.The // Operation.metadata will be WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#workflowmetadata). Also see Using WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#u -// sing_workflowmetadata).On successful completion, Operation.response -// will be Empty. +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). +// Also see Using WorkflowMetadata +// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).On +// successful completion, Operation.response will be Empty. func (r *ProjectsLocationsWorkflowTemplatesService) InstantiateInline(parent string, workflowtemplate *WorkflowTemplate) *ProjectsLocationsWorkflowTemplatesInstantiateInlineCall { c := &ProjectsLocationsWorkflowTemplatesInstantiateInlineCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8034,8 +8040,7 @@ type ProjectsRegionsClustersCreateCall struct { // Create: Creates a cluster in a project. The returned // Operation.metadata will be ClusterOperationMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#clusteroperationmetadata). +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). func (r *ProjectsRegionsClustersService) Create(projectId string, region string, cluster *Cluster) *ProjectsRegionsClustersCreateCall { c := &ProjectsRegionsClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -8205,8 +8210,7 @@ type ProjectsRegionsClustersDeleteCall struct { // Delete: Deletes a cluster in a project. The returned // Operation.metadata will be ClusterOperationMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#clusteroperationmetadata). +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). func (r *ProjectsRegionsClustersService) Delete(projectId string, region string, clusterName string) *ProjectsRegionsClustersDeleteCall { c := &ProjectsRegionsClustersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -8390,11 +8394,10 @@ type ProjectsRegionsClustersDiagnoseCall struct { // Diagnose: Gets cluster diagnostic information. The returned // Operation.metadata will be ClusterOperationMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#clusteroperationmetadata). After the operation completes, -// Operation.response contains DiagnoseClusterResults -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#diagnoseclusterresults). +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). +// After the operation completes, Operation.response contains +// DiagnoseClusterResults +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#diagnoseclusterresults). func (r *ProjectsRegionsClustersService) Diagnose(projectId string, region string, clusterName string, diagnoseclusterrequest *DiagnoseClusterRequest) *ProjectsRegionsClustersDiagnoseCall { c := &ProjectsRegionsClustersDiagnoseCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -9247,8 +9250,7 @@ type ProjectsRegionsClustersPatchCall struct { // Patch: Updates a cluster in a project. The returned // Operation.metadata will be ClusterOperationMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#clusteroperationmetadata). +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). func (r *ProjectsRegionsClustersService) Patch(projectId string, region string, clusterName string, cluster *Cluster) *ProjectsRegionsClustersPatchCall { c := &ProjectsRegionsClustersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -9266,8 +9268,8 @@ func (r *ProjectsRegionsClustersService) Patch(projectId string, region string, // removing nodes (and potentially interrupting jobs). Default timeout // is 0 (for forceful decommission), and the maximum allowed timeout is // 1 day. (see JSON representation of Duration -// (https://developers.google.com/protocol-buffers/docs/proto3#json)).Onl -// y supported on Dataproc image versions 1.2 and higher. +// (https://developers.google.com/protocol-buffers/docs/proto3#json)).Only +// supported on Dataproc image versions 1.2 and higher. func (c *ProjectsRegionsClustersPatchCall) GracefulDecommissionTimeout(gracefulDecommissionTimeout string) *ProjectsRegionsClustersPatchCall { c.urlParams_.Set("gracefulDecommissionTimeout", gracefulDecommissionTimeout) return c @@ -9763,10 +9765,9 @@ type ProjectsRegionsJobsCancelCall struct { // Cancel: Starts a job cancellation request. To access the job resource // after cancellation, call regions/{region}/jobs.list -// (https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.reg -// ions.jobs/list) or regions/{region}/jobs.get -// (https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.reg -// ions.jobs/get). +// (https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs/list) +// or regions/{region}/jobs.get +// (https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs/get). func (r *ProjectsRegionsJobsService) Cancel(projectId string, region string, jobId string, canceljobrequest *CancelJobRequest) *ProjectsRegionsJobsCancelCall { c := &ProjectsRegionsJobsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -13050,11 +13051,10 @@ type ProjectsRegionsWorkflowTemplatesInstantiateCall struct { // operations.cancel. This will cause any inflight jobs to be cancelled // and workflow-owned clusters to be deleted.The Operation.metadata will // be WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#workflowmetadata). Also see Using WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#u -// sing_workflowmetadata).On successful completion, Operation.response -// will be Empty. +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). +// Also see Using WorkflowMetadata +// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).On +// successful completion, Operation.response will be Empty. func (r *ProjectsRegionsWorkflowTemplatesService) Instantiate(name string, instantiateworkflowtemplaterequest *InstantiateWorkflowTemplateRequest) *ProjectsRegionsWorkflowTemplatesInstantiateCall { c := &ProjectsRegionsWorkflowTemplatesInstantiateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -13203,11 +13203,10 @@ type ProjectsRegionsWorkflowTemplatesInstantiateInlineCall struct { // aborted via operations.cancel. This will cause any inflight jobs to // be cancelled and workflow-owned clusters to be deleted.The // Operation.metadata will be WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#workflowmetadata). Also see Using WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#u -// sing_workflowmetadata).On successful completion, Operation.response -// will be Empty. +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). +// Also see Using WorkflowMetadata +// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).On +// successful completion, Operation.response will be Empty. func (r *ProjectsRegionsWorkflowTemplatesService) InstantiateInline(parent string, workflowtemplate *WorkflowTemplate) *ProjectsRegionsWorkflowTemplatesInstantiateInlineCall { c := &ProjectsRegionsWorkflowTemplatesInstantiateInlineCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/dataproc/v1beta2/dataproc-gen.go b/dataproc/v1beta2/dataproc-gen.go index c7f61cb3830..1d20a27fe15 100644 --- a/dataproc/v1beta2/dataproc-gen.go +++ b/dataproc/v1beta2/dataproc-gen.go @@ -265,10 +265,16 @@ type AcceleratorConfig struct { // AcceleratorTypeUri: Full URL, partial URI, or short name of the // accelerator type resource to expose to this instance. See Compute // Engine AcceleratorTypes - // (https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes - // )Examples * - // https://www.googleapis.com/compute/beta/projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80 * projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80 * nvidia-tesla-k80Auto Zone Exception: If you are using the Dataproc Auto Zone Placement (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the accelerator type resource, for example, - // nvidia-tesla-k80. + // (https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes)Examples + // * + // https://www.googleapis.com/compute/beta/projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80 + // * + // projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k + // 80 * nvidia-tesla-k80Auto Zone Exception: If you are using the + // Dataproc Auto Zone Placement + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) + // feature, you must use the short name of the accelerator type + // resource, for example, nvidia-tesla-k80. AcceleratorTypeUri string `json:"acceleratorTypeUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to @@ -301,8 +307,10 @@ type AutoscalingConfig struct { // PolicyUri: Optional. The autoscaling policy used by the cluster.Only // resource names including projectid and location (region) are valid. // Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[policy_id] projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[policy_id]Note that the policy must be in the same project and Dataproc - // region. + // https://www.googleapis.com/compute/v1/projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[policy_id] + // projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/ + // [policy_id]Note that the policy must be in the same project and + // Dataproc region. PolicyUri string `json:"policyUri,omitempty"` // ForceSendFields is a list of field names (e.g. "PolicyUri") to @@ -665,9 +673,9 @@ type ClusterConfig struct { // according to the Compute Engine zone where your cluster is deployed, // and then create and manage this project-level, per-location bucket // (see Dataproc staging bucket - // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/ - // staging-bucket)). This field requires a Cloud Storage bucket name, - // not a URI to a Cloud Storage bucket. + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/staging-bucket)). + // This field requires a Cloud Storage bucket name, not a URI to a Cloud + // Storage bucket. ConfigBucket string `json:"configBucket,omitempty"` // EncryptionConfig: Optional. Encryption settings for the cluster. @@ -693,7 +701,9 @@ type ClusterConfig struct { // and all worker nodes. You can test a node's role metadata to run an // executable on a master or worker node, as shown below using curl (you // can also use wget): ROLE=$(curl -H Metadata-Flavor:Google - // http://metadata/computeMetadata/v1beta2/instance/attributes/dataproc-role) if [[ "${ROLE}" == 'Master' ]]; then ... master specific actions ... else ... worker specific actions ... fi + // http://metadata/computeMetadata/v1beta2/instance/attributes/dataproc-role) + // if [[ "${ROLE}" == 'Master' ]]; then ... master specific actions ... + // else ... worker specific actions ... fi InitializationActions []*NodeInitializationAction `json:"initializationActions,omitempty"` // LifecycleConfig: Optional. The config setting for auto delete cluster @@ -1250,8 +1260,7 @@ type GceClusterConfig struct { // Metadata: The Compute Engine metadata entries to add to all instances // (see Project and instance metadata - // (https://cloud.google.com/compute/docs/storing-retrieving-metadata#pro - // ject_and_instance_metadata)). + // (https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)). Metadata map[string]string `json:"metadata,omitempty"` // NetworkUri: Optional. The Compute Engine network to be used for @@ -1262,8 +1271,8 @@ type GceClusterConfig struct { // (https://cloud.google.com/compute/docs/subnetworks) for more // information).A full URL, partial URI, or short name are valid. // Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default projects/[project_id]/regions/global/default - // default + // https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default + // projects/[project_id]/regions/global/default default NetworkUri string `json:"networkUri,omitempty"` // NodeGroupAffinity: Optional. Node Group Affinity for sole-tenant @@ -1291,15 +1300,13 @@ type GceClusterConfig struct { ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` // ServiceAccount: Optional. The Dataproc service account - // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/ - // service-accounts#service_accounts_in_dataproc) (also see VM Data - // Plane identity - // (https://cloud.google.com/dataproc/docs/concepts/iam/dataproc-principa - // ls#vm_service_account_data_plane_identity)) used by Dataproc cluster - // VM instances to access Google Cloud Platform services.If not - // specified, the Compute Engine default service account - // (https://cloud.google.com/compute/docs/access/service-accounts#default - // _service_account) is used. + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/service-accounts#service_accounts_in_dataproc) + // (also see VM Data Plane identity + // (https://cloud.google.com/dataproc/docs/concepts/iam/dataproc-principals#vm_service_account_data_plane_identity)) + // used by Dataproc cluster VM instances to access Google Cloud Platform + // services.If not specified, the Compute Engine default service account + // (https://cloud.google.com/compute/docs/access/service-accounts#default_service_account) + // is used. ServiceAccount string `json:"serviceAccount,omitempty"` // ServiceAccountScopes: Optional. The URIs of service account scopes to @@ -1322,8 +1329,8 @@ type GceClusterConfig struct { // SubnetworkUri: Optional. The Compute Engine subnetwork to be used for // machine communications. Cannot be specified with network_uri.A full // URL, partial URI, or short name are valid. Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/subnetworks/sub0 projects/[project_id]/regions/us-east1/subnetworks/sub0 - // sub0 + // https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/subnetworks/sub0 + // projects/[project_id]/regions/us-east1/subnetworks/sub0 sub0 SubnetworkUri string `json:"subnetworkUri,omitempty"` // Tags: The Compute Engine tags to add to all instances (see Tagging @@ -1337,8 +1344,8 @@ type GceClusterConfig struct { // zone in the corresponding Compute Engine region. On a get request, // zone will always be present.A full URL, partial URI, or short name // are valid. Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone] projects/[project_id]/zones/[zone] - // us-central1-f + // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone] + // projects/[project_id]/zones/[zone] us-central1-f ZoneUri string `json:"zoneUri,omitempty"` // ForceSendFields is a list of field names (e.g. "InternalIpOnly") to @@ -1462,11 +1469,9 @@ func (s *GkeClusterConfig) MarshalJSON() ([]byte, error) { } // HadoopJob: A Dataproc job for running Apache Hadoop MapReduce -// (https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop -// -mapreduce-client-core/MapReduceTutorial.html) jobs on Apache Hadoop -// YARN -// (https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YA -// RN.html). +// (https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html) +// jobs on Apache Hadoop YARN +// (https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html). type HadoopJob struct { // ArchiveUris: Optional. HCFS URIs of archives to be extracted in the // working directory of Hadoop drivers and tasks. Supported file types: @@ -1693,8 +1698,13 @@ type InstanceGroupConfig struct { // ImageUri: Optional. The Compute Engine image resource used for // cluster instances.The URI can represent an image or image // family.Image examples: - // https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id] projects/[project_id]/global/images/[image-id] image-idImage family examples. Dataproc will use the most recent image from the family: https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name] projects/[project_id]/global/images/family/[custom-image-family-name]If the URI is unspecified, it will be inferred from SoftwareConfig.image_version or the system - // default. + // https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id] + // projects/[project_id]/global/images/[image-id] image-idImage family + // examples. Dataproc will use the most recent image from the family: + // https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name] + // projects/[project_id]/global/images/family/[custom-image-family-name]I + // f the URI is unspecified, it will be inferred from + // SoftwareConfig.image_version or the system default. ImageUri string `json:"imageUri,omitempty"` // InstanceNames: Output only. The list of instance names. Dataproc @@ -1713,8 +1723,13 @@ type InstanceGroupConfig struct { // MachineTypeUri: Optional. The Compute Engine machine type used for // cluster instances.A full URL, partial URI, or short name are valid. // Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2 projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2 n1-standard-2Auto Zone Exception: If you are using the Dataproc Auto Zone Placement (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) feature, you must use the short name of the machine type resource, for example, - // n1-standard-2. + // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2 + // projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2 + // n1-standard-2Auto Zone Exception: If you are using the Dataproc Auto + // Zone Placement + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) + // feature, you must use the short name of the machine type resource, + // for example, n1-standard-2. MachineTypeUri string `json:"machineTypeUri,omitempty"` // ManagedGroupConfig: Output only. The config for Compute Engine @@ -1724,8 +1739,7 @@ type InstanceGroupConfig struct { // MinCpuPlatform: Specifies the minimum cpu platform for the Instance // Group. See Dataproc -> Minimum CPU Platform - // (https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min- - // cpu). + // (https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu). MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NumInstances: Optional. The number of VM instances in the instance @@ -2704,7 +2718,8 @@ type NodeGroupAffinity struct { // (https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups) // that the cluster will be created on.A full URL, partial URI, or node // group name are valid. Examples: - // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1 projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1 + // https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1 + // projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1 // node-group-1 NodeGroupUri string `json:"nodeGroupUri,omitempty"` @@ -2739,10 +2754,10 @@ type NodeInitializationAction struct { // ExecutionTimeout: Optional. Amount of time executable has to // complete. Default is 10 minutes (see JSON representation of Duration - // (https://developers.google.com/protocol-buffers/docs/proto3#json)).Clu - // ster creation fails with an explanatory error message (the name of - // the executable that caused the error and the exceeded timeout period) - // if the executable is not completed at end of the timeout period. + // (https://developers.google.com/protocol-buffers/docs/proto3#json)).Cluster + // creation fails with an explanatory error message (the name of the + // executable that caused the error and the exceeded timeout period) if + // the executable is not completed at end of the timeout period. ExecutionTimeout string `json:"executionTimeout,omitempty"` // ForceSendFields is a list of field names (e.g. "ExecutableFile") to @@ -3423,12 +3438,11 @@ func (s *ShieldedInstanceConfig) MarshalJSON() ([]byte, error) { type SoftwareConfig struct { // ImageVersion: Optional. The version of software inside the cluster. // It must be one of the supported Dataproc Versions - // (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-v - // ersions#supported_dataproc_versions), such as "1.2" (including a - // subminor version, such as "1.2.29"), or the "preview" version - // (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-v - // ersions#other_versions). If unspecified, it defaults to the latest - // Debian version. + // (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#supported_dataproc_versions), + // such as "1.2" (including a subminor version, such as "1.2.29"), or + // the "preview" version + // (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#other_versions). + // If unspecified, it defaults to the latest Debian version. ImageVersion string `json:"imageVersion,omitempty"` // OptionalComponents: The set of optional components to activate on the @@ -6180,11 +6194,10 @@ type ProjectsLocationsWorkflowTemplatesInstantiateCall struct { // operations.cancel. This will cause any inflight jobs to be cancelled // and workflow-owned clusters to be deleted.The Operation.metadata will // be WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1beta2#workflowmetadata). Also see Using WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#u -// sing_workflowmetadata).On successful completion, Operation.response -// will be Empty. +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#workflowmetadata). +// Also see Using WorkflowMetadata +// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).On +// successful completion, Operation.response will be Empty. func (r *ProjectsLocationsWorkflowTemplatesService) Instantiate(name string, instantiateworkflowtemplaterequest *InstantiateWorkflowTemplateRequest) *ProjectsLocationsWorkflowTemplatesInstantiateCall { c := &ProjectsLocationsWorkflowTemplatesInstantiateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6333,11 +6346,10 @@ type ProjectsLocationsWorkflowTemplatesInstantiateInlineCall struct { // aborted via operations.cancel. This will cause any inflight jobs to // be cancelled and workflow-owned clusters to be deleted.The // Operation.metadata will be WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#workflowmetadata). Also see Using WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#u -// sing_workflowmetadata).On successful completion, Operation.response -// will be Empty. +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). +// Also see Using WorkflowMetadata +// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).On +// successful completion, Operation.response will be Empty. func (r *ProjectsLocationsWorkflowTemplatesService) InstantiateInline(parent string, workflowtemplate *WorkflowTemplate) *ProjectsLocationsWorkflowTemplatesInstantiateInlineCall { c := &ProjectsLocationsWorkflowTemplatesInstantiateInlineCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8327,8 +8339,7 @@ type ProjectsRegionsClustersCreateCall struct { // Create: Creates a cluster in a project. The returned // Operation.metadata will be ClusterOperationMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1beta2#clusteroperationmetadata). +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata). func (r *ProjectsRegionsClustersService) Create(projectId string, region string, cluster *Cluster) *ProjectsRegionsClustersCreateCall { c := &ProjectsRegionsClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -8498,8 +8509,7 @@ type ProjectsRegionsClustersDeleteCall struct { // Delete: Deletes a cluster in a project. The returned // Operation.metadata will be ClusterOperationMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1beta2#clusteroperationmetadata). +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata). func (r *ProjectsRegionsClustersService) Delete(projectId string, region string, clusterName string) *ProjectsRegionsClustersDeleteCall { c := &ProjectsRegionsClustersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -8683,9 +8693,8 @@ type ProjectsRegionsClustersDiagnoseCall struct { // Diagnose: Gets cluster diagnostic information. The returned // Operation.metadata will be ClusterOperationMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1beta2#clusteroperationmetadata). After the operation -// completes, Operation.response contains Empty. +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata). +// After the operation completes, Operation.response contains Empty. func (r *ProjectsRegionsClustersService) Diagnose(projectId string, region string, clusterName string, diagnoseclusterrequest *DiagnoseClusterRequest) *ProjectsRegionsClustersDiagnoseCall { c := &ProjectsRegionsClustersDiagnoseCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -9562,8 +9571,7 @@ type ProjectsRegionsClustersPatchCall struct { // Patch: Updates a cluster in a project. The returned // Operation.metadata will be ClusterOperationMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1beta2#clusteroperationmetadata). +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata). func (r *ProjectsRegionsClustersService) Patch(projectId string, region string, clusterName string, cluster *Cluster) *ProjectsRegionsClustersPatchCall { c := &ProjectsRegionsClustersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -9581,8 +9589,8 @@ func (r *ProjectsRegionsClustersService) Patch(projectId string, region string, // removing nodes (and potentially interrupting jobs). Default timeout // is 0 (for forceful decommission), and the maximum allowed timeout is // 1 day (see JSON representation of Duration -// (https://developers.google.com/protocol-buffers/docs/proto3#json)).Onl -// y supported on Dataproc image versions 1.2 and higher. +// (https://developers.google.com/protocol-buffers/docs/proto3#json)).Only +// supported on Dataproc image versions 1.2 and higher. func (c *ProjectsRegionsClustersPatchCall) GracefulDecommissionTimeout(gracefulDecommissionTimeout string) *ProjectsRegionsClustersPatchCall { c.urlParams_.Set("gracefulDecommissionTimeout", gracefulDecommissionTimeout) return c @@ -10399,10 +10407,9 @@ type ProjectsRegionsJobsCancelCall struct { // Cancel: Starts a job cancellation request. To access the job resource // after cancellation, call regions/{region}/jobs.list -// (https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/project -// s.regions.jobs/list) or regions/{region}/jobs.get -// (https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/project -// s.regions.jobs/get). +// (https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/list) +// or regions/{region}/jobs.get +// (https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/get). func (r *ProjectsRegionsJobsService) Cancel(projectId string, region string, jobId string, canceljobrequest *CancelJobRequest) *ProjectsRegionsJobsCancelCall { c := &ProjectsRegionsJobsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.projectId = projectId @@ -13758,11 +13765,10 @@ type ProjectsRegionsWorkflowTemplatesInstantiateCall struct { // operations.cancel. This will cause any inflight jobs to be cancelled // and workflow-owned clusters to be deleted.The Operation.metadata will // be WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1beta2#workflowmetadata). Also see Using WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#u -// sing_workflowmetadata).On successful completion, Operation.response -// will be Empty. +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#workflowmetadata). +// Also see Using WorkflowMetadata +// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).On +// successful completion, Operation.response will be Empty. func (r *ProjectsRegionsWorkflowTemplatesService) Instantiate(name string, instantiateworkflowtemplaterequest *InstantiateWorkflowTemplateRequest) *ProjectsRegionsWorkflowTemplatesInstantiateCall { c := &ProjectsRegionsWorkflowTemplatesInstantiateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -13911,11 +13917,10 @@ type ProjectsRegionsWorkflowTemplatesInstantiateInlineCall struct { // aborted via operations.cancel. This will cause any inflight jobs to // be cancelled and workflow-owned clusters to be deleted.The // Operation.metadata will be WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dat -// aproc.v1#workflowmetadata). Also see Using WorkflowMetadata -// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#u -// sing_workflowmetadata).On successful completion, Operation.response -// will be Empty. +// (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). +// Also see Using WorkflowMetadata +// (https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).On +// successful completion, Operation.response will be Empty. func (r *ProjectsRegionsWorkflowTemplatesService) InstantiateInline(parent string, workflowtemplate *WorkflowTemplate) *ProjectsRegionsWorkflowTemplatesInstantiateInlineCall { c := &ProjectsRegionsWorkflowTemplatesInstantiateInlineCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/datastore/v1/datastore-gen.go b/datastore/v1/datastore-gen.go index 8cbf63a7295..ef61ac29abb 100644 --- a/datastore/v1/datastore-gen.go +++ b/datastore/v1/datastore-gen.go @@ -2098,8 +2098,7 @@ type Query struct { // EndCursor: An ending point for the query results. Query cursors are // returned in query result batches and can only be used to limit the // same query - // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limi - // ts_and_offsets). + // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limits_and_offsets). EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. @@ -2129,8 +2128,7 @@ type Query struct { // StartCursor: A starting point for the query results. Query cursors // are returned in query result batches and can only be used to continue // the same query - // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limi - // ts_and_offsets). + // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limits_and_offsets). StartCursor string `json:"startCursor,omitempty"` // ForceSendFields is a list of field names (e.g. "DistinctOn") to diff --git a/datastore/v1beta3/datastore-gen.go b/datastore/v1beta3/datastore-gen.go index aa5b10bfc8d..f4d014ba337 100644 --- a/datastore/v1beta3/datastore-gen.go +++ b/datastore/v1beta3/datastore-gen.go @@ -1714,8 +1714,7 @@ type Query struct { // EndCursor: An ending point for the query results. Query cursors are // returned in query result batches and can only be used to limit the // same query - // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limi - // ts_and_offsets). + // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limits_and_offsets). EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. @@ -1745,8 +1744,7 @@ type Query struct { // StartCursor: A starting point for the query results. Query cursors // are returned in query result batches and can only be used to continue // the same query - // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limi - // ts_and_offsets). + // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limits_and_offsets). StartCursor string `json:"startCursor,omitempty"` // ForceSendFields is a list of field names (e.g. "DistinctOn") to diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 13f283593e5..f9ab903286c 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -5901,8 +5901,7 @@ type GoogleCloudDialogflowV2BatchCreateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For // more information, see Multilingual intent and entity data - // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e - // ntity). + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Entities") to @@ -5939,8 +5938,7 @@ type GoogleCloudDialogflowV2BatchDeleteEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For // more information, see Multilingual intent and entity data - // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e - // ntity). + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "EntityValues") to @@ -6036,8 +6034,7 @@ type GoogleCloudDialogflowV2BatchUpdateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For // more information, see Multilingual intent and entity data - // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e - // ntity). + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -6082,8 +6079,7 @@ type GoogleCloudDialogflowV2BatchUpdateEntityTypesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For // more information, see Multilingual intent and entity data - // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e - // ntity). + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -6165,8 +6161,7 @@ type GoogleCloudDialogflowV2BatchUpdateIntentsRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For // more information, see Multilingual intent and entity data - // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e - // ntity). + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -9849,8 +9844,7 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format - // (https://developers.google.com/assistant/actions/build/json/dialogflow - // -webhook-json) + // (https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -12772,8 +12766,7 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format - // (https://developers.google.com/assistant/actions/build/json/dialogflow - // -webhook-json) + // (https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -14433,8 +14426,7 @@ type ProjectsAgentSearchCall struct { // listing all agents across projects the caller has access to. One can // achieve that with a wildcard project collection id "-". Refer to List // Sub-Collections -// (https://cloud.google.com/apis/design/design_patterns#list_sub-collect -// ions). +// (https://cloud.google.com/apis/design/design_patterns#list_sub-collections). func (r *ProjectsAgentService) Search(parent string) *ProjectsAgentSearchCall { c := &ProjectsAgentSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -15219,8 +15211,7 @@ func (r *ProjectsAgentEntityTypesService) Create(parent string, googleclouddialo // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15507,8 +15498,7 @@ func (r *ProjectsAgentEntityTypesService) Get(name string) *ProjectsAgentEntityT // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15669,8 +15659,7 @@ func (r *ProjectsAgentEntityTypesService) List(parent string) *ProjectsAgentEnti // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15879,8 +15868,7 @@ func (r *ProjectsAgentEntityTypesService) Patch(nameid string, googleclouddialog // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -18794,8 +18782,7 @@ func (c *ProjectsAgentIntentsCreateCall) IntentView(intentView string) *Projects // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19107,8 +19094,7 @@ func (c *ProjectsAgentIntentsGetCall) IntentView(intentView string) *ProjectsAge // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19293,8 +19279,7 @@ func (c *ProjectsAgentIntentsListCall) IntentView(intentView string) *ProjectsAg // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19528,8 +19513,7 @@ func (c *ProjectsAgentIntentsPatchCall) IntentView(intentView string) *ProjectsA // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index 6264f902e1b..a49ac0777be 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -8289,8 +8289,7 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format - // (https://developers.google.com/assistant/actions/build/json/dialogflow - // -webhook-json) + // (https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -8474,8 +8473,7 @@ type GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For // more information, see Multilingual intent and entity data - // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e - // ntity). + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Entities") to @@ -8512,8 +8510,7 @@ type GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For // more information, see Multilingual intent and entity data - // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e - // ntity). + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). LanguageCode string `json:"languageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "EntityValues") to @@ -8609,8 +8606,7 @@ type GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For // more information, see Multilingual intent and entity data - // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e - // ntity). + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -8655,8 +8651,7 @@ type GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For // more information, see Multilingual intent and entity data - // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e - // ntity). + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -8740,8 +8735,7 @@ type GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest struct { // LanguageCode: Optional. The language used to access language-specific // data. If not specified, the agent's default language is used. For // more information, see Multilingual intent and entity data - // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e - // ntity). + // (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). LanguageCode string `json:"languageCode,omitempty"` // UpdateMask: Optional. The mask to control which fields get updated. @@ -13382,8 +13376,7 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format - // (https://developers.google.com/assistant/actions/build/json/dialogflow - // -webhook-json) + // (https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -15046,8 +15039,7 @@ type ProjectsAgentSearchCall struct { // listing all agents across projects the caller has access to. One can // achieve that with a wildcard project collection id "-". Refer to List // Sub-Collections -// (https://cloud.google.com/apis/design/design_patterns#list_sub-collect -// ions). +// (https://cloud.google.com/apis/design/design_patterns#list_sub-collections). func (r *ProjectsAgentService) Search(parent string) *ProjectsAgentSearchCall { c := &ProjectsAgentSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -15832,8 +15824,7 @@ func (r *ProjectsAgentEntityTypesService) Create(parent string, googleclouddialo // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16120,8 +16111,7 @@ func (r *ProjectsAgentEntityTypesService) Get(name string) *ProjectsAgentEntityT // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16282,8 +16272,7 @@ func (r *ProjectsAgentEntityTypesService) List(parent string) *ProjectsAgentEnti // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16492,8 +16481,7 @@ func (r *ProjectsAgentEntityTypesService) Patch(nameid string, googleclouddialog // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19411,8 +19399,7 @@ func (c *ProjectsAgentIntentsCreateCall) IntentView(intentView string) *Projects // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19725,8 +19712,7 @@ func (c *ProjectsAgentIntentsGetCall) IntentView(intentView string) *ProjectsAge // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19912,8 +19898,7 @@ func (c *ProjectsAgentIntentsListCall) IntentView(intentView string) *ProjectsAg // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -20147,8 +20132,7 @@ func (c *ProjectsAgentIntentsPatchCall) IntentView(intentView string) *ProjectsA // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -26904,8 +26888,7 @@ type ProjectsLocationsAgentSearchCall struct { // listing all agents across projects the caller has access to. One can // achieve that with a wildcard project collection id "-". Refer to List // Sub-Collections -// (https://cloud.google.com/apis/design/design_patterns#list_sub-collect -// ions). +// (https://cloud.google.com/apis/design/design_patterns#list_sub-collections). func (r *ProjectsLocationsAgentService) Search(parent string) *ProjectsLocationsAgentSearchCall { c := &ProjectsLocationsAgentSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -27690,8 +27673,7 @@ func (r *ProjectsLocationsAgentEntityTypesService) Create(parent string, googlec // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -27978,8 +27960,7 @@ func (r *ProjectsLocationsAgentEntityTypesService) Get(name string) *ProjectsLoc // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -28140,8 +28121,7 @@ func (r *ProjectsLocationsAgentEntityTypesService) List(parent string) *Projects // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -28350,8 +28330,7 @@ func (r *ProjectsLocationsAgentEntityTypesService) Patch(nameid string, googlecl // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -31269,8 +31248,7 @@ func (c *ProjectsLocationsAgentIntentsCreateCall) IntentView(intentView string) // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -31583,8 +31561,7 @@ func (c *ProjectsLocationsAgentIntentsGetCall) IntentView(intentView string) *Pr // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -31770,8 +31747,7 @@ func (c *ProjectsLocationsAgentIntentsListCall) IntentView(intentView string) *P // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -32005,8 +31981,7 @@ func (c *ProjectsLocationsAgentIntentsPatchCall) IntentView(intentView string) * // used to access language-specific data. If not specified, the agent's // default language is used. For more information, see Multilingual // intent and entity data -// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-e -// ntity). +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 5668d6398d9..fdd9467cb30 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -11580,8 +11580,7 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format - // (https://developers.google.com/assistant/actions/build/json/dialogflow - // -webhook-json) + // (https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -14503,8 +14502,7 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format - // (https://developers.google.com/assistant/actions/build/json/dialogflow - // -webhook-json) + // (https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index ca4ada9f977..ff6421641e4 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -11584,8 +11584,7 @@ type GoogleCloudDialogflowV2WebhookResponse struct { // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format - // (https://developers.google.com/assistant/actions/build/json/dialogflow - // -webhook-json) + // (https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to @@ -14507,8 +14506,7 @@ type GoogleCloudDialogflowV2beta1WebhookResponse struct { // (https://cloud.google.com/dialogflow/docs/integrations/aog) for rich // response messages. See the format definition at Google Assistant // Dialogflow webhook format - // (https://developers.google.com/assistant/actions/build/json/dialogflow - // -webhook-json) + // (https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json) Payload googleapi.RawMessage `json:"payload,omitempty"` // SessionEntityTypes: Optional. Additional session entity types to diff --git a/digitalassetlinks/v1/digitalassetlinks-gen.go b/digitalassetlinks/v1/digitalassetlinks-gen.go index 70fcd7778e3..fa0a4440511 100644 --- a/digitalassetlinks/v1/digitalassetlinks-gen.go +++ b/digitalassetlinks/v1/digitalassetlinks-gen.go @@ -522,8 +522,7 @@ type AssetlinksCheckCall struct { // the website's statements have not been altered by a third party. For // more information, see the Digital Asset Links technical design // specification -// (https://github.com/google/digitalassetlinks/blob/master/well-known/de -// tails.md). +// (https://github.com/google/digitalassetlinks/blob/master/well-known/details.md). func (r *AssetlinksService) Check() *AssetlinksCheckCall { c := &AssetlinksCheckCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -815,16 +814,16 @@ type StatementsListCall struct { // or Android apps, have been made in a secure way by the owner of those // assets, as described in the Digital Asset Links technical design // specification -// (https://github.com/google/digitalassetlinks/blob/master/well-known/de -// tails.md). Specifically, you should consider that for insecure -// websites (that is, where the URL starts with `http://` instead of -// `https://`), this guarantee cannot be made. The `List` command is -// most useful in cases where the API client wants to know all the ways -// in which two assets are related, or enumerate all the relationships -// from a particular source asset. Example: a feature that helps users -// navigate to related items. When a mobile app is running on a device, -// the feature would make it easy to navigate to the corresponding web -// site or Google+ profile. +// (https://github.com/google/digitalassetlinks/blob/master/well-known/details.md). +// Specifically, you should consider that for insecure websites (that +// is, where the URL starts with `http://` instead of `https://`), this +// guarantee cannot be made. The `List` command is most useful in cases +// where the API client wants to know all the ways in which two assets +// are related, or enumerate all the relationships from a particular +// source asset. Example: a feature that helps users navigate to related +// items. When a mobile app is running on a device, the feature would +// make it easy to navigate to the corresponding web site or Google+ +// profile. func (r *StatementsService) List() *StatementsListCall { c := &StatementsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index a22be87cefb..a3d475a2755 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -2107,18 +2107,18 @@ type GooglePrivacyDlpV2CryptoReplaceFfxFpeConfig struct { // the surrogate is 'abc', the full replacement value will be: // 'MY_TOKEN_INFO_TYPE(3):abc' This annotation identifies the surrogate // when inspecting content using the custom infoType `SurrogateType` - // (https://cloud.google.com/dlp/docs/reference/rest/v2/InspectConfig#sur - // rogatetype). This facilitates reversal of the surrogate when it - // occurs in free text. In order for inspection to work properly, the - // name of this infoType must not occur naturally anywhere in your data; - // otherwise, inspection may find a surrogate that does not correspond - // to an actual identifier. Therefore, choose your custom infoType name - // carefully after considering what your data looks like. One way to - // select a name that has a high chance of yielding reliable detection - // is to include one or more unicode characters that are highly - // improbable to exist in your data. For example, assuming your data is - // entered from a regular ASCII keyboard, the symbol with the hex code - // point 29DD might be used like so: ⧝MY_TOKEN_TYPE + // (https://cloud.google.com/dlp/docs/reference/rest/v2/InspectConfig#surrogatetype). + // This facilitates reversal of the surrogate when it occurs in free + // text. In order for inspection to work properly, the name of this + // infoType must not occur naturally anywhere in your data; otherwise, + // inspection may find a surrogate that does not correspond to an actual + // identifier. Therefore, choose your custom infoType name carefully + // after considering what your data looks like. One way to select a name + // that has a high chance of yielding reliable detection is to include + // one or more unicode characters that are highly improbable to exist in + // your data. For example, assuming your data is entered from a regular + // ASCII keyboard, the symbol with the hex code point 29DD might be used + // like so: ⧝MY_TOKEN_TYPE SurrogateInfoType *GooglePrivacyDlpV2InfoType `json:"surrogateInfoType,omitempty"` // ForceSendFields is a list of field names (e.g. "CommonAlphabet") to @@ -2817,9 +2817,9 @@ func (s *GooglePrivacyDlpV2DetectionRule) MarshalJSON() ([]byte, error) { // information specific to the data, such as a list of employee IDs or // job titles. Dictionary words are case-insensitive and all characters // other than letters and digits in the unicode Basic Multilingual Plane -// (https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_ -// Plane) will be replaced with whitespace when scanning for matches, so -// the dictionary phrase "Sam Johnson" will match all three phrases "sam +// (https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane) +// will be replaced with whitespace when scanning for matches, so the +// dictionary phrase "Sam Johnson" will match all three phrases "sam // johnson", "Sam, Johnson", and "Sam (Johnson)". Additionally, the // characters surrounding any match must be of a different type than the // adjacent characters within the word, so letters must be next to @@ -5951,8 +5951,8 @@ type GooglePrivacyDlpV2PublishSummaryToCscc struct { // Pub/Sub topic when DlpJob has completed. The message contains a // single field, `DlpJobName`, which is equal to the finished job's // `DlpJob.name` -// (https://cloud.google.com/dlp/docs/reference/rest/v2/projects.dlpJobs# -// DlpJob). Compatible with: Inspect, Risk +// (https://cloud.google.com/dlp/docs/reference/rest/v2/projects.dlpJobs#DlpJob). +// Compatible with: Inspect, Risk type GooglePrivacyDlpV2PublishToPubSub struct { // Topic: Cloud Pub/Sub topic to send notifications to. The topic must // have given publishing access rights to the DLP API service account @@ -7198,12 +7198,12 @@ func (s *GooglePrivacyDlpV2SummaryResult) MarshalJSON() ([]byte, error) { // GooglePrivacyDlpV2SurrogateType: Message for detecting output from // deidentification transformations such as `CryptoReplaceFfxFpeConfig` -// (https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.dei -// dentifyTemplates#cryptoreplaceffxfpeconfig). These types of -// transformations are those that perform pseudonymization, thereby -// producing a "surrogate" as output. This should be used in conjunction -// with a field on the transformation such as `surrogate_info_type`. -// This CustomInfoType does not support the use of `detection_rules`. +// (https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig). +// These types of transformations are those that perform +// pseudonymization, thereby producing a "surrogate" as output. This +// should be used in conjunction with a field on the transformation such +// as `surrogate_info_type`. This CustomInfoType does not support the +// use of `detection_rules`. type GooglePrivacyDlpV2SurrogateType struct { } @@ -14652,8 +14652,8 @@ type ProjectsContentReidentifyCall struct { } // Reidentify: Re-identifies content that has been de-identified. See -// https://cloud.google.com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example to learn -// more. +// https://cloud.google.com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example +// to learn more. func (r *ProjectsContentService) Reidentify(parentid string, googleprivacydlpv2reidentifycontentrequest *GooglePrivacyDlpV2ReidentifyContentRequest) *ProjectsContentReidentifyCall { c := &ProjectsContentReidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parentid = parentid @@ -18633,8 +18633,8 @@ type ProjectsLocationsContentReidentifyCall struct { } // Reidentify: Re-identifies content that has been de-identified. See -// https://cloud.google.com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example to learn -// more. +// https://cloud.google.com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example +// to learn more. func (r *ProjectsLocationsContentService) Reidentify(parentid string, googleprivacydlpv2reidentifycontentrequest *GooglePrivacyDlpV2ReidentifyContentRequest) *ProjectsLocationsContentReidentifyCall { c := &ProjectsLocationsContentReidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parentid = parentid diff --git a/documentai/v1beta2/documentai-gen.go b/documentai/v1beta2/documentai-gen.go index 010b4cfedbe..06cad8edad1 100644 --- a/documentai/v1beta2/documentai-gen.go +++ b/documentai/v1beta2/documentai-gen.go @@ -5843,8 +5843,8 @@ type GoogleTypePostalAddress struct { // RegionCode: Required. CLDR region code of the country/region of the // address. This is never inferred and it is up to the user to ensure // the value is correct. See http://cldr.unicode.org/ and - // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for - // Switzerland. + // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. RegionCode string `json:"regionCode,omitempty"` // Revision: The schema revision of the `PostalAddress`. This must be diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 7c2fef7c12d..e9bda604470 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -7380,8 +7380,8 @@ type GoogleTypePostalAddress struct { // RegionCode: Required. CLDR region code of the country/region of the // address. This is never inferred and it is up to the user to ensure // the value is correct. See http://cldr.unicode.org/ and - // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for - // Switzerland. + // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. RegionCode string `json:"regionCode,omitempty"` // Revision: The schema revision of the `PostalAddress`. This must be diff --git a/domains/v1alpha2/domains-gen.go b/domains/v1alpha2/domains-gen.go index de787cb83f9..06f54e6cd3d 100644 --- a/domains/v1alpha2/domains-gen.go +++ b/domains/v1alpha2/domains-gen.go @@ -1457,8 +1457,8 @@ type PostalAddress struct { // RegionCode: Required. CLDR region code of the country/region of the // address. This is never inferred and it is up to the user to ensure // the value is correct. See http://cldr.unicode.org/ and - // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for - // Switzerland. + // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. RegionCode string `json:"regionCode,omitempty"` // Revision: The schema revision of the `PostalAddress`. This must be diff --git a/domains/v1beta1/domains-gen.go b/domains/v1beta1/domains-gen.go index 649d13d6731..dd00f0ee92b 100644 --- a/domains/v1beta1/domains-gen.go +++ b/domains/v1beta1/domains-gen.go @@ -1457,8 +1457,8 @@ type PostalAddress struct { // RegionCode: Required. CLDR region code of the country/region of the // address. This is never inferred and it is up to the user to ensure // the value is correct. See http://cldr.unicode.org/ and - // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for - // Switzerland. + // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. RegionCode string `json:"regionCode,omitempty"` // Revision: The schema revision of the `PostalAddress`. This must be diff --git a/eventarc/v1beta1/eventarc-gen.go b/eventarc/v1beta1/eventarc-gen.go index a6de522f3e8..96423f73987 100644 --- a/eventarc/v1beta1/eventarc-gen.go +++ b/eventarc/v1beta1/eventarc-gen.go @@ -368,8 +368,9 @@ type CloudRunService struct { // Service: Required. The name of the Cloud run service being addressed // (see - // https://cloud.google.com/run/docs/reference/rest/v1/namespaces.services). Only services located in the same project of the trigger object can be - // addressed. + // https://cloud.google.com/run/docs/reference/rest/v1/namespaces.services). + // Only services located in the same project of the trigger object can + // be addressed. Service string `json:"service,omitempty"` // ForceSendFields is a list of field names (e.g. "Path") to @@ -1157,8 +1158,14 @@ type Trigger struct { // with the trigger. The service account represents the identity of the // trigger. The principal who calls this API must have // `iam.serviceAccounts.actAs` permission in the service account. See - // https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common for more information. For Cloud Run destinations, this service account is used to generate identity tokens when invoking the service. See https://cloud.google.com/run/docs/triggering/pubsub-push#create-service-account for information on how to invoke authenticated Cloud Run services. In order to create Audit Log triggers, the service account should also have 'eventarc.events.receiveAuditLogV1Written' - // permission. + // https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common + // for more information. For Cloud Run destinations, this service + // account is used to generate identity tokens when invoking the + // service. See + // https://cloud.google.com/run/docs/triggering/pubsub-push#create-service-account + // for information on how to invoke authenticated Cloud Run services. In + // order to create Audit Log triggers, the service account should also + // have 'eventarc.events.receiveAuditLogV1Written' permission. ServiceAccount string `json:"serviceAccount,omitempty"` // Transport: Output only. In order to deliver messages, Eventarc may diff --git a/fcm/v1/fcm-gen.go b/fcm/v1/fcm-gen.go index e6c48906a5b..4036d4b1b5f 100644 --- a/fcm/v1/fcm-gen.go +++ b/fcm/v1/fcm-gen.go @@ -291,12 +291,12 @@ type AndroidNotification struct { BodyLocKey string `json:"bodyLocKey,omitempty"` // ChannelId: The notification's channel id - // (https://developer.android.com/guide/topics/ui/notifiers/notifications - // #ManageChannels) (new in Android O). The app must create a channel - // with this channel ID before any notification with this channel ID is - // received. If you don't send this channel ID in the request, or if the - // channel ID provided has not yet been created by the app, FCM uses the - // channel ID specified in the app manifest. + // (https://developer.android.com/guide/topics/ui/notifiers/notifications#ManageChannels) + // (new in Android O). The app must create a channel with this channel + // ID before any notification with this channel ID is received. If you + // don't send this channel ID in the request, or if the channel ID + // provided has not yet been created by the app, FCM uses the channel ID + // specified in the app manifest. ChannelId string `json:"channelId,omitempty"` // ClickAction: The action associated with a user click on the @@ -310,33 +310,31 @@ type AndroidNotification struct { // DefaultLightSettings: If set to true, use the Android framework's // default LED light settings for the notification. Default values are // specified in config.xml - // (https://android.googlesource.com/platform/frameworks/base/+/master/co - // re/res/res/values/config.xml). If `default_light_settings` is set to - // true and `light_settings` is also set, the user-specified - // `light_settings` is used instead of the default value. + // (https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). + // If `default_light_settings` is set to true and `light_settings` is + // also set, the user-specified `light_settings` is used instead of the + // default value. DefaultLightSettings bool `json:"defaultLightSettings,omitempty"` // DefaultSound: If set to true, use the Android framework's default // sound for the notification. Default values are specified in // config.xml - // (https://android.googlesource.com/platform/frameworks/base/+/master/co - // re/res/res/values/config.xml). + // (https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). DefaultSound bool `json:"defaultSound,omitempty"` // DefaultVibrateTimings: If set to true, use the Android framework's // default vibrate pattern for the notification. Default values are // specified in config.xml - // (https://android.googlesource.com/platform/frameworks/base/+/master/co - // re/res/res/values/config.xml). If `default_vibrate_timings` is set to - // true and `vibrate_timings` is also set, the default value is used - // instead of the user-specified `vibrate_timings`. + // (https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). + // If `default_vibrate_timings` is set to true and `vibrate_timings` is + // also set, the default value is used instead of the user-specified + // `vibrate_timings`. DefaultVibrateTimings bool `json:"defaultVibrateTimings,omitempty"` // EventTime: Set the time that the event in the notification occurred. // Notifications in the panel are sorted by this time. A point in time // is represented using protobuf.Timestamp - // (https://developers.google.com/protocol-buffers/docs/reference/java/co - // m/google/protobuf/Timestamp). + // (https://developers.google.com/protocol-buffers/docs/reference/java/com/google/protobuf/Timestamp). EventTime string `json:"eventTime,omitempty"` // Icon: The notification's icon. Sets the notification icon to myicon @@ -359,8 +357,7 @@ type AndroidNotification struct { // the current device. Some notifications can be bridged to other // devices for remote display, such as a Wear OS watch. This hint can be // set to recommend this notification not be bridged. See Wear OS guides - // (https://developer.android.com/training/wearables/notifications/bridge - // r#existing-method-of-preventing-bridging) + // (https://developer.android.com/training/wearables/notifications/bridger#existing-method-of-preventing-bridging) LocalOnly bool `json:"localOnly,omitempty"` // NotificationCount: Sets the number of items this notification @@ -384,9 +381,8 @@ type AndroidNotification struct { // slightly on different platforms. Note this priority differs from // `AndroidMessagePriority`. This priority is processed by the client // after the message has been delivered, whereas AndroidMessagePriority - // (https://firebase.google.com/docs/reference/fcm/rest/v1/projects.messa - // ges#androidmessagepriority) is an FCM concept that controls when the - // message is delivered. + // (https://firebase.google.com/docs/reference/fcm/rest/v1/projects.messages#androidmessagepriority) + // is an FCM concept that controls when the message is delivered. // // Possible values: // "PRIORITY_UNSPECIFIED" - If priority is unspecified, notification @@ -449,19 +445,19 @@ type AndroidNotification struct { // VibrateTimings: Set the vibration pattern to use. Pass in an array of // protobuf.Duration - // (https://developers.google.com/protocol-buffers/docs/reference/google. - // protobuf#google.protobuf.Duration) to turn on or off the vibrator. - // The first value indicates the `Duration` to wait before turning the - // vibrator on. The next value indicates the `Duration` to keep the - // vibrator on. Subsequent values alternate between `Duration` to turn - // the vibrator off and to turn the vibrator on. If `vibrate_timings` is - // set and `default_vibrate_timings` is set to `true`, the default value - // is used instead of the user-specified `vibrate_timings`. + // (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration) + // to turn on or off the vibrator. The first value indicates the + // `Duration` to wait before turning the vibrator on. The next value + // indicates the `Duration` to keep the vibrator on. Subsequent values + // alternate between `Duration` to turn the vibrator off and to turn the + // vibrator on. If `vibrate_timings` is set and + // `default_vibrate_timings` is set to `true`, the default value is used + // instead of the user-specified `vibrate_timings`. VibrateTimings []string `json:"vibrateTimings,omitempty"` // Visibility: Set the Notification.visibility - // (https://developer.android.com/reference/android/app/Notification.html - // #visibility) of the notification. + // (https://developer.android.com/reference/android/app/Notification.html#visibility) + // of the notification. // // Possible values: // "VISIBILITY_UNSPECIFIED" - If unspecified, default to @@ -505,17 +501,15 @@ type ApnsConfig struct { // Headers: HTTP request headers defined in Apple Push Notification // Service. Refer to APNs request headers - // (https://developer.apple.com/documentation/usernotifications/setting_u - // p_a_remote_notification_server/sending_notification_requests_to_apns) + // (https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/sending_notification_requests_to_apns) // for supported headers, e.g. "apns-priority": "10". Headers map[string]string `json:"headers,omitempty"` // Payload: APNs payload as a JSON object, including both `aps` // dictionary and custom payload. See Payload Key Reference - // (https://developer.apple.com/documentation/usernotifications/setting_u - // p_a_remote_notification_server/generating_a_remote_notification). If - // present, it overrides google.firebase.fcm.v1.Notification.title and - // google.firebase.fcm.v1.Notification.body. + // (https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/generating_a_remote_notification). + // If present, it overrides google.firebase.fcm.v1.Notification.title + // and google.firebase.fcm.v1.Notification.body. Payload googleapi.RawMessage `json:"payload,omitempty"` // ForceSendFields is a list of field names (e.g. "FcmOptions") to @@ -729,20 +723,17 @@ func (s *FcmOptions) MarshalJSON() ([]byte, error) { // LightSettings: Settings to control notification LED. type LightSettings struct { // Color: Required. Set `color` of the LED with google.type.Color - // (https://github.com/googleapis/googleapis/blob/master/google/type/colo - // r.proto). + // (https://github.com/googleapis/googleapis/blob/master/google/type/color.proto). Color *Color `json:"color,omitempty"` // LightOffDuration: Required. Along with `light_on_duration `, define // the blink rate of LED flashes. Resolution defined by proto.Duration - // (https://developers.google.com/protocol-buffers/docs/reference/google. - // protobuf#google.protobuf.Duration) + // (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration) LightOffDuration string `json:"lightOffDuration,omitempty"` // LightOnDuration: Required. Along with `light_off_duration`, define // the blink rate of LED flashes. Resolution defined by proto.Duration - // (https://developers.google.com/protocol-buffers/docs/reference/google. - // protobuf#google.protobuf.Duration) + // (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration) LightOnDuration string `json:"lightOnDuration,omitempty"` // ForceSendFields is a list of field names (e.g. "Color") to diff --git a/firebase/v1beta1/firebase-gen.go b/firebase/v1beta1/firebase-gen.go index 694920c46d2..c03cc37ac22 100644 --- a/firebase/v1beta1/firebase-gen.go +++ b/firebase/v1beta1/firebase-gen.go @@ -737,8 +737,8 @@ func (s *FirebaseAppInfo) MarshalJSON() ([]byte, error) { // Cloud Storage buckets), and other Firebase and Google Cloud Platform // (GCP) resources. You create a `FirebaseProject` by calling // AddFirebase and specifying an *existing* GCP `Project` -// (https://cloud.google.com/resource-manager/reference/rest/v1/projects) -// . This adds Firebase resources to the existing GCP `Project`. Since a +// (https://cloud.google.com/resource-manager/reference/rest/v1/projects). +// This adds Firebase resources to the existing GCP `Project`. Since a // FirebaseProject is actually also a GCP `Project`, a `FirebaseProject` // has the same underlying GCP identifiers (`projectNumber` and // `projectId`). This allows for easy interop with Google APIs. @@ -1780,7 +1780,7 @@ type AvailableProjectsListCall struct { // List: Lists each [Google Cloud Platform (GCP) `Project`] // (https://cloud.google.com/resource-manager/reference/rest/v1/projects) -// that can have Firebase resources added to it. A Project will only be +// that can have Firebase resources added to it. A Project will only be // listed if: - The caller has sufficient Google IAM // (https://cloud.google.com/iam) permissions to call AddFirebase. - The // Project is not already a FirebaseProject. - The Project is not in an @@ -2120,8 +2120,8 @@ type ProjectsAddFirebaseCall struct { // AddFirebase: Adds Firebase resources to the specified existing // [Google Cloud Platform (GCP) `Project`] -// (https://cloud.google.com/resource-manager/reference/rest/v1/projects) -// . Since a FirebaseProject is actually also a GCP `Project`, a +// (https://cloud.google.com/resource-manager/reference/rest/v1/projects). +// Since a FirebaseProject is actually also a GCP `Project`, a // `FirebaseProject` has the same underlying GCP identifiers // (`projectNumber` and `projectId`). This allows for easy interop with // Google APIs. The result of this call is an `Operation` @@ -4865,11 +4865,11 @@ type ProjectsAvailableLocationsListCall struct { // default GCP resource location has already been set for the Project, // then this setting cannot be changed. This call checks for any // possible location restrictions -// (https://cloud.google.com/resource-manager/docs/organization-policy/de -// fining-locations) for the specified Project and, thus, might return a -// subset of all possible GCP resource locations. To list all GCP -// resource locations (regardless of any restrictions), call the -// endpoint without specifying a unique project identifier (that is, +// (https://cloud.google.com/resource-manager/docs/organization-policy/defining-locations) +// for the specified Project and, thus, might return a subset of all +// possible GCP resource locations. To list all GCP resource locations +// (regardless of any restrictions), call the endpoint without +// specifying a unique project identifier (that is, // `/v1beta1/{parent=projects/-}/listAvailableLocations`). To call // `ListAvailableLocations` with a specified project, a member must be // at minimum a Viewer of the Project. Calls without a specified project @@ -5073,9 +5073,8 @@ type ProjectsDefaultLocationFinalizeCall struct { // Finalize: Sets the default Google Cloud Platform (GCP) resource // location for the specified FirebaseProject. This method creates an // App Engine application with a default Cloud Storage bucket -// (https://cloud.google.com/appengine/docs/standard/python/googlecloudst -// orageclient/setting-up-cloud-storage#activating_a_cloud_storage_bucket -// ), located in the specified `locationId` +// (https://cloud.google.com/appengine/docs/standard/python/googlecloudstorageclient/setting-up-cloud-storage#activating_a_cloud_storage_bucket), +// located in the specified `locationId` // (#body.request_body.FIELDS.location_id). This location must be one of // the available GCP resource locations // (https://firebase.google.com/docs/projects/locations). After the diff --git a/firebasedatabase/v1beta/firebasedatabase-gen.go b/firebasedatabase/v1beta/firebasedatabase-gen.go index 5183d8ab817..b2a2e86ad2f 100644 --- a/firebasedatabase/v1beta/firebasedatabase-gen.go +++ b/firebasedatabase/v1beta/firebasedatabase-gen.go @@ -319,8 +319,9 @@ type ProjectsLocationsInstancesCreateCall struct { // a successfully created DatabaseInstance is ACTIVE. Only available for // projects on the Blaze plan. Projects can be upgraded using the Cloud // Billing API -// https://cloud.google.com/billing/reference/rest/v1/projects/updateBillingInfo. Note that it might take a few minutes for billing enablement state to propagate to Firebase -// systems. +// https://cloud.google.com/billing/reference/rest/v1/projects/updateBillingInfo. +// Note that it might take a few minutes for billing enablement state to +// propagate to Firebase systems. func (r *ProjectsLocationsInstancesService) Create(parent string, databaseinstance *DatabaseInstance) *ProjectsLocationsInstancesCreateCall { c := &ProjectsLocationsInstancesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go b/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go index e524122b3d5..cf49593bca6 100644 --- a/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go +++ b/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go @@ -247,16 +247,14 @@ func (s *AndroidInfo) MarshalJSON() ([]byte, error) { type CreateManagedShortLinkRequest struct { // DynamicLinkInfo: Information about the Dynamic Link to be shortened. // Learn more - // (https://firebase.google.com/docs/reference/dynamic-links/link-shorten - // er). + // (https://firebase.google.com/docs/reference/dynamic-links/link-shortener). DynamicLinkInfo *DynamicLinkInfo `json:"dynamicLinkInfo,omitempty"` // LongDynamicLink: Full long Dynamic Link URL with desired query // parameters specified. For example, // "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample" // , Learn more - // (https://firebase.google.com/docs/reference/dynamic-links/link-shorten - // er). + // (https://firebase.google.com/docs/reference/dynamic-links/link-shortener). LongDynamicLink string `json:"longDynamicLink,omitempty"` // Name: Link name to associate with the link. It's used for marketer to @@ -342,16 +340,14 @@ func (s *CreateManagedShortLinkResponse) MarshalJSON() ([]byte, error) { type CreateShortDynamicLinkRequest struct { // DynamicLinkInfo: Information about the Dynamic Link to be shortened. // Learn more - // (https://firebase.google.com/docs/reference/dynamic-links/link-shorten - // er). + // (https://firebase.google.com/docs/reference/dynamic-links/link-shortener). DynamicLinkInfo *DynamicLinkInfo `json:"dynamicLinkInfo,omitempty"` // LongDynamicLink: Full long Dynamic Link URL with desired query // parameters specified. For example, // "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample" // , Learn more - // (https://firebase.google.com/docs/reference/dynamic-links/link-shorten - // er). + // (https://firebase.google.com/docs/reference/dynamic-links/link-shortener). LongDynamicLink string `json:"longDynamicLink,omitempty"` // SdkVersion: Google SDK version. Version takes the form @@ -1059,8 +1055,7 @@ func (s *GetIosReopenAttributionResponse) MarshalJSON() ([]byte, error) { // GooglePlayAnalytics: Parameters for Google Play Campaign // Measurements. Learn more -// (https://developers.google.com/analytics/devguides/collection/android/ -// v4/campaigns#campaign-params) +// (https://developers.google.com/analytics/devguides/collection/android/v4/campaigns#campaign-params) type GooglePlayAnalytics struct { // Gclid: AdWords autotagging parameter // (https://support.google.com/analytics/answer/1033981?hl=en); used to diff --git a/genomics/v1alpha2/genomics-gen.go b/genomics/v1alpha2/genomics-gen.go index ba9383cf2bb..68ddea8b7d9 100644 --- a/genomics/v1alpha2/genomics-gen.go +++ b/genomics/v1alpha2/genomics-gen.go @@ -429,8 +429,8 @@ type Disk struct { // ReadOnly: Specifies how a sourced-base persistent disk will be // mounted. See - // https://cloud.google.com/compute/docs/disks/persistent-disks#use_multi_instances for more details. Can only be set at create - // time. + // https://cloud.google.com/compute/docs/disks/persistent-disks#use_multi_instances + // for more details. Can only be set at create time. ReadOnly bool `json:"readOnly,omitempty"` // SizeGb: The size of the disk. Defaults to 500 (GB). This field is not @@ -438,8 +438,10 @@ type Disk struct { SizeGb int64 `json:"sizeGb,omitempty"` // Source: The full or partial URL of the persistent disk to attach. See - // https://cloud.google.com/compute/docs/reference/latest/instances#resource and https://cloud.google.com/compute/docs/disks/persistent-disks#snapshots for more - // details. + // https://cloud.google.com/compute/docs/reference/latest/instances#resource + // and + // https://cloud.google.com/compute/docs/disks/persistent-disks#snapshots + // for more details. Source string `json:"source,omitempty"` // Type: Required. The type of the disk to create. @@ -1165,16 +1167,15 @@ type PipelineResources struct { // an experimental feature that may go away. Defaults to false. // Corresponds to `--no_address` flag for [gcloud compute instances // create] - // (https://cloud.google.com/sdk/gcloud/reference/compute/instances/creat - // e). In order to use this, must be true for both create time and run - // time. Cannot be true at run time if false at create time. If you need - // to ssh into a private IP VM for debugging, you can ssh to a public VM + // (https://cloud.google.com/sdk/gcloud/reference/compute/instances/create). + // In order to use this, must be true for both create time and run time. + // Cannot be true at run time if false at create time. If you need to + // ssh into a private IP VM for debugging, you can ssh to a public VM // and then ssh into the private VM's Internal IP. If noAddress is set, // this pipeline run may only load docker images from Google Container // Registry and not Docker Hub. Before using this, you must configure // access to Google services from internal IPs - // (https://cloud.google.com/compute/docs/configure-private-google-access - // #configuring_access_to_google_services_from_internal_ips). + // (https://cloud.google.com/compute/docs/configure-private-google-access#configuring_access_to_google_services_from_internal_ips). NoAddress bool `json:"noAddress,omitempty"` // Preemptible: Whether to use preemptible VMs. Defaults to `false`. In diff --git a/genomics/v2alpha1/genomics-gen.go b/genomics/v2alpha1/genomics-gen.go index 7a518fa12c4..71239a80eaf 100644 --- a/genomics/v2alpha1/genomics-gen.go +++ b/genomics/v2alpha1/genomics-gen.go @@ -1814,9 +1814,8 @@ type VirtualMachine struct { // "n1-standard-1") or a custom machine type (such as "custom-1-4096", // where "1" indicates the number of vCPUs and "4096" indicates the // memory in MB). See Creating an instance with a custom machine type - // (https://cloud.google.com/compute/docs/instances/creating-instance-wit - // h-custom-machine-type#create) for more specifications on creating a - // custom machine type. + // (https://cloud.google.com/compute/docs/instances/creating-instance-with-custom-machine-type#create) + // for more specifications on creating a custom machine type. MachineType string `json:"machineType,omitempty"` // Network: The VM network configuration. diff --git a/google-api-go-generator/gen.go b/google-api-go-generator/gen.go index 41b36d88e02..7a2614ea779 100644 --- a/google-api-go-generator/gen.go +++ b/google-api-go-generator/gen.go @@ -27,7 +27,6 @@ import ( "unicode" "google.golang.org/api/google-api-go-generator/internal/disco" - "google.golang.org/api/internal/version" ) const ( @@ -2018,7 +2017,7 @@ func (meth *Method) generateCode() { pn("\nfunc (c *%s) doRequest(alt string) (*http.Response, error) {", callName) pn(`reqHeaders := make(http.Header)`) - pn(`reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/%s")`, version.Repo) + pn(`reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110")`) pn("for k, v := range c.header_ {") pn(" reqHeaders[k] = v") pn("}") @@ -2374,7 +2373,7 @@ func (meth *Method) NewBodyArg(ds *disco.Schema) *argument { func (meth *Method) NewArg(apiname string, p *Param) *argument { apitype := p.p.Type - des := removeMarkdownLinks(p.p.Description) + des := p.p.Description goname := validGoIdentifer(apiname) // but might be changed later, if conflicts if strings.Contains(des, "identifier") && !strings.HasSuffix(strings.ToLower(goname), "id") { goname += "id" // yay @@ -2475,7 +2474,7 @@ func (a *arguments) String() string { return buf.String() } -var urlRE = regexp.MustCompile(`^http\S+$`) +var urlRE = regexp.MustCompile(`^\(?http\S+$`) func asComment(pfx, c string) string { var buf bytes.Buffer @@ -2492,11 +2491,14 @@ func asComment(pfx, c string) string { break } // Don't break URLs. + var si int if !urlRE.MatchString(line[:maxLen]) { line = line[:maxLen] + si = strings.LastIndex(line, " ") + } else { + si = strings.Index(line, " ") } - si := strings.LastIndex(line, " ") - if nl := strings.Index(line, "\n"); nl != -1 && nl < si { + if nl := strings.Index(line, "\n"); nl != -1 && (nl < si || si == -1) { si = nl } if si != -1 { diff --git a/google-api-go-generator/gen_test.go b/google-api-go-generator/gen_test.go index cd9f8d25ec3..13ace509edb 100644 --- a/google-api-go-generator/gen_test.go +++ b/google-api-go-generator/gen_test.go @@ -243,7 +243,7 @@ func TestIsNewerRevision(t *testing.T) { } } -func TestIt(t *testing.T) { +func TestRemoveMarkdownLinks(t *testing.T) { tests := []struct { name string input string @@ -269,3 +269,16 @@ func TestIt(t *testing.T) { }) } } + +func TestAsComment_LongLink(t *testing.T) { + //input := "The specification of cohorts for a cohort report. Cohort reports create a time series of user retention for the cohort. For example, you could select the cohort of users that were acquired in the first week of September and follow that cohort for the next six weeks. Selecting the users acquired in the first week of September cohort is specified in the `cohort` object. Following that cohort for the next six weeks is specified in the `cohortsRange` object. For examples, see [Cohort Report Examples](https://developers.google.com/analytics/devguides/reporting/data/v1/advanced#cohort_report_examples). The report response could show a weekly time series where say your app has retained 60% of this cohort after three weeks and 25% of this cohort after six weeks. These two percentages can be calculated by the metric `cohortActiveUsers/cohortTotalUsers` and will be separate rows in the report." + input := "This make sure we don't split long links (http://example.com/really/really/really/really/really/really/really/really/really/really/really/long). We want them to show up well in godoc." + want := `// This make sure we don't split long links +// (http://example.com/really/really/really/really/really/really/really/really/really/really/really/long). +// We want them to show up well in godoc. +` + got := asComment("", input) + if got != want { + t.Errorf("got %q, want %q", got, want) + } +} diff --git a/google-api-go-generator/testdata/http-body.want b/google-api-go-generator/testdata/http-body.want index a53e58ac9a0..f002f0842df 100644 --- a/google-api-go-generator/testdata/http-body.want +++ b/google-api-go-generator/testdata/http-body.want @@ -404,15 +404,13 @@ type ProjectsLocationsDatasetsFhirStoresFhirReadCall struct { // Read: Gets the contents of a FHIR resource. // -// Implements the FHIR standard -// [read -// interaction](http://hl7.org/implement/standards/fhir/STU3/http.h -// tml#read). +// Implements the FHIR standard read +// interaction +// (http://hl7.org/implement/standards/fhir/STU3/http.html#read). // -// Also supports the FHIR standard [conditional -// read -// interaction](http://hl7.org/implement/standards/fhir/STU3/http.ht -// ml#cread) +// Also supports the FHIR standard conditional read +// interaction +// (http://hl7.org/implement/standards/fhir/STU3/http.html#cread) // specified by supplying an `If-Modified-Since` header with a date/time // value // or an `If-None-Match` header with an ETag value. diff --git a/google-api-go-generator/testdata/json-body.want b/google-api-go-generator/testdata/json-body.want index f3e30c8c643..1a6c3b8df46 100644 --- a/google-api-go-generator/testdata/json-body.want +++ b/google-api-go-generator/testdata/json-body.want @@ -389,7 +389,7 @@ type GoogleCloudMlV1__AutoScaling struct { // `rate` * `min_nodes` * number of hours since last billing // cycle, // where `rate` is the cost per node-hour as documented in the - // [pricing guide](/ml-engine/docs/pricing), + // pricing guide (/ml-engine/docs/pricing), // even if no predictions are performed. There is additional cost for // each // prediction performed. @@ -1051,8 +1051,8 @@ type GoogleCloudMlV1__Model struct { // // You can change the default version by // calling - // [projects.methods.versions.setDefault](/ml-engine/reference/re - // st/v1/projects.models.versions/setDefault). + // projects.methods.versions.setDefault + // (/ml-engine/reference/rest/v1/projects.models.versions/setDefault). DefaultVersion *GoogleCloudMlV1__Version `json:"defaultVersion,omitempty"` // Description: Optional. The description specified for the model when @@ -1441,16 +1441,14 @@ type GoogleCloudMlV1__PredictionInput struct { // SignatureName: Optional. The name of the signature defined in the // SavedModel to use for - // this job. Please refer - // to - // [SavedModel](https://tensorflow.github.io/serving/serving_basic.htm - // l) + // this job. Please refer to + // SavedModel + // (https://tensorflow.github.io/serving/serving_basic.html) // for information about how to use signatures. // - // Defaults - // to - // [DEFAULT_SERVING_SIGNATURE_DEF_KEY](https://www.tensorflow.org/api_ - // docs/python/tf/saved_model/signature_constants) + // Defaults to + // DEFAULT_SERVING_SIGNATURE_DEF_KEY + // (https://www.tensorflow.org/api_docs/python/tf/saved_model/signature_constants) // , which is "serving_default". SignatureName string `json:"signatureName,omitempty"` @@ -1466,8 +1464,7 @@ type GoogleCloudMlV1__PredictionInput struct { // of the version // information: // - // "projects/YOUR_PROJECT/models/YOUR_MODEL/versions/YOUR_ - // VERSION" + // "projects/YOUR_PROJECT/models/YOUR_MODEL/versions/YOUR_VERSION" VersionName string `json:"versionName,omitempty"` // ForceSendFields is a list of field names (e.g. "Accelerator") to @@ -1903,8 +1900,8 @@ func (s *GoogleCloudMlV1__TrainingOutput) UnmarshalJSON(data []byte) error { // get // information about all of the versions of a given model by // calling -// [projects.models.versions.list](/ml-engine/reference/rest/v1/p -// rojects.models.versions/list). +// projects.models.versions.list +// (/ml-engine/reference/rest/v1/projects.models.versions/list). type GoogleCloudMlV1__Version struct { // AutoScaling: Automatically scale the number of nodes used to serve // the model in @@ -1919,16 +1916,14 @@ type GoogleCloudMlV1__Version struct { // DeploymentUri: Required. The Google Cloud Storage location of the // trained model used to // create the version. See the - // [guide to - // model - // deployment](/ml-engine/docs/tensorflow/deploying-models) for + // guide to model + // deployment (/ml-engine/docs/tensorflow/deploying-models) for // more // information. // - // When passing Version - // to - // [projects.models.versions.create](/ml-engine/reference/rest/v1/proj - // ects.models.versions/create) + // When passing Version to + // projects.models.versions.create + // (/ml-engine/reference/rest/v1/projects.models.versions/create) // the model service uses the specified location as the source of the // model. // Once deployed, the model version is hosted by the prediction service, @@ -1985,8 +1980,8 @@ type GoogleCloudMlV1__Version struct { // // You can change the default version by // calling - // [projects.methods.versions.setDefault](/ml-engine/reference/re - // st/v1/projects.models.versions/setDefault). + // projects.methods.versions.setDefault + // (/ml-engine/reference/rest/v1/projects.models.versions/setDefault). IsDefault bool `json:"isDefault,omitempty"` // Labels: Optional. One or more labels that you can add, to organize @@ -2370,7 +2365,7 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) { // // // For a description of IAM and its features, see the -// [IAM developer's guide](https://cloud.google.com/iam/docs). +// IAM developer's guide (https://cloud.google.com/iam/docs). type GoogleIamV1__Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2481,8 +2476,8 @@ type GoogleIamV1__TestIamPermissionsRequest struct { // wildcards (such as '*' or 'storage.*') are not allowed. For // more // information see - // [IAM - // Overview](https://cloud.google.com/iam/docs/overview#permissions). + // IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` // ForceSendFields is a list of field names (e.g. "Permissions") to @@ -2677,8 +2672,7 @@ type GoogleProtobuf__Empty struct { // that is suitable for different // programming environments, including REST APIs and RPC APIs. It is // used by -// [gRPC](https://github.com/grpc). The error model is designed to -// be: +// gRPC (https://github.com/grpc). The error model is designed to be: // // - Simple to use and understand for most users // - Flexible enough to meet unexpected needs @@ -3013,8 +3007,7 @@ type ProjectsPredictCall struct { // POST // method.

For details of the request and response format, see the // **guide -// to the [predict request -// format](/ml-engine/docs/v1/predict-request)**. +// to the predict request format (/ml-engine/docs/v1/predict-request)**. func (r *ProjectsService) Predict(name string, googlecloudmlv1__predictrequest *GoogleCloudMlV1__PredictRequest) *ProjectsPredictCall { c := &ProjectsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4781,10 +4774,9 @@ type ProjectsModelsCreateCall struct { // // You must add at least one version before you can request predictions // from -// the model. Add versions by -// calling -// [projects.models.versions.create](/ml-engine/reference/rest/v1 -// /projects.models.versions/create). +// the model. Add versions by calling +// projects.models.versions.create +// (/ml-engine/reference/rest/v1/projects.models.versions/create). func (r *ProjectsModelsService) Create(parent string, googlecloudmlv1__model *GoogleCloudMlV1__Model) *ProjectsModelsCreateCall { c := &ProjectsModelsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -4927,10 +4919,9 @@ type ProjectsModelsDeleteCall struct { // // You can only delete a model if there are no versions in it. You can // delete -// versions by -// calling -// [projects.models.versions.delete](/ml-engine/reference/rest/v1 -// /projects.models.versions/delete). +// versions by calling +// projects.models.versions.delete +// (/ml-engine/reference/rest/v1/projects.models.versions/delete). func (r *ProjectsModelsService) Delete(name string) *ProjectsModelsDeleteCall { c := &ProjectsModelsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6057,8 +6048,8 @@ type ProjectsModelsVersionsCreateCall struct { // want a // new version to be the default, you must // call -// [projects.models.versions.setDefault](/ml-engine/reference/rest/v -// 1/projects.models.versions/setDefault). +// projects.models.versions.setDefault +// (/ml-engine/reference/rest/v1/projects.models.versions/setDefault). func (r *ProjectsModelsVersionsService) Create(parent string, googlecloudmlv1__version *GoogleCloudMlV1__Version) *ProjectsModelsVersionsCreateCall { c := &ProjectsModelsVersionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6340,8 +6331,8 @@ type ProjectsModelsVersionsGetCall struct { // // Models can have multiple versions. You can // call -// [projects.models.versions.list](/ml-engine/reference/rest/v1/proj -// ects.models.versions/list) +// projects.models.versions.list +// (/ml-engine/reference/rest/v1/projects.models.versions/list) // to get the same information that this method returns for all of // the // versions of a model. diff --git a/google-api-go-generator/testdata/resource-named-service.want b/google-api-go-generator/testdata/resource-named-service.want index 9fd5d31dfe4..292f02501ea 100644 --- a/google-api-go-generator/testdata/resource-named-service.want +++ b/google-api-go-generator/testdata/resource-named-service.want @@ -204,8 +204,8 @@ type AppsServicesVersionsInstancesService struct { s *APIService } -// ApiConfigHandler: [Google Cloud -// Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) +// ApiConfigHandler: Google Cloud Endpoints +// (https://cloud.google.com/appengine/docs/python/endpoints/) // configuration for API handlers. type ApiConfigHandler struct { // AuthFailAction: Action to take when users access resources that @@ -373,10 +373,10 @@ func (s *Application) MarshalJSON() ([]byte, error) { // AutomaticScaling: Automatic scaling is based on request rate, // response latencies, and other application metrics. type AutomaticScaling struct { - // CoolDownPeriod: Amount of time that the - // [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) - // should wait between changes to the number of virtual machines. Only - // applicable for VM runtimes. + // CoolDownPeriod: Amount of time that the Autoscaler + // (https://cloud.google.com/compute/docs/autoscaler/) should wait + // between changes to the number of virtual machines. Only applicable + // for VM runtimes. CoolDownPeriod string `json:"coolDownPeriod,omitempty"` // CpuUtilization: Target scaling by CPU usage. @@ -1189,9 +1189,9 @@ func (s *LocationMetadata) MarshalJSON() ([]byte, error) { // of its memory over time. type ManualScaling struct { // Instances: Number of instances to assign to the service at the start. - // This number can later be altered by using the [Modules - // API](https://cloud.google.com/appengine/docs/python/modules/functions) - // `set_num_instances()` function. + // This number can later be altered by using the Modules API + // (https://cloud.google.com/appengine/docs/python/modules/functions) + // `set_num_instances()` function. Instances int64 `json:"instances,omitempty"` // ForceSendFields is a list of field names (e.g. "Instances") to @@ -1719,9 +1719,9 @@ func (s *StaticFilesHandler) MarshalJSON() ([]byte, error) { // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs -// and RPC APIs. It is used by [gRPC](https://github.com/grpc). The -// error model is designed to be: - Simple to use and understand for -// most users - Flexible enough to meet unexpected needs # Overview The +// and RPC APIs. It is used by gRPC (https://github.com/grpc). The error +// model is designed to be: - Simple to use and understand for most +// users - Flexible enough to meet unexpected needs # Overview The // `Status` message contains three pieces of data: error code, error // message, and error details. The error code should be an enum value of // google.rpc.Code, but it may accept additional error codes if needed. @@ -1966,9 +1966,9 @@ func (s *UrlMap) MarshalJSON() ([]byte, error) { // Version: A Version resource is a specific set of source code and // configuration files that are deployed into a service. type Version struct { - // ApiConfig: Serving configuration for [Google Cloud - // Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). - // Only returned in `GET` requests if `view=FULL` is set. + // ApiConfig: Serving configuration for Google Cloud Endpoints + // (https://cloud.google.com/appengine/docs/python/endpoints/). Only + // returned in `GET` requests if `view=FULL` is set. ApiConfig *ApiConfigHandler `json:"apiConfig,omitempty"` // AutomaticScaling: Automatic scaling is based on request rate, @@ -1994,10 +1994,9 @@ type Version struct { // DefaultExpiration: Duration that static files should be cached by web // proxies and browsers. Only applicable if the corresponding - // [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api - // /reference/rest/v1/apps.services.versions#staticfileshandler) does - // not specify its own expiration time. Only returned in `GET` requests - // if `view=FULL` is set. + // StaticFilesHandler + // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is + // set. DefaultExpiration string `json:"defaultExpiration,omitempty"` // Deployment: Code and application artifacts that make up this version. @@ -3679,17 +3678,9 @@ func (r *AppsServicesService) Patch(appsId string, servicesId string, service *S // `true` to gradually shift traffic from one version to another single // version. By default, traffic is shifted immediately. For gradual // traffic migration, the target version must be located within -// instances that are configured for both [warmup -// requests](https://cloud.google.com/appengine/docs/admin-api/reference/ -// rest/v1/apps.services.versions#inboundservicetype) and [automatic -// scaling](https://cloud.google.com/appengine/docs/admin-api/reference/r -// est/v1/apps.services.versions#automaticscaling). You must specify the -// [`shardBy`](https://cloud.google.com/appengine/docs/admin-api/referenc -// e/rest/v1/apps.services#shardby) field in the Service resource. -// Gradual traffic migration is not supported in the App Engine flexible -// environment. For examples, see [Migrating and Splitting -// Traffic](https://cloud.google.com/appengine/docs/admin-api/migrating-s -// plitting-traffic). +// instances that are configured for both warmup requests +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#automaticscaling). You must specify the `shardBy` (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services#shardby) field in the Service resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see Migrating and Splitting Traffic +// (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic). func (c *AppsServicesPatchCall) MigrateTraffic(migrateTraffic bool) *AppsServicesPatchCall { c.urlParams_.Set("migrateTraffic", fmt.Sprint(migrateTraffic)) return c @@ -4552,23 +4543,9 @@ type AppsServicesVersionsPatchCall struct { // Patch: Updates the specified Version resource. You can specify the // following fields depending on the App Engine environment and type of -// scaling that the version resource uses: * -// [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/r -// eference/rest/v1/apps.services.versions#Version.FIELDS.serving_status) -// : For Version resources that use basic scaling, manual scaling, or -// run in the App Engine flexible environment. * -// [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/r -// eference/rest/v1/apps.services.versions#Version.FIELDS.instance_class) -// : For Version resources that run in the App Engine standard -// environment. * -// [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appe -// ngine/docs/admin-api/reference/rest/v1/apps.services.versions#Version. -// FIELDS.automatic_scaling): For Version resources that use automatic -// scaling and run in the App Engine standard environment. * -// [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appe -// ngine/docs/admin-api/reference/rest/v1/apps.services.versions#Version. -// FIELDS.automatic_scaling): For Version resources that use automatic -// scaling and run in the App Engine standard environment. +// scaling that the version resource uses: * `serving_status` +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * `instance_class` (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * `automatic_scaling.min_idle_instances` (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * `automatic_scaling.max_idle_instances` (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard +// environment. func (r *AppsServicesVersionsService) Patch(appsId string, servicesId string, versionsId string, version *Version) *AppsServicesVersionsPatchCall { c := &AppsServicesVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId diff --git a/healthcare/v1/healthcare-gen.go b/healthcare/v1/healthcare-gen.go index 78463b8a940..cc0e4883986 100644 --- a/healthcare/v1/healthcare-gen.go +++ b/healthcare/v1/healthcare-gen.go @@ -1199,15 +1199,14 @@ type FhirStore struct { // EnableUpdateCreate: Whether this FHIR store has the updateCreate // capability - // (https://www.hl7.org/fhir/capabilitystatement-definitions.html#Capabil - // ityStatement.rest.resource.updateCreate). This determines if the - // client can use an Update operation to create a new resource with a - // client-specified ID. If false, all IDs are server-assigned through - // the Create operation and attempts to update a non-existent resource - // return errors. Be careful with the audit logs if client-specified - // resource IDs contain sensitive data such as patient identifiers, - // those IDs are part of the FHIR resource path recorded in Cloud audit - // logs and Cloud Pub/Sub notifications. + // (https://www.hl7.org/fhir/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.updateCreate). + // This determines if the client can use an Update operation to create a + // new resource with a client-specified ID. If false, all IDs are + // server-assigned through the Create operation and attempts to update a + // non-existent resource return errors. Be careful with the audit logs + // if client-specified resource IDs contain sensitive data such as + // patient identifiers, those IDs are part of the FHIR resource path + // recorded in Cloud audit logs and Cloud Pub/Sub notifications. EnableUpdateCreate bool `json:"enableUpdateCreate,omitempty"` // Labels: User-supplied key-value pairs used to organize FHIR stores. @@ -1239,11 +1238,11 @@ type FhirStore struct { // is removed from the list, the server stops streaming to that // location. Before adding a new config, you must add the required // `bigquery.dataEditor` - // (https://cloud.google.com/bigquery/docs/access-control#bigquery.dataEd - // itor) role to your project's **Cloud Healthcare Service Agent** - // service account (https://cloud.google.com/iam/docs/service-accounts). - // Some lag (typically on the order of dozens of seconds) is expected - // before the results show up in the streaming destination. + // (https://cloud.google.com/bigquery/docs/access-control#bigquery.dataEditor) + // role to your project's **Cloud Healthcare Service Agent** service + // account (https://cloud.google.com/iam/docs/service-accounts). Some + // lag (typically on the order of dozens of seconds) is expected before + // the results show up in the streaming destination. StreamConfigs []*StreamConfig `json:"streamConfigs,omitempty"` // Version: Immutable. The FHIR specification version that this FHIR @@ -1604,8 +1603,23 @@ func (s *GoogleCloudHealthcareV1FhirGcsSource) MarshalJSON() ([]byte, error) { type Hl7V2NotificationConfig struct { // Filter: Restricts notifications sent for messages matching a filter. // If this is empty, all messages are matched. Syntax: - // https://cloud.google.com/appengine/docs/standard/python/search/query_strings The following fields and functions are available for filtering: * `message_type`, from the MSH-9.1 field. For example, `NOT message_type = "ADT". * `send_date` or `sendDate`, the YYYY-MM-DD date the message was sent in the dataset's time_zone, from the MSH-7 segment. For example, `send_date < "2017-01-02". * `send_time`, the timestamp when the message was sent, using the RFC3339 time format for comparisons, from the MSH-7 segment. For example, `send_time < "2017-01-02T00:00:00-05:00". * `send_facility`, the care center that the message came from, from the MSH-4 segment. For example, `send_facility = "ABC". * `PatientId(value, type)`, which matches if the message lists a patient having an ID of the given value and type in the PID-2, PID-3, or PID-4 segments. For example, `PatientId("123456", "MRN")`. * `labels.x`, a string value of the label with key `x` as set using the Message.labels map. For example, `labels."priority"="high". The operator `:*` can be used to assert the existence of a label. For example, - // `labels."priority":*`. + // https://cloud.google.com/appengine/docs/standard/python/search/query_strings + // The following fields and functions are available for filtering: * + // `message_type`, from the MSH-9.1 field. For example, `NOT + // message_type = "ADT". * `send_date` or `sendDate`, the YYYY-MM-DD + // date the message was sent in the dataset's time_zone, from the MSH-7 + // segment. For example, `send_date < "2017-01-02". * `send_time`, the + // timestamp when the message was sent, using the RFC3339 time format + // for comparisons, from the MSH-7 segment. For example, `send_time < + // "2017-01-02T00:00:00-05:00". * `send_facility`, the care center that + // the message came from, from the MSH-4 segment. For example, + // `send_facility = "ABC". * `PatientId(value, type)`, which matches if + // the message lists a patient having an ID of the given value and type + // in the PID-2, PID-3, or PID-4 segments. For example, + // `PatientId("123456", "MRN")`. * `labels.x`, a string value of the + // label with key `x` as set using the Message.labels map. For example, + // `labels."priority"="high". The operator `:*` can be used to assert + // the existence of a label. For example, `labels."priority":*`. Filter string `json:"filter,omitempty"` // PubsubTopic: The Cloud Pub/Sub @@ -3108,7 +3122,8 @@ func (s *StreamConfig) MarshalJSON() ([]byte, error) { type TagFilterList struct { // Tags: Tags to be filtered. Tags must be DICOM Data Elements, File // Meta Elements, or Directory Structuring Elements, as defined at: - // http://dicom.nema.org/medical/dicom/current/output/html/part06.html#table_6-1,. They may be provided by "Keyword" or "Tag". For example "PatientID", + // http://dicom.nema.org/medical/dicom/current/output/html/part06.html#table_6-1,. + // They may be provided by "Keyword" or "Tag". For example "PatientID", // "00100010". Tags []string `json:"tags,omitempty"` @@ -6003,7 +6018,8 @@ func (r *ProjectsLocationsDatasetsDicomStoresService) List(parent string) *Proje // Filter sets the optional parameter "filter": Restricts stores // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings Only filtering on labels is supported. For example, +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// Only filtering on labels is supported. For example, // `labels.key=value`. func (c *ProjectsLocationsDatasetsDicomStoresListCall) Filter(filter string) *ProjectsLocationsDatasetsDicomStoresListCall { c.urlParams_.Set("filter", filter) @@ -6357,15 +6373,14 @@ type ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall struct { // SearchForInstances: SearchForInstances returns a list of matching // instances. See [Search Transaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.6). For details on the implementation of SearchForInstances, -// see Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6). +// For details on the implementation of SearchForInstances, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForInstances, see Searching for studies, // series, instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6489,15 +6504,14 @@ type ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall struct { // SearchForSeries: SearchForSeries returns a list of matching series. // See [Search Transaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.6). For details on the implementation of SearchForSeries, see -// Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6). +// For details on the implementation of SearchForSeries, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForSeries, see Searching for studies, series, // instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6621,15 +6635,14 @@ type ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall struct { // SearchForStudies: SearchForStudies returns a list of matching // studies. See [Search Transaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.6). For details on the implementation of SearchForStudies, see -// Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6). +// For details on the implementation of SearchForStudies, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForStudies, see Searching for studies, series, // instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForStudies(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6895,14 +6908,13 @@ type ProjectsLocationsDatasetsDicomStoresStoreInstancesCall struct { // StoreInstances: StoreInstances stores DICOM instances associated with // study instance unique identifiers (SUID). See [Store Transaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.5). For details on the implementation of StoreInstances, see -// Store transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.5). +// For details on the implementation of StoreInstances, see Store +// transaction // (https://cloud.google.com/healthcare/docs/dicom#store_transaction) in // the Cloud Healthcare API conformance statement. For samples that show // how to call StoreInstances, see Storing DICOM data -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dic -// om_data). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7166,8 +7178,7 @@ type ProjectsLocationsDatasetsDicomStoresStudiesDeleteCall struct { // study could result in the new instances not appearing in search // results until the deletion operation finishes. For samples that show // how to call DeleteStudy, see Deleting a study, series, or instance -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_ -// study_series_or_instance). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_study_series_or_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7311,14 +7322,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall struct { // RetrieveMetadata: RetrieveStudyMetadata returns instance associated // with the given study presented as metadata with the bulk data // removed. See [RetrieveTransaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of -// RetrieveStudyMetadata, see Metadata resources +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveStudyMetadata, see +// Metadata resources // (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) // in the Cloud Healthcare API conformance statement. For samples that // show how to call RetrieveStudyMetadata, see Retrieving metadata -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// metadata). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7442,14 +7452,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall struct { // RetrieveStudy: RetrieveStudy returns all instances within the given // study. See [RetrieveTransaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of RetrieveStudy, see -// DICOM study/series/instances -// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta -// nces) in the Cloud Healthcare API conformance statement. For samples -// that show how to call RetrieveStudy, see Retrieving DICOM data -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// dicom_data). +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveStudy, see DICOM +// study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinstances) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveStudy, see Retrieving DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveStudy(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7573,15 +7582,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall struct { // SearchForInstances: SearchForInstances returns a list of matching // instances. See [Search Transaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.6). For details on the implementation of SearchForInstances, -// see Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6). +// For details on the implementation of SearchForInstances, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForInstances, see Searching for studies, // series, instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7705,15 +7713,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall struct { // SearchForSeries: SearchForSeries returns a list of matching series. // See [Search Transaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.6). For details on the implementation of SearchForSeries, see -// Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6). +// For details on the implementation of SearchForSeries, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForSeries, see Searching for studies, series, // instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7837,14 +7844,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall struct { // StoreInstances: StoreInstances stores DICOM instances associated with // study instance unique identifiers (SUID). See [Store Transaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.5). For details on the implementation of StoreInstances, see -// Store transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.5). +// For details on the implementation of StoreInstances, see Store +// transaction // (https://cloud.google.com/healthcare/docs/dicom#store_transaction) in // the Cloud Healthcare API conformance statement. For samples that show // how to call StoreInstances, see Storing DICOM data -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dic -// om_data). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7964,8 +7970,7 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesDeleteCall struct { // search results until the deletion operation finishes. For samples // that show how to call DeleteSeries, see Deleting a study, series, or // instance -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_ -// study_series_or_instance). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_study_series_or_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8110,14 +8115,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall struc // RetrieveMetadata: RetrieveSeriesMetadata returns instance associated // with the given study and series, presented as metadata with the bulk // data removed. See [RetrieveTransaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of -// RetrieveSeriesMetadata, see Metadata resources +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveSeriesMetadata, see +// Metadata resources // (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) // in the Cloud Healthcare API conformance statement. For samples that // show how to call RetrieveSeriesMetadata, see Retrieving metadata -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// metadata). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8241,14 +8245,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall struct // RetrieveSeries: RetrieveSeries returns all instances within the given // study and series. See [RetrieveTransaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of RetrieveSeries, see -// DICOM study/series/instances -// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta -// nces) in the Cloud Healthcare API conformance statement. For samples -// that show how to call RetrieveSeries, see Retrieving DICOM data -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// dicom_data). +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveSeries, see DICOM +// study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinstances) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveSeries, see Retrieving DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8372,15 +8375,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall str // SearchForInstances: SearchForInstances returns a list of matching // instances. See [Search Transaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.6). For details on the implementation of SearchForInstances, -// see Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6). +// For details on the implementation of SearchForInstances, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForInstances, see Searching for studies, // series, instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8507,8 +8509,7 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall struct // series search results can take a few seconds to be updated after an // instance is deleted using DeleteInstance. For samples that show how // to call DeleteInstance, see Deleting a study, series, or instance -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_ -// study_series_or_instance). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_study_series_or_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8653,16 +8654,15 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceC // RetrieveInstance: RetrieveInstance returns instance associated with // the given study, series, and SOP Instance UID. See // [RetrieveTransaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of RetrieveInstance, see -// DICOM study/series/instances -// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta -// nces) and DICOM instances +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveInstance, see DICOM +// study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinstances) +// and DICOM instances // (https://cloud.google.com/healthcare/docs/dicom#dicom_instances) in // the Cloud Healthcare API conformance statement. For samples that show // how to call RetrieveInstance, see Retrieving an instance -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// an_instance). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_an_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveInstance(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8788,14 +8788,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataC // associated with the given study, series, and SOP Instance UID // presented as metadata with the bulk data removed. See // [RetrieveTransaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of -// RetrieveInstanceMetadata, see Metadata resources +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveInstanceMetadata, see +// Metadata resources // (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) // in the Cloud Healthcare API conformance statement. For samples that // show how to call RetrieveInstanceMetadata, see Retrieving metadata -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// metadata). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8920,15 +8919,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedC // RetrieveRendered: RetrieveRenderedInstance returns instance // associated with the given study, series, and SOP Instance UID in an // acceptable Rendered Media Type. See [RetrieveTransaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of -// RetrieveRenderedInstance, see Rendered resources +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveRenderedInstance, see +// Rendered resources // (https://cloud.google.com/healthcare/docs/dicom#rendered_resources) // in the Cloud Healthcare API conformance statement. For samples that // show how to call RetrieveRenderedInstance, see Retrieving consumer // image formats -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// consumer_image_formats). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_consumer_image_formats). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9053,14 +9051,12 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFra // RetrieveFrames: RetrieveFrames returns instances associated with the // given study, series, SOP Instance UID and frame numbers. See // [RetrieveTransaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4}. For details on the implementation of RetrieveFrames, see -// DICOM frames +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4}. +// For details on the implementation of RetrieveFrames, see DICOM frames // (https://cloud.google.com/healthcare/docs/dicom#dicom_frames) in the // Cloud Healthcare API conformance statement. For samples that show how // to call RetrieveFrames, see Retrieving DICOM data -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// dicom_data). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveFrames(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9185,15 +9181,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRen // RetrieveRendered: RetrieveRenderedFrames returns instances associated // with the given study, series, SOP Instance UID and frame numbers in // an acceptable Rendered Media Type. See [RetrieveTransaction] -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of -// RetrieveRenderedFrames, see Rendered resources +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveRenderedFrames, see +// Rendered resources // (https://cloud.google.com/healthcare/docs/dicom#rendered_resources) // in the Cloud Healthcare API conformance statement. For samples that // show how to call RetrieveRenderedFrames, see Retrieving consumer // image formats -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// consumer_image_formats). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_consumer_image_formats). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -10403,7 +10398,8 @@ func (r *ProjectsLocationsDatasetsFhirStoresService) List(parent string) *Projec // Filter sets the optional parameter "filter": Restricts stores // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings Only filtering on labels is supported, for example +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// Only filtering on labels is supported, for example // `labels.key=value`. func (c *ProjectsLocationsDatasetsFhirStoresListCall) Filter(filter string) *ProjectsLocationsDatasetsFhirStoresListCall { c.urlParams_.Set("filter", filter) @@ -11044,12 +11040,12 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall struct { // PatientEverything: Retrieves a Patient resource and resources related // to that patient. Implements the FHIR extended operation // Patient-everything (DSTU2 -// (http://hl7.org/implement/standards/fhir/DSTU2/patient-operations.html -// #everything), STU3 -// (http://hl7.org/implement/standards/fhir/STU3/patient-operations.html# -// everything), R4 -// (http://hl7.org/implement/standards/fhir/R4/patient-operations.html#ev -// erything)). On success, the response body will contain a JSON-encoded +// (http://hl7.org/implement/standards/fhir/DSTU2/patient-operations.html#everything), +// STU3 +// (http://hl7.org/implement/standards/fhir/STU3/patient-operations.html#everything), +// R4 +// (http://hl7.org/implement/standards/fhir/R4/patient-operations.html#everything)). +// On success, the response body will contain a JSON-encoded // representation of a `Bundle` resource of type `searchset`, containing // the results of the operation. Errors generated by the FHIR store will // contain a JSON-encoded `OperationOutcome` resource describing the @@ -11400,16 +11396,16 @@ type ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall struct { } // Capabilities: Gets the FHIR capability statement (STU3 -// (http://hl7.org/implement/standards/fhir/STU3/capabilitystatement.html -// ), R4 -// (http://hl7.org/implement/standards/fhir/R4/capabilitystatement.html)) -// , or the conformance statement +// (http://hl7.org/implement/standards/fhir/STU3/capabilitystatement.html), +// R4 +// (http://hl7.org/implement/standards/fhir/R4/capabilitystatement.html)), +// or the conformance statement // (http://hl7.org/implement/standards/fhir/DSTU2/conformance.html) in // the DSTU2 case for the store, which contains a description of // functionality supported by the server. Implements the FHIR standard // capabilities interaction (STU3 // (http://hl7.org/implement/standards/fhir/STU3/http.html#capabilities), -// R4 +// R4 // (http://hl7.org/implement/standards/fhir/R4/http.html#capabilities)), // or the conformance interaction // (http://hl7.org/implement/standards/fhir/DSTU2/http.html#conformance) @@ -11764,7 +11760,7 @@ type ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall struct { // ExecuteBundle: Executes all the requests in the given Bundle. // Implements the FHIR standard batch/transaction interaction (DSTU2 // (http://hl7.org/implement/standards/fhir/DSTU2/http.html#transaction), -// STU3 +// STU3 // (http://hl7.org/implement/standards/fhir/STU3/http.html#transaction), // R4 // (http://hl7.org/implement/standards/fhir/R4/http.html#transaction)). @@ -12355,12 +12351,12 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // indicates what search parameters are supported on each FHIR resource. // A list of all search parameters defined by the specification can be // found in the FHIR Search Parameter Registry (STU3 -// (http://hl7.org/implement/standards/fhir/STU3/searchparameter-registry -// .html), R4 -// (http://hl7.org/implement/standards/fhir/R4/searchparameter-registry.h -// tml)). FHIR search parameters for DSTU2 can be found on each -// resource's definition page. Supported search modifiers: `:missing`, -// `:exact`, `:contains`, `:text`, `:in`, `:not-in`, `:above`, `:below`, +// (http://hl7.org/implement/standards/fhir/STU3/searchparameter-registry.html), +// R4 +// (http://hl7.org/implement/standards/fhir/R4/searchparameter-registry.html)). +// FHIR search parameters for DSTU2 can be found on each resource's +// definition page. Supported search modifiers: `:missing`, `:exact`, +// `:contains`, `:text`, `:in`, `:not-in`, `:above`, `:below`, // `:[type]`, `:not`, and `:recurse`. Supported search result // parameters: `_sort`, `_count`, `_include`, `_revinclude`, // `_summary=text`, `_summary=data`, and `_elements`. The maximum number @@ -13329,7 +13325,8 @@ func (r *ProjectsLocationsDatasetsHl7V2StoresService) List(parent string) *Proje // Filter sets the optional parameter "filter": Restricts stores // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings Only filtering on labels is supported. For example, +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// Only filtering on labels is supported. For example, // `labels.key=value`. func (c *ProjectsLocationsDatasetsHl7V2StoresListCall) Filter(filter string) *ProjectsLocationsDatasetsHl7V2StoresListCall { c.urlParams_.Set("filter", filter) @@ -14583,8 +14580,23 @@ func (r *ProjectsLocationsDatasetsHl7V2StoresMessagesService) List(parent string // Filter sets the optional parameter "filter": Restricts messages // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings Fields/functions available for filtering are: * `message_type`, from the MSH-9.1 field. For example, `NOT message_type = "ADT". * `send_date` or `sendDate`, the YYYY-MM-DD date the message was sent in the dataset's time_zone, from the MSH-7 segment. For example, `send_date < "2017-01-02". * `send_time`, the timestamp when the message was sent, using the RFC3339 time format for comparisons, from the MSH-7 segment. For example, `send_time < "2017-01-02T00:00:00-05:00". * `send_facility`, the care center that the message came from, from the MSH-4 segment. For example, `send_facility = "ABC". * `PatientId(value, type)`, which matches if the message lists a patient having an ID of the given value and type in the PID-2, PID-3, or PID-4 segments. For example, `PatientId("123456", "MRN")`. * `labels.x`, a string value of the label with key `x` as set using the Message.labels map. For example, `labels."priority"="high". The operator `:*` can be used to assert the existence of a label. For example, -// `labels."priority":*`. +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// Fields/functions available for filtering are: * `message_type`, from +// the MSH-9.1 field. For example, `NOT message_type = "ADT". * +// `send_date` or `sendDate`, the YYYY-MM-DD date the message was sent +// in the dataset's time_zone, from the MSH-7 segment. For example, +// `send_date < "2017-01-02". * `send_time`, the timestamp when the +// message was sent, using the RFC3339 time format for comparisons, from +// the MSH-7 segment. For example, `send_time < +// "2017-01-02T00:00:00-05:00". * `send_facility`, the care center that +// the message came from, from the MSH-4 segment. For example, +// `send_facility = "ABC". * `PatientId(value, type)`, which matches if +// the message lists a patient having an ID of the given value and type +// in the PID-2, PID-3, or PID-4 segments. For example, +// `PatientId("123456", "MRN")`. * `labels.x`, a string value of the +// label with key `x` as set using the Message.labels map. For example, +// `labels."priority"="high". The operator `:*` can be used to assert +// the existence of a label. For example, `labels."priority":*`. func (c *ProjectsLocationsDatasetsHl7V2StoresMessagesListCall) Filter(filter string) *ProjectsLocationsDatasetsHl7V2StoresMessagesListCall { c.urlParams_.Set("filter", filter) return c diff --git a/healthcare/v1beta1/healthcare-gen.go b/healthcare/v1beta1/healthcare-gen.go index acdaa09fcd6..4019148fed4 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -2394,16 +2394,22 @@ type ExportDicomDataResponse struct { // ExportMessagesRequest: Request to schedule an export. type ExportMessagesRequest struct { // EndTime: The end of the range in `send_time` (MSH.7, - // https://www.hl7.org/documentcenter/public_temp_2E58C1F9-1C23-BA17-0C6126475344DA9D/wg/conf/HL7MSH.htm) to process. If not specified, the time when the export is scheduled is used. This value has to come after the `start_time` defined below. Only messages whose `send_time` lies in the range `start_time` (inclusive) to `end_time` (exclusive) are - // exported. + // https://www.hl7.org/documentcenter/public_temp_2E58C1F9-1C23-BA17-0C6126475344DA9D/wg/conf/HL7MSH.htm) + // to process. If not specified, the time when the export is scheduled + // is used. This value has to come after the `start_time` defined below. + // Only messages whose `send_time` lies in the range `start_time` + // (inclusive) to `end_time` (exclusive) are exported. EndTime string `json:"endTime,omitempty"` // GcsDestination: Export to a Cloud Storage destination. GcsDestination *GcsDestination `json:"gcsDestination,omitempty"` // StartTime: The start of the range in `send_time` (MSH.7, - // https://www.hl7.org/documentcenter/public_temp_2E58C1F9-1C23-BA17-0C6126475344DA9D/wg/conf/HL7MSH.htm) to process. If not specified, the UNIX epoch (1970-01-01T00:00:00Z) is used. This value has to come before the `end_time` defined below. Only messages whose `send_time` lies in the range `start_time` (inclusive) to `end_time` (exclusive) are - // exported. + // https://www.hl7.org/documentcenter/public_temp_2E58C1F9-1C23-BA17-0C6126475344DA9D/wg/conf/HL7MSH.htm) + // to process. If not specified, the UNIX epoch (1970-01-01T00:00:00Z) + // is used. This value has to come before the `end_time` defined below. + // Only messages whose `send_time` lies in the range `start_time` + // (inclusive) to `end_time` (exclusive) are exported. StartTime string `json:"startTime,omitempty"` // ForceSendFields is a list of field names (e.g. "EndTime") to @@ -2682,15 +2688,14 @@ type FhirStore struct { // EnableUpdateCreate: Whether this FHIR store has the updateCreate // capability - // (https://www.hl7.org/fhir/capabilitystatement-definitions.html#Capabil - // ityStatement.rest.resource.updateCreate). This determines if the - // client can use an Update operation to create a new resource with a - // client-specified ID. If false, all IDs are server-assigned through - // the Create operation and attempts to update a non-existent resource - // return errors. Be careful with the audit logs if client-specified - // resource IDs contain sensitive data such as patient identifiers, - // those IDs are part of the FHIR resource path recorded in Cloud audit - // logs and Cloud Pub/Sub notifications. + // (https://www.hl7.org/fhir/capabilitystatement-definitions.html#CapabilityStatement.rest.resource.updateCreate). + // This determines if the client can use an Update operation to create a + // new resource with a client-specified ID. If false, all IDs are + // server-assigned through the Create operation and attempts to update a + // non-existent resource return errors. Be careful with the audit logs + // if client-specified resource IDs contain sensitive data such as + // patient identifiers, those IDs are part of the FHIR resource path + // recorded in Cloud audit logs and Cloud Pub/Sub notifications. EnableUpdateCreate bool `json:"enableUpdateCreate,omitempty"` // Labels: User-supplied key-value pairs used to organize FHIR stores. @@ -2722,11 +2727,11 @@ type FhirStore struct { // is removed from the list, the server stops streaming to that // location. Before adding a new config, you must add the required // `bigquery.dataEditor` - // (https://cloud.google.com/bigquery/docs/access-control#bigquery.dataEd - // itor) role to your project's **Cloud Healthcare Service Agent** - // service account (https://cloud.google.com/iam/docs/service-accounts). - // Some lag (typically on the order of dozens of seconds) is expected - // before the results show up in the streaming destination. + // (https://cloud.google.com/bigquery/docs/access-control#bigquery.dataEditor) + // role to your project's **Cloud Healthcare Service Agent** service + // account (https://cloud.google.com/iam/docs/service-accounts). Some + // lag (typically on the order of dozens of seconds) is expected before + // the results show up in the streaming destination. StreamConfigs []*StreamConfig `json:"streamConfigs,omitempty"` // Version: Immutable. The FHIR specification version that this FHIR @@ -3870,8 +3875,23 @@ func (s *Hl7TypesConfig) MarshalJSON() ([]byte, error) { type Hl7V2NotificationConfig struct { // Filter: Restricts notifications sent for messages matching a filter. // If this is empty, all messages are matched. Syntax: - // https://cloud.google.com/appengine/docs/standard/python/search/query_strings The following fields and functions are available for filtering: * `message_type`, from the MSH-9.1 field. For example, `NOT message_type = "ADT". * `send_date` or `sendDate`, the YYYY-MM-DD date the message was sent in the dataset's time_zone, from the MSH-7 segment. For example, `send_date < "2017-01-02". * `send_time`, the timestamp when the message was sent, using the RFC3339 time format for comparisons, from the MSH-7 segment. For example, `send_time < "2017-01-02T00:00:00-05:00". * `send_facility`, the care center that the message came from, from the MSH-4 segment. For example, `send_facility = "ABC". * `PatientId(value, type)`, which matches if the message lists a patient having an ID of the given value and type in the PID-2, PID-3, or PID-4 segments. For example, `PatientId("123456", "MRN")`. * `labels.x`, a string value of the label with key `x` as set using the Message.labels map. For example, `labels."priority"="high". The operator `:*` can be used to assert the existence of a label. For example, - // `labels."priority":*`. + // https://cloud.google.com/appengine/docs/standard/python/search/query_strings + // The following fields and functions are available for filtering: * + // `message_type`, from the MSH-9.1 field. For example, `NOT + // message_type = "ADT". * `send_date` or `sendDate`, the YYYY-MM-DD + // date the message was sent in the dataset's time_zone, from the MSH-7 + // segment. For example, `send_date < "2017-01-02". * `send_time`, the + // timestamp when the message was sent, using the RFC3339 time format + // for comparisons, from the MSH-7 segment. For example, `send_time < + // "2017-01-02T00:00:00-05:00". * `send_facility`, the care center that + // the message came from, from the MSH-4 segment. For example, + // `send_facility = "ABC". * `PatientId(value, type)`, which matches if + // the message lists a patient having an ID of the given value and type + // in the PID-2, PID-3, or PID-4 segments. For example, + // `PatientId("123456", "MRN")`. * `labels.x`, a string value of the + // label with key `x` as set using the Message.labels map. For example, + // `labels."priority"="high". The operator `:*` can be used to assert + // the existence of a label. For example, `labels."priority":*`. Filter string `json:"filter,omitempty"` // PubsubTopic: The Cloud Pub/Sub @@ -6379,7 +6399,8 @@ func (s *StreamConfig) MarshalJSON() ([]byte, error) { type TagFilterList struct { // Tags: Tags to be filtered. Tags must be DICOM Data Elements, File // Meta Elements, or Directory Structuring Elements, as defined at: - // http://dicom.nema.org/medical/dicom/current/output/html/part06.html#table_6-1,. They may be provided by "Keyword" or "Tag". For example, "PatientID", + // http://dicom.nema.org/medical/dicom/current/output/html/part06.html#table_6-1,. + // They may be provided by "Keyword" or "Tag". For example, "PatientID", // "00100010". Tags []string `json:"tags,omitempty"` @@ -9492,7 +9513,8 @@ func (r *ProjectsLocationsDatasetsAnnotationStoresService) List(parent string) * // Filter sets the optional parameter "filter": Restricts stores // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings Only filtering on labels is supported, for example +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// Only filtering on labels is supported, for example // `labels.key=value`. func (c *ProjectsLocationsDatasetsAnnotationStoresListCall) Filter(filter string) *ProjectsLocationsDatasetsAnnotationStoresListCall { c.urlParams_.Set("filter", filter) @@ -11853,7 +11875,8 @@ func (r *ProjectsLocationsDatasetsConsentStoresService) List(parent string) *Pro // Filter sets the optional parameter "filter": Restricts the stores // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings. Only filtering on labels is supported. For example, +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings. +// Only filtering on labels is supported. For example, // `labels.key=value`. func (c *ProjectsLocationsDatasetsConsentStoresListCall) Filter(filter string) *ProjectsLocationsDatasetsConsentStoresListCall { c.urlParams_.Set("filter", filter) @@ -12059,8 +12082,8 @@ func (r *ProjectsLocationsDatasetsConsentStoresService) Patch(name string, conse // UpdateMask sets the optional parameter "updateMask": The update mask // that applies to the resource. For the `FieldMask` definition, see -// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask. The `labels` field is allowed to be -// updated. +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask. +// The `labels` field is allowed to be updated. func (c *ProjectsLocationsDatasetsConsentStoresPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDatasetsConsentStoresPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -13097,8 +13120,8 @@ func (r *ProjectsLocationsDatasetsConsentStoresAttributeDefinitionsService) List // Filter sets the optional parameter "filter": Restricts the attributes // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings. The only field available for filtering is -// `category`. +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings. +// The only field available for filtering is `category`. func (c *ProjectsLocationsDatasetsConsentStoresAttributeDefinitionsListCall) Filter(filter string) *ProjectsLocationsDatasetsConsentStoresAttributeDefinitionsListCall { c.urlParams_.Set("filter", filter) return c @@ -13303,7 +13326,10 @@ func (r *ProjectsLocationsDatasetsConsentStoresAttributeDefinitionsService) Patc // UpdateMask sets the optional parameter "updateMask": The update mask // that applies to the resource. For the `FieldMask` definition, see -// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask. The `description`, `allowed_values`, `consent_default_values`, and `data_mapping_default_value` fields are allowed to be updated. The updated `allowed_values` must contain all values from the previous +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask. +// The `description`, `allowed_values`, `consent_default_values`, and +// `data_mapping_default_value` fields are allowed to be updated. The +// updated `allowed_values` must contain all values from the previous // `allowed_values`. func (c *ProjectsLocationsDatasetsConsentStoresAttributeDefinitionsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDatasetsConsentStoresAttributeDefinitionsPatchCall { c.urlParams_.Set("updateMask", updateMask) @@ -13872,7 +13898,8 @@ func (r *ProjectsLocationsDatasetsConsentStoresConsentArtifactsService) List(par // Filter sets the optional parameter "filter": Restricts the artifacts // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings The fields available for filtering are: - user_id - +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// The fields available for filtering are: - user_id - // consent_content_version func (c *ProjectsLocationsDatasetsConsentStoresConsentArtifactsListCall) Filter(filter string) *ProjectsLocationsDatasetsConsentStoresConsentArtifactsListCall { c.urlParams_.Set("filter", filter) @@ -14774,8 +14801,10 @@ func (r *ProjectsLocationsDatasetsConsentStoresConsentsService) List(parent stri // Filter sets the optional parameter "filter": Restricts the consents // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings The fields available for filtering are: - user_id - consent_artifact - state - revision_create_time - metadata. For example, `Metadata("key")="value" or -// `HasMetadata("key")`. +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// The fields available for filtering are: - user_id - consent_artifact +// - state - revision_create_time - metadata. For example, +// `Metadata("key")="value" or `HasMetadata("key")`. func (c *ProjectsLocationsDatasetsConsentStoresConsentsListCall) Filter(filter string) *ProjectsLocationsDatasetsConsentStoresConsentsListCall { c.urlParams_.Set("filter", filter) return c @@ -14981,8 +15010,9 @@ func (r *ProjectsLocationsDatasetsConsentStoresConsentsService) ListRevisions(na // Filter sets the optional parameter "filter": Restricts the revisions // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings. Fields/functions available for filtering are: - user_id - consent_artifact - state - -// revision_create_time +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings. +// Fields/functions available for filtering are: - user_id - +// consent_artifact - state - revision_create_time func (c *ProjectsLocationsDatasetsConsentStoresConsentsListRevisionsCall) Filter(filter string) *ProjectsLocationsDatasetsConsentStoresConsentsListRevisionsCall { c.urlParams_.Set("filter", filter) return c @@ -15191,7 +15221,8 @@ func (r *ProjectsLocationsDatasetsConsentStoresConsentsService) Patch(name strin // UpdateMask sets the optional parameter "updateMask": The update mask // to apply to the resource. For the `FieldMask` definition, see -// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask. The `user_id`, `policies`, and `consent_artifact` fields can be +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask. +// The `user_id`, `policies`, and `consent_artifact` fields can be // updated. func (c *ProjectsLocationsDatasetsConsentStoresConsentsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDatasetsConsentStoresConsentsPatchCall { c.urlParams_.Set("updateMask", updateMask) @@ -16189,8 +16220,9 @@ func (r *ProjectsLocationsDatasetsConsentStoresUserDataMappingsService) List(par // Filter sets the optional parameter "filter": Restricts the user data // mappings returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings The fields available for filtering are: - data_id - user_id - archived - -// archive_time +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// The fields available for filtering are: - data_id - user_id - +// archived - archive_time func (c *ProjectsLocationsDatasetsConsentStoresUserDataMappingsListCall) Filter(filter string) *ProjectsLocationsDatasetsConsentStoresUserDataMappingsListCall { c.urlParams_.Set("filter", filter) return c @@ -17576,7 +17608,8 @@ func (r *ProjectsLocationsDatasetsDicomStoresService) List(parent string) *Proje // Filter sets the optional parameter "filter": Restricts stores // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings Only filtering on labels is supported. For example, +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// Only filtering on labels is supported. For example, // `labels.key=value`. func (c *ProjectsLocationsDatasetsDicomStoresListCall) Filter(filter string) *ProjectsLocationsDatasetsDicomStoresListCall { c.urlParams_.Set("filter", filter) @@ -17930,15 +17963,14 @@ type ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall struct { // SearchForInstances: SearchForInstances returns a list of matching // instances. See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of SearchForInstances, -// see Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of SearchForInstances, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForInstances, see Searching for studies, // series, instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18062,15 +18094,14 @@ type ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall struct { // SearchForSeries: SearchForSeries returns a list of matching series. // See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of SearchForSeries, see -// Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of SearchForSeries, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForSeries, see Searching for studies, series, // instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18194,15 +18225,14 @@ type ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall struct { // SearchForStudies: SearchForStudies returns a list of matching // studies. See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of SearchForStudies, see -// Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of SearchForStudies, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForStudies, see Searching for studies, series, // instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresService) SearchForStudies(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall { c := &ProjectsLocationsDatasetsDicomStoresSearchForStudiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18468,14 +18498,13 @@ type ProjectsLocationsDatasetsDicomStoresStoreInstancesCall struct { // StoreInstances: StoreInstances stores DICOM instances associated with // study instance unique identifiers (SUID). See Store Transaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.5). For details on the implementation of StoreInstances, see -// Store transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.5). +// For details on the implementation of StoreInstances, see Store +// transaction // (https://cloud.google.com/healthcare/docs/dicom#store_transaction) in // the Cloud Healthcare API conformance statement. For samples that show // how to call StoreInstances, see Storing DICOM data -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dic -// om_data). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18880,14 +18909,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall struct { // RetrieveMetadata: RetrieveStudyMetadata returns instance associated // with the given study presented as metadata with the bulk data // removed. See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of -// RetrieveStudyMetadata, see Metadata resources +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveStudyMetadata, see +// Metadata resources // (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) // in the Cloud Healthcare API conformance statement. For samples that // show how to call RetrieveStudyMetadata, see Retrieving metadata -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// metadata). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19011,14 +19039,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall struct { // RetrieveStudy: RetrieveStudy returns all instances within the given // study. See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of RetrieveStudy, see -// DICOM study/series/instances -// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta -// nces) in the Cloud Healthcare API conformance statement. For samples -// that show how to call RetrieveStudy, see Retrieving DICOM data -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// dicom_data). +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveStudy, see DICOM +// study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinstances) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveStudy, see Retrieving DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveStudy(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveStudyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19142,15 +19169,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall struct { // SearchForInstances: SearchForInstances returns a list of matching // instances. See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of SearchForInstances, -// see Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of SearchForInstances, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForInstances, see Searching for studies, // series, instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19274,15 +19300,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall struct { // SearchForSeries: SearchForSeries returns a list of matching series. // See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of SearchForSeries, see -// Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of SearchForSeries, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForSeries, see Searching for studies, series, // instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) SearchForSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSearchForSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19406,14 +19431,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall struct { // StoreInstances: StoreInstances stores DICOM instances associated with // study instance unique identifiers (SUID). See Store Transaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.5). For details on the implementation of StoreInstances, see -// Store transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.5). +// For details on the implementation of StoreInstances, see Store +// transaction // (https://cloud.google.com/healthcare/docs/dicom#store_transaction) in // the Cloud Healthcare API conformance statement. For samples that show // how to call StoreInstances, see Storing DICOM data -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dic -// om_data). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#storing_dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) StoreInstances(parent string, dicomWebPath string, body_ io.Reader) *ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesStoreInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19675,14 +19699,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall struc // RetrieveMetadata: RetrieveSeriesMetadata returns instance associated // with the given study and series, presented as metadata with the bulk // data removed. See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of -// RetrieveSeriesMetadata, see Metadata resources +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveSeriesMetadata, see +// Metadata resources // (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) // in the Cloud Healthcare API conformance statement. For samples that // show how to call RetrieveSeriesMetadata, see Retrieving metadata -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// metadata). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19806,14 +19829,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall struct // RetrieveSeries: RetrieveSeries returns all instances within the given // study and series. See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of RetrieveSeries, see -// DICOM study/series/instances -// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta -// nces) in the Cloud Healthcare API conformance statement. For samples -// that show how to call RetrieveSeries, see Retrieving DICOM data -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// dicom_data). +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveSeries, see DICOM +// study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinstances) +// in the Cloud Healthcare API conformance statement. For samples that +// show how to call RetrieveSeries, see Retrieving DICOM data +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveSeries(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveSeriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19937,15 +19959,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall str // SearchForInstances: SearchForInstances returns a list of matching // instances. See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of SearchForInstances, -// see Search transaction +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of SearchForInstances, see Search +// transaction // (https://cloud.google.com/healthcare/docs/dicom#search_transaction) // in the Cloud Healthcare API conformance statement. For samples that // show how to call SearchForInstances, see Searching for studies, // series, instances, and frames -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_f -// or_studies_series_instances_and_frames). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#searching_for_studies_series_instances_and_frames). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) SearchForInstances(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesSearchForInstancesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20072,8 +20093,7 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall struct // series search results can take a few seconds to be updated after an // instance is deleted using DeleteInstance. For samples that show how // to call DeleteInstance, see Deleting a study, series, or instance -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_ -// study_series_or_instance). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#deleting_a_study_series_or_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) Delete(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20218,16 +20238,15 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceC // RetrieveInstance: RetrieveInstance returns instance associated with // the given study, series, and SOP Instance UID. See // RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of RetrieveInstance, see -// DICOM study/series/instances -// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinsta -// nces) and DICOM instances +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveInstance, see DICOM +// study/series/instances +// (https://cloud.google.com/healthcare/docs/dicom#dicom_studyseriesinstances) +// and DICOM instances // (https://cloud.google.com/healthcare/docs/dicom#dicom_instances) in // the Cloud Healthcare API conformance statement. For samples that show // how to call RetrieveInstance, see Retrieving an instance -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// an_instance). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_an_instance). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveInstance(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20353,14 +20372,13 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataC // associated with the given study, series, and SOP Instance UID // presented as metadata with the bulk data removed. See // RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of -// RetrieveInstanceMetadata, see Metadata resources +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveInstanceMetadata, see +// Metadata resources // (https://cloud.google.com/healthcare/docs/dicom#metadata_resources) // in the Cloud Healthcare API conformance statement. For samples that // show how to call RetrieveInstanceMetadata, see Retrieving metadata -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// metadata). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_metadata). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20485,15 +20503,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedC // RetrieveRendered: RetrieveRenderedInstance returns instance // associated with the given study, series, and SOP Instance UID in an // acceptable Rendered Media Type. See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of -// RetrieveRenderedInstance, see Rendered resources +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveRenderedInstance, see +// Rendered resources // (https://cloud.google.com/healthcare/docs/dicom#rendered_resources) // in the Cloud Healthcare API conformance statement. For samples that // show how to call RetrieveRenderedInstance, see Retrieving consumer // image formats -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// consumer_image_formats). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_consumer_image_formats). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20618,14 +20635,12 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFra // RetrieveFrames: RetrieveFrames returns instances associated with the // given study, series, SOP Instance UID and frame numbers. See // RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of RetrieveFrames, see -// DICOM frames +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveFrames, see DICOM frames // (https://cloud.google.com/healthcare/docs/dicom#dicom_frames) in the // Cloud Healthcare API conformance statement. For samples that show how // to call RetrieveFrames, see Retrieving DICOM data -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// dicom_data). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_dicom_data). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveFrames(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20750,15 +20765,14 @@ type ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRen // RetrieveRendered: RetrieveRenderedFrames returns instances associated // with the given study, series, SOP Instance UID and frame numbers in // an acceptable Rendered Media Type. See RetrieveTransaction -// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#s -// ect_10.4). For details on the implementation of -// RetrieveRenderedFrames, see Rendered resources +// (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4). +// For details on the implementation of RetrieveRenderedFrames, see +// Rendered resources // (https://cloud.google.com/healthcare/docs/dicom#rendered_resources) // in the Cloud Healthcare API conformance statement. For samples that // show how to call RetrieveRenderedFrames, see Retrieving consumer // image formats -// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_ -// consumer_image_formats). +// (https://cloud.google.com/healthcare/docs/how-tos/dicomweb#retrieving_consumer_image_formats). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -21970,7 +21984,8 @@ func (r *ProjectsLocationsDatasetsFhirStoresService) List(parent string) *Projec // Filter sets the optional parameter "filter": Restricts stores // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings Only filtering on labels is supported, for example +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// Only filtering on labels is supported, for example // `labels.key=value`. func (c *ProjectsLocationsDatasetsFhirStoresListCall) Filter(filter string) *ProjectsLocationsDatasetsFhirStoresListCall { c.urlParams_.Set("filter", filter) @@ -22972,19 +22987,19 @@ type ProjectsLocationsDatasetsFhirStoresFhirObservationLastnCall struct { // for a subject matching search criteria specified as query parameters, // grouped by `Observation.code`, sorted from most recent to oldest. // Implements the FHIR extended operation Observation-lastn (STU3 -// (https://hl7.org/implement/standards/fhir/STU3/observation-operations. -// html#lastn), R4 -// (https://hl7.org/implement/standards/fhir/R4/observation-operations.ht -// ml#lastn)). DSTU2 doesn't define the Observation-lastn method, but -// the server supports it the same way it supports STU3. Search terms -// are provided as query parameters following the same pattern as the -// search method. The following search parameters must be provided: - -// `subject` or `patient` to specify a subject for the Observation. - -// `code`, `category` or any of the composite parameters that include -// `code`. Any other valid Observation search parameters can also be -// provided. This operation accepts an additional query parameter `max`, -// which specifies N, the maximum number of Observations to return from -// each group, with a default of 1. Searches with over 1000 results are +// (https://hl7.org/implement/standards/fhir/STU3/observation-operations.html#lastn), +// R4 +// (https://hl7.org/implement/standards/fhir/R4/observation-operations.html#lastn)). +// DSTU2 doesn't define the Observation-lastn method, but the server +// supports it the same way it supports STU3. Search terms are provided +// as query parameters following the same pattern as the search method. +// The following search parameters must be provided: - `subject` or +// `patient` to specify a subject for the Observation. - `code`, +// `category` or any of the composite parameters that include `code`. +// Any other valid Observation search parameters can also be provided. +// This operation accepts an additional query parameter `max`, which +// specifies N, the maximum number of Observations to return from each +// group, with a default of 1. Searches with over 1000 results are // rejected. Results are counted before grouping and limiting the // results with `max`. To stay within the limit, constrain these // searches using Observation search parameters such as `_lastUpdated` @@ -23108,23 +23123,23 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatientEverythingCall struct { // PatientEverything: Retrieves a Patient resource and resources related // to that patient. Implements the FHIR extended operation // Patient-everything (DSTU2 -// (https://hl7.org/implement/standards/fhir/DSTU2/patient-operations.htm -// l#everything), STU3 -// (https://hl7.org/implement/standards/fhir/STU3/patient-operations.html -// #everything), R4 -// (https://hl7.org/implement/standards/fhir/R4/patient-operations.html#e -// verything)). On success, the response body contains a JSON-encoded -// representation of a `Bundle` resource of type `searchset`, containing -// the results of the operation. Errors generated by the FHIR store -// contain a JSON-encoded `OperationOutcome` resource describing the -// reason for the error. If the request cannot be mapped to a valid API -// method on a FHIR store, a generic GCP error might be returned -// instead. The resources in scope for the response are: * The patient -// resource itself. * All the resources directly referenced by the -// patient resource. * Resources directly referencing the patient -// resource that meet the inclusion criteria. The inclusion criteria are -// based on the membership rules in the patient compartment definition -// (DSTU2 (https://hl7.org/fhir/DSTU2/compartment-patient.html), STU3 +// (https://hl7.org/implement/standards/fhir/DSTU2/patient-operations.html#everything), +// STU3 +// (https://hl7.org/implement/standards/fhir/STU3/patient-operations.html#everything), +// R4 +// (https://hl7.org/implement/standards/fhir/R4/patient-operations.html#everything)). +// On success, the response body contains a JSON-encoded representation +// of a `Bundle` resource of type `searchset`, containing the results of +// the operation. Errors generated by the FHIR store contain a +// JSON-encoded `OperationOutcome` resource describing the reason for +// the error. If the request cannot be mapped to a valid API method on a +// FHIR store, a generic GCP error might be returned instead. The +// resources in scope for the response are: * The patient resource +// itself. * All the resources directly referenced by the patient +// resource. * Resources directly referencing the patient resource that +// meet the inclusion criteria. The inclusion criteria are based on the +// membership rules in the patient compartment definition (DSTU2 +// (https://hl7.org/fhir/DSTU2/compartment-patient.html), STU3 // (http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html), R4 // (https://hl7.org/fhir/R4/compartmentdefinition-patient.html)), which // details the eligible resource types and referencing search @@ -23464,20 +23479,20 @@ type ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall struct { } // Capabilities: Gets the FHIR capability statement (STU3 -// (https://hl7.org/implement/standards/fhir/STU3/capabilitystatement.htm -// l), R4 -// (https://hl7.org/implement/standards/fhir/R4/capabilitystatement.html) -// ), or the conformance statement +// (https://hl7.org/implement/standards/fhir/STU3/capabilitystatement.html), +// R4 +// (https://hl7.org/implement/standards/fhir/R4/capabilitystatement.html)), +// or the conformance statement // (https://hl7.org/implement/standards/fhir/DSTU2/conformance.html) in // the DSTU2 case for the store, which contains a description of // functionality supported by the server. Implements the FHIR standard // capabilities interaction (STU3 -// (https://hl7.org/implement/standards/fhir/STU3/http.html#capabilities) -// , R4 +// (https://hl7.org/implement/standards/fhir/STU3/http.html#capabilities), +// R4 // (https://hl7.org/implement/standards/fhir/R4/http.html#capabilities)), -// or the conformance interaction +// or the conformance interaction // (https://hl7.org/implement/standards/fhir/DSTU2/http.html#conformance) -// in the DSTU2 case. On success, the response body contains a +// in the DSTU2 case. On success, the response body contains a // JSON-encoded representation of a `CapabilityStatement` resource. func (r *ProjectsLocationsDatasetsFhirStoresFhirService) Capabilities(name string) *ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall { c := &ProjectsLocationsDatasetsFhirStoresFhirCapabilitiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -23592,9 +23607,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalDeleteCall struct { // ConditionalDelete: Deletes FHIR resources that match a search query. // Implements the FHIR standard conditional delete interaction (DSTU2 // (https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.12.1), -// STU3 +// STU3 // (https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.13.1), -// R4 +// R4 // (https://hl7.org/implement/standards/fhir/R4/http.html#3.1.0.7.1)). // If multiple resources match, all matching resources are deleted. // Search terms are provided as query parameters following the same @@ -23892,9 +23907,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalUpdateCall struct { // contents of that resource. Implements the FHIR standard conditional // update interaction (DSTU2 // (https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.10.2), -// STU3 +// STU3 // (https://hl7.org/implement/standards/fhir/STU3/http.html#cond-update), -// R4 +// R4 // (https://hl7.org/implement/standards/fhir/R4/http.html#cond-update)). // Search terms are provided as query parameters following the same // pattern as the search method. If the search criteria identify more @@ -24277,23 +24292,23 @@ type ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall struct { // ExecuteBundle: Executes all the requests in the given Bundle. // Implements the FHIR standard batch/transaction interaction (DSTU2 -// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#transaction) -// , STU3 +// (https://hl7.org/implement/standards/fhir/DSTU2/http.html#transaction), +// STU3 // (https://hl7.org/implement/standards/fhir/STU3/http.html#transaction), -// R4 +// R4 // (https://hl7.org/implement/standards/fhir/R4/http.html#transaction)). // Supports all interactions within a bundle, except search. This method // accepts Bundles of type `batch` and `transaction`, processing them // according to the batch processing rules (DSTU2 // (https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.1), -// STU3 +// STU3 // (https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.1), -// R4 (https://hl7.org/implement/standards/fhir/R4/http.html#brules)) +// R4 (https://hl7.org/implement/standards/fhir/R4/http.html#brules)) // and transaction processing rules (DSTU2 // (https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.2), -// STU3 +// STU3 // (https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.2), -// R4 (https://hl7.org/implement/standards/fhir/R4/http.html#trules)). +// R4 (https://hl7.org/implement/standards/fhir/R4/http.html#trules)). // The request body must contain a JSON-encoded FHIR `Bundle` resource, // and the request headers must contain `Content-Type: // application/fhir+json`. For a batch bundle or a successful @@ -24877,12 +24892,12 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // parameters are supported on each FHIR resource. A list of all search // parameters defined by the specification can be found in the FHIR // Search Parameter Registry (STU3 -// (https://hl7.org/implement/standards/fhir/STU3/searchparameter-registr -// y.html), R4 -// (https://hl7.org/implement/standards/fhir/R4/searchparameter-registry. -// html)). FHIR search parameters for DSTU2 can be found on each -// resource's definition page. Supported search modifiers: `:missing`, -// `:exact`, `:contains`, `:text`, `:in`, `:not-in`, `:above`, `:below`, +// (https://hl7.org/implement/standards/fhir/STU3/searchparameter-registry.html), +// R4 +// (https://hl7.org/implement/standards/fhir/R4/searchparameter-registry.html)). +// FHIR search parameters for DSTU2 can be found on each resource's +// definition page. Supported search modifiers: `:missing`, `:exact`, +// `:contains`, `:text`, `:in`, `:not-in`, `:above`, `:below`, // `:[type]`, `:not`, and `:recurse`. Supported search result // parameters: `_sort`, `_count`, `_include`, `_revinclude`, // `_summary=text`, `_summary=data`, and `_elements`. The maximum number @@ -26164,7 +26179,8 @@ func (r *ProjectsLocationsDatasetsHl7V2StoresService) List(parent string) *Proje // Filter sets the optional parameter "filter": Restricts stores // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings Only filtering on labels is supported. For example, +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// Only filtering on labels is supported. For example, // `labels.key=value`. func (c *ProjectsLocationsDatasetsHl7V2StoresListCall) Filter(filter string) *ProjectsLocationsDatasetsHl7V2StoresListCall { c.urlParams_.Set("filter", filter) @@ -27423,8 +27439,23 @@ func (r *ProjectsLocationsDatasetsHl7V2StoresMessagesService) List(parent string // Filter sets the optional parameter "filter": Restricts messages // returned to those matching a filter. Syntax: -// https://cloud.google.com/appengine/docs/standard/python/search/query_strings The following fields and functions are available for filtering: * `message_type`, from the MSH-9.1 field. For example, `NOT message_type = "ADT". * `send_date` or `sendDate`, the YYYY-MM-DD date the message was sent in the dataset's time_zone, from the MSH-7 segment. For example, `send_date < "2017-01-02". * `send_time`, the timestamp when the message was sent, using the RFC3339 time format for comparisons, from the MSH-7 segment. For example, `send_time < "2017-01-02T00:00:00-05:00". * `send_facility`, the care center that the message came from, from the MSH-4 segment. For example, `send_facility = "ABC". * `PatientId(value, type)`, which matches if the message lists a patient having an ID of the given value and type in the PID-2, PID-3, or PID-4 segments. For example, `PatientId("123456", "MRN")`. * `labels.x`, a string value of the label with key `x` as set using the Message.labels map. For example, `labels."priority"="high". The operator `:*` can be used to assert the existence of a label. For example, -// `labels."priority":*`. +// https://cloud.google.com/appengine/docs/standard/python/search/query_strings +// The following fields and functions are available for filtering: * +// `message_type`, from the MSH-9.1 field. For example, `NOT +// message_type = "ADT". * `send_date` or `sendDate`, the YYYY-MM-DD +// date the message was sent in the dataset's time_zone, from the MSH-7 +// segment. For example, `send_date < "2017-01-02". * `send_time`, the +// timestamp when the message was sent, using the RFC3339 time format +// for comparisons, from the MSH-7 segment. For example, `send_time < +// "2017-01-02T00:00:00-05:00". * `send_facility`, the care center that +// the message came from, from the MSH-4 segment. For example, +// `send_facility = "ABC". * `PatientId(value, type)`, which matches if +// the message lists a patient having an ID of the given value and type +// in the PID-2, PID-3, or PID-4 segments. For example, +// `PatientId("123456", "MRN")`. * `labels.x`, a string value of the +// label with key `x` as set using the Message.labels map. For example, +// `labels."priority"="high". The operator `:*` can be used to assert +// the existence of a label. For example, `labels."priority":*`. func (c *ProjectsLocationsDatasetsHl7V2StoresMessagesListCall) Filter(filter string) *ProjectsLocationsDatasetsHl7V2StoresMessagesListCall { c.urlParams_.Set("filter", filter) return c diff --git a/homegraph/v1/homegraph-gen.go b/homegraph/v1/homegraph-gen.go index ea39da7325b..905bc82a350 100644 --- a/homegraph/v1/homegraph-gen.go +++ b/homegraph/v1/homegraph-gen.go @@ -222,10 +222,10 @@ type Device struct { // CustomData: Custom device attributes stored in Home Graph and // provided to your smart home Action in each QUERY - // (https://developers.google.com/assistant/smarthome/reference/intent/qu - // ery) and EXECUTE - // (https://developers.google.com/assistant/smarthome/reference/intent/ex - // ecute) intent. + // (https://developers.google.com/assistant/smarthome/reference/intent/query) + // and EXECUTE + // (https://developers.google.com/assistant/smarthome/reference/intent/execute) + // intent. CustomData googleapi.RawMessage `json:"customData,omitempty"` // DeviceInfo: Device manufacturer, model, hardware version, and @@ -473,8 +473,8 @@ func (s *QueryRequestPayload) MarshalJSON() ([]byte, error) { // (#google.home.graph.v1.HomeGraphApiService.Query) call. This should // follow the same format as the Google smart home // `action.devices.QUERY` response -// (https://developers.google.com/assistant/smarthome/reference/intent/qu -// ery). # Example ```json { "requestId": +// (https://developers.google.com/assistant/smarthome/reference/intent/query). +// # Example ```json { "requestId": // "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "devices": { // "123": { "on": true, "online": true }, "456": { "on": true, "online": // true, "brightness": 80, "color": { "name": "cerulean", "spectrumRGB": @@ -596,8 +596,8 @@ type ReportStateAndNotificationRequest struct { // FollowUpToken: Token to maintain state in the follow up notification // response. Deprecated. See the notifications guide - // (https://developers.google.com/assistant/smarthome/develop/notificatio - // ns) for details on implementing follow up notifications. + // (https://developers.google.com/assistant/smarthome/develop/notifications) + // for details on implementing follow up notifications. FollowUpToken string `json:"followUpToken,omitempty"` // Payload: Required. State of devices to update and notification @@ -776,8 +776,8 @@ func (s *SyncRequest) MarshalJSON() ([]byte, error) { // (#google.home.graph.v1.HomeGraphApiService.Sync) call. This should // follow the same format as the Google smart home `action.devices.SYNC` // response -// (https://developers.google.com/assistant/smarthome/reference/intent/sy -// nc). # Example ```json { "requestId": +// (https://developers.google.com/assistant/smarthome/reference/intent/sync). +// # Example ```json { "requestId": // "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "agentUserId": // "1836.15267389", "devices": [{ "id": "123", "type": // "action.devices.types.OUTLET", "traits": [ @@ -866,11 +866,10 @@ type AgentUsersDeleteCall struct { // Action. All data related to this user will be deleted. For more // details on how users link their accounts, see fulfillment and // authentication -// (https://developers.google.com/assistant/smarthome/concepts/fulfillmen -// t-authentication). The third-party user's identity is passed in via -// the `agent_user_id` (see DeleteAgentUserRequest). This request must -// be authorized using service account credentials from your Actions -// console project. +// (https://developers.google.com/assistant/smarthome/concepts/fulfillment-authentication). +// The third-party user's identity is passed in via the `agent_user_id` +// (see DeleteAgentUserRequest). This request must be authorized using +// service account credentials from your Actions console project. func (r *AgentUsersService) Delete(agentUserId string) *AgentUsersDeleteCall { c := &AgentUsersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.agentUserId = agentUserId @@ -1145,13 +1144,13 @@ type DevicesReportStateAndNotificationCall struct { // device notifications. Called by your smart home Action when the state // of a third-party device changes or you need to send a notification // about the device. See Implement Report State -// (https://developers.google.com/assistant/smarthome/develop/report-stat -// e) for more information. This method updates the device state -// according to its declared traits -// (https://developers.google.com/assistant/smarthome/concepts/devices-tr -// aits). Publishing a new state value outside of these traits will -// result in an `INVALID_ARGUMENT` error response. The third-party -// user's identity is passed in via the `agent_user_id` (see +// (https://developers.google.com/assistant/smarthome/develop/report-state) +// for more information. This method updates the device state according +// to its declared traits +// (https://developers.google.com/assistant/smarthome/concepts/devices-traits). +// Publishing a new state value outside of these traits will result in +// an `INVALID_ARGUMENT` error response. The third-party user's identity +// is passed in via the `agent_user_id` (see // ReportStateAndNotificationRequest). This request must be authorized // using service account credentials from your Actions console project. func (r *DevicesService) ReportStateAndNotification(reportstateandnotificationrequest *ReportStateAndNotificationRequest) *DevicesReportStateAndNotificationCall { @@ -1280,8 +1279,8 @@ type DevicesRequestSyncCall struct { } // RequestSync: Requests Google to send an `action.devices.SYNC` intent -// (https://developers.google.com/assistant/smarthome/reference/intent/sy -// nc) to your smart home Action to update device metadata for the given +// (https://developers.google.com/assistant/smarthome/reference/intent/sync) +// to your smart home Action to update device metadata for the given // user. The third-party user's identity is passed via the // `agent_user_id` (see RequestSyncDevicesRequest). This request must be // authorized using service account credentials from your Actions diff --git a/iam/v1/iam-gen.go b/iam/v1/iam-gen.go index 1c3322707a8..ee29ada1365 100644 --- a/iam/v1/iam-gen.go +++ b/iam/v1/iam-gen.go @@ -5642,8 +5642,8 @@ type ProjectsServiceAccountsGetIamPolicyCall struct { // the `getIamPolicy` method for that resource. For example, to view the // role grants for a project, call the Resource Manager API's // `projects.getIamPolicy` -// (https://cloud.google.com/resource-manager/reference/rest/v1/projects/ -// getIamPolicy) method. +// (https://cloud.google.com/resource-manager/reference/rest/v1/projects/getIamPolicy) +// method. func (r *ProjectsServiceAccountsService) GetIamPolicy(resource string) *ProjectsServiceAccountsGetIamPolicyCall { c := &ProjectsServiceAccountsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -6139,8 +6139,7 @@ type ProjectsServiceAccountsSetIamPolicyCall struct { // for the resource. 3. Call the resource's `setIamPolicy` method to // update its IAM policy. For detailed instructions, see Granting roles // to a service account for specific resources -// (https://cloud.google.com/iam/help/service-accounts/granting-access-to -// -service-accounts). +// (https://cloud.google.com/iam/help/service-accounts/granting-access-to-service-accounts). func (r *ProjectsServiceAccountsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsServiceAccountsSetIamPolicyCall { c := &ProjectsServiceAccountsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -6282,9 +6281,9 @@ type ProjectsServiceAccountsSignBlobCall struct { // SignBlob: **Note:** This method is deprecated and will stop working // on July 1, 2021. Use the `signBlob` -// (https://cloud.google.com/iam/help/rest-credentials/v1/projects.servic -// eAccounts/signBlob) method in the IAM Service Account Credentials API -// instead. If you currently use this method, see the migration guide +// (https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signBlob) +// method in the IAM Service Account Credentials API instead. If you +// currently use this method, see the migration guide // (https://cloud.google.com/iam/help/credentials/migrate-api) for // instructions. Signs a blob using the system-managed private key for a // ServiceAccount. @@ -6429,9 +6428,9 @@ type ProjectsServiceAccountsSignJwtCall struct { // SignJwt: **Note:** This method is deprecated and will stop working on // July 1, 2021. Use the `signJwt` -// (https://cloud.google.com/iam/help/rest-credentials/v1/projects.servic -// eAccounts/signJwt) method in the IAM Service Account Credentials API -// instead. If you currently use this method, see the migration guide +// (https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signJwt) +// method in the IAM Service Account Credentials API instead. If you +// currently use this method, see the migration guide // (https://cloud.google.com/iam/help/credentials/migrate-api) for // instructions. Signs a JSON Web Token (JWT) using the system-managed // private key for a ServiceAccount. diff --git a/iap/v1/iap-gen.go b/iap/v1/iap-gen.go index 9478976cb15..d31db458680 100644 --- a/iap/v1/iap-gen.go +++ b/iap/v1/iap-gen.go @@ -811,8 +811,9 @@ type OAuthSettings struct { // LoginHint: Domain hint to send as hd=? parameter in OAuth request // flow. Enables redirect to primary IDP by skipping Google's login // screen. - // https://developers.google.com/identity/protocols/OpenIDConnect#hd-param Note: IAP does not verify that the id token's hd claim matches this value since access behavior is managed by IAM - // policies. + // https://developers.google.com/identity/protocols/OpenIDConnect#hd-param + // Note: IAP does not verify that the id token's hd claim matches this + // value since access behavior is managed by IAM policies. LoginHint string `json:"loginHint,omitempty"` // ForceSendFields is a list of field names (e.g. "LoginHint") to diff --git a/jobs/v3/jobs-gen.go b/jobs/v3/jobs-gen.go index 18f760ae274..d0830c63e81 100644 --- a/jobs/v3/jobs-gen.go +++ b/jobs/v3/jobs-gen.go @@ -2564,8 +2564,8 @@ type LocationFilter struct { // "Liverpool, UK". Set this field if all the jobs to search against are // from a same region, or jobs are world-wide, but the job seeker is // from a specific region. See http://cldr.unicode.org/ and - // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for - // Switzerland. + // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. RegionCode string `json:"regionCode,omitempty"` // TelecommutePreference: Optional. Allows the client to return jobs @@ -3037,8 +3037,8 @@ type PostalAddress struct { // RegionCode: Required. CLDR region code of the country/region of the // address. This is never inferred and it is up to the user to ensure // the value is correct. See http://cldr.unicode.org/ and - // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for - // Switzerland. + // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. RegionCode string `json:"regionCode,omitempty"` // Revision: The schema revision of the `PostalAddress`. This must be diff --git a/jobs/v3p1beta1/jobs-gen.go b/jobs/v3p1beta1/jobs-gen.go index 05723fa7f7b..b1097cccd89 100644 --- a/jobs/v3p1beta1/jobs-gen.go +++ b/jobs/v3p1beta1/jobs-gen.go @@ -2783,8 +2783,8 @@ type LocationFilter struct { // "Liverpool, UK". Set this field if all the jobs to search against are // from a same region, or jobs are world-wide, but the job seeker is // from a specific region. See http://cldr.unicode.org/ and - // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for - // Switzerland. + // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. RegionCode string `json:"regionCode,omitempty"` // TelecommutePreference: Optional. Allows the client to return jobs @@ -3318,8 +3318,8 @@ type PostalAddress struct { // RegionCode: Required. CLDR region code of the country/region of the // address. This is never inferred and it is up to the user to ensure // the value is correct. See http://cldr.unicode.org/ and - // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for - // Switzerland. + // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. RegionCode string `json:"regionCode,omitempty"` // Revision: The schema revision of the `PostalAddress`. This must be diff --git a/jobs/v4/jobs-gen.go b/jobs/v4/jobs-gen.go index f327ea51c65..b9627876b65 100644 --- a/jobs/v4/jobs-gen.go +++ b/jobs/v4/jobs-gen.go @@ -2474,8 +2474,8 @@ type LocationFilter struct { // Set this field to bias location resolution toward a specific country // or territory. If this field is not set, application behavior is // biased toward the United States by default. See - // https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for - // Switzerland. + // https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. RegionCode string `json:"regionCode,omitempty"` // TelecommutePreference: Allows the client to return jobs without a set @@ -2918,8 +2918,8 @@ type PostalAddress struct { // RegionCode: Required. CLDR region code of the country/region of the // address. This is never inferred and it is up to the user to ensure // the value is correct. See http://cldr.unicode.org/ and - // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for - // Switzerland. + // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. RegionCode string `json:"regionCode,omitempty"` // Revision: The schema revision of the `PostalAddress`. This must be diff --git a/lifesciences/v2beta/lifesciences-gen.go b/lifesciences/v2beta/lifesciences-gen.go index cdd7a491095..0df19649e58 100644 --- a/lifesciences/v2beta/lifesciences-gen.go +++ b/lifesciences/v2beta/lifesciences-gen.go @@ -1608,9 +1608,8 @@ type VirtualMachine struct { // "n1-standard-1") or a custom machine type (such as "custom-1-4096", // where "1" indicates the number of vCPUs and "4096" indicates the // memory in MB). See Creating an instance with a custom machine type - // (https://cloud.google.com/compute/docs/instances/creating-instance-wit - // h-custom-machine-type#create) for more specifications on creating a - // custom machine type. + // (https://cloud.google.com/compute/docs/instances/creating-instance-with-custom-machine-type#create) + // for more specifications on creating a custom machine type. MachineType string `json:"machineType,omitempty"` // Network: The VM network configuration. diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go index 06eda22d514..00193acdf1c 100644 --- a/logging/v2/logging-gen.go +++ b/logging/v2/logging-gen.go @@ -2217,10 +2217,9 @@ type LogSink struct { // methods.Until you grant this identity write-access to the // destination, log entry exports from this sink will fail. For more // information, see Granting Access for a Resource - // (https://cloud.google.com/iam/docs/granting-roles-to-service-accounts# - // granting_access_to_a_service_account_for_a_resource). Consult the - // destination service's documentation to determine the appropriate IAM - // roles to assign to the identity. + // (https://cloud.google.com/iam/docs/granting-roles-to-service-accounts#granting_access_to_a_service_account_for_a_resource). + // Consult the destination service's documentation to determine the + // appropriate IAM roles to assign to the identity. WriterIdentity string `json:"writerIdentity,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/managedidentities/v1alpha1/managedidentities-gen.go b/managedidentities/v1alpha1/managedidentities-gen.go index 0799a8f05c0..36c7e31751f 100644 --- a/managedidentities/v1alpha1/managedidentities-gen.go +++ b/managedidentities/v1alpha1/managedidentities-gen.go @@ -2065,8 +2065,10 @@ func (s *TimeOfDay) MarshalJSON() ([]byte, error) { // Trust: Represents a relationship between two domains which makes it // possible for users in one domain to be authenticated by a dc in // another domain. Refer -// https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/cc731335(v%3dws.10) If the trust is being changed, it will be placed into the UPDATING state, which indicates that the resource is being reconciled. At this point, Get will reflect an intermediate -// state. +// https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/cc731335(v%3dws.10) +// If the trust is being changed, it will be placed into the UPDATING +// state, which indicates that the resource is being reconciled. At this +// point, Get will reflect an intermediate state. type Trust struct { // CreateTime: Output only. The time the instance was created. CreateTime string `json:"createTime,omitempty"` diff --git a/ml/v1/ml-gen.go b/ml/v1/ml-gen.go index 3e24cdecf91..4548ad5b512 100644 --- a/ml/v1/ml-gen.go +++ b/ml/v1/ml-gen.go @@ -984,7 +984,8 @@ type GoogleCloudMlV1__AutoScaling struct { // version, and you can also update `min_nodes` for an existing version: // update_body.json: { 'autoScaling': { 'minNodes': 5 } } HTTP request: // PATCH - // https://ml.googleapis.com/v1/{name=projects/*/models/*/versions/*}?update_mask=autoScaling.minNodes -d @./update_body.json + // https://ml.googleapis.com/v1/{name=projects/*/models/*/versions/*}?update_mask=autoScaling.minNodes + // -d @./update_body.json MinNodes int64 `json:"minNodes,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxNodes") to @@ -1291,8 +1292,7 @@ func (s *GoogleCloudMlV1__Config) MarshalJSON() ([]byte, error) { // GoogleCloudMlV1__ContainerPort: Represents a network port in a single // container. This message is a subset of the Kubernetes ContainerPort // v1 core specification -// (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# -// containerport-v1-core). +// (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#containerport-v1-core). type GoogleCloudMlV1__ContainerPort struct { // ContainerPort: Number of the port to expose on the container. This // must be a valid port number: 0 < PORT_NUMBER < 65536. @@ -1324,8 +1324,7 @@ func (s *GoogleCloudMlV1__ContainerPort) MarshalJSON() ([]byte, error) { // GoogleCloudMlV1__ContainerSpec: Specification of a custom container // for serving predictions. This message is a subset of the Kubernetes // Container v1 core specification -// (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# -// container-v1-core). +// (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#container-v1-core). type GoogleCloudMlV1__ContainerSpec struct { // Args: Immutable. Specifies arguments for the command that runs when // the container starts. This overrides the container's `CMD` @@ -1336,15 +1335,15 @@ type GoogleCloudMlV1__ContainerSpec struct { // field runs without any additional arguments. See the Kubernetes // documentation about how the `command` and `args` fields interact with // a container's `ENTRYPOINT` and `CMD` - // (https://kubernetes.io/docs/tasks/inject-data-application/define-comma - // nd-argument-container/#notes). If you don't specify this field and - // don't specify the `commmand` field, then the container's `ENTRYPOINT` + // (https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#notes). + // If you don't specify this field and don't specify the `commmand` + // field, then the container's `ENTRYPOINT` // (https://docs.docker.com/engine/reference/builder/#cmd) and `CMD` // determine what runs based on their default behavior. See the Docker // documentation about how `CMD` and `ENTRYPOINT` interact - // (https://docs.docker.com/engine/reference/builder/#understand-how-cmd- - // and-entrypoint-interact). In this field, you can reference - // environment variables set by AI Platform Prediction + // (https://docs.docker.com/engine/reference/builder/#understand-how-cmd-and-entrypoint-interact). + // In this field, you can reference environment variables set by AI + // Platform Prediction // (/ai-platform/prediction/docs/custom-container-requirements#aip-variab // les) and environment variables set in the env field. You cannot // reference environment variables set in the Docker image. In order for @@ -1355,8 +1354,7 @@ type GoogleCloudMlV1__ContainerSpec struct { // unchanged. To avoid variable expansion, you can escape this syntax // with `$$`; for example: $$(VARIABLE_NAME) This field corresponds to // the `args` field of the Kubernetes Containers v1 core API - // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# - // container-v1-core). + // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#container-v1-core). Args []string `json:"args,omitempty"` // Command: Immutable. Specifies the command that runs when the @@ -1370,16 +1368,15 @@ type GoogleCloudMlV1__ContainerSpec struct { // exists. If this field is not specified and the container does not // have an `ENTRYPOINT`, then refer to the Docker documentation about // how `CMD` and `ENTRYPOINT` interact - // (https://docs.docker.com/engine/reference/builder/#understand-how-cmd- - // and-entrypoint-interact). If you specify this field, then you can - // also specify the `args` field to provide additional arguments for - // this command. However, if you specify this field, then the - // container's `CMD` is ignored. See the Kubernetes documentation about - // how the `command` and `args` fields interact with a container's - // `ENTRYPOINT` and `CMD` - // (https://kubernetes.io/docs/tasks/inject-data-application/define-comma - // nd-argument-container/#notes). In this field, you can reference - // environment variables set by AI Platform Prediction + // (https://docs.docker.com/engine/reference/builder/#understand-how-cmd-and-entrypoint-interact). + // If you specify this field, then you can also specify the `args` field + // to provide additional arguments for this command. However, if you + // specify this field, then the container's `CMD` is ignored. See the + // Kubernetes documentation about how the `command` and `args` fields + // interact with a container's `ENTRYPOINT` and `CMD` + // (https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#notes). + // In this field, you can reference environment variables set by AI + // Platform Prediction // (/ai-platform/prediction/docs/custom-container-requirements#aip-variab // les) and environment variables set in the env field. You cannot // reference environment variables set in the Docker image. In order for @@ -1390,8 +1387,7 @@ type GoogleCloudMlV1__ContainerSpec struct { // unchanged. To avoid variable expansion, you can escape this syntax // with `$$`; for example: $$(VARIABLE_NAME) This field corresponds to // the `command` field of the Kubernetes Containers v1 core API - // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# - // container-v1-core). + // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#container-v1-core). Command []string `json:"command,omitempty"` // Env: Immutable. List of environment variables to set in the @@ -1405,8 +1401,7 @@ type GoogleCloudMlV1__ContainerSpec struct { // the variables in the example, then the expansion does not occur. This // field corresponds to the `env` field of the Kubernetes Containers v1 // core API - // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# - // container-v1-core). + // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#container-v1-core). Env []*GoogleCloudMlV1__EnvVar `json:"env,omitempty"` // Image: URI of the Docker image to be used as the custom container for @@ -1446,8 +1441,7 @@ type GoogleCloudMlV1__ContainerSpec struct { // Platform Prediction does not use ports other than the first one // listed. This field corresponds to the `ports` field of the Kubernetes // Containers v1 core API - // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# - // container-v1-core). + // (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#container-v1-core). Ports []*GoogleCloudMlV1__ContainerPort `json:"ports,omitempty"` // ForceSendFields is a list of field names (e.g. "Args") to @@ -1543,13 +1537,11 @@ func (s *GoogleCloudMlV1__EncryptionConfig) MarshalJSON() ([]byte, error) { // GoogleCloudMlV1__EnvVar: Represents an environment variable to be // made available in a container. This message is a subset of the // Kubernetes EnvVar v1 core specification -// (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/# -// envvar-v1-core). +// (https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#envvar-v1-core). type GoogleCloudMlV1__EnvVar struct { // Name: Name of the environment variable. Must be a valid C identifier - // (https://github.com/kubernetes/kubernetes/blob/v1.18.8/staging/src/k8s - // .io/apimachinery/pkg/util/validation/validation.go#L258) and must not - // begin with the prefix `AIP_`. + // (https://github.com/kubernetes/kubernetes/blob/v1.18.8/staging/src/k8s.io/apimachinery/pkg/util/validation/validation.go#L258) + // and must not begin with the prefix `AIP_`. Name string `json:"name,omitempty"` // Value: Value of the environment variable. Defaults to an empty @@ -2748,8 +2740,8 @@ type GoogleCloudMlV1__PredictionInput struct { // (https://tensorflow.github.io/serving/serving_basic.html) for // information about how to use signatures. Defaults to // DEFAULT_SERVING_SIGNATURE_DEF_KEY - // (https://www.tensorflow.org/api_docs/python/tf/saved_model/signature_c - // onstants) , which is "serving_default". + // (https://www.tensorflow.org/api_docs/python/tf/saved_model/signature_constants) + // , which is "serving_default". SignatureName string `json:"signatureName,omitempty"` // Uri: Use this field if you want to specify a Google Cloud Storage @@ -2888,9 +2880,9 @@ type GoogleCloudMlV1__ReplicaConfig struct { // that the version of TensorFlow included in a runtime version may // differ from the numbering of the runtime version itself, because it // may have a different patch version - // (https://www.tensorflow.org/guide/version_compat#semantic_versioning_2 - // 0). In this field, you must specify the runtime version (TensorFlow - // minor version). For example, if your custom container runs TensorFlow + // (https://www.tensorflow.org/guide/version_compat#semantic_versioning_20). + // In this field, you must specify the runtime version (TensorFlow minor + // version). For example, if your custom container runs TensorFlow // `1.x.y`, specify `1.x`. TpuTfVersion string `json:"tpuTfVersion,omitempty"` diff --git a/monitoring/v1/monitoring-gen.go b/monitoring/v1/monitoring-gen.go index 33b30dab6f6..71489396641 100644 --- a/monitoring/v1/monitoring-gen.go +++ b/monitoring/v1/monitoring-gen.go @@ -1576,8 +1576,8 @@ func (s *Tile) MarshalJSON() ([]byte, error) { // TimeSeriesFilter: A filter that defines a subset of time series data // that is displayed in a widget. Time series data is fetched using the // ListTimeSeries -// (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeS -// eries/list) method. +// (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) +// method. type TimeSeriesFilter struct { // Aggregation: By default, the raw time series data is returned. Use // this field to combine multiple time series for different views of the @@ -1685,8 +1685,8 @@ type TimeSeriesQuery struct { // UnitOverride: The unit of data contained in fetched time series. If // non-empty, this unit will override any unit that accompanies fetched // data. The format is the same as the unit - // (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.metri - // cDescriptors) field in MetricDescriptor. + // (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.metricDescriptors) + // field in MetricDescriptor. UnitOverride string `json:"unitOverride,omitempty"` // ForceSendFields is a list of field names (e.g. "TimeSeriesFilter") to diff --git a/monitoring/v3/monitoring-gen.go b/monitoring/v3/monitoring-gen.go index 749c561aed1..db0ebb762f8 100644 --- a/monitoring/v3/monitoring-gen.go +++ b/monitoring/v3/monitoring-gen.go @@ -2266,15 +2266,14 @@ type InternalChecker struct { // configured. A checker in this state can be returned by // ListInternalCheckers or GetInternalChecker, as well as by examining // the long running Operation - // (https://cloud.google.com/apis/design/design_patterns#long_running_ope - // rations) that created it. + // (https://cloud.google.com/apis/design/design_patterns#long_running_operations) + // that created it. // "RUNNING" - The checker is running and available for use. A checker // in this state can be returned by ListInternalCheckers or // GetInternalChecker as well as by examining the long running Operation - // (https://cloud.google.com/apis/design/design_patterns#long_running_ope - // rations) that created it. If a checker is being torn down, it is - // neither visible nor usable, so there is no "deleting" or "down" - // state. + // (https://cloud.google.com/apis/design/design_patterns#long_running_operations) + // that created it. If a checker is being torn down, it is neither + // visible nor usable, so there is no "deleting" or "down" state. State string `json:"state,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -3054,9 +3053,9 @@ type MetricAbsence struct { // across all members of a group of resrouces). Multiple aggregations // are applied in the order specified.This field is similar to the one // in the ListTimeSeries request - // (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeS - // eries/list). It is advisable to use the ListTimeSeries method when - // debugging this field. + // (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). + // It is advisable to use the ListTimeSeries method when debugging this + // field. Aggregations []*Aggregation `json:"aggregations,omitempty"` // Duration: The amount of time that a time series must fail to report @@ -3070,12 +3069,11 @@ type MetricAbsence struct { // that identifies which time series should be compared with the // threshold.The filter is similar to the one that is specified in the // ListTimeSeries request - // (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeS - // eries/list) (that call is useful to verify the time series that will - // be retrieved / processed). The filter must specify the metric type - // and the resource type. Optionally, it can specify resource labels and - // metric labels. This field must not exceed 2048 Unicode characters in - // length. + // (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) + // (that call is useful to verify the time series that will be retrieved + // / processed). The filter must specify the metric type and the + // resource type. Optionally, it can specify resource labels and metric + // labels. This field must not exceed 2048 Unicode characters in length. Filter string `json:"filter,omitempty"` // Trigger: The number/percent of time series for which the comparison @@ -3420,9 +3418,9 @@ type MetricThreshold struct { // across all members of a group of resrouces). Multiple aggregations // are applied in the order specified.This field is similar to the one // in the ListTimeSeries request - // (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeS - // eries/list). It is advisable to use the ListTimeSeries method when - // debugging this field. + // (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). + // It is advisable to use the ListTimeSeries method when debugging this + // field. Aggregations []*Aggregation `json:"aggregations,omitempty"` // Comparison: The comparison to apply between the time series @@ -3485,12 +3483,11 @@ type MetricThreshold struct { // that identifies which time series should be compared with the // threshold.The filter is similar to the one that is specified in the // ListTimeSeries request - // (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeS - // eries/list) (that call is useful to verify the time series that will - // be retrieved / processed). The filter must specify the metric type - // and the resource type. Optionally, it can specify resource labels and - // metric labels. This field must not exceed 2048 Unicode characters in - // length. + // (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) + // (that call is useful to verify the time series that will be retrieved + // / processed). The filter must specify the metric type and the + // resource type. Optionally, it can specify resource labels and metric + // labels. This field must not exceed 2048 Unicode characters in length. Filter string `json:"filter,omitempty"` // ThresholdValue: A value against which to compare the time series. diff --git a/networkmanagement/v1beta1/networkmanagement-gen.go b/networkmanagement/v1beta1/networkmanagement-gen.go index 06f73cae495..c0176a4a6c9 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -728,8 +728,7 @@ type Endpoint struct { CloudSqlInstance string `json:"cloudSqlInstance,omitempty"` // GkeMasterCluster: A cluster URI for Google Kubernetes Engine master - // (https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-arch - // itecture). + // (https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture). GkeMasterCluster string `json:"gkeMasterCluster,omitempty"` // Instance: A Compute Engine instance URI. @@ -738,8 +737,7 @@ type Endpoint struct { // IpAddress: The IP address of the endpoint, which can be an external // or internal IP. An IPv6 address is only allowed when the test's // destination is a global load balancer VIP - // (https://cloud.google.com/load-balancing/docs/load-balancing-overview) - // . + // (https://cloud.google.com/load-balancing/docs/load-balancing-overview). IpAddress string `json:"ipAddress,omitempty"` // Network: A Compute Engine network URI. diff --git a/notebooks/v1/notebooks-gen.go b/notebooks/v1/notebooks-gen.go index 1f5191c0835..564d43097d3 100644 --- a/notebooks/v1/notebooks-gen.go +++ b/notebooks/v1/notebooks-gen.go @@ -730,8 +730,8 @@ type Instance struct { // within the same project, but you must have the service account user // permission to use the instance. If not specified, the Compute Engine // default service account - // (https://cloud.google.com/compute/docs/access/service-accounts#default - // _service_account) is used. + // (https://cloud.google.com/compute/docs/access/service-accounts#default_service_account) + // is used. ServiceAccount string `json:"serviceAccount,omitempty"` // State: Output only. The state of this instance. diff --git a/osconfig/v1/osconfig-gen.go b/osconfig/v1/osconfig-gen.go index a6667b92376..0a2f95478c3 100644 --- a/osconfig/v1/osconfig-gen.go +++ b/osconfig/v1/osconfig-gen.go @@ -616,8 +616,8 @@ type InventorySoftwarePackage struct { GoogetPackage *InventoryVersionedPackage `json:"googetPackage,omitempty"` // QfePackage: Details of a Windows Quick Fix engineering package. See - // https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/win32-quickfixengineering for info in Windows Quick Fix - // Engineering. + // https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/win32-quickfixengineering + // for info in Windows Quick Fix Engineering. QfePackage *InventoryWindowsQuickFixEngineeringPackage `json:"qfePackage,omitempty"` // WuaPackage: Details of a Windows Update package. See @@ -1117,8 +1117,7 @@ func (s *PatchConfig) MarshalJSON() ([]byte, error) { // instance filter, package repository settings, and a schedule. For // more information about creating and managing patch deployments, see // Scheduling patch jobs -// (https://cloud.google.com/compute/docs/os-patch-management/schedule-pa -// tch-jobs). +// (https://cloud.google.com/compute/docs/os-patch-management/schedule-patch-jobs). type PatchDeployment struct { // CreateTime: Output only. Time the patch deployment was created. // Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text @@ -1285,8 +1284,7 @@ func (s *PatchInstanceFilterGroupLabel) MarshalJSON() ([]byte, error) { // the job. To paginate through instance details, use // ListPatchJobInstanceDetails. For more information about patch jobs, // see Creating patch jobs -// (https://cloud.google.com/compute/docs/os-patch-management/create-patc -// h-job). +// (https://cloud.google.com/compute/docs/os-patch-management/create-patch-job). type PatchJob struct { // CreateTime: Time this patch job was created. CreateTime string `json:"createTime,omitempty"` @@ -1397,8 +1395,7 @@ func (s *PatchJob) UnmarshalJSON(data []byte) error { // PatchJobInstanceDetails: Patch details for a VM instance. For more // information about reviewing VM instance details, see Listing all VM // instance details for a specific patch job -// (https://cloud.google.com/compute/docs/os-patch-management/manage-patc -// h-jobs#list-instance-details). +// (https://cloud.google.com/compute/docs/os-patch-management/manage-patch-jobs#list-instance-details). type PatchJobInstanceDetails struct { // AttemptCount: The number of times the agent that the agent attempts // to apply the patch. diff --git a/osconfig/v1beta/osconfig-gen.go b/osconfig/v1beta/osconfig-gen.go index a106f927cbc..cf48523e35a 100644 --- a/osconfig/v1beta/osconfig-gen.go +++ b/osconfig/v1beta/osconfig-gen.go @@ -1083,8 +1083,8 @@ type InventorySoftwarePackage struct { GoogetPackage *InventoryVersionedPackage `json:"googetPackage,omitempty"` // QfePackage: Details of a Windows Quick Fix engineering package. See - // https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/win32-quickfixengineering for info in Windows Quick Fix - // Engineering. + // https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/win32-quickfixengineering + // for info in Windows Quick Fix Engineering. QfePackage *InventoryWindowsQuickFixEngineeringPackage `json:"qfePackage,omitempty"` // WuaPackage: Details of a Windows Update package. See @@ -1775,8 +1775,7 @@ func (s *PatchConfig) MarshalJSON() ([]byte, error) { // instance filter, package repository settings, and a schedule. For // more information about creating and managing patch deployments, see // Scheduling patch jobs -// (https://cloud.google.com/compute/docs/os-patch-management/schedule-pa -// tch-jobs). +// (https://cloud.google.com/compute/docs/os-patch-management/schedule-patch-jobs). type PatchDeployment struct { // CreateTime: Output only. Time the patch deployment was created. // Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text @@ -1939,8 +1938,7 @@ func (s *PatchInstanceFilterGroupLabel) MarshalJSON() ([]byte, error) { // the job. To paginate through instance details, use // `ListPatchJobInstanceDetails`. For more information about patch jobs, // see Creating patch jobs -// (https://cloud.google.com/compute/docs/os-patch-management/create-patc -// h-job). +// (https://cloud.google.com/compute/docs/os-patch-management/create-patch-job). type PatchJob struct { // CreateTime: Time this patch job was created. CreateTime string `json:"createTime,omitempty"` @@ -2051,8 +2049,7 @@ func (s *PatchJob) UnmarshalJSON(data []byte) error { // PatchJobInstanceDetails: Patch details for a VM instance. For more // information about reviewing VM instance details, see Listing all VM // instance details for a specific patch job -// (https://cloud.google.com/compute/docs/os-patch-management/manage-patc -// h-jobs#list-instance-details). +// (https://cloud.google.com/compute/docs/os-patch-management/manage-patch-jobs#list-instance-details). type PatchJobInstanceDetails struct { // AttemptCount: The number of times the agent that the agent attempts // to apply the patch. diff --git a/privateca/v1beta1/privateca-gen.go b/privateca/v1beta1/privateca-gen.go index 234567a6db1..33193cf5f83 100644 --- a/privateca/v1beta1/privateca-gen.go +++ b/privateca/v1beta1/privateca-gen.go @@ -6707,8 +6707,7 @@ func (r *ProjectsLocationsCertificateAuthoritiesCertificatesService) List(parent // Filter sets the optional parameter "filter": Only include resources // that match the filter in the response. For details on supported // filters and syntax, see Certificates Filtering documentation -// (https://cloud.google.com/certificate-authority-service/docs/sorting-f -// iltering-certificates#filtering_support). +// (https://cloud.google.com/certificate-authority-service/docs/sorting-filtering-certificates#filtering_support). func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) Filter(filter string) *ProjectsLocationsCertificateAuthoritiesCertificatesListCall { c.urlParams_.Set("filter", filter) return c @@ -6717,8 +6716,7 @@ func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) Filter(fil // OrderBy sets the optional parameter "orderBy": Specify how the // results should be sorted. For details on supported fields and syntax, // see Certificates Sorting documentation -// (https://cloud.google.com/certificate-authority-service/docs/sorting-f -// iltering-certificates#sorting_support). +// (https://cloud.google.com/certificate-authority-service/docs/sorting-filtering-certificates#sorting_support). func (c *ProjectsLocationsCertificateAuthoritiesCertificatesListCall) OrderBy(orderBy string) *ProjectsLocationsCertificateAuthoritiesCertificatesListCall { c.urlParams_.Set("orderBy", orderBy) return c diff --git a/realtimebidding/v1/realtimebidding-gen.go b/realtimebidding/v1/realtimebidding-gen.go index 4ffa65887d5..494f85c9d13 100644 --- a/realtimebidding/v1/realtimebidding-gen.go +++ b/realtimebidding/v1/realtimebidding-gen.go @@ -498,10 +498,10 @@ type Creative struct { // shown from this creative. Can be used to filter the response of the // creatives.list method. If the `excluded_attribute` field of a bid // request - // (https://developers.google.com/authorized-buyers/rtb/downloads/realtim - // e-bidding-proto") contains one of the attributes that were declared - // or detected for a given creative, and a bid is submitted with that - // creative, the bid will be filtered before the auction. + // (https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto") + // contains one of the attributes that were declared or detected for a + // given creative, and a bid is submitted with that creative, the bid + // will be filtered before the auction. // // Possible values: // "ATTRIBUTE_UNSPECIFIED" - Do not use. This is a placeholder value @@ -698,10 +698,10 @@ type CreativeServingDecision struct { // detected for this creative. Can be used to filter the response of the // creatives.list method. If the `excluded_attribute` field of a bid // request - // (https://developers.google.com/authorized-buyers/rtb/downloads/realtim - // e-bidding-proto) contains one of the attributes that were declared or - // detected for a given creative, and a bid is submitted with that - // creative, the bid will be filtered before the auction. + // (https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) + // contains one of the attributes that were declared or detected for a + // given creative, and a bid is submitted with that creative, the bid + // will be filtered before the auction. // // Possible values: // "ATTRIBUTE_UNSPECIFIED" - Do not use. This is a placeholder value @@ -774,8 +774,8 @@ type CreativeServingDecision struct { // DetectedLanguages: The detected languages for this creative. The // order is arbitrary. The codes are 2 or 5 characters and are // documented at - // https://developers.google.com/adwords/api/docs/appendix/languagecodes. Can be used to filter the response of the creatives.list - // method. + // https://developers.google.com/adwords/api/docs/appendix/languagecodes. + // Can be used to filter the response of the creatives.list method. DetectedLanguages []string `json:"detectedLanguages,omitempty"` // DetectedProductCategories: Detected product categories, if any. See @@ -798,11 +798,10 @@ type CreativeServingDecision struct { // possible values. Can be used to filter the response of the // creatives.list method. If the `allowed_vendor_type` field of a bid // request - // (https://developers.google.com/authorized-buyers/rtb/downloads/realtim - // e-bidding-proto) does not contain one of the vendor type IDs that - // were declared or detected for a given creative, and a bid is - // submitted with that creative, the bid will be filtered before the - // auction. + // (https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) + // does not contain one of the vendor type IDs that were declared or + // detected for a given creative, and a bid is submitted with that + // creative, the bid will be filtered before the auction. DetectedVendorIds []int64 `json:"detectedVendorIds,omitempty"` // LastStatusUpdate: The last time the creative status was updated. Can @@ -1815,8 +1814,8 @@ type PretargetingConfig struct { // excluded in this configuration. Bid requests for inventory with any // of the specified content label IDs will not be sent. Refer to this // file - // https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category - // IDs. + // https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt + // for category IDs. ExcludedContentLabelIds googleapi.Int64s `json:"excludedContentLabelIds,omitempty"` // GeoTargeting: The geos included or excluded in this configuration @@ -1942,11 +1941,10 @@ type PretargetingConfig struct { // (https://iabtechlab.com/ads-txt/) / app-ads.txt // (https://iabtechlab.com/app-ads-txt/) and in bid requests in the // `BidRequest.publisher_id` field on the Google RTB protocol - // (https://developers.google.com/authorized-buyers/rtb/downloads/realtim - // e-bidding-proto) or the `BidRequest.site.publisher.id` / - // `BidRequest.app.publisher.id` field on the OpenRTB protocol - // (https://developers.google.com/authorized-buyers/rtb/downloads/openrtb - // -adx-proto). + // (https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) + // or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` + // field on the OpenRTB protocol + // (https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto). PublisherTargeting *StringTargetingDimension `json:"publisherTargeting,omitempty"` // State: Output only. The state of this pretargeting configuration. diff --git a/recommendationengine/v1beta1/recommendationengine-gen.go b/recommendationengine/v1beta1/recommendationengine-gen.go index 326e97cbe2e..f59362eba24 100644 --- a/recommendationengine/v1beta1/recommendationengine-gen.go +++ b/recommendationengine/v1beta1/recommendationengine-gen.go @@ -396,7 +396,8 @@ type GoogleCloudRecommendationengineV1beta1BigQuerySource struct { // https://cloud.google.com/recommendations-ai/docs/upload-catalog#mc // Supported values for user event imports: 1: // "user_events_recommendations_ai" using - // https://cloud.google.com/recommendations-ai/docs/manage-user-events#import (Default for userEvents.import) 2. "user_events_ga360" using + // https://cloud.google.com/recommendations-ai/docs/manage-user-events#import + // (Default for userEvents.import) 2. "user_events_ga360" using // https://support.google.com/analytics/answer/3437719?hl=en DataSchema string `json:"dataSchema,omitempty"` @@ -636,8 +637,8 @@ func (s *GoogleCloudRecommendationengineV1beta1CatalogItemCategoryHierarchy) Mar type GoogleCloudRecommendationengineV1beta1CatalogItemLevelConfig struct { // EventItemLevel: Optional. Level of the catalog at which events are // uploaded. See - // https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels for more - // details. + // https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels + // for more details. // // Possible values: // "CATALOG_ITEM_LEVEL_UNSPECIFIED" - Unknown value - should never be @@ -648,8 +649,8 @@ type GoogleCloudRecommendationengineV1beta1CatalogItemLevelConfig struct { // PredictItemLevel: Optional. Level of the catalog at which predictions // are made. See - // https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels for more - // details. + // https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels + // for more details. // // Possible values: // "CATALOG_ITEM_LEVEL_UNSPECIFIED" - Unknown value - should never be @@ -908,7 +909,8 @@ type GoogleCloudRecommendationengineV1beta1GcsSource struct { // https://cloud.google.com/recommendations-ai/docs/upload-catalog#mc // Supported values for user events imports: 1: // "user_events_recommendations_ai" using - // https://cloud.google.com/recommendations-ai/docs/manage-user-events#import (Default for userEvents.import) 2. "user_events_ga360" using + // https://cloud.google.com/recommendations-ai/docs/manage-user-events#import + // (Default for userEvents.import) 2. "user_events_ga360" using // https://support.google.com/analytics/answer/3437719?hl=en JsonSchema string `json:"jsonSchema,omitempty"` @@ -4223,8 +4225,7 @@ type ProjectsLocationsCatalogsEventStoresPlacementsPredictCall struct { // Predict: Makes a recommendation prediction. If using API Key based // authentication, the API Key must be registered using the // PredictionApiKeyRegistry service. Learn more -// (https://cloud.google.com/recommendations-ai/docs/setting-up#register- -// key). +// (https://cloud.google.com/recommendations-ai/docs/setting-up#register-key). func (r *ProjectsLocationsCatalogsEventStoresPlacementsService) Predict(name string, googlecloudrecommendationenginev1beta1predictrequest *GoogleCloudRecommendationengineV1beta1PredictRequest) *ProjectsLocationsCatalogsEventStoresPlacementsPredictCall { c := &ProjectsLocationsCatalogsEventStoresPlacementsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/remotebuildexecution/v1/remotebuildexecution-gen.go b/remotebuildexecution/v1/remotebuildexecution-gen.go index 27ad30daf4b..3286952ea5b 100644 --- a/remotebuildexecution/v1/remotebuildexecution-gen.go +++ b/remotebuildexecution/v1/remotebuildexecution-gen.go @@ -1229,8 +1229,8 @@ func (s *BuildBazelRemoteExecutionV2PlatformProperty) MarshalJSON() ([]byte, err // `build.bazel.remote.execution.v2.requestmetadata-bin` * contents: the // base64 encoded binary `RequestMetadata` message. Note: the gRPC // library serializes binary headers encoded in base 64 by default -// (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#reques -// ts). Therefore, if the gRPC library is used to pass/retrieve this +// (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#requests). +// Therefore, if the gRPC library is used to pass/retrieve this // metadata, the user may ignore the base64 encoding and assume it is // simply serialized as a binary message. type BuildBazelRemoteExecutionV2RequestMetadata struct { @@ -2312,8 +2312,11 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateInstanceRequest struct // UpdateMask: The update mask applies to instance. For the `FieldMask` // definition, see - // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If an empty update_mask is provided, only the non-default valued field in the worker pool field will be updated. Note that in order to update a field to the default value (zero, false, empty string) an explicit update_mask must be - // provided. + // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask + // If an empty update_mask is provided, only the non-default valued + // field in the worker pool field will be updated. Note that in order to + // update a field to the default value (zero, false, empty string) an + // explicit update_mask must be provided. UpdateMask string `json:"updateMask,omitempty"` // ForceSendFields is a list of field names (e.g. "Instance") to @@ -2344,8 +2347,11 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateInstanceRequest) Ma type GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateWorkerPoolRequest struct { // UpdateMask: The update mask applies to worker_pool. For the // `FieldMask` definition, see - // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If an empty update_mask is provided, only the non-default valued field in the worker pool field will be updated. Note that in order to update a field to the default value (zero, false, empty string) an explicit update_mask must be - // provided. + // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask + // If an empty update_mask is provided, only the non-default valued + // field in the worker pool field will be updated. Note that in order to + // update a field to the default value (zero, false, empty string) an + // explicit update_mask must be provided. UpdateMask string `json:"updateMask,omitempty"` // WorkerPool: Specifies the worker pool to update. diff --git a/remotebuildexecution/v1alpha/remotebuildexecution-gen.go b/remotebuildexecution/v1alpha/remotebuildexecution-gen.go index 4ec52a2e100..77a28b76e29 100644 --- a/remotebuildexecution/v1alpha/remotebuildexecution-gen.go +++ b/remotebuildexecution/v1alpha/remotebuildexecution-gen.go @@ -1229,8 +1229,8 @@ func (s *BuildBazelRemoteExecutionV2PlatformProperty) MarshalJSON() ([]byte, err // `build.bazel.remote.execution.v2.requestmetadata-bin` * contents: the // base64 encoded binary `RequestMetadata` message. Note: the gRPC // library serializes binary headers encoded in base 64 by default -// (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#reques -// ts). Therefore, if the gRPC library is used to pass/retrieve this +// (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#requests). +// Therefore, if the gRPC library is used to pass/retrieve this // metadata, the user may ignore the base64 encoding and assume it is // simply serialized as a binary message. type BuildBazelRemoteExecutionV2RequestMetadata struct { @@ -2292,8 +2292,11 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateInstanceRequest struct // UpdateMask: The update mask applies to instance. For the `FieldMask` // definition, see - // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If an empty update_mask is provided, only the non-default valued field in the worker pool field will be updated. Note that in order to update a field to the default value (zero, false, empty string) an explicit update_mask must be - // provided. + // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask + // If an empty update_mask is provided, only the non-default valued + // field in the worker pool field will be updated. Note that in order to + // update a field to the default value (zero, false, empty string) an + // explicit update_mask must be provided. UpdateMask string `json:"updateMask,omitempty"` // ForceSendFields is a list of field names (e.g. "Instance") to @@ -2324,8 +2327,11 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateInstanceRequest) Ma type GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateWorkerPoolRequest struct { // UpdateMask: The update mask applies to worker_pool. For the // `FieldMask` definition, see - // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If an empty update_mask is provided, only the non-default valued field in the worker pool field will be updated. Note that in order to update a field to the default value (zero, false, empty string) an explicit update_mask must be - // provided. + // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask + // If an empty update_mask is provided, only the non-default valued + // field in the worker pool field will be updated. Note that in order to + // update a field to the default value (zero, false, empty string) an + // explicit update_mask must be provided. UpdateMask string `json:"updateMask,omitempty"` // WorkerPool: Specifies the worker pool to update. @@ -3829,8 +3835,11 @@ func (c *ProjectsInstancesPatchCall) Name1(name1 string) *ProjectsInstancesPatch // UpdateMask sets the optional parameter "updateMask": The update mask // applies to instance. For the `FieldMask` definition, see -// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If an empty update_mask is provided, only the non-default valued field in the worker pool field will be updated. Note that in order to update a field to the default value (zero, false, empty string) an explicit update_mask must be -// provided. +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask +// If an empty update_mask is provided, only the non-default valued +// field in the worker pool field will be updated. Note that in order to +// update a field to the default value (zero, false, empty string) an +// explicit update_mask must be provided. func (c *ProjectsInstancesPatchCall) UpdateMask(updateMask string) *ProjectsInstancesPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/remotebuildexecution/v2/remotebuildexecution-gen.go b/remotebuildexecution/v2/remotebuildexecution-gen.go index 84689f7bac2..90e6aead44a 100644 --- a/remotebuildexecution/v2/remotebuildexecution-gen.go +++ b/remotebuildexecution/v2/remotebuildexecution-gen.go @@ -1874,8 +1874,8 @@ func (s *BuildBazelRemoteExecutionV2PriorityCapabilitiesPriorityRange) MarshalJS // `build.bazel.remote.execution.v2.requestmetadata-bin` * contents: the // base64 encoded binary `RequestMetadata` message. Note: the gRPC // library serializes binary headers encoded in base 64 by default -// (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#reques -// ts). Therefore, if the gRPC library is used to pass/retrieve this +// (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#requests). +// Therefore, if the gRPC library is used to pass/retrieve this // metadata, the user may ignore the base64 encoding and assume it is // simply serialized as a binary message. type BuildBazelRemoteExecutionV2RequestMetadata struct { @@ -3054,8 +3054,11 @@ type GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateInstanceRequest struct // UpdateMask: The update mask applies to instance. For the `FieldMask` // definition, see - // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If an empty update_mask is provided, only the non-default valued field in the worker pool field will be updated. Note that in order to update a field to the default value (zero, false, empty string) an explicit update_mask must be - // provided. + // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask + // If an empty update_mask is provided, only the non-default valued + // field in the worker pool field will be updated. Note that in order to + // update a field to the default value (zero, false, empty string) an + // explicit update_mask must be provided. UpdateMask string `json:"updateMask,omitempty"` // ForceSendFields is a list of field names (e.g. "Instance") to @@ -3086,8 +3089,11 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateInstanceRequest) Ma type GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateWorkerPoolRequest struct { // UpdateMask: The update mask applies to worker_pool. For the // `FieldMask` definition, see - // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If an empty update_mask is provided, only the non-default valued field in the worker pool field will be updated. Note that in order to update a field to the default value (zero, false, empty string) an explicit update_mask must be - // provided. + // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask + // If an empty update_mask is provided, only the non-default valued + // field in the worker pool field will be updated. Note that in order to + // update a field to the default value (zero, false, empty string) an + // explicit update_mask must be provided. UpdateMask string `json:"updateMask,omitempty"` // WorkerPool: Specifies the worker pool to update. diff --git a/run/v1/run-gen.go b/run/v1/run-gen.go index c8671131fac..03b48d56628 100644 --- a/run/v1/run-gen.go +++ b/run/v1/run-gen.go @@ -1397,8 +1397,9 @@ type GoogleCloudRunV1Condition struct { // Type: type is used to communicate the status of the reconciliation // process. See also: - // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting Types common to all resources include: * "Ready": True when the Resource is - // ready. + // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting + // Types common to all resources include: * "Ready": True when the + // Resource is ready. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "LastTransitionTime") @@ -2060,8 +2061,8 @@ type ObjectMeta struct { // found in the time allotted, and the client should retry (optionally // after the time indicated in the Retry-After header). Applied only if // Name is not specified. More info: - // https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency string generateName = - // 2; + // https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency + // string generateName = 2; GenerateName string `json:"generateName,omitempty"` // Generation: (Optional) A sequence number representing a specific @@ -2677,7 +2678,9 @@ func (s *RevisionTemplate) MarshalJSON() ([]byte, error) { // creating them; in these cases the Route is additionally responsible // for monitoring the Configuration for "latest ready" revision changes, // and smoothly rolling out latest revisions. See also: -// https://github.com/knative/serving/blob/master/docs/spec/overview.md#route Cloud Run currently supports referencing a single Configuration to automatically deploy the "latest ready" Revision from that +// https://github.com/knative/serving/blob/master/docs/spec/overview.md#route +// Cloud Run currently supports referencing a single Configuration to +// automatically deploy the "latest ready" Revision from that // Configuration. type Route struct { // ApiVersion: The API version for this call such as diff --git a/run/v1alpha1/run-gen.go b/run/v1alpha1/run-gen.go index 1c6d5faa3eb..87759e07582 100644 --- a/run/v1alpha1/run-gen.go +++ b/run/v1alpha1/run-gen.go @@ -1342,8 +1342,9 @@ type Condition struct { // Type: type is used to communicate the status of the reconciliation // process. See also: - // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting Types common to all resources include: * "Ready": True when the Resource is - // ready. + // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting + // Types common to all resources include: * "Ready": True when the + // Resource is ready. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "LastTransitionTime") @@ -1585,8 +1586,8 @@ type ConfigurationCondition struct { // Type: ConfigurationConditionType is used to communicate the status of // the reconciliation process. See also: - // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting Types - // include:"Ready" + // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting + // Types include:"Ready" Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "LastTransitionTime") @@ -1628,8 +1629,9 @@ type ConfigurationSpec struct { // Revision to be created when the spec doesn't otherwise change, a // nonce label may be provided in the template metadata. For more // details, see: - // https://github.com/knative/serving/blob/master/docs/client-conventions.md#associate-modifications-with-revisions Cloud Run does not currently support referencing a build that is responsible for materializing the container image from - // source. + // https://github.com/knative/serving/blob/master/docs/client-conventions.md#associate-modifications-with-revisions + // Cloud Run does not currently support referencing a build that is + // responsible for materializing the container image from source. RevisionTemplate *RevisionTemplate `json:"revisionTemplate,omitempty"` // Template: Template holds the latest specification for the Revision to @@ -3350,8 +3352,8 @@ type ObjectMeta struct { // the client should retry (optionally after the time indicated in the // Retry-After header). Applied only if Name is not specified. More // info: - // https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency +optional string generateName = - // 2; + // https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency + // +optional string generateName = 2; GenerateName string `json:"generateName,omitempty"` // Generation: A sequence number representing a specific generation of @@ -3913,7 +3915,11 @@ type RevisionCondition struct { // Type: RevisionConditionType is used to communicate the status of the // reconciliation process. See also: - // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting Types include: * "Ready": True when the Revision is ready. * "ResourcesAvailable": True when underlying resources have been provisioned. * "ContainerHealthy": True when the Revision readiness check completes. * "Active": True when the Revision may receive + // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting + // Types include: * "Ready": True when the Revision is ready. * + // "ResourcesAvailable": True when underlying resources have been + // provisioned. * "ContainerHealthy": True when the Revision readiness + // check completes. * "Active": True when the Revision may receive // traffic. Type string `json:"type,omitempty"` @@ -4135,7 +4141,9 @@ func (s *RevisionTemplate) MarshalJSON() ([]byte, error) { // creating them; in these cases the Route is additionally responsible // for monitoring the Configuration for "latest ready" revision changes, // and smoothly rolling out latest revisions. See also: -// https://github.com/knative/serving/blob/master/docs/spec/overview.md#route Cloud Run currently supports referencing a single Configuration to automatically deploy the "latest ready" Revision from that +// https://github.com/knative/serving/blob/master/docs/spec/overview.md#route +// Cloud Run currently supports referencing a single Configuration to +// automatically deploy the "latest ready" Revision from that // Configuration. type Route struct { // ApiVersion: The API version for this call such as @@ -4207,8 +4215,8 @@ type RouteCondition struct { // Type: RouteConditionType is used to communicate the status of the // reconciliation process. See also: - // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting Types include: - // "Ready". + // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting + // Types include: "Ready". Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "LastTransitionTime") @@ -4676,7 +4684,9 @@ type ServiceCondition struct { // Type: ServiceConditionType is used to communicate the status of the // reconciliation process. See also: - // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting Types include: "Ready", "ConfigurationsReady", and "RoutesReady". "Ready" will be true when the underlying Route and Configuration are + // https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting + // Types include: "Ready", "ConfigurationsReady", and "RoutesReady". + // "Ready" will be true when the underlying Route and Configuration are // ready. Type string `json:"type,omitempty"` diff --git a/run/v1beta1/run-gen.go b/run/v1beta1/run-gen.go index 03ab3e5201a..a919570a62e 100644 --- a/run/v1beta1/run-gen.go +++ b/run/v1beta1/run-gen.go @@ -214,8 +214,8 @@ type CustomResourceColumnDefinition struct { // Format: format is an optional OpenAPI type definition for this // column. The 'name' format is applied to the primary identifier column // to assist in clients identifying column is the resource name. See - // https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for more. - // +optional + // https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types + // for more. +optional Format string `json:"format,omitempty"` // JsonPath: JSONPath is a simple JSON path, i.e. with array notation. @@ -231,8 +231,8 @@ type CustomResourceColumnDefinition struct { Priority int64 `json:"priority,omitempty"` // Type: type is an OpenAPI type definition for this column. See - // https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for - // more. + // https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types + // for more. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -1034,8 +1034,8 @@ type ObjectMeta struct { // found in the time allotted, and the client should retry (optionally // after the time indicated in the Retry-After header). Applied only if // Name is not specified. More info: - // https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency string generateName = - // 2; + // https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency + // string generateName = 2; GenerateName string `json:"generateName,omitempty"` // Generation: (Optional) A sequence number representing a specific diff --git a/searchconsole/v1/searchconsole-gen.go b/searchconsole/v1/searchconsole-gen.go index bc60c9a653d..034a25ecd92 100644 --- a/searchconsole/v1/searchconsole-gen.go +++ b/searchconsole/v1/searchconsole-gen.go @@ -409,24 +409,19 @@ type MobileFriendlyIssue struct { // (https://support.google.com/webmasters/answer/6352293#flash_usage). // "CONFIGURE_VIEWPORT" - Viewsport is not specified using the meta // viewport tag. [Learn more] - // (https://support.google.com/webmasters/answer/6352293#viewport_not_con - // figured). + // (https://support.google.com/webmasters/answer/6352293#viewport_not_configured). // "FIXED_WIDTH_VIEWPORT" - Viewport defined to a fixed width. [Learn // more] - // (https://support.google.com/webmasters/answer/6352293#fixed-width_view - // port). + // (https://support.google.com/webmasters/answer/6352293#fixed-width_viewport). // "SIZE_CONTENT_TO_VIEWPORT" - Content not sized to viewport. [Learn // more] - // (https://support.google.com/webmasters/answer/6352293#content_not_size - // d_to_viewport). + // (https://support.google.com/webmasters/answer/6352293#content_not_sized_to_viewport). // "USE_LEGIBLE_FONT_SIZES" - Font size is too small for easy reading // on a small screen. [Learn More] - // (https://support.google.com/webmasters/answer/6352293#small_font_size) - // . + // (https://support.google.com/webmasters/answer/6352293#small_font_size). // "TAP_TARGETS_TOO_CLOSE" - Touch elements are too close to each // other. [Learn more] - // (https://support.google.com/webmasters/answer/6352293#touch_elements_t - // oo_close). + // (https://support.google.com/webmasters/answer/6352293#touch_elements_too_close). Rule string `json:"rule,omitempty"` // ForceSendFields is a list of field names (e.g. "Rule") to diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index fcd72be2b15..3dd066504d6 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -317,8 +317,8 @@ type Asset struct { IamPolicy *IamPolicy `json:"iamPolicy,omitempty"` // Name: The relative resource name of this asset. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: - // "organizations/{organization_id}/assets/{asset_id}". + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: "organizations/{organization_id}/assets/{asset_id}". Name string `json:"name,omitempty"` // ResourceProperties: Resource managed properties. These properties are @@ -681,21 +681,25 @@ type Finding struct { ExternalUri string `json:"externalUri,omitempty"` // Name: The relative resource name of this finding. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}" Name string `json:"name,omitempty"` // Parent: The relative resource name of the source the finding belongs // to. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // This field is immutable after creation time. For example: // "organizations/{organization_id}/sources/{source_id}" Parent string `json:"parent,omitempty"` // ResourceName: For findings on Google Cloud resources, the full // resource name of the Google Cloud resource this finding is for. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name When the finding is for a non-Google Cloud resource, the resourceName can be a customer or partner defined string. This field is immutable after creation - // time. + // https://cloud.google.com/apis/design/resource_names#full_resource_name + // When the finding is for a non-Google Cloud resource, the resourceName + // can be a customer or partner defined string. This field is immutable + // after creation time. ResourceName string `json:"resourceName,omitempty"` // SecurityMarks: Output only. User specified security marks. These @@ -1088,21 +1092,25 @@ type GoogleCloudSecuritycenterV1p1beta1Finding struct { ExternalUri string `json:"externalUri,omitempty"` // Name: The relative resource name of this finding. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}" Name string `json:"name,omitempty"` // Parent: The relative resource name of the source the finding belongs // to. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // This field is immutable after creation time. For example: // "organizations/{organization_id}/sources/{source_id}" Parent string `json:"parent,omitempty"` // ResourceName: For findings on Google Cloud resources, the full // resource name of the Google Cloud resource this finding is for. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name When the finding is for a non-Google Cloud resource, the resourceName can be a customer or partner defined string. This field is immutable after creation - // time. + // https://cloud.google.com/apis/design/resource_names#full_resource_name + // When the finding is for a non-Google Cloud resource, the resourceName + // can be a customer or partner defined string. This field is immutable + // after creation time. ResourceName string `json:"resourceName,omitempty"` // SecurityMarks: Output only. User specified security marks. These @@ -1337,7 +1345,9 @@ type GoogleCloudSecuritycenterV1p1beta1SecurityMarks struct { Marks map[string]string `json:"marks,omitempty"` // Name: The relative resource name of the SecurityMarks. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Examples: + // "organizations/{organization_id}/assets/{asset_id}/securityMarks" // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}/securityMarks". Name string `json:"name,omitempty"` @@ -2028,7 +2038,8 @@ type NotificationConfig struct { Description string `json:"description,omitempty"` // Name: The relative resource name of this notification config. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: // "organizations/{organization_id}/notificationConfigs/notify_public_buc // ket". Name string `json:"name,omitempty"` @@ -2148,8 +2159,8 @@ type OrganizationSettings struct { EnableAssetDiscovery bool `json:"enableAssetDiscovery,omitempty"` // Name: The relative resource name of the settings. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: - // "organizations/{organization_id}/organizationSettings". + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: "organizations/{organization_id}/organizationSettings". Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2422,7 +2433,9 @@ type SecurityMarks struct { Marks map[string]string `json:"marks,omitempty"` // Name: The relative resource name of the SecurityMarks. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Examples: + // "organizations/{organization_id}/assets/{asset_id}/securityMarks" // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}/securityMarks". Name string `json:"name,omitempty"` @@ -2551,8 +2564,8 @@ type Source struct { DisplayName string `json:"displayName,omitempty"` // Name: The relative resource name of this source. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: - // "organizations/{organization_id}/sources/{source_id}" + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: "organizations/{organization_id}/sources/{source_id}" Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index 49aeadc6fbb..000b325a5ef 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -203,8 +203,8 @@ type Asset struct { CreateTime string `json:"createTime,omitempty"` // Name: The relative resource name of this asset. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: - // "organizations/{organization_id}/assets/{asset_id}". + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: "organizations/{organization_id}/assets/{asset_id}". Name string `json:"name,omitempty"` // ResourceProperties: Resource managed properties. These properties are @@ -568,21 +568,25 @@ type Finding struct { ExternalUri string `json:"externalUri,omitempty"` // Name: The relative resource name of this finding. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}" Name string `json:"name,omitempty"` // Parent: The relative resource name of the source the finding belongs // to. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // This field is immutable after creation time. For example: // "organizations/{organization_id}/sources/{source_id}" Parent string `json:"parent,omitempty"` // ResourceName: For findings on Google Cloud resources, the full // resource name of the Google Cloud resource this finding is for. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name When the finding is for a non-Google Cloud resource, the resourceName can be a customer or partner defined string. This field is immutable after creation - // time. + // https://cloud.google.com/apis/design/resource_names#full_resource_name + // When the finding is for a non-Google Cloud resource, the resourceName + // can be a customer or partner defined string. This field is immutable + // after creation time. ResourceName string `json:"resourceName,omitempty"` // SecurityMarks: Output only. User specified security marks. These @@ -931,21 +935,25 @@ type GoogleCloudSecuritycenterV1beta1Finding struct { ExternalUri string `json:"externalUri,omitempty"` // Name: The relative resource name of this finding. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}" Name string `json:"name,omitempty"` // Parent: Immutable. The relative resource name of the source the // finding belongs to. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // This field is immutable after creation time. For example: // "organizations/{organization_id}/sources/{source_id}" Parent string `json:"parent,omitempty"` // ResourceName: For findings on Google Cloud resources, the full // resource name of the Google Cloud resource this finding is for. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name When the finding is for a non-Google Cloud resource, the resourceName can be a customer or partner defined string. This field is immutable after creation - // time. + // https://cloud.google.com/apis/design/resource_names#full_resource_name + // When the finding is for a non-Google Cloud resource, the resourceName + // can be a customer or partner defined string. This field is immutable + // after creation time. ResourceName string `json:"resourceName,omitempty"` // SecurityMarks: Output only. User specified security marks. These @@ -1052,7 +1060,9 @@ type GoogleCloudSecuritycenterV1beta1SecurityMarks struct { Marks map[string]string `json:"marks,omitempty"` // Name: The relative resource name of the SecurityMarks. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Examples: + // "organizations/{organization_id}/assets/{asset_id}/securityMarks" // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}/securityMarks". Name string `json:"name,omitempty"` @@ -1115,21 +1125,25 @@ type GoogleCloudSecuritycenterV1p1beta1Finding struct { ExternalUri string `json:"externalUri,omitempty"` // Name: The relative resource name of this finding. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}" Name string `json:"name,omitempty"` // Parent: The relative resource name of the source the finding belongs // to. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // This field is immutable after creation time. For example: // "organizations/{organization_id}/sources/{source_id}" Parent string `json:"parent,omitempty"` // ResourceName: For findings on Google Cloud resources, the full // resource name of the Google Cloud resource this finding is for. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name When the finding is for a non-Google Cloud resource, the resourceName can be a customer or partner defined string. This field is immutable after creation - // time. + // https://cloud.google.com/apis/design/resource_names#full_resource_name + // When the finding is for a non-Google Cloud resource, the resourceName + // can be a customer or partner defined string. This field is immutable + // after creation time. ResourceName string `json:"resourceName,omitempty"` // SecurityMarks: Output only. User specified security marks. These @@ -1364,7 +1378,9 @@ type GoogleCloudSecuritycenterV1p1beta1SecurityMarks struct { Marks map[string]string `json:"marks,omitempty"` // Name: The relative resource name of the SecurityMarks. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Examples: + // "organizations/{organization_id}/assets/{asset_id}/securityMarks" // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}/securityMarks". Name string `json:"name,omitempty"` @@ -1930,8 +1946,8 @@ type OrganizationSettings struct { EnableAssetDiscovery bool `json:"enableAssetDiscovery,omitempty"` // Name: The relative resource name of the settings. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: - // "organizations/{organization_id}/organizationSettings". + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: "organizations/{organization_id}/organizationSettings". Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2139,7 +2155,9 @@ type SecurityMarks struct { Marks map[string]string `json:"marks,omitempty"` // Name: The relative resource name of the SecurityMarks. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Examples: + // "organizations/{organization_id}/assets/{asset_id}/securityMarks" // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}/securityMarks". Name string `json:"name,omitempty"` @@ -2264,8 +2282,8 @@ type Source struct { DisplayName string `json:"displayName,omitempty"` // Name: The relative resource name of this source. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: - // "organizations/{organization_id}/sources/{source_id}" + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: "organizations/{organization_id}/sources/{source_id}" Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/securitycenter/v1beta2/securitycenter-gen.go b/securitycenter/v1beta2/securitycenter-gen.go index 592090e2eca..c6b38d78def 100644 --- a/securitycenter/v1beta2/securitycenter-gen.go +++ b/securitycenter/v1beta2/securitycenter-gen.go @@ -582,21 +582,25 @@ type Finding struct { ExternalUri string `json:"externalUri,omitempty"` // Name: The relative resource name of this finding. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}" Name string `json:"name,omitempty"` // Parent: The relative resource name of the source the finding belongs // to. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // This field is immutable after creation time. For example: // "organizations/{organization_id}/sources/{source_id}" Parent string `json:"parent,omitempty"` // ResourceName: For findings on Google Cloud resources, the full // resource name of the Google Cloud resource this finding is for. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name When the finding is for a non-Google Cloud resource, the resourceName can be a customer or partner defined string. This field is immutable after creation - // time. + // https://cloud.google.com/apis/design/resource_names#full_resource_name + // When the finding is for a non-Google Cloud resource, the resourceName + // can be a customer or partner defined string. This field is immutable + // after creation time. ResourceName string `json:"resourceName,omitempty"` // SecurityMarks: Output only. User specified security marks. These @@ -919,21 +923,25 @@ type GoogleCloudSecuritycenterV1p1beta1Finding struct { ExternalUri string `json:"externalUri,omitempty"` // Name: The relative resource name of this finding. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Example: // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}" Name string `json:"name,omitempty"` // Parent: The relative resource name of the source the finding belongs // to. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // This field is immutable after creation time. For example: // "organizations/{organization_id}/sources/{source_id}" Parent string `json:"parent,omitempty"` // ResourceName: For findings on Google Cloud resources, the full // resource name of the Google Cloud resource this finding is for. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name When the finding is for a non-Google Cloud resource, the resourceName can be a customer or partner defined string. This field is immutable after creation - // time. + // https://cloud.google.com/apis/design/resource_names#full_resource_name + // When the finding is for a non-Google Cloud resource, the resourceName + // can be a customer or partner defined string. This field is immutable + // after creation time. ResourceName string `json:"resourceName,omitempty"` // SecurityMarks: Output only. User specified security marks. These @@ -1168,7 +1176,9 @@ type GoogleCloudSecuritycenterV1p1beta1SecurityMarks struct { Marks map[string]string `json:"marks,omitempty"` // Name: The relative resource name of the SecurityMarks. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Examples: + // "organizations/{organization_id}/assets/{asset_id}/securityMarks" // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}/securityMarks". Name string `json:"name,omitempty"` @@ -1319,7 +1329,9 @@ type SecurityMarks struct { Marks map[string]string `json:"marks,omitempty"` // Name: The relative resource name of the SecurityMarks. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" + // https://cloud.google.com/apis/design/resource_names#relative_resource_name + // Examples: + // "organizations/{organization_id}/assets/{asset_id}/securityMarks" // "organizations/{organization_id}/sources/{source_id}/findings/{finding // _id}/securityMarks". Name string `json:"name,omitempty"` diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go index 9dcc2bb4df9..ed229a98079 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go @@ -356,14 +356,16 @@ func (s *AttachTenantProjectRequest) MarshalJSON() ([]byte, error) { // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { // Audiences: The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, JWTs with - // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, JWTs with audiences: - + // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - - // https://library-example.googleapis.com/google.example.library.v1.LibraryService - https://library-example.googleapis.com/ Example: audiences: bookstore_android.apps.googleusercontent.com, + // https://library-example.googleapis.com/google.example.library.v1.LibraryService + // - https://library-example.googleapis.com/ Example: audiences: + // bookstore_android.apps.googleusercontent.com, // bookstore_web.apps.googleusercontent.com Audiences string `json:"audiences,omitempty"` @@ -377,15 +379,17 @@ type AuthProvider struct { Id string `json:"id,omitempty"` // Issuer: Identifies the principal that issued the JWT. See - // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 Usually a URL or an email address. Example: https://securetoken.google.com Example: + // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 + // Usually a URL or an email address. Example: + // https://securetoken.google.com Example: // 1234567-compute@developer.gserviceaccount.com Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature // of the JWT. See OpenID Discovery - // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe - // tadata). Optional if the key set document: - can be retrieved from - // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata). + // Optional if the key set document: - can be retrieved from OpenID + // Discovery // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the // issuer. - can be inferred from the email domain of the issuer (e.g. a // Google service account). Example: @@ -433,10 +437,10 @@ type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime // components. The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, only JWTs - // with audience "https://Service_name/API_name" will be accepted. For + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, only JWTs with + // audience "https://Service_name/API_name" will be accepted. For // example, if no audiences are in the setting, LibraryService API will // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr @@ -639,7 +643,9 @@ type BackendRule struct { // https://example.cloudfunctions.net/getUser Requests to the following // request paths will call the backend at the translated path: Request // path: /api/company/widgetworks/user/johndoe Translated: - // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe Request path: /api/company/widgetworks/user/johndoe?timezone=EST Translated: + // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe + // Request path: /api/company/widgetworks/user/johndoe?timezone=EST + // Translated: // https://example.cloudfunctions.net/getUser?timezone=EST&cid=widgetworks&uid=johndoe // "APPEND_PATH_TO_ADDRESS" - The request path will be appended to the // backend address. # Examples Given the following operation config: @@ -661,8 +667,8 @@ type BackendRule struct { // for improved performance. Configuring this field to non-default // values is only supported for secure HTTP backends. This field will be // ignored for all other backends. See - // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids for more details on the supported - // values. + // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids + // for more details on the supported values. Protocol string `json:"protocol,omitempty"` // Selector: Selects the methods to which this rule applies. Refer to diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index 1248e69d326..9cae9bf8b12 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -271,14 +271,16 @@ func (s *Api) MarshalJSON() ([]byte, error) { // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { // Audiences: The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, JWTs with - // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, JWTs with audiences: - + // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - - // https://library-example.googleapis.com/google.example.library.v1.LibraryService - https://library-example.googleapis.com/ Example: audiences: bookstore_android.apps.googleusercontent.com, + // https://library-example.googleapis.com/google.example.library.v1.LibraryService + // - https://library-example.googleapis.com/ Example: audiences: + // bookstore_android.apps.googleusercontent.com, // bookstore_web.apps.googleusercontent.com Audiences string `json:"audiences,omitempty"` @@ -292,15 +294,17 @@ type AuthProvider struct { Id string `json:"id,omitempty"` // Issuer: Identifies the principal that issued the JWT. See - // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 Usually a URL or an email address. Example: https://securetoken.google.com Example: + // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 + // Usually a URL or an email address. Example: + // https://securetoken.google.com Example: // 1234567-compute@developer.gserviceaccount.com Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature // of the JWT. See OpenID Discovery - // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe - // tadata). Optional if the key set document: - can be retrieved from - // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata). + // Optional if the key set document: - can be retrieved from OpenID + // Discovery // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the // issuer. - can be inferred from the email domain of the issuer (e.g. a // Google service account). Example: @@ -348,10 +352,10 @@ type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime // components. The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, only JWTs - // with audience "https://Service_name/API_name" will be accepted. For + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, only JWTs with + // audience "https://Service_name/API_name" will be accepted. For // example, if no audiences are in the setting, LibraryService API will // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr @@ -554,7 +558,9 @@ type BackendRule struct { // https://example.cloudfunctions.net/getUser Requests to the following // request paths will call the backend at the translated path: Request // path: /api/company/widgetworks/user/johndoe Translated: - // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe Request path: /api/company/widgetworks/user/johndoe?timezone=EST Translated: + // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe + // Request path: /api/company/widgetworks/user/johndoe?timezone=EST + // Translated: // https://example.cloudfunctions.net/getUser?timezone=EST&cid=widgetworks&uid=johndoe // "APPEND_PATH_TO_ADDRESS" - The request path will be appended to the // backend address. # Examples Given the following operation config: @@ -576,8 +582,8 @@ type BackendRule struct { // for improved performance. Configuring this field to non-default // values is only supported for secure HTTP backends. This field will be // ignored for all other backends. See - // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids for more details on the supported - // values. + // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids + // for more details on the supported values. Protocol string `json:"protocol,omitempty"` // Selector: Selects the methods to which this rule applies. Refer to diff --git a/servicecontrol/v1/servicecontrol-gen.go b/servicecontrol/v1/servicecontrol-gen.go index 05d6e5802b7..55b98bbff26 100644 --- a/servicecontrol/v1/servicecontrol-gen.go +++ b/servicecontrol/v1/servicecontrol-gen.go @@ -2310,8 +2310,8 @@ type Request struct { // Protocol: The network protocol used with the request, such as // "http/1.1", "spdy/3", "h2", "h2c", "webrtc", "tcp", "udp", "quic". // See - // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids for - // details. + // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids + // for details. Protocol string `json:"protocol,omitempty"` // Query: The HTTP URL query in the format of diff --git a/servicecontrol/v2/servicecontrol-gen.go b/servicecontrol/v2/servicecontrol-gen.go index 0ae3293b0d3..6f136fa2616 100644 --- a/servicecontrol/v2/servicecontrol-gen.go +++ b/servicecontrol/v2/servicecontrol-gen.go @@ -785,8 +785,8 @@ type Request struct { // Protocol: The network protocol used with the request, such as // "http/1.1", "spdy/3", "h2", "h2c", "webrtc", "tcp", "udp", "quic". // See - // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids for - // details. + // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids + // for details. Protocol string `json:"protocol,omitempty"` // Query: The HTTP URL query in the format of @@ -1290,8 +1290,7 @@ type ServicesCheckCall struct { // must call the Check method multiple times. This method requires the // `servicemanagement.services.check` permission on the specified // service. For more information, see Service Control API Access Control -// (https://cloud.google.com/service-infrastructure/docs/service-control/ -// access-control). +// (https://cloud.google.com/service-infrastructure/docs/service-control/access-control). func (r *ServicesService) Check(serviceName string, checkrequest *CheckRequest) *ServicesCheckCall { c := &ServicesCheckCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -1443,8 +1442,7 @@ type ServicesReportCall struct { // per call. This method requires the // `servicemanagement.services.report` permission on the specified // service. For more information, see Service Control API Access Control -// (https://cloud.google.com/service-infrastructure/docs/service-control/ -// access-control). +// (https://cloud.google.com/service-infrastructure/docs/service-control/access-control). func (r *ServicesService) Report(serviceName string, reportrequest *ReportRequest) *ServicesReportCall { c := &ServicesReportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName diff --git a/servicemanagement/v1/servicemanagement-gen.go b/servicemanagement/v1/servicemanagement-gen.go index 173090fcd32..f7c0f61874f 100644 --- a/servicemanagement/v1/servicemanagement-gen.go +++ b/servicemanagement/v1/servicemanagement-gen.go @@ -414,14 +414,16 @@ func (s *AuditLogConfig) MarshalJSON() ([]byte, error) { // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { // Audiences: The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, JWTs with - // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, JWTs with audiences: - + // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - - // https://library-example.googleapis.com/google.example.library.v1.LibraryService - https://library-example.googleapis.com/ Example: audiences: bookstore_android.apps.googleusercontent.com, + // https://library-example.googleapis.com/google.example.library.v1.LibraryService + // - https://library-example.googleapis.com/ Example: audiences: + // bookstore_android.apps.googleusercontent.com, // bookstore_web.apps.googleusercontent.com Audiences string `json:"audiences,omitempty"` @@ -435,15 +437,17 @@ type AuthProvider struct { Id string `json:"id,omitempty"` // Issuer: Identifies the principal that issued the JWT. See - // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 Usually a URL or an email address. Example: https://securetoken.google.com Example: + // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 + // Usually a URL or an email address. Example: + // https://securetoken.google.com Example: // 1234567-compute@developer.gserviceaccount.com Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature // of the JWT. See OpenID Discovery - // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe - // tadata). Optional if the key set document: - can be retrieved from - // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata). + // Optional if the key set document: - can be retrieved from OpenID + // Discovery // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the // issuer. - can be inferred from the email domain of the issuer (e.g. a // Google service account). Example: @@ -491,10 +495,10 @@ type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime // components. The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, only JWTs - // with audience "https://Service_name/API_name" will be accepted. For + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, only JWTs with + // audience "https://Service_name/API_name" will be accepted. For // example, if no audiences are in the setting, LibraryService API will // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr @@ -697,7 +701,9 @@ type BackendRule struct { // https://example.cloudfunctions.net/getUser Requests to the following // request paths will call the backend at the translated path: Request // path: /api/company/widgetworks/user/johndoe Translated: - // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe Request path: /api/company/widgetworks/user/johndoe?timezone=EST Translated: + // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe + // Request path: /api/company/widgetworks/user/johndoe?timezone=EST + // Translated: // https://example.cloudfunctions.net/getUser?timezone=EST&cid=widgetworks&uid=johndoe // "APPEND_PATH_TO_ADDRESS" - The request path will be appended to the // backend address. # Examples Given the following operation config: @@ -719,8 +725,8 @@ type BackendRule struct { // for improved performance. Configuring this field to non-default // values is only supported for secure HTTP backends. This field will be // ignored for all other backends. See - // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids for more details on the supported - // values. + // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids + // for more details on the supported values. Protocol string `json:"protocol,omitempty"` // Selector: Selects the methods to which this rule applies. Refer to diff --git a/servicenetworking/v1/servicenetworking-gen.go b/servicenetworking/v1/servicenetworking-gen.go index a27f5814305..a260c0ed6e8 100644 --- a/servicenetworking/v1/servicenetworking-gen.go +++ b/servicenetworking/v1/servicenetworking-gen.go @@ -627,14 +627,16 @@ func (s *Api) MarshalJSON() ([]byte, error) { // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { // Audiences: The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, JWTs with - // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, JWTs with audiences: - + // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - - // https://library-example.googleapis.com/google.example.library.v1.LibraryService - https://library-example.googleapis.com/ Example: audiences: bookstore_android.apps.googleusercontent.com, + // https://library-example.googleapis.com/google.example.library.v1.LibraryService + // - https://library-example.googleapis.com/ Example: audiences: + // bookstore_android.apps.googleusercontent.com, // bookstore_web.apps.googleusercontent.com Audiences string `json:"audiences,omitempty"` @@ -648,15 +650,17 @@ type AuthProvider struct { Id string `json:"id,omitempty"` // Issuer: Identifies the principal that issued the JWT. See - // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 Usually a URL or an email address. Example: https://securetoken.google.com Example: + // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 + // Usually a URL or an email address. Example: + // https://securetoken.google.com Example: // 1234567-compute@developer.gserviceaccount.com Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature // of the JWT. See OpenID Discovery - // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe - // tadata). Optional if the key set document: - can be retrieved from - // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata). + // Optional if the key set document: - can be retrieved from OpenID + // Discovery // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the // issuer. - can be inferred from the email domain of the issuer (e.g. a // Google service account). Example: @@ -704,10 +708,10 @@ type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime // components. The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, only JWTs - // with audience "https://Service_name/API_name" will be accepted. For + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, only JWTs with + // audience "https://Service_name/API_name" will be accepted. For // example, if no audiences are in the setting, LibraryService API will // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr @@ -910,7 +914,9 @@ type BackendRule struct { // https://example.cloudfunctions.net/getUser Requests to the following // request paths will call the backend at the translated path: Request // path: /api/company/widgetworks/user/johndoe Translated: - // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe Request path: /api/company/widgetworks/user/johndoe?timezone=EST Translated: + // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe + // Request path: /api/company/widgetworks/user/johndoe?timezone=EST + // Translated: // https://example.cloudfunctions.net/getUser?timezone=EST&cid=widgetworks&uid=johndoe // "APPEND_PATH_TO_ADDRESS" - The request path will be appended to the // backend address. # Examples Given the following operation config: @@ -932,8 +938,8 @@ type BackendRule struct { // for improved performance. Configuring this field to non-default // values is only supported for secure HTTP backends. This field will be // ignored for all other backends. See - // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids for more details on the supported - // values. + // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids + // for more details on the supported values. Protocol string `json:"protocol,omitempty"` // Selector: Selects the methods to which this rule applies. Refer to diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go index fac0f02ec2a..a086755009a 100644 --- a/servicenetworking/v1beta/servicenetworking-gen.go +++ b/servicenetworking/v1beta/servicenetworking-gen.go @@ -409,14 +409,16 @@ func (s *Api) MarshalJSON() ([]byte, error) { // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { // Audiences: The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, JWTs with - // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, JWTs with audiences: - + // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - - // https://library-example.googleapis.com/google.example.library.v1.LibraryService - https://library-example.googleapis.com/ Example: audiences: bookstore_android.apps.googleusercontent.com, + // https://library-example.googleapis.com/google.example.library.v1.LibraryService + // - https://library-example.googleapis.com/ Example: audiences: + // bookstore_android.apps.googleusercontent.com, // bookstore_web.apps.googleusercontent.com Audiences string `json:"audiences,omitempty"` @@ -430,15 +432,17 @@ type AuthProvider struct { Id string `json:"id,omitempty"` // Issuer: Identifies the principal that issued the JWT. See - // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 Usually a URL or an email address. Example: https://securetoken.google.com Example: + // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 + // Usually a URL or an email address. Example: + // https://securetoken.google.com Example: // 1234567-compute@developer.gserviceaccount.com Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature // of the JWT. See OpenID Discovery - // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe - // tadata). Optional if the key set document: - can be retrieved from - // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata). + // Optional if the key set document: - can be retrieved from OpenID + // Discovery // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the // issuer. - can be inferred from the email domain of the issuer (e.g. a // Google service account). Example: @@ -486,10 +490,10 @@ type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime // components. The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, only JWTs - // with audience "https://Service_name/API_name" will be accepted. For + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, only JWTs with + // audience "https://Service_name/API_name" will be accepted. For // example, if no audiences are in the setting, LibraryService API will // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr @@ -692,7 +696,9 @@ type BackendRule struct { // https://example.cloudfunctions.net/getUser Requests to the following // request paths will call the backend at the translated path: Request // path: /api/company/widgetworks/user/johndoe Translated: - // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe Request path: /api/company/widgetworks/user/johndoe?timezone=EST Translated: + // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe + // Request path: /api/company/widgetworks/user/johndoe?timezone=EST + // Translated: // https://example.cloudfunctions.net/getUser?timezone=EST&cid=widgetworks&uid=johndoe // "APPEND_PATH_TO_ADDRESS" - The request path will be appended to the // backend address. # Examples Given the following operation config: @@ -714,8 +720,8 @@ type BackendRule struct { // for improved performance. Configuring this field to non-default // values is only supported for secure HTTP backends. This field will be // ignored for all other backends. See - // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids for more details on the supported - // values. + // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids + // for more details on the supported values. Protocol string `json:"protocol,omitempty"` // Selector: Selects the methods to which this rule applies. Refer to diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index f43041c3dd6..8b52a8360e9 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -308,14 +308,16 @@ func (s *Api) MarshalJSON() ([]byte, error) { // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { // Audiences: The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, JWTs with - // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, JWTs with audiences: - + // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - - // https://library-example.googleapis.com/google.example.library.v1.LibraryService - https://library-example.googleapis.com/ Example: audiences: bookstore_android.apps.googleusercontent.com, + // https://library-example.googleapis.com/google.example.library.v1.LibraryService + // - https://library-example.googleapis.com/ Example: audiences: + // bookstore_android.apps.googleusercontent.com, // bookstore_web.apps.googleusercontent.com Audiences string `json:"audiences,omitempty"` @@ -329,15 +331,17 @@ type AuthProvider struct { Id string `json:"id,omitempty"` // Issuer: Identifies the principal that issued the JWT. See - // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 Usually a URL or an email address. Example: https://securetoken.google.com Example: + // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 + // Usually a URL or an email address. Example: + // https://securetoken.google.com Example: // 1234567-compute@developer.gserviceaccount.com Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature // of the JWT. See OpenID Discovery - // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe - // tadata). Optional if the key set document: - can be retrieved from - // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata). + // Optional if the key set document: - can be retrieved from OpenID + // Discovery // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the // issuer. - can be inferred from the email domain of the issuer (e.g. a // Google service account). Example: @@ -385,10 +389,10 @@ type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime // components. The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, only JWTs - // with audience "https://Service_name/API_name" will be accepted. For + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, only JWTs with + // audience "https://Service_name/API_name" will be accepted. For // example, if no audiences are in the setting, LibraryService API will // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr @@ -591,7 +595,9 @@ type BackendRule struct { // https://example.cloudfunctions.net/getUser Requests to the following // request paths will call the backend at the translated path: Request // path: /api/company/widgetworks/user/johndoe Translated: - // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe Request path: /api/company/widgetworks/user/johndoe?timezone=EST Translated: + // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe + // Request path: /api/company/widgetworks/user/johndoe?timezone=EST + // Translated: // https://example.cloudfunctions.net/getUser?timezone=EST&cid=widgetworks&uid=johndoe // "APPEND_PATH_TO_ADDRESS" - The request path will be appended to the // backend address. # Examples Given the following operation config: @@ -613,8 +619,8 @@ type BackendRule struct { // for improved performance. Configuring this field to non-default // values is only supported for secure HTTP backends. This field will be // ignored for all other backends. See - // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids for more details on the supported - // values. + // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids + // for more details on the supported values. Protocol string `json:"protocol,omitempty"` // Selector: Selects the methods to which this rule applies. Refer to diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index 4fb9230b15f..ffd4cf1dac6 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -356,14 +356,16 @@ func (s *Api) MarshalJSON() ([]byte, error) { // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). type AuthProvider struct { // Audiences: The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, JWTs with - // audiences: - "https://[service.name]/[google.protobuf.Api.name]" - + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, JWTs with audiences: - + // "https://[service.name]/[google.protobuf.Api.name]" - // "https://[service.name]/" will be accepted. For example, if no // audiences are in the setting, LibraryService API will accept JWTs // with the following audiences: - - // https://library-example.googleapis.com/google.example.library.v1.LibraryService - https://library-example.googleapis.com/ Example: audiences: bookstore_android.apps.googleusercontent.com, + // https://library-example.googleapis.com/google.example.library.v1.LibraryService + // - https://library-example.googleapis.com/ Example: audiences: + // bookstore_android.apps.googleusercontent.com, // bookstore_web.apps.googleusercontent.com Audiences string `json:"audiences,omitempty"` @@ -377,15 +379,17 @@ type AuthProvider struct { Id string `json:"id,omitempty"` // Issuer: Identifies the principal that issued the JWT. See - // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 Usually a URL or an email address. Example: https://securetoken.google.com Example: + // https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1 + // Usually a URL or an email address. Example: + // https://securetoken.google.com Example: // 1234567-compute@developer.gserviceaccount.com Issuer string `json:"issuer,omitempty"` // JwksUri: URL of the provider's public key set to validate signature // of the JWT. See OpenID Discovery - // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMe - // tadata). Optional if the key set document: - can be retrieved from - // OpenID Discovery + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata). + // Optional if the key set document: - can be retrieved from OpenID + // Discovery // (https://openid.net/specs/openid-connect-discovery-1_0.html) of the // issuer. - can be inferred from the email domain of the issuer (e.g. a // Google service account). Example: @@ -433,10 +437,10 @@ type AuthRequirement struct { // Audiences: NOTE: This will be deprecated soon, once // AuthProvider.audiences is implemented and accepted in all the runtime // components. The list of JWT audiences - // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#sectio - // n-4.1.3). that are allowed to access. A JWT containing any of these - // audiences will be accepted. When this setting is absent, only JWTs - // with audience "https://Service_name/API_name" will be accepted. For + // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). + // that are allowed to access. A JWT containing any of these audiences + // will be accepted. When this setting is absent, only JWTs with + // audience "https://Service_name/API_name" will be accepted. For // example, if no audiences are in the setting, LibraryService API will // only accept JWTs with the following audience // "https://library-example.googleapis.com/google.example.library.v1.Libr @@ -639,7 +643,9 @@ type BackendRule struct { // https://example.cloudfunctions.net/getUser Requests to the following // request paths will call the backend at the translated path: Request // path: /api/company/widgetworks/user/johndoe Translated: - // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe Request path: /api/company/widgetworks/user/johndoe?timezone=EST Translated: + // https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe + // Request path: /api/company/widgetworks/user/johndoe?timezone=EST + // Translated: // https://example.cloudfunctions.net/getUser?timezone=EST&cid=widgetworks&uid=johndoe // "APPEND_PATH_TO_ADDRESS" - The request path will be appended to the // backend address. # Examples Given the following operation config: @@ -661,8 +667,8 @@ type BackendRule struct { // for improved performance. Configuring this field to non-default // values is only supported for secure HTTP backends. This field will be // ignored for all other backends. See - // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids for more details on the supported - // values. + // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids + // for more details on the supported values. Protocol string `json:"protocol,omitempty"` // Selector: Selects the methods to which this rule applies. Refer to diff --git a/sheets/v4/sheets-gen.go b/sheets/v4/sheets-gen.go index 6d757a110f0..0246f8f06e1 100644 --- a/sheets/v4/sheets-gen.go +++ b/sheets/v4/sheets-gen.go @@ -4519,8 +4519,7 @@ func (s *DataSourceObjectReferences) MarshalJSON() ([]byte, error) { type DataSourceParameter struct { // Name: Named parameter. Must be a legitimate identifier for the // DataSource that supports it. For example, BigQuery identifier - // (https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical - // #identifiers). + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#identifiers). Name string `json:"name,omitempty"` // NamedRangeId: ID of a NamedRange. Its size must be 1x1. @@ -6444,8 +6443,12 @@ type FindReplaceRequest struct { // SearchByRegex: True if the find value is a regex. The regular // expression and replacement should follow Java regex rules at - // https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. The replacement string is allowed to refer to capturing groups. For example, if one cell has the contents "Google Sheets" and another has "Google Docs", then searching for "o.* (.*)" with a replacement of "$1 Rocks" would change the contents of the cells to "GSheets Rocks" and "GDocs Rocks" - // respectively. + // https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. + // The replacement string is allowed to refer to capturing groups. For + // example, if one cell has the contents "Google Sheets" and another + // has "Google Docs", then searching for "o.* (.*)" with a + // replacement of "$1 Rocks" would change the contents of the cells to + // "GSheets Rocks" and "GDocs Rocks" respectively. SearchByRegex bool `json:"searchByRegex,omitempty"` // SheetId: The sheet to find/replace over. diff --git a/slides/v1/slides-gen.go b/slides/v1/slides-gen.go index 3bbc49723ec..075732954b7 100644 --- a/slides/v1/slides-gen.go +++ b/slides/v1/slides-gen.go @@ -2423,9 +2423,9 @@ type LineConnection struct { // DrawingML Shape and Text Geometries" of "Office Open XML File // Formats-Fundamentals and Markup Language Reference", part 1 of // [ECMA-376 5th edition] - // (http://www.ecma-international.org/publications/standards/Ecma-376.htm - // ). The position of each connection site can also be viewed from - // Slides editor. + // (http://www.ecma-international.org/publications/standards/Ecma-376.htm). + // The position of each connection site can also be viewed from Slides + // editor. ConnectionSiteIndex int64 `json:"connectionSiteIndex,omitempty"` // ForceSendFields is a list of field names (e.g. "ConnectedObjectId") diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index 6ab6e60bcfb..2ad2a0a2e83 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -2662,8 +2662,9 @@ type QueryOptions struct { // queried from SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS. Executing a // SQL statement with an invalid optimizer version will fail with a // syntax error (`INVALID_ARGUMENT`) status. See - // https://cloud.google.com/spanner/docs/query-optimizer/manage-query-optimizer for more information on managing the query optimizer. The `optimizer_version` statement hint has precedence over this - // setting. + // https://cloud.google.com/spanner/docs/query-optimizer/manage-query-optimizer + // for more information on managing the query optimizer. The + // `optimizer_version` statement hint has precedence over this setting. OptimizerVersion string `json:"optimizerVersion,omitempty"` // ForceSendFields is a list of field names (e.g. "OptimizerVersion") to diff --git a/storagetransfer/v1/storagetransfer-gen.go b/storagetransfer/v1/storagetransfer-gen.go index fd3fdf947c8..b45fdc8e244 100644 --- a/storagetransfer/v1/storagetransfer-gen.go +++ b/storagetransfer/v1/storagetransfer-gen.go @@ -169,9 +169,9 @@ type TransferOperationsService struct { } // AwsAccessKey: AWS access key (see AWS Security Credentials -// (https://docs.aws.amazon.com/general/latest/gr/aws-security-credential -// s.html)). For information on our data retention policy for user -// credentials, see User credentials (data-retention#user-credentials). +// (https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)). +// For information on our data retention policy for user credentials, +// see User credentials (data-retention#user-credentials). type AwsAccessKey struct { // AccessKeyId: Required. AWS access key ID. AccessKeyId string `json:"accessKeyId,omitempty"` @@ -215,8 +215,7 @@ type AwsS3Data struct { AwsAccessKey *AwsAccessKey `json:"awsAccessKey,omitempty"` // BucketName: Required. S3 Bucket name (see Creating a bucket - // (https://docs.aws.amazon.com/AmazonS3/latest/dev/create-bucket-get-loc - // ation-example.html)). + // (https://docs.aws.amazon.com/AmazonS3/latest/dev/create-bucket-get-location-example.html)). BucketName string `json:"bucketName,omitempty"` // Path: Root path to transfer objects. Must be an empty string or full @@ -251,12 +250,10 @@ func (s *AwsS3Data) MarshalJSON() ([]byte, error) { // source, but not a data sink. An AzureBlobStorageData resource // represents one Azure container. The storage account determines the // Azure endpoint -// (https://docs.microsoft.com/en-us/azure/storage/common/storage-create- -// storage-account#storage-account-endpoints). In an -// AzureBlobStorageData resource, a blobs's name is the Azure Blob +// (https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints). +// In an AzureBlobStorageData resource, a blobs's name is the Azure Blob // Storage blob's key name -// (https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and- -// referencing-containers--blobs--and-metadata#blob-names). +// (https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names). type AzureBlobStorageData struct { // AzureCredentials: Required. Input only. Credentials used to // authenticate API requests to Azure. For information on our data @@ -307,8 +304,7 @@ type AzureCredentials struct { // SasToken: Required. Azure shared access signature. (see Grant limited // access to Azure Storage resources using shared access signatures // (SAS) - // (https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-ove - // rview)). + // (https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-overview)). SasToken string `json:"sasToken,omitempty"` // ForceSendFields is a list of field names (e.g. "SasToken") to diff --git a/streetviewpublish/v1/streetviewpublish-gen.go b/streetviewpublish/v1/streetviewpublish-gen.go index 576959d2fa3..23df88c47ad 100644 --- a/streetviewpublish/v1/streetviewpublish-gen.go +++ b/streetviewpublish/v1/streetviewpublish-gen.go @@ -759,7 +759,8 @@ type Pose struct { // AccuracyMeters: The estimated horizontal accuracy of this pose in // meters with 68% confidence (one standard deviation). For example, on // Android, this value is available from this method: - // https://developer.android.com/reference/android/location/Location#getAccuracy(). Other platforms have different methods of obtaining similar accuracy + // https://developer.android.com/reference/android/location/Location#getAccuracy(). + // Other platforms have different methods of obtaining similar accuracy // estimations. AccuracyMeters float64 `json:"accuracyMeters,omitempty"` @@ -774,8 +775,11 @@ type Pose struct { // LatLngPair: Latitude and longitude pair of the pose, as explained // here: - // https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng When creating a Photo, if the latitude and longitude pair are not provided, the geolocation from the exif header is used. A latitude and longitude pair not provided in the photo or exif header causes the photo process to - // fail. + // https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng + // When creating a Photo, if the latitude and longitude pair are not + // provided, the geolocation from the exif header is used. A latitude + // and longitude pair not provided in the photo or exif header causes + // the photo process to fail. LatLngPair *LatLng `json:"latLngPair,omitempty"` // Level: Level (the floor in a building) used to configure vertical @@ -1434,8 +1438,16 @@ type PhotoStartUploadCall struct { // bytes. The method uses the upload URL of the returned UploadRef to // upload the bytes for the Photo. In addition to the photo requirements // shown in -// https://support.google.com/maps/answer/7012050?hl=en&ref_topic=6275604, the photo must meet the following requirements: * Photo Sphere XMP metadata must be included in the photo metadata. See https://developers.google.com/streetview/spherical-metadata for the required fields. * The pixel size of the photo must meet the size requirements listed in https://support.google.com/maps/answer/7012050?hl=en&ref_topic=6275604, and the photo must be a full 360 horizontally. After the upload completes, the method uses UploadRef with CreatePhoto to create the Photo object -// entry. +// https://support.google.com/maps/answer/7012050?hl=en&ref_topic=6275604, +// the photo must meet the following requirements: * Photo Sphere XMP +// metadata must be included in the photo metadata. See +// https://developers.google.com/streetview/spherical-metadata for the +// required fields. * The pixel size of the photo must meet the size +// requirements listed in +// https://support.google.com/maps/answer/7012050?hl=en&ref_topic=6275604, +// and the photo must be a full 360 horizontally. After the upload +// completes, the method uses UploadRef with CreatePhoto to create the +// Photo object entry. func (r *PhotoService) StartUpload(empty *Empty) *PhotoStartUploadCall { c := &PhotoStartUploadCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.empty = empty diff --git a/sts/v1beta/sts-gen.go b/sts/v1beta/sts-gen.go index bbe00adae3e..a75120c89df 100644 --- a/sts/v1beta/sts-gen.go +++ b/sts/v1beta/sts-gen.go @@ -179,24 +179,23 @@ type GoogleIdentityStsV1betaExchangeTokenRequest struct { // `/.well-known/openid-configuration`, where `` is the value of this // field. The document must be formatted according to section 4.2 of the // OIDC 1.0 Discovery specification - // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderCo - // nfigurationResponse). - `iat`: The issue time, in seconds, since the - // Unix epoch. Must be in the past. - `exp`: The expiration time, in - // seconds, since the Unix epoch. Must be less than 48 hours after - // `iat`. Shorter expiration times are more secure. If possible, we - // recommend setting an expiration time less than 6 hours. - `sub`: The - // identity asserted in the JWT. - `aud`: Configured by the mapper - // policy. The default value is the service account's unique ID. Example - // header: ``` { "alg": "RS256", "kid": "us-east-11" } ``` Example - // payload: ``` { "iss": "https://accounts.google.com", "iat": - // 1517963104, "exp": 1517966704, "aud": "113475438248934895348", "sub": - // "113475438248934895348", "my_claims": { "additional_claim": "value" } - // } ``` If `subject_token` is an AWS token, it must be a serialized, - // signed - // (https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_request - // s.html) request to the AWS `GetCallerIdentity()` - // (https://docs.aws.amazon.com/STS/latest/APIReference/API_GetCallerIden - // tity) method. Format the request as URL-encoded JSON, and set the + // (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfigurationResponse). + // - `iat`: The issue time, in seconds, since the Unix epoch. Must be in + // the past. - `exp`: The expiration time, in seconds, since the Unix + // epoch. Must be less than 48 hours after `iat`. Shorter expiration + // times are more secure. If possible, we recommend setting an + // expiration time less than 6 hours. - `sub`: The identity asserted in + // the JWT. - `aud`: Configured by the mapper policy. The default value + // is the service account's unique ID. Example header: ``` { "alg": + // "RS256", "kid": "us-east-11" } ``` Example payload: ``` { "iss": + // "https://accounts.google.com", "iat": 1517963104, "exp": 1517966704, + // "aud": "113475438248934895348", "sub": "113475438248934895348", + // "my_claims": { "additional_claim": "value" } } ``` If `subject_token` + // is an AWS token, it must be a serialized, signed + // (https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) + // request to the AWS `GetCallerIdentity()` + // (https://docs.aws.amazon.com/STS/latest/APIReference/API_GetCallerIdentity) + // method. Format the request as URL-encoded JSON, and set the // `subject_token_type` parameter to // `urn:ietf:params:aws:token-type:aws4_request`. The following // parameters are required: - `url`: The URL of the AWS STS endpoint for @@ -207,19 +206,36 @@ type GoogleIdentityStsV1betaExchangeTokenRequest struct { // must include: - `Authorization`: The request signature. - // `x-amz-date`: The time you will send the request, formatted as an // ISO8601 Basic - // (https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.html#sig - // v4_elements_date) string. This is typically set to the current time - // and used to prevent replay attacks. - `host`: The hostname of the - // `url` field; for example, `sts.amazonaws.com`. - - // `x-goog-cloud-target-resource`: The full, canonical resource name of - // the workload identity pool provider, with or without an `https:` - // prefix. To help ensure data integrity, we recommend including this - // header in the `SignedHeaders` field of the signed request. For - // example: + // (https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.html#sigv4_elements_date) + // string. This is typically set to the current time and used to prevent + // replay attacks. - `host`: The hostname of the `url` field; for + // example, `sts.amazonaws.com`. - `x-goog-cloud-target-resource`: The + // full, canonical resource name of the workload identity pool provider, + // with or without an `https:` prefix. To help ensure data integrity, we + // recommend including this header in the `SignedHeaders` field of the + // signed request. For example: // //iam.googleapis.com/projects//locations//workloadIdentityPools//provi // ders/ - // https://iam.googleapis.com/projects//locations//workloadIdentityPools//providers/ If you are using temporary security credentials provided by AWS, you must also include the header `x-amz-security-token`, with the value ``. The following example shows a signed, serialized request: ``` { "headers":[ {"key": "x-amz-date", "value": "20200815T015049Z"}, {"key": "Authorization", "value": "AWS4-HMAC-SHA256+Credential=$credential,+SignedHeaders=host;x-amz-date;x-goog-cloud-target-resource,+Signature=$signature"}, {"key": "x-goog-cloud-target-resource", "value": "//iam.googleapis.com/projects//locations//workloadIdentityPools//providers/"}, {"key": "host", "value": "sts.amazonaws.com"} . ], "method":"POST", "url":"https://sts.amazonaws.com?Action=GetCallerIdentity&Version=2011-06-15" } ``` You can also use a Google-issued OAuth 2.0 access token with this field to obtain an access token with new security attributes applied, such as a Credential Access Boundary. In this case, set `subject_token_type` to `urn:ietf:params:oauth:token-type:access_token`. If an access token already contains security attributes, you cannot apply additional security - // attributes. + // https://iam.googleapis.com/projects//locations//workloadIdentityPools//providers/ + // If you are using temporary security credentials provided by AWS, you + // must also include the header `x-amz-security-token`, with the value + // ``. The following example shows a signed, serialized request: ``` { + // "headers":[ {"key": "x-amz-date", "value": "20200815T015049Z"}, + // {"key": "Authorization", "value": + // "AWS4-HMAC-SHA256+Credential=$credential,+SignedHeaders=host;x-amz-dat + // e;x-goog-cloud-target-resource,+Signature=$signature"}, {"key": + // "x-goog-cloud-target-resource", "value": + // "//iam.googleapis.com/projects//locations//workloadIdentityPools//prov + // iders/"}, {"key": "host", "value": "sts.amazonaws.com"} . ], + // "method":"POST", + // "url":"https://sts.amazonaws.com?Action=GetCallerIdentity&Version=2011 + // -06-15" } ``` You can also use a Google-issued OAuth 2.0 access token + // with this field to obtain an access token with new security + // attributes applied, such as a Credential Access Boundary. In this + // case, set `subject_token_type` to + // `urn:ietf:params:oauth:token-type:access_token`. If an access token + // already contains security attributes, you cannot apply additional + // security attributes. SubjectToken string `json:"subjectToken,omitempty"` // SubjectTokenType: Required. diff --git a/translate/v3/translate-gen.go b/translate/v3/translate-gen.go index 2a0d89ee45e..de6c1a86e0b 100644 --- a/translate/v3/translate-gen.go +++ b/translate/v3/translate-gen.go @@ -929,9 +929,9 @@ type OutputConfig struct { // keeping updated during the process, please make sure there is no // custom retention policy applied on the output bucket that may avoid // file updating. - // (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-pol - // icy) The format of translations_file (for target language code 'trg') - // is: gs://translation_test/a_b_c_'trg'_translations.[extension] If the + // (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy) + // The format of translations_file (for target language code 'trg') is: + // gs://translation_test/a_b_c_'trg'_translations.[extension] If the // input file extension is tsv, the output has the following columns: // Column 1: ID of the request provided in the input, if it's not // provided in the input, then the input row number is used (0-based). diff --git a/translate/v3beta1/translate-gen.go b/translate/v3beta1/translate-gen.go index 69913d69f9e..960d14c0492 100644 --- a/translate/v3beta1/translate-gen.go +++ b/translate/v3beta1/translate-gen.go @@ -926,9 +926,9 @@ type OutputConfig struct { // keeping updated during the process, please make sure there is no // custom retention policy applied on the output bucket that may avoid // file updating. - // (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-pol - // icy) The format of translations_file (for target language code 'trg') - // is: gs://translation_test/a_b_c_'trg'_translations.[extension] If the + // (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy) + // The format of translations_file (for target language code 'trg') is: + // gs://translation_test/a_b_c_'trg'_translations.[extension] If the // input file extension is tsv, the output has the following columns: // Column 1: ID of the request provided in the input, if it's not // provided in the input, then the input row number is used (0-based). diff --git a/youtube/v3/youtube-gen.go b/youtube/v3/youtube-gen.go index 6ec516dde99..15bbf7657cd 100644 --- a/youtube/v3/youtube-gen.go +++ b/youtube/v3/youtube-gen.go @@ -8396,7 +8396,8 @@ type Video struct { // because there is generated client code in the wild that refers to it // [1]. We keep this field and do NOT remove it because otherwise V3 // would return an error when this part gets requested [2]. [1] - // https://developers.google.com/resources/api-libraries/documentation/youtube/v3/csharp/latest/classGoogle_1_1Apis_1_1YouTube_1_1v3_1_1Data_1_1VideoProjectDetails.html [2] + // https://developers.google.com/resources/api-libraries/documentation/youtube/v3/csharp/latest/classGoogle_1_1Apis_1_1YouTube_1_1v3_1_1Data_1_1VideoProjectDetails.html + // [2] // http://google3/video/youtube/src/python/servers/data_api/common.py?l=1565-1569&rcl=344141677 ProjectDetails *VideoProjectDetails `json:"projectDetails,omitempty"` @@ -9499,7 +9500,8 @@ func (s *VideoProcessingDetailsProcessingProgress) MarshalJSON() ([]byte, error) // because there is generated client code in the wild that refers to it // [1]. We keep this field and do NOT remove it because otherwise V3 // would return an error when this part gets requested [2]. [1] -// https://developers.google.com/resources/api-libraries/documentation/youtube/v3/csharp/latest/classGoogle_1_1Apis_1_1YouTube_1_1v3_1_1Data_1_1VideoProjectDetails.html [2] +// https://developers.google.com/resources/api-libraries/documentation/youtube/v3/csharp/latest/classGoogle_1_1Apis_1_1YouTube_1_1v3_1_1Data_1_1VideoProjectDetails.html +// [2] // http://google3/video/youtube/src/python/servers/data_api/common.py?l=1565-1569&rcl=344141677 type VideoProjectDetails struct { } From a6b570f17163e9ceb53ea79ba398749ef89a874d Mon Sep 17 00:00:00 2001 From: Cody Oss Date: Mon, 11 Jan 2021 12:20:36 -0700 Subject: [PATCH 4/4] undo removal of version.Repo call --- google-api-go-generator/gen.go | 3 +- .../testdata/json-body.want | 4 +-- .../testdata/resource-named-service.want | 28 +++++++++++++++---- 3 files changed, 27 insertions(+), 8 deletions(-) diff --git a/google-api-go-generator/gen.go b/google-api-go-generator/gen.go index 7a2614ea779..6a9b2782e6a 100644 --- a/google-api-go-generator/gen.go +++ b/google-api-go-generator/gen.go @@ -27,6 +27,7 @@ import ( "unicode" "google.golang.org/api/google-api-go-generator/internal/disco" + "google.golang.org/api/internal/version" ) const ( @@ -2017,7 +2018,7 @@ func (meth *Method) generateCode() { pn("\nfunc (c *%s) doRequest(alt string) (*http.Response, error) {", callName) pn(`reqHeaders := make(http.Header)`) - pn(`reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110")`) + pn(`reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/%s")`, version.Repo) pn("for k, v := range c.header_ {") pn(" reqHeaders[k] = v") pn("}") diff --git a/google-api-go-generator/testdata/json-body.want b/google-api-go-generator/testdata/json-body.want index 1a6c3b8df46..19a9101c00b 100644 --- a/google-api-go-generator/testdata/json-body.want +++ b/google-api-go-generator/testdata/json-body.want @@ -425,8 +425,8 @@ type GoogleCloudMlV1__AutoScaling struct { // HTTP request: // 

 	// PATCH
-	// https://ml.googleapis.com/v1/{name=projects/*/models/*/versions/*}?update_mask=autoScaling.minNodes -d
-	// @./update_body.json
+	// https://ml.googleapis.com/v1/{name=projects/*/models/*/versions/*}?update_mask=autoScaling.minNodes
+	// -d @./update_body.json
 	//
MinNodes int64 `json:"minNodes,omitempty"` diff --git a/google-api-go-generator/testdata/resource-named-service.want b/google-api-go-generator/testdata/resource-named-service.want index 292f02501ea..815861456cb 100644 --- a/google-api-go-generator/testdata/resource-named-service.want +++ b/google-api-go-generator/testdata/resource-named-service.want @@ -1995,8 +1995,9 @@ type Version struct { // DefaultExpiration: Duration that static files should be cached by web // proxies and browsers. Only applicable if the corresponding // StaticFilesHandler - // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time. Only returned in `GET` requests if `view=FULL` is - // set. + // (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) + // does not specify its own expiration time. Only returned in `GET` + // requests if `view=FULL` is set. DefaultExpiration string `json:"defaultExpiration,omitempty"` // Deployment: Code and application artifacts that make up this version. @@ -3679,7 +3680,14 @@ func (r *AppsServicesService) Patch(appsId string, servicesId string, service *S // version. By default, traffic is shifted immediately. For gradual // traffic migration, the target version must be located within // instances that are configured for both warmup requests -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#automaticscaling). You must specify the `shardBy` (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services#shardby) field in the Service resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see Migrating and Splitting Traffic +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#inboundservicetype) +// and automatic scaling +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#automaticscaling). +// You must specify the `shardBy` +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services#shardby) +// field in the Service resource. Gradual traffic migration is not +// supported in the App Engine flexible environment. For examples, see +// Migrating and Splitting Traffic // (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic). func (c *AppsServicesPatchCall) MigrateTraffic(migrateTraffic bool) *AppsServicesPatchCall { c.urlParams_.Set("migrateTraffic", fmt.Sprint(migrateTraffic)) @@ -4544,8 +4552,18 @@ type AppsServicesVersionsPatchCall struct { // Patch: Updates the specified Version resource. You can specify the // following fields depending on the App Engine environment and type of // scaling that the version resource uses: * `serving_status` -// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * `instance_class` (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * `automatic_scaling.min_idle_instances` (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * `automatic_scaling.max_idle_instances` (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard -// environment. +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status): +// For Version resources that use basic scaling, manual scaling, or run +// in the App Engine flexible environment. * `instance_class` +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class): +// For Version resources that run in the App Engine standard +// environment. * `automatic_scaling.min_idle_instances` +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): +// For Version resources that use automatic scaling and run in the App +// Engine standard environment. * `automatic_scaling.max_idle_instances` +// (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): +// For Version resources that use automatic scaling and run in the App +// Engine standard environment. func (r *AppsServicesVersionsService) Patch(appsId string, servicesId string, versionsId string, version *Version) *AppsServicesVersionsPatchCall { c := &AppsServicesVersionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.appsId = appsId