From 09ddacba9c3b45798fa309d3719638c754ec69a1 Mon Sep 17 00:00:00 2001 From: Cody Oss <6331106+codyoss@users.noreply.github.com> Date: Mon, 11 Jan 2021 16:38:06 -0700 Subject: [PATCH] fix: don't use markdown style links (#789) Fixes: #712 --- .../v1/abusiveexperiencereport-gen.go | 17 +- .../v1/acceleratedmobilepageurl-gen.go | 12 +- accessapproval/v1/accessapproval-gen.go | 15 +- .../v1/accesscontextmanager-gen.go | 19 +- .../v1beta/accesscontextmanager-gen.go | 6 +- .../v2beta1/adexchangebuyer2-gen.go | 45 +- .../v1/adexperiencereport-gen.go | 18 +- admin/directory/v1/admin-gen.go | 349 +++-- admin/reports/v1/admin-gen.go | 26 +- alertcenter/v1beta1/alertcenter-gen.go | 43 +- analyticsdata/v1alpha/analyticsdata-gen.go | 82 +- .../v4/analyticsreporting-gen.go | 169 ++- .../v1/androiddeviceprovisioning-gen.go | 78 +- androidmanagement/v1/androidmanagement-gen.go | 69 +- androidpublisher/v3/androidpublisher-gen.go | 39 +- apigateway/v1/apigateway-gen.go | 64 +- apigateway/v1beta/apigateway-gen.go | 72 +- apigee/v1/apigee-gen.go | 183 ++- appengine/v1/appengine-gen.go | 109 +- appengine/v1beta/appengine-gen.go | 103 +- appengine/v1beta4/appengine-gen.go | 105 +- appengine/v1beta5/appengine-gen.go | 105 +- artifactregistry/v1/artifactregistry-gen.go | 6 +- .../v1beta1/artifactregistry-gen.go | 37 +- .../v1beta2/artifactregistry-gen.go | 37 +- assuredworkloads/v1/assuredworkloads-gen.go | 10 +- bigquery/v2/bigquery-gen.go | 74 +- .../v1beta1/bigqueryconnection-gen.go | 31 +- .../v1/bigquerydatatransfer-gen.go | 54 +- .../v1/bigqueryreservation-gen.go | 6 +- .../v1beta1/bigqueryreservation-gen.go | 10 +- bigtableadmin/v2/bigtableadmin-gen.go | 44 +- billingbudgets/v1/billingbudgets-gen.go | 26 +- billingbudgets/v1beta1/billingbudgets-gen.go | 20 +- .../v1/binaryauthorization-gen.go | 36 +- .../v1beta1/binaryauthorization-gen.go | 36 +- chat/v1/chat-gen.go | 6 +- classroom/v1/classroom-gen.go | 67 +- cloudasset/v1/cloudasset-gen.go | 364 +++--- cloudasset/v1beta1/cloudasset-gen.go | 130 +- cloudasset/v1p1beta1/cloudasset-gen.go | 48 +- cloudasset/v1p4beta1/cloudasset-gen.go | 80 +- cloudasset/v1p5beta1/cloudasset-gen.go | 118 +- cloudbilling/v1/cloudbilling-gen.go | 112 +- cloudbuild/v1/cloudbuild-gen.go | 45 +- cloudbuild/v1alpha1/cloudbuild-gen.go | 45 +- cloudbuild/v1alpha2/cloudbuild-gen.go | 45 +- .../v1beta1/clouderrorreporting-gen.go | 69 +- cloudfunctions/v1/cloudfunctions-gen.go | 59 +- cloudidentity/v1/cloudidentity-gen.go | 145 ++- cloudidentity/v1beta1/cloudidentity-gen.go | 157 ++- cloudiot/v1/cloudiot-gen.go | 37 +- cloudkms/v1/cloudkms-gen.go | 103 +- cloudprofiler/v2/cloudprofiler-gen.go | 24 +- .../v1/cloudresourcemanager-gen.go | 80 +- .../v1beta1/cloudresourcemanager-gen.go | 33 +- .../v2/cloudresourcemanager-gen.go | 37 +- .../v2beta1/cloudresourcemanager-gen.go | 37 +- cloudscheduler/v1/cloudscheduler-gen.go | 155 ++- cloudscheduler/v1beta1/cloudscheduler-gen.go | 155 ++- cloudsearch/v1/cloudsearch-gen.go | 100 +- cloudshell/v1/cloudshell-gen.go | 6 +- cloudshell/v1alpha1/cloudshell-gen.go | 6 +- cloudtasks/v2/cloudtasks-gen.go | 414 +++--- cloudtasks/v2beta2/cloudtasks-gen.go | 336 +++-- cloudtasks/v2beta3/cloudtasks-gen.go | 425 +++---- cloudtrace/v2/cloudtrace-gen.go | 10 +- cloudtrace/v2beta1/cloudtrace-gen.go | 19 +- composer/v1/composer-gen.go | 107 +- composer/v1beta1/composer-gen.go | 114 +- compute/v0.alpha/compute-gen.go | 215 ++-- compute/v0.beta/compute-gen.go | 207 +-- compute/v1/compute-gen.go | 177 +-- container/v1/container-gen.go | 710 +++++------ container/v1beta1/container-gen.go | 700 +++++----- .../v1alpha1/containeranalysis-gen.go | 57 +- .../v1beta1/containeranalysis-gen.go | 81 +- content/v2.1/content-gen.go | 14 +- customsearch/v1/customsearch-gen.go | 466 ++++--- datacatalog/v1beta1/datacatalog-gen.go | 156 ++- dataflow/v1b3/dataflow-gen.go | 43 +- datafusion/v1/datafusion-gen.go | 37 +- datafusion/v1beta1/datafusion-gen.go | 37 +- datalabeling/v1beta1/datalabeling-gen.go | 93 +- datamigration/v1beta1/datamigration-gen.go | 58 +- dataproc/v1/dataproc-gen.go | 181 ++- dataproc/v1beta2/dataproc-gen.go | 173 +-- datastore/v1/datastore-gen.go | 84 +- datastore/v1beta1/datastore-gen.go | 22 +- datastore/v1beta3/datastore-gen.go | 40 +- .../v0.alpha/deploymentmanager-gen.go | 43 +- deploymentmanager/v2/deploymentmanager-gen.go | 37 +- .../v2beta/deploymentmanager-gen.go | 43 +- dialogflow/v2/dialogflow-gen.go | 444 +++---- dialogflow/v2beta1/dialogflow-gen.go | 559 ++++---- dialogflow/v3/dialogflow-gen.go | 515 ++++---- dialogflow/v3beta1/dialogflow-gen.go | 515 ++++---- digitalassetlinks/v1/digitalassetlinks-gen.go | 61 +- displayvideo/v1/displayvideo-gen.go | 21 +- dlp/v2/dlp-gen.go | 119 +- docs/v1/docs-gen.go | 4 +- documentai/v1beta2/documentai-gen.go | 28 +- documentai/v1beta3/documentai-gen.go | 33 +- domains/v1alpha2/domains-gen.go | 53 +- domains/v1beta1/domains-gen.go | 53 +- domainsrdap/v1/domainsrdap-gen.go | 22 +- .../v1.1/doubleclickbidmanager-gen.go | 4 +- doubleclicksearch/v2/doubleclicksearch-gen.go | 4 +- eventarc/v1beta1/eventarc-gen.go | 52 +- fcm/v1/fcm-gen.go | 173 ++- file/v1/file-gen.go | 16 +- file/v1beta1/file-gen.go | 24 +- firebase/v1beta1/firebase-gen.go | 482 ++++--- .../v1beta/firebasedatabase-gen.go | 5 +- .../v1/firebasedynamiclinks-gen.go | 64 +- firebasehosting/v1/firebasehosting-gen.go | 6 +- .../v1beta1/firebasehosting-gen.go | 107 +- firebaseml/v1/firebaseml-gen.go | 6 +- firebaseml/v1beta2/firebaseml-gen.go | 6 +- firestore/v1/firestore-gen.go | 68 +- firestore/v1beta1/firestore-gen.go | 50 +- firestore/v1beta2/firestore-gen.go | 6 +- gameservices/v1/gameservices-gen.go | 111 +- gameservices/v1beta/gameservices-gen.go | 111 +- genomics/v1/genomics-gen.go | 20 +- genomics/v1alpha2/genomics-gen.go | 45 +- genomics/v2alpha1/genomics-gen.go | 38 +- gmail/v1/gmail-gen.go | 4 +- .../v1beta1/gmailpostmastertools-gen.go | 43 +- google-api-go-generator/gen.go | 35 +- google-api-go-generator/gen_test.go | 40 + .../testdata/http-body.want | 14 +- .../testdata/json-body.want | 81 +- .../testdata/resource-named-service.want | 89 +- healthcare/v1/healthcare-gen.go | 836 ++++++------ healthcare/v1beta1/healthcare-gen.go | 1124 +++++++++-------- homegraph/v1/homegraph-gen.go | 132 +- iam/v1/iam-gen.go | 168 ++- iap/v1/iap-gen.go | 36 +- iap/v1beta1/iap-gen.go | 31 +- jobs/v3/jobs-gen.go | 50 +- jobs/v3p1beta1/jobs-gen.go | 56 +- jobs/v4/jobs-gen.go | 39 +- language/v1/language-gen.go | 24 +- language/v1beta1/language-gen.go | 20 +- language/v1beta2/language-gen.go | 28 +- lifesciences/v2beta/lifesciences-gen.go | 32 +- localservices/v1/localservices-gen.go | 4 +- logging/v2/logging-gen.go | 7 +- managedidentities/v1/managedidentities-gen.go | 83 +- .../v1alpha1/managedidentities-gen.go | 87 +- .../v1beta1/managedidentities-gen.go | 45 +- memcache/v1beta2/memcache-gen.go | 13 +- ml/v1/ml-gen.go | 677 +++++----- monitoring/v1/monitoring-gen.go | 8 +- monitoring/v3/monitoring-gen.go | 54 +- networkmanagement/v1/networkmanagement-gen.go | 41 +- .../v1beta1/networkmanagement-gen.go | 51 +- notebooks/v1/notebooks-gen.go | 77 +- osconfig/v1/osconfig-gen.go | 45 +- osconfig/v1beta/osconfig-gen.go | 47 +- people/v1/people-gen.go | 69 +- playablelocations/v3/playablelocations-gen.go | 20 +- .../v1/policytroubleshooter-gen.go | 22 +- .../v1beta/policytroubleshooter-gen.go | 22 +- poly/v1/poly-gen.go | 28 +- privateca/v1beta1/privateca-gen.go | 63 +- .../v1alpha1/prod_tt_sasportal-gen.go | 10 +- pubsub/v1/pubsub-gen.go | 96 +- pubsub/v1beta2/pubsub-gen.go | 51 +- realtimebidding/v1/realtimebidding-gen.go | 63 +- .../v1beta1/recommendationengine-gen.go | 39 +- redis/v1/redis-gen.go | 16 +- redis/v1beta1/redis-gen.go | 16 +- .../v1/remotebuildexecution-gen.go | 38 +- .../v1alpha/remotebuildexecution-gen.go | 45 +- .../v2/remotebuildexecution-gen.go | 38 +- retail/v2/retail-gen.go | 130 +- retail/v2alpha/retail-gen.go | 130 +- retail/v2beta/retail-gen.go | 130 +- run/v1/run-gen.go | 48 +- run/v1alpha1/run-gen.go | 71 +- run/v1beta1/run-gen.go | 12 +- runtimeconfig/v1/runtimeconfig-gen.go | 6 +- runtimeconfig/v1beta1/runtimeconfig-gen.go | 61 +- sasportal/v1alpha1/sasportal-gen.go | 10 +- script/v1/script-gen.go | 37 +- searchconsole/v1/searchconsole-gen.go | 31 +- secretmanager/v1/secretmanager-gen.go | 31 +- secretmanager/v1beta1/secretmanager-gen.go | 31 +- securitycenter/v1/securitycenter-gen.go | 84 +- securitycenter/v1beta1/securitycenter-gen.go | 97 +- securitycenter/v1beta2/securitycenter-gen.go | 32 +- .../v1/serviceconsumermanagement-gen.go | 212 ++-- .../v1beta1/serviceconsumermanagement-gen.go | 212 ++-- servicecontrol/v1/servicecontrol-gen.go | 37 +- servicecontrol/v2/servicecontrol-gen.go | 67 +- servicedirectory/v1/servicedirectory-gen.go | 31 +- .../v1beta1/servicedirectory-gen.go | 31 +- servicemanagement/v1/servicemanagement-gen.go | 263 ++-- servicenetworking/v1/servicenetworking-gen.go | 220 ++-- .../v1beta/servicenetworking-gen.go | 220 ++-- serviceusage/v1/serviceusage-gen.go | 218 ++-- serviceusage/v1beta1/serviceusage-gen.go | 212 ++-- sheets/v4/sheets-gen.go | 35 +- slides/v1/slides-gen.go | 14 +- sourcerepo/v1/sourcerepo-gen.go | 37 +- spanner/v1/spanner-gen.go | 172 +-- speech/v1/speech-gen.go | 47 +- speech/v1p1beta1/speech-gen.go | 101 +- speech/v2beta1/speech-gen.go | 14 +- storagetransfer/v1/storagetransfer-gen.go | 87 +- streetviewpublish/v1/streetviewpublish-gen.go | 39 +- sts/v1beta/sts-gen.go | 101 +- texttospeech/v1/texttospeech-gen.go | 20 +- texttospeech/v1beta1/texttospeech-gen.go | 20 +- toolresults/v1beta3/toolresults-gen.go | 10 +- tpu/v1/tpu-gen.go | 6 +- tpu/v1alpha1/tpu-gen.go | 6 +- translate/v3/translate-gen.go | 16 +- translate/v3beta1/translate-gen.go | 17 +- vault/v1/vault-gen.go | 6 +- videointelligence/v1/videointelligence-gen.go | 156 +-- .../v1beta2/videointelligence-gen.go | 156 +-- .../v1p1beta1/videointelligence-gen.go | 156 +-- .../v1p2beta1/videointelligence-gen.go | 156 +-- .../v1p3beta1/videointelligence-gen.go | 156 +-- vision/v1/vision-gen.go | 47 +- vision/v1p1beta1/vision-gen.go | 47 +- vision/v1p2beta1/vision-gen.go | 47 +- .../v1beta/workflowexecutions-gen.go | 5 +- workflows/v1beta/workflows-gen.go | 6 +- youtube/v3/youtube-gen.go | 6 +- youtubeanalytics/v2/youtubeanalytics-gen.go | 30 +- 234 files changed, 11158 insertions(+), 11321 deletions(-) diff --git a/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go b/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go index 303a81da3bf..3eb802f2b82 100644 --- a/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go +++ b/abusiveexperiencereport/v1/abusiveexperiencereport-gen.go @@ -155,14 +155,13 @@ 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 + // (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](https://support.google.com/webtools/answer/7538608). + // FilterStatus: The site's enforcement status + // (https://support.google.com/webtools/answer/7538608). // // Possible values: // "UNKNOWN" - N/A. @@ -177,9 +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](https://support.google.com/webmasters/answer/9008080) 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 dfd8d067cd9..ca53eaaa8d9 100644 --- a/acceleratedmobilepageurl/v1/acceleratedmobilepageurl-gen.go +++ b/acceleratedmobilepageurl/v1/acceleratedmobilepageurl-gen.go @@ -138,8 +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 + // 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"` @@ -238,8 +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](/amp/cache/reference/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 @@ -314,8 +314,8 @@ 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) +// (/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/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 44c1bdb77d1..6918c98c9fa 100644 --- a/accesscontextmanager/v1/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1/accesscontextmanager-gen.go @@ -859,17 +859,16 @@ 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 // 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 + // (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"` @@ -1711,11 +1710,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](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/accesscontextmanager/v1beta/accesscontextmanager-gen.go b/accesscontextmanager/v1beta/accesscontextmanager-gen.go index 4d7430504fc..ecd09104dac 100644 --- a/accesscontextmanager/v1beta/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1beta/accesscontextmanager-gen.go @@ -914,11 +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](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/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go index 43826caca0f..498942cea30 100644 --- a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go +++ b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go @@ -977,8 +977,8 @@ 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 + // (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 @@ -1039,14 +1039,15 @@ 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 + // (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"` // EntityName: The name of the entity. This field is automatically @@ -1798,8 +1799,8 @@ 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 + // (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 @@ -2691,10 +2692,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](https://developers.google.com/authorized-buyers/r - // tb/downloads/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 @@ -3890,9 +3890,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](https://storage.googleapis.com/adx-rtb-dictionaries/ge - // o-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 @@ -5081,10 +5081,9 @@ 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 + // (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/adexperiencereport/v1/adexperiencereport-gen.go b/adexperiencereport/v1/adexperiencereport-gen.go index 20e5e981f69..f69de2fa29c 100644 --- a/adexperiencereport/v1/adexperiencereport-gen.go +++ b/adexperiencereport/v1/adexperiencereport-gen.go @@ -158,14 +158,14 @@ 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 + // (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](https://support.google.com/webtools/answer/7308033) on this + // FilterStatus: The site's enforcement status + // (https://support.google.com/webtools/answer/7308033) on this // platform. // // Possible values: @@ -193,9 +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](https://support.google.com/webmasters/answer/9008080) 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 1cd774a6c26..7bb687361f8 100644 --- a/admin/directory/v1/admin-gen.go +++ b/admin/directory/v1/admin-gen.go @@ -667,15 +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](//http://support.google.com/a/bin/answer.py?amp;answer=1032419 -// ). +// 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](http://en.wikipedia.org/wiki/Epoch_time) format. + // CreationTime: The time when the ASP was created. Expressed in Unix + // time (http://en.wikipedia.org/wiki/Epoch_time) format. CreationTime int64 `json:"creationTime,omitempty,string"` // Etag: ETag of the ASP. @@ -685,8 +684,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 (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 @@ -763,10 +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`](/my-business/reference/rest/v4/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 @@ -1163,10 +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](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 +// (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"` @@ -1192,10 +1190,8 @@ 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 + // (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 @@ -1267,9 +1263,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](/admin-sdk/directory/v1/guides/manage-chrome-devices.html#expor - // t_meid). + // 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 @@ -1277,12 +1273,12 @@ 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 + // (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 @@ -1292,12 +1288,11 @@ 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 + // (/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 (http://support.google.com/a/bin/answer.py?answer=182433). OrgUnitPath string `json:"orgUnitPath,omitempty"` // OsVersion: The Chrome device's operating system version. @@ -1784,15 +1779,15 @@ 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 + // 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 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 + // (http://en.wikipedia.org/wiki/E.164) format. PhoneNumber string `json:"phoneNumber,omitempty"` // PostalAddress: The customer's postal address information. @@ -1841,8 +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](http://www.iso.org/iso/country_codes.htm). + // 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 @@ -2186,8 +2181,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 + // (http://en.wikipedia.org/wiki/Epoch_time) format. (Read-only). CreationTime int64 `json:"creationTime,omitempty,string"` // DomainAliases: List of domain alias objects. (Read-only) @@ -2411,8 +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](/admin-sdk/directory/v1/guides/manage-groups). +// 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. @@ -2438,9 +2433,9 @@ 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 + // (http://support.google.com/a/bin/answer.py?answer=33386) for the + // details. Email string `json:"email,omitempty"` // Etag: ETag of the resource. @@ -2534,8 +2529,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 (/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. @@ -2562,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](http://support.google.com/a/bin/answer.py?answer=167094). + // 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) @@ -2675,11 +2670,11 @@ func (s *MembersHasMember) MarshalJSON() ([]byte, error) { } // MobileDevice: Google Workspace 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). +// 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) @@ -2725,10 +2720,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](/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 + // (/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) @@ -2777,19 +2772,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](/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 + // (/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](/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 + // (/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 @@ -2797,11 +2792,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](/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 + // (/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) @@ -2837,11 +2832,11 @@ 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 + // (/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. @@ -2884,10 +2879,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](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 + // (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`. @@ -2990,17 +2985,16 @@ 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 +// (/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](http://support.google.com/a/bin/answer.py?answer=182442&topic= - // 1227584&ctx=topic). + // 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. @@ -3030,12 +3024,12 @@ type OrgUnit struct { // the `parentOrgunitPath`. A user's organizational unit determines // which Google Workspace 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 + // (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. @@ -3134,9 +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()`](/admin-sdk/directory/v1/reference/privileges/lis - // t). + // 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. @@ -3295,9 +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()`](/admin-sdk/directory/v1/reference/privileges/lis - // t). + // 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 @@ -3507,8 +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](/admin-sdk/directory/v1/guides/manage-schemas). +// 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"` @@ -3546,10 +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](/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 + // (/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 @@ -3768,10 +3760,10 @@ 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 (/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. @@ -3789,9 +3781,9 @@ 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 + // (https://support.google.com/a/answer/60224). ChangePasswordAtNextLogin bool `json:"changePasswordAtNextLogin,omitempty"` // CreationTime: User's G Suite account creation time. (Read-only) @@ -3800,13 +3792,14 @@ 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: 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. + // 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"` @@ -3829,9 +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](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 (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 @@ -3847,32 +3840,32 @@ type User struct { // IncludeInGlobalAddressList: Indicates if the user's profile is // visible in the Google Workspace 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 + // (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](http://support.google.com/a/bin/answer.py?answer=60752). + // 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](/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 + // (/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](http://support.google.com/a/bin/answer.py?answer=33325). + // 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 @@ -3913,9 +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](http://support.google.com/a/bin/answer.py?answer=33386). - // 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 @@ -3942,9 +3935,9 @@ 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 + // (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 @@ -4597,16 +4590,16 @@ 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 + // (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 string `json:"photoData,omitempty"` // PrimaryEmail: The user's primary email address. @@ -5492,8 +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](https://support.google.com/chrome/a/answer/3523633). +// 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 @@ -6243,8 +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](/admin-sdk/directory/v1/guides/performance#patch). +// `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 @@ -8826,8 +8819,8 @@ func (r *GroupsService) List() *GroupsListCall { // account, to 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) +// `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 @@ -9104,8 +9097,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 (/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 @@ -10564,8 +10557,8 @@ 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 +// (/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 @@ -12183,8 +12176,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 (/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 @@ -18580,9 +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](/admin-sdk/directory/v1/guides/manage-users#retriev -// e_users_non_admin). +// 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" @@ -18915,7 +18908,7 @@ func (c *UsersListCall) CustomFieldMask(customFieldMask string) *UsersListCall { // 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 Users 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) @@ -18974,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](/admin-sdk/directory/v1/guides/search-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 @@ -19001,9 +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](/admin-sdk/directory/v1/guides/manage-users#retriev -// e_users_non_admin). +// 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" @@ -19993,9 +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](/admin-sdk/directory/v1/guides/manage-users#retriev -// e_users_non_admin). +// 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 @@ -21064,8 +21057,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 (/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 33ec6ad6e01..4657a41b3b8 100644 --- a/admin/reports/v1/admin-gen.go +++ b/admin/reports/v1/admin-gen.go @@ -671,9 +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](/admin-sdk/reports/v1/reference/usage-ref-appendix-a/entiti - // es). + // 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 @@ -2107,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 @@ -2407,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 03723cd6ed7..d434ff33b33 100644 --- a/alertcenter/v1beta1/alertcenter-gen.go +++ b/alertcenter/v1beta1/alertcenter-gen.go @@ -309,8 +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) + // SecurityInvestigationToolLink: Output only. An optional Security + // Investigation Tool (https://support.google.com/a/answer/7575955) // query for this alert. SecurityInvestigationToolLink string `json:"securityInvestigationToolLink,omitempty"` @@ -326,8 +326,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 [Google - // Workspace Alert types](/admin-sdk/alertcenter/reference/alert-types). + // alert is created. For a list of available alert types see Google + // Workspace Alert types (/admin-sdk/alertcenter/reference/alert-types). Type string `json:"type,omitempty"` // UpdateTime: Output only. The time this alert was last updated. @@ -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 @@ -1335,8 +1334,8 @@ func (s *MatchInfo) MarshalJSON() ([]byte, error) { } // Notification: Settings for callback notifications. For more details -// see [Google Workspace Alert -// Notification](/admin-sdk/alertcenter/guides/notifications). +// see Google Workspace Alert Notification +// (/admin-sdk/alertcenter/guides/notifications). type Notification struct { // CloudPubsubTopic: A Google Cloud Pub/sub topic destination. CloudPubsubTopic *CloudPubsubTopic `json:"cloudPubsubTopic,omitempty"` @@ -1366,9 +1365,8 @@ 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 +// (/admin-sdk/alertcenter/reference/rest/v1beta1/MailPhishing) instead. type PhishingSpike struct { // DomainId: The domain ID. DomainId *DomainId `json:"domainId,omitempty"` @@ -1687,11 +1685,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](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. @@ -2646,10 +2644,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](/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 +// (/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 @@ -3173,11 +3171,10 @@ 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 +// (/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 5d5944c52b8..28bd7a2a602 100644 --- a/analyticsdata/v1alpha/analyticsdata-gen.go +++ b/analyticsdata/v1alpha/analyticsdata-gen.go @@ -453,14 +453,13 @@ func (s *CohortReportSettings) MarshalJSON() ([]byte, error) { // 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. +// 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. type CohortSpec struct { // CohortReportSettings: Optional settings for a cohort report. CohortReportSettings *CohortReportSettings `json:"cohortReportSettings,omitempty"` @@ -663,14 +662,14 @@ 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 + // (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") @@ -769,7 +768,7 @@ func (s *DimensionHeader) MarshalJSON() ([]byte, error) { // DimensionMetadata: Explains a dimension. type DimensionMetadata struct { - // ApiName: This dimension's name. Useable in [Dimension](#Dimension)'s + // ApiName: This dimension's name. Useable in Dimension (#Dimension)'s // `name`. For example, `eventName`. ApiName string `json:"apiName,omitempty"` @@ -890,9 +889,8 @@ 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 + // (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 @@ -1118,14 +1116,13 @@ 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 + // (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 @@ -1209,7 +1206,7 @@ func (s *MetricHeader) MarshalJSON() ([]byte, error) { // MetricMetadata: Explains a metric. type MetricMetadata struct { - // ApiName: A metric name. Useable in [Metric](#Metric)'s `name`. For + // ApiName: A metric name. Useable in Metric (#Metric)'s `name`. For // example, `eventCount`. ApiName string `json:"apiName,omitempty"` @@ -1227,7 +1224,7 @@ 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 + // 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"` @@ -1875,8 +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](#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 @@ -2011,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 (#PropertyQuota). ReturnPropertyQuota bool `json:"returnPropertyQuota,omitempty"` // ForceSendFields is a list of field names (e.g. "DimensionFilter") to @@ -2139,9 +2136,8 @@ 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 + // (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,17 +2162,16 @@ 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 + // (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. 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 + // (#PropertyQuota). ReturnPropertyQuota bool `json:"returnPropertyQuota,omitempty"` // ForceSendFields is a list of field names (e.g. "CohortSpec") to @@ -2231,9 +2226,8 @@ 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 + // (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 f01766f24bd..94684e8b018 100644 --- a/analyticsreporting/v4/analyticsreporting-gen.go +++ b/analyticsreporting/v4/analyticsreporting-gen.go @@ -351,27 +351,26 @@ 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 (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 @@ -462,9 +461,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 +// (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"` @@ -528,11 +526,11 @@ 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 +// (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 @@ -845,15 +843,15 @@ 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 + // (/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 @@ -1019,9 +1017,8 @@ 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` +// 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 @@ -1652,21 +1649,19 @@ 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 + // (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](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 + // 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 googleapi.Int64s `json:"samplingSpaceSizes,omitempty"` @@ -1708,7 +1703,7 @@ 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` + // present. Every ReportRequest (#ReportRequest) within a `batchGet` // method must contain the same `cohortGroup` definition. CohortGroup *CohortGroup `json:"cohortGroup,omitempty"` @@ -1720,9 +1715,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](#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 @@ -1742,9 +1737,8 @@ 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 + // (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 @@ -1798,14 +1792,13 @@ 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 + // (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 @@ -1819,15 +1812,15 @@ 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 (#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 + // 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"` @@ -1991,20 +1984,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](#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](#SearchUserActivityRequest) must contain + // SearchUserActivityRequest (#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 + // (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 @@ -2034,15 +2026,14 @@ func (s *SearchUserActivityRequest) MarshalJSON() ([]byte, error) { // call. type SearchUserActivityResponse struct { // NextPageToken: This token should be passed to - // [SearchUserActivityRequest](#SearchUserActivityRequest) to retrieve + // SearchUserActivityRequest (#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 - // 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 271de8591f3..cabb36f7929 100644 --- a/androiddeviceprovisioning/v1/androiddeviceprovisioning-gen.go +++ b/androiddeviceprovisioning/v1/androiddeviceprovisioning-gen.go @@ -798,14 +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](https://developers.google.com/zero-touch/guides/identifi - // ers). + // 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](https://developers.google.com/zero-touch/guides/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 @@ -841,8 +840,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 (/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"` @@ -894,18 +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](https://developers.google.com/zero-touch/guides/identifi -// ers). +// 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](/zero-touch/resources/manufacturer-names#manufacturers - // -names). + // values are listed in manufacturers + // (/zero-touch/resources/manufacturer-names#manufacturers-names). Manufacturer string `json:"manufacturer,omitempty"` // Meid: The device’s MEID number. @@ -913,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](/zero-touch/resources/manufacturer-names#model-names). + // models (/zero-touch/resources/manufacturer-names#model-names). Model string `json:"model,omitempty"` // SerialNumber: The manufacturer's serial number for the device. This @@ -944,8 +941,8 @@ 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 +// (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"` @@ -983,9 +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](https://developers.google.com/zero-touch/guides/identifi -// ers). +// 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"` @@ -1018,8 +1014,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 (/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 @@ -1068,8 +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](/zero-touch/guides/how-it-works#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 @@ -1104,12 +1100,12 @@ 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 +// (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 @@ -1696,11 +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](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. @@ -2651,9 +2647,9 @@ 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 +// (/protocol-buffers/docs/reference/google.protobuf#fieldmask) in the +// Protocol Buffers documentation. func (c *CustomersConfigurationsPatchCall) UpdateMask(updateMask string) *CustomersConfigurationsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -4300,8 +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](/zero-touch/guides/how-it-works#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 @@ -5194,8 +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](/zero-touch/guides/how-it-works#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 @@ -5336,8 +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](/zero-touch/guides/how-it-works#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..f24adcb71c1 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -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 @@ -4529,7 +4528,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4681,7 +4680,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4824,7 +4823,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4988,7 +4987,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5149,7 +5148,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5311,7 +5310,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5448,7 +5447,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5611,7 +5610,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5786,7 +5785,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5939,7 +5938,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6072,7 +6071,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6215,7 +6214,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6389,7 +6388,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6561,7 +6560,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6700,7 +6699,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6831,7 +6830,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6972,7 +6971,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7130,7 +7129,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7305,7 +7304,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7451,7 +7450,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7589,7 +7588,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7730,7 +7729,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7888,7 +7887,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8063,7 +8062,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8210,7 +8209,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8365,7 +8364,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index f41f46f72da..e06a03ea723 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -734,9 +734,8 @@ 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 + // (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 @@ -4313,9 +4312,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](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 +// (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 @@ -9787,9 +9786,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](https://developers.google.com/api-client-library/java/google-a -// pi-java-client/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 @@ -10007,9 +10006,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](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 +// (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 653413e6387..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: @@ -566,9 +571,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1170,9 +1174,10 @@ 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 +// (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", @@ -1190,8 +1195,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 (https://cloud.google.com/iam/docs/). type ApigatewayPolicy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1230,9 +1235,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1302,11 +1307,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](https://github.com/grpc). Each `Status` message contains three -// pieces of data: error code, error message, and error details. You can -// find 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 (https://github.com/grpc). +// Each `Status` message contains three pieces of data: error code, +// error message, and error details. You can find 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. @@ -1349,8 +1354,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2223,9 +2228,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -3500,9 +3504,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -4749,9 +4752,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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/apigateway/v1beta/apigateway-gen.go b/apigateway/v1beta/apigateway-gen.go index 567a225bdc9..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. @@ -612,9 +615,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1245,9 +1247,10 @@ 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 +// (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", @@ -1265,8 +1268,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 (https://cloud.google.com/iam/docs/). type ApigatewayPolicy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1305,9 +1308,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1377,11 +1380,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](https://github.com/grpc). Each `Status` message contains three -// pieces of data: error code, error message, and error details. You can -// find 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 (https://github.com/grpc). +// Each `Status` message contains three pieces of data: error code, +// error message, and error details. You can find 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. @@ -1424,8 +1427,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2298,9 +2301,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -3575,9 +3577,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -4824,9 +4825,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 284ce80ec3c..6e5a0a33206 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -5445,22 +5445,20 @@ 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 + // (https://cloud.google.com/apigee/docs/api-platform/get-started/create-org). 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 - // CLOUD. The value can be updated only when there are no runtime - // instances. For example: "default". **Note:** Not supported for Apigee - // hybrid. + // to be peered with Apigee runtime instances. See Getting started with + // the Service Networking API + // (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 @@ -5518,8 +5516,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](https://cloud.google.com/apigee/pricing/). + // purchased). See Apigee pricing + // (https://cloud.google.com/apigee/pricing/). // // Possible values: // "SUBSCRIPTION_TYPE_UNSPECIFIED" - Subscription type not specified. @@ -5764,9 +5762,9 @@ 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 + // (https://docs.apigee.com/hybrid/latest/precog-provision). Defaults to + // us-west1. AnalyticsRegion string `json:"analyticsRegion,omitempty"` // AuthorizedNetwork: Name of the customer project's VPC network. If @@ -7128,15 +7126,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](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 + // (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 @@ -7147,9 +7145,8 @@ 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 + // (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 @@ -7705,9 +7702,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -7782,9 +7778,10 @@ 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 +// (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", @@ -7802,8 +7799,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 (https://cloud.google.com/iam/docs/). type GoogleIamV1Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -7842,9 +7839,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -7917,8 +7914,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -8164,11 +8161,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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. @@ -8425,9 +8422,9 @@ 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 +// (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 @@ -8699,9 +8696,9 @@ 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 +// (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 @@ -9027,13 +9024,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](setSyncAuthorization) to ensure that you are +// 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. +// overwritten indiscriminately. For more information, see Configure the +// Synchronizer +// (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 @@ -9175,9 +9172,8 @@ 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 +// (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 @@ -9328,12 +9324,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](getSyncAuthorization). If you don't pass the +// 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. +// see Configure the Synchronizer +// (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 @@ -13193,7 +13189,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 (updateApiProxyRevision). func (r *OrganizationsApisRevisionsService) Get(name string) *OrganizationsApisRevisionsGetCall { c := &OrganizationsApisRevisionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -21651,10 +21647,10 @@ 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 +// (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 @@ -21668,9 +21664,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -21820,11 +21815,11 @@ 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 -// `apigee.environments.setIamPolicy` permission to call this API. +// 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-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 @@ -22385,7 +22380,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 (get). func (r *OrganizationsEnvironmentsService) Update(name string, googlecloudapigeev1environment *GoogleCloudApigeeV1Environment) *OrganizationsEnvironmentsUpdateCall { c := &OrganizationsEnvironmentsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -22698,7 +22693,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 (get). func (r *OrganizationsEnvironmentsService) UpdateEnvironment(name string, googlecloudapigeev1environment *GoogleCloudApigeeV1Environment) *OrganizationsEnvironmentsUpdateEnvironmentCall { c := &OrganizationsEnvironmentsUpdateEnvironmentCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -29060,9 +29055,8 @@ 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 +// (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 @@ -29072,7 +29066,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 @@ -29229,9 +29223,8 @@ 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 +// (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 @@ -29383,9 +29376,8 @@ 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 +// (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 @@ -29548,9 +29540,8 @@ 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 +// (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 @@ -29711,9 +29702,8 @@ 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 +// (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 @@ -29872,9 +29862,8 @@ 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 +// (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 a78d88c1293..d40936aadf6 100644 --- a/appengine/v1beta4/appengine-gen.go +++ b/appengine/v1beta4/appengine-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -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 @@ -691,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 @@ -2502,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 @@ -2765,7 +2767,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2913,7 +2915,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3020,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 @@ -3066,7 +3066,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3222,7 +3222,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3397,7 +3397,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3570,7 +3570,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3720,7 +3720,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3887,7 +3887,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4042,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 @@ -4085,7 +4083,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4245,7 +4243,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4394,7 +4392,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4567,7 +4565,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4764,7 +4762,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4920,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)} @@ -4982,7 +4976,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5155,7 +5149,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5322,7 +5316,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5492,7 +5486,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5621,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 @@ -5682,7 +5675,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5879,7 +5872,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6062,7 +6055,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/20210110") 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..e30390ac8d2 100644 --- a/appengine/v1beta5/appengine-gen.go +++ b/appengine/v1beta5/appengine-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -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 @@ -691,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 @@ -2457,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 @@ -2724,7 +2726,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2873,7 +2875,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2980,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 @@ -3026,7 +3026,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3182,7 +3182,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3357,7 +3357,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3543,7 +3543,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3726,7 +3726,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3899,7 +3899,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4049,7 +4049,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4216,7 +4216,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4371,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 @@ -4414,7 +4412,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4574,7 +4572,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4723,7 +4721,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4896,7 +4894,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5093,7 +5091,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5249,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)} @@ -5311,7 +5305,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5484,7 +5478,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5651,7 +5645,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5821,7 +5815,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5950,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 @@ -6011,7 +6004,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/artifactregistry/v1/artifactregistry-gen.go b/artifactregistry/v1/artifactregistry-gen.go index 7058bea63c6..e78b6a218fc 100644 --- a/artifactregistry/v1/artifactregistry-gen.go +++ b/artifactregistry/v1/artifactregistry-gen.go @@ -326,11 +326,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 ebda77cbb61..8a0c23f58f7 100644 --- a/artifactregistry/v1beta1/artifactregistry-gen.go +++ b/artifactregistry/v1beta1/artifactregistry-gen.go @@ -244,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -888,9 +887,10 @@ 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 +// (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", @@ -908,8 +908,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 (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 @@ -944,9 +944,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1074,11 +1074,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](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. @@ -1161,8 +1161,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2437,9 +2437,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 8992cf9c154..dd866be024e 100644 --- a/artifactregistry/v1beta2/artifactregistry-gen.go +++ b/artifactregistry/v1beta2/artifactregistry-gen.go @@ -244,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -888,9 +887,10 @@ 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 +// (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", @@ -908,8 +908,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 (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 @@ -944,9 +944,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1074,11 +1074,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](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. @@ -1161,8 +1161,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2437,9 +2437,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 b2098fd94d7..945f0135440 100644 --- a/assuredworkloads/v1/assuredworkloads-gen.go +++ b/assuredworkloads/v1/assuredworkloads-gen.go @@ -896,11 +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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 bd9901478f4..84551ac1883 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -1184,9 +1184,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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,9 +2846,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -3450,16 +3448,16 @@ type JobConfigurationLoad struct { // DecimalTargetTypes: Defines the list of possible SQL data types to // which the source decimal values are converted. This list and the // precision and the scale parameters of the decimal field determine the - // target type. In the order of NUMERIC, BIGNUMERIC - // ([Preview](/products/#product-launch-stages)), and STRING, a type is - // picked if it is in the specified list and if it supports the - // precision and the scale. STRING supports all precision and scale - // values. If none of the listed types supports the precision and the - // scale, the type supporting the widest range in the specified list is - // picked, and if a value exceeds the supported range when reading the - // data, an error will be thrown. Example: Suppose the value of this - // field is ["NUMERIC", "BIGNUMERIC"]. If (precision,scale) is: * (38,9) - // -> NUMERIC; * (39,9) -> BIGNUMERIC (NUMERIC cannot hold 30 integer + // target type. In the order of NUMERIC, BIGNUMERIC (Preview + // (/products/#product-launch-stages)), and STRING, a type is picked if + // it is in the specified list and if it supports the precision and the + // scale. STRING supports all precision and scale values. If none of the + // listed types supports the precision and the scale, the type + // supporting the widest range in the specified list is picked, and if a + // value exceeds the supported range when reading the data, an error + // will be thrown. Example: Suppose the value of this field is + // ["NUMERIC", "BIGNUMERIC"]. If (precision,scale) is: * (38,9) -> + // NUMERIC; * (39,9) -> BIGNUMERIC (NUMERIC cannot hold 30 integer // digits); * (38,10) -> BIGNUMERIC (NUMERIC cannot hold 10 fractional // digits); * (76,38) -> BIGNUMERIC; * (77,38) -> BIGNUMERIC (error if // value exeeds supported range). This field cannot contain duplicate @@ -4244,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. @@ -4893,9 +4906,10 @@ 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 +// (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", @@ -4913,8 +4927,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -4953,9 +4967,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -6511,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") @@ -7032,8 +7046,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 834ae97f1dd..df1e4c83fe1 100644 --- a/bigqueryconnection/v1beta1/bigqueryconnection-gen.go +++ b/bigqueryconnection/v1beta1/bigqueryconnection-gen.go @@ -281,9 +281,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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,9 +612,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -690,9 +688,10 @@ 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 +// (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", @@ -710,8 +709,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -750,9 +749,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -824,8 +823,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 046ad5ee5f9..5ce4a5f6004 100644 --- a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go +++ b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go @@ -1021,11 +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](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. @@ -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/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index ae7a4e5b7dd..6e7ad273457 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -947,11 +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](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/bigqueryreservation/v1beta1/bigqueryreservation-gen.go b/bigqueryreservation/v1beta1/bigqueryreservation-gen.go index b0698195ed9..98303f9d8d6 100644 --- a/bigqueryreservation/v1beta1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1beta1/bigqueryreservation-gen.go @@ -803,11 +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](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. @@ -2892,8 +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](https://cloud.google.com/logging/docs/view/advanced-filters). +// \"*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 45576aaf423..f7fa73ad967 100644 --- a/bigtableadmin/v2/bigtableadmin-gen.go +++ b/bigtableadmin/v2/bigtableadmin-gen.go @@ -299,10 +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](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 + // (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. @@ -561,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1390,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -2116,9 +2113,10 @@ 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 +// (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", @@ -2136,8 +2134,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2176,9 +2174,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2435,11 +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](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. @@ -2592,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 e7df259b9bc..8bdfce40595 100644 --- a/billingbudgets/v1/billingbudgets-gen.go +++ b/billingbudgets/v1/billingbudgets-gen.go @@ -271,10 +271,9 @@ 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 + // (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 @@ -578,9 +582,9 @@ 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 +// (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 bbe002db54c..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 @@ -361,10 +366,9 @@ 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 + // (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/binaryauthorization/v1/binaryauthorization-gen.go b/binaryauthorization/v1/binaryauthorization-gen.go index 5808a4f37c0..403d51673e1 100644 --- a/binaryauthorization/v1/binaryauthorization-gen.go +++ b/binaryauthorization/v1/binaryauthorization-gen.go @@ -425,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -574,9 +573,10 @@ 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 +// (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,8 +594,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 (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,9 +630,9 @@ 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 + // (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,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -1925,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -2856,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 c5116995ff5..102b6164ccc 100644 --- a/binaryauthorization/v1beta1/binaryauthorization-gen.go +++ b/binaryauthorization/v1beta1/binaryauthorization-gen.go @@ -427,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -576,9 +575,10 @@ 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 +// (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", @@ -596,8 +596,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 (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 @@ -632,9 +632,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -978,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -1927,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -2858,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 7a58860a3c0..c2676e69280 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -605,14 +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](/hangouts/chat/how-tos/cards-onclick) for + // 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](/hangouts/chat/how-tos/auth-3p) for more information. + // outside of Google Chat. See the Authorizing access to 3p services + // 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 a99266f1270..8ed3fb6d28a 100644 --- a/classroom/v1/classroom-gen.go +++ b/classroom/v1/classroom-gen.go @@ -601,9 +601,8 @@ 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 + // (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 @@ -4747,13 +4746,13 @@ 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 +// (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 // 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,8 +5638,8 @@ 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 +// 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 @@ -5789,9 +5788,9 @@ 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 +// (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 // requesting user is not permitted to delete the requested course or @@ -6511,9 +6510,9 @@ 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 +// (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 // not permitted to make the requested modification to the student @@ -7170,9 +7169,9 @@ 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 +// 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 @@ -7341,9 +7340,9 @@ 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 +// (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 // not permitted to make the requested modification to the student @@ -7531,7 +7530,7 @@ 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) +// 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 @@ -7704,9 +7703,9 @@ 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 +// 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. * @@ -7874,9 +7873,9 @@ 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 +// 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. * @@ -8185,9 +8184,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](https://support.google.com/cloud/answer/6158849) 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 03da0ca9fd2..d65cb1a1e61 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -281,38 +281,36 @@ 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 +// (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#a - // ccess-levels). + // 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](https://cloud.google.com/access-context-manager/docs/overview#a - // ccess-policies). + // 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](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 + // (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: - // `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 + // (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 @@ -321,36 +319,35 @@ 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 + // the resource's ancestry resource levels in the hierarchy. See this + // 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](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. + // s/instance1` See Resource names + // (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-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 + // (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-ma - // nagement) for more information. + // See this topic + // (https://cloud.google.com/compute/docs/instances/os-inventory-management) + // 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 (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 @@ -558,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 @@ -603,9 +600,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -762,14 +758,14 @@ 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 + // (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"` // ContentType: Asset content type. If not specified, no content but the @@ -890,18 +886,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](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more info. + // s/instance1`. See Resource Names + // (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 // 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 + // (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 @@ -911,9 +907,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](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 + // (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 @@ -1000,10 +996,10 @@ 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 + // (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. @@ -1260,8 +1256,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), + // 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 - // serviceAccount:s1@prj1.iam.gserviceaccount.com - // projectOwner:some_project_id - domain:google.com - allUsers - etc. @@ -1334,9 +1330,8 @@ 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 + // (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 @@ -1560,9 +1555,10 @@ 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 + // (/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`, @@ -2679,12 +2675,10 @@ 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 + // (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 @@ -2719,9 +2713,9 @@ 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 + // (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 @@ -2917,10 +2911,10 @@ type IamPolicySearchResult struct { // Resource: Required. 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 + // (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 @@ -2950,9 +2944,9 @@ 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 + // 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", // "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice @@ -3432,9 +3426,10 @@ 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 +// (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", @@ -3452,8 +3447,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -3492,9 +3487,9 @@ 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 + // (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 @@ -3574,12 +3569,12 @@ 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 + // (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: // `//cloudresourcemanager.googleapis.com/projects/my_project_123` For // third-party assets, this field may be set differently. Parent string `json:"parent,omitempty"` @@ -3624,17 +3619,16 @@ type ResourceSearchResult struct { // another. 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 - // `additional_attributes = { dnsName: "foobar" }`, you can issue a - // query `foobar`. + // corresponding GCP service (e.g., Compute Engine). see API references + // and supported searchable attributes + // (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: @@ -3657,16 +3651,15 @@ type ResourceSearchResult struct { // Instance" DisplayName string `json:"displayName,omitempty"` - // Labels: Optional. 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. - // 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: Optional. Labels associated with this resource. See Labelling + // and grouping GCP resources + // (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 @@ -3678,21 +3671,21 @@ type ResourceSearchResult struct { // Name: Required. 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 + // (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: 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-gr - // ouping-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` + // resources. See Labelling GCP resources + // (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 @@ -3732,9 +3725,8 @@ 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 + // (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 @@ -3854,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 @@ -3902,11 +3894,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](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. @@ -5154,8 +5146,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 +// 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 @@ -5260,9 +5252,8 @@ 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 +// (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 @@ -5270,13 +5261,14 @@ 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 -// 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 @@ -6041,19 +6033,18 @@ 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`. 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 bindings that specify the Compute Admin role. * +// 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/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 +// bindings that specify the Compute Admin role. * // `policy.role.permissions:storage.buckets.update` to find IAM policy // bindings that specify a role containing "storage.buckets.update" // permission. Note that if callers don't have `iam.roles.get` access to @@ -6261,17 +6252,16 @@ 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). 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 expression syntax. If the regular expression -// does not match any supported asset type, an INVALID_ARGUMENT error -// will be returned. +// the searchable asset types +// (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 +// expression syntax. If the regular expression does not match any +// supported asset type, an INVALID_ARGUMENT error will be returned. func (c *V1SearchAllResourcesCall) AssetTypes(assetTypes ...string) *V1SearchAllResourcesCall { c.urlParams_.SetMulti("assetTypes", append([]string{}, assetTypes...)) return c @@ -6313,15 +6303,15 @@ 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 -// 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 +// 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 // 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 36a508741c4..f64d8741549 100644 --- a/cloudasset/v1beta1/cloudasset-gen.go +++ b/cloudasset/v1beta1/cloudasset-gen.go @@ -205,28 +205,26 @@ 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 +// (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#a - // ccess-levels). + // 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](https://cloud.google.com/access-context-manager/docs/overview#a - // ccess-policies). + // 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](https://cloud.google.com/asset-inventory/docs/supported-asset-t - // ypes) 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 @@ -235,30 +233,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 + // the resource's ancestry resource levels in the hierarchy. See this + // 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](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. + // s/instance1` See Resource names + // (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-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 + // (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. 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 (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 @@ -421,9 +418,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -491,9 +487,9 @@ 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 + // (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 @@ -604,9 +600,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](https://cloud.google.com/storage/docs/viewing-editing-metada - // ta) 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 @@ -840,9 +836,10 @@ 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 + // (/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`, @@ -1965,9 +1962,10 @@ 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 +// (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", @@ -1985,8 +1983,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2025,9 +2023,9 @@ 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 + // (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 @@ -2073,12 +2071,12 @@ 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 + // (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: // `//cloudresourcemanager.googleapis.com/projects/my_project_123` For // third-party assets, this field may be set differently. Parent string `json:"parent,omitempty"` @@ -2117,11 +2115,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](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. @@ -2547,11 +2545,10 @@ 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 +// (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 @@ -3063,11 +3060,10 @@ 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 +// (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 448ca417c62..b4caacf59c3 100644 --- a/cloudasset/v1p1beta1/cloudasset-gen.go +++ b/cloudasset/v1p1beta1/cloudasset-gen.go @@ -261,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -443,9 +442,9 @@ 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 + // (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 @@ -511,9 +510,10 @@ 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 +// (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", @@ -531,8 +531,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -571,9 +571,9 @@ 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 + // (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 @@ -694,10 +694,10 @@ 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 + // (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 @@ -706,16 +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](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. + // s/instance1`. See Resource Names + // (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, // 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 + // (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 f9229e76f82..b21ce3c3580 100644 --- a/cloudasset/v1p4beta1/cloudasset-gen.go +++ b/cloudasset/v1p4beta1/cloudasset-gen.go @@ -236,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -680,8 +679,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), + // 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 - // serviceAccount:s1@prj1.iam.gserviceaccount.com - // projectOwner:some_project_id - domain:google.com - allUsers - etc. @@ -754,9 +753,8 @@ 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 + // (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 @@ -863,12 +861,10 @@ 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 + // (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. @@ -906,9 +902,9 @@ 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 + // (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 @@ -951,9 +947,9 @@ 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 + // 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", // "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice @@ -1133,11 +1129,10 @@ 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 + // (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#analyzable_asset_types). FullResourceName string `json:"fullResourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "FullResourceName") to @@ -1166,11 +1161,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](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. @@ -1244,8 +1239,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 +// 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 @@ -1258,11 +1253,10 @@ 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 +// (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#analyzable_asset_types). func (c *V1p4beta1AnalyzeIamPolicyCall) AnalysisQueryResourceSelectorFullResourceName(analysisQueryResourceSelectorFullResourceName string) *V1p4beta1AnalyzeIamPolicyCall { c.urlParams_.Set("analysisQuery.resourceSelector.fullResourceName", analysisQueryResourceSelectorFullResourceName) return c @@ -1297,14 +1291,14 @@ 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 +// (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 f5b6e68924e..b1a2dc210dd 100644 --- a/cloudasset/v1p5beta1/cloudasset-gen.go +++ b/cloudasset/v1p5beta1/cloudasset-gen.go @@ -145,38 +145,36 @@ 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 +// (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#a - // ccess-levels). + // 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](https://cloud.google.com/access-context-manager/docs/overview#a - // ccess-policies). + // 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](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 + // (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: - // `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 + // (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 @@ -185,30 +183,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 + // the resource's ancestry resource levels in the hierarchy. See this + // 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](https://cloud.google.com/apis/design/resource_names#full_resour - // ce_name) for more information. + // s/instance1` See Resource names + // (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-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 + // (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. 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 (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 @@ -339,9 +336,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -663,9 +659,10 @@ 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 + // (/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`, @@ -1736,9 +1733,10 @@ 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 +// (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", @@ -1756,8 +1754,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1796,9 +1794,9 @@ 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 + // (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 @@ -1844,12 +1842,12 @@ 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 + // (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: // `//cloudresourcemanager.googleapis.com/projects/my_project_123` For // third-party assets, this field may be set differently. Parent string `json:"parent,omitempty"` @@ -1912,14 +1910,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](https://github.com/google/re2/wiki/Syntax) for +// "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. +// 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 6ceef5cbb4b..6b906cccbbe 100644 --- a/cloudbilling/v1/cloudbilling-gen.go +++ b/cloudbilling/v1/cloudbilling-gen.go @@ -345,19 +345,19 @@ 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 +// (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](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 + // (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"` // Name: Output only. The resource name of the billing account. The @@ -407,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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,9 +822,10 @@ 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 +// (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", @@ -843,8 +843,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -883,9 +883,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1263,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -1385,15 +1385,14 @@ 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 +// (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 @@ -1521,8 +1520,8 @@ 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 +// (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 @@ -1670,9 +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](https://cloud.google.com/billing/docs/how-to/billing-access) -// . +// 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 @@ -1686,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -1839,8 +1836,8 @@ 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 +// (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 @@ -1848,9 +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](https://cloud.google.com/billing/docs/concepts) 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 { @@ -2042,9 +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](https://cloud.google.com/billing/docs/how-to/billing-a -// ccess) 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 @@ -2201,9 +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](https://cloud.google.com/billing/docs/how-to/billing- -// access). +// 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 @@ -2492,9 +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](https://cloud.google.com/billing/docs/how-to/billing-access) -// . +// 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 @@ -2690,9 +2685,8 @@ 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 +// (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 @@ -2850,11 +2844,11 @@ 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 +// 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 diff --git a/cloudbuild/v1/cloudbuild-gen.go b/cloudbuild/v1/cloudbuild-gen.go index 20c442c35ca..a3572ac94aa 100644 --- a/cloudbuild/v1/cloudbuild-gen.go +++ b/cloudbuild/v1/cloudbuild-gen.go @@ -220,10 +220,10 @@ 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 + // (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"` // Paths: Path globs used to match files in the build's workspace. @@ -377,9 +377,9 @@ 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 + // (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"` @@ -690,13 +690,13 @@ 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 + // (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 @@ -1611,8 +1611,8 @@ 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) + // 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. BuildStepOutputs []string `json:"buildStepOutputs,omitempty"` @@ -1876,11 +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](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. @@ -1921,10 +1921,9 @@ 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 + // (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 cfb0b90cd99..519745ef0db 100644 --- a/cloudbuild/v1alpha1/cloudbuild-gen.go +++ b/cloudbuild/v1alpha1/cloudbuild-gen.go @@ -184,10 +184,10 @@ 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 + // (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"` // Paths: Path globs used to match files in the build's workspace. @@ -341,9 +341,9 @@ 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 + // (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"` @@ -650,13 +650,13 @@ 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 + // (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 @@ -1305,8 +1305,8 @@ 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) + // 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. BuildStepOutputs []string `json:"buildStepOutputs,omitempty"` @@ -1535,11 +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](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. @@ -1580,10 +1580,9 @@ 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 + // (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 cd774c3a1dc..813b72227b6 100644 --- a/cloudbuild/v1alpha2/cloudbuild-gen.go +++ b/cloudbuild/v1alpha2/cloudbuild-gen.go @@ -184,10 +184,10 @@ 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 + // (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"` // Paths: Path globs used to match files in the build's workspace. @@ -341,9 +341,9 @@ 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 + // (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"` @@ -650,13 +650,13 @@ 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 + // (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 @@ -1298,8 +1298,8 @@ 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) + // 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. BuildStepOutputs []string `json:"buildStepOutputs,omitempty"` @@ -1528,11 +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](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. @@ -1573,10 +1573,9 @@ 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 + // (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 5a4eb357e07..f02e29bfd91 100644 --- a/clouderrorreporting/v1beta1/clouderrorreporting-gen.go +++ b/clouderrorreporting/v1beta1/clouderrorreporting-gen.go @@ -576,22 +576,21 @@ 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()` + // (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.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). Message string `json:"message,omitempty"` // ServiceContext: Required. The service context in which this error has @@ -981,8 +980,9 @@ 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` +// (/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 @@ -990,8 +990,9 @@ 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` +// (/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.service +// ). func (c *ProjectsEventsListCall) ServiceFilterService(serviceFilterService string) *ProjectsEventsListCall { c.urlParams_.Set("serviceFilter.service", serviceFilterService) return c @@ -999,8 +1000,9 @@ 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` +// (/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.version +// ). func (c *ProjectsEventsListCall) ServiceFilterVersion(serviceFilterVersion string) *ProjectsEventsListCall { c.urlParams_.Set("serviceFilter.version", serviceFilterVersion) return c @@ -1237,10 +1239,10 @@ 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 +// (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 { c := &ProjectsEventsReportCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -1460,8 +1462,9 @@ 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` +// (/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 @@ -1469,8 +1472,9 @@ 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` +// (/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.service +// ). func (c *ProjectsGroupStatsListCall) ServiceFilterService(serviceFilterService string) *ProjectsGroupStatsListCall { c.urlParams_.Set("serviceFilter.service", serviceFilterService) return c @@ -1478,8 +1482,9 @@ 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` +// (/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 0afeb2a2267..e833cb6c109 100644 --- a/cloudfunctions/v1/cloudfunctions-gen.go +++ b/cloudfunctions/v1/cloudfunctions-gen.go @@ -285,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -480,9 +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](https://cloud.google.com/functions/docs/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 @@ -498,15 +497,15 @@ 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 + // 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. 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 (/sdk/gcloud/reference/functions/deploy#--runtime). Runtime string `json:"runtime,omitempty"` // ServiceAccountEmail: The email of the function's service account. If @@ -558,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](https://cloud.google.com/compute/docs/vpc) - // 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, @@ -1177,9 +1176,10 @@ 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 +// (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", @@ -1197,8 +1197,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1237,9 +1237,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1360,11 +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](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. @@ -1407,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2045,8 +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](https://cloud.google.com/functions/quotas#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 @@ -2920,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 a62478ccaf4..638ad8dd734 100644 --- a/cloudidentity/v1/cloudidentity-gen.go +++ b/cloudidentity/v1/cloudidentity-gen.go @@ -382,8 +382,8 @@ 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: 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 @@ -445,8 +445,8 @@ 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: 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 @@ -508,8 +508,8 @@ 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: 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 @@ -572,8 +572,8 @@ 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: 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 @@ -697,8 +697,8 @@ 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 + // 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. @@ -908,10 +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](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 + // (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, @@ -1025,8 +1025,8 @@ 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 + // 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"` @@ -1193,8 +1193,8 @@ 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 + // 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 @@ -1235,8 +1235,8 @@ 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: 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 @@ -1299,8 +1299,8 @@ 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: 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 @@ -1391,9 +1391,9 @@ 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 + // (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 @@ -1566,8 +1566,8 @@ 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 + // Name: The resource name + // (https://cloud.google.com/apis/design/resource_names) of the // looked-up `Group`. Name string `json:"name,omitempty"` @@ -1601,8 +1601,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 + // 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"` @@ -1694,8 +1694,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 + // 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"` @@ -2065,11 +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](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. @@ -2300,8 +2300,8 @@ 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 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 @@ -2439,8 +2439,8 @@ 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 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 @@ -2583,8 +2583,8 @@ 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 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 @@ -2741,8 +2741,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 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 @@ -2756,10 +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](https://developers.google.com/admin-sdk/directory/v1/search-op -// erators). 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 @@ -3555,8 +3554,8 @@ 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 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 @@ -3699,8 +3698,8 @@ 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 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 @@ -3858,8 +3857,8 @@ 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 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 @@ -3871,10 +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](https://developers.google.com/admin-sdk/directory/v1/search-op -// erators). 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 @@ -4110,9 +4108,8 @@ 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 +// (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 @@ -4494,8 +4491,8 @@ 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 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 @@ -4653,8 +4650,8 @@ 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 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 @@ -4877,8 +4874,8 @@ 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 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 @@ -5694,9 +5691,9 @@ 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 +// (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 @@ -6043,10 +6040,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](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 +// (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) @@ -7229,8 +7226,8 @@ type GroupsMembershipsLookupCall struct { header_ http.Header } -// Lookup: Looks up the [resource -// name](https://cloud.google.com/apis/design/resource_names) of a +// 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)} diff --git a/cloudidentity/v1beta1/cloudidentity-gen.go b/cloudidentity/v1beta1/cloudidentity-gen.go index 423a298304a..0f18291e0b4 100644 --- a/cloudidentity/v1beta1/cloudidentity-gen.go +++ b/cloudidentity/v1beta1/cloudidentity-gen.go @@ -266,8 +266,8 @@ 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: 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 @@ -329,8 +329,8 @@ 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: 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 @@ -392,8 +392,8 @@ 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: 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 @@ -456,8 +456,8 @@ 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: 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 @@ -614,8 +614,8 @@ 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 + // 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. @@ -662,8 +662,8 @@ 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: 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 @@ -853,10 +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](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 + // (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, @@ -970,8 +970,8 @@ 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 + // 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"` @@ -1475,8 +1475,8 @@ 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 + // 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. @@ -1682,10 +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](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 + // (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, @@ -1795,8 +1795,8 @@ 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 + // 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"` @@ -1938,9 +1938,9 @@ 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 + // (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 @@ -2221,8 +2221,8 @@ 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 + // Name: Output only. The resource name + // (https://cloud.google.com/apis/design/resource_names) of the // looked-up `Group`. Name string `json:"name,omitempty"` @@ -2256,8 +2256,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 + // 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"` @@ -2296,8 +2296,8 @@ 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 + // 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 @@ -2401,8 +2401,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 + // 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"` @@ -2785,11 +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](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. @@ -2894,8 +2894,8 @@ 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: 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 @@ -2958,8 +2958,8 @@ 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: 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 @@ -3299,8 +3299,8 @@ 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 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 @@ -3443,8 +3443,8 @@ 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 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. func (c *DevicesGetCall) Customer(customer string) *DevicesGetCall { @@ -3596,8 +3596,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 sets the optional parameter "customer": Required. Resource +// name (https://cloud.google.com/apis/design/resource_names) of the // customer. func (c *DevicesListCall) Customer(customer string) *DevicesListCall { c.urlParams_.Set("customer", customer) @@ -3606,10 +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](https://developers.google.com/admin-sdk/directory/v1/search-op -// erators). 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 @@ -4402,8 +4401,8 @@ 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 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 @@ -4546,8 +4545,8 @@ 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 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 @@ -4703,8 +4702,8 @@ 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 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 @@ -4716,10 +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](https://developers.google.com/admin-sdk/directory/v1/search-op -// erators). 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 @@ -4952,9 +4950,8 @@ 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 +// (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 @@ -5327,8 +5324,8 @@ 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 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 @@ -5488,8 +5485,8 @@ 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 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 @@ -6305,9 +6302,9 @@ 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 +// (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 @@ -6654,10 +6651,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](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 +// (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) @@ -7831,8 +7828,8 @@ type GroupsMembershipsLookupCall struct { header_ http.Header } -// Lookup: Looks up the [resource -// name](https://cloud.google.com/apis/design/resource_names) of a +// 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)} diff --git a/cloudiot/v1/cloudiot-gen.go b/cloudiot/v1/cloudiot-gen.go index c61e4616fd0..4eb3b2c007e 100644 --- a/cloudiot/v1/cloudiot-gen.go +++ b/cloudiot/v1/cloudiot-gen.go @@ -285,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -921,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -1219,9 +1217,10 @@ 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 +// (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", @@ -1239,8 +1238,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 (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 @@ -1275,9 +1274,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1545,11 +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](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. @@ -1592,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 a9eee89da56..936f9d9027a 100644 --- a/cloudkms/v1/cloudkms-gen.go +++ b/cloudkms/v1/cloudkms-gen.go @@ -534,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -649,7 +648,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 (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 @@ -1460,8 +1459,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 (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 @@ -1950,9 +1949,10 @@ 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 +// (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", @@ -1970,8 +1970,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2010,9 +2010,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2087,10 +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](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 (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"` @@ -2181,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2278,10 +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](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 (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"` @@ -2983,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -3144,8 +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](https://cloud.google.com/kms/docs/sorting-and-filtering). +// 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 @@ -3153,9 +3152,9 @@ 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 +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -4264,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -4425,8 +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](https://cloud.google.com/kms/docs/sorting-and-filtering). +// 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 @@ -4434,9 +4432,9 @@ 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 +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsCryptoKeysListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsCryptoKeysListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -6270,8 +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](https://cloud.google.com/kms/docs/sorting-and-filtering). +// 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 @@ -6279,9 +6277,9 @@ 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 +// (https://cloud.google.com/kms/docs/sorting-and-filtering). func (c *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall) OrderBy(orderBy string) *ProjectsLocationsKeyRingsCryptoKeysCryptoKeyVersionsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -7127,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -7288,8 +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](https://cloud.google.com/kms/docs/sorting-and-filtering). +// 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 @@ -7297,9 +7294,9 @@ 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 +// (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 ab72cdc421b..d464ab81b7c 100644 --- a/cloudprofiler/v2/cloudprofiler-gen.go +++ b/cloudprofiler/v2/cloudprofiler-gen.go @@ -227,16 +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]([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". + // 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: @@ -246,8 +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]([-a-z0-9_.]{0,253}[a-z0-9])?$`. + // 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 5f8257bbc40..c2e2e9fa902 100644 --- a/cloudresourcemanager/v1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v1/cloudresourcemanager-gen.go @@ -333,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -594,11 +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](/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. +// 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. @@ -1066,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -1673,9 +1671,10 @@ 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 + // (/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`, @@ -1838,9 +1837,10 @@ 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 +// (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", @@ -1858,8 +1858,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1898,9 +1898,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2258,11 +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](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. @@ -2305,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -6562,8 +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](https://cloud.google.com/apis/design/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 @@ -7411,14 +7411,14 @@ 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 +// (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 // 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 +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](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 +// (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 7777906bbdf..908b8919732 100644 --- a/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go @@ -297,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -807,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -1074,9 +1072,10 @@ 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 +// (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", @@ -1094,8 +1093,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1134,9 +1133,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1369,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2989,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](/apis/design/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 6be221c6cae..9dae4b2585a 100644 --- a/cloudresourcemanager/v2/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v2/cloudresourcemanager-gen.go @@ -269,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -789,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -1001,9 +999,10 @@ 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 +// (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", @@ -1021,8 +1020,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1061,9 +1060,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1260,11 +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](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. @@ -1307,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 cdf398d302d..5286f971b17 100644 --- a/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go @@ -269,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -789,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -1001,9 +999,10 @@ 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 +// (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", @@ -1021,8 +1020,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1061,9 +1060,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1260,11 +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](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. @@ -1307,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 d1bc0341f9c..d91ec97ea8f 100644 --- a/cloudscheduler/v1/cloudscheduler-gen.go +++ b/cloudscheduler/v1/cloudscheduler-gen.go @@ -255,22 +255,20 @@ 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 +// (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-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 + // (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] + '.' + @@ -295,15 +293,14 @@ 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 + // (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 @@ -389,16 +386,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 + // 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](https://developers.google.com/identity/protocols/OpenIDConnect) - // token will be generated and attached as an `Authorization` header in + // 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. @@ -467,14 +464,14 @@ 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 - // 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. + // Identifying projects + // (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. @@ -485,17 +482,17 @@ 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 + // (http://en.wikipedia.org/wiki/Cron#Overview) * English-like schedule + // (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 + // 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,7 +523,7 @@ 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 + // 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 @@ -690,21 +687,21 @@ 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 +// (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](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 + // (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 @@ -730,22 +727,22 @@ 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 +// (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](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 + // (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 @@ -779,9 +776,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] +// 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 { @@ -852,10 +849,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](https://cloud.google.com/pubsub/docs/reference/r - // pc/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. + // PublishRequest.name + // (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 @@ -964,11 +961,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](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/cloudscheduler/v1beta1/cloudscheduler-gen.go b/cloudscheduler/v1beta1/cloudscheduler-gen.go index 14d2d89c853..68c7ea3b097 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-gen.go +++ b/cloudscheduler/v1beta1/cloudscheduler-gen.go @@ -255,22 +255,20 @@ 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 +// (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-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 + // (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] + '.' + @@ -295,15 +293,14 @@ 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 + // (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 @@ -389,16 +386,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 + // 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](https://developers.google.com/identity/protocols/OpenIDConnect) - // token will be generated and attached as an `Authorization` header in + // 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. @@ -474,14 +471,14 @@ 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 - // 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. + // Identifying projects + // (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. @@ -492,17 +489,17 @@ 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 + // (http://en.wikipedia.org/wiki/Cron#Overview) * English-like schedule + // (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 + // 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,7 +530,7 @@ 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 + // 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 @@ -697,21 +694,21 @@ 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 +// (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](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 + // (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 @@ -737,22 +734,22 @@ 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 +// (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](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 + // (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 @@ -786,9 +783,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] +// 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 { @@ -859,10 +856,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](https://cloud.google.com/pubsub/docs/reference/r - // pc/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. + // PublishRequest.name + // (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 @@ -999,11 +996,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](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/cloudsearch/v1/cloudsearch-gen.go b/cloudsearch/v1/cloudsearch-gen.go index cc74f738d43..dd6937d904b 100644 --- a/cloudsearch/v1/cloudsearch-gen.go +++ b/cloudsearch/v1/cloudsearch-gen.go @@ -915,9 +915,10 @@ 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 +// (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](/cloud-search/docs/guides/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,18 +4587,17 @@ 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 + // (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)](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. + // 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/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 @@ -5280,8 +5280,8 @@ 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 + // (https://support.google.com/a/users/answer/9299929) Query string `json:"query,omitempty"` // QueryInterpretationOptions: Options to interpret the user query. @@ -5763,11 +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](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. @@ -9435,21 +9435,19 @@ 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 -// 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. +// that can not be inlined during index requests +// (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-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 @@ -10041,9 +10039,9 @@ 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 +// (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 @@ -10172,9 +10170,9 @@ 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 +// (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 @@ -10303,10 +10301,9 @@ 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 +// (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 @@ -10345,8 +10342,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](https://support.google.com/a/answer/9043922). +// 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 @@ -10355,13 +10352,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)](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) +// (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 aac12f029e3..d84bcff981a 100644 --- a/cloudshell/v1/cloudshell-gen.go +++ b/cloudshell/v1/cloudshell-gen.go @@ -643,11 +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](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/cloudshell/v1alpha1/cloudshell-gen.go b/cloudshell/v1alpha1/cloudshell-gen.go index d6e12a92d52..6b0f513373f 100644 --- a/cloudshell/v1alpha1/cloudshell-gen.go +++ b/cloudshell/v1alpha1/cloudshell-gen.go @@ -586,11 +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](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/cloudtasks/v2/cloudtasks-gen.go b/cloudtasks/v2/cloudtasks-gen.go index f0fc4259ce9..bbcc2dc9456 100644 --- a/cloudtasks/v2/cloudtasks-gen.go +++ b/cloudtasks/v2/cloudtasks-gen.go @@ -185,16 +185,16 @@ 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 +// `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-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, @@ -205,23 +205,22 @@ type ProjectsLocationsQueuesTasksService struct { // 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. +// 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 // app_engine_routing_override is set on the queue, this value is used @@ -252,26 +251,24 @@ 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 - // 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/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 // 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 + // (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 @@ -317,41 +314,39 @@ 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 +// (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` 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 + // (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-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 + // (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 @@ -449,9 +444,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -523,7 +517,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 + // Google IAM (https://cloud.google.com/iam/) permission on the Task // resource. // // Possible values: @@ -696,9 +690,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -783,16 +776,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 + // 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](https://developers.google.com/identity/protocols/OpenIDConnect) - // token will be generated and attached as an `Authorization` header in + // 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. @@ -994,21 +987,21 @@ 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 +// (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](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 + // (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 @@ -1034,22 +1027,22 @@ 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 +// (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](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 + // (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 @@ -1090,9 +1083,10 @@ 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 +// (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", @@ -1110,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 (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 @@ -1146,9 +1140,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1200,21 +1194,20 @@ 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 - // 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. + // Identifying projects + // (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/taskq - // ueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). + // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud + // Console + // (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"` @@ -1241,20 +1234,21 @@ 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 + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks). 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 (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](https://cloud.google.com/appengine/docs/python/config - // /queueref). 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. @@ -1317,8 +1311,8 @@ 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 + // 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. @@ -1327,13 +1321,12 @@ type RateLimits struct { // 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_dispatches_per_second is updated. + // `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_dispatches_per_second is updated. MaxBurstSize int64 `json:"maxBurstSize,omitempty"` // MaxConcurrentDispatches: The maximum number of concurrent tasks that @@ -1342,17 +1335,15 @@ 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 + // (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/pytho - // n/config/queueref#rate). + // 500. This field has the same meaning as rate in queue.yaml/xml + // (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 @@ -1404,9 +1395,8 @@ 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 + // (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 @@ -1414,9 +1404,8 @@ 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 + // (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` @@ -1430,9 +1419,8 @@ 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 + // (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 @@ -1442,9 +1430,9 @@ 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 + // (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 @@ -1452,9 +1440,8 @@ 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 + // (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 @@ -1489,7 +1476,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 + // Google IAM (https://cloud.google.com/iam/) permission on the Task // resource. // // Possible values: @@ -1559,10 +1546,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { } // StackdriverLoggingConfig: Configuration options for writing logs to -// [Stackdriver Logging](https://cloud.google.com/logging/docs/). +// Stackdriver Logging (https://cloud.google.com/logging/docs/). type StackdriverLoggingConfig struct { // SamplingRatio: Specifies the fraction of operations to write to - // [Stackdriver Logging](https://cloud.google.com/logging/docs/). This + // 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"` @@ -1606,11 +1593,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](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. @@ -1675,19 +1662,19 @@ 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 + // (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. @@ -1707,16 +1694,15 @@ 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 - // 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. + // Identifying projects + // (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 @@ -1777,8 +1763,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2201,9 +2187,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](https://cloud.google.com/tasks/docs/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 @@ -2346,10 +2332,10 @@ 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 +// (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 @@ -2626,9 +2612,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](https://cloud.google.com/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 @@ -2778,11 +2764,11 @@ 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 +// (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 @@ -2989,10 +2975,10 @@ 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 +// (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 @@ -3437,8 +3423,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](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). +// 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 @@ -3582,8 +3568,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 (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 @@ -4155,8 +4141,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 +// (https://cloud.google.com/iam/) permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -4362,8 +4348,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 +// (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 2e09992fc61..36ad2ef77e0 100644 --- a/cloudtasks/v2beta2/cloudtasks-gen.go +++ b/cloudtasks/v2beta2/cloudtasks-gen.go @@ -218,16 +218,16 @@ 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 +// `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-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, @@ -238,23 +238,22 @@ func (s *AcknowledgeTaskRequest) MarshalJSON() ([]byte, error) { // 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. +// 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 @@ -279,26 +278,24 @@ 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 + // (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 // 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 + // (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 @@ -350,10 +347,10 @@ 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` +// (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 { // AppEngineRoutingOverride: Overrides for the task-level // app_engine_routing. If set, `app_engine_routing_override` is used for @@ -388,23 +385,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](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 +// (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-re - // quests-are-routed). The host is constructed as: * `host = - // [application_domain_name]` `| [service] + '.' + - // [application_domain_name]` `| [version] + '.' + + // 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] + '.' + // [application_domain_name]` `| [instance_dot_service] + '.' + @@ -430,15 +425,14 @@ 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 + // (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 @@ -535,9 +529,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -610,7 +603,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 + // Google IAM (https://cloud.google.com/iam/) permission on the Task // resource. // // Possible values: @@ -663,7 +656,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 + // Google IAM (https://cloud.google.com/iam/) permission on the Task // resource. // // Possible values: @@ -837,9 +830,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -879,9 +871,8 @@ 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-), + // 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. @@ -912,7 +903,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 + // Google IAM (https://cloud.google.com/iam/) permission on the Task // resource. // // Possible values: @@ -1163,9 +1154,10 @@ 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 +// (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", @@ -1183,8 +1175,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 (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 @@ -1219,9 +1211,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1265,8 +1257,8 @@ 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-), + // 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. @@ -1317,14 +1309,13 @@ 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 - // 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. + // Identifying projects + // (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 @@ -1333,9 +1324,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). + // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud + // Console + // (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"` @@ -1357,15 +1348,16 @@ 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 + // (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 // 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 + // (https://cloud.google.com/appengine/docs/python/config/queueref). + // UpdateQueue cannot be used to change `state`. // // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -1503,7 +1495,7 @@ 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) + // 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 @@ -1513,12 +1505,11 @@ type RateLimits struct { // `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 + // (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 @@ -1529,9 +1520,8 @@ 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 + // (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 @@ -1540,9 +1530,8 @@ 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 + // (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 @@ -1596,7 +1585,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 + // Google IAM (https://cloud.google.com/iam/) permission on the Task // resource. // // Possible values: @@ -1660,9 +1649,8 @@ 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 + // (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` @@ -1677,9 +1665,8 @@ 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 + // (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 @@ -1690,9 +1677,8 @@ 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 + // (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 @@ -1701,9 +1687,8 @@ 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 + // (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. @@ -1741,7 +1726,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 + // Google IAM (https://cloud.google.com/iam/) permission on the Task // resource. // // Possible values: @@ -1813,11 +1798,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](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. @@ -1872,16 +1857,15 @@ 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 - // 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. + // Identifying projects + // (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 @@ -1997,8 +1981,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2421,9 +2405,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](https://cloud.google.com/tasks/docs/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 @@ -2566,10 +2550,10 @@ 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 +// (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 @@ -2863,9 +2847,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](https://cloud.google.com/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 @@ -3015,11 +2999,11 @@ 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 +// (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 @@ -3243,10 +3227,10 @@ 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 +// (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 @@ -3691,8 +3675,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](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). +// 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 @@ -3836,8 +3820,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 (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 @@ -4699,8 +4683,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 +// (https://cloud.google.com/iam/) permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -5056,8 +5040,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 +// (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 da3695cb4b2..3f3e4fa0575 100644 --- a/cloudtasks/v2beta3/cloudtasks-gen.go +++ b/cloudtasks/v2beta3/cloudtasks-gen.go @@ -186,10 +186,10 @@ 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` +// (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 // app_engine_routing. If set, `app_engine_routing_override` is used for @@ -225,16 +225,16 @@ 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 +// `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-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, @@ -245,23 +245,22 @@ func (s *AppEngineHttpQueue) MarshalJSON() ([]byte, error) { // 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. +// 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 @@ -291,26 +290,24 @@ 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 - // 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/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 // 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 + // (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 @@ -356,38 +353,35 @@ 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 +// (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 // 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 + // (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-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 + // (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 @@ -485,9 +479,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -559,7 +552,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 + // Google IAM (https://cloud.google.com/iam/) permission on the Task // resource. // // Possible values: @@ -732,9 +725,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -819,16 +811,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 + // 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](https://developers.google.com/identity/protocols/OpenIDConnect) - // token will be generated and attached as an `Authorization` header in + // 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. @@ -1030,21 +1022,21 @@ 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 +// (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](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 + // (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 @@ -1070,22 +1062,22 @@ 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 +// (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](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 + // (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 @@ -1126,9 +1118,10 @@ 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 +// (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,8 +1139,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 (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,9 +1175,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1225,8 +1218,8 @@ 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-), + // 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. @@ -1274,21 +1267,20 @@ 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 - // 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. + // Identifying projects + // (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/taskq - // ueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue). + // purged using PurgeQueue, the App Engine Task Queue SDK, or the Cloud + // Console + // (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"` @@ -1315,20 +1307,21 @@ 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 + // (https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks). 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 (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](https://cloud.google.com/appengine/docs/python/config - // /queueref). 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. @@ -1474,7 +1467,7 @@ 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) + // 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 @@ -1484,12 +1477,11 @@ type RateLimits struct { // `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 + // (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 @@ -1498,18 +1490,16 @@ 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 + // (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. * 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 + // (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 @@ -1561,9 +1551,8 @@ 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 + // (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 @@ -1571,9 +1560,8 @@ 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 + // (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` @@ -1587,9 +1575,8 @@ 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 + // (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 @@ -1599,9 +1586,9 @@ 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 + // (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 @@ -1609,9 +1596,8 @@ 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 + // (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 @@ -1646,7 +1632,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 + // Google IAM (https://cloud.google.com/iam/) permission on the Task // resource. // // Possible values: @@ -1716,10 +1702,10 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { } // StackdriverLoggingConfig: Configuration options for writing logs to -// [Stackdriver Logging](https://cloud.google.com/logging/docs/). +// Stackdriver Logging (https://cloud.google.com/logging/docs/). type StackdriverLoggingConfig struct { // SamplingRatio: Specifies the fraction of operations to write to - // [Stackdriver Logging](https://cloud.google.com/logging/docs/). This + // 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"` @@ -1763,11 +1749,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](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. @@ -1832,19 +1818,19 @@ 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 + // (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. @@ -1864,25 +1850,24 @@ 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 - // 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. + // Identifying projects + // (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. + // 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 @@ -1944,8 +1929,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2368,9 +2353,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](https://cloud.google.com/tasks/docs/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 @@ -2513,10 +2498,10 @@ 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 +// (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 @@ -2810,9 +2795,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](https://cloud.google.com/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 @@ -2962,11 +2947,11 @@ 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 +// (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 @@ -3190,10 +3175,10 @@ 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 +// (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 @@ -3638,8 +3623,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](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). +// 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 @@ -3783,8 +3768,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 (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 @@ -4356,8 +4341,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 +// (https://cloud.google.com/iam/) permission on the Task resource. // // Possible values: // "VIEW_UNSPECIFIED" - Unspecified. Defaults to BASIC. @@ -4563,8 +4548,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 +// (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 6ad663722e4..37b4bc44cc2 100644 --- a/cloudtrace/v2/cloudtrace-gen.go +++ b/cloudtrace/v2/cloudtrace-gen.go @@ -637,8 +637,8 @@ 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 (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 @@ -741,11 +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](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/cloudtrace/v2beta1/cloudtrace-gen.go b/cloudtrace/v2beta1/cloudtrace-gen.go index 7db5a8a4efd..c223c0e3e4f 100644 --- a/cloudtrace/v2beta1/cloudtrace-gen.go +++ b/cloudtrace/v2beta1/cloudtrace-gen.go @@ -267,13 +267,14 @@ 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 + // (/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 @@ -948,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/v1/composer-gen.go b/composer/v1/composer-gen.go index 7c625f24588..c95e1eee7d7 100644 --- a/composer/v1/composer-gen.go +++ b/composer/v1/composer-gen.go @@ -367,8 +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](/composer/docs/how-to/accessing/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 @@ -432,8 +432,8 @@ 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) + // 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. @@ -448,8 +448,8 @@ 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) + // 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. @@ -659,26 +659,25 @@ 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 + // (/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](/compute/docs/machine-types) used for cluster instances, - // specified as a [relative resource - // name](/apis/design/resource_names#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 @@ -688,20 +687,20 @@ 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 + // 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". 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 - // 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 @@ -717,9 +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](/apis/design/resource_names#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 @@ -728,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](https://www.ietf.org/rfc/rfc1035.txt). 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 @@ -837,8 +835,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 ( /apis/design/resource_names#relative_resource_name). Resource string `json:"resource,omitempty"` // ResourceUuid: Output only. The UUID of the resource being operated @@ -987,12 +985,11 @@ 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 + // 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. AirflowConfigOverrides map[string]string `json:"airflowConfigOverrides,omitempty"` @@ -1015,16 +1012,16 @@ 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 + // 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). + // 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 @@ -1068,11 +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](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/composer/v1beta1/composer-gen.go b/composer/v1beta1/composer-gen.go index 1d88c77ba56..cc596fcd290 100644 --- a/composer/v1beta1/composer-gen.go +++ b/composer/v1beta1/composer-gen.go @@ -430,8 +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](/composer/docs/how-to/accessing/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 @@ -519,8 +519,8 @@ 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) + // 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 @@ -537,8 +537,8 @@ 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) + // 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 @@ -752,8 +752,8 @@ 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 + // 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"` @@ -796,26 +796,25 @@ 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 + // (/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](/compute/docs/machine-types) used for cluster instances, - // specified as a [relative resource - // name](/apis/design/resource_names#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 @@ -825,8 +824,8 @@ 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 + // 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". MachineType string `json:"machineType,omitempty"` @@ -839,19 +838,18 @@ 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 - // 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 + // (/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 // `nodeConfig.subnetwork`. Network string `json:"network,omitempty"` @@ -868,9 +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](/apis/design/resource_names#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 @@ -879,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](https://www.ietf.org/rfc/rfc1035.txt). 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 @@ -988,8 +985,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 ( /apis/design/resource_names#relative_resource_name). Resource string `json:"resource,omitempty"` // ResourceUuid: Output only. The UUID of the resource being operated @@ -1141,12 +1138,11 @@ 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 + // 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. AirflowConfigOverrides map[string]string `json:"airflowConfigOverrides,omitempty"` @@ -1169,16 +1165,16 @@ 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 + // 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). + // 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 @@ -1222,11 +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](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/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index fa502876113..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: @@ -3347,9 +3345,9 @@ 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 (/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. @@ -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"` @@ -5187,11 +5186,10 @@ 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 +// (/compute/docs/reference/rest/{$api_version}/backendServices) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionBackendServices) // // For more information, see Backend Services. // @@ -6832,9 +6830,8 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -6958,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 // @@ -8165,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 @@ -8297,11 +8294,11 @@ 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 (/compute/docs/reference/rest/{$api_version}/disks) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionDisks) // -// 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. @@ -8463,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"` @@ -8485,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: @@ -8523,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"` @@ -8541,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"` @@ -8559,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"` @@ -8612,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 @@ -9050,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"` @@ -9082,10 +9081,9 @@ 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 +// (/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. @@ -10677,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"` @@ -11572,11 +11571,10 @@ 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 +// (/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. @@ -11598,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 @@ -11606,9 +11605,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](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_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. @@ -11853,9 +11852,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](/load-balancing/docs/forwarding-rule-concepts#port_spe - // cifications). + // 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 @@ -11915,9 +11913,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](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_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. @@ -13130,10 +13128,9 @@ 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 (/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 // (`compute.v1.regionHealthChecks`). @@ -13458,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 { @@ -13626,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 @@ -15729,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"` @@ -16110,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"` @@ -19904,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"` @@ -20141,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"` @@ -21025,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"` @@ -24504,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"` @@ -27212,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"` @@ -27257,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"` @@ -30229,16 +30236,16 @@ 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 +// (/compute/docs/reference/rest/{$api_version}/globalOperations) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionOperations) * +// Zonal +// (/compute/docs/reference/rest/{$api_version}/zoneOperations) // -// 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. @@ -32028,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 @@ -32366,9 +32374,8 @@ 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 +// (https://cloud.google.com/iam/help/conditions/resource-policies). // // **JSON example:** // @@ -32394,8 +32401,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](https://cloud.google.com/iam/docs/). +// 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. @@ -32456,9 +32463,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -37991,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 @@ -42442,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"` @@ -42598,11 +42605,10 @@ 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 +// (/compute/docs/reference/rest/{$api_version}/sslCertificates) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionSslCertificates) // // // @@ -45256,11 +45262,10 @@ 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 +// (/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. // @@ -45293,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"` @@ -45924,11 +45937,11 @@ 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 +// (/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. // @@ -45985,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"` @@ -46078,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"` @@ -46455,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"` @@ -47516,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"` @@ -47548,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"` @@ -49373,9 +49398,9 @@ 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 (/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. @@ -92714,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 { @@ -92728,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 { @@ -152886,8 +152913,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](/cdn/docs/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 @@ -184612,8 +184639,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](/cdn/docs/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 62898a553f5..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: @@ -3010,9 +3008,9 @@ 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 (/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. @@ -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"` @@ -4832,11 +4831,10 @@ 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 +// (/compute/docs/reference/rest/{$api_version}/backendServices) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionBackendServices) // // For more information, see Backend Services. // @@ -6405,9 +6403,8 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -7516,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 @@ -7648,11 +7644,11 @@ 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 (/compute/docs/reference/rest/{$api_version}/disks) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionDisks) // -// 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. @@ -7803,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"` @@ -7825,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: @@ -7863,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"` @@ -8345,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"` @@ -8377,10 +8374,9 @@ 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 +// (/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. @@ -9968,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"` @@ -10562,11 +10559,10 @@ 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 +// (/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. @@ -10588,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 @@ -10596,9 +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](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_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. @@ -10838,9 +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](/load-balancing/docs/forwarding-rule-concepts#port_spe - // cifications). + // 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 @@ -10896,9 +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](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_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. @@ -12043,10 +12039,9 @@ 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 (/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 // (`compute.v1.regionHealthChecks`). @@ -12364,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 { @@ -12528,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 @@ -14619,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"` @@ -18398,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"` @@ -18620,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"` @@ -22027,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"` @@ -24599,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"` @@ -24626,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"` @@ -27522,16 +27525,16 @@ 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 +// (/compute/docs/reference/rest/{$api_version}/globalOperations) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionOperations) * +// Zonal +// (/compute/docs/reference/rest/{$api_version}/zoneOperations) // -// 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. @@ -29284,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 @@ -29503,9 +29507,8 @@ 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 +// (https://cloud.google.com/iam/help/conditions/resource-policies). // // **JSON example:** // @@ -29531,8 +29534,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](https://cloud.google.com/iam/docs/). +// 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. @@ -29593,9 +29596,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -33796,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 @@ -37415,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"` @@ -37571,11 +37574,10 @@ 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 +// (/compute/docs/reference/rest/{$api_version}/sslCertificates) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionSslCertificates) // // // @@ -40086,11 +40088,10 @@ 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 +// (/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. // @@ -40123,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"` @@ -40721,11 +40730,11 @@ 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 +// (/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. // @@ -40767,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"` @@ -40856,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"` @@ -41233,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"` @@ -42285,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"` @@ -42317,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"` @@ -43839,9 +43860,9 @@ 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 (/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. @@ -84724,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 { @@ -84738,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 { @@ -133134,8 +133157,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](/cdn/docs/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 @@ -162557,8 +162580,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](/cdn/docs/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 a2eb54ca071..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: @@ -2920,9 +2918,9 @@ 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 (/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. @@ -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"` @@ -4492,11 +4491,10 @@ 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 +// (/compute/docs/reference/rest/{$api_version}/backendServices) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionBackendServices) // // For more information, see Backend Services. // @@ -5648,9 +5646,8 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` // Members: Specifies the identities requesting access for a Cloud @@ -6856,11 +6853,11 @@ 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 (/compute/docs/reference/rest/{$api_version}/disks) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionDisks) // -// 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. @@ -6994,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"` @@ -7016,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: @@ -7054,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"` @@ -7523,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"` @@ -7555,10 +7553,9 @@ 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 +// (/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. @@ -9131,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"` @@ -9551,11 +9549,10 @@ 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 +// (/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. @@ -9577,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 @@ -9585,9 +9583,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](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_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. @@ -9810,9 +9808,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](/load-balancing/docs/forwarding-rule-concepts#port_spe - // cifications). + // 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 @@ -9860,9 +9857,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](/load-balancing/docs/forwarding-rule-concepts#ip_addre - // ss_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. @@ -10971,10 +10968,9 @@ 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 (/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 // (`compute.v1.regionHealthChecks`). @@ -11292,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 { @@ -11439,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 @@ -13467,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"` @@ -17111,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"` @@ -17319,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"` @@ -22744,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"` @@ -22771,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"` @@ -25553,16 +25556,16 @@ 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 +// (/compute/docs/reference/rest/{$api_version}/globalOperations) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionOperations) * +// Zonal +// (/compute/docs/reference/rest/{$api_version}/zoneOperations) // -// 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. @@ -27221,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 @@ -27440,9 +27444,8 @@ 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 +// (https://cloud.google.com/iam/help/conditions/resource-policies). // // **JSON example:** // @@ -27468,8 +27471,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](https://cloud.google.com/iam/docs/). +// 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. @@ -27530,9 +27533,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -31676,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 @@ -34657,11 +34659,10 @@ 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 +// (/compute/docs/reference/rest/{$api_version}/sslCertificates) * +// Regional +// (/compute/docs/reference/rest/{$api_version}/regionSslCertificates) // // // @@ -37154,11 +37155,10 @@ 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 +// (/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. // @@ -37675,11 +37675,11 @@ 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 +// (/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. // @@ -37797,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"` @@ -38174,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"` @@ -39221,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"` @@ -39253,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"` @@ -40744,9 +40748,9 @@ 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 (/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. @@ -78126,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 { @@ -146870,8 +146875,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](/cdn/docs/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 ab102c0f4a7..61ef1ecb746 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -284,8 +284,8 @@ 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 + // (https://cloud.google.com/compute/docs/gpus) AcceleratorType string `json:"acceleratorType,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to @@ -418,7 +418,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 + // upgrades, in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text // format. AutoUpgradeStartTime string `json:"autoUpgradeStartTime,omitempty"` @@ -481,10 +481,9 @@ 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 + // (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. @@ -595,15 +594,15 @@ 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). + // 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 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 + // (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 @@ -749,8 +748,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) + // 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"` @@ -759,7 +758,7 @@ type Cluster struct { 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 (https://www.ietf.org/rfc/rfc3339.txt) text format. CreateTime string `json:"createTime,omitempty"` // CurrentMasterVersion: [Output only] The current software version of @@ -771,11 +770,10 @@ 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 + // (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"` @@ -809,7 +807,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 + // deleted in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text // format. ExpireTime string `json:"expireTime,omitempty"` @@ -827,11 +825,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](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 + // 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 @@ -851,25 +849,23 @@ 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 + // (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/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 + // (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/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,10 +910,10 @@ 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 + // (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. @@ -967,8 +963,8 @@ 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) + // 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"` @@ -1002,14 +998,14 @@ type Cluster struct { // 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 + // (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](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // 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"` @@ -1021,10 +1017,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](https://cloud.google.com/compute/docs/zones#available) 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 @@ -1059,9 +1054,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](https://cloud.google.com/compute/docs/zones#available) 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 @@ -1131,12 +1126,12 @@ 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 - // 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 @@ -1267,16 +1262,16 @@ 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 + // (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](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 + // (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 @@ -1364,24 +1359,23 @@ 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 + // (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 // 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). + // 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 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 + // (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 @@ -1422,16 +1416,16 @@ 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 + // (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](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 + // (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 @@ -1462,14 +1456,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](https://www.ietf.org/rfc/rfc3339.txt) format + // 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](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 + // (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 @@ -1842,8 +1836,8 @@ 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) + // 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. @@ -1868,8 +1862,8 @@ 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) + // 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. @@ -1884,8 +1878,8 @@ 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) + // 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. @@ -1908,8 +1902,8 @@ 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) + // 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. @@ -2542,7 +2536,7 @@ type NetworkConfig struct { PrivateIpv6GoogleAccess string `json:"privateIpv6GoogleAccess,omitempty"` // Subnetwork: Output only. The relative name of the Google Compute - // Engine [subnetwork](https://cloud.google.com/compute/docs/vpc) to + // 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"` @@ -2684,9 +2678,9 @@ 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 - // 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 @@ -2712,15 +2706,14 @@ 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 + // (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 // 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 + // (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 @@ -2729,11 +2722,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](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. + // 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 @@ -2743,9 +2735,9 @@ 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 + // (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. @@ -2857,24 +2849,23 @@ 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 + // (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](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 + // (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/re - // ference/rest/v1/projects.locations.clusters#Cluster.FIELDS.locations) + // 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/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"` @@ -3000,9 +2991,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](https://kubernetes.io/docs/concepts/configuration/taint-and-tol -// eration) for more information, including usage and the valid values. +// PreferNoSchedule or NoExecute. See here +// (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. // @@ -3052,15 +3043,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 + // (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](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 + // (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. @@ -3099,8 +3090,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 + // (https://www.ietf.org/rfc/rfc3339.txt) text format. StartTime string `json:"startTime,omitempty"` // Status: The current status of the operation. @@ -3120,10 +3111,10 @@ 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 + // (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"` // ServerResponse contains the HTTP response code and headers from the @@ -3434,10 +3425,10 @@ 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 +// (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. @@ -3576,15 +3567,15 @@ 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). + // 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 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 + // (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 @@ -3708,15 +3699,15 @@ 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). + // 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 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 + // (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 @@ -3762,19 +3753,19 @@ 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 + // (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](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 + // (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 @@ -3816,15 +3807,15 @@ 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). + // 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 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 + // (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 @@ -3857,12 +3848,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 + // (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 @@ -3870,15 +3861,15 @@ 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). + // 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 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 + // (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 @@ -3925,15 +3916,15 @@ 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). + // 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 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 + // (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 @@ -3974,13 +3965,13 @@ 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 (https://support.google.com/cloud/answer/6158840). 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 + // (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 @@ -4030,18 +4021,18 @@ 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). + // 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 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 + // (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 @@ -4090,15 +4081,15 @@ 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). + // 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 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 + // (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 @@ -4140,16 +4131,16 @@ 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 + // (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](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 + // (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 @@ -4194,15 +4185,15 @@ 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). + // 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 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 + // (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 @@ -4247,15 +4238,15 @@ 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). + // 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 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 + // (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 @@ -4300,15 +4291,15 @@ 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). + // 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 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 + // (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 @@ -4416,19 +4407,19 @@ 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 + // (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](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 + // (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 @@ -4542,18 +4533,18 @@ 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). + // 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 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 + // (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 @@ -4600,15 +4591,15 @@ 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). + // 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 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 + // (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 @@ -4644,11 +4635,11 @@ 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 + // (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. Locations []string `json:"locations,omitempty"` @@ -4671,8 +4662,8 @@ 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). + // 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 string `json:"projectId,omitempty"` @@ -4684,10 +4675,10 @@ 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 + // (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 @@ -5246,19 +5237,19 @@ 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 -// 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](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 +// (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 @@ -5553,13 +5544,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](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 +// (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 @@ -5719,19 +5710,19 @@ 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 -// 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](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 +// (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 @@ -5892,19 +5883,19 @@ 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 -// 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](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 +// (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 @@ -6214,19 +6205,19 @@ 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 -// 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](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 +// (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 @@ -6661,9 +6652,8 @@ 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) +// Use projects.locations.clusters.update +// (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)} @@ -8229,19 +8219,19 @@ 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 +// (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](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 +// (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 @@ -8415,19 +8405,19 @@ 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 +// (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](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 +// (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 @@ -8606,19 +8596,19 @@ 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 +// (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](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 +// (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 @@ -9482,10 +9472,10 @@ 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 +// (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 { c := &ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9782,19 +9772,19 @@ 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 -// 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](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 +// (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 @@ -9961,19 +9951,19 @@ 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 -// 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](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 +// (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 @@ -10614,13 +10604,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](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 +// (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 @@ -11442,8 +11432,8 @@ 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) +// projects.locations.clusters.update +// (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)} diff --git a/container/v1beta1/container-gen.go b/container/v1beta1/container-gen.go index 581b58391f6..bfa4104e3f7 100644 --- a/container/v1beta1/container-gen.go +++ b/container/v1beta1/container-gen.go @@ -284,8 +284,8 @@ 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 + // (https://cloud.google.com/compute/docs/gpus) AcceleratorType string `json:"acceleratorType,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to @@ -427,7 +427,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 + // upgrades, in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text // format. AutoUpgradeStartTime string `json:"autoUpgradeStartTime,omitempty"` @@ -489,10 +489,9 @@ 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 + // (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 @@ -501,11 +500,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](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. + // 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 @@ -648,15 +646,15 @@ 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 + // (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](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 (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 @@ -802,8 +800,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) + // 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"` @@ -818,7 +816,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 (https://www.ietf.org/rfc/rfc3339.txt) text format. CreateTime string `json:"createTime,omitempty"` // CurrentMasterVersion: [Output only] The current software version of @@ -830,11 +828,10 @@ 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 + // (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"` @@ -869,7 +866,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 + // deleted in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text // format. ExpireTime string `json:"expireTime,omitempty"` @@ -887,11 +884,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](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 + // 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 @@ -911,25 +908,23 @@ 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 + // (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/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 + // (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/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 @@ -984,11 +979,11 @@ 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 + // (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. @@ -1052,8 +1047,8 @@ 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) + // 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"` @@ -1086,18 +1081,18 @@ type Cluster struct { // 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 + // (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](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // 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"` @@ -1109,10 +1104,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](https://cloud.google.com/compute/docs/zones#available) 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 @@ -1147,9 +1141,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](https://cloud.google.com/compute/docs/zones#available) 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 @@ -1279,12 +1273,12 @@ 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 - // 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 @@ -1431,15 +1425,15 @@ 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 + // (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](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 (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 @@ -1558,9 +1552,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/v1b - // eta1/projects.locations.clusters) + // Cluster: Required. A cluster resource + // (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 @@ -1568,15 +1561,15 @@ 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 + // (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](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 (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 @@ -1618,15 +1611,15 @@ 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 + // (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](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 (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 @@ -2078,8 +2071,8 @@ 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) + // 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. @@ -2104,8 +2097,8 @@ 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) + // 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. @@ -2120,8 +2113,8 @@ 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) + // 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. @@ -2144,8 +2137,8 @@ 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) + // 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 @@ -2974,7 +2967,7 @@ type NetworkConfig struct { PrivateIpv6GoogleAccess string `json:"privateIpv6GoogleAccess,omitempty"` // Subnetwork: Output only. The relative name of the Google Compute - // Engine [subnetwork](https://cloud.google.com/compute/docs/vpc) to + // 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"` @@ -3127,8 +3120,8 @@ 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 + // (https://cloud.google.com/compute/docs/machine-types). If // unspecified, the default machine type is `e2-medium`. MachineType string `json:"machineType,omitempty"` @@ -3155,15 +3148,14 @@ 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 + // (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 // 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 + // (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 @@ -3172,11 +3164,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](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. + // 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 @@ -3186,9 +3177,9 @@ 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 + // (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. @@ -3262,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"` @@ -3342,24 +3337,23 @@ 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 + // (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](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 + // (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/re - // ference/rest/v1/projects.locations.clusters#Cluster.FIELDS.locations) + // 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/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"` @@ -3485,9 +3479,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](https://kubernetes.io/docs/concepts/configuration/taint-and-tol -// eration) for more information, including usage and the valid values. +// PreferNoSchedule or NoExecute. See here +// (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. // @@ -3567,18 +3561,18 @@ 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 + // (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](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 + // (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. @@ -3617,8 +3611,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 + // (https://www.ietf.org/rfc/rfc3339.txt) text format. StartTime string `json:"startTime,omitempty"` // Status: The current status of the operation. @@ -3638,10 +3632,10 @@ 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 + // (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"` // ServerResponse contains the HTTP response code and headers from the @@ -4019,10 +4013,10 @@ 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 +// (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. @@ -4163,15 +4157,15 @@ 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 + // (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](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 (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 @@ -4299,15 +4293,15 @@ 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 + // (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](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 (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 @@ -4354,18 +4348,18 @@ 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 + // (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](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 (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 @@ -4408,15 +4402,15 @@ 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 + // (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](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 (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 @@ -4449,12 +4443,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 + // (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 @@ -4463,15 +4457,15 @@ 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 + // (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](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 (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 @@ -4519,15 +4513,15 @@ 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 + // (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](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 (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 @@ -4568,13 +4562,13 @@ 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 (https://support.google.com/cloud/answer/6158840). 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 + // (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 @@ -4625,18 +4619,18 @@ 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 + // (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](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 (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 @@ -4686,15 +4680,15 @@ 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 + // (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](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 (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 @@ -4737,15 +4731,15 @@ 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 + // (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](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 (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 @@ -4792,15 +4786,15 @@ 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 + // (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](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 (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 @@ -4847,15 +4841,15 @@ 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 + // (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](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 (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 @@ -4902,15 +4896,15 @@ 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 + // (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](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 (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 @@ -5019,18 +5013,18 @@ 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 + // (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](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 (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 @@ -5058,11 +5052,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](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. @@ -5317,18 +5311,18 @@ 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 + // (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](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 (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 @@ -5376,15 +5370,15 @@ 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 + // (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](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 (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 @@ -5426,11 +5420,11 @@ 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 + // (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. Locations []string `json:"locations,omitempty"` @@ -5455,9 +5449,9 @@ 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 + // (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 @@ -5469,9 +5463,9 @@ 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 - // 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 @@ -6059,8 +6053,8 @@ 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 +// 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. func (c *ProjectsLocationsGetServerConfigCall) ProjectId(projectId string) *ProjectsLocationsGetServerConfigCall { c.urlParams_.Set("projectId", projectId) @@ -6068,10 +6062,10 @@ func (c *ProjectsLocationsGetServerConfigCall) ProjectId(projectId string) *Proj } // 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 +// (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 @@ -6510,13 +6504,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](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 +// (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 @@ -6676,8 +6670,8 @@ 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 +// 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. func (c *ProjectsLocationsClustersDeleteCall) ProjectId(projectId string) *ProjectsLocationsClustersDeleteCall { c.urlParams_.Set("projectId", projectId) @@ -6685,10 +6679,10 @@ func (c *ProjectsLocationsClustersDeleteCall) ProjectId(projectId string) *Proje } // 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 +// (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 @@ -6849,8 +6843,8 @@ 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 +// 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. func (c *ProjectsLocationsClustersGetCall) ProjectId(projectId string) *ProjectsLocationsClustersGetCall { c.urlParams_.Set("projectId", projectId) @@ -6858,10 +6852,10 @@ func (c *ProjectsLocationsClustersGetCall) ProjectId(projectId string) *Projects } // 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 +// (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 @@ -7171,8 +7165,8 @@ 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 +// 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. func (c *ProjectsLocationsClustersListCall) ProjectId(projectId string) *ProjectsLocationsClustersListCall { c.urlParams_.Set("projectId", projectId) @@ -7180,10 +7174,10 @@ func (c *ProjectsLocationsClustersListCall) ProjectId(projectId string) *Project } // 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 +// (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 @@ -7618,10 +7612,9 @@ 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 +// (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 @@ -9186,19 +9179,20 @@ 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 +// (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](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 +// (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 @@ -9372,19 +9366,20 @@ 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 +// (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](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 +// (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 @@ -9563,19 +9558,20 @@ 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 +// (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](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 +// (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 @@ -10439,10 +10435,10 @@ 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 +// (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 { c := &ProjectsLocationsClustersWellKnownGetOpenidConfigurationCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -10739,8 +10735,8 @@ 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 +// 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. func (c *ProjectsLocationsOperationsGetCall) ProjectId(projectId string) *ProjectsLocationsOperationsGetCall { c.urlParams_.Set("projectId", projectId) @@ -10748,10 +10744,10 @@ func (c *ProjectsLocationsOperationsGetCall) ProjectId(projectId string) *Projec } // 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 +// (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 @@ -10918,8 +10914,8 @@ 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 +// 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. func (c *ProjectsLocationsOperationsListCall) ProjectId(projectId string) *ProjectsLocationsOperationsListCall { c.urlParams_.Set("projectId", projectId) @@ -10927,10 +10923,10 @@ func (c *ProjectsLocationsOperationsListCall) ProjectId(projectId string) *Proje } // 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 +// (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 @@ -11571,13 +11567,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](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 +// (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 @@ -12399,9 +12395,9 @@ 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 +// (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 b2c8db2c54b..5453d3e700f 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -442,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1099,9 +1098,9 @@ 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 + // (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 @@ -1320,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -1944,9 +1942,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: 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 + // (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 @@ -2327,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 @@ -2391,9 +2390,10 @@ 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 +// (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", @@ -2411,8 +2411,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 (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 @@ -2447,9 +2447,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2766,11 +2766,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](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. @@ -2850,8 +2850,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -3065,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 7294122d485..940c7460bc0 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -567,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1151,10 +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](https://cpe.mitre.org/specification/) 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. @@ -1358,9 +1357,9 @@ 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 - // 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 @@ -1635,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 @@ -1750,9 +1750,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -2626,9 +2625,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](https://cpe.mitre.org/specification/) 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 @@ -2947,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 @@ -3011,9 +3011,10 @@ 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 +// (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", @@ -3031,8 +3032,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 (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 @@ -3067,9 +3068,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -3517,11 +3518,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](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. @@ -3564,8 +3565,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -3747,9 +3748,9 @@ 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 + // (https://cpe.mitre.org/specification/) format. Examples include + // distro or storage location for vulnerable jar. CpeUri string `json:"cpeUri,omitempty"` // Package: Required. The package being described. @@ -3816,10 +3817,10 @@ 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 - // 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 f6fdd4beece..1020404b9a0 100644 --- a/content/v2.1/content-gen.go +++ b/content/v2.1/content-gen.go @@ -6630,8 +6630,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 (/shopping-content/guides/order-tracking-signals). MerchantId int64 `json:"merchantId,omitempty,string"` // OrderCreatedTime: Required. The time when the order was created on @@ -11517,9 +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](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 + // (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. @@ -14464,8 +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](https://www.iana.org/time-zones). +// 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 4a83a8d2e85..c44303eedc9 100644 --- a/customsearch/v1/customsearch-gen.go +++ b/customsearch/v1/customsearch-gen.go @@ -147,10 +147,10 @@ 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 + // (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. @@ -297,8 +297,8 @@ 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 + // (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. @@ -308,9 +308,9 @@ 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 + // (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. @@ -431,9 +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](https://developers.google.com/custom-search/docs/refinements# - // create) (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. @@ -443,10 +443,10 @@ 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 + // (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 @@ -532,18 +532,18 @@ 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 + // (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#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 - // Engine [Control Panel](https://programmablesearchengine.google.com/). + // 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"` @@ -556,11 +556,11 @@ 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 + // (https://developers.google.com/custom-search/docs/xml_results#chineseSearch) + // 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,26 +580,25 @@ 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 + // (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](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 + // (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#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 + // parameter value. See Country Codes + // (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,15 +614,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](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 + // (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 @@ -668,9 +665,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](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 + // (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. @@ -686,12 +683,11 @@ 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 + // (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. @@ -758,18 +754,18 @@ 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 + // (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#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 - // Engine [Control Panel](https://programmablesearchengine.google.com/). + // 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"` @@ -782,11 +778,11 @@ 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 + // (https://developers.google.com/custom-search/docs/xml_results#chineseSearch) + // 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,26 +802,25 @@ 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 + // (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](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 + // (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#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 + // parameter value. See Country Codes + // (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"` @@ -841,15 +836,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](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 + // (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 @@ -894,9 +887,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](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 + // (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. @@ -912,12 +905,11 @@ 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 + // (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. @@ -984,18 +976,18 @@ 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 + // (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#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 - // Engine [Control Panel](https://programmablesearchengine.google.com/). + // 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"` @@ -1008,11 +1000,11 @@ 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 + // (https://developers.google.com/custom-search/docs/xml_results#chineseSearch) + // 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,26 +1024,25 @@ 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 + // (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](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 + // (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#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 + // parameter value. See Country Codes + // (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"` @@ -1067,15 +1058,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](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 + // (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 @@ -1120,9 +1109,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](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 + // (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. @@ -1138,12 +1127,11 @@ 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 + // (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. @@ -1293,9 +1281,9 @@ 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 + // (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 @@ -1343,26 +1331,26 @@ 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 +// (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 } // 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 +// (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 @@ -1404,22 +1392,21 @@ 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 +// (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](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 +// (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 @@ -1428,13 +1415,12 @@ 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 +// (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 @@ -1461,13 +1447,11 @@ 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 +// (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 { @@ -1628,9 +1612,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](https://wiki.creativecommons.org/wiki/CC_Search_integrat -// ion). +// 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 @@ -1690,9 +1673,8 @@ 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 +// (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 @@ -2111,26 +2093,26 @@ 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 +// (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 } // 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 +// (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,22 +2154,21 @@ 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 +// (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](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 +// (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 @@ -2196,13 +2177,12 @@ 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 +// (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 @@ -2229,13 +2209,11 @@ 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 +// (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 { @@ -2396,9 +2374,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](https://wiki.creativecommons.org/wiki/CC_Search_integrat -// ion). +// 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 @@ -2458,9 +2435,8 @@ 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 +// (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 8aaa5467d15..9bdd9504b26 100644 --- a/datacatalog/v1beta1/datacatalog-gen.go +++ b/datacatalog/v1beta1/datacatalog-gen.go @@ -296,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -471,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -676,11 +674,11 @@ 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 + // (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 @@ -985,10 +983,10 @@ 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: * + // 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. * @@ -1494,9 +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](https://cloud.google.com/data-catalog/docs/how-to/search-refer - // ence) 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 @@ -1638,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"` @@ -1860,8 +1859,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](https://cloud.google.com/data-catalog/docs/concepts/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. @@ -2016,12 +2015,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](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 +// create and attach the tag to GCP resources. Tag template roles +// (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. type GoogleCloudDatacatalogV1beta1TagTemplate struct { // DisplayName: The display name for this template. Defaults to an empty @@ -2235,9 +2234,10 @@ 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 +// (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", @@ -2255,8 +2255,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 (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 @@ -2291,9 +2291,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2359,8 +2359,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2438,9 +2438,9 @@ 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 +// (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)} c.googleclouddatacatalogv1beta1searchcatalogrequest = googleclouddatacatalogv1beta1searchcatalogrequest @@ -2599,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 @@ -2761,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 @@ -2920,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 @@ -3569,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 @@ -4024,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)} @@ -4182,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 @@ -4821,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,13 +5132,11 @@ 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 -// 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/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,13 +5754,11 @@ 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 -// 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/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 @@ -6379,9 +6377,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](https://cloud.google.com/data-catalog/docs/concepts/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 @@ -6538,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 @@ -6986,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 @@ -7440,9 +7438,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](https://cloud.google.com/data-catalog/docs/concepts/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 @@ -7603,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 @@ -7753,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 @@ -7916,9 +7914,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](https://cloud.google.com/data-catalog/docs/concepts/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 @@ -9284,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 @@ -10476,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 ed7a617c912..d8d5ecbe5bc 100644 --- a/dataflow/v1b3/dataflow-gen.go +++ b/dataflow/v1b3/dataflow-gen.go @@ -2164,10 +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](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 + // (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 @@ -2236,10 +2236,10 @@ 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 + // (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. @@ -5107,10 +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](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 + // (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 @@ -5183,10 +5183,10 @@ 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 + // (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. @@ -6449,11 +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](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. @@ -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/datafusion/v1/datafusion-gen.go b/datafusion/v1/datafusion-gen.go index dc1a433d622..52d146bcdb5 100644 --- a/datafusion/v1/datafusion-gen.go +++ b/datafusion/v1/datafusion-gen.go @@ -337,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -999,9 +998,10 @@ 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 +// (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", @@ -1019,8 +1019,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1059,9 +1059,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1135,11 +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](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. @@ -1182,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2097,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 dd31117b9a5..4f8f83a8d55 100644 --- a/datafusion/v1beta1/datafusion-gen.go +++ b/datafusion/v1beta1/datafusion-gen.go @@ -333,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -993,9 +992,10 @@ 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 +// (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", @@ -1013,8 +1013,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1053,9 +1053,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1140,11 +1140,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](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. @@ -1187,8 +1187,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2247,9 +2247,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 35eae3e9997..c4074fffe12 100644 --- a/datalabeling/v1beta1/datalabeling-gen.go +++ b/datalabeling/v1beta1/datalabeling-gen.go @@ -567,9 +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 + // 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"` @@ -1697,12 +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](/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 + // (/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 @@ -1731,10 +1730,10 @@ 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) + // (/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 @@ -1907,9 +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)](/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) + // (/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. @@ -2485,8 +2484,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 +// 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. type GoogleCloudDatalabelingV1beta1EvaluationJob struct { // AnnotationSpecSet: Required. Name of the AnnotationSpecSet describing @@ -2519,11 +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](/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 + // (/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"` @@ -2536,11 +2534,11 @@ 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. + // 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"` @@ -2677,9 +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](/ml-engine/docs/continuous-evaluation/create-job#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 @@ -3329,9 +3326,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 + // 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"` @@ -5746,9 +5743,9 @@ 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 - // 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 @@ -6360,9 +6357,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 + // 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"` @@ -7209,9 +7206,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 + // 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"` @@ -7952,11 +7949,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 099b7af6211..82560b271cf 100644 --- a/datamigration/v1beta1/datamigration-gen.go +++ b/datamigration/v1beta1/datamigration-gen.go @@ -297,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -482,9 +481,9 @@ type CloudSqlSettings struct { StorageAutoResizeLimit int64 `json:"storageAutoResizeLimit,omitempty,string"` // Tier: The tier (or machine type) for this instance, for example: - // `db-n1-standard-1` (MySQL instances). For more information, see - // [Cloud SQL Instance - // Settings](https://cloud.google.com/sql/docs/mysql/instance-settings). + // `db-n1-standard-1` (MySQL instances). For more information, see Cloud + // SQL Instance 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,9 +1338,10 @@ 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 +// (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", @@ -1359,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1399,9 +1399,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -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. @@ -1529,8 +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](https://tools.ietf.org/html/rfc3339) format, for example: + // 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 string `json:"expireTime,omitempty"` @@ -1711,11 +1713,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](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. @@ -1763,8 +1765,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2770,9 +2772,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -4236,9 +4237,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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/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 ac11b6f55a9..ef61ac29abb 100644 --- a/datastore/v1/datastore-gen.go +++ b/datastore/v1/datastore-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -753,11 +753,11 @@ 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 - // specified URL prefix. The final output URL will be provided in the + // more information about Cloud Storage namespace paths, 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.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 @@ -881,10 +881,10 @@ 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 + // (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"` @@ -1493,9 +1493,8 @@ 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 +// (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 * @@ -1516,9 +1515,8 @@ 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 + // (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 @@ -2098,10 +2096,9 @@ 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 + // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limits_and_offsets). EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. @@ -2129,10 +2126,9 @@ 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 + // (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 @@ -2464,11 +2460,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](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. @@ -2681,7 +2677,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2821,7 +2817,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2962,7 +2958,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3109,7 +3105,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3254,7 +3250,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3394,7 +3390,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3535,7 +3531,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3675,7 +3671,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3815,7 +3811,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3963,7 +3959,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4110,7 +4106,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4261,7 +4257,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4435,7 +4431,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4615,7 +4611,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4749,7 +4745,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4893,7 +4889,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5068,7 +5064,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/datastore/v1beta1/datastore-gen.go b/datastore/v1beta1/datastore-gen.go index 7d1b1f13bbd..99c6f06170b 100644 --- a/datastore/v1beta1/datastore-gen.go +++ b/datastore/v1beta1/datastore-gen.go @@ -624,10 +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](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 + // (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,10 +753,10 @@ 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 + // (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"` @@ -884,11 +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](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/datastore/v1beta3/datastore-gen.go b/datastore/v1beta3/datastore-gen.go index c1f54a87e0c..f4d014ba337 100644 --- a/datastore/v1beta3/datastore-gen.go +++ b/datastore/v1beta3/datastore-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -1109,9 +1109,8 @@ 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 +// (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 * @@ -1132,9 +1131,8 @@ 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 + // (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 @@ -1714,10 +1712,9 @@ 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 + // (https://cloud.google.com/datastore/docs/concepts/queries#cursors_limits_and_offsets). EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. @@ -1745,10 +1742,9 @@ 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 + // (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 @@ -2255,7 +2251,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2395,7 +2391,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2536,7 +2532,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2676,7 +2672,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2817,7 +2813,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2957,7 +2953,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3097,7 +3093,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/20210110") 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 134a306a37a..2d7246592c3 100644 --- a/deploymentmanager/v0.alpha/deploymentmanager-gen.go +++ b/deploymentmanager/v0.alpha/deploymentmanager-gen.go @@ -442,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -559,7 +558,7 @@ 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 + // `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"` @@ -770,7 +769,7 @@ 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 + // 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"` @@ -913,7 +912,7 @@ 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 + // 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"` @@ -1438,12 +1437,11 @@ 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) +// 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, @@ -1862,9 +1860,10 @@ 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 +// (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", @@ -1882,8 +1881,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1922,9 +1921,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2749,7 +2748,7 @@ 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 + // 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"` @@ -2945,7 +2944,7 @@ 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 + // 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"` diff --git a/deploymentmanager/v2/deploymentmanager-gen.go b/deploymentmanager/v2/deploymentmanager-gen.go index 4cc75501c12..ef0679b9d94 100644 --- a/deploymentmanager/v2/deploymentmanager-gen.go +++ b/deploymentmanager/v2/deploymentmanager-gen.go @@ -315,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -431,7 +430,7 @@ 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 + // 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"` @@ -535,7 +534,7 @@ 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 + // 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"` @@ -927,12 +926,11 @@ 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) +// 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, @@ -1310,9 +1308,10 @@ 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 +// (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", @@ -1330,8 +1329,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1370,9 +1369,9 @@ 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 + // (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 0b139ed9a4b..581af56bc92 100644 --- a/deploymentmanager/v2beta/deploymentmanager-gen.go +++ b/deploymentmanager/v2beta/deploymentmanager-gen.go @@ -442,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -555,7 +554,7 @@ 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 + // `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"` @@ -763,7 +762,7 @@ 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 + // 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"` @@ -867,7 +866,7 @@ 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 + // 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"` @@ -1346,12 +1345,11 @@ 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) +// 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, @@ -1775,9 +1773,10 @@ 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 +// (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", @@ -1795,8 +1794,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1835,9 +1834,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2627,7 +2626,7 @@ 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 + // 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"` @@ -2819,7 +2818,7 @@ 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 + // 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"` diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 2e43c2c11f4..f9ab903286c 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -1074,9 +1074,9 @@ 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 + // (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 @@ -1377,10 +1377,10 @@ 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 + // (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. @@ -1409,15 +1409,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](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) 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](https://cloud.google.com/speech-to-text/docs/basics) - // 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 @@ -1701,8 +1701,8 @@ func (s *GoogleCloudDialogflowCxV3IntentTrainingPhrasePart) MarshalJSON() ([]byt // 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 +// (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. @@ -1915,8 +1915,8 @@ 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) + // 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. @@ -2221,8 +2221,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](/speech/text-to-speech/docs/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. @@ -2690,11 +2690,11 @@ func (s *GoogleCloudDialogflowCxV3TextInput) MarshalJSON() ([]byte, error) { // 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 + // (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: @@ -3764,9 +3764,9 @@ 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 + // (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 @@ -4068,10 +4068,10 @@ 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 + // (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. @@ -4100,15 +4100,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](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) 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](https://cloud.google.com/speech-to-text/docs/basics) - // 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 @@ -4393,8 +4393,8 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentTrainingPhrasePart) MarshalJSON() ( // 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 +// (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. @@ -4607,8 +4607,8 @@ 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) + // 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. @@ -4913,8 +4913,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](/speech/text-to-speech/docs/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. @@ -5383,11 +5383,11 @@ func (s *GoogleCloudDialogflowCxV3beta1TextInput) MarshalJSON() ([]byte, error) // 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 + // (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: @@ -5722,8 +5722,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](https://cloud.google.com/dialogflow/docs/agents-overview). +// 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 @@ -5738,8 +5738,8 @@ 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 + // (https://cloud.google.com/dialogflow/docs/integrations/web-demo) // integration. AvatarUri string `json:"avatarUri,omitempty"` @@ -5754,10 +5754,10 @@ 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 + // (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 @@ -5802,8 +5802,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, + // 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 string `json:"timeZone,omitempty"` @@ -5853,14 +5853,14 @@ 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 + // (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 - // ](https://cloud.google.com/dialogflow/docs/reference/system-entities) + // 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" } @@ -5900,9 +5900,8 @@ 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 + // (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 @@ -5938,9 +5937,8 @@ 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 + // (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 @@ -6035,9 +6033,8 @@ 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 + // (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. @@ -6081,9 +6078,8 @@ 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 + // (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. @@ -6164,9 +6160,8 @@ 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 + // (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. @@ -6237,8 +6232,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](https://cloud.google.com/dialogflow/docs/contexts-overview). +// 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`, @@ -6477,8 +6472,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](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -6625,8 +6620,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](https://cloud.google.com/dialogflow/docs/agents-versions). +// 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/`. @@ -6686,8 +6681,8 @@ 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) + // 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. @@ -6734,10 +6729,10 @@ 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 + // (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"` // ForceSendFields is a list of field names (e.g. "AgentUri") to @@ -6804,8 +6799,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](https://cloud.google.com/dialogflow/docs/fulfillment-overview). +// 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. @@ -7016,11 +7011,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](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 + // (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 @@ -7029,10 +7024,10 @@ 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 + // (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. @@ -7060,19 +7055,19 @@ 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 + // (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](https://cloud.google.com/speech-to-text/docs/basics) - // for more details. + // content sent in 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: If `false` (default), recognition does not cease @@ -7087,9 +7082,9 @@ 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 + // (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 @@ -7122,8 +7117,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](https://cloud.google.com/dialogflow/docs/intents-overview). +// 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. @@ -7331,9 +7326,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](https://cloud.google.com/dialogflow/docs/intents-rich-messag -// es). +// 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"` @@ -8753,9 +8747,9 @@ 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 + // (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. @@ -8849,9 +8843,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](https://en.wikipedia.org/wiki/E.164) 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`, @@ -9011,8 +9004,8 @@ 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., + // 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 string `json:"timeZone,omitempty"` @@ -9095,9 +9088,9 @@ 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 + // (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, @@ -9390,8 +9383,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](https://cloud.google.com/dialogflow/docs/entities-session). +// 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. @@ -9469,9 +9462,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](https://cloud.google.com/speech-to-text/quotas) 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 @@ -9592,11 +9584,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](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 + // (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 @@ -9817,9 +9809,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](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// 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`, @@ -9849,12 +9840,11 @@ 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 + // (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 @@ -9965,8 +9955,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](https://cloud.google.com/dialogflow/docs/contexts-overview). +// 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`, @@ -10033,8 +10023,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](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -10147,8 +10137,8 @@ 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) + // 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. @@ -10233,8 +10223,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](https://cloud.google.com/dialogflow/docs/intents-overview). +// 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. @@ -11446,8 +11436,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 + // 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"` @@ -11930,8 +11920,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](https://developers.google.com/actions/reference/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. @@ -11964,8 +11954,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 (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 @@ -12339,9 +12329,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](https://en.wikipedia.org/wiki/E.164) 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`, @@ -12423,9 +12412,9 @@ 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 + // (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, @@ -12614,8 +12603,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](https://cloud.google.com/dialogflow/docs/entities-session). +// 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. @@ -12736,9 +12725,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](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// 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 @@ -12774,12 +12762,11 @@ 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 + // (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 @@ -13148,11 +13135,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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. @@ -13982,10 +13969,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](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 +// (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 @@ -14437,10 +14424,9 @@ 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 +// (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 @@ -15223,10 +15209,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15511,10 +15496,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15673,10 +15657,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -15883,10 +15866,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16799,10 +16781,9 @@ 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 +// (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 @@ -18799,10 +18780,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19112,10 +19092,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19298,10 +19277,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19533,10 +19511,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19841,10 +19818,9 @@ 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 +// (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 a78bf5a7b83..a49ac0777be 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -1290,9 +1290,9 @@ 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 + // (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 @@ -1593,10 +1593,10 @@ 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 + // (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. @@ -1625,15 +1625,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](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) 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](https://cloud.google.com/speech-to-text/docs/basics) - // 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 @@ -1917,8 +1917,8 @@ func (s *GoogleCloudDialogflowCxV3IntentTrainingPhrasePart) MarshalJSON() ([]byt // 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 +// (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. @@ -2131,8 +2131,8 @@ 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) + // 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. @@ -2437,8 +2437,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](/speech/text-to-speech/docs/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. @@ -2906,11 +2906,11 @@ func (s *GoogleCloudDialogflowCxV3TextInput) MarshalJSON() ([]byte, error) { // 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 + // (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: @@ -3980,9 +3980,9 @@ 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 + // (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 @@ -4284,10 +4284,10 @@ 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 + // (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. @@ -4316,15 +4316,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](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) 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](https://cloud.google.com/speech-to-text/docs/basics) - // 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 @@ -4609,8 +4609,8 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentTrainingPhrasePart) MarshalJSON() ( // 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 +// (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. @@ -4823,8 +4823,8 @@ 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) + // 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. @@ -5129,8 +5129,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](/speech/text-to-speech/docs/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. @@ -5599,11 +5599,11 @@ func (s *GoogleCloudDialogflowCxV3beta1TextInput) MarshalJSON() ([]byte, error) // 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 + // (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: @@ -5936,14 +5936,14 @@ 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 + // (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 - // ](https://cloud.google.com/dialogflow/docs/reference/system-entities) + // 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" } @@ -6045,8 +6045,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](https://cloud.google.com/dialogflow/docs/contexts-overview). +// 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`, @@ -6171,8 +6171,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](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -6284,8 +6284,8 @@ 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) + // 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. @@ -6370,8 +6370,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](https://cloud.google.com/dialogflow/docs/intents-overview). +// 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. @@ -6546,9 +6546,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](https://cloud.google.com/dialogflow/docs/intents-rich-messag -// es). +// 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"` @@ -7777,9 +7776,9 @@ 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 + // (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. @@ -7873,9 +7872,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](https://en.wikipedia.org/wiki/E.164) 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`, @@ -7953,9 +7951,9 @@ 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 + // (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, @@ -8144,8 +8142,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](https://cloud.google.com/dialogflow/docs/entities-session). +// 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. @@ -8256,9 +8254,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](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// 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`, @@ -8288,12 +8285,11 @@ 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 + // (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 @@ -8341,8 +8337,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](https://cloud.google.com/dialogflow/docs/agents-overview). +// 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 @@ -8357,8 +8353,8 @@ 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 + // (https://cloud.google.com/dialogflow/docs/integrations/web-demo) // integration. AvatarUri string `json:"avatarUri,omitempty"` @@ -8373,10 +8369,10 @@ 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 + // (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 @@ -8422,8 +8418,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, + // 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 string `json:"timeZone,omitempty"` @@ -8476,9 +8472,8 @@ 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 + // (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 @@ -8514,9 +8509,8 @@ 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 + // (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 @@ -8611,9 +8605,8 @@ 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 + // (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. @@ -8657,9 +8650,8 @@ 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 + // (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. @@ -8742,9 +8734,8 @@ 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 + // (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. @@ -8815,8 +8806,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](https://cloud.google.com/dialogflow/docs/contexts-overview). +// 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`, @@ -9001,8 +8992,8 @@ 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). +// 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`. type GoogleCloudDialogflowV2beta1Document struct { @@ -9140,8 +9131,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](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -9289,9 +9280,9 @@ 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 +// (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/` - @@ -9352,8 +9343,8 @@ 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) + // 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. @@ -9400,10 +9391,10 @@ 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 + // (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"` // ForceSendFields is a list of field names (e.g. "AgentUri") to @@ -9471,8 +9462,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](https://cloud.google.com/dialogflow/docs/fulfillment-overview). +// 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. @@ -9715,11 +9706,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](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 + // (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 @@ -9728,10 +9719,10 @@ 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 + // (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. @@ -9759,19 +9750,19 @@ 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 + // (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](https://cloud.google.com/speech-to-text/docs/basics) - // for more details. + // content sent in 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: If `false` (default), recognition does not cease @@ -9786,9 +9777,9 @@ 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 + // (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 @@ -9821,8 +9812,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](https://cloud.google.com/dialogflow/docs/intents-overview). +// 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. @@ -11067,8 +11058,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 + // 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"` @@ -11551,8 +11542,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](https://developers.google.com/actions/reference/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. @@ -11585,8 +11576,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 (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 @@ -11919,10 +11910,10 @@ 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 +// (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 // name must be 1024 bytes or less; otherwise, the creation request @@ -12278,9 +12269,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](https://en.wikipedia.org/wiki/E.164) 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`, @@ -12453,8 +12443,8 @@ 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., + // 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 string `json:"timeZone,omitempty"` @@ -12541,9 +12531,9 @@ 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 + // (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, @@ -12872,8 +12862,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](https://cloud.google.com/dialogflow/docs/entities-session). +// 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. @@ -12955,9 +12945,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](https://cloud.google.com/speech-to-text/quotas) 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 @@ -13113,11 +13102,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](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 + // (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 @@ -13243,8 +13232,8 @@ type GoogleCloudDialogflowV2beta1VoiceSelectionParams struct { // Name: Optional. The name of the voice. If not set, the service will // choose a voice based on the other parameters such as language_code // and ssml_gender. For the list of available voices, please refer to - // [Supported voices and - // languages](https://cloud.google.com/text-to-speech/docs/voices). + // Supported voices and languages + // (https://cloud.google.com/text-to-speech/docs/voices). Name string `json:"name,omitempty"` // SsmlGender: Optional. The preferred gender of the voice. If not set, @@ -13346,9 +13335,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](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// 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 @@ -13384,12 +13372,11 @@ 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 + // (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 @@ -13758,11 +13745,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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. @@ -14594,10 +14581,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](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 +// (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 @@ -15050,10 +15037,9 @@ 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 +// (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 @@ -15836,10 +15822,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16124,10 +16109,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16286,10 +16270,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -16496,10 +16479,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -17412,10 +17394,9 @@ 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 +// (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 @@ -19416,10 +19397,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19730,10 +19710,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -19917,10 +19896,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -20152,10 +20130,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -20788,7 +20765,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 (https://aip.dev/160). func (c *ProjectsAgentKnowledgeBasesListCall) Filter(filter string) *ProjectsAgentKnowledgeBasesListCall { c.urlParams_.Set("filter", filter) return c @@ -21603,7 +21580,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 (https://aip.dev/160). func (c *ProjectsAgentKnowledgeBasesDocumentsListCall) Filter(filter string) *ProjectsAgentKnowledgeBasesDocumentsListCall { c.urlParams_.Set("filter", filter) return c @@ -22243,10 +22220,9 @@ 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 +// (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 @@ -24404,7 +24380,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 (https://aip.dev/160). func (c *ProjectsKnowledgeBasesListCall) Filter(filter string) *ProjectsKnowledgeBasesListCall { c.urlParams_.Set("filter", filter) return c @@ -25219,7 +25195,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 (https://aip.dev/160). func (c *ProjectsKnowledgeBasesDocumentsListCall) Filter(filter string) *ProjectsKnowledgeBasesDocumentsListCall { c.urlParams_.Set("filter", filter) return c @@ -26454,10 +26430,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](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 +// (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 @@ -26910,10 +26886,9 @@ 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 +// (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 @@ -27696,10 +27671,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentEntityTypesCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -27984,10 +27958,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentEntityTypesGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -28146,10 +28119,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentEntityTypesListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -28356,10 +28328,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentEntityTypesPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentEntityTypesPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -29272,10 +29243,9 @@ 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 +// (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 @@ -31276,10 +31246,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentIntentsCreateCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsCreateCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -31590,10 +31559,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentIntentsGetCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsGetCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -31777,10 +31745,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentIntentsListCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -32012,10 +31979,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](https://cloud.google.com/dialogflow/docs/agents-multilingual#int -// ent-entity). +// default language is used. For more information, see Multilingual +// intent and entity data +// (https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). func (c *ProjectsLocationsAgentIntentsPatchCall) LanguageCode(languageCode string) *ProjectsLocationsAgentIntentsPatchCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -32321,10 +32287,9 @@ 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 +// (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 @@ -34482,7 +34447,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 (https://aip.dev/160). func (c *ProjectsLocationsKnowledgeBasesListCall) Filter(filter string) *ProjectsLocationsKnowledgeBasesListCall { c.urlParams_.Set("filter", filter) return c @@ -35297,7 +35262,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 (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 2f41927e249..fdd9467cb30 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -403,16 +403,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](https://cloud.google.com/dialogflow/docs/integrations/web-demo) + // 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](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 + // (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 @@ -445,8 +445,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, + // 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 string `json:"timeZone,omitempty"` @@ -1076,9 +1076,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](https://cloud.google.com/dialogflow/docs/entities-overv -// iew). +// the Dialogflow documentation +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowCxV3EntityType struct { // AutoExpansionMode: Indicates whether the entity type can be // automatically expanded. @@ -1476,9 +1475,9 @@ func (s *GoogleCloudDialogflowCxV3Experiment) MarshalJSON() ([]byte, error) { type GoogleCloudDialogflowCxV3ExperimentDefinition struct { // Condition: The condition defines which subset of sessions are // selected for this experiment. If not specified, all sessions are - // eligible. E.g. "query_input.language_code=en" See the [conditions - // reference](https://cloud.google.com/dialogflow/cx/docs/reference/condi - // tion). + // eligible. E.g. "query_input.language_code=en" See the conditions + // reference + // (https://cloud.google.com/dialogflow/cx/docs/reference/condition). Condition string `json:"condition,omitempty"` // VersionVariants: The flow versions as the variants of this @@ -1709,10 +1708,10 @@ func (s *GoogleCloudDialogflowCxV3ExperimentResultVersionMetrics) MarshalJSON() // 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 + // (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"` // ForceSendFields is a list of field names (e.g. "AgentUri") to @@ -1789,16 +1788,16 @@ type GoogleCloudDialogflowCxV3ExportTestCasesRequest struct { DataFormat string `json:"dataFormat,omitempty"` // Filter: The filter expression used to filter exported test cases, see - // [API Filtering](https://aip.dev/160). The expression is case + // API Filtering (https://aip.dev/160). The expression is case // insensitive and supports the following syntax: name = [OR name = ] // ... For example: * "name = t1 OR name = t2" matches the test case // with the exact resource name "t1" or "t2". Filter string `json:"filter,omitempty"` - // GcsUri: The [Google Cloud - // Storage](https://cloud.google.com/storage/docs/) URI to export the - // test cases to. The format of this URI must be `gs:///`. If - // unspecified, the serialized test cases is returned inline. + // GcsUri: The Google Cloud Storage + // (https://cloud.google.com/storage/docs/) URI to export the test cases + // to. The format of this URI must be `gs:///`. If unspecified, the + // serialized test cases is returned inline. GcsUri string `json:"gcsUri,omitempty"` // ForceSendFields is a list of field names (e.g. "DataFormat") to @@ -2307,9 +2306,9 @@ 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 + // (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 @@ -2531,9 +2530,9 @@ type GoogleCloudDialogflowCxV3ImportTestCasesRequest struct { // Content: Uncompressed raw byte content for test cases. Content string `json:"content,omitempty"` - // GcsUri: The [Google Cloud - // Storage](https://cloud.google.com/storage/docs/) URI to import test - // cases from. The format of this URI must be `gs:///`. + // GcsUri: The Google Cloud Storage + // (https://cloud.google.com/storage/docs/) URI to import test cases + // from. The format of this URI must be `gs:///`. GcsUri string `json:"gcsUri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -2644,10 +2643,10 @@ 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 + // (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. @@ -2676,15 +2675,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](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) 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](https://cloud.google.com/speech-to-text/docs/basics) - // 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 @@ -3963,8 +3962,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](https://cloud.google.com/dialogflow/cx/docs/concept/page). +// 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. @@ -4181,8 +4180,8 @@ 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) + // 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. @@ -4247,8 +4246,8 @@ 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., + // 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 string `json:"timeZone,omitempty"` @@ -4317,9 +4316,9 @@ 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 + // (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. @@ -4714,8 +4713,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](/speech/text-to-speech/docs/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. @@ -4826,9 +4825,9 @@ 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 + // (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 @@ -5065,9 +5064,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](https://cloud.google.com/dialogflow/docs/entities-overv -// iew). +// 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. @@ -5711,11 +5709,11 @@ func (s *GoogleCloudDialogflowCxV3TransitionCoverageTransitionNode) MarshalJSON( // 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 + // (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: @@ -6147,8 +6145,8 @@ type GoogleCloudDialogflowCxV3VoiceSelectionParams struct { // Name: Optional. The name of the voice. If not set, the service will // choose a voice based on the other parameters such as language_code // and ssml_gender. For the list of available voices, please refer to - // [Supported voices and - // languages](https://cloud.google.com/text-to-speech/docs/voices). + // Supported voices and languages + // (https://cloud.google.com/text-to-speech/docs/voices). Name string `json:"name,omitempty"` // SsmlGender: Optional. The preferred gender of the voice. If not set, @@ -7273,9 +7271,9 @@ 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 + // (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 @@ -7577,10 +7575,10 @@ 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 + // (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. @@ -7609,15 +7607,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](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) 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](https://cloud.google.com/speech-to-text/docs/basics) - // 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 @@ -7902,8 +7900,8 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentTrainingPhrasePart) MarshalJSON() ( // 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 +// (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. @@ -8116,8 +8114,8 @@ 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) + // 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. @@ -8422,8 +8420,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](/speech/text-to-speech/docs/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. @@ -8892,11 +8890,11 @@ func (s *GoogleCloudDialogflowCxV3beta1TextInput) MarshalJSON() ([]byte, error) // 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 + // (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: @@ -9229,14 +9227,14 @@ 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 + // (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 - // ](https://cloud.google.com/dialogflow/docs/reference/system-entities) + // 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" } @@ -9338,8 +9336,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](https://cloud.google.com/dialogflow/docs/contexts-overview). +// 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`, @@ -9464,8 +9462,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](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -9577,8 +9575,8 @@ 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) + // 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. @@ -9663,8 +9661,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](https://cloud.google.com/dialogflow/docs/intents-overview). +// 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. @@ -9839,9 +9837,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](https://cloud.google.com/dialogflow/docs/intents-rich-messag -// es). +// 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"` @@ -11070,9 +11067,9 @@ 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 + // (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. @@ -11166,9 +11163,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](https://en.wikipedia.org/wiki/E.164) 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`, @@ -11246,9 +11242,9 @@ 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 + // (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, @@ -11437,8 +11433,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](https://cloud.google.com/dialogflow/docs/entities-session). +// 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. @@ -11549,9 +11545,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](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// 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`, @@ -11581,12 +11576,11 @@ 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 + // (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 @@ -11697,8 +11691,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](https://cloud.google.com/dialogflow/docs/contexts-overview). +// 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`, @@ -11765,8 +11759,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](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -11879,8 +11873,8 @@ 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) + // 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. @@ -11965,8 +11959,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](https://cloud.google.com/dialogflow/docs/intents-overview). +// 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. @@ -13178,8 +13172,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 + // 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"` @@ -13662,8 +13656,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](https://developers.google.com/actions/reference/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. @@ -13696,8 +13690,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 (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 @@ -14071,9 +14065,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](https://en.wikipedia.org/wiki/E.164) 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`, @@ -14155,9 +14148,9 @@ 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 + // (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, @@ -14346,8 +14339,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](https://cloud.google.com/dialogflow/docs/entities-session). +// 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. @@ -14468,9 +14461,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](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// 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 @@ -14506,12 +14498,11 @@ 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 + // (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 @@ -14880,11 +14871,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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. @@ -16353,10 +16344,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](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 +// (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 @@ -16661,10 +16652,11 @@ 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 +// (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 @@ -16825,10 +16817,11 @@ 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 +// (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 @@ -17037,10 +17030,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](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 +// (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 @@ -19216,9 +19209,9 @@ 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 +// (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 @@ -20435,10 +20428,10 @@ 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 +// (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 { c.urlParams_.Set("languageCode", languageCode) return c @@ -20741,10 +20734,10 @@ 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 +// (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 { c.urlParams_.Set("languageCode", languageCode) return c @@ -21064,10 +21057,10 @@ 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 +// (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 { c.urlParams_.Set("languageCode", languageCode) return c @@ -21276,10 +21269,10 @@ 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 +// (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 { c.urlParams_.Set("languageCode", languageCode) return c @@ -21740,10 +21733,11 @@ 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 +// (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 @@ -22050,10 +22044,11 @@ 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 +// (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 @@ -22217,10 +22212,11 @@ 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 +// (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 @@ -22433,10 +22429,11 @@ 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 +// (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 @@ -22605,10 +22602,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](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 +// (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 @@ -22912,10 +22909,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](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 +// (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 @@ -23077,10 +23074,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](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 +// (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 @@ -23289,10 +23286,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](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 +// (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 @@ -24368,10 +24365,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](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 +// (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 @@ -24656,10 +24653,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](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 +// (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 @@ -24832,10 +24829,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](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 +// (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 @@ -25058,10 +25055,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](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 +// (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 @@ -25223,9 +25220,9 @@ 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 +// (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 @@ -28007,19 +28004,19 @@ func (r *ProjectsLocationsAgentsTestCasesResultsService) List(parent string) *Pr } // Filter sets the optional parameter "filter": The filter expression -// used to filter test case results. See [API -// Filtering](https://aip.dev/160). The expression is case insensitive. -// Only 'AND' is supported for logical operators. The supported syntax -// is listed below in detail: [AND ] ... [AND latest] The supported -// fields and operators are: field operator `environment` `=`, `IN` (Use -// value `draft` for draft environment) `test_time` `>`, `<` `latest` -// only returns the latest test result in all results for each test -// case. Examples: * "environment=draft AND latest" matches the latest -// test result for each test case in the draft environment. * -// "environment IN (e1,e2)" matches any test case results with an -// environment resource name of either "e1" or "e2". * "test_time > -// 1602540713" matches any test case results with test time later than a -// unix timestamp in seconds 1602540713. +// used to filter test case results. See API Filtering +// (https://aip.dev/160). The expression is case insensitive. Only 'AND' +// is supported for logical operators. The supported syntax is listed +// below in detail: [AND ] ... [AND latest] The supported fields and +// operators are: field operator `environment` `=`, `IN` (Use value +// `draft` for draft environment) `test_time` `>`, `<` `latest` only +// returns the latest test result in all results for each test case. +// Examples: * "environment=draft AND latest" matches the latest test +// result for each test case in the draft environment. * "environment IN +// (e1,e2)" matches any test case results with an environment resource +// name of either "e1" or "e2". * "test_time > 1602540713" matches any +// test case results with test time later than a unix timestamp in +// seconds 1602540713. func (c *ProjectsLocationsAgentsTestCasesResultsListCall) Filter(filter string) *ProjectsLocationsAgentsTestCasesResultsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index d1f4ed9bbfa..ff6421641e4 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -1134,9 +1134,9 @@ 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 + // (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 @@ -1437,10 +1437,10 @@ 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 + // (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. @@ -1469,15 +1469,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](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) 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](https://cloud.google.com/speech-to-text/docs/basics) - // 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 @@ -1761,8 +1761,8 @@ func (s *GoogleCloudDialogflowCxV3IntentTrainingPhrasePart) MarshalJSON() ([]byt // 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 +// (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. @@ -1975,8 +1975,8 @@ 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) + // 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. @@ -2281,8 +2281,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](/speech/text-to-speech/docs/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. @@ -2750,11 +2750,11 @@ func (s *GoogleCloudDialogflowCxV3TextInput) MarshalJSON() ([]byte, error) { // 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 + // (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: @@ -3091,16 +3091,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](https://cloud.google.com/dialogflow/docs/integrations/web-demo) + // 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](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 + // (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 @@ -3133,8 +3133,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, + // 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 string `json:"timeZone,omitempty"` @@ -3764,9 +3764,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](https://cloud.google.com/dialogflow/docs/entities-overv -// iew). +// the Dialogflow documentation +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowCxV3beta1EntityType struct { // AutoExpansionMode: Indicates whether the entity type can be // automatically expanded. @@ -4165,9 +4164,9 @@ func (s *GoogleCloudDialogflowCxV3beta1Experiment) MarshalJSON() ([]byte, error) type GoogleCloudDialogflowCxV3beta1ExperimentDefinition struct { // Condition: The condition defines which subset of sessions are // selected for this experiment. If not specified, all sessions are - // eligible. E.g. "query_input.language_code=en" See the [conditions - // reference](https://cloud.google.com/dialogflow/cx/docs/reference/condi - // tion). + // eligible. E.g. "query_input.language_code=en" See the conditions + // reference + // (https://cloud.google.com/dialogflow/cx/docs/reference/condition). Condition string `json:"condition,omitempty"` // VersionVariants: The flow versions as the variants of this @@ -4399,10 +4398,10 @@ func (s *GoogleCloudDialogflowCxV3beta1ExperimentResultVersionMetrics) MarshalJS // 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 + // (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"` // ForceSendFields is a list of field names (e.g. "AgentUri") to @@ -4479,16 +4478,16 @@ type GoogleCloudDialogflowCxV3beta1ExportTestCasesRequest struct { DataFormat string `json:"dataFormat,omitempty"` // Filter: The filter expression used to filter exported test cases, see - // [API Filtering](https://aip.dev/160). The expression is case + // API Filtering (https://aip.dev/160). The expression is case // insensitive and supports the following syntax: name = [OR name = ] // ... For example: * "name = t1 OR name = t2" matches the test case // with the exact resource name "t1" or "t2". Filter string `json:"filter,omitempty"` - // GcsUri: The [Google Cloud - // Storage](https://cloud.google.com/storage/docs/) URI to export the - // test cases to. The format of this URI must be `gs:///`. If - // unspecified, the serialized test cases is returned inline. + // GcsUri: The Google Cloud Storage + // (https://cloud.google.com/storage/docs/) URI to export the test cases + // to. The format of this URI must be `gs:///`. If unspecified, the + // serialized test cases is returned inline. GcsUri string `json:"gcsUri,omitempty"` // ForceSendFields is a list of field names (e.g. "DataFormat") to @@ -4998,9 +4997,9 @@ 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 + // (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 @@ -5223,9 +5222,9 @@ type GoogleCloudDialogflowCxV3beta1ImportTestCasesRequest struct { // Content: Uncompressed raw byte content for test cases. Content string `json:"content,omitempty"` - // GcsUri: The [Google Cloud - // Storage](https://cloud.google.com/storage/docs/) URI to import test - // cases from. The format of this URI must be `gs:///`. + // GcsUri: The Google Cloud Storage + // (https://cloud.google.com/storage/docs/) URI to import test cases + // from. The format of this URI must be `gs:///`. GcsUri string `json:"gcsUri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -5336,10 +5335,10 @@ 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 + // (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. @@ -5368,15 +5367,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](https://cloud.google.com/speech-to-text/docs/basics#phr - // ase-hints) 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](https://cloud.google.com/speech-to-text/docs/basics) - // 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 @@ -6658,8 +6657,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](https://cloud.google.com/dialogflow/cx/docs/concept/page). +// 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. @@ -6876,8 +6875,8 @@ 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) + // 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. @@ -6942,8 +6941,8 @@ 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., + // 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 string `json:"timeZone,omitempty"` @@ -7012,9 +7011,9 @@ 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 + // (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. @@ -7409,8 +7408,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](/speech/text-to-speech/docs/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. @@ -7521,9 +7520,9 @@ 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 + // (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 @@ -7760,9 +7759,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](https://cloud.google.com/dialogflow/docs/entities-overv -// iew). +// 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. @@ -8407,11 +8405,11 @@ func (s *GoogleCloudDialogflowCxV3beta1TransitionCoverageTransitionNode) Marshal // 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 + // (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: @@ -8844,8 +8842,8 @@ type GoogleCloudDialogflowCxV3beta1VoiceSelectionParams struct { // Name: Optional. The name of the voice. If not set, the service will // choose a voice based on the other parameters such as language_code // and ssml_gender. For the list of available voices, please refer to - // [Supported voices and - // languages](https://cloud.google.com/text-to-speech/docs/voices). + // Supported voices and languages + // (https://cloud.google.com/text-to-speech/docs/voices). Name string `json:"name,omitempty"` // SsmlGender: Optional. The preferred gender of the voice. If not set, @@ -9233,14 +9231,14 @@ 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 + // (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 - // ](https://cloud.google.com/dialogflow/docs/reference/system-entities) + // 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" } @@ -9342,8 +9340,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](https://cloud.google.com/dialogflow/docs/contexts-overview). +// 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`, @@ -9468,8 +9466,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](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -9581,8 +9579,8 @@ 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) + // 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. @@ -9667,8 +9665,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](https://cloud.google.com/dialogflow/docs/intents-overview). +// 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. @@ -9843,9 +9841,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](https://cloud.google.com/dialogflow/docs/intents-rich-messag -// es). +// 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"` @@ -11074,9 +11071,9 @@ 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 + // (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. @@ -11170,9 +11167,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](https://en.wikipedia.org/wiki/E.164) 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`, @@ -11250,9 +11246,9 @@ 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 + // (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, @@ -11441,8 +11437,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](https://cloud.google.com/dialogflow/docs/entities-session). +// 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. @@ -11553,9 +11549,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](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// 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`, @@ -11585,12 +11580,11 @@ 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 + // (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 @@ -11701,8 +11695,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](https://cloud.google.com/dialogflow/docs/contexts-overview). +// 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`, @@ -11769,8 +11763,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](https://cloud.google.com/dialogflow/docs/entities-overview). +// Entity guide +// (https://cloud.google.com/dialogflow/docs/entities-overview). type GoogleCloudDialogflowV2beta1EntityType struct { // AutoExpansionMode: Optional. Indicates whether the entity type can be // automatically expanded. @@ -11883,8 +11877,8 @@ 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) + // 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. @@ -11969,8 +11963,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](https://cloud.google.com/dialogflow/docs/intents-overview). +// 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. @@ -13182,8 +13176,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 + // 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"` @@ -13666,8 +13660,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](https://developers.google.com/actions/reference/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. @@ -13700,8 +13694,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 (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 @@ -14075,9 +14069,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](https://en.wikipedia.org/wiki/E.164) 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`, @@ -14159,9 +14152,9 @@ 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 + // (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, @@ -14350,8 +14343,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](https://cloud.google.com/dialogflow/docs/entities-session). +// 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. @@ -14472,9 +14465,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](https://developers.google.com/protocol-buffers/docs/proto3#json -// ). +// 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 @@ -14510,12 +14502,11 @@ 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 + // (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 @@ -14884,11 +14875,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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. @@ -16360,10 +16351,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](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 +// (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 @@ -16669,10 +16660,11 @@ 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 +// (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 @@ -16834,10 +16826,11 @@ 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 +// (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 @@ -17046,10 +17039,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](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 +// (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 @@ -19233,9 +19226,9 @@ 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 +// (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 @@ -20452,10 +20445,10 @@ 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 +// (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 { c.urlParams_.Set("languageCode", languageCode) return c @@ -20759,10 +20752,10 @@ 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 +// (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 { c.urlParams_.Set("languageCode", languageCode) return c @@ -21083,10 +21076,10 @@ 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 +// (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 { c.urlParams_.Set("languageCode", languageCode) return c @@ -21295,10 +21288,10 @@ 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 +// (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 { c.urlParams_.Set("languageCode", languageCode) return c @@ -21760,10 +21753,11 @@ 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 +// (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 @@ -22071,10 +22065,11 @@ 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 +// (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 @@ -22239,10 +22234,11 @@ 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 +// (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 @@ -22455,10 +22451,11 @@ 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 +// (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 @@ -22628,10 +22625,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](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 +// (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 @@ -22935,10 +22932,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](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 +// (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 @@ -23100,10 +23097,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](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 +// (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 @@ -23312,10 +23309,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](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 +// (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 @@ -24393,10 +24390,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](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 +// (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 @@ -24682,10 +24679,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](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 +// (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 @@ -24859,10 +24856,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](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 +// (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 @@ -25085,10 +25082,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](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 +// (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 @@ -25251,9 +25248,9 @@ 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 +// (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 @@ -28036,19 +28033,19 @@ func (r *ProjectsLocationsAgentsTestCasesResultsService) List(parent string) *Pr } // Filter sets the optional parameter "filter": The filter expression -// used to filter test case results. See [API -// Filtering](https://aip.dev/160). The expression is case insensitive. -// Only 'AND' is supported for logical operators. The supported syntax -// is listed below in detail: [AND ] ... [AND latest] The supported -// fields and operators are: field operator `environment` `=`, `IN` (Use -// value `draft` for draft environment) `test_time` `>`, `<` `latest` -// only returns the latest test result in all results for each test -// case. Examples: * "environment=draft AND latest" matches the latest -// test result for each test case in the draft environment. * -// "environment IN (e1,e2)" matches any test case results with an -// environment resource name of either "e1" or "e2". * "test_time > -// 1602540713" matches any test case results with test time later than a -// unix timestamp in seconds 1602540713. +// used to filter test case results. See API Filtering +// (https://aip.dev/160). The expression is case insensitive. Only 'AND' +// is supported for logical operators. The supported syntax is listed +// below in detail: [AND ] ... [AND latest] The supported fields and +// operators are: field operator `environment` `=`, `IN` (Use value +// `draft` for draft environment) `test_time` `>`, `<` `latest` only +// returns the latest test result in all results for each test case. +// Examples: * "environment=draft AND latest" matches the latest test +// result for each test case in the draft environment. * "environment IN +// (e1,e2)" matches any test case results with an environment resource +// name of either "e1" or "e2". * "test_time > 1602540713" matches any +// test case results with test time later than a unix timestamp in +// seconds 1602540713. func (c *ProjectsLocationsAgentsTestCasesResultsListCall) Filter(filter string) *ProjectsLocationsAgentsTestCasesResultsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/digitalassetlinks/v1/digitalassetlinks-gen.go b/digitalassetlinks/v1/digitalassetlinks-gen.go index 9f9e462affb..fa0a4440511 100644 --- a/digitalassetlinks/v1/digitalassetlinks-gen.go +++ b/digitalassetlinks/v1/digitalassetlinks-gen.go @@ -405,8 +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](/digital-asset-links/v1/getting-started). +// 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 @@ -414,9 +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](/digital-asset-links/v1/relation-strings) 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"` @@ -520,9 +520,9 @@ 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 +// (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 @@ -532,11 +532,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](/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 +// 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 { @@ -812,29 +812,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 +// (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 } // 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 +// 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`. func (c *StatementsListCall) Relation(relation string) *StatementsListCall { diff --git a/displayvideo/v1/displayvideo-gen.go b/displayvideo/v1/displayvideo-gen.go index ae934a5b583..5d74dcbdfd0 100644 --- a/displayvideo/v1/displayvideo-gen.go +++ b/displayvideo/v1/displayvideo-gen.go @@ -3403,10 +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](partners.channels#Channel.FIELDS.channel_id) or - // [advertiser-owned - // channel](advertisers.channels#Channel.FIELDS.channel_id) 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 @@ -8440,10 +8439,10 @@ 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 + // (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 @@ -11792,11 +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](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/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index 231ec37a059..a3d475a2755 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -1360,9 +1360,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](https://github.com/google/re2/wiki/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 @@ -1370,9 +1370,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](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 + // (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 @@ -2106,20 +2106,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`](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` + // (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,23 +2816,23 @@ 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 +// (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 +// 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. type GooglePrivacyDlpV2Dictionary struct { // CloudStoragePath: Newline-delimited file of words in Cloud Storage. // Only a single file is accepted. @@ -3306,8 +3305,8 @@ 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 + // 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" @@ -3586,8 +3585,8 @@ 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 + // 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" : @@ -3748,8 +3747,8 @@ 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 + // 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" : @@ -5138,8 +5137,8 @@ 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 +// 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. @@ -5951,8 +5950,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`](https://cloud.google.com/dlp/docs/reference/rest/v2/pr -// ojects.dlpJobs#DlpJob). 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 @@ -7197,10 +7197,9 @@ 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` +// (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 @@ -7998,11 +7997,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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. @@ -14653,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 @@ -18634,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/docs/v1/docs-gen.go b/docs/v1/docs-gen.go index e74181abc36..64e36d973a0 100644 --- a/docs/v1/docs-gen.go +++ b/docs/v1/docs-gen.go @@ -6876,8 +6876,8 @@ 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 + // 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 diff --git a/documentai/v1beta2/documentai-gen.go b/documentai/v1beta2/documentai-gen.go index 851d3df333f..06cad8edad1 100644 --- a/documentai/v1beta2/documentai-gen.go +++ b/documentai/v1beta2/documentai-gen.go @@ -1135,9 +1135,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](https://cloud.google.com/storage/docs/reference-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 @@ -3047,9 +3046,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](https://cloud.google.com/storage/docs/reference-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 @@ -5442,11 +5440,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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. @@ -5845,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 @@ -5889,8 +5887,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 (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 d4d33804973..e9bda604470 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -1135,9 +1135,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](https://cloud.google.com/storage/docs/reference-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 @@ -2987,9 +2986,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](https://cloud.google.com/storage/docs/reference-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 @@ -5121,9 +5119,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](https://cloud.google.com/storage/docs/reference-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 @@ -6980,11 +6977,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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. @@ -7383,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 @@ -7427,8 +7424,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 (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 2c97e5210fb..06f54e6cd3d 100644 --- a/domains/v1alpha2/domains-gen.go +++ b/domains/v1alpha2/domains-gen.go @@ -318,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -555,7 +554,7 @@ func (s *Contact) MarshalJSON() ([]byte, error) { } // ContactSettings: Defines the contact information associated with a -// `Registration`. [ICANN](https://icann.org/) requires all domain names +// `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. @@ -665,8 +664,8 @@ 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 + // (https://domains.google/). GoogleDomainsDns *GoogleDomainsDns `json:"googleDomainsDns,omitempty"` // ForceSendFields is a list of field names (e.g. "CustomDns") to @@ -867,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](https://domains.google/). +// 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 @@ -1288,9 +1287,10 @@ 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 +// (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", @@ -1308,8 +1308,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1348,9 +1348,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -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 @@ -1898,11 +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](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. @@ -1945,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -3277,8 +3277,8 @@ 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 +// 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 @@ -3585,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 aefb08af9de..dd00f0ee92b 100644 --- a/domains/v1beta1/domains-gen.go +++ b/domains/v1beta1/domains-gen.go @@ -318,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -555,7 +554,7 @@ func (s *Contact) MarshalJSON() ([]byte, error) { } // ContactSettings: Defines the contact information associated with a -// `Registration`. [ICANN](https://icann.org/) requires all domain names +// `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. @@ -665,8 +664,8 @@ 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 + // (https://domains.google/). GoogleDomainsDns *GoogleDomainsDns `json:"googleDomainsDns,omitempty"` // ForceSendFields is a list of field names (e.g. "CustomDns") to @@ -867,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](https://domains.google/). +// 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 @@ -1288,9 +1287,10 @@ 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 +// (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", @@ -1308,8 +1308,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1348,9 +1348,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -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 @@ -1898,11 +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](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. @@ -1945,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -3277,8 +3277,8 @@ 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 +// 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 @@ -3585,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 eb68d867c36..8d586df9e1c 100644 --- a/domainsrdap/v1/domainsrdap-gen.go +++ b/domainsrdap/v1/domainsrdap-gen.go @@ -250,8 +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](https://tools.ietf.org/html/rfc7483#section-4.2). +// 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"` @@ -298,8 +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](https://tools.ietf.org/html/rfc7483#section-4.3). +// 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"` @@ -310,11 +310,11 @@ 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 + // (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 string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -353,8 +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](https://tools.ietf.org/html/rfc7483#section-6). + // 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 b294fa65db7..e3fe33e2c07 100644 --- a/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go +++ b/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go @@ -2528,8 +2528,8 @@ 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: +// 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. diff --git a/doubleclicksearch/v2/doubleclicksearch-gen.go b/doubleclicksearch/v2/doubleclicksearch-gen.go index d7fc48eeb4d..3ee47baf4f6 100644 --- a/doubleclicksearch/v2/doubleclicksearch-gen.go +++ b/doubleclicksearch/v2/doubleclicksearch-gen.go @@ -711,8 +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 + // 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. ReportType string `json:"reportType,omitempty"` diff --git a/eventarc/v1beta1/eventarc-gen.go b/eventarc/v1beta1/eventarc-gen.go index 64e28e77a8e..96423f73987 100644 --- a/eventarc/v1beta1/eventarc-gen.go +++ b/eventarc/v1beta1/eventarc-gen.go @@ -285,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -369,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 @@ -824,9 +824,10 @@ 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 +// (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", @@ -844,8 +845,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -884,9 +885,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -991,11 +992,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](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. @@ -1038,8 +1039,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -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 @@ -2688,9 +2695,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 d9c0b05cf49..4036d4b1b5f 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 (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,8 +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](https://developer.android.com/training/articles/direct-boot). + // 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. @@ -182,8 +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](https://goo.gl/GjONJv). + // more information, see Setting the priority of a message + // (https://goo.gl/GjONJv). // // Possible values: // "NORMAL" - Default priority for data messages. Normal priority @@ -281,22 +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](https://goo.gl/MalYE3) 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](https://goo.gl/NdFZGI) for more information. + // See String Resources (https://goo.gl/NdFZGI) 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 + // (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 @@ -309,35 +309,32 @@ 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 + // 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. 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 + // (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/core/res/res/values/config.xml). If - // `default_vibrate_timings` is set to true and `vibrate_timings` is + // 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`. 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 + // (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,21 +356,20 @@ 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 + // (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 // 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 + // (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 @@ -384,10 +380,9 @@ 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 + // (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 @@ -438,31 +433,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](https://goo.gl/MalYE3) 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](https://goo.gl/NdFZGI) for more + // 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](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 + // (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/andr - // oid/app/Notification.html#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 @@ -498,26 +493,23 @@ func (s *AndroidNotification) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ApnsConfig: [Apple Push Notification Service](https://goo.gl/MXRTPa) +// 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](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 + // (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_up_a_remote_notification_server/generating_a_remote_notificat - // ion). If present, it overrides - // google.firebase.fcm.v1.Notification.title and - // google.firebase.fcm.v1.Notification.body. + // dictionary and custom payload. See Payload Key Reference + // (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 @@ -730,21 +722,18 @@ 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 + // (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/r - // eference/google.protobuf#google.protobuf.Duration) + // 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/r - // eference/google.protobuf#google.protobuf.Duration) + // 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 @@ -773,11 +762,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](https://goo.gl/4GLdUl). + // through FCM connection server (https://goo.gl/4GLdUl). 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 + // (https://goo.gl/MXRTPa) specific options. Apns *ApnsConfig `json:"apns,omitempty"` // Condition: Condition to send a message to, e.g. "'foo' in topics && @@ -808,8 +797,8 @@ 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 + // (https://tools.ietf.org/html/rfc8030) options. Webpush *WebpushConfig `json:"webpush,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -912,8 +901,8 @@ 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 (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. @@ -922,15 +911,15 @@ 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 + // 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 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). - // 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 4cf26c3ca8a..d263574b586 100644 --- a/file/v1/file-gen.go +++ b/file/v1/file-gen.go @@ -1303,13 +1303,13 @@ 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 + // (/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](https://www.arin.net/knowledge/address_filters.html) that + // 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 @@ -1602,11 +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](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/file/v1beta1/file-gen.go b/file/v1beta1/file-gen.go index 35c638cc224..77f23e209a6 100644 --- a/file/v1beta1/file-gen.go +++ b/file/v1beta1/file-gen.go @@ -1308,18 +1308,18 @@ 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 + // (/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](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 + // (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. ReservedIpRange string `json:"reservedIpRange,omitempty"` // ForceSendFields is a list of field names (e.g. "IpAddresses") to @@ -1612,11 +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](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/firebase/v1beta1/firebase-gen.go b/firebase/v1beta1/firebase-gen.go index 6b7fa09ac48..c03cc37ac22 100644 --- a/firebase/v1beta1/firebase-gen.go +++ b/firebase/v1beta1/firebase-gen.go @@ -259,29 +259,28 @@ 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` + // (../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`](../../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` + // (../../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`](../../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` + // (../../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 TimeZone string `json:"timeZone,omitempty"` // ForceSendFields is a list of field names (e.g. "LocationId") to @@ -308,11 +307,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 + // (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 @@ -348,11 +347,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 - // 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) + // 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"` @@ -443,11 +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`](../../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` + // (../../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 @@ -485,15 +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`](../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 + // 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)). + // (see `appId` (../projects.androidApps#AndroidApp.FIELDS.app_id)). Name string `json:"name,omitempty"` // PackageName: Immutable. The canonical package name of the Android app @@ -575,20 +574,20 @@ 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 + // 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](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) + // 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"` @@ -596,9 +595,9 @@ type DefaultResources struct { // 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 + // 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` @@ -645,8 +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](https://firebase.google.com/docs/projects/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 @@ -737,24 +736,23 @@ 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` +// (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. 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 + // `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"` @@ -832,15 +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`](../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 + // 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)). + // (see `appId` (../projects.iosApps#IosApp.FIELDS.app_id)). Name string `json:"name,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier of the parent @@ -1204,14 +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](https://firebase.google.com/docs/projects/locations#types). + // 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](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 + // (https://firebase.google.com/docs/projects/locations#types) for data + // replication. // // Possible values: // "LOCATION_TYPE_UNSPECIFIED" - Used internally for distinguishing @@ -1319,20 +1317,20 @@ 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 + // (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`](../projects.defaultLocation/finalize) + // `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`](../projects#FirebaseProject.FIELDS.name) field for details - // about PROJECT_IDENTIFIER values. + // Refer to the `FirebaseProject` `name` + // (../projects#FirebaseProject.FIELDS.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 +1442,17 @@ 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: 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 - // )). + // (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`. @@ -1490,11 +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](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. @@ -1585,7 +1582,7 @@ 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) + // `FirebaseProject` `name` (../projects#FirebaseProject.FIELDS.name) // field for details about PROJECT_IDENTIFIER values. App string `json:"app,omitempty"` @@ -1593,14 +1590,14 @@ type StreamMapping struct { // 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 + // (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](https://support.google.com/analytics/answer/9303323). + // 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 @@ -1641,15 +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`](../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 + // 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)). + // (see `appId` (../projects.webApps#WebApp.FIELDS.app_id)). Name string `json:"name,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier of the parent @@ -1708,11 +1705,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 - // 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) + // 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"` @@ -1721,16 +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](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 + // (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. MeasurementId string `json:"measurementId,omitempty"` // MessagingSenderId: The sender ID for use with Firebase Cloud @@ -1784,12 +1780,12 @@ 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. +// 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. func (r *AvailableProjectsService) List() *AvailableProjectsListCall { c := &AvailableProjectsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -2124,20 +2120,20 @@ 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`](../../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 +// 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 @@ -2286,46 +2282,44 @@ 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 -// `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 +// 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](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 +// `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). +// `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 @@ -2616,9 +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](https://firebase.google.com/docs/admin/setup#initializ -// e_the_sdk) 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 @@ -3107,7 +3101,7 @@ type ProjectsPatchCall struct { } // Patch: Updates the attributes of the specified FirebaseProject. All -// [query parameters](#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 @@ -3269,13 +3263,13 @@ 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` +// (../../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`. func (r *ProjectsService) RemoveAnalytics(parent string, removeanalyticsrequest *RemoveAnalyticsRequest) *ProjectsRemoveAnalyticsCall { c := &ProjectsRemoveAnalyticsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -3428,26 +3422,26 @@ 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 (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 // 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 +4858,18 @@ 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 +// 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, +// possible location restrictions +// (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 @@ -5078,35 +5072,33 @@ 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 +// (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 +// 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. func (r *ProjectsDefaultLocationService) Finalize(parent string, finalizedefaultlocationrequest *FinalizeDefaultLocationRequest) *ProjectsDefaultLocationFinalizeCall { c := &ProjectsDefaultLocationFinalizeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent 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 35e244ab18d..cf49593bca6 100644 --- a/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go +++ b/firebasedynamiclinks/v1/firebasedynamiclinks-gen.go @@ -246,17 +246,15 @@ 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 + // (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-sh - // ortener). + // , Learn more + // (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 @@ -341,17 +339,15 @@ 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 + // (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-sh - // ortener). + // , Learn more + // (https://firebase.google.com/docs/reference/dynamic-links/link-shortener). LongDynamicLink string `json:"longDynamicLink,omitempty"` // SdkVersion: Google SDK version. Version takes the form @@ -564,21 +560,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](https://firebase.google.com/docs/dynamic-links/create- - // manually). + // 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](https://firebase.google.com/docs/dynamic-links/create- - // manually). + // 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](https://firebase.google.com/docs/dynamic-links/create- - // manually). + // 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, @@ -589,23 +582,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](https://firebase.google.com/docs/dynamic-links/android/receive) - // on how to set up Dynamic Link domain associated with your Firebase + // 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](https://firebase.google.com/docs/dynamic-links/create- - // manually). + // 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](https://firebase.google.com/docs/dynamic-links/create- - // manually). 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 @@ -1061,14 +1054,13 @@ 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 +// (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 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 55b0881baf1..2d4731e1ea2 100644 --- a/firebasehosting/v1/firebasehosting-gen.go +++ b/firebasehosting/v1/firebasehosting-gen.go @@ -247,11 +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](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/firebasehosting/v1beta1/firebasehosting-gen.go b/firebasehosting/v1beta1/firebasehosting-gen.go index 5f704865933..33b177b8e51 100644 --- a/firebasehosting/v1beta1/firebasehosting-gen.go +++ b/firebasehosting/v1beta1/firebasehosting-gen.go @@ -786,14 +786,14 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } -// Header: A [`header`](/docs/hosting/full-config#headers) is an object +// 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](/docs/hosting/full-config#glob_pattern_matching) 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. @@ -861,9 +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`](../sites.channels/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 @@ -930,9 +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`](../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` + // (../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, @@ -1234,14 +1234,14 @@ func (s *PreviewConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Redirect: A [`redirect`](/docs/hosting/full-config#redirects) object +// 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](/docs/hosting/full-config#glob_pattern_matching) 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 @@ -1283,9 +1283,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 (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. @@ -1293,8 +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`](sites.releases/create) 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 @@ -1350,7 +1349,7 @@ func (s *Release) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Rewrite: A [`rewrite`](/docs/hosting/full-config#rewrites) object +// 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. @@ -1363,9 +1362,9 @@ 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 + // (/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. @@ -1405,8 +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](/docs/hosting/full-config#hosting_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. // @@ -1523,11 +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](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. @@ -1565,12 +1564,12 @@ 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 (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`](/docs/cli/#the_firebasejson_file) 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. @@ -1603,8 +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`](../sites.versions/create) 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 @@ -1615,14 +1614,14 @@ 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` (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 @@ -2031,10 +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](../sites.SiteConfig) that you +// 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. +// `max_versions` (../sites.SiteConfig.max_versions) will be used. func (c *ProjectsSitesUpdateConfigCall) UpdateMask(updateMask string) *ProjectsSitesUpdateConfigCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -5075,7 +5074,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 +// `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)} @@ -5085,10 +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](../sites.versions) that you want to update. +// 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. +// 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 @@ -5756,10 +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](../sites.SiteConfig) that you +// 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. +// `max_versions` (../sites.SiteConfig.max_versions) will be used. func (c *SitesUpdateConfigCall) UpdateMask(updateMask string) *SitesUpdateConfigCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -8800,7 +8799,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 +// `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)} @@ -8810,10 +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](../sites.versions) that you want to update. +// 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. +// 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 bfc65431c63..d5f406433a5 100644 --- a/firebaseml/v1/firebaseml-gen.go +++ b/firebaseml/v1/firebaseml-gen.go @@ -298,11 +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](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/firebaseml/v1beta2/firebaseml-gen.go b/firebaseml/v1beta2/firebaseml-gen.go index e09a8d4e384..43e7f42063c 100644 --- a/firebaseml/v1beta2/firebaseml-gen.go +++ b/firebaseml/v1beta2/firebaseml-gen.go @@ -428,11 +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](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/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index 3f3a36c3220..6182718ecf4 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -2874,11 +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](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. @@ -3496,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3642,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3792,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3966,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4160,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4310,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4449,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4591,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4758,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4935,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5081,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5222,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5363,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5522,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5696,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5872,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6092,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6297,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6459,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6603,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6797,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6961,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7102,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7243,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7393,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7535,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7679,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7854,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8037,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8204,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") 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..6678d1dabab 100644 --- a/firestore/v1beta1/firestore-gen.go +++ b/firestore/v1beta1/firestore-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -2401,11 +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](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. @@ -3023,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3169,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3312,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3458,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3599,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3740,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3899,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4073,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4249,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4469,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4674,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4836,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4980,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5174,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5338,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5479,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5620,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5769,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5908,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6050,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6215,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/20201110") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/firestore/v1beta2/firestore-gen.go b/firestore/v1beta2/firestore-gen.go index e377d1bb121..efc0aedbeb7 100644 --- a/firestore/v1beta2/firestore-gen.go +++ b/firestore/v1beta2/firestore-gen.go @@ -1035,11 +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](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/gameservices/v1/gameservices-gen.go b/gameservices/v1/gameservices-gen.go index 7304495c2cc..c4b6a9ca9bd 100644 --- a/gameservices/v1/gameservices-gen.go +++ b/gameservices/v1/gameservices-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -364,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1886,9 +1885,10 @@ 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 +// (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", @@ -1906,8 +1906,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1958,9 +1958,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2487,11 +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](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. @@ -2697,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2813,7 +2813,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2987,7 +2987,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3172,7 +3172,7 @@ func (c *ProjectsLocationsGameServerDeploymentsCreateCall) Header() http.Header func (c *ProjectsLocationsGameServerDeploymentsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3315,7 +3315,7 @@ func (c *ProjectsLocationsGameServerDeploymentsDeleteCall) Header() http.Header func (c *ProjectsLocationsGameServerDeploymentsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3450,7 +3450,7 @@ func (c *ProjectsLocationsGameServerDeploymentsFetchDeploymentStateCall) Header( func (c *ProjectsLocationsGameServerDeploymentsFetchDeploymentStateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3599,7 +3599,7 @@ func (c *ProjectsLocationsGameServerDeploymentsGetCall) Header() http.Header { func (c *ProjectsLocationsGameServerDeploymentsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3715,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -3760,7 +3759,7 @@ func (c *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall) Header() http.H func (c *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3910,7 +3909,7 @@ func (c *ProjectsLocationsGameServerDeploymentsGetRolloutCall) Header() http.Hea func (c *ProjectsLocationsGameServerDeploymentsGetRolloutCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4086,7 +4085,7 @@ func (c *ProjectsLocationsGameServerDeploymentsListCall) Header() http.Header { func (c *ProjectsLocationsGameServerDeploymentsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4273,7 +4272,7 @@ func (c *ProjectsLocationsGameServerDeploymentsPatchCall) Header() http.Header { func (c *ProjectsLocationsGameServerDeploymentsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4437,7 +4436,7 @@ func (c *ProjectsLocationsGameServerDeploymentsPreviewRolloutCall) Header() http func (c *ProjectsLocationsGameServerDeploymentsPreviewRolloutCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4593,7 +4592,7 @@ func (c *ProjectsLocationsGameServerDeploymentsSetIamPolicyCall) Header() http.H func (c *ProjectsLocationsGameServerDeploymentsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4738,7 +4737,7 @@ func (c *ProjectsLocationsGameServerDeploymentsTestIamPermissionsCall) Header() func (c *ProjectsLocationsGameServerDeploymentsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4893,7 +4892,7 @@ func (c *ProjectsLocationsGameServerDeploymentsUpdateRolloutCall) Header() http. func (c *ProjectsLocationsGameServerDeploymentsUpdateRolloutCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5049,7 +5048,7 @@ func (c *ProjectsLocationsGameServerDeploymentsConfigsCreateCall) Header() http. func (c *ProjectsLocationsGameServerDeploymentsConfigsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5194,7 +5193,7 @@ func (c *ProjectsLocationsGameServerDeploymentsConfigsDeleteCall) Header() http. func (c *ProjectsLocationsGameServerDeploymentsConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5335,7 +5334,7 @@ func (c *ProjectsLocationsGameServerDeploymentsConfigsGetCall) Header() http.Hea func (c *ProjectsLocationsGameServerDeploymentsConfigsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5512,7 +5511,7 @@ func (c *ProjectsLocationsGameServerDeploymentsConfigsListCall) Header() http.He func (c *ProjectsLocationsGameServerDeploymentsConfigsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5698,7 +5697,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5839,7 +5838,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5982,7 +5981,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6156,7 +6155,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6335,7 +6334,7 @@ func (c *ProjectsLocationsRealmsCreateCall) Header() http.Header { func (c *ProjectsLocationsRealmsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6478,7 +6477,7 @@ func (c *ProjectsLocationsRealmsDeleteCall) Header() http.Header { func (c *ProjectsLocationsRealmsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6619,7 +6618,7 @@ func (c *ProjectsLocationsRealmsGetCall) Header() http.Header { func (c *ProjectsLocationsRealmsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6795,7 +6794,7 @@ func (c *ProjectsLocationsRealmsListCall) Header() http.Header { func (c *ProjectsLocationsRealmsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6981,7 +6980,7 @@ func (c *ProjectsLocationsRealmsPatchCall) Header() http.Header { func (c *ProjectsLocationsRealmsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7143,7 +7142,7 @@ func (c *ProjectsLocationsRealmsPreviewUpdateCall) Header() http.Header { func (c *ProjectsLocationsRealmsPreviewUpdateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7304,7 +7303,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersCreateCall) Header() http.Head func (c *ProjectsLocationsRealmsGameServerClustersCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7447,7 +7446,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersDeleteCall) Header() http.Head func (c *ProjectsLocationsRealmsGameServerClustersDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7588,7 +7587,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersGetCall) Header() http.Header func (c *ProjectsLocationsRealmsGameServerClustersGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7764,7 +7763,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersListCall) Header() http.Header func (c *ProjectsLocationsRealmsGameServerClustersListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7950,7 +7949,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersPatchCall) Header() http.Heade func (c *ProjectsLocationsRealmsGameServerClustersPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8112,7 +8111,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersPreviewCreateCall) Header() ht func (c *ProjectsLocationsRealmsGameServerClustersPreviewCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8269,7 +8268,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersPreviewDeleteCall) Header() ht func (c *ProjectsLocationsRealmsGameServerClustersPreviewDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8424,7 +8423,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersPreviewUpdateCall) Header() ht func (c *ProjectsLocationsRealmsGameServerClustersPreviewUpdateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/gameservices/v1beta/gameservices-gen.go b/gameservices/v1beta/gameservices-gen.go index 0dedaa6cef6..856045b4793 100644 --- a/gameservices/v1beta/gameservices-gen.go +++ b/gameservices/v1beta/gameservices-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -364,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1886,9 +1885,10 @@ 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 +// (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", @@ -1906,8 +1906,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1958,9 +1958,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2487,11 +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](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. @@ -2697,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2813,7 +2813,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2987,7 +2987,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3172,7 +3172,7 @@ func (c *ProjectsLocationsGameServerDeploymentsCreateCall) Header() http.Header func (c *ProjectsLocationsGameServerDeploymentsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3315,7 +3315,7 @@ func (c *ProjectsLocationsGameServerDeploymentsDeleteCall) Header() http.Header func (c *ProjectsLocationsGameServerDeploymentsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3450,7 +3450,7 @@ func (c *ProjectsLocationsGameServerDeploymentsFetchDeploymentStateCall) Header( func (c *ProjectsLocationsGameServerDeploymentsFetchDeploymentStateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3599,7 +3599,7 @@ func (c *ProjectsLocationsGameServerDeploymentsGetCall) Header() http.Header { func (c *ProjectsLocationsGameServerDeploymentsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3715,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -3760,7 +3759,7 @@ func (c *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall) Header() http.H func (c *ProjectsLocationsGameServerDeploymentsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3910,7 +3909,7 @@ func (c *ProjectsLocationsGameServerDeploymentsGetRolloutCall) Header() http.Hea func (c *ProjectsLocationsGameServerDeploymentsGetRolloutCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4086,7 +4085,7 @@ func (c *ProjectsLocationsGameServerDeploymentsListCall) Header() http.Header { func (c *ProjectsLocationsGameServerDeploymentsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4273,7 +4272,7 @@ func (c *ProjectsLocationsGameServerDeploymentsPatchCall) Header() http.Header { func (c *ProjectsLocationsGameServerDeploymentsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4437,7 +4436,7 @@ func (c *ProjectsLocationsGameServerDeploymentsPreviewRolloutCall) Header() http func (c *ProjectsLocationsGameServerDeploymentsPreviewRolloutCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4593,7 +4592,7 @@ func (c *ProjectsLocationsGameServerDeploymentsSetIamPolicyCall) Header() http.H func (c *ProjectsLocationsGameServerDeploymentsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4738,7 +4737,7 @@ func (c *ProjectsLocationsGameServerDeploymentsTestIamPermissionsCall) Header() func (c *ProjectsLocationsGameServerDeploymentsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4893,7 +4892,7 @@ func (c *ProjectsLocationsGameServerDeploymentsUpdateRolloutCall) Header() http. func (c *ProjectsLocationsGameServerDeploymentsUpdateRolloutCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5049,7 +5048,7 @@ func (c *ProjectsLocationsGameServerDeploymentsConfigsCreateCall) Header() http. func (c *ProjectsLocationsGameServerDeploymentsConfigsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5194,7 +5193,7 @@ func (c *ProjectsLocationsGameServerDeploymentsConfigsDeleteCall) Header() http. func (c *ProjectsLocationsGameServerDeploymentsConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5335,7 +5334,7 @@ func (c *ProjectsLocationsGameServerDeploymentsConfigsGetCall) Header() http.Hea func (c *ProjectsLocationsGameServerDeploymentsConfigsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5512,7 +5511,7 @@ func (c *ProjectsLocationsGameServerDeploymentsConfigsListCall) Header() http.He func (c *ProjectsLocationsGameServerDeploymentsConfigsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5698,7 +5697,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5839,7 +5838,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5982,7 +5981,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6156,7 +6155,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/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6335,7 +6334,7 @@ func (c *ProjectsLocationsRealmsCreateCall) Header() http.Header { func (c *ProjectsLocationsRealmsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6478,7 +6477,7 @@ func (c *ProjectsLocationsRealmsDeleteCall) Header() http.Header { func (c *ProjectsLocationsRealmsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6619,7 +6618,7 @@ func (c *ProjectsLocationsRealmsGetCall) Header() http.Header { func (c *ProjectsLocationsRealmsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6795,7 +6794,7 @@ func (c *ProjectsLocationsRealmsListCall) Header() http.Header { func (c *ProjectsLocationsRealmsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6981,7 +6980,7 @@ func (c *ProjectsLocationsRealmsPatchCall) Header() http.Header { func (c *ProjectsLocationsRealmsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7143,7 +7142,7 @@ func (c *ProjectsLocationsRealmsPreviewUpdateCall) Header() http.Header { func (c *ProjectsLocationsRealmsPreviewUpdateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7304,7 +7303,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersCreateCall) Header() http.Head func (c *ProjectsLocationsRealmsGameServerClustersCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7447,7 +7446,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersDeleteCall) Header() http.Head func (c *ProjectsLocationsRealmsGameServerClustersDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7588,7 +7587,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersGetCall) Header() http.Header func (c *ProjectsLocationsRealmsGameServerClustersGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7764,7 +7763,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersListCall) Header() http.Header func (c *ProjectsLocationsRealmsGameServerClustersListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7950,7 +7949,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersPatchCall) Header() http.Heade func (c *ProjectsLocationsRealmsGameServerClustersPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8112,7 +8111,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersPreviewCreateCall) Header() ht func (c *ProjectsLocationsRealmsGameServerClustersPreviewCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8269,7 +8268,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersPreviewDeleteCall) Header() ht func (c *ProjectsLocationsRealmsGameServerClustersPreviewDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8424,7 +8423,7 @@ func (c *ProjectsLocationsRealmsGameServerClustersPreviewUpdateCall) Header() ht func (c *ProjectsLocationsRealmsGameServerClustersPreviewUpdateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20201215") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/genomics/v1/genomics-gen.go b/genomics/v1/genomics-gen.go index 2a0d5800890..661cfb526b5 100644 --- a/genomics/v1/genomics-gen.go +++ b/genomics/v1/genomics-gen.go @@ -798,11 +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](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. @@ -957,7 +957,7 @@ 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) +// 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)} @@ -1102,7 +1102,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: * +// 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)} @@ -1249,8 +1249,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: * +// 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)} @@ -1270,9 +1270,9 @@ 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 +// (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 >= // 1432140000` * `projectId = my-project AND createTime >= 1432140000 diff --git a/genomics/v1alpha2/genomics-gen.go b/genomics/v1alpha2/genomics-gen.go index 18bd9a5abec..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-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 + // (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 @@ -1627,11 +1628,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](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. @@ -1818,7 +1819,7 @@ 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) +// 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)} @@ -1963,7 +1964,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: * +// 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)} @@ -2110,8 +2111,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: * +// 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)} @@ -2131,9 +2132,9 @@ 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 +// (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 >= // 1432140000` * `projectId = my-project AND createTime >= 1432140000 diff --git a/genomics/v2alpha1/genomics-gen.go b/genomics/v2alpha1/genomics-gen.go index f252c9eb55b..71239a80eaf 100644 --- a/genomics/v2alpha1/genomics-gen.go +++ b/genomics/v2alpha1/genomics-gen.go @@ -1640,11 +1640,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](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. @@ -1800,9 +1800,10 @@ 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 + // 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. @@ -1812,10 +1813,9 @@ type VirtualMachine struct { // 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 + // (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. @@ -2031,8 +2031,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](https://cloud.google.com/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)} @@ -2165,7 +2165,7 @@ 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) +// 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)} @@ -2310,7 +2310,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: * +// 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)} @@ -2457,8 +2457,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: * +// 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)} @@ -2478,9 +2478,9 @@ 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 +// (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 >= // 1432140000` * `projectId = my-project AND createTime >= 1432140000 diff --git a/gmail/v1/gmail-gen.go b/gmail/v1/gmail-gen.go index 55451c2ec82..726c7dad78f 100644 --- a/gmail/v1/gmail-gen.go +++ b/gmail/v1/gmail-gen.go @@ -1526,8 +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` + // `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. ThreadId string `json:"threadId,omitempty"` diff --git a/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go b/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go index acaa3e5e1cf..464ce3350d3 100644 --- a/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go +++ b/gmailpostmastertools/v1beta1/gmailpostmastertools-gen.go @@ -293,8 +293,8 @@ 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 +// FeedbackLoop: Feedback loop +// (https://support.google.com/mail/answer/6254652) identifier // information. type FeedbackLoop struct { // Id: Feedback loop identifier that uniquely identifies individual @@ -346,15 +346,14 @@ 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 + // (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](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 + // (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"` // Reputation: The reputation category this IP reputation represents. @@ -478,19 +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](http://www.openspf.org/) or - // [DKIM](http://www.dkim.org/). + // 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](http://www.dkim.org/). 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](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 + // (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. @@ -515,8 +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](http://www.openspf.org/) or [DKIM](http://www.dkim.org/). + // 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 @@ -540,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](http://www.dkim.org/). + // 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](http://www.openspf.org/). 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](http://www.dkim.org/). + // 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 657243197e8..6a9b2782e6a 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 @@ -2475,7 +2475,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 +2492,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 { @@ -2641,3 +2644,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], 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 1eda4b921cb..13ace509edb 100644 --- a/google-api-go-generator/gen_test.go +++ b/google-api-go-generator/gen_test.go @@ -242,3 +242,43 @@ func TestIsNewerRevision(t *testing.T) { t.Fatalf("got %v, want %v", err, errOldRevision) } } + +func TestRemoveMarkdownLinks(t *testing.T) { + tests := []struct { + name string + input string + want string + }{ + {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 (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 (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) { + if got := removeMarkdownLinks(tc.input); got != tc.want { + t.Errorf("removeMarkdownLinks(%q) = %q, want %q", tc.input, got, tc.want) + } + }) + } +} + +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..19a9101c00b 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. @@ -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"` @@ -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..815861456cb 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,10 @@ 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 +3679,16 @@ 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 +4551,19 @@ 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 fa32c0eee2d..cc0e4883986 100644 --- a/healthcare/v1/healthcare-gen.go +++ b/healthcare/v1/healthcare-gen.go @@ -393,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1198,16 +1197,16 @@ 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 + // (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. @@ -1238,10 +1237,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 + // `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. StreamConfigs []*StreamConfig `json:"streamConfigs,omitempty"` @@ -1604,29 +1603,42 @@ 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](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 + // (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](https://cloud.google.com/pubsub/docs/overview#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](/healthcare/docs/how-tos/logging)). + // 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 @@ -2403,25 +2415,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](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 + // (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 string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "PubsubTopic") to @@ -2530,8 +2541,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](/healthcare/docs/how-tos/logging). + // 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 @@ -2661,9 +2672,10 @@ 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 +// (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", @@ -2681,8 +2693,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2721,9 +2733,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2884,12 +2896,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](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 + // (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 @@ -2999,11 +3010,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](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. @@ -3072,8 +3083,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](/healthcare/docs/how-tos/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 @@ -3111,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"` @@ -3143,8 +3155,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -3754,8 +3766,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](/healthcare/docs/how-tos/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 @@ -4187,9 +4199,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -5130,8 +5141,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](/healthcare/docs/how-tos/logging)). +// 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 @@ -5404,8 +5415,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 (/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 @@ -5705,9 +5716,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -5858,8 +5868,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 (/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 @@ -6008,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) @@ -6362,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](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). +// (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_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 @@ -6494,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](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). +// (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_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 @@ -6626,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](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). +// (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_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 @@ -6900,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](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). +// (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_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 +7177,8 @@ 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 +// (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 @@ -7316,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](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). +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7447,15 +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_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). +// (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 @@ -7579,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](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). +// (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_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 @@ -7711,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](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). +// (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_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 @@ -7843,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](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). +// (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_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 +7968,9 @@ 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 +// (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 @@ -8115,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](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). +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8246,15 +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_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). +// (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 @@ -8378,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](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). +// (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_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 +8508,8 @@ 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 +// (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 @@ -8659,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_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). +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveInstance(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8794,15 +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](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). +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8927,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](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). +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9060,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](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). +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveFrames(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9192,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](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). +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9478,8 +9466,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](/healthcare/docs/how-tos/logging)). +// 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 @@ -9754,7 +9742,7 @@ 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)). +// 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. @@ -10057,9 +10045,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -10258,11 +10245,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](/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. +// 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 @@ -10411,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) @@ -11051,32 +11039,31 @@ 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 -// 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 +// 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#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 +// 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 -// _compartment_resources). +// 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 @@ -11274,10 +11261,10 @@ 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 +// (/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 @@ -11408,23 +11395,22 @@ 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 +// 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#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 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 @@ -11537,11 +11523,10 @@ 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)), +// 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`. @@ -11552,9 +11537,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirCreateCall struct { // `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). +// 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 @@ -11665,19 +11649,17 @@ 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)). +// 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_reso -// urce). +// 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 @@ -11776,26 +11758,24 @@ 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)). +// 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 @@ -11807,8 +11787,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall struct { // 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). +// 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 @@ -11911,22 +11891,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](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 -// 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). +// 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 @@ -12101,13 +12080,13 @@ 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: +// 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 @@ -12115,9 +12094,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirPatchCall struct { // 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). +// 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 @@ -12219,16 +12197,14 @@ 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)) +// 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 @@ -12236,9 +12212,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirReadCall struct { // 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). +// 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 @@ -12351,16 +12326,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](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)) +// 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 +// (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 @@ -12376,13 +12350,13 @@ 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`, +// 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.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 @@ -12395,9 +12369,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // 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). +// 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 @@ -12505,12 +12479,11 @@ 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 +// 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: @@ -12522,9 +12495,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirUpdateCall struct { // 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). +// 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 @@ -12627,20 +12599,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](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 +// 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). +// 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 @@ -13195,9 +13166,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -13355,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) @@ -14609,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 4e07fd58c5e..4019148fed4 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -910,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -2395,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 @@ -2681,16 +2686,16 @@ 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 + // (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. @@ -2721,10 +2726,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 + // `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. StreamConfigs []*StreamConfig `json:"streamConfigs,omitempty"` @@ -3433,7 +3438,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 + // Cloud Logging (see Viewing logs (/healthcare/docs/how- [Viewing // logs](/healthcare/docs/how-tos/logging)). BigqueryDestination *GoogleCloudHealthcareV1beta1DicomBigQueryDestination `json:"bigqueryDestination,omitempty"` @@ -3870,27 +3875,41 @@ 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](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 + // (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](https://cloud.google.com/pubsub/docs/overview#names) must be - // scoped to a project. Cloud Healthcare API service account must have + // 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). + // 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 @@ -5214,25 +5233,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](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 + // (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 string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "PubsubTopic") to @@ -5341,8 +5359,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](/healthcare/docs/how-tos/logging). + // 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 @@ -5492,9 +5510,10 @@ 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 +// (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", @@ -5512,8 +5531,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -5552,9 +5571,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -6085,12 +6104,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](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 + // (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 @@ -6269,11 +6287,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](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. @@ -6342,8 +6360,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](/healthcare/docs/how-tos/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 @@ -6381,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"` @@ -6413,8 +6432,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -7239,8 +7258,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](/healthcare/docs/how-tos/logging). +// 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 @@ -7672,9 +7691,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -8744,7 +8762,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 (/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 @@ -8888,8 +8906,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](/healthcare/docs/how-tos/logging)). +// 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 @@ -9190,9 +9208,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -9346,7 +9363,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 (/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 @@ -9496,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) @@ -11698,9 +11716,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -11858,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) @@ -12064,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 @@ -13102,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 @@ -13308,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) @@ -13877,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) @@ -14779,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 @@ -14986,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 @@ -15196,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) @@ -16194,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 @@ -16704,8 +16731,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](/healthcare/docs/how-tos/logging). +// 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 @@ -16978,8 +17005,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 (/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 @@ -17279,9 +17306,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -17432,8 +17458,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 (/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 @@ -17582,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) @@ -17935,16 +17962,15 @@ 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 +// (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_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 +18093,15 @@ 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 +// (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_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 +18224,15 @@ 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 +// (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_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 +18497,14 @@ 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 +// (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_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 +18908,14 @@ 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 +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19016,16 +19038,14 @@ 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 +// (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 @@ -19148,16 +19168,15 @@ 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 +// (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_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 +19299,15 @@ 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 +// (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_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 +19430,14 @@ 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 +// (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_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 +19698,14 @@ 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 +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19812,16 +19828,14 @@ 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 +// (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 @@ -19944,16 +19958,15 @@ 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 +// (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_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 +20092,8 @@ 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 +// (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 @@ -20225,16 +20237,16 @@ 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 +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveInstance(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveInstanceCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20359,15 +20371,14 @@ 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 +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveMetadata(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20491,16 +20502,15 @@ 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 -// 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). +// acceptable Rendered Media Type. See RetrieveTransaction +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20624,14 +20634,13 @@ 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 +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveFrames(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveFramesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -20755,16 +20764,15 @@ 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 +// (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). func (r *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesService) RetrieveRendered(parent string, dicomWebPath string) *ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall { c := &ProjectsLocationsDatasetsDicomStoresStudiesSeriesInstancesFramesRetrieveRenderedCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -21043,8 +21051,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](/healthcare/docs/how-tos/logging). +// 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 @@ -21319,11 +21327,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](/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 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 @@ -21623,9 +21631,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -21824,11 +21831,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](/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. +// 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 @@ -21977,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) @@ -22617,18 +22625,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](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 +// (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 @@ -22817,18 +22825,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](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 +// (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 @@ -22978,20 +22986,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](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 +// (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` @@ -23114,32 +23122,31 @@ 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 -// `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 +// Patient-everything (DSTU2 +// (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 // 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). +// 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 @@ -23337,10 +23344,10 @@ 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 +// (/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 @@ -23471,23 +23478,22 @@ 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 +// (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/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 @@ -23599,13 +23605,13 @@ 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. +// 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 @@ -23615,9 +23621,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalDeleteCall struct { // 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 +// (/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 @@ -23761,30 +23767,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](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 +// 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](/healthcare/docs/how-tos/fhir-resources#conditionally_patchi -// ng_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 @@ -23899,13 +23905,13 @@ 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 +// 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 @@ -23925,9 +23931,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirConditionalUpdateCall struct { // 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 +// (/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 @@ -24040,19 +24046,17 @@ 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)), +// 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#ccre -// ate), -// [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#ccreate -// ), -// [R4](https://hl7.org/implement/standards/fhir/R4/http.html#ccreate)), +// 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 @@ -24064,10 +24068,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirCreateCall struct { // 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). +// 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 @@ -24178,20 +24181,18 @@ 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)). +// 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_reso -// urce). +// 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 @@ -24290,26 +24291,24 @@ 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)). +// 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 @@ -24328,8 +24327,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirExecuteBundleCall struct { // 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). +// `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 @@ -24432,22 +24431,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](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 +// 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_resourc -// e_versions). +// 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 @@ -24622,23 +24620,22 @@ 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: +// 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). +// 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 @@ -24740,16 +24737,14 @@ 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)) +// 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 @@ -24757,9 +24752,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirReadCall struct { // `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). +// 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 @@ -24872,16 +24866,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](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)). -// 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 @@ -24897,13 +24891,13 @@ 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`, +// Search Parameter Registry (STU3 +// (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 @@ -24916,9 +24910,9 @@ type ProjectsLocationsDatasetsFhirStoresFhirSearchCall struct { // 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). +// 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 @@ -25026,13 +25020,12 @@ 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 +// 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: @@ -25044,9 +25037,8 @@ type ProjectsLocationsDatasetsFhirStoresFhirUpdateCall struct { // `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). +// 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 @@ -25149,20 +25141,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](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 +// 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_res -// ource_version). +// 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 @@ -25864,9 +25855,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -26037,8 +26027,8 @@ 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 +// 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 { @@ -26189,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) @@ -27448,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 17aa7ad499f..905bc82a350 100644 --- a/homegraph/v1/homegraph-gen.go +++ b/homegraph/v1/homegraph-gen.go @@ -221,11 +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](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 + // (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 @@ -246,9 +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](https://developers.google.com/assistant/smarthome/concept - // s/local). + // 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. @@ -259,12 +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](https://developers.google.com/assistant/smarthome/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](https://developers.google.com/assistant/smarthome/guides). + // 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 @@ -378,8 +377,8 @@ 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` +// (#google.home.graph.v1.HomeGraphApiService.Query) call. type QueryRequest struct { // AgentUserId: Required. Third-party user ID. AgentUserId string `json:"agentUserId,omitempty"` @@ -470,12 +469,12 @@ 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` +// (#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": // "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 +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](https://developers.google.com/assistant/smarthome/traits). + // 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](https://developers.google.com/assistant/smarthome/traits). + // 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 @@ -580,11 +579,11 @@ func (s *ReportStateAndNotificationDevice) MarshalJSON() ([]byte, error) { } // ReportStateAndNotificationRequest: Request type for the -// [`ReportStateAndNotification`](#google.home.graph.v1.HomeGraphApiServi -// ce.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 } }, } } } ``` @@ -596,9 +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](https://developers.google.com/assistant/smarthome/develop/notif - // ications) for details on implementing follow up notifications. + // response. Deprecated. See the notifications guide + // (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 @@ -632,8 +631,9 @@ func (s *ReportStateAndNotificationRequest) MarshalJSON() ([]byte, error) { } // ReportStateAndNotificationResponse: Response type for the -// [`ReportStateAndNotification`](#google.home.graph.v1.HomeGraphApiServi -// ce.ReportStateAndNotification) call. +// `ReportStateAndNotification` +// (#google.home.graph.v1.HomeGraphApiService.ReportStateAndNotification) +// call. type ReportStateAndNotificationResponse struct { // RequestId: Request ID copied from ReportStateAndNotificationRequest. RequestId string `json:"requestId,omitempty"` @@ -665,9 +665,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` +// (#google.home.graph.v1.HomeGraphApiService.RequestSyncDevices) call. type RequestSyncDevicesRequest struct { // AgentUserId: Required. Third-party user ID. AgentUserId string `json:"agentUserId,omitempty"` @@ -702,9 +701,10 @@ 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 -// 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. @@ -740,8 +740,8 @@ 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` +// (#google.home.graph.v1.HomeGraphApiService.Sync) call. type SyncRequest struct { // AgentUserId: Required. Third-party user ID. AgentUserId string `json:"agentUserId,omitempty"` @@ -772,12 +772,12 @@ 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` +// (#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": // "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "agentUserId": // "1836.15267389", "devices": [{ "id": "123", "type": // "action.devices.types.OUTLET", "traits": [ @@ -864,12 +864,12 @@ 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 +// (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 @@ -1143,14 +1143,14 @@ 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 -// user's identity is passed in via the `agent_user_id` (see +// about the device. See Implement Report State +// (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 { @@ -1278,10 +1278,10 @@ 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 +// (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 // console project. diff --git a/iam/v1/iam-gen.go b/iam/v1/iam-gen.go index c52ab50dbcc..ee29ada1365 100644 --- a/iam/v1/iam-gen.go +++ b/iam/v1/iam-gen.go @@ -497,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1270,9 +1269,10 @@ 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 +// (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", @@ -1290,8 +1290,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1330,9 +1330,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1696,12 +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](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 +// (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. @@ -1927,13 +1927,13 @@ 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 +// SignBlobRequest: Deprecated. Migrate to Service Account Credentials +// 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](https://cloud.google.com/iam/help/credentials/migrate-api). The + // BytesToSign: Required. Deprecated. Migrate to Service Account + // Credentials API + // (https://cloud.google.com/iam/help/credentials/migrate-api). The // bytes to sign. BytesToSign string `json:"bytesToSign,omitempty"` @@ -1960,17 +1960,17 @@ 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 +// SignBlobResponse: Deprecated. Migrate to Service Account Credentials +// 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](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 + // (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](https://cloud.google.com/iam/help/credentials/migrate-api). The + // 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"` @@ -2001,13 +2001,12 @@ 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 +// SignJwtRequest: Deprecated. Migrate to Service Account Credentials +// 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](https://cloud.google.com/iam/help/credentials/migrate-api). The + // 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`) @@ -2040,17 +2039,17 @@ 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 +// SignJwtResponse: Deprecated. Migrate to Service Account Credentials +// 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](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 + // (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](https://cloud.google.com/iam/help/credentials/migrate-api). The + // 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"` @@ -2083,11 +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](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. @@ -2130,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2428,8 +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](https://cloud.google.com/logging/docs/audit). +// 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 @@ -5642,8 +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`](https://cloud.google.com/resource-manager/re -// ference/rest/v1/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 @@ -5657,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -6138,10 +6137,9 @@ 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 +// (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,12 +6280,11 @@ 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 -// Credentials API instead. If you currently use this method, see the -// [migration -// guide](https://cloud.google.com/iam/help/credentials/migrate-api) for +// on July 1, 2021. Use the `signBlob` +// (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. func (r *ProjectsServiceAccountsService) SignBlob(name string, signblobrequest *SignBlobRequest) *ProjectsServiceAccountsSignBlobCall { @@ -6430,12 +6427,11 @@ 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 -// Credentials API instead. If you currently use this method, see the -// [migration -// guide](https://cloud.google.com/iam/help/credentials/migrate-api) for +// July 1, 2021. Use the `signJwt` +// (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. func (r *ProjectsServiceAccountsService) SignJwt(name string, signjwtrequest *SignJwtRequest) *ProjectsServiceAccountsSignJwtCall { @@ -7933,24 +7929,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`](/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` +// (/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: // `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()` +// (/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 1edf460b2ac..d31db458680 100644 --- a/iap/v1/iap-gen.go +++ b/iap/v1/iap-gen.go @@ -299,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -625,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -813,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 @@ -851,9 +850,10 @@ 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 +// (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", @@ -871,8 +871,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 (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 @@ -907,9 +907,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1130,8 +1130,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 35fb5d2aea4..fb3f6cfbaac 100644 --- a/iap/v1beta1/iap-gen.go +++ b/iap/v1beta1/iap-gen.go @@ -152,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -315,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -356,9 +354,10 @@ 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 +// (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", @@ -376,8 +375,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 (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 @@ -412,9 +411,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -480,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 0b63237bdd3..d0830c63e81 100644 --- a/jobs/v3/jobs-gen.go +++ b/jobs/v3/jobs-gen.go @@ -1753,8 +1753,8 @@ 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" + // "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'. @@ -2274,9 +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](https://tools.ietf.org/html/bcp47). 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 @@ -2303,8 +2303,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 (https://tools.ietf.org/html/bcp47). QueryLanguageCode string `json:"queryLanguageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "CommuteFilter") to @@ -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 @@ -3675,15 +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](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. +// 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 @@ -3691,8 +3690,8 @@ 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 +// "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 @@ -3946,10 +3945,9 @@ 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) +// 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)} diff --git a/jobs/v3p1beta1/jobs-gen.go b/jobs/v3p1beta1/jobs-gen.go index 4f1256ff653..b1097cccd89 100644 --- a/jobs/v3p1beta1/jobs-gen.go +++ b/jobs/v3p1beta1/jobs-gen.go @@ -1967,8 +1967,8 @@ 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" + // "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'. @@ -2493,9 +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](https://tools.ietf.org/html/bcp47). 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 @@ -2522,8 +2522,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 (https://tools.ietf.org/html/bcp47). QueryLanguageCode string `json:"queryLanguageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "CommuteFilter") to @@ -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 @@ -3810,11 +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](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. @@ -4031,15 +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](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. +// 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 @@ -4047,8 +4046,8 @@ 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 +// "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 @@ -4302,10 +4301,9 @@ 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) +// 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)} diff --git a/jobs/v4/jobs-gen.go b/jobs/v4/jobs-gen.go index af3dc0d95b8..b9627876b65 100644 --- a/jobs/v4/jobs-gen.go +++ b/jobs/v4/jobs-gen.go @@ -1584,8 +1584,8 @@ 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" + // "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'. @@ -2114,9 +2114,9 @@ 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 + // (https://tools.ietf.org/html/bcp47). At most 10 language code filters + // are allowed. LanguageCodes []string `json:"languageCodes,omitempty"` // LocationFilters: The location filter specifies geo-regions containing @@ -2143,8 +2143,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 (https://tools.ietf.org/html/bcp47). QueryLanguageCode string `json:"queryLanguageCode,omitempty"` // ForceSendFields is a list of field names (e.g. "CommuteFilter") to @@ -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 @@ -3466,11 +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](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. @@ -3657,8 +3657,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 +// "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. func (c *ProjectsTenantsCompleteQueryCall) LanguageCodes(languageCodes ...string) *ProjectsTenantsCompleteQueryCall { c.urlParams_.SetMulti("languageCodes", append([]string{}, languageCodes...)) @@ -4674,10 +4674,9 @@ 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) +// 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)} diff --git a/language/v1/language-gen.go b/language/v1/language-gen.go index a7b46dc7cd3..e21a03ed554 100644 --- a/language/v1/language-gen.go +++ b/language/v1/language-gen.go @@ -610,8 +610,8 @@ 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 + // (https://cloud.google.com/natural-language/docs/categories). Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -853,12 +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](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 + // (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`, @@ -1346,11 +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](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. @@ -1426,7 +1426,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) + // Lemma: Lemma (https://en.wikipedia.org/wiki/Lemma_%28morphology%29) // of the token. Lemma string `json:"lemma,omitempty"` diff --git a/language/v1beta1/language-gen.go b/language/v1beta1/language-gen.go index 5dd876be2b5..fa31f37a4f4 100644 --- a/language/v1beta1/language-gen.go +++ b/language/v1beta1/language-gen.go @@ -655,12 +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](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 + // (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`, @@ -1114,11 +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](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. @@ -1194,7 +1194,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) + // Lemma: Lemma (https://en.wikipedia.org/wiki/Lemma_%28morphology%29) // of the token. Lemma string `json:"lemma,omitempty"` diff --git a/language/v1beta2/language-gen.go b/language/v1beta2/language-gen.go index 9dc3fc55ed8..a8b6acc02a2 100644 --- a/language/v1beta2/language-gen.go +++ b/language/v1beta2/language-gen.go @@ -610,8 +610,8 @@ 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 + // (https://cloud.google.com/natural-language/docs/categories). Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -865,12 +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](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 + // (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 @@ -1061,8 +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](https://cloud.google.com/natural-language/docs/categories). + // predefined taxonomy + // (https://cloud.google.com/natural-language/docs/categories). ClassifyText bool `json:"classifyText,omitempty"` // ExtractDocumentSentiment: Extract document-level sentiment. @@ -1365,11 +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](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. @@ -1445,7 +1445,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) + // Lemma: Lemma (https://en.wikipedia.org/wiki/Lemma_%28morphology%29) // of the token. Lemma string `json:"lemma,omitempty"` diff --git a/lifesciences/v2beta/lifesciences-gen.go b/lifesciences/v2beta/lifesciences-gen.go index 36309c31399..0df19649e58 100644 --- a/lifesciences/v2beta/lifesciences-gen.go +++ b/lifesciences/v2beta/lifesciences-gen.go @@ -1466,11 +1466,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](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. @@ -1594,9 +1594,10 @@ 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 + // 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. @@ -1606,10 +1607,9 @@ type VirtualMachine struct { // 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 + // (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. @@ -2128,7 +2128,7 @@ 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) +// 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)} @@ -2272,7 +2272,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: * +// 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)} @@ -2418,8 +2418,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: * +// 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)} @@ -2639,8 +2639,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: * +// required permissions. Authorization requires the following Google IAM +// (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)} diff --git a/localservices/v1/localservices-gen.go b/localservices/v1/localservices-gen.go index ddb656b879f..923671664e4 100644 --- a/localservices/v1/localservices-gen.go +++ b/localservices/v1/localservices-gen.go @@ -563,8 +563,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 (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/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/v1/managedidentities-gen.go b/managedidentities/v1/managedidentities-gen.go index f102d4b3f23..0a05ec27fff 100644 --- a/managedidentities/v1/managedidentities-gen.go +++ b/managedidentities/v1/managedidentities-gen.go @@ -228,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -460,7 +459,7 @@ 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 + // 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, @@ -1573,9 +1572,10 @@ 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 +// (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", @@ -1593,8 +1593,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 (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 @@ -1629,9 +1629,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1810,11 +1810,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](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. @@ -1857,8 +1857,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2208,7 +2208,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/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2374,7 +2374,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/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2546,7 +2546,7 @@ func (c *ProjectsLocationsGlobalDomainsAttachTrustCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsAttachTrustCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2700,7 +2700,7 @@ func (c *ProjectsLocationsGlobalDomainsCreateCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2843,7 +2843,7 @@ func (c *ProjectsLocationsGlobalDomainsDeleteCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2975,7 +2975,7 @@ func (c *ProjectsLocationsGlobalDomainsDetachTrustCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsDetachTrustCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3124,7 +3124,7 @@ func (c *ProjectsLocationsGlobalDomainsGetCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3240,9 +3240,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -3285,7 +3284,7 @@ func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3407,9 +3406,9 @@ 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 +// (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 @@ -3470,7 +3469,7 @@ func (c *ProjectsLocationsGlobalDomainsListCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3656,7 +3655,7 @@ func (c *ProjectsLocationsGlobalDomainsPatchCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3802,7 +3801,7 @@ func (c *ProjectsLocationsGlobalDomainsReconfigureTrustCall) Header() http.Heade func (c *ProjectsLocationsGlobalDomainsReconfigureTrustCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3942,7 +3941,7 @@ func (c *ProjectsLocationsGlobalDomainsResetAdminPasswordCall) Header() http.Hea func (c *ProjectsLocationsGlobalDomainsResetAdminPasswordCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4084,7 +4083,7 @@ func (c *ProjectsLocationsGlobalDomainsSetIamPolicyCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4229,7 +4228,7 @@ func (c *ProjectsLocationsGlobalDomainsTestIamPermissionsCall) Header() http.Hea func (c *ProjectsLocationsGlobalDomainsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4371,7 +4370,7 @@ func (c *ProjectsLocationsGlobalDomainsValidateTrustCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsValidateTrustCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4520,7 +4519,7 @@ func (c *ProjectsLocationsGlobalOperationsCancelCall) Header() http.Header { func (c *ProjectsLocationsGlobalOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4661,7 +4660,7 @@ func (c *ProjectsLocationsGlobalOperationsDeleteCall) Header() http.Header { func (c *ProjectsLocationsGlobalOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4804,7 +4803,7 @@ func (c *ProjectsLocationsGlobalOperationsGetCall) Header() http.Header { func (c *ProjectsLocationsGlobalOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4978,7 +4977,7 @@ func (c *ProjectsLocationsGlobalOperationsListCall) Header() http.Header { func (c *ProjectsLocationsGlobalOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/managedidentities/v1alpha1/managedidentities-gen.go b/managedidentities/v1alpha1/managedidentities-gen.go index dc844e5ee4e..36c7e31751f 100644 --- a/managedidentities/v1alpha1/managedidentities-gen.go +++ b/managedidentities/v1alpha1/managedidentities-gen.go @@ -239,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -464,7 +463,7 @@ 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 + // 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 @@ -1627,9 +1626,10 @@ 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 +// (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", @@ -1647,8 +1647,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 (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 @@ -1683,9 +1683,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1910,11 +1910,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](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. @@ -1957,8 +1957,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -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"` @@ -2306,7 +2308,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/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2472,7 +2474,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/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2644,7 +2646,7 @@ func (c *ProjectsLocationsGlobalDomainsAttachTrustCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsAttachTrustCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2798,7 +2800,7 @@ func (c *ProjectsLocationsGlobalDomainsCreateCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2941,7 +2943,7 @@ func (c *ProjectsLocationsGlobalDomainsDeleteCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3073,7 +3075,7 @@ func (c *ProjectsLocationsGlobalDomainsDetachTrustCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsDetachTrustCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3222,7 +3224,7 @@ func (c *ProjectsLocationsGlobalDomainsGetCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3338,9 +3340,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -3383,7 +3384,7 @@ func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3566,7 +3567,7 @@ func (c *ProjectsLocationsGlobalDomainsListCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3754,7 +3755,7 @@ func (c *ProjectsLocationsGlobalDomainsPatchCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -3900,7 +3901,7 @@ func (c *ProjectsLocationsGlobalDomainsReconfigureTrustCall) Header() http.Heade func (c *ProjectsLocationsGlobalDomainsReconfigureTrustCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4041,7 +4042,7 @@ func (c *ProjectsLocationsGlobalDomainsResetAdminPasswordCall) Header() http.Hea func (c *ProjectsLocationsGlobalDomainsResetAdminPasswordCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4183,7 +4184,7 @@ func (c *ProjectsLocationsGlobalDomainsSetIamPolicyCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4328,7 +4329,7 @@ func (c *ProjectsLocationsGlobalDomainsTestIamPermissionsCall) Header() http.Hea func (c *ProjectsLocationsGlobalDomainsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4468,7 +4469,7 @@ func (c *ProjectsLocationsGlobalDomainsValidateTrustCall) Header() http.Header { func (c *ProjectsLocationsGlobalDomainsValidateTrustCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4617,7 +4618,7 @@ func (c *ProjectsLocationsGlobalDomainsSqlIntegrationsGetCall) Header() http.Hea func (c *ProjectsLocationsGlobalDomainsSqlIntegrationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4795,7 +4796,7 @@ func (c *ProjectsLocationsGlobalDomainsSqlIntegrationsListCall) Header() http.He func (c *ProjectsLocationsGlobalDomainsSqlIntegrationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4981,7 +4982,7 @@ func (c *ProjectsLocationsGlobalOperationsCancelCall) Header() http.Header { func (c *ProjectsLocationsGlobalOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5122,7 +5123,7 @@ func (c *ProjectsLocationsGlobalOperationsDeleteCall) Header() http.Header { func (c *ProjectsLocationsGlobalOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5265,7 +5266,7 @@ func (c *ProjectsLocationsGlobalOperationsGetCall) Header() http.Header { func (c *ProjectsLocationsGlobalOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5439,7 +5440,7 @@ func (c *ProjectsLocationsGlobalOperationsListCall) Header() http.Header { func (c *ProjectsLocationsGlobalOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210109") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/managedidentities/v1beta1/managedidentities-gen.go b/managedidentities/v1beta1/managedidentities-gen.go index bbe2bbfd4aa..1781dc3bc9f 100644 --- a/managedidentities/v1beta1/managedidentities-gen.go +++ b/managedidentities/v1beta1/managedidentities-gen.go @@ -240,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -472,7 +471,7 @@ 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 + // 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, @@ -1617,9 +1616,10 @@ 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 +// (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,8 +1637,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 (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,9 +1673,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1909,11 +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](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. @@ -1956,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -3334,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -3501,9 +3500,9 @@ 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 +// (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 65aa8f06329..c1079e3fa7b 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 + // (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. @@ -1498,11 +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](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/ml/v1/ml-gen.go b/ml/v1/ml-gen.go index 11a8bbe5da2..4548ad5b512 100644 --- a/ml/v1/ml-gen.go +++ b/ml/v1/ml-gen.go @@ -871,9 +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](/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 +// (/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. @@ -962,29 +962,30 @@ 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 + // 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` + // 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), + // 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 + // 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 + // 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 @@ -1289,10 +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](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 +// (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. @@ -1322,77 +1322,72 @@ 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 +// (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`](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` + // (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-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`](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 - // 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-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). + // 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` + // (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 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 + // 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 @@ -1404,23 +1399,21 @@ 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 + // (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](/artifact-registry/docs/overview) and begin with the + // 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) + // 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` @@ -1429,28 +1422,26 @@ type GoogleCloudMlV1__ContainerSpec struct { // 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 + // (/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](/ai-platform/prediction/docs/custom-container-requirements#hea - // lth) to this port. If you do not specify this field, it defaults to + // 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). + // 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 @@ -1545,24 +1536,22 @@ 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 +// (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/stag - // ing/src/k8s.io/apimachinery/pkg/util/validation/validation.go#L258) + // 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_`. 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: + // string. 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 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 @@ -1625,8 +1614,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. (/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 @@ -2429,8 +2418,8 @@ 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 + // 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"` @@ -2438,10 +2427,10 @@ type GoogleCloudMlV1__Model struct { // 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 (/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 @@ -2650,7 +2639,7 @@ 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 + // request body details section (#request-body-details) for more // information on how to structure your request. HttpBody *GoogleApi__HttpBody `json:"httpBody,omitempty"` @@ -2747,12 +2736,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](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 + // (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) + // , which is "serving_default". SignatureName string `json:"signatureName,omitempty"` // Uri: Use this field if you want to specify a Google Cloud Storage @@ -2845,10 +2834,10 @@ 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. + // (/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 @@ -2878,24 +2867,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](/ai-platform/training/docs/distributed-training-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](/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 + // (/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](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 + // (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"` // ForceSendFields is a list of field names (e.g. "AcceleratorConfig") @@ -2926,11 +2914,11 @@ 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 +// 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 +// 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 { @@ -2938,7 +2926,7 @@ type GoogleCloudMlV1__RequestLoggingConfig struct { // 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 + // 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 @@ -2991,18 +2979,18 @@ 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 +// responds to these requests with appropriate responses. Read Custom +// 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](/ai-platform/prediction/docs/custom-container-requirements#che - // cks). For example, if you set this field to `/bar`, then AI Platform + // 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 @@ -3105,9 +3093,9 @@ 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: + // 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"` @@ -3120,20 +3108,20 @@ 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: + // 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"` @@ -3393,8 +3381,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 (/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 @@ -3405,22 +3393,21 @@ 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 + // (/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.](/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. + // (/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 @@ -3452,14 +3439,13 @@ 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. + // (/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 @@ -3471,30 +3457,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](/ml-engine/docs/machine-types#compute-engine-machine-types). + // 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). + // `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](/vpc/docs/vpc) 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.](/ai-platform/training/docs/vpc-peering). + // unspecified, the Job is not peered with any network. Learn about + // using VPC Network Peering. (/ai-platform/training/docs/vpc-peering). Network string `json:"network,omitempty"` // PackageUris: Required. The Google Cloud Storage location of the @@ -3505,16 +3491,15 @@ 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 + // set to a Compute Engine machine type. Learn about restrictions on + // 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 - // ). + // 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 @@ -3546,21 +3531,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](/ml-engine/docs/runtime-version-list). + // 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](/ai-platform/training/docs/regions) for AI + // 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](/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 (/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 @@ -3604,31 +3589,30 @@ 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 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. 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. + // (/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.](/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. + // (/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 @@ -3644,11 +3628,11 @@ 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 + // (/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 @@ -3690,9 +3674,9 @@ 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` + // (#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. @@ -3831,8 +3815,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](/ml-engine/docs/machine-types-online-prediction#gpus). + // 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 @@ -3840,8 +3824,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](#Version.FIELDS.accelerator_config). 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 @@ -3857,19 +3841,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](/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 + // (/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) + // . DeploymentUri string `json:"deploymentUri,omitempty"` // Description: Optional. The description specified for the version when @@ -3901,10 +3885,10 @@ 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 + // (/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 @@ -3938,8 +3922,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](/ml-engine/docs/machine-types-online-prediction). + // 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 @@ -3956,49 +3940,48 @@ 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, - // 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. + // 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](#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 (#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). PredictionClass string `json:"predictionClass,omitempty"` // PythonVersion: Required. The version of Python used in prediction. @@ -4007,8 +3990,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](/ml-engine/docs/runtime-version-list). + // available for each runtime version + // (/ml-engine/docs/runtime-version-list). PythonVersion string `json:"pythonVersion,omitempty"` // RequestLoggingConfig: Optional. *Only* specify this field in a @@ -4028,16 +4011,16 @@ 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 + // (/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](/ai-platform/prediction/docs/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. @@ -4226,9 +4209,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -4303,9 +4285,10 @@ 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 +// (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", @@ -4323,8 +4306,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 (https://cloud.google.com/iam/docs/). type GoogleIamV1__Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -4363,9 +4346,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4438,8 +4421,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -4612,11 +4595,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](https://github.com/grpc). Each `Status` message contains three -// pieces of data: error code, error message, and error details. You can -// find 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 (https://github.com/grpc). +// Each `Status` message contains three pieces of data: error code, +// error message, and error details. You can find 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. @@ -5602,9 +5585,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -9469,9 +9451,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -10940,8 +10921,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 (/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/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 a68fe93759a..db0ebb762f8 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 ((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 @@ -2267,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 @@ -3055,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 @@ -3071,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 @@ -3421,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 @@ -3486,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/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index d8fc961fbdb..5305de84e7d 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -361,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -664,8 +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](/load-balancing/docs/load-balancing-overview). + // destination is a global load balancer VIP + // (/load-balancing/docs/load-balancing-overview). IpAddress string `json:"ipAddress,omitempty"` // Network: A Compute Engine network URI. @@ -1457,9 +1456,10 @@ 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 +// (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", @@ -1477,8 +1477,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1517,9 +1517,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1737,11 +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](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. @@ -1908,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2933,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 fe971ad6c3c..c0176a4a6c9 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -361,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -724,13 +723,12 @@ 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 (https://cloud.google.com/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 + // (https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture). GkeMasterCluster string `json:"gkeMasterCluster,omitempty"` // Instance: A Compute Engine instance URI. @@ -738,9 +736,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](https://cloud.google.com/load-balancing/docs/load-balancing-overv - // iew). + // 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. @@ -1637,9 +1634,10 @@ 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 +// (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", @@ -1657,8 +1655,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -1697,9 +1695,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1991,11 +1989,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](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. @@ -2174,8 +2172,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -3199,9 +3197,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 9f1c54477a3..564d43097d3 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 (/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,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -607,9 +606,9 @@ 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 + // (/compute/docs/gpus/#gpus-list). AcceleratorConfig *AcceleratorConfig `json:"acceleratorConfig,omitempty"` // BootDiskSizeGb: Input only. The size of the boot disk in GB attached @@ -683,16 +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](/kms/docs/quickstart). + // 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](/compute/docs/machine-types) 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. @@ -729,10 +728,10 @@ 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 + // (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. @@ -1164,9 +1163,10 @@ 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 +// (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", @@ -1184,8 +1184,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 (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 @@ -1220,9 +1220,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1357,10 +1357,10 @@ 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 + // (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. @@ -1438,8 +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](https://cloud.google.com/compute/docs/machine-types). + // 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 @@ -1471,11 +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](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. @@ -1522,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -3129,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 5d32c640cba..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 @@ -1018,7 +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 +// Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text // format. type OneTimeSchedule struct { // ExecuteTime: Required. The desired patch job execution time. @@ -1116,12 +1116,11 @@ 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 +// (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 + // Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text // format. CreateTime string `json:"createTime,omitempty"` @@ -1137,8 +1136,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](https://www.ietf.org/rfc/rfc3339.txt) 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 @@ -1160,7 +1159,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 + // Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text // format. UpdateTime string `json:"updateTime,omitempty"` @@ -1245,11 +1244,11 @@ 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", +// 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 { @@ -1284,9 +1283,8 @@ 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 +// (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"` @@ -1395,10 +1393,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](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 +// (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. @@ -1723,8 +1720,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](https://www.iana.org/time-zones). +// 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 afdb386bb58..cf48523e35a 100644 --- a/osconfig/v1beta/osconfig-gen.go +++ b/osconfig/v1beta/osconfig-gen.go @@ -856,10 +856,10 @@ 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 + // (/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. @@ -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 @@ -1564,7 +1564,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 +// Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text // format. type OneTimeSchedule struct { // ExecuteTime: Required. The desired patch job execution time. @@ -1774,12 +1774,11 @@ 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 +// (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 + // Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text // format. CreateTime string `json:"createTime,omitempty"` @@ -1795,8 +1794,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](https://www.ietf.org/rfc/rfc3339.txt) 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 @@ -1818,7 +1817,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 + // Timestamp is in RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) text // format. UpdateTime string `json:"updateTime,omitempty"` @@ -1938,9 +1937,8 @@ 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 +// (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"` @@ -2049,10 +2047,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](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 +// (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. @@ -2829,8 +2826,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](https://en.wikipedia.org/wiki/Shebang_\(Unix\)). + // likely only succeed for scripts with shebang lines + // (https://en.wikipedia.org/wiki/Shebang_\(Unix\)). // // Possible values: // "INTERPRETER_UNSPECIFIED" - Default value for ScriptType. @@ -2910,8 +2907,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](https://www.iana.org/time-zones). +// 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 4e22f22eae1..2429fbcecef 100644 --- a/people/v1/people-gen.go +++ b/people/v1/people-gen.go @@ -251,9 +251,9 @@ 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 + // (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, @@ -568,7 +568,7 @@ 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) + // 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"` @@ -593,8 +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](/people/api/rest/v1/contactgroups/members/ - // modify). + // ModifyContactGroupMembers + // (/people/api/rest/v1/contactgroups/members/modify). MemberResourceNames []string `json:"memberResourceNames,omitempty"` // Metadata: Output only. Metadata about the contact group. @@ -678,9 +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`](/people/api/rest/v1/contactgroups/list) - // 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. @@ -1524,8 +1524,8 @@ 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 + // (https://tools.ietf.org/html/bcp47) language tag representing the // locale. Value string `json:"value,omitempty"` @@ -2048,7 +2048,7 @@ 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) + // 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"` @@ -2171,9 +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`](/people/api/rest/v1/people.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 @@ -2192,11 +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`](/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` + // (/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. @@ -2271,9 +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](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 + // (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 @@ -2617,9 +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](https://tools.ietf.org/html/rfc3261#section-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 @@ -2678,8 +2677,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. + // 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 string `json:"etag,omitempty"` @@ -2741,11 +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](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. @@ -3621,7 +3620,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 +// 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) @@ -5218,9 +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`](/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` +// (/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 e08e569090e..2169bc675f9 100644 --- a/playablelocations/v3/playablelocations-gen.go +++ b/playablelocations/v3/playablelocations-gen.go @@ -346,11 +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++](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++ + // (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 @@ -428,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](/maps/documentation/gaming/tt/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 @@ -485,10 +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](/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: 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 a48e4e6bfcc..b2fa80d120b 100644 --- a/policytroubleshooter/v1/policytroubleshooter-gen.go +++ b/policytroubleshooter/v1/policytroubleshooter-gen.go @@ -626,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -703,9 +702,10 @@ 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 +// (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", @@ -723,8 +723,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 (https://cloud.google.com/iam/docs/). type GoogleIamV1Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -763,9 +763,9 @@ 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 + // (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 b8f95c7348e..d3af67e1ff0 100644 --- a/policytroubleshooter/v1beta/policytroubleshooter-gen.go +++ b/policytroubleshooter/v1beta/policytroubleshooter-gen.go @@ -626,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -703,9 +702,10 @@ 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 +// (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", @@ -723,8 +723,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 (https://cloud.google.com/iam/docs/). type GoogleIamV1Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -763,9 +763,9 @@ 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 + // (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 bac45e1c517..e47354a47c3 100644 --- a/poly/v1/poly-gen.go +++ b/poly/v1/poly-gen.go @@ -170,13 +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](//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 +// (//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](/poly/discover/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 @@ -349,9 +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](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/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 @@ -385,9 +385,9 @@ 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) +// 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. @@ -788,9 +788,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 (//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 6f119b15be7..33193cf5f83 100644 --- a/privateca/v1beta1/privateca-gen.go +++ b/privateca/v1beta1/privateca-gen.go @@ -503,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -2037,9 +2036,10 @@ 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 +// (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", @@ -2057,8 +2057,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2097,9 +2097,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2134,9 +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](https://tools.ietf.org/html/rfc5280#section-4.1 - // ) 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 @@ -2608,11 +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](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. @@ -2904,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -4271,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -5544,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -6708,9 +6706,8 @@ 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 +// (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 @@ -6718,9 +6715,8 @@ 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 +// (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 @@ -8037,9 +8033,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 bfb408052ae..ce1eca4f9cd 100644 --- a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go +++ b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go @@ -1533,11 +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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 fea0b6fcabe..85194597437 100644 --- a/pubsub/v1/pubsub-gen.go +++ b/pubsub/v1/pubsub-gen.go @@ -252,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -817,10 +816,9 @@ 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 +// (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 @@ -831,9 +829,9 @@ 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 + // (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"` @@ -872,9 +870,10 @@ 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 +// (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", @@ -892,8 +891,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 (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 @@ -928,9 +927,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1026,9 +1025,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] +// 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 { @@ -1383,11 +1382,11 @@ 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 +// (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. 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,11 +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](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: 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. @@ -1576,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -1805,12 +1804,12 @@ 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 +// 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. @@ -2265,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -2417,7 +2415,7 @@ type ProjectsSnapshotsListCall struct { header_ http.Header } -// List: Lists the existing snapshots. Snapshots are used in [Seek]( +// 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 @@ -3776,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -5574,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -6493,7 +6489,7 @@ 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) +// 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. diff --git a/pubsub/v1beta2/pubsub-gen.go b/pubsub/v1beta2/pubsub-gen.go index d6a27f6c960..87b51e3bc0b 100644 --- a/pubsub/v1beta2/pubsub-gen.go +++ b/pubsub/v1beta2/pubsub-gen.go @@ -228,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -551,10 +550,9 @@ 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 +// (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 @@ -565,9 +563,9 @@ 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 + // (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"` @@ -606,9 +604,10 @@ 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 +// (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", @@ -626,8 +625,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 (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 @@ -662,9 +661,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -764,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](https://tools.ietf.org/html/rfc4648). + // 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 @@ -1061,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -1759,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -3267,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 0895c2e15f2..494f85c9d13 100644 --- a/realtimebidding/v1/realtimebidding-gen.go +++ b/realtimebidding/v1/realtimebidding-gen.go @@ -496,11 +496,12 @@ 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 + // (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 @@ -695,11 +696,12 @@ 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 + // (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 @@ -772,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 @@ -794,12 +796,12 @@ 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 + // (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 @@ -1174,8 +1176,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]( https://support.google.com/google-ads/answer/2476688). + // 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 @@ -1812,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 @@ -1935,15 +1937,14 @@ 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 + // (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/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 63e1c931307..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"` @@ -547,8 +548,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](/recommendations-ai/docs/catalog#item-group-id). + // 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 @@ -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 @@ -895,9 +896,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](/recommendations-ai/docs/upload-catalog) 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 @@ -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"` @@ -2531,11 +2533,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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. @@ -4222,9 +4224,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](https://cloud.google.com/recommendations-ai/docs/setting-up#regi -// ster-key). +// PredictionApiKeyRegistry service. Learn more +// (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/redis/v1/redis-gen.go b/redis/v1/redis-gen.go index b81c0f2e5f1..2293f423532 100644 --- a/redis/v1/redis-gen.go +++ b/redis/v1/redis-gen.go @@ -479,7 +479,7 @@ 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 + // 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"` @@ -948,11 +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](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. @@ -996,12 +996,12 @@ 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 + // 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](https://tools.ietf.org/html/rfc3339) format, for example + // 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 string `json:"expireTime,omitempty"` @@ -1423,7 +1423,7 @@ 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). +// 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 diff --git a/redis/v1beta1/redis-gen.go b/redis/v1beta1/redis-gen.go index 55d78e6198f..1740fa55d9d 100644 --- a/redis/v1beta1/redis-gen.go +++ b/redis/v1beta1/redis-gen.go @@ -484,7 +484,7 @@ 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 + // 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"` @@ -953,11 +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](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. @@ -1001,12 +1001,12 @@ 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 + // 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](https://tools.ietf.org/html/rfc3339) format, for example + // 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 string `json:"expireTime,omitempty"` @@ -1428,7 +1428,7 @@ 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). +// 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 diff --git a/remotebuildexecution/v1/remotebuildexecution-gen.go b/remotebuildexecution/v1/remotebuildexecution-gen.go index 72ce19448f4..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. @@ -2384,8 +2390,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). + // 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 string `json:"diskType,omitempty"` @@ -2408,8 +2414,8 @@ 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 + // (https://cloud.google.com/compute/docs/cpu-platforms). MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NetworkAccess: Determines the type of network access granted to @@ -2422,7 +2428,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 + // Preemptible VMs (https://cloud.google.com/preemptible-vms/) for more // details. Reserved bool `json:"reserved,omitempty"` @@ -3248,11 +3254,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 76db9d80f4c..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. @@ -2364,8 +2370,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). + // 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 string `json:"diskType,omitempty"` @@ -2388,8 +2394,8 @@ 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 + // (https://cloud.google.com/compute/docs/cpu-platforms). MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NetworkAccess: Determines the type of network access granted to @@ -2402,7 +2408,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 + // Preemptible VMs (https://cloud.google.com/preemptible-vms/) for more // details. Reserved bool `json:"reserved,omitempty"` @@ -3178,11 +3184,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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. @@ -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 c1be2073d40..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. @@ -3126,8 +3132,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). + // 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 string `json:"diskType,omitempty"` @@ -3150,8 +3156,8 @@ 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 + // (https://cloud.google.com/compute/docs/cpu-platforms). MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // NetworkAccess: Determines the type of network access granted to @@ -3164,7 +3170,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 + // Preemptible VMs (https://cloud.google.com/preemptible-vms/) for more // details. Reserved bool `json:"reserved,omitempty"` @@ -3936,11 +3942,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index 7a872d3d8b9..4819c7997ef 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -549,8 +549,8 @@ type GoogleCloudRetailV2BigQuerySource struct { // DataSchema: The schema to use when parsing the data from the source. // Supported values for product imports: * `product` (default): One JSON // Product per line. Each product must have a valid Product.id. * - // `product_merchant_center`: See [Importing catalog data from Merchant - // Center](/retail/recommendations-ai/docs/upload-catalog#mc). Supported + // `product_merchant_center`: See Importing catalog data from Merchant + // Center (/retail/recommendations-ai/docs/upload-catalog#mc). Supported // values for user events imports: * `user_event` (default): One JSON // UserEvent per line. * `user_event_ga360`: Using // https://support.google.com/analytics/answer/3437719?hl=en. @@ -686,8 +686,8 @@ type GoogleCloudRetailV2GcsSource struct { // DataSchema: The schema to use when parsing the data from the source. // Supported values for product imports: * `product` (default): One JSON // Product per line. Each product must have a valid Product.id. * - // `product_merchant_center`: See [Importing catalog data from Merchant - // Center](/retail/recommendations-ai/docs/upload-catalog#mc). Supported + // `product_merchant_center`: See Importing catalog data from Merchant + // Center (/retail/recommendations-ai/docs/upload-catalog#mc). Supported // values for user events imports: * `user_event` (default): One JSON // UserEvent per line. * `user_event_ga360`: Using // https://support.google.com/analytics/answer/3437719?hl=en. @@ -698,9 +698,9 @@ type GoogleCloudRetailV2GcsSource 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 product - // information](/recommendations-ai/docs/upload-catalog) for the - // expected file format and setup instructions. + // GB. See Importing product information + // (/recommendations-ai/docs/upload-catalog) for the expected file + // format and setup instructions. InputUris []string `json:"inputUris,omitempty"` // ForceSendFields is a list of field names (e.g. "DataSchema") to @@ -735,8 +735,8 @@ type GoogleCloudRetailV2Image struct { // Uri: Required. URI of the image. This field must be a valid UTF-8 // encoded URI with a length limit of 5,000 characters. Otherwise, an // INVALID_ARGUMENT error is returned. Google Merchant Center property - // [image_link](https://support.google.com/merchants/answer/6324350). - // Schema.org property [Product.image](https://schema.org/image). + // image_link (https://support.google.com/merchants/answer/6324350). + // Schema.org property Product.image (https://schema.org/image). Uri string `json:"uri,omitempty"` // Width: Width of the image in number of pixels. This field must be @@ -1199,25 +1199,24 @@ func (s *GoogleCloudRetailV2PredictResponsePredictionResult) MarshalJSON() ([]by type GoogleCloudRetailV2PriceInfo struct { // Cost: The costs associated with the sale of a particular product. // Used for gross profit reporting. * Profit = price - cost Google - // Merchant Center property - // [cost_of_goods_sold](https://support.google.com/merchants/answer/90178 - // 95). + // Merchant Center property cost_of_goods_sold + // (https://support.google.com/merchants/answer/9017895). Cost float64 `json:"cost,omitempty"` - // CurrencyCode: The 3-letter currency code defined in [ISO - // 4217](https://www.iso.org/iso-4217-currency-codes.html). If this - // field is an unrecognizable currency code, an INVALID_ARGUMENT error - // is returned. + // CurrencyCode: The 3-letter currency code defined in ISO 4217 + // (https://www.iso.org/iso-4217-currency-codes.html). If this field is + // an unrecognizable currency code, an INVALID_ARGUMENT error is + // returned. CurrencyCode string `json:"currencyCode,omitempty"` // OriginalPrice: Price of the product without any discount. If zero, by // default set to be the price. OriginalPrice float64 `json:"originalPrice,omitempty"` - // Price: Price of the product. Google Merchant Center property - // [price](https://support.google.com/merchants/answer/6324371). - // Schema.org property - // [Offer.priceSpecification](https://schema.org/priceSpecification). + // Price: Price of the product. Google Merchant Center property price + // (https://support.google.com/merchants/answer/6324371). Schema.org + // property Offer.priceSpecification + // (https://schema.org/priceSpecification). Price float64 `json:"price,omitempty"` // ForceSendFields is a list of field names (e.g. "Cost") to @@ -1282,10 +1281,9 @@ type GoogleCloudRetailV2Product struct { Attributes map[string]GoogleCloudRetailV2CustomAttribute `json:"attributes,omitempty"` // Availability: The online availability of the Product. Default to - // Availability.IN_STOCK. Google Merchant Center Property - // [availability](https://support.google.com/merchants/answer/6324448). - // Schema.org Property - // [Offer.availability](https://schema.org/availability). + // Availability.IN_STOCK. Google Merchant Center Property availability + // (https://support.google.com/merchants/answer/6324448). Schema.org + // Property Offer.availability (https://schema.org/availability). // // Possible values: // "AVAILABILITY_UNSPECIFIED" - Default product availability. Default @@ -1327,9 +1325,9 @@ type GoogleCloudRetailV2Product struct { // Description: Product description. This field must be a UTF-8 encoded // string with a length limit of 5,000 characters. Otherwise, an // INVALID_ARGUMENT error is returned. Google Merchant Center property - // [description](https://support.google.com/merchants/answer/6324468). - // schema.org property - // [Product.description](https://schema.org/description). + // description (https://support.google.com/merchants/answer/6324468). + // schema.org property Product.description + // (https://schema.org/description). Description string `json:"description,omitempty"` // Id: Immutable. Product identifier, which is the final component of @@ -1337,15 +1335,15 @@ type GoogleCloudRetailV2Product struct { // `projects/*/locations/global/catalogs/default_catalog/branches/default // _branch/products/id_1`. This field must be a UTF-8 encoded string // with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT - // error is returned. Google Merchant Center property - // [id](https://support.google.com/merchants/answer/6324405). Schema.org - // Property [Product.sku](https://schema.org/sku). + // error is returned. Google Merchant Center property id + // (https://support.google.com/merchants/answer/6324405). Schema.org + // Property Product.sku (https://schema.org/sku). Id string `json:"id,omitempty"` // Images: Product images for the product. A maximum of 300 images are - // allowed. Google Merchant Center property - // [image_link](https://support.google.com/merchants/answer/6324350). - // Schema.org property [Product.image](https://schema.org/image). + // allowed. Google Merchant Center property image_link + // (https://support.google.com/merchants/answer/6324350). Schema.org + // property Product.image (https://schema.org/image). Images []*GoogleCloudRetailV2Image `json:"images,omitempty"` // Name: Immutable. Full resource name of the product, such as @@ -1354,8 +1352,7 @@ type GoogleCloudRetailV2Product struct { Name string `json:"name,omitempty"` // PriceInfo: Product price and cost information. Google Merchant Center - // property - // [price](https://support.google.com/merchants/answer/6324371). + // property price (https://support.google.com/merchants/answer/6324371). PriceInfo *GoogleCloudRetailV2PriceInfo `json:"priceInfo,omitempty"` // PrimaryProductId: Variant group identifier. Must be an id, with the @@ -1364,12 +1361,12 @@ type GoogleCloudRetailV2Product struct { // same value as id. For VARIANT Products, this field cannot be empty. A // maximum of 2,000 products are allowed to share the same Type.PRIMARY // Product. Otherwise, an INVALID_ARGUMENT error is returned. Google - // Merchant Center Property - // [item_group_id](https://support.google.com/merchants/answer/6324507). - // Schema.org Property - // [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID - // ). This field must be enabled before it can be used. [Learn - // more](/recommendations-ai/docs/catalog#item-group-id). + // Merchant Center Property item_group_id + // (https://support.google.com/merchants/answer/6324507). Schema.org + // Property Product.inProductGroupWithID + // (https://schema.org/inProductGroupWithID). This field must be enabled + // before it can be used. Learn more + // (/recommendations-ai/docs/catalog#item-group-id). PrimaryProductId string `json:"primaryProductId,omitempty"` // Tags: Custom tags associated with the product. At most 250 values are @@ -1377,16 +1374,15 @@ type GoogleCloudRetailV2Product struct { // length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT // error is returned. This tag can be used for filtering recommendation // results by passing the tag as part of the PredictRequest.filter. - // Google Merchant Center property - // [custom_label_0–4](https://support.google.com/merchants/answer/63244 - // 73). + // Google Merchant Center property custom_label_0–4 + // (https://support.google.com/merchants/answer/6324473). Tags []string `json:"tags,omitempty"` // Title: Required. Product title. This field must be a UTF-8 encoded // string with a length limit of 128 characters. Otherwise, an // INVALID_ARGUMENT error is returned. Google Merchant Center property - // [title](https://support.google.com/merchants/answer/6324415). - // Schema.org property [Product.name](https://schema.org/name). + // title (https://support.google.com/merchants/answer/6324415). + // Schema.org property Product.name (https://schema.org/name). Title string `json:"title,omitempty"` // Type: Immutable. The type of the product. This field is output-only. @@ -1409,9 +1405,9 @@ type GoogleCloudRetailV2Product struct { // Uri: Canonical URL directly linking to the product detail page. This // field must be a UTF-8 encoded string with a length limit of 5,000 // characters. Otherwise, an INVALID_ARGUMENT error is returned. Google - // Merchant Center property - // [link](https://support.google.com/merchants/answer/6324416). - // Schema.org property [Offer.url](https://schema.org/url). + // Merchant Center property link + // (https://support.google.com/merchants/answer/6324416). Schema.org + // property Offer.url (https://schema.org/url). Uri string `json:"uri,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1558,23 +1554,23 @@ type GoogleCloudRetailV2ProductLevelConfig struct { // this field is set to an invalid value other than these, an // INVALID_ARGUMENT error is returned. If this field is `variant` and // merchant_center_product_id_field is `itemGroupId`, an - // INVALID_ARGUMENT error is returned. See [Using catalog - // levels](/retail/recommendations-ai/docs/catalog#catalog-levels) for - // more details. + // INVALID_ARGUMENT error is returned. See Using catalog levels + // (/retail/recommendations-ai/docs/catalog#catalog-levels) for more + // details. IngestionProductType string `json:"ingestionProductType,omitempty"` - // MerchantCenterProductIdField: Which field of [Merchant Center - // Product](/bigquery-transfer/docs/merchant-center-products-schema) - // should be imported as Product.id. Acceptable values are: * `offerId` - // (default): Import `offerId` as the product ID. * `itemGroupId`: - // Import `itemGroupId` as the product ID. Notice that Retail API will - // choose one item from the ones with the same `itemGroupId`, and use it - // to represent the item group. If this field is set to an invalid value + // MerchantCenterProductIdField: Which field of Merchant Center Product + // (/bigquery-transfer/docs/merchant-center-products-schema) should be + // imported as Product.id. Acceptable values are: * `offerId` (default): + // Import `offerId` as the product ID. * `itemGroupId`: Import + // `itemGroupId` as the product ID. Notice that Retail API will choose + // one item from the ones with the same `itemGroupId`, and use it to + // represent the item group. If this field is set to an invalid value // other than these, an INVALID_ARGUMENT error is returned. If this // field is `itemGroupId` and ingestion_product_type is `variant`, an - // INVALID_ARGUMENT error is returned. See [Using catalog - // levels](/retail/recommendations-ai/docs/catalog#catalog-levels) for - // more details. + // INVALID_ARGUMENT error is returned. See Using catalog levels + // (/retail/recommendations-ai/docs/catalog#catalog-levels) for more + // details. MerchantCenterProductIdField string `json:"merchantCenterProductIdField,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -3458,11 +3454,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index ad2a479e5f0..829cb8ada0e 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -812,8 +812,8 @@ type GoogleCloudRetailV2alphaBigQuerySource struct { // DataSchema: The schema to use when parsing the data from the source. // Supported values for product imports: * `product` (default): One JSON // Product per line. Each product must have a valid Product.id. * - // `product_merchant_center`: See [Importing catalog data from Merchant - // Center](/retail/recommendations-ai/docs/upload-catalog#mc). Supported + // `product_merchant_center`: See Importing catalog data from Merchant + // Center (/retail/recommendations-ai/docs/upload-catalog#mc). Supported // values for user events imports: * `user_event` (default): One JSON // UserEvent per line. * `user_event_ga360`: Using // https://support.google.com/analytics/answer/3437719?hl=en. @@ -1089,8 +1089,8 @@ type GoogleCloudRetailV2alphaGcsSource struct { // DataSchema: The schema to use when parsing the data from the source. // Supported values for product imports: * `product` (default): One JSON // Product per line. Each product must have a valid Product.id. * - // `product_merchant_center`: See [Importing catalog data from Merchant - // Center](/retail/recommendations-ai/docs/upload-catalog#mc). Supported + // `product_merchant_center`: See Importing catalog data from Merchant + // Center (/retail/recommendations-ai/docs/upload-catalog#mc). Supported // values for user events imports: * `user_event` (default): One JSON // UserEvent per line. * `user_event_ga360`: Using // https://support.google.com/analytics/answer/3437719?hl=en. @@ -1101,9 +1101,9 @@ type GoogleCloudRetailV2alphaGcsSource 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 product - // information](/recommendations-ai/docs/upload-catalog) for the - // expected file format and setup instructions. + // GB. See Importing product information + // (/recommendations-ai/docs/upload-catalog) for the expected file + // format and setup instructions. InputUris []string `json:"inputUris,omitempty"` // ForceSendFields is a list of field names (e.g. "DataSchema") to @@ -1138,8 +1138,8 @@ type GoogleCloudRetailV2alphaImage struct { // Uri: Required. URI of the image. This field must be a valid UTF-8 // encoded URI with a length limit of 5,000 characters. Otherwise, an // INVALID_ARGUMENT error is returned. Google Merchant Center property - // [image_link](https://support.google.com/merchants/answer/6324350). - // Schema.org property [Product.image](https://schema.org/image). + // image_link (https://support.google.com/merchants/answer/6324350). + // Schema.org property Product.image (https://schema.org/image). Uri string `json:"uri,omitempty"` // Width: Width of the image in number of pixels. This field must be @@ -1603,25 +1603,24 @@ func (s *GoogleCloudRetailV2alphaPredictResponsePredictionResult) MarshalJSON() type GoogleCloudRetailV2alphaPriceInfo struct { // Cost: The costs associated with the sale of a particular product. // Used for gross profit reporting. * Profit = price - cost Google - // Merchant Center property - // [cost_of_goods_sold](https://support.google.com/merchants/answer/90178 - // 95). + // Merchant Center property cost_of_goods_sold + // (https://support.google.com/merchants/answer/9017895). Cost float64 `json:"cost,omitempty"` - // CurrencyCode: The 3-letter currency code defined in [ISO - // 4217](https://www.iso.org/iso-4217-currency-codes.html). If this - // field is an unrecognizable currency code, an INVALID_ARGUMENT error - // is returned. + // CurrencyCode: The 3-letter currency code defined in ISO 4217 + // (https://www.iso.org/iso-4217-currency-codes.html). If this field is + // an unrecognizable currency code, an INVALID_ARGUMENT error is + // returned. CurrencyCode string `json:"currencyCode,omitempty"` // OriginalPrice: Price of the product without any discount. If zero, by // default set to be the price. OriginalPrice float64 `json:"originalPrice,omitempty"` - // Price: Price of the product. Google Merchant Center property - // [price](https://support.google.com/merchants/answer/6324371). - // Schema.org property - // [Offer.priceSpecification](https://schema.org/priceSpecification). + // Price: Price of the product. Google Merchant Center property price + // (https://support.google.com/merchants/answer/6324371). Schema.org + // property Offer.priceSpecification + // (https://schema.org/priceSpecification). Price float64 `json:"price,omitempty"` // ForceSendFields is a list of field names (e.g. "Cost") to @@ -1686,10 +1685,9 @@ type GoogleCloudRetailV2alphaProduct struct { Attributes map[string]GoogleCloudRetailV2alphaCustomAttribute `json:"attributes,omitempty"` // Availability: The online availability of the Product. Default to - // Availability.IN_STOCK. Google Merchant Center Property - // [availability](https://support.google.com/merchants/answer/6324448). - // Schema.org Property - // [Offer.availability](https://schema.org/availability). + // Availability.IN_STOCK. Google Merchant Center Property availability + // (https://support.google.com/merchants/answer/6324448). Schema.org + // Property Offer.availability (https://schema.org/availability). // // Possible values: // "AVAILABILITY_UNSPECIFIED" - Default product availability. Default @@ -1731,9 +1729,9 @@ type GoogleCloudRetailV2alphaProduct struct { // Description: Product description. This field must be a UTF-8 encoded // string with a length limit of 5,000 characters. Otherwise, an // INVALID_ARGUMENT error is returned. Google Merchant Center property - // [description](https://support.google.com/merchants/answer/6324468). - // schema.org property - // [Product.description](https://schema.org/description). + // description (https://support.google.com/merchants/answer/6324468). + // schema.org property Product.description + // (https://schema.org/description). Description string `json:"description,omitempty"` // Id: Immutable. Product identifier, which is the final component of @@ -1741,15 +1739,15 @@ type GoogleCloudRetailV2alphaProduct struct { // `projects/*/locations/global/catalogs/default_catalog/branches/default // _branch/products/id_1`. This field must be a UTF-8 encoded string // with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT - // error is returned. Google Merchant Center property - // [id](https://support.google.com/merchants/answer/6324405). Schema.org - // Property [Product.sku](https://schema.org/sku). + // error is returned. Google Merchant Center property id + // (https://support.google.com/merchants/answer/6324405). Schema.org + // Property Product.sku (https://schema.org/sku). Id string `json:"id,omitempty"` // Images: Product images for the product. A maximum of 300 images are - // allowed. Google Merchant Center property - // [image_link](https://support.google.com/merchants/answer/6324350). - // Schema.org property [Product.image](https://schema.org/image). + // allowed. Google Merchant Center property image_link + // (https://support.google.com/merchants/answer/6324350). Schema.org + // property Product.image (https://schema.org/image). Images []*GoogleCloudRetailV2alphaImage `json:"images,omitempty"` // Name: Immutable. Full resource name of the product, such as @@ -1758,8 +1756,7 @@ type GoogleCloudRetailV2alphaProduct struct { Name string `json:"name,omitempty"` // PriceInfo: Product price and cost information. Google Merchant Center - // property - // [price](https://support.google.com/merchants/answer/6324371). + // property price (https://support.google.com/merchants/answer/6324371). PriceInfo *GoogleCloudRetailV2alphaPriceInfo `json:"priceInfo,omitempty"` // PrimaryProductId: Variant group identifier. Must be an id, with the @@ -1768,12 +1765,12 @@ type GoogleCloudRetailV2alphaProduct struct { // same value as id. For VARIANT Products, this field cannot be empty. A // maximum of 2,000 products are allowed to share the same Type.PRIMARY // Product. Otherwise, an INVALID_ARGUMENT error is returned. Google - // Merchant Center Property - // [item_group_id](https://support.google.com/merchants/answer/6324507). - // Schema.org Property - // [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID - // ). This field must be enabled before it can be used. [Learn - // more](/recommendations-ai/docs/catalog#item-group-id). + // Merchant Center Property item_group_id + // (https://support.google.com/merchants/answer/6324507). Schema.org + // Property Product.inProductGroupWithID + // (https://schema.org/inProductGroupWithID). This field must be enabled + // before it can be used. Learn more + // (/recommendations-ai/docs/catalog#item-group-id). PrimaryProductId string `json:"primaryProductId,omitempty"` // Tags: Custom tags associated with the product. At most 250 values are @@ -1781,16 +1778,15 @@ type GoogleCloudRetailV2alphaProduct struct { // length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT // error is returned. This tag can be used for filtering recommendation // results by passing the tag as part of the PredictRequest.filter. - // Google Merchant Center property - // [custom_label_0–4](https://support.google.com/merchants/answer/63244 - // 73). + // Google Merchant Center property custom_label_0–4 + // (https://support.google.com/merchants/answer/6324473). Tags []string `json:"tags,omitempty"` // Title: Required. Product title. This field must be a UTF-8 encoded // string with a length limit of 128 characters. Otherwise, an // INVALID_ARGUMENT error is returned. Google Merchant Center property - // [title](https://support.google.com/merchants/answer/6324415). - // Schema.org property [Product.name](https://schema.org/name). + // title (https://support.google.com/merchants/answer/6324415). + // Schema.org property Product.name (https://schema.org/name). Title string `json:"title,omitempty"` // Type: Immutable. The type of the product. This field is output-only. @@ -1813,9 +1809,9 @@ type GoogleCloudRetailV2alphaProduct struct { // Uri: Canonical URL directly linking to the product detail page. This // field must be a UTF-8 encoded string with a length limit of 5,000 // characters. Otherwise, an INVALID_ARGUMENT error is returned. Google - // Merchant Center property - // [link](https://support.google.com/merchants/answer/6324416). - // Schema.org property [Offer.url](https://schema.org/url). + // Merchant Center property link + // (https://support.google.com/merchants/answer/6324416). Schema.org + // property Offer.url (https://schema.org/url). Uri string `json:"uri,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1962,23 +1958,23 @@ type GoogleCloudRetailV2alphaProductLevelConfig struct { // this field is set to an invalid value other than these, an // INVALID_ARGUMENT error is returned. If this field is `variant` and // merchant_center_product_id_field is `itemGroupId`, an - // INVALID_ARGUMENT error is returned. See [Using catalog - // levels](/retail/recommendations-ai/docs/catalog#catalog-levels) for - // more details. + // INVALID_ARGUMENT error is returned. See Using catalog levels + // (/retail/recommendations-ai/docs/catalog#catalog-levels) for more + // details. IngestionProductType string `json:"ingestionProductType,omitempty"` - // MerchantCenterProductIdField: Which field of [Merchant Center - // Product](/bigquery-transfer/docs/merchant-center-products-schema) - // should be imported as Product.id. Acceptable values are: * `offerId` - // (default): Import `offerId` as the product ID. * `itemGroupId`: - // Import `itemGroupId` as the product ID. Notice that Retail API will - // choose one item from the ones with the same `itemGroupId`, and use it - // to represent the item group. If this field is set to an invalid value + // MerchantCenterProductIdField: Which field of Merchant Center Product + // (/bigquery-transfer/docs/merchant-center-products-schema) should be + // imported as Product.id. Acceptable values are: * `offerId` (default): + // Import `offerId` as the product ID. * `itemGroupId`: Import + // `itemGroupId` as the product ID. Notice that Retail API will choose + // one item from the ones with the same `itemGroupId`, and use it to + // represent the item group. If this field is set to an invalid value // other than these, an INVALID_ARGUMENT error is returned. If this // field is `itemGroupId` and ingestion_product_type is `variant`, an - // INVALID_ARGUMENT error is returned. See [Using catalog - // levels](/retail/recommendations-ai/docs/catalog#catalog-levels) for - // more details. + // INVALID_ARGUMENT error is returned. See Using catalog levels + // (/retail/recommendations-ai/docs/catalog#catalog-levels) for more + // details. MerchantCenterProductIdField string `json:"merchantCenterProductIdField,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -3460,11 +3456,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index 0596769dc77..07d681298e1 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -1214,8 +1214,8 @@ type GoogleCloudRetailV2betaBigQuerySource struct { // DataSchema: The schema to use when parsing the data from the source. // Supported values for product imports: * `product` (default): One JSON // Product per line. Each product must have a valid Product.id. * - // `product_merchant_center`: See [Importing catalog data from Merchant - // Center](/retail/recommendations-ai/docs/upload-catalog#mc). Supported + // `product_merchant_center`: See Importing catalog data from Merchant + // Center (/retail/recommendations-ai/docs/upload-catalog#mc). Supported // values for user events imports: * `user_event` (default): One JSON // UserEvent per line. * `user_event_ga360`: Using // https://support.google.com/analytics/answer/3437719?hl=en. @@ -1491,8 +1491,8 @@ type GoogleCloudRetailV2betaGcsSource struct { // DataSchema: The schema to use when parsing the data from the source. // Supported values for product imports: * `product` (default): One JSON // Product per line. Each product must have a valid Product.id. * - // `product_merchant_center`: See [Importing catalog data from Merchant - // Center](/retail/recommendations-ai/docs/upload-catalog#mc). Supported + // `product_merchant_center`: See Importing catalog data from Merchant + // Center (/retail/recommendations-ai/docs/upload-catalog#mc). Supported // values for user events imports: * `user_event` (default): One JSON // UserEvent per line. * `user_event_ga360`: Using // https://support.google.com/analytics/answer/3437719?hl=en. @@ -1503,9 +1503,9 @@ type GoogleCloudRetailV2betaGcsSource 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 product - // information](/recommendations-ai/docs/upload-catalog) for the - // expected file format and setup instructions. + // GB. See Importing product information + // (/recommendations-ai/docs/upload-catalog) for the expected file + // format and setup instructions. InputUris []string `json:"inputUris,omitempty"` // ForceSendFields is a list of field names (e.g. "DataSchema") to @@ -1540,8 +1540,8 @@ type GoogleCloudRetailV2betaImage struct { // Uri: Required. URI of the image. This field must be a valid UTF-8 // encoded URI with a length limit of 5,000 characters. Otherwise, an // INVALID_ARGUMENT error is returned. Google Merchant Center property - // [image_link](https://support.google.com/merchants/answer/6324350). - // Schema.org property [Product.image](https://schema.org/image). + // image_link (https://support.google.com/merchants/answer/6324350). + // Schema.org property Product.image (https://schema.org/image). Uri string `json:"uri,omitempty"` // Width: Width of the image in number of pixels. This field must be @@ -2004,25 +2004,24 @@ func (s *GoogleCloudRetailV2betaPredictResponsePredictionResult) MarshalJSON() ( type GoogleCloudRetailV2betaPriceInfo struct { // Cost: The costs associated with the sale of a particular product. // Used for gross profit reporting. * Profit = price - cost Google - // Merchant Center property - // [cost_of_goods_sold](https://support.google.com/merchants/answer/90178 - // 95). + // Merchant Center property cost_of_goods_sold + // (https://support.google.com/merchants/answer/9017895). Cost float64 `json:"cost,omitempty"` - // CurrencyCode: The 3-letter currency code defined in [ISO - // 4217](https://www.iso.org/iso-4217-currency-codes.html). If this - // field is an unrecognizable currency code, an INVALID_ARGUMENT error - // is returned. + // CurrencyCode: The 3-letter currency code defined in ISO 4217 + // (https://www.iso.org/iso-4217-currency-codes.html). If this field is + // an unrecognizable currency code, an INVALID_ARGUMENT error is + // returned. CurrencyCode string `json:"currencyCode,omitempty"` // OriginalPrice: Price of the product without any discount. If zero, by // default set to be the price. OriginalPrice float64 `json:"originalPrice,omitempty"` - // Price: Price of the product. Google Merchant Center property - // [price](https://support.google.com/merchants/answer/6324371). - // Schema.org property - // [Offer.priceSpecification](https://schema.org/priceSpecification). + // Price: Price of the product. Google Merchant Center property price + // (https://support.google.com/merchants/answer/6324371). Schema.org + // property Offer.priceSpecification + // (https://schema.org/priceSpecification). Price float64 `json:"price,omitempty"` // ForceSendFields is a list of field names (e.g. "Cost") to @@ -2087,10 +2086,9 @@ type GoogleCloudRetailV2betaProduct struct { Attributes map[string]GoogleCloudRetailV2betaCustomAttribute `json:"attributes,omitempty"` // Availability: The online availability of the Product. Default to - // Availability.IN_STOCK. Google Merchant Center Property - // [availability](https://support.google.com/merchants/answer/6324448). - // Schema.org Property - // [Offer.availability](https://schema.org/availability). + // Availability.IN_STOCK. Google Merchant Center Property availability + // (https://support.google.com/merchants/answer/6324448). Schema.org + // Property Offer.availability (https://schema.org/availability). // // Possible values: // "AVAILABILITY_UNSPECIFIED" - Default product availability. Default @@ -2132,9 +2130,9 @@ type GoogleCloudRetailV2betaProduct struct { // Description: Product description. This field must be a UTF-8 encoded // string with a length limit of 5,000 characters. Otherwise, an // INVALID_ARGUMENT error is returned. Google Merchant Center property - // [description](https://support.google.com/merchants/answer/6324468). - // schema.org property - // [Product.description](https://schema.org/description). + // description (https://support.google.com/merchants/answer/6324468). + // schema.org property Product.description + // (https://schema.org/description). Description string `json:"description,omitempty"` // Id: Immutable. Product identifier, which is the final component of @@ -2142,15 +2140,15 @@ type GoogleCloudRetailV2betaProduct struct { // `projects/*/locations/global/catalogs/default_catalog/branches/default // _branch/products/id_1`. This field must be a UTF-8 encoded string // with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT - // error is returned. Google Merchant Center property - // [id](https://support.google.com/merchants/answer/6324405). Schema.org - // Property [Product.sku](https://schema.org/sku). + // error is returned. Google Merchant Center property id + // (https://support.google.com/merchants/answer/6324405). Schema.org + // Property Product.sku (https://schema.org/sku). Id string `json:"id,omitempty"` // Images: Product images for the product. A maximum of 300 images are - // allowed. Google Merchant Center property - // [image_link](https://support.google.com/merchants/answer/6324350). - // Schema.org property [Product.image](https://schema.org/image). + // allowed. Google Merchant Center property image_link + // (https://support.google.com/merchants/answer/6324350). Schema.org + // property Product.image (https://schema.org/image). Images []*GoogleCloudRetailV2betaImage `json:"images,omitempty"` // Name: Immutable. Full resource name of the product, such as @@ -2159,8 +2157,7 @@ type GoogleCloudRetailV2betaProduct struct { Name string `json:"name,omitempty"` // PriceInfo: Product price and cost information. Google Merchant Center - // property - // [price](https://support.google.com/merchants/answer/6324371). + // property price (https://support.google.com/merchants/answer/6324371). PriceInfo *GoogleCloudRetailV2betaPriceInfo `json:"priceInfo,omitempty"` // PrimaryProductId: Variant group identifier. Must be an id, with the @@ -2169,12 +2166,12 @@ type GoogleCloudRetailV2betaProduct struct { // same value as id. For VARIANT Products, this field cannot be empty. A // maximum of 2,000 products are allowed to share the same Type.PRIMARY // Product. Otherwise, an INVALID_ARGUMENT error is returned. Google - // Merchant Center Property - // [item_group_id](https://support.google.com/merchants/answer/6324507). - // Schema.org Property - // [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID - // ). This field must be enabled before it can be used. [Learn - // more](/recommendations-ai/docs/catalog#item-group-id). + // Merchant Center Property item_group_id + // (https://support.google.com/merchants/answer/6324507). Schema.org + // Property Product.inProductGroupWithID + // (https://schema.org/inProductGroupWithID). This field must be enabled + // before it can be used. Learn more + // (/recommendations-ai/docs/catalog#item-group-id). PrimaryProductId string `json:"primaryProductId,omitempty"` // Tags: Custom tags associated with the product. At most 250 values are @@ -2182,16 +2179,15 @@ type GoogleCloudRetailV2betaProduct struct { // length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT // error is returned. This tag can be used for filtering recommendation // results by passing the tag as part of the PredictRequest.filter. - // Google Merchant Center property - // [custom_label_0–4](https://support.google.com/merchants/answer/63244 - // 73). + // Google Merchant Center property custom_label_0–4 + // (https://support.google.com/merchants/answer/6324473). Tags []string `json:"tags,omitempty"` // Title: Required. Product title. This field must be a UTF-8 encoded // string with a length limit of 128 characters. Otherwise, an // INVALID_ARGUMENT error is returned. Google Merchant Center property - // [title](https://support.google.com/merchants/answer/6324415). - // Schema.org property [Product.name](https://schema.org/name). + // title (https://support.google.com/merchants/answer/6324415). + // Schema.org property Product.name (https://schema.org/name). Title string `json:"title,omitempty"` // Type: Immutable. The type of the product. This field is output-only. @@ -2214,9 +2210,9 @@ type GoogleCloudRetailV2betaProduct struct { // Uri: Canonical URL directly linking to the product detail page. This // field must be a UTF-8 encoded string with a length limit of 5,000 // characters. Otherwise, an INVALID_ARGUMENT error is returned. Google - // Merchant Center property - // [link](https://support.google.com/merchants/answer/6324416). - // Schema.org property [Offer.url](https://schema.org/url). + // Merchant Center property link + // (https://support.google.com/merchants/answer/6324416). Schema.org + // property Offer.url (https://schema.org/url). Uri string `json:"uri,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2363,23 +2359,23 @@ type GoogleCloudRetailV2betaProductLevelConfig struct { // this field is set to an invalid value other than these, an // INVALID_ARGUMENT error is returned. If this field is `variant` and // merchant_center_product_id_field is `itemGroupId`, an - // INVALID_ARGUMENT error is returned. See [Using catalog - // levels](/retail/recommendations-ai/docs/catalog#catalog-levels) for - // more details. + // INVALID_ARGUMENT error is returned. See Using catalog levels + // (/retail/recommendations-ai/docs/catalog#catalog-levels) for more + // details. IngestionProductType string `json:"ingestionProductType,omitempty"` - // MerchantCenterProductIdField: Which field of [Merchant Center - // Product](/bigquery-transfer/docs/merchant-center-products-schema) - // should be imported as Product.id. Acceptable values are: * `offerId` - // (default): Import `offerId` as the product ID. * `itemGroupId`: - // Import `itemGroupId` as the product ID. Notice that Retail API will - // choose one item from the ones with the same `itemGroupId`, and use it - // to represent the item group. If this field is set to an invalid value + // MerchantCenterProductIdField: Which field of Merchant Center Product + // (/bigquery-transfer/docs/merchant-center-products-schema) should be + // imported as Product.id. Acceptable values are: * `offerId` (default): + // Import `offerId` as the product ID. * `itemGroupId`: Import + // `itemGroupId` as the product ID. Notice that Retail API will choose + // one item from the ones with the same `itemGroupId`, and use it to + // represent the item group. If this field is set to an invalid value // other than these, an INVALID_ARGUMENT error is returned. If this // field is `itemGroupId` and ingestion_product_type is `variant`, an - // INVALID_ARGUMENT error is returned. See [Using catalog - // levels](/retail/recommendations-ai/docs/catalog#catalog-levels) for - // more details. + // INVALID_ARGUMENT error is returned. See Using catalog levels + // (/retail/recommendations-ai/docs/catalog#catalog-levels) for more + // details. MerchantCenterProductIdField string `json:"merchantCenterProductIdField,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -3459,11 +3455,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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 ac9b0878ece..03b48d56628 100644 --- a/run/v1/run-gen.go +++ b/run/v1/run-gen.go @@ -450,8 +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](https://www.google.com/webmasters/verification/home). +// Webmaster Central +// (https://www.google.com/webmasters/verification/home). type AuthorizedDomain struct { // Id: Relative name of the domain authorized for use. Example: // `example.com`. @@ -493,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1398,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") @@ -2061,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 @@ -2204,9 +2204,10 @@ 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 +// (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", @@ -2224,8 +2225,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2264,9 +2265,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -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 @@ -3407,8 +3410,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -9685,9 +9688,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 81240910381..87759e07582 100644 --- a/run/v1alpha1/run-gen.go +++ b/run/v1alpha1/run-gen.go @@ -561,8 +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](https://www.google.com/webmasters/verification/home). +// Webmaster Central +// (https://www.google.com/webmasters/verification/home). type AuthorizedDomain struct { // Id: Relative name of the domain authorized for use. Example: // `example.com`. @@ -603,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1343,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") @@ -1586,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") @@ -1629,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 @@ -3351,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 @@ -3560,9 +3561,10 @@ 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 +// (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", @@ -3580,8 +3582,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -3620,9 +3622,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -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"` @@ -5024,8 +5034,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -18205,9 +18215,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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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/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/runtimeconfig/v1/runtimeconfig-gen.go b/runtimeconfig/v1/runtimeconfig-gen.go index 5c2053a94a4..3c6a26c63dc 100644 --- a/runtimeconfig/v1/runtimeconfig-gen.go +++ b/runtimeconfig/v1/runtimeconfig-gen.go @@ -266,11 +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](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/runtimeconfig/v1beta1/runtimeconfig-gen.go b/runtimeconfig/v1beta1/runtimeconfig-gen.go index e0190b74867..17466b70cb8 100644 --- a/runtimeconfig/v1beta1/runtimeconfig-gen.go +++ b/runtimeconfig/v1beta1/runtimeconfig-gen.go @@ -208,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -616,9 +615,10 @@ 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 +// (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", @@ -636,8 +636,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 (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 @@ -672,9 +672,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -782,11 +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](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. @@ -829,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -905,10 +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](?:[_.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 (?:[_.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 @@ -975,8 +975,8 @@ 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) +// 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 @@ -1545,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 @@ -2617,9 +2616,9 @@ 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) +// prefix. To learn more about creating a variable, read the Setting and +// 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)} @@ -3589,9 +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](/deployment-manager/runtime-configurator/watching-a-variable) -// 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 adb68f1f3bb..63496d8a3cb 100644 --- a/sasportal/v1alpha1/sasportal-gen.go +++ b/sasportal/v1alpha1/sasportal-gen.go @@ -1533,11 +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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 14e62991ead..47ec4195b66 100644 --- a/script/v1/script-gen.go +++ b/script/v1/script-gen.go @@ -573,11 +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) + // 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 @@ -1338,11 +1338,11 @@ 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 +// (/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 // object. The `Status` object's `details` field contains an array with @@ -4537,15 +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](#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. +// 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 e8d00cc4bb1..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 @@ -719,7 +714,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 (https://support.google.com/webmasters/answer/156184). Sitemap []*WmxSitemap `json:"sitemap,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -752,8 +747,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 + // (https://support.google.com/webmasters/answer/2451999). SiteEntry []*WmxSite `json:"siteEntry,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -828,8 +823,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](https://support.google.com/webmasters/answer/2451999). +// 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. // @@ -876,8 +871,8 @@ 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 +// (https://support.google.com/webmasters/answer/156184). type WmxSitemap struct { // Contents: The various content types in the sitemap. Contents []*WmxSitemapContent `json:"contents,omitempty"` @@ -1417,7 +1412,7 @@ type SitemapsListCall struct { header_ http.Header } -// List: Lists the [sitemaps-entries](/webmaster-tools/v3/sitemaps) +// 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 { diff --git a/secretmanager/v1/secretmanager-gen.go b/secretmanager/v1/secretmanager-gen.go index 3a86be3d787..f3502423204 100644 --- a/secretmanager/v1/secretmanager-gen.go +++ b/secretmanager/v1/secretmanager-gen.go @@ -421,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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,9 +822,10 @@ 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 +// (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", @@ -843,8 +843,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -883,9 +883,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1243,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2309,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 dbb92a62668..fe5f5204045 100644 --- a/secretmanager/v1beta1/secretmanager-gen.go +++ b/secretmanager/v1beta1/secretmanager-gen.go @@ -356,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -691,9 +690,10 @@ 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 +// (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", @@ -711,8 +711,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -751,9 +751,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1026,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -2061,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 60e023aa989..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 @@ -513,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -682,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 @@ -863,9 +866,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -1090,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 @@ -1339,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"` @@ -2030,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"` @@ -2150,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 @@ -2194,9 +2203,10 @@ 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 +// (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", @@ -2214,8 +2224,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2254,9 +2264,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2423,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"` @@ -2552,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 @@ -2585,11 +2597,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](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. @@ -2672,8 +2684,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 76754049ef5..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 @@ -395,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -569,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 @@ -746,9 +749,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -933,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 @@ -1054,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"` @@ -1117,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 @@ -1366,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"` @@ -1932,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 @@ -1976,9 +1990,10 @@ 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 +// (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", @@ -1996,8 +2011,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -2036,9 +2051,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2140,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"` @@ -2265,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 @@ -2298,11 +2315,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](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. @@ -2345,8 +2362,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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/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 26e9ef40d36..ed229a98079 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go @@ -242,7 +242,7 @@ 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) + // 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 @@ -352,20 +352,20 @@ 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) +// (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-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 + // (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"` @@ -379,18 +379,20 @@ 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# - // 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: + // 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 JwksUri string `json:"jwksUri,omitempty"` @@ -429,19 +431,18 @@ 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) +// (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](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 + // (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 // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -642,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: @@ -664,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 @@ -1283,9 +1286,9 @@ 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 + // 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. @@ -1295,10 +1298,10 @@ type Endpoint struct { 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 - // 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 @@ -1534,33 +1537,32 @@ 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 +// (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 // (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 +1642,16 @@ 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 +// 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 +// 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 // service config is simply the YAML representation of the @@ -1665,26 +1667,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](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 -// 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 @@ -2204,8 +2206,8 @@ 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: + // `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 @@ -2228,11 +2230,11 @@ type MetricDescriptor struct { // 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 + // 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"). * `%` @@ -3349,11 +3351,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](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. @@ -3779,10 +3781,10 @@ 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 + // 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"` diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index 76d9a6c279c..9cae9bf8b12 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -232,7 +232,7 @@ 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) + // 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 @@ -267,20 +267,20 @@ 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) +// (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-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 + // (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"` @@ -294,18 +294,20 @@ 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# - // 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: + // 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 JwksUri string `json:"jwksUri,omitempty"` @@ -344,19 +346,18 @@ 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) +// (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](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 + // (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 // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -557,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: @@ -579,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 @@ -1094,9 +1097,9 @@ 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 + // 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. @@ -1106,10 +1109,10 @@ type Endpoint struct { 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 - // 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 @@ -1345,33 +1348,32 @@ 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 +// (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 // (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 +1453,16 @@ 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 +// 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 +// 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 // service config is simply the YAML representation of the @@ -1476,26 +1478,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](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 -// 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 @@ -1943,8 +1945,8 @@ 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: + // `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 @@ -1967,11 +1969,11 @@ type MetricDescriptor struct { // 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 + // 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"). * `%` @@ -2951,11 +2953,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](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. @@ -3165,10 +3167,10 @@ 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 + // 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"` diff --git a/servicecontrol/v1/servicecontrol-gen.go b/servicecontrol/v1/servicecontrol-gen.go index 4b0405daef4..55b98bbff26 100644 --- a/servicecontrol/v1/servicecontrol-gen.go +++ b/servicecontrol/v1/servicecontrol-gen.go @@ -531,8 +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](https://cloud.google.com/logging/docs/audit#user-id). + // 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 @@ -887,8 +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](https://cloud.google.com/resource-manager/). + // Google Resource Manager (https://cloud.google.com/resource-manager/). // // Possible values: // "CONSUMER_TYPE_UNSPECIFIED" - This is never used. @@ -972,7 +971,7 @@ 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 + // 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"` @@ -1237,9 +1236,9 @@ 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 + // (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 @@ -2311,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 @@ -2685,11 +2684,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](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. @@ -2917,8 +2916,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** +// 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 @@ -3073,8 +3072,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](https://cloud.google.com/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 @@ -3223,8 +3222,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](https://cloud.google.com/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 f26640a21d4..6f136fa2616 100644 --- a/servicecontrol/v2/servicecontrol-gen.go +++ b/servicecontrol/v2/servicecontrol-gen.go @@ -456,8 +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](https://cloud.google.com/logging/docs/audit#user-id). + // 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 @@ -599,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"` @@ -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 @@ -1194,11 +1194,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](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. @@ -1278,22 +1278,19 @@ 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 -// 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). +// 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 @@ -1435,19 +1432,17 @@ 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 -// 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 +// 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](https://cloud.google.com/service-infrastructure/docs/service- -// control/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 6503d94d419..5b1efa322c6 100644 --- a/servicedirectory/v1/servicedirectory-gen.go +++ b/servicedirectory/v1/servicedirectory-gen.go @@ -200,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -439,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -718,9 +716,10 @@ 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 +// (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", @@ -738,8 +737,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 (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 @@ -774,9 +773,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -982,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 201d9ce7416..dfb2938c376 100644 --- a/servicedirectory/v1beta1/servicedirectory-gen.go +++ b/servicedirectory/v1beta1/servicedirectory-gen.go @@ -200,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -436,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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,9 +713,10 @@ 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 +// (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", @@ -735,8 +734,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 (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 @@ -771,9 +770,9 @@ 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 + // (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,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 bb153cadff9..f7c0f61874f 100644 --- a/servicemanagement/v1/servicemanagement-gen.go +++ b/servicemanagement/v1/servicemanagement-gen.go @@ -278,7 +278,7 @@ 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) + // 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 @@ -410,20 +410,20 @@ 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) +// (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-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 + // (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"` @@ -437,18 +437,20 @@ 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# - // 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: + // 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 JwksUri string `json:"jwksUri,omitempty"` @@ -487,19 +489,18 @@ 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) +// (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](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 + // (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 // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -700,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: @@ -722,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 @@ -862,9 +865,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1602,9 +1604,9 @@ 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 + // 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. @@ -1614,10 +1616,10 @@ type Endpoint struct { 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 - // 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 @@ -2021,9 +2023,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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -2095,33 +2096,32 @@ 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 +// (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 // (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; // @@ -2201,16 +2201,16 @@ 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 +// 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 +// 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 // service config is simply the YAML representation of the @@ -2226,26 +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](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 -// 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 @@ -2682,8 +2682,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 + // (/service-management/overview) for naming requirements. ServiceName string `json:"serviceName,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2877,8 +2877,8 @@ 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: + // `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 @@ -2901,11 +2901,11 @@ type MetricDescriptor struct { // 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 + // 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"). * `%` @@ -3582,9 +3582,10 @@ 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 +// (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", @@ -3602,8 +3603,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -3642,9 +3643,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4194,11 +4195,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](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. @@ -4466,8 +4467,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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -4648,10 +4649,10 @@ 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 + // 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"` @@ -5382,9 +5383,9 @@ 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 +// (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 @@ -8192,11 +8193,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](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 +// (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' 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 de9390ef2f2..a260c0ed6e8 100644 --- a/servicenetworking/v1/servicenetworking-gen.go +++ b/servicenetworking/v1/servicenetworking-gen.go @@ -491,7 +491,7 @@ type AddSubnetworkRequest struct { // range. IpPrefixLength int64 `json:"ipPrefixLength,omitempty"` - // Region: Required. The name of a [region](/compute/docs/regions-zones) + // Region: Required. The name of a region (/compute/docs/regions-zones) // for the subnet, such `europe-west1`. Region string `json:"region,omitempty"` @@ -516,9 +516,9 @@ 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 + // (/compute/docs/reference/rest/v1/subnetworks) in the Compute API + // documentation. Subnetwork string `json:"subnetwork,omitempty"` // SubnetworkUsers: A list of members that are granted the @@ -588,7 +588,7 @@ 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) + // 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 @@ -623,20 +623,20 @@ 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) +// (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-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 + // (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"` @@ -650,18 +650,20 @@ 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# - // 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: + // 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 JwksUri string `json:"jwksUri,omitempty"` @@ -700,19 +702,18 @@ 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) +// (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](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 + // (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 // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -913,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: @@ -935,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 @@ -1774,9 +1777,9 @@ 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 + // 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. @@ -1786,10 +1789,10 @@ type Endpoint struct { 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 - // 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 @@ -2104,33 +2107,32 @@ 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 +// (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 // (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; // @@ -2210,16 +2212,16 @@ 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 +// 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 +// 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 // service config is simply the YAML representation of the @@ -2235,26 +2237,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](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 -// 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 @@ -2806,8 +2808,8 @@ 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: + // `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 @@ -2830,11 +2832,11 @@ type MetricDescriptor struct { // 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 + // 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"). * `%` @@ -4239,11 +4241,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](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. @@ -4583,10 +4585,10 @@ 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 + // 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"` diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go index 3061bc61160..a086755009a 100644 --- a/servicenetworking/v1beta/servicenetworking-gen.go +++ b/servicenetworking/v1beta/servicenetworking-gen.go @@ -285,7 +285,7 @@ type AddSubnetworkRequest struct { // range. IpPrefixLength int64 `json:"ipPrefixLength,omitempty"` - // Region: Required. The name of a [region](/compute/docs/regions-zones) + // Region: Required. The name of a region (/compute/docs/regions-zones) // for the subnet, such `europe-west1`. Region string `json:"region,omitempty"` @@ -298,9 +298,9 @@ 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 + // (/compute/docs/reference/rest/v1/subnetworks) in the Compute API + // documentation. Subnetwork string `json:"subnetwork,omitempty"` // SubnetworkUsers: A list of members that are granted the @@ -370,7 +370,7 @@ 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) + // 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 @@ -405,20 +405,20 @@ 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) +// (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-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 + // (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"` @@ -432,18 +432,20 @@ 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# - // 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: + // 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 JwksUri string `json:"jwksUri,omitempty"` @@ -482,19 +484,18 @@ 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) +// (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](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 + // (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 // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -695,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: @@ -717,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 @@ -1435,9 +1438,9 @@ 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 + // 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. @@ -1447,10 +1450,10 @@ type Endpoint struct { 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 - // 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 @@ -1765,33 +1768,32 @@ 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 +// (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 // (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; // @@ -1871,16 +1873,16 @@ 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 +// 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 +// 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 // service config is simply the YAML representation of the @@ -1896,26 +1898,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](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 -// 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 @@ -2396,8 +2398,8 @@ 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: + // `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 @@ -2420,11 +2422,11 @@ type MetricDescriptor struct { // 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 + // 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"). * `%` @@ -3650,11 +3652,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](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. @@ -3916,10 +3918,10 @@ 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 + // 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"` diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index 2c8f2d093d3..8b52a8360e9 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -269,7 +269,7 @@ 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) + // 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 @@ -304,20 +304,20 @@ 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) +// (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-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 + // (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"` @@ -331,18 +331,20 @@ 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# - // 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: + // 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 JwksUri string `json:"jwksUri,omitempty"` @@ -381,19 +383,18 @@ 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) +// (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](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 + // (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 // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -594,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: @@ -616,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 @@ -1444,9 +1447,9 @@ 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 + // 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. @@ -1456,10 +1459,10 @@ type Endpoint struct { 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 - // 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 @@ -2108,33 +2111,32 @@ 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 +// (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 // (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 +2216,16 @@ 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 +// 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 +// 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 // service config is simply the YAML representation of the @@ -2239,26 +2241,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](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 -// 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 @@ -2866,8 +2868,8 @@ 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: + // `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 @@ -2890,11 +2892,11 @@ type MetricDescriptor struct { // 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 + // 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"). * `%` @@ -3867,11 +3869,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](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. @@ -4081,10 +4083,10 @@ 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 + // 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"` @@ -5577,9 +5579,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](https://cloud.google.com/asset-inventory/docs/apis), 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 46bca3c9e9a..ffd4cf1dac6 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -317,7 +317,7 @@ 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) + // 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 @@ -352,20 +352,20 @@ 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) +// (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-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 + // (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"` @@ -379,18 +379,20 @@ 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# - // 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: + // 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 JwksUri string `json:"jwksUri,omitempty"` @@ -429,19 +431,18 @@ 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) +// (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](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 + // (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 // aryService". Example: audiences: // bookstore_android.apps.googleusercontent.com, @@ -642,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: @@ -664,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 @@ -1524,9 +1527,9 @@ 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 + // 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. @@ -1536,10 +1539,10 @@ type Endpoint struct { 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 - // 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 @@ -2184,33 +2187,32 @@ 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 +// (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 // (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 +2292,16 @@ 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 +// 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 +// 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 // service config is simply the YAML representation of the @@ -2315,26 +2317,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](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 -// 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 @@ -3125,8 +3127,8 @@ 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: + // `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 @@ -3149,11 +3151,11 @@ type MetricDescriptor struct { // 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 + // 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"). * `%` @@ -4329,11 +4331,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](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. @@ -4543,10 +4545,10 @@ 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 + // 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"` diff --git a/sheets/v4/sheets-gen.go b/sheets/v4/sheets-gen.go index 9de680bc2a7..0246f8f06e1 100644 --- a/sheets/v4/sheets-gen.go +++ b/sheets/v4/sheets-gen.go @@ -2285,9 +2285,9 @@ 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 (https://cloud.google.com/bigquery/docs/tables-intro) is +// allowed. type BigQueryTableSpec struct { // DatasetId: The BigQuery dataset id. DatasetId string `json:"datasetId,omitempty"` @@ -4518,9 +4518,8 @@ 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 + // (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. @@ -7543,9 +7546,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](/sheets/api/guides/formats) 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 @@ -12616,11 +12619,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](/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 +// (/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 8f13a7a18e8..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") @@ -6939,8 +6939,8 @@ 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 + // 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"). @@ -7639,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](/slides/limits) 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 1ae8fbaf102..b38a287b571 100644 --- a/sourcerepo/v1/sourcerepo-gen.go +++ b/sourcerepo/v1/sourcerepo-gen.go @@ -277,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -566,9 +565,10 @@ 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 +// (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", @@ -586,8 +586,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 (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. @@ -626,9 +626,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -836,11 +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](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. @@ -926,8 +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](https://cloud.google.com/iam/docs/overview#permissions). + // 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 @@ -1787,9 +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](https://cloud.google.com/iam/help/conditions/resource-p -// olicies). +// 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 2c3fe521804..2ad2a0a2e83 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -496,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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 @@ -1380,9 +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](https://cloud.google.com/iam/help/conditions/resource-p - // olicies). + // 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. @@ -1433,8 +1431,8 @@ 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 + // 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 @@ -1455,9 +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](https://cloud.google.com/spanner/docs/instances#node_co - // unt) 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, @@ -2562,9 +2560,10 @@ 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 +// (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", @@ -2582,8 +2581,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 (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 @@ -2618,9 +2617,9 @@ 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 + // (https://cloud.google.com/iam/help/conditions/resource-policies). Version int64 `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2663,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 @@ -2877,9 +2877,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](https://cloud.google.com/spanner/docs/instances#region_ - // types) 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". @@ -3236,7 +3236,7 @@ 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 + // 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 @@ -3392,11 +3392,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](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. @@ -4179,7 +4179,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4341,7 +4341,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4527,7 +4527,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4670,7 +4670,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4820,7 +4820,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -4965,7 +4965,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5148,7 +5148,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5343,7 +5343,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5486,7 +5486,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5631,7 +5631,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -5839,7 +5839,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6028,7 +6028,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6172,7 +6172,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6314,7 +6314,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6455,7 +6455,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6651,7 +6651,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6835,7 +6835,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -6986,7 +6986,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7134,7 +7134,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7282,7 +7282,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7416,7 +7416,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7560,7 +7560,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7735,7 +7735,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -7973,7 +7973,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8150,7 +8150,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8291,7 +8291,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8433,7 +8433,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8580,7 +8580,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8721,7 +8721,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -8887,7 +8887,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9067,7 +9067,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9212,7 +9212,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9360,7 +9360,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9506,7 +9506,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9654,7 +9654,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9788,7 +9788,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -9932,7 +9932,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10107,7 +10107,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10282,7 +10282,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10425,7 +10425,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10577,7 +10577,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10730,7 +10730,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -10871,7 +10871,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11012,7 +11012,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11160,7 +11160,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11304,7 +11304,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11456,7 +11456,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11629,7 +11629,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11812,7 +11812,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -11965,7 +11965,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12114,7 +12114,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12260,7 +12260,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12404,7 +12404,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12552,7 +12552,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12686,7 +12686,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -12830,7 +12830,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -13005,7 +13005,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/20210110") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/speech/v1/speech-gen.go b/speech/v1/speech-gen.go index c1747b5b627..c04593231f5 100644 --- a/speech/v1/speech-gen.go +++ b/speech/v1/speech-gen.go @@ -406,8 +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](https://cloud.google.com/speech-to-text/quotas#content). +// 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,8 +420,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 (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -532,10 +532,10 @@ 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 (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 @@ -581,9 +581,9 @@ 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 + // (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 @@ -848,13 +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](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 + // (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 @@ -978,11 +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](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. @@ -1795,9 +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](https://cloud.google.com/speech-to-text/docs/async-recognize) -// . +// 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 9bcb5e18451..14beed11c81 100644 --- a/speech/v1p1beta1/speech-gen.go +++ b/speech/v1p1beta1/speech-gen.go @@ -475,21 +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](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 +// (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 @@ -605,8 +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](https://cloud.google.com/speech-to-text/quotas#content). +// 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 @@ -619,8 +619,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 (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -651,16 +651,16 @@ 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 + // (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](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 + // 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. @@ -774,10 +774,10 @@ 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 (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 @@ -823,9 +823,9 @@ 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 + // (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 @@ -1140,13 +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](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 + // (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 @@ -1259,10 +1259,10 @@ 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 + // (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 @@ -1290,11 +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](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. @@ -2130,9 +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](https://cloud.google.com/speech-to-text/docs/async-recognize) -// . +// 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 eb07d7ffeaf..7d59f9bb09b 100644 --- a/speech/v2beta1/speech-gen.go +++ b/speech/v2beta1/speech-gen.go @@ -420,10 +420,10 @@ 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 + // (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 @@ -451,11 +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](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/storagetransfer/v1/storagetransfer-gen.go b/storagetransfer/v1/storagetransfer-gen.go index d6cbf5b6af3..b45fdc8e244 100644 --- a/storagetransfer/v1/storagetransfer-gen.go +++ b/storagetransfer/v1/storagetransfer-gen.go @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC. +// Copyright 2021 Google LLC. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. @@ -168,11 +168,10 @@ 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 +// (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"` @@ -211,13 +210,12 @@ 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 + // (data-retention#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 + // (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,18 +249,16 @@ 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 +// (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](data-retention#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 @@ -302,14 +298,13 @@ 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 +// (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)](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) + // (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 @@ -560,9 +555,9 @@ 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 + // (https://cloud.google.com/storage/docs/naming#requirements)). BucketName string `json:"bucketName,omitempty"` // Path: Root path to transfer objects. Must be an empty string or full @@ -637,9 +632,9 @@ 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 +// 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 @@ -1059,11 +1054,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](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. @@ -1601,7 +1596,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/20201217") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1733,7 +1728,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/20201217") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -1870,7 +1865,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/20201217") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2034,7 +2029,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/20201217") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2200,7 +2195,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/20201217") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2358,7 +2353,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/20201217") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2509,7 +2504,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/20201217") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2668,7 +2663,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/20201217") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2842,7 +2837,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/20201217") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } @@ -2982,7 +2977,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/20201217") + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/20210110") for k, v := range c.header_ { reqHeaders[k] = v } diff --git a/streetviewpublish/v1/streetviewpublish-gen.go b/streetviewpublish/v1/streetviewpublish-gen.go index d7ed4246127..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 @@ -841,11 +845,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](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. @@ -973,11 +977,12 @@ 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`, -// `pose.pitch`, `pose.roll`, `pose.altitude`, and `pose.level` fields -// in Pose. This method returns the following error codes: * +// 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`, `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. * @@ -1433,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 ffd3ca23eed..a75120c89df 100644 --- a/sts/v1beta/sts-gen.go +++ b/sts/v1beta/sts-gen.go @@ -167,36 +167,36 @@ 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 - // `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.h - // tml#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/APIRefe - // rence/API_GetCallerIdentity) method. Format the request as - // URL-encoded JSON, and set the `subject_token_type` parameter to + // 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#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 // `GetCallerIdentity()`, such as @@ -205,20 +205,37 @@ type GoogleIdentityStsV1betaExchangeTokenRequest struct { // 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`. - - // `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: + // ISO8601 Basic + // (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/texttospeech/v1/texttospeech-gen.go b/texttospeech/v1/texttospeech-gen.go index 4951648c6db..40bd1e180ca 100644 --- a/texttospeech/v1/texttospeech-gen.go +++ b/texttospeech/v1/texttospeech-gen.go @@ -179,9 +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](https://cloud.google.com/text-to-speech/docs/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, @@ -298,8 +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](https://cloud.google.com/text-to-speech/docs/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. @@ -404,7 +404,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 + // 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"` @@ -457,9 +457,9 @@ 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 + // (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 // this parameter to help choose an appropriate voice. Note that the TTS @@ -660,7 +660,7 @@ 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. +// 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 diff --git a/texttospeech/v1beta1/texttospeech-gen.go b/texttospeech/v1beta1/texttospeech-gen.go index b295d44d7b4..e5672c898e2 100644 --- a/texttospeech/v1beta1/texttospeech-gen.go +++ b/texttospeech/v1beta1/texttospeech-gen.go @@ -183,9 +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](https://cloud.google.com/text-to-speech/docs/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, @@ -302,8 +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](https://cloud.google.com/text-to-speech/docs/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. @@ -473,7 +473,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 + // 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"` @@ -526,9 +526,9 @@ 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 + // (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 // this parameter to help choose an appropriate voice. Note that the TTS @@ -729,7 +729,7 @@ 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. +// 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 diff --git a/toolresults/v1beta3/toolresults-gen.go b/toolresults/v1beta3/toolresults-gen.go index ab65eca5296..f5774cc1f21 100644 --- a/toolresults/v1beta3/toolresults-gen.go +++ b/toolresults/v1beta3/toolresults-gen.go @@ -3313,11 +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](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. @@ -4173,10 +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](https://developers.google.com/time/smear). The +// 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. +// 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 f81ff1ccbff..27868afb010 100644 --- a/tpu/v1/tpu-gen.go +++ b/tpu/v1/tpu-gen.go @@ -846,11 +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](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/tpu/v1alpha1/tpu-gen.go b/tpu/v1alpha1/tpu-gen.go index 2920eaad6a4..6ee566f4067 100644 --- a/tpu/v1alpha1/tpu-gen.go +++ b/tpu/v1alpha1/tpu-gen.go @@ -846,11 +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](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/translate/v3/translate-gen.go b/translate/v3/translate-gen.go index 571792d410d..de6c1a86e0b 100644 --- a/translate/v3/translate-gen.go +++ b/translate/v3/translate-gen.go @@ -536,8 +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](https://cloud.google.com/translate/docs/advanced/glossary - // ). + // 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 @@ -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). @@ -983,11 +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](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/translate/v3beta1/translate-gen.go b/translate/v3beta1/translate-gen.go index 2b827078c20..960d14c0492 100644 --- a/translate/v3beta1/translate-gen.go +++ b/translate/v3beta1/translate-gen.go @@ -533,9 +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](https://support.google.com/translatortoolkit/answer/6306379? - // hl=en). + // 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 @@ -927,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). @@ -981,11 +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](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/vault/v1/vault-gen.go b/vault/v1/vault-gen.go index 4b529097cab..d806116a731 100644 --- a/vault/v1/vault-gen.go +++ b/vault/v1/vault-gen.go @@ -2289,11 +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](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/videointelligence/v1/videointelligence-gen.go b/videointelligence/v1/videointelligence-gen.go index f7fca7aec33..daa0f09b7c9 100644 --- a/videointelligence/v1/videointelligence-gen.go +++ b/videointelligence/v1/videointelligence-gen.go @@ -287,12 +287,12 @@ 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 + // 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 @@ -307,12 +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](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 + // (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 @@ -486,9 +486,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1447,8 +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](https://cloud.google.com/speech/limits#content). + // 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 @@ -1540,10 +1540,10 @@ 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 + // (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 @@ -1613,10 +1613,10 @@ 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 (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 @@ -1930,8 +1930,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1992,8 +1992,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -2414,9 +2414,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -3181,10 +3181,10 @@ 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 + // (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 @@ -3450,8 +3450,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -3512,8 +3512,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3876,9 +3876,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4645,10 +4645,10 @@ 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 + // (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 @@ -4914,8 +4914,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4976,8 +4976,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -5340,9 +5340,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -6109,10 +6109,10 @@ 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 + // (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 @@ -6378,8 +6378,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6440,8 +6440,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6910,9 +6910,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7725,10 +7725,10 @@ 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 + // (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 @@ -8083,8 +8083,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8148,8 +8148,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8454,11 +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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 b2c977c0173..faa58a3211e 100644 --- a/videointelligence/v1beta2/videointelligence-gen.go +++ b/videointelligence/v1beta2/videointelligence-gen.go @@ -323,9 +323,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1088,10 +1088,10 @@ 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 + // (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 @@ -1356,8 +1356,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1418,8 +1418,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1661,12 +1661,12 @@ 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 + // 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 @@ -1681,12 +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](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 + // (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 @@ -1861,9 +1861,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2825,8 +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](https://cloud.google.com/speech/limits#content). + // 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 @@ -2918,10 +2918,10 @@ 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 + // (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 @@ -2991,10 +2991,10 @@ 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 (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 @@ -3309,8 +3309,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -3371,8 +3371,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3793,9 +3793,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4562,10 +4562,10 @@ 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 + // (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 @@ -4831,8 +4831,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4893,8 +4893,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -5257,9 +5257,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -6026,10 +6026,10 @@ 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 + // (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 @@ -6295,8 +6295,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6357,8 +6357,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6827,9 +6827,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7642,10 +7642,10 @@ 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 + // (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 @@ -8000,8 +8000,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8065,8 +8065,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8317,11 +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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 ffe7db2f7f1..9eed7e03125 100644 --- a/videointelligence/v1p1beta1/videointelligence-gen.go +++ b/videointelligence/v1p1beta1/videointelligence-gen.go @@ -323,9 +323,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1088,10 +1088,10 @@ 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 + // (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 @@ -1356,8 +1356,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1418,8 +1418,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1782,9 +1782,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2549,10 +2549,10 @@ 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 + // (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 @@ -2818,8 +2818,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -2880,8 +2880,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3123,12 +3123,12 @@ 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 + // 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 @@ -3143,12 +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](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 + // (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 @@ -3323,9 +3323,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4289,8 +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](https://cloud.google.com/speech/limits#content). + // 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 @@ -4382,10 +4382,10 @@ 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 + // (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 @@ -4455,10 +4455,10 @@ 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 (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 @@ -4773,8 +4773,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4835,8 +4835,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -5257,9 +5257,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -6026,10 +6026,10 @@ 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 + // (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 @@ -6295,8 +6295,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6357,8 +6357,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6827,9 +6827,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7642,10 +7642,10 @@ 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 + // (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 @@ -8000,8 +8000,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8065,8 +8065,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8317,11 +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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 7fea350c4e5..c489b188ae2 100644 --- a/videointelligence/v1p2beta1/videointelligence-gen.go +++ b/videointelligence/v1p2beta1/videointelligence-gen.go @@ -323,9 +323,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1088,10 +1088,10 @@ 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 + // (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 @@ -1356,8 +1356,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1418,8 +1418,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1782,9 +1782,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2549,10 +2549,10 @@ 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 + // (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 @@ -2818,8 +2818,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -2880,8 +2880,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3244,9 +3244,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4013,10 +4013,10 @@ 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 + // (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 @@ -4282,8 +4282,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4344,8 +4344,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -4587,12 +4587,12 @@ 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 + // 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 @@ -4607,12 +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](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 + // (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 @@ -4787,9 +4787,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -5753,8 +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](https://cloud.google.com/speech/limits#content). + // 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 @@ -5846,10 +5846,10 @@ 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 + // (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 @@ -5919,10 +5919,10 @@ 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 (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 @@ -6237,8 +6237,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -6299,8 +6299,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6827,9 +6827,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7642,10 +7642,10 @@ 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 + // (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 @@ -8000,8 +8000,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8065,8 +8065,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8317,11 +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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 ad1992aba58..db5c5740a31 100644 --- a/videointelligence/v1p3beta1/videointelligence-gen.go +++ b/videointelligence/v1p3beta1/videointelligence-gen.go @@ -323,9 +323,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -1088,10 +1088,10 @@ 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 + // (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 @@ -1356,8 +1356,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -1418,8 +1418,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -1782,9 +1782,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -2549,10 +2549,10 @@ 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 + // (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 @@ -2818,8 +2818,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -2880,8 +2880,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -3244,9 +3244,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -4013,10 +4013,10 @@ 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 + // (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 @@ -4282,8 +4282,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -4344,8 +4344,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -4708,9 +4708,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -5477,10 +5477,10 @@ 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 + // (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 @@ -5746,8 +5746,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -5808,8 +5808,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -6052,12 +6052,12 @@ 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 + // 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 @@ -6072,12 +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](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 + // (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 @@ -6358,9 +6358,9 @@ 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 + // (https://developers.google.com/knowledge-graph/). EntityId string `json:"entityId,omitempty"` // LanguageCode: Language code for `description` in BCP-47 format. @@ -7370,8 +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](https://cloud.google.com/speech/limits#content). + // 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 @@ -7463,10 +7463,10 @@ 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 + // (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 @@ -7536,10 +7536,10 @@ 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 (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 @@ -7943,8 +7943,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // ProgressPercent: Approximate percentage processed thus far. @@ -8008,8 +8008,8 @@ 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 + // (https://cloud.google.com/storage/). InputUri string `json:"inputUri,omitempty"` // LogoRecognitionAnnotations: Annotations for list of logos detected, @@ -8318,11 +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](https://github.com/grpc). -// Each `Status` message contains three pieces of data: error code, -// error message, and error details. You can find 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 (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find 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 6b33aaf5a67..f3886ad79ef 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 (https://developers.google.com/knowledge-graph/). 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 (https://developers.google.com/knowledge-graph/). 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 (https://developers.google.com/knowledge-graph/). 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 (https://developers.google.com/knowledge-graph/). 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 (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -11642,8 +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](https://cloud.google.com/vision/docs/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. @@ -11713,19 +11713,18 @@ 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 + // (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](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 + // 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 @@ -13367,11 +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](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/vision/v1p1beta1/vision-gen.go b/vision/v1p1beta1/vision-gen.go index 04ff39d0fc4..1db3830931d 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 (https://developers.google.com/knowledge-graph/). 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 (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -2722,8 +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](https://cloud.google.com/vision/docs/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. @@ -2794,19 +2794,18 @@ 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 + // (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](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 + // 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 @@ -4815,8 +4814,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 (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -7166,8 +7165,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 (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -9699,8 +9698,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 (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -12808,11 +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](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/vision/v1p2beta1/vision-gen.go b/vision/v1p2beta1/vision-gen.go index 5c4f6e83e05..ebd71054e39 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 (https://developers.google.com/knowledge-graph/). 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 (https://developers.google.com/knowledge-graph/). 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 (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -5022,8 +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](https://cloud.google.com/vision/docs/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. @@ -5094,19 +5094,18 @@ 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 + // (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](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 + // 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 @@ -7166,8 +7165,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 (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -9699,8 +9698,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 (https://developers.google.com/knowledge-graph/). Mid string `json:"mid,omitempty"` // Properties: Some entities may have optional user-supplied `Property` @@ -12808,11 +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](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/workflowexecutions/v1beta/workflowexecutions-gen.go b/workflowexecutions/v1beta/workflowexecutions-gen.go index 9677f5728b1..9c5ee072ea5 100644 --- a/workflowexecutions/v1beta/workflowexecutions-gen.go +++ b/workflowexecutions/v1beta/workflowexecutions-gen.go @@ -217,9 +217,8 @@ 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 +// (/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. *Note*: If you are using the REST API diff --git a/workflows/v1beta/workflows-gen.go b/workflows/v1beta/workflows-gen.go index 7e32c4c8376..dd2e97bdac3 100644 --- a/workflows/v1beta/workflows-gen.go +++ b/workflows/v1beta/workflows-gen.go @@ -461,11 +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](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/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 { } diff --git a/youtubeanalytics/v2/youtubeanalytics-gen.go b/youtubeanalytics/v2/youtubeanalytics-gen.go index 53373cc943b..efe3c11ae1b 100644 --- a/youtubeanalytics/v2/youtubeanalytics-gen.go +++ b/youtubeanalytics/v2/youtubeanalytics-gen.go @@ -1918,12 +1918,12 @@ 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 -// 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,]+ +// 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) return c @@ -1939,12 +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](/youtube/analytics/v2/available_reports) document +// 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 +// 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 { @@ -1983,11 +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](/youtube/analytics/v2/available_reports) +// 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,]+ +// 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